使用 MQTT.fx 接入平台
使用 MQTT.fx 接入平台
- MQTT.fx 是一个多平台的 MQTT 协议客户端,本文以 Windows 系统为例,介绍使用 MQTT.fx 模拟物联网设备接入平台,并体验平台的核心功能。
前提条件
已创建产品和设备,并获取 MQTT 连接参数。具体操作,请参见创建产品与设备。
在设备管理中进入设备详情,在「设备信息」区域的 MQTT连接 处单击 获取连接信息,本示例获取的连接参数值如下表(每次点击都会重新计算,
clientId、username、password必须来自同一次获取):参数 值(示例) clientId xCgOGN.device1|timestamp=1765676893841,signmethod=hmacsha256|username device1&xCgOGNpassword DA181D4449DAAE88C5A47681098970BE43D797EB0E513D69A7A0B09E0830EE78host mqtt.xiaolizi.techport 2883keepalive 120提示
平台不校验 timestamp 是否过期,但 password 与该 timestamp 一一绑定。直接粘贴控制台返回的三个值即可,手动修改 clientId 中的时间戳会导致鉴权失败。
操作步骤
1. 下载并安装 MQTT.fx
从 MQTT.fx 官网 下载安装包并安装(也可使用 MQTTX 等其他客户端,配置方法相同)。
2. 配置连接
打开 MQTT.fx,单击左下角齿轮图标进入 Connection Profile 配置页。
配置以下参数:
配置项 取值 Profile Name xiaolizi-device1(自定义)Broker Address 控制台返回的 host,如mqtt.xiaolizi.techBroker Port 控制台返回的 port,如2883Client ID 直接粘贴控制台返回的 clientId(不要使用随机生成按钮覆盖)User Credentials → User Name 控制台返回的 usernameUser Credentials → Password 控制台返回的 password协议版本使用默认 MQTT 3.1.1,单击 OK 保存。
如需使用 MQTTS(TLS 加密),Broker Address 换为
mqtts.xiaolizi.tech、Port 为9883,并在 SSL/TLS 页签启用 TLS 且加载 CA 证书,证书内容参见建立 MQTT 连接。
3. 连接平台
单击右上角 Connect,指示灯变为绿色表示连接成功。此时控制台的设备状态将显示为在线(状态经 Kafka 链路同步,存在秒级延迟)。
4. 上报一条属性
切换到 Publish 页签。
在 Topic 输入框填写属性上报 Topic(将 ProductKey、DeviceName 替换为实际值):
/sys/{ProductKey}/{DeviceName}/thing/event/property/postQoS 选择 1,在消息框中输入以下 JSON(
temperature为物模型中定义的属性标识符):{ "id": "1", "version": "1.0", "sys": { "ack": 1 }, "params": { "temperature": 23.6 }, "method": "thing.event.property.post" }单击 Publish 发布。
切换到 Log 页签,可以看到平台下发的回复报文:
{ "id": "1", "code": 200, "method": "thing.event.property.post", "data": {}, "message": "success" }回到控制台,在设备详情的物模型数据 / 属性记录中即可看到
temperature = 23.6。
5. 验证平台下行(属性设置)
在 MQTT.fx 切换到 Subscribe 页签,订阅属性设置 Topic:
/sys/{ProductKey}/{DeviceName}/thing/service/property/set在控制台设备详情的属性配置中,对该设备执行 设置(如把
temperature设为26.0)。MQTT.fx 将收到平台下发的报文:
{ "id": "123456789012345678", "timestamp": 1700000000000, "params": { "temperature": 26.0 }, "method": "thing.service.property.set" }完整的回复报文格式与更多 Topic,请参见使用物模型通信与Topic 与报文约定。
6. 断开连接
验证完成后单击 Disconnect 断开连接,控制台设备状态将变为离线。
常见问题
| 现象 | 原因与处理 |
|---|---|
| 连接被拒绝(not authorized) | 三元组不匹配:clientId、username、password 必须来自同一次「获取连接信息」;检查是否误改了 clientId;确认设备未被停用。更多排查见故障排查 |
| 手动改了 clientId 里的时间戳 | password 与时间戳绑定,必须重新在控制台获取整套连接参数 |
| 设备在线但控制台显示离线 | 状态同步存在秒级延迟,稍等刷新即可 |