Main Content

writeline

将 ASCII 数据行写入串行端口

自 R2019b 起

说明

示例

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 中推出