Mac で QMK firmware のビルド環境を構築してみた
Keyball39 を組み立てて動かせたものの, ファームウェア書き換えを以外に解決方法のない問題に遭遇, QMK firmware のビルド環境を構築する必要がありました.
本記事では, 自作キーボード初心者が M2 Macbook Air (Mac OS Sonoma) で QMK firmware のビルド環境を構築した際, 詰まった点をご紹介します.
まずは先人のお知恵を拝借
最も参考にさせていただいたのはこちらの記事. この通りに進めて途中で詰まることがなければ, 本記事は読む必要がないかもしれません… それほどわかりやすく簡潔にまとめられています.
途中で詰まった箇所
Homebrew のインストール
公式ホームページに記載された下記のコマンドを実行しただけでは, brew を使えるようになりませんでした.
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
terminal 上の表示をよく見ると, なにやら追加のコマンド実行が必要そうな文言を発見.
Warning: /opt/homebrew/bin is not in your PATH.
Instructions on how to configure your shell for Homebrew
can be found in the 'Next steps' section below.
==> Installation successful!
:
:
==> Next steps:
- Run these two commands in your terminal to add Homebrew to your PATH:
(echo; echo 'eval "$(/opt/homebrew/bin/brew shellenv)"') >> /Users/daimaru/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"
- Run brew help to get started
- Further documentation:
https://docs.brew.sh
その通りに 2 つのコマンドを実行すると確かに brew が使えるようになり, 無事に git と qmk_firmware をインストールできました.
terminal 上の情報見落とし, ダメゼッタイ.
qmk_firmware のクローン
なぜか github から qmk_firmware のクローンができなかったため, QMK firmware 公式ドキュメントを参考にセットアップを試みました.
デフォルトでは ~/ に home folder を作られてしまうのが嫌だったため, 下記の通りにあらかじめ作っておいたディレクトリを指定しました.
qmk setup -H ~/Projects
.hex ファイルの生成場所探し
その後も先人のお導きによって着実にセットアップが進み, コンパイルが成功したまではよかったのですが, 肝心の生成物がどこにあるのかわからず探し回ることに…
ここでも答えを授けてくれたのは terminal 上の情報でした.
Linking: .build/keyball_keyball39_via.elf [OK]
Creating load file for flashing: .build/keyball_keyball39_via.hex [OK]
Copying keyball_keyball39_via.hex to qmk_firmware folder [OK]
Checking file size of keyball_keyball39_via.hex [OK]
* The firmware size is fine - 26682/28672 (93%, 1990 bytes free)
はい, qmk_firmware フォルダにコピーしたとガッツリ書いてあります.
terminal 上の情報見落とし, ダメゼッタイ.
この記事は Keyball39 で書きました.