Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Improve help for one key don't working #31

Merged
merged 2 commits into from
Sep 9, 2024
Merged

Improve help for one key don't working #31

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
2c5e6c3
Improve help for one key don't working
razzeee Sep 8, 2024
b1b8139
Update troubleshooting.md
bstiq Sep 9, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 20 additions & 2 deletions help/troubleshooting.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,12 +15,30 @@ This page offers remedies to common problems after completing your build. If you

## One or more keys don't work

A single key not working, which has neighbors that work, is most often caused by either a faulty switch, or diode to column discontinuity. It can often be fixed with a [bodge wire][Bodge wire].
A single key not working, which has neighbors that work, 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 switch leg (diode to switch discontinuity), and, separately, between the two switch legs (faulty switch).
There are a number of steps you can try, starting with the most simple.

### Bad solder joint

If the switch or diode are not soldered properly, this can cause the switch press to not register.
Try to reflow the solder on diode and switch.

### Discontinuity

If the reflow does not work, let's check if the key presses register.

You can do so either by:

- turning the board on and bridge the diode's cathode to the right switch leg
- checking that connection with a multimeter

If that produces a keypress, you can narrow it down further by bridging from the cathode to the switch leg (**diode to switch discontinuity**), and, separately, between the two switch legs (**faulty switch**).

To find out exactly where which diode is connected to which switch leg, please consult the [diagnosing a broken trace](./diagnose_broken_trace.html#inspect-the-schematics) guide.

If it's a faulty switch - you can replace the switch. If it's a discontinuity, you can [bodge wire][Bodge wire] it.

## One or more rows or columns don't work

If an entire row or column, or a large part of it, does not work, the most common cause is a broken row or column trace. They can often be fixed with a [bodge wire][Bodge wire].
Expand Down