HA添加海尔设备时无法发现新设备

Question

在Home Assistant中添加海尔设备时，常见问题为无法发现新设备，主要原因多为设备与HA主机不在同一局域网，或UPnP/SSDP广播通信受阻。部分海尔IoT设备依赖特定云服务进行配对，本地发现功能受限。此外，路由器启用了AP隔离或防火墙规则限制了设备间通信，也会导致扫描失败。建议检查网络连通性、确保mDNS和SSDP端口开放，并确认设备处于配网模式。

Answer 1

1. 常见现象与初步排查

在Home Assistant中添加海尔IoT设备时，用户常遇到“无法发现新设备”的提示。该问题通常表现为：启动集成配置流程后，扫描界面长时间无响应或未列出目标设备。

• 确认海尔设备与Home Assistant主机是否处于同一局域网（LAN）子网内。
• 检查设备Wi-Fi指示灯状态，判断是否已成功连接到网络。
• 验证Home Assistant系统日志（Developer Tools > Logs）中是否存在SSDP/mDNS相关错误信息。
• 重启路由器和HA主机，排除临时性网络抖动影响。

2. 网络通信机制分析

海尔设备多采用UPnP/SSDP协议进行局域网广播，以实现即插即用的自动发现功能。Home Assistant通过内置的ssdp组件监听来自设备的 NOTIFY 消息。

协议	端口	传输方式	用途
SSDP	1900/UDP	组播	设备发现
mDNS	5353/UDP	组播	主机名解析（.local）
HTTP	80/TCP	单播	设备描述获取
TCP	443/TCP	单播	云服务注册

3. 路由器层面限制排查

现代企业级或高安全设置的家用路由器可能启用以下功能，阻碍设备间通信：

1. AP隔离（Client Isolation）：禁止无线客户端之间互相访问。
2. IGMP Snooping 启用但配置不当，导致组播报文被过滤。
3. 防火墙规则阻止了239.255.255.250:1900（SSDP组播地址）的数据包。
4. UPnP功能被手动关闭，影响SSDP服务注册与发现。

建议登录路由器管理界面，依次检查并关闭AP隔离，开启IGMP Proxy或Snooping，并确保“允许本地设备发现”类选项启用。

4. Home Assistant 配置与服务验证

确保configuration.yaml中启用了必要的发现组件：

# configuration.yaml
default_config:

discovery:
  ignore:
    - homekit

同时可通过命令行工具验证SSDP监听状态：

sudo tcpdump -i any udp port 1900 -v

若无来自海尔设备的M-SEARCH响应，则说明广播链路中断。

5. 设备配网模式与云依赖深度解析

部分新型海尔空调、洗衣机等设备采用“先入云端再反向下发”的配对逻辑，其本地SSDP服务仅在特定阶段激活。

进入配网模式的方法因型号而异，常见操作包括：

• 长按电源键10秒直至指示灯闪烁。
• 同时按下“风速+模式”键维持5秒。
• 通过海尔智家App触发“重新配网”指令。

6. 网络拓扑可视化诊断（Mermaid流程图）

graph TD
            A[海尔IoT设备] -->|发送SSDP NOTIFY| B(组播IP: 239.255.255.250:1900)
            B --> C{路由器是否转发组播?}
            C -->|否| D[发现失败]
            C -->|是| E[Home Assistant主机]
            E --> F{HA是否运行ssdp监听?}
            F -->|否| G[需启用discovery组件]
            F -->|是| H[设备出现在发现列表]
            H --> I[完成OAuth或本地认证接入]

7. 高级调试手段与日志追踪

启用Home Assistant的详细日志跟踪：

logger:
  default: info
  logs:
    homeassistant.components.ssdp: debug
    homeassistant.components.haier: debug

观察日志输出中是否出现类似条目：

DEBUG (MainThread) [homeassistant.components.ssdp] Discovered haier_ac with location http://192.168.3.15:80/...

若未捕获此类消息，可使用Wireshark抓包分析局域网内是否有来自设备的SSDP报文流出。