update firmware reference + more build guide things

This commit is contained in:
jack 2022-03-29 01:47:21 -06:00
parent 4324fdfcb3
commit 1634833f2b
No known key found for this signature in database
GPG Key ID: 38FE2D9C474B1286
4 changed files with 69 additions and 1745 deletions

View File

@ -11,32 +11,33 @@ https://github.com/foostan/crkbd/blob/master/corne-cherry/doc/v2/buildguide_en.m
| Name | Count | Remarks |
|:-|:-|:-|
| PCB | 1 set | |
| Top plate | 2 sheets | |
| Top plate | 2 sheets | 1.5mm-3mm thick |
| Bottom plate | 2 sheets | |
| OLED cover | 2 sheets | |
| ProMicro | 2 | |
| ProMicro | 2 | Alternative: [Elite-C](https://deskthority.net/wiki/Elite-C) |
| TRRS jack | 2 | |
| Reset switch | 2 | |
| Diodes | 42 | Only SMD parts are supported |
| Diodes | 42 | SMD Only (SOD-123 Package) |
| PCB sockets | 42 | Compatible with Kailh and Gateron |
| Key switches | 42 | Only compatible with CherryMX |
| Keycaps | 42 pcs | 1u 40 pcs, 1.5u 2 pcs |
| Spacer M2 7.5mm | 10 pieces | |
| Spacer M2 9mm | 4 pieces | |
| Key switches | 42 | Only compatible with MX style |
| Keycaps | 42 pieces | 1u 40 pcs, 1.5u 2 pcs |
| Spacer M2 7.5mm | 10 pieces | For Case assembly |
| Spacer M2 9mm | 4 pieces | For OLED cover |
| Screw M2 4mm | 28 screws | |
| Rubber feet | 8 pieces | |
| TRRS (4 poles) cable | 1 | TRS (3 poles) cable is also acceptable |
| Micro USB cable | 1 | |
| TRRS (4 poles) cable | 1 | TRS (3 poles) cable is also compatible |
| Micro USB cable | 1 | Avoid charge-only cables |
### Optional
| Name | Count | Remarks |
|:-|:-|:-|
| OLED module | 2 | |
| Pin header for OLED module 4 series 1.5mm | 2 | |
| 4 pin sockets for OLED module 2.5mm | 2 | |
| SK6812MINI-E | 42 pieces | LEDs for Back light |
| SK6812MINI-E | 42 | LEDs for Backlight |
| WS2812B | 12 | LEDs for Undergrow |
| [Microcontroller/OLED Sockets](https://www.digikey.com/en/products/detail/315-43-112-41-003000/ED4764-12-ND/4455232) | 1 | Alternative: [2.54 1row femal sliv](https://www.aliexpress.com/item/4001122376295.html) option |
| [Microcontroller Pins](https://www.digikey.com/en/products/detail/mill-max-manufacturing-corp/3320-0-00-15-00-00-03-0/4147392) | 48 | Alternative: Diode/Resistor legs |
| [OLED Headers](https://www.digikey.com/en/products/detail/mill-max-manufacturing-corp/350-10-164-00-006000/357045) | 1 | Soldered to OLED module |
## Firmware preparation
@ -57,11 +58,11 @@ Make sure it is the same as your PCB.
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,
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,
\**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)
@ -70,50 +71,43 @@ which are marked in red in the image below.*
### Diodes
Solder diodes for SMD components.
Since SMD parts are very small,
it is convenient to have tweezers and counter-acting tweezers.
Since SMD parts are very small, fine-tip/reverse-action tweezers are recommended.
**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.
**The diodes have a specific orientation**, so install with "|" marking on the diode
facing the "|" on the PCB marking: "|◁"
![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.
Begin with applying solder to only one 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,
Next, place SMD component while heating solder. At this time,
it is recommended to use [reverse-action tweezers](https://www.alimed.com/_resources/cache/images/product/70895A_850x480-pad.jpg),
so that you can hold the SMD part firmly without applying force,
and concentrate on alignment and soldering instead.
Also, if the soldering iron is too hot or the solder is touched too long,
the flux contained in the solder may evaporate and form an undesirable pile solder,
but since it can be repaired later,
the flux contained in the solder may evaporate and form a poor solder joint,
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.
It is okay if the SMD component is not flush with the PCB when viewed from the side.
If it is floating, press the SMD component down with tweezers or your finger and reheat the solder.
![tips_building_smd_03](https://user-images.githubusercontent.com/736191/54487437-79330280-48d9-11e9-996d-a578e767c12c.jpg)
Then solder the other pin.
Then solder the other contacts.
Be careful not to apply too much solder,
as a small amount is sufficient.
If you have applied too much,
you can remove it with a suction pump, blotting wire
or by scooping it with a soldering iron.
you can remove it with a suction pump, solder wick,
or by picking it up 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 heap,
@ -131,28 +125,24 @@ The diode is completed by soldering 42 pieces in total on the left and right.
Solder the SK6812MINI-E and WS2812B.
First, check the state after installation.
![build_led_front_overview](assets/build_led_front_overview.jpg)
All soldering is done from the back side, but the SK6812MINI-E is for Backlight
(the front side is shining) and the WS2812B is for Undergrow (the back side is shining).
![build_led_back_overview](assets/build_led_back_overview.jpg)
#### WS2812B (Undergrow)
First, solder the WS2812B.
Solder with the corners of the recesses on the WS2812B
and the corner marks on the PCB aligned as shown below.
**TIPS: As I introduced in Tips for Installing SMD Parts**,
I think that you can attach it well with spare solder.
In addition, his PCB of Corne has the same mounting orientation of his WS2812B.
Match recessed corner of the LED with marked corner on the PCB as shown below.
Refer to **TIPS: Tips for installing SMD parts** section above as similar soldering
procedure is followed.
![build_led_undergrow](assets/build_led_undergrow.jpg)
He soldered a total of 12 pieces on the left and right, and he completed the WS2812B.
WS2812B LED soldering is completed after 12 are installed on left and right.
![build_led_undergrow_overview](assets/build_led_undergrow_overview.jpg)
@ -160,21 +150,17 @@ He soldered a total of 12 pieces on the left and right, and he completed the WS2
Then solder the SK6812MINI-E.
Solder the SK6812MINI-E with the missing corners aligned with the PCB corners
as shown below.
**TIPS: As I introduced in Tips for Installing SMD Parts**,
I think that you can attach it well with spare solder.
It is harder to break than the SK6812MINI,
but it may be damaged if it is directly exposed to the heat of a soldering iron.
If the temperature is about 320°C
with a soldering iron with a temperature control function,
it seems that there is no problem even if four legs are soldered continuously.
All Corne PCBs have the same mounting orientation for the SK6812MINI-E.
Match the notched corner of the LED with the marked corner on the PCB as show below.
Refer to **TIPS: Tips for installing SMD parts** section above as similar soldering
procedure is followed.
These are more resilient than the SK6812MINI LEDs,
but still may be damaged if directly exposed to the heat of a soldering iron.
~320°C seems to be an ok temperature, evne if all four legs are soldered
one after another.
![build_led_backlight](assets/build_led_backlight.jpg)
SK6812MINI-E is completed by soldering a total of 42 pieces on the left and right.
SK6812MINI-E LED soldering is completed after 42 are installed on left and right.
![build_led_back_overview](assets/build_led_back_overview.jpg)
@ -185,17 +171,15 @@ 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.
Since these parts may fall off when soldering, you can affix them with masking tape.
### ProMicro
Solder headers to PCB. Then solder ProMicro to headers, with components facing PCB
Solder headers to PCB. Then solder ProMicro to headers, with components facing PCB as shown below.
![build_promicro](assets/build_promicro.jpg)
If you use spring-loaded pin headers (e.g. Conthrough),
If you use [spring-loaded pin headers](https://shop.yushakobo.jp/collections/all-keyboard-parts/products/31),
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)
@ -205,64 +189,55 @@ for details on how to use spring-loaded pin headers.
### 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.
Insert the pin header into the socket first, then solder the OLED module
to the pin header.
Note: Solder one pin to OLED module, then reheat solder to confirm OLED module is level,
then solder remaining pins.
![build_oled](assets/build_oled.jpg)
### 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.
Now is a good time to test your keyboard to help isolate potential problems.
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.
To check the operation, connect left and right sides with TRRS cable,
then connect left side to the computer with USB cable.
If it is done correctly so far, shorting a hotswap socket pad with tweezers will
output out a keypress and it will be displayed on the OLED module.
### PCB socket
### Switch Sockets
Solder the PCB socket according to the mark as shown below.
All the PCB sockets are listed below,
but I'm not really into it,
so attach them one by one.
**TIPS: As I introduced in Tips for Installing SMD Parts**,
I think that you can attach it well with spare solder.
Solder hotswap sockets according to mark on PCB as shown below.
Refer to **TIPS: Tips for installing SMD parts** section above as similar soldering
procedure is followed.
![build_socket](assets/build_socket.jpg)
The PCB socket is completed by soldering a total of 42 left and right.
Switch Socket soldering is completed after 42 are installed on left and right.
![build_socket_overview](assets/build_socket_overview.jpg)
### OLED protective plate
### OLED protective cover
Attach the OLED protective plate with M2 9mm spacers and M2 screws.
Attach the OLED protective cover 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)
### Plates, switches
### Plates & Switches
After attaching the key switch to the top plate,
fit the key switch into the socket.
Place a few key switches into the top plate, then line up and press into PCB socket.
If you attach all the key switches to the top plate first,
it will be more difficult to fit them in the socket,
so it is easier to attach only the end key switches first.
it will be more difficult to fit them in the PCB sockets all at once.
So it is recommended to do a few to begin with.
![build_top_plate_switches](assets/build_top_plate_switches.jpg)
Install the M2 7.5mm spacer and M2 screws on the top plate.
![build_screws_spacers_front](assets/build_screws_spacers_front.jpg)
It is easy to screw the spacer after inserting it into the hole from the back side.
It is easy to screw the spacer in after inserting it into the hole from the back side.
![build_screws_spacers_back](assets/build_screws_spacers_back.jpg)
@ -270,10 +245,10 @@ Attach the bottom plate with M2 screws.
![build_bottom_plate](assets/build_bottom_plate.jpg)
Install the cushion rubber in the following positions.
Install the rubber feet in the following positions.
![build_cushion_rubbers](assets/build_cushion_rubbers.jpg)
That's it.
That's it!
![build_finish](assets/build_finish.jpg)

File diff suppressed because it is too large Load Diff

View File

@ -22,7 +22,7 @@ Open QMK Toolbox, you will see a window like the one below.
### Flash the firmware
Download the firmware of VIA from the following link.\
[crkbd_rev1_common_via.hex](https://raw.githubusercontent.com/foostan/crkbd/main/doc/assets/crkbd_rev1_via.hex)
[crkbd_rev1_common_via.hex](https://raw.githubusercontent.com/foostan/qmk_firmware-hex/main/.build/crkbd_rev1_via.hex)
Specify the file downloaded from "**Open**" in QMK Toolbox.
And enable the check box for "**Auto-Flash**".

View File

@ -21,7 +21,7 @@ QMK Toolbox を開くと下記のようなウィンドウが表示されます
### ファームウェアの書き込み
VIA用のファームウェアを下記よりダウンロードします。\
[crkbd_rev1_common_via.hex](https://raw.githubusercontent.com/foostan/crkbd/main/doc/assets/crkbd_rev1_via.hex)
[crkbd_rev1_common_via.hex](https://raw.githubusercontent.com/foostan/qmk_firmware-hex/main/.build/crkbd_rev1_via.hex)
QMK Toolbox の 「**Open**」 からダウンロードしたファイルを指定します。\
また「**Auto-Flash**」のチェックボックスをチェックします。