新硬件形态:WizFi360 WiFi 版
基于 RP2040 + WizFi360 WiFi 模块,通过 WiFi TCP 与 PC
通信,无需蓝牙。
| 特性 |
说明 |
| 主控 |
RP2040(WizFi360-EVB-Pico) |
| 通信 |
WiFi TCP(端口 57321) |
| 输出 |
WS2812×2 双灯 + MAX98357A 扬声器 |
| 传感器 |
振动传感器 + 马达 |
| 供电 |
USB 即插即用 |
新功能
- 静态 IP 自动分配:GUI 自动扫描局域网空闲
IP,注入设备配置,无需手动查 IP
- GUI 桥接按钮:烧录+配对后,在 GUI
内一键启动守护进程,无需另开终端
- 烧录后自动获取 IP:wizfi360 烧录完成后自动从串口抓取设备 IP
并完成配对
- wizfiatcontrol 库:封装 WiFi 连接、TCP Server、AT 指令收发
改进
- +IPD 格式解析修复(匹配 WizFi360 实际响应格式)
- 振动传感器 PULL_DOWN 修复(RP2040 GPIO 浮空导致 IRQ 不触发)
- surrogate 字符清理(防止 daemon 推送含 emoji 的消息崩溃)
- config 覆盖正则修复(缩进行的 WIFI_SSID/WIFI_PASSWORD 正确替换)
文档
- 全部文档更新为四种硬件形态(dshell / panel / clock / wizfi360)
- setup_tool_guide 新增 WizFi360 分叉路径截图(WiFi 配置 / TCP 配对)
- firmware/README.md 新增库文件说明
- presentation 更新至 v1.1.0
四种硬件形态
| 形态 |
主控 |
通信 |
输出 |
| D-Shell |
ESP32-S3 |
BLE |
2.4寸触摸屏 + LVGL + WS2812×8 + 语音 |
| Panel |
ESP32-S3 |
BLE |
2.4寸触摸屏 + LVGL + 语音 |
| Clock |
ESP32-C3 |
BLE |
WS2812×2 + 语音 |
| WizFi360 🆕 |
RP2040 |
WiFi TCP |
WS2812×2 + 语音 + 振动 |
安装
# CLI 烧录(新形态)
python scripts/flash_device.py --variant wizfi360 \
--wifi-ssid "MyWiFi" --wifi-password "password"
# 或使用 GUI 一键工具
dist/Claude_Assistant_Setup.exe
WizFi360 使用 .uf2 固件格式(拖拽烧录),详见 [firmware/README.md]。