This library provides access to the built-in hardware of M5Stack controllers. Library functionality is available through the m5 namespace, and includes the following:

• LCD display access, fonts, and graphical primitives (in conjunction with M5GFX)
• Touchscreen and hardware button access
• Speaker and microphone access
• Power and battery charging control
• Accelerometer, gyroscope, magnetometer access
• Real-time clock and wakeup timer access

M5Unified requires M5GFX to be installed.

#include "M5Unified.h"

In the Arduino IDE, once the M5Unified library is installed through Library Manager, the following example programs are available under File > Examples > M5Unified > Basic.

• Combined demonstration: A demonstration exhibiting several functions in a single example is in HowToUse

• Displays: A basic demonstration of printing text on each of the supported M5Stack displays is in Displays.
• Buttons: A demo of detecting and responding to button presses is in Button.
• Touch: A demo of detecting and reacting to touch events is in Touch.
• Speaker: An example of playing wave audio through built-in speakers and accessories that support audio is in Speaker
• Clock: An example of connecting to an Internet time server over WiFi and setting the built-in clock is in RTC.
• Microphone: An example that records a short clip and plays it back through the speaker is in Microphone.
• IMU: An example demonstrating the accelerometer / gyro / magnetometer is in IMU
• Advanced examples include playing audio over Bluetooth and streaming and decoding MP3 audio, and are in the Advanced folder.

The following functionality is built in to the ESP32 framework or available elsewhere, independent of any hardware included in the M5Stack products, and do not require or have explicit support in the M5Unified library. To use these functions, simply use existing ESP32 or Arduino supporting libraries. This list is provided for the benefit of newcomers who may be asking where the "M5Unified" support for a particular feature is found, before discovering that it's either already part of the basic ESP32 platform, or a device that is generic enough (e.g. I2C or SPI) to be fully supported with generic libraries found online, including in the Arduino library manager, that work with any platform.

• Network access using WiFi (built into ESP32)
• Micro SD card access (SD cards are generic SPI devices)
• Infrared remote control transmitter
• Color-changing LED (e.g. on Atom)

• Power: A demonstration of detecting the battery level and charging state, powering off, and entering deep sleep mode when power off is unavailable.
• Battery lifespan management: An example/utility sketch that runs the battery down to an optimum storage percentage (~40%) before powering off as fully as possible, and as a separate function, charges it to a lifespan-preserving 75% maximum, on each M5Stack device where the power management hardware supports this.
• RTC wakeup: A demonstration of using the realtime clock to set a wakeup timer to power-on, or bring the device out of sleep mode after a pre-determined number of seconds, on devices that support this.

• ESP-IDF
• Arduino IDE

• M5Stack Core (BASIC / GRAY / GO / FIRE)
• M5Stack Core2 / Core2 v1.1 / Tough
• M5Stick C / CPlus / CPlus2
• M5Stack CoreInk
• M5Station
• M5Paper
• M5ATOM Lite / Matrix / ECHO / PSRAM / U
• M5STAMP PICO

• M5Stack CoreS3 / CoreS3SE
• M5StickS3
• M5ATOMS3 / S3Lite / S3U
• M5ATOMS3R / S3RExt / S3RCam / ECHO S3R
• M5STAMPS3 (S3 / S3A) / S3Bat / S3Mini
• M5STAMPPLC
• M5Dial
• M5DinMeter
• M5Capsule
• M5Cardputer / M5CardputerADV
• M5VAMeter
• M5AirQ
• M5PaperS3
• M5PaperColor
• M5PaperMono
• M5PaperDIY
• M5PowerHub
• M5StopWatch
• M5StackChan
• M5ChainCaptain
• M5DualKey

• M5STAMPC3 / C3U

• M5STAMPC5
• M5ToughC5

• M5NanoC6
• M5UnitC6L
• M5STAMPC6
• ArduinoNessoN1

• M5NanoH2

• M5Tab5
• M5STAMPP4
• M5UnitPoEP4

• Unit LCD
• Unit OLED
• Unit Mini OLED
• Unit RCA (without ESP32S3 series)
• Unit GLASS
• Unit GLASS2
• ATOM Display adapter (HDMI output for M5ATOM Lite / Matrix / PSRAM / S3 / S3Lite / S3R / S3RCam / S3RExt )
• Module Display adapter (HDMI output for M5Stack Core / Core2 / Tough / CoreS3 / CoreS3SE )
• Module RCA adapter (composite NTSC/PAL output for M5Stack Core / Core2 / Tough / (without ESP32S3 series))

• SPK HAT (with M5StickC / CPlus / M5Stack CoreInk)
• SPK HAT2 (with M5StickCPlus)
• ATOMIC SPK (with M5ATOM Lite / PSRAM / S3 / S3Lite / S3R / S3RCam / S3RExt )
• ATOMIC ECHO BASE (with M5ATOM Lite / PSRAM / S3 / S3Lite / S3R / S3RCam / S3RExt )
• Module Display adapter (Audio over HDMI for M5Stack Core / Core2 / Tough / CoreS3 / CoreS3SE )
• Module RCA adapter (M5Stack Core / Core2 / Tough)

• Unit RTC
• Unit IMU

	M5Stack BASIC/GRAY GO/FIRE FACES II	M5Stack Core2 Core2AWS TOUGH	M5Stack CoreS3 CoreS3SE
Bus	M-Bus	M-Bus	M-Bus
	※ HPWR=not connected to the ESP32. Used by modules capable of supplying 12V power.

	M5Stack BASIC/GRAY GO/FIRE FACES II	M5Stack Core2 Core2AWS TOUGH	M5Stack CoreS3	M5Paper	M5Station
PortA	PortA	PortA	PortA	PortA	PortA
PortB	PortB	PortB	PortB	PortB	PortB1	PortB2
PortC	PortC	PortC	PortC	PortC	PortC1	PortC2
PortD	PortD	PortD
PortE	PortE	PortE / 485 TOUGH485:12V

	M5Stick C	M5Stick C Plus	M5Stack CoreInk	M5Stamp PICO	M5Stamp C3	M5Stamp C3U
PortA
HAT
Bus			MI-Bus

	ATOM Lite	ATOM Matrix	ATOM ECHO	ATOM PSRAM	ATOM U
PortA
Bus

	ATOMS3 /S3Lite	NanoC6/Cardputer
PortA
Bus