2022.12.06

  • 自作キーボード

QMK環境を作る(M1 mac)

ゴリゴリにQMKで遊ぼうと思って、環境を新しく作りました。メモを残しておきます。

m1 mac、Monterey(12.3.1)です。
Homebrewはインストール済みのところから開始です。

brewでqmkインストール

brew install qmk/qmk/qmk

めっちゃqmk続くのがちょっとツボに入ってしまった。最後のqmkはフォーミュラの指定なんですね、これ。
https://github.com/qmk/homebrew-qmk

インストール終了までの間、ご飯とか食べると良いと思います。そのくらい待ちます。

ログを確認して修正、調整

さて、インストールできたのでざっとログを見ます。
気になったところを抜粋。

Command Line Tools

Warning: A newer Command Line Tools release is available.
Update them from Software Update in System Preferences.
If that doesn't show you any updates, run:
sudo rm -rf /Library/Developer/CommandLineTools
sudo xcode-select --install

新しいCommand Line Toolsがあるらしい。
システム環境設定から or コマンドでインストール。

pillowのシンボリックリンク

Error: The `brew link` step did not complete successfully
The formula built, but is not symlinked into /opt/homebrew
Could not symlink lib/python3.9/site-packages/PIL/BdfFontFile.py
Target /opt/homebrew/lib/python3.9/site-packages/PIL/BdfFontFile.py
already exists. You may want to remove it:

rm /opt/homebrew/lib/python3.9/site-packages/PIL/BdfFontFile.py

To force the link and overwrite all conflicting files:
brew link --overwrite pillow

To list all files that would be deleted:
brew link --overwrite --dry-run pillow

既に存在するのでシンボリックリンクが貼れない?
とりあえずrm。そして`brew link --overwrite pillow`

Linking /opt/homebrew/Cellar/pillow/9.3.0_1... 321 symlinks created.

大丈夫っぽい?
brew linkした一覧はbrew --prefixで表示されるパス下のbinにあるはずなんだけど、それっぽいものが追加されたように見えない?
とりあえず一旦これで進む。

QMK環境を作る

QMK Firmware has been installed but your environment may not have been setup yet. Please set it up now:
qmk setup
If you have a fork already you can specify it like this:
qmk setup <username>/qmk_firmware
This will create qmk_firmware in your home directory. If you'd like to change this location, use the -H flag as well:
qmk setup -H /your/preferred/path

新しいCommand Line Toolsがあるらしい。
システム環境設定から or コマンドでインストール。

QMK の作業ディレクトリの準備がまだなら作ろうか。ということかな? 示された選択肢は2つ。後者で行こうと思います。

  • qmk setup =>GitHubからCloneする
  • qmk setup 【GitHubのユーザー名】/qmk_firmware =>GitHubからFolkをClone

ホームとは別の場所に環境を作りたいので、

qmk setup -H /Users/【hoge】/【huga】/qmk_firmware

パスの最後は`qmk_firmware`で終わらないといけないようです。
このままqmk/qmk_firmwareをcloneするか聞かれるけど断ります。

GitHubでqmkをFolkしてから、こちらのコマンドを。

qmk setup 【GitHubのユーザー名】/qmk_firmware

多分、リポジトリが存在しなければFalkしてくれて、それからCloneします。
ただし、ID、Password認証が通るのであれば。
私は2段階認証をONにしているためか通りませんでした!
ということで、サイトでFolkリポジトリを作っておいてからCloneしました。

Can't find arm-none-eabi-gcc in your path.
Can't find avr-gcc in your path.
Would you like to install dependencies? [Y/n] y

依存関係の何かが足りないらしいですね。
yでインストールしてもらいます。

ログを追う

無事終わったところでまたログを追っていきます。

Warning: qmk/qmk/qmk 1.1.1 is already installed and up-to-date.
To reinstall 1.1.1, run:
brew reinstall qmk

をや。
qmk/qmk/qmkをインストールしようとしてくれたらしい。
ということは、いきなりqmk setupから始めてもよかったのかも。

あとはavr-gccとかarm-gccとかにパスを通したかったら通しな、って言われてたので通しました。

動作確認

さて、環境ができたところで軽く動作確認してみたいと思います。
公式のサンプルに倣って、Clueboard 66%のファームをコンパイルしてみることにします。
https://docs.qmk.fm/#/newbs_getting_started?id=_4-test-your-build-environment

qmk_firmwareディレクトリに移動して、下記コマンドを叩きます。

qmk compile -kb clueboard/66/rev3 -km default

.buildディレクトリを確認するとclueboard_66_rev3_default.hexファイルが生成されています。
ということは動作問題なさそう。


次は「新しいキーボード用のファームを作る」篇がきっと近いうちに公開される。はず。