在爱星物联云平台，怎么使用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）

暂无评论

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

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

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

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

设计经验发布时间 : 2023-06-22

安信可科技（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 PDF 中文下载

安信可科技(Ai-Thinker)是国内领先的物联网无线通信模组供应商，公司集研发、生产、销售于一体，专注于物联网通信应用，致力于为全球物联网终端提供WiFi、蓝牙、LoRa、雷达、离线语音、UWB、NB-IoT、GPS/GPRS等稳定可靠的物联网软硬件无线连接方案。

授权代理商 - 世强先进（深圳）科技股份有限公司线上商城技术资料

展开

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

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

原厂动态发布时间 : 2024-01-10

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

提供安信可科技无线模组选型,封装: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℃

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

【选型】秋田微（AVD）IoT物联网产品（ARM嵌入式板、串口板和A/D板、显示器驱动板、嵌入式显示器）选型指南

目录- IoT Products—ARM Embedded Boards IoT Products—Serial Port Boards IoT Products—Display Driver Board IOT Products Selection Table

型号- RTD2556T,AVD‐IOT‐OA‐A002L,ARM RK3288,AVD‐IOT‐AA‐A00XX,RTD2660H,AVD‐IOT‐OC‐A001M,NXP IMX6UL,AVD‐IOT‐AC‐A003M,AVD‐IOT‐OA001M,AVD‐IOT‐AC‐A002M,AVD‐IOT‐DC‐A001L,NXP IMX6Q,AVD‐IOT‐AC‐A006M,RTD2513A,AVD‐IOT‐AA‐A00XM,AVD‐IOT‐AA‐A004M,AVD‐IOT‐OA‐A004L,AVD‐IOT‐AC‐A0005M,AVD‐IOT‐OA‐C002M,AVD‐TV001‐NN‐003‐A,AVD‐IOT‐AA‐C003M,AVD‐IOT‐AA‐A003M

选型指南 - 秋田微 - 2021 PDF 英文下载

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

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

产品发布时间 : 2023-09-20

Key Applications of IoT Modem in Industrial Automation

This article will explore in detail the key applications and functional advantages of IoT Modem in industrial automation, and analyze its application effect in practical scenarios through specific case studies.

技术探讨发布时间 : 2024-10-23

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

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

产品发布时间 : 2024-06-24

IoT Products —ARM Embedded Boards Company Profile

型号- RTD2556T,AVD-IOT-AC-A002M,AVD-IOT-AC-A003M,AVD-IOT-AC-A0005M,AVD-IOT-AA-A00XM,AVD-IOT-AC-A006M,RTD2660H,AVD-IOT-OA-A004L,AVD-IOT-AA-A004M,AVD-IOT-AA-A003M,AVD-IOT-OA-A002L,AVD-IOT-OA-C002M,AVD-IOT-OA001M,AVD-IOT-AA-C003M,AVD-IOT-AA-A00XX,RTD2513A,AVD-TV001-NN-003-A,AVD-IOT-OC-A001M,AVD-IOT-DC-A001

商品及供应商介绍 - 秋田微 - May 2021 PDF 英文下载