Skip to content

minoseigenheer/SWD-over-USB-C

Repository files navigation

SWD over USB-C

I like the idea to have a single USB-C connector which can be used for USB 2.0 and also gives access to SWD (single wire debugging) both on the same USB-C connector.
With USB-C DAM (Debug Accessory Mode) this is possible.
https://en.wikipedia.org/wiki/USB-C#Debug_Accessory_Mode
In my case I want to use the USB-C connector for client software updates with a normal USB-C cable. And for debugging and initial programming of the USB boot loader a ST-link can be connected to the same port.

To let the target device know that we want to enter debug mode, CC1 and CC2 (Configuration Channels) both have to be pulled high. The target device can then enable the SWD lines.
Check out the "Debug accessory mode detection" section for detail how the detection on the target device is done.

USB-C pinout

The USB-C connector has 24 pins in total. 10 of them are used for Vbus (power), GND and CC (Configuration Channels) which leaves 14 pins free for manufacturer-specific port configuration in debug mode.
Because 5 additional debug pins where enough for me and I did not want to detect the orientation of the plug, I decided to go with a reversible pin configuration and kept the USB 2.0 differential pair connected in the debug mode.

A normal USB-C cable can not be used because they don't pass trough both CC1 and CC2.

SWD over USB-C pinout

Target device debug accessory mode detection

Normal USB-C cables connect only one CC line which determines the orientation of the plug. The host's pull-up resistor defines the maximum current which can be drawn (for example 56kΩ to 5V for 500mA) and the device pulls the CC line down with a 5.1kΩ pull-down to enable host power delivery. For DAM (Debug Accessory Mode) we need to pull both CC lines high.
The official DAM resistor values are a bit different.
For 500mA @5V 22kΩ on CC1 and 10kΩ on CC2 should be used.

  • CC1: Host 22kΩ pull-up to 5V and device 5.1kΩ pull-down = 0.9V
  • CC2: Host 10kΩ pull-up to 5V and device 5.1kΩ pull-down = 1.7V

First we need two OpAmps to boost the CC voltages above the minimum high-state voltage of the AND gate (2V for SN74LVC1G08).
The logic AND gate (SN74LVC1G08) checks if both CC1 and CC2 are logic one and switches a 4-channel TMUX switch (TMUX1511) which connects the SWD lines to the USB-C connector.

SWD over USB-C pinout

Make sure you add EST protection to all USB and SWD signal lines!
The target device schematics shows an example of the whole device USB circuit.

USB-C to SWD connector board

schematics can be found here.
SWD over USB-C connector
Render of the USB-C to SWD connector board

ST-Link debugger connections

Two different pinouts for a ST-Link are available on this breakout board.

ST-Link V3 mini [STDC14]

I like the ST-Link V3 mini because they are small, cheap and designed by STM32. The only down side in my opinion is that they are built to work with 1.65V to 3.6V MCU's and for that reason don't supply power to your target device like all official ST-links.
You need to power your device separately. You need to connect 5V and GND on the debug connector board to a external power supply.
https://www.st.com/en/development-tools/stlink-v3minie.html
or the older https://www.st.com/en/development-tools/stlink-v3mini.html
Order from Mouser for € 10,75 https://eu.mouser.com/ProductDetail/STMicroelectronics/STLINK-V3MINIE

ST-Link V2 clones [IDC10]

Clones usually work fine but differ a bit from the original.
They do not detect the device voltage and work with 3.3V only! The good thing is they can supply a few mA 3.3V and 5V to power the device during programming.
These clones don't bring out SWO (printf traces) but you can modify it yourself if you need traces. https://sudonull.com/post/20076-Completion-of-the-Chinese-ST-Link-v2-add-the-SWO-debug-information-output-interface-and-foot-reset

They are available for a few dollars from china.
https://nl.aliexpress.com/w/wholesale-ST%2525252dlink-V2.html

Maybe someone will make a clone ST-Link V3 which combines the official features (SWO traces, MCU voltage detection, fast programming...) with 5V power supply from the USB host and directly has a male USB-C on the other side for SWD over USB-C.

Links

https://en.wikipedia.org/wiki/USB-C#Debug_Accessory_Mode
https://www.usb.org/sites/default/files/USB%20Type-C%20Spec%20R2.0%20-%20August%202019.pdf
https://threadreaderapp.com/thread/1495860045728395278.html

About

Use SWD debugging over USB-C debug accessory mode

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published