# Lily58 ビルドガイド
## 新しいビルドガイドページを参照ください
[https://kata0510.github.io/Lily58-Document/Lily58_BG.html](https://kata0510.github.io/Lily58-Document/Lily58_BG.html)
## 必要部品
| パーツ名 | 個数 | 備考 |
|--------|-------|-------|
|Lily58 PCB | 2枚 ||
|Lily58 ケース|1セット||
|ProMicro|2個|はんだ付けの回数が減り、破損しやすいコネクタのため交換が可能になるため別売の[コンスルー](https://yushakobo.jp/shop/a01mc-00/)の使用を推奨|
|キースイッチ(CherryMX,PG1350)|58pcs ※|ALPS軸非対応|
|キーキャップ|1U 56個 1.5U 2個※|1.5Uの部分は1Uでも可|
|ダイオード 1N4148|58本(個)||
|タクトスイッチ|2個||
|TRRSジャック|2個||
|M2 スペーサー 6mm,10mm|10個,4個||
|M2 ネジ 5mm|28個||
|TRS(TRRS)ケーブル|1本|AUXケーブルと言われるオーディオ用のケーブルです|
|MicroUSBケーブル|1本|Pro Micro側のコネクタの耐久性が低いためマグネット式を推奨|
※キットには付属していないため用意が必要です。
## ダイオードを取り付ける
**ロープロファイルスイッチを使用する場合スイッチを取り付けるアクリルプレートとPCBの間の高さを稼げないため別売の[表面実装ダイオード(1N4148W)](http://akizukidenshi.com/catalog/g/gI-07084/)を使用することを推奨します。
付属の足付きダイオードを使用する場合ははんだ付けした面の飛び出しを最小限にする必要があります。(足をカットしてからはんだ付けを行う)**
このPCBはリバーシブルなので**片面づつに**部品を実装していきます。ダイオードを実装する面(オレンジの部品が見える方)が裏面の扱いになります。
横から見るとこのような図になります
ダイオードの足を曲げます。
ケース3枚を重ねた状態のものに押し当てると簡単にダイオードの足を曲げることができます。
PCBの裏側(スイッチやProMicroを取り付けるのと反対側)に折り曲げたダイオードを差し込みます。
ダイオードには向きがあります。PCBの表記を確認して正しい方向に差し込んで下さい。
以下の画像のようにダイオードの黒い線が常に基板の表示の三角形の横棒のある方向に向いた状態ではんだ付けをしてください。向きが正しくないとキーが反応しません。
裏側からはんだ付けを行いますが落ちてしまうため、マスキングテープなどで止めます。止める際にダイオードが浮かないようにテープの上から力を加えて抑えながら仮固定します。
はんだ付けを行います。
はんだ付けが終わったらダイオードの足をニッパー等でカットします。カットするときに足が飛びやすいため、手で足をつまみながらカットしましょう。
カットが終わったら10mm(長いスペーサー)を取り付けします。
## TRRSジャック/リセットスイッチをはんだ付けする
表面の左上にTRRSジャックを取り付けします。どちらも裏返してはんだ付けする際に落ちたりずれやすいのでマスキングテープなどで仮固定します。
裏側からはんだ付けをします。
## OLED用を使用する場合(オプション)
OLEDを使用する場合は表面のProMicro近くの4つのパッドをジャンパさせてください。
## Pro Microをはんだ付けする
#### コンスルーを使用する場合
[コンスルー](https://yushakobo.jp/shop/a01mc-00/)を使用する場合は以下のような取り付け方法を行ってください。
Helixの[ビルドガイド](https://github.com/MakotoKurauchi/helix/blob/master/Doc/buildguide_jp.md#pro-micro)のProMicroの章を参考にはんだ付けを行います。
ProMicro側のみはんだ付けを行い、PCB側ははんだ付けしません。
はんだ付けが終わった後は浮きが無いようにしっかりと差し込みます。
### 付属のピンを使用する場合
Pro Microを袋から取り出し、足が長い方を下にして以下の画像の赤線の内側の**PCBの線で囲まれている列を確認して**PCBに差し込みます。左右で差し込む場所が異なるため注意してください。
Pro Microをその上から部品が乗っている面を下向きにして取り付けします。
ProMicro側をはんだ付けをします。
ProMicro側をはんだ付け後マスキングテープ等で固定し基板の裏側からはんだ付けを行います。
はんだ付け後ニッパーなどで余っているピンをカットします
## キースイッチを取り付ける
トッププレートにスペーサーとキースイッチを4箇所はめ込み、ピンが曲がらないように注意しながらPCBに取り付けし、浮きや傾きが無いことを確認して4つのスイッチをはんだ付けします。
トッププレートに残りのスイッチを取り付けをします。
正常に取り付けできている場合PCBからピンの足が少し出てきますが曲がっている場合やしっかりとはまっていない場合は下側の画像のように足が出てきません。足が曲がっている場合やプレートにしっかりはまっていないので1度取り外すなどして確認して下さい。
すべてのスイッチを取り付けをしてはんだ付けをします。
## ProMicroカバーを取り付け
Pro Micro上部用のアクリルを取り付けます。
幅が広い方を外側にして取り付けます。低頭ネジで上部をネジ止めします。
## キーマップの書き込み
キーマップを書き込むために準備が必要です。導入されていることを前提に記述しております。[qmk公式のページなどを参考に導入して下さい。](https://docs.qmk.fm/#/getting_started_build_tools)
QMK Toolboxを使用すれば環境構築の必要が無く、GUIで書き込みが行うことができます。(キーマップの変更はできません)
[qmk/qmk_toolbox](https://github.com/qmk/qmk_toolbox/releases)
Lily58のデフォルトキーマップを書き込むにはqmk_firmwareのフォルダ階層で以下を実行します
make lily58:default:avrdude
**Detecting USB port, reset your controller now...** と表示されたらキーボード上のリセットボタンを押すと書き込みが始まります。
上記の要領でもう片方のキーボードにも同じように書き込みを行って下さい。
Defaultキーマップは以下のようになっています。
## 動作確認
左右をTRRSケーブル(TRSケーブル)で接続し左側のProMicro(デフォルトキーマップの場合)にMicroUSBケーブルを接続しキーが反応するかを確認して下さい。
裏面にゴム足を4箇所取り付けて完成です。お疲れ様でした。
## 困ったときは
### Q.1列(複数列)又は1行(複数行)キースイッチが反応しない
A.ProMicroのはんだ付け、取り付けしっかりとできてない場合があります。再度確認し、必要に応じて再度はんだ付け、取り付けを行ってください。
### Q.キースイッチが単体で反応しない
A.キースイッチのはんだづけ又はダイオードのはんだ付けに問題がある可能性があります。
キースイッチの場合
問題のあるキースイッチのはんだ付けを確認してください。はんだが足りてない場合は再度はんだ付けを行ってください。
ダイオードのはんだ付けの場合
ダイオードの向きを確認してください。間違っていた場合は外してはんだ付けし直してください。
はんだ付けが足りない場合は再度はんだ付けを行ってください。
**困った場合などはお気軽にDiscordサーバー([Self-Made Keyboards in Japan](https://discordapp.com/invite/NM7XtDW))の「#Lily58」チャンネルもしくはTwitter:@F_YUUCHIにメッセージをお送りください**