Skip to content

Commit

Permalink
fix/ctxlink/readme: Update ctxlink readme to reflect the recent build…
Browse files Browse the repository at this point in the history
… system changes
  • Loading branch information
sidprice committed Nov 6, 2024
1 parent f60046a commit e25ca87
Showing 1 changed file with 36 additions and 11 deletions.
47 changes: 36 additions & 11 deletions src/platforms/ctxlink/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,15 +16,6 @@ Allows the use of ctxLink board as a Black Magic Probe.
* PC7: TDO/TRACESWO
* PA2: nRST

## How to Flash with DFU

After build:

1) `apt install dfu-util`
2) Force ctxLink into system bootloader mode by holding down the Mode switch while
pressing reset. Release reset followed by Mode. System bootloader should appear.
3) `dfu-util -a 0 --dfuse-address 0x08000000:leave -D blackmagic_ctxlink_firmware.bin`

## 10 pin male from pins

ctxLink uses the common 2 x 5 0.05" pin-header.
Expand All @@ -39,8 +30,42 @@ ctxLink uses the common 2 x 5 0.05" pin-header.
| SWDIO/TMS | SWCLK/TCK | TRACESWO/TDO | TDI | RESET |
+-----------+-------------+--------------+------------+-----------+


## Compiling the ctxLink firmware

1. Clone the Blackmagic Debug Repository

```sh
git clone https://github.com/blackmagic-debug/blackmagic.git
cd blackmagic
```

2. Create the build configuration for the ctxLink firmware

```sh
meson setup build --cross-file=cross-file/ctxlink.ini
```

3. Compile the ctxLink firmware
note: ctxLink uses the ST System Bootloader and does not have a bootloader itself.

```sh
ninja -C build
```

## How to Flash with DFU

After build:

4) Install dfu-util
5) Force ctxLink into system bootloader mode by holding down the Mode switch while
pressing reset. Release reset followed by Mode. System bootloader should appear.
6) Flash the firmware

```sh
dfu-util -a 0 --dfuse-address 0x08000000:leave -D blackmagic_ctxlink_firmware.bin
```

## SWD/JTAG frequency setting

https://github.com/blackmagic-debug/blackmagic/pull/783#issue-529197718

`mon freq 900k` helps at most

0 comments on commit e25ca87

Please sign in to comment.