Ai-WB2 mDNS Demo：局域网零配置设备发现

[AmateurNoobDog]

Ai-WB2 mDNS Demo：局域网零配置设备发现

背景

在 IoT 场景中，设备获取 IP 后如何被手机/电脑发现？传统做法是硬编码 IP 或依赖云端，但：

• 硬编码 IP：换路由器、DHCP 变化就得重新配置
• 云端中转：离线不可用，延迟高，依赖公网

mDNS（Multicast DNS）是 零配置网络 的标准方案，Apple Bonjour、Google Home、Avahi 都基于它。设备在局域网广播自己的 hostname 和服务，其他设备直接用 <hostname>.local 访问，无需任何服务器。

本 demo 在 Ai-WB2（BL602）上演示 mDNS responder，让设备开机即被发现。

---

功能亮点

特性	说明
零配置	开机连 WiFi 后自动注册 mDNS 服务，无需手动设置
基于 RFC 6762/6763	使用 lwIP 标准 mDNS 实现，兼容 Bonjour/Avahi
自定义 TXT 记录	可附带设备元数据（名称、版本、类型等）
最小依赖	不需要蓝牙、云服务，仅需 WiFi + lwIP

---

快速上手

1. 配置 WiFi

编辑 mdns/main.c，修改 SSID 和密码：

#define ROUTER_SSID      "你的WiFi名称"
#define ROUTER_PWD       "你的WiFi密码"

2. 编译烧录

cd applications/protocols/mdns
make -j6
make flash

3. 查看串口输出

打开串口终端（115200 波特率），看到以下内容表示成功：

[OS] mDNS demo starting...
[APP] [EVT] INIT DONE 0
[APP] [EVT] MGMR DONE 12
[APP] [EVT] connecting to your_ssid:your_pwd...
[APP] [EVT] connected 3456
[APP] [EVT] GOT IP 5678
[SYS] Memory left is 123456 Bytes
[MDNS] registered: Ai-mdns-XXYYZZ.local (_mdns_demo._tcp port 8080)

---

局域网验证

设备注册成功后，在同一局域网的电脑/手机上验证：

Linux（Avahi）

# 发现所有 mDNS 服务
avahi-browse -a

# 只查找 _mdns_demo 服务
avahi-browse -r _mdns_demo._tcp

# 直接 ping 设备
ping Ai-mdns-XXYYZZ.local

macOS（dns-sd）

# 浏览服务
dns-sd -B _mdns_demo._tcp

# 查看服务详情
dns-sd -L "Ai-mdns-XXYYZZ" _mdns_demo._tcp

# ping 设备
ping Ai-mdns-XXYYZZ.local

Windows

Windows 10+ 原生支持 mDNS，直接在浏览器访问：

http://Ai-mdns-XXYYZZ.local:8080

或安装 Bonjour Print Services 获得完整支持。

---

代码解读

核心 mDNS 注册流程只有 4 步：

static void start_mdns(void)
{
    // 1. 获取 WiFi 网络接口
    struct netif *netif = wifi_mgmr_sta_netif_get();

    // 2. 从 MAC 地址生成唯一 hostname
    //    格式: Ai-mdns-XXYYZZ（XXYYZZ 为 MAC 后 3 字节）
    uint8_t mac[6];
    char hostname[32];
    wifi_mgmr_sta_mac_get(mac);
    snprintf(hostname, sizeof(hostname), "Ai-mdns-%02X%02X%02X",
             mac[3], mac[4], mac[5]);

    // 3. 初始化 mDNS 并注册网络接口
    mdns_resp_init();
    mdns_resp_add_netif(netif, hostname, 3600);

    // 4. 注册服务（类型 + 端口 + TXT 记录回调）
    mdns_resp_add_service(netif, hostname,
                          "_mdns_demo",     // 服务类型
                          DNSSD_PROTO_TCP,
                          8080,             // 端口
                          3600,             // TTL
                          mdns_txt_cb,      // TXT 回调
                          NULL);
}

TXT 回调用于附带设备元数据：

static void mdns_txt_cb(struct mdns_service *service, void *txt_userdata)
{
    mdns_resp_add_service_txtitem(service, "name=mdns_demo", ...);
    mdns_resp_add_service_txtitem(service, "version=1.0", ...);
}

---

自定义指南

改服务类型

修改 main.c 中的宏定义，适配你的应用：

// 例如注册为 HTTP 服务
#define MDNS_SVC_TYPE   "_http._tcp"
#define MDNS_SVC_PORT   80

// 例如注册为 Home Assistant 设备
#define MDNS_SVC_TYPE   "_aitinker"
#define MDNS_SVC_PORT   9100

添加更多 TXT 记录

在 mdns_txt_cb() 中增加你需要的字段：

static void mdns_txt_cb(struct mdns_service *service, void *txt_userdata)
{
    mdns_resp_add_service_txtitem(service, "type=sensor", ...);
    mdns_resp_add_service_txtitem(service, "fw=1.0.0", ...);
    mdns_resp_add_service_txtitem(service, "model=WB2-12F", ...);
}

改 hostname 前缀

#define MDNS_HOSTNAME_PREFIX  "MyDevice"  // → MyDevice-XXYYZZ.local

---

文件结构

applications/protocols/mdns/
├── Makefile              # 构建入口，引入 lwip_mdns 组件
├── proj_config.mk        # SDK 配置（WiFi 开启，蓝牙关闭）
├── GITHUB_POST.md        # 本文档
├── README.md             # 快速上手指南
└── mdns/
    ├── bouffalo.mk       # 组件编译规则
    └── main.c            # mDNS demo 核心代码（181 行）

---

API 参考

函数	说明
mdns_resp_init()	初始化 mDNS responder，在添加 netif 之前调用
mdns_resp_add_netif(netif, hostname, ttl)	为网络接口注册 hostname，开始 mDNS 响应
mdns_resp_add_service(netif, hostname, svc, proto, port, ttl, txt_fn, userdata)	注册一个服务实例
mdns_resp_add_service_txtitem(service, txt, len)	在 TXT 回调中添加键值对
mdns_resp_deinit()	释放 mDNS responder（移除 netif 后调用）

---

FAQ

Q: hostname 重复怎么办？

mDNS 协议内置冲突检测（probing）。如果两个设备用了相同 hostname，后加入的设备会被协议层拒绝并触发 rename。

Q: 能同时注册多个服务吗？

可以。对同一 netif 多次调用 mdns_resp_add_service() 即可，例如同时注册 _http._tcp 和 _mqtt._tcp。

Q: 支持 IPv6 吗？

lwIP mDNS 实现支持 IPv4 和 IPv6，取决于你的网络接口是否启用了 IPv6。

Q: 能被 Home Assistant 自动发现吗？

是的。将服务类型改为 _aitinker._tcp 并按 HA 协议填写 TXT 记录，即可被 Home Assistant 自动发现。

---

相关资源

• RFC 6762 - Multicast DNS
• RFC 6763 - DNS-Based Service Discovery
• lwIP mDNS 文档
• Ai-Thinker WB2 SDK

---

如有问题，欢迎在 Issues 提问。
附件:
mdns_demo.zip

[SeaHi-Mo]

这个要点赞，我都没折腾过的功能

[AmateurNoobDog]

这个要点赞，我都没折腾过的功能

我也是最近搞HA集成发现用ip连接设备,ip变了就要重新配置,mDNS解决了这个问题,就让Ai搞了个demo出来

[Gu-Yi8023]

厉害啊狗哥