pdf-icon

Arduino Guide

1. Arduino Setup

1. Arduino IDE
2. Arduino Board Manager
3. Arduino Library

2. API & Examples

M5Tough

Touch

M5NanoC6

RGB LED

3. M5Unified

4. M5GFX

M5GFX API
M5GFX Canvas
M5GFX Button
M5GFX Functions
M5GFX Appendix

M5Unified Quick Start Guide

Introduction

M5Unified is a driver library for M5Stack main control devices. This library supports most of the built-in hardware drivers for M5Stack main controllers, such as LCD, Touch, Buttons, Speaker, Microphone, etc. M5Unified provides a unified API, allowing the same program to run conveniently on different M5Stack devices. M5Unified supports both Arduino and ESP-IDF development platforms, greatly enhancing development efficiency.

M5Unified Installation

Hello World

Create a new program in Arduino IDE, and paste the Hello World example code below. Compile and upload it to the device. The screen and the serial monitor will display "HelloWorld!" and count every second.

#include <M5Unified.h> // Make the M5Unified library available to your program.

// global variables (define variables to be used throughout the program)
uint32_t count;


// setup function is executed only once at startup.
// This function mainly describes the initialization process.
void setup() {

  auto cfg = M5.config(); // Assign a structure for initializing M5Stack
  // If config is to be set, set it here
  // Example.
  // cfg.external_spk = true;

  M5.begin(cfg);                        // initialize M5 device

  M5.Display.setTextSize(3);            // change text size
  M5.Display.print("Hello World!!!") ;  // display Hello World! and one line is displayed on the screen
  Serial.println("Hello World!!!") ;    // display Hello World! and one line on the serial monitor
  count = 0;                            // initialize count

}

// loop function is executed repeatedly for as long as it is running.
// loop function acquires values from sensors, rewrites the screen, etc.
void loop() {

  Display.setCursor(0, 20);             // set character drawing coordinates (cursor position)
  Display.printf("COUNT: %d\n", count); // display count on screen
  Serial.printf("COUNT: %d\n", count);  // display count serially
  count++;                              // increase count by 1
  delay(1000);                          // wait 1 second(1,000msec)

}

Examples

The M5Unified driver library provides a series of example programs, which can be used to reference the usage of APIs for different hardware peripherals.

M5Unified API

Migration Guide

Refer to the guide below to learn how to migrate from other M5Stack main control driver libraries to M5Unified.

On This Page