有没有在机厅被 Maimai 的转盘+触摸 combo 支配过？打完一局，钱包空了，手也抽筋了。回家想练歌，却发现模拟器要么手感离谱，要么整套设备比房租还贵。今天聊的 GitHub 项目 Mai Pico，就是一位国内开发者“whowechina”为音游爱好者打造的开源解决方案：仅需一张 15.6 英寸便携屏、几块 3D 打印件和一颗树莓派 Pico，即可 DIY 出一台功能完整的 Maimai Mini 机台。全套设计开源，成本可控，适合动手党。
项目概览
Maimai 的核心体验在于两点：
- 八个物理按钮带来的精准节奏反馈；
- 支持多点触控的 ITO 玻璃感应区域。
传统方案要么价格高昂，要么兼容性差。Mai Pico 利用开源硬件，整合按键与触摸系统，实现高还原度操作体验，并支持双人对战模式，大幅降低入门门槛。
核心功能与实现原理
- 按钮模块：采用 8 颗凯华 Choc 矮轴（线性轴，30–45g 触发力），每颗配备两颗 WS2812B RGB 灯珠，支持自定义灯效。
- 触摸系统：使用自制 ITO 玻璃，搭配 3 片 MPR121 电容触摸芯片，将玻璃划分为 24 个独立感应区，协议兼容 Sucareto 的 Mai2Touch 方案，即插即用。
- 主控单元：基于树莓派 Pico 或 Pico W，通过 USB-C 一线连接，固件支持 HID 手柄与键盘双模式，兼容主流模拟器及街机平台。
- 双人模式：支持左右双机并联，USB 一进二出，轻松实现 Double Play。
- NFC 刷卡支持：预留 PN532 模块接口，可接入 AIME 卡或手机 NFC，保留段位数据。
硬件构成
按键板
IO 板
爱好者作品展示
多位玩家已基于 Mai Pico 设计完成个性化成品。
Lavide 的作品
Lavide 制作了一款紧凑型一体化 Mai Pico 机框。
Romper 的作品
Romper 基于 Mai Pico 触摸设计打造了全尺寸控制器。
imfrea 的作品
imfrea 为 Mai Pico 设计了一套性价比高且美观的亚克力外壳。
IlIIllllIlIIlll 的作品
IlIIllllIlIIlll 也制作了一套定制外壳。
制作指南
PCB 制作
- 使用项目提供的 Gerber 文件（
production\PCB\mai_io_v*.zip和Production\PCB\mai_button_v*.zip）下单生产，建议采用 FR-4 材质，厚度 1.6mm。每台需 1 块 IO 板和 8 块按钮板。
关键元器件清单
- 1x 树莓派 Pico 或 Pico W
- 1x USB Type-C 插座（型号：918-418K2023S40001 或 KH-TYPE-C-16P）
- 2x 0603 5.1kΩ 电阻（R20, R21），若直接使用 Pico 自带接口可省略
- 3x MPR121 模块（如 SparkFun Retired #9695），焊接前需切断 ADDR 与 GND 间的跳线
- 16x WS2812B-3528 RGB LED（每个按钮 2 颗）
- 8x 凯华 Choc v1 线性开关（30gf–45gf）
- 1x SN74LV1T34DBVR 电平转换器（U8），新版可替换为 10Ω 电阻或直接省略
- 4x 0603 1μF 电容（C1–C3, C7），推荐但非必需
- PN532 NFC 模块（可选，用于 AIME 刷卡），焊接至 GPIO6/7 的 I2C 总线
ITO 玻璃定制
需定制蚀刻 ITO 镀膜玻璃，参考文件：Production\CAD\mai_pico_ito_v*.dwg。建议使用 2mm 厚、方阻 10–20Ω 的 ITO 玻璃。
通过“斑马线”（热压密封连接器）将 ITO 玻璃与 IO PCB 连接，使用 200°C 硅加热头压合。
按键环组装
- 从
Production\3DPrint\mai_*.stl打印 8 套底座、连接板、按钮和盖子。 - 准备 8 根 2mm×40mm 钢轴作为铰链。
组装步骤：
- 焊接按钮 PCB 并串联 GND、信号线、VCC 三线连接。
- 使用 3M5423 UHMW 胶带润滑按钮表面。
- 安装 3D 打印结构件，扩孔后涂抹润滑脂提升顺滑度。
- 使用 M2*4mm 螺丝固定底座与连接板，M2*5mm 螺丝安装盖子。
便携显示器选择
- 推荐 15.6 英寸、1920×1080 分辨率、120Hz 刷新率，内置扬声器。
- 支持 micro-HDMI 或 Type-C 输入均可，二手瑕疵品亦可降低成本。
整机组装
- 使用 3M VHB 胶带（0.5–1mm 厚）粘合各层结构。
- 建议使用 4 小块胶带分别固定 ITO 玻璃与显示器、按钮环与 ITO 玻璃。
- 避免在 ITO 走线上贴胶，以免影响导电性能。
固件烧录与配置
- 固件位于
Production\Firmware目录下的 UF2 文件。 - 烧录时按住 BOOTSEL 键插入 USB，拖入 UF2 文件即可。
- 触摸与 LED 协议基于 Sucareto 的 Mai2Touch 实现。
通过 Web Serial Terminal 进行串口配置（支持 "?" 查看帮助）：
gpio：重新映射按钮 GPIO，支持 8 主键 + 4 辅助键（Test/Service/Coin/Navigate）touch：调整触摸电极映射，适用于自定义 ITO 布局rgb：设置每个按钮串联的 LED 数量level：调节 LED 亮度hid <joy|key1|key2>：切换输出模式（手柄 / 键盘模式）factory：恢复默认配置，升级固件后建议执行
开源信息
项目仓库地址：
https://github.com/whowechina/mai_pico
该项目采用 CC-NC 授权，允许个人 DIY 及无偿分享给朋友，禁止任何形式的商业用途，包括代工、售卖整机或改名发布。如有商业需求，请联系原作者授权。
