1. Product Overview
The M5Stack ATOM Lite is an ultra-compact and versatile IoT development board, part of the M5Stack development kit series. Measuring only 24.0 x 24.0 x 9.5 mm, it is designed for embedded smart hardware development, offering extensive GPIO for user customization.
It features the ESP32-PICO-D4 solution, integrating a Wi-Fi module and a built-in 3D antenna. The board includes 4 MB of SPI flash, an Infra-Red (IR) transmitter, an RGB LED (SK6812 3535 x 1), a programmable button, and GROVE/HY2.0 interfaces. The onboard USB Type-C interface facilitates quick program upload and download, and an M2 screw hole is provided on the back for secure fixing.
Key Features:
- Based on ESP32 development
- Compact body design
- Built-in infrared transmission function
- Programmable button (GPIO39)
- RGB LED indicator (GPIO27)
- Expandable pins and interfaces (GROVE/HY2.0)
- Multiple development platform support: UiFlow1, UiFlow2, Arduino IDE, ESP-IDF, PlatformIO
Applications:
- IoT nodes
- Microcontrollers
- Wearable devices
- Home automation

2. Getting Started (Setup)
This section guides you through the initial setup of your ATOM Lite device.
2.1 Package Contents
- 1 x ATOM Lite development board
2.2 Physical Connection
- Power Supply: Connect the ATOM Lite to a 5V power source using a USB Type-C cable. The onboard USB Type-C port also allows for data communication.
- Mounting (Optional): The ATOM Lite features an M2 screw hole on its back, allowing for secure mounting in your projects or enclosures.
- External Peripherals (Optional): Utilize the GROVE/HY2.0 interfaces and 2.54mm extension pins for connecting external sensors, actuators, or other modules. Refer to the PinMap in Section 5 for pin assignments.

2.3 Software Setup
The ATOM Lite supports various development platforms. Choose the one that best suits your project needs:
- UiFlow1 & UiFlow2: Graphical programming platforms for easy development.
- Arduino IDE: Popular IDE for ESP32 development.
- ESP-IDF: Espressif IoT Development Framework for advanced users.
- PlatformIO: An open-source ecosystem for IoT development.
For detailed guides and examples, please refer to the official M5Stack documentation and tutorials:
- Arduino Library: Atom Arduino Library
- UiFlow1 Quick Start & Test Example: UiFlow1 Resources
- UiFlow2 Quick Start & Test Example: UiFlow2 Resources
- PlatformIO Configuration Example:
[env:m5stack-atom]platform = espressif32@6.7.0board = m5stack-atomframework = arduinoupload_speed = 1500000monitor_speed = 115200build_flags = -DCORE_DEBUG_LEVEL=5lib_deps = M5Unified=https://github.com/m5stack/M5Unified
- Easyloader (Factory Test): A tool for flashing factory test firmware. Download Easyloader
3. Operating Instructions
The ATOM Lite is designed for flexible operation based on your programmed logic. Here are its core interactive components:
3.1 Programmable Button
The device features a customizable button (GPIO39) for user input. Its function is determined by the firmware loaded onto the ATOM Lite.
3.2 RGB LED Indicator
An integrated RGB LED (GPIO27, SK6812 3535 x 1) provides visual feedback. Its color and pattern can be controlled programmatically to indicate status, alerts, or other information.
3.3 Infrared (IR) Transmitter
The built-in IR transmitter allows the ATOM Lite to send infrared signals, enabling control of IR-compatible devices such as air conditioners, TVs, or other home appliances.
3.4 External Interfaces
The GROVE/HY2.0 interfaces and extension pins (G19, G21, G22, G23, G25, G33) provide connectivity for a wide range of external modules, expanding the functionality of your ATOM Lite.
3.5 Functionality Demonstration Video
4. Maintenance
The M5Stack ATOM Lite is a robust development board designed for durability. No specific routine maintenance is required for the device itself. Keep the device clean and free from dust and moisture. Avoid exposing it to extreme temperatures or harsh chemicals.
5. Troubleshooting
If you encounter issues with your ATOM Lite, consider the following general troubleshooting steps:
- Power Issues: Ensure the USB Type-C cable is securely connected and providing 5V power. Try a different cable or power source.
- Connectivity Problems: Verify that the USB Type-C cable is a data-capable cable if you are trying to upload code or communicate via serial. Check your computer's device manager for proper driver installation.
- Code Upload Failure: Double-check your development environment settings (e.g., board selection, COM port). Ensure your code is correctly compiled and free of errors.
- Unexpected Behavior: Review your code logic. If using external modules, ensure they are correctly wired and compatible with the ATOM Lite's pin assignments and voltage levels.
- Firmware Corruption: If the device is unresponsive, try reflashing the factory test firmware using Easyloader or a known working program.
For more specific issues related to programming or external modules, consult the M5Stack official documentation and community forums.
6. Specifications
6.1 Technical Specifications
| Specification | Parameter |
|---|---|
| SoC | ESP32-PICO-D4, 240MHz dual core, 600 DMIPS, 520KB SRAM, Wi-Fi |
| Flash | 4MB |
| Input Voltage | 5V @ 500mA |
| Host Interface | Type-C x 1, GROVE(I2C+I/O+UART) x 1 |
| PIN Interface | G19, G21, G22, G23, G25, G33 |
| RGB LED | SK6812 3535 x 1 |
| IR | IR transmitter |
| Button | Customizable button x 1 |
| Antenna | 2.4G 3D antenna |
| Operating Temp | 0 ~ 40°C |
| Case Material | Plastic (PC) + ABS |
| Product Size | 24.0 x 24.0 x 9.5mm |
| Product Weight | 5.5g |
| Package Size | 81.0 x 65.0 x 13.0mm |
| Gross Weight | 10.9g |
6.2 Pin Assignments
| ESP32-PICO-D4 | G27 | G39 | G12 | G21 | G25 |
|---|---|---|---|---|---|
| RGB | RGB | ||||
| Button | Button | ||||
| IR | IR | ||||
| I2C | SCL | SDA |
6.3 HY2.0-4P Interface
| HY2.0-4P | Black | Red | Yellow | White |
|---|---|---|---|---|
| PORT.CUSTOM | GND | 5V | G26 | G32 |
6.4 Physical Dimensions and Weight


6.5 Schematics and PinMap


7. Warranty and Support
For warranty information and technical support, please contact the M5Stack Official Store or refer to their official website. Detailed documentation, including datasheets and further tutorials, can be found on the M5Stack website.
An additional user manual in PDF format is available for download: User Manual (PDF)
8. User Tips
- Home Assistant Integration: The ATOM Lite is an excellent choice for Home Assistant projects. When using it as a Bluetooth proxy, ensure you configure the memory partition correctly for optimal performance.
- Bluetooth Range Extension: This device can effectively extend Bluetooth range for other devices, improving connectivity in your smart home setup.
- Home Automation: Leverage the ATOM Lite's IR capabilities for automating various home appliances, such as air conditioners, that use IR remote controls.
- Quality Assurance: M5Stack products are generally recognized for their quality and reliability.
9. Frequently Asked Questions (FAQ)
- Q: What is the tape for?
- A: Information regarding the purpose of any included tape is not available in the provided documentation.