# 上官乐玩派ESP32_S3

**Repository Path**: watsonhuang_admin/shangguan-lewan-pi-esp32ss3

## Basic Information

- **Project Name**: 上官乐玩派ESP32_S3
- **Description**: 上官乐玩派 ESP32-S3-IOT Board 开发板开发例程及资料
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-08-20
- **Last Updated**: 2025-10-09

## Categories & Tags

**Categories**: hardware

**Tags**: ESP32, 教程

## README

### 项目说明

本仓库用于存放**上官乐玩派ESP32-S3 IOT**开发板的相关开发的学习资料。
涉及相关例程皆使用**VsCode+ESP-IDF**进行开发。

* 维护者：**[B站@嵌入式王子](https://space.bilibili.com/26064574)**
* 邮箱：**donminedm@163.com**
* 开发板部件示意说明如下图：
* ![本地路径](文档及图示/开发板布局说明.png "开发板布局说明")

### 文件夹说明：

* [开发资料](开发资料)：**存放原理图等开发资料**；
* [驱动及资源](驱动及资源)：**接口驱动、相关工具**；
* [example-code](example-code)：**各阶段相关历程**；
* [example-code/components](example-code/components)：**板载相关硬件驱动**；
* 课程视频： 移步至 [B站]([https://](https://space.bilibili.com/26064574)) 或**抖音**。

### 相关开发在线文档

* [ESP-IDF API 文档](文档及图示/ESP-IDF学习路径.png)
* [ESP-IDF API 文档](https://esp-idf-zh.readthedocs.io/zh-cn/latest/api-reference/)
* [ESP-IDF 官方组件库](https://components.espressif.com/)
* [FreeRTOS 文档](https://www.freertos.org/zh-cn-cmn-s/Documentation/00-Overview)

### 开发环境搭建

* 开发环境采用`ESP-IDF`+`VsCode`，`VsCode`中扩展中搜索`ESP-IDF`并点击安装，安装后按[VsCode环境配置文档](文档及图示/Vscode及ESP-IDF开发环境配置.pdf)进行操作
* [VSCode 官网下载](https://code.visualstudio.com/)
* 
* ![本地路径](文档及图示/vscode插件安装.png "vscode插件安装图")
* 
* 软件相关使用说明可查看[开发软件使用说明手册](https://docs.espressif.com/projects/vscode-esp-idf-extension/zh_CN/latest/)

### 建议学习路线：

![本地路径](文档及图示/ESP-IDF学习路径.png "学习路径图")

### 基础学习参考

* **GPIO硬件结构解析及仿真**

[GPIO硬件结构解析及仿真](https://www.bilibili.com/video/BV1izkwYVEcQ)

* **函数指针及回调函数**

[函数指针及回调函数](https://www.bilibili.com/video/BV1JWvTePETT)

* **网络通信基础及MQTT协议**

[网络通信基础及MQTT协议](https://www.bilibili.com/video/BV1uQsweVEmW)

### 阶段例程介绍：

##### 01.GPIO阶段

```
* GPIO 基本结构
* 点亮LED灯
* 按钮检测 -> 外部中断 -> 信号量
```

##### 02.UART阶段

```
* UART 通信原理
* 日志打印
* 串口指令接受 -> 串口中断 -> 消息队列
```

##### 03.SD卡及文件系统阶段

```
* SDIO 基本原理
* 文件系统挂载
* 文件的增删改查
```

##### 04.LCD移植及显示

```
* LCD  显示驱动移植
* LCD 触摸驱动移植
* LCD 绘制及图片显示
```

##### 05.LVGL

```
* LVGL 适配移植（显示和触控）
* 界面布局及基础控件
* 界面工具设计及工程导入
```

##### 06.I2S及音频阶段

`音乐播放器应用`

```
* I2S 接口介绍
* 播放文件
* 录音并保存文件
```

##### 07.USB及摄像头应用阶段

`相机应用`

```
* USB 接口介绍
* 摄像头图像解析
* 屏幕显示图像
```

##### 08.WIFI及WEB应用开发阶段

`终端网页控制台`、`MQTT终端`

```
* WIFI模式介绍-AP、STA
* 网页开发语言介绍 Html
* MQTT协议介绍，构建客户端
```