Add all missing English translations of MD documents

... using Google translate + manual MD syntax fixing
This commit is contained in:
hoijui
2021-04-17 15:22:45 +02:00
parent bf513928c6
commit 9269c04e5c
8 changed files with 1072 additions and 4 deletions

View File

@@ -0,0 +1,8 @@
# Build Guide
This is the Corne Light build guide.
The build guide differs depending on the version,
so please choose your own from the following.
- [v1 build guide](https://github.com/foostan/crkbd/blob/master/corne-light/doc/v1/buildguide_en.md)
- [v2 low-edition build guide](https://github.com/foostan/crkbd/blob/master/corne-light/doc/v2/buildguide_low_edition_en.md)

View File

@@ -0,0 +1,244 @@
# Build Guide
This is the Corne Light build guide.
## Parts
<table>
<thead>
<tr> <td width = "30%"> Name </td> <td width = "15%"> Number </td> <td> Remarks </td> </tr>
</header>
<tbody>
<tr>
<td> PCB </td>
<td> 1 set </td>
<td>
![PCB](https://user-images.githubusercontent.com/736191/69554623-6be02300-0fe5-11ea-879d-9e4316df0226.JPG)
</td>
</tr>
<tr>
<td> Top plate </td>
<td> 2 sheets </td>
<td>
![top-plates](https://user-images.githubusercontent.com/736191/69554621-6be02300-0fe5-11ea-9ca2-5556f99fa2e5.JPG)
</td>
</tr>
<tr>
<td> Bottom plate </td>
<td> 2 sheets </td>
<td rowspan = "2">
![bottom-plates](https://user-images.githubusercontent.com/736191/69554622-6be02300-0fe5-11ea-8803-a1c97aae0433.JPG)
</td>
</tr>
<tr>
<td> ProMicro protective plate </td>
<td> 2 sheets </td>
</tr>
<tr>
<td> diode </td>
<td> 42 </td>
<td>
![diodes](https://user-images.githubusercontent.com/736191/69554619-6b478c80-0fe5-11ea-9a26-96d617f2b0f6.JPG)
</td>
</tr>
<tr>
<td> Spacer M2 7.5mm </td>
<td> 10 </td>
<td rowspan = "3">
![screws](https://user-images.githubusercontent.com/736191/69554618-6b478c80-0fe5-11ea-8090-b14d989e9d07.JPG)
</td>
</tr>
<tr>
<td> Spacer M2 9mm </td>
<td> 4 </td>
</tr>
<tr>
<td> Screw M2 4mm </td>
<td> 28 </td>
</tr>
<tr>
<td> TRRS jack </td>
<td> 2 </td>
<td rowspan = "3">
![jacks](https://user-images.githubusercontent.com/736191/69554620-6be02300-0fe5-11ea-94ee-6f8f50d800da.JPG)
</td>
</tr>
<tr>
<td> Reset switch </td>
<td> 2 </td>
</tr>
<tr>
<td> Rubber feet </td>
<td> 8 </td>
</tr>
<tr>
<td> ProMicro (with conthrough) </td>
<td> 2 </td>
<td>
<a href="https://yushakobo.jp/shop/promicro-spring-pinheader/"> https://yushakobo.jp/shop/promicro-spring-pinheader/ </a>
</td>
</tr>
<tr>
<td> OLED module (with pin socket) </td>
<td> 2 </td>
<td>
<a href="https://yushakobo.jp/shop/oled/"> https://yushakobo.jp/shop/oled/ </a>
</td>
</tr>
<tr>
<td> key switch </td>
<td> 42 </td>
<td> </td>
</tr>
<tr>
<td> keycap </td>
<td> 42 </td>
<td> </td>
</tr>
<tr>
<td> TRRS cable </td>
<td> 1 </td>
<td> TRS cable is also acceptable </td>
</tr>
<tr>
<td> USB cable </td>
<td> 1 </td>
<td> </td>
</tr>
</tbody>
</table>
## 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.
## Implementation
### PCB disconnection
Check the front and back and separate the left and right PCBs
(the photo is the front).
![assembly-pcb](https://user-images.githubusercontent.com/736191/69554624-6c78b980-0fe5-11ea-9828-3be0af9f27af.JPG)
This is a jig for bending the legs of a diode.
Separate it if necessary.
![assembly-tool-of-diodes](https://user-images.githubusercontent.com/736191/69554626-6c78b980-0fe5-11ea-8c4d-ae70374d54bc.JPG)
* Some versions do not have a jig.
### diode
First, bend the legs of the reed type diode.
* You can clean it by bending it one by one as shown in the picture,
but it is more efficient to bend multiple pieces at the same time
while connected to the tape.
![assembly-diodes-1](https://user-images.githubusercontent.com/736191/69554627-6c78b980-0fe5-11ea-9f4f-120c28b49953.JPG)
Attach the diode with the bent leg to the specified position.
![assembly-diodes-2](https://user-images.githubusercontent.com/736191/69554628-6d115000-0fe5-11ea-8885-e88b5d87a3b1.JPG)
The diode has an orientation and is installed as shown in the photo.
* All the diodes to be attached are in the same orientation.
![assembly-diodes-3](https://user-images.githubusercontent.com/736191/69554629-6d115000-0fe5-11ea-9df5-70e8ab10489f.JPG)
You can attach it neatly by fixing it with masking tape.
![assembly-diodes-4](https://user-images.githubusercontent.com/736191/69554632-6d115000-0fe5-11ea-907f-2188aa59094a.JPG)
Solder from the back side.
![assembly-diodes-5](https://user-images.githubusercontent.com/736191/69554633-6da9e680-0fe5-11ea-9d5c-751595784d84.JPG)
If you are fixing with masking tape,
cutting your legs to the limit like this will make soldering easier.
![assembly-diodes-6](https://user-images.githubusercontent.com/736191/69554634-6da9e680-0fe5-11ea-9051-93f9edd09c9a.JPG)
With 21 one-handed and two-handed he installs 42 diodes.
![assembly-diodes-7](https://user-images.githubusercontent.com/736191/69554635-6da9e680-0fe5-11ea-9ee3-b503bc0fcc83.JPG)
### TRRS jack, reset switch, pin socket
Install in the specified position.
* Install the right hand side in the same position
(be careful of mistakes on the front and back).
![assembly-jacks-resets-pinsockets-1](https://user-images.githubusercontent.com/736191/69554641-6e427d00-0fe5-11ea-87d7-c46056e4fb09.JPG)
### ProMicro, OLED module
Install his ProMicro and his OLED module by referring to the [Helix Build Guide](
https://github.com/MakotoKurauchi/helix/blob/master/Doc/buildguide_en.md#pro-micro).
![assembly-promicro-oled](https://user-images.githubusercontent.com/736191/69554644-6e427d00-0fe5-11ea-8c6b-9aaa3d2c3f6c.JPG)
### Write firmware
Write the firmware to ProMicro by referring to the following. \
<https://github.com/foostan/crkbd/blob/master/doc/firmware_en.md>
### Operation check
To check the operation,
connect the left hand side to the PC with a USB cable,
and connect the left hand side and the right hand side with a 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.
* Since the switch is not attached,
check the operation with tweezers as shown in the photo.
![check](https://user-images.githubusercontent.com/736191/69554646-6edb1380-0fe5-11ea-8428-afd7bef09c15.JPG)
### Top plate, key switch
Attach the key switch to the top plate as shown in the picture.
* Be careful of the direction of the key switch.
![assembly-keyswitches-1](https://user-images.githubusercontent.com/736191/69554647-6edb1380-0fe5-11ea-9e17-d4d644f9a60c.JPG)
We recommend using a 3-pin key switch.
* Even when using 5 pins, the plastic legs can be separated to make 3 pins.
![assembly-keyswitches-2](https://user-images.githubusercontent.com/736191/69554648-6edb1380-0fe5-11ea-94fe-cd758f46cfd0.JPG)
Solder so that there is no gap between the switch and the PCB.
![assembly-keyswitches-3](https://user-images.githubusercontent.com/736191/69554652-700c4080-0fe5-11ea-8633-afae5e825d02.JPG)
![assembly-keyswitches-4](https://user-images.githubusercontent.com/736191/69554654-700c4080-0fe5-11ea-8514-9a46ba4da38c.JPG)
### ProMicro Protective Plate, Bottom Plate
Attach his ProMicro protective plate using an M2 9mm spacer.
![assembly-plates-1](https://user-images.githubusercontent.com/736191/69554656-700c4080-0fe5-11ea-8083-b55fea60adc9.JPG)
Install the bottom plate using the M2 7.5mm spacer.
![assembly-plates-2](https://user-images.githubusercontent.com/736191/69554660-70a4d700-0fe5-11ea-9c46-eb32c7589470.JPG)
Attach the rubber feet to the four corners.
![assembly-plates-3](https://user-images.githubusercontent.com/736191/69554661-70a4d700-0fe5-11ea-85c1-acae90ea7725.JPG)
## Complete
Attach the keycap and you're done.
![assembly-finished-1](https://user-images.githubusercontent.com/736191/69654854-d615c800-10b8-11ea-8903-ebf019d7b125.png)
![assembly-finished-2](https://user-images.githubusercontent.com/736191/69654882-df069980-10b8-11ea-8efe-069b68db3bc0.png)

View File

@@ -0,0 +1,205 @@
# Build Guide
This is the build guide for Corne Light v2 Low edition.
![corne-light-low-edition-001](assets/corner-light-low-edition-001.jpg)
![corne-light-low-edition-002](assets/corner-light-low-edition-002.jpg)
![corne-light-low-edition-003](assets/corner-light-low-edition-003.jpg)
## Parts
### Required
| Name | Number | 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 | |
### Options
| Name | Number | 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
### diode
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 Conthru, you do not need to solder the back side.
Please refer to [Helix Build Guide](
https://github.com/MakotoKurauchi/helix/blob/master/Doc/buildguide_en.md#pro-micro)
for details on how to use Consul.
![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 his 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)