在爱星物联云平台，怎么使用MQTTX工具进行设备调试，排查设备问题？

时间： 2024-06-20 来源：安信可科技

代理服务

技术支持

批量订货

爱星物联IoT云平台是一款面向智能小家电、环境电器等C端用户领域的通用物联网平台，设备和平台交互主要使用了MQTT协议。从下图可以看到，智能设备-平台-APP主要使用了MQTT协议进行数据的交互。

MQTT是一种基于发布/订阅模式的“轻量级”通讯协议，该协议构建于TCP/IP协议上，由IBM在1999年发布。MQTT的主要设计目标是为低带宽、高延迟或不可靠的网络中的远程传感器和控制设备之间的通信提供实时可靠的消息服务。

随着物联网（IoT）的快速发展，大量的设备需要通过网络进行通信和数据交换。这些设备可能分布在各个角落，网络环境复杂多变，因此需要一个能够适应这种环境的通信协议。MQTT协议就是为满足这种需求而设计的。它特别适合用于物联网中的传感器和控制设备，这些设备通常具有有限的计算能力、存储空间和带宽。

MQTT协议的其它特性、及应用场景，感兴趣的读者可以参考相关专业资料。

MQTT协议的可用调试工具较多，有带GUI的也有命令行的。这里推荐一款MQTTX，界面比较好，使用也比较简单。

可以到官网下载安装：https://mqttx.app/zh/docs/downloading-and-installation

MQTTX的使用说明请参考官网：

（1）https://mqttx.app/zh/docs/get-started

（2）https://mqttx.app/zh/docs/advanced

在爱星物联云平台中，怎么使用MQTTX工具进行设备调试，排查设备问题？

MQTT协议的消息有消息主题、消息体的概念。平台制定了设备端和云端通讯的协议，约定了交互流程和消息规范，我们在用MQTTX工具进行调试时，我们必须要熟悉这些内容。可以参考《爱星云平台嵌入式与IoT云平台协议规范》。

其中比较重要、经常需要关注的是消息topic和各业务消息结构。

消息topic如下表，其中ProductKey是产品key，DeviceId是设备ID。

各业务消息接口，可以参考协议文档。通常在设备开发中，我们需要反复查阅协议文档内容，要对协议条目的场景、消息规范等需要有比较清晰的理解，严格按照协议规范进行开发。

了解了协议之后，我们介绍一下具体使用MQTTX进行设备调试的例子。我们使用MQTTX 1.9.6版本来介绍，其它版本的界面布局可能略有不同，但关键参数是一样的。

以某产品为例，产品key是DomeDev，我们需要调试改产品的设备A，设备ID是VIRTDVA2FDDUKH。

我们先来建立连接参数，界面如下图所示：

因为云端对MQTT连接做了安全认证和鉴权。因此，需要注意几点：

Client ID：必须填写tool_{aaaaaa}，其中{aaaaaa}是随机字符串，如tool_debug等。

用户名：必须填写产品key，需要调试哪个产品就用哪个产品的key，注意是产品key，不是设备key，如DomeDev。

密码：密码=MD5(产品key+随机字符串)，例子就是DomeDevdebug字符串的MD5值，32位小写。

MQTT版本：选择3.1或3.1.1，目前平台未配置5.0，所以不要选择5.0版本。

其它参数按照云服务器实际配置来填写，比如域名，端口及加密参数等。

连接建立完成后，我们需要订阅我们感兴趣的设备的消息。比如我们是要调试设备VIRTDVA2FDDUKH，则可以使用带通配符的topic： DomeDev/VIRTDVA2FDDUKH/# ，订阅改设备的所有消息。

注意，因为这次MQTT连接是DomeDev作为用户名进行连接的，所以只能订阅DomeDev产品下的设备的消息，其它产品的消息都会被视为非法消息；如果订阅其它产品的消息，则会被平台踢掉连接。

当订阅成功后，平台会立即推送该设备的retain消息；同时，该设备后续进行的所有实时数据和指令收发，都可以订阅到并在界面展示出来。

如果此时设备还没有连上平台，那么不会有实时数据推送。如果确认设备已正常连接，却看不到数据更新，设备也收不到控制指令，就要考虑设备端是否连错服务器或者数据收发逻辑了。

剩下的就是，对照协议内容分析指令、数据、以及设备的真实状态了。

另外，MQTTX也支持指令下发，开发者可以根据协议规范，手动构建指令下发。

如下图所示：

其它，设备配不上网的问题、设备连不上的问题、设备状态异常的问题、设备控制不正常的问题，等等所有这些设备相关的问题，均可以通过MQTTX工具来排查问题、定位原因。

发送到邮箱 |
+1 赞 0
收藏
评论 0
| 转发至：

本文由赵优秀转载自安信可科技，原文标题为:爱星物联——如何用MQTTX调试设备，排查问题，本站所有转载文章系出于传递更多信息之目的，且明确注明来源，不希望被转载的媒体或个人可与我们联系，我们将立即进行删除处理。

全部评论（0）

暂无评论

【经验】如何将安信可科技的PB-03F模块升级DTM固件进行认证测试？

使用安信可科技的蓝牙模组PB-03F进行产品设计后期，部分产品需要连同PB-03F模块一同送去认证机构进行认证测试，此时需要给蓝牙模组PB-03F烧录特殊的测试固件DTM。本文指导如何给PB-03F模块烧写DTM固件。

2023-06-22 - 设计经验代理服务技术支持批量订货

Stability Is King: How to Choose A Highly Reliable IoT Router

Choosing a highly reliable IoT router requires consideration of multiple aspects such as network requirements, applicable area, heat dissipation design, security, and management methods. Only by considering these factors can we find the router that best suits our needs and ensure the stability and efficiency of IoT applications.

2024-10-28 - 设计经验代理服务技术支持批量订货

智能家居之旅（14）：安信可IoT Blufi配网工具新功能介绍

今天给大家介绍一下小程序配网工具-安信可IoT，近期刚发布了新的版本，新增了服务器地址配置的功能，在配网的时候，可以选择配置服务器地址。这个新功能，给我们带来了不少便利，特别是 HomeAssistant 固件使用这一块。

2024-09-06 - 设计经验代理服务技术支持批量订货

安信可科技（Ai-Thinker）物联网专用模组&天线选型指南

目录- LoRa product Radar product WiFi+Bluetooth products 2.4G Series Module GPS Series Module UWB & 4G series module GPRS series module Offline Voice Module Series Antenna

型号- RA-01SH,PB-02-KIT,RTL8720 SERIES,AI-WB1,AI-WB2,AI-WB2-M1,HI-07S-KIT,TB-02-KIT,AI-WB2-12F-KIT,AI-WB2-13-KIT,AI-WB2-13U,AI-WB2-01S,A9,SX1268,RA-01SC,TG-02-KIT,PB SERIES,RTL8710BX SERIES,GPS SERIES,AI-WB2-01M,VC-01-KIT,HI-12F,TB SERIES,HI-12F-KIT,BW16,AI-WB2 SERIES,BW15,BW14,TG-12F-KIT,BW12,RTL8710BX,A9G,HI SERIES,AI-WB2-12S,PB-03,SX126X,AI-WB1-32S,HI-07S,HI-07SL-KIT,PB-01,PB-02,RG-02,AI-WB1-32S-KIT,RTL8720DN,AI-WB2-12F,TG-01M,AI-WB1SERIES,NF-05,NF-02-PA,NF-04,NF-03,BW16-KIT,NF-01-S,SX127X,TB-03F-KIT,LLCC68,TG-02,AI-WB2-07S,NF-01-N,NF-02-PE,AI-WB1-32S-CAM,GP-02-KIT,AI-WB2-M1-I,TG-02M-KIT,TG-02M,RA-08-KIT,GP-01,GP-02,CA-01-KITC,CA-01,2.4G SERIES,AI-WB2-13,PB-03F,PB-03M,TG SERIES,TB-04-KIT,TB-05,GPRS SERIES,TB-04,TG-02F,TB-02,RTL8720DN SERIES,TG-02F-KIT,4G SERIES,PB-03M-KIT,AI-WB2-32S-KIT,BU01,RA-01,PB-03-KIT,ESP32-G,RTL8720,RA-08H,NF-04-MI,VC-02-KIT,NF-05-S,RA-01S,HI-12FL,RA-01H,HI-07SL,AI-WB2-32S,RA-01SCH,PB-01-KIT,RTL8720CF,TG-01M-KIT,TG-12F,AI-WB1-A1S,AI-WB1-12F,TB-03F,BW15-KIT,GPRS,UWB SERIES,GP-01-KIT,AI-WB1-12F-KIT,NODEMCU-BU01,RA-08H-KIT,RD-01,RA-02,RTL8720CF SERIES,RA-08,VC-02,VC-01,HI-12FL-KIT,PB-03F-KIT

2023/09/19 - 安信可科技 - 选型指南代理服务技术支持批量订货

涂鸦智能Cube Cloud正式支持阿里云IoT、腾讯云IoT和AWS IoT

12月29日，涂鸦智能正式对外宣布，其IoT平台支持兼容各大主流云厂商IoT平台南向设备接入和北向应用服务。本文重点介绍标准化迁移解决方案及涂鸦IoT平台如何为客户迁移保驾护航。

2024-01-10 - 原厂动态

IOT Sensor Monitoring System Gateway IOT-G010

IoT sensor monitoring system gateway IOT-G010 is mainly used for sensor monitoring and control of the Internet of Things. The whole network system is composed of gateway IOT-G010 and node IOT-N010/ IOT-THS010, which uses a wireless star network combined with Mesh networking. A good coordination mechanism and precise scheduling algorithm are used internally between the node and the gateway to avoid collisions between data packets in the air.

2024-11-05 - 产品代理服务技术支持批量订货

安信可科技无线模组选型表

提供安信可科技无线模组选型,封装:DIP/SMD,尺寸:10.3mm*9.9mm*2.4(±0.2)mm-120.0mm*120.0mm*30.0mm,通信接口:UART/GPIO/ADC/PWM/I?C/SPI/Touch senser/PSRAM/SDIO/Duplex I²S/麦克风/扬声器,最大速率:2.5mW-100mW,参考距离:80m-5km,供电电压:1.9V-5.25V

产品型号	品类	封装	尺寸(mm)	通信接口	最大速率(mW)	参考距离(m/km)	供电电压(V)	空中速率(Kbps/Mbps)	天线形式	工作温度(℃)
NF-01-S	2.4G模组	DIP-8	28.6mm*15.3mm	SPI	5mW	240m	1.9V-3.6V	250Kbps-2Mbps	板载天线	-20℃～70℃

选型表 - 安信可科技立即选型

爱星物联——IoT云平台介绍

本文介绍了爱星物联IoT云平台，该平台专为环境电器与智能家电行业提供一站式智能化解决方案。通过实例展示了空气净化器设备接入的基本原理，并突出了平台的四大亮点：1) 物联网功能全面；2) 支持品类可扩展；3) 低代码开发支持完善；4) 云平台技术可扩展、易定制。这些特性使得爱星物联IoT平台能够帮助客户缩短研发周期，降低成本，快速开发AIoT产品，构建安全稳定且可定制化的解决方案。

2024-06-24 - 产品代理服务技术支持批量订货

Iot Router‘s Integration and Data Management for The Internet of Things

In the context of the rapid development of the Industrial Internet of Things (IIoT), IoT routers play a crucial role as a bridge connecting the factory floor with the cloud data center. For enterprises requiring networking applications, the IoT router‘s IoT integration and data management capabilities are pivotal for achieving intelligent manufacturing, remote monitoring, and data analysis.

2024-10-31 - 技术探讨代理服务技术支持批量订货

【产品】安信可科技WIFI蓝牙二合一模块Ai-WB2系列通过各项性能测试，实测400-500米传输距离

天线作为无线信号辐射和接收的重要器件，有着不可替代的作用。一款天线设计完成后需要经过测试才能确定其性能是否符合设计要求。那么天线性能需要进行哪些性能测试呢？本文以安信可的Ai-WB2-12F模块为例，看看如何测试PCB天线的性能。

2023-09-20 - 产品代理服务技术支持批量订货

安信可科技Rd-04低成本低功耗雷达模组赋能照明行业，适合嵌入式隐蔽设计

安信可科技Rd-04是基于富奥星的XBR818芯片而设计的微动、运动感知模组。其中心频率为10.525GHz，基于多普勒雷达原理，芯片内置算法，无需外挂单片机，超高性价比。主要针对低成本或低功耗的应用领域，该产品定位为微动、运动感知场景应用，适合壁挂或吸顶安装。

2023-07-30 - 原厂动态代理服务技术支持批量订货

Key Role and Selection Points of IoT Modem in Industrial IoT Projects

IoT Modem plays a crucial role in industrial IoT projects. It can not only realize important functions such as data collection and transmission, remote monitoring and control, data security and protection, but also has the advantages of real-time, stability, flexibility and scalability. When selecting a model, it is necessary to consider factors such as communication modules, interface types, power consumption, and protection levels based on specific application scenarios and requirements to ensure that the IoT Modem device can meet the project‘s needs.

2024-10-28 - 设计经验代理服务技术支持批量订货

安信可科技（Ai-Thinker）2.4G模组选型表

目录- 2.4G模组

型号- NF-02-PA,NF-04,NF-03,NF-01-S,NF-02-SM,NF-04-MI,NF-01-N,NF-02-PE

2017/6/10 - 安信可科技 - 选型指南代理服务技术支持批量订货

安信可科技针对物联网设计通用型蓝牙模组符合BLE 5.0，智能手机Mesh组网，可对接天猫精灵

安信可科技针对物联网设计通用型的蓝牙模组，其功能强大、用途广泛。可以用于智能灯、智能插座、智能空调等其他智能家电。同时符合BLE 5.0及SIG Mesh规范，可直接通过智能手机组建Mesh网络，也可对接天猫精灵等智能音箱，适用于多种智能家居应用场景。

2024-07-04 - 产品代理服务技术支持批量订货

Comprehensive Analysis of The Purchase Strategy of Iot Routers

In the era of Internet of Things (IoT), networked applications have become an indispensable part of all walks of life. In order to ensure stable connection and efficient operation of IoT devices, it is crucial to choose the right IoT router. The following is a comprehensive analysis of the purchasing strategy of IoT routers from multiple dimensions to help users with networking application needs make informed choices.1. CLARIFY THE USAGE SCENARIOS AND REQUIREMENTSFirst, the specifications and functions of the router need to be determined based on the actual usage scenarios and requirements.

2024-10-27 - 设计经验代理服务技术支持批量订货