# esp32s3_handheld

**Repository Path**: ren2004/esp32s3_handheld

## Basic Information

- **Project Name**: esp32s3_handheld
- **Description**: 基于esp32s3的掌机
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-27
- **Last Updated**: 2025-12-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 基于立创ESP32S3开发板的掌机
---

## 开发板介绍
ESP32S3 N16R8:内置SRAM 512KB, 内置ROM 384KB, 外扩PSRAM 16MB, 外扩FLASH 8MB。

## 功能描述
- [x] 1. 音乐播放器
- [x] 2. NES 模拟器
- [x] 3. 文件系统
- [x] 4. 摄像头
- [x] 5. 运动传感器
- [x] 6. 天气应用
- [x] 7. 连接wifi
- [x] 8. 图片浏览
---

## 硬件需求
1. 立创ESP32S3开发板

---

## 软件需求
1.**开发工具链**
   - ESP-IDF
   - CMake

---

## 项目结构
```plaintext
├── components/
|   |—— audio                  # 音频驱动
|   |—— camera                 # 摄像头驱动
│   ├── lvgl/                  # LVGL v8.3.10
|   ├── lvgl_porting/          # LVGL porting 移植文件
|   |—— nes                    # nes 模拟器
|   ├── lcd/                   # St7789V驱动
|   ├── pca9557/               # IO扩展芯片驱动
|   |—— qmi8658/               # imu 驱动
|   |—— sdcard/                # SD 卡驱动
|   |—— touch/                 # 触摸屏驱动
├── main/
|   ├── apps/                  # 应用层
|   |   ├── camera_app/        # 摄像头应用
|   |   ├── imu_app/           # 运动传感器应用
|   |   ├── music_app/         # 音乐播放器应用
|   |   ├── nes_app/           # NES 模拟器应用
|   |   ├── weather_app/       # 天气应用
|   |—— fonts/                 # 字体文件
|   |—— images/                # 图片文件
|   |—— bt/                    # 蓝牙
│   └── main.c                 # 程序入口
├── CMakeLists.txt             # CMake 配置文件
└── sdkconfig                  # SDK 配置文件
```

## 快速开始

### 1.下载程序步骤
```bash
首次运行可能需要执行idf.py fullclean
idf.py set-target esp32s3           # 设置目标芯片
idf.py menuconfig                   # 打开配置菜单
idf.py build                        # 编译程序  
idf.py flash                        # 烧录程序  
idf.py monitor                      # 监控输出
idf.py build flash monitor          # 编译烧录监控
```
### 2.menuconfig 配置说明
ESP32也可以通过修改lv_conf实现，优点不用重新编译。但是我用S3好像不太行，不管lv_cong.h中宏定义怎么改，都不起作用
1.输入idf.py menuconfig进行组件配置
![alt text](assert/image.png)
2.找到lvgl配置
![alt text](assert/image-1.png)
3.找到Color setting进行颜色配置
![alt text](assert/image-2.png)  
4.使用spi 8bit传输需要进行字节交换
![alt text](assert/image-3.png)
5.找到Demo选项选择；你想要运行的demo
![alt text](assert/image-4.png)
![alt text](assert/image-5.png)
### 3.运行效果

---

## 注意事项

---

## 后续计划

---

## 参考文档
1.[ESP-IDF 官方文档](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/index.html)

## 参考项目

完成时间：`<2025/6/18>`  
项目作者：`<ryh>`