免编译通用固件 v1.0（Universal Firmware）

免编译通用固件 v1.0（2026-09-22 重新编译）

给没有 ESP-IDF 编译环境的人用 —— 下载后直接刷机。

适用硬件

• M5Stack StackChan（CoreS3 版本）
• ⛔ 不适用于其他板卡（没有舵机 / 灯环 / 触摸头，刷了没意义）

编译环境：ESP‑IDF v6.1；对应上游固件 78/xiaozhi-esp32 = 5d54beb7（2026‑09‑15）
—— 这是作者设备上实测过的那个上游版本；想自己编出跟这个固件一致的东西，就取它
（版本表与取法见 INSTALL.md §0.5）。

文件与校验

文件	md5
fairy-stackchan-universal.bin（整机合并固件，烧到 0x0）	034b0b58516625017e382d29341e83fc

特性

• ✅ 双皮肤（Fairy ⇄ 官方几何脸），按电源键切换
• ✅ 摸头 → 抬头 + 冒爱心；甩晕 → 转圈
• ✅ 双唤醒词：「Hi Fairy」+「你好小智」
• ✅ 可以在设备自己的配网页里填服务器地址（免编译，也不用念 IP）
• ✅ 也支持语音设置地址（self.server.set_ota_url）
• ✅ 不含作者的任何私有配置（无内网 IP、无 API Key）

★ 刷完后第一件事：填你自己的服务器地址

固件不含任何服务器地址 ⇒ 第一次开机会去连官方服务器（api.tenclass.net）。
要连你自己的服务器，这样填（不需要重新编译固件）：

① 让设备进【配网模式】
     全新设备：第一次开机会自动进
     已配网的设备：开机后趁屏幕还在「启动中」时点一下屏幕；
                   或者让 WiFi 连不上，它也会自动进
② 手机连设备开的热点（名字见屏幕提示，形如 Xiaozhi-XXXX）
③ 浏览器打开屏幕上显示的那个地址
   → 点上方「高级选项」页签（英文界面是 Advanced）
   → 在「自定义 OTA 地址」里填：
         http://<你的服务器IP>:<端口>/xiaozhi/ota/     ← 端口默认 8003
   → 点「保存」
④ 回「Wi-Fi 配置」页签，填你家 WiFi 的账号密码
   → 设备重启，就直接连你的服务器了

⚠️ 那一页的「保存」会真的写进设备 —— 只想看看就别按保存。
同页另外三项（Wi-Fi 最大发射功率 / 记住 BSSID / 启用睡眠模式）不影响连服务器，一般不用动。

其它两种办法

• 语音：设备能连上官方服务器时，直接对它说「我的服务器是 http://…」
  （AI 会调设备本地工具把地址写进 NVS）
• 编译期地址：想一劳永逸、刷完即连，就用 CONFIG_OTA_URL 把地址编进固件
  ⇒ 给朋友用连配网都不用，见下面的「路径 A」

详细步骤（含改端口、排错）见
firmware-bin/README.md 第三节，
以及 INSTALL.md 的 §2.5（烧录）与 §3（合流）。

怎么刷

见 firmware-bin/README.md
（网页烧录器 / esptool / M5Burner 都写了）。

版权

• 本项目是非官方同人作品，与米哈游 / HoYoverse 无任何关系
• 许可分层（详见 CREDITS.md）：
  • 本项目代码：MIT ⇒ ✅ 可自由使用，包括商业用途
  • Fairy 的美术形象 ⇒ ⛔ 权利人是米哈游，商用需授权
  • 音色 / 参考音频 ⇒ ⛔ 权利人是原声者（本固件不含音频、不含音色模型）
• ⚠️ 如实披露：本固件内嵌了 2 个表情动画 GIF（约 2 MB，作者自用素材）。
  它们不在本仓库里（仓库里只有 1 张控制台界面截图 docs/console-home.png，
  不含任何角色素材），但在这个固件里 ——
  二次分发 / 商用前请自行确认这几个 GIF 的版权（见 CREDITS.md）。