diff --git a/.wordlist.txt b/.wordlist.txt index 6929bc2..be321fc 100644 --- a/.wordlist.txt +++ b/.wordlist.txt @@ -81,3 +81,7 @@ overtighten Kapton Din Dout +Keycaps +Pseudoku +Asymplex +daughterboard diff --git a/Gemfile b/Gemfile index fc337a5..a0762f8 100644 --- a/Gemfile +++ b/Gemfile @@ -9,3 +9,5 @@ gem "just-the-docs", "0.7.0" # pinned to the current release gem "jekyll-remote-theme" gem "jekyll-default-layout" + +gem "json" # work around upstream bug (?) diff --git a/_config.yml b/_config.yml index 1bee5e4..ab70cad 100644 --- a/_config.yml +++ b/_config.yml @@ -15,6 +15,7 @@ exclude: - Gemfile.lock - _site/ - building-locally.md + - cspell.config.yaml plugins: - jekyll-default-layout diff --git a/_includes/splinktegrated_preparation.md b/_includes/splinktegrated_preparation.md index b4436b1..46f1444 100644 --- a/_includes/splinktegrated_preparation.md +++ b/_includes/splinktegrated_preparation.md @@ -65,7 +65,7 @@ In this section, we will solder headers to the PCB. **They will be close to some ![](../assets/pics/guides/splinktegrated/7.jpg) - Inspect the front of the assembly:  -- Make sure that the headers are flush with the motherboard and daugtherboard +- Make sure that the headers are flush with the motherboard and daughterboard - Solder the top headers, then the bottom headers - Finally, cut the headers to make them flush using pliers @@ -151,7 +151,7 @@ In the next section, we will prepare the first Splinktegrated by installing the ![](../assets/pics/guides/splinktegrated/8.jpg) - Inspect the front of the assembly:  -- Make sure that the headers are flush with the motherboard and daugtherboard +- Make sure that the headers are flush with the motherboard and daughterboard - Solder the top headers, then the bottom headers - Finally, cut the headers to make them flush using pliers @@ -213,4 +213,4 @@ You now have 2 Splinktegrated assemblies. Make sure they match with the pictures ![](../assets/pics/guides/splinktegrated/23.jpg) -![](../assets/pics/guides/splinktegrated/24.jpg) \ No newline at end of file +![](../assets/pics/guides/splinktegrated/24.jpg) diff --git a/_includes/testing_pcb.md b/_includes/testing_pcb.md new file mode 100644 index 0000000..7a6b3d4 --- /dev/null +++ b/_includes/testing_pcb.md @@ -0,0 +1,14 @@ +# Testing before case installation + +Now is a great time to function test the assembled PCBs, as any troubleshooting steps you might need to complete will be much easier to do while the plates are still outside of the case. + +{: .info } +The TRRS connection will not work yet, as only ony one leg of the jack is connected. You can test this part later. + +To begin, connect one half to your PC via USB. If you have RGB, observe the LEDs. Do they all light up? Are the colors correct, and can you see a rainbow animation play? + +To test the switches, open [VIA](https://usevia.app/). After connecting to your device, switch to the key tester page using the stethoscope pictogram, then activate the "Test Matrix" option. Now, you can connect each pair of switch pads in turn, using your tweezers, a wire, or a short length of solder. + +![]({{site.baseurl}}/assets/pics/guides/generic/via-test-matrix.png) + +Did they all light up? Great, proceed to case installation! Not quite perfect yet? Don't worry, proceed to the [Troubleshooting]({{site.baseurl}}/help/troubleshooting.html) section! diff --git a/assets/pics/guides/generic/via-test-matrix.png b/assets/pics/guides/generic/via-test-matrix.png new file mode 100644 index 0000000..d897bae Binary files /dev/null and b/assets/pics/guides/generic/via-test-matrix.png differ diff --git a/bg_charybdis/10install_the_switches.md b/bg_charybdis/10install_the_switches.md index ec40345..e031973 100644 --- a/bg_charybdis/10install_the_switches.md +++ b/bg_charybdis/10install_the_switches.md @@ -10,6 +10,8 @@ parent: Build guide - Charybdis 1. TOC {:toc} +{% include testing_pcb.md %} + # Introduction Now that everything is connected together, the next step is to install the switches and the PCBs into the case. The process is exactly the same for both sides, so we will detail only the Scylla side (without trackball). diff --git a/bg_cnano/10install_the_switches.md b/bg_cnano/10install_the_switches.md index 9630236..61a11c7 100644 --- a/bg_cnano/10install_the_switches.md +++ b/bg_cnano/10install_the_switches.md @@ -10,6 +10,7 @@ parent: Build guide - Charybdis Nano 1. TOC {:toc} +{% include testing_pcb.md %} # Introduction diff --git a/bg_scylla/10install_the_switches.md b/bg_scylla/10install_the_switches.md index 4648304..6c1e044 100644 --- a/bg_scylla/10install_the_switches.md +++ b/bg_scylla/10install_the_switches.md @@ -10,6 +10,8 @@ parent: Build guide - Scylla 1. TOC {:toc} +{% include testing_pcb.md %} + # Introduction Now that everything is connected together, the next step is to install the switches and the PCBs into the case. The process is exactly the same for both sides, so we will detail only the Scylla side (without trackball). @@ -38,4 +40,4 @@ When installing the switches, use the following technique: - start with the top two switches (labeled 1, in red on the picture) - continue with the outer four switches (labeled 2, in blue on the picture) - continue with the bottom six switches (labeled 3, in green on the picture) -- finally, install the rest of the switches \ No newline at end of file +- finally, install the rest of the switches diff --git a/bg_skeletyl/10install_the_switches.md b/bg_skeletyl/10install_the_switches.md index 6945612..65c8cc6 100644 --- a/bg_skeletyl/10install_the_switches.md +++ b/bg_skeletyl/10install_the_switches.md @@ -10,6 +10,7 @@ parent: Build guide - Skeletyl 1. TOC {:toc} +{% include testing_pcb.md %} # Introduction