misc: Reworded the README section of BMDA to match the name change

This commit is contained in:
dragonmux 2022-07-03 12:41:48 -04:00 committed by Piotr Esden-Tempski
parent c26115b3f7
commit 7bc2fa53f1
1 changed files with 18 additions and 16 deletions

View File

@ -71,23 +71,24 @@ Breakpoint 1, main () at /devel/en_apps/gpio/f4_discovery/../gpio.c:70
70 { 70 {
``` ```
BLACKMAGIC ## Black Magic Debug App
==========
You can also build blackmagic as a PC hosted application You can also build the Black Magic Debug suite as a PC program called Black Magic Debug App
"make PROBE_HOST=hosted" by running `make PROBE_HOST=hosted`
This builds the same GDB server, that is running on the Black Magic Probe. This builds the same GDB server that is running on the Black Magic Probe.
While connection to the Black Magic Probe GDB server is via serial line, While connection to the Black Magic Probe GDB server is via serial line,
connection to the PC-Hosted GDB server is via TCP port 2000 for the first connection to the Black Magic Debug App is via TCP port 2000 for the first
GDB server and higher for more invokations. Use "tar(get) ext(ented) :2000" GDB server and higher for more invokations. Use "tar(get) ext(ented) :2000"
to connect. to connect.
PC-hosted BMP GDB server can talk to
- Black Magic Probe firmware probes via the USB-serial port Black Magic Debug App can talk to
- ST-LinkV2 and V3 with recent firmware
- CMSIS-DAP compatible probes * Black Magic Probe firmware probes via the USB-serial port
- JLINK probes * ST-LinkV2 and V3 with recent firmware
- FTDI MPSSE based probe. * CMSIS-DAP compatible probes
* JLINK probes
* FTDI MPSSE based probe.
When connected to a single BMP supported probe, starting "blackmagic" w/o any When connected to a single BMP supported probe, starting "blackmagic" w/o any
arguments starts the server. When several BMP supported probes are connected, arguments starts the server. When several BMP supported probes are connected,
@ -96,6 +97,7 @@ Add "-P (position)" to the next invocation to select one.
For the setup from the sample session above: For the setup from the sample session above:
In another terminal: In another terminal:
```console ```console
> blackmagic > blackmagic
Black Magic Debug App v1.8.0 Black Magic Debug App v1.8.0
@ -106,6 +108,7 @@ Listening on TCP: 2000
``` ```
And in the GDB terminal: And in the GDB terminal:
```console ```console
(gdb) tar ext :2000 (gdb) tar ext :2000
Remote debugging using :2000 Remote debugging using :2000
@ -113,7 +116,6 @@ Remote debugging using :2000
... ...
``` ```
PC hosted BMP also allows to flash, read and verify a binary file, by default Black Magic Debug App also provides for Flashing, reading and verification of a binary file,
starting at lowest flash address. The "-t" argument displays information about the by default starting at lowest flash address. The `-t` argument displays information about the
connected target. Use "-h " to get a list of supported options. connected target. Use `-h`/`--help` to get a list of supported options.