跳转至

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
用于标识属性的方法。必须是以下项之一:NoneRegularExpressionToken。如果使用None,则将忽略Identifier Value,并且所有消息都将更新该属性。Token 类型将仅与消息开头的Identifier Value文本进行匹配,而RegularExpression将与配置的正则表达式Identifier Value字段进行匹配。
identifierValue 字符串 属性标识符的值。对RegularExpressionToken标识符类型有效。如果使用了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