客制化鍵盤QMK固件入門-編譯環境搭建

2021-01-08 圓大頭說

客制化鍵盤，這是一個巨大的坑，形形色色的軸體、外殼、PCB、數據線、鍵帽、燈效、音效甚至掌託，對於熱愛DIY的玩家們來說，確實很吸引人，但再看看價格，只能打擾了。

T站上看到了一款主要零部件用3D列印的機械鍵盤（SICK68），列印外殼甚至鍵帽，不用PCB而是飛線，非常硬核，關鍵是價格，這應該算是除撿垃圾以外，最便宜的客制化機械鍵盤了。SICK68採用了QMK固件，擁有和大幾千的客制化鍵盤相同的核心，作為一隻程序汪，想要玩客制化鍵盤又玩不起，就只能著鍵盤的固件深入研究一番了。

簡介

QMK包含了一套高度可定製的工具集：QMK Firmware，QMK Configurator，QMK Toolbox。QMKFirmware是固件的原始碼；QMKConfigurator是在線配置鍵盤功能、生成固件的網絡客戶端；QMK_Toolbox是下載和調試固件時使用圖形界面工具。

通常來說，使用QMK_Configurator就可以生成市面上一些客制化鍵盤套件的固件了。但對於想要高度定製的同學，特別是給鍵盤添加便宜的藍牙模塊、oled屏、旋鈕等，就需要搭建編譯環境，自己修改代碼，自己編譯，這也是折騰的樂趣所在。

編譯QMK固件，首先需要搭建編譯環境，按照官網文檔一步步操作本應很輕鬆的。但得益於國內的網絡環境，在安裝編譯環境的過程中會遇到很多坑。

安裝msys2客戶端

Windows中使用開發環境，去官網下載免費的安裝包。

安裝則沒有什麼特別的，只需要設置一下安裝路徑，然後一直next就行。

更新軟體庫

按照官方文檔，安裝完成後需要更新MSYS2的軟體庫，最好先將MSYS2的源設置為清華大學的源。打開安裝路徑C:\msys64\etc\pacman.d中的配置文件

修改mirrorlist.msys，在最上面增加一行Server = https://mirrors.tuna.tsinghua.edu.cn/msys2/msys/$arch；

修改mirrorlist.mingw32，在最上面增加一行Server = https://mirrors.tuna.tsinghua.edu.cn/msys2/mingw/i686。

修改mirrorlist.mingw64，在最上面增加一行Server = https://mirrors.tuna.tsinghua.edu.cn/msys2/mingw/x86_64。

運行安裝路徑根目錄中的mingw64.exe。

輸入命令pacman -Syu更新。

中途按提示可能需要重啟該程序，再次執行該命令，等待更新完成。

然後安裝編譯qmk固件需要軟體，輸入命令pacman -S git mingw-w64-x86_64-toolchain mingw-w64-x86_64-python3-pip。

接著安裝python中的qmk庫，使用命令python3 -m pip install qmk -i https://pypi.tuna.tsinghua.edu.cn/simple從清華大學的pip源安裝。

需要的軟體安裝完了，最後輸入命令qmk setup。這一步會去下載qmk的固件源碼，沒有國內的源可以使用，速度比較慢，在網絡不佳時極可能因錯誤中斷，最好找個月黑風高的夜晚，消消地下完它。

編譯測試

輸入命令qmk compile -kb clueboard/66/rev3 -km default，如果能成功編譯完成，那麼編譯環境就算搭建完成了。

設置VSCode

在VSCode中點擊File->Open Floder打開之前下載的QMK固件。

下載文件，保存到qmk_firmware/.vscode/文件夾中

修改該文件中WIN32部分的"includePath"的頭文件路徑為自己電腦內的對應路徑，一些沒有的路徑，比如Visual Studio 2017等，直接刪除也不影響編譯，因為這裡的頭文件路徑只是提供給插件使用，方便文件解析的。

修改settings.json，添加以下代碼到文件中，

"terminal.integrated.shell.windows": "C:\\msys64\\usr\\bin\\bash.exe", "terminal.integrated.env.windows": { "MSYSTEM": "MINGW64", "CHERE_INVOKING": "1" }, "terminal.integrated.shellArgs.windows": [ "--login" ], "terminal.integrated.cursorStyle": "line",

將當前工程的終端設置為QMK使用的MSYS2。

設置完，VSCode會提示安裝插件等，都是為了方便瀏覽代碼的，安裝完重啟即可。然後就可以在vscode裡修改代碼，編譯固件了。

Ctrl+` 打開終端，可以看到進入了MSYS2終端，輸入qmk compile -kb clueboard/66/rev3 -km default測試一下編譯環境，一切正常。

相關焦點

  • 客制化鍵盤QMK固件入門-修改keyboard和keymap
    客制化鍵盤，這是一個巨大的坑，形形色色的軸體、外殼、PCB、數據線、鍵帽、燈效、音效甚至掌託，對於熱愛DIY的玩家們來說，確實很吸引人，但再看看價格，只能打擾了。作為一隻程序猿，想要玩客制化鍵盤又玩不起，就只能對著鍵盤的固件深入研究一番了。在我的前一篇文章中，一步步搭建起了QMK固件在Windows系統中的編譯環境，接下來就著手打造自己的鍵盤固件吧。
  • 價格親民的入門客制化鍵盤-GK61
    前言 自從用上了機械鍵盤，就再也回不去以前一把薄膜用好幾年的我了。從入手的第一把機械鍵盤到現在，陸陸續續也買了好多把了。基本常見的黑紅青茶全都體驗過了，但是用了一段時間線性軸後就回懷念線性軸的手感，換回線性軸就開始想念段落軸按下的爽快感，便想著有沒有一把鍵盤能同時讓我享受到線性軸和段落軸呢。問了問身邊的朋友得知自己可以客制化機械鍵盤來裝不同的軸進去用，客制化機械鍵盤一般是購買套件、軸體、鍵帽等。於是上了萬能的馬爸爸家搜了下，找到了一把我的家庭條件能夠支持得起的套件-GK61。
  • 機械鍵盤的終極命題:入門、客制化還是一步到位
    各位看官想討論軸體，這裡歡迎，但是噴櫻桃軸的，輕點 我是真的不懂，我只是個入門小白。經過一番查詢大概了解了一些品牌，入門級的ikbc、Ganss，中端的杜嘉、阿米洛，高端的大L（Leopold）、大F（Filco）。大F大L名聲在外，就不談了，而且當時覺得真的太貴了。在經過翻看張大媽各類評測與橫評文章後，最後選擇了Ganss紅軸作為我的第一把機械鍵盤。
  • 鍵盤收藏家的創造力 客制化Heavy Shell登陸中國市場
    在眾多客制化產品中，以「玩法」著稱的就不得不提到國外一枚優秀客制化設計公司i:C，其主筆的大咖設計師Jacob Alexander號稱收藏了600隻以上的珍藏鍵盤。一位可以為了鍵盤而搬家的男人，你覺得他能設計出怎樣的產品呢？有興趣？
  • CHERRY RGB軸客制化鍵盤——憶光GK64機械鍵盤體驗
    因此「客制化」鍵盤開始進入了大眾的視野。客制化，就是「定製化」的另一種翻譯，相當於「自定義」。也就是說你可以定製你喜歡的外殼、喜歡的顏色、喜歡的軸體、喜歡的燈光等等。既然是定製，那麼在價錢方面肯定必然是要比量產的品牌鍵盤要高啦！
  • TIME RE 客制化機械鍵盤套件
    TIME RE  數據及特色：結構形式：Top mount split plate（分體定位板）配列：無門牙/大門牙角度：5.7度PCB：typec 支持qmk購買方式：1.淘寶：Fox Lab緮置本段內容₴SdOb1ylDRXa₴打楷淘tao寳或掂擊煉接https://m.tb.cn/h.VrNLNN0 至瀏.覽覽.器【Fox Lab Time Reforged 客制化套件團購
  • 外設新寵:DIY客制化鍵盤
    為何DIY客制化鍵盤成為外設新寵？ 說起來客制化，其字面意思就是客戶定製的意思。由於客制化鍵盤的多樣性組合，使得玩家能根據個人的喜好設計製造出自己心目中最好的那塊鍵盤，給外設玩家提供的更多的可能。
  • 機械鍵盤不完全指北——我的客制化優聯鍵盤
    嚴格意義上說我對於機械鍵盤的了解還很初級（所以只能來做做入門科普和分享），自己也僅僅擁有兩把機械鍵盤——ikbc F104以及高斯ALT 61。不過後來能讓我暫時消停作死的原因是一把叫普拉斯（現更名為寧芝NIZ）的國產靜電容鍵盤，35克的觸發壓力，溫潤綿滑的手感，以及對比HHKB的低廉售價，用它打字真的是種享受。雖說無法接受它手感的人也不在少數，但手感這個事兒嘛，因人而異，在此不表了。
  • 高度客制化 iQunix F96 KAT逸白雙模機械鍵盤評測
    底部撐腳採用了客制化鍵盤中常見陽極鋁製金屬撐腳，與鍵盤外殼顏色保持一致，在使用時能夠與桌面形成8°夾角，更加符合人體工學設計，配合鍵帽弧度，能帶來很好的使用舒適感。撐腳頂部的黑色部分也能提供不錯的防滑效果。撐腳下方則是雙模切換的物理按鍵，廠商也貼心的使用英文進行了備註。鍵盤採用鍵線分離設計，接口設計在鍵盤的左上角的側面，並且採用內凹設計，接口連接後也能保持美觀。
  • 從入門到精通 機械鍵盤發燒不完全指南-入門,入坑,機械鍵盤,還能...
    在筆者來看，機械鍵盤近幾年的大火併不是一個偶然的現象。因為隨著PC硬體性能的逐年過剩和電競的興起，玩家們勢必會將注意力轉移到外設周邊這個曾經被忽略的陣地上來。而機械鍵盤又憑藉其更易於DIY的屬性成為玩家眼中的香餑餑。這次，筆者就從入門到高階為大家梳理一下機械鍵盤的發燒方向，希望能幫助剛剛上路的同學少走一點彎路。
  • 客制化登大舞臺 iqunix金屬小鍵盤試玩
    【IT168 評測】外設圈有一群人是專門玩定製的，定製各種鍵帽還有各種外殼，相比遊戲玩家，玩定製款的玩家更加注重鍵盤的手感方面，還有外觀的個性元素。於是淘寶上就又不少商家推出模塊化的定製服務，行內叫「客制」鍵盤。通過這些客制化的鍵盤零件，玩家就可以隨心所欲的DIY一把完全屬於自己風格的鍵盤了。
  • 客制化鍵盤配列
    一眨眼，從最早的為了給自己的量產鍵盤換上一套可可愛愛的鍵帽，到某魚翻到各種套件的毒圖，再到加入了好幾頁的客制化鍵盤群，然後一股腦的跟著衝衝衝買各種鍵帽、各種套件，已經過去兩年多了，從最早的小白「蛻變」成為了一根老韭菜，希望本帖可以為剛入圈想買套件不懂套件配列的的朋友節省一些時間成本40%配列（出鏡鍵盤摩根
  • 觀點|什麼是客制化鍵盤?萌新入坑簡單指南
    隨著電子競技的不斷發展，現在的許多遊戲玩家也開始注重起自己的遊戲體驗，而作為與遊戲體驗切身相關的，那就是平常使用的滑鼠鍵盤等外設了，而其中，鍵盤想必是許多遊戲玩家的第一把"武器"了。而入手了機械鍵盤遊戲鍵盤之後，想必可能有的小夥伴們開始聽到了"客制化"這個詞，於是乎又想要入坑客制化鍵盤，那麼什麼是客制化鍵盤呢？現在的客制化鍵盤圈子又怎麼樣呢？就讓小編這個剛入坑的小萌新幫你排排雷吧，注意，僅為個人觀點。首先是客制化（customize），其實它就是"定製化"的另一種稱呼，這個詞語本來是流行於港臺的。
  • 一入鍵坑深似海,怒喵科技客制化鍵盤NOWIRE品牌新品定價引熱議
    對於此前已經上線眾籌平臺的Cyberboard機械鍵盤，怒喵科技表示已經售罄。不過，該機械鍵盤價格引發了輿論的熱議，有許多網友表示定價過高。其實許多接觸過機械鍵盤的朋友都知道，機械鍵盤並不是一個廉價的產品，高品質的鍵盤價格破千並不是難事，大廠的鍵盤的旗艦款價格基本在1500元左右。
  • 「客制化鍵盤」L980改優聯熱插拔+PG電耗子+蒂芙尼V2潤軸
    轉自 Stefan 過去十年，一直在用量產機械鍵盤，跟很多人一樣，迷信櫻桃、雷蛇、海盜船，覺得他們就是最棒的。去年有了孩子，基本上和電腦無緣了，家裡的鍵盤也被孩子把鍵帽拆的七零八落的，每日和電腦接觸的時間基本上只剩下在公司上班的時間。
  • 作為量產機械鍵盤頂端的F與L,為啥只是某些客制化價格的零頭?
    作為量產機械鍵盤頂端的F與L，為啥只是某些客制化鍵盤價格的零頭？這也是為啥不直接叫鍵盤而是套件的原因，因為在出售時還沒有組成鍵盤。 而今天要討論的就是第二種客制化套件，也就是玩家們常說的高端套件。 二、客制化套件是怎麼來的？ 之前也說了，套件都是作者設計好了的。那問題來了，作者是誰？又怎麼出售呢？
  • 客制化元素多樣:2019特色鍵盤產品盤點
    CNC一體成型鋁合金底殼+VSA高度的PBT雙色注塑鍵帽也帶來了很強的客制化感覺，更有Vortexgear宏編程功能、配列切換、RGB燈光也大大增加了這款鍵盤的兼容性、可玩性。客制化的特殊設計隨著機械鍵盤市場的不斷擴大，用戶的需求也呈現出多樣化的態勢，廠商越來越注重產品的個性化元素，通過客制化的設計來搶佔更多的市場。
  • 前魅族李楠首款創業新品眾籌上線 客制化鍵盤將要出爐
    不過，現在有網友在Angry Miao官網發現了一款定價3799元的高端鍵盤。雖然目前該連結已被撤下，但也正式曝光了其接下來將推出的產品。其實，目前這款高端鍵盤產品已經正式上線了眾籌平臺indiegogo，且一分鐘就完成了眾籌目標。
  • 自定義鍵盤 FMJ與GH60圖賞
    作為一個機械鍵盤發燒友，客制化一把鍵盤似乎成為最終的目標了。此前曾經打算製作一把韓國KMAC的，但得知FMJ已經是最後一批生產，所有就入手了。上圖整體為FMJ方案二與GH60，鍵帽為iKBC白透鍵帽。自從國外GH60開源後，國內如同打了雞血一樣，不同的作者推出不同的顏色版本的GH60 PCB，在固件、工藝、裝配上比原版還誇張。
  • 有客制化那內味了,GANSS ALT83G機械鍵盤曬物
    現在隨著機械鍵盤越來越多的客制化玩法，以前小眾的客制化配列都逐漸的成為了機械鍵盤的主流，受到越來越多的年輕玩家的青睞，個性化的需求一直以來都是彰顯個人獨特風格。