Skip to the content
4 layers33 × 11 mmWch probe, the printed circuit board in 3D

CH347F-based JTAG & SWD debug probe

Size
33 × 11 mm
Copper layers
4
Thickness
1.6 mm
Parts
36
Nets
52
Pads
158
Tracks, vias
382, 80
Pours
4
Routed
Yes
KiCad
KiCad 10.0 (file 20260206)
Created
4 Sep 2026
Updated
15 Oct 2026

Overview

Wch probe is an open-source printed circuit board by korken89, from the korken89/wch-probe repository on GitHub, published under the CERN-OHL-P-2.0 licence. It is a 4-layer board of 33 × 11 mm with 36 parts on 52 nets, routed with 382 tracks and 80 vias.

It is built around the CH347F, CH412K and AP2112K-3.3, with the SMF5.0A among its other parts. Its parts include 11 capacitors, 9 resistors, 5 ICs, 5 connectors and 4 diodes. It belongs with the interfaces and adapters and sensors and measurement boards of this library.

Main components

4

README

README.md

wch-probe

KiCad hardware for a CH347F-based JTAG & SWD debug probe. USB-C on one end, a 10-pin 1.27 mm Cortex debug header on the other, plus a UART on the bottom-side TX/RX/GND pads. The I/O voltage (VIO) tracks the target's VTref (valid range 1.8 V to 3.3 V), and defaults to 3.3 V when the target does not drive VTref.

Board top Board bottom

Fabrication

The fabrication outputs (gerber zip, BOM, placement file, schematic PDF) for each board revision are attached to the releases. To generate them locally, make fab writes the same set to Fabrication/ and make check runs ERC and DRC; both need KiCad 10's kicad-cli.

Ordering

JLCPCB, 4 layers, 1.6 mm thick. Order options:

  • Stackup: JLC04161H-7628 with impedance control (the USB pair is 90 ohm differential)
  • Surface finish: HASL lead-free

USB identity

Stock CH347s ship with a blank config and all enumerate with the same default serial. Use wch-cfg to write each board's USB identity (serial number, product and manufacturer strings):

sh
wch-cfg version --min 1.01 && wch-cfg write --init --random-serial --product wch-probe --manufacturer korken89
# replug the board (the chip reads the strings at power-on), then
wch-cfg verify --serial <the printed serial> --product wch-probe --manufacturer korken89

write prints the serial for the label on stdout once the OS has enumerated it.

Gotchas

Several probes behind one hub can fail to enumerate.

The CH347 declares its interrupt endpoints with 125/250 us polling, and the host controller reserves that bandwidth at enumeration whether the endpoints are used or not. After a few probes it will error with can't set config #1, error -28 ("Not enough bandwidth"). Work around it on Linux by treating the bInterval values as milliseconds (will support 8x more probes - UART, JTAG and SWD run on bulk endpoints and are unaffected):

sh
echo '1a86:55de:l' | sudo tee /sys/module/usbcore/parameters/quirks

then replug the probes (quirks apply at enumeration). To make it permanent, add usbcore.quirks=1a86:55de:l to the kernel command line. dmesg printing endpoint 0x85 has an invalid bInterval 1, changing to 4 for each probe confirms the quirk is active.

License

CERN-OHL-P-2.0, see LICENSE.

Parts

36
QtyValueFootprintReferences
50.1upassive:C_0402C5, C6, C7, C9, C10
410upassive:C_0603C1, C2, C8, C11
433kpassive:R_0402R5, R6, R7, R9
45.1kpassive:R_0402R1, R2, R3, R8
3Conn_01x01connectors:pad_1.5x2.5mmJ3, J4, J5
230ppassive:C_0402C3, C4
11passive:R_0402R4
11N4148Diode_SMD:D_SOD-523D2
1450mΩ 600Ω@100MHzpassive:R_0603FB1
18 MHzCrystal:Crystal_SMD_3225-4Pin_3.2x2.5mmY1
1AP2112K-3.3Package_TO_SOT_SMD:SOT-23-5U1
1CH347FPackage_DFN_QFN:WQFN-28-1EP_4x4mm_P0.4mm_EP2.7x2.7mmU3
1CH412KPackage_TO_SOT_SMD:SOT-363_SC-70-6U2
1Conn_ARM_JTAG_SWD_10connectors:PinHeader_2x05_FTSH-105-01-L-DV-KJ2
1GREENLED_SMD:LED_0402_1005MetricD3
1NUF8401MNT4Gdfn:DFN-16-1EP_1.6x4mm_P0.5mmU5
1ORANGELED_SMD:LED_0402_1005MetricD4
1SMF5.0ADiode_SMD:D_SOD-123FD1
1TLV9062IDDFRPackage_TO_SOT_SMD:SOT-23-8U4
1USB_C_Receptacle_USB2.0_14PConnector_USB:USB_C_Receptacle_GCT_USB4105-xx-A_16P_TopMnt_HorizontalJ1

Similar boards

  • 4 layers57.4 × 23.9 mmSpark debug, the printed circuit board in 3D

    Spark debug

    emb3rcia/spark-debug

    Custom UART debugger and SPI programmer based on CH347T

    17 parts1
  • 2 layers90 × 55 mmJianjia, the printed circuit board in 3D

    Jianjia

    huming2207/jianjia-hw

    Jianjia hardware

    62 parts
  • 2 layers61 × 52 mmCH32X035C R0, the printed circuit board in 3D

    CH32X035C R0

    openwch/ch32x035

    32-bit RISC-V MCU CH32X035 built-in USB PD PHY

    40 parts86
  • 4 layers431.5 × 125.5 mmClavier, the printed circuit board in 3D

    Clavier

    lsartory/Clavier

    An FPGA-based mechanical keyboard with an integrated USB hub and communication interfaces

    344 parts212
  • 2 layers80.1 × 70 mmUSB TO UART SPI I2C, the printed circuit board in 3D

    USB TO UART SPI I2C

    LuizFernandoOliveira/Conversor-USB-UART-SPI-I2C-JTAG

    This work is licensed under a [Creative Commons Attribution-NonCommercial-NoDerivs 4.0 International License][cc-by-nc-nd].

    76 parts
  • 4 layers66.2 × 30.9 mmUni dap, the printed circuit board in 3D

    Uni dap

    Reutronix/uni-dap-v3

    UniDAP hardware repo

    149 parts
  • 2 layers27.2 × 56.2 mmRB-347, the printed circuit board in 3D

    RB-347

    reza-bakhshi/RB-347

    RB-347 is a small USB interface and debugging module built around the WCH CH347F. It provides several commonly used digital interfaces from a single USB-C connection, making it useful for embedded development, board…

    36 parts

Questions

How big is the Wch probe PCB?

It measures 33 × 11 mm and has 4 copper layers, 1.6 mm thick.

What parts does the Wch probe use?

36 parts, built around the CH347F, CH412K, AP2112K-3.3 and SMF5.0A. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.

Where can I download the Wch probe KiCad files?

From the korken89/wch-probe repository on GitHub, at the commit this page was made from: the board is wch-probe.kicad_pcb and its schematic wch-probe.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Wch probe design in my own project?

Its repository publishes it under the CERN-OHL-P-2.0 licence: you may reuse it on that licence's terms (keep the author's notice, and for a copyleft licence share your changes alike).