A high-precision, 100% local Home Assistant integration for SensorPush sensors. This integration bypasses the Cloud API and uses Bluetooth Proxies to perform active battery audits, providing millivolt-accurate data even for sensors inside appliances like fridges or freezers.
- Active Battery Audits: Performs a GATT connection nightly at 3:00am local time to retrieve real-time millivolt data. The initial audit runs in the background on startup so HA is never blocked.
- Smart Calibration: Automatically detects hardware generations (HT1 vs HT.w/HTP.xw) to apply correct voltage offsets.
- Infrastructure Hardened: Uses a global concurrency lock to prevent Bluetooth proxy contention.
- Resilient: If a device is temporarily unreachable, its last-known value is preserved until the next successful audit rather than disappearing from the UI.
- Native Integration: Sensors attach directly to your existing SensorPush devices in the Home Assistant UI.
- Diagnostic Data: Includes RSSI-at-read, Proxy Source, and Raw Value as entity attributes.
- Click the button above, or open HACS and add this repository manually as a custom repository under the Integration category.
- Click Install.
- Restart Home Assistant.
- Download the
sensorpush_localfolder. - Copy it into your
/config/custom_components/directory. - Restart Home Assistant.
- Go to Settings > Devices & Services.
- Click Add Integration and search for SensorPush Local.
- Click Submit — no further input is required.
This integration provides a service to trigger an audit of all sensors manually (useful for testing or after a battery swap).
- Service:
sensorpush_local.run_audit
Every battery entity includes the following attributes for troubleshooting:
rssi_at_read: Signal strength at the moment of the audit.proxy_source: Friendly name of the Bluetooth adapter or proxy used for the connection, resolved via HA's scanner registry (e.g. "Living Room Hub"). Falls back to the raw source identifier (e.g.hci0) if the scanner cannot be found.last_audit: ISO timestamp of the last successful connection.raw_value: The raw millivolt count from the sensor firmware.temp_at_read: Raw temperature value returned alongside the battery read. Units are device-dependent and not calibrated °C.model_type: Identified hardware generation.