# ruixing_esp32s3_examples

**Repository Path**: wangjun009xx/ruixing_esp32s3_examples

## Basic Information

- **Project Name**: ruixing_esp32s3_examples
- **Description**: Ruixing esp32s3开发板例程
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2026-08-02
- **Last Updated**: 2026-08-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ruixing_esp32s3_examples

#### 一、开发板例程介绍

Ruixing esp32s3系列开发板，包括esp32s3核心板、esp32s3-ev-board一体板和esp32s3-ev-board-EX功能扩展板，均适用于本仓库相应的例程。目前仓库主要例程为esp32s3的LCD屏相关例程，例程均在乐鑫官方例程的基础上进行修改得到，方便学习和理解。

淘宝店链接：https://p1ou4nxnp2ai269t5tpgpweqmzulflc.taobao.com

 _1、esp32s3核心板_ 

![输入图片说明](sch/%E6%A0%B8%E5%BF%83%E6%9D%BF_%E4%B8%BB%E5%9B%BE.jpg)

 _2、esp32s3一体开发板_ 

![输入图片说明](sch/yiti_board_f.png)
![输入图片说明](sch/yiti_board_bk.png)

 _3、esp32s3核心板+功能扩展板_ 

![输入图片说明](sch/ex_board.jpg)
![输入图片说明](sch/ex_board_bk.jpg)

#### 二、开发环境

1. 开发环境建议采用：ESP-IDF5.3以上版本，本仓库所有例程开发环境为：ESP-IDF 5.3.2;
2. 建议使用windows系统下的离线安装安装开发环境或虚拟机ubuntu开发环境，具体开发环境搭建可直接参考乐鑫官网开发指南。


#### 三、例程目录

1.  1.0-generic_gpio，入门基础，GPIO控制。
    1.1-blink_ws2812_gpo,操作ws2812 led灯 或gpio;
2.  2.0-lvgl_demos，lvgl demo例程，lv8。基于github仓库中的esp_dev_kits/esp32_s3_lcd_ev_board,version:2.1.0;
3.  2.1-display_lvgl_demos，lvgl demo例程，lv9.2。项目创建于乐鑫组件管理器esp32_s3_lcd_ev_board(version:2.2)组件examples;
4.  2.2-rgb_avoid_tearing，st7701_480*480例程，lv8。项目创建于乐鑫组件管理器st7701组件examples;
5.  2.3-rgb_avoid_tearing_3rd-st7701s，lv8。同上，但st7701组件为第3方驱动，较早期。
6.  2.4-86box_demo_ev_board1.0.3, lv8。基于github仓库中的esp_dev_kits/esp32_s3_lcd_ev_board，version:1.0.3；
7.  2.5-86box_demo_ev_board2.1, lv8。基于github仓库中的esp_dev_kits/esp32_s3_lcd_ev_board，version:2.1.0。
8.  2.6-usb_camera_lcd,usb摄像头例程。基于github仓库中的esp_dev_kits/esp32_s3_lcd_ev_board示例
9.  2.7-i80_controller,3.5寸I80-RGB屏示例，基于idf components组件中LCD自带示例修改。注：本例程中，开发板硬件和程序默认设置为MCU-8并口模式。
10. 2.8-86box_smart_panel_ev_board2.1，智能家居中控屏项目。基于github仓库中的esp_dev_kits/esp32_s3_lcd_ev_board，version:2.1.0。

#### 四、使用说明
因开发板支持多种不同类型的LCD屏，各自接口和引脚配置也不相同，因此不同的屏需不同的配置文件。使用时从board_include/board_include/evBoard_2.1_lv8或board_include/evBoard_2.2_lv9文件夹中选择相应的配置文件（头文件），复制到项目中components/espressif__esp32_s3_lcd_ev_board/include/bsp/中，重命名为esp32_s3_lcd_ev_board.h，取代原有的头文件。复制时请注意示例和lvgl的版本号。各种屏配置头文件的说明如下：其中以_EX结尾的适用于核心板+功能扩展板，其它的适用于一体板。如以下为evBoard_2.2_lv9中的头文件，分别对应4.3/4/7''PANEL：
1.  esp32_s3_lcd_ev_board_4.3_480_272_40p.h
2.  esp32_s3_lcd_ev_board_4.3_800_480_40p.h
3.  esp32_s3_lcd_ev_board_4_480_480_40p.h
4.  esp32_s3_lcd_ev_board_7_800_480_50p.h
5.  esp32_s3_lcd_ev_board_4.3_480_272_40p_EX.h
6.  esp32_s3_lcd_ev_board_4.3_800_480_40p_EX.h
7.  esp32_s3_lcd_ev_board_4_480_480_40p_EX.h
8.  esp32_s3_lcd_ev_board_7_800_480_50p_EX.h


*注意事项：
1.  board_include/evBoard_2.2_lv9文件夹下的头文件适用于esp32_s3_lcd_ev_board 2.2和lv9以上版本。evBoard_2.1_lv8文件夹中的头文件适用于esp32_s3_lcd_ev_board 2.1.0和lv8及之前的版本;
2.  部分只涉及专用屏的例程，无需更改头文件，如ST7701,86屏，3.5''I80；
3.  因IO复用的原因，项目中应避免4''方屏或3.5''屏与SD同时使用；
4.  根据所接的LCD屏，选择好头文件后，还应确认menuconfig中的LCD分辨率的配置，除4''方屏选择480*480，其它（4.3~7''）均选择800*480.####（重要）

#### 参与贡献

1.  Fork 本仓库
2.  新建 Feat_xxx 分支
3.  提交代码
4.  新建 Pull Request


#### 特技

1.  使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md
2.  Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com)
3.  你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目
4.  [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
5.  Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
6.  Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)