Connect IoT - MQTT驱动程序#
MQTT是一种机器对机器(M2M)/物联网连接协议。它被设计为一个超轻量级的发布/订阅消息传递传输系统。
数据类型#
这些是受支持的特定数据类型:
| 名称 | 描述 |
|---|---|
| UInt8 | 无符号整数8位 |
| UInt16 | 无符号整数16位 |
| UInt32 | 无符号整数32位 |
| Int8 | 有符号整数8位 |
| Int16 | 有符号整数16位 |
| Int32 | 有符号整数32位 |
| 浮点型 | 浮点数 |
| 双精度 | 浮点双精度数 |
| 字符串 | ASCII 值(文本字符串) |
异常流程参数#
异常流程支持以下参数:
| 名称 | 类型 | 可能的值 | 默认值 | 描述 |
|---|---|---|---|---|
| 地址 | 字符串 | MQTT代理的地址 | ||
| 端口 | 整数 | 1883 | MQTT代理的端口 | |
| user | 字符串 | 登录用户名 | ||
| 密码 | 字符串 | 登录密码 | ||
| pollInterval | 整数 | 2000 | 当没有可用的更改值通知时,变量轮询之间的时间。仅用于事件。(毫秒) | |
| byteOrder | 枚举 | BigEndian LittleEndian | BigEndian | 消息数据的字节顺序 |
| 对发送内容转换不可打印的ASCII字符 | 布尔值 | False | 对发送的值进行字符替换。将ASCII名称令牌替换为相应的ASCII值。(例如:对于命令值, <NUL> 转换为#00、...、<DEL>转换为#127) | |
| 对接收内容转换不可打印的ASCII字符 | 布尔值 | False | 对接收到的值进行字符替换。将非可打印ASCII代码替换为相应的<NAME>。(例如:#00转换为<NUL>、#01转换为<SOH>、...、#7F转换为<DEL>) |
扩展参数#
属性#
| 名称 | 类型 | 可能的值 | 默认值 | 描述 |
|---|---|---|---|---|
| identifierType | 枚举 | 无 RegularExpression Token | 无 | 用于标识属性的方法。必须是以下项之一:None、RegularExpression或Token。如果使用None,则将忽略Identifier Value,并且所有消息都将更新该属性。Token 类型将仅与消息开头的Identifier Value文本进行匹配,而RegularExpression将与配置的正则表达式Identifier Value字段进行匹配。 |
| identifierValue | 字符串 | 属性标识符的值。对RegularExpression或Token标识符类型有效。如果使用了Convert Non Printable ASCII Chars on Identifiers选项,则可以转换非可打印ASCII字符 | ||
| 转换标识符中的非可打印ASCII字符 | 将<NAME>中的非可打印ASCII代码替换为相应的ASCII代码(例如,<NULL>转换为#0、<SOH>转换为#1、<STX>转换为#2、...、<US>转换为#31、<DEL>转换为#127) |
事件#
| 名称 | 类型 | 可能的值 | 默认值 | 描述 |
|---|---|---|---|---|
| triggerMode | 枚举 | 始终 OnChange OnInterval | 始终 | 可以发布数据(基于事件):Always:每次收到触发器属性值时OnChange:每次收到不同的触发器属性值时OnInterval:定期(每个周期的时间间隔,以毫秒为单位),忽略属性更新周期或值 |
| 时间间隔 | 整数 | 1000 | 发布数据的毫秒数。仅对triggerMode有效 OnInterval |
事件属性#
| 名称 | 类型 | 可能的值 | 默认值 | 描述 |
|---|---|---|---|---|
| isTrigger | 布尔值 | true | 接收到属性(事件触发模式Always)或更改值(事件触发模式OnChange)时触发事件 |
备注/行为#
- 当事件具有多个属性带
isTrigger标志时:- 每次任何属性值更改时都会触发它。
- 此时将请求其他属性的值。
- 可能有多个触发器具有相同的设置值(因为它们未更改)。如果不希望出现这种行为,请将其分成多个事件,每个事件都有自己的触发器集。
- 如果事件没有具有isTrigger标志的属性,则从不触发(除非事件定义为
Periodic)
命令#
- 不适用
命令参数#
- 不适用
非可打印ASCII字符 - 令牌/值替换#
| 令牌 | 值 | 令牌 | 值 | 令牌 | 值 | 令牌 | 值 | 令牌 | 值 |
|---|---|---|---|---|---|---|---|---|---|
| <NUL> | 0 | <SOH> | 1 | <STX> | 2 | <ETX> | 3 | <EOT> | 4 |
| <ENQ> | 5 | <ACK> | 6 | <BEL> | 7 | <BS> | 8 | <TAB> | 9 |
| <LF> | 10 | <VT> | 11 | <FF> | 12 | <CR> | 13 | <SO> | 14 |
| <SI> | 15 | <DLE> | 16 | <DC1> | 17 | <DC2> | 18 | <DC3> | 19 |
| <DC4> | 20 | <NAK> | 21 | <SYN> | 22 | <ETB> | 23 | <CAN> | 24 |
| <EM> | 25 | <SUB> | 26 | <ESC> | 27 | <FS> | 28 | <GS> | 29 |
| <RS> | 30 | <US> | 31 | <DEL> | 127 |