UIFlow - ATOM U上手指南
驱动安装
将设备连接至PC，打开设备管理器为设备安装
FTDI驱动
。以win10环境为例,下载匹配操作系统的驱动文件, 并解压,通过设备管理器进行安装。（注:某些系统环境下,需要安装两次,驱动才会生效,未识别的设备名通常为M5Stack或USB Serial, Windows推荐使用驱动文件在设备管理器直接进行安装(自定义更新), 可执行文件安装方式可能无法正常工作）。
点击此处，前往下载FTDI驱动
对于MacOS用户安装前请勾选 系统偏好设置 - >安全性与隐私 - >通用 - >允许以下位置下载的App - > App Store和认可的开发者选项。
烧录工具
请根据您所使用的操作系统,点击下方按钮下载相应的M5Burner固件烧录工具。解压后打开应用程序。
| 软件版本 | 下载链接 |
|---|---|
| M5Burner_Windows | Download |
| M5Burner_MacOS | Download |
| M5Burner_Linux | Download |
注意:MacOS用户安装完成后请将应用放入Application文件夹内,如下图所示。
Linux用户请切换至解压文件路径下,在终端中运行./M5Burner, 运行应用。
固件烧录
双击打开Burner烧录工具, 在左侧菜单中选择对应的设备类, 选择匹配设备的固件, 点击下载按钮进行下载。
将M5设备通过Type-C数据线连接到电脑, Burner会自动选择对应的COM口, 波特率可使用M5Burner中的默认配置, 点击Burn。
在固件烧录阶段需将WiFi信息填入WiFi配置框, 该信息将随同固件一起烧录保存至M5设备，点击Start开始烧录。注:若出现烧录超时情况，可尝试降低波特率至115200。
当烧录日志提示Burn Successfully时,则表示固件已经烧录完成。
首次烧录或固件程序运行异常时, 可点击右上角的Erase擦除flash内存,在后续的固件更新时, 则无需再次擦除, 否则将删除已保存的Wi-Fi信息且刷新API KEY.
获取API KEY
请将您的M5设备通过Type-C数据线连接到电脑并选择对应的COM口
1. 点击configuration进行查看, API KEY信息会出现在配置框中。(请复制保存该APIKEY，它是后续用于UIFlow通信的凭证)
2. 将Start Mode配置为Internet Mode(完成该配置后，设备将自动重启进入在线编程模式)
3. 有关配置框中的其他配置项说明，请参考下方配置说明。
如果您需要修改配置文件,请将您的M5设备通过Type-C数据线连接到电脑并选择对应的COM口,然后可点击configuration进行修改。
M5Burner配置项说明
如果您需要修改配置文件, 请将您的M5设备通过Type-C数据线连接到电脑并选择对应的COM, 然后可点击configuration进行修改。
APIKEY: M5设备在使用UIFlow web编程时的通信凭证Start Mode: 可配置启动后进入的模式 Quick Start: 可选择快速启动以跳过启动界面Server: 服务器选择 Wifi: 配置Wifi的SSID以及Password
API KEY配对
将设备配置为在线编程模式后， 我们需要通过API KEY让设备与UIFlow建立起连接, 使其能够为指定的设备推送程序。用户需在电脑端浏览器访问 flow.m5stack.com 进入UIFlow编程页面, 点击页面右上角的菜单栏中的设置按钮, 输入我们在上一步骤获取的API KEY, 点击OK保存, 等待提示连接成功。
点亮RGB灯
完成上述配置后， 我们尝试编程点亮LED灯。首先， 从左侧程序块菜单中，选中Hardware->RGB->Set RGB Bar color. 将其拖拽到工作区并连接到setup。 点击右上角的三角形运行按钮，执行程序。
运行/下载程序
程序的运行/下载:
1. UIFlow在线版菜单栏中的运行按钮(三角形)为单次测试运行，设备复位后将会重新进入在线编程模式。
2. 下载按钮则会将当前程序下载至设备，并配置为开机自动运行。注意：下载的程序若涉及网络通信部分，请在程序的开头添加WiFi连接程序，离线运行模式下如需要重新进入编程模式，可参考该文档下方的模式切换说明。
设备模式切换
设备上电或重启时按住中间按键不放可进入不同模式,LED灯不同颜色代表进入不同的模式,松开按键即进入相应模式.
绿灯: UIFlow 在线编程模式蓝灯 UIFlow 离线编程模式黄灯 配置 WIFI 模式紫灯 运行最后一次下载的程序
UIFlow离线编程模式
UIFlow Desktop IDE是一个离线版的UIFlow编程器,无需网络依赖,且能够提供反应迅速程序推送体验,请根据您的操作系统,点击下方按钮对应版本的 UIFlow-Desktop-IDE 进行下载。
| 软件版本 | 下载链接 |
|---|---|
| UIFlow-Desktop-IDE_Windows | Download |
| UIFlow-Desktop-IDE_MacOS | Download |
| UIFlow-Desktop-IDE_Linux | Download |
将下载好的UIFlow Desktop IDE压缩包解压,双击执行应用程序。软件启动后,将自动检测您的电脑是否安装有USB驱动（CP210X)， ATOM设备可以忽略这一步骤，点击Skip跳过。
驱动安装完成后,将自动进入UIFlow Desktop IDE并自动弹出配置框,此时将M5设备通过Tpye-C数据线连接至电脑。然后设备上电或重启的同时按住中间按键不放,直到显示蓝色呼吸灯时松开,此时蓝色灯常亮即进入UIFlow离线编程模式. 在UIFlow Desktop IDE的配置框中选择好对应的端口,与编程设备,点击OK进行连接。若无法正常连接，可尝试更换数据线或插拔更换端口以及检查是否存在端口占用情况。
补充说明
AP热点配置WiFi
M5设备支持使用手机配置WiFi. 在设备上电或重启的同时按住中间按键不放, 直到显示黄色呼吸灯时松开, 此时黄灯常亮即进入WIFI配置模式.
1. 在WIFI配置模式下, ATOM会启用AP热点, 其SSID为: M5Stack-XXX
2. 使用手机连接该AP后，打开浏览器输入192.168.4.1进入WiFi配置页面, 输入SSID和密码进行网络连接.
3. 完成配置后，设备指示灯将表示当前状态:
- 红灯闪烁(WiFi未连接，长时间处于该状态，需检查输入的WiFi信息是否正确，或重新配置)
- 蓝灯常亮(WiFi已连接，UIFlow服务器未连接)
- 绿灯闪烁（一切连接正常, 可开始在线编程，推送程序)。
WIFI连接状态提示: 蓝灯常亮: WiFi已经连接入网但是没有连接上UIFlow服务器红灯常亮: WiFi连接网络失败, 可尝试按下中间按键重新连接网络或重启设备.