This is the documentation for the latest (main) development branch of Zephyr. If you are looking for the documentation of previous releases, use the drop-down menu on the left and select the desired version.

M5Stack 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

M5Stack-Core2

M5Stack-Core2 module

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 Zephyr m5stack_core2 board configuration supports the following hardware features:

Interface

Controller

Driver/Component

NVIC

on-chip

nested vector interrupt controller

UART

on-chip

serial port-polling; serial port-interrupt

PINMUX

on-chip

pinmux

GPIO

on-chip

gpio

I2C

on-chip

i2c

SPI

on-chip

spi

CLOCK

on-chip

reset and clock control

COUNTER

on-chip

rtc

WATCHDOG

on-chip

independent watchdog

PWM

on-chip

pwm

ADC

on-chip

adc

DAC

on-chip

dac

die-temp

on-chip

die temperature sensor

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.