QMK Userspace (7skb カスタム構成)

このリポジトリは、QMK本体をサブモジュールとして保持し、独自のキーマップを管理するための環境です。

1. 開発環境のセットアップ

CLIのインストール (macOS)

brew install qmk/qmk/qmk

リポジトリの準備と初期化

このリポジトリをクローンした後、以下のコマンドでQMK本体を展開し、パスを設定します。

# サブモジュールの展開
git submodule update --init --recursive

# QMK CLIの設定（ディレクトリの紐付け）
qmk config user.qmk_home=$(realpath external/qmk_firmware)
qmk config user.overlay_dir=$(realpath .)

# ビルド環境の依存関係をインストール
qmk setup

2. ビルド方法

ローカルでビルドする

qmk compile -kb salicylic_acid3/7skb -km svmv2

書き込み (Flash)

手元の環境ではCLIコマンド(qmk flash)はProMicroの書き込み待機状態への遷移を検知できなかったのでQMK Toolboxを使ってください。

3. トラブルシューティング

qmk doctor で ARM GCC のエラーが出る場合

arm-none-eabi-gcc のテストコンパイルに失敗し、Major problems detected と表示されることがあります。

• 7skb (AVR系) の場合: Successfully compiled using avr-gcc と出ていれば、ARMのエラーが出ていても無視して 7skb のビルドは可能です。

• RP2040等のARMボードを使う場合: HomebrewでインストールされたGCCのバージョンが新しすぎることが原因です。以下のコマンドで、安定版のツールチェーン（Cask版）に入れ替えることで解消します。

  brew uninstall arm-none-eabi-gcc
  brew install --cask gcc-arm-embedded

⚠ QMK home does not appear to be a Git repository!

external/qmk_firmware が Git サブモジュールであるために出る警告ですが、動作に影響はありません。無視して進めて問題ありません。