Skip to content

backport: jtag/drivers: add T-Head CK-Link JTAG adapter driver #80

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
will-tm wants to merge 1 commit into
base: zephyr-20250213
Choose a base branch
from
Open

backport: jtag/drivers: add T-Head CK-Link JTAG adapter driver #80

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions configure.ac
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -115,6 +115,7 @@ m4_define([ADAPTER_OPT], [m4_translit(ADAPTER_ARG($1), [_], [-])])

m4_define([USB1_ADAPTERS],
[[[ftdi], [MPSSE mode of FTDI based devices], [FTDI]],
[[cklink], [T-Head CK-Link JTAG Probe], [CKLINK]],
[[stlink], [ST-Link Programmer], [HLADAPTER_STLINK]],
[[ti_icdi], [TI ICDI JTAG Programmer], [HLADAPTER_ICDI]],
[[ulink], [Keil ULINK JTAG Programmer], [ULINK]],
Expand Down
6 changes: 6 additions & 0 deletions contrib/60-openocd.rules
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -226,6 +226,12 @@ ATTRS{idVendor}=="2aec", ATTRS{idProduct}=="1106", MODE="660", GROUP="plugdev",
ATTRS{idVendor}=="303a", ATTRS{idProduct}=="1001", MODE="660", GROUP="plugdev", TAG+="uaccess"
ATTRS{idVendor}=="303a", ATTRS{idProduct}=="1002", MODE="660", GROUP="plugdev", TAG+="uaccess"

# T-Head CK-Link Lite (PingTouGe Semiconductor)
ATTRS{idVendor}=="32bf", ATTRS{idProduct}=="b210", MODE="660", GROUP="plugdev", TAG+="uaccess"

# Bouffalo Lab BL616/BL702 CK-Link clones
ATTRS{idVendor}=="42bf", ATTRS{idProduct}=="b210", MODE="660", GROUP="plugdev", TAG+="uaccess"

# Marvell Sheevaplug
ATTRS{idVendor}=="9e88", ATTRS{idProduct}=="9e8f", MODE="660", GROUP="plugdev", TAG+="uaccess"

Expand Down
16 changes: 16 additions & 0 deletions doc/openocd.texi
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2523,6 +2523,22 @@ and a specific set of GPIOs is used.
@c chooses among list of bit configs ... only one option
@end deffn

@deffn {Interface Driver} {cklink}
Driver for the T-Head CK-Link Lite V2 JTAG probe and Bouffalo Lab
BL616/BL702 clones, including the built-in debugger on Bouffalo BL618
evaluation boards. Communication is over USB bulk endpoints using a
T-Head DebugServer-compatible framed command protocol.

The driver only supports JTAG transport and a single-TAP chain. The
probe runs at a fixed clock; @command{adapter speed} requests are
accepted but ignored (with a one-time warning). @command{JTAG_TMS} and
@command{JTAG_PATHMOVE} are not supported by this probe's protocol.

By default the driver matches 0x42bf/0xb210 (Bouffalo) and
0x32bf/0xb210 (T-Head). The built-in list can be overridden via
@command{adapter usb vid_pid}.
@end deffn

@deffn {Interface Driver} {cmsis-dap}
ARM CMSIS-DAP compliant based adapter v1 (USB HID based)
or v2 (USB bulk).
Expand Down
3 changes: 3 additions & 0 deletions src/jtag/drivers/Makefile.am
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -165,6 +165,9 @@ endif
if XLNX_PCIE_XVC
DRIVERFILES += %D%/xlnx-pcie-xvc.c
endif
if CKLINK
DRIVERFILES += %D%/cklink.c
endif
if BCM2835GPIO
DRIVERFILES += %D%/bcm2835gpio.c
endif
Expand Down
Loading