Skip to content

Commit 335566e

Browse files
authored
Update README.md
Added a summary of the various utilities.
1 parent c978151 commit 335566e

File tree

1 file changed

+19
-1
lines changed

1 file changed

+19
-1
lines changed

‎README.md‎

Lines changed: 19 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,25 @@ Several utilities accompagny this guide. Some are small, such as `bmscan` to loc
1010

1111
The software is licensed under the [Apache License, version 2.0](https://www.apache.org/licenses/LICENSE-2.0).
1212

13-
For the purpose of troubleshooting, pre-build versions of the "hosted" variant of the Black Magic firmware are also available for Windows and Linux (see [Releases](https://github.com/compuphase/Black-Magic-Probe-Book/releases)).
13+
A summary of the utilities:
14+
<table>
15+
<tr>
16+
<td> <img src="https://www.compuphase.com/electronics/icon_debug_64.png" alt="Icon"> </td><td> bmdebug </td><td> A front-end for GDB with specific support for the Black Magic Probe and debugging embedded targets. </td>
17+
</tr><tr>
18+
<td> <img src="https://www.compuphase.com/electronics/icon_download_64.png" alt="Icon"> </td><td> bmflash </td><td> A utility to download firmware into the Flash memory of a microcontroller, with support for serialization. </td>
19+
</tr><tr>
20+
<td> <img src="https://www.compuphase.com/electronics/icon_profile_64.png" alt="Icon"> </td><td> bmprofile </td><td> A sampling profiler using the CoreSight debugging features and the TRACESWO channel. </td>
21+
</tr><tr>
22+
<td> <img src="https://www.compuphase.com/electronics/icon_trace_64.png" alt="Icon"> </td><td> bmtrace </td><td> A utility to monitor SWO trace messages, with support for filtering, multiple channels and the <a href="https://diamon.org/ctf/">Common Trace Format</a>. </td>
23+
</tr><tr>
24+
<td> </td><td> bmscan </td><td> A command-line utility to check the COM port (Windows) or ttyACM device (Linux) that the Black Magic Probe is attached to. It can locate the IP address of a ctxLink probe by doing a network scan. </td>
25+
</tr><tr>
26+
<td> </td><td> elf&#x2011;postlink </td><td> A utility to set the checksum in the vector table for NXP microcontrollers in the LPC series. As the name suggests, this utility can be run on an ELF file after the "link" stage. </td>
27+
</tr><tr>
28+
<td> </td><td> tracegen </td><td> A utility to generate C source files from a TSDL specification for the <a href="https://diamon.org/ctf/">Common Trace Format</a>. </td>
29+
</tr>
30+
</table>
31+
1432
## Building the software
1533
Several makefiles are provided for various compilers. Use the one that is appropriate for your system. It is most convenient if you rename the correct makefile (for your system) to `Makefile`, so that you don't have to specify it on the command line each time you run `make`.
1634

0 commit comments

Comments
 (0)