EMTime/libopencm3-examples
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: try and clear up how "make flash" works

Browse Source 
Likely to be insufficient, but perhaps a start.

See https://github.com/libopencm3/libopencm3-examples/issues/34
This commit is contained in:
Karl Palsson
2016-12-27 21:41:08 +00:00
parent c03b580722
commit 1b92d46b97
1 changed files with 6 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files

16
README.md
View File

@@ -29,34 +29,30 @@ The makefiles are generally useable for your own projects with
only minimal changes for the libopencm3 install path (See Reuse) only minimal changes for the libopencm3 install path (See Reuse)
## Make Flash Target ## Make Flash Target
Please note, the "make flash" target is complicated and not always self-consistent. Please see: https://github.com/libopencm3/libopencm3-examples/issues/34
For flashing the 'miniblink' example (after you built libopencm3 and the For flashing the 'miniblink' example (after you built libopencm3 and the
examples by typing 'make' at the top-level directory) onto the Olimex examples by typing 'make' at the top-level directory) onto the Olimex
STM32-H103 eval board (ST STM32F1 series microcontroller), you can execute: STM32-H103 eval board (ST STM32F1 series microcontroller), you can execute:
cd examples/stm32/f1/stm32-h103/miniblink cd examples/stm32/f1/stm32-h103/miniblink
make flash make flash V=1
The Makefiles of the examples are configured to use a certain OpenOCD The Makefiles of the examples are configured to use a certain OpenOCD
flash programmer, you might need to change some of the variables in the flash programmer, you might need to change some of the variables in the
Makefile if you use a different one. Makefile if you use a different one.
The make flash target also supports a few other programmers. If you provide the To program via a Black Magic Probe, simply provide the serial port, eg:
Black Magic Probe serial port the target will automatically choose to program
via Black Magic Probe. For example on linux you would do the following:
cd examples/stm32/f1/stm32-h103/miniblink cd examples/stm32/f1/stm32-h103/miniblink
make flash BMP_PORT=/dev/ttyACM0 make flash BMP_PORT=/dev/ttyACM0
This will also work with discovery boards that got the st-link firmware To program via texane/stlink (st-flash utility), use the special target:
replaced with the Black Magic Probe firmware.
In case you did not replace the firmware you can program using the st-flash
program by invoking the stlink-flash target:
cd examples/stm32/f1/stm32vl-discovery/miniblink cd examples/stm32/f1/stm32vl-discovery/miniblink
make miniblink.stlink-flash make miniblink.stlink-flash
If you rather use GDB to connect to the st-util you can provide the STLINK\_PORT If you rather use GDB to connect to the st-util you can provide the STLINK\_PORT
to the flash target. to the flash target.