ESP32-C6-LCD-1.9

来自Waveshare Wiki
跳转至： 导航、 搜索
ESP32-C6-LCD-1.9-details-3-1.jpg
ESP32-C6-LCD-1.9-details-3-2.jpg
{{{name2}}}
{{{name3}}}
功能简介
特性 无特性，不解释
主控 ESP32-C6
' 无特性，不解释
' 无特性，不解释
' 无特性，不解释
接口 UART I2C USB

产品介绍

产品简介

本产品采用 ESP32-C6FH8 芯片，支持 2.4GHz Wi-Fi 6 和 BLE 5 蓝牙功能，叠封 8MB Flash，板载 1.9 寸 LCD 显示屏，可流畅运行 LVGL 等 GUI 界面程序。板载 QMI8658 六轴传感器、Micro SD 卡槽和锂电池充电等外设资源，同时预留 Pico 兼容引脚接口，兼容性和扩展性强，可快速开发 ESP32-C6 的 HMI 等应用。

产品特性

  • 搭载 ESP32-C6 高性能 32 位 RISC-V 处理器，主频高达 160MHz
  • 支持 2.4GHz Wi-Fi 6 (802.11 ax/b/g/n) 和 Bluetooth 5 (LE)，板载天线
  • 内置 512KB HP SRAM、16KB LP SRAM 和 320KB ROM，叠封 8MB Flash
  • 板载 1.9 英寸 LCD 屏，170 × 320 分辨率，262K 彩色，能清晰地显示彩色图片
  • 板载 QMI8658 六轴惯性测量单元（3 轴加速度、3 轴陀螺仪），可检测运动姿态拓展应用
  • 板载 USB Type-C 接口，可用于供电和下载调试，方便开发使用
  • 板载 3.7V MX1.25 锂电池充放电接口
  • 板载 Micro SD 卡槽，可外接 SD 卡存储图片或文件
  • 板载 Pico 兼容接口，引出丰富的外设接口，兼容性和扩展性强

资源简介

ESP32-C6-LCD-1.9-details-intro.jpg

1、ESP32-C6FH8
    叠封 8Mb Flash，运行频率高达 160MHz
2、TCA9554
    扩展 8 通道 GPIO 芯片，提升 IO 灵活性
3、MX1.25 3.7V 锂电池接口
    用于连接锂电池，支持充放电功能
4、RESET 按键
    系统复位，便于调试
5、USB Type-C 接口
    支持电源输入和数据传输
6、Micro SD 卡槽 (背面)
    用于扩展存储，支持 Micro SD 卡

7、充电指示灯
    充满熄灭
8、BOOT 按键
    用于下载程序或进入引导模式
9、WS2812 (背面，仅限无触控版本）
    RGB 灯珠，支持多彩光效
10、QMI8658 (背面)
    IMU 六轴惯性传感器（3 轴陀螺仪 + 3 轴加速度计)
11、IPEX1 外部天线接口 (仅限带触控版本)
    需要修改焊点接入
12、贴片陶瓷天线
    板载天线设计，节省空间，信号稳定

接口介绍

需要更加详细请查阅原理图
Esp32 c6 lcd 1.9 1.png

产品尺寸

ESP32-C6-LCD-1.9

ESP32-C6-LCD-1.9-details-size.jpg

ESP32-C6-Touch-LCD-1.9

ESP32-C6-LCD-1.9-details-size-1.jpg

LCD参数

Esp32 c6 lcd 1.9 2.png

使用说明

目前提供 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-LCD-1.9 x1
  • SD卡 x1 (非必需)
  • USB线 type A公口 转 Type C公口 x1

Esp32 c6 lcd 1.9 3.png

在操作前，建议先浏览目录，快速了解文档结构。为顺利操作，请仔细阅读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-LCD-1.9 开发板安装说明
板名称 板安装要求 版本号要求
ESP32-C6-LCD-1.9/ESP32C6 Dev Module “离线”安装/“在线”安装 ≥3.0.7

安装库

  • 在安装 Arduino 库时，通常有两种方式可供选择：在线安装 和 离线安装。若库安装要求离线安装，则必须使用提供的库文件。
    对于大多数库，用户可以通过 Arduino 软件的在线库管理器轻松搜索并安装。然而，一些开源库或自定义库未被同步到 Arduino 库管理器中，因此无法通过在线搜索获取。在这种情况下，用户只能通过离线方式手动安装这些库。
  • 库安装教程，详见：Arduino 库管理教程
  • ESP32-C6-LCD-1.9 库文件存放于示例程序中，存放路径：
    ..\ESP32-C6-LCD-1.9-Demo\Arduino\libraries
  • ESP32-C6-LCD-1.9-Demo 库文件安装说明
库名称 说明 版本 库安装要求
LVGL 图形库 v8.4.0 “离线”安装
Arduino_GFX_Library 图形库 v1.5.6 “离线/在线”安装
Freenove_WS2812_Lib_for_ESP32 ws2812驱动库 v2.0.0 “离线/在线”安装

运行第一个 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-LCD-1.9 示例程序
示例程序 基础例程说明 依赖库
01_ADC_Test 读取系统当前的电压值 -
02_I2C_QMI8658 打印IMU发出来的原始数据 -
03_SD_Card 加载显示SD卡的信息 -
04_WS2812_Test 驱动WS2812RGB灯珠 Freenove_WS2812_Lib_for_ESP32
05_WIFI_AP 设置为AP模式，可获取接入设备的IP地址 -
06_WIFI_STA 设置为STA模式，可接入WiFi获取IP地址 -
07_Hello_World_GFX GFX基础示例 Arduino_GFX_Library
08_LVGL_Test LVGL例程 LVGL


01_ADC_Test

【程序说明】

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

【硬件连接】

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

Esp32 c6 lcd 1.9 5.png

【代码分析】

  • 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-Touch-AMOLED-1.43-demo-03.png

  • ADC采样值是1900左右，系统电压是4.9V左右，若想具体分析，可以查看原理图。

02_I2C_QMI8658

【程序说明】

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

【硬件连接】

  • 使用USB线把板子接入电脑（参考示例01）

【代码分析】

  • qmi8658c_example(void* parameter) ：该函数初始化 QMI8658 设备，在无限循环中读取并打印加速度计、陀螺仪数据和温度数据，每 1 秒执行一次，旋转板子的过程中陀螺仪数据随着旋转越快而越大，加速度计会根据当前的位置计算出对应的加速度。

【运行效果】

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

ESP32-S3-Touch-AMOLED-1.43-demo-05.png

  • 数据每隔 1 秒输出一次，若需修改或参考，可直接进入 qmi 源文件进行操作。

03_SD_Card

【程序说明】

  • 通过使用SPI总线驱动SD卡，成功挂载SD卡之后把SD卡信息打印到终端，同时每隔1秒往writeTest.txt文件读写数据。

【硬件连接】

  • 将fat32格式的SD卡接入板子，使用USB线把板子接入电脑（参考示例01）

【代码分析】

  • 在03_SD_Card.ino文件找到#define sdcard_write_Test取消该宏定义注释，即可测试SD卡读写功能。
//#define sdcard_write_Test

【运行效果】

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

ESP32-S3-AMOLED-1.91-Ar-demo-07.png

04_WS2812_Test

【程序说明】

  • 驱动WS2812RGB灯珠，让其实现流动的彩虹效果，该示例仅适用ESP32-C6-LCD-1.9。

【硬件连接】

  • 使用USB线把板子接入电脑（参考示例01）

【代码分析】

  • 先对文件的宏定义进行分析。
#define LEDS_COUNT  2 //WS2812-RGB灯数量
#define LEDS_PIN    3 //WS2812-GPIO控制引脚
#define CHANNEL	    0 //WS2812控制通道
  • 对主要函数进行分析。
strip.setLedColorData(id, color); //id：RGB灯的ID，color：实际的颜色0XFF0000表示红色
strip.setLedColorData(id, r, g, b); //r,g,b：实际的三原色数值
strip.show();//把颜色数据推送到WS2812

【运行效果】

  • 实际效果如下：

Esp32 s3 lcd 1.9 vid -middle-original.gif

05_WIFI_AP

【程序说明】

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

【硬件连接】

  • 使用USB线把板子接入电脑（参考示例01）

【代码分析】

  • 在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

【程序说明】

  • 把开发板作为一个终端角色，可以连接环境可用的AP，成功连接之后打印获取到的IP信息到终端。

【硬件连接】

  • 使用USB线把板子接入电脑（参考示例01）

【代码修改】

该工程实现芯片处于STA模式下连接WIFI而且获取到IP地址，在编译、下载固件之前，需要修改一些代码，此处修改成所处环境可用的WIFI路由器名字和密码。
ESP32-S3-AMOLED-1.91-Ar-demo-08.png

【代码分析】

  • wifi_init(void) ：该函数用于初始化 ESP32 的 Wi-Fi 连接。它将 ESP32 设置为 Wi-Fi 站点模式，尝试连接到指定的 Wi-Fi 网络（通过ssid和password）。如果连接成功，打印本地 IP 地址；如果在一定时间内（20 * 500 毫秒）未能连接成功，则打印连接失败信息。同时，函数还可以设置自动连接和自动重连功能。

【运行效果】

  • 芯片处于STA模式下成功连接WIFI，并且点击串口监控设备，可以看到获取到的IP地址，如图：

ESP32-S3-AMOLED-1.91-Ar-demo-09.png

07_Hello_World_GFX

【程序说明】

  • 通过移植Arduino_GFX_Library，在屏幕上实现一些基础的GUI界面。

【硬件连接】

  • 使用USB线把板子接入电脑（参考示例01）

【代码分析】

  • 通过配置Arduino_DataBus和Arduino_GFX两个类，即可驱动LCD。
Arduino_DataBus *bus = new Arduino_HWSPI(6 /* DC */, 7 /* CS */, 5 /* SCK */, 4 /* MOSI */);
Arduino_GFX *gfx = new Arduino_ST7789(bus, 14 /* RST */,0 /*rotation*/,0/*IPS*/,170/*w*/,320/*h*/,35/*offsetx1*/,0/*offsety1*/,35/*offsetx2*/,0/*offsety2*/);

【运行效果】

烧录完程序，可以看到屏幕上显示多种格式的Hello World，如图：
ESP32-S3-LCD-1.9-details-intro200.png

08_LVGL_Test

【程序说明】

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

【硬件连接】

  • 使用USB线把板子接入电脑（参考示例01）

【代码分析】

针对 LVGL，lvgl_conf.h 是其配置文件，下面对一些常用内容进行说明。 

/*Color depth: 1 (1 byte per pixel), 8 (RGB332), 16 (RGB565), 32 (ARGB8888)*/
#define LV_COLOR_DEPTH 16//Color depth, a macro definition that must be concerned with porting LVGL


#define LV_MEM_CUSTOM 0
#if LV_MEM_CUSTOM == 0
    /*Size of the memory available for `lv_mem_alloc()` in bytes (>= 2kB)*/
    #define LV_MEM_SIZE (48U * 1024U)          /*[bytes]*/

    /*Set an address for the memory pool instead of allocating it as a normal array. Can be in external SRAM too.*/
    #define LV_MEM_ADR 0     /*0: unused*/
    /*Instead of an address give a memory allocator that will be called to get a memory pool for LVGL. E.g. my_malloc*/
    #if LV_MEM_ADR == 0
        #undef LV_MEM_POOL_INCLUDE
        #undef LV_MEM_POOL_ALLOC
    #endif

#else       /*LV_MEM_CUSTOM*/
    #define LV_MEM_CUSTOM_INCLUDE <stdlib.h>   /*Header for the dynamic memory function*/
    #define LV_MEM_CUSTOM_ALLOC   malloc
    #define LV_MEM_CUSTOM_FREE    free
    #define LV_MEM_CUSTOM_REALLOC realloc
#endif     /*LV_MEM_CUSTOM*/
//The above section is mainly for LVGL memory allocation, 
//which defaults to lv_mem_alloc() versus lv_mem_free().

还有一些LVGL的demo、文件系统都可以在conf配置文件里面设置。

【代码修改】

  • 如果需要旋转90度显示，可以在lcd_config.h文件找到Direction宏定义，二者取其一。
#define Rotate 1    //Rotation 90
#define Normal 0    //Normal
#define Direction   Normal
  • 该示例为了兼容ESP32-C6-LCD-1.9默认不启用Touch，如需启用可以在lcd_config.h文件找到EXAMPLE_USE_TOUCH宏定义置1即可。
#define EXAMPLE_USE_TOUCH      0
  • 板子上的SD卡和屏幕共用SPI，如需启用共存可以在lcd_config.h文件找到EXAMPLE_USE_SDCARD宏定义置1即可。
#define EXAMPLE_USE_SDCARD     0

【运行效果】

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

ESP32-C6-LCD-1.9-20.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

示例程序

Demo-flow-01.png

  • ESP32-C6-LCD-1.9 示例程序
示例程序 基础例程说明 依赖库
01_ADC_Test 读取系统当前的电压值 -
02_I2C_QMI8658 打印IMU发出来的原始数据 -
03_SD_Card 加载显示SD卡的信息 -
04_WS2812_Test 驱动WS2812RGB灯珠 -
05_WIFI_AP 设置为AP模式，可获取接入设备的IP地址 -
06_WIFI_STA 设置为STA模式，可接入WiFi获取IP地址 -
07_LVGL_Test LVGL例程 LVGL
08_FactoryProgram 综合性示例 LVGL


01_ADC_Test

【程序说明】

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

【硬件连接】

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

Esp32 c6 lcd 1.9 5.png

【代码分析】

  • 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-Touch-AMOLED-1.43-demo-10.png

  • ADC采样值是1900左右，系统电压是4.9V左右，若想具体分析，可以查看原理图。

02_I2C_QMI8658

【程序说明】

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

【硬件连接】

  • 使用USB线把板子接入电脑（参考示例01）

【代码分析】

  • qmi8658c_example(void* parameter) ：该函数初始化 QMI8658 设备，在无限循环中读取并打印加速度计、陀螺仪数据和温度数据，每 1 秒执行一次，旋转板子的过程中陀螺仪数据随着旋转越快而越大，加速度计会根据当前的位置计算出对应的加速度。

【运行效果】

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

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

ESP32-S3-Touch-AMOLED-1.43-demo-12.png

  • 可以看到，每隔1秒输出一次，如果需要修改或者参考，可以直接进去qmi源文件修改。

03_SD_Card

【程序说明】

  • 通过使用SPI总线驱动SD卡，成功挂载SD卡之后把SD卡信息打印到终端，同时每隔1秒往writeTest.txt文件读写数据。

【硬件连接】

  • 将fat32格式的SD卡接入板子，使用USB线把板子接入电脑（参考示例01）

【代码分析】

  • 在user_app.c文件找到#define sdcard_write_Test取消该宏定义注释，即可测试SD卡读写功能。
//#define sdcard_write_Test

【运行效果】

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

ESP32-S3-Touch-AMOLED-1.43-demo-13.png

04_WS2812_Test

【程序说明】

  • 驱动WS2812RGB灯珠，让其实现流动的彩虹效果，该示例仅适用ESP32-C6-LCD-1.9。

【硬件连接】

  • 使用USB线把板子接入电脑（参考示例01）

【代码分析】

  • 先对ws2812_bsp.h文件的宏定义进行分析。
#define LEDS_COUNT  2 //WS2812-RGB灯数量
#define LEDS_PIN    3 //WS2812-GPIO控制引脚
  • 对主要函数进行分析。
void ws2812_Init(void); //初始化ws2812
uint32_t ws2812_Wheel(uint8_t pos); //对0-255种颜色进行转换成标准24位RGB颜色值
void ws2812_set_pixel(uint8_t id,uint8_t r,uint8_t g,uint8_t b); //把r,g,b颜色值推送至对应的WS2812

【运行效果】

  • 实际效果如下：

Esp32 s3 lcd 1.9 vid -middle-original.gif

05_WIFI_AP

【程序说明】

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

【硬件连接】

  • 使用USB线把板子接入电脑（参考示例01）

【代码分析】

  • 在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 设备，以连接路由器，从而接入系统网络。

【硬件连接】

  • 使用USB线把板子接入电脑（参考示例01）

【代码分析】

  • 在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_LVGL_Test

【程序说明】

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

【硬件连接】

  • 使用USB线把板子接入电脑（参考示例01）

【代码分析】

  • 如果需要旋转90度显示，可以在main.c文件找到Direction宏定义，二者取其一。
#define Rotate 1    //Rotation 90
#define Normal 0    //Normal
#define Direction   Normal
  • 该示例为了兼容ESP32-C6-LCD-1.9默认不启用Touch，如需启用可以在main.c文件找到EXAMPLE_USE_TOUCH宏定义置1即可。
#define EXAMPLE_USE_TOUCH      0
  • 板子上的SD卡和屏幕共用SPI，如需启用共存可以在main.c文件找到EXAMPLE_USE_SDCARD宏定义置1即可。
#define EXAMPLE_USE_SDCARD     0

【运行效果】

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

ESP32-C6-LCD-1.9-20.png

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

08_FactoryProgram

【程序说明】

  • 这是一个综合性工程，用于测试板载功能。该示例对 IDF 版本有所要求，V5.2.0 及以上版本可能无法扫描到周围 WiFi。如果因版本过高导致测试失败，可使用较低版本进行编译，或直接使用我们提供的 BIN 固件。

【硬件连接】

  • 使用USB线把板子接入电脑（参考示例01）

【代码分析】

  • ESP32-C6-LCD-1.9通过BOOT按钮单击切换页面，双击打开/关闭背光，长按测试SD卡读写；ESP32-C6-Touch-LCD-1.9通过BOOT按钮或者Touch进行控制。

【运行效果】

  • 程序烧录完成，等待三原色显示，如图：

ESP32-C6-LCD-1.9-10.png

  • 显示完RGB之后，将会自动跳转到时钟界面，如图：

ESP32-C6-LCD-1.9-11.png

  • 单击BOOT按键切换页面，可以看到该页面是一些板载硬件信息，如图：

ESP32-C6-LCD-1.9-12.png

Flash固件的烧录与擦除

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

资料

原理图

示例程序

尺寸外观文件

数据手册

ESP32-C6

其他器件

软件工具

Arduino

VScode

固件烧录工具

其他资料链接

FAQ

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

  • 可长按BOOT按键，同时按下RESET，然后松开RESET，再松开BOOT按键，此时模块可进入下载模式，可解决大部分无法下载的问题。


问题： VSCode环境搭建失败?

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


问题： 显示/背光不稳定?

  • 是否有导体（比如手）大面积触碰排针


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

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


问题： 显示不了中文?

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


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

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


问题： ESP-IDF烧录成功串口显示“waiting for download...”怎么处理？

  • 插拔一下USB


问题： 找不到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 设备时，程序烧录失败？


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


技术支持

  • 联系人：吴工
  • 邮箱：2880803592@qq.com
  • 微信：

Img 301.png

取自“https://www.waveshare.net/w/index.php?title=ESP32-C6-LCD-1.9&oldid=127850”