inital commit
[suzanna] / README.md
1 Suzanna - USB-C debug cable adaptor
2 ===================================
3
4 This is a "Suzy-Q" USB-C Debug Accessory adaptor board.
5 Designed by John Tsiombikas <nuclear@member.fsf.org>
6
7 There are multiple possible configurations supported for testing, don't populate
8 all footprints when building this.
9
10 Possible configurations:
11
12   1. As described at https://www.chromium.org/chromium-os/ccd which seems to
13      agree with the USB-C standard Debug Accessory Mode: populate R2 and R4 with
14      22k and 56k resistors (0805 package).
15
16   2. https://wiki.postmarketos.org/wiki/Serial_debugging#Suzy-Q_debug_cable
17      shows inconsistent pin numbers and signal names. Assuming the signal names
18      are correct: populate R1 and R3 footprints with 5.1k resistors
19      (0805 package).
20
21   3. Same as '2' but assume signal names in that diagram are incorrect and pin
22      numbers are correct: populate R3 and R5 with 5.1k resistors (0805 package).
23      This seems more likely than '2', as it seems to also agree with the USB-C
24      standard for the Debug Accessory Mode.
25
26 The LED D1 is optional, if populated the reistor R6 is also needed (any value
27 between 330ohm and 1k, 0805 package).
28
29 Soldering the USB-C connector is going to be a bitch...