The latest development version of this page may be more current than this released 4.1.0 version.

Core2

Overview

M5Stack Core2 is an ESP32-based development board from M5Stack. It is the successor for the Core module.

M5Stack Core2 features the following integrated components:

ESP32-D0WDQ6-V3 chip (240MHz dual core, 600 DMIPS, 520KB SRAM, Wi-Fi)
PSRAM 8MB
Flash 16MB
LCD IPS TFT 2”, 320x240 px screen (ILI9342C)
Touch screen (FT6336U)
PMU AXP192
Audio NS4168 amplifier (1W-092 speaker)
Vibration motor
RTC BM8563
USB CP2104
SD-Card slot
Grove connector
IMO 6-axis IMU MPU6886
MIC SPM1423
Battery 390mAh 3,7V

Functional Description

The following table below describes the key components, interfaces, and controls of the M5Stack Core2 board.

Key Component	Description	Status
ESP32-D0WDQ6-V2 module	This MPU-ESP32 module provides complete Wi-Fi and Bluetooth functionalities and integrates a 16-MB SPI flash.	supported
32.768 kHz RTC	External precision 32.768 kHz crystal oscillator serves as a clock with low-power consumption while the chip is in Deep-sleep mode.	supported
Status LED	One user LED connected to the GPIO pin.	supported
USB Port	USB interface. Power supply for the board as well as the communication interface between a computer and the board. Contains: TypeC x 1, GROVE(I2C+I/O+UART) x 1	supported
Reset button	Reset button	supported
Power Switch	Power on/off button.	supported
LCD screen	Built-in LCD TFT display (LCD-ILI9342C, 2”, 320x240 px) controlled via SPI interface	supported
SD-Card slot	SD-Card connection via SPI-mode.	supported
6-axis IMU MPU6886	The MPU-6886 is a 6-axis motion tracker (6DOF IMU) device that combines a 3-axis gyroscope and a 3-axis accelerometer. For details please refer to M5Stack-Core2 base shield	supported
Grove port	Note: Grove port requires 5V to be enabled via `bus_5v` regulator	supported
Built-in microphone	The SPM-1423 I2S driven microphone.	todo
Built-in speaker	1W speaker for audio output via I2S interface.	todo
Battery-support	Power supply via battery is supported automatically. But there is no possibility to query current battery status.	todo

Power supply

M5Stack Core2 module is equipped with the feature-rich power management IC (x-powers,axp192-regulator). Following regulators are utilized on this module:

vdd_mcu: Main power supply for the MCU.
lcd_bg: Display backlight voltage.
v_peri: Periphal supply. This regulator controls supply for the display, SD-Card.
vib_motor: Vibration motor regulator.
bus_5v BUS_5V supply for Grove port. Note: This fixed regulator supply is disabled by default.

These voltages can be controlled via regulator api.

Supported Features

The m5stack_core2 board supports the hardware features listed below.

on-chip / on-board: Feature integrated in the SoC / present on the board.
2 / 2: Number of instances that are enabled / disabled.
Click on the label to see the first instance of this feature in the board/SoC DTS files.
vnd,foo: Compatible string for the Devicetree binding matching the feature.
Click on the link to view the binding documentation.

`m5stack_core2/esp32/appcpu` target

Type	Location	Description	Compatible
CPU	on-chip	Espressif Xtensa LX6 CPU2	`espressif,xtensa-lx6`
ADC	on-chip	ESP32 ADC2	`espressif,esp32-adc`
Bluetooth	on-chip	Bluetooth HCI for Espressif ESP321	`espressif,esp32-bt-hci`
CAN	on-chip	ESP32 Two-Wire Automotive Interface (TWAI)1	`espressif,esp32-twai`
Clock control	on-chip	ESP32 RTC (Power & Clock Controller Module) Module1	`espressif,esp32-rtc`
Counter	on-chip	ESP32 Counter Driver based on RTC Main Timer1	`espressif,esp32-rtc-timer`
Counter	on-chip	ESP32 general-purpose timers4	`espressif,esp32-timer`
DAC	on-chip	ESP32 Digital to Analog converter (DAC)1	`espressif,esp32-dac`
Ethernet	on-chip	ESP32 Ethernet1	`espressif,esp32-eth`
Flash controller	on-chip	ESP32 flash controller1	`espressif,esp32-flash-controller`
GPIO & Headers	on-chip	ESP32 GPIO controller2	`espressif,esp32-gpio`
I2C	on-chip	ESP32 I2C2	`espressif,esp32-i2c`
Input	on-chip	ESP32 touch sensor input1	`espressif,esp32-touch`
Interrupt controller	on-chip	ESP32 Interrupt controller1	`espressif,esp32-intc`
IPM	on-chip	ESP32 soft inter processor message1	`espressif,esp32-ipm`
Mailbox	on-chip	ESP32 soft mailbox1	`espressif,mbox-esp32`
MDIO	on-chip	ESP32 MDIO controller1	`espressif,esp32-mdio`
Memory controller	on-chip	ESP32 pseudo-static RAM controller1	`espressif,esp32-psram`
MTD	on-chip	Flash node1	`soc-nv-flash`
MTD	on-chip	Fixed partitions of a flash (or other non-volatile storage) memory1	`fixed-partitions`
Pin control	on-chip	ESP32 pin controller1	`espressif,esp32-pinctrl`
PWM	on-chip	ESP32 LED Control (LEDC)1	`espressif,esp32-ledc`
PWM	on-chip	ESP32 Motor Control Pulse Width Modulator (MCPWM)2	`espressif,esp32-mcpwm`
RNG	on-chip	ESP32 TRNG (True Random Number Generator)1	`espressif,esp32-trng`
SDHC	on-chip	ESP32 SDHC controller1	`espressif,esp32-sdhc`
SDHC	on-chip	ESP32 SDHC controller slot2	`espressif,esp32-sdhc-slot`
Sensors	on-chip	ESP32 Pulse Counter (PCNT)1	`espressif,esp32-pcnt`
Serial controller	on-chip	ESP32 UART3	`espressif,esp32-uart`
SPI	on-chip	ESP32 SPI2	`espressif,esp32-spi`
SRAM	on-chip	Generic on-chip SRAM description2	`mmio-sram`
Watchdog	on-chip	ESP32 watchdog1 1	`espressif,esp32-watchdog`
Wi-Fi	on-chip	ESP32 SoC Wi-Fi1	`espressif,esp32-wifi`

`m5stack_core2/esp32/procpu` target

Type	Location	Description	Compatible
CPU	on-chip	Espressif Xtensa LX6 CPU2	`espressif,xtensa-lx6`
ADC	on-chip	ESP32 ADC2	`espressif,esp32-adc`
Bluetooth	on-chip	Bluetooth HCI for Espressif ESP321	`espressif,esp32-bt-hci`
CAN	on-chip	ESP32 Two-Wire Automotive Interface (TWAI)1	`espressif,esp32-twai`
Clock control	on-chip	ESP32 RTC (Power & Clock Controller Module) Module1	`espressif,esp32-rtc`
Counter	on-chip	ESP32 Counter Driver based on RTC Main Timer1	`espressif,esp32-rtc-timer`
Counter	on-chip	ESP32 general-purpose timers4	`espressif,esp32-timer`
DAC	on-chip	ESP32 Digital to Analog converter (DAC)1	`espressif,esp32-dac`
Display	on-board	ILI9342C 320x240 display controller1	`ilitek,ili9342c`
Ethernet	on-chip	ESP32 Ethernet1	`espressif,esp32-eth`
Flash controller	on-chip	ESP32 flash controller1	`espressif,esp32-flash-controller`
GPIO & Headers	on-chip	ESP32 GPIO controller2	`espressif,esp32-gpio`
	on-board	AXP192 GPIO Controller AX192 features 5 native GPIOs1	`x-powers,axp192-gpio`
	on-board	GPIO pins exposed on Grove 4 pins headers1	`grove-header`
	on-board	GPIO pins exposed on M5Stack M-Bus headers1	`m5stack,mbus-header`
I2C	on-chip	ESP32 I2C1 1	`espressif,esp32-i2c`
Input	on-chip	ESP32 touch sensor input1	`espressif,esp32-touch`
Input	on-board	FT3267/FT5XX6/FT6XX6 capacitive touch panels1	`focaltech,ft5336`
Interrupt controller	on-chip	ESP32 Interrupt controller1	`espressif,esp32-intc`
IPM	on-chip	ESP32 soft inter processor message1	`espressif,esp32-ipm`
LED	on-board	Group of GPIO-controlled LEDs1	`gpio-leds`
Mailbox	on-chip	ESP32 soft mailbox1	`espressif,mbox-esp32`
MDIO	on-chip	ESP32 MDIO controller1	`espressif,esp32-mdio`
Memory controller	on-chip	ESP32 pseudo-static RAM controller1	`espressif,esp32-psram`
Multi-Function Device	on-board	X-Powers AXP1921	`x-powers,axp192`
MTD	on-chip	Flash node1	`soc-nv-flash`
MTD	on-chip	Fixed partitions of a flash (or other non-volatile storage) memory1	`fixed-partitions`
Pin control	on-chip	ESP32 pin controller1	`espressif,esp32-pinctrl`
PWM	on-chip	ESP32 LED Control (LEDC)1	`espressif,esp32-ledc`
PWM	on-chip	ESP32 Motor Control Pulse Width Modulator (MCPWM)2	`espressif,esp32-mcpwm`
Regulator	on-board	AXP192 PMIC1	`x-powers,axp192-regulator`
Regulator	on-board	Fixed voltage regulators1	`regulator-fixed`
RNG	on-chip	ESP32 TRNG (True Random Number Generator)1	`espressif,esp32-trng`
RTC	on-board	NXP PCF8563 RTC1	`nxp,pcf8563`
SDHC	on-chip	ESP32 SDHC controller1	`espressif,esp32-sdhc`
SDHC	on-chip	ESP32 SDHC controller slot2	`espressif,esp32-sdhc-slot`
Sensors	on-chip	ESP32 Pulse Counter (PCNT)1	`espressif,esp32-pcnt`
Serial controller	on-chip	ESP32 UART1 2	`espressif,esp32-uart`
SPI	on-chip	ESP32 SPI1 1	`espressif,esp32-spi`
SRAM	on-chip	Generic on-chip SRAM description2	`mmio-sram`
Watchdog	on-chip	ESP32 watchdog1 1	`espressif,esp32-watchdog`
Wi-Fi	on-chip	ESP32 SoC Wi-Fi1	`espressif,esp32-wifi`

Start Application Development

Before powering up your M5Stack Core2, please make sure that the board is in good condition with no obvious signs of damage.

System requirements

Prerequisites

Espressif HAL requires WiFi and Bluetooth binary blobs in order work. Run the command below to retrieve those files.

west blobs fetch hal_espressif

Note

It is recommended running the command above after west update.

Building & Flashing

Build and flash applications as usual (see Building an Application and Run an Application for more details).

# From the root of the zephyr repository
west build -b m5stack_core2/esp32/procpu samples/hello_world

The usual flash target will work with the m5stack_core2 board configuration. Here is an example for the Hello World application.

# From the root of the zephyr repository
west build -b m5stack_core2/esp32/procpu samples/hello_world
west flash

The baud rate of 921600bps is set by default. If experiencing issues when flashing, try using different values by using --esp-baud-rate <BAUD> option during west flash (e.g. west flash --esp-baud-rate 115200).

You can also open the serial monitor using the following command:

west espressif monitor

After the board has automatically reset and booted, you should see the following message in the monitor:

***** Booting Zephyr OS vx.x.x-xxx-gxxxxxxxxxxxx *****
Hello World! m5stack_core2

Debugging

M5Stack Core2 debugging is not supported due to pinout limitations.