“有沒(méi)有在機(jī)廳被 Maimai 的轉(zhuǎn)盤(pán)+觸摸 combo 支配過(guò)？打完一局，錢(qián)包空了，手也抽筋了。回家想練歌，卻發(fā)現(xiàn)模擬器要么手感離譜，要么整套設(shè)備比房租還貴。今天聊的 GitHub 項(xiàng)目 Mai Pico，就是一位國(guó)內(nèi)大佬“whowechina”送給所有手殘黨的禮物：只用一張 15.6 寸便攜屏、幾塊 3D 打印件和一顆樹(shù)莓派 Pico，就能搓出一臺(tái)「麻雀雖小、五臟俱全」的 Maimai Mini 機(jī)臺(tái)。重點(diǎn)是，全套開(kāi)源，不花冤枉錢(qián)。”

? 概覽

Maimai 的精髓在兩點(diǎn)：

八個(gè)物理按鈕的“咔噠”節(jié)奏感；

那塊能感知多點(diǎn)觸摸的 ITO 玻璃。
市面上要么買(mǎi)官方 10 萬(wàn)日元的手臺(tái)，要么淘寶 3D 打印殼+山寨觸摸板，手感隨緣。Mai Pico 想做的，就是用開(kāi)源硬件把這兩件事一次性解決，順便把價(jià)格打下來(lái)，讓雙人游戲也變成可能。

核心功能與原理

按鈕圈：

8 顆凱華 Choc 矮軸，30–45 g 線性手感，回彈跟手。

每顆軸配兩顆 WS2812B，RGB 燈效自己寫(xiě)，想跑馬燈還是純色隨你。

觸摸：

自制 ITO 玻璃，3 片 MPR121 電容觸摸芯片，把整塊玻璃切成 24 個(gè)獨(dú)立觸摸區(qū)。

協(xié)議直接參考 Sucareto 的 Mai2Touch，電腦端即插即用。

主控：

樹(shù)莓派 Pico（或 Pico W），USB-C 一線通。

固件自帶 HID 手柄/鍵盤(pán)雙模式，想打 Maimai DX+ 還是自制模擬器都能識(shí)別。

雙人模式：

左右各一套按鈕 + 觸摸，USB 一進(jìn)二出，兩臺(tái)機(jī)器肩并肩就是 Double Play。

AIME 刷卡：

預(yù)留 PN532 NFC 模塊，刷實(shí)卡或手機(jī) NFC 都行，段位不丟。

硬件部分

硬件部分由 IO 板與按鍵板組成。

按鍵板

IO 板

制作集錦

以下是一些愛(ài)好者的作品：

Lavide 的作品

Lavide 制作了一個(gè)漂亮的緊湊型一體化 Mai Pico 機(jī)框！

Romper 的作品

Romper 利用 Mai Pico 的觸摸設(shè)計(jì)制作了一個(gè)全尺寸的控制器。

imfrea 的作品

imfrea 給 Mai Pico 設(shè)計(jì)了一套平價(jià)又好看的亞克力外殼。

IlIIllllIlIIlll 的作品

IlIIllllIlIIlll 也制作了一套外殼。
???

如何制作

PCB

使用 gerber zip 文件（最新的productionPCBmai_io_v*.zip

和ProductionPCBmai_button_v*.zip）下單，常規(guī) FR-4 板，厚度 1.6mm。你需要 1x io PCB 和 8x 按鈕 PCBs 來(lái)構(gòu)建一個(gè) Mai Pico con。

1x Raspberry Pico Pi Pico 或 Pico W。
https://www.raspberrypi.com/products/raspberry-pi-pico

注意另一側(cè)的 3 個(gè)引腳，它們很難焊接，可能會(huì)留下氣泡。

1x USB Type-C 插座（918-418K2023S40001 或 KH-TYPE-C-16P）

2x 0603 5.1kohm 電阻（R20，R21）用于 USB，如果你打算直接使用 Pi Pico 上面原生的 USB 插座，那么 Type-C 插座和電阻都可以省去，焊接也會(huì)簡(jiǎn)單不少。

3x MPR121 模塊，市場(chǎng)上有許多類(lèi)型，選擇像這樣的。 https://www.sparkfun.com/products/retired/9695

在將 MP121 模塊焊接到主 PCB 板之前，記得用小刀切斷 ADDR 和 GND 之間的微小連線，注意絕對(duì)不要切過(guò)頭。

因?yàn)槲覀兪褂玫氖?MPR121 模塊，而不是芯片，所以 U5、U6、U7 區(qū)域的離散組件留空（新版里已經(jīng)移除）。

1x SN74LV1T34DBVR（SOT-23-5）電平轉(zhuǎn)換器（U8），如果你找不到，就用 0603 10ohm 電阻（R4）替代，新版的設(shè)計(jì)里，它已經(jīng)被移除。

4x 0603 1uF（0.1~1uF 都可以）電容器（C1，C2，C3，C7），可選，推薦。有些已經(jīng)在新版本里移除。

16x WS2812B-3528 RGB LED（每個(gè)按鈕需要兩個(gè)）。

8x Kailh Choc v1 鍵盤(pán)開(kāi)關(guān)，線性的，30gf 到 45gf 的。

1x PN532 NFC 模塊和一些細(xì)電線, 只有需要 AIME 的時(shí)候才用得上.
你需要把它焊接到 MPR121 所在的 I2C 總線上（GPIO 6 and 7）。

以下僅適用于使用了光電開(kāi)關(guān)的按鈕。

8x 0603 220ohm 電阻（R1，R2，R3，R4，R5，R6，R7，R8），它們是限流電阻。

8x 0603 5.1kohm 電阻（R10，R11，R12，R13，R14，R15，R16），它們是上拉電阻?？赡懿恍枰憧梢韵仍囋嚥缓附?。

ITO 玻璃

找一個(gè)服務(wù)定制蝕刻 ITO 鍍膜玻璃。AutoCAD 文件是ProductionCADmai_pico_ito_v*.dwg。使用 2mm 厚，10-20ohm 平方電阻的 ITO 鍍膜玻璃。

ITO 鍍膜玻璃通過(guò) "斑馬線"（1.6mm 間距：0.8mm 黑色部分和 0.8mm 透明部分）連接到 IO PCB。使用 200°C 的硅加熱頭將斑馬線粘貼到 PCB 的金手指部分和 ITO 鍍膜玻璃上。這種線的正式名稱(chēng)是 "熱壓密封連接器"。 定制 ITO 鍍膜玻璃相對(duì)較貴，但我們的尺寸小，所以并不像街機(jī)那么貴。這

按鍵環(huán)

從Production3DPrintmai_*.stl打印出 8 套 底座、連接板、按鈕 和 蓋子。

購(gòu)買(mǎi) 8 根 2mm（直徑）* 40mm（長(zhǎng)度）的鋼軸，它們用作按鈕鉸鏈。

這是如何組裝它們的方法，這個(gè)渲染圖像中沒(méi)有顯示鉸鏈軸和 PCB 上的組件。

這是我如何組裝環(huán)的方法。請(qǐng)注意，這些圖片中缺少按鈕開(kāi)關(guān)的線路。

所有離散組件已準(zhǔn)備好。

首先焊接按鈕 PCB。

按鍵 PCB 使用細(xì)小且柔軟的 3 線電纜串聯(lián)，它們是 G、IN/OUT、V，分別代表地、信號(hào)進(jìn)/出和電源。按鈕開(kāi)關(guān)信號(hào)引腳還沒(méi)有焊接，你可以后面再焊接。請(qǐng)不用擔(dān)心按鈕 GPIO 的順序，因?yàn)樗鼈兛梢酝ㄟ^(guò)命令行重新映射。

你需要 3M5423 UHMW 膠帶（或類(lèi)似的硬且超滑的 PTFE 膠帶，厚度 0.2-0.3）。它用來(lái)潤(rùn)滑觸摸鍵開(kāi)關(guān)的按鈕表面。

將 3D 打印的部件和 PCBs 組裝在一起。

使用軸稍微擴(kuò)大支撐孔，然后涂上一些鍵盤(pán)開(kāi)關(guān)潤(rùn)滑劑，如 Krytox 205G0，使軸超級(jí)光滑。

每個(gè)連接板需要 8x M2*4mm 螺絲將兩個(gè)底座連接在一起。

安裝蓋子，每個(gè)需要 2x M2*5mm 螺絲。

便攜顯示器

分辨率：1920*1080，尺寸：15.6 英寸，刷新率：120Hz（推薦）或 60Hz，內(nèi)置揚(yáng)聲器。

它們很容易找到。選擇閑魚(yú)上有小瑕疵的會(huì)便宜得多，也一樣很好用。

有兩種類(lèi)型的驅(qū)動(dòng)板，一種只有 micro-HDMI，另一種支持 type-C 顯示（方便連接 Nintendo Switch）。兩種都可以。

粘合到一起

我使用 3M VHB 膠帶（0.5mm 或 1mm 厚）將按鈕環(huán)、ITO 玻璃和顯示器粘在一起。

只使用一點(diǎn)膠帶，我使用 4 小塊膠帶將 ITO 玻璃粘到顯示器上，另外 4 小塊膠帶將按鈕環(huán)粘到 ITO 玻璃上。

不要在 ITO 玻璃的走線上貼膠帶，你可以在某個(gè)角度光線下看到 ITO 的走線。

固件

UF2 文件在ProductionFirmware文件夾中。

對(duì)于新的構(gòu)建，連接 USB 到 PC 時(shí)按住 BOOTSEL 按鈕，會(huì)出現(xiàn)一個(gè)名為 "RPI-RP2" 的磁盤(pán)。將 UF2 固件二進(jìn)制文件拖入其中。就這樣。

LED 和 Touch 協(xié)議的實(shí)現(xiàn)遵循 Sucareto 在https://github.com/Sucareto/Mai2Touch上的研究。

它有一個(gè)命令行進(jìn)行配置。你可以使用這個(gè) Web Serial Terminal 連接到 Mai Pico 的 USB 串口。（注意："?" 是幫助）

當(dāng)你點(diǎn)擊這個(gè)網(wǎng)頁(yè)的 Connect 按鈕后，你能看到每個(gè)端口的名稱(chēng)。

可以使用gpio命令重新映射按鈕 GPIOs，固件支持 8 個(gè)主按鈕和 4 個(gè)輔助按鈕（分別是：Test, Service, Navigate, Coin）。

可以使用touch命令重新映射觸摸鍵。對(duì)于用 ITO 膜手作觸摸板，或者自己定制了引腳不同的 ITO 鍍膜玻璃的朋友，這個(gè)命令會(huì)很有用:

touch 不帶參數(shù)，可以用來(lái)檢測(cè)當(dāng)前按下的觸摸鍵。

touch 1 9 E6 是映射第二個(gè) MPR121 傳感器的電極 9 到 “E6”，注意 “XX” 表示不連接任何觸摸鍵。

可以使用rgb命令為每個(gè)按鈕分配串聯(lián)的 RGB LED 數(shù)量。

可以通過(guò)level命令調(diào)整 LED 的亮度。

有 MPR121 參數(shù)調(diào)整和靈敏度設(shè)置，自己探索。

它實(shí)現(xiàn)了 3 個(gè) COM 端口，一個(gè)用于命令行，另外兩個(gè)用于 LED 和 Touch。通過(guò)向命令行發(fā)出whoami，每個(gè) COM 端口都會(huì)打印它們的身份。

按鈕信號(hào)通過(guò) HID Joystick 或 HID NKRO（鍵盤(pán)）發(fā)送到主機(jī)。有兩套 NKRO 鍵映射，使用hid 在它們之間切換。在 NKRO 模式下，鍵映射是：

key1：WEDCXZAQ-按鍵環(huán)，3-Select

key2（小鍵盤(pán)）：89632147-按鍵環(huán)，*-Select

上述兩套都有：F1-TestF2-ServiceF3-投幣

factory 用來(lái)復(fù)位到默認(rèn)配置。當(dāng)固件升級(jí)時(shí)，老配置可能失效，這時(shí)候請(qǐng)復(fù)位到默認(rèn)配置，然后重新插拔一下控制器。

開(kāi)源地址

最后是該項(xiàng)目的倉(cāng)庫(kù)：

https://github.com/whowechina/mai_pico

除了這個(gè)項(xiàng)目外，作者還有很多很酷的項(xiàng)目，有興趣的小伙伴可以去倉(cāng)庫(kù)查看！ 最后，項(xiàng)目是 CC-NC 授權(quán)。所以你只能給自己和或者免費(fèi)給你的朋友 DIY，不能利用這個(gè)項(xiàng)目賺錢(qián)，比如收費(fèi)的代做，出售整機(jī)等，連源作者都不敢提的抄襲或者稍微改改換個(gè)名字來(lái)打擦邊球就更不可以了。有商業(yè)訴求的，請(qǐng)聯(lián)系項(xiàng)目的作者。 ?

注意：如果想第一時(shí)間收到 KiCad 內(nèi)容推送，請(qǐng)點(diǎn)擊下方的名片，按關(guān)注，再設(shè)為星標(biāo)。

常用合集匯總：

和 Dr Peter 一起學(xué) KiCad

KiCad 8 探秘合集

KiCad 使用經(jīng)驗(yàn)分享

KiCad 設(shè)計(jì)項(xiàng)目（Made with KiCad）

常見(jiàn)問(wèn)題與解決方法

KiCad 開(kāi)發(fā)筆記

插件應(yīng)用

發(fā)布記錄

審核編輯 黃宇