ESP32-C6-Touch-AMOLED-1.43

来自Waveshare Wiki
跳转至： 导航、 搜索
Esp32c6-test-1.43-9.jpg
Esp32c6-test-1.43-8.jpg
{{{name2}}}
{{{name3}}}
功能简介
特性 无特性，不解释
主控 ESP32-C6
' 无特性，不解释
' 无特性，不解释
' 无特性，不解释
接口 Type C USB

产品介绍

产品简介

本产品是一款微雪 (Waveshare) 设计的高性能、高集成的微控制器开发板，外挂大容量 Flash。板载 1.43 英寸高清 AMOLED 显示屏、高度集成的 RTC、IMU、Micro SD 卡槽、低功耗音频编解码芯片、双 MIC 电路及锂电池充放电等外设，同时预留 USB、UART、I2C 及 GPIO 等接口，提供灵活扩展能力，方便开发并嵌入到产品中。

产品特性

  • 搭载 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
  • 板载 1.43 英寸电容触摸高清 AMOLED 屏，466 × 466 分辨率，16.7M 彩色，能清晰地显示彩色图片
  • 内置 CO5300 驱动芯片和 FT6146 电容触控芯片，分别使用 QSPI 和 I2C 接口通信，提升性能的同时不占用过多的引脚资源
  • 配备双数字麦克风阵列，支持更丰富的语音交互功能，适用于精准语音识别及近场 / 远场语音唤醒应用
  • 板载 QMI8658 六轴惯性测量单元 (3 轴加速度、3 轴陀螺仪)，可检测运动姿态、计步等功能
  • 板载 PCF85063 RTC 芯片，可方便实现 RTC 功能需求
  • 板载 PWR、BOOT 两个可自定义功能的侧边按钮，方便使用按钮进行自定义功能开发
  • 板载 3.7V MX1.25 锂电池充放电接口
  • 板载 Micro SD 卡槽，可灵活扩展存储和快速进行数据传输，适用于数据记录和媒体播放，简化了电路设计
  • 引出 UART 和 I2C SH1.0 4PIN 接口，并预留 2 × 4PIN 2.54mm 间距的接口
  • 使用 AMOLED 屏幕，具有更高的对比度、更广的视角、丰富的色彩和快速响应时间，视觉效果更出色，同时具备纤薄设计、低功耗和灵活性等优点
  • 可选配外壳，CNC 外壳设计精美，接口说明标注清晰，整体美观，便于携带

资源简介

Esp32c6-test-1.43-10.jpg

1、ESP32-C6
   集成 RISC-V 单核处理器，160MHz 运行频率，支持 2.4GHz Wi-Fi 6 和 BLE 5
2、板载贴片天线
   支持 2.4GHz Wi-Fi (802.11 b/g/n) 和 Bluetooth 5 (LE)
3、ES7210 ADC 音频解码芯片
   高性能低功耗音频模数转换器，支持多路麦克风输入
4、MX1.25 2PIN 锂电池接口
   用于连接锂电池，支持电池供电

5、MX1.25 2PIN 扬声器接口
   音频输出信号，支持外接扬声器
6、双麦克风阵列设计
   双数字麦克风阵列，支持更丰富的语音交互功能
7、SH1.0 4PIN I2C 接口
   标准 I2C 总线接口，便于扩展传感器等设备
8、SH1.0 4PIN UART 接口
   用于调试或与其他模块进行数据交互
9、PWR 电源按键
   配合程序可实现锂电池供电情况下的电源控制

10、BOOT 按键
   按住 BOOT 按键，重新上电可进入下载模式
11、PCF85063
   RTC 时钟芯片，支持时间保持功能
12、2 × 4PIN 2.54mm 间距排母
   用于外部模块扩展，兼容杜邦线
13、Type-C 接口
   用于烧录程序和日志打印
14、W25Q128JVSI
   16MB Flash 存储器
15、ES8311 DAC 音频编码芯片
   高性能低功耗音频数模转换器
16、QMI8658
   三轴加速度 + 三轴陀螺仪，可用于姿态感知、动作识别等应用
17、TCA9554PWR
   8 位 I2C GPIO 扩展芯片
18、Micro SD 卡槽
   支持 FAT32 格式的 SD 卡，用于数据扩展

接口介绍

需要更加详细请查阅原理图
Esp32c6-test-1.43-11.png

产品尺寸

不带外壳版

Esp32c6-test-1.43-12.jpg

带外壳版

Esp32c6-test-1.43-13.jpg

AMOLED屏参数

Esp32c6-test-1.43-14.png

使用说明

ESP32-C6-Touch-AMOLED-1.43 目前提供 Arduino IDE 和 ESP-IDF 两种开发工具和框架，提供了灵活的开发选择，你可以根据项目需求和个人习惯选择适合的开发工具。

开发工具介绍

Arduino-IDE-logo.jpg

Arduino IDE

Arduino IDE是一款便捷灵活、方便上手的开源电子原型平台。不需要太多基础，简单学习后，你也可以快速地进行开发。同时，Arduino 拥有庞大的全球用户社区，提供了海量的开源代码、项目示例和教程，还有丰富的库资源，封装了复杂功能，让开发者能快速实现各种功能。

ESP-IDF-logo.jpg

ESP-IDF

ESP-IDF，全称Espressif IDE，是乐鑫科技为 ESP系列芯片推出的专业开发框架。它使用C语言开发，包括编译器、调试器、烧录工具等，可在命令行下或使用集成开发环境（如 Visual Studio Code 配合 Espressif IDF 插件）进行开发，插件提供代码导航、项目管理、调试等功能。


这两种开发方式各有其优势，开发者可以根据自身需求和技能水平进行选择。Arduino 适合初学者和非专业人士，因其简单易学、上手快。而对于有专业背景或对性能要求较高的开发者，ESP-IDF 是更好的选择，它提供了更高级的开发工具和更强的控制能力，适用于复杂项目的开发。

器件准备

  • ESP32-C6-Touch-AMOLED-1.43 x1
  • SD卡（FAT32格式） x1
  • USB线 type A公口 转 Type C公口 x1
在操作前，建议先浏览目录，快速了解文档结构。为顺利操作，请仔细阅读FAQ，提前了解可能的问题。文档中所有资料均提供超链接，方便下载。

Arduino开发

本章介绍 Arduino 环境搭建，包括 Arduino IDE、ESP32板管理、相关库的安装，程序编译下载及示例程序测试，帮助用户掌握开发板，便于二次开发。 Arduino-flow-04.png

环境搭建

下载和安装 Arduino IDE

  • 点击访问Arduino官网，选择对应的系统和系统位数下载。
    ESP32-S3-AMOLED-1.91-Ar-software-01.png
  • 运行安装程序，全部默认安装即可。
环境设置是在 Windows 10 系统下进行，Linux和Mac用户可访问Arduino-esp32环境搭建参考

安装 ESP32 开发板

  • ESP32相关主板在Arduino IDE使用，须先安装“esp32 by Espressif Systems”开发板的软件包
  • 根据板安装要求进行安装，一般推荐“在线安装”， 若在线安装失败，则使用“离线安装”
  • 安装教程，详见：Arduino 板管理教程
  • ESP32-C6-Touch-AMOLED-1.43 所需开发板安装说明
板名称 板安装要求 版本号要求
esp32 by Espressif Systems “离线”安装/“在线”安装 ≥3.2.1

安装库

  • 在安装 Arduino 库时，通常有两种方式可供选择：在线安装 和 离线安装。若库安装要求离线安装，则必须使用提供的库文件。
    对于大多数库，用户可以通过 Arduino 软件的在线库管理器轻松搜索并安装。然而，一些开源库或自定义库未被同步到 Arduino 库管理器中，因此无法通过在线搜索获取。在这种情况下，用户只能通过离线方式手动安装这些库。
  • 库安装教程，详见：Arduino 库管理教程
  • ESP32-C6-Touch-AMOLED-1.43 库文件路径：
    ..\'ESP32-C6-Touch-AMOLED-1.43\Arduino\libraries
  • 'ESP32-C6-Touch-AMOLED-1.43 库文件安装说明
库名称 说明 版本 库安装要求
LVGL 图形库 v8.3.11/v9.3.0 “离线”安装
SensorLib 传感器控制库 v0.3.1 “离线/在线”安装

运行第一个 Arduino 程序

如果你刚入门学习ESP32和Arduino，还不知道如何创建、编译、烧录和运行Arduino ESP32程序，那么请展开看看，希望可以帮助到你！

新建工程

  • 运行Arduino IDE，选择 File -> New Sketch
    ESP32-S3-AMOLED-1.91-Ar-study-01.png
  • 输入代码：
void setup() {
  // put your setup code here, to run once:
  Serial.begin(115200);
}

void loop() {
  // put your main code here, to run repeatedly:
  Serial.println("Hello, World!");
  delay(2000);
}
  • 保存代码工程，选择 File -> Save As...；在弹出的菜单选择保存工程路径，并输入工程名，如 Hello_World，点击保存

ESP32-S3-AMOLED-1.91-Ar-study-02.png

编译和烧录程序

  • 选择对应的开发板，以ESP32S3主板为例：

①. 点击选择下拉框选项“Select Other Board and Port”；
②. 搜索需要的开发板型号“esp32s3 dev module”并选择；
③. 选择COM口；
④. 保存选择。
ESP32-S3-AMOLED-1.91-Ar-study-03.png

  • 若ESP32S3主板只有USB口，须打开（Enable）USB CDC，如下图所示：

ESP32-S3-AMOLED-1.91-Ar-study-04.png

  • 编译并上传程序：

①. 编译程序；②. 编译并下载程序；③. 下载成功。
ESP32-S3-AMOLED-1.91-Ar-study-05.png

  • 打开串口监视窗口，程序每隔2秒会打印“Hello World!”，运行情况如下所示：

ESP32-S3-AMOLED-1.91-Ar-study-06.png

示例程序

Demo-flow-01.png

  • ESP32-C6-Touch-AMOLED-1.43 示例程序
示例程序 基础例程说明 依赖库
01_ADC_Test 获取锂电池的电压值 -
02_I2C_PCF85063 打印RTC芯片的实时时间 SensorLib
03_I2C_QMI8658 打印IMU发出来的原始数据 SensorLib
04_SD_Card 加载显示SD卡的信息 -
05_WIFI_AP 设置为AP模式，可获取接入设备的IP地址 -
06_WIFI_STA 设置为STA模式，可接入WiFi获取IP地址 -
07_BATT_PWR_Test 单独使用锂电池供电时，通过PWR按键控制电源 -
08_Audio_Test 扬声器播放麦克风录到的声音 -
09_LVGL_V8_Test LVGLV8例程 LVGL V8.3.11
10_LVGL_V9_Test LVGLV9例程 LVGL V9.3.0

Arduino 工程参数设置

ESP32 Tool Settings.jpg

01_ADC_Test

【程序说明】

  • 通过GPIO连接的模拟量电压经过ADC转换成数字量，然后通过计算得到实际的锂电池电压，并打印到终端。

【硬件连接】

  • 使用USB线把板子接入电脑

【代码分析】

  • adc_bsp_init(void) ：初始化 ADC1，包括创建 ADC 单次触发单元并配置 ADC1 的通道 0。
  • adc_get_value(float *value,int *data) ：读取 ADC1 通道 0 的值，并根据参考电压和分辨率计算出对应的电压值存储在传入的指针指向的位置，如果读取失败则存储 0。
  • adc_example(void* parameter)：初始化 ADC1 后，创建一个ADC任务，该任务每隔 1 秒读取一次ADC的值，通过读取的ADC原始值计算出系统的电压。

【运行效果】

  • 程序编译下载完成，打开串口监控可以看到打印输出的ADC的值和电压，如下图所示：

Esp32c6-test-1.43-15.png

02_I2C_PCF85063

【程序说明】

  • 通过I2C协议，分别对PCF85063芯片进行初始化、设置时间、间隔读取时间，然后打印到终端

【硬件连接】

  • 使用USB线把板子接入电脑

【代码分析】

  • void i2c_rtc_loop_task(void *arg) ：创建一个RTC任务来实现RTC功能，每隔1秒读取一次RTC芯片的时钟，然后输出到终端。

【运行效果】

  • 打开串口监控，可以看到打印输出的RTC时间，如下图所示：

ESP32-S3-LCD-3.16-14.png

03_I2C_QMI8658

【程序说明】

  • 通过I2C协议，对QMI8658芯片进行初始化设置，然后每隔200毫秒读取对应的姿态信息打印到终端

【硬件连接】

  • 使用USB线把板子接入电脑

【代码分析】

  • void i2c_qmi_loop_task(void *arg) ：创建一个QMI任务来实现获取姿态信息，在任务中读取并打印加速度计、陀螺仪数据，并将获取的结果输出到串口控制台，间隔200毫秒。

【运行效果】

  • 打开串口监控，可以看到打印输出的IMU发出来的原始数据(欧拉角需要自己转换)，如下图所示：

ESP32-S3-LCD-3.16-15.png

04_SD_Card

【程序说明】

  • 通过SDSPI方式驱动SD卡，成功挂载之后把SD卡信息打印到终端。

【硬件连接】

  • 上电之前先给板子装上FatFs格式的SD卡

【代码分析】

  • sdcard_init(void) ：使用SDSPI方式初始化SD卡。
  • loop()：测试SD卡读写功能，需要取消#define sdcard_write_Test宏定义的注释。
//#define sdcard_write_Test

【运行效果】

  • 点击串口监控设备，可以看到输出的SD卡的信息，practical_size是SD卡的实际容量，如下图所示：

ESP32-S3-LCD-3.16-16.png

想了解更多关于Arduino ESP32库关于SD卡相关的使用？可访问：Arduino ESP32 库 SD 使用

05_WIFI_AP

【程序说明】

  • 该示例可将开发板设置为热点，允许手机或其他处于 STA 模式的设备连接到开发板。

【硬件连接】

  • 使用USB线把板子接入电脑

【代码分析】

  • 在05_WIFI_AP.ino文件找到ssid和password，然后手机或其他处于 STA 模式的设备即可使用该 ssid 和 password 连接到开发板。
const char *ssid = "ESP32_AP";
const char *password = "12345678";

【运行效果】

烧录完程序，打开串口终端，如果设备连接成功热点之后，会输出该设备的MAC地址，如图: ESP32-S3-LCD-1.3-1006.png

06_WIFI_STA

【程序说明】

  • 该示例可将开发板配置为 STA 设备，以连接路由器，从而接入系统网络。

【硬件连接】

  • 使用USB线把板子接入电脑

【代码分析】

  • 在05_WIFI_STA.ino文件找到ssid和password，然后将其修改为当前环境中可用路由器的SSID 和 Password。
const char *ssid = "you_ssid"; 
const char *password = "you_password";

【运行效果】

烧录完程序，打开串口终端，如果设备连接成功热点之后，会输出所获取的IP地址，如图: ESP32-S3-LCD-1.3-1007.png

07_BATT_PWR_Test

【程序说明】

  • 使用锂电池供电的情况下，演示如何通过PWR按键控制系统的电源。

【硬件连接】

  • 使用USB线把板子接入电脑

【代码分析】

  • setup_ui(lv_ui *ui) ：初始化ui界面，使得控制可视化。
  • esp_io_expander_new_i2c_tca9554() ：初始化锂电池控制IO端口。
  • user_button_init()：初始化按键以及各类触发事件。
  • example_button_task(void* parmeter)：等待按键事件触发的任务。

【运行效果】

  • 程序烧录完成后，断开USB供电，接入锂电池，通过长按PWR按键进行开机，如图：

Esp32c6-test-1.43-17.png 

1.长按PWR按键，等待屏幕显示"Power on succeeded"，表示启动成功，松开按键即可
2.再次长按PWR按键，等待屏幕显示"Power on failed"，表示电源关闭成功，松开按键即可

08_Audio_Test

【程序说明】

  • 演示如何获取麦克风的数据，然后再通过扬声器播放。

【硬件连接】

  • 使用USB线把板子接入电脑

【代码分析】

  • i2c_master_Init() ：初始化I2C总线。
  • esp_io_expander_new_i2c_tca9554() ：初始化功放CTRL控制IO端口。
  • esp_codec_dev_set_out_vol();：设置播放时的声音大小。
  • esp_codec_dev_set_in_gain()：设置录音的增益。

【运行效果】

  • 程序烧录完成后，对着麦克风说话，扬声器会自动播放录到的声音
1.如果感觉播放声音比较小，优先使用"esp_codec_dev_set_out_vol"调大播放音量
2.调大播放音量满足不了的情况下，可以使用"esp_codec_dev_set_in_gain"调大录音时的增益

09_LVGL_V8_Test

【程序说明】

  • 通过移植LVGL V8，在屏幕上实现一些多功能的GUI界面。

【硬件连接】

  • 使用USB线把板子接入电脑

【代码分析】

  • 如果需要旋转90度显示，可以在user_config.h文件找到#define EXAMPLE_Rotate_90宏定义，取消注释即可。
  • 如果需要进行背光测试，可以在user_config.h文件找到#define Backlight_Testing宏定义，取消注释即可。
//#define Backlight_Testing
//#define EXAMPLE_Rotate_90

【运行效果】

  • 程序烧录完成后，设备的运行效果如下：

Esp32c6-test-1.43-19.png

LVGL更多学习及使用可参考LVGL官方文档

10_LVGL_V9_Test

【程序说明】

  • 通过移植LVGL V9，在屏幕上实现一些多功能的GUI界面。

【硬件连接】

  • 使用USB线把板子接入电脑

【代码分析】

  • 如果需要旋转90度显示，可以在user_config.h文件找到#define EXAMPLE_Rotate_90宏定义，取消注释即可。
  • 如果需要进行背光测试，可以在user_config.h文件找到#define Backlight_Testing宏定义，取消注释即可。
//#define Backlight_Testing
//#define EXAMPLE_Rotate_90

【运行效果】

  • 程序烧录完成后，设备的运行效果如下：

Esp32c6-test-1.43-19.png

LVGL更多学习及使用可参考LVGL官方文档

ESP-IDF开发

本章介绍 ESP-IDF 环境搭建，包括 Visual Studio、Espressif IDF插件的安装，程序编译下载及示例程序测试，帮助用户掌握开发板，便于二次开发。 ESP-IDF-flow-01.png

环境搭建

下载和安装 Visual Studio

  • 打开VScode官网的下载页面，选择对应系统和系统位数进行下载
    ESP32-S3-AMOLED-1.91-VScode-01.png
  • 运行安装包后，其余均可以默认安装，但这里为了后续的体验建议，建议在此处勾选框中的1、2、3项
    ESP32-S3-AMOLED-1.91-VScode-02.png
    • 第一二项开启后，可以直接通过鼠标右键文件或者目录打开VSCode，可以提高后续的使用体验.
    • 第三项开启后，选择打开方式时，可以直接选择VSCode
环境设置是在 Windows 10 系统下进行，Linux和Mac用户可访问ESP-IDF环境搭建参考

安装Espressif IDF插件

  • 一般推荐“在线安装”， 若因网络因素无法在线安装，则使用“离线安装”。
  • 安装Espressif IDF插件教程，详见：安装Espressif IDF插件教程

运行第一个 ESP-IDF 程序

如果你刚入门学习ESP32和ESP-IDF，还不知道如何创建、编译、烧录和运行ESP-IDF程序，那么请展开看看，希望可以帮助到你！

新建项目

ESP32-S3-AMOLED-1.91-study-01.png

ESP32-S3-AMOLED-1.91-study-02.png

创建例程

  • 使用快捷键 F1 ，输入esp-idf:show examples projects

ESP32-S3-AMOLED-1.91-study-03.png

  • 选择你当前的IDF版本

ESP32-S3-AMOLED-1.91-study-04.png

  • 以Hello world例程为例

①选择对应例程
②其readme会说明该例程适用于什么芯片（下文有介绍例程怎么使用与文件结构，这里略）
③点击创建例程
ESP32-S3-AMOLED-1.91-study-05.png

  • 选择放置例程的路径，要求无例程同名文件夹

ESP32-S3-AMOLED-1.91-study-06.png

修改COM口

  • 此处显示使用对应的COM口，点击可以修改对应COM口
  • 请根据设备对应COM口进行选择（可通过设备管理器查看）
  • 若出现下载失败的情况请点击复位按键1秒以上或进入下载模式，等待 PC 端重新识别到设备后再次下载

ESP32-S3-AMOLED-1.91-study-07.png

修改驱动对象

  • 选择我们需要驱动的对象，也就是我们的主芯片为ESP32S3

ESP32-S3-AMOLED-1.91-study-08.png

  • 选择openocd的路径，这里对我们没有影响，所以我们随便选择一个即可

ESP32-S3-AMOLED-1.91-study-09.png


其余状态栏简介

①.ESP-IDF开发环境版本管理器，当我们的工程需要区分开发环境版本时，可以通过安装不同版本的ESP-IDF来分别管理，当工程使用特定版本时，可以通过使用它来切换
②.设备烧录COM口，选择以将编译好的程序烧录进芯片上
③.set-target 芯片型号选择，选择对应的芯片型号，如:ESP32-P4-Nano需要选择 esp32p4 为目标芯片
④.menuconfig，点击修改sdkconfig配置文件内容，项目配置详细资料
⑤.fullclean 清理按钮，当工程编译报错或其他操作污染编译内容时，通过点击清理全部编译内容
⑥. Build 构建工程，当一个工程满足构建时，通过此按钮进行编译
⑦.当前下载方式，默认为UART
⑧.flash烧录按钮，当一个工程Build构建通过时，选择对应开发板COM口，点击此按钮可以将编译好的固件烧录至芯片
⑨.monitor开启烧录口监控，当一个工程Build-->flash后，可通过点击此按钮查看烧录、调试口输出的l0g，以便观察应用程序是否正常工作
⑩.Debug调试
⑪.Build Flash Monitor 一键按钮，用于连续执行Build-->Flash-->Monitor，常被称作小火苗

ESP32-S3-AMOLED-1.91-study-10.png

编译、烧录、串口监视

  • 点击我们之前介绍的 编译，烧录，打开串口监视器按键

ESP32-S3-AMOLED-1.91-study-11.png

  • 编译可能需要较长时间才能完成，尤其是在第一次编译时

ESP32-S3-AMOLED-1.91-study-12.png

  • 在此过程中，ESP-IDF可能会占用大量CPU资源，因此可能会导致系统卡顿
  • 若是新工程首次烧录程序，将需要选择下载方式，选择 UART

ESP32-S3-AMOLED-1.91-study-13.png

  • 后续也可在 下载方式 处进行修改（点击即可弹出选项）

ESP32-S3-AMOLED-1.91-study-14.png

  • 因为板载自动下载电路，无需手动操作即可自动下载
  • 下载成功后，自动进入串口监视器，可以看到芯片输出对应的信息并提示10S后重启

ESP32-S3-AMOLED-1.91-study-15.png


使用IDF 示例程序

下文以使用“ESP32-S3-LCD-1.47-Demo”为例介绍工程的两种打开方式及使用的一般步骤、ESP-IDF工程项目详解，若使用其他工程，操作步骤类推。

软件内部打开

  • 打开 VScode 软件，选择文件夹打开示例

ESP32-S3-AMOLED-1.91-study-16.png

  • 选择提供的 ESP-IDF 下的示例，点击选择文件(位于 示例程序/Demo/ESP-IDF 路径下)

ESP32-S3-AMOLED-1.91-study-17.png


软件外部打开

  • 正确选择工程目录，打开工程，否则会影响后续程序编译烧录

ESP32-S3-AMOLED-1.91-study-18.png

  • 连接设备后，选择好COM口和型号，点击下方编译并烧录即可实现程序控制

ESP32-S3-AMOLED-1.91-study-19.png

ESP-IDF工程项目详解

  • 组件（Component）:ESP-IDF中的组件是构建应用的基本模块，每个组件通常是相对独立的代码库或库，能实现特定的功能或服务，可以被应用程序或是其他组件重复使用，类似于Python开发中的库的定义。
    • 组件的引用：Python开发环境中引入库只需要“import 库名或路径”即可，而ESP-IDF基于C语言基础，引入库是通过CMakeLists.txt进行配置和定义的。
    • CmakeLists.txt的作用：ESP-IDF编译时编译工具CMake会首先通过读取工程目录的顶层CMakeLists.txt的内容来读取构建规则，识别需要编译的内容。当在CMakeLists.txt中引入了需要的组件、程序后，编译工具CMake会根据索引导入每个所需要编译的内容。编译过程如：

ESP32-P4 VSCode ESP-IDF GettingStart 240906 02.png

修改COM口

  • 此处显示使用对应的COM口，点击可以修改对应COM口
  • 请根据设备对应COM口进行选择（可通过设备管理器查看）
  • 若出现下载失败的情况请点击复位按键1秒以上或进入下载模式，等待 PC 端重新识别到设备后再次下载

ESP32-S3-AMOLED-1.91-study-07.png

修改驱动对象

  • 选择我们需要驱动的对象，下图以主芯片为ESP32S3 以例（用户根据手头实物板子的主控芯片对应设置）

ESP32-S3-AMOLED-1.91-study-08.png

  • 选择openocd的路径，这里对我们没有影响，所以我们随便选择一个即可

ESP32-S3-AMOLED-1.91-study-09.png

其余状态栏简介

①.ESP-IDF开发环境版本管理器，当我们的工程需要区分开发环境版本时，可以通过安装不同版本的ESP-IDF来分别管理，当工程使用特定版本时，可以通过使用它来切换
②.设备烧录COM口，选择以将编译好的程序烧录进芯片上
③.set-target 芯片型号选择，选择对应的芯片型号，如:ESP32-P4-Nano需要选择 esp32p4 为目标芯片
④.menuconfig，点击修改sdkconfig配置文件内容，项目配置详细资料
⑤.fullclean 清理按钮，当工程编译报错或其他操作污染编译内容时，通过点击清理全部编译内容
⑥. Build 构建工程，当一个工程满足构建时，通过此按钮进行编译
⑦.当前下载方式，默认为UART
⑧.flash烧录按钮，当一个工程Build构建通过时，选择对应开发板COM口，点击此按钮可以将编译好的固件烧录至芯片
⑨.monitor开启烧录口监控，当一个工程Build-->flash后，可通过点击此按钮查看烧录、调试口输出的l0g，以便观察应用程序是否正常工作
⑩.Debug调试
⑪.Build Flash Monitor 一键按钮，用于连续执行Build-->Flash-->Monitor，常被称作小火苗

ESP32-S3-AMOLED-1.91-study-10.png

编译、烧录、串口监视

  • 点击我们之前介绍的 编译，烧录，打开串口监视器按键

ESP32-S3-AMOLED-1.91-study-11.png

  • 编译可能需要较长时间才能完成，尤其是在第一次编译时

ESP32-S3-AMOLED-1.91-study-12.png

  • 在此过程中，ESP-IDF可能会占用大量CPU资源，因此可能会导致系统卡顿
  • 若是新工程首次烧录程序，将需要选择下载方式，选择 UART

ESP32-S3-AMOLED-1.91-study-13.png

  • 后续也可在 下载方式 处进行修改（点击即可弹出选项）

ESP32-S3-AMOLED-1.91-study-14.png

  • 因为板载自动下载电路，无需手动操作即可自动下载
  • 下载成功后，自动进入串口监视器，可以看到芯片输出对应的信息并提示10S后重启

ESP32-S3-AMOLED-1.91-study-15.png


使用IDF 示例程序

下文以使用“ESP32-S3-LCD-1.47-Demo”为例介绍工程的两种打开方式及使用的一般步骤、ESP-IDF工程项目详解，若使用其他工程，操作步骤类推。

软件内部打开

  • 打开 VScode 软件，选择文件夹打开示例

ESP32-S3-AMOLED-1.91-study-16.png

  • 选择提供的 ESP-IDF 下的示例，点击选择文件(位于 示例程序/Demo/ESP-IDF 路径下)

ESP32-S3-AMOLED-1.91-study-17.png


软件外部打开

  • 正确选择工程目录，打开工程，否则会影响后续程序编译烧录

ESP32-S3-AMOLED-1.91-study-18.png

  • 连接设备后，选择好COM口和型号，点击下方编译并烧录即可实现程序控制

ESP32-S3-AMOLED-1.91-study-19.png

ESP-IDF工程项目详解

  • 组件（Component）:ESP-IDF中的组件是构建应用的基本模块，每个组件通常是相对独立的代码库或库，能实现特定的功能或服务，可以被应用程序或是其他组件重复使用，类似于Python开发中的库的定义。
    • 组件的引用：Python开发环境中引入库只需要“import 库名或路径”即可，而ESP-IDF基于C语言基础，引入库是通过CMakeLists.txt进行配置和定义的。
    • CmakeLists.txt的作用：ESP-IDF编译时编译工具CMake会首先通过读取工程目录的顶层CMakeLists.txt的内容来读取构建规则，识别需要编译的内容。当在CMakeLists.txt中引入了需要的组件、程序后，编译工具CMake会根据索引导入每个所需要编译的内容。编译过程如：

ESP32-P4 VSCode ESP-IDF GettingStart 240906 02.png

示例程序

Demo-flow-01.png

  • ESP32-C6-Touch-AMOLED-1.43 示例程序
示例程序 基础例程说明 依赖库
01_ADC_Test 获取锂电池的电压值 -
02_I2C_PCF85063 打印RTC芯片的实时时间 SensorLib
03_I2C_QMI8658 打印IMU发出来的原始数据 SensorLib
04_SD_Card 加载显示SD卡的信息 -
05_WIFI_AP 设置为AP模式，可获取接入设备的IP地址 -
06_WIFI_STA 设置为STA模式，可接入WiFi获取IP地址 -
07_BATT_PWR_Test 单独使用锂电池供电时，通过PWR按键控制电源 -
08_Audio_Test 扬声器播放麦克风录到的声音 -
09_LVGL_V8_Test LVGLV8例程 LVGL V8.3.11
10_LVGL_V9_Test LVGLV9例程 LVGL V9.3.0
11_FactoryProgram 综合示例 LVGL V8.3.11


01_ADC_Test

【程序说明】

  • 通过GPIO连接的模拟量电压经过ADC转换成数字量，然后通过计算得到实际的锂电池电压，并打印到终端。

【硬件连接】

  • 使用USB线把板子接入电脑

【代码分析】

  • adc_bsp_init(void) ：初始化 ADC1，包括创建 ADC 单次触发单元并配置 ADC1 的通道 0。
  • adc_get_value(float *value,int *data) ：读取 ADC1 通道 0 的值，并根据参考电压和分辨率计算出对应的电压值存储在传入的指针指向的位置，如果读取失败则存储 0。
  • adc_example(void* parameter)：初始化 ADC1 后，创建一个ADC任务，该任务每隔 1 秒读取一次ADC的值，通过读取的ADC原始值计算出系统的电压。

【运行效果】

  • 程序编译下载完成，打开串口监控可以看到打印输出的ADC的值和电压，如下图所示：

ESP32-S3-LCD-3.16-19.png

02_I2C_PCF85063

【程序说明】

  • 通过I2C协议，分别对PCF85063芯片进行初始化、设置时间、间隔读取时间，然后打印到终端

【硬件连接】

  • 使用USB线把板子接入电脑

【代码分析】

  • void i2c_rtc_loop_task(void *arg) ：创建一个RTC任务来实现RTC功能，每隔1秒读取一次RTC芯片的时钟，然后输出到终端。

【运行效果】

  • 程序编译下载完成，打开串口监控可以看到打印输出的RTC时间，如下图所示：

ESP32-S3-LCD-3.16-20.png

03_I2C_QMI8658

【程序说明】

  • 通过I2C协议，对QMI8658芯片进行初始化设置，然后每隔200毫秒读取对应的姿态信息打印到终端

【硬件连接】

  • 使用USB线把板子接入电脑

【代码分析】

  • void i2c_qmi_loop_task(void *arg) ：创建一个QMI任务来实现获取姿态信息，在任务中读取并打印加速度计、陀螺仪数据，并将获取的结果输出到串口控制台，间隔200毫秒。

【运行效果】

  • 打开串口监控，可以看到打印输出的IMU发出来的原始数据(欧拉角需要自己转换)，如下图所示：

ESP32-S3-LCD-3.16-21.png

04_SD_Card

【程序说明】

  • 通过SDSPI方式驱动SD卡，成功挂载之后把SD卡信息打印到终端。

【硬件连接】

  • 上电之前先给板子装上FatFs格式的SD卡

【代码分析】

  • sdcard_init(void) ：使用SDSPI方式初始化SD卡。
  • sdcard_loop_task(void *arg)：测试SD卡读写功能的任务，需要取消#define sdcard_write_Test宏定义的注释。
//#define sdcard_write_Test

【运行效果】

  • 点击串口监控设备，可以看到输出的SD卡的信息，practical_size是SD卡的实际容量，如下图所示：

ESP32-S3-LCD-3.16-22.png

想了解更多关于Arduino ESP32库关于SD卡相关的使用？可访问：Arduino ESP32 库 SD 使用

05_WIFI_AP

【程序说明】

  • 该示例可将开发板设置为热点，允许手机或其他处于 STA 模式的设备连接到开发板。

【代码分析】

  • 在softap_example_main.c文件找到SSID和PASSWORD，然后手机或其他处于 STA 模式的设备即可使用该 SSID 和 PASSWORD 连接到开发板。
#define EXAMPLE_ESP_WIFI_SSID      "waveshare_esp32"
#define EXAMPLE_ESP_WIFI_PASSWORD      "wav123456"

【运行效果】

烧录完程序，打开串口终端，如果设备连接成功热点之后，会输出该设备的MAC地址和IP地址，如图： ESP32-S3-LCD-1.3-1008.png

06_WIFI_STA

【程序说明】

  • 该示例可将开发板配置为 STA 设备，以连接路由器，从而接入系统网络。

【代码分析】

  • 在esp_wifi_bsp.c文件找到ssid和password，然后将其修改为当前环境中可用路由器的SSID 和 Password。
wifi_config_t wifi_config = {
      .sta = {
        .ssid = "PDCN",
        .password = "1234567890",
      },
  };

【运行效果】

烧录完程序，打开串口终端，如果设备连接成功热点之后，会输出所获取的IP地址，如图： ESP32-S3-LCD-1.3-1009.png

07_BATT_PWR_Test

【程序说明】

  • 使用锂电池供电的情况下，演示如何通过PWR按键控制系统的电源。

【硬件连接】

  • 使用USB线把板子接入电脑

【代码分析】

  • setup_ui(lv_ui *ui) ：初始化ui界面，使得控制可视化。
  • esp_io_expander_new_i2c_tca9554() ：初始化锂电池控制IO端口。
  • user_button_init()：初始化按键以及各类触发事件。
  • example_button_task(void* parmeter)：等待按键事件触发的任务。

【运行效果】

  • 程序烧录完成后，断开USB供电，接入锂电池，通过长按PWR按键进行开机，如图：

Esp32c6-test-1.43-17.png 

1.长按PWR按键，等待屏幕显示"Power on succeeded"，表示启动成功，松开按键即可
2.再次长按PWR按键，等待屏幕显示"Power on failed"，表示电源关闭成功，松开按键即可

08_Audio_Test

【程序说明】

  • 演示如何获取麦克风的数据，然后再通过扬声器播放。

【硬件连接】

  • 使用USB线把板子接入电脑

【代码分析】

  • i2c_master_Init() ：初始化I2C总线。
  • esp_io_expander_new_i2c_tca9554() ：初始化功放CTRL控制IO端口。
  • esp_codec_dev_set_out_vol();：设置播放时的声音大小。
  • esp_codec_dev_set_in_gain()：设置录音的增益。

【运行效果】

  • 程序烧录完成后，对着麦克风说话，扬声器会自动播放录到的声音
1.如果感觉播放声音比较小，优先使用"esp_codec_dev_set_out_vol"调大播放音量
2.调大播放音量满足不了的情况下，可以使用"esp_codec_dev_set_in_gain"调大录音时的增益

09_LVGL_V8_Test

【程序说明】

  • 通过移植LVGL V8，在屏幕上实现一些多功能的GUI界面。

【硬件连接】

  • 使用USB线把板子接入电脑

【代码分析】

  • 如果需要旋转90度显示，可以在user_config.h文件找到#define EXAMPLE_Rotate_90宏定义，取消注释即可。
  • 如果需要进行背光测试，可以在user_config.h文件找到#define Backlight_Testing宏定义，取消注释即可。
//#define Backlight_Testing
//#define EXAMPLE_Rotate_90

【运行效果】

  • 程序烧录完成后，设备的运行效果如下：

Esp32c6-test-1.43-19.png

LVGL更多学习及使用可参考LVGL官方文档

10_LVGL_V9_Test

【程序说明】

  • 通过移植LVGL V9，在屏幕上实现一些多功能的GUI界面。

【硬件连接】

  • 使用USB线把板子接入电脑

【代码分析】

  • 如果需要旋转90度显示，可以在user_config.h文件找到#define EXAMPLE_Rotate_90宏定义，取消注释即可。
  • 如果需要进行背光测试，可以在user_config.h文件找到#define Backlight_Testing宏定义，取消注释即可。
//#define Backlight_Testing
//#define EXAMPLE_Rotate_90

【运行效果】

  • 程序烧录完成后，设备的运行效果如下：

Esp32c6-test-1.43-19.png

LVGL更多学习及使用可参考LVGL官方文档

11_FactoryProgram

【程序说明】

  • 综合性工程，简单测试板载硬件功能，也可以直接使用我们提供的BIN固件烧录。

【硬件连接】

  • 使用USB线把板子接入电脑

【运行效果】

  • 显示屏从红、绿、蓝三种颜色进行跳转(跳转间隔1.5秒)，如图：

Esp32c6-test-1.43-2.png

  • 系统跑完上面的颜色之后会自动进入板载硬件信息界面，如图：

Esp32c6-test-1.43-3.png

1.可以显示ESP32C6叠封的Flash
2.显示接入SD卡的实际容量
3.显示接入锂电池电压
4.实时显示rtc时间和QMI姿态数据
5.扫描周围的蓝牙和wifi设备
  • 在板载硬件信息界面单击BOOT按键进入Touch功能界面，如图：

Esp32c6-test-1.43-20.png

  • 再次单击BOOT按键，退出Touch的功能界面，进行麦克风收音和扬声器播放音乐功能：
1.对着麦克风说话，扬声器会自动播放收录的声音
2.按住BOOT按键，可以播放音乐，松开停止
  • 检验SD卡读写功能，如图：

Esp32c6-test-1.43-6.png

1.双击BOOT按键即可检验
  • 往左滑动，进入到设置AMOLED背光界面，如图：

Esp32c6-test-1.43-7.png 

1.通过滑块实现控制背光
  • 单独使用锂电池供电，PWR按键控制电源：
1.长按PWR按键打开系统电源，再次长按PWR可以关机系统电源

小智AI应用

为顺利操作，请仔细阅读FAQ，提前了解可能的问题。声音问题，可通过对话将声音设置为最大，如：“将声音调至最大”。

七牛云接入


ESP32-S3-PhotoPainter-3.png


ESP32-S3-PhotoPainter-4.png

  • 3.进入main\Kconfig.projbuild同步修改OTA地址为七牛云的OTA地址，如图：


ESP32-S3-PhotoPainter-5.png

  • 4.选择对应的产品型号，这里以ESP32-S3-Touch-LCD-3.49为例，该产品具备回声消除电路，可以打开AEC，如图：


ESP32-S3-PhotoPainter-6.png

  • 5.正常编译工程->烧录工程，烧录成功之后，配网、添加6位验证码添加到七牛云控制台，如图：


ESP32-S3-PhotoPainter-7.png
ESP32-S3-PhotoPainter-8.png

  • 6.到此即可成功接入七牛云；更多功能，可以在控制台添加，自定义MCP，记忆体，知识库等等

Flash固件的烧录与擦除

  • 当前示例程序有提供测试固件，可通过直接烧录测试固件来测试板载设备功能正常与否
  • bin文件路径：
    ..\ESP32-C6-Touch-AMOLED-1.43-Demo\Firmware
Flash固件的烧录与擦除教程参考

资料

原理图

示例程序

结构尺寸

数据手册

ESP32-C6

其他器件

软件工具

Arduino

VScode

固件烧录工具

其他资料链接

FAQ

问题：发现触摸会出现报错？

  • 是因为官方I2C驱动底层原因，降低idf版本至5.1.6以下5.0.0以上即可解决。


问题：模块下载程序后，重新下载，有时会出现无法连接串口，或者烧录失败的情况？

  • 可长按BOOT按键，重新上电，此时模块可进入下载模式，可解决大部分无法下载的问题。


问题： VSCode环境搭建失败?

  • 优先考虑网络问题，试着切换别得网络


问题：Arduino程序编译报错？

  • 检查Arduino IDE -> Tools有没有正确配置


问题： 显示图片滑动的时候比较卡?

  • 修改LVGL显示缓存为整个屏幕大小
  • 在配置选项里面修改LV_IMG_CACHE_DEF_SIZE改到1000可以得到一定优化


问题： 显示不了中文?

  • 基本的中文可以显示，如果是生僻字显示不了
  • 可以把需要的生僻字通过转码软件转码，然后加入到工程字库里面


问题： 程序首次编译超级慢怎么处理?

  • 首次编译很慢属于正常情况，耐心等待即可


问题： 找不到AppData文件夹怎么处理？

  • 部分AppData文件夹是默认隐藏的，可以设置为显示。
  • 英文系统：资源管理器->View->勾选“Hidden items”
  • 中文系统：文件资源管理器->查看->显示->勾选“隐藏的项目”


问题： 怎么查看自己使用的COM口?

  • Windows系统：

①通过设备管理器查看： 按下Windows + R键打开“运行”对话框； 输入devmgmt.msc并按回车键打开设备管理器； 展开“端口（COM和LPT）”部分，这里会列出所有的COM端口及其当前状态。
②使用命令提示符查看： 打开命令提示符（CMD）； 输入mode命令，这将显示所有COM端口的状态信息。
③查看硬件连接： 如果你已经连接了外部设备到COM口，通常设备会占用一个端口号，可以通过查看连接的硬件来确定使用的是哪个端口。

  • Linux系统：

①使用dmesg命令查看： 打开终端。
②使用ls命令查看： 输入ls /dev/ttyS*或ls /dev/ttyUSB*来列出所有的串口设备。
③使用setserial命令查看： 输入setserial -g /dev/ttyS*来查看所有串口设备的配置信息。


问题：在使用 MAC 设备时，程序烧录失败？


问题：锂电池不清楚怎么选择？

  • 正常的3.7V-4.2V 正向MX1.25端子锂电池，


问题：如何使用SquareLine Studio设计界面


技术支持

联系人：赵工
EMAIL：3005223819@qq.com (邮箱不常用，推荐使用QQ或微信沟通)
QQ：3005223819
微信：扫下方二维码添加
Zyj-wx.png

说明：进行售后服务前，请准备好客户信息（定货单位、定货人等），以供验证
取自“https://www.waveshare.net/w/index.php?title=ESP32-C6-Touch-AMOLED-1.43&oldid=139584”