ESP32 掌上游戏机：从设备摸底到贪吃蛇

接手这块 ESP32-S3 掌机时，先做的是把它摸清楚——芯片参数、分区表、屏幕、手柄，然后才动手写游戏。

设备摸底

通过 esptool 读出芯片信息 + 抓启动日志，得到一份完整的配置：

项目	值
芯片	ESP32-S3 (QFN56) v0.2
Flash	8MB (GD)，DIO 模式
PSRAM	无（启动时 PSRAM ID read error）
SDK	ESP-IDF v4.4.4（Arduino）
屏幕	GC9A01，128×128
音频	PWM 输出
输入	NES 手柄

分区表也读出来了：

nvs (20KB) → otadata (8KB) → app0 (1280KB) → app1 (1280KB)
→ spiffs (1408KB) → coredump (64KB)

启动日志里 microSD [fail] 说明卡槽没插卡，游戏 ROM 主要靠 SPIFFS 的 1.4MB 分区存。

固件架构

flowchart LR
    INPUT[NES 手柄] --> LOOP[游戏循环]
    LOOP --> UPDATE[update 逻辑]
    UPDATE --> RENDER[render 渲染]
    RENDER --> SCREEN[GC9A01 屏]
    LOOP --> AUDIO[PWM 音频]

固定的 update + render 游戏循环，方便把贪吃蛇、打砖块这类小游戏接进去。

手柄输入：移位寄存器协议

NES 手柄是经典的移位寄存器协议，不是简单的"一个按键一根线"——用 GPIO 模拟时钟和数据线，串行读出 8 个按键状态：

// 脉冲 LATCH 锁存，然后逐 CLOCK 位读取 DATA
digitalWrite(LATCH, HIGH); delayMicroseconds(12); digitalWrite(LATCH, LOW);
for (int i = 0; i < 8; i++) {
    state |= digitalRead(DATA) << i;
    digitalWrite(CLOCK, HIGH); digitalWrite(CLOCK, LOW);
}

屏显驱动的坑

屏幕是 GC9A01（128×128 方形屏）。关键卡点在 SPI 端口选择——TFT_eSPI 必须指定正确的 SPI 端口，否则一初始化就崩溃。这个在 NES 项目里反复验证过，直接沿用。

开发贪吃蛇

核心就是 game loop + 4 个方向键 + 一个会变长的蛇身数组：

• display：绘制像素格子的蛇身和食物
• input：读 NES 手柄的 4 方向 + 开始键
• audio：PWM 音符表，吃食物和撞墙的音效
• snake：蛇身坐标、移动、生长、碰撞判定

编译过程中遇到过 TFT_WIDTH 未声明、颜色常量跨文件共享这类小问题，逐个修掉后能稳定跑通。

体会

从"摸清一块陌生板子"到"在上面跑起游戏"，整个流程的骨架是通用的：先读硬件 -> 确认引脚和驱动 -> 搭最小可运行循环 -> 逐模块填充。这套方法后面做 NES 模拟器时也直接复用了。