https://alpaca-lab.blog/ja/tags/keyboard/Recent content in Keyboard on alpaca-lab.blogHugo -- 0.156.0jaFri, 18 Sep 2026 00:00:00 +0000https://alpaca-lab.blog/ja/posts/single-key-zmk-poc/Fri, 18 Sep 2026 00:00:00 +0000https://alpaca-lab.blog/ja/posts/single-key-zmk-poc/<h2 id="これはなに">これはなに</h2> <p>現在愛用中の自作キーボードは、Pro Micro + QMK Firmwareという定番構成の有線キーボードなのですが、これの完全無線化バージョンを作りたいと思い立ちまして、手始めにXIAO nRF52840と<a href="https://zmk.dev/">ZMK</a>に触ってみることにしました。</p> <p>まずは最小構成で「ZMKの設定リポジトリ作成 → ビルド → 書き込み → Bluetooth接続」までの一連の流れを体験してみたので、この記事ではその内容を共有します。</p> <p>用意したのはスイッチ1個だけです。ハンダ付けもブレッドボードも使わず、マイコンのパッドにICテストフックを挟むだけの配線にしました。PoCが終わったあとも、パーツを元の状態に戻しやすくするためです。</p> <h2 id="ハードウェア構成">ハードウェア構成</h2> <ul> <li>マイコン: <a href="https://wiki.seeedstudio.com/XIAO_BLE/">Seeed Studio XIAO nRF52840</a></li> <li>スイッチ: Cherry MX互換のキースイッチ1個</li> <li>配線: XIAO本体のパッドにICテストフック（グラバー）を直接クランプし、スイッチの端子へ2本だけ配線 <ul> <li><code>D0</code>（<code>P0.02</code>） → スイッチの一方の端子</li> <li><code>GND</code> → スイッチのもう一方の端子</li> </ul> </li> <li>外付けのプルアップ抵抗はなし。GPIOの内部プルアップに依存</li> <li>電源: USB-C給電（モバイルバッテリー）</li> </ul> <p>配線はこんな感じです。</p> <p><img alt="XIAO nRF52840とキースイッチの配線" loading="lazy" src="https://alpaca-lab.blog/images/single-key-zmk-poc-01.jpg"></p> <p>ハンダ付けなしで気軽に試せるように、モバイルバッテリーからUSB-C給電しつつ動かしました。キーキャップには実際に送信するキーコードと同じ「A」を貼っています。</p> <p><img alt="モバイルバッテリー給電でのセットアップ全体" loading="lazy" src="https://alpaca-lab.blog/images/single-key-zmk-poc-02.jpg"></p> <h2 id="zmk設定リポジトリを作る">ZMK設定リポジトリを作る</h2> <p>ZMKには公式の<a href="https://github.com/zmkfirmware/zmk-cli">ZMK CLI</a>（<code>uv tool install zmk</code>→<code>zmk init</code>）が用意されていて、対話的にGitHubリポジトリの作成までできるようです。ただ今回は、生成される構成をきちんと理解したかったので、ZMK公式の<a href="https://github.com/zmkfirmware/unified-zmk-config-template">unified-zmk-config-template</a>をベースに、必要なファイルを手で組み立てました。</p> <p>最終的にできたリポジトリはこちらです。</p> <ul> <li><a href="https://github.com/hhiroshell/zmk-config">hhiroshell/zmk-config</a></li> </ul> <p>ディレクトリ構成は次のようになりました。</p> <pre tabindex="0"><code>zmk-config/ ├── .github/workflows/build.yml # ZMK公式の再利用可能workflowを呼ぶだけ ├── boards/shields/single_key/ # 自作シールド本体 │ ├── Kconfig.shield │ ├── Kconfig.defconfig │ ├── single_key.overlay # ハードウェア定義（kscan / GPIO） │ ├── single_key.keymap # キーコード │ └── single_key.conf ├── build.yaml # ビルドマトリクス（board + shield の組み合わせ） ├── config/west.yml # ZMK本体を取得するmanifest └── zephyr/module.yml # このリポジトリをboard/shieldの検索パスに登録 </code></pre><p>ポイントは<code>zephyr/module.yml</code>です。</p>