configureTerminator
为与串行端口的 ASCII 字符串通信设置终止符
说明
configureTerminator(
定义与指定的串行端口进行读写通信的终止符。允许的终止符值是 device
,terminator
)"LF"
(默认值)、"CR"
、"CR/LF"
以及 0
到 255
的整数值。该语法设置 device
的 Terminator
属性。
设置终止符后,使用 writeline
和 readline
写入和读取以 ASCII 字符结尾的字符串数据。
configureTerminator(
为读取和写入通信定义单独的终止符。device
,readterminator,writeterminator
)
示例
为读取和写入通信设置相同的终止符
使用 serialport
创建到串行端口设备的连接。
device = serialport("COM3",9600)
device = Serialport with properties: Port: "COM3" BaudRate: 9600 NumBytesAvailable: 0 Show all properties, functions
将读取终止符和写入终止符都设置为 "CR/LF"
。
configureTerminator(device,"CR/LF")
确认更改。
device.Terminator
ans = "CR/LF"
为读取和写入通信设置不同终止符
使用 serialport
创建到串行端口设备的连接。
device = serialport("COM3",9600)
device = Serialport with properties: Port: "COM3" BaudRate: 9600 NumBytesAvailable: 0 Show all properties, functions
将读取终止符设置为 "CR"
,将写入终止符设置为 10
。
configureTerminator(device,"CR",10)
确认更改。
device.Terminator
ans=1×2 cell array
{["CR"]} {[10]}
数组中的第一个元素是读取终止符,第二个元素是写入终止符。
从串行端口设备读写 ASCII 数据行
创建到串行端口设备的连接。在此示例中,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
输入参数
device
— 串行端口连接
serialport
对象
串行端口连接,指定为 serialport
对象。
示例: configureTerminator(device,"CR")
设置串行端口连接 device
上的终止符。
terminator
— ASCII 终止符
"LF"
(默认) | "CR"
| "CR/LF"
| 0 至 255
读取和写入通信的 ASCII 终止符,指定为 "LF"
、"CR"
、"CR/LF"
或 0 到 255 之间的一个整数数值。当为读取和写入设置相同的终止符时,请使用此形式。当从终止符值为 "CR/LF"
的串行端口读取时,读取会在 CR
和 LF
同时出现时终止。当写入终止符值为 "CR/LF"
的串行端口时,写入通过同时添加 CR
和 LF
这两者来终止。此输入参量设置 Terminator
属性。
示例: configureTerminator(device,"CR/LF")
将读取终止符和写入终止符都设置为 "CR/LF"
。
数据类型: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
| char
| string
readterminator,writeterminator
— 用于读取和写入的 ASCII 终止符
"LF"
(默认) | "CR"
| "CR/LF"
| 0 至 255
读取或写入通信的 ASCII 终止符,指定为 "LF"
、"CR"
、"CR/LF"
或 0 到 255 之间的一个整数数值。当为读取和写入设置不同的终止符时,请使用此形式。当从终止符值为 "CR/LF"
的串行端口读取时,读取会在 CR
和 LF
同时出现时终止。当写入终止符值为 "CR/LF"
的串行端口时,写入通过同时添加 CR
和 LF
这两者来终止。此输入参量设置 Terminator
属性。
示例: configureTerminator(device,"CR",10)
将读取终止符设置为 "CR"
,将写入终止符设置为 10
。
数据类型: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
| char
| string
版本历史记录
在 R2019b 中推出
MATLAB 命令
您点击的链接对应于以下 MATLAB 命令:
请在 MATLAB 命令行窗口中直接输入以执行命令。Web 浏览器不支持 MATLAB 命令。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)