Override the per-request quiet window.

behavior-id -> name, from the model's behavior table (ActivityTypes.json).

Best-effort minimal ConfigParams. If the server returns no ota_files, capture the real body/response from mitmproxy instead.

Trigger the ring's sleep analysis. Returns the `0x29` status byte.

Set a feature's operating mode (SetFeatureMode). The consumer-feature enable path — e.g. `feature-mode real_steps` turns on the on-ring step/gait DSP

Read the actual on-ring mode/status of the data-producing features.

Label activity sessions by running Oura's own `automatic_activity_detection` TorchScript model over the stored events. Built with `--features torch` i

Subscribe a feature capability via SetFeatureSubscription (needs auth).

The persisted incremental-sync cursor (deciseconds), or 0 if none.

`atlas_metadata` (tag `0x87`): control message that opens an Atlas (bioZ) stream. Only the subtype-0 "start" form (10 bytes) is decoded.

Decode an event body for a given tag. Public entry point for re-decoding events already stored raw (e.g. after adding new decoders).

A single leading byte under a named key.

`ibi_and_amplitude_event` (tag `0x60`): a fixed 14-byte packet holding 6 inter-beat intervals (ms) and PPG amplitudes, bit-packed per the native `pars

`real_steps_features_1/2` (tags `0x7e`/`0x7f`): a 14-byte bit-packed feature record (the firmware packs 9-bit counts as `byte*2 + carry_bit`). The par

`sleep_summary_1` (tag `0x49`): two minute-offsets from the event's ring time to the sleep window start/end. The absolute timestamps need the event he

`sleep_summary_2` (tag `0x4c`): 14-byte record (u64, u16, u32). Field names/units unresolved in the decompile.

`sleep_summary_3` (tag `0x4f`): 11-byte record; three fields are `>>3` (÷8 fixed-point) in the parser.

`sleep_summary_4` (tag `0x58`): 7-byte record (u32, u16, u8).

`spo2_event`: a header byte then one SpO2 % per sample (1 Hz). A trailing `0xff` is a "continued" sentinel, not a sample.

All decoded events as `(ring_timestamp_deciseconds, tag, decoded_json, captured_unix)`, ordered by ring time. For analysis/reporting commands that rec

Abs-deviation in real units.

Distinct device serials that have stored events.

Drain history events starting from `cursor` (deciseconds), invoking `on_event` for each. Loops until the ring reports no bytes left. Returns the count

Read a feature's latest cached values (HR / SpO2). Reflects the last automatic measurement; meaningful only when the ring is worn.

Generate a random 16-byte auth key from the OS CSPRNG.

Read the hardware id (e.g. `BLB_03`).

Insert an event, ignoring exact duplicates. Returns true if a row was added.

Enable live heart rate (daytime HR, `CONNECTED_LIVE`) and invoke `on_sample` for each valid beat for up to `duration`. Restores `AUTOMATIC` mode on ex

Vector magnitude, useful for motion/wave detection.

Wrap a transport with the default response window.

Parse a capabilities page response (`0x2f` ext `0x02`).

RData capacity rate-probe (Phase-2 spike): arm ACM-50, record briefly, then stop and drain pages to measure the real byte rate and page size. **ALWAYS

Test 1: run the app's strict start recipe — Clear (require SUCCESS) -> state -> CONFIGURE with startTime=0 — and report each status. Tears down afterw

Try several RData `configure` argument variants and report which (if any) moves the ring out of the idle state (status 3). Each attempt is immediately

Combined in-session unlock attempt: confirm RAW_DATA_SAMPLER is advertised, try enabling it (subscription + feature-mode) on the correct id 0x12, then

Re-decode every stored event body with the current decoders, updating `decoded_json`. Returns `(rows_with_decode, total_rows)`. Lets new decoders be a

Request the app-auth nonce (`0x2f` ext `0x2b`).

Authenticate with the AES-encrypted nonce (`0x2f` ext `0x2d`).

Get battery level (`0x0c`).

Get a capabilities page (`0x2f` ext `0x01`).

Ask the ring to run sleep analysis (`28 01 <force>`). After it postprocesses, `sleep_phase`/`sleep_summary` events appear in history. Response tag `0x

Get a feature's latest values (`0x2f` ext `0x24`).

Get a feature's status (`0x2f` ext `0x20`).

Get firmware / API / bootloader / BT-stack / MAC (`0x08`).

Get up to `max_events` history events from `start` (deciseconds) (`0x10`). `flags` is passed through verbatim; the app uses `-1` to request all types

Clear RData session/data from flash (`030104`).

Configure/start an RData session for one or more signal types. Layout matches the app's `RDataStart`: `03 <len> 02 <startTime u32 LE> <currentTime u32

Request an RData page by index (`0303 01 <page u16 LE>`).

Query RData collection state (`030105`) — read-only, safe.

Stop an RData collection session (`030103`).

Install a 16-byte auth key on a factory-reset ring (`0x24`).

`SetFeatureSubscription` — subscribe/unsubscribe a feature capability (e.g. real steps, Atlas/bioZ). Extended op `0x2f`, sub-op `0x26`; response sub-o

Enable/disable the async notification flags (`0x1c`).

Set the ring clock to a UTC unix timestamp (`0x12`).

Heart-rate variability. Ported from ecore `hrv @ 0x1e7984`: RMSSD of the inter-beat-interval series — the textbook `sqrt(mean(diff(ibi)^2))`. The ring

Persist a key as hex with owner-only permissions.

Scan for Oura rings advertising the service, filtered by case-insensitive name substring. Returns candidates sorted by signal strength (strongest firs

Install a new 16-byte auth key. Only valid on a factory-reset ring.

Sleep debt from per-day actual and needed sleep (seconds), index 0 = most recent. Days with actual/need of 0 or `i32::MAX` are treated as invalid.

Stream live accelerometer samples (the "wave to test motion" path): enable the ACM real-time measurement for `duration` and invoke `on_sample` for eac

Summarize an epoch stage-code series (+ optional time-in-bed seconds) into stage durations, sleep-onset latency, wake count and efficiency.

Write `request` and collect notification frames until the link is quiet for `quiet` (i.e. no new frame arrives within that window). This matches the r

Record/refresh device metadata.

Metabolic helpers ported from ecore's activity/calorie path. These match the standard published formulas the decompile uses (constants confirmed again