Initial corne-ultralight board.

* Power switch and battery pin/JST instead of TRRS.
* Gateron ks-27, choc v1, and MX support.

corne-ultralight/doc/v2/buildguide_low_edition_en.md

@@ -0,0 +1,208 @@
+# Build Guide
+
+This is the build guide for Corne Light v2 Low edition.
+
+![corne-light-low-edition-001](assets/corne-light-low-edition-001.jpg)
+![corne-light-low-edition-002](assets/corne-light-low-edition-002.jpg)
+![corne-light-low-edition-003](assets/corne-light-low-edition-003.jpg)
+
+## Parts
+
+### Required
+
+| Name | Count | Remarks |
+|:-|:-|:-|
+| PCB | 1 set | |
+| Top plate (acrylic) 2mm | 2 sheets | |
+| Bottom foam | 2 sheets | Special foam is cut out with a special mold |
+| OLED protective plate | 2 sheets | |
+| ProMicro | 2 sheets | |
+| TRRS jack | 2 | |
+| Tact switch | 2 | |
+| Diodes | 42 | Recommended SMD Parts |
+| Key switches | 42 | Kailh Choc v1 or v2 recommended |
+| Keycaps | 42 pcs | 1u 40 pcs, 1.5u 2 pcs |
+| Spacer M2 9mm | 4 pieces | |
+| Screw M2 4mm | 8 screws | |
+| TRRS (4 poles) cable | 1 | TRS (3 poles) cable is also acceptable |
+| Micro USB cable | 1 | |
+
+### Optional
+
+| Name | Count | Remarks |
+|:-|:-|:-|
+| OLED module | 2 sheets | |
+| Pin header for OLED module 4 series 1.5mm | 2 | |
+| 4 pin sockets for OLED module 2.5mm | 2 | |
+
+## Advance preparation
+
+If you build the firmware yourself,
+it takes time to prepare the environment,
+so it is recommended to start first. \
+See <https://github.com/foostan/crkbd/blob/master/doc/firmware_en.md>
+for more information.
+
+## Verification
+
+The PCB for Corne Light v2 is as follows.
+Make sure it is the same as your PCB.
+
+![confirm_front](assets/confirm_front.jpg)
+
+![confirm_back](assets/confirm_back.jpg)
+
+The PCB comes with a frame for manufacturing reasons.
+You can fold it by hand to remove it, but if it is difficult,
+make a cut in the joint \* with a cutter or similar,
+to make it easier to remove.
+In addition, the joint can be cleaned with a file.
+
+\* *Joint part: There are a total of 8 parts,
+which are marked in red in the image below.*
+
+![confirm_remove_frame](assets/confirm_remove_frame.jpg)
+
+## Assembly
+
+### Diodes
+
+Solder diodes for SMD components.
+Since SMD parts are very small,
+it is convenient to have tweezers and counter-acting tweezers.
+
+**The diode has a fixed mounting direction**,
+so solder it so that the "|" mark on the part faces the "|" on the diode mark "|◁".
+In addition, Corne's PCB has all the same diode mounting orientations.
+
+![build_diode](assets/build_diode.jpg)
+
+<details>
+<summary>TIPS: Tips for installing SMD parts</summary>
+
+The trick is to attach the SMD parts, but first, as a spare solder,
+put the solder on only one side of the pad.
+
+![tips_building_smd_01](https://user-images.githubusercontent.com/736191/54487435-79330280-48d9-11e9-9138-525d8ee68144.jpg)
+
+Next, solder one leg of the diode so that the spare solder melts.
+At this time, it is recommended to use reverse-action tweezers,
+because you can hold the chip parts firmly without exerting force
+and you can concentrate on alignment and soldering.
+Also, if the soldering iron is too hot or the solder is touched too much,
+the flux contained in the solder may evaporate and form a clean pile of solder,
+but it can be repaired later,
+so at this point you should only care about attaching parts.
+It's okay.
+
+![tips_building_smd_02](https://user-images.githubusercontent.com/736191/54487436-79330280-48d9-11e9-856e-f3f5b9f58414.jpg)
+
+It is okay if the diode does not float when viewed from the side
+when one foot is attached.
+If it floats, press the diode with tweezers or your fingers
+and reheat the soldered part with a soldering iron to clean it.
+
+![tips_building_smd_03](https://user-images.githubusercontent.com/736191/54487437-79330280-48d9-11e9-996d-a578e767c12c.jpg)
+
+Then solder the other one.
+Be careful not to apply too much,
+as a small amount of solder is sufficient.
+If you apply too much, you can remove it with a blotting wire
+or by scooping it with a soldering iron.
+
+If the amount of solder on the preliminary solder side is small,
+additional soldering is performed, and if it is a mountain,
+apply flux from above and heat it to clean it.
+
+![tips_building_smd_04](https://user-images.githubusercontent.com/736191/54487438-79cb9900-48d9-11e9-9280-dc72a2087307.jpg)
+
+</details>
+
+The diode is completed by soldering 42 pieces in total on the left and right.
+
+![build_diode_overview](assets/build_diode_overview.jpg)
+
+### TRRS jack, reset switch, pin socket for OLED
+
+Solder the TRRS jack, reset switch (tact switch),
+and OLED pin socket as shown in the picture below.
+
+![build_trrs_reset_oled](assets/build_trrs_reset_oled.jpg)
+
+Since it is a part that easily slips off,
+you can solder it while holding the part by hand,
+or fix it with masking tape and then solder it.
+
+### ProMicro
+
+Solder ProMicro in the following orientation
+
+![build_promicro](assets/build_promicro.jpg)
+
+If you use spring-loaded pin headers (e.g. Conthrough),
+you do not need to solder the back side.
+Please refer to the [Helix Build Guide](
+https://github.com/MakotoKurauchi/helix/blob/master/Doc/buildguide_en.md#pro-micro)
+for details on how to use spring-loaded pin headers.
+
+![build_promicro_conthrough](assets/build_promicro_conthrough.jpg)
+
+### OLED module
+
+Insert the pin header into the pin socket for OLED first,
+and then solder the pin header and OLED module.
+At this time, the OLED module is easy to float,
+so be careful not to float it while pressing it with your finger.
+
+![build_oled](assets/build_oled.jpg)
+
+### Firmware
+
+Write the firmware to ProMicro by referring to the following. \
+<https://github.com/foostan/crkbd/blob/master/doc/firmware_en.md>
+
+### Operation check
+
+We recommend that you check the operation when the ProMicro and OLED module are attached.
+If you do it at the very end, it will be difficult to isolate the problem.
+
+To check the operation,
+connect the left hand side to the PC with MicroUSB,
+and connect the left hand side and the right hand side with the TRRS cable.
+Since there may be defects such as jacks,
+be sure to connect the left and right instead of one by one
+before checking the operation.
+If it is done correctly so far,
+if you short the pad to attach the PCB socket with tweezers etc.,
+the key pressed on the OLED module will be displayed.
+
+### Top plate, switch
+
+After attaching the key switch to the top plate, solder the key switch.
+If you attach all the key switches to the top plate first,
+it will be more difficult to attach the switches to the board,
+so it is easier to attach only the end key switches first.
+![build_top_plate_switches](assets/build_top_plate_switches.jpg)
+
+### OLED protective plate
+
+Attach the OLED protective plate with M2 9mm spacers and M2 screws.
+
+![build_oled_plate_front](assets/build_oled_plate_front.jpg)
+![build_oled_plate_back](assets/build_oled_plate_back.jpg)
+
+Especially for the screws on the back side,
+tighten them firmly to attach the bottom foam after this.
+
+### Bottom form
+
+Finally, paste the bottom form.
+This foam has an adhesive surface on one side
+and a non-slip surface on the other side.
+Stick the adhesive side firmly to the PCB.
+
+![build_bottom_foam](assets/build_bottom_foam.jpg)
+
+That's it.
+
+![build_finish](assets/build_finish.jpg)

corne-ultralight/doc/v2/buildguide_low_edition_jp.md

@@ -0,0 +1,165 @@
+# Build Guide
+
+こちらは Corne Light v2 Low edition のビルドガイドになります。
+
+![corne-light-low-edition-001](assets/corne-light-low-edition-001.jpg)
+![corne-light-low-edition-002](assets/corne-light-low-edition-002.jpg)
+![corne-light-low-edition-003](assets/corne-light-low-edition-003.jpg)
+
+## 部品
+
+### 必須
+
+| 名前 | 数 | 備考 |
+|:-|:-|:-|
+| PCB | 1セット | |
+| トッププレート(アクリル) 2mm | 2枚 | |
+| ボトムフォーム | 2枚 | 特殊なフォームを専用の型で切り出しています |
+| OLED保護プレート | 2枚 | |
+| ProMicro | 2枚 | |
+| TRRSジャック | 2個 | |
+| タクトスイッチ | 2個 | |
+| ダイオード | 42本 | SMD部品推奨 |
+| キースイッチ | 42個 | Kailh Choc v1 or v2 推奨 |
+| キーキャップ | 42個 | 1u 40個、1.5u 2個 |
+| スペーサー M2 9mm | 4本 | |
+| ネジ M2 4mm | 8本 | |
+| TRRS(4極)ケーブル | 1本 | TRS(3極)ケーブルでも可 |
+| Micro USBケーブル | 1本 | |
+
+### オプション
+
+| 名前 | 数 | 備考 |
+|:-|:-|:-|
+| OLEDモジュール | 2枚 | |
+| OLEDモジュール用ピンヘッダ 4連 1.5mm | 2つ | |
+| OLEDモジュール用ピンソケット 4連 2.5mm | 2つ | |
+
+## 事前準備
+
+ファームウェアを自分でビルドする場合は環境を整備するのに時間がかかるのではじめに取り掛かっておくことをおすすめします。\
+詳しくは <https://github.com/foostan/crkbd/blob/master/doc/firmware_jp.md> を参照してください。
+
+## 確認
+
+Corne Light v2 のPCBは以下のものになります。お手持ちのPCBと同一のものかご確認ください。
+
+![confirm_front](assets/confirm_front.jpg)
+
+![confirm_back](assets/confirm_back.jpg)
+
+PCBは製造の都合上フレームが付いた状態となっています。
+手で折って外すことができますが、難しい場合は接合部分※にカッター等で切り込みを入れると外しやすくなります。
+また、接合部分はヤスリ等できれいにすることができます。
+
+※ 接合部分: 下記画像の赤で記した部分のこと、計8箇所あります
+
+![confirm_remove_frame](assets/confirm_remove_frame.jpg)
+
+## 組み立て
+
+### ダイオード
+
+SMD部品のダイオードのはんだづけを行います。
+SMD部品は非常に小さいためピンセット及び逆作用ピンセットがあると便利です。
+
+**ダイオードは取り付ける向きが決まっていて**、部品の「|」印が、ダイオードマーク「|◁」の「|」の方に向けるようにはんだづけを行います。
+なお、Corne の PCB はダイオードの取り付け向きがすべて統一されています。
+
+![build_diode](assets/build_diode.jpg)
+
+<details>
+<summary>TIPS: SMD部品を取り付けるコツ</summary>
+
+SMD部品を取り付けるコツですが、まずは予備ハンダとしてパットの片側のみにハンダを盛ります。
+
+![tips_building_smd_01](https://user-images.githubusercontent.com/736191/54487435-79330280-48d9-11e9-9138-525d8ee68144.jpg)
+
+次に予備ハンダを溶かすようにしてダイオードの片足をはんだ付けします。
+このとき、逆作用ピンセットを利用すると力を入れずともチップ部品をしっかりと持つことができ、位置合わせとはんだづけに集中できるのでおすすめです。
+またはんだごてがあつすぎたり、はんだを触りすぎたりするとはんだに含まれるフラックスが気化してきれいにはんだの山ができることがありますが、あとで修復できるのでこの時点ではパーツを付けることだけを意識すれば大丈夫です。
+
+![tips_building_smd_02](https://user-images.githubusercontent.com/736191/54487436-79330280-48d9-11e9-856e-f3f5b9f58414.jpg)
+
+片足をつけた段階で横から見てダイオードが浮いていなければ大丈夫です。浮いてしまった場合はダイオードをピンセットや指で押さえつけながらはんだごてではんだづけした部分を再度熱すればきれいになります。
+
+![tips_building_smd_03](https://user-images.githubusercontent.com/736191/54487437-79330280-48d9-11e9-996d-a578e767c12c.jpg)
+
+次にもう片方をはんだづけします。少量のはんだで十分なのでつけすぎに注意します。
+つけすぎてしまった場合は吸い取り線で取るか、はんだごてですくうようにすれば取れます。
+
+また予備はんだ側のはんだの量が少ない場合は追加ではんだづけを重ねて行い、山になっている場合はフラックスを上から塗って熱すればきれいになります。
+
+![tips_building_smd_04](https://user-images.githubusercontent.com/736191/54487438-79cb9900-48d9-11e9-9280-dc72a2087307.jpg)
+
+</details>
+
+左右合わせて42個をはんだづけしてダイオードは完了です。
+
+![build_diode_overview](assets/build_diode_overview.jpg)
+
+### TRRSジャック、リセットスイッチ、OLED用ピンソケット
+
+下記の写真通りにTRRSジャック、リセットスイッチ(タクトスイッチ)、OLED用ピンソケットをはんだづけします。
+
+![build_trrs_reset_oled](assets/build_trrs_reset_oled.jpg)
+
+ずれやすい部品なので、手で部品を抑えながらはんだづけするか、マスキングテープ等で固定してからはんだづけするときれいに付きます。
+
+### ProMicro
+
+ProMicroを下記のような向きではんだ付けします
+
+![build_promicro](assets/build_promicro.jpg)
+
+なお、コンスルーを利用する場合は裏側のはんだ付けをする必要はありません。
+コンスルーの詳しい利用方法は [Helix のビルドガイド](https://github.com/MakotoKurauchi/helix/blob/master/Doc/buildguide_jp.md#pro-micro)をご参照ください。
+
+![build_promicro_conthrough](assets/build_promicro_conthrough.jpg)
+
+### OLEDモジュール
+
+OLED用のピンソケットにピンヘッダを先に差し込み、その後からピンヘッダとOLEDモジュールをはんだづけします。
+このときOLEDモジュールが浮きやすいので指で押さえつけながら浮かないように気をつけます。
+
+![build_oled](assets/build_oled.jpg)
+
+### ファームウェア
+
+下記を参照しファームウェアをProMicroに書き込みます。\
+<https://github.com/foostan/crkbd/blob/master/doc/firmware_jp.md>
+
+### 動作確認
+
+ProMicroとOLEDモジュールを付けた段階で動作確認をすることをおすすめします。
+一番最後にやると問題の切り分けが難しくなります。
+
+動作確認は左手側はMicroUSBでPCとつなぎ、左手側と右手側をTRRSケーブルで接続させて行います。ジャック等の不良等もありえるので、片方ずつではなく必ず左右を接続させてから動作確認をしてください。ここまで正しくできていれば、PCBソケットを取り付けるパットをピンセット等でショートさせるとOLEDモジュールに押されたキーが表示されます。
+
+### トッププレート、スイッチ
+
+トッププレートにキースイッチに取り付けた後、キースイッチをはんだ付けします。
+先にすべてのキースイッチをトッププレートに取り付けてしまうと、スイッチを基板にはめる難易度が上がってしまうため、先に端のキースイッチのみを取り付ける方が簡単です。
+![build_top_plate_switches](assets/build_top_plate_switches.jpg)
+
+### OLED保護プレート
+
+M2 9mm のスペーサーと M2 ネジで OLED 保護プレートを取り付けます。
+
+![build_oled_plate_front](assets/build_oled_plate_front.jpg)
+![build_oled_plate_back](assets/build_oled_plate_back.jpg)
+
+特に裏側のネジについては、このあとボトムフォームを貼り付けるためしっかりと締めてください。
+
+### ボトムフォーム
+
+最後にボトムフォームを貼り付けます。
+このフォームは片側が粘着面、もう片側が滑り止め面になっています。
+粘着面をPCBにしっかいと貼り付けてください。
+
+![build_bottom_foam](assets/build_bottom_foam.jpg)
+
+以上で完成です。
+
+![build_finish](assets/build_finish.jpg)
+