README in progress ...

x3utils

Downloads

• GUI v1.2.6 — desktop app for Windows, Linux and macOS. Recommended for most users.
• CLI v1.8.1 — the scripts, for terminal users.

ST-LINK utilities for X3 / 3rd-generation scooters.

Supported models: ZT3 Pro, Max G3, F3 / F3 Pro.

Warning

This tool talks directly to the scooter VCU. A bad connection, wrong file, or interrupted flash can leave the controller unusable until recovered. Always make a full dump first and keep the backup somewhere safe.

Caution

SHU compatibility firmware limits: Do not use Flash SHU Compatible with F3/G3 VCU 1.6.3 or newer, or ZT3 VCU 1.5.9 or newer. GT3 is not supported by Flash SHU Compatible at any version (its own limit, VCU 1.7.2, is listed for reference only). SHU compat saves the original backup first, but using it on newer firmware may require restoring that backup.

Quick Start

Watch the quick video first.

This short video shows the normal Windows + clone ST-LINK flow: launcher on one side, test board and C45 timing on the other.

Quick steps:

1. Download the latest x3utils release.
2. Open x3utils_win.
3. Run launcher.bat.
4. Select B - C45 / Clone ST-Link.
5. Run option 2 first to make a full 128 KB backup.
6. Do not flash anything until the dump works.

If option 2 works, your ST-LINK connection is probably good enough for the next steps.

What This Tool Does

The launcher has five main actions:

[1] Flash SHU compatible

Dumps your current VCU firmware, patches it, and flashes it back for SHU-compatible workflows such as flashing from repo or changing serial. Use at your own risk. More info >

[2] Run Full Memory Dump (128 KB)

Makes a full backup. Run this first. More info >

[3] Flash Loaded File to Chip

Flashes the .bin file selected with option 4.

[4] Load / Change Target .bin File

Selects the .bin file to flash. Normal firmware files must be exactly 128 KB.

[5] Exit

Closes the utility.

Connection Modes

A - Default / Blinker buttons

Use this when SWD is available, either normally or by holding the turn indicator buttons during power-up. More info >

B - C45 / Clone ST-Link

Most common mode. Use this with clone ST-LINK adapters. The launcher tells you when to touch C45 to GND. More info >

C - C45 / Genuine ST-Link

Use this with a genuine ST-LINK adapter and its reset pin connected to the MCU reset line at C45. More info >

More Documentation

• Windows guide
• Linux guide
• macOS guide
• Wiki home