RN0107

Release note

ST-LINK server

About this release note

This release note contains information about the latest version of the ST-LINK server application for ST-LINK/V2,
ST-LINK/V2-1, and STLINK-V3 boards.
ST-LINK-SERVER is the part number of this application.

Table 1. ST-LINK server 2.1.0 release summary

Type Summary

Minor release Performance improvement

Customer support
For more information or help concerning 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/st-link-server.

RN0107 - Rev 7 - April 2022 www.st.com

For further information contact your local STMicroelectronics sales office.
 RN0107
General information

1 General information

1.1 Overview
The ST-LINK server is an application sharing the debug interface of a single ST-LINK board among several
host applications, typically a debugging tool and a monitoring tool. Of course, two debugging tools cannot
simultaneously control the same target, but both may have access to it if appropriate connection settings are
chosen.
The ST-LINK server also has access to several boards with one single tool to launch and control the debugging of
these boards.
The host application must be able to connect to the ST-LINK server instead of connecting directly to the ST-LINK
USB interface.
Other ST-LINK interfaces (such as Virtual COM port and mass storage, if provided) are not managed through the
ST-LINK server, but may be used simultaneously.

ST-LINK-SERVER interfaces with ST-LINK probes which run on dedicated STM32 microcontrollers based on the
Arm® Cortex®-M processor.
Note: Arm is a registered trademark of Arm Limited (or its subsidiaries) in the US and/or elsewhere.

1.2 Host PC system requirements

• Multi‑OS support: Windows® 10, Linux® 64-bit, or macOS® operating systems
On Windows® operating system, the ST-LINK board requires the installation of a dedicated USB driver. In case
the driver is not installed by the used toolset, it can be found on the STSW-LINK009 webpage.
On Linux®, the application relies on libusb-1.0, which must be installed separately. For instance, on Ubuntu®,
this is done through the command sudo apt-get install libusb-1.0.
On Linux®, users must be granted rights to accessing the ST-LINK USB devices. If not already done, it might
be necessary to install one of the packages (depending on the Linux® version) provided by the ST-LINK,
ST-LINK/V2, ST-LINK/V2-1, and STLINK-V3 boards firmware upgrade package (STSW-LINK007) in its folder
AllPlatforms/StlinkRulesFilesForLinux.
Note: macOS® is a trademark of Apple Inc., registered in the U.S. and other countries and regions.
Linux® is a registered trademark of Linus Torvalds.
Ubuntu® is a registered trademark of Canonical Ltd.
All other trademarks are the property of their respective owners.

RN0107 - Rev 7 page 2/10

 RN0107
Licensing

1.3 Licensing
ST-LINK-SERVER is delivered under the Mix Ultimate Liberty+OSS+3rd-party V1 software license agreement
(SLA0048).

1.4 Toolset first versions

Toolset first versions supporting the ST-LINK server
• STM32CubeIDE 1.0.0
• STM32CubeProgrammer (STM32CubeProg) 1.3.0
• Keil® MDK v5.27
• IAR Systems® EWARM 8.30
• SW4STM32 2.2.0

RN0107 - Rev 7 page 3/10

 RN0107
ST-LINK server 2.1.0

2 ST-LINK server 2.1.0

Software package content

The zip file contains 5 packages:
1. For Windows® st-stlink-server.2.1.0-1.msi
2. For macOS® X st-stlink-server.2.1.0-1.pkg
3. For Linux® Debian® st-stlink-server-2.1.0-1-linux-amd64.deb
4. For Linux® Red Hat® st-stlink-server-2.1.0-1-linux-amd64.rpm
5. For other Linux® OS st-stlink-server-2.1.0-1-linux-amd64.install.sh
The zip file also contains the raw binary for Linux® (out of any installation package): stlink-server.2.1.0-1,
and a readme.txt file.
Note: Red Hat® is a registered trademark of Red Hat, Inc.
Debian is a registered trademark of Software in the Public Interest, Inc.

What is new
• Added support of miscellaneous commands for performance enhancement (API extended to version 3).
• Do not enumerate ST-LINK boards (v1, obsolete), as they are not supported.

RN0107 - Rev 7 page 4/10

 RN0107
Known problems and limitations

3 Known problems and limitations

1. The ST-LINK server provides simultaneous communication channels to a single ST-LINK board (and target
microcontroller behind) but does not manage priorities between client applications. As a consequence, a
new connection attempt might disturb or kill a previously established connection if, for instance, the second
client application drives the reset of the target or stops the core).
The typical use case for sharing target accesses is one application controlling the target (a debugger for
instance), and one application monitoring the target (and connecting without impacting the target state).
2. The SWV (Serial Wire Viewer) feature can not be shared between applications. Only one application is
allowed to control it. The behavior in the case of conflicting applications is not predictable.
In case of instabilities with SWV in shared mode, firstly try the same SWV configuration out of the shared
mode.
3. When connecting to an STM32 target, the protocol (SWD or JTAG) is selected by the first client application
connecting. In further connections, the protocol must be the same (if a JTAG connection is attempted while
an SWD is already set, the new connection fails).
Conversely, the protocol frequency is enforced by the last caller. Any attempt to modify the frequency of one
protocol has no impact on the other.
4. The default connection setting is localhost port 7184. The server only accepts sockets from the local host.
The port may be modified (implementation dependent), however, for correct behavior, all clients must use
the same port. Only one instance of the server must run.
5. On Windows® and Linux®, it is necessary to uninstall a previous version, if present, before installing the new
one.
6. Long commands may result in timeout when done on a target at a very low SWD frequency (5 kHz). Either
increase the SWD frequency or connect to the target in the direct (not shared) mode.
7. ST-LINK/V1 boards (now obsolete) are not supported by the ST-LINK server.

RN0107 - Rev 7 page 5/10

 RN0107
Release information for previous releases

4 Release information for previous releases

4.1 ST-LINK server 2.0.2

Software package content
The zip file contains 5 packages:
1. For Windows® st-stlink-server.2.0.2-3.msi
2. For macOS® X st-stlink-server.2.0.2-3.pkg
3. For Linux® Debian® st-stlink-server-2.0.2-3-linux-amd64.deb
4. For Linux® Red Hat® st-stlink-server-2.0.2-3-linux-amd64.rpm
5. For other Linux® OS st-stlink-server-2.0.2-3-linux-amd64.install.sh
The zip file also contains the raw binary for Linux® (out of any installation package): stlink-server.2.0.2-3,
and a readme.txt file.

What is new
• Update from libusb 1.0.22 to libusb 1.0.23 to fix ST-LINK detection issue in some USB context
• Modified error messages, especially in case of several running instances
• Allowed commands with a payload greater than 1428 bytes (and up to 6144 bytes) after segmentation
• Partial fix of timeout issue at SWD frequency less than 1 MHz (50/200/500 kHz).
libSTLinkUSBDriver 6.0.0.0 at least is necessary for a full fix. The issue may remain at 5 kHz.
• Enhanced robustness against ST-LINK disconnection
• Updated standalone installer on Linux® for correct downgrade check and suppression of a wrong error
message

4.2 ST-LINK server 1.3.0

Software package content
The zip file contains 5 packages:
1. For Windows® st-stlink-server.1.3.0-4.msi
2. For macOS® st-stlink-server.1.3.0-4.pkg
3. For Linux® Debian®st-stlink-server-1.3.0-4-linux-amd64.deb
4. For Linux® Red Hat® st-stlink-server-1.3.0-4-linux-amd64.rpm
5. For other Linux® OS st-stlink-server-1.3.0-4-linux-amd64.install.sh
The zip file also contains the raw binary for Linux® (out of any installation package): stlink-server.1.3.0-4,
and a readme.txt file.

What is new
• Improved robustness in case of intensive client connection/disconnection sequences
• Fixed issue preventing installation on macOS® Catalina
• Added license information to the Linux® package

RN0107 - Rev 7 page 6/10

 RN0107
ST-LINK server 1.1.1

4.3 ST-LINK server 1.1.1

Software package content
The zip file contains 5 packages:
1. For Windows® st-stlink-server.1.1.1-3.msi
2. For macOS® st-stlink-server.1.1.1-3.pkg
3. For Linux® Debian® st-stlink-server-1.1.1-3-linux-amd64.deb
4. For Linux® Red Hat® st-stlink-server-1.1.1-3-linux-amd64.rpm
5. For other Linux® OS st-stlink-server-1.1.1-3-linux-amd64.rpm

What is new
• Added support for STLINK-V3SET

4.4 ST-LINK server 1.0

• Fix SWO trace issue
• Normalized error log
• Add JTAG support

RN0107 - Rev 7 page 7/10

 RN0107

Revision history
Table 2. Document revision history

Document
Date Changes
revision

13-Sep-2017 1 Initial version.

Updated:
• Chapter 2.2: Software package content
28-Nov-2017 2
Added:
• Chapter 2.3: What’s new
Updated:
• Section 2 ST-LINK server latest version
• Section 3 on the configuration in shared mode
22-Feb-2019 3 Added:
• STLINK-V3 support in Introduction, Customer support, and General
information
• Section 4: Release information for previous releases
Updated:
• Section 3 Known problems and limitations
• ST-LINK server 1.1.1 moved to Section 4 Release information for
10-Feb-2020 4 previous releases
Added:
• Release information in ST-LINK server 1.3.0
Updated:
• Table 1 switch to the new major release
• Section 3 Known problems and limitations
27-Nov-2020 5 • ST-LINK server 1.3.0 moved to Section 4 Release information for
previous releases
Added:
• Release information in ST-LINK server 2.0.2
Updated:
• Table 1 switch to the new minor release
25-Aug-2021 6 • Supported operating systems in Section 1.2 Host PC system
requirements
• Software package content and what is new in Section 2 ST-LINK server
2.0.2
Updated:
• Table 1 switch to the new minor release
14-Apr-2022 7 • Software package content and what is new in Section 2 ST-LINK server
2.1.0
• ST-LINK server 2.0.2 moved to Section 4 Release information for
previous releases

RN0107 - Rev 7 page 8/10

 RN0107
Contents

Contents
1 General information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1.2 Host PC system requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1.3 Licensing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.4 Toolset first versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
2 ST-LINK server 2.1.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
3 Known problems and limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
4 Release information for previous releases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
4.1 ST-LINK server 2.0.2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
4.2 ST-LINK server 1.3.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
4.3 ST-LINK server 1.1.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
4.4 ST-LINK server 1.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Revision history . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8

RN0107 - Rev 7 page 9/10

 RN0107

IMPORTANT NOTICE – READ CAREFULLY

STMicroelectronics NV and its subsidiaries (“ST”) reserve the right to make changes, corrections, enhancements, modifications, and improvements to ST
products and/or to this document at any time without notice. Purchasers should obtain the latest relevant information on ST products before placing orders. ST
products are sold pursuant to ST’s terms and conditions of sale in place at the time of order acknowledgment.
Purchasers are solely responsible for the choice, selection, and use of ST products and ST assumes no liability for application assistance or the design of
purchasers’ products.
No license, express or implied, to any intellectual property right is granted by ST herein.
Resale of ST products with provisions different from the information set forth herein shall void any warranty granted by ST for such product.
ST and the ST logo are trademarks of ST. For additional information about ST trademarks, refer to www.st.com/trademarks. All other product or service names
are the property of their respective owners.
Information in this document supersedes and replaces information previously supplied in any prior versions of this document.
© 2022 STMicroelectronics – All rights reserved

RN0107 - Rev 7 page 10/10