本产品采用 ESP32-C6FH8 芯片,支持 2.4GHz Wi-Fi 6 和 BLE 5 蓝牙功能,叠封 8MB Flash,板载 1.9 寸 LCD 显示屏,可流畅运行 LVGL 等 GUI 界面程序。板载 QMI8658 六轴传感器、Micro SD 卡槽和锂电池充电等外设资源,同时预留 Pico 兼容引脚接口,兼容性和扩展性强,可快速开发 ESP32-C6 的 HMI 等应用。
1、ESP32-C6FH8 | 7、充电指示灯 |
需要更加详细请查阅原理图
目前提供 Arduino IDE 和 ESP-IDF 两种开发工具和框架,提供了灵活的开发选择,你可以根据项目需求和个人习惯选择适合的开发工具。
这两种开发方式各有其优势,开发者可以根据自身需求和技能水平进行选择。Arduino 适合初学者和非专业人士,因其简单易学、上手快。而对于有专业背景或对性能要求较高的开发者,ESP-IDF 是更好的选择,它提供了更高级的开发工具和更强的控制能力,适用于复杂项目的开发。
本章介绍 Arduino 环境搭建,包括 Arduino IDE、ESP32板管理、相关库的安装,程序编译下载及示例程序测试,帮助用户掌握开发板,便于二次开发。
板名称 | 板安装要求 | 版本号要求 |
---|---|---|
ESP32-C6-LCD-1.9/ESP32C6 Dev Module | “离线”安装/“在线”安装 | ≥3.0.7 |
..\ESP32-C6-LCD-1.9-Demo\Arduino\libraries
库名称 | 说明 | 版本 | 库安装要求 |
---|---|---|---|
LVGL | 图形库 | v8.4.0 | “离线”安装 |
Arduino_GFX_Library | 图形库 | v1.5.6 | “离线/在线”安装 |
Freenove_WS2812_Lib_for_ESP32 | ws2812驱动库 | v2.0.0 | “离线/在线”安装 |
File
-> New Sketch
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,点击保存
①. 点击选择下拉框选项“Select Other Board and Port”;
②. 搜索需要的开发板型号“esp32s3 dev module”并选择;
③. 选择COM口;
④. 保存选择。
①. 编译程序;②. 编译并下载程序;③. 下载成功。
示例程序 | 基础例程说明 | 依赖库 |
---|---|---|
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 |
【程序说明】
【硬件连接】
【代码分析】
【程序说明】
【硬件连接】
【代码分析】
【运行效果】
【程序说明】
writeTest.txt
文件读写数据。【硬件连接】
【代码分析】
03_SD_Card.ino
文件找到#define sdcard_write_Test
取消该宏定义注释,即可测试SD卡读写功能。//#define sdcard_write_Test
【运行效果】
【程序说明】
【硬件连接】
【代码分析】
#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
【运行效果】
【程序说明】
【硬件连接】
【代码分析】
05_WIFI_AP.ino
文件找到ssid
和password
,然后手机或其他处于 STA 模式的设备即可使用该 ssid 和 password 连接到开发板。const char *ssid = "ESP32_AP";
const char *password = "12345678";
【运行效果】
烧录完程序,打开串口终端,如果设备连接成功热点之后,会输出该设备的MAC地址,如图:
【程序说明】
【硬件连接】
【代码修改】
该工程实现芯片处于STA模式下连接WIFI而且获取到IP地址,在编译、下载固件之前,需要修改一些代码,此处修改成所处环境可用的WIFI路由器名字和密码。
【代码分析】
ssid
和password
)。如果连接成功,打印本地 IP 地址;如果在一定时间内(20 * 500 毫秒)未能连接成功,则打印连接失败信息。同时,函数还可以设置自动连接和自动重连功能。【运行效果】
【程序说明】
【硬件连接】
【代码分析】
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,如图:
【程序说明】
【硬件连接】
【代码分析】
针对 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配置文件里面设置。
【代码修改】
Direction
宏定义,二者取其一。#define Rotate 1 //Rotation 90
#define Normal 0 //Normal
#define Direction Normal
EXAMPLE_USE_TOUCH
宏定义置1即可。#define EXAMPLE_USE_TOUCH 0
EXAMPLE_USE_SDCARD
宏定义置1即可。#define EXAMPLE_USE_SDCARD 0
【运行效果】
本章介绍 ESP-IDF 环境搭建,包括 Visual Studio、Espressif IDF插件的安装,程序编译下载及示例程序测试,帮助用户掌握开发板,便于二次开发。
①选择对应例程
②其readme会说明该例程适用于什么芯片(下文有介绍例程怎么使用与文件结构,这里略)
③点击创建例程
①.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,常被称作小火苗
CMakeLists.txt
进行配置和定义的。CMake
会首先通过读取工程目录的顶层CMakeLists.txt
的内容来读取构建规则,识别需要编译的内容。当在CMakeLists.txt
中引入了需要的组件、程序后,编译工具CMake
会根据索引导入每个所需要编译的内容。编译过程如:示例程序 | 基础例程说明 | 依赖库 |
---|---|---|
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 |
【程序说明】
【硬件连接】
【代码分析】
【程序说明】
【硬件连接】
【代码分析】
【运行效果】
程序烧录完成后,设备的运行效果如下:
【程序说明】
writeTest.txt
文件读写数据。【硬件连接】
【代码分析】
user_app.c
文件找到#define sdcard_write_Test
取消该宏定义注释,即可测试SD卡读写功能。//#define sdcard_write_Test
【运行效果】
【程序说明】
【硬件连接】
【代码分析】
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
【运行效果】
【程序说明】
【硬件连接】
【代码分析】
softap_example_main.c
文件找到SSID
和PASSWORD
,然后手机或其他处于 STA 模式的设备即可使用该 SSID 和 PASSWORD 连接到开发板。#define EXAMPLE_ESP_WIFI_SSID "waveshare_esp32"
#define EXAMPLE_ESP_WIFI_PASSWORD "wav123456"
【运行效果】
烧录完程序,打开串口终端,如果设备连接成功热点之后,会输出该设备的MAC地址和IP地址,如图:
【程序说明】
【硬件连接】
【代码分析】
esp_wifi_bsp.c
文件找到ssid
和password
,然后将其修改为当前环境中可用路由器的SSID 和 Password。wifi_config_t wifi_config = {
.sta = {
.ssid = "PDCN",
.password = "1234567890",
},
};
【运行效果】
烧录完程序,打开串口终端,如果设备连接成功热点之后,会输出所获取的IP地址,如图:
【程序说明】
【硬件连接】
【代码分析】
Direction
宏定义,二者取其一。#define Rotate 1 //Rotation 90
#define Normal 0 //Normal
#define Direction Normal
EXAMPLE_USE_TOUCH
宏定义置1即可。#define EXAMPLE_USE_TOUCH 0
EXAMPLE_USE_SDCARD
宏定义置1即可。#define EXAMPLE_USE_SDCARD 0
【运行效果】
【程序说明】
【硬件连接】
【代码分析】
【运行效果】
..\ESP32-C6-LCD-1.9-Demo\Firmware
①通过设备管理器查看: 按下Windows + R键打开“运行”对话框; 输入devmgmt.msc并按回车键打开设备管理器; 展开“端口(COM和LPT)”部分,这里会列出所有的COM端口及其当前状态。
②使用命令提示符查看: 打开命令提示符(CMD); 输入mode命令,这将显示所有COM端口的状态信息。
③查看硬件连接: 如果你已经连接了外部设备到COM口,通常设备会占用一个端口号,可以通过查看连接的硬件来确定使用的是哪个端口。
①使用dmesg命令查看: 打开终端。
②使用ls命令查看: 输入ls /dev/ttyS*或ls /dev/ttyUSB*来列出所有的串口设备。
③使用setserial命令查看: 输入setserial -g /dev/ttyS*来查看所有串口设备的配置信息。
周一-周五(9:30-6:30)周六(9:30-5:30)
手机:13434470212
邮箱:services04@spotpear.cn
QQ:202004841