Atom-Matrix: Flash Firmware & Run Code

1. USB Driver Installation

Before flashing Atom-Matrix firmware, install the FTDI driver first so that the computer can recognize the device and create a virtual serial port, ensuring normal communication between the flashing tool and the device. Follow the steps below:

Connect the device to the PC, open Device Manager, and install the FTDI driver for the device. Using Windows 10 as an example, download the driver file that matches your operating system, extract it, and install it through Device Manager. (Note: In some system environments, the driver may need to be installed twice before it takes effect. Unrecognized devices are usually named M5Stack or USB Serial. On Windows, it is recommended to install directly through Device Manager using the driver files (custom update); installing via the executable may not work properly.) Click here to download the FTDI driver

2. UiFlow2 Firmware Flashing

1. Refer to the UiFlow2 Web IDE Tutorial to learn the basic workflow of UiFlow2 and complete the installation of the M5Burner firmware flashing tool.

2. Download the firmware for Atom Matrix in M5Burner, as shown below.

3. Connect the device to the computer with a USB cable. After the device is powered on, plugging in the USB port automatically enters download mode. Once connected successfully, M5Burner will display Found New Device; the device has entered programming mode and is ready for flashing.

4. In M5Burner, click the Burn button for the corresponding firmware, select the device port, and click Start.

5. Enter the Wi-Fi configuration required by the device, including Wi-Fi SSID and Wi-Fi Password, as well as any other device configuration that needs to be added or modified, then click Next to start flashing.

Configuration information:

• COM: Select the serial port corresponding to the device
• BaudRate: Baud rate for serial communication
• Server: Server address the device connects to
• WIFI SSID/WIFI Password: Wi-Fi name and password used by the device
• SNTP Server:
  • SNTP0: Alibaba Cloud NTP server (China)
  • SNTP1: Japan NTP server pool
  • SNTP2: Global public NTP server pool
• Timezone: Time zone setting
• Boot Option: Set the device boot mode after firmware flashing is complete
  • Run main.py directly: After flashing is complete, run the program in main.py directly without connecting to the network or displaying the UiFlow2 startup screen
  • Show startup menu and network setup: The device connects to the network, and devices with a screen will display the UiFlow2 startup screen
  • Only network setup: The device only performs network setup and does not display the UiFlow2 startup screen

When Burn successfully, click here to return is displayed, flashing is successful.

6. After firmware flashing is complete, if you need to modify the device configuration, keep the USB connection, restart the device, click Configure, and modify the settings according to the prompts.

3. Device Connection

The device supports connecting to UiFlow2 via Access Code (wireless network) or USB (wired connection to a computer) for program pushing and debugging. Refer to the following steps:

Access Code Wireless Connection

1. Visit uiflow2.m5stack.com to open the UiFlow2 Web IDE.

2. Make sure the device is connected to the network and obtain the Access Code: use WebTerminal to view the current valid Access Code generated by the device. Click the WebTerminal button, select the serial port for Atom-Matrix in the dialog, then click Connect to open the serial monitor. You can view the current valid Access Code and Wi-Fi connection status. (Note: If the corresponding information is not displayed, click Soft Reset to perform a soft reboot.)

4. Click Select Your Controller on the page (shown on first entry) or the Controller button to enter the Select Device page.

5. Click Connect Device, enter the access code and a custom device name, then click Confirm to connect Atom-Matrix to UiFlow2.

6. Select the connected Atom-Matrix device on the Select Device page, then click Confirm to enter the UiFlow2 programming interface.

USB Wired Connection

1. Visit uiflow2.m5stack.com to open the UiFlow2 Web IDE, and connect Atom-Matrix to the computer with a USB cable.

2. Click Select Your Controller on the page (shown on first entry) or the Controller button to enter the Select Device page.

3. Select Atom-Matrix from the device list, then click Confirm.

4. Click the WebTerminal button, select the serial port for Atom-Matrix in the dialog, and click Connect.

When the WebTerminal screen displays Connected to Serial Port!, the USB connection is successful.

4. Program Run and Download

After the device is connected to UiFlow2, you can drag Blockly blocks to edit programs.

After editing the program, click the Run Once button in the lower-right corner to run the program once for testing. Click Run Always to download the program to the device.

You can also run once or download the program in the WebTerminal window.

5. Related Links

• UiFlow2 Blockly Introduction
• UiFlow2 Firmware Source Code

Built-in Peripheral Development

• RGB
• Button
• IMU

Related Videos