04. macOS quick start

4. macOS Quick Start

Open a terminal in x3utils_mac.

chmod +x installer.sh
./installer.sh
./launcher.sh

The installer:

• detects Apple Silicon or Intel;
• checks the bundled xPack OpenOCD binary;
• checks for Homebrew;
• installs required dependencies with Homebrew;
• sets executable permissions;
• tests OpenOCD startup.

Requirements

Homebrew is required by the installer:

https://brew.sh

The bundled OpenOCD folders are:

• xpack-openocd-0.12.0-7-darwin-arm64
• xpack-openocd-0.12.0-7-darwin-x64

First Test

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

If macOS blocks a binary, check the terminal output and allow the binary from macOS security settings if needed.