琴鍵上亮起一盞燈燈亮到哪個(gè)鍵你就按哪個(gè)鍵——這是我最初對(duì)Play-Along Keyboard的全部設(shè)想。后來(lái)真正做出來(lái)才發(fā)現(xiàn)這個(gè)項(xiàng)目最花時(shí)間的根本不是LED和按鍵而是如何處理你明明按下了系統(tǒng)卻說(shuō)沒(méi)檢測(cè)到和你明明沒(méi)按系統(tǒng)卻說(shuō)連擊了這兩件破事。如果你也打算做一把帶提示燈、能跟著曲譜走的練習(xí)鍵盤這篇文章應(yīng)該能幫你少走不少?gòu)澛贰?. 為什么要做一把能帶著你彈的鍵盤1.1 練琴路上的真實(shí)痛點(diǎn)我接觸過(guò)不少鍵盤樂(lè)器初學(xué)者也包括我自己。最常見(jiàn)的困境不是不想練而是看不懂譜子和找不到鍵位同時(shí)發(fā)生。譜子上寫著一個(gè)音符你要先反應(yīng)它是C還是D再反應(yīng)它在鍵盤上的位置等這兩個(gè)反應(yīng)做完拍子早就過(guò)去了。市面上很多練琴App能做實(shí)時(shí)評(píng)分但它們的邏輯是你彈完我來(lái)聽(tīng)而不是在你彈之前告訴你按哪里。對(duì)完全零基礎(chǔ)的人來(lái)說(shuō)后者才是真正能把手帶起來(lái)的東西。另一個(gè)痛點(diǎn)是重復(fù)練習(xí)極其枯燥。一段十六小節(jié)的旋律你需要在琴鍵上來(lái)回找位置找錯(cuò)了還要自己回頭去對(duì)照譜子。如果鍵盤本身能提示該按哪里練習(xí)就從讀譜-找鍵-糾錯(cuò)變成了看燈-按鍵-形成肌肉記憶效率完全不一樣。1.2 Play-Along Keyboard 到底是個(gè)什么東西我做的這把鍵盤準(zhǔn)確說(shuō)是一個(gè)帶LED按鍵提示的MIDI風(fēng)格練習(xí)鍵盤。它本身不發(fā)聲也不需要真實(shí)鋼琴的配重手感核心功能只有三個(gè)從內(nèi)部存儲(chǔ)或外部輸入的曲譜數(shù)據(jù)中解析出當(dāng)前應(yīng)該彈奏的音符序列。在鍵盤對(duì)應(yīng)按鍵上點(diǎn)亮LED提示你下一個(gè)應(yīng)該按哪里。當(dāng)你按下正確按鍵后LED自動(dòng)跳轉(zhuǎn)到下一個(gè)音符按錯(cuò)時(shí)給出提示并且不會(huì)繼續(xù)推進(jìn)。這個(gè)邏輯聽(tīng)起來(lái)很簡(jiǎn)單但實(shí)現(xiàn)過(guò)程中牽涉到按鍵掃描、抖動(dòng)處理、時(shí)序同步、狀態(tài)機(jī)設(shè)計(jì)等多個(gè)環(huán)節(jié)。尤其是按鍵抖動(dòng)幾乎決定了整個(gè)項(xiàng)目體驗(yàn)的上限——如果去抖沒(méi)做好你會(huì)看到LED自己亂跳仿佛鍵盤在嘲諷你的手速。1.3 這篇內(nèi)容覆蓋的范圍我不會(huì)只給你看一個(gè)最終的代碼包。我會(huì)把關(guān)鍵決策的來(lái)龍去脈講清楚為什么主控選擇ATmega328P而不是ESP32為什么矩陣掃描要用狀態(tài)機(jī)而不是簡(jiǎn)單的delay為什么指向下一個(gè)音的推進(jìn)邏輯要放在按下事件里而不是LED亮起后的固定時(shí)間里。這些是你在任何一份現(xiàn)成代碼里都能跑通但出了問(wèn)題不知道怎么改的根源。整個(gè)項(xiàng)目難度中等偏上適合有Arduino或嵌入式基礎(chǔ)、想從點(diǎn)亮一個(gè)LED進(jìn)階到做一個(gè)完整交互設(shè)備的人。如果你是完全零基礎(chǔ)建議先跑通按鍵讀取和LED點(diǎn)亮兩個(gè)獨(dú)立實(shí)驗(yàn)再來(lái)做這個(gè)整合。2. 硬件底座的選型思路與整體架構(gòu)2.1 主控選型Arduino還是ESP32我見(jiàn)過(guò)不少人在這個(gè)項(xiàng)目上直接用ESP32理由是性能強(qiáng)、還能接Wi-Fi。但實(shí)際做下來(lái)對(duì)一把練琴鍵盤來(lái)說(shuō)ATmega328P也就是Arduino Uno/Nano那顆芯片完全夠用而且有幾個(gè)好處是ESP32給不了的。首先ATmega328P的GPIO電平是5V和大多數(shù)矩陣鍵盤、LED燈珠的匹配更直接。ESP32是3.3V IO驅(qū)動(dòng)5V LED或某些按鍵模塊往往需要電平轉(zhuǎn)換雖然能用但憑空多出一層麻煩。其次ATmega328P的中斷和定時(shí)器資源雖然沒(méi)有ESP32多但在這個(gè)場(chǎng)景下足夠用而且Arduino生態(tài)里關(guān)于按鍵去抖、矩陣掃描的成熟代碼幾乎都是基于AVR寫的資料找起來(lái)省力得多。最后是功耗和穩(wěn)定性8MHz/16MHz的AVR芯片在工業(yè)環(huán)境里被用了十幾年抗干擾表現(xiàn)比高頻的ESP32穩(wěn)定這對(duì)按鍵信號(hào)采集很重要。如果你以后想擴(kuò)展成藍(lán)牙連接手機(jī)App、用Wi-Fi下載曲庫(kù)那確實(shí)要上ESP32。但第一版老老實(shí)實(shí)用Arduino Nano就夠了成本十幾塊錢燒錄簡(jiǎn)單出了問(wèn)題也好排查。2.2 鍵盤矩陣的硬件接法一把標(biāo)準(zhǔn)的61鍵鍵盤如果每個(gè)按鍵單獨(dú)接一個(gè)GPIO那需要61個(gè)引腳任何單片機(jī)都扛不住。所以必須用矩陣掃描把按鍵排列成行和列比如6行×11列共17個(gè)GPIO就能覆蓋66個(gè)按鍵位。矩陣掃描的原理不復(fù)雜先把所有列線設(shè)置為輸入上拉模式然后逐行拉低讀取列線的電平。如果某行某列交叉處的按鍵被按下對(duì)應(yīng)的列線就會(huì)被拉低。逐行掃描一遍就能得到整個(gè)鍵盤的按鍵狀態(tài)。要注意的是行數(shù)和列數(shù)的分配要結(jié)合GPIO布局來(lái)定。像Arduino Nano數(shù)字引腳只有D2到D13共12個(gè)可用再加上A0到A7模擬引腳也能做數(shù)字IO實(shí)際可用IO大概20個(gè)。我采用的是8行×8列的矩陣用掉16個(gè)GPIO剩下4個(gè)GPIO留給LED控制和功能鍵。這個(gè)方案的好處是掃描邏輯非常對(duì)稱代碼寫起來(lái)清爽。2.3 LED指示系統(tǒng)怎么設(shè)計(jì)才不刺眼按鍵提示的核心是LED但LED的選擇直接決定使用體驗(yàn)。我一開(kāi)始用的是普通5mm紅色LED直接串聯(lián)限流電阻接到矩陣的行列引腳上。結(jié)果發(fā)現(xiàn)兩個(gè)問(wèn)題一是矩陣掃描時(shí)LED會(huì)串電導(dǎo)致相鄰的鍵隱約發(fā)光二是紅色LED在白天幾乎看不清晚上又特別刺眼。后來(lái)改成兩種方案對(duì)比一種是用WS2812全彩燈珠每顆燈珠獨(dú)立IC控制一根信號(hào)線搞定亮度顏色都能調(diào)但缺點(diǎn)是燈珠本身有一定高度需要做導(dǎo)光結(jié)構(gòu)把光引到鍵帽表面。另一種是用3mm的霧狀LED配合淺色半透明鍵帽發(fā)光均勻度比5mm透明LED好很多而且霧狀燈珠的散射角大從側(cè)面看不會(huì)出現(xiàn)只有一個(gè)亮點(diǎn)的廉價(jià)感。我的建議是如果你有3D打印機(jī)優(yōu)先用WS2812燈板白色鍵帽如果沒(méi)有就買現(xiàn)成的LED背光鍵帽模組這種鍵帽內(nèi)部有導(dǎo)光板用普通LED也能獲得不錯(cuò)的效果。注意LED驅(qū)動(dòng)電流不要超過(guò)20mA用220Ω到470Ω的限流電阻都能接受具體看你的LED壓降和供電電壓。2.4 供電與通信方案這個(gè)項(xiàng)目有兩種工作模式獨(dú)立模式和聯(lián)機(jī)模式。獨(dú)立模式下所有曲譜都存在SD卡或EEPROM里鍵盤自己運(yùn)行跟彈邏輯不需要連接電腦。聯(lián)機(jī)模式下用USB連接電腦電腦端發(fā)送MIDI格式的曲譜數(shù)據(jù)鍵盤負(fù)責(zé)按鍵掃描和LED顯示。供電上有個(gè)坑如果直接用Arduino的USB口供電當(dāng)所有LED同時(shí)點(diǎn)亮?xí)r電流很容易超過(guò)500mA的USB端口限制導(dǎo)致電壓跌落、按鍵掃描出現(xiàn)隨機(jī)誤觸。我實(shí)測(cè)在16顆LED全亮的情況下電流就到了420mA還只用了四分之一按鍵位。解決方案是外接5V 2A的電源適配器或者用USB HUB的獨(dú)立供電口?？傊灰袻ED電源和主控電源混在一個(gè)線性穩(wěn)壓器后面最好是外部5V先給燈板再穩(wěn)壓到5V給主控或者直接用兩個(gè)電源軌。3. 按鍵抖動(dòng)與掃描時(shí)序先解決手沒(méi)抖鍵在抖的問(wèn)題3.1 機(jī)械按鍵為什么會(huì)抖動(dòng)這是整個(gè)項(xiàng)目中最容易讓人心態(tài)崩潰的部分。機(jī)械按鍵的結(jié)構(gòu)就是兩個(gè)金屬簧片接觸按下時(shí)簧片不是一瞬間就穩(wěn)定貼合而是會(huì)發(fā)生微小的彈跳在幾毫秒到幾十毫秒內(nèi)反復(fù)接通和斷開(kāi)。示波器上看按鍵按下的一瞬間電平會(huì)像一片噪聲一樣上下跳變最后才穩(wěn)定在低電平。如果你在代碼里發(fā)現(xiàn)我只按了一下結(jié)果連跳了兩個(gè)音或者我明明按下了但程序沒(méi)反應(yīng)大概率不是按鍵壞了而是抖動(dòng)沒(méi)處理干凈。用500Hz的掃描頻率去讀一個(gè)按鍵抖動(dòng)期間有可能讀到按下、抬起、按下、抬起多個(gè)狀態(tài)變化每一個(gè)變化都可能被當(dāng)作一次有效按下事件。3.2 最簡(jiǎn)單的軟件去抖延時(shí)和它的缺陷最基礎(chǔ)的軟件去抖方法是檢測(cè)到電平變化后延時(shí)20ms到50ms再讀取一次如果電平仍然是變化后的狀態(tài)就認(rèn)為按鍵確實(shí)是按下了。這個(gè)方案在小項(xiàng)目里夠用但在Play-Along Keyboard里會(huì)帶來(lái)一個(gè)致命問(wèn)題delay會(huì)阻塞整個(gè)程序。跟彈模式下LED指示和按鍵掃描是同時(shí)進(jìn)行的。如果你在按鍵掃描里用了delay做去抖那LED的刷新就會(huì)卡住出現(xiàn)燈在閃的時(shí)候突然停了一拍的現(xiàn)象。而且如果用戶按鍵速度很快連續(xù)的兩個(gè)按鍵在延時(shí)期間可能都被漏掉這在快節(jié)奏曲子中會(huì)直接丟音。3.3 狀態(tài)機(jī)去抖不阻塞掃描的chatter blocker真正的解法是用狀態(tài)機(jī)去抖也叫chatter blocker——每次掃描周期比如每2ms采樣一次按鍵狀態(tài)只有連續(xù)N次采樣都是同一狀態(tài)才認(rèn)為狀態(tài)發(fā)生了變化。這樣delay沒(méi)了掃描和LED刷新可以同時(shí)進(jìn)行而且N的大小直接控制去抖的靈敏度。我用的參數(shù)是掃描周期2ms連續(xù)5次采樣一致后確認(rèn)狀態(tài)變化也就是10ms的去抖時(shí)間。這個(gè)值是我實(shí)測(cè)后確定下來(lái)的。用5ms去抖快速?gòu)椬鄷r(shí)偶爾還會(huì)出現(xiàn)一次連擊用20ms去抖極快的十六分音符連續(xù)擊鍵會(huì)被吃掉。10ms是快節(jié)奏和穩(wěn)定性之間的平衡點(diǎn)。如果你們用的是那種簧片很軟的廉價(jià)按鍵開(kāi)關(guān)去抖時(shí)間可能需要加到15ms到20ms具體要看你手頭按鍵的示波器波形。代碼上我建議把所有按鍵的去抖邏輯封裝成一個(gè)KeyScanner類每次調(diào)用update()就掃描一遍矩陣內(nèi)部維護(hù)每個(gè)按鍵的計(jì)數(shù)器只在狀態(tài)確認(rèn)變化時(shí)通過(guò)回調(diào)函數(shù)通知上層。這樣上層邏輯不需要關(guān)心抖動(dòng)只需要處理有按鍵被按下和有按鍵被釋放兩個(gè)事件。3.4 矩陣掃描的鬼影問(wèn)題與二極管方案矩陣掃描除了抖動(dòng)還有一個(gè)更隱蔽的問(wèn)題鬼影。當(dāng)你同時(shí)按下三個(gè)或四個(gè)按鍵而這些按鍵恰好構(gòu)成一個(gè)矩形時(shí)掃描程序可能會(huì)誤判出第四個(gè)沒(méi)有按下的鍵。原因是矩陣的行列交叉點(diǎn)在電氣上不是完全隔離的電流會(huì)通過(guò)按下按鍵的交點(diǎn)串到別的行列上。處理鬼影的方法有幾種。最簡(jiǎn)單的是用將列線設(shè)置為輸入上拉逐行拉低掃描這種行列法配合外部或內(nèi)部上拉電阻可以在一定程度上減少鬼影但無(wú)法完全杜絕。最可靠的方法是在每個(gè)按鍵上串聯(lián)一個(gè)1N4148二極管方向統(tǒng)一從列線流向行線。這樣電流只能沿單方向流動(dòng)交叉串?dāng)_就從根源上被切斷了。如果你只用8行×8列這種小矩陣而且平時(shí)不會(huì)同時(shí)按超過(guò)三個(gè)鍵可以考慮不加二極管——我自己在前期調(diào)試時(shí)就沒(méi)加直到有一次需要按下三和弦測(cè)試才被鬼影問(wèn)題折磨了半天。后來(lái)在按鍵矩陣板上焊上64個(gè)1N4148問(wèn)題立刻消失。這個(gè)步驟雖然費(fèi)工夫但如果你要做的鍵盤支持和弦檢測(cè)就必須做。4. 跟彈引擎從曲譜數(shù)據(jù)到按鍵提示的核心邏輯4.1 曲譜數(shù)據(jù)怎么存跟彈鍵盤的核心是曲譜數(shù)據(jù)——它要解決下一個(gè)該亮哪個(gè)鍵的問(wèn)題。我的第一個(gè)版本用最直接的簡(jiǎn)化譜格式每一行代表一個(gè)音符事件包含兩個(gè)信息按鍵編號(hào)和持續(xù)時(shí)間。例如60 480 62 240 64 240 60 480這里的60是MIDI音符編號(hào)中央C是60480是音符時(shí)長(zhǎng)單位是毫秒。BPM為120時(shí)四分音符是500ms480接近但略有誤差方便處理附點(diǎn)等復(fù)雜節(jié)奏。這個(gè)格式處理單音旋律非常方便但遇到和弦就麻煩了因?yàn)槎鄠€(gè)音符有相同的起始時(shí)間需要表示成音軌而不是單序列。第二版我改成了一種帶和弦標(biāo)記的格式用分號(hào)分隔和弦內(nèi)的多個(gè)音符60;64;67 480 62;67;71 480解析時(shí)如果一行的音符編號(hào)包含多個(gè)就同時(shí)點(diǎn)亮多個(gè)LED等待所有對(duì)應(yīng)按鍵都被按下再推進(jìn)。這種格式犧牲了一點(diǎn)點(diǎn)存儲(chǔ)效率但代碼處理起來(lái)非常直白非常適合作為鍵盤內(nèi)部固件的曲譜格式。MIDI文件的解析在單片機(jī)上是另一個(gè)話題。我建議第一版不要直接在Arduino里解析標(biāo)準(zhǔn)MIDI文件一是MIDI時(shí)間戳和節(jié)拍換算比較繁瑣二是SD卡讀取和緩沖需要額外內(nèi)存。更可靠的做法是在電腦上用Python腳本把MIDI轉(zhuǎn)成上面這種簡(jiǎn)化文本格式再把文本寫入小容量Flash或SD卡。我在GitHub上找到一個(gè)現(xiàn)成的轉(zhuǎn)換工具自己改了一下午跑通了從MIDI到練習(xí)格式的完整鏈路。4.2 BPM與節(jié)拍用millis做時(shí)間基準(zhǔn)跟彈動(dòng)作不能簡(jiǎn)單用delay來(lái)卡時(shí)間因?yàn)槟阈枰瑫r(shí)響應(yīng)按鍵和推進(jìn)LED。正確的時(shí)間基準(zhǔn)是millis()函數(shù)它返回從開(kāi)機(jī)到現(xiàn)在的毫秒數(shù)用差值來(lái)判斷某個(gè)音符應(yīng)該持續(xù)多久。比如當(dāng)前音符時(shí)長(zhǎng)是480ms你在t0時(shí)刻點(diǎn)亮了LED那么音符結(jié)束時(shí)間是t0 480。每輪主循環(huán)都查一次millis() - t0如果大于480說(shuō)明音符時(shí)間到了。但要注意這里有一個(gè)自動(dòng)模式和等待按鍵模式的區(qū)別。自動(dòng)模式音符時(shí)長(zhǎng)到了就自動(dòng)跳下一個(gè)音適合用來(lái)聽(tīng)整段旋律。跟彈模式音符時(shí)長(zhǎng)到了但如果用戶還沒(méi)按鍵LED繼續(xù)亮著直到用戶按下正確按鍵才跳下一個(gè)音。我在跟彈模式里加了一個(gè)超時(shí)提示邏輯如果當(dāng)前音符持續(xù)超過(guò)了正常時(shí)長(zhǎng)的1.5倍就把LED改成閃爍模式提醒用戶這里的鍵還沒(méi)按。這個(gè)細(xì)節(jié)看起來(lái)小但對(duì)學(xué)習(xí)體驗(yàn)的改善特別明顯因?yàn)樾率纸?jīng)常盯著一處不知道下一步該干嘛閃爍能把他拉回注意力。4.3 跟彈模式的狀態(tài)機(jī)設(shè)計(jì)跟彈的核心是一個(gè)狀態(tài)機(jī)我把它分成四個(gè)狀態(tài)WAITING_START等待用戶按下開(kāi)始鍵。SHOWING_NOTE當(dāng)前音符的LED已經(jīng)亮起等待按鍵輸入。WAITING_CONFIRM檢測(cè)到按鍵按下正在確認(rèn)是否正確如果正確進(jìn)入下一音符如果錯(cuò)誤保留當(dāng)前音符并給出錯(cuò)誤提示。FINISHED整首曲子完成LED全部熄滅等待重新開(kāi)始。狀態(tài)轉(zhuǎn)換的關(guān)鍵在SHOWING_NOTE到WAITING_CONFIRM這一步。由于按鍵事件由KeyScanner的掃描回調(diào)產(chǎn)生和主循環(huán)在同一個(gè)線程里所以需要小心處理共享變量。我用的是一個(gè)簡(jiǎn)單的標(biāo)志位currentNoteActive在回調(diào)函數(shù)里只做兩件事把按鍵值和掃描結(jié)果記錄下來(lái)返回真正的狀態(tài)機(jī)推進(jìn)放在主循環(huán)里執(zhí)行。這樣避免在中斷上下文里做復(fù)雜邏輯。4.4 彈錯(cuò)與卡住的判斷策略新手在跟彈過(guò)程中難免按錯(cuò)鍵錯(cuò)誤處理策略直接決定體驗(yàn)。我的設(shè)計(jì)是如果按下的不是當(dāng)前音符對(duì)應(yīng)的鍵立刻點(diǎn)亮一個(gè)紅色錯(cuò)誤LED并且在同一個(gè)音符上等待用戶改按正確的鍵。這里有個(gè)很關(guān)鍵的點(diǎn)不要因?yàn)榘村e(cuò)就重置當(dāng)前音符的時(shí)間戳。否則用戶會(huì)陷入按錯(cuò)-時(shí)間歸零-又要重新等的惡性循環(huán)越著急越錯(cuò)。如果用戶把正確按鍵和錯(cuò)誤按鍵同時(shí)按下比如三和弦錯(cuò)按了其中一個(gè)我的邏輯是所有需要的鍵都按下后才算通過(guò)但允許中間過(guò)程按錯(cuò)。也就是說(shuō)錯(cuò)誤鍵并不阻斷進(jìn)度只是給出提示當(dāng)所有正確鍵都被按住時(shí)當(dāng)前音符才判定完成。這個(gè)策略讓新手在摸索時(shí)可以一直嘗試而不會(huì)因?yàn)橐淮五e(cuò)誤就卡死。5. 從點(diǎn)劃鍵盤延伸出的輸入效率優(yōu)化5.1 單鍵點(diǎn)劃雙模式聊完跟彈引擎我發(fā)現(xiàn)一個(gè)和dotdash keyboard理念貼合的問(wèn)題在有限的按鍵數(shù)量下如何表達(dá)更豐富的音符內(nèi)容如果只有61個(gè)鍵位你需要找2個(gè)八度之內(nèi)的高音或低音手就得跨很大幅度。一個(gè)參考方案是點(diǎn)劃鍵盤的思路——每個(gè)按鍵除了普通的短按還支持長(zhǎng)按作為劃兩種輸入對(duì)應(yīng)不同功能。我在這個(gè)項(xiàng)目里給右側(cè)的功能鍵區(qū)做了類似設(shè)計(jì)按住Shift鍵再按一個(gè)音階鍵就切換該音階的八度按住Alt鍵再按一個(gè)和弦鍵就切換預(yù)置和弦類型。短按是點(diǎn)長(zhǎng)按是劃用同一個(gè)物理鍵實(shí)現(xiàn)兩個(gè)邏輯功能。這個(gè)設(shè)計(jì)在實(shí)彈中非常實(shí)用因?yàn)槭植恍枰x開(kāi)主鍵區(qū)去摸八度切換按鈕。實(shí)現(xiàn)上把Shift和Alt功能鍵的狀態(tài)也納入KeyScanner在回調(diào)函數(shù)里額外記錄功能鍵是否處于長(zhǎng)按狀態(tài)。注意長(zhǎng)按的判定閾值我這里設(shè)為400ms超過(guò)400ms才算劃短按釋放時(shí)算點(diǎn)。這個(gè)閾值要和去抖時(shí)間分開(kāi)不要混用同一個(gè)計(jì)數(shù)器。5.2 用點(diǎn)劃組合切換八度與和弦具體映射上我參考了摩斯碼點(diǎn)劃組合的表達(dá)方式設(shè)計(jì)了一張簡(jiǎn)單的編碼表功能組合方式實(shí)際效果八度上移Shift 點(diǎn)按高音區(qū)C鍵整個(gè)鍵盤音域上移一個(gè)八度八度下移Shift 劃按高音區(qū)C鍵整個(gè)鍵盤音域下移一個(gè)八度大三和弦Alt 點(diǎn)按和弦根音當(dāng)前根音上疊加三和弦小三和弦Alt 劃按和弦根音當(dāng)前根音上疊加小三和弦這個(gè)方案的好處是學(xué)習(xí)成本極低——你只需要記住點(diǎn)和劃的區(qū)別而不是死記硬背幾十個(gè)功能組合鍵。對(duì)初學(xué)鍵盤的人來(lái)說(shuō)這個(gè)設(shè)計(jì)能讓他更快地探索整個(gè)音域而不會(huì)被物理鍵位限制住。5.3 跟彈模式下的快速指法映射點(diǎn)劃組合還解決了一個(gè)實(shí)際演奏問(wèn)題當(dāng)曲譜中出現(xiàn)跨八度的跳躍音時(shí)如果只靠物理鍵位手需要大幅度移動(dòng)。利用點(diǎn)劃切換八度后高音區(qū)的音可以由相鄰鍵位映射過(guò)來(lái)。在跟彈模式下曲譜中要顯示的音符編號(hào)是邏輯音高而不是物理鍵位。程序在顯示前會(huì)先做一次映射把邏輯音高轉(zhuǎn)換為當(dāng)前八度下的物理按鍵編號(hào)。這個(gè)映射函數(shù)我單獨(dú)寫成一個(gè)模塊方便調(diào)試。它的核心思路是維護(hù)一個(gè)baseOctave變量每次點(diǎn)劃切換八度時(shí)改變它所有曲譜音高先減去基礎(chǔ)偏移再對(duì)12取模得到該音高在當(dāng)前八度下的相對(duì)位置然后映射到物理鍵位矩陣的坐標(biāo)。由于是純數(shù)學(xué)運(yùn)算轉(zhuǎn)換速度很快完全不影響掃描時(shí)序。6. 實(shí)測(cè)中踩過(guò)的坑和完整調(diào)試清單6.1 按鍵串聯(lián)導(dǎo)致的假連擊第一次整機(jī)實(shí)測(cè)時(shí)我遇到一個(gè)詭異的bug某些按鍵單獨(dú)按沒(méi)問(wèn)題但只要同時(shí)按下兩個(gè)相鄰的高音鍵第三個(gè)鍵就會(huì)自動(dòng)觸發(fā)一次假連擊。排查了半天發(fā)現(xiàn)不是代碼問(wèn)題而是硬件布局問(wèn)題——我的按鍵矩陣PCB走線時(shí)把相鄰兩列的地線共用了回流路徑太長(zhǎng)按下一個(gè)鍵時(shí)地線上壓降跳變影響了另一列的采樣電平。這種問(wèn)題非常難查。我在代碼里把掃描周期調(diào)到1ms外加去抖計(jì)數(shù)提到8次仍然復(fù)現(xiàn)。后來(lái)用示波器測(cè)矩陣列線的電平才發(fā)現(xiàn)噪聲尖峰。解決方法是重畫PCB把地線加寬每個(gè)按鍵旁邊都加一個(gè)100nF的退耦電容。如果你的項(xiàng)目是用面包板搭的遇到類似假連擊問(wèn)題先別急著調(diào)代碼試試在按鍵行列線之間并一個(gè)100nF電容很多時(shí)候立刻就好。6.2 LED掃描與按鍵掃描共用引腳時(shí)的時(shí)序沖突我最初為了省引腳把LED驅(qū)動(dòng)直接接到矩陣的行列線上想著反正掃描時(shí)分時(shí)復(fù)用應(yīng)該沒(méi)問(wèn)題。結(jié)果運(yùn)行起來(lái)LED有嚴(yán)重的拖影按鍵也有漏掃。原因很簡(jiǎn)單LED亮滅和按鍵掃描共用同一組IO當(dāng)掃描到某一行時(shí)該行的LED狀態(tài)和按鍵狀態(tài)會(huì)互相干擾——如果LED點(diǎn)亮?xí)r把行線拉低按鍵采樣就會(huì)誤讀到按下。我的最終方案是LED驅(qū)動(dòng)完全獨(dú)立出來(lái)用一組專用的GPIO控制并加一個(gè)74HC595移位寄存器來(lái)擴(kuò)展輸出。這樣按鍵矩陣和LED燈板互不干擾掃描和刷新可以并行。如果你想省事也可以用現(xiàn)成的LED按鍵模塊但這種模塊往往把LED和按鍵串在同一個(gè)IO上一樣會(huì)有時(shí)序沖突。6.3 不同琴鍵力度下的觸發(fā)閾值問(wèn)題機(jī)械按鍵的觸發(fā)力度不同導(dǎo)致的問(wèn)題是不管怎么調(diào)去抖參數(shù)總會(huì)有某幾個(gè)鍵手感不一樣。有的鍵輕碰就觸發(fā)有的鍵要按到底才觸發(fā)。原因是簧片間距和彈片的彈性差異。我在這上面花了大量時(shí)間后來(lái)才發(fā)現(xiàn)光靠軟件去抖無(wú)法根本解決必須結(jié)合硬件。我的做法是在按鍵矩陣板上用3D打印件做了一個(gè)勻力壓片把按鍵的觸發(fā)形變集中在同一段行程內(nèi)。雖然不能做到和鋼琴鍵盤一樣的力度分級(jí)但至少所有按鍵的觸發(fā)點(diǎn)不再參差不齊。如果你不打算做壓片還有一個(gè)折中的處理方案在KeyScanner里為每個(gè)按鍵保存一個(gè)觸發(fā)閾值計(jì)數(shù)器不同按鍵可以設(shè)置不同的去抖計(jì)數(shù)。比如某些鍵需要連續(xù)7次確認(rèn)才算按下有些鍵5次就夠。這個(gè)差異化參數(shù)在調(diào)試時(shí)非常管用。6.4 調(diào)試用的輔助工具與日志策略這種項(xiàng)目最怕的就是出問(wèn)題后不知道內(nèi)部狀態(tài)。我的建議是從一開(kāi)始就做好日志輸出。我用的是Arduino的Serial輸出但不會(huì)在主循環(huán)里狂打日志那會(huì)影響時(shí)序。而是把日志寫到環(huán)形緩沖區(qū)在按鍵事件、狀態(tài)切換、音符推進(jìn)這些關(guān)鍵節(jié)點(diǎn)寫入日志然后通過(guò)串口批量輸出。調(diào)試時(shí)我會(huì)在電腦端開(kāi)一個(gè)串口監(jiān)視器實(shí)時(shí)觀察狀態(tài)機(jī)變遷。比如我定義了這樣的日志格式[120] KEY_DOWN row2 col5 key60 [122] KEY_UP row2 col5 key60 [125] STATE_CHANGE oldSHOWING_NOTE newWAITING_CONFIRM [126] NOTE_FINISHED key60靠著這個(gè)日志我很容易定位到哪個(gè)按鍵事件被漏掉或狀態(tài)機(jī)卡在哪個(gè)分支。你還可以在代碼里加一個(gè)編譯期開(kāi)關(guān)發(fā)布給用戶使用時(shí)把日志關(guān)掉調(diào)試時(shí)才打開(kāi)避免串口輸出拖慢掃描周期。再分享一個(gè)我最后才加的功能長(zhǎng)按某個(gè)功能鍵2秒鍵盤會(huì)進(jìn)入自檢測(cè)試模式所有LED依次點(diǎn)亮所有按鍵狀態(tài)實(shí)時(shí)上報(bào)到串口。這個(gè)模式在硬件故障排查時(shí)特別有用不用寫任何額外測(cè)試程序直接就能檢查每個(gè)按鍵和每顆LED是否正常。7. 一些后續(xù)可以繼續(xù)打磨的方向做到這一步一把能跟彈的LED鍵盤已經(jīng)能穩(wěn)定運(yùn)行了。我后續(xù)計(jì)劃把它往兩個(gè)方向擴(kuò)展一是加入更完整的MIDI輸入解析讓它直接讀標(biāo)準(zhǔn)MIDI文件而不是預(yù)處理過(guò)的簡(jiǎn)化格式二是把點(diǎn)劃雙模式擴(kuò)展成更靈活的自定義指法映射讓用戶可以在上位機(jī)軟件里自由綁定功能鍵。如果你也打算做這個(gè)項(xiàng)目我的建議是不要一開(kāi)始就追求61鍵全尺寸先用25鍵或37鍵的小鍵盤跑通完整的LED指示-按鍵掃描-跟彈邏輯鏈路。小鍵盤需要的IO更少、調(diào)試更快等整個(gè)系統(tǒng)穩(wěn)定了再擴(kuò)展到大鍵數(shù)。硬件上優(yōu)先解決去抖和鬼影軟件上優(yōu)先做好狀態(tài)機(jī)和日志這兩個(gè)方向做扎實(shí)了剩下的都是水到渠成的事。