智能硬件测试教程 MQTT Client 版本

# 如何使用 SmartHWTool 测试 MQTT Client 版本硬件

## 五、MQTT Client 版本测试方法

### 5.1 使用"MQTT.fx"工具

#### 5.1.1 工具简介
![image.png](http://47.120.74.198:10086/media/202505/2025-05-17_202121_0335600.6491667759994169.png)

MQTT.fx 是一款常用的 MQTT 协议调试工具，适用于测试 MQTT Client 版本的智能硬件设备。

#### 5.1.2 适用场景
- 适用于测试设备的 MQTT 连接、消息发布与订阅。
- 可用于验证设备的命令下发、状态上报、参数设置等 MQTT 功能。

#### 5.1.3 操作步骤
1. 打开 MQTT.fx。
2. 配置 MQTT Broker 地址（如 192.168.1.199）、端口（如 1883）、用户名、密码等参数。
3. 点击"Connect"建立连接。
4. 在"Subscribe"标签页输入设备的发布主题（如 `device001/device_pub_topic`），点击"Subscribe"订阅。
5. 在"Publish"标签页输入设备的订阅主题（如 `device001/device_sub_topic`），填写要发送的 JSON 消息内容，例如：
   ```json
   {
     "ctrl_cmd": {
       "open_relay_cmd": {}
     }
   }
   ```
6. 点击"Publish"发送消息，查看设备响应。
7. 在"Subscribe"窗口查看设备上报的消息内容。

#### 5.1.4 注意事项
- Broker 地址、端口、用户名、密码需与设备配置一致。
- 主题名称需与设备实际使用的 topic 保持一致。
- 消息内容需为合法 JSON 格式。
- 设备和测试电脑需在同一局域网内。

---

### 5.2 使用"SmartHWTool"工具

#### 5.2.1 工具简介

![image.png](http://47.120.74.198:10086/media/202505/2025-05-17_202223_1854730.48655415230467336.png)

SmartHWTool 支持 MQTT 协议测试，界面化操作便于参数设置、命令下发、状态查询等典型 MQTT 交互调试。

#### 5.2.2 操作步骤
1. **连接服务器**  
   - 在 Server 区域填写 MQTT 服务器地址（如 `47.120.74.198`）、端口（如 `1883`）、用户名（如 `admin`）、密码（如 `vsykb*&(18`）。
   - 输入设备编号（device No），如 `device001`。
   - 点击 "connect" 按钮建立连接。
   - 点击 "subscript" 按钮订阅设备的发布主题（如 `device001/device_pub_topic`）。

2. **参数查询**  
   - 在 Get Parameters 区域，Select Parameter 下拉框选择要查询的参数（如 `soft_ver`）。
   - 点击 "Get" 按钮。
   - 在接收消息区域查看设备返回的参数值。

3. **参数设置**  
   - 在 Set Parameters 区域，Select Parameter 下拉框选择要设置的参数（如 `voltage_calibration`）。
   - 在输入框填写参数值（如 `-100`）。
   - 点击 "Set" 按钮。
   - 在接收消息区域确认设置结果。

4. **控制命令下发**  
   - 在 Control Commands 区域，Select Command 下拉框选择要下发的命令（如 `open_relay_cmd`、`factory_params_cmd`）。
   - 如命令需参数，可在右侧输入框填写。
   - 点击 "Send" 按钮。
   - 在接收消息区域查看设备响应。

5. **状态查询**  
   - 在 Get Status 区域，Select Status 下拉框选择要查询的状态（如 `rssi_abs`）。
   - 点击 "Get" 按钮。
   - 在接收消息区域查看设备返回的状态值。

6. **服务器参数配置**  
   - 在 Set Parameters 区域，依次设置 `mqtt_server`、`mqtt_port`、`mqtt_username`、`mqtt_password` 等参数。
   - 每项设置后点击 "Set" 按钮。
   - 修改完成后，需通过 Control Commands 区域下发 `reboot_cmd` 命令重启设备，配置才会生效。

#### 5.2.3 注意事项
- 所有参数、命令、状态等下拉框内容需与设备固件支持的协议一致。
- 服务器参数修改后必须重启设备。
- 建议修改服务器配置前先记录当前配置。
- 设备和电脑需在同一局域网内。
- 发送和接收消息区域可用于调试协议交互内容。

---

### 5.3 使用 mosquitto_pub/mosquitto_sub 工具

#### 5.3.1 工具简介
mosquitto_pub 和 mosquitto_sub 是命令行 MQTT 客户端工具，适合自动化测试和脚本集成。

#### 5.3.2 操作步骤
1. 打开命令行终端。
2. 发送控制命令（以打开继电器为例）：
   ```bash
   mosquitto_pub -h 192.168.1.199 -p 1883 -u 用户名 -P 密码 -t device001/device_sub_topic -m '{"ctrl_cmd":{"open_relay_cmd":{}}}'
   ```
3. 订阅设备上报消息：
   ```bash
   mosquitto_sub -h 192.168.1.199 -p 1883 -u 用户名 -P 密码 -t device001/device_pub_topic
   ```
4. 在订阅窗口查看设备返回的 JSON 响应。

#### 5.3.3 注意事项
- 替换 Broker 地址、端口、用户名、密码、topic 为实际设备参数。
- JSON 数据需符合协议文档格式。
- 建议在设备和电脑处于同一局域网时使用。

---

## 七、技术支持
如遇到问题，请联系技术支持：
- 邮箱：support@company.com
- 电话：400-XXX-XXXX
- 工作时间：周一至周五 9:00-18:00