HLK-RM04_DISCOVER搜索不到设备？

Question

在使用HLK-RM04模块进行设备发现时，常有开发者反馈通过HLK-RM04_DISCOVER广播无法搜索到设备。该问题通常源于模块未处于正确的发现模式（如未启用UDP广播或未进入AP/Station混杂模式），或网络配置错误（如IP子网不一致、防火墙阻断广播包）。此外，发送的发现报文格式不符合官方协议规范，或目标模块固件版本过旧，亦会导致搜索失败。建议检查模块工作模式、确保局域网通信正常，并使用抓包工具验证广播包是否发出。

Answer 1

一、问题现象与初步排查

在使用HLK-RM04模块进行设备发现时，开发者常反馈通过HLK-RM04_DISCOVER广播无法搜索到目标设备。该问题直接影响设备的自动化部署和网络集成效率。

最直观的表现是：客户端发送发现请求后，未收到任何来自HLK-RM04模块的响应。此时应首先确认以下几点：

1. 目标模块是否已上电并正常启动；
2. 模块是否处于可被发现的状态（如AP模式或Station混杂模式）；
3. 发送端是否在同一局域网子网内；
4. 防火墙或路由器是否阻止了UDP广播包（默认端口通常为50000）；
5. 发现报文是否符合官方定义的数据格式。

二、技术原理与协议规范解析

HLK-RM04模块支持基于UDP广播的设备发现机制，其核心依赖于特定格式的DISCOVER报文交互。标准流程如下：

步骤	方向	协议类型	目的地址	端口	数据内容
1	Client → Module	UDP Broadcast	255.255.255.255 或 子网广播地址	50000	{"cmd":"discover"}
2	Module → Client	UDP Unicast	Client IP	随机高位端口	{"status":"ok", "mac":"xx:xx:xx:xx:xx:xx", "ip":"192.168.x.x"}

三、常见故障点深度分析

根据长期现场调试经验，导致发现失败的主要原因可分为四类：

• 模式配置错误：模块未启用混杂模式（Promiscuous Mode），或工作在纯AP模式下未开启Station监听功能；
• 网络隔离问题：VLAN划分、子网掩码不一致（如/24 vs /16）、NAT穿透限制等导致广播域分离；
• 报文格式偏差：JSON结构缺失字段、编码错误（如非UTF-8）、大小写敏感性未处理；
• 固件兼容性缺陷：早期版本固件对discover命令响应逻辑存在bug，需升级至v1.3.2以上。

四、诊断流程与抓包验证

推荐采用系统化排查路径，结合Wireshark等工具进行协议层验证：

# 示例：Linux下发送标准发现报文
echo -n '{"cmd":"discover"}' | nc -u -w1 255.255.255.255 50000
    

使用Wireshark过滤表达式：udp.port == 50000 && ip.dst == 255.255.255.255，观察是否有出站广播包生成。若无，则问题出在本地主机或应用层代码。

五、解决方案与最佳实践

针对不同层级的问题，提出以下应对策略：

1. 确保模块配置为“AP+Station”双模运行，可通过AT指令AT+WMODE=3设置；
2. 检查模块IP是否与客户端处于同一子网，建议统一为192.168.1.x/24；
3. 关闭Windows Defender防火墙或添加UDP 50000入站规则；
4. 更新模块固件至最新版本，官网提供烧录工具及校验脚本；
5. 开发侧封装标准化发现函数，避免手动拼接JSON出错；
6. 部署多播替代方案（如mDNS）作为冗余发现机制；
7. 在嵌入式端启用日志输出，监控on_udp_discover_received()回调触发情况；
8. 使用Python脚本批量扫描局域网设备，提升调试效率。

六、可视化诊断流程图

graph TD
            A[开始设备发现] --> B{模块上电且运行?}
            B -- 否 --> C[检查电源与时序]
            B -- 是 --> D{处于AP/Station混杂模式?}
            D -- 否 --> E[执行AT+WMODE=3]
            D -- 是 --> F{在同一子网内?}
            F -- 否 --> G[调整IP配置]
            F -- 是 --> H{防火墙允许UDP 50000?}
            H -- 否 --> I[添加防火墙规则]
            H -- 是 --> J{发送标准discover报文?}
            J -- 否 --> K[修正JSON格式]
            J -- 是 --> L[用Wireshark抓包验证]
            L --> M{收到响应?}
            M -- 是 --> N[发现成功]
            M -- 否 --> O[升级模块固件]
            O --> P[重试发现流程]