mqtt V3 API
1.3.1 mqtt.new
| 功能 |
创建mqtt实例 |
| 接口描述 |
obj = mqtt.new() |
| obj |
创建并返回的mqtt实例对象 |
1.3.2 mqtt.subscribe
| 功能 |
订阅mqtt主题消息 |
| 接口描述 |
subscribe(obj, topic) |
| obj |
mqtt实例对象 |
| topic |
订阅的主题<字符串> |
1.3.3 mqtt.unsubscribe
| 功能 |
取消订阅mqtt主题消息 |
| 接口描述 |
unsubscribe(obj, topic) |
| obj |
mqtt实例对象 |
| topic |
订阅的主题<字符串> |
1.3.4 mqtt.config
| 功能 |
配置mqtt server连接信息 |
| 接口描述 |
config(obj, mqttid, serverip, serverport) |
| obj |
mqtt实例对象 |
| mqttid |
mqttid<字符串>，当填nil时，则默认使用设备ID作为mqtt id |
| serverip |
mqtt服务器地址<字符串> |
| serverport |
mqtt端口号<字符串> |
1.3.5 mqtt.publish
| 功能 |
发布消息 |
| 接口描述 |
publish(obj, taginfo, topic, payload) |
| obj |
mqtt实例对象 |
| taginfo |
标记消息，用于日志输出查看<字符串>，没有可填nil |
| topic |
报文topic<字符串> |
| payload |
报文消息<字符串> |
1.3.6 publish_hex
| 功能 |
发布十六进制消息 |
| 接口描述 |
publish_hex(obj, taginfo, topic, payload) |
| obj |
mqtt实例对象 |
| taginfo |
标记消息，用于日志输出查看<字符串>，没有可填nil |
| topic |
报文topic<字符串> |
| payload |
报文消息<字符串> 例：”0e0a0b” 实际发送为3字节十六进制数据 |
1.3.7 mqtt.run
| 功能 |
启动mqtt实例 |
| 接口描述 |
run(obj) |
| obj |
mqtt实例对象 |
1.3.8 mqtt.stop
| 功能 |
停止mqtt实例 |
| 接口描述 |
stop(obj) |
| obj |
mqtt实例对象 |
1.3.9 mqtt.reboot
| 功能 |
配置 MQTT 断开重启(重启设备)参数（设置失败指定次数后触发重启 / 关闭 mqtt 链接失败后重启功能） |
| 接口描述 |
reboot(obj, mode, num) |
| obj |
mqtt 实例对象 |
| mode |
重启功能开关 <字符串>，可选值：”on”（开启重启功能）、”off”（关闭重启功能）；默认开启 |
| num |
失败重启次数阈值 <数字>，可选参数；不传时默认值为 3，传值需≥0 |
| 例 |
mqtt.reboot(m1, "on", 5) mqtt.reboot(m2, "off") mqtt.reboot(m3, "on") |
文档更新时间: 2026-03-12 14:20 作者：CGL
