Arduino Quick Start
2. Devices & Examples
StackChan
3. M5Unified
4. M5GFX
5. Extensions
Unit
Atomic
Base
IoT
Accessories
Atom‑Lite/Matrix Arduino Example Program Compilation & Upload
1. Preparation
- 1. Arduino IDE installation: Refer to the Arduino IDE Installation Guide to install the IDE.
- 2. Board Manager: Refer to the Basic Environment Setup Guide to install the M5Stack board package and select the development board
M5Atom.
- 3. Library installation: Follow the Library Management Installation Guide to install the
M5UnifiedandM5GFXdriver libraries and any required dependencies.
2. USB Driver Installation
Driver Installation Prompt
Connect the device to the PC, open the Device Manager to install the [FTDI Driver] (https://ftdichip.com/drivers/vcp-drivers/). Please download the driver file that matches the operating system and extract it. Install it through the Device Manager. (Note: In some system environments, the driver will take effect only after being installed twice. Unrecognized device names are usually
M5Stack or USB Serial. For Windows, it is recommended to use the driver file to install directly in the Device Manager (custom update), while the executable file installation method may not work properly.)FTDI VCP Driver Download Page:
Installation Method:
MacOS note
On macOS, before installing the driver open
System Preferences → Security & Privacy → General and allow apps downloaded from App Store and identified developers if prompted.3. Port Selection
Connect the device via USB. After the driver is installed, select the corresponding serial port in the Arduino IDE.
4. Program Compilation & Upload
Open the example sketch LogOutput from the driver library, set Tools -> Core Debug Level to Info, then click Upload. The sketch will be compiled and flashed automatically.
Example serial output:
[0;31mM5.Log error log [0m
[0;33mM5.Log warn log [0m
[0;32mM5.Log info log [0m
[0;36mM5.Log debug log [0m
[0;37mM5.Log verbose log [0m
[0;31m[ 386][E][LogOutput.ino:63] setup(): M5_LOGE error log [0m
[0;33m[ 393][W][LogOutput.ino:64] setup(): M5_LOGW warn log [0m
[0;32m[ 399][I][LogOutput.ino:65] setup(): M5_LOGI info log [0m
[0;36m[ 404][D][LogOutput.ino:66] setup(): M5_LOGD debug log [0m
[0;37m[ 411][V][LogOutput.ino:67] setup(): M5_LOGV verbose log [0m
M5.Log.printf non level output
[0;33m[ 1407][W][LogOutput.ino:79] loop(): BtnA 1 click [0m
[0;37m[ 1443][V][LogOutput.ino:93] loop(): count:1 [0m
[0;37m[ 2467][V][LogOutput.ino:93] loop(): count:2 [0m
[0;37m[ 3491][V][LogOutput.ino:93] loop(): count:3 [0m
...