ESP32-C6-LCD-1.28 使用教程
产品特性
- 搭载 ESP32-C6 高性能 32 位 RISC-V 处理器，主频高达 160MHz
- 集成 Wi-Fi 6、蓝牙 5 和 IEEE 802.15.4 (Zigbee 3.0 和 Thread) 无线通信，具有出色的射频性能
- 内置 512KB HP SRAM、16KB LP SRAM 和 320KB ROM，外接 16MB Flash
- 采用 Type-C 接口，无需纠结正反插
- 板载 1.28 英寸电容 LCD 屏，240 × 240 分辨率，65K 彩色，能清晰地显示彩色图片
- 上壳采用 CNC 金属材质，背面装有亚克力磨砂底板 (可选)
- 板载 QMI8658 六轴惯性测量单元 (3 轴加速度、3 轴陀螺仪)
- 板载 PCF85063 RTC 芯片，可方便实现 RTC 功能需求
- 板载 3.7V MX1.25 锂电池充放电接口
- 板载 SH1.0 14PIN 扩展接口，可引出 6 个 GPIO、1 个 UART、1 个 I2C
- 板载 Micro SD 卡槽，可实现存储扩展、高速数据传输，提升使用灵活性
资源简介
- ESP32-C6 集成 RISC-V 单核处理器，运行频率高达 160MHz，支持 2.4GHz Wi-Fi 6 和 BLE 5
- 2.4GHz 陶瓷天线
- TF 卡槽
- BOOT 按键 复位时按下，可进入下载模式
- RESET 按键 用于系统复位
- 16MB NOR Flash
- QMI8658 六轴惯性测量单元（IMU），集成 3 轴陀螺仪和 3 轴加速度计
- MX1.25 电池接口 MX1.25 2P 连接器，可接入 3.7V 锂电池，支持充放电
- ETA6096 高效锂电池充电芯片
- 充电指示灯 连接系统电池时，充电常亮，充满熄灭；未连接系统电池时状态不定
- USB Type-C 接口 USB 转串口，用于程序烧录和日志打印
- PCF85063 RTC 时钟芯片
- SH1.0 RTC 电池接口 支持接入可充电式 RTC 电池
接口介绍
产品尺寸
ESP32-C6-LCD-1.28
ESP32-C6-LCD-1.28-B
Arduino 开发
本章节包含以下部分，请按需阅读：
Arduino 入门教程
初次接触 Arduino ESP32 开发，想要快速上手？我们为您准备了一套通用的 入门教程。
- 第0节 认识 ESP32
- 第1节 安装和配置 Arduino IDE
- 第2节 Arduino 基础知识
- 第3节 数字输出/输入
- 第4节 模拟输入
- 第5节 脉冲宽度调制 (PWM)
- 第6节 串行通信 (UART)
- 第7节 I2C 通信
- 第8节 SPI 通信
- 第9节 Wi-Fi 基础用法
- 第10节 网页服务器
- 第11节 蓝牙 (Bluetooth)
- 第12节 LVGL 图形界面开发
- 第13节 综合项目
请注意：该教程使用 ESP32-S3-Zero 作为教学示例，所有硬件代码均基于其引脚布局。在动手实践前，建议您对照手中的开发板引脚图，确认引脚配置无误。
配置开发环境
1. 安装和配置 Arduino IDE
对于 ESP32-C6-LCD-1.28 开发板，Arduino IDE 需要安装 arduino-esp32 v3.2.1 以上版本。
请参考 安装和配置 Arduino IDE 教程 下载安装 Arduino IDE 并添加 ESP32 支持。
2. 安装库
- 在安装 Arduino 库时，通常有两种方式可供选择：在线安装 和 离线安装。若库安装要求离线安装，则必须使用提供的库文件。
- 对于大多数库，用户可以通过 Arduino 软件的在线库管理器轻松搜索并安装。然而，一些开源库或自定义库未被同步到 Arduino 库管理器中，因此无法通过在线搜索获取。在这种情况下，用户只能通过离线方式手动安装这些库。
- 可从 该处 下载 ESP32-C6-LCD-1.28 开发板的示例程序包。包内的 Arduino\libraries 目录已包含本教程所需的全部库文件。
| 库或文件名称 | 说明 | 版本 | 安装方式 |
|---|---|---|---|
| LVGL | 图形库 | v8.4.0 | "离线安装" |
| Arduino_GFX_Library | 图形绘制底层库 | v1.6.4 | "离线/在线 安装" |
LVGL 及其驱动库的版本之间存在较强的依赖关系。例如，为 LVGL v8 编写的驱动可能不兼容 LVGL v9。为确保示例能够稳定复现，推荐使用上表列出的特定版本。混合使用不同版本的库可能导致编译失败或运行时异常。
3. Arduino 工程参数设置
示例程序
Arduino 示例程序位于 示例程序包 的 Arduino/examples 目录中。
| 示例程序 | 基础例程说明 | 依赖库 |
|---|---|---|
| 01_I2C_PCF85063 | 读取 RTC 时间并打印 | - |
| 02_I2C_QMI8658 | 打印 IMU 发出来的原始数据 | - |
| 03_SD_Card | 加载显示 SD 卡的信息 | - |
| 04_WIFI_AP | 设置为 AP 模式，可获取接入设备的 MAC 地址 | - |
| 05_WIFI_STA | 设置为 STA 模式，可接入 WiFi 获取 IP 地址 | - |
| 06_HelloWorld_GFX | 屏幕上显示 HelloWorld | GFX_Library_for_Arduino |
| 07_LVGL_Demo | LVGL 例程 | LVGL |
01_I2C_PCF85063
【程序说明】
- 本示例演示 ESP32-C6-LCD-1.28 获取 PCF85063 的时间和日期并打印到终端。
【运行效果】
程序编译下载完成，打开串口监控可以看到打印输出的 RTC 的时间，如下图所示 ：
02_I2C_QMI8658
【程序说明】
- 通过 I2C 协议，对 QMI8658 芯片进行初始化设置，然后读取对应的姿态信息打印到终端。
【运行效果】
打开串口监控，可以看到打印输出的 IMU 发出来的原始数据(欧拉角需要自己转换)，如下图所示 ：
03_SD_Card
【程序说明】
- 通过使用 SPI 接口驱动 SD 卡，成功挂载 SD 卡之后把 SD 卡信息打印到终端。
【运行效果】
点击串口监控设备，可以看到输出的 SD Size 是 SD 卡的实际容量，如下图所示 ：
04_WIFI_AP
【程序说明】
- 该示例可将开发板设置为热点，允许手机或其他处于 STA 模式的设备连接到开发板。
【运行效果】
烧录完程序，打开串口终端，设备连接热点成功后，会输出该设备的 MAC 地址，如图：
05_WIFI_STA
【程序说明】
- 该示例可将开发板配置为 STA 设备，以连接路由器，从而接入系统网络。
【运行效果】
烧录完程序，打开串口终端，设备成功连接路由器后，会输出所获取的 IP 地址，如图：
06_HelloWorld_GFX
【程序说明】
- 通过移植 Arduino_GFX_Library ，在屏幕上实现一些基础的 GUI 界面。
【运行效果】
烧录完程序，可以看到屏幕上显示多种格式的 Hello World，如图 ：
07_LVGL_Demo
【程序说明】
- 通过移植 LVGL V8，运行 LVGL 示例程序。
【运行效果】
程序烧录完成后，设备的运行效果如下：
ESP-IDF
本章节包含以下部分，请按需阅读：
ESP-IDF 入门教程
初次接触 ESP32 ESP-IDF 开发，想要快速上手？我们为您准备了一套通用的 入门教程。
请注意：该教程使用 ESP32-S3-Zero 作为教学示例，所有硬件代码均基于其引脚布局。在动手实践前，建议您对照手中的开发板引脚图，确认引脚配置无误。
配置 ESP-IDF 开发环境
对于 ESP32-C6-LCD-1.28 开发板，需要使用 ESP-IDF V5.5.2 以上版本。
以下内容以 Windows 系统为例，使用 VS Code + ESP-IDF 扩展 的方式进行开发。Mac/Linux 用户请参考 官方说明。
此部分图示以安装 ESP-IDF V5.5.2 为例示范，安装时请选用与您开发板示例匹配的 ESP-IDF 版本。
安装 ESP-IDF 开发环境
前往 ESP-IDF Installation Manager 下载 ESP-IDF 安装管理器。这是乐鑫最新推出的跨平台安装工具，下文将演示如何使用其离线安装功能。
在页面中点击 Offline Installer 标签，然后在筛选栏中选择 Windows 操作系统和你需要的 ESP-IDF 版本（图示仅为参考，请以实际为准）。
确认选择无误后，点击下载按钮。浏览器将自动同时下载两个文件：一个是 ESP-IDF 离线整合包(.zst)，另一个是 ESP-IDF 安装器(.exe)。
请耐心等待两个文件下载完成。
下载完成后，双击运行 ESP-IDF 安装器(eim-gui-windows-x64.exe)。
启动后，可在右上角将界面语言切换为中文。
安装工具会自动检测同一目录下是否存在离线整合包。点击 从存档安装。
接下来，选择安装路径。建议使用默认路径；若需自定义，请确保路径中不包含中文或空格。确认无误后，点击 开始安装。
当看到如下界面时，表示 ESP-IDF 已安装成功。
建议同时安装驱动程序。点击 完成安装，然后点击 安装驱动程序。
安装 Visual Studio Code 与 ESP-IDF 扩展
下载并安装 Visual Studio Code。
安装时建议勾选 通过 Code 打开操作添加到 Windows 资源管理器文件上下文菜单,以便快速打开项目文件夹。
在 VS Code 中,点击侧边活动栏中的
扩展图标(或使用快捷键 Ctrl + Shift + X)打开 扩展 视图。在搜索框中输入 ESP-IDF,找到 ESP-IDF 扩展并点击安装。
当 ESP-IDF 扩展版本 ≥ 2.0 时,扩展会自动检测并识别上述步骤中安装的 ESP-IDF 环境,无需手动配置。
示例程序
ESP-IDF 示例程序位于 示例程序包 的 ESP-IDF 目录中。
| 示例程序 | 基础例程说明 | 依赖库 |
|---|---|---|
| 01_Factory | 出厂测试程序 | - |
| 02_QMI8658 | 打印 IMU 发出来的原始数据 | - |
| 03_PCF85063 | 读取 RTC 时间并打印 | - |
| 04_SD_Card | 加载显示 SD 卡的信息 | - |
| 05_WIFI_AP | 设置为 AP 模式，可获取接入设备的 IP 地址 | - |
| 06_WIFI_STA | 设置为 STA 模式，可接入 WiFi 获取 IP 地址 | - |
| 07_LVGL_Demo | LVGL 例程 | LVGL |
01_Factory
【程序说明】
- 本示例演示是 ESP32-C6-LCD-1.28 的综合示例，也是出厂默认烧录的示例。
【运行效果】
- 程序编译下载完成，屏幕进入显示测试界面，屏幕会依次刷红、绿、蓝三色
- 短按 BOOT 按键，可以切换各个界面，查看各项参数
02_QMI8658
【程序说明】
- 通过 I2C 协议，对 QMI8658 芯片进行初始化设置，然后读取对应的姿态信息打印到终端。
【运行效果】
打开串口监控，可以看到打印输出的 IMU 发出来的原始数据(欧拉角需要自己转换)，如下图所示 ：
03_PCF85063
【程序说明】
- 本示例演示 ESP32-C6-LCD-1.28 获取 PCF85063 的时间和日期并打印到终端。
【运行效果】
程序编译下载完成，打开串口监控可以看到打印输出的 RTC 的时间，如下图所示 ：
04_SD_Card
【程序说明】
- 通过使用 SPI 接口驱动 SD 卡，成功挂载 SD 卡之后往 test.txt 文件读写数据。
【运行效果】
点击串口监控设备，可以看到输出的 SD 卡读写测试过程，如下图所示 ：
05_WIFI_AP
【程序说明】
- 该示例可将开发板设置为热点，允许手机或其他处于 STA 模式的设备连接到开发板。
【运行效果】
烧录完程序，打开串口终端，设备连接热点成功后，会输出该设备的 IP 地址，如图：
06_WIFI_STA
【程序说明】
- 该示例可将开发板配置为 STA 设备，以连接路由器，从而接入系统网络。
【运行效果】
烧录完程序，打开串口终端，设备成功连接路由器后，会输出所获取的 IP 地址和 WIFI 信息，如图：
07_LVGL_Demo
【程序说明】
- 通过移植 LVGL V9，运行 LVGL 示例程序。
【运行效果】
程序烧录完成后，设备的运行效果如下：
Flash 固件的烧录与擦除
当前产品提供了测试固件，可通过直接烧录测试固件来验证板载设备功能是否正常。
- 固件下载：ESP32-C6-LCD-1.28 示例程序，bin 文件位于代码资料中的
ESP32-C6-LCD-1.28-Demo\Firmware目录下 - 烧录地址：
0x00
- Flash 固件的烧录
- Flash 固件的擦除
以下步骤适用于烧录本页提供的固件。
下载并解压乐鑫官方烧录工具 Flash Download Tool（下载地址）
运行 Flash Download Tool，根据开发板的主控芯片与下载接口选择对应选项。下图以 ESP32-S3 与 USB 为例，实际选项以产品硬件设计为准
参数设置
- 选择与开发板所对应的 COM 口
- 选择 BAUD 为最高的 1152000
- 点击该行的“...”按钮，选择微雪提供的 bin 文件，并在其右侧手动填写本页上方给出的烧录地址（比如
0x00），同时勾选该行最左侧的复选框 - 点击 START 开始烧录
等待烧录完成（烧录过程需要一定时间，请耐心等待）
按下复位键，观察运行现象
相关资料
1. 硬件资料
开发板设计文件
2. 技术手册
ESP32-C6 芯片官方手册
数据手册
