This tutorial applies to BASIC / GRAY / M5GO / FIRE / FACES kit
Before the program is burned, M5Core host (including BASIC / GRAY / M5GO / FIRE / FACES) users please download the corresponding CP210X driver package according to the operating system you use. After decompressing the package，select the corresponding installation package base on your operating system digits.
For Mac OS, make sure System preferences - > Security & Privacy - > General before installing, and allow the apps to be installed from the App Store and ident ified developers
Please click the button below to download the corresponding M5Burner firmware burning tool according to your operating system. Unzip and open the application.
Note: MacOS users please put M5Burner App in the Application folder after the installation as shown in the figure below.
Note: For Linux users, please switch to the decompressed file path and run
./M5Burner in the terminal to run the application.
1.Double-click to open the Burner burning tool, select the corresponding device type in the left menu, select the firmware version you need, and click the download button to download.
2.Then connect the M5 device to the computer through the Type-C data cable, select the corresponding COM port, the baud rate can use the default configuration in M5Burner, i In addition, you can also fill in the device to be connected later during the firmware burning stage WIFI information. After configuration, click "Burn" to start burning.
3.When the burning log prompts
Burn Successfully, it means that the firmware has been burned.
When first burning or the firmware program runs abnormally, you can click "Erase" to erase the flash memory so that there is no need to erase again in the subsequent firmware update. Otherwise, the Wi-Fi information which is saved already will be deleted and the API Key will be refreshed.
UIFlow provides both offline and web version of the programmer. When using the web version, we need to configure a WiFi connection for the device. The following describes two ways to configure WiFi connection for the device (Burn configuration and AP hotspot configuration).
UIFlow-1.4.5 and the above versions are in support of the pre-burning configuration under WIFI connnection. All users need to do is to fill in WIFI configuration box before setting your firmware to burn. After the configuration of WIFI, clicking 'Burn' to start firmware burning so that the WIFI infomation you filled in together with your firmware will be burned and stored into your M5 device.
Note: Special characters such as "space" are not allowed in the configured WiFi information.
Network programming mode is a docking mode between M5 device and UIFlow web programming platform. The screen will show the current network connection status of the device. When the indicator is green, it means that you can receive program push at any time. Under default situation, after the first successful WiFi network configuration, the device will automatically restart and enter the network programming mode. If you do not know how to re-enter the programming mode after running other applications, you can refer to the following operations.
After booting, quickly press the right button on the panel to enter the Setup page after the menu appears on the screen, select "Internet Mode", and use a computer browser to access flow.m5stack.com Enter the UIFlow programming page.
API KEY is the communication credential for M5 devices when using UIFlow web programming. By configuring the corresponding API KEY on UIFlow side, programs can be pushed for the specific devices. The user needs to visit flow.m5stack.com in the computer web browser to enter the UIFlow programming page . Click the setting button in the menu bar at the upper right corner of the page, enter the API Key on the corresponding device, select the hardware for connecting, click OK to save and wait till it prompts successfully connecting
With the above steps being settled, you can start programming with UIFlow. The following will show you a simple program that drives the screen to display "Hello M5". (1. Place a label 2. Add a label program block .3 Click the run button in the upper right corner)
UIFlow Desktop IDE is an offline version of UIFlow programmer which does not require network connection, and can provide you with responsive program push experience. Please click the corresponding version of UIFlow-Desktop-IDE to download according to your operating system .
Unzip the downloaded UIFlow Desktop IDE archive and double-click to run the application.
After the app starts, it will automatically detect whether your computer has a USB driver (CP210X), click Install, and follow the prompts to finish installation.
After the driver installation is completed, it will automatically enter the UIFlow Desktop IDE with the configuration box popping up. At this time, connect the M5 device to the computer via the Tpye-C data cable.
Using UIFlow Desktop IDE requires M5 device with UIFlow firmware and enter USB programming mode.
Click the power button on the left side of the device to restart. Quickly select Setup after entering the menu, enter the configuration page, and select USB mode.
Select the corresponding port, and the programming device, click OK to connect.
-Introduction to UIFlow
-Video tutorial for developing M5Core in UIFlow