https://github.com/brainelectronics/stm32-flash-lock
Flash a STM32F1 chip with some already compiled binary and optionally lock the chip with Readout protection level 1. Unlocking will erase the chip completly
https://github.com/brainelectronics/stm32-flash-lock
bash-script chip flash lock openocd stlink stm32 stm32f103 telnet unlock
Last synced: 12 days ago
JSON representation
Flash a STM32F1 chip with some already compiled binary and optionally lock the chip with Readout protection level 1. Unlocking will erase the chip completly
- Host: GitHub
- URL: https://github.com/brainelectronics/stm32-flash-lock
- Owner: brainelectronics
- Created: 2020-09-23T12:19:52.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2021-06-07T14:10:22.000Z (almost 4 years ago)
- Last Synced: 2025-03-25T06:41:34.221Z (29 days ago)
- Topics: bash-script, chip, flash, lock, openocd, stlink, stm32, stm32f103, telnet, unlock
- Language: Shell
- Homepage:
- Size: 39.1 KB
- Stars: 6
- Watchers: 2
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Flash and Lock STM32 devices
Bare minimum scripts to lock or unlock STM32 devices
---------------
## Tools
Install the following tools on your system.
### Openocd
*used version 0.10.0*
#### Linux
```bash
sudo apt-get install openocd
```
#### Mac
See [xpack OpenOCD Installation instructions](https://xpack.github.io/openocd/install/)
or download latest released version, unzip it and change its rights.
```bash
wget https://github.com/xpack-dev-tools/openocd-xpack/releases/download/v0.10.0-14/xpack-openocd-0.10.0-14-darwin-x64.tar.gz
tar -zxvf xpack-openocd-0.10.0-14-darwin-x64.tar.gz
chmod -R -w xpack-openocd-0.10.0-14-darwin-x64
```
Move the files into your applications folder and create a symlink to use it
with the same commands as on linux
```bash
sudo ln -s /Volumes/Macintosh\ HD/Applications/OpenOCD/ /usr/share/openocd
```
### telnet
```bash
sudo apt-get install telnet
```
## General
### Run openocd with telnet
Call this in first terminal
```bash
openocd -d3 -f stlink-v2.cfg -c "transport select hla_swd" -f stm32f1x.cfg
```
open second terminal
```bash
telnet 127.0.0.1 4444
```
### Programming with scripts
If the chip is locked, it can't be programmed until it is unlocked.
A power cycle is required after locking the chip to run the program.
Unlocking the chip will erase it's content completly.
#### Config
Config files for STLink are located at `/usr/share/openocd/scripts/interface/`,
config for targets can be found at ` /usr/share/openocd/scripts/target/`.
Be aware of different STLink versions, which only differ in one single char of VID.
#### Flashing
```bash
sh flash.sh path/to/some/file.bin
```
Flash a file with debug level 1
```bash
sh flash.sh path/to/some/file.bin -d1
```
#### Locking
Lock a STM32F1 with a STLink V2
```bash
sh lock.sh
```
Perform lock with debug level 2 on a STM32F1 with a STLink V2
```bash
sh lock.sh -d2
```
Use `general_un_lock_st.sh` to lock or unlock a general STM32 device. The
following example is for an STM32F0 by using a STLink
```bash
sh un_lock_st.sh \
/Applications/OpenOCD/bin/openocd \
/Applications/OpenOCD/scripts \
stlink \
stm32f0x \
lock
```
#### Unlocking
Unlock a STM32F1 with a STLink V2
```bash
sh unlock.sh
```
Perform unlock with debug level 1 on a STM32F1 with a STLink V2
```bash
sh unlock.sh -d1
```
Use `general_un_lock_st.sh` to lock or unlock a general STM32 device. The
following example is for an STM32F0 by using an STLink
```bash
sh un_lock_st.sh \
/Applications/OpenOCD/bin/openocd \
/Applications/OpenOCD/scripts \
stlink \
stm32f0x \
unlock
```
#### Power cycle (only on raspberry)
Power cycle the target by using a raspberry pi pin.
Connect VCC of the debug interface via a transistor or mosfet to VCC.
The mosfet or transistor is controlled by the raspberry pi pin.
You have to run this script once to configure the pin and turn it on.
```bash
python power_cycle.py
```