fbpx

QMK 自訂鍵盤配置

使用支援 QMK 的鍵盤可以自訂鍵盤的配置,非常方便。

上一篇:新版 QMK 教學

建立你自己的鍵盤韌體

在你完成上一步的環境設定之後,接者就可以自訂鍵盤配置。接下來分為三個步驟。

建立新的配置檔 (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] = {

這是虛擬鍵盤層的開始設定的地方,也是自訂配置的地方,您可以參考下列文件來設定:

請小心編輯此檔案,每次做小部分變更比較容易找出問題,如果一次修改了很多程式碼,可能會造成編譯時除錯上的困難。

編譯鍵盤韌體

自訂你的鍵盤配置之後,接者就是編譯了。請開啟終端機視窗並輸入:

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)

下一步:燒錄韌體

Show CommentsClose Comments

Leave a comment