Atom-Matrix 固件烧录与程序推送

1. USB 驱动安装

烧录 Atom-Matrix 固件前，请先安装 FTDI 驱动，使电脑正常识别设备并生成虚拟串口，保证烧录工具与设备正常通信。具体操作如下：

将设备连接至 PC，打开设备管理器为设备安装 FTDI 驱动。以 Windows 10 环境为例，下载匹配操作系统的驱动文件，并解压，通过设备管理器进行安装。(注：某些系统环境下，需要安装两次，驱动才会生效，未识别的设备名通常为 M5Stack 或 USB Serial，Windows 推荐使用驱动文件在设备管理器直接进行安装 (自定义更新)，可执行文件安装方式可能无法正常工作)。点击此处，前往下载 FTDI 驱动

对于 MacOS 用户，安装前请勾选 系统偏好设置 -> 安全性与隐私 -> 通用 -> 允许以下位置下载的 App -> App Store 和认可的开发者选项。

波特率限制

在进行设备程序下载操作时，推荐选用以下串口波特率选项。若采用其他速度，可能导致程序无法正常下载。
1500000 bps / 750000 bps / 500000 bps / 250000 bps / 115200 bps

2. UiFlow2 固件烧录

参考 UiFlow2 Web IDE 教程，了解使用 UiFlow2 的基本流程，并完成 M5Burner 固件烧录工具的安装。
在 M5Burner 中下载适配 Atom Matrix 的固件，如下图所示。

将设备通过 USB 线连接至电脑。设备开机后插入 USB 接口会自动进入下载模式，连接成功后 M5Burner 会弹出 Found New Device，此时设备进入编程模式，等待烧录。

在 M5Burner 中点击对应固件的 Burn 按钮，选择对应设备端口后，单击 Start。

填写该设备需要连接的 Wi-Fi 配置，包括 Wi-Fi SSID 和 Wi-Fi Password，以及其他需要添加或修改的设备配置后，点击 Next，开始烧录。

配置信息说明：

COM：选择设备对应的串口
BaudRate：串口通信的波特率
Server：设备连接的服务器地址
WIFI SSID/WIFI Password：设备连接的 Wi-Fi 名称和密码
SNTP 服务器：
- SNTP0：阿里云 NTP 服务器 (中国)
- SNTP1：日本 NTP 服务器池
- SNTP2：全球公共 NTP 服务器池
Timezone：时区设置
Boot Option：设置固件烧录完成后，设备的启动模式
- run main.py directly：烧录完成后，直接运行 main.py 中的程序，不联网且不显示 UiFlow2 的启动界面
- show startup menu and network setup：设备联网，带屏幕的设备会显示 UiFlow2 的启动界面
- only net work setup：设备仅进行联网，不显示 UiFlow2 的启动界面

当提示 Burn successfully, click here to return 时，表示烧录成功。

完成固件烧录后，如果需要修改设备配置，可以保持 USB 连接，重新启动设备，点击 Configure 选项，根据界面提示进行修改。

3. 设备连接

设备支持 Access Code (通过无线网络) 或 USB (有线连接电脑) 方式连接 UiFlow2，实现程序的推送与调试，详细可参考以下教程操作：

Access Code 无线连接

访问 uiflow2.m5stack.com 打开 UiFlow2 Web IDE。
确保设备已连接网络，并获取 Access Code：可通过 WebTerminal 查看设备当前生成的有效 Access Code。点击 WebTerminal 按钮，在弹框中选择 Atom-Matrix 的串行端口，点击 连接，打开串口监视器后即可查看当前生成的有效 Access Code 以及 Wi-Fi 连接状态。(注：如果没有显示对应信息，可以单击 Soft Reset 按钮进行软重启)

点击页面上的 Select Your Controller (首次进入时会显示) 或 Controller 按钮，进入 Select Device 页面。

点击 Connect Device，输入访问码以及自定义设备名称后，单击 Confirm 即可将 Atom-Matrix 连接到 UiFlow2 中。

Access Code 说明

1. 更换浏览器、使用隐私 / 无痕模式、清除 UiFlow 网站缓存，会导致原配对状态失效。
2. 仅关闭标签页、重启浏览器、登录或退出账号，不会影响已绑定的配对关系。
3. 设备一旦被其他浏览器绑定配对，原有浏览器的配对关系将立即失效。

在 Select Device 页面选中已经连接的 Atom-Matrix 设备，单击 Confirm，就可以进入 UiFlow2 的编程界面。

USB 有线连接

访问 uiflow2.m5stack.com 打开 UiFlow2 Web IDE，并将 Atom-Matrix 通过 USB 线连接至电脑。
点击页面上的 Select Your Controller (首次进入时会显示) 或 Controller 按钮，进入 Select Device 页面。