[鍵盤] Vortex Hellcat/PC66 QMK json 除錯

pinkb 發表於 2024/11/6 上午1:57:44

看板Key_Mou_Pad標題[鍵盤] Vortex Hellcat/PC66 QMK json 除錯作者

(b)時間Nov 6 01:57:44 2024推噓 1 推:1 噓:0 →:0

Hellcat 是 65% 噴砂壓克力船殼結構(Tray Mount)的 RGB 鍵盤，有含軸的成品鍵盤，
也有不含軸的套件版本(含DSA鍵帽&衛星軸)。船殼結構可以避免 Gasket Mount
定位版的固定點，或是 Top Mount 的鎖孔露出在半透殼正面影響質感，同時利用定位
板矽膠墊有效減少船殼結構常遇到支撐處和邊緣打感不一的問題。

主板延用非三模版本的 PC66 QMK，雖然寫支援 Via/Vial/QMK，
但只有 Vial https://vial.rocks 可以直接使用，不用折騰。

Via 部分因為目前官網下載的 json 檔都要除錯之後才能載入改鍵，
對沒有除錯能力的入門使用者來說不太友好，喜歡折騰的再往下看。

QMK 部分若是使用 QMK Configurator https://config.qmk.fm/
也搜尋不到能對應的鍵盤型號，所以也用不了。

▼ 內容物共兩盒，一盒是鍵盤，包含外紙盒(未入鏡)、攜行箱(未入鏡)、
鍵盤本體(已組)、保固卡、貼紙x3、螺絲螺柱包(應該是多給的)。
https://imgur.com/6slJWLd.jpg

未組套件的開箱，可以參考 Oliver Granlund 的開箱。
https://olli.works/post/vortex-hellcat-keyboard-review-sponsored/

▼ 另一盒是 DSA Hellcat 鍵帽，美規版本配置如下：
https://imgur.com/sSWl8ZO.jpg

沒有 Del 和 Fn，Fn 可使用 PN 或是個性來替代，
美規版本也沒有歐規版本需要的鍵帽。
6.25u 空白鍵微彎，對打感沒什麼影響。
有鍵帽盒可以收納換下來的鍵帽，算是還不錯的。

測試觸發

測試觸發其實用線上鍵盤測試網站就好，
不過還是用 Via 官網 https://via.evove.top/ 來測。
接線後能辨識出和 PC66 QMK 一樣的 M77_US_1 ，但是配置沒有自動載入，
要手動載入 json 檔。先點選上排選單左邊第二個圖示 KEY TESTER 測試觸發。
方向上的右邊和右 Alt 右邊的這兩個鍵應該是切層，所以單獨按不會觸發，
要使用組合鍵像是 Fn+1 來測試。

json 除錯

官網json檔下載位置：左上角選單 → 技術支援 → VIA ViaL Json&更新檔
Hellcat DIY KIT (VIA 適用版本: 1.3.1)

縮網址
https://tinyurl.com/yu2atdud

https://cdn.shopify.com/s/files/1/0653/2812/0033/files/
Hellcat_Via_Json_files.zip

解壓之後會有兩個檔(不能通用)
Hellcat_ISO_via.json (歐規)
Hellcat_US_via.json (美規，可和 PC66 QMK 通用)

點選 Design 分頁(上排左邊第三個圖示)，因為使用到 lighting 相關燈效參數，
所以需要勾選 V2 Definitions，如果沒有勾選 Use V2 Definitions 就直接
Load Draft Definition 載入解壓縮的 Json 檔，會出現錯誤訊息：

Hellcat_US_via.json Object: should NOT have additional properties

勾選 Use V2 Definitions (deprecated) 再 Load Draft Definition
解壓縮的 Json 檔，則會出現另ㄧ個錯誤訊息：

Error: `Row,col` pairs must be placed in the top-left legend in
the KLE keymap provided in definition

大意是 json 檔裡面有格式上的語法錯誤，用文字編輯軟體打開 json 檔，
把 9-123 行貼到 KLE (https://www.keyboard-layout-editor.com/) 的
Raw Data 分頁。

https://imgur.com/CPAAOY7.png

錯誤原因為空白鍵的矩陣 "4,7" 在格式設到居中("a": 7)，以致於無法正常
讀取，必須改回預設的左上角。

把110行(歐規版本則是116行)的

"a": 7,

這一整行刪掉再儲存，然後重新 Load 再連接就可以載入 Layout 了，
如果 Layout 載入一半就卡住，那就關掉瀏覽器或是 Reload Via 的
網頁再連接即可。

114-116行(歐規版本則是120-122行)為還原左上角的設定，可刪可不刪，建議順手刪。

{
"a": 4
},

▼ 載入後的 Via 畫面
https://imgur.com/QjjJfG6.jpg

▼ Via 左下角的 Lighting 選單，相關的設定沒有作用，
也不會讀取鍵盤目前的燈效設定，要改燈效只能用實體按鍵按出來。
https://imgur.com/WeIYmnK.jpg

預設的燈效：

Fn + E = 開關燈 RGB Toggle
Fn + R = 燈效切換 RGB Mode+
Fn + T = 軸燈/底燈/軸燈+底燈切換 0x5DB1
Fn + 上 / Fn + 下 = Sat+ / Sat- 調整飽和度
Fn + 左 / Fn + 右 = Hue+ / Hue- 調整色相
Fn + PageUp = Brght+ 增加亮度
Fn + PageDown = Brght- 減少亮度

國外官網(https://vortexgear.store) 找到一個2024.06.05版本的 json，
據說是能解決這個無法設定燈效的問題

Latest firmware release notes - 2024.06.05 :
Fixed the issue of not be able to control the light settings through VIA
(ANSI layout only)

縮網址：
https://tinyurl.com/bdhbv9bd

https://cdn.shopify.com/s/files/1/0575/2278/2371/files/
Hellcat_PC66_QMK_us1_via_JOSN_240605.json

但實際上也有語法錯誤無法正常載入的問題，修正語法的錯誤之後，
一樣無法從選單來設定燈效。

改用 Vial (https://vial.rocks) 也是一樣無法從選單來設定燈效。

▼ 如果要套用Via鍵帽配色，則要修正如下
Hellcat_US_via.json (非官方修正版)
https://imgur.com/gtyogfa.png

{
"name": "M77_US1",
"vendorId": "0xEB88",
"productId": "0x0014",
"lighting": "qmk_rgblight",
"matrix": {"rows": 5, "cols": 15},
"layouts": {
"keymap": [

[
{"c": "#777777"},
"0,0",
{"c": "#cccccc"},
"0,1",
"0,2",
"0,3",
"0,4",
"0,5",
"0,6",
"0,7",
"0,8",
"0,9",
"0,10",
"0,11",
"0,12",
{"c": "#aaaaaa","w": 2},
"0,13",
"0,14"
],

[
{"w": 1.5},
"1,0",
{"c": "#cccccc"},
"1,1",
"1,2",
"1,3",
"1,4",
"1,5",
"1,6",
"1,7",
"1,8",
"1,9",
"1,10",
"1,11",
"1,12",
{"w": 1.5},
"1,13",
{"c": "#aaaaaa"},
"1,14"
],

[
{"w": 1.75},
"2,0",
{"c": "#cccccc"},
"2,1",
"2,2",
"2,3",
"2,4",
"2,5",
"2,6",
"2,7",
"2,8",
"2,9",
"2,10",
"2,11",
{"c": "#777777","w": 2.25},
"2,13",
{"c": "#aaaaaa"},
"2,14"
],

[
{"w": 2.25},
"3,0",
{"c": "#cccccc"},
"3,2",
"3,3",
"3,4",
"3,5",
"3,6",
"3,7",
"3,8",
"3,9",
"3,10",
"3,11",
{"c": "#aaaaaa","w": 1.75},
"3,12",
"3,13",
"3,14"
],

[
{"w": 1.25},
"4,0",
{"w": 1.25},
"4,1",
{"w": 1.25},
"4,2",
{"c": "#cccccc","w": 6.25},
"4,7",
{"c": "#aaaaaa"},
"4,9",
"4,10",
"4,11",
"4,12",
"4,13",
"4,14"
]
]
}
}

Hellcat_ISO_via.json (非官方修正版)
https://imgur.com/C1Iz8rZ.png

{
"name": "M77_EU1",
"vendorId": "0xEB88",
"productId": "0x0012",
"lighting": "qmk_rgblight",
"matrix": {"rows": 5, "cols": 15},
"layouts": {
"keymap": [

[
{"c": "#777777"},
"0,0",
{"c": "#cccccc"},
"0,1",
"0,2",
"0,3",
"0,4",
"0,5",
"0,6",
"0,7",
"0,8",
"0,9",
"0,10",
"0,11",
"0,12",
{"c": "#aaaaaa","w": 2},
"0,13",
"0,14"
],

[
{"w": 1.5},
"1,0",
{"c": "#cccccc"},
"1,1",
"1,2",
"1,3",
"1,4",
"1,5",
"1,6",
"1,7",
"1,8",
"1,9",
"1,10",
"1,11",
"1,12",
{"c": "#777777","x": 0.25,"w": 1.25,"h": 2,"w2": 1.5,
"h2": 1,"x2": -0.25},
"1,13",
{"c": "#aaaaaa"},
"1,14"
],

[
{"w": 1.75},
"2,0",
{"c": "#cccccc"},
"2,1",
"2,2",
"2,3",
"2,4",
"2,5",
"2,6",
"2,7",
"2,8",
"2,9",
"2,10",
"2,11",
"2,12",
{"c": "#aaaaaa","x": 1.25},
"2,14"
],

[
{"w": 1.25},
"3,0",
{"c": "#cccccc"},
"3,1",
"3,2",
"3,3",
"3,4",
"3,5",
"3,6",
"3,7",
"3,8",
"3,9",
"3,10",
"3,11",
{"c": "#aaaaaa","w": 1.75},
"3,12",
"3,13",
"3,14"
],

[
{"w": 1.25},
"4,0",
{"w": 1.25},
"4,1",
{"w": 1.25},
"4,2",
{"c": "#cccccc","w": 6.25},
"4,7",
{"c": "#aaaaaa"},
"4,9",
"4,10",
"4,11",
"4,12",
"4,13",
"4,14"
]
]
}
}