产品内置固件升级教程

简介

部分 M5Stack 产品内置了独立的协处理器（例如 STM32）。产品发布新的功能或问题修复时，可通过 I2C 通信接口更新协处理器中的内置固件。

升级时需要使用一台作为 HOST 的主控设备。HOST 固件中包含用于升级从机的内置固件数据；用户通过 HOST 提供的网页下达升级指令后，HOST 会通过 I2C 接口将固件数据传输并写入从机。完整流程如下：

1. 根据产品型号和 HOST 主控平台，烧录对应的 HOST 固件；
2. 按照产品说明连接 HOST 和待升级从机，并给设备上电；
3. 等待 HOST 启动 AP，使用手机或电脑连接该 AP；
4. 通过浏览器打开 192.168.4.1，进入本地升级页面；
5. 在网页中确认 HOST 和通信配置，检测从机并写入内置固件。

不同产品使用的 HOST 型号、通信引脚、AP 名称和升级页面可能不同，请以对应产品页面和升级页面显示的配置为准。本教程以 Faces Gamepad3 作为界面示例，页面截图来自该产品，其他支持此功能的产品可按照相同流程操作。

操作步骤

1. 烧录 HOST 固件

根据产品型号和 HOST 芯片类型，在产品页面或下方表格中选择对应的 HOST 固件链接，进入 M5Burner Web 固件烧录页面，并按照页面提示完成烧录。

2. 连接硬件并启动设备

HOST 固件烧录完成后，按照产品说明将 HOST 和待升级从机正确连接，并给设备提供稳定电源。

设备启动后，HOST 会进入 AP（Access Point）模式。该 AP 仅用于让手机或电脑访问 HOST 提供的网页并下达操作指令，不用于传输固件数据。使用手机或电脑连接 HOST 的 AP，AP 名称以产品说明或设备实际显示的名称为准。

3. 连接 AP 并打开控制页面

手机或电脑连接 HOST 的 AP 后，打开浏览器访问 http://192.168.4.1，进入内置固件升级控制页面。

4. 确认 HOST 和通信配置

在升级页面确认自动识别的 HOST 型号、通信接口和 SDA/SCL 引脚是否正确。如果识别结果不正确，请根据实际硬件连接手动修改；如果所使用的 HOST 不在列表范围内，请选择 Other device，并按照页面提示配置通信引脚。

5. 检查设备连接

点击页面中的设备检测按钮，检查 HOST 与待升级从机之间的 I2C 通信状态。

6. 开始升级

检测成功后点击 Start firmware upgrade，进入固件升级确认页面。

在确认窗口确认设备供电和连接稳定，勾选确保供电和连接稳定，然后单击 Write firmware。HOST 接收到网页操作指令后，会将固件中的内置固件数据通过 I2C 写入从机。

等待网页显示升级完成，并确认版本校验成功。只有页面明确显示升级完成和校验成功后，才可以断电或断开设备连接。

常见问题

升级中途断电或连接中断

1. 重新连接设备并上电，等待 HOST 完成启动。
2. 在手机或电脑的 Wi-Fi 设置中，连接 HOST 的 AP。
3. 打开 http://192.168.4.1。
4. 重新检测设备。
5. 如果页面显示恢复模式或 Bootloader，确认后重新开始升级。

恢复时会重新完整升级，不需要手动选择中断位置。

找不到设备 AP

• 确认 HOST 和待升级从机已经正确连接、上电并完成启动；
• 复位 HOST 并等待设备重新启动；
• 确认手机或电脑没有自动切回其他 Wi-Fi。

网页打不开

• 确认手机或电脑已连接 HOST 的 AP；
• 手动访问 http://192.168.4.1；
• 断开 VPN 连接，避免蜂窝网络切换时触发 VPN 自动切换。

检测不到待升级从机

• 确认待升级从机已供电；
• 确认接口和连接方向正确；
• 确认使用了产品要求的通信接口和 SDA/SCL 引脚，Core/Core2 要使用 M5-Bus；
• 确认只连接一台待升级从机；
• 重新插拔连接后再次检测。

升级失败

• 保持 HOST 和待升级从机供电稳定；
• 检查连接线和接口接触；
• 重新上电后再次检测并完整升级；
• 如果进入恢复模式，按“升级中途断电或连接中断”步骤操作。