WB2(BL602)IPv6 双栈 Web 三色 LED —— 菜狗的LED

[AmateurNoobDog]

一个运行在 Ai-WB2-12F-Kit 开发板上的小项目:基于官方 BL602 SDK 的 IPv4/IPv6 双栈 Web 服务器(端口 8888),用浏览器控制三颗 LED,并集成 blufi 蓝牙配网。

功能亮点

• IPv4 / IPv6 双栈 Web 服务器(lwIP),IPv6 下同时支持全局地址与链路本地地址访问
• 三色 LED:红灯 IO14、绿灯 IO17、蓝灯 IO3(高电平点亮,上电默认全灭)
• 网页圆饼交互:饼图三分,点击扇区翻转对应 LED;点击后服务端立即回传权威状态 JSON,页面即时刷新(无 1s 轮询延迟,轮询仅作兜底校准)
• blufi 蓝牙配网:WiFi 凭据存入 easyflash(ROUTER_SSID / ROUTER_PWD),配网成功后自动重启;已配置则直接以 STA 模式连接
• IPv6 全局地址保活:修复"重启一段时间后全局地址消失"的问题——每 60s 主动发送 Router Solicitation,触发路由器重新下发 RA 续期 valid lifetime(实测 valid_life 到期前回弹)
• 双栈绑定 IP6_ADDR_ANY、接收超时 + 监听自动重建,web 服务稳定不假死

硬件

器件	引脚
红色 LED	IO14
绿色 LED	IO17
蓝色 LED	IO3

使用 Ai-WB2-12F-Kit 开发板(BL602 RISC-V);其它 Ai-WB2 系列开发板也可直接用(引脚一致,只需按板卡上 LED 实际位置对应 IO14/17/3 接线)。

使用说明

1. 首次使用:设备无 WiFi 凭据 → 自动进入 blufi 配网模式,用手机 App(支持 blufi)扫描配网
2. 配网完成后自动重启并连接路由器
3. 浏览器访问 http://<IPv4>:8888 或 http://[<IPv6>]:8888
   • 桌面/手机打开即见圆饼,点击红/绿/蓝扇区控制对应 LED
   • 也支持直接调 REST 接口:/r、/g、/b(返回 {"r":1,"g":0,"b":0})、/status

编译烧录

cd Ai-Thinker-WB2/applications/wifi/ipv6_web_led
make          # 编译
make flash    # 烧录(921600 baud)

• 烧录串口 921600;调试日志串口 115200
• proj_config.mk 中需 CONFIG_IPV6:=1、CONFIG_BT:=1;Makefile 引入 blufi、easyflash4 组件

工程结构

applications/wifi/ipv6_web_led/
├── Makefile / proj_config.mk
└── ipv6_web_led/
    ├── main.c              # boot_mode:读flash决定配网或STA;web任务;IPv6 RS/MLD 保活任务
    ├── http_server.c/.h    # 双栈web、路由、三色LED、页面
    ├── blufi_app.c/.h      # blufi 配网
    └── easyflash_common.c/.h

关键实现细节(坑与修复)

• IPv6 全局地址失效:运营商路由 RA 下发的全局地址 valid lifetime 仅约 120s,lwIP 使能 LWIP_IPV6_ADDRESS_LIFETIMES 后倒计时归零即置 INVALID,导致"重启几分钟内能开、之后打不开"。修复:将 lwIP 的 nd6_send_rs() 由 static 暴露为公开接口,每 60s 发送 RS 触发路由器重发 RA 续期。
• MLD 保活:每 60s 通过 tcpip_callback 重新加入 ff02::1 与 solicited-node 组。
• Web 假死:netconn_set_recvtimeout(conn, 3000) + accept 循环出错重建监听;http 任务栈提升到 8192。
• 状态即时刷新:点击扇区时 /r|/g|/b 直接返回最新 JSON,页面 .then(paint) 立即更新,1s 轮询仅作兜底。
• 移动端点击高亮:为饼图加 outline:none; -webkit-tap-highlight-color: transparent; user-select: none 消除手机上的方形选中框。

说明

• 主要面向学习/演示:IPv6 双栈 Web + BLE 配网 + 状态同步。
• 若需在你的路由器环境跑通 IPv6 保活,注意确认 LWIP_IPV6_ADDRESS_LIFETIMES、LWIP_IPV6_SEND_ROUTER_SOLICIT 等宏已使能(工程内已配置)。
  一个运行在 Ai-Thinker WB2 开发板上的小项目:基于官方 BL602 SDK 的 IPv4/IPv6 双栈 Web 服务器(端口 8888),用浏览器控制三颗 LED,并集成 blufi 蓝牙配网。

功能亮点

• IPv4 / IPv6 双栈 Web 服务器(lwIP),IPv6 下同时支持全局地址与链路本地地址访问
• 三色 LED:红灯 IO14、绿灯 IO17、蓝灯 IO3(高电平点亮,上电默认全灭)
• 网页圆饼交互:饼图三分,点击扇区翻转对应 LED;点击后服务端立即回传权威状态 JSON,页面即时刷新(无 1s 轮询延迟,轮询仅作兜底校准)
• blufi 蓝牙配网:WiFi 凭据存入 easyflash(ROUTER_SSID / ROUTER_PWD),配网成功后自动重启;已配置则直接以 STA 模式连接
• IPv6 全局地址保活:修复"重启一段时间后全局地址消失"的问题——每 60s 主动发送 Router Solicitation,触发路由器重新下发 RA 续期 valid lifetime(实测 valid_life 到期前回弹)
• 双栈绑定 IP6_ADDR_ANY、接收超时 + 监听自动重建,web 服务稳定不假死

硬件

器件	引脚
红色 LED	IO14
绿色 LED	IO17
蓝色 LED	IO3

使用 Ai-Thinker WB2 开发板,SDK 为官方 Ai-Thinker-WB2(BL602 RISC-V)。

使用说明

1. 首次使用:设备无 WiFi 凭据 → 自动进入 blufi 配网模式,用手机 App(支持 blufi)扫描配网
2. 配网完成后自动重启并连接路由器
3. 浏览器访问 http://<IPv4>:8888 或 http://[<IPv6>]:8888
   • 桌面/手机打开即见圆饼,点击红/绿/蓝扇区控制对应 LED
   • 也支持直接调 REST 接口:/r、/g、/b(返回 {"r":1,"g":0,"b":0})、/status

编译烧录

cd Ai-Thinker-WB2/applications/wifi/ipv6_web_led
make          # 编译
make flash    # 烧录(921600 baud)

• 烧录串口 921600;调试日志串口 115200
• proj_config.mk 中需 CONFIG_IPV6:=1、CONFIG_BT:=1;Makefile 引入 blufi、easyflash4 组件

工程结构

applications/wifi/ipv6_web_led/
├── Makefile / proj_config.mk
└── ipv6_web_led/
    ├── main.c              # boot_mode:读flash决定配网或STA;web任务;IPv6 RS/MLD 保活任务
    ├── http_server.c/.h    # 双栈web、路由、三色LED、页面
    ├── blufi_app.c/.h      # blufi 配网
    └── easyflash_common.c/.h

关键实现细节(坑与修复)

• IPv6 全局地址失效:运营商路由 RA 下发的全局地址 valid lifetime 仅约 120s,lwIP 使能 LWIP_IPV6_ADDRESS_LIFETIMES 后倒计时归零即置 INVALID,导致"重启几分钟内能开、之后打不开"。修复:将 lwIP 的 nd6_send_rs() 由 static 暴露为公开接口,每 60s 发送 RS 触发路由器重发 RA 续期。
• MLD 保活:每 60s 通过 tcpip_callback 重新加入 ff02::1 与 solicited-node 组。
• Web 假死:netconn_set_recvtimeout(conn, 3000) + accept 循环出错重建监听;http 任务栈提升到 8192。
• 状态即时刷新:点击扇区时 /r|/g|/b 直接返回最新 JSON,页面 .then(paint) 立即更新,1s 轮询仅作兜底。
• 移动端点击高亮:为饼图加 outline:none; -webkit-tap-highlight-color: transparent; user-select: none 消除手机上的方形选中框。

说明

• 主要面向学习/演示:IPv6 双栈 Web + BLE 配网 + 状态同步。
• 若需在你的路由器环境跑通 IPv6 保活,注意确认 LWIP_IPV6_ADDRESS_LIFETIMES、LWIP_IPV6_SEND_ROUTER_SOLICIT 等宏已使能(工程内已配置)。
  ipv6_web_led_bundle.zip

[Yaqing-Zheng]

给狗哥点赞~