项目

← 返回项目列表

cardputer-ADV

进行中嵌入式
ESP32-S3CardputerArduino游戏开发

在 M5Stack Cardputer 上开发文字冒险游戏（ADV）：用 ESP32-S3 处理器、键盘输入和 1.14 寸彩屏，做一台掌上文字冒险游戏机。

过程记录

环境搭建：点亮屏幕 + Hello World
2026-10-25 · 环境搭建

目标

搭建 Cardputer 的开发环境，点亮屏幕、跑通键盘输入，为后面写游戏引擎打底。

硬件

  • M5Stack Cardputer（ESP32-S3 + 1.14 寸 ST7789 彩屏 + 全键盘 + 电池）

环境搭建步骤

  1. 安装 Arduino IDE（或 PlatformIO）
  2. 在开发板管理器安装 ESP32 支持包（esp32 by Espressif）
  3. 在库管理器安装 M5Cardputer 库
  4. 打开示例 Display 与 Keyboard，验证屏幕和按键正常

踩坑记录

  • USB 线必须支持数据传输（有些充电线只供电不传数据）
  • 烧录前按住键盘上的 G0 键再插 USB，进入下载模式
  • 波特率默认 115200，串口监视器要选对

下一步

搭建游戏主循环：屏幕绘制 + 按键轮询 + 场景状态机。