1. Introduction
The M5Stack ATOM Echo is a highly compact, programmable smart speaker designed for a wide range of applications, from wireless audio streaming to advanced IoT voice control. Measuring only 24x24x17mm, it integrates an ESP32 chip with built-in Wi-Fi and Bluetooth capabilities, a speaker, and a microphone. This device is ideal for developers and enthusiasts looking to implement voice assistants, smart home nodes, or custom audio projects.

Key Features:
- Compact and lightweight design (24x24x17mm, 5g product weight).
- Integrated ESP32-PICO-D4 (240MHz, Dual Core, Wi-Fi) for powerful processing and connectivity.
- Supports A2DP and BLE 4.0 for Bluetooth audio streaming.
- Built-in 0.8W speaker and SPM1423 PDM microphone.
- RGB LED (SK6812) for visual status indication.
- GROVE expansion interface for connecting external devices.
- Independent programmable button and reset button.
- Supports STT (Speech-to-Text) services for voice commands.
- Programmable with Arduino, ESP-IDF/ADF, and UI Flow.
- M2 screw hole on the back for easy mounting.
Applications:
- Wireless speaker for music playback from mobile devices.
- Voice control for smart home systems and IoT devices.
- IoT node for various smart applications.
- Custom voice assistant projects.

2. Package Contents
The M5Stack ATOM Echo package includes:
- 1 x ATOM Echo device

3. Setup and Initial Configuration
The ATOM Echo comes pre-installed with ESPHome firmware for Home Assistant integration, allowing for out-of-the-box voice assistant functionality. For other applications or custom firmware, follow the instructions below.
3.1. Connecting to Home Assistant (Pre-installed ESPHome Firmware)
- **Power On**: Connect the ATOM Echo to a power source using its USB-C port. The RGB LED will initially display red.
- **Discovery**: If your Home Assistant instance has Bluetooth enabled, the ATOM Echo should be automatically discovered as an ESPHome device.
- **Configuration**:
- In Home Assistant, navigate to Settings > Devices & Services > Integrations.
- Look for a discovered device named "m5stack-atom-21bf38" (or similar) with "ESPHome" integration.
- Click "Configure" and follow the prompts to add the device.
- Enter your Wi-Fi credentials (SSID and Password) when prompted to connect the device to your network.
- Once connected, the RGB LED will turn green.
- The device will now be available in Home Assistant, ready for voice commands (e.g., "OK Nabu, turn off the office lights").
3.2. Driver Installation (for custom firmware/development)
If you plan to flash custom firmware or use development environments like Arduino IDE or ESP-IDF, you may need to install the FTDI driver.
- **Connect Device**: Connect the ATOM Echo to your PC via the USB-C port.
- **Download Driver**: Download the appropriate FTDI driver for your operating system. A common source for the FTDI driver can be found on the M5Stack official documentation or FTDI website.
- **Install Driver**:
- **Windows**: Open Device Manager, locate the unrecognized device (often "M5Stack" or "USB Serial"), right-click, and select "Update driver". Browse to the downloaded driver file and install it. (Note: Some systems may require installing the driver twice).
- **macOS**: Go to System Preferences -> Security & Privacy -> General, and ensure "Allow apps downloaded from > App Store and identified developers" is enabled if you encounter installation issues.
For detailed instructions and driver downloads, please refer to the official M5Stack documentation or the user manual PDF.
3.3. Baud Rate Limit for Programming
When performing device program download operations, it is recommended to select one of the following serial port baud rate options for optimal performance:
- 1500000 bps
- 750000 bps
- 500000 bps
- 250000 bps
- 115200 bps
Using other speeds may result in the program being unable to download properly.
4. Operating Instructions
4.1. Wireless Speaker Mode (A2DP)
The ATOM Echo can function as a wireless speaker using the A2DP Bluetooth protocol. When powered on, the RGB LED will display red. Once connected to a wireless device (e.g., smartphone, tablet), the LED will turn green, indicating successful connection and readiness to output audio. After disconnection, the LED will revert to red.
Note: The current firmware does not support phone calls via A2DP.
4.2. Voice Assistant Mode (ESPHome/STT)
With the pre-installed ESPHome firmware, the ATOM Echo acts as a voice assistant for Home Assistant. It supports wake word detection and speech-to-text (STT) services. Simply use the configured wake word (e.g., "OK Nabu") followed by your command. The RGB LED will provide visual feedback during interaction.
4.3. Programmable Button
The ATOM Echo features an independent programmable button (G39). Its functionality can be customized through firmware. For example, it can be configured to trigger specific actions or voice commands.
4.4. RGB LED Status Display
The embedded RGB LED (SK6812) visually indicates the device's connection status and other operational states, depending on the loaded firmware. Typically:
- **Red**: Powered on, not connected or in standby.
- **Green**: Successfully connected (e.g., to Wi-Fi or Bluetooth).
- Other colors/patterns may indicate specific states or actions based on custom programming.
5. Maintenance and Precautions
5.1. General Care
- Keep the device dry and away from moisture.
- Avoid exposing the device to extreme temperatures.
- Clean the device with a soft, dry cloth. Do not use harsh chemicals or solvents.
- Handle with care to prevent physical damage.
5.2. Pin Usage Precautions
The following GPIO pins (G19/G22/G23/G33) are predefined for specific functions. Do not multiplex these pins for other purposes, as it may damage the ATOM Echo.
5.3. Playback Precautions
To prevent damage to the ATOM Echo's speaker, avoid the following operations:
- Using the I2S channel to output DC signals.
- Playing white noise for extended periods.
- Playing full-amplitude square wave audio.
6. Troubleshooting
- **Device not discovered by Home Assistant**:
- Ensure your Home Assistant instance has Bluetooth enabled and is within range of the ATOM Echo.
- Verify the ATOM Echo is powered on and its RGB LED is red (indicating it's not yet connected to Wi-Fi).
- Check your network configuration and ensure there are no firewall rules blocking discovery.
- **Cannot connect to Wi-Fi**:
- Double-check the Wi-Fi SSID and password entered during configuration.
- Ensure the ATOM Echo is within range of your Wi-Fi router.
- Try restarting the ATOM Echo and your router.
- **Voice commands not working**:
- Confirm the device is successfully connected to Home Assistant (RGB LED green).
- Ensure the wake word is correctly configured and spoken clearly.
- Check Home Assistant logs for any errors related to the ESPHome integration or voice assistant pipeline.
- **No sound from speaker**:
- Verify the device is connected via Bluetooth (LED green) if using wireless speaker mode.
- Check volume settings on the connected device or within Home Assistant.
- Ensure no playback precautions (Section 5.3) are being violated.
- **Firmware upload issues**:
- Ensure the correct FTDI drivers are installed (Section 3.2).
- Verify the selected baud rate is one of the recommended options (Section 3.3).
- Check the USB-C cable and port for proper connection.
7. Specifications
| Specification | Parameters |
|---|---|
| SoC | ESP32-PICO-D4, 240MHz, Dual Core, Wi-Fi |
| Flash | 4MB |
| Interface | 1 x IR-TX, 1 x Button, 1 x Reset Button |
| PinOut | G21/G25/5V/GND, 3V3/G22/G19/G23/G33 |
| RGB LED | SK6812 |
| SPEAKER | 0.8W/NS4168 I2S |
| MIC | SPM1423 PDM |
| Housing Material | Plastic (PC) |
| Product Weight | 5g |
| Gross Weight | 10g |
| Product Size | 24 x 24 x 17mm |
| Package Size | 85 x 65 x 17mm |
7.1. Schematics

7.2. Pin Map
| Atom-Echo | G22 | G19 | G33 | G23 |
|---|---|---|---|---|
| NS4168 | AMP DATA | AMP BCLK | AMP LRCK | |
| SPM1423 | MIC CLK | MIC DATA |
HMI Pin Map
| Atom-Echo | G27 | G39 |
|---|---|---|
| RGB LED | Data | |
| Button | Input |
HY2.0-4P Pin Map
| HY2.0-4P | Black | Red | Yellow | White |
|---|---|---|---|---|
| PORT.CUSTOM | GND | 5V | G26 | G32 |
7.3. Model Size

8. User Tips
- **Speaker Volume**: While the speaker is satisfactory for its size, manage expectations for loudness. For applications requiring higher volume, consider external audio solutions via the GROVE interface if supported by custom firmware.
- **Firmware Updates**: Always check the official M5Stack website for the latest firmware versions, especially for Home Assistant integration, as new features and improvements are frequently released.
- **Customization**: The ATOM Echo is highly customizable. Explore Arduino IDE or ESP-IDF for advanced projects, such as integrating with other cloud platforms like AWS or Google.
- **Power Supply**: Use a stable 5V power supply via the USB-C port for reliable operation.
9. Warranty and Support
For technical support, detailed documentation, and community forums, please visit the official M5Stack website. You can also find additional tutorials and quick start guides there.
A comprehensive user manual in PDF format is available for download: M5Stack ATOM Echo User Manual (PDF).
For specific warranty information, please refer to the terms and conditions provided by the manufacturer or your point of purchase.