Main Content

writeline

将 ASCII 数据行写入串行端口

全页折叠

语法

writeline(device,data)

说明

writeline(device,data) 将 ASCII 文本 data（后跟终止符）写入指定的串行端口。该函数暂停 MATLAB® 的执行，直到写入了数据和终止符。

示例

示例

全部折叠

创建到串行端口设备的连接。在此示例中，COM3 上的串行端口连接到环回设备。

device = serialport("COM3",9600)
device = 

  Serialport with properties:

                 Port: "COM3"
             BaudRate: 9600
    NumBytesAvailable: 0

  Show all properties, functions

检查默认的 ASCII 终止符。

device.Terminator
ans = 

    "LF"

将终止符设置为 "CR"，并写入一个 ASCII 数据字符串。writeline 函数自动将终止符追加到数据中。

configureTerminator(device,"CR")
writeline(device,"hello")

写入自动追加了终止符的另一个 ASCII 数据字符串。

writeline(device,"world")

由于该端口连接到环回设备，您写入该设备的数据将返回到 MATLAB。读取一个 ASCII 数据字符串。readline 函数返回数据，直到到达终止符。

readline(device)
ans = 

    "hello"

再次读取一个 ASCII 数据字符串，以返回您写入的第二个字符串。

readline(device)
ans = 

    "world"

清除串行端口连接。

clear device

输入参数

全部折叠

串行端口连接，指定为 serialport 对象。

示例: writeline(device,1:5) 写入串行端口连接 device。

要写入的 ASCII 数据，指定为文本类型的字符向量或字符串标量。

示例: writeline(device,"*IDN?") 写入 ASCII 字符串 "*IDN?"

数据类型: char | string

版本历史记录

在 R2019b 中推出

另请参阅

函数