The M5Stack is an ESP32-based development kit from M5Stack. The M5Stack resembles a finished solution featuring an industrial-grade case and LCD screen, and the kit contains a lithium battery, M-BUS socket, and extendable pins on both sides.
Having both BLE and Wi-Fi connectivity options, M5Stack projects include the following protocol elements:
As is standard with any project type that uses Wi-Fi, cloud elements are accessible from both the Embedded and Application tabs in Atmosphere Studio.
Some devices may have limitations or design restrictions that cause unexpected behavior when used with Atmosphere. Specific information and details pertaining to the M5Stack and its performance on Atmosphere is noted below.
ADC2is not accessible, since it conflicts with the Wi-Fi. This means that pins
IO26cannot be used as analog input pins.
Default Pin Mapping
Atmosphere configures each peripheral to a default pin for every supported device, based on ideal pairing of pins and their usage. The default pin configuration is set for convenience and enables each peripheral to work naturally without needing to be modified.
All pins can be used as general purpose input/output (GPIO) unless otherwise specified.
M5Stack projects start with the following pin configuration:
||UART1 TX Pin||Maps to
||UART1 RX Pin||Maps to
||UART2 TX Pin||Maps to
||UART2 RX Pin||Maps to
||I2C SDA||Maps to
||I2C SCL||Maps to
||SPI MOSI||Maps to
||SPI MISO||Maps to
||SPI CLK||Maps to
||Button A||Maps to
||Button B||Maps to
||Button C||Maps to
Internal ESP32 Pins
All internal pins can be accessed using the following nomenclature:
GPIO_NUM_[PIN]. For example, pin 12 can be accessed via
The default pin for any peripheral can be changed within an element's properties, from an element that references that particular peripheral.
Below is information regarding the M5Stack’s exposed peripherals.
This I2C bus is exposed via pins
This SPI bus is exposed via pins
UART1 (USB Debug Console)
This UART is exposed via the micro-USB connector on the M5Stack or pins
This UART is exposed via pins
ADC2 cannot be used, since it conflicts with the Wi-Fi. The following pins can be used for analog input:
Any GPIO pin can be used for PWM output.
Programming the M5Stack involves using the programmer interface in Atmosphere Studio to install embedded firmware.
Prior to programming an M5Stack, ensure you have the following setup configuration:
- The M5Stack is connected to the computer via USB to an available communication port.
- The computer has the necessary connectivity protocols enabled (Bluetooth Low Energy, Wi-Fi, etc.).
- The Atmosphere IoT Agent is installed on the computer and running. This is a local application that runs in the system tray and acts as an intermediary between the computer’s connectivity protocol drivers and the browser running Atmosphere.
- An Internet connection is maintained.
- The project to be programmed has been compiled.
With setup complete, you can program the M5Stack:
- From Atmosphere Studio’s Embedded tab, click the button from the tab’s toolbar. This displays the Program Firmware window.
- Under Device Port, select the communication port the device is connected to.
- Click Program to start programming. When complete, you’ll be notified that the device is programmed with the project’s embedded firmware.
When complete, the M5Stack is programmed with the project’s embedded firmware.
Guides and Tutorials
Get started using the M5Stack with Atmosphere by walking through the following guides:
|Getting Started with ESP32|
There are currently no demo projects available for the M5Stack.
The following additional resources and downloadable files are available for the M5Stack: