本产品是一款基于 ESP32-S3 的全反射屏 AIoT 开发板,支持 Wi-Fi 与 BLE 双模通信,搭载 4.2 英寸全反射显示屏 (RLCD),低功耗,显示效果接近墨水屏,更快的刷新响应。板载音频编解码电路、双麦克风、喇叭、SHTC3 高精度温湿度传感器、Micro SD 卡槽,RTC 接口以及电池充放电管理电路等,并预留 USB、UART、I2C 和多路 GPIO 接口,方便扩展。支持 AI 语音、温湿度监测与物联网控制,适用于 DIY 桌面智能摆件、电子日历、AI 智能体等,也可用于产品原型开发。



请参考 安装和配置 Arduino IDE 教程 下载安装 Arduino IDE 并添加 ESP32 支持。
| 库或文件名称 | 说明 | 版本 | 安装方式 |
|---|---|---|---|
| LVGL | 图形库 | v8.3.11/v9.3.0 | "离线安装" |
| SensorLib | 传感器库 | v0.3.1 | "离线/在线 安装" |
LVGL 及其驱动库的版本之间存在较强的依赖关系。例如,为 LVGL v8 编写的驱动可能不兼容 LVGL v9。为确保示例能够稳定复现,推荐使用上表列出的特定版本。混合使用不同版本的库可能导致编译失败或运行时异常。

Arduino 示例程序位于 示例程序包 的 Arduino/examples 目录中。
| 示例程序 | 基础例程说明 | 依赖库 |
|---|---|---|
| 01_WIFI_AP | 设置为 AP 模式,可获取接入设备的 IP 地址 | - |
| 02_WIFI_STA | 设置为 STA 模式,可接入 WiFi 获取 IP 地址 | - |
| 03_ADC_Test | 获取锂电池的电压值 | - |
| 04_I2C_PCF85063 | 打印 RTC 芯片的实时时间 | SensorLib |
| 05_I2C_SHTC3 | 打印温湿度传感器的数据 | - |
| 06_SD_Card | 加载显示 SD 卡的信息 | - |
| 07_Audio_Test | 扬声器播放麦克风录到的声音 | LVGL V8.3.11 |
| 08_LVGL_V8_Test | LVGLV8 例程 | LVGL V8.3.11 |
| 09_LVGL_V9_Test | LVGLV9 例程 | LVGL V9.3.0 |
【程序说明】
【硬件连接】
【代码分析】
在 01_WIFI_AP.ino 文件找到 ssid 和 password,然后手机或其他处于 STA 模式的设备即可使用该 ssid 和 password 连接到开发板。
const char *ssid = "ESP32_AP";
const char *password = "12345678";
【运行效果】
程序编译下载完成,打开串口监控可以看到打印输出的 ADC 的值和电压,如下图所示:

【程序说明】
【硬件连接】
【代码分析】
在 02_WIFI_STA.ino 文件找到 ssid 和 password,然后将其修改为当前环境中可用路由器的 SSID 和 Password。
const char *ssid = "you_ssid";
const char *password = "you_password";
【运行效果】
烧录完程序,打开串口终端,如果设备连接成功热点之后,会输出所获取的 IP 地址,如图:

【程序说明】
【硬件连接】
【代码分析】
Adc_PortInit(void):初始化 ADC1,包括创建 ADC 单次触发单元并配置 ADC1 的通道 3。float Adc_GetBatteryVoltage(int *data):读取 ADC1 通道 3 的值,返回实际的电压值。uint8_t Adc_GetBatteryLevel(void):返回电池的百分比。void Adc_LoopTask(void *arg):创建一个 ADC 任务,该任务每隔 1 秒读取一次 ADC 的值并打印到串口。【运行效果】
程序编译下载完成,打开串口监控可以看到打印输出的 ADC 的值和电压,如下图所示:

【程序说明】
【硬件连接】
【代码分析】
I2cMasterBus I2cbus(14,13,0); //I2C 总线初始化
void setup() {
Serial.begin(115200);
delay(1000);
Serial.printf("rtc-example run \n");
Rtc_Setup(&I2cbus, 0x51); //初始化 RTC RTC 从机地址 0x51
Rtc_SetTime(2025, 9, 9, 20, 15, 30); //设置 RTC 时间
}
void loop() {
rtcTimeStruct_t rtcData;
Rtc_GetTime(&rtcData); //获取 RTC 实时时间
Serial.printf("%d/%d/%d %02d:%02d:%02d \n",
rtcData.year, rtcData.month, rtcData.day, rtcData.hour, rtcData.minute,
rtcData.second);
delay(1000);
}
【运行效果】
程序编译下载完成,打开串口监控可以看到打印输出的 RTC 时间,如下图所示:

【程序说明】
【硬件连接】
【代码分析】
I2cMasterBus I2cbus(14,13,0);
Shtc3Port *shtc3port = NULL;
void setup() {
Serial.begin(115200);
delay(1000);
Serial.printf("shtc3-example run \n");
shtc3port = new Shtc3Port(I2cbus); //初始化 SHTC3
}
void loop() {
float rh,temp;
shtc3port->Shtc3_ReadTempHumi(&temp,&rh); //获取温湿度数据
Serial.printf("RH:%.2f%%,Temp:%.2f° \n",rh,temp);
delay(1000);
}
【运行效果】
打开串口监控,可以看到打印输出的温湿度数据,如下图所示:

【程序说明】
【硬件连接】
【代码分析】
#define sdcard_write_Test
CustomSDPort *sdcardPort = NULL;
void setup()
{
Serial.begin(115200);
delay(2000);
sdcardPort = new CustomSDPort("/sdcard"); //初始化 SDMMC 驱动
}
uint32_t value = 1;
char sdcard_read[45] = {""};
char sdcard_write[45] = {""};
void loop()
{
#ifdef sdcard_write_Test //测试 SD 卡读写功能
snprintf(sdcard_write,45,"sdcard_writeTest : %ld \n",value);
sdcardPort->SDPort_WriteFile("/sdcard/writeTest.txt",sdcard_write,strlen(sdcard_write));
vTaskDelay(pdMS_TO_TICKS(500));
sdcardPort->SDPort_ReadFile("/sdcard/writeTest.txt",(uint8_t *)sdcard_read,NULL);
Serial.printf("read data:%s\n",sdcard_read);
vTaskDelay(pdMS_TO_TICKS(500));
value++;
#endif
}
【运行效果】
点击串口监控设备,可以看到输出的 SD 卡的信息,如下图所示:

【程序说明】
【硬件连接】
【代码分析】
CodecPort_SetInfo("es8311 & es7210",1,16000,2,16):设置 Codec 芯片的采样率、通道数、位深。CodecPort_SetSpeakerVol(100):设置播放增益 100 。CodecPort_SetMicGain(35):设置麦克风增益 35 。Codec_LoopTask(void *arg):Codec 任务,实现录音、播放等功能。【运行效果】
程序烧录完成后,如图:

【程序说明】
【硬件连接】
【代码分析】
/*创建一个 IMG1 控件*/
ui->screen_img_1 = lv_img_create(ui->screen);
lv_obj_add_flag(ui->screen_img_1, LV_OBJ_FLAG_CLICKABLE);
lv_img_set_src(ui->screen_img_1, &_ein_alpha_400x300);
lv_img_set_pivot(ui->screen_img_1, 50,50);
lv_img_set_angle(ui->screen_img_1, 0);
lv_obj_set_pos(ui->screen_img_1, 0, 0);
lv_obj_set_size(ui->screen_img_1, 400, 300);
/*创建一个 IMG2 控件*/
ui->screen_img_2 = lv_img_create(ui->screen);
lv_obj_add_flag(ui->screen_img_2, LV_OBJ_FLAG_CLICKABLE);
lv_img_set_src(ui->screen_img_2, &_2_alpha_400x300);
lv_img_set_pivot(ui->screen_img_2, 50,50);
lv_img_set_angle(ui->screen_img_2, 0);
lv_obj_set_pos(ui->screen_img_2, 0, 0);
lv_obj_set_size(ui->screen_img_2, 400, 300);
lv_obj_add_flag(ui->screen_img_2, LV_OBJ_FLAG_HIDDEN);
【运行效果】
程序烧录完成后,间隔 1.5 秒交替显示,如图:

【程序说明】
【硬件连接】
【代码分析】
/*创建一个 IMG1 控件*/
ui->screen_img_1 = lv_image_create(ui->screen);
lv_obj_set_pos(ui->screen_img_1, 0, 0);
lv_obj_set_size(ui->screen_img_1, 400, 300);
lv_obj_add_flag(ui->screen_img_1, LV_OBJ_FLAG_CLICKABLE);
lv_image_set_src(ui->screen_img_1, &_ein_RGB565A8_400x300);
lv_image_set_pivot(ui->screen_img_1, 50,50);
lv_image_set_rotation(ui->screen_img_1, 0);
/*创建一个 IMG2 控件*/
ui->screen_img_2 = lv_image_create(ui->screen);
lv_obj_set_pos(ui->screen_img_2, 0, 0);
lv_obj_set_size(ui->screen_img_2, 400, 300);
lv_obj_add_flag(ui->screen_img_2, LV_OBJ_FLAG_HIDDEN);
lv_obj_add_flag(ui->screen_img_2, LV_OBJ_FLAG_CLICKABLE);
lv_image_set_src(ui->screen_img_2, &_2_RGB565A8_400x300);
lv_image_set_pivot(ui->screen_img_2, 50,50);
lv_image_set_rotation(ui->screen_img_2, 0);
【运行效果】
程序烧录完成后,间隔 1.5 秒交替显示,如图:

请参考 安装 ESP-IDF 开发环境。
ESP-IDF 示例程序位于 示例程序包 的 ESP-IDF 目录中。
| 示例程序 | 基础例程说明 | 依赖库 |
|---|---|---|
| 01_WIFI_AP | 设置为 AP 模式,可获取接入设备的 IP 地址 | - |
| 02_WIFI_STA | 设置为 STA 模式,可接入 WiFi 获取 IP 地址 | - |
| 03_ADC_Test | 获取锂电池的电压值 | - |
| 04_I2C_PCF85063 | 打印 RTC 芯片的实时时间 | SensorLib |
| 05_I2C_SHTC3 | 打印温湿度传感器的数据 | - |
| 06_SD_Card | 加载显示 SD 卡的信息 | - |
| 07_Audio_Test | 扬声器播放麦克风录到的声音 | LVGL V8.3.11 |
| 08_LVGL_V8_Test | LVGLV8 例程 | LVGL V8.3.11 |
| 09_LVGL_V9_Test | LVGLV9 例程 | LVGL V9.3.0 |
| 10_FactoryProgram | 综合示例 | LVGL V8.3.11 |
【程序说明】
【硬件连接】
【代码分析】
在 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 地址,如图:

【程序说明】
【硬件连接】
【代码分析】
Adc_PortInit(void):初始化 ADC1,包括创建 ADC 单次触发单元并配置 ADC1 的通道 3。float Adc_GetBatteryVoltage(int *data):读取 ADC1 通道 3 的值,返回实际的电压值。uint8_t Adc_GetBatteryLevel(void):返回电池的百分比。void Adc_LoopTask(void *arg):创建一个 ADC 任务,该任务每隔 1 秒读取一次 ADC 的值并打印到串口。【运行效果】
程序编译下载完成,打开串口监控可以看到打印输出的 ADC 的值和电压,如下图所示:

【程序说明】
【硬件连接】
【代码分析】
void Rtc_LoopTask(void *arg):创建一个 RTC 任务来实现 RTC 功能,每隔 1 秒读取一次 RTC 芯片的时钟,然后输出到终端。【运行效果】
程序编译下载完成,打开串口监控可以看到打印输出的 RTC 时间,如下图所示:

【程序说明】
【硬件连接】
【代码分析】
void Shtc3_LoopTask(void *arg):创建一个 SHTC3 传感器任务,间隔 1 秒定时获取温湿度。【运行效果】
打开串口监控,可以看到打印输出的温湿度数据,如下图所示:

【程序说明】
【硬件连接】
【代码分析】
Fatfs_LoopTask(void *arg):测试 SD 卡读写功能的任务,需要取消 #define sdcard_write_Test 宏定义的注释。【运行效果】
点击串口监控设备,可以看到输出的 SD 卡的信息,如下图所示:

【程序说明】
【硬件连接】
【代码分析】
CodecPort_SetInfo("es8311 & es7210",1,16000,2,16):设置 Codec 芯片的采样率、通道数、位深。CodecPort_SetSpeakerVol(100):设置播放增益 100 。CodecPort_SetMicGain(35):设置麦克风增益 35 。Codec_LoopTask(void *arg):Codec 任务,实现录音、播放等功能。【运行效果】
程序烧录完成后,如图:

【程序说明】
【硬件连接】
【代码分析】
/*创建一个 IMG1 控件*/
ui->screen_img_1 = lv_img_create(ui->screen);
lv_obj_add_flag(ui->screen_img_1, LV_OBJ_FLAG_CLICKABLE);
lv_img_set_src(ui->screen_img_1, &_ein_alpha_400x300);
lv_img_set_pivot(ui->screen_img_1, 50,50);
lv_img_set_angle(ui->screen_img_1, 0);
lv_obj_set_pos(ui->screen_img_1, 0, 0);
lv_obj_set_size(ui->screen_img_1, 400, 300);
/*创建一个 IMG2 控件*/
ui->screen_img_2 = lv_img_create(ui->screen);
lv_obj_add_flag(ui->screen_img_2, LV_OBJ_FLAG_CLICKABLE);
lv_img_set_src(ui->screen_img_2, &_2_alpha_400x300);
lv_img_set_pivot(ui->screen_img_2, 50,50);
lv_img_set_angle(ui->screen_img_2, 0);
lv_obj_set_pos(ui->screen_img_2, 0, 0);
lv_obj_set_size(ui->screen_img_2, 400, 300);
lv_obj_add_flag(ui->screen_img_2, LV_OBJ_FLAG_HIDDEN);
【运行效果】
程序烧录完成后,间隔 1.5 秒交替显示,如图:

【程序说明】
【硬件连接】
【代码分析】
/*创建一个 IMG1 控件*/
ui->screen_img_1 = lv_image_create(ui->screen);
lv_obj_set_pos(ui->screen_img_1, 0, 0);
lv_obj_set_size(ui->screen_img_1, 400, 300);
lv_obj_add_flag(ui->screen_img_1, LV_OBJ_FLAG_CLICKABLE);
lv_image_set_src(ui->screen_img_1, &_ein_RGB565A8_400x300);
lv_image_set_pivot(ui->screen_img_1, 50,50);
lv_image_set_rotation(ui->screen_img_1, 0);
/*创建一个 IMG2 控件*/
ui->screen_img_2 = lv_image_create(ui->screen);
lv_obj_set_pos(ui->screen_img_2, 0, 0);
lv_obj_set_size(ui->screen_img_2, 400, 300);
lv_obj_add_flag(ui->screen_img_2, LV_OBJ_FLAG_HIDDEN);
lv_obj_add_flag(ui->screen_img_2, LV_OBJ_FLAG_CLICKABLE);
lv_image_set_src(ui->screen_img_2, &_2_RGB565A8_400x300);
lv_image_set_pivot(ui->screen_img_2, 50,50);
lv_image_set_rotation(ui->screen_img_2, 0);
【运行效果】
程序烧录完成后,间隔 1.5 秒交替显示,如图:

【程序说明】
【硬件连接】
【代码分析】
sdcardPort = new CustomSDPort("/sdcard"); //sdcard 初始化
Adc_PortInit(); //Adc 初始化
Custom_ButtonInit(); //按键初始化
Rtc_Setup(&I2cbus,0x51); //Rtc 初始化
Rtc_SetTime(2026,1,5,14,30,30); //设置 Rtc 时间
shtc3port = new Shtc3Port(I2cbus); //shtc3 初始化
espwifi_init(); //wifi sta 模式初始化
CodecGroups = xEventGroupCreate();
codecport = new CodecPort(I2cbus,"S3_RLCD_4_2"); //Codec 初始化
codecport->CodecPort_SetInfo("es8311 & es7210",1,16000,2,16);
codecport->CodecPort_SetSpeakerVol(100); //设置扬声器增益
codecport->CodecPort_SetMicGain(35); //设置麦克风增益
【运行效果】
程序烧录完成后,显示主界面,如图:

开发板设计文件
ESP32-S3 芯片官方手册
板载器件数据手册
周一-周五(9:30-6:30)周六(9:30-5:30)
手机:13434470212
邮箱:services04@spotpear.cn
QQ:202004841
