Kick off a passive BLE discovery sweep. The call returns a scan handle immediately; the sweep runs for up to timeout_s seconds (bounded 1–60) and then shuts itself down. Retrieve findings with lw_ble_scan_poll or abort early with lw_ble_scan_stop.

Fetch everything a sweep has gathered so far, plus whether it is still running.

End a sweep now and hand back everything it recorded before stopping.

Open a GATT session with a peripheral, addressed by its MAC. Returns a connection_id on success. The operation is wrapped in an outer timeout so a stalled driver call cannot leave the client waiting forever.

Close and forget an existing GATT session given its connection_id.

Report the liveness of a session and the peripheral's identity details.

Enumerate every session the server currently holds.

Walk the remote GATT database and dump its services, characteristics, and associated descriptors in one call.

Fetch a characteristic's contents; the reply carries them as base64, hex, and a plain byte count.

Send bytes to a characteristic. Encode the payload as base64 (data_b64) or hex (data_hex); with_response selects write-with-response vs. fire-and-forget.

Show the MTU agreed for a session; the useful per-packet payload is MTU minus three bytes of ATT overhead.

Read a descriptor's bytes by its attribute handle; handles come from lw_ble_discover.

Store bytes into a descriptor addressed by handle; encode the payload as base64 or hex.

Begin receiving notification events from a characteristic; returns a subscription_id that later calls use to manage the stream.

Stop a notification stream and release its buffered data.

Drain whatever notifications are already queued, without waiting; an empty result means nothing has arrived yet. The dropped counter reports overflow that was shed while nobody was reading.

Wait up to timeout_s for the next notification and return it, or null if nothing arrives within the window.

Show every notification stream the server is currently holding.

Show every discovery sweep the server knows about, finished or not.

One-shot device recon: service table, every readable characteristic value, and the negotiated MTU in a single call. Characteristics that fail to read are reported in read_failures instead of aborting the whole dump.

Report engine resource usage: live links, scans, notification streams, and whether the I/O bridge thread is healthy. Useful for diagnosing resource exhaustion in long-running sessions.