Skip to content

Commit

Permalink
Add first draft of troubleshooting page
Browse files Browse the repository at this point in the history
  • Loading branch information
burkfers committed Oct 19, 2023
1 parent aaaed0f commit f138e87
Show file tree
Hide file tree
Showing 2 changed files with 48 additions and 0 deletions.
9 changes: 9 additions & 0 deletions help/index.md
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}
39 changes: 39 additions & 0 deletions help/troubleshooting.md
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

0 comments on commit f138e87

Please sign in to comment.