Skip to content

x3utils CLI v1.8.0

Choose a tag to compare

@ztakis ztakis released this 21 Jul 17:00
· 76 commits to main since this release
This release brings the Windows, Linux, and macOS CLI tools back to the same version and gives all three platforms a consistent launcher workflow.

What’s new

  • Added a read-only Check Connection action for modes A/B/C/D.
  • Reordered the launcher actions to match the Flutter GUI workflow.
  • Added an Advanced submenu with:
    • Flash Only
    • Flash Slot 0
    • Check Protection
    • Unlock / Rescue
  • Protection actions honor the connection mode selected in the launcher, including Power-race.
  • Preserved standalone script usage, Windows drag-and-drop, and Bash file prompts.

macOS improvements

  • Completed Power-race support across dump, flash, SHU-compatible flash, Flash Only, and Slot 0.
  • Added architecture-aware Power-race target configurations for bundled xPack OpenOCD.
  • Added evidence-based Mode-D protection checking and rescue.
  • Improved handling of xPack OpenOCD’s slower and slightly different output.

Safety

  • Check Connection does not dump or write firmware.
  • Normal flashing still requires a successful backup first.
  • Flash Only remains under Advanced because it deliberately skips the backup.
  • Unlock / Rescue retains its explicit UNLOCK confirmation and can mass-erase main flash.
  • A blank chip left after rescue is rejected by Backup + Flash and can be restored with Advanced → Flash Only.

Validation

Connection checking passed on real hardware in modes A/B/C/D on Windows, Linux, and macOS.

Integrated launcher backup, SHU-compatible flashing, normal flashing, Flash Only, Slot 0, and protection workflows were exercised across the supported platforms. macOS Power-race rescue was also destructively validated, followed by successful blank-chip detection and firmware recovery.

The Flutter GUI remains separately versioned and is unchanged by this CLI release.