Main Content

本页对应的英文页面已更新,但尚未翻译。 若要查看最新内容,请点击此处访问英文页面。

serialport

连接到串行端口

说明

serialport 对象表示与串行端口通信的串行客户端。在创建对象后,请使用圆点表示法设置其属性。

创建对象

说明

示例

s = serialport(port,baudrate) 连接到 port 指定的串行端口,波特率为 baudrate

s = serialport(port,baudrate,Name,Value) 连接到串行端口,并使用可选的名称-值对组参数设置其他属性。

s = serialport(不带参数)使用上次清除的 serialport 对象实例的属性设置连接到串行端口。保留的属性包括 PortBaudRateByteOrderFlowControlStopBitsDataBitsParityTimeoutTerminator。请参阅属性

输入参数

全部展开

串行端口名称,指定为字符串或字符向量。使用 serialportlist 获取已连接端口的列表。

示例: "COM2"

串行通信的波特率,指定为双精度。

示例: 9600

名称-值对组参数

指定可选的、以逗号分隔的 Name,Value 对组参数。Name 为参数名称,Value 为对应的值。Name 必须放在引号中。您可采用任意顺序指定多个名称-值对组参数,如 Name1,Value1,...,NameN,ValueN 所示。

您可以使用名称-值对组来设置 DataBitsParityStopBitsFlowControlByteOrderTimeout 对象属性。请参阅属性了解其数据类型和允许的值。

示例: "Timeout",30

属性

全部展开

此属性为只读

用于连接的串行端口,以字符串或字符向量形式返回。

示例: "COM1"

数据类型: string

通信速度,以位/秒为单位,以双精度正整数形式返回。

示例: 14400

数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

用于检查数据是否丢失或写入的奇偶校验,以 "none""even""odd" 形式返回。

示例: "odd"

数据类型: char | string

表示一个数据字符的位数,返回为 8765

示例: 8

数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

指示字符或整个传输结束的位的模式,返回为 11.52

示例: 1

数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

管理数据传输速率的模式,返回为 "none""hardware""software"

示例: "software"

数据类型: char | string

字节排列成较大数值的顺序,返回为 "little-endian""big-endian"

示例: "little-endian"

数据类型: char | string

允许的完成读写操作的时间(以秒为单位),以数值形式返回。

示例: 60

数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

此属性为只读

可供读取的字节数,以数值形式返回。

示例: 1024

数据类型: double

此属性为只读

写入串行端口的字节数,以数值形式返回。

示例: 512

数据类型: double

读写行的终止符字符,返回为 "LF""CR""CR/LF"。使用 configureTerminator (Instrument Control Toolbox) 函数设置此属性。

示例: "CR"

数据类型: char | string

字节可用回调函数,以函数句柄形式返回。该回调是通过接收一定数量的字节或接收终止符来触发的。使用 configureCallback (Instrument Control Toolbox) 函数设置此属性。

示例: @myFun

数据类型: function_handle

触发回调的数据字节数,以双精度形式返回。仅当 BytesAvailableFcnMode 属性为 "byte" 时,才使用此值。使用 configureCallback (Instrument Control Toolbox) 函数设置这些属性。

示例: 128

数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

字节可用回调触发模式,返回为 "off""byte""terminator"。此设置确定回调是关闭的、由多个字节触发的还是由终止符触发的。使用 configureCallback (Instrument Control Toolbox) 函数设置此属性。

示例: "off"

数据类型: char | string

由错误触发的回调函数,以函数句柄形式返回。

示例: @myErrFun

数据类型: function_handle

用户数据的通用属性,以任何类型形式返回。

示例: datetime()

数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char | string | struct | table | cell | function_handle | categorical | datetime | duration | calendarDuration | fi
复数支持:

对象函数

read从串行端口读取数据
readline从串行端口读取 ASCII 字符串数据行
write将数据写入串行端口
writeline将 ASCII 数据行写入串行端口
flush刷新串行端口缓冲区
configureTerminator为串行端口上的 ASCII 字符串通信设置终止符
configureCallback设置串行端口回调函数和触发器
getpinstatus获取串行引脚状态
setRTS设置串行 RTS 引脚
setDTR设置串行 DTR 引脚

示例

全部折叠

COM3 串行端口读取 uint32 数据的 16 个值。

s = serialport("COM3",9600,"Timeout",5);
data = read(s,16,"uint32");

另请参阅

函数

在 R2019b 中推出