On Windows users should ensure that the following software is installed:
git
(optional, but recommended)7zip
cmake
MSYS2
- Install
git
from https://git-scm.com/download/win - Install
cmake
from https://cmake.org/download/#latest --> Binary distributions --> Windows x64 Installer
Ensure that you add cmake to the $PATH system variable when following the instructions by the setup assistant. - Install
MSYS2
from https://www.msys2.org/
Follow the installation instructions on the website. - Install
mingw-w64
via the MSYS2 UCRT64 Shell:pacman -S mingw-w64-x86_64-make
- Fetch the project sourcefiles by running
git clone https://github.com/stlink-org/stlink.git
from the command-line (cmd.exe)
or download and extract (7zip
) the stlink zip-sourcefolder from the Release page on GitHub.
- Open the command-line (cmd.exe) with administrator privileges
- Move to the
stlink
directory withcd C:\$Path-to-your-stlink-folder$\
- Execute
mingw64-build.bat
Depending on the flavour of compilation the final executables will be placed in the following directories:
- Local compilation:
<project_root>\build-mingw\bin
- Local installation:
C:\Program Files (x86)\stlink\bin
- Package Generation (portable):
C:\Users\swift\Desktop\stlink\build-mingw\dist
NOTE:
ST-LINK drivers are required for programmers to work with stlink
.
Install the following packages from your package repository:
git
gcc
orclang
ormingw32-gcc
ormingw64-gcc
(C-compiler; very likely gcc is already present)build-essential
(on Debian based distros (Debian, Ubuntu))cmake
rpm
(on Debian based distros (Debian, Ubuntu), needed for package build withmake package
)libusb-1.0
libusb-1.0-0-dev
(development headers for building)libgtk-3-dev
(optional, needed forstlink-gui
)pandoc
(optional, needed for generating manpages from markdown)
or execute (Debian-based systems only): apt-get install gcc build-essential cmake libusb-1.0 libusb-1.0-0-dev libgtk-3-dev pandoc
(Replace gcc with the intended C-compiler if necessary or leave out any optional package not needed.)
- Open a new terminal console
- Create a new destination folder at a place of your choice e.g. at
~/git
:mkdir $HOME/git
- Change to this directory:
cd ~/git
- Fetch the project sourcefiles by running
git clone https://github.com/stlink-org/stlink.git
- Change into the project source directory:
cd stlink
- Run
make clean
-- required by some linux variants. - Run
make release
to create the Release target. - Run
make install
to full install the package with complete system integration. This might require sudo permissions. - Run
make debug
to create the Debug target (optional)
The debug target is only necessary in order to modify the sources and to run under a debugger. - Run
make package
to build a Debian Package. The generated packages can be found in the subdirectory./build/Release/dist
.
As an option you may also install to an individual user-defined folder e.g $HOME
with make install DESTDIR=$HOME
.
When installing system-wide (sudo make install
) the dynamic library cache needs to be updated with the command ldconfig
.
- Run
make uninstall
to perform a clean uninstall of the package from the system. - Run
make clean
to clean the build-folder within the project source and remove all compiled and linked files and libraries.
Install the following packages from your package repository:
mingw-w64
mingw-w64-common
mingw-w64-i686-dev
mingw-w64-x86-64-dev
After following the steps for installation above, proceed with from the build dircetory itself:
$ sudo sh ./cmake/packaging/windows/generate_binaries.sh
The generated zip-packages can be found in the subdirectory ./build/dist
.
By default most distributions don't allow access to USB devices.
In this context udev rules, which create devices nodes, are necessary to run the tools without root permissions.
To achieve this you need to ensure that the group plugdev
exists and the user who is trying to access these devices is a member of this group.
Within the sourcefolder of the project, these rules are located in the subdirectory config/udev/rules.d
and are automatically installed along with sudo make install
on linux.
Afterwards it may be necessary to reload the udev rules:
$ sudo cp -a config/udev/rules.d/* /lib/udev/rules.d/
$ sudo udevadm control --reload-rules
$ sudo udevadm trigger
udev will now create device node files, e.g. /dev/stlinkv3_XX
, /dev/stlinkv2_XX
, /dev/stlinkv1_XX
.
As the STLINKV1's SCSI emulation is somehow broken, the best advice possibly is to tell your operating system to completely ignore it.
Choose one of the following options before connecting the device to your computer:
modprobe -r usb-storage && modprobe usb-storage quirks=483:3744:i
- OR
echo "options usb-storage quirks=483:3744:i" >> /etc/modprobe.conf
modprobe -r usb-storage && modprobe usb-storage
- OR
cp stlink_v1.modprobe.conf /etc/modprobe.d
modprobe -r usb-storage && modprobe usb-storage
To put the compiled shared libs into a different directory during installation,
you can use the cmake option cmake -DLIB_INSTALL_DIR:PATH="/usr/lib64" ..
.
The cmake build system of this toolset includes GNUInstallDirs
to define GNU standard installation directories.
This module provides install directory variables as defined by the GNU Coding Standards.
Below are the preset default cmake options, which apply if none of these options are redefined:
-DCMAKE_INSTALL_SYSCONFDIR=/etc
-DCMAKE_INSTALL_PREFIX=/usr/local
Please refer to the related cmake documentation for details.
Author: nightwalker-87