Update RSSI sliding window for a device and return the average.

Start the Flask server in a background thread.

Start the Flask server in a background thread.

Construct a valid RPA string from an IRK and a 3-byte prand.

Parse an IRK from hex string (plain, colon-separated, or 0x-prefixed). Returns 16 bytes or raises ValueError.

Parse an IRK from hex string (plain, colon-separated, or 0x-prefixed). Returns 16 bytes or raises ValueError.

Signal the SocketIO server to shut down.

Signal the SocketIO server to shut down.

Mask an IRK hex string, showing only the first and last 4 characters.

Mask an IRK hex string, showing only the first and last 4 characters.

One tick of the scan loop: redraw TUI, emit GUI status/GPS.

One tick of the scan loop: redraw TUI, emit GUI status/GPS.

Push scan status to all connected clients.

Push scan status to all connected clients.

Update RSSI sliding window for a device and return the average.

Bluetooth Core Spec ah() function (Vol 3, Part H, Section 2.2.2). AES-128-ECB(IRK, padding || prand) -> return last 3 bytes. Note: ECB mode

Bluetooth Core Spec ah() function (Vol 3, Part H, Section 2.2.2). AES-128-ECB(IRK, padding || prand) -> return last 3 bytes. Note: ECB mode

Build a record dict from device/adv data.

Build a record dict from device/adv data.

Estimate distance in meters using the log-distance path loss model. When *ref_rssi* is provided it is used directly as the expected RSSI at t

Estimate distance in meters using the log-distance path loss model. When *ref_rssi* is provided it is used directly as the expected RSSI at t

Remove oldest devices when cache exceeds cap.

Remove oldest devices when cache exceeds cap.

Handle a detection in IRK resolution mode.

Handle a detection in IRK resolution mode.

Check if a 6-byte address is a Resolvable Private Address. RPA has top two bits of the most-significant byte set to 01.

Check if a 6-byte address is a Resolvable Private Address. RPA has top two bits of the most-significant byte set to 01.

Print scan configuration banner.

Print scan configuration banner.

Print scan summary statistics.

Print scan summary statistics.

Build a record, optionally append to self.records, write to live log, and update TUI state. Returns the record dict.

Build a record, optionally append to self.records, write to live log, and update TUI state. Returns the record dict.

Redraw the TUI live table.

Redraw the TUI live table.

Resolve a MAC address string against an IRK. MAC format: AA:BB:CC:DD:EE:FF prand = first 3 octets (AA:BB:CC), hash = last 3 octets (DD:EE:FF)

Resolve a MAC address string against an IRK. MAC format: AA:BB:CC:DD:EE:FF prand = first 3 octets (AA:BB:CC), hash = last 3 octets (DD:EE:FF)

Run the BLE scanner and return elapsed seconds.

Run the BLE scanner and return elapsed seconds.

Return an ISO 8601 timestamp with timezone offset.

Return an ISO 8601 timestamp with timezone offset.

Write batch output file (json / jsonl / csv).

Write batch output file (json / jsonl / csv).

Push scan complete event and store for reconnecting clients.

Push scan complete event and store for reconnecting clients.

Push a device update to all connected clients.

Push a device update to all connected clients.

Push scanner GPS position to all connected clients.

Push scanner GPS position to all connected clients.