SeaGlass Build Guide

1. 準備

制作を始める前に、まずは必要なものがすべて揃っていることをご確認ください。

1-1. 同梱品チェック

同梱品に不足がある場合は、お手数ですがご連絡いただけますと幸いです。
迅速に対応させていただきます。

1-2. 組立前にお客様自身で準備いただく部品

SeaGlassのバッテリーは以下のバッテリーサイズを基準に設計していますので、こちらの購入をおすすめします。
これ以外のバッテリーを使用する場合、コネクタの大きさ(JST 1.25mm)と極性に十分注意しお選びください。極性が逆のバッテリーを接続してしまうとマイコンが故障します。

500mAh 602040 2個入

https://www.amazon.co.jp/dp/B0FBWJFCLB/?coliid=I3BOB6AZA0OG7C

1-3. 必要な工具

組み立てには下記の工具が必要です。

1-4. 組付け済部品の分解

梱包時に組付けられた状態になっている部品がいくつかあります。
組み立てを行う前に、一度それらを分解してください。半組み立てキット場合の説明を記載していますが、お手元のキットの形態に応じて適宜読み替えてください。

1. 背面のネジを４本外し、底面ケースを取り外します。
2. 基板とトッププレートを取り外します。半組み立てキットの場合マイコンがケースと干渉するため基板を斜めに持ち上げるように取り外してください。
3. （左手側のみ）ロータリーエンコーダが刺さっているので取り外します。ホイールパーツを軸から取り外します。軸はロータリーエンコーダに刺さったままにしておいて大丈夫です。
4. （右手側のみ）トラックボール読み取り基板を取り外します。ぐりぐりと引っ張ると抜けます。
5. トッププレートにキーキャップマウント用のパーツがついているので取り外します。
6. キーキャップマウントからキーキャップを取り外します。ドライバーやピンセットなどで裏側から軸を押し出すと外しやすいと思います。キーキャップマウントはもう使わないので処分して大丈夫です。

2. はんだ付け手順

ここからはんだ付け作業に入ります。
特に断りがない作業は左右どちらの基板でも同じ作業をすると読み取ってください。

はんだ付けが少しやりやすくなる治具を用意したので、３Dプリンターをお持ちの方は以下からSTLをダウンロードし出力して使用してみてください。（出力品の販売などは行っておりません）
ダウンロード

治具を使用しない場合はマスキングテープなどで基板や部品がずれないように適宜固定しながらはんだ付けを行うことをおすすめします。

2-1. マイコンのはんだ付け

※ 半組み立てキットではこの工程は対応不要です！
※ 最難関の工程となるので気合を入れて挑んでください！

1. 画像のようにピンヘッダを片側に差し込みマイコンを固定します。基板の裏表を間違えないよう注意してください。
2. はんだがブリッジしないよう注意しながらはんだ付けを行ってください。この際、右手側基板については必ずマイコン側面のランドにのみはんだ付けを行うようにし、スルーホール部分にはんだが乗らないように注意してください。画像2枚目のようになればOKです。
3. ピンヘッダを取り外し、反対側も同様にはんだ付けを行います。もしはんだがブリッジしてしまった場合は、画像のようにはんだ吸い取り線を用いることでブリッジを解消することができます。画像3枚目のようになればOKです。
4. （右手側基板のみ）トラックボール読み取り基板接続用のピンソケットをはんだ付けします。画像の場所にピンソケットを差し込み、基板の表側からはんだ付けを行ってください。
5. マイコン裏側のBAT+とRSTをはんだ付けします。画像のようになればOKです。後ほどの動作確認時にバッテリーを接続しても認識されなかったりリセットボタンを押しても反応しない場合はここのはんだ付けがうまくいっているか確認してみてください。

2-2. 右手マウスクリックボタンのはんだ付け

右手側基板にマウスクリックボタンを取り付けます。

1. マウスクリックボタンを基板の表面に置きます。スイッチ部分が上側になるように配置してください。
2. 片側の足をはんだ付けします。パッドまではんだがしっかり流れるよう十分に加熱してください。
3. ズレや浮きがないことを確認したら反対側の足もはんだ付けします。
4. 画像のようになればOKです。

2-3. 左手ロータリーエンコーダのはんだ付け

左手側基板にロータリーエンコーダを取り付けます。

1. ロータリーエンコーダを基板の表面から差し込みます。ホイール部品は邪魔になるので外しておいてください。（軸は刺したままで大丈夫です。）
2. 基板を裏返し、はみ出した足をニッパーでカットしてください。
3. ロータリーエンコーダが浮いたり傾かないように注意しながらはんだ付けしてください。
4. 画像のようになればOKです。
5. （テスター頒布版のみ）ロータリーエンコーダがチャタリングを起こす場合は画像のように真ん中のピンと左右のピンをつなぐようにコンデンサを追加することでチャタリングを低減することができます。(応急処置なのではんだ付けが汚くてすみません。)
   コンデンサは10nFか22nF推奨です。本頒布版では基板に組み込むので本対応は不要です！

2-4. 左右共通・電源スイッチはんだ付け

左右両方の基板に電源スイッチを取り付けます。

1. スライドスイッチを基板の表面から差し込み、マスキングテープなどで固定してください。
2. 基板を裏返し、はみ出した足をニッパーでカットしてください。
3. スライドスイッチが浮かないように注意しながらはんだ付けします。
4. 画像のようになればOKです。

2-5. 左右共通・キーソケットはんだ付け

左右両方の基板にキーソケットを取り付けます。左右各20個、合計40個のキーソケットが必要です。

1. キーソケットのフットプリントの片側にはんだを盛ります。
2. フットプリントの形と合うようにキーソケットを置いてください。
3. キーソケットをピンセットなどで抑えながら盛ったはんだを溶かしてください。
4. キーソケットが固定できたら、反対側にもはんだ付けを行ってください。

2-6. トラックボールセンサー接続用ピンヘッダはんだ付け

Comming soon...
※ 半組み立てキットではこの工程は対応不要です！
※ 現行ロットでは組み立てキットでもこの工程は対応不要です！

2-7. トラックボールセンサーはんだ付け

トラックボール読み取りセンサーを基板に取り付けます。

1. 半組み立てキットの場合、トラックボール基板にピンをはんだ付け済みで、右手側基板のソケットの差し込み済の状態になっています。センサーのはんだ付けのため、メイン基板からトラックボール基板を引き抜いてください。
2. センサーを基板に差し込みます。画像を参考に、向きを間違えないようにしてください。
3. センサーをマスキングテープなどで固定してください。
4. すべてのピンにはんだ付けをします。はんだを盛りすぎない・長時間熱しすぎないように注意してください。
5. 画像のようになればOKです。

2-8. トラボレンズ固定

トラックボールセンサー用レンズを取り付けます。

1. センサーの保護シールを剥がします。
2. センサー用レンズを差し込みます。向きを間違えないように注意してください。
3. センサー裏面の、レンズのピンがはみ出している箇所に剥がした保護シールを乗せ、その上からはんだごてを軽く当ててピンを溶かし、センサー用レンズを固定してください。
4. 画像のようにレンズのピンが平たく潰れていればOKです。

以上ではんだ付けは完了です。お疲れさまでした！
各パーツが正しく取り付けられているか、もう一度ご確認ください。

3. 組み立て手順

はんだ付けが完了したら、キーボードの組み立てを行います。

3-1. 右手側組み立て手順

1. トッププレートを乗せ、位置がずれないようにキースイッチをいくつかはめ込んでください。
2. 画像を参考にクッションシールを貼ってください。一部カットが必要です。
3. バッテリーコネクタを差し込んでください。コネクタの相性によってかなり硬いことがありますが、コネクタの向きがあっていれば画像の深さまで差し込むことができます。
4. トラックボール基板を差し込んでください。
5. ボトムプレートの四隅にゴム足を貼り付けてください。ボトムプレートは左右共通です。
6. （任意）左右を磁石で合体させたい方はボトムプレートに磁石をはめ込んでください。底面同士がくっつくように極性をしっかり確認してください。
7. ボトムプレートにリセットスイッチ用パーツを乗せてください。固定はされないので落とさないよう取り扱いに注意してください。
8. ボトムプレートにバッテリーを装着してください。
9. 右手側カバーにPOM球を乗せてください。
10. マイコンのUSBコネクタをトッププレートの穴にあわせるように意識しながら、斜めから挿し込むように基板をセットしてください。
11. リセットスイッチがはずれないよう注意しつつボトムプレートを閉じ、4箇所ネジ止めしてください。このときネジを強く締めすぎるとネジ穴が潰れてしまう可能性があるので、締めすぎには注意してください。
12. 電源スイッチを装着してください。
13. キーキャップとキースイッチを取り付けたら完成です！

3-2. 左手側組み立て手順

1. 画像のようにロータリーエンコーダに軸とホイールを装着してください。トッププレートを装着した後はロータリーエンコーダのつけ外しができなくなるので組み立ての順番に注意してください。
2. ホイールの下に滑り込ませるようにトッププレートを装着してください。
3. 右手側と同様にクッションシールおよびゴム足貼り付けと、バッテリー・リセットスイッチの装着を行ってください。
4. 右手側と同様に斜め方向からトップカバーを装着してください。ロータリーエンコーダとホイールのはめ込みがある分右手側よりややシビアですが、信じてグッとやればズボッとハマるはずです。
5. 右手側と同様にネジを4箇所止め、電源スイッチを装着してください。
6. キーキャップとキースイッチを取り付けたら完成です！

組み立ておつかれさまでした！

4. ファームウェア

次に、動作確認のためにファームウェアの書き込みを行います。

4-1. テスト用ファームウェアのダウンロード

以下のリンクからファームウェアをダウンロードしてください。
ダウンロード

ダウンロード後zipファイルを展開し、

• SeaGlass_L rgbled_adapter-seeeduino_xiao_ble-zmk.uf2
• SeaGlass_R rgbled_adapter-seeeduino_xiao_ble-zmk.uf2
• settings_reset-seeeduino_xiao_ble-zmk.uf2

という3つのファイルが入っていることを確認してください。

4-2. テスト用ファームウェアの書き込みとペアリング

マイコンにファームウェアを書き込みます。テスト用といいつつ通常動作するファームウェアなので、この工程が済むと一旦の完成になります。

1. マイコンをブートローダーモードにします。
   • PCとSeaGlass右手側をUSBケーブルで接続します。
   • リセットボタンを素早く2回押します。SeaGlassのリセットボタンは本体裏面の白いボタンです。
   • PC上で「NO NAME」や「XIAO-BOOT」などの名称でドライブが認識されれば成功です。（マイコンのロットなどによって表示名が異なる場合があります。）
2. 表示されたドライブに settings_reset-seeeduino_xiao_ble-zmk.uf2 をドラッグ&ドロップまたはコピー&ペーストで書き込みます。この時画像のようなメッセージが出る場合がありますが、ドライブが自動的に認識されなくなっていたら書き込みに成功しています。
   settings_reset-seeeduino_xiao_ble-zmk.uf2 は設定初期化用のファイルなので、基本的に今後は書き込み不要です。
3. 再度マイコンをブートローダーモードにし、今度は右手用のファームウェアSeaGlass_R rgbled_adapter-seeeduino_xiao_ble-zmk.uf2 を同様の手順で書き込みます。この時も同様のメッセージが出ることがありますが、正常です。
4. 左手側も同様の手順でsettings_reset-seeeduino_xiao_ble-zmk.uf2 → SeaGlass_L rgbled_adapter-seeeduino_xiao_ble-zmk.uf2 の順番で書き込みを行います。
5. 左右の書き込みが完了したらUSBケーブルを取り外し、両方のSeaGlassのスイッチをオン（上側）にし、マイコンのリセットスイッチを左右どちらも一度ずつ押します
6. 電源オンの時やリセットの時にマイコンのLEDが点滅するはずです。以下の意味がありますので、正常に点滅することを確認してください。
   • 最初の点灯（バッテリーの残量）
     • 🟢/🟡/🔴の三段階で点灯。初期ファームウェアでは40%以上は🟢、20%までは🟡、それ以下は🔴が点灯するように設定されています。
     • この閾値はファームウェアを編集することでお好みに設定できます。
   • 2つ目の点灯（ブルートゥースの接続状況）
     • 🔵は接続成功、🟡はペアリング中、🔴は接続失敗を意味します。
     • 左右で少し意味が異なり、左側の点灯は親側（右側）へのペアリング状況を意味し、右側の点灯はPCなどの機器へのペアリング状況を意味します。

• ですので、ファームウェア書き込み後の正常な点灯は以下のとおりです。
  • 左手側：🟢/🟡/🔴（バッテリーの充電状況次第）→ 🔵（左手側との接続成功）
  • 右手側：🟢/🟡/🔴（バッテリーの充電状況次第）→ 🟡（機器とのペアリング中）

詳細はzmk-rgbled-widgetのREADMEをご覧ください。

7. 正常に点灯していたらPC側でBluetoothデバイスとして「SeaGlass」が認識されているはずです。そのまま接続を行ってください。

テスト用ファームウェアのキーマップは普段自分が使用しているものなので、あまり汎用的ではない設定が含まれています。
おそらくこれから自分だけのファームウェア設定を模索していくことになると思います。テスト用ではない本番のファームウェアはぜひ皆さんの手で作り上げてください！

以下は本ファームウェアで設定されているキーマップになります。参考にしてみてください。

4-3. Bluetooth切り替え手順

本キーボードは最大5台のBluetoothデバイスとの接続を切り替えることができます。
接続先の切り替えはキーマップで設定可能で、テストファームウェアだとレイヤー6のz~bキーに設定されています。

4-4. 動作確認

Bluetoothの接続後、キーやトラックボールの動作を確認してください。不具合があったら、最も可能性が高いのははんだ付けの不良です。各種はんだ付けに不備が無いかチェックしてみてください。
どうしても解決しないときはXやboothのメッセージやgithubのissueなど、手段は問いませんのでご連絡をお願いいたします。

4-5. ZMK Studioの活用

※ 2026/06/16追記
本ファームウェアはキーマップ変更ツールDYA Studioに対応しました！
DYA Studioはこちらです。 special thanks! cormoran さん
ZMK Studioより多彩な設定がファームウェアのビルド無しで行えます。ぜひ使ってみてください。
※ 追記終わり

SeaGlassはZMK Studioに対応しています。ZMK Studioを使用することでファームウェアを書き換えることなくGUIでキーマップを簡単に編集できます。
ただしZMK Studio自体まだ開発段階？のようで、設定可能なキーボード設定に一部制限があります。なのでZMK Studioでのカスタマイズのみでは後々物足りなくなる可能性が高いですが、GitHubに慣れていない方などはまずはこちらでいろいろ触ってみるのも手だと思います。

1. ZMK Studioにアクセスします。
2. 接続するキーボードを選択します。
3. 接続が完了すると、現在のキーマップが表示されます。
4. 変更したいキーをクリックし、任意の動作を選択します。
5. 設定が完了したら右上の保存ボタンをクリックして変更を保存します。

細かい操作や設定、どういった制限があるのかなどについてはここでは説明しませんので詳しくはこちらを参照してください。

4-6. ZMKファームウェアのカスタマイズとビルド方法

ZMK Studioで対応していない高度な設定を行いたい場合は、直接ファームウェアをカスタマイズしてビルドする必要があります。ファームウェアのカスタマイズビルドにはGitHubを使用します。
ファームウェアのリポジトリはこちらです。
zmk-config-SeaGlass

ファームウェアのビルド〜書き込みのおおまかなフローは以下のとおりです。（画像内のリポジトリ名がSeaSide39になっていますが、適宜SeaGlassに読み替えてください。）
ここでは各ツールの細かな使い方の説明はしませんので、必要に応じて調べてみてください。

1. zmk-config-SeaGlassをフォークする

• あなたのGitHubアカウント上にzmk-config-SeaGlassリポジトリが表示されていればOKです。

2. 手動またはKeymapEditorでファームウェアを編集する

• ZMK Keymap Editor とあなたのGitHubアカウントを接続すると、KeymapEditorから直接リポジトリへ変更をプッシュすることができます。

3. ビルドされたファームウェアをダウンロードして書き込む

• 「GitHub Actions」という機能を使って、コードをリモートリポジトリへプッシュするたびに自動的にファームウェアがビルドされます。
• Actionsはリポジトリの「Actions」タブから確認できます。初回は手動で有効化が必要です。
• リポジトリに変更をプッシュすると数分でビルドが完了します。「Actions」タブから最新のワークフローを開き、Artifactsからファームウェアをダウンロードしてください。
• ダウンロードしたファームウェアを書き込みます。キーマップの変更の場合は右側だけの書き込みでOKです。

ZMKファームウェアについて、細かくカスタマイズをしたい方はZMK公式ドキュメントを参照してください。

5. お疲れさまでした

これにて組み立ては完了です。お疲れさまでした！
ぜひ感想や要望などあればハッシュタグ #SeaGlass_kbd で発信をお願いいたします🌊