Vortex Hellcat/PC66 QMK json 除錯

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、螺絲螺柱包(多給的)。

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

▼ 另一盒是 DSA Hellcat 鍵帽,美規版本配置如下:

沒有 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://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 分頁

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

把110行(歐規版本則是116行)的 "a": 7, 這一整行刪掉再儲存,然後重新 Load 再連接就可以載入 Layout 了,如果 Layout 載入一半就卡住,那就關掉瀏覽器或是 Reload Via 的網頁再連接即可。

"a": 7,


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

{ "a": 4 },

▼ 載入後的 Via 畫面


▼ Via 左下角的 Lighting 選單,相關的設定沒有作用,也不會讀取鍵盤目前的燈效設定,要改燈效只能用實體按鍵按出來。

預設的燈效:

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

國外官網(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://cdn.shopify.com/s/files/1/0575/2278/2371/files/Hellcat_PC66_QMK_us1_via_JOSN_240605.json

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


▼ 如果要套用Via鍵帽配色,則要修正如下
Hellcat_US_via.json (非官方修正版)

{ "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 (非官方修正版)

{ "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" ] ] } }

▼ 這樣就能套用 Via 的鍵帽配色了。


Vial用的uf2檔就沒有另做測試了

疏漏之處還請各位補充及指正。



Select a repo