# run_guard

Who vouches for the board a run flashes and the instrument it powers or measures with: the guard protocols a capture consults, the operator guard the command line uses, and the rail and supply requests a power run selects.

Every name on this page is imported from `helia_profiler`.

**API tier:** `experimental`

Generated from the `src/helia_profiler` tree `f38e378c801d34438affb680257217e0b58d2cd1`.

[Machine-readable model](https://ambiqai.github.io/helia-profiler/reference/api/helia_profiler/run_guard.json)

`dataclass`

Capture authority from an operator who names the board and the J-Link probe on it.

HPX cannot prove which physical board a probe is wired to: the core's
CPUID and the probe list name a SoC and a serial, not a board. With this
guard the operator vouches for the board and holds it for the whole
capture, as ``hpx profile`` assumes. :meth:`verify_target` refuses a
capture whose board or probe serial differs from the ones the operator
named, and :meth:`check` allows every step. A harness that can prove the
board and lock it passes its own
:class:`~helia_profiler.FixtureCaptureGuard` instead.

**API tier:** `experimental`

Allow the step: the operator holds the board for the whole capture.

Refuse a target board or probe serial other than the operator's.

`dataclass`

The board a fixture image runs on, its J-Link device and the image's load address.

**API tier:** `experimental`

Caller-owned authorization and remaining-window checks.

**API tier:** `experimental`

Require caller-verified physical board/serial identity and exclusive ownership.

Core CPUID and probe enumeration cannot establish the physical board.
Reject if the caller has no current independent board/serial evidence.

`dataclass`

Explicit station-owned supply path; enabling it does not request energy measurement.

**API tier:** `experimental`

`dataclass`

Station-selected instrument/rail and channels, separate from firmware wiring.

**API tier:** `experimental`

Station authority for the board and measured instrument/rail.

**API tier:** `experimental`

---

Machine-readable: [`run_guard.json`](https://ambiqai.github.io/helia-profiler/reference/api/helia_profiler/run_guard.json) · [`run_guard.md`](https://ambiqai.github.io/helia-profiler/reference/api/helia_profiler/run_guard.md), complete and lossless.