Difference between revisions of "STLink"
(7 intermediate revisions by 3 users not shown) | |||
Line 17: | Line 17: | ||
==Install Software== | ==Install Software== | ||
The ''st-flash'' and ''st-util'' tools are needed, | '''INFO''' Latest version is now available on github in this repository: https://github.com/stlink-org/stlink, with all install instructions (from packages or from sources with CMake). Instruction below are for legacy code and should be removed soon. | ||
The ''st-flash'' and ''st-util'' tools are needed, provided by [https://github.com/texane/stlink texane] | |||
Download and compile | Download and compile | ||
Line 27: | Line 29: | ||
$ make | $ make | ||
Set | Set environment variable | ||
$ exportline="PATH=$PATH:/opt/stlink" | $ exportline="PATH=$PATH:/opt/stlink" | ||
$ if grep -Fxq "$exportline" ~/.profile; then echo nothing to do ; else echo $exportline >> ~/.profile; fi | $ if grep -Fxq "$exportline" ~/.profile; then echo nothing to do ; else echo $exportline >> ~/.profile; fi | ||
Line 48: | Line 50: | ||
==Update the ST-Link to blackmagic probe== | ==Update the ST-Link to blackmagic probe== | ||
The STM32F103 (STLink MCU) can be flashed with the blackmagic's | The STM32F103 (STLink MCU) can be flashed with the blackmagic's firmware.<br/> | ||
===Two STLinkV2 Method=== | ===Two STLinkV2 Method=== | ||
Line 87: | Line 89: | ||
st-flash write blackmagic_dfu.bin 0x8000000 | st-flash write blackmagic_dfu.bin 0x8000000 | ||
===Documentation=== | ====Documentation==== | ||
[http://esden.net/2014/12/29/black-magic-discovery Black Magic Discovery from Esden] <-- This also describes how to remove the read out protection. <br/> | [http://esden.net/2014/12/29/black-magic-discovery Black Magic Discovery from Esden] <-- This also describes how to remove the read out protection. <br/> | ||
[http://embdev.net/articles/STM_Discovery_as_Black_Magic_Probe embdev.net page] | [http://embdev.net/articles/STM_Discovery_as_Black_Magic_Probe embdev.net page] | ||
==BMP Method== | ===BMP Method=== | ||
Use a BMP to flash a STLink | Use a BMP to flash a STLink | ||
Transfer the solder jumpers from "Default" to "Reversed" and build the firmware as | Transfer the solder jumpers from "Default" to "Reversed" and build the firmware as described above.<br/> | ||
Connect the BMP to the CN2 header (see Pinout above). | Connect the BMP to the CN2 header (see Pinout above). | ||
Line 109: | Line 111: | ||
The option bytes do not cover the Readout Protection (RDP), but the RDP is disabled anyhow... | The option bytes do not cover the Readout Protection (RDP), but the RDP is disabled anyhow... | ||
'''Error at loading a new image after removing RDP''' | |||
Error erasing flash with vFlashErase packet | |||
If this occurs powercycle the target (disconnect and reconnect the 3V3 connection), swd scan, attach and try loading the image again. Usually the reset of the RDP requires a flash erase (done by mon option erase) and reset. | |||
Probably this can also be done via gdb. | |||
==Clones== | ==Clones== | ||
There are also | There are also a lot of different Chinese clones out there. Most with an identical MCU as the original STLinkV2, some with an STM32F101. | ||
It seems that each clone has its own programming pinout, so better double check (continuity tester) than to release the magic smoke... | |||
Most (all?) should work with the "stlink" target from Blackmagic Probe, since they probably use the same firmware from the original STLinkV2. | |||
===Red PCB=== | |||
Seems to work with the standard stlink BMP image. | |||
[[Image:stlinkv2_clone_red_front.jpg|250px]] | |||
[[Image:stlinkv2_clone_red_back.jpg|250px]] | |||
* STM32F103C8T6 | |||
Programming header (1.27mm, populated on the images) from the Mini USB to the Pin header (right to left on the image), used for programming the onboard MCU. | |||
# SWDIO | |||
# GND | |||
# SWDCLK | |||
# 3V3 | |||
Some Images and details about this hardware can be found at[https://www.mikrocontroller.net/articles/IRMP_auf_STM32_-_Bauanleitung] | |||
===Blue PCB=== | |||
NOT TESTED YET | |||
[[Image:stlinkv2_clone_blue_front.jpg|250px]] | |||
[[Image:stlinkv2_clone_blue_back.jpg|250px]] | |||
* STM32F103C8T6 | |||
Programming header (2.54mm, unpopulated on the images) from the USB to the Pin header (left to the right on the images), used for programming the onboard MCU. | |||
# GND | |||
# 5V | |||
# USART1 RX (PA10) | |||
# USART1 TX (PA9) | |||
Bootloader header (2.54mm, unpopulated on the images), from the USB to the Pin header (left to the right on the images), used for USART bootloader activation | |||
# 3V3 | |||
# BOOT0 (pin 44) | |||
The 3V3/5V switch selects the input voltage for the onboard MCU. | |||
===Aluminium housing=== | |||
NOT TESTED YET | |||
[[Image:stlinkv2_clone_aluminium.jpg|250px]] | |||
[[Image:stlinkv2_clone_aluminium_front.jpg|250px]] | |||
[[Image:stlinkv2_clone_aluminium_back.jpg|250px]] | |||
* STM32F101C8T6 | |||
Programming header (1.27mm, unpopulated on the images) from the USB to the Pin header (left to the right on the images), used for programming the onboard MCU. | |||
# SWDIO (PA13) | |||
# GND | |||
# SWDCLK(PA14) | |||
# VDD, VBAT | |||
To disassemble pull the aluminium housing towards the USB connector. | |||
This has not the same hardware as https://github.com/blacksphere/blackmagic/issues/62 , but the same MCU, seems that this has just an other PCB. | |||
[[Category:Firmware Flashing]] [[Category:Developer_Documentation]] | [[Category:Firmware Flashing]] [[Category:Developer_Documentation]] |
Latest revision as of 14:34, 16 December 2020
Every STM discovery / eval board comes with a ST-Link V2 on board, with one exception; the STM32VL version comes with a ST-Link V1.
SWD Header
Install Software
INFO Latest version is now available on github in this repository: https://github.com/stlink-org/stlink, with all install instructions (from packages or from sources with CMake). Instruction below are for legacy code and should be removed soon.
The st-flash and st-util tools are needed, provided by texane
Download and compile
$ cd /opt $ git clone git://github.com/texane/stlink.git stlink $ cd stlink $ ./autogen.sh $ ./configure $ make
Set environment variable
$ exportline="PATH=$PATH:/opt/stlink" $ if grep -Fxq "$exportline" ~/.profile; then echo nothing to do ; else echo $exportline >> ~/.profile; fi $ source ~/.profile
Add udev rules
$ sudo cp /opt/stlink/49-stlinkv*.rules /etc/udev/rules.d $ sudo udevadm control --reload-rules
ST-LinkV1 requires a bit different treatment, read the Readme.txt
Airframe.xml setup
Connect the ST-Link to the MCU. If a complete STM32Fx-Discovery board is used, CN3 jumpers need to be set. To program a external MCU, remove CN3 jumpers and connect the external MCU with the SWD header.
To use SWD via STLink as default:
Set FLASH_MODE=STLINK
Update the ST-Link to blackmagic probe
The STM32F103 (STLink MCU) can be flashed with the blackmagic's firmware.
Two STLinkV2 Method
Use one STLink to flash another
Hardware Setup:
One STLinkV2 (connected via USB) is programming the other one. Change the 4 Solder jumpers on the bottom of the target STLinkV2 from "DEFAULT" to "REVERSED".
Connections between the two STLinks
Use | From Programmer | To Target |
---|---|---|
5V | P2-5V | P2-5V |
SWDIO | CN2-4 | CN3-2 |
SWDCLK | CN2-2 | CN3-3 |
GND | CN2-3 | CN3-4 |
Download and build the Firmware
git clone https://github.com/blacksphere/blackmagic cd blackmagic git submodule init git submodule update make cd src make clean make PROBE_HOST=stlink
Remove the readout protection, erase and flash
openocd -f interface/stlink-v2.cfg -f target/stm32f1x_stlink.cfg -c "init" -c "halt" -c "stm32f1x unlock 0" -c "shutdown" st-flash erase st-flash --reset write blackmagic.bin 0x8002000 st-flash write blackmagic_dfu.bin 0x8000000
Documentation
Black Magic Discovery from Esden <-- This also describes how to remove the read out protection.
embdev.net page
BMP Method
Use a BMP to flash a STLink
Transfer the solder jumpers from "Default" to "Reversed" and build the firmware as described above.
Connect the BMP to the CN2 header (see Pinout above).
Start gdb, erase the option bytes and flash BMP
(gdb) target extended-remote /dev/ttyACM0 (gdb) mon swdp_scan (gdb) att 1 (gdb) mon option erase (gdb) load /dir/to/blackmagic (gdb) load /dir/to/blackmagic_dfu (gdb) detach
The option bytes do not cover the Readout Protection (RDP), but the RDP is disabled anyhow...
Error at loading a new image after removing RDP
Error erasing flash with vFlashErase packet
If this occurs powercycle the target (disconnect and reconnect the 3V3 connection), swd scan, attach and try loading the image again. Usually the reset of the RDP requires a flash erase (done by mon option erase) and reset.
Probably this can also be done via gdb.
Clones
There are also a lot of different Chinese clones out there. Most with an identical MCU as the original STLinkV2, some with an STM32F101.
It seems that each clone has its own programming pinout, so better double check (continuity tester) than to release the magic smoke...
Most (all?) should work with the "stlink" target from Blackmagic Probe, since they probably use the same firmware from the original STLinkV2.
Red PCB
Seems to work with the standard stlink BMP image.
- STM32F103C8T6
Programming header (1.27mm, populated on the images) from the Mini USB to the Pin header (right to left on the image), used for programming the onboard MCU.
- SWDIO
- GND
- SWDCLK
- 3V3
Some Images and details about this hardware can be found at[1]
Blue PCB
- STM32F103C8T6
Programming header (2.54mm, unpopulated on the images) from the USB to the Pin header (left to the right on the images), used for programming the onboard MCU.
- GND
- 5V
- USART1 RX (PA10)
- USART1 TX (PA9)
Bootloader header (2.54mm, unpopulated on the images), from the USB to the Pin header (left to the right on the images), used for USART bootloader activation
- 3V3
- BOOT0 (pin 44)
The 3V3/5V switch selects the input voltage for the onboard MCU.
Aluminium housing
- STM32F101C8T6
Programming header (1.27mm, unpopulated on the images) from the USB to the Pin header (left to the right on the images), used for programming the onboard MCU.
- SWDIO (PA13)
- GND
- SWDCLK(PA14)
- VDD, VBAT
To disassemble pull the aluminium housing towards the USB connector.
This has not the same hardware as https://github.com/blacksphere/blackmagic/issues/62 , but the same MCU, seems that this has just an other PCB.