19.6.143. UARTSerialBusV2(UART 串行总线连接资源描述符版本 2 宏)
语法 :
UARTSerialBusV2 (InitialBaudRate, BitsPerByte, StopBits, LinesInUse, IsBigEndian, Parity, FlowControl, ReceiveBufferSize,
TransmitBufferSize, ResourceSource, ResourceSourceIndex, ResourceUsage, DescriptorName, Shared, VendorData)
参数
InitialBaudRate 求值为一个 32 位整数,用于指定设备支持的默认或初始连接速度,单位为每秒字节数。位域 _SPE 会被自动创建以引用资源描述符的这一部分。
BitsPerByte 是一个可选参数,用于指定在传输单个分组或字符期间,数据部分是五位(DataBitsFive)、六位(DataBitsSix)、七位(DataBitsSeven)、八位(DataBitsEight)还是九位(DataBitsNine)。默认值为 DataBitsEight。位域 DescriptorName._LEN 会被自动创建以引用资源描述符的这一部分。
StopBits 是一个可选参数,用于指定用于表示分组或字符结束的是两位(StopBitsTwo)、一位半(StopBitsOnePlusHalf)、一位(StopBitsOne)还是零位(StopBitsZero)。默认值为 StopBitsOne。位域 _STB 会被自动创建以引用资源描述符的这一部分。
LinesInUse 求值为一个整数,表示 8 个 1 位标志,用于表示特定线路的存在(‘1’)或不存在(‘0’)。位域 _LIN 会被自动创建以引用资源描述符的这一部分。
表 19.42 UART 串行总线连接资源描述符 - 版本 2 宏
| 位掩码 | UART 线路 |
|---|---|
| Bit 7 (0x80) | 请求发送(RTS) |
| Bit 6 (0x40) | 清除发送(CTS) |
| Bit 5 (0x20) | 数据终端就绪(DTR) |
| Bit 4 (0x10) | 数据设备就绪(DSR) |
| Bit 3 (0x08) | 振铃指示(RI) |
| Bit 2 (0x04) | 数据载波检测(DTD) |
| Bit 1 (0x02) | 保留。必须为 0。 |
| Bit 0 (0x01) | 保留。必须为 0。 |
IsBigEndian 是一个可选参数,用于指定设备期望的是大端(BigEndian)还是小端(LittleEndian)数据格式。默认值为 LittleEndian。位字段 _END 会被自动创建,以引用资源描述符的这一部分。
Parity 是一个可选参数,用于指定数据包中数据之后包含的奇偶校验位类型应被解释为空格校验(ParityTypeSpace)、标记校验(ParityTypeMark)、奇校验(ParityTypeOdd)、偶校验(ParityTypeEven)还是无校验(ParityTypeNone)。默认值为 ParityTypeNone。位字段 PAR 会被自动创建,以引用资源描述符的这一部分。
FlowControl 是一个可选参数,用于指定与设备通信时使用的是基于硬件的流控制(FlowControlHardware)、基于软件的流控制(FlowControlXON)还是无流控制(FlowControlNone)。默认值为 FlowControlNone。位字段_FLC 会被自动创建,以引用资源描述符的这一部分。
ReceiveBufferSize 求值为一个 16 位整数,用于指定与该设备通信时可被最优利用的接收缓冲区字节数上限。位字段_RXL 会被自动创建,以引用资源描述符的这一部分。
TransmitBufferSize 求值为一个 16 位整数,用于指定与该设备通信时可被最优利用的发送缓冲区字节数上限。位字段 _TXL 会被自动创建,以引用资源描述符的这一部分。
ResourceSource 是一个字符串,用于唯一标识此描述符所引用的 UART 总线控制器。ResourceSource 可以是完全限定名、相对名称,或利用命名空间搜索规则的名称段。
ResourceSourceIndex 是一个可选参数,在此修订版本中假定为 0。
ResourceUsage 是一个可选参数,在此修订版本中假定为 ResourceConsumer。
DescriptorName 是一个可选参数,用于为将在当前作用域中创建的整数常量指定名称,该常量包含此资源描述符在当前资源模板缓冲区内的偏移量。预定义的描述符字段名称可以附加到该名称后,以通过缓冲区字段运算符访问描述符中的各个字段。
Shared 是一个可选参数,可以是 Shared 或 Exclusive。如果未指定,则假定为 Exclusive。位字段名 _SHR 会被自动创建,以引用资源描述符的这一部分。
VendorData 是一个可选参数,用于指定一个由 OS 驱动程序解码的对象。它是一个原始数据缓冲区。位字段名 _VEN 会被自动创建,以引用资源描述符的这一部分。
说明
UARTSerialBusV2 宏求值为一个缓冲区,其中包含 UART 串行总线连接资源描述符 - 版本 2 宏。该宏设计用于 ResourceTemplate(资源到缓冲区转换宏)内部。