Firmware Upgrade for ST-LINK, ST-LINK/V2, ST-LINK/V2-1 and STLINK-V3 Boards

Release Note

About this release note

This release note contains information about the latest firmware versions for ST-LINK, ST-LINK/V2, ST-LINK/V2-1, and STLINK-V3 boards. It can be used to identify the version of the firmware currently running and, if necessary, upgrade firmware through the USB port.

STSW-LINK007 is the part number of the firmware upgrade application for ST-LINK, ST-LINK/V2, ST-LINK/V2-1, and STLINK-V3.

Table 1. ST-LINK board firmware upgrade release summary
Type Summary
Minor release ST-LinkUpgrade.exe 2.5.6 and STLinkUpgrade.jar 3.3.6:
  • Possibility to enable/disable the mass storage interface on STLINK-V3 boards
  • Improvements, especially of the SWV trace feature

Customer support

For more information or help concerning ST-LINK, ST-LINK/V2, ST-LINK/V2-1 and STLINK-V3 boards, contact the nearest STMicroelectronics sales office. For the complete list of STMicroelectronics offices and distributors, refer to the www.st.com webpage.

Software updates

Software updates and all the latest documentation can be downloaded from the STMicroelectronics support webpage at www.st.com/en/development-tools/stsw-link007.

Host PC system requirements

PC and compatibles running with:

Note: The firmware upgrade application is not validated on Windows 7® and Windows 8® because these systems are no longer officially maintained by Microsoft®.

The application requires the installation of the Java Runtime Environment 7u51 (or more recent). On Windows® operating systems, the ST-LINK board requires a dedicated USB driver (STSW-LINK009). If the STSW-LINK009 driver is not installed by the toolset, it can be downloaded from the www.st.com web site.

On Linux®, the application relies on libusb-1.0, which must be installed separately. For instance, on Ubuntu®, use the command sudo apt-get install libusb-1.0.

On Linux®, users must be granted rights for accessing the ST-LINK USB devices. This might require installing one of the packages (depending on the Linux® version) provided in the AllPlatforms/StlinkRulesFilesForLinux directory.

Note: STLINK-V3 boards can be recognized by Windows® 10 without any driver installation. However, ST-LINK driver installation is required for previous ST-LINK generations, or for STLINK-V3 boards on previous versions of Windows®.

Note: The ST-LINK boards feature a STM32 32-bit microcontroller based on the Arm® Cortex®-M processor.

macOS® is a trademark of Apple Inc. registered in the U.S. and other countries.

Linux® is a registered trademark of Linus Torvalds.

Java is a registered trademark of Oracle and/or its affiliates.

Ubuntu® is a registered trademark of Canonical Ltd.

Arm is a registered trademark of Arm Limited (or its subsidiaries) in the US and/or elsewhere.

All other trademarks are the property of their respective owners.

Licensing

STSW-LINK007 is delivered under the Mix Ultimate Liberty+OSS+3rd-party V1 software license agreement (SLA0048).

Change in ST-LinkUpgrade.exe 2.5.6 and STLinkUpgrade.jar 3.3.6

Enhancements and corrections

On ST-LINK/V2-1 and STLINK-V3 boards:

On STLINK-V3 boards:

On ST-LINK/V2 and ST-LINK/V2-1 boards:

Known problems and limitations

Release information for previous releases

4.1 Summary of change in ST-LinkUpgrade.exe 2.5.5 and STLinkUpgrade.jar 3.3.5

Enhancements and corrections

On ST-LINK/V2-1 and STLINK-V3 boards:

On STLINK-V3 boards:

4.2 Summary of changes in ST-LinkUpgrade.exe 2.5.4 and STLinkUpgrade.jar 3.3.4

Enhancements and corrections

On ST-LINK/V2, ST-LINK/V2-1 and STLINK-V3 boards:

On ST-LINK/V2-1 and STLINK-V3 boards:

On STLINK-V3E boards:

This possibility does not concern the STLINK-V3 standalone boards (STLINK-V3SET, STLINK-V3MINI and STLINK-V3MODS).

4.3 Summary of changes in ST-LinkUpgrade.exe 2.5.3 and STLinkUpgrade.jar 3.3.3

4.4 Summary of changes in ST-LinkUpgrade.exe 2.5.2 and STLinkUpgrade.jar 3.3.2

Enhancements and corrections

On STLINK-V3SET:

On STLINK-V3 boards:

4.5 Summary of changes in ST-LinkUpgrade.exe 2.5.2 and STLinkUpgrade.jar 3.3.2

Enhancements and corrections

On ST-LINK/V2, ST-LINK/V2-1 and STLINK-V3 boards, enhanced robustness in case of wrong initialization sequence from host PC and SWD communication WAIT status.

On ST-LINK/V2-1 boards and STLINK-V3SET, enhanced Virtual COM port and mass storage USB interfaces behaviour after PC reboot.

On STLINK-V3 boards, fixed regression appeared in V3J4M2: used space of mass storage virtual disk wrongly computed if target Flash size is over 1.5 Mbyte.

On ST-LINK/V2-1 boards for STM8, fixed issue with STM8 drag-and-drop programming potentially not working on boards with SWIM pin reconfigured.

On ST-LINK/V2-1 boards, Virtual COM port internal buffer increased from 512 bytes to 204 bytes for upstream (target to ST-LINK).

4.6 Summary of changes in ST-LinkUpgrade.exe 2.5.1 and STLinkUpgrade.jar 3.3.1

New feature

Manage the Flash drag-and-drop programming on STM32L552 and STM32L562 microcontrollers when Arm® TrustZone® for Armv8-M is enabled.

Enhancements and corrections

On STLINK-V3SET, the baud rate for the Virtual COM port can exceed 12 MHz.

On STLINK-V3SET, improved SWV (Serial Wire Viewer) and Virtual COM port performance (reduced the probability of data loss).

4.7 Summary of changes in ST-LinkUpgrade.exe 2.5.0 and STLinkUpgrade.jar 3.3.0

New features

Added the possibility to hide the mass-storage interface on ST-LINK/V2-1 and STLINK-V3 boards (requires to update the ST-LINK USB driver: STSW-LINK009 on Windows®, 49-stlinkvxxx.rules files on Linux®). Moreover, it might be also necessary to update the host application so that it identifies correctly this new ST-LINK version, especially on Linux® and macOS®.

On STLINK-V3SET, allows the replacement of the mass-storage interface by a second Virtual COM port (VCP2), using the Bridge UART signals of the MB1440B.CN9 connector. This VCP2 implements hardware-flow control (CTS/RTS) if the signals are physically connected to the target. The hardware-flow control can be disabled by removing the physical connection of signals to the target. It cannot be disabled by software (the hardware-flow control configuration parameter available in some hyperterminal applications has no effect on Virtual COM port).

Corrections

4.8 Summary of changes in ST-LinkUpgrade.exe 2.4.12 and STLinkUpgrade.jar 3.2.12

Correction

Fixed mass storage interface issue with NUCLEO-8L152R8 and NUCLEO-8S208RB on Windows 10® (operating system files corrupting the STM8 Flash). Currently, a binary file dropped into the mass storage virtual disk is programmed into the STM8 Flash only if it starts with code 0x82 and if the following 3 bytes (reset vector value) point to an address in Flash.

4.9 Summary of changes in ST-LinkUpgrade.exe 2.4.11 and STLinkUpgrade.jar 3.2.11

4.10 Summary of changes in ST-LinkUpgrade.exe 2.4.10 and STLinkUpgrade.jar 3.2.10

Correction (for STM32 debug with ST-LINK/V2-1 and ST-LINK/V2)

Fixed wrong management of STM32 target hardware reset pin by firmware V2J30M21 in SWD mode.

Summary of changes in ST-LinkUpgrade.exe 2.4.10 and STLinkUpgrade.jar 3.2.10

Corrections (for ST-LINK/V2-1 only)

4.11 Summary of changes in ST-LinkUpgrade.exe 2.4.9 and STLinkUpgrade.jar 3.2.9

Corrections (for ST-LINK/V2-1 only)

4.12 Summary of changes in ST-LinkUpgrade.exe 2.4.8 and STLinkUpgrade.jar 3.2.8

Corrections (for ST-LINK/V2-1 only)

4.13 Summary of changes in ST-LinkUpgrade.exe 2.4.5 and STLinkUpgrade.jar 3.2.5

Corrections (for ST-LINK/V2 and ST-LINK/V2-1)

Correction against sporadic failure during the initialization of the debug session on STM32L0xx microcontrollers.

4.14 Summary of changes in ST-LinkUpgrade.exe 2.4.2 and STLinkUpgrade.jar 3.2.2

Corrections (for ST-LINK/V2-1 only)

4.15 Summary of changes in ST-LinkUpgrade.exe 2.4.0 and STLinkUpgrade.jar 3.2.0

Corrections (for ST-LINK/V2-1)

4.16 Summary of changes in ST-LinkUpgrade.exe 2.3.30 and STLinkUpgrade.jar 3.1.0

Corrections

Fixed a regression, which made the V2J26M15 not functional on few host systems. Failing boards may be recovered either by upgrading the firmware to V2J27M15 from another host, not presenting the incompatibility with the V2J26M15, or by forcing manually the upgrade mode of the board, when possible. For instance on Nucleo-64 boards, make a little shortcut between RST and SB11 pads behind the board. In this way, firmware may be upgraded afterwards, even on host presenting the incompatibility with the V2J26M15. On other ST-LINK/V2-1 boards, refer to the schematics of the board to find how to reset the STM32F103CB microcontroller (solder bridge on the STM_RST signal).

4.17 Summary of changes in ST-LinkUpgrade.exe 2.3.28 and STLinkUpgrade.jar 3.0.7

Enhancement

Virtual COM port latency reduced from 5 ms to 1 ms (approximatively average values) in the target Tx / ST-LINK/V2-1 Rx direction.

Corrections

4.18 Summary of changes in ST-LinkUpgrade.exe 2.3.27 and STLinkUpgrade.jar 3.0.6

Enhancements

Large applications are now fully programmed through drag-and-drop on Evaluation boards (on Evaluation boards, applications with sizes greater than the target Flash memory size minus 4 Kbytes were not totally programmed).

4.19 Summary of changes in ST-LinkUpgrade.exe 2.3.26 and STLinkUpgrade.jar 3.0.5

Enhancement

Implementation of retry loops for better behavior in case of noisy SWD communication.

New features

4.20 Summary of changes in ST-LinkUpgrade.exe 2.3.24 and STLinkUpgrade.jar 3.0.3

Correction

Bugfix SWV not working with V2J23Mx firmware on some recent PCs.

New features

4.21 Summary of changes in ST-LinkUpgrade.exe 2.3.21 and STLinkUpgrade.jar 3.0.0

Corrections

New features

4.22 Summary of changes in ST-LinkUpgrade.exe 2.3.16

Corrections

4.23 Summary of changes in ST-LinkUpgrade.exe 2.3.14

New functionalities

4.24 Summary of changes in ST-LinkUpgrade.exe 2.3.11

Corrections

Set NRST pin high, when exiting the firmware update mode.

4.25 Summary of changes in ST-LinkUpgrade.exe 2.3.10

Corrections

4.26 Summary of changes in ST-LinkUpgrade.exe 2.3.7

Correction

Fixed the issue about the application sometimes not running after being programmed (STM32Fxx targets, programmed through a Save As action with long filename).

Revision history

Table 2. Document revision history
Date Revision Changes
13-Feb-2014 1 Initial release.
14-Apr-2014 2 Added content for new version 2.21.4.
2-June-2014 3 Added content for new version 2.21.5.
10-July-2014 4 Added content for new version 2.22.5.
22-Sept-2014 5 Added content for new version 2.23.6.
2-April-2015 6 Added content for new version 2.23.7.
25-May-2015 7 Added content for new version 2.24.11.
9-Nov-2015 8 Added content for new version 2.25.13.
11-Dec-2015 9 Added content for new version 2.25.14.
26-Jan-2016 10 Added content for new version 2.26.15.
7-Mar-2016 11 Added content for new version 2.27.15.
28-Sep-2016 12 Title and content changes to cover the firmware update for ST-LINK, ST-LINK/V2 and ST-LINK/V2-1 boards.
4-Jan-2017 13 Added Section 2: Changes in ST-LinkUpgrade.exe 2.4.2 and STLinkUpgrade.jar 3.2.2.
13-Sep-2017 14 Updated Section 2: Changes in ST-LinkUpgrade.exe 2.4.5 and STLinkUpgrade.jar 3.2.5.
17-Jan-2018 15 Updated Section 2: Changes in ST-LinkUpgrade.exe 2.4.8 and STLinkUpgrade.jar 3.2.8.
26-Mar-2018 16 Updated Section 2: Changes in ST-LinkUpgrade.exe 2.4.9 and STLinkUpgrade.jar 3.2.9.
27-Apr-2018 17 Updated Section 2: Changes in ST-LinkUpgrade.exe 2.4.10 and STLinkUpgrade.jar 3.2.10.
14-Jun-2018 18 Updated Section 2: Changes in ST-LinkUpgrade.exe 2.4.11 and STLinkUpgrade.jar 3.2.11.
27-Sep-2018 19 Updated Section 2: Changes in ST-LinkUpgrade.exe 2.4.12 and STLinkUpgrade.jar 3.2.12.
24-Jan-2019 20 Document scope extended to STLINK-V3:
  • Updated document title and About this release note
  • Updated Section 1: Host PC system requirements
  • Updated Section 2: Changes in ST-LinkUpgrade.exe 2.5.0 and STLinkUpgrade.jar 3.3.0
  • Added STLINK-V3SET entries to Section 3: Known problems and limitations
30-Apr-2019 21 Updated Section 2: Changes in ST-LinkUpgrade.exe 2.5.1 and STLinkUpgrade.jar 3.3.1.
27-Sep-2019 22 Updated Section 2: Changes in ST-LinkUpgrade.exe 2.5.2 and STLinkUpgrade.jar 3.3.2.
Updated document format.
30-Jan-2020 23 Updated Section 2 Change in ST-LinkUpgrade.exe 2.5.3 and STLinkUpgrade.jar 3.3.3 and Section 3 Known problems and limitations.
11-May-2020 24 Updated Section 2 Change in ST-LinkUpgrade.exe 2.5.4 and STLinkUpgrade.jar 3.3.4 and Section 3 Known problems and limitations.
7-Jan-2021 25 Updated Section 2 Change in ST-LinkUpgrade.exe 2.5.5 and STLinkUpgrade.jar 3.3.5. Updated the software license agreement in Licensing.
6-May-2021 26 Updated Section 2 Change in ST-LinkUpgrade.exe 2.5.6 and STLinkUpgrade.jar 3.3.6. Updated Section 3 Known problems and limitations.

PDF preview unavailable. Download the PDF instead.

dm00107009-firmware-upgrade-for-stlink-stlinkv2-stlinkv21-and-stlinkv3-boards-stmicroelectronics Antenna House PDF Output Library 7.0.1600; modified using iText 2.1.7 by 1T3XT C2 v4.2.0220 build 670 - c2 rendition config : Techlit Active

Related Documents

Preview STSW-LINK009 USB Driver for ST-LINK/V2 and ST-LINK/V2-1 | STMicroelectronics
STMicroelectronics STSW-LINK009 is a data brief detailing the USB driver for ST-LINK/V2 and ST-LINK/V2-1 boards, featuring WinUSB CoInstallers for multiple Windows versions.
Preview ST-LINK/V2 In-Circuit Debugger/Programmer User Manual
User manual for STMicroelectronics' ST-LINK/V2 and ST-LINK/V2-ISOL in-circuit debuggers/programmers, detailing features, hardware and software configuration, connection methods for STM8 and STM32 microcontrollers, and status indicators.
Preview ST-LINK/V2 In-Circuit Debugger/Programmer User Manual
User manual for STMicroelectronics' ST-LINK/V2 and ST-LINK/V2-ISOL in-circuit debuggers/programmers. This document details features, hardware configuration, software setup, connection methods for STM8 and STM32 microcontrollers, and status LED indicators.
Preview ST-LINK/V2 & ST-LINK/V2-ISOL User Manual: Debugging STM8 and STM32 Microcontrollers
Comprehensive user manual for STMicroelectronics' ST-LINK/V2 and ST-LINK/V2-ISOL in-circuit debuggers and programmers, detailing features, hardware configuration, software integration, and usage for STM8 and STM32 microcontrollers.
Preview STM32 Nucleo-144 Board NUCLEO-L496ZG - STMicroelectronics
Data brief for the STM32 Nucleo-144 board (NUCLEO-L496ZG) from STMicroelectronics, featuring an STM32L496ZGT6 microcontroller, Arduino Uno V3 and ST morpho connectivity, and an integrated ST-LINK/V2-1 debugger. Ideal for prototyping and embedded system development.
Preview ST-LINK/V2 In-Circuit Debugger/Programmer for STM8 and STM32 User Manual
This user manual provides comprehensive information on the ST-LINK/V2 and ST-LINK/V2-ISOL in-circuit debuggers/programmers for STM8 and STM32 microcontrollers. It covers features, hardware configuration, connection methods for STM8 and STM32 applications, software configuration, and schematics.
Preview STM32 ST-LINK Utility User Manual
This user manual provides a comprehensive guide to the STM32 ST-LINK Utility software, detailing its features, user interface, and command-line operations for programming and debugging STM32 microcontrollers.
Preview STM32 Nucleo-144 Board: Features, Description, and Ordering Information
A comprehensive data brief detailing the features, description, device summary, and ordering information for the STM32 Nucleo-144 development board, including its connectivity options, debugger, software support, and various STM32 microcontroller variants.