Keyboard

FDkeeb ビルドガイド（組立手順説明書）

自作キーボードキット「fdkeeb」のビルドガイド（組立手順説明書）です。

目次

0. はじめに

自作キーボードキット「FDkeeb」をお買い上げいただいた皆様、ありがとうございます。
組み立て前に、このビルドガイドに一通り目を通していただくようお願いします。
不明な点がありましたら、ぜひお知らせください。お知らせいただく際は、当記事最下部にあるDISQUSにコメントしていただくか、Twitterで @alg0002 にメンションを飛ばしてください。

基本的に、数字の順序どおりに読み作業を進めてください。

例1：
4-1. Pi PicoにPRK Firmware書き込み
4-2. Pi Picoにテスト用keymap.rb書き込み
→4-1.の次に4-2.を行ってください

ただし、数字ではなく英字が出てくることがあります。その場合、いずれかの作業を選んで行ってください。

例2：
4-A. ダイオード（スルーホールタイプ）のはんだ付け
4-B. ダイオード（表面実装タイプ）のはんだ付け
→4-A.と4-B.のいずれかのみを行ってください

1. 必要な部品を確認する

1-1. キットに含まれる部品

キットに含まれる部品です。この表の通りの部品が揃っているかどうか確認してください。
もし欠品があった場合、お早めに購入ショップまでご連絡ください。

名称 数量 当記事での略称 備考
トッププレート 1 「Top」と書いてあります
スイッチプレート 1 「Switch」と書いてあります
ミドルプレート 1 「Middle」と書いてあります
実装基板 1 「Assemble」と書いてあります
ボトムプレート 2 「Bottom」と書いてあり、同じものが2枚あります
ボトムカバープレート 1 「Bottom_cover」と書いてあります
低頭ねじ 8 ねじ 長さ3mmのM2低頭ねじです
スペーサー 4 長さ5mmのM2両メネジスペーサーです
ゴム足 4 直径8mm高さ2mmのゴム足です

1-2. キットに含まれない必須部品

キットに含まれませんが、完成に必要な部品の一覧です。
これらの部品がないとキーボードとして機能しませんので、別途お買い求めください。
代表的な購入先のURLも載せましたので、参考にしてください。

名称 数量 購入先 当記事での略称 備考
Waveshare RP2040-Zero 1 TALPKEYBOARD
スイッチサイエンス
Kailh Choc V1 キースイッチ 1 遊舎工房
TALPKEYBOARD
Daily Craft Keyboard		 キースイッチ Choc V2やCherryMX互換は非対応です
Kailh Choc V1用キーキャップ 1 遊舎工房
TALPKEYBOARD
Daily Craft Keyboard		 キーキャップ
Kailh Choc V1用PCBソケット 1 遊舎工房
Daily Craft Keyboard		 スイッチソケット MX用ではなくChoc用を購入してください
C to A USBケーブル 1 遊舎工房
Daily Craft Keyboard		 USBケーブル 充電専用ではなく通信ができるものを使用してください

1-3. キットに含まれないオプション部品

キットに含まれず、完成に必須というわけでもない部品の一覧です。
必須ではありませんが、あると楽しいかもしれません。

名称 数量 購入先 当記事での略称 備考
SK6812MINI-E 1 遊舎工房
秋月電子		 LED
ダイオード 1 遊舎工房
TALPKEYBOARD
Daily Craft Keyboard		 LEDを使う場合に必要です
マスキングテープ 6mm黒 1 ヨドバシ・ドット・コム マステ黒6mm

2. 必要な器具や消耗品を調達する

組み立てに必要となるであろう器具や消耗品を確認し、調達します。
代表的な購入先のURL（Amazon.co.jpのものはアフィリエイトリンクです）も載せましたので、参考にしてください。
※すべてが必須というわけではありませんので、当ガイドを見て必要と判断したものを用意してください

名称 購入先 当記事での略称 備考
はんだこて Amazon.co.jp 温度が調節できるものがお勧め
こて台 Amazon.co.jp
はんだ Amazon.co.jp
はんだ吸い取り線 Amazon.co.jp はんだ付けに失敗したときに使用します
はんだ付け作業用マット Amazon.co.jp
ピンセット Amazon.co.jp 小さい部品をつまむのに使いますが、なくてもいいかも
マスキングテープ Amazon.co.jp マステ 一般的なマスキングテープでOKです
ドライバー Amazon.co.jp
キーキャップ引き抜き工具 TALPKEYBOARD キーキャップを外すときに使います
パソコン Amazon.co.jp ファームウェアの書き込みに使用します
テスター 遊舎工房 キーボードがうまく動作しない場合の原因調査に使用します
油性ペン（黒） Amazon.co.jp 改めて購入しなくても、ご家庭にあるもので十分です

3. 組み立てる(1)

3-1. プレート側面を黒く塗る


各種プレート（トッププレート、スイッチプレート、ミドルプレート、実装基板、ボトムプレート、ボトムカバープレート）の側面を黒いペンで塗ります。
これをやらなくてもキーボードとしては機能しますが、見映えが良くなるので塗ることをおすすめします。
FDkeebの場合は細かいところがあるので、太いペンと細いペンが両方あると塗りやすいです。

3-2. スイッチソケットをはんだ付けする


実装基板にスイッチソケットをはんだ付けします。
最初に実装基板上のパッド（銀色のところ）の片側に予備はんだ（少量のはんだを溶かして乗せておく）をします。
その後、スイッチソケットをのせます。スイッチソケットの向きに注意してください。角張っていて突起がある方が右、角が落とされている方が左、です。
予備はんだをした方のパッドにはんだごてを当て、はんだを溶かして固定します。
予備はんだしなかった方のパッドもはんだ付けします。

3-3. （オプション） LEDとダイオードをはんだ付けする


実装基板にLEDとダイオードをはんだ付けします。
オプションなのでこの手順は飛ばしてもかまいません。
写真を参考に、LEDとダイオードの向きに注意してください。
LEDは左下がGNDです。

3-4. RP2040-Zeroをはんだ付けする


実装基板にRP2040-Zeroをはんだ付けします。
はんだ付けが必要なのは以下のパッドだけです。

  • 5V
  • GND
  • GP29
  • GP0

この4か所だけはんだ付けすれば動作はしますが、全部のパッドをはんだ付けするとしっかり固定されます。
（写真では4か所に加えてGP8とGP14をはんだ付けしています）

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

FDkeebはファームウェアとしてPRK FirmwareとKermiteをサポートしています。
どちらかお好みの方を利用してください。

4-A. PRK Firmware

PRK Firmwareは、キー割り当てなどをRubyでカスタマイズすることができるファームウェアです。

PRK Firmwareのファームウェアファイルをダウンロードします。


基本的に最新版を使うのが良いですが、もし最新版で不具合が出た場合は少し古いバージョンも試してみてください。

USBケーブルをRP2040-ZeroのUSBコネクタに差し込みます。


ブートローダーモードにするため、RP2040-ZeroのBOOTボタン（「BOOT」と書かれた表面左下の小さいボタン）を押しながらUSBケーブルをパソコンに接続します。
「RPI-RP2」というUSBマスストレージが認識されるはずです。

先ほどダウンロードしたPRK Firmwareの圧縮ファイルの中には拡張子が「uf2」というファイルがありますので、そのuf2ファイルをUSBマスストレージにコピーします。
少し待つと「RPI-RP2」というUSBマスストレージが認識されなくなり、かわりに「PRK DRIVE」または「PRK Firmware」というUSBマスストレージが認識されます。この状態になったらファームウェアの書き込みは成功です。
上手くいかなかった場合、RP2040-ZeroのBOOTボタンを押しながらパソコンに接続しなおしてみてください。

FDkeeb用の設定ファイルkeymap.rbをダウンロードします。
↓のリンクを右クリックして「名前を付けてリンクを保存」などでパソコンにファイルを保存します。

保存したkeymap.rbファイルを、「PRK DRIVE」または「PRK Firmware」USBマスストレージにコピーします。
コピーが終わったらリセットボタン（BOOTボタンの右側にある「RESET」と書かれたボタン）を押してリセットします。

スイッチソケットにキースイッチを取り付け、キースイッチを押したときに正しく動作するかを確認してください。
正しく動作しなかった場合は、ここまでの組み立て過程で行ったはんだ付けを見直してみてください。
それでも解決しなかった場合は、下のDISQUSフォームまたはTwitterからお問い合わせください。

4-B. Kermite

Kermiteは、Webブラウザでキー割り当ての変更などができるファームウェア（およびエコシステムの総称）です。

使い方については公式ドキュメントもご覧ください。

KermiteのWebアプリを開きます。


「スタート」で「プロファイル作成ウィザード」をクリックします。


キーボード定義の一覧から「FDkeeb」を選択し、「次へ」をクリックします。

USBケーブルをRP2040-ZeroのUSBコネクタに差し込みます。


ブートローダーモードにするため、RP2040-ZeroのBOOTボタン（表面左下の小さいボタン）を押しながらUSBケーブルをパソコンに接続します。
「RPI-RP2」というUSBマスストレージが認識されるはずです。


「uf2ファイルダウンロード」ボタンを押します。
拡張子がuf2のファイルがダウンロードされます。

ダウンロードされたuf2ファイルを、USBマスストレージにコピーします。


「デバイスを追加」ボタンを押します。一覧に「FDkeeb #xxxx」のような表示があれば、それを選択して「接続」ボタンを押して接続します。
一覧に表示されなかった場合、RP2040-Zeroをブートローダーモードにしてもう一度uf2ファイルをコピーしてみてください。


画面左半分に「接続されています」と表示されたら、「次へ」を押します。


「完了」を押します。


メイン画面が表示されます。
「プリセット」をクリックします。


プリセットから「(userProfile)FDkeeb-default (by alg)」を選択し、「プロファイルを作成」をクリックします。


メイン画面に戻りますので、「書き込み」をクリックします。
「write succeeded.」と表示されれば書き込み成功です。


「保存」をクリックし、適当なプロファイル名を付けて「OK」ボタンを押します。
※この「保存」をやっておかないと、後で自分好みのキー割り当てに変更するときにちょっと面倒になるので、必ず「保存」してください

スイッチソケットにキースイッチを取り付け、キースイッチを押したときに正しく動作するかを確認してください。
正しく動作しなかった場合は、ここまでの組み立て過程で行ったはんだ付けを見直してみてください。
それでも解決しなかった場合は、下のDISQUSフォームまたはTwitterからお問い合わせください。

5. 組み立てる(2)

5-1. 部品をネジ留めする

キースイッチをいったん取り外します。


ボトムカバープレートの「Bottom_cover」と書かれた面の四隅にスペーサーを置き、裏からネジ留めします。


その上に、以下の順番でプレート類を重ねます。

  • ボトムプレート
  • ボトムプレート
  • 実装基板
  • ミドルプレート
  • スイッチプレート
  • トッププレート

重ねる際は各プレートの形が合うように重ねてください。


重ねたら、トッププレートの四隅をネジ留めします。

5-2. ゴム足を貼る


裏側の四隅の適当な場所にゴム足を貼ります。
ゴム足はネジを避ける位置に貼るとよいです（分解する可能性があるので）。

5-3. スイッチとキーキャップを取り付ける


スイッチとキーキャップを取り付けます。
スイッチ取り付け前に金属足が曲がっていないか確認してください。もし曲がっていたら真っ直ぐにしてから取り付けます。

6. キー割り当てを変更する

書き込んだファームウェアによって、やり方が異なります。

6-A. PRK Firmwareの場合

FDkeebをUSBケーブルでパソコンに接続します。

「PRK DRIVE」または「PRK Firmware」というUSBマスストレージが認識されます
その中にあるファイル「keymap.rb」を適当な場所にコピーし、適宜編集してください。
編集が終わったら、「PRK DRIVE」または「PRK Firmware」USBマスストレージに上書きコピーすると反映されます。

keymap.rbの書き方について詳しくはPRK FirmwareのWikiを参照してください。

6-B. Kermiteの場合

FDkeebをUSBケーブルでパソコンに接続します。

KermiteのWebアプリを開きます。


「デバイス」をクリックします。
「FDkeeb #xxxx」がすでに表示されて選択されていれば、そのままでOKです。


もし表示されていなかったら、「add device」ボタンを押します。
一覧に「FDkeeb #xxxx」のような表示があるはずなので、それを選択して「接続」ボタンを押して接続します。


「メイン」をクリックします。
キー割り当てを変更したいキーを画面でクリックし、下半分の候補から割り当てたいキーを選んでクリックします。
これを必要なだけ繰り返し、お好きなようにキー割り当てを変更してください。


終わったら、「書き込み」を押すとfdkeebにキー割り当てが反映されます。


変更した割り当てを後から再利用するかもしれない場合は、メニューから「別名で保存」をクリックし、適当な名前をつけて保存してください。

7. 完成度を上げる

側面にマステ黒6mmを貼ると完成度が上がります。
フロッピーディスクラベルみたいなものを自作するのもいいと思います。

8. 自慢する

お疲れさまでした！これが最後にしてもっとも重要な手順です。
できあがったFDkeebを、SNSなどで自慢してください。
写真をアップしたり、楽しめた点や苦労した点などをつぶやいたり、思い思いの方法で共有してください。
Twitterで私 @alg0002 宛にメンションを飛ばしていただけるとなお嬉しいです。