Skip to content

Commit 11e357a

Browse files
General project update
- Updated version_support - Updated tutorial - Updated CHANGELOG - Updated list of contributors - Fixed parsing of unit prefixes (Closes #1445) - Updated list of supported devices - Added support for STM32C051/71/91 chips - Added support for STM32U031/73/83 chips (Closes #1436)
1 parent e734619 commit 11e357a

File tree

14 files changed

+133
-43
lines changed

14 files changed

+133
-43
lines changed

CHANGELOG.md

Lines changed: 22 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
# v1.8.1
44

5-
Release date: 2024-09-01
5+
Release date: 2025-03-xx
66

77
This release drops support for some older operating systems. Check project README for details.
88

@@ -13,6 +13,8 @@ Updated system requirements:
1313
- `libgtk-dev` >= 3.24.18
1414

1515
Features:
16+
17+
- Show all info during full erase ([#1363](https://github.com/stlink-org/stlink/pull/1363), commit [#6a6718b](https://github.com/stlink-org/stlink/commit/6a6718b3342b6c5e282a4e33325b9f97908a0692))
1618
- Added support for STLINK-V3PWR ([#1388](https://github.com/stlink-org/stlink/pull/1388), [#1389](https://github.com/stlink-org/stlink/pull/1389))
1719
- Dynamic SRAM size for F4 memory map ([#1390](https://github.com/stlink-org/stlink/pull/1390))
1820
- Modifications to allow building of toolset in OpenBSD ([#1392](https://github.com/stlink-org/stlink/pull/1392))
@@ -21,26 +23,36 @@ Features:
2123
- Improvements for stlink-gui ([#1411](https://github.com/stlink-org/stlink/pull/1411))
2224
- [STM32U575/585]: Added support for OTP bytes ([#1419](https://github.com/stlink-org/stlink/pull/1419))
2325
- [STM32Gx]: Added erase support for multi-bank products ([#1420](https://github.com/stlink-org/stlink/pull/1420))
26+
- libusb-cmake as libusb provider and added support for MSVC ([#1424](https://github.com/stlink-org/stlink/pull/1424), [#1440](https://github.com/stlink-org/stlink/pull/1440))
27+
- [STM32L4Q5CG]: Added support for device ([#1438](https://github.com/stlink-org/stlink/pull/1438), [#1439](https://github.com/stlink-org/stlink/pull/1439))
2428

2529
Updates & changes:
30+
31+
- [stlink-lib] Clarified warning message for data alignment ([#1371](https://github.com/stlink-org/stlink/pull/1371), commit [#40ee5f4](https://github.com/stlink-org/stlink/commit/40ee5f4bd1151cec65f291f0166429b061c6e5c0))
32+
- Rewrite commandline usage text for st-flash tool ([#1372](https://github.com/stlink-org/stlink/pull/1372), commit [#95862cc](https://github.com/stlink-org/stlink/commit/95862cc687203ca20e328804f149959c51da2947))
2633
- Debian 11 x64 doesn't work with v1.8.0 because of incompatible glibc ([#1376](https://github.com/stlink-org/stlink/pull/1376), commit [#ece34ef](https://github.com/stlink-org/stlink/commit/ece34efbce579ca7d367c58f903ffa6dc7bd96e6))
2734
- [STM32L4R5ZI]: gdb-multiarch uses wrong osabi ([#1386](https://github.com/stlink-org/stlink/pull/1386), [#1387](https://github.com/stlink-org/stlink/pull/1387), [#1394](https://github.com/stlink-org/stlink/pull/1394))
2835
- [doc] STM32H573 reports chipid 0x000 ([#1398](https://github.com/stlink-org/stlink/pull/1398), commit [#3655871](https://github.com/stlink-org/stlink/commit/3655871f8dd97294bbee191c1c7341c8a129af2f))
2936

3037
Fixes:
3138

39+
- Can't build stlink 1.8.0 for Fedora ([#1365](https://github.com/stlink-org/stlink/pull/1365), [#1444](https://github.com/stlink-org/stlink/pull/1444), commit [#6a6718b](https://github.com/stlink-org/stlink/commit/6a6718b3342b6c5e282a4e33325b9f97908a0692))
40+
- Fixed include path for header file poll.h ([#1370](https://github.com/stlink-org/stlink/pull/1370), commit [#710e1d3](https://github.com/stlink-org/stlink/commit/710e1d3c3b72187769fcc6a4878c73e35ce03f9b))
3241
- Cmake minimal version mismatch ([#1374](https://github.com/stlink-org/stlink/pull/1374), [#1375](https://github.com/stlink-org/stlink/pull/1375), commit [#1ee7f6b](https://github.com/stlink-org/stlink/commit/1ee7f6b6c05e305112bb070ae571ebbe26c55946))
3342
- Added a graceful way to terminate st-util ([#1395](https://github.com/stlink-org/stlink/pull/1395), [#1396](https://github.com/stlink-org/stlink/pull/1396))
3443
- [st-trace] Bug in function static bool read_trace( ) ([#1400](https://github.com/stlink-org/stlink/pull/1400), commit [#32ce4bf](https://github.com/stlink-org/stlink/commit/32ce4bf88a816fb6a9841a33e6c5f6b593a9b927))
3544
- Fixed STM32H7 FLASH_OPTCR unlock sequence ([#1401](https://github.com/stlink-org/stlink/pull/1401), [#1416](https://github.com/stlink-org/stlink/pull/1416))
3645
- Restored support for STM32G4 Cat4 device STM32G491 ([#1403](https://github.com/stlink-org/stlink/pull/1403), [#1414](https://github.com/stlink-org/stlink/pull/1414))
46+
- Target reset is less reliable on testing branch ([#1409](https://github.com/stlink-org/stlink/pull/1409), commit [#733893a](https://github.com/stlink-org/stlink/commit/733893a50b1cc9323765a62c456c129ed6807886))
3747
- Fixed STM32H7 option byte programming ([#1417](https://github.com/stlink-org/stlink/pull/1417))
3848
- Latest release stlink-1.8.0-win32 doesn't run ([#1364](https://github.com/stlink-org/stlink/pull/1364), [#1410](https://github.com/stlink-org/stlink/pull/1410), commit [#e493109](https://github.com/stlink-org/stlink/commit/e4931097f887d8a048d1d188388b82ced918cf08))
3949
- Make path to .chip files relative to installation directory on Windows ([#1421](https://github.com/stlink-org/stlink/pull/1421))
50+
- Re-add support for STM32F411xC/xE option bytes read/write ([#1422](https://github.com/stlink-org/stlink/pull/1422))
4051
- Replaced deprecated cmd to fix package uninstall ([#1426](https://github.com/stlink-org/stlink/pull/1426))
4152
- Fixed compilation error -Wshorten-64-to-32 in stlink-lib/usb.c ([#1427](https://github.com/stlink-org/stlink/pull/1427))
4253
- st-util cannot parse -V and -F options and --freq option results in a segmentation fault ([#1428](https://github.com/stlink-org/stlink/pull/1428), [#1429](https://github.com/stlink-org/stlink/pull/1429))
4354

55+
4456
# v1.8.0
4557

4658
Release date: 2024-02-01
@@ -148,6 +160,7 @@ Fixes:
148160
- stlink-gui: failed to allocate 139988352155568 bytes ([#1356](https://github.com/stlink-org/stlink/pull/1356))
149161
- [STM32U575RGT6]: Verification failed at offset 43008 ([#1362](https://github.com/stlink-org/stlink/pull/1362), commit [#0145bae](https://github.com/stlink-org/stlink/commit/0145baeb2e3bac31bf9d3cbd0dab38d70618d46b))
150162

163+
151164
# v1.7.0
152165

153166
Release date: 2021-04-25
@@ -218,6 +231,7 @@ Fixes:
218231
- Applied missing changes to tests ([#1119](https://github.com/stlink-org/stlink/pull/1119))
219232
- Fixed reading of chip ID on Cortex-M0+ core ([#1017](https://github.com/stlink-org/stlink/pull/1017), [#1125](https://github.com/stlink-org/stlink/pull/1125), [#1126](https://github.com/stlink-org/stlink/pull/1126), [#1133](https://github.com/stlink-org/stlink/pull/1133))
220233

234+
221235
# v1.6.1
222236

223237
Release date: 2020-06-01
@@ -315,6 +329,7 @@ Fixes:
315329
- Fixed udev rules installing to wrong directory ([#966](https://github.com/stlink-org/stlink/pull/966))
316330
- Fixed formatting for options display in `st-flash` & `st-info` (commits [#c783d0e](https://github.com/stlink-org/stlink/commit/c783d0e777ccc83a7a8be26a4f4d3414e0478560) and [#562cd24](https://github.com/stlink-org/stlink/commit/562cd2496e696dbd22950925866aac662d81ee5f))
317331

332+
318333
# v1.6.0
319334

320335
Release date: 2020-02-20
@@ -367,6 +382,7 @@ General project updates:
367382
- Added `CODE_OF_CONDUCT` (Nightwalker-87)
368383
- Archived page from github project wiki to doc/wiki_old.md (Nightwalker-87)
369384

385+
370386
# v1.5.1
371387

372388
Release date: 2018-09-13
@@ -400,6 +416,7 @@ Updates and fixes:
400416
- Return correct value on `EOF` for semihosting `SYS_READ` ([#726](https://github.com/stlink-org/stlink/pull/726), [#727](https://github.com/stlink-org/stlink/pull/727), [#728](https://github.com/stlink-org/stlink/pull/728), [#729](https://github.com/stlink-org/stlink/pull/729), [#730](https://github.com/stlink-org/stlink/pull/730), [#731](https://github.com/stlink-org/stlink/pull/731), [#732](https://github.com/stlink-org/stlink/pull/732))
401417
- FreeBSD defines `LIBUSB_API_VERSION` instead of `LIBUSBX_API_VERSION` ([#733](https://github.com/stlink-org/stlink/pull/733))
402418

419+
403420
# v1.5.0
404421

405422
Release date: 2018-02-16
@@ -422,6 +439,7 @@ Updates and fixes:
422439
- Added debian/triggers to run `ldconfig` ([#664](https://github.com/stlink-org/stlink/pull/664))
423440
- Fixed build on Fedora with GCC 8 ([#666](https://github.com/stlink-org/stlink/pull/666), [#667](https://github.com/stlink-org/stlink/pull/667), [#668](https://github.com/stlink-org/stlink/pull/668))
424441

442+
425443
# v1.4.0
426444

427445
Release date: 2017-07-01
@@ -449,6 +467,7 @@ Updates and fixes:
449467
- Fixed flashing to `F0 device` targets ([#594](https://github.com/stlink-org/stlink/pull/594), [#595](https://github.com/stlink-org/stlink/pull/595))
450468
- Fixed wrong counting when flashing ([#605](https://github.com/stlink-org/stlink/pull/605))
451469

470+
452471
# v1.3.1
453472

454473
Release date: 2017-02-25
@@ -468,6 +487,7 @@ Updates and fixes:
468487
- Fixed incorrect release folder name in docs ([#560](https://github.com/stlink-org/stlink/pull/560))
469488
- Fixed compilation when path includes spaces ([#561](https://github.com/stlink-org/stlink/pull/561))
470489

490+
471491
# v1.3.0
472492

473493
Release date: 2017-01-28
@@ -517,6 +537,7 @@ Updates and fixes:
517537
- Wrong extract command in `FindLibUSB.cmake` ([#510](https://github.com/stlink-org/stlink/pull/510), [#511](https://github.com/stlink-org/stlink/pull/511))
518538
- Fixed compilation error on Ubuntu 16.10 ([#514](https://github.com/stlink-org/stlink/pull/514), [#525](https://github.com/stlink-org/stlink/pull/525))
519539

540+
520541
# v1.2.0
521542

522543
Release date: 2016-05-16

config/chips/C051xx.chip

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
# Chip-ID file for STM32C051xx device
2+
#
3+
dev_type STM32C051xx
4+
ref_manual_id 0490
5+
chip_id 0x44C // STM32_CHIPID_C051xx
6+
flash_type C0
7+
flash_size_reg 0x1fff75a0
8+
flash_pagesize 0x800 // 2 KB
9+
sram_size 0x3000 // 12 KB
10+
bootrom_base 0x1fff0000
11+
bootrom_size 0x1800 // 6 KB
12+
option_base 0x1fff7800 // STM32_C0_OPTION_BYTES_BASE
13+
option_size 0x80 // 128 B
14+
flags none

config/chips/C071xx.chip

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
# Chip-ID file for STM32C071xx device
2+
#
3+
dev_type STM32C071xx
4+
ref_manual_id 0490
5+
chip_id 0x493 // STM32_CHIPID_C071xx
6+
flash_type C0
7+
flash_size_reg 0x1fff75a0
8+
flash_pagesize 0x800 // 2 KB
9+
sram_size 0x6000 // 24 KB
10+
bootrom_base 0x1fff0000
11+
bootrom_size 0x1800 // 6 KB
12+
option_base 0x1fff7800 // STM32_C0_OPTION_BYTES_BASE
13+
option_size 0x80 // 128 B
14+
flags none

config/chips/C091xx.chip

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
# Chip-ID file for STM32_C091xx_C92xx device
2+
#
3+
dev_type STM32_C091xx_C92xx
4+
ref_manual_id 0490
5+
chip_id 0x44D // STM32_CHIPID_C091xx_C92xx
6+
flash_type C0
7+
flash_size_reg 0x1fff75a0
8+
flash_pagesize 0x800 // 2 KB
9+
sram_size 0x9000 // 36 KB: C92xx: 30 KB + 6KB FDCAN RAM (RM490 rev. 5 2.4 FDCAN RAM)
10+
bootrom_base 0x1fff0000
11+
bootrom_size 0x1800 // 6 KB
12+
option_base 0x1fff7800 // STM32_C0_OPTION_BYTES_BASE
13+
option_size 0x80 // 128 B
14+
flags none

config/chips/L45x_L46x.chip

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,4 +13,4 @@ option_base 0x0
1313
option_size 0x0
1414
flags swo
1515
otp_base 0x1fff7000
16-
otp_size 0x400 // 1 KB
16+
otp_size 0x400 // 1 KB

config/chips/U031xx.chip

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
# Chip-ID file for STM32U031xx device
2+
#
3+
dev_type STM32U031xx
4+
ref_manual_id 0503
5+
chip_id 0x459 // STM32_CHIPID_U031xx
6+
flash_type C0
7+
flash_size_reg 0x1fff3ea0
8+
flash_pagesize 0x800 // 2 KB
9+
sram_size 0x3000 // 12 KB
10+
bootrom_base 0x1fff0000
11+
bootrom_size 0x1400 // 5 KB
12+
option_base 0x1fff7000 // STM32_U0_OPTION_BYTES_BASE
13+
option_size 0x1000 // 4 KB
14+
flags swo

config/chips/U073xx_083xx.chip

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
# Chip-ID file for STM32U073xx / STM32U083xx device
2+
#
3+
dev_type STM32U073xx_U083xx
4+
ref_manual_id 0503
5+
chip_id 0x489 // STM32_CHIPID_U073xx_U083xx
6+
flash_type C0
7+
flash_size_reg 0x1fff6ea0
8+
flash_pagesize 0x800 // 2 KB
9+
sram_size 0xa000 // 40 KB
10+
bootrom_base 0x1fff0000
11+
bootrom_size 0x1400 // 5 KB
12+
option_base 0x1fff7000 // STM32_U0_OPTION_BYTES_BASE
13+
option_size 0x1000 // 4 KB
14+
flags swo

contributors.txt

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,7 @@ Alexey Cherevatenko
44
Alexey Panarin
55
Anatoli Klassen [dev26th]
66
Andrea Mucignat
7+
Andreas Michelis [a-michelis]
78
Andrew Andrianov [nekromant]
89
Andrey Yurovsky
910
Andy Isaacson

doc/compiling.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -9,31 +9,31 @@ On Windows users should ensure that the following software is installed:
99

1010
- `git` (_optional, but recommended_)
1111
- `7zip`
12-
- `cmake`
1312
- `MSYS2`
1413

1514
### Installation
1615

17-
1. Install `git` from <https://git-scm.com/download/win>
18-
2. Install `cmake` from <https://cmake.org/download/#latest> --> Binary distributions --> Windows x64 Installer<br />
19-
Ensure that you add cmake to the $PATH system variable when following the instructions by the setup assistant.
20-
3. Install `MSYS2` from <https://www.msys2.org/><br />
16+
1. Install `MSYS2` from <https://www.msys2.org/><br />
2117
Follow the installation instructions on the website.
22-
4. Install `mingw-w64` via the MSYS2 UCRT64 Shell: `pacman -S mingw-w64-x86_64-make`
23-
5. Fetch the project sourcefiles by running `git clone https://github.com/stlink-org/stlink.git`from the command-line (cmd.exe)<br />
18+
2. Install `mingw-w64` via the MSYS2 UCRT64 Shell: `pacman -S mingw-w64-x86_64-cmake mingw-w64-x86_64-make mingw-w64-x86_64-gcc git`
19+
3. Fetch the project sourcefiles by running `git clone https://github.com/stlink-org/stlink.git`from the command-line (cmd.exe)<br />
2420
or download and extract (`7zip`) the stlink zip-sourcefolder from the Release page on GitHub.
2521

2622
### Building
2723

2824
1. Open the command-line (cmd.exe) with administrator privileges
29-
2. Move to the `stlink` directory with `cd C:\$Path-to-your-stlink-folder$\`
30-
3. Execute `mingw64-build.bat`
25+
2. Move to the `stlink` directory and execute `C:\$Path-to-your-stlink-folder$\mingw64-build.bat`
3126

3227
Depending on the flavour of compilation the final executables will be placed in the following directories:
3328
- Local compilation: `<project_root>\build-mingw\bin`
3429
- Local installation: `C:\Program Files (x86)\stlink\bin`
3530
- Package Generation (portable): `C:\Users\swift\Desktop\stlink\build-mingw\dist`
3631

32+
#### Removal:
33+
34+
Remove `C:\Program Files (x86)\stlink\` and `C:\$Path-to-your-stlink-folder$`.
35+
36+
3737
**NOTE:**
3838

3939
[ST-LINK drivers](https://www.st.com/en/development-tools/stsw-link009.html) are required for programmers to work with `stlink`.

doc/supported_devices.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,7 @@ More commonly these are:
99
| STM32C0 | M0+ | |
1010
| STM32G0 | M0+ | |
1111
| STM32L0 | M0+ | |
12+
| STM32U0 | M0+ | *preliminary, limited and partial support only!* |
1213
| STM32F10**0** | M3 | Value line |
1314
| STM32F10**1** | M3 | Access line |
1415
| STM32F10**2** | M3 | USB Access line |

0 commit comments

Comments
 (0)