# power

What a power capture produces: the measured result, the observations behind it, and the on-device summary the firmware reports.

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

**API tier:** `stable`, `experimental`

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

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

Power measurement mode.

**API tier:** `stable`

`dataclass`

Complete result of a power capture.

``metadata`` is the typed :class:`~helia_profiler.power.metadata.PowerMetadata`
(#154); the flat dict view is ``metadata.to_metadata_dict()``.
The result is frozen but its metadata is deliberately mutable: pipeline
stages enrich it after capture, like ``RunMetadata``.

**API tier:** `stable`

`dataclass`

Host instrument observation, independent of firmware terminal status.

**API tier:** `experimental`

`dataclass`

Versioned firmware status emitted only after the power gate is low.

**API tier:** `experimental`

`dataclass`

Integer-unit aggregate reported by a firmware-side power monitor.

**API tier:** `experimental`

---

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