diff --git a/README.md b/README.md
index 913c53e..2d5e2f8 100644
--- a/README.md
+++ b/README.md
@@ -8,7 +8,7 @@ Crkbd stands for Corne Keyboard.
- corne-classic([JP](corne-classic/doc/buildguide_jp.md)/[EN](corne-classic/doc/buildguide_en.md)):
Corne for Cherry MX switches
-- corne-cherry([JP](corne-cherry/doc/buildguide_jp.md)) ([tilting, JP](corne-cherry/doc/buildguide_tilting_tenting_plate_jp.md)):
+- corne-cherry([JP](corne-cherry/doc/buildguide_jp.md)) ([tilting, JP](corne-cherry/doc/v2/buildguide_tilting_tenting_plate_jp.md)):
Hotswappable Corne for Cherry MX switches by kailh PCB sockets.
- corne-chocolate([JP](corne-chocolate/doc/buildguide_jp.md)/[EN](corne-chocolate/doc/buildguide_en.md)):
Hotswappable Corne for Chocolate switches using Kailh PCB hot-swap sockets.
diff --git a/corne-cherry/doc/v2/buildguide_jp.md b/corne-cherry/doc/v2/buildguide_jp.md
index 59480eb..1ffab49 100644
--- a/corne-cherry/doc/v2/buildguide_jp.md
+++ b/corne-cherry/doc/v2/buildguide_jp.md
@@ -36,8 +36,8 @@
![01](https://user-images.githubusercontent.com/736191/54487431-789a6c00-48d9-11e9-9390-a8510b19ba34.jpg)
## 事前準備
-実装の途中でProMicroにファームを入れる作業がありますが、ファームをビルドする環境を整備するのは時間がかかるのではじめに取り掛かっておくことをおすすめします。
-https://docs.qmk.fm/#/newbs_getting_started こちら等を参考にし、OSに合わせて必要なものをインストールしておきます(インストールに時間がかかるため動かしつつ実装を進めると効率的です)。
+ファームウェアを自分でビルドする場合は環境を整備するのに時間がかかるのではじめに取り掛かっておくことをおすすめします。\
+詳しくは https://github.com/foostan/crkbd/blob/master/doc/firmware_jp.md を参照してください。
## 実装
@@ -150,35 +150,8 @@ ProMicroとOLEDモジュールを付けた段階で動作確認をすること
![20](https://user-images.githubusercontent.com/736191/54487451-7afcc600-48d9-11e9-8c90-2f2919bf9483.jpg)
## ファームウェア
-https://docs.qmk.fm/#/newbs_getting_started こちらを参照して頂き、ファームウェアを書き込む環境を用意します。
-
-環境ができましたら、下記コマンドで Crkbd 用にファームウェアをビルドします。
-
-```
-make crkbd:default
-```
-
-ビルドが完了したら下記コマンドを実行します。
-
-```
-make crkbd:default:avrdude
-```
-
-実行すると下記のようなログがでて、`.` が増えていくことが確認出来ると思います。
-この間にリセットスイッチを **2回** 押すとファームウェアの書き込みが完了します。
-
-```
-<省略>
-
-Checking file size of crkbd_rev1_default.hex [OK]
- * File size is fine - 27328/28672
-Copying crkbd_rev1_default.hex to qmk_firmware folder [OK]
-Detecting USB port, reset your controller now........
-```
-
-片側のProMicroにファームウェアの書き込みが完了したら、もう片方も同じ手順で書き込みを行います。
-
-以上で完成です。
+下記を参照しファームウェアをProMicroに書き込みます。\
+https://github.com/foostan/crkbd/blob/master/doc/firmware_jp.md
## LED(オプション)
SK6812MINIを取り付けていきます。
diff --git a/corne-cherry/doc/v3/buildguide_jp.md b/corne-cherry/doc/v3/buildguide_jp.md
index 1c59107..289c1fb 100644
--- a/corne-cherry/doc/v3/buildguide_jp.md
+++ b/corne-cherry/doc/v3/buildguide_jp.md
@@ -36,10 +36,8 @@
| WS2812B | 12個 | Undergrow 用 LEDs |
## 事前準備
-組み立ての途中で ProMicro にファームウェアを入れる作業がありますが、ファームウェアをビルドする環境を整備するのには時間がかかるためはじめに取り掛かっておくことをおすすめします。
-
-https://docs.qmk.fm/#/ja/newbs_getting_started を参考にし、OSに合わせて必要なものをインストールしておきます。
-インストールに時間がかかるため動かしつつ組み立てを進めると効率的です。
+ファームウェアを自分でビルドする場合は環境を整備するのに時間がかかるのではじめに取り掛かっておくことをおすすめします。\
+詳しくは https://github.com/foostan/crkbd/blob/master/doc/firmware_jp.md を参照してください。
## 確認
@@ -165,54 +163,9 @@ OLED用のピンソケットにピンヘッダを先に差し込み、その後
![build_oled](assets/build_oled.jpg)
-### ファームウェア
-https://docs.qmk.fm/#/ja/newbs_getting_started こちら等を参考にし、OSに合わせて必要なものをインストールしておきます。
-上記の事前準備にも挙げたとおり、インストールに時間がかかるため事前に用意しておくことをおすすめします。
-
-Corne 用のファームウェアは `keyboards/crkbd` です。
-なお、LEDはデフォルトでは無効になっているため、`keyboards/crkbd/rules.mk` にて `RGBLIGHT_ENABLE = yes` と変更する必要があります。
-
-```diff
-diff --git a/keyboards/crkbd/rules.mk b/keyboards/crkbd/rules.mk
-index 30de5b388..174dd5c7e 100644
---- a/keyboards/crkbd/rules.mk
-+++ b/keyboards/crkbd/rules.mk
-@@ -26,7 +26,7 @@ MIDI_ENABLE = no # MIDI controls
- AUDIO_ENABLE = no # Audio output on port C6
- UNICODE_ENABLE = no # Unicode
- BLUETOOTH_ENABLE = no # Enable Bluetooth with the Adafruit EZ-Key HID
--RGBLIGHT_ENABLE = no # Enable WS2812 RGB underlight.
-+RGBLIGHT_ENABLE = yes # Enable WS2812 RGB underlight.
-
- # Do not enable SLEEP_LED_ENABLE. it uses the same timer as BACKLIGHT_ENABLE
- SLEEP_LED_ENABLE = no # Breathing sleep LED during USB suspend
-```
-
-環境ができたら、下記コマンドでファームウェアをビルドします。
-
-```bash
-make crkbd:default
-```
-
-ビルドが完了したら下記コマンドを実行します。
-
-```bash
-make crkbd:default:avrdude
-```
-
-実行すると下記のようなログがでて、`.` が増えていくことが確認出来ると思います。
-この間にリセットスイッチを **2回** 押すとファームウェアの書き込みが完了します。
-
-```bash
-<省略>
-
-Checking file size of crkbd_rev1_default.hex [OK]
- * File size is fine - 27328/28672
-Copying crkbd_rev1_default.hex to qmk_firmware folder [OK]
-Detecting USB port, reset your controller now........
-```
-
-片側のProMicroにファームウェアの書き込みが完了したら、もう片方も同じ手順で書き込みを行います。
+## ファームウェア
+下記を参照しファームウェアをProMicroに書き込みます。\
+https://github.com/foostan/crkbd/blob/master/doc/firmware_jp.md
### 動作確認
ProMicroとOLEDモジュールを付けた段階で動作確認をすることをおすすめします。
diff --git a/corne-cherry/pcb/corne-cherry.kicad_pcb b/corne-cherry/pcb/corne-cherry.kicad_pcb
index 0774140..d0d50ad 100644
--- a/corne-cherry/pcb/corne-cherry.kicad_pcb
+++ b/corne-cherry/pcb/corne-cherry.kicad_pcb
@@ -94,11 +94,11 @@
(plotinvisibletext false)
(padsonsilk false)
(subtractmaskfromsilk false)
- (outputformat 1)
+ (outputformat 5)
(mirror false)
(drillshape 0)
(scaleselection 1)
- (outputdirectory "./garber"))
+ (outputdirectory "./svg"))
)
(net 0 "")
diff --git a/corne-cherry/pcb/kbd b/corne-cherry/pcb/kbd
index e6b740e..f90510c 160000
--- a/corne-cherry/pcb/kbd
+++ b/corne-cherry/pcb/kbd
@@ -1 +1 @@
-Subproject commit e6b740e597b23f9370d4f8f19beb0164f4eac087
+Subproject commit f90510c11b6df53bcdb55740b0d59183957e4036
diff --git a/corne-cherry/pcb/svg/corne-cherry-B_Cu.svg b/corne-cherry/pcb/svg/corne-cherry-B_Cu.svg
new file mode 100644
index 0000000..7ab1563
--- /dev/null
+++ b/corne-cherry/pcb/svg/corne-cherry-B_Cu.svg
@@ -0,0 +1,11959 @@
+
+
+
diff --git a/corne-cherry/pcb/svg/corne-cherry-B_Mask.svg b/corne-cherry/pcb/svg/corne-cherry-B_Mask.svg
new file mode 100644
index 0000000..873d52f
--- /dev/null
+++ b/corne-cherry/pcb/svg/corne-cherry-B_Mask.svg
@@ -0,0 +1,7346 @@
+
+
+
diff --git a/corne-cherry/pcb/svg/corne-cherry-B_SilkS.svg b/corne-cherry/pcb/svg/corne-cherry-B_SilkS.svg
new file mode 100644
index 0000000..0548152
--- /dev/null
+++ b/corne-cherry/pcb/svg/corne-cherry-B_SilkS.svg
@@ -0,0 +1,9056 @@
+
+
+
diff --git a/corne-cherry/pcb/svg/corne-cherry-Edge_Cuts.svg b/corne-cherry/pcb/svg/corne-cherry-Edge_Cuts.svg
new file mode 100644
index 0000000..f2603bd
--- /dev/null
+++ b/corne-cherry/pcb/svg/corne-cherry-Edge_Cuts.svg
@@ -0,0 +1,3091 @@
+
+
+
diff --git a/corne-cherry/pcb/svg/corne-cherry-F_Cu.svg b/corne-cherry/pcb/svg/corne-cherry-F_Cu.svg
new file mode 100644
index 0000000..8f3caf2
--- /dev/null
+++ b/corne-cherry/pcb/svg/corne-cherry-F_Cu.svg
@@ -0,0 +1,4634 @@
+
+
+
diff --git a/corne-cherry/pcb/svg/corne-cherry-F_Mask.svg b/corne-cherry/pcb/svg/corne-cherry-F_Mask.svg
new file mode 100644
index 0000000..d07edfc
--- /dev/null
+++ b/corne-cherry/pcb/svg/corne-cherry-F_Mask.svg
@@ -0,0 +1,3326 @@
+
+
+
diff --git a/corne-cherry/pcb/svg/corne-cherry-F_SilkS.svg b/corne-cherry/pcb/svg/corne-cherry-F_SilkS.svg
new file mode 100644
index 0000000..345ba53
--- /dev/null
+++ b/corne-cherry/pcb/svg/corne-cherry-F_SilkS.svg
@@ -0,0 +1,5444 @@
+
+
+
diff --git a/corne-chocolate/doc/buildguide_en.md b/corne-chocolate/doc/buildguide_en.md
index 10fa2fc..6cebb5d 100644
--- a/corne-chocolate/doc/buildguide_en.md
+++ b/corne-chocolate/doc/buildguide_en.md
@@ -37,10 +37,8 @@ This is the build guide for Corne Chocolate.
| SK6812MINI | 54 | 42 for backlight, 12 for under-glow |
## Preparation
-
-It is recommended to [flash the firmware](#firmware) onto the Pro Micro before doing anything else,
-as it is time-consuming to prepare the environment for building it,
-and doing it in the middle of the soldering process is a hassle.
+If you build the firmware yourself, it will take some time to set up the environment, so it's best to start at the beginning. \
+For more information, please see https://github.com/foostan/crkbd/blob/master/doc/firmware_en.md.
## Building
@@ -254,41 +252,8 @@ because it looks better.
![](https://user-images.githubusercontent.com/736191/52534914-00e19a80-2d8b-11e9-8005-7e0b157e09e4.png)
## Firmware
-
-Refer to [the QMK _getting started_ guide](https://docs.qmk.fm/#/newbs_getting_started),
-and install the necessary software according to your OS
-(it takes quite some time to install).
-
-Once the environment is ready,
-build the firmware for Crkbd with the following command.
-
-```
-make crkbd: default
-```
-
-When the build is completed,
-execute the following command.
-
-```
-make crkbd: default: avrdude
-```
-
-When you execute it,
-you will see the following log,
-and you can progress by `.`s appearing.
-Press the reset switch **twice** during this time to complete the firmware writing.
-
-```
-
-
-Checking file size of crkbd_rev1_default.hex [OK]
- * File size is fine-27328/28672
-Copying crkbd_rev1_default.hex to qmk_firmware folder [OK]
-Detecting USB port, reset your controller now ........
-```
-
-Once the firmware has been written to one side of the Pro Micro,
-follow the same procedure for the other side.
+See below to flash the firmware to the ProMicro. \
+https://github.com/foostan/crkbd/blob/master/doc/firmware_en.md
This is the end.
diff --git a/corne-chocolate/doc/buildguide_jp.md b/corne-chocolate/doc/buildguide_jp.md
index 24e2a14..3ea72f2 100644
--- a/corne-chocolate/doc/buildguide_jp.md
+++ b/corne-chocolate/doc/buildguide_jp.md
@@ -34,8 +34,8 @@
| SK6812MINI | 54個 | 上向き実装 42個、下向き実装 12個 |
## 事前準備
-実装の途中でProMicroにファームを入れる作業がありますが、ファームをビルドする環境を整備するのは時間がかかるのではじめに取り掛かっておくことをおすすめします。
-https://docs.qmk.fm/#/newbs_getting_started こちら等を参考にし、OSに合わせて必要なものをインストールしておきます(インストールに時間がかかるため動かしつつ実装を進めると効率的です)。
+ファームウェアを自分でビルドする場合は環境を整備するのに時間がかかるのではじめに取り掛かっておくことをおすすめします。\
+詳しくは https://github.com/foostan/crkbd/blob/master/doc/firmware_jp.md を参照してください。
## 実装
@@ -191,33 +191,8 @@ LEDは4つずつはんだづけを行いますが、一度に4つ行わず
![33](https://user-images.githubusercontent.com/736191/52534914-00e19a80-2d8b-11e9-8005-7e0b157e09e4.png)
## ファームウェア
-https://docs.qmk.fm/#/newbs_getting_started こちらを参照して頂き、ファームウェアを書き込む環境を用意します。
-
-環境ができましたら、下記コマンドで Crkbd 用にファームウェアをビルドします。
-
-```
-make crkbd:default
-```
-
-ビルドが完了したら下記コマンドを実行します。
-
-```
-make crkbd:default:avrdude
-```
-
-実行すると下記のようなログがでて、`.` が増えていくことが確認出来ると思います。
-この間にリセットスイッチを **2回** 押すとファームウェアの書き込みが完了します。
-
-```
-<省略>
-
-Checking file size of crkbd_rev1_default.hex [OK]
- * File size is fine - 27328/28672
-Copying crkbd_rev1_default.hex to qmk_firmware folder [OK]
-Detecting USB port, reset your controller now........
-```
-
-片側のProMicroにファームウェアの書き込みが完了したら、もう片方も同じ手順で書き込みを行います。
+下記を参照しファームウェアをProMicroに書き込みます。\
+https://github.com/foostan/crkbd/blob/master/doc/firmware_jp.md
以上で完成です。
diff --git a/corne-classic/doc/buildguide_en.md b/corne-classic/doc/buildguide_en.md
index affe21c..150426d 100644
--- a/corne-classic/doc/buildguide_en.md
+++ b/corne-classic/doc/buildguide_en.md
@@ -29,6 +29,10 @@
![image](https://user-images.githubusercontent.com/736191/40734610-e1ca0136-6473-11e8-8ac7-7bfa4b843f93.png)
+## Preparation
+If you build the firmware yourself, it will take some time to set up the environment, so it's best to start at the beginning. \
+For more information, please see https://github.com/foostan/crkbd/blob/master/doc/firmware_en.md.
+
## Soldering
PCB is reversible; use one for the left hand side and the other for the right.
@@ -193,34 +197,8 @@ Lastly install keycaps.
## Firmware
-Setup firmware build environment following the instructions here:
-https://docs.qmk.fm/#/newbs_getting_started
-
-Then build firmware for Crkbd with this command:
-
-```
-make crkbd:default
-```
-
-To flash the firmware image you have just built, execute this:
-
-```
-make crkbd:default:avrdude
-```
-
-You will see `.` after a message like below.
-While you see `.` is being printed on the screen, push the reset switch __twice__.
-
-```
-(snip)
-
-Checking file size of crkbd_rev1_default.hex [OK]
- * File size is fine - 27328/28672
-Copying crkbd_rev1_default.hex to qmk_firmware folder [OK]
-Detecting USB port, reset your controller now........
-```
-
-Flash the firmware to the other side as well.
+See below to flash the firmware to the ProMicro. \
+https://github.com/foostan/crkbd/blob/master/doc/firmware_en.md
### Turning LEDS on
To turn the LEDs on, you have to edit the `rules.mk` file. If you use the default layout, it can be found here `keyboards/crkbd/keymaps/default/rules.mk`. Add the following line to the top of the file:
diff --git a/corne-classic/doc/buildguide_jp.md b/corne-classic/doc/buildguide_jp.md
index e9758a6..8821d2f 100644
--- a/corne-classic/doc/buildguide_jp.md
+++ b/corne-classic/doc/buildguide_jp.md
@@ -30,8 +30,8 @@
![image](https://user-images.githubusercontent.com/736191/40734610-e1ca0136-6473-11e8-8ac7-7bfa4b843f93.png)
## 事前準備
-実装の途中でProMicroにファームを入れる作業がありますが、ファームをビルドする環境を整備するのは時間がかかるのではじめに取り掛かっておくことをおすすめします。
-https://docs.qmk.fm/#/newbs_getting_started こちら等を参考にし、OSに合わせて必要なものをインストールしておきます(インストールに時間がかかるため動かしつつ実装を進めると効率的です)。
+ファームウェアを自分でビルドする場合は環境を整備するのに時間がかかるのではじめに取り掛かっておくことをおすすめします。\
+詳しくは https://github.com/foostan/crkbd/blob/master/doc/firmware_jp.md を参照してください。
## 実装
@@ -179,32 +179,7 @@ LEDを実装した場合はすべて点灯することを確認します。
![lrg_dsc03895](https://user-images.githubusercontent.com/736191/40888756-c371e264-6796-11e8-8fc5-e842e8baf2b8.png)
## ファームウェア
-https://docs.qmk.fm/#/newbs_getting_started こちらを参照して頂き、ファームウェアを書き込む環境を用意します。
-
-環境ができましたら、下記コマンドで Crkbd 用にファームウェアをビルドします。
-
-```
-make crkbd:default
-```
-
-ビルドが完了したら下記コマンドを実行します。
-
-```
-make crkbd:default:avrdude
-```
-
-実行すると下記のようなログがでて、`.` が増えていくことが確認出来ると思います。
-この間にリセットスイッチを __2回__ 押すとファームウェアの書き込みが完了します。
-
-```
-<省略>
-
-Checking file size of crkbd_rev1_default.hex [OK]
- * File size is fine - 27328/28672
-Copying crkbd_rev1_default.hex to qmk_firmware folder [OK]
-Detecting USB port, reset your controller now........
-```
-
-片側のProMicroにファームウェアの書き込みが完了したら、もう片方も同じ手順で書き込みを行います。
+下記を参照しファームウェアをProMicroに書き込みます。\
+https://github.com/foostan/crkbd/blob/master/doc/firmware_jp.md
以上で完成です。
diff --git a/corne-light/doc/v1/buildguide_jp.md b/corne-light/doc/v1/buildguide_jp.md
index 2d949ea..4bd297d 100644
--- a/corne-light/doc/v1/buildguide_jp.md
+++ b/corne-light/doc/v1/buildguide_jp.md
@@ -110,8 +110,8 @@
## 事前準備
-実装の途中でProMicroにファームを入れる作業がありますが、ファームをビルドする環境を整備するのは時間がかかるのではじめに取り掛かっておくことをおすすめします。
-https://docs.qmk.fm/#/newbs_getting_started こちら等を参考にし、OSに合わせて必要なものをインストールしておきます(インストールに時間がかかるため動かしつつ実装を進めると効率的です)。
+ファームウェアを自分でビルドする場合は環境を整備するのに時間がかかるのではじめに取り掛かっておくことをおすすめします。\
+詳しくは https://github.com/foostan/crkbd/blob/master/doc/firmware_jp.md を参照してください。
## 実装
### PCBの切り離し
@@ -171,35 +171,8 @@ https://docs.qmk.fm/#/newbs_getting_started こちら等を参考にし、OSに
### ファームウェアの書き込み
-ProMicroとOLEDモジュールを付けた段階でファームウェアを書き込み、動作確認をすることをおすすめします(キースイッチを付けたあとに不具合が見つかると厄介です)。
-
-https://docs.qmk.fm/#/newbs_getting_started こちらを参照し、ファームウェアを書き込む環境を用意します。
-
-環境ができたら下記コマンドで Crkbd 用にファームウェアをビルドします。
-
-```
-make crkbd:default
-```
-
-ビルドが完了したら下記コマンドを実行します。
-
-```
-make crkbd:default:avrdude
-```
-
-実行すると下記のようなログがでて、`.` が増えていくことが確認出来ると思います。
-この間にリセットスイッチを **2回** 押すとファームウェアの書き込みが完了します。
-
-```
-<省略>
-
-Checking file size of crkbd_rev1_default.hex [OK]
- * File size is fine - 27328/28672
-Copying crkbd_rev1_default.hex to qmk_firmware folder [OK]
-Detecting USB port, reset your controller now........
-```
-
-片側のProMicroにファームウェアの書き込みが完了したら、もう片方も同じ手順で書き込みを行います。
+下記を参照しファームウェアをProMicroに書き込みます。\
+https://github.com/foostan/crkbd/blob/master/doc/firmware_jp.md
### 動作確認
diff --git a/corne-light/doc/v2/buildguide_low_edition_jp.md b/corne-light/doc/v2/buildguide_low_edition_jp.md
index 737ac15..592fc96 100644
--- a/corne-light/doc/v2/buildguide_low_edition_jp.md
+++ b/corne-light/doc/v2/buildguide_low_edition_jp.md
@@ -33,10 +33,8 @@
| OLEDモジュール用ピンソケット 4連 2.5mm | 2つ | |
## 事前準備
-組み立ての途中で ProMicro にファームウェアを入れる作業がありますが、ファームウェアをビルドする環境を整備するのには時間がかかるためはじめに取り掛かっておくことをおすすめします。
-
-https://docs.qmk.fm/#/ja/newbs_getting_started を参考にし、OSに合わせて必要なものをインストールしておきます。
-インストールに時間がかかるため動かしつつ組み立てを進めると効率的です。
+ファームウェアを自分でビルドする場合は環境を整備するのに時間がかかるのではじめに取り掛かっておくことをおすすめします。\
+詳しくは https://github.com/foostan/crkbd/blob/master/doc/firmware_jp.md を参照してください。
## 確認
@@ -120,53 +118,8 @@ OLED用のピンソケットにピンヘッダを先に差し込み、その後
![build_oled](assets/build_oled.jpg)
### ファームウェア
-https://docs.qmk.fm/#/ja/newbs_getting_started こちら等を参考にし、OSに合わせて必要なものをインストールしておきます。
-上記の事前準備にも挙げたとおり、インストールに時間がかかるため事前に用意しておくことをおすすめします。
-
-Corne 用のファームウェアは `keyboards/crkbd` です。
-なお、LEDはデフォルトでは無効になっているため、`keyboards/crkbd/rules.mk` にて `RGBLIGHT_ENABLE = yes` と変更する必要があります。
-
-```diff
-diff --git a/keyboards/crkbd/rules.mk b/keyboards/crkbd/rules.mk
-index 30de5b388..174dd5c7e 100644
---- a/keyboards/crkbd/rules.mk
-+++ b/keyboards/crkbd/rules.mk
-@@ -26,7 +26,7 @@ MIDI_ENABLE = no # MIDI controls
- AUDIO_ENABLE = no # Audio output on port C6
- UNICODE_ENABLE = no # Unicode
- BLUETOOTH_ENABLE = no # Enable Bluetooth with the Adafruit EZ-Key HID
--RGBLIGHT_ENABLE = no # Enable WS2812 RGB underlight.
-+RGBLIGHT_ENABLE = yes # Enable WS2812 RGB underlight.
-
- # Do not enable SLEEP_LED_ENABLE. it uses the same timer as BACKLIGHT_ENABLE
- SLEEP_LED_ENABLE = no # Breathing sleep LED during USB suspend
-```
-
-環境ができたら、下記コマンドでファームウェアをビルドします。
-
-```bash
-make crkbd:default
-```
-
-ビルドが完了したら下記コマンドを実行します。
-
-```bash
-make crkbd:default:avrdude
-```
-
-実行すると下記のようなログがでて、`.` が増えていくことが確認出来ると思います。
-この間にリセットスイッチを **2回** 押すとファームウェアの書き込みが完了します。
-
-```bash
-<省略>
-
-Checking file size of crkbd_rev1_default.hex [OK]
- * File size is fine - 27328/28672
-Copying crkbd_rev1_default.hex to qmk_firmware folder [OK]
-Detecting USB port, reset your controller now........
-```
-
-片側のProMicroにファームウェアの書き込みが完了したら、もう片方も同じ手順で書き込みを行います。
+下記を参照しファームウェアをProMicroに書き込みます。\
+https://github.com/foostan/crkbd/blob/master/doc/firmware_jp.md
### 動作確認
ProMicroとOLEDモジュールを付けた段階で動作確認をすることをおすすめします。
diff --git a/corne-light/pcb/kbd b/corne-light/pcb/kbd
index f829a12..f90510c 160000
--- a/corne-light/pcb/kbd
+++ b/corne-light/pcb/kbd
@@ -1 +1 @@
-Subproject commit f829a12d88a0cb7cf553ddcb0b7139f8a2abec80
+Subproject commit f90510c11b6df53bcdb55740b0d59183957e4036
diff --git a/doc/assets/qmk_toolbox_begin.jpg b/doc/assets/qmk_toolbox_begin.jpg
new file mode 100644
index 0000000..386c8c3
Binary files /dev/null and b/doc/assets/qmk_toolbox_begin.jpg differ
diff --git a/doc/assets/qmk_toolbox_download.jpg b/doc/assets/qmk_toolbox_download.jpg
new file mode 100644
index 0000000..95de5b8
Binary files /dev/null and b/doc/assets/qmk_toolbox_download.jpg differ
diff --git a/doc/assets/qmk_toolbox_flash.jpg b/doc/assets/qmk_toolbox_flash.jpg
new file mode 100644
index 0000000..53b7f8e
Binary files /dev/null and b/doc/assets/qmk_toolbox_flash.jpg differ
diff --git a/doc/assets/qmk_toolbox_flashed.jpg b/doc/assets/qmk_toolbox_flashed.jpg
new file mode 100644
index 0000000..fcc2cd6
Binary files /dev/null and b/doc/assets/qmk_toolbox_flashed.jpg differ
diff --git a/doc/assets/via_begin.jpg b/doc/assets/via_begin.jpg
new file mode 100644
index 0000000..4779b5c
Binary files /dev/null and b/doc/assets/via_begin.jpg differ
diff --git a/doc/assets/via_download.jpg b/doc/assets/via_download.jpg
new file mode 100644
index 0000000..5f7b2f2
Binary files /dev/null and b/doc/assets/via_download.jpg differ
diff --git a/doc/assets/via_keymap_configure.jpg b/doc/assets/via_keymap_configure.jpg
new file mode 100644
index 0000000..c614983
Binary files /dev/null and b/doc/assets/via_keymap_configure.jpg differ
diff --git a/doc/assets/via_keymap_tester.jpg b/doc/assets/via_keymap_tester.jpg
new file mode 100644
index 0000000..2d01f56
Binary files /dev/null and b/doc/assets/via_keymap_tester.jpg differ
diff --git a/doc/assets/via_keymap_tester_matrix.jpg b/doc/assets/via_keymap_tester_matrix.jpg
new file mode 100644
index 0000000..ea70da0
Binary files /dev/null and b/doc/assets/via_keymap_tester_matrix.jpg differ
diff --git a/doc/assets/via_lighting.jpg b/doc/assets/via_lighting.jpg
new file mode 100644
index 0000000..2170beb
Binary files /dev/null and b/doc/assets/via_lighting.jpg differ
diff --git a/doc/firmware_en.md b/doc/firmware_en.md
new file mode 100644
index 0000000..cbdc973
--- /dev/null
+++ b/doc/firmware_en.md
@@ -0,0 +1,124 @@
+
+# Firmware
+
+## Flash the firmware
+
+There are several ways to flash the firmware, but using [QMK Toolbox](https://github.com/qmk/qmk_toolbox) is the easiest way.
+
+### Download QMK Toolbox
+Download QMK Toolbox from the following link.\
+https://github.com/qmk/qmk_toolbox/releases/
+
+![qmk_toolbox_download](assets/qmk_toolbox_download.jpg)
+
+Install QMK Toolbox from the downloaded file. \
+Follow the instructions for each operating system for installation.
+
+Open QMK Toolbox, you will see a window like the one below.
+
+![qmk_toolbox_begin](assets/qmk_toolbox_begin.jpg)
+
+### Flash the firmware
+
+Download the firmware of VIA from the following link.\
+[crkbd_rev1_common_via.hex](https://github.com/foostan/qmk_firmware-hex/releases/download/release-20201103/crkbd_rev1_common_via.hex)
+
+Specify the file downloaded from "**Open**" in QMK Toolbox.
+And enable the check box for "**Auto-Flash**".
+
+![qmk_toolbox_flash](assets/qmk_toolbox_flash.jpg)
+
+With the keyboard connected via USB, press the reset button to start flashing the firmware. \
+If you see the message, it's done.
+
+![qmk_toolbox_flashed](assets/qmk_toolbox_flashed.jpg)
+
+Once the firmware has been written to one side of the Pro Micro,
+follow the same procedure for the other side.
+
+### (Optional) If you build the firmware yourself
+
+Refer to [the QMK _getting started_ guide](https://docs.qmk.fm/#/newbs_getting_started),
+and install the necessary software according to your OS
+(it takes quite some time to install).
+
+Once the environment is ready,
+build the firmware for Crkbd with the following command.
+
+```
+make crkbd/rev1/common:via
+```
+
+When the build is completed,
+execute the following command.
+
+```
+make crkbd/rev1/common:via:avrdude
+```
+
+When you execute it,
+you will see the following log,
+and you can progress by `.`s appearing.
+Press the reset switch **twice** during this time to complete the firmware writing.
+Depending on the ProMicro, it may be one time.
+
+```
+
+
+Checking file size of crkbd_rev1_default.hex [OK]
+ * File size is fine-27328/28672
+Copying crkbd_rev1_default.hex to qmk_firmware folder [OK]
+Detecting USB port, reset your controller now ........
+```
+
+Once the firmware has been written to one side of the Pro Micro,
+follow the same procedure for the other side.
+
+## Change your keymap
+
+The Corne Keyboard is supported by [VIA](https://caniusevia.com/). \
+It can be used by flashing the firmware for VIA as described above.
+
+### Download VIA
+
+Download VIA from the following link.\
+https://github.com/the-via/releases/releases/
+
+![via_download](assets/via_download.jpg)
+
+Install VIA from the downloaded file. \
+Follow the instructions for each operating system for installation.
+
+When VIA is opened with the keyboard plugged in, the following window will appear.
+
+![via_begin](assets/via_begin.jpg)
+
+### KEYMAP / CONFIGURE
+
+In this screen, you can change the key map.
+
+There are several types of keys that can be changed and you can find them in the "1" area.
+If you want to change the key, click on "2" to change the key and "3" to select the key you want to change.
+VIA instantly changes the keymap.
+
+![via_keymap_configure](assets/via_keymap_configure.jpg)
+
+### KEYMAP / TESTER
+
+In this screen, you can test the operation of the keymap.
+
+You can confirm that the key is set correctly by checking that the color of the key you press changes.
+
+![via_keymap_tester](assets/via_keymap_tester.jpg)
+
+Test Matrix allows you to check the operation of each switch on the keyboard.
+It is easier to check the operation of each switch after build.
+
+![via_keymap_tester_matrix](assets/via_keymap_tester_matrix.jpg)
+
+### LIGHTING
+
+In this screen, you can change the pattern and color of the LEDs.
+
+![via_lighitng](assets/via_lighting.jpg)
+
diff --git a/doc/firmware_jp.md b/doc/firmware_jp.md
new file mode 100644
index 0000000..f0fead9
--- /dev/null
+++ b/doc/firmware_jp.md
@@ -0,0 +1,113 @@
+# ファームウェア
+
+## ファームウェアの書き込み
+
+ファームウェアの書き込み方法はいくつか用意されていますが、[QMK Toolbox](https://github.com/qmk/qmk_toolbox) を利用する方法が手軽です。
+
+### QMK Toolbox のダウンロード
+下記のURLから最新版の QMK Toolbox をダウンロードします。\
+https://github.com/qmk/qmk_toolbox/releases/
+
+![qmk_toolbox_download](assets/qmk_toolbox_download.jpg)
+
+ダウンロードしたファイルから QMK Toolbox をインストールします。\
+インストール方法は各OSの指示に従ってください。
+
+QMK Toolbox を開くと下記のようなウィンドウが表示されます。
+
+![qmk_toolbox_begin](assets/qmk_toolbox_begin.jpg)
+
+### ファームウェアの書き込み
+
+VIA用のファームウェアを下記よりダウンロードします。\
+[crkbd_rev1_common_via.hex](https://github.com/foostan/qmk_firmware-hex/releases/download/release-20201103/crkbd_rev1_common_via.hex)
+
+QMK Toolbox の 「**Open**」 からダウンロードしたファイルを指定します。\
+また「**Auto-Flash**」のチェックボックスをチェックします。
+
+![qmk_toolbox_flash](assets/qmk_toolbox_flash.jpg)
+
+この状態でキーボードをUSBで接続し、リセットボタンを押すとファームウェアの書き込みが始まります。\
+下記のように書き込みのメッセージが表示されれば完了です。
+
+![qmk_toolbox_flashed](assets/qmk_toolbox_flashed.jpg)
+
+片側のProMicroにファームウェアの書き込みが完了したら、もう片方も同じ手順で書き込みを行います。
+
+### (オプション) 自分でファームウェアをビルドする場合
+
+https://docs.qmk.fm/#/newbs_getting_started こちらを参照して頂き、ファームウェアを書き込む環境を用意します。
+
+環境ができましたら、下記コマンドで Crkbd 用にファームウェアをビルドします。
+
+```
+make crkbd/rev1/common:via
+```
+
+ビルドが完了したら下記コマンドを実行します。
+
+```
+make crkbd/rev1/common:via:avrdude
+```
+
+実行すると下記のようなログがでて、`.` が増えていくことが確認出来ると思います。
+この間にリセットスイッチを **2回** 押すとファームウェアの書き込みが完了します。
+なおProMicroによって1回の場合もあります。
+
+```
+<省略>
+
+Checking file size of crkbd_rev1_common_via.hex [OK]
+ * File size is fine - 27328/28672
+Copying crkbd_rev1_common_via.hex to qmk_firmware folder [OK]
+Detecting USB port, reset your controller now........
+```
+
+片側のProMicroにファームウェアの書き込みが完了したら、もう片方も同じ手順で書き込みを行います。
+
+## キーマップの変更
+
+Corne Keyboard は [VIA](https://caniusevia.com/) に対応しています。\
+上記の手順で VIA 用のファームウェアを書き込むことで利用することできます。
+
+### VIA のダウンロード
+下記のURLから最新版の VIA をダウンロードします。\
+https://github.com/the-via/releases/releases/
+
+![via_download](assets/via_download.jpg)
+
+ダウンロードしたファイルから VIA をインストールします。\
+インストール方法は各OSの指示に従ってください。
+
+キーボードを接続した状態で VIA を開くと下記のようなウィンドウが表示されます。
+
+![via_begin](assets/via_begin.jpg)
+
+### KEYMAP / CONFIGURE
+
+この画面ではキーマップが変更できます。
+
+変更可能なキーはいくつかの種類に分類されていて、「1」のエリアから探すことができます。
+キーを変更する場合は「2」変更する場所をクリックし、「3」変更したいキーを選択します。
+なお VIA では瞬時にキーマップが書き換わります。
+
+![via_keymap_configure](assets/via_keymap_configure.jpg)
+
+### KEYMAP / TESTER
+
+この画面ではキーマップの動作テストができます。
+
+押したキーの色が変わることでキーが正しく設定されていることが確認できます。
+
+![via_keymap_tester](assets/via_keymap_tester.jpg)
+
+Test Matrix ではキーボードの各スイッチの動作確認ができます。
+実装後の動作確認はこちらで行ったほうがわかりやすいです。
+
+![via_keymap_tester_matrix](assets/via_keymap_tester_matrix.jpg)
+
+### LIGHTING
+
+この画面ではLEDのパターンや色の変更ができます。
+
+![via_lighitng](assets/via_lighting.jpg)