Arduino Guide
1. Arduino Setup
2. API & Examples
M5Tough
M5NanoC6
3. M5Unified
M5PaperS3程序编译与烧录
1.准备工作
- Arduino IDE安装： 参考 Arduino IDE安装教程 ，完成IDE安装。
2.添加ESP32板管理URL
- 1.打开Arduino IDE。
- 2.选择文件 > 首选项
- 3.在首选项窗口中，找到"附加开发板管理器网址"的输入框，并添加以下URL：
https://espressif.github.io/arduino-esp32/package_esp32_index.json
- 4.在开发板管理器中，搜索
ESP32板管理并进行安装。
版本要求
要求使用板管理版本v3.0.7以下, 否则将无法正常编译。
板子选取注意事项
1.选择开发板
2.启用PSRAM,并选择模式为
3.参考下图并根据需求启用其他配置。
ESP32S3 Dev Module2.启用PSRAM,并选择模式为
OPI PSRAM3.参考下图并根据需求启用其他配置。
3.依赖库安装
- 3.依赖库安装： 参考
库管理安装教程
，完成
M5Unified,M5GFX,Epdiy驱动库安装。(根据提示安装依赖库M5GFX)。注: 要求M5Unified和M5GFX版本>0.2.2。
epdiy库安装
由于Arduino library管理中的epdiy版本较旧, 需要访问
Epdiy - Github
, 手动下载。并安装放置到Arduino库文件路径中。
库管理路径
Windows:
macOS:
Linux:
C:\Users\{username}\Documents\ArduinomacOS:
/Users/{username}/Documents/ArduinoLinux:
/home/{username}/Arduino
4.下载模式
将设备通过USB线连接至电脑, 长按M5PaperS3上的电源按键, 当背部状态灯红色闪烁时表示设备已进入下载模式。
5.端口选择
等待设备识别端口成功， 在Arduino IDE中选中对应设备的端口。
6.程序编译&烧录
打开M5GFX驱动库中的案例程序"BarGraph", 在案例程序开头添加#include <epdiy.h>, 点击上传按钮，将自动进行程序编译，与程序烧录。
蜂鸣器与IMU,RTC等外设驱动可参考M5Unified库中的案例程序。
常见问题
M5GFX中通过
__has_include (<epdiy.h>)对依赖库引入情况进行判断, 在Arduino IDE若在未引入<epdiy.h>情况下进行编译, 可能导致设备无法正常运行。 该情况下请访问路径C:\Users\PC\AppData\Local\arduino\sketches并删除对应当前程序的缓存, 引入<epdiy.h>并重新进行编译。