如何使用测试工具

# 如何使用测试工具

## 一. 软件介绍
**SmartHWTool** 是一款用于测试和调试智能硬件的专用工具软件。软件界面包含多个功能标签页：Download、Server、OTA、Serialization、Chart、NetLog、TCP Server等。

## 二. 功能标签页说明
### 2.1 Download（下载）标签页
- 用于固件下载和烧录
- 支持选择串口和波特率
- 可以选择固件文件进行烧录
- 显示下载进度和结果

### 2.2 Server（服务器）标签页
- MQTT服务器连接配置
- 设备参数设置和获取
- 控制命令发送
- 状态查询和设置
- 消息收发监控

### 2.3 OTA（在线升级）标签页
- 支持设备远程固件升级
- 可选择升级文件
- 显示升级进度
- 支持升级结果确认
- 可查看当前固件版本

### 2.4 Serialization（序列化）标签页
- 设备序列号读写
- MAC地址配置
- 产品信息配置
- 批量设备初始化

### 2.5 Chart（图表）标签页
- 实时数据波形显示
- 支持多通道数据
- 可调节显示范围
- 支持数据导出
- 波形缩放和平移

### 2.6 NetLog（网络日志）标签页
- 网络通信日志记录
- 数据包分析
- 支持日志过滤
- 可导出日志文件
- 实时日志显示

### 2.7 TCP Server（TCP服务器）标签页
- TCP服务器功能
- 支持多客户端连接
- 数据收发测试
- 连接状态监控
- 自定义端口配置

## 三. 连接设置
1. 服务器配置
   - Server：输入MQTT服务器地址（例如：47.120.74.198）
   - port：输入服务器端口（例如：1883）
   - username：输入用户名（例如：admin）
   - password：输入密码
   - 点击 disable/enable 按钮启用或禁用连接

2. 设备配置
   - device No：输入设备编号（例如：0042004F）
   - 点击 subscript 按钮订阅设备消息

## 四. 功能操作说明
### 4.1 参数设置与获取
1. 设置参数（Set Parameters）
   - Select Parameter：从下拉菜单选择要设置的参数（如 voltage_calibration）
   - 在输入框中输入参数值（如 -100）
   - 点击"Set"按钮发送设置命令

2. 获取参数（Get Parameters）
   - Select Parameter：从下拉菜单选择要获取的参数
   - 点击"Get"按钮获取当前值

### 4.2 控制命令（Control Commands）
1. 发送控制命令
   - Select Command：从下拉菜单选择命令类型（如 factory_params_cmd）
   - 在命令参数框中输入具体参数
   - 点击"Send"按钮发送命令

### 4.3 状态操作
1. 设置状态（Set Status）
   - Select Status：选择状态类型（如 rssi_abs）
   - 输入设置值
   - 点击"Set"按钮

2. 获取状态（Get Status）
   - Select Status：选择要查询的状态
   - 点击"Get"按钮获取当前状态

### 4.4 消息查看
1. 发送消息（发送消息:）
   - 显示所有发送的JSON格式消息，例如：
   ```json
   {"get_param": {"soft_ver": {}}}
   {"set_param": {"voltage_calibration": -100}}
   {"ctrl_cmd": {"factory_params_cmd": ""}}
   ```

2. 接收消息（接收消息:）
   - 显示设备返回的所有消息
   - 支持自动滚动显示

## 五. 常见操作示例
1. 查询软件版本
   - 在 Get Parameters 中选择 "soft_ver"
   - 点击 "Get" 按钮
   - 在接收消息区域查看返回结果

2. 电压校准
   - 在 Set Parameters 中选择 "voltage_calibration"
   - 输入校准值（如 -100）
   - 点击 "Set" 按钮
   - 可在接收消息区域确认设置结果

3. 恢复出厂设置
   - 在 Control Commands 中选择 "factory_params_cmd"
   - 点击 "Send" 按钮
   - 等待设备重启完成

4. 配置私有服务器
   a) 修改服务器参数
      - 在 Server 标签页中选择 Set Parameters
      - 设置 MQTT 服务器地址：
        - Select Parameter 选择 "mqtt_server"
        - 输入服务器地址（如 "192.168.1.100"）
        - 点击 "Set" 按钮
      - 设置 MQTT 端口：
        - Select Parameter 选择 "mqtt_port"
        - 输入端口号（如 "1883"）
        - 点击 "Set" 按钮
      - 设置 MQTT 用户名：
        - Select Parameter 选择 "mqtt_username"
        - 输入用户名
        - 点击 "Set" 按钮
      - 设置 MQTT 密码：
        - Select Parameter 选择 "mqtt_password"
        - 输入密码
        - 点击 "Set" 按钮
   
   b) 重要说明
      - 所有参数修改完成后，必须重启设备才能生效
      - 可以通过发送重启命令重启设备：
        - Select Command 选择 "reboot_cmd"
        - 点击 "Send" 按钮
      - 重启后设备将连接到新配置的服务器
      - 建议修改服务器配置前先记录当前配置，以便出现问题时恢复

## 六. 注意事项
1. 操作建议
   - 修改参数前先获取当前值，以便确认修改是否成功
   - 重要操作前请先确认设备状态
   - 保持软件版本为最新版本

2. 故障排除
   - 如果连接失败，检查服务器地址和端口是否正确
   - 如果消息发送失败，检查设备编号是否正确
   - 如果参数设置失败，检查输入值是否在有效范围内

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