Skip to content

Repository files navigation

🎮 retro-go_chaeng(ESP32-S3 复古掌机)

20260614_092928

基于 Retro-Go(ducalex)移植的 ESP32-S3 复古掌机项目
Retro-Go 中文硬件扩展版本(chaeng 定制)


Base Platform Display Audio RGB Language License


🆕 最新更新 · Chaeng 2.0.7(2026-07-22)

微信图片_20260722063755_10_2

  • 电子书:新增 TXT 阅读应用,启动器中作为独立机种,每本书相当于一个 ROM(roms/txt/*.txt)
  • 编码与字体:UTF-8 / GBK 自动识别,霞鹜文楷多字号阅读
  • 书目菜单:与游戏一致 — 继续游戏 / 新游戏 / 删除存档
  • 阅读操作:菜单键、设置键与模拟器相同(存档槽 / 系统选项)
  • 翻页:上/A 上一页,下/B 下一页;左/右按约 5% 进度跳转;选择/开始调节字号
  • 存档:中文书名路径兼容(rename 失败时回退直接写入)
  • 界面字库:FusionPixel 扩至完整 GB2312,修复中文书名缺字
  • 翻译:补充存档槽预览、超频等中文文案

更多历史见 CHANGELOG.md


📺 B站演示视频

https://www.bilibili.com/video/BV1SQJF6KEsp/?vd_source=3ac89604b734514d5955b607a3f43d69


📌 硬件开源地址(已加入“星火计划2026”)星火计划-透底黑

https://oshwhub.com/chaeng/project_jofcnupz


✨ 项目特性

  • 基于 Retro-Go(ducalex)二次开发
  • ESP32-S3 双核高性能主控
  • 3.2 寸 TFT LCD(SPI,320×240)
  • SD 卡游戏加载
  • TXT 电子书阅读(roms/txt/*.txt,UTF-8/GBK,书签存档与游戏逻辑一致)
  • I2S 数字音频输出
  • 完整按键控制系统
  • 可编程 WS2812 RGB 状态灯(默认蓝色)
  • 兼容小智AI等项目

🔌 GPIO 引脚定义

SD_CMD - GPIO11
SD_CLK - GPIO13
SD_DATA - GPIO9
SD_CD - GPIO10

SPK_DOUT - GPIO40
SPK_BCLK - GPIO41
SPK_LRCK - GPIO42

KEY_BOOT - GPIO0
KEY_MENU - GPIO18
KEY_OPTION - GPIO8
KEY_SELECT - GPIO16
KEY_START - GPIO17
KEY_A - GPIO15
KEY_B - GPIO5
KEY_LEFT - GPIO19
KEY_RIGHT - GPIO6
KEY_UP - GPIO7
KEY_DOWN - GPIO20

BAT - GPIO4
TFT_BLK - GPIO39
TFT_MOSI - GPIO12
TFT_CLK - GPIO48
TFT_DC - GPIO47
TFT_RST - GPIO3
TFT_CS - GPIO14

MIC_WS - GPIO1
MIC_SCK - GPIO2
MIC_DIN - GPIO21

STATUS_LED - GPIO38


🧠 系统架构

硬件架构

ESP32-S3 主控
├── 3.2寸 TFT 屏幕
├── SD 卡模块
├── I2S 音频输出
├── WS2812 RGB 灯
├── 按键输入系统
└── 电池供电系统


软件架构

retro-go base
↓
retro-go_chaeng port
├── driver(驱动层)
├── ui(界面系统)
├── input(输入系统)
├── audio(音频系统)
└── game(游戏运行层)


📷 实物展示

20260614_092733 20260614_092746 20260614_092850 20260614_092856 20260614_093534 20260614_091542 装配


🎯 项目目标

  • 构建 ESP32-S3 复古掌机系统
  • 基于 Retro-Go 实现硬件移植
  • 提供完整开源软硬件方案
  • 支持教学 / DIY / 二次开发
  • 可扩展 AI / IoT / 联机能力

📜 开源协议

GNU General Public License v3.0 (GPLv3)

✔ 允许使用 / 修改 / 分发
❗ 必须开源衍生代码
❗ 必须保留原始版权信息

About

基于 ESP32-S3 的开源复古掌机项目

Resources

Stars

41 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages