このガイドでは、Keyball44の組み立て手順を詳しく説明します。
※Keyball44の白基板の写真をメインに説明していますが黒基板も同様の手順になります。
黒基板セットのみ対応が必要な箇所は文頭に ⚫️ を付けています。
English build guide for Keyball44 is here.
準備編
実装編
組み立て編
仕上げ編
キットが届きましたらキット同梱品がすべて入っているかご確認ください。
標準セットは左右どちらかに1つ親指トラックボールを搭載できます。
左右両方にトラックボールを搭載するデュアルボール仕様や、左右両方トラックボール無しで組み立てることもできるように、片手のみのキットも販売しています。
片手セットやデュアルボールセットをご購入の場合は、キットに同封の部品リストにて同梱品をご確認ください。
Keyball44 標準キットの同梱品一覧
| 部品名 | 数量 | 備考 |
|---|---|---|
| ミドルPCB(左右) | 1組 | メインボード |
| トップPCBプレート(左右) | 1組 | キースイッチ固定用 |
| ミドルアクリルプレート(左右) | 1組 | キースイッチ固定用 |
| ボトムアクリルプレート(左右) | 1組 | 底面カバー |
| ProMicro保護プレート | 2枚 | 基板保護用 |
| トラックボール保持ケース(上下) | 1組 | ボール固定用 |
| Φ2 セラミックボール | 1個 | 予備 |
| トラックボール読取り基板 | 1枚 | センサー基板 |
| L字コンスルーピン(7ピン) | 1個 | センサー接続用 |
| トラックボール読取りIC | 1個 | PMW3360 |
| 読取りIC用レンズ | 1個 | 光学レンズ |
| 平頭タップネジ M1.7 | 2本 | トラックボールケース固定用 |
| 小頭タップネジ M1.7 | 2本 | トラックボールケース同士の固定用 |
| TRRSジャック | 2個 | 左右接続用 |
| タクトスイッチ | 2個 | リセット用 |
| ストレートコンスルーピン(12ピン) | 4本 | ProMicro接続用 |
| ダイオード（表面実装タイプ） | 50個＋ | キーマトリクス誤認識防止用 |
| Kailh PCBソケット CherryMX用 | 44個＋ | キースイッチ用 |
| Kailh PCBソケット choc用 | 5個 | 親指ロープロ改造時に使用 |
| OLEDモジュール | 2枚 | ディスプレイ |
| 4連ピンヘッダ | 2つ | OLED接続用 |
| 4連ピンソケット | 2つ | OLED接続用 |
| スペーサー M2 7mm | 14本＋ | 標準スペーサー |
| スペーサー M2 9mm | 4本 | 高さ調整用 |
| スペーサー M2 4mm | 4本 | 親指ロープロ仕様で使用 |
| ネジ M2 3.5mm | 36本＋ | プレート固定用 |
| クッションゴム | 10個 | 底面の滑り止め用 |
以下の部品はキットに含まれていないため、別途ご購入いただく必要があります。
| 部品名 | 数量 | 備考 |
|---|---|---|
| ProMicro | 2個 | 安価なものやUSB Type-C対応のもの等選べます |
| CherryMX互換キースイッチ | 44個 | 親指ロープロ仕様なら39個 |
| ロープロファイルキースイッチ | 5個 | 親指ロープロ仕様とする場合のみ |
| 直径34mmトラックボール | 1個 | トラックボール使用時に必要 |
| TRS(3極)ケーブル | 1本 | TRRS(4極)ケーブルでも可 |
| Micro USBケーブル | 1本 | ご購入いただいたProMicroに対応するもの |
以下の部品は組み立て後に取り付けることができ、お好みに応じてカスタマイズできます。
| 部品名 | 数量 | 備考 |
|---|---|---|
| キーキャップ | 44個 | 1u 44個 |
| ロープロファイルキーキャップ | 5個 | 親指ロープロ仕様のみ 1u 5個 |
| YS-SK6812MINI-E | 59個 | ※SK6812MINIは使用できません |
Keyball44の組み立てには下記の工具が必要です。すべて揃っているかご確認ください。
| 工具名 | 用途 |
|---|---|
| はんだごて(LEDを実装する場合は温度調整可能なもの) | はんだ付け作業 |
| はんだ(LEDを実装する場合は低融点のものが有効) | 接続用 |
| 0番＋精密ドライバー | ネジ締め用 |
| ピンセット | 部品取り扱い用 |
| カッター | トッププレート親指部パーツ切り離し用 |
| 150番手くらいの紙やすり | プレートを切り離した時の研磨用 |
Keyball44を動作させるには、ご購入いただいたProMicroへのファームウェアの書き込みが必要です。
すでにビルド済みのファームウェアを、REMAPというウェブ上のキーボード管理ソフトにて簡単に書き込みができます。
書き込みについてはこの後の3-7章でテスト用のファームウェアの書き込み、10章で製品版ファームウェアの書き込みについて詳しく説明しています。
ここからはんだ付け作業に入ります。
PCBはリバーシブルになっているので、最初にどちらを左手用/右手用にするか決めます。
右手親指でトラックボールを操作する場合は下写真の赤丸で示した、PCBが欠けている部分にトラックボールが付きます。
左手親指でトラックボールを操作する場合は下記写真のような配置です。
本ビルドガイドでは右手にトラックボール付ける仕様で説明します。
⚡️ 注意:裏表を間違えてはんだ付けをしてしまうとやり直しが非常に困難になります。
下記写真のようにミス防止のため表面にマスキングテープ等の目印を付けてください。。
⚫️ 黒基板セットの場合はお好みでトップPCBとミドルPCBの側面を黒のマーカーで塗りつぶしておくと仕上がりが綺麗になります。
はんだごての"こて先"は竹槍の先端のような形状のものだと平面にはんだを乗せたり、余分なはんだを"すくい取る"事が出来るので使いやすいです。
それではダイオードを順にはんだ付けしていきます。
ダイオードはすべて裏面にはんだ付けします。
ダイオードのシルクマークは下写真の矢印で示したマークで、左右で合計46個あります。
⚡️注意: ダイオードには極性がありますので、正しい向きで取り付けてください。
向きは部品上の直線とシルクマーク内の矢印の先についている直線が一致する方向です。
下記写真をよく見て向きを確認してください。
同一基板上のダイオードの向きはすべて同じ向きで配置されています。
はんだ付けを進める中で回りのダイオードと同じ向きになっているか確認しながら行ってください。
ダイオードのシルクには下記写真の赤で示すような黒点があるのでダイオードのはんだ付け後にも極性確認ができます。
はんだ付け開始です。
まずダイオード用パッドの片側にはんだを盛ります。
ピンセットでダイオードを掴み、事前に盛ったはんだを溶かしながらダイオードを固定します。
基板を180度回転させてダイオードの反対側の足にもはんだを流します。
最後に両方の足をこて先で触り、ダイオードが脱落しなければ両足ともはんだ付けされています。
左右で合計46個のダイオードを取り付けます。
LED（YS-SK6812MINI-E）はオプションになります。
左右で計59個取り付け可能です。
ただしLEDは非常に熱に弱く、こて先温度を220度～280度に調整して行ってください。
銀入りはんだ等の融点の低いハンダを使用すると良いです。
こて先の温度が低いため、パッドに熱が伝わらずはんだがテンプラ（接続不良）しやすいです。
LED無しでもキーボードは使用できますし、すべてのLEDを点灯させるのは難易度が高いです。
まずはLEDなしで完成させることをおすすめします。後からでもLEDを追加できます。
LEDをはんだ付けする場合にはこのタイミングで作業すると作業性が良いと思います。
LEDはすべて裏面にはんだ付けします。
YS-SK6812MINI-Eの4ピンのうち切り欠きがある足と、マーキングされているパッドを合わせてLEDを載せてはんだ付けします。
LEDには上向きと下向きに付けるものが混在しますが、下写真のようにピンの切り欠きとマーキングを合わせると自動的に上下が合います。
一度に4ピンすべてのはんだ付けをすると部品の温度が上がり壊れやすいので、2ピンづつを目安に時間を空けながらはんだ付けしてください。
そのために10個ほどのLEDを一度に載せて、一度はんだを当てたら次のLEDのはんだ付けに移るようにします。
こうすると1つのLEDに熱を加え続けることを防げます。
全てのLEDがはんだ付けが完了したら次の工程へ進めます。
後ほどLEDの点灯確認を行います。
キーソケットはダイオードと同様にすべて裏面にはんだ付けします。
シルクマークと形状が合うようにセットしてはんだ付けします。
⚡️注意:シルクからはみ出すようであれば方向が違います。
正しい向きを下記写真で確認してください。
親指キーをロープロ仕様で組み立てる場合は、親指キーとなる箇所（左右で5キー）にロープロファイル用ソケットをはんだ付けして下さい。
このロープロソケットにも向きがあります。
下記写真のように黒い樹脂部分が八角形のような形の端子をスイッチの中心付近に配置します。
はんだ付けは青丸で示すように事前にソケット用パッドの片側にはんだを盛っておきます。
ソケットをはめて上からピンセットで抑えて端子の横からはんだを少し載せたこて先を当てると、はんだが溶けてソケットが沈み込みます。
経験上、この方法が一番テンプラ（接続不良）しにくいです。
基板を180度回転させて反対側の端子もはんだ付けします。
左右合わせて44個はんだ付けして完了です。
親指キーのPCBソケットはCherryMX互換ソケットかロープロソケットのどちらかだけでも構いません。
※写真では両方付けています。
OLEDモジュールを動作させるためにジャンパをショートさせる必要があります。
⚡️注意:ジャンパのはんだ付けは裏面のみに行います。
"Back Side Only"の表示があり、左右の基板に各【4個ずつ】あります。
パッドをこて先で温めてから、はんだを溶かすとブリッジできます。
はんだ付けに自信が無い方やブリッジ作業が苦手な方は、下記写真のようにまずは8個のパッドにはんだを付ける事を行ってみてください。
ここにはんだを追加することで、楽にブリッジさせられると思います。
はんだの鮮度が落ちる（何度も温め直す）と表面張力が落ちてうまくブリッジできません。
一度はんだを払ってしまい、はんだやフラックスを足してやり直してください。
左右とも、計8か所をブリッジします。
次にトラックボール用信号線のジャンパをショートさせます。
下記写真の位置にある4個のジャンパを写真のようにはんだ付けしてください。
これも裏面のみ行います。
最後に左手判定ジャンパをショートさせます。
下記写真のように左手とする側の小指キー付近にLEFTの表示があるジャンパが1つあります。
これも裏面のみショートさせてください。
全てのジャンパのはんだ付けが完了したのが下記写真です。
4つの青丸部分が全てはんだ付けしてあるか確認してください。
下記写真の部品をはんだ付けします。
⚡️注意:今度はすべて表面のみに取付けますのでご注意ください。
部品が浮いてしまうのが心配であれば、マスキングテープ等で固定してはんだ付けします。
すべて取り付けると下写真のようになります。
裏面のはんだ付けした状態の写真です。
ProMicroは下記写真のコンスルーピンを使用してはんだ付けすることで、ProMicroの故障時に交換が容易になります。
コンスルーピンには取付け方向がありますので写真をよく見て作業してください。
⚠️ 12Pコンスルーの代わりにProMicro用ピンヘッダ＋ピンソケットが同梱されていた場合には、【こちら】のビルドガイドをご利用ください。
まずコンスルーピンを基板【表面】に差し込みます。
シルクの四角枠に合うようにコンスルーを差し込んでください。
シルクの黒枠がコンスルーとずれているようであれば差し込む穴が間違っています。
差し込んだコンスルーピンにProMicroを挿入します。
しっかり最後まで差し込んだ状態でProMicro側のみはんだ付けします。
基板に差し込んだ状態ではんだ付けすることで、コンスルーピンが斜めに取り付けられてしまうことを防げます。
⚡️注意:コンスルーピンをミドルPCB側にもはんだ付けしてしまうとProMicro故障時に取り替えが非常に困難になります。
左右の基板には標準でOLEDが搭載できます。
4連ピンソケットに4連ピンヘッダを挿入してOLEDモジュールを載せます。
そして、4ピンのうちの1つだけをはんだ付けします。
1つだけはんだ付けしたピンのはんだを溶かしながらOLEDモジュールを上から押して浮かないようにします。
またProMicroと並行になるように調整すると見栄えが良くなります。
位置が決まったら残り3ピンをはんだ付けします。
テスト用のファームウェアをProMicroに書き込みましょう。
テスト用ファームウェアは動作確認がしやすいキーマップ配置であることに加え、LEDが赤→緑→青と順に点灯するので、不具合箇所を発見しやすいです。
LEDのはんだ付けを見送っている場合など、テスト用ファームウェアが必要無い方は10章の正規のファームウェアをここで書き込んでも構いません。
Keyball44のファームウェアは、トラックボールを左右どちら側に載せた場合でも共通です。
REMAPに登録してあるKeyball_test.hex を書き込み(FLASH)してください。
上記リンクにあるFLASHボタンを押すと、書き込み方法の説明が表示されます。
USBケーブルを接続しているのにキーボードが認識されない場合は、はんだ付けしたRESETスイッチを素早く2回押すと認識されると思います。
※必ず左右両方のPro Microに同じhexファイルを書き込んでください。
Keyball44のファームウェアを直接編集してご自身でビルドしたい場合は、 こちらのリポジトリにソースファイルがありますのでダウンロードしてご活用ください。
書き込みが完了したら下写真のようにキースイッチのパッドをピンセットでショートしてテキストエディタに文字が入力されることを確認します。
キーボードの左右が反転している場合がありますが、現状は問題ありません。
ひとまず何かしらの文字が入力されてProMicroが動作しているかだけご確認ください。
すべてのキーを試す必要はまだありませんが、早い段階で動作確認をすることで問題の切り分けが楽になります。
※ファームウェアの書き込みは必ず左右両方のPro Microに対して行ってください。
このタイミングでLEDの点灯確認も行います。
LEDは直列に配線されているので、途中までしか光らない場合の不具合箇所の特定がしやすいです。
例えば12番のLEDまでは点灯したが、13番以降のLED以降が点灯しない場合、【12番か13番】のLEDのはんだ付けに問題がある可能性が高いのでそれらのLEDのはんだ付けをやり直してください。
それでも改善しない場合はLEDの故障が考えられるので13番のLEDを交換してください。
点灯確認とはんだ付け修正を繰り返して、すべてのLEDが点灯するようにします。
下写真の基板（以下、ボール基板）と光学センサーを準備します。
※センサーや基板の品質確認のため、はんだ付け済のボール基板が届く場合があります。
その際はこの工程を飛ばして、4-2章のL字コンスルーはんだ付けに進んでください。
センサーICはボール基板の部品が実装されていない裏面から差し込みます。
⚡️注意:センサーの極性を間違えると、修理がとても大変です！
正しい向きで、正しい方向から挿入しているかしっかりと確認してからはんだ付けしてください！
ICの１ピンを示すくぼみと基板の【1pin】のシルクを合わせます。
ICを裏から見るとこのような方向です。
表面実装部品が実装されている表面側（Keyballロゴの無い面側）から全ピンをはんだ付けしてください。
ピンセットを使って保護シール【２枚】をはがします。
保護シールをはがした面側にセンサーレンズを取り付けます。
レンズには方向があり、方向が違うとレンズの細いピン2本が折れてしまう恐れがあるため方向をしっかりとご確認ください。
レンズ手前に下記写真の矢印のような突起があり、これが上側にくるように取り付けます。
レンズとICの方向が合えば、レンズのピン2本がICに無理なく差し込めるはずです。ゆっくりと差し込んでください。
次にL字コンスルーピンをトラックボールを搭載する基板の表面に取付けます。
L字コンスルーにも方向があります。
ピンがU字型になっていない方をミドル基板に差し込んではんだ付けします。
部品が浮かないようにマスキングテープ等を貼って裏面からはんだ付けしてください。
裏面から7ピンのはんだ付けをします。
以上ではんだ付け作業は完了です。
余談ですがはんだごての電気を落とす前に、こて先にたっっぷりとはんだを付けておきましょう。次回使用するときにこのはんだを落とせば、ピカピカのこて先で作業を再開できますよ！
Keyball44は親指キー5個をchocロープロファイルスイッチに切り替えることが可能です。
その場合は親指キー部分のプレートの高さが変わるのでトッププレートのミシン目を切り離す必要があります。
切り離す場合はカッターを使用して表面と裏面のミシン目部分に切り込みを入れてから折って切り離します。
親指キーを通常のCherry MXスイッチにする場合には基板を切り離す必要はありませんが、両方使用したい場合は切り離しておくことをおすすめいたします。
切り離した断面は150番手くらいの紙やすりで整えてください。
ミドル基板にProMicro保護プレートを取り付けます。 まず9mmスペーサをネジ止めします。
アクリル保護プレートをスペーサにネジ止めします。
トラックボール有側も無側も保護プレートの形状は共通です。表裏もありません。
トッププレートの裏面に7mmスペーサをネジ止めします。
親指キーをロープロファイル仕様で組み立てる場合は、親指キー用トッププレートに4mmスペーサを取り付けます。
トッププレートの四隅と親指用プレートにキースイッチをはめ込みます。
こうしておくとプレート同士の位置決め精度が上がります。
トッププレートとミドルアクリルプレートのネジ穴を合わせ、プレート同士を重ねます。
次に半田付けしたミドル基板もネジ穴を合わせ、キースイッチの端子がしっかりキーソケットに入ることを確認しながら重ねます。
アクリルボトムプレートの保護シートを剥がし、本体裏面に重ねてネジ止めします。
次にキーボード裏の四隅にクッションゴムを張り付けてください。
組み立てたトラックボール読み取り基板を７ピンコンスルーへ差し込みます。
わかりやすいように斜めにしていますが、基板は垂直にして差し込みます。
ボール基板が垂直に立ちました。
トラックボールケースには事前にセラミックボール3個が固定されています。
万が一セラミックボールが脱落している場合にはお手数ですが予備のセラミックボールを適当なボンドで固定してください。
セラミックボールの予備は今後ボールを紛失した時のために保管しておいてください。
ケースを振ってみて、セラミックボールが脱落しないか確認してください。
ケース下の穴へ、ケース上のピン２本が挿入できます。
上下からゆっくり力を入れて結合します。（ぴったりと結合しなくてもこの後のネジ絞めでくっつきますので大丈夫です。）
M1.7のタッピングネジを付けます。
キットには頭の小さなネジと頭の平らなネジが同梱されていますが、頭の小さなネジを使用します。
ケース裏から見て、この２個所をネジ止めします。
⚡️注意:締め付けすぎにご注意ください。
完成したケースを本体に取付けます。
ケース裏側のセンサー収納部にボール基板が入ります。
矢印で示すボール基板がケース中央くらいにくるようにしながら、上からゆっくりとはめます。
引っ掛かりがある場合は無理に押し込まず、一度引き抜いて再度入れ直してください。
それほど力を入れなくても最後まで入るはずです。
本体裏から確認するとメイン基板とボール基板の間に、矢印で示すような隙間が出来ている場合があります。
その時は、軽～くケース手前（指マークの方向）から押します。
力を入れすぎるとL字コンスルーが破損する可能性があるので、やさしく押してください。
下写真のように隙間がなくなれば、青丸部のネジ穴が合うと思います。
キットに同梱のM1.7トルクスネジの頭が平らなネジ２本を本体裏から絞めます。
この時ボール保持ケースが回転しないように指で抑えながらネジを絞めてください。
完成間近です！お好みのキースイッチとキーキャップをはめ込んでいきます。
最後に34mmトラックボールをケースに押し込んで完成です！
お疲れ様でした。
それでは最後に正規のファームウェアをProMicroに書き込みましょう。
Keyball44はReMAPに対応していますので特別なソフトをインストールしなくてもファームウェアの書き込みとキーマップの変更が可能です。Remapの使用方法については自キ温泉ガイドのサリチル酸の記事に詳しく掲載されています。
ReMAPを使用するためにREMAPカタログのKeyball44ファームウェアページを開き、Keyball44_viaのファームウェアをFLASH（書き込み）してください。
書き込みは3-7章でも書いた通り、FLASHボタンを押すと、書き込み方法の説明が表示されます。 USBケーブルを接続しているのにキーボードが認識されない場合は、はんだ付けしたRESETスイッチを素早く2回押すと認識されると思います。
⚡️注意:必ず左右両方のPro Microに同じhexファイルを書き込んでください。
ご自身でファームウェアをビルドする場合
Keyball44の最新ファームウェアはGithubのリポジトリにて公開しています。
このkeyballフォルダをお手持ちのQMK_Firmware/keyboardsへコピーして自由にキーマップ等を編集してmakeしてください。
-
トラックボールはレイヤー３に切り替わっている間は上下左右スクロールに変わります。
-
ReMAPで簡単にキーマップの確認・変更・書込みが可能です。
-
USBケーブルは左右どちらに差しても使用できます。
ただしキーマップはUSBケーブルを差した側のProMicroへ書き込まれるため、初めて差し替えた場合はキーマップを見直してください。 -
Keyballシリーズ用に特別に用意されたキーコードがレイヤー３に配置されています。
トラックボールをスクロールに変化させたり、カーソル速度やスクロール速度変更に使用できます。
詳しくは キーコード一覧 を参照してください。
⚡️注意:KeyballとPCを接続した状態（電源が入った状態）でTRSケーブルを抜くと故障の原因となります。
TRSケーブルを抜き挿しする際は必ず先にUSBケーブルを抜いてから行ってください。
以上でKeyball44のビルドガイドは終了です。
Keyball44についてのご質問や不具合等についてはGithubのリポジトリ、Yowkees/keyballのDiscussionsへご投稿ください。
なるべく早くご回答させていただきます。
―謝辞―
Keyball44のファームウェアは、KoRoN@香り屋様の多大なるご協力のおかげでトラックボールの動作が大幅にスムーズになったことに加え、メモリ容量の大幅な削減によりとてもたくさんのLEDアクションが楽しめます。このような素晴らしいファームウェアをスピーディに作成していただき、とてもスムーズにKeyball44の販売を開始することができました。この場を借りて深くお礼させていただきます。本当にありがとうございました。
@Yowkees