作者pinkb (b)
看板Key_Mou_Pad
標題[鍵盤] Vortex Hellcat/PC66 QMK json 除錯
時間Wed Nov 6 01:57:44 2024
網頁版
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 檔就沒有另做測試了
疏漏之處還請各位補充及指正。
--
推 afuu: 謝謝分享 11/06 08:21
※ 編輯: pinkb (111.243.6.173 臺灣), 11/06/2024 16:06:30
推 ediward: 看不懂 但是推 11/06 22:22
推 Edge5566: 推一個 11/10 16:00