gamebox

1. 项目简介

Gamebox · 灵境方寸

“不止掌机，更是一个实现自由创意的硬件平台。”

嗨，同学们大家好！我是 Gamebox，一款基于 ESP32-S3R8 主控 的开源掌机。搭载 2.4英寸 240×320 LCD屏、8MB PSRAM 及 16MB Flash，支持 Wi-Fi / 蓝牙 和 TF卡扩展。采用 ES8311音频编解码芯片，内置 800mAh锂电池，集成 DC-DC降压电路 及完整电源管理模块。配备经典游戏按键布局，可运行复古游戏模拟器、小智AI机器人及音视频播放，机身仅 70×70×10mm。所有硬件资料和代码均已开源，欢迎大家动手复刻，记得 点赞收藏，一起交流分享创作乐趣！

2. 技术规格

3. 软件与生态

🎮 RegroGo

同步最新代码（2026-05-28），中文语言、字体支持，idf v5.5.4适配。
使用在线烧录工具，不用搭建开发环境，也不用写一行代码。

多种模拟器 · 海量游戏库

🎮 1000+游戏可玩

🔓 Gitee 开源

📦 镜像可直接从0x0000烧录，见附件: retro-go_..._gamebox-v1.img

🔗 乐鑫ESP在线烧录工具 🔗 国内备用在线烧录工具

查看项目 →

🤖 小智AI 2.0

完美适配最新固件。全双工语音对话 · 打断唤醒 · 响应速度快，idf v5.5.4适配。
使用在线烧录工具，不用搭建开发环境，也不用写一行代码。

智能语音引擎

🎤 50+种音色 🔊 自定义唤醒词 🆕 声纹识别(New!)

🔓 Gitee 开源

📦 镜像可直接从0x0000烧录，见附件: xiaozhi-esp32_..._gamebox-v1.bin

🔗 乐鑫ESP在线烧录工具 🔗 国内备用在线烧录工具

查看项目 →

4. 接口与安装说明

🔌 接口概览

Type-C 接口

支持充电与数据传输，可连接电脑进行固件烧录，支持OTG功能。

TF 卡槽

支持最大32GB TF卡扩展，用于存放游戏ROM、配置、音视频等资源。

电源键

位于顶部，单击显示系统菜单，长按可强制关机。

🎮 按键布局

方向键（D-pad）：上、下、左、右四向导航，游戏控制核心按键

功能按键：A/B/X/Y 四键，兼容经典游戏手柄布局

系统按键：START/SELECT 菜单确认与返回，HOME/BOOT键模拟器内菜单操作

电源按键：短按开机，长按2秒关机（使用HK015T芯片）

 

组装流程指引 

STEP 01

准备物料

STEP 02

焊接主板

STEP 03

功能测试

STEP 04

内部组装

STEP 05

组装完成

📋 详细步骤说明

01

准备物料：清点物料,PCB根据挖孔路径分割3块，3D打印按键拆开并去除毛刺，将内嵌螺母使用镊子夹住使用烙铁将其嵌入外壳。

02

焊接主板：按照BOM清单焊接所有元件，建议制作钢网值锡使用加热台的方式焊接元件。正面双S按键建议植锡后用风*加热贴放。

03

功能测试：焊接完成后先烧录固件进行功能测试，确认屏幕显示、音频输出、Wi-Fi连接正常后再进行后续组装。

04

内部组装：确认排线方向后对准插座缓慢插入，安装锅仔片按键（需要手动去除锅仔片底部部分）、电池、扬声器，注意别忘了扬声器防尘网。

05

组装完成：合上外壳，拧紧螺丝，插入TF卡，烧录程序，开机体验复古游戏或AI语音助手！

END OF INSTALLATION GUIDE

5. 板子工艺信息

5.1 主板 (Main)

• 关键厚度 1.0 mm (必须)
• 板子层数 四层板
• 元件分布 单面贴片

6. 常见问题解答 (FAQ)

• 1. 复刻前准备
• Q1: 下单 PCB 打板有什么特殊要求？
  A1: 务必选择 1.0mm 厚度，其他厚度无法适配外壳。阻抗选择“JLC04101H-3313(免费)”。
• Q2: PCB 跟原理图 DRC 报错很多？
  A2: PCB和原理图均已通过CRC校验，PCB报错为双面铺铜允许了游离块，不影响制作。
• Q3: FPC必须打印吗？
  A3: 非必须，根据选择的显示屏决定，不带排线款的显示屏必须制作FPC排线。要勾选打印补强。
  
• Q4: 显示面板打印有什么要求？
  A4: 打印时要勾选 1.0厚度 透明亚克力 底面打印 强遮光          
• Q5: 3D打印如何下单、模型异常提醒怎么处理？
  A5: 推荐嘉立创3D打印，一键导入模型文件STL(见附件),推荐树脂材料 精度±0.2mm。下单后提示模型有问题直接回复”接受风险打印“即可。

• 2. 复刻中与调试
• Q1: 焊好后没有声音，或者只有电流声/杂音？
  A1: 90% 是 ES8311 音频芯片 没焊好（虚焊/短路），或者麦克风因风*温度过高吹坏了。
• Q2: 连不上 Wi-Fi，或者语音对话反应慢？
  A2: 检查天线周边是否有金属遮挡，CLC电路是否有电阻断路和电容短路。
• Q3: 烧录固件时电脑识别不到串口？
  A3: 请使用具备数据传输功能的 USB 线。按住板上 BOOT/HOME键 不松手点击电源键即可进入烧录模式。
• Q4: 小智系统 如何设置自定义表情 ？
  A4: 配网成功后进入小智AI后台，在“智能体设置”页面上传 G1F 或图片，系统会根据情绪自动调用。
• Q5: Gamebox-RetorGo固件个别中文无法显示 ？
  A5: 内置的中文字体经过了GB2312一级二级常用文字压缩（解决嵌入式小容量RAM问题），汉字覆盖率99%，个别低频字不显示为正常现象。
• Q6: 焊接完成后通电测试有短路现象 ？
  A5: 先检查元件引脚是否有连锡问题，排除后大概率是裁切PCB导致的多层金属层短路，使用砂纸打磨裁切处即可。

7. 注意事项与复刻指南

• 复刻难度：⭐⭐⭐⛤⛤
• PCB厚度：下单打板时请务必选择 1.0mm，否则与外壳不匹配。
• 阻抗要求：下单时选择“我文中已有压层顺序”，阻抗“JLC04101H-3313(免费)”，不然影响射频信号。
• 屏幕安装：装入外壳时要有一定技巧不可强力按压，安装排线时先确认排线方向然后对准插座，缓慢*入排线。切勿暴*硬*。
• 固件烧录：建议使用 乐鑫提供的在线烧录工具，地址设为 0x00000，选择IMG/BIN固件，连接USB按住BOOT键开机烧录。

🛒 外设和需要独立购买的元件（价格仅供参考）

8. 项目总结

9. 致谢与开源协议