Create a rotating file logger for field diagnostics, or None. Autostart launches the tray under pythonw.exe, which has no console — stdout is

Build the headless launch command for the Run value. Uses the BASE interpreter's pythonw.exe — `sys.base_exec_prefix` points at the real Pyth

Lazily create and ready a shared CoreBluetooth central manager.

True if a connect error is a macOS bonding/encryption mismatch. macOS reports a stale bond as CBErrorDomain Code=15 ("Failed to encrypt the c

Add "c":1 to the payload when the config opts in, so the firmware may sound the session-reset chime. Omitted entirely when chime is off.

Add "c":1 to the payload when the config opts in, so the firmware may sound the session-reset chime. Omitted entirely when chime is off.

Add wall-clock fields to the payload when the config opts in. "t" = local wall-clock epoch (UTC epoch shifted by the tz offset) so the

Add "t" (local wall-clock epoch) + "tf" (12|24) when the config opts in.

Idle "Zzz" screen — shown when the host is connected but no usage update has landed recently (token expired, daemon down, host asleep…). Full-screen,

Pairing hint — shown when disconnected so the screen isn't empty and the user knows how to (re)pair. Wording matches the 3-second release gesture.

Pick layout values from the active board's pixel dimensions. The two existing boards happen to land on the two breakpoints below; new ports inherit th

Connect to a target and poll until disconnected or stopped. ``target`` is either an address string (Linux) or a BLEDevice carrying live CoreB

Best-effort 12h/24h detection for the host. Returns 12 or 24 (default 24).

Best-effort 12h/24h detection on Windows via the registry. Returns 12 or 24.

Return the BLE address of the bonded Clawdmeter, or None. A device that is paired AND connected to Windows stops advertising, so BleakScanner

Return a connectable target, or None. The daemon only ever targets the device this system already holds — it never scans for a nearby device

* look for the coefficient in coeff_div[] table */

Tray entry point: build icons, start daemon bg thread, run pystray. `import pystray` is intentionally INSIDE this function (not at module top)

Parse a JSON line into UsageData.

Poll every configured config dir and return the active plan's payload. Returns None when no dir yields a usable payload this cycle. A single

Hold-to-pair gesture signals. Mirror the 216 (PMU PKEY long/positive IRQs) or the 1.8" (software hold-timing off a polled GPIO) port. Stub = no gestur

Read the `chime` option from the config file. One of: off|on. Defaults to "off" (the device stays silent) so existing setups are unaffected u

Read the `chime` option from the config file. One of: off|on. Defaults to "off" so the device stays silent until the user opts in.

Read the `clock` option from the config file. One of: off|auto|12|24. Defaults to "off" (no clock; the device keeps showing "Usage") so existing

Read the `clock` option from the config file. One of: off|auto|12|24. Defaults to "off" so existing setups keep showing "Usage" until opted in.

Return a BLEDevice for a system-connected 'Clawdmeter', or None. Two-step lookup, strongest signal first: 1. Peripherals connected under our

Rotate a w×h strip into rot_buf and compute destination coordinates on the 480×480 panel. Src is row-major over the rectangle (sx, sy, w, h).