Skip to content

Commit

Permalink
Add image of PCB
Browse files Browse the repository at this point in the history
  • Loading branch information
danngreen committed Oct 24, 2023
1 parent 5c935d1 commit bc7e526
Show file tree
Hide file tree
Showing 3 changed files with 7 additions and 4 deletions.
5 changes: 2 additions & 3 deletions docs/firmware-debugging.md
Original file line number Diff line number Diff line change
Expand Up @@ -65,15 +65,14 @@ Debug::Pin1::set(false); //same as ::low()
```

The pins and pads are located on the PCB as shown here:
![PCB header locations](./images/pcb-headers.jpg)

![PCB header locations](./images/pcb-headers.png)


## Console output (printf debugging)

You can view the console output by connecting a USB-UART cable to the TX pin of
the debug header (next to the SWD header). The TX pin is labeled (upper-right
pin). The bottom four pins are all GND. Settings are 115200, 8N1.
pin). The bottom four pins are all GND. Settings are 115200, 8N1. See image above.

Use `pr_dbg()`, `pr_warn()`, `pr_err()`, and `pr_trace()` for debug output. These
require the `console/pr_dbg.hh` header.
Expand Down
6 changes: 5 additions & 1 deletion docs/firmware-loading.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,8 @@ in a section below:

### Load in RAM over SWD/JTAG

![PCB header locations](./images/pcb-headers.png)

This is the preferred method for active firmware development. It requires a
JTAG programmer.

Expand All @@ -24,7 +26,7 @@ attach without loading.

If you need to load new firmware, then do this:

1) Install a jumper on `Control Expander` header that bridges the top-left pin
1) Install a "Freeze jumper" on `Control Expander` header that bridges the top-left pin
and the pin just to the right of it. Make sure you use the right header, it's
the one above the Wifi header, near the `y` and `z` pots. The jumper should be
horizontal, not vertical, on the top row of pins all the way to the left:
Expand All @@ -36,6 +38,8 @@ horizontal, not vertical, on the top row of pins all the way to the left:
o o o o
```

See image above for reference.

2) Power off and back on (full power-cycle is required).

The console will show:
Expand Down
Binary file added docs/images/pcb-headers.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit bc7e526

Please sign in to comment.