使用支援 QMK 的鍵盤可以自訂鍵盤的配置,非常方便。
Table Of Contents
建立你自己的鍵盤韌體
在你完成上一步的環境設定之後,接者就可以自訂鍵盤配置。接下來分為三個步驟。
建立新的配置檔 (Keymap)
首先你要從 default
的配置檔中複製一份出來,接者再修改,如果你已經在上一篇中設定鍵盤的預設選項,則就可以直接透過 QMK CLI 工具來操作:
qmk new-keymap
如果沒有設定過鍵盤,必須指定鍵盤型號:
qmk new-keymap -kb <keyboard_name>
你將會看到類似的訊息:
Ψ <github_username> keymap directory created in: /home/me/qmk_firmware/keyboards/clueboard/66/rev3/keymaps/<github_username>
這是您 keymap.c
檔的位置。
實際案例
你可以用 -kb
來指定鍵盤的型號,用 -km
來指定新配置檔的名稱,QMK 會提示你要編譯時的指令:
$ qmk new-keymap -kb ergodash/rev1 -km h0003
Ψ h0003 keymap directory created in: /home/HaWay/qmk_firmware/keyboards/ergodash/rev1/keymaps/h0003
Ψ Compile a firmware with your new keymap by typing:
qmk compile -kb ergodash/rev1 -km h0003
編輯你的 keymap.c 檔
接者用您的文字編輯器,打開 keymap.c
檔,您就可以看到如下開頭的程式碼:
const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
這是虛擬鍵盤層的開始設定的地方,也是自訂配置的地方,您可以參考下列文件來設定:
- 基本的鍵盤代碼 (外連)
- 特殊的 Quantum 代碼
- ESC (外連)
- 滑鼠 (外連)
請小心編輯此檔案,每次做小部分變更比較容易找出問題,如果一次修改了很多程式碼,可能會造成編譯時除錯上的困難。
編譯鍵盤韌體
自訂你的鍵盤配置之後,接者就是編譯了。請開啟終端機視窗並輸入:
qmk compile
在沒有指定預設鍵盤的情況下,請用 -kb
與 -km
指定鍵盤與配置檔,請執行:
qmk compile -kb <keyboard> -km <keymap>
最後你應該會看到類似的訊息:
Linking: .build/planck_rev5_default.elf [OK]
Creating load file for flashing: .build/planck_rev5_default.hex [OK]
Copying planck_rev5_default.hex to qmk_firmware folder [OK]
Checking file size of planck_rev5_default.hex [OK]
* The firmware size is fine - 27312/28672 (95%, 1360 bytes free)