灵活固件

固件特性

• 灵活适配
  采用 “通用固件 + JSON 配置” 架构，实现单一固件适配多类硬件，践行 “一次编译，处处运行” 的设计理念。
  在 2.0 版本中，进一步引入 “灵活插件” 机制，轻松扩展设备能力边界。

• 功能丰富
  支持免编译切换硬件、UI 风格、服务器及虚拟身份，集成主流大模型 AI 对话、在线音乐、网络电台、本地音乐、闹钟、相册等多元化功能。

• 安全稳定
  灵活固件仅私有 OTA 升级时需连接专用服务器，其余功能均在设备端(ESP32)内部独立实现，即使停服也仅无法更新升级，不影响正常使用。
  偏好、插件、相册图片等数据均存储于本地(ESP32 Flash)不经过云端保障隐私安全；AI 对话、音乐、电台、天气等服务则直连主流厂商，避免私人服务器停服设备无法使用的问题。

固件选择

灵活固件分为通用固件和专用固件： 固件列表 >>

硬件要求

组件	要求	说明
主控	必须	ESP32-S3-N16R8
拾音	必须	ICS-43434、INMP441 或其它 I2S 麦克风
功放	必须	MAX98357 或其它 I2S 功放
音频	兼容	ES8311 (Flex1.6.3.36 开始支持)
屏幕	可选	ST7789、ST77916 等各种尺寸的 SPI/QSPI 接口屏幕
储存	可选	SDMMC 1Bit 兼容 4 线 SPI 接口

自动升级

设备每次开机会检测服务器端是否有新版本固件，发现新固件会根据偏好设置中的 OTA 等级决定是否自动升级。

手动烧录

请在群文件（群号：1041054478）下载固件及刷机工具。

TIP

固件仅供个人玩家测试体验，如需要批量使用或定制服务请加群联系。

WARNING

在烧录灵活固件之前可使用flash_download_tool备份您的原始固件，烧录灵活固件后如果无法适配可随时烧录回原始固件。

烧录说明

1. 打开 flash_download_tool_3.9.8_2.exe 下拉选择 ESP32S3 点击 OK 开启软件。
2. 勾选第一行，点击 ... 选择 bin 文件，烧录地址填写 0x00。
3. 左下角的 COM 下拉选择正确的设备串口号。
4. 点击 START 开始下载固件进设备。
5. 等待下载完成重启设备即可。

常见问题

烧录灵活固件设备黑屏，喊唤醒词也没反应？

灵活固件分为通用固件和专用固件，如果烧录的是通用固件或烧录的专用固件与实际硬件不符则无法正常使用，如果是量产设备可加群找群友分享的配置 JSON，如果是自制硬件则按原理图配置参数。

为什么内存卡里上千首歌，AI 只能调用一百首？

由于 AI 服务器协议限制了 MCP 数据包大小，故无法将全部歌曲列表上传给 AI，当歌曲列表太长时会自动截断，目前测试能上传歌曲数量约 100 首，仅 AI 点歌时有此限制，随机播放或顺序播放本地歌曲时无数量限制。

TIP

更多问题请加群讨论。 群号：1041054478