M5Unified 相关数据定义

Boards

M5.getBoard()

可通过 M5.getBoard() 获取的开发板类型枚举值：

Board	Value
M5Stack	m5::board_t::board_M5Stack
M5StackCore2	m5::board_t::board_M5StackCore2
M5StickC	m5::board_t::board_M5StickC
M5StickCPlus	m5::board_t::board_M5StickCPlus
M5StackCoreInk	m5::board_t::board_M5StackCoreInk
M5Paper	m5::board_t::board_M5Paper
M5Tough	m5::board_t::board_M5Tough
M5Station	m5::board_t::board_M5Station
M5Atom	m5::board_t::board_M5Atom
M5AtomPsram	m5::board_t::board_M5AtomPsram
M5AtomU	m5::board_t::board_M5AtomU
M5TimerCam	m5::board_t::board_M5TimerCam
M5StampPico	m5::board_t::board_M5StampPico
M5StampC3	m5::board_t::board_M5StampC3
M5StampC3U	m5::board_t::board_M5StampC3U

Configs

M5.config()

全局配置参数

参数名	类型	说明	默认值	适用条件
serial_baudrate	uint32_t	USB串口波特率	115200	仅限Arduino-esp32平台
clear_display	bool	启动时是否清屏	true	仅带屏幕设备有效
output_power	bool	外部5V输出开关	true	仅支持AXP192芯片的设备
internal_imu	bool	是否启用内置IMU	true	仅带IMU模块的设备
internal_rtc	bool	是否使用内置RTC	true	仅带RTC模块的设备
internal_spk	bool	是否使用内置扬声器	true	仅带扬声器设备
internal_mic	bool	是否使用内置麦克风	true	仅带麦克风设备
external_imu	bool	是否使用外接IMU/加速度计单元	false	需连接 Unit IMU / Unit Accel
external_rtc	bool	是否使用外接RTC单元	false	需连接 Unit RTC
external_spk	bool	是否使用外接扬声器	false	需连接 Ha SPK / Atomic SPK Base
led_brightness	uint8_t	内置LED亮度(0-255)	0	仅限单色LED设备(RGB灯无效)

相关外接设备:

M5.Speaker.config()

扬声器配置参数

参数名	类型	说明	默认值	备注
pin_data_out	int	I2S数据输出引脚	-1	需指定GPIO引脚号
pin_bck	int	I2S时钟引脚(BCK)	-1
pin_ws	int	I2S声道选择引脚(WS/LRCK)	-1
sample_rate	uint32_t	采样率(Hz)	64000	立体声模式
stereo	bool	是否启用立体声	false
buzzer	bool	是否使用蜂鸣器输出	false	启用时只需设置data_out引脚
use_dac	bool	是否使用内置DAC输出	false	仅支持GPIO25/26
dac_zero_level	uint8_t	DAC零电平参考值	0	0表示动态调整
magnification	uint8_t	输出值放大倍数	16
dma_buf_len	size_t	I2S DMA缓冲区长度	128
dma_buf_count	size_t	I2S DMA缓冲区数量	8
task_priority	UBaseType_t	音频播放任务优先级	2
task_pinned_core	BaseType_t	音频播放任务绑定的CPU核心	-1
i2s_port	i2s_port_t	使用的I2S端口	I2S_NUM_0	可选0或1

Buttons

各型号设备的按键GPIO映射：

设备型号	BtnA	BtnB	BtnC	BtnPWR	BtnEXT
M5Stack Basic/Gray/Fire	GPIO39	GPIO38	GPIO37	-	-
M5Stack Core2	TouchA	TouchB	TouchC		-
M5Stick C/CPlus	GPIO39	GPIO37	-	AXP192	-
M5Stack CoreInk	GPIO37(Up)	GPIO38(Press)	GPIO39(Down)	GPIO27	GPIO5
M5Paper	GPIO37(Up)	GPIO38(Press)	GPIO39(Down)	-	-
M5Station	GPIO37	GPIO38	GPIO39	AXP192	-
M5Tough	-	-	-	AXP192	-
M5Atom/M5StampPico	GPIO39	-	-	-	-
M5StampC3	GPIO3	-	-	-	-
M5StacmC3U	GPIO9	-	-	-	-

On This Page