キー配列セットアップ

必要なもの

• GitHub アカウント
• ZEN 本体
• 対応コントローラ（左右）
• データ通信対応の USB Type-C ケーブル
• Mac / PC

リポジトリを fork する

fork は、このファームウェア設定を自分の GitHub アカウントにコピーする操作です。キー配置を自分用に編集するため、まず fork を作成します。

1. E24-GH/zen-firmware を開きます。
2. 画面右上の Fork を押し、Create a new fork を選びます。
3. Owner に自分の GitHub アカウントを選びます。
4. Repository name は通常そのまま zen-firmware で構いません。
5. Copy the main branch only は ON のままにします。
6. Create fork を押します。

Keymap Editor にログインする

Keymap Editor を使うと、ブラウザ上でキー配置を編集できます。初回は GitHub ログインと認証が必要です。

1. Keymap Editor を開きます。
2. Login with GitHub を押します。
3. 認証画面が出たら Authorize を押します。

fork したリポジトリを追加する

1. Keymap Editor で Add Repository が表示されたら押します。
2. GitHub App のインストール画面で、Only select repositories を選びます。
3. 自分が fork した zen-firmware だけを選び、Install を押します。
4. Keymap Editor に戻ったら、Source を GitHub にして自分の zen-firmware を開きます。
5. config/keymap.keymap が読み込まれ、ZEN のレイアウトが表示されれば OK です。

キー配置を編集して保存する

1. Keymap Editor 上でキーを変更します。
2. 変更が終わったら Save を押します。
3. 保存すると、自分の fork した GitHub リポジトリに変更が反映されます。

保存後、GitHub Actions が自動でファームウェアを build します。ダウンロードは次の手順で GitHub Actions 画面から行います。

GitHub Actions でファームウェアを作る

1. 自分の zen-firmware リポジトリを開きます。
2. Actions タブを開きます。
3. 初回だけ、Actions を有効化するボタンが出る場合があります。その場合は有効化します。
4. 最新の build を開きます。
5. build が完了したら、図の赤枠のダウンロードボタンを押します。

ダウンロードした zip ファイルの中には、以下の UF2 ファイルが入っています。

• settings_reset-bmp_boost-zmk.uf2リセット用
• zen_right_trackball_pmw3610_central.uf2右手用（トラックボール側）
• zen_left_peripheral.uf2左手用

その他、カスタマイズ用のファームウェア

• zen_right_trackball_paw3222_central.uf2トラックボールのセンサー PAW3222 用
• zen_right_trackpad_central.uf2トラックパッド用

ファームウェアを書き込む

通常の書き込み

1. 右手側の対応コントローラをブートローダーモードにします。
2. zen_right_trackball_pmw3610_central.uf2 を書き込みます。
3. 左手側の対応コントローラをブートローダーモードにします。
4. zen_left_peripheral.uf2 を書き込みます。

接続がうまくいかない場合

1. Mac / PC の接続設定から ZEN を削除します。
2. settings_reset-bmp_boost-zmk.uf2 を書き込みます。
3. USB を外します。
4. ZEN の電源を入れます。
5. もう一度、通常ファームウェアを書き込みます。
6. Mac / PC の接続設定から ZEN を接続します。

困ったとき