> For the complete documentation index, see [llms.txt](https://beekeeb-japan.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://beekeeb-japan.gitbook.io/docs/toucan-keyboard/page.md).
# ビルドガイド
### 注意事項 ）または他の経験豊富なビルダーにご相談ください。
* バッテリーを接続する前に、**必ず極性（プラス／マイナス）を確認してください**。\
極性を誤って接続すると、電子部品の損傷や火災の危険があります。
* はんだ付けや修正を行う前に、キーボードをコンピューター、バッテリー、または電源から切断してください。
* はんだ付けや修正作業の後は、**Toucanキーボードの PCBが十分に冷めてから**、コンピューターに接続してください。
* 不適切なはんだ付けは、部品やToucanキーボードPCB を損傷する原因となります。
* はんだ付けの温度および作業時間を適切に保ち、パッドや部品に過度な熱や圧力を加えないでください。
* ホットスワップソケットやスルーホール部品など、一部の部品には**鋭利なエッジや露出したピン**が含まれる場合があります。取り扱いには十分ご注意ください。
* コンピューターに接続する前に、**ショート（短絡）が発生していないか**を必ず確認してください。\
はんだ付け箇所や配線を慎重に確認し、損傷につながる可能性のあるショートがないことを確認してください。
* **温度制御機能付きのはんだごて**の使用を推奨します。
* 飛散物やはんだの飛び散りから目を保護するため、**安全メガネを着用**してください。
* はんだやフラックスの煙を吸い込まないよう、**十分な換気**または**フュームエクストラクター**を使用してください。
* 作業スペースは**可燃物から離し**、安定した**非可燃性の作業台**の上ではんだ付けを行ってください。
* はんだ付け作業の後は、**必ず手をよく洗ってください**。
### ファームウェア書き込み
下記ページを参照し、左手側・右手側それぞれのXIAOコントローラーにファームウェアを書き込んでください。
{% content-ref url="/pages/I9hlkhXIJ12IFcCsglzR" %}
[ZMK ファームウェア](/docs/toucan-keyboard/zmk-fmuwea.md)
{% endcontent-ref %}
### コントローラーのはんだ付け
* 左手側のコントローラーを、**左側のPCB（beekeebロゴがある側）** にはんだ付けします。
* **芋はんだやショートがないか**を必ず確認してください。
{% hint style="info" %}
はんだごてのこて先は、**2mm程度のB型・C型・BC型・K型**などが使用可能です。
{% endhint %}
{% hint style="info" %}
ヤニ入りはんだを使用する場合でも、**追加でフラックスを塗布することを推奨します**。\
フラックスを使用することで、ショートや芋はんだの修正がスムーズになります。
{% endhint %}
{% hint style="info" %}
必要に応じて、**はんだ吸取線**を使用し、余分なはんだを除去してください。
{% endhint %}
* 右手側のコントローラーを、**右側のPCB（beekeebロゴがない側）** にはんだ付けします。
### ダイオードのはんだ付け
* ダイオードには**向き（極性）**があります。\
下の写真を参考に、**正しい向き**で配置してください。 \
作業の際はピンセットを使用し、はんだ付け位置にダイオードをセットします。
* 左右それぞれの基板に、**ダイオードを21 個ずつ**はんだ付けしてください。
{% hint style="info" %}
はんだ付け用の**パッドは通常よりも大きめ**に設計されています。\
これにより、手作業でのはんだ付けが**より簡単で安定しやすく**なっています。
{% endhint %}
{% hint style="info" %}
ダイオードは非常に小さい部品のため、**予備のパーツをキットに同梱**しています。
{% endhint %}
{% hint style="info" %}
作業をスムーズに行うため、**片側のパッドにあらかじめ「予備はんだ」** をしておくのがおすすめです。\
ただし、**ダイオードを載せる前に両方のパッドにはんだを盛ることは避けてください**。\
一般的なはんだごてでは両側を同時に加熱するのが難しく、かえって部品を固定しにくくなります。
{% endhint %}
{% hint style="info" %}
ダイオードの**向きを示すラインが見えにくい場合**は、ライトで照らしながら角度を変えて確認してください。
{% endhint %}
### ホットスワップソケットのはんだ付け
* 左側の PCB（**beekeeb ロゴがある側**）で、まずはコントローラー付近にある **「SW18」** のソケットを 1 つはんだ付けしてください。\
作業の順序は自由ですが、この位置は**後で動作確認がしやすいため、最初に行うのがおすすめ**です。
* ホットスワップソケットには**取り付け向きの指定はありません**。\
どちらの向きで取り付けても動作します。
* ただし、ソケットの形状は**完全な左右対称ではありません**。\
見た目をきれいに揃えたい場合は、**基板のシルク印刷に合わせて向きを揃える**と綺麗に仕上がります。
#### はんだ付け方法
* はんだ付けの際は、**ソケット下側の金属部分**と**基板のパッド**を同時に温めながら、そこにはんだを流し込みます。\
このとき、**ソケット上部の金属パーツにこて先が触れないよう注意**してください。
{% hint style="info" %}
上の写真では、**2mm程度のK型（ナイフ型）こて先**を使用しています。\
具体例としては、**C245-789 / K200 / KU / SK** などが挙げられます。
{% endhint %}
* はんだ付けが完了したら、**基板が十分に冷めるまで**少し待ちましょう。
* 作業後、**不要なショートが発生していないか**を改めて確認してください。
#### 動作確認
* PCに接続する際は、**必ずデータ転送対応のUSBケーブル**を使用してください。\
（充電専用ケーブルでは動作しません）
* ホットスワップソケットに**Choc v1 または Choc v2スイッチ**を差し込み、キー入力をテストします。\
キーを押した際に、画面に **「t」などの文字が入力されれば成功**です。
{% hint style="info" %}
**この時点では、すべてのスイッチを取り付けないでください。**\
この後、PCB とスイッチの間に**プレートとフォームを挟んで組み立てる工程**があります。
{% endhint %}
#### 仕上げ
* 動作確認が完了したら、**残りのホットスワップソケットをすべて**はんだ付けしてください。
* 右側の動作確認を行う場合も、**USBケーブルは左側の基板に接続**してください。\
本製品は、**左側が主（マスター）、右側が従（スレーブ）** として動作する仕様です。
### PCBナットのはんだ付け
* 左右それぞれの基板に、**PCBナットを9個ずつ**はんだ付けしてください。
&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.