Skip to content

03. Linux quick start

ztakis edited this page Jul 2, 2026 · 1 revision

3. Linux Quick Start

Open a terminal in x3utils_linux.

chmod +x *.sh oocd/bin/openocd
./launcher.sh

Dependencies

Depending on your distro, you may need:

  • python3
  • usbutils
  • hidapi / libhidapi-hidraw0

You may also need OpenOCD udev rules. The repository includes:

x3utils_linux/oocd/contrib/60-openocd.rules

Copy it to:

/etc/udev/rules.d/

Then reload udev rules and reconnect the ST-LINK.

First Test

Use option 2 to run a full 128 KB dump before flashing.

If Linux cannot see the adapter, check USB permissions and udev rules first.

Clone this wiki locally