Skip to content

MagicBox v0.1 · M09

Pre-release
Pre-release

Choose a tag to compare

View all tags
@lewangdev lewangdev released this 19 Oct 15:08
v0.1
0e9fd37

预设测试 Wi-Fi / Test Wi-Fi preset

新增 magicbox-m09-s3-hw210-v0.1-testwifi.zip 与 magicbox-m09-s3-hw210-v0.1-testwifi-full.bin：从 0x0 烧录后直接尝试连接 FOLOTOY_LAND，密码 makeitanything。默认服务器仍为 Magic Server；约 60 秒无法连接则进入配网。设备激活/云端绑定仍单独进行。

The separate testwifi full installer presets the test network. Only Wi-Fi NVS changes; the released application and every byte outside NVS remain identical to the standard full installer. No new physical Wi-Fi test is claimed. This is a complete installation image: it resets local settings and replaces the factory application. Only use the exact matching hardware profile; no full-chip erase is needed.

原无预设网络的完整固件、原应用升级包均保留。包内含中英文说明、清单与校验和。
The standard no-preset full installer and original application update remain available. Bilingual instructions, manifest and checksums are included.

完整安装 / Complete installation

现新增两种格式的组合包 magicbox-m09-s3-hw210-v0.1-bundle.zip：

  • magicbox-m09-s3-hw210-v0.1-full.bin：从 0x0 烧录的完整安装固件，会清除写入范围内的本机配置并替换原厂应用。
  • magicbox-m09-s3-hw210-v0.1.bin：原有应用升级固件，文件字节保持不变；此前已验证 app0 地址 0x410000，仍需核对实际分区及启动槽。

The new bundle contains both formats. Write *-full.bin at 0x0 for complete installation; it replaces the factory application and resets local settings in its written range. The original application-only BIN remains unchanged. Use only the exact matching profile, 16 MB flash and devices without Secure Boot/Flash Encryption. No full-chip erase is required; identity partitions are outside the full image, and existing cloud bindings are unchanged.

含中英文说明、完整包清单及 SHA-256。已完成离线镜像/分区/合并校验，完整安装包尚未进行新的空白设备真机验收。
Includes bilingual instructions, manifest and SHA-256. Offline image, partition and merge checks passed; no new blank-device physical test was performed.

简体中文

MagicBox v0.1：采用 MagicBox 独立版本体系的首个固件预发布版本。固件内应用版本为 0.1.0；当前兼容小智协议，不沿用上游的产品名或版本号。

项目 配置
适配硬件 MagicBox M09 / ESP32-S3 / HW2.1.0 / 16 MB Flash
BIN magicbox-m09-s3-hw210-v0.1.bin
ZIP magicbox-m09-s3-hw210-v0.1.zip
默认服务 https://magic.folotoy.cn/xiaozhi/ota/
配网热点 FoloToy-XXXX，配置页面 http://192.168.4.1

配网后在 Magic Console 使用激活码绑定。Voice 按住说话，Mode 切换对话模式。保留旋钮音量和现有运动唤醒实现。

Magic Server 面向多协议扩展，当前支持小智兼容协议，未来计划增加更多协议。现有协议路径、源码移植目录及上游署名保留兼容性和来源信息，不作为 MagicBox 的产品命名。

附件包含应用 BIN、中英文说明 ZIP、构建清单和 SHA-256。ESP-IDF 6.1 构建通过；8 项仓库测试通过；126 项小智移植测试运行成功，2 项条件跳过；镜像与压缩包校验通过。

这是应用升级包，不是全量出厂包。需独立确认实际硬件、分区、启动槽和备份；此前测试的 M09 app0 位于 0x410000。保留原厂固件、身份、NVS 和 OTA 选择数据。此版本按自身版本号从 0.1.0 开始，旧上游版本号 2.5.3 不能用作本项目新版本系列的大小比较依据；本次不配置自动 OTA。

功能源码继承此前 M09 真机验证，版本标识已变更。此新二进制未重新烧录验收。附件仅适配上表硬件，C5 及其他 PCB 需独立版本。

中文使用说明

English

MagicBox v0.1 is the first firmware prerelease under MagicBox's independent
version scheme. The embedded application version is 0.1.0. It currently
supports the XiaoZhi protocol; upstream product names and version numbers do
not define MagicBox release naming.

  • Hardware: MagicBox M09 / ESP32-S3 / HW2.1.0 / 16 MB flash.
  • Assets: magicbox-m09-s3-hw210-v0.1.bin, matching ZIP with bilingual instructions, build manifest and SHA-256 checksums.
  • Default service: https://magic.folotoy.cn/xiaozhi/ota/.
  • Provisioning: join FoloToy-XXXX, open http://192.168.4.1, then bind the activation code in Magic Console.
  • Voice is push-to-talk; Mode changes conversation mode. Knob volume and existing motion-wake implementation are retained.

Magic Server is intended to support multiple open device protocols. XiaoZhi
compatibility is available today; additional protocols are planned. Existing
protocol paths, port source directories and upstream attribution are retained
for compatibility and provenance.

Validation: ESP-IDF 6.1 build, 8 repository tests, 126 port host tests with 2
conditional skips, and firmware/archive validation passed. This is an
application-only update. Verify the actual hardware, partition map, boot slot
and private backups before updating; the previously tested M09 uses app0 at
0x410000. Preserve factory firmware, identity, NVS and OTA-selection data.
The previous upstream-based version 2.5.3 and the independent 0.1.0 series are
not directly comparable for OTA version ordering. No automatic OTA rollout is
configured by this release.

Functionality inherits prior M09 device evidence; the application version marker
changed. This new binary has not been flashed for fresh acceptance. C5 and
other PCB revisions require independent releases.

English guide

Branch naming update / 分支更新

MagicBox firmware source is now demo/magicbox. The separately recreated demo/xiaozhi targets the original XiaoZhi service. v0.1 firmware bytes and the pinned source commit are unchanged; this update corrects branch links, manifest branch metadata and ZIP instructions.

MagicBox 固件源码分支现为 demo/magicbox；新建的 demo/xiaozhi 对接原小智服务。v0.1 固件二进制和固定源码提交未变，仅更新分支链接、清单分支信息和压缩包说明。

Assets 14
Loading