-
Notifications
You must be signed in to change notification settings - Fork 7
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Add first draft of troubleshooting page
- Loading branch information
burkfers
committed
Oct 19, 2023
1 parent
aaaed0f
commit f138e87
Showing
2 changed files
with
48 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,9 @@ | ||
--- | ||
layout: default | ||
title: Help | ||
nav_order: 9 | ||
has_children: true | ||
--- | ||
|
||
1. TOC | ||
{:toc} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,39 @@ | ||
--- | ||
layout: default | ||
title: Troubleshooting | ||
nav_order: 2 | ||
parent: Help | ||
--- | ||
|
||
1. TOC | ||
{:toc} | ||
|
||
# Post-Build Troubleshooting | ||
|
||
This page offers remedies to common problems after completing your build. If your problem is not covered, or the offered solution does not help, please feel free ask the community on Discord: [bstkbd.com/discord](https://www.bstkbd.com/discord) | ||
|
||
## One or more keys don't work! | ||
|
||
A single key, which has neighbors that work, not working, is most often caused by either a faulty switch, or diode to column discontinuity. | ||
|
||
You can either try measuring those with a multimeter, or turn the board on and bridge the diode's cathode to the right switch leg. If that produces a keypress, you can narrow it down further by bridging from the cathode to the left switch leg (diode to switch discontinuity), and, separately, between the two switch legs (faulty switch). | ||
|
||
TODO: Images, explain how to locate diode and its cathode | ||
|
||
## One or more rows or columns don't work! | ||
|
||
If an entire row or column does not work, the most common cause is a broken row or column trace. | ||
TODO: more, images | ||
|
||
## The board turns off immediately when I plug in the USB connection! | ||
|
||
wow, such short, very fire | ||
TODO: explain, mention shorts, leds orientation | ||
|
||
## One or more LEDs don't work! | ||
|
||
TODO: explain chained nature, add pinout diagram | ||
|
||
## The LEDs flicker or change color randomly! | ||
|
||
TODO: explain chained nature, bad soldering |