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

網頁版 https://hackmd.io/rynDz2RlJl https://www.ptt.cc/bbs/Key_Mou_Pad/M.1730829474.A.190.html 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" ] ] } } ▼ 這樣就能套用 Via 的鍵帽配色了。 https://imgur.com/fBfnpI0.jpg Vial 用的 uf2 檔就沒有另做測試了 疏漏之處還請各位補充及指正。 --