ATOM MicroPython Quick Start
This tutorial applies to ATOM LITE / MATRIX
USB driver installation
Connect the device to the PC. If the port cannot be recognized normally, the user can manually install the
FTDI driver
to fix the problem. Take the win10 environment as an example, download the driver file that matches the operating system, unzip it, and install it through the device manager. (Note: In some system environments, the driver needs to be installed twice for the driver to take effect. The unrecognized device name is usually M5Stack or USB Serial. Windows recommends using the driver file to install directly in the device manager (custom Update), the executable file installation method may not work properly).
Click here to download the FTDI driver
For MacOS users, make sure that system preferences-> Security and Privacy-> General-> App-> App Store and approved developer options are checked before installation.
Burning tool
Please click the button below to download the appropriate M5Burner firmware burning tool according to the operating system you are using. Open the application after decompression.
| Software | Link |
|---|---|
| M5Burner_Windows | Download |
| M5Burner_MacOS | Download |
| M5Burner_Linux | Download |
Pay attention:MacOSAfter the user has completed the installation, please put the application into theApplication,As shown in the following figure。
LinuxFor users, please switch to the decompressed file path and run in the terminal../M5Burner, run the application。
Firmware burning
Double-click to open the Burner burning tool, select the corresponding device class in the left menu, select the firmware of the matching device, and click the download button to download.
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, click on Burn.
In the firmware burning stage, you need to fill in the WiFi information into the WiFi configuration box. The information will be burned and saved to the M5 device along with the firmware, and click on Start to start burning. Note: If the programming timeout occurs, try to reduce the baud rate to 115200.
When the burning log prompts Burn Successfully, it means that the firmware has been burned.
When burning for the first time or the firmware program runs abnormally, you can click Erase in the upper right corner to erase the flash memory. In the subsequent firmware update, there is no need to erase again, otherwise the saved Wi-Fi information will be deleted and refreshed API KEY.
Configuration file.
If you need to modify the configuration file, please connect your M5 device to your computer through the Type-C cable and select the corresponding COM port,⑦Then you can click configuration to modify it.
APIKey: Communication credentials of M5 devices when programming with UIFlow web.
Start Mode: Configurable mode to enter after startup.
Quick Start: You can choose Quick start to skip the startup interface.
Server: Server selection.
Wifi: Configure SSID and Password for Wifi.
VSCode IDE Development.
Preparatory work.
Download. VSCode IDE:
Click here to download
Install the M5Stack plug-in: Search the plug-in market for M5Stack and install the plug-in, as shown below.
Device offline programming mode (USB mode).
Connect the M5 device to the computer through the Tpye-C cable. Then hold down the middle button while the device is powered on or rebooted until the blue breath light is released, when the blue light is always on and enters offline programming mode.
Connect to Device.
Click the Add M5Stack option in the lower left corner and select the corresponding device port to complete the connection.
LED control.
After completing the above steps, let's implement a simple lighting case program, open the M5Stack file tree, and type in the following program. Click Run in M5stack to easily turn on the small lights. If the device is reset, click the refresh button to reopen the file tree.
Sample code.
from m5stack import *
from m5ui import *
from uiflow import *
rgb.set_screen([0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0])
rgb.setColorAll(0xff0000)
Introduction to menu options.
Press and hold the middle button to enter different modes when the device is powered on or rebooted. Different colors of LED lights represent different modes. Release the button and enter the corresponding mode.
Green light UIFlow online programming mode.
Blue light Offline programming mode.
Yellow light Configure WIFI mode.
Purple Lamp Run the last downloaded program.