1. 先弄清楚需求翻頁(yè)器本質(zhì)上是藍(lán)牙鍵盤AlphaPi 完全能勝任1.1 翻頁(yè)器到底是什么常說道理我都懂可就是差一個(gè)能用的小工具。我在做這個(gè)項(xiàng)目之前拆過一次朋友的翻頁(yè)筆發(fā)現(xiàn)里面結(jié)構(gòu)比想象中簡(jiǎn)單一個(gè)單片機(jī)、一個(gè)藍(lán)牙模塊、兩三個(gè)微動(dòng)開關(guān)、一顆紐扣電池沒了。所有翻頁(yè)筆本質(zhì)上都在做同一件事——把自己模擬成一只藍(lán)牙鍵盤然后向連接的電腦發(fā)送 PageDown、PageUp 這種標(biāo)準(zhǔn)鍵盤按鍵。演示軟件PPT、Keynote、PDF閱讀器其實(shí)并不認(rèn)識(shí)翻頁(yè)筆它們只認(rèn)識(shí)鍵盤按鍵。翻頁(yè)筆的按鍵被電腦識(shí)別成按鍵事件以后軟件自然就翻頁(yè)了。搞清楚這一點(diǎn)思路就通了。既然翻頁(yè)筆 藍(lán)牙鍵盤 兩個(gè)按鍵那如果我有一塊帶藍(lán)牙模塊、帶 GPIO 的開發(fā)板理論上完全可以自己做一個(gè)翻頁(yè)器。AlphaPi 這塊開發(fā)板本來就是 ARM 架構(gòu)、跑完整 Linux 系統(tǒng)性能比翻頁(yè)筆里的單片機(jī)強(qiáng)得多干這點(diǎn)活綽綽有余。它可以同時(shí)當(dāng)一個(gè)可編程的藍(lán)牙鍵盤既發(fā)翻頁(yè)命令也能按需求擴(kuò)展成打印當(dāng)前頁(yè)切換軟件窗口播放暫停視頻這類自定義快捷操作。1.2 為什么用 AlphaPi 改裝而不是買一個(gè)這是每個(gè)人聽到這個(gè)項(xiàng)目后問的第一句話。市面上翻頁(yè)筆幾十塊就能買到用開發(fā)板改裝體積又大功耗又高圖什么呢我的回答是翻頁(yè)筆只是順帶的結(jié)果真正想借這個(gè)項(xiàng)目搞明白的是Linux 開發(fā)板如何被識(shí)別成藍(lán)牙外設(shè)這條知識(shí)線。這個(gè)問題的答案不只在翻頁(yè)器上還能延伸到做藍(lán)牙控制器、藍(lán)牙手柄、藍(lán)牙傳感器節(jié)點(diǎn)等一堆場(chǎng)景。價(jià)格上算一筆賬自然更清楚方案成本體積可擴(kuò)展性學(xué)習(xí)價(jià)值買現(xiàn)成翻頁(yè)筆40~200元極小基本為零低藍(lán)牙BLE模塊單片機(jī)自己寫20~50元小一般中AlphaPi開發(fā)板改裝0元吃灰板子中等很強(qiáng)高項(xiàng)目做完翻頁(yè)器用在每周例會(huì)匯報(bào)上很順手而掌握的那套HID over GATT注冊(cè)流程以后做遙控小車、體感手柄、甚至做無障礙輸入設(shè)備都能復(fù)用。這筆買賣我認(rèn)為劃算。1.3 項(xiàng)目拆解三個(gè)關(guān)鍵子問題把整個(gè)項(xiàng)目拆開看真正需要解決的問題只有三個(gè)板卡側(cè)讓 AlphaPi 的藍(lán)牙協(xié)議棧注冊(cè)一個(gè) HID人機(jī)交互設(shè)備服務(wù)這樣電腦才會(huì)把它識(shí)別成鍵盤而不是一個(gè)音頻設(shè)備或者未知設(shè)備。交互側(cè)用 GPIO 讀取按鈕按下去以后向已連接的電腦發(fā)送對(duì)應(yīng)的 HID 報(bào)文模擬鍵盤按下 PageDown。運(yùn)維側(cè)供電、開機(jī)自啟、意外斷線后自動(dòng)重連讓它從一個(gè)開發(fā)板變成一個(gè)可以帶出門的工具。這個(gè)項(xiàng)目里我用 Workbuddy 作為開發(fā)主力工具。它本質(zhì)上是一個(gè) AI 工作臺(tái)能在一個(gè)界面里調(diào)度終端、編輯器、瀏覽器我可以用自然語言給它交代任務(wù)讓它去查資料、寫代碼、看日志、改 bug。以前這種小項(xiàng)目最耗時(shí)的就是對(duì)著裁剪過的藍(lán)牙協(xié)議棧文檔啃半天現(xiàn)在 Workbuddy 幫我走通整個(gè)流程我只負(fù)責(zé)在關(guān)鍵節(jié)點(diǎn)上做判斷項(xiàng)目推進(jìn)速度快了很多。這篇文章就完整記錄我用 Workbuddy 走通這條路的過程踩過的坑一個(gè)不少希望遇到同樣需求的人能少走幾步彎路。2. 開工準(zhǔn)備燒系統(tǒng)、查藍(lán)牙、初始化 Workbuddy 工作區(qū)2.1 燒錄系統(tǒng)并確認(rèn)藍(lán)牙適配器AlphaPi 開發(fā)板拿到手第一步自然是燒系統(tǒng)。我選的是 Debian 系鏡像背后沒什么特殊理由就是藍(lán)牙相關(guān)的軟件包在 Debian 系下最全BlueZ 工具鏈基本是開箱即在。燒錄用常規(guī)做法SD 卡格式化后用工具把鏡像寫入卡內(nèi)插回板子通電網(wǎng)線或者 WiFi 連接然后通過 SSH 從電腦登錄。整個(gè)過程十分鐘左右。燒完系統(tǒng)最先要確認(rèn)的不是跑分而是藍(lán)牙適配器是否被內(nèi)核識(shí)別systemctl status bluetooth bluetoothctl list重點(diǎn)看兩件事第一bluetooth 服務(wù)有沒有起來第二bluetoothctl list能不能列出本機(jī)的藍(lán)牙適配器。如果這里什么都沒有后面的步驟全部無從談起。我手上這塊 AlphaPi 板載藍(lán)牙正常但如果你用的板子沒有板載藍(lán)牙花二十幾塊錢插一個(gè) USB 藍(lán)牙適配器也能達(dá)到同樣的效果只是注意別買那種免驅(qū)只支持鼠標(biāo)的老款要買支持 BlueZ 標(biāo)準(zhǔn)協(xié)議棧的。2.2 Workbuddy 的角色定位不是寫碼工具是帶班工程師這個(gè)項(xiàng)目里 Workbuddy 在我的電腦上運(yùn)行通過 SSH 連接 AlphaPi 開發(fā)板終端。用下來我最突出的感受是它不像一個(gè)代碼補(bǔ)全工具更像一個(gè)能長(zhǎng)期盯項(xiàng)目、幫我把步驟落實(shí)的帶班工程師。我給它布置任務(wù)時(shí)并不局限于幫我寫一個(gè)函數(shù)而是給它完整的項(xiàng)目上下文。比如我對(duì)它說當(dāng)前有一個(gè) AlphaPi 開發(fā)板運(yùn)行 Debian已通過 SSH 連接內(nèi)核版本是某某藍(lán)牙芯片型號(hào)是某某我現(xiàn)在想讓它被電腦識(shí)別成藍(lán)牙鍵盤目標(biāo)是按下 GPIO 物理按鍵后發(fā)送 PageDown 鍵。請(qǐng)先調(diào)研兩條技術(shù)路線一條是基于 BlueZ D-Bus 注冊(cè) GATT 服務(wù)一條是使用第三方工具對(duì)比優(yōu)缺點(diǎn)后給出推薦方案。它會(huì)真的去查資料然后把方案整理成表格交給我。這就是我說它像帶班工程師的原因它處理的是任務(wù)不是片段。在整個(gè)開發(fā)過程中我?guī)缀醪恍枰ニ阉饕媸謩?dòng)翻那些過時(shí)的教程遇到報(bào)錯(cuò)直接把終端輸出貼給它它通常能指出問題出在哪一層。2.3 把需求描述成 AI 能執(zhí)行的拆解任務(wù)用 Workbuddy 這類 AI 工作臺(tái)有一個(gè)習(xí)慣必須養(yǎng)成任務(wù)描述里一定要包含環(huán)境信息、目標(biāo)、限制條件三樣?xùn)|西。拿這個(gè)項(xiàng)目舉例我給它的一條完整指令是這樣的當(dāng)前環(huán)境AlphaPi 開發(fā)板Debian 12內(nèi)核 6.1BlueZ 版本 5.66藍(lán)牙適配器為板載。目標(biāo)讓開發(fā)板通過藍(lán)牙 HID over GATT 協(xié)議被外部電腦識(shí)別為標(biāo)準(zhǔn)鍵盤。限制不能修改內(nèi)核不能使用閉源驅(qū)動(dòng)。請(qǐng)給出實(shí)施方案并說明每步需要切換權(quán)限的地方。第一次用這種完整描述跑任務(wù)時(shí)效果和直接說幫我做藍(lán)牙鍵盤完全不同。前者它知道去哪里查、用什么工具、要考慮什么約束后者它會(huì)反過來問你一堆問題。并不是 AI 變笨了而是我給的上下文越準(zhǔn)確它越不需要猜。這個(gè)過程本身也是這個(gè)學(xué)用系列項(xiàng)目里最值得復(fù)制的一種工作方式把一個(gè)大任務(wù)拆成環(huán)境目標(biāo)約束AI 才能真正替你干活。3. 核心攻堅(jiān)HID over GATT讓開發(fā)板變成隱形鍵盤3.1 原理藍(lán)牙 HID 服務(wù)的 GATT 骨架整個(gè)項(xiàng)目最核心、也最勸退新人的部分就是讓開發(fā)板變成藍(lán)牙鍵盤。這句話說起來簡(jiǎn)單做起來涉及藍(lán)牙協(xié)議棧里一個(gè)叫HID over GATT的規(guī)范。用生活類比解釋一下。藍(lán)牙設(shè)備之間通信就像兩個(gè)人在一個(gè)房間聊天GATT 就是房間里的公告板公告板上掛著各種欄目。普通藍(lán)牙耳機(jī)掛的是音頻輸出欄目藍(lán)牙溫度計(jì)掛的是溫度測(cè)量欄目我們這次要掛的是人機(jī)交互設(shè)備欄目也就是 HID。電腦連上這塊開發(fā)板后會(huì)去公告板上找這個(gè)欄目找到了它就相信對(duì)方是一只鍵盤或鼠標(biāo)。技術(shù)上HID 服務(wù)有一個(gè)固定的 UUID0x1812里面包含若干個(gè)特性。最核心的兩個(gè)一個(gè)是Report Map用來描述這個(gè)鍵盤有幾個(gè)按鍵、報(bào)文是多長(zhǎng)相當(dāng)于說明書的目錄一個(gè)是Report這是真正實(shí)時(shí)收發(fā)按鍵數(shù)據(jù)的地方。電腦讀取了 Report Map知道該怎么解析數(shù)據(jù)開發(fā)板向 Report 特性寫入PageDown 按下的報(bào)文電腦的藍(lán)牙協(xié)議棧就會(huì)把它轉(zhuǎn)成一個(gè)真實(shí)的鍵盤按鍵事件。這個(gè)流程聽起來復(fù)雜但好消息是有 BlueZ 這套現(xiàn)成工具鏈我們不需要自己從零實(shí)現(xiàn) GATT 協(xié)議。Workbuddy 幫我把 BlueZ 官方文檔和社區(qū)實(shí)踐整理成了幾頁(yè)可操作的步驟真正動(dòng)手時(shí)只需要會(huì)改配置、會(huì)寫一段注冊(cè)服務(wù)的小代碼。3.2 用 Workbuddy 生成 GATT HID 服務(wù)注冊(cè)代碼BlueZ 通過 D-Bus 向外部程序暴露 GATT 管理接口。我們要做的是向 BlueZ 注冊(cè)一個(gè)應(yīng)用程序其中包含 HID 服務(wù)和它下面的幾個(gè)特性。這部分代碼用 Python 調(diào)用 D-Bus 的方式編寫結(jié)構(gòu)大致如下# 簡(jiǎn)單示例向 BlueZ 注冊(cè) HID over GATT 服務(wù) # 完整代碼由 Workbuddy 生成這里只展示關(guān)鍵結(jié)構(gòu) HID_SERVICE_UUID 00001812-0000-1000-8000-00805f9b34fb REPORT_MAP_UUID 00002a4b-0000-1000-8000-00805f9b34fb REPORT_UUID 00002a4a-0000-1000-8000-00805f9b34fb HID_INFORMATION_UUID 00002a4a-0000-1000-8000-00805f9b34fb # Report Map描述這是一個(gè)標(biāo)準(zhǔn) 6 鍵鍵盤最多同時(shí)按 6 個(gè)鍵 report_map bytes([ 0x05, 0x01, # Usage Page (Generic Desktop) 0x09, 0x06, # Usage (Keyboard) 0xA1, 0x01, # Collection (Application) ... # 中間為鍵盤用的報(bào)告描述符較長(zhǎng)此處省略 0xC0 # End Collection ]) def register_hid_service(bus): # 通過 D-Bus 創(chuàng)建 GATT 服務(wù)、添加特性、啟動(dòng)服務(wù) # 具體調(diào)用 org.bluez.GattManager1.RegisterApplication pass def send_key(device_path, keycode): # 構(gòu)造 HID 鍵盤報(bào)文 8 字節(jié) # 結(jié)構(gòu)Modifier 1字節(jié) | Reserved 1字節(jié) | Keycode 6字節(jié) report_with_key bytearray(8) report_with_key[2] keycode # 把按鍵碼放入第一個(gè)鍵位 # 寫入 Report 特性并通知已連接的電腦 write_report(device_path, bytes(report_with_key))這段代碼里的關(guān)鍵常量一個(gè)都不能寫錯(cuò)。特別是 Report Map它決定電腦如何理解后面收到的報(bào)文。如果 Report Map 里聲明的是 8 字節(jié)鍵盤報(bào)文實(shí)際發(fā)送時(shí)卻只發(fā) 6 字節(jié)電腦端會(huì)直接忽略或報(bào)協(xié)議錯(cuò)誤。所以 Workbuddy 生成完代碼我第一件事就是逐字段核對(duì) Report Map 的長(zhǎng)度和 Report 報(bào)文長(zhǎng)度是不是對(duì)得上。3.3 發(fā)送一次 PageDown按下與釋放的報(bào)文節(jié)奏很多人第一次做這里會(huì)卡住明明往 Report 特性里寫了 PageDown 鍵碼電腦一點(diǎn)反應(yīng)都沒有。原因多半在于只發(fā)了按下沒發(fā)釋放。真實(shí)的鍵盤工作方式是這樣的按下按鍵時(shí)發(fā)送包含鍵碼的報(bào)文松開按鍵時(shí)發(fā)送全部為零的報(bào)文。如果只發(fā)按下的報(bào)文電腦會(huì)認(rèn)為這個(gè)鍵一直被按著在演示文稿里表現(xiàn)為連續(xù)翻頁(yè)翻到了底。正確的節(jié)奏是import time def tap_page_down(device_path): # PageDown 在 USB HID 鍵盤頁(yè)中的鍵碼是 0x4E keycode 0x4E # 按下 press_report bytearray(8) press_report[2] keycode send_hid_report(device_path, bytes(press_report)) # 等待 20~50 毫秒讓電腦有時(shí)間識(shí)別按鍵 time.sleep(0.03) # 釋放 release_report bytearray(8) send_hid_report(device_path, bytes(release_report))時(shí)間間隔我實(shí)測(cè)下來 20 毫秒到 50 毫秒都行太短了電腦有可能沒收干凈太長(zhǎng)了連續(xù)翻頁(yè)時(shí)會(huì)明顯變慢。至于鍵碼PageDown 是0x4EPageUp 是0x4B左方向鍵是0x50右方向鍵是0x4F。我最初以為需要在代碼里寫復(fù)雜的掃描碼實(shí)際上 BlueZ 層接收的就是 HID 標(biāo)準(zhǔn)鍵碼寫對(duì)數(shù)字就行。3.4 第一次連接成功從配對(duì)到看到鍵盤圖標(biāo)服務(wù)注冊(cè)完成接下來就是一對(duì)一連接的見證時(shí)刻。開發(fā)板默認(rèn)處于可發(fā)現(xiàn)狀態(tài)之后我打開演示電腦的藍(lán)牙設(shè)置列表里出現(xiàn)了一串字符設(shè)備名點(diǎn)擊配對(duì)。這時(shí)開發(fā)板側(cè)需要執(zhí)行一個(gè)動(dòng)作來接受配對(duì)否則電腦會(huì)一直轉(zhuǎn)圈或提示失敗。我是在 SSH 終端里進(jìn)入bluetoothctl交互模式操作的bluetoothctl agent on default-agent做完這兩步電腦端那邊立即就配對(duì)完成了。緊接著我打開設(shè)備與打印機(jī)里面出現(xiàn)了一個(gè)鍵盤圖標(biāo)那一刻項(xiàng)目的難度已經(jīng)過去了一半。從這時(shí)起開發(fā)板在電腦眼里就是一只標(biāo)準(zhǔn)的藍(lán)牙鍵盤后面所有功能性工作都建立在它對(duì)電腦來說就是鍵盤這個(gè)事實(shí)之上。第一次看到鍵盤圖標(biāo)出現(xiàn)時(shí)印象很深速度比想象中快整個(gè)前期調(diào)研和代碼修補(bǔ)雖然折騰但總算從不可能變成了可行。4. 按鍵與交互邏輯GPIO 檢測(cè)、防抖、組合鍵設(shè)計(jì)4.1 按鍵規(guī)劃三鍵方案藍(lán)牙鍵盤這個(gè)底層能力打通之后翻頁(yè)器就只差物理按鈕 按鍵邏輯這部分了。AlphaPi 的 GPIO 引腳很充足我最終做了三個(gè)按鍵而不是兩個(gè)。布局邏輯是這樣的按鍵 A放在左手拇指位置負(fù)責(zé)下一頁(yè)。按鍵 B放在左手食指位置負(fù)責(zé)上一頁(yè)。按鍵 C放在側(cè)面靠?jī)?nèi)的位置是一個(gè)功能鍵短按切換模式長(zhǎng)按發(fā)送 F5 進(jìn)入放映模式。三鍵方案比兩鍵多一個(gè)模式鍵可玩性高很多。按下模式鍵以后整個(gè)設(shè)備在不同演示場(chǎng)景里的表現(xiàn)是不一樣的默認(rèn)模式發(fā) PageDown/PageUp適合 PDF 和 PPT 的逐頁(yè)瀏覽切換到方向鍵模式后發(fā)送右方向鍵/左方向鍵兼容某些只認(rèn)方向鍵的軟件放映模式下的下一頁(yè)則發(fā)送回車鍵方便一些特定的演示流程。每個(gè)按鍵在 GPIO 上的連接方式一端接 GPIO 針腳另一端接 GND。代碼里設(shè)置上拉電阻平時(shí)讀到高電平按下變成低電平以此來識(shí)別按鍵事件。每個(gè)按鍵對(duì)應(yīng)一個(gè)引腳三個(gè)按鍵互不影響。4.2 防抖和長(zhǎng)按/短按識(shí)別物理按鍵第一次按下會(huì)有機(jī)械抖動(dòng)電氣層面表現(xiàn)為在一個(gè)極短的時(shí)間內(nèi)電平反復(fù)跳變。如果不做處理一次實(shí)際按壓會(huì)被識(shí)別成好幾次翻頁(yè)器按下一次翻好幾頁(yè)非常尷尬。最簡(jiǎn)單的防抖方式是軟件延時(shí)判斷檢測(cè)到電平變化后等待 20 毫秒再讀一次如果還是穩(wěn)定狀態(tài)才確認(rèn)是一次有效按下。這套邏輯在手寫代碼時(shí)挺容易寫錯(cuò)交給 Workbuddy 生成初稿幾乎一次就對(duì)了但校驗(yàn)點(diǎn)還是要自己把握延時(shí)太短防不住抖動(dòng)太長(zhǎng)會(huì)讓按鍵失去跟手感。我實(shí)測(cè)大約 15 毫秒到 25 毫秒之間手感最好。長(zhǎng)按和短按的區(qū)分核心是計(jì)時(shí)。檢測(cè)到按鍵按下后記錄時(shí)間戳一直等它釋放如果釋放時(shí)按壓時(shí)長(zhǎng)小于 500 毫秒算短按執(zhí)行某一套動(dòng)作如果超過 800 毫秒則算長(zhǎng)按執(zhí)行另一套動(dòng)作。用來區(qū)分模式鍵的短按切換與長(zhǎng)按 F5 的正好是這套邏輯。4.3 模式切換方向鍵模式、閱讀器模式、放映模式設(shè)計(jì)模式切換的出發(fā)點(diǎn)是不同應(yīng)用對(duì)翻頁(yè)指令的口味不一樣。我做了一個(gè)簡(jiǎn)單狀態(tài)機(jī)把模式保存在內(nèi)存變量里每次按鍵時(shí)先查當(dāng)前模式再?zèng)Q定發(fā)什么鍵碼。模式按鍵A下一頁(yè)按鍵B上一頁(yè)適合場(chǎng)景0 默認(rèn)模式PageDownPageUpPPT、PDF閱讀器1 方向鍵模式右方向鍵左方向鍵網(wǎng)頁(yè)橫向滾動(dòng)、某些白板工具2 演示模式回車PageUp特定放映流程模式切換后我讓開發(fā)板通過藍(lán)牙發(fā)送一個(gè)當(dāng)前模式的無聲按鍵作為反饋什么反饋?zhàn)钪庇^呢我用的是發(fā)送一個(gè)鍵盤按鍵作為確認(rèn)信號(hào)比如切換模式時(shí)發(fā)送一次 Alt 鍵的按下釋放這樣電腦端可能表現(xiàn)為無操作或窗口菜單彈出少量干擾換來了明確感知。當(dāng)然也可以在開發(fā)板上加一個(gè) LED 燈做指示那個(gè)方案外觀上更友好但需要多占一個(gè)引腳、多幾行代碼。這套邏輯看著不復(fù)雜但它是整個(gè)翻頁(yè)器過程體驗(yàn)的核心。按鍵好按下去翻得干凈利落、模式切換不迷路才是能日常使用的工具否則只是能跑通的模塊。5. 實(shí)測(cè)排坑四個(gè)把我折磨到大半夜的問題5.1 問題一開發(fā)板默認(rèn)沒有注冊(cè) HID 服務(wù)第一次測(cè)試時(shí)我打開電腦藍(lán)牙掃描開發(fā)板的設(shè)備名看得見但是配對(duì)之后彈出的類型是其他設(shè)備而不是鍵盤。說明開發(fā)板雖然開啟了廣播但它的 GATT 服務(wù)里根本沒有 HID 欄目電腦不知道該怎么理解這個(gè)設(shè)備。這個(gè)問題的根源是BlueZ 默認(rèn)只提供 SPP、A2DP 等常規(guī)服務(wù)HID over GATT 的注冊(cè)工作必須由應(yīng)用層自己完成。換句話說光有 bluetoothd 還不夠還必須把前文提到的 RegisterApplication 那段代碼跑起來。排查思路是在開發(fā)板上執(zhí)行bluetoothctl查看已注冊(cè)的服務(wù)列表發(fā)現(xiàn)里面沒有 0x1812 服務(wù) UUID立刻定位到了問題。把 HID 服務(wù)注冊(cè)代碼作為 systemd 服務(wù)隨系統(tǒng)啟動(dòng)問題才真正解決。5.2 問題二電腦配對(duì)成功卻沒有彈出鍵盤類型這個(gè)坑比前一個(gè)更隱蔽。服務(wù)注冊(cè)代碼確實(shí)跑起來了電腦端也能配對(duì)但是設(shè)備類型依然是未知設(shè)備。檢查代碼時(shí)發(fā)現(xiàn)Report Map 里的描述符聲明的是一個(gè)鍵盤集合但 HID 服務(wù)里還需要包含HID Information特性其中有一個(gè)字段是 bcdHID 版本號(hào)和一個(gè) country code 國(guó)家代碼。當(dāng)時(shí)生成的代碼里 HID Information 特性的值全部為零電腦端識(shí)別不出這是一個(gè)合法的 HID 設(shè)備。把 HID Information 特性值修正為標(biāo)準(zhǔn)的 1.11 版本號(hào)并正確設(shè)置 boot protocol 標(biāo)志后插上重新連接電腦立刻識(shí)別出了鍵盤字樣。這個(gè)坑讓我意識(shí)到GATT 服務(wù)不是把一個(gè) UUID 掛上去就完事里面每個(gè)特性的內(nèi)容都要符合規(guī)范少一個(gè)字段主設(shè)備端就可能拒絕承認(rèn)你的身份。5.3 問題三翻頁(yè)信號(hào)到了但按一下出一頁(yè)半功能通了之后還有一個(gè)體驗(yàn)問題折磨人明明做了防抖偶爾按一下還是會(huì)連續(xù)翻頁(yè)。排查了一輪發(fā)現(xiàn)問題不在 GPIO 抖動(dòng)而在藍(lán)牙 HID 報(bào)文本身。之前提到發(fā)送按鍵時(shí)要按下釋放成對(duì)發(fā)送我在釋放之后沒有任何間隔導(dǎo)致電腦端在極短時(shí)間內(nèi)收到了兩次按鍵事件。有時(shí)候釋放報(bào)文和下一次按下的報(bào)文在藍(lán)牙協(xié)議棧里被合并到了一起電腦端解析成了兩次按鍵。修復(fù)方式是在一次完整的按下釋放之后再加 50 毫秒的靜默期保證每次翻頁(yè)事件之間有足夠的分隔。這個(gè)細(xì)節(jié)直接影響使用體驗(yàn)如果沒有耐心測(cè)試很難注意到。5.4 問題四休眠喚醒后連接丟失重連不上開發(fā)板跑的是完整 Linux 系統(tǒng)平時(shí)插著電源用沒問題但你想把它帶出門就要考慮斷電、休眠、藍(lán)牙斷連之后的恢復(fù)。AlphaPi 默認(rèn)的電源管理會(huì)在系統(tǒng)空閑一段時(shí)間后掛起藍(lán)牙模塊醒來后電腦端顯示設(shè)備連接失敗。處理辦法分兩層第一層修改電源管理策略禁止藍(lán)牙 USB 設(shè)備自動(dòng)掛起第二層在開發(fā)板側(cè)寫一個(gè)守護(hù)腳本定時(shí)檢查是否有已配對(duì)設(shè)備連接如果沒有就主動(dòng)發(fā)起重連。腳本邏輯很簡(jiǎn)單但很實(shí)用#!/bin/bash # 每 30 秒檢查一次如果有配對(duì)的鍵盤主機(jī)不在線嘗試重連 while true; do if ! bluetoothctl info 對(duì)端MAC | grep -q Connected: yes; then bluetoothctl connect 對(duì)端MAC /dev/null 21 fi sleep 30 done這臺(tái)翻頁(yè)器實(shí)際用起來穩(wěn)定性的主要障礙就是這個(gè)。每次重連恢復(fù)正常之后我出門都敢直接帶它往包里一塞到會(huì)場(chǎng)開機(jī)、翻頁(yè)基本無障礙。6. 從原型到口袋設(shè)備供電、自啟與外殼6.1 供電方案對(duì)比充電寶最省事18650 最便攜開發(fā)板做翻頁(yè)器功能完全跑通后供電是個(gè)繞不開的問題——你不能在講臺(tái)上放一個(gè)拖著電源線的翻頁(yè)器那太另類了。我先后試過三種方案USB 充電寶直接供電、手機(jī)充電器直插、鋰電池模塊供電。充電寶最穩(wěn)定但體積太大完全違背了翻頁(yè)器該有的便攜屬性。手機(jī)充電器供電干脆不現(xiàn)實(shí)講臺(tái)上極少有能隨手插電的插座。最終還是選了 18650 鋰電池加充放電保護(hù)模塊的方案容量 2000mAh 左右實(shí)測(cè)給這塊開發(fā)板供電能撐一個(gè)晚上完全夠用。接線時(shí)注意一點(diǎn)鋰電池必須走保護(hù)板絕對(duì)不能直接焊到開發(fā)板的 5V 引腳上不然過放一次電池就廢了。這一點(diǎn)我在焊接時(shí)尤其小心。6.2 做成開機(jī)自啟的 systemd 服務(wù)開發(fā)板作為翻頁(yè)器如果每次開機(jī)都要手動(dòng)運(yùn)行腳本那就沒有工具的意義了。我把翻頁(yè)服務(wù)的進(jìn)程和重連守護(hù)腳本都做成了 systemd 服務(wù)設(shè)置開機(jī)自啟。這里有個(gè)容易忽略的點(diǎn)服務(wù)的啟動(dòng)順序依賴藍(lán)牙服務(wù)先就緒。我給翻頁(yè)服務(wù)加了一條Afterbluetooth.service同時(shí)在實(shí)際執(zhí)行的腳本開頭加了 5 秒等待確保 bluetoothd 完全起來再注冊(cè) GATT 服務(wù)。沒有這個(gè)等待動(dòng)作開機(jī)后偶爾會(huì)出現(xiàn)注冊(cè)失敗表現(xiàn)就是電腦那邊搜不到開發(fā)板的鍵盤。做一個(gè)便捷開關(guān)也很有用我在系統(tǒng)里添加了一個(gè)別名指令輸入presentation-on或presentation-off就能手動(dòng)啟動(dòng)或停止翻頁(yè)服務(wù)。實(shí)際使用場(chǎng)景中有時(shí)候并不希望開發(fā)板立刻變成鍵盤設(shè)備比如需要先用它做別的調(diào)試任務(wù)。6.3 外殼與按鍵手感一個(gè) 3D 打印小盒子翻頁(yè)器的最終形態(tài)不能是裸露的 PCB那既不安全也不好用。我用 3D 打印做了一個(gè)上下蓋結(jié)構(gòu)的小盒子整體尺寸大約 100×60×25 毫米內(nèi)部剛好放下開發(fā)板、鋰電池、充放電模塊和三個(gè)微動(dòng)開關(guān)。外殼設(shè)計(jì)上三個(gè)關(guān)鍵點(diǎn)第一三個(gè)按鍵的位置要貼合握持手勢(shì)不能按照 PCB 排布來而是按鍵通過飛線連接到 GPIO再把按鍵固定在外殼的按鈕位上第二電池倉(cāng)和主板之間加了一層絕緣隔板防止移動(dòng)中短路第三開發(fā)板的 USB 口在側(cè)面開一個(gè)缺口露出來充電和調(diào)試都方便。按鍵手感方面試過兩種開關(guān)薄膜按鍵和微動(dòng)開關(guān)。薄膜按鍵安靜但回彈軟微動(dòng)開關(guān)干脆利落但按多了手指累。最終選了手感適中的輕觸微動(dòng)開關(guān)并在按鈕蓋上加了一圈增高帽使手指按下去時(shí)的受力面積更大長(zhǎng)時(shí)間演講時(shí)不容易疲勞。6.4 最終效果與進(jìn)一步擴(kuò)展做完之后我拿它在周例會(huì)上實(shí)測(cè)了幾次穩(wěn)定性和可玩性都遠(yuǎn)超預(yù)期。設(shè)備在演示電腦上顯示為鍵盤翻頁(yè)響應(yīng)基本感覺不到延遲長(zhǎng)按模式鍵切換模式也正常。整機(jī)的續(xù)航足夠覆蓋幾場(chǎng)連續(xù)會(huì)議充電 2 小時(shí)能用很久。最讓人欣慰的地方是它不是一次性玩具而是一個(gè)可以隨意改寫的設(shè)備。換個(gè)腳本它下一秒就能變成 PPT 遙控、視頻播放暫?？旖萱I、甚至音量控制器。如果繼續(xù)擴(kuò)展我下一個(gè)想加的是 OLED 小屏幕用來顯示當(dāng)前模式和電池電量再往下走可以用藍(lán)牙低功耗連接方式降低功耗讓同樣的電池容量續(xù)航翻幾倍。但這些都不影響它在當(dāng)前狀態(tài)下的實(shí)用價(jià)值——一個(gè)從吃灰開發(fā)板里變出來的翻頁(yè)器就這么穩(wěn)定地在每個(gè)周一早晨替我翻完二十幾頁(yè)匯報(bào)材料了。這個(gè)項(xiàng)目的完整形態(tài)就是這樣。我個(gè)人的體會(huì)是用 Workbuddy 幫助做這類硬件小項(xiàng)目最寶貴的不是它替你寫的那些代碼而是它幫你把我不知道從哪開始縮短成了我知道下一步該驗(yàn)證什么。從需求到成品在 AI 工作臺(tái)的輔助下一個(gè)不算小的硬件改造項(xiàng)目斷斷續(xù)續(xù)幾天就能走完并且最終的產(chǎn)品還能在日常工作中持續(xù)使用。下次我再看到某個(gè)開發(fā)板吃灰大概會(huì)先想想能不能把它變成身邊另一個(gè)趁手的小工具。