Arduino 上手教程
2. 设备开发 & 案例程序
3. M5Unified
5. 拓展模块 & 案例
Atom DTU
Hat
PaperS3 Arduino 示例程序编译与烧录
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
- 如果是使用2.x 板管理版本，由于API兼容性问题，建议将epdiy库回退至以下版本。
git reset --hard cbdaaa7a0d0f084b2d1e7ee3333a24ad3d67f7204.下载模式
将设备通过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并删除对应当前程序的缓存吗, 重启Arduino IDE, 引入<epdiy.h>并重新进行编译。
7.相关资源
Github
Arduino API & Examples