jackcartersmith/blackmagic
1
0
Fork 0
Code Issues Pull Requests Releases Activity

hosted: Make HOSTED_BMP_ONLY the default.

Browse Source 
Hopefully more people will use it when reporting errors!
This commit is contained in:
Uwe Bonnes 2021-08-15 15:22:57 +02:00 committed by UweBonnes
parent 2fcd4a878a
commit 49122b50b6
2 changed files with 16 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
src/platforms/hosted/Makefile.inc
View File

@ -2,12 +2,12 @@ SYS = $(shell $(CC) -dumpmachine)
CFLAGS += -DENABLE_DEBUG -DPLATFORM_HAS_DEBUG CFLAGS += -DENABLE_DEBUG -DPLATFORM_HAS_DEBUG
CFLAGS +=-I ./target -I./platforms/pc CFLAGS +=-I ./target -I./platforms/pc
# Define HOSTED_BMP_ONLY to '1' in order to build the hosted blackmagic # Define HOSTED_BMP_ONLY to '0' in order to build the hosted blackmagic
# executable with support for native BMP probes only. This makes # executable with support for other probes beside BMP. Default HOSTED_BMP_ONLY
# linking against the libftdi and libusb libraries unnecessary. This can # == 1 makes linking against the libftdi and libusb libraries unnecessary.
# be useful to minimize external dependencies, and make building on # This can be useful to minimize external dependencies, and make building on
# windows systems easier. # windows systems easier and is default now.
HOSTED_BMP_ONLY ?= 0 HOSTED_BMP_ONLY ?= 1
CFLAGS += -DHOSTED_BMP_ONLY=$(HOSTED_BMP_ONLY) CFLAGS += -DHOSTED_BMP_ONLY=$(HOSTED_BMP_ONLY)
ifneq (, $(findstring linux, $(SYS))) ifneq (, $(findstring linux, $(SYS)))

16
src/platforms/hosted/Readme.md
View File

@ -1,5 +1,7 @@
# PC-Hosted BMP # PC-Hosted BMP
Compile in src with "make PROBE_HOST=hosted" Compile in src with "make PROBE_HOST=hosted". This needs minimal external
support. "make PROBE_HOST=hosted HOSTED_BMP=0" will compile support for FTDI,
STLink, CMSIS-DAP and JLINK probes, but requires external libraries.
## Description ## Description
PC-hosted BMP run on the PC and compiles as "blackmagic". When started, PC-hosted BMP run on the PC and compiles as "blackmagic". When started,
@ -8,7 +10,7 @@ if either only one probe is attached to the PC or enough information is
given on the command line to select one of several probes. given on the command line to select one of several probes.
When started without any other argument beside the probe selection, a When started without any other argument beside the probe selection, a
GDB server is started as port 2000 and up. Connect to the server as you would GDB server is started on port 2000 and up. Connect to the server as you would
connect to the BMP with the CDCACM GDB serial server. GDB functionality connect to the BMP with the CDCACM GDB serial server. GDB functionality
is the same, monitor option may vary. is the same, monitor option may vary.
@ -60,9 +62,9 @@ blackmagic -M "option help"
## Compiling on windows ## Compiling on windows
You can crosscompile blackmagic for windows with mingw or on windows You can crosscompile blackmagic for windows with mingw or on windows
with cygwin. For compilation, headers for libftdi1 and libusb-1.0 are with cygwin. For suppport of other probes beside BMP, headers for libftdi1 and
needed. For running, libftdi1.dll and libusb-1.0.dll are needed and libusb-1.0 are needed. For running, libftdi1.dll and libusb-1.0.dll are needed
the executable must be able to find them. Mingw on cygwin does not provide and the executable must be able to find them. Mingw on cygwin does not provide
a libftdi package yet. a libftdi package yet.
PC-hosted BMP for windows can also be built with [MSYS2](https://www.msys2.org/), PC-hosted BMP for windows can also be built with [MSYS2](https://www.msys2.org/),
@ -78,7 +80,8 @@ pacman -S mingw-w64-x86_64-gcc --needed
PROBE_HOST=hosted make PROBE_HOST=hosted make
``` ```
To prepare libusb access to the ftdi/stlink/jlink/cmsis-dap devices, run zadig For suppport of other probes beside BMP, libusb access is needed. To prepare
libusb access to the ftdi/stlink/jlink/cmsis-dap devices, run zadig
https://zadig.akeo.ie/. Choose WinUSB(libusb-1.0). https://zadig.akeo.ie/. Choose WinUSB(libusb-1.0).
Running cygwin/blackmagic in a cygwin console, the program does not react Running cygwin/blackmagic in a cygwin console, the program does not react
@ -91,6 +94,7 @@ REMOTE_BMP is a "normal" BMP usb connected
| Debugger | Speed | Remarks | Debugger | Speed | Remarks
| ------------ | ----- | ------ | ------------ | ----- | ------
| REMOTE_BMP | +++ | Requires recent firmware for decent speed | REMOTE_BMP | +++ | Requires recent firmware for decent speed
Probes below only when compiled with HOSTED_BMP=0
| ST-Link V3 | ++++ | Requires recent firmware, Only STM32 devices supported! | ST-Link V3 | ++++ | Requires recent firmware, Only STM32 devices supported!
| ST-Link V2 | +++ | Requires recent firmware, No CDCACM uart! Cortex only! | ST-Link V2 | +++ | Requires recent firmware, No CDCACM uart! Cortex only!
| ST-Link V2/1 | +++ | Requires recent firmware, Cortex only! | ST-Link V2/1 | +++ | Requires recent firmware, Cortex only!