Repository navigation
Supported HTTP API and Owner-Managed People
Presence Bridge is now in the default HACS catalog: search its name and install
the latest full release, without a custom repository or beta opt-in.
Presence Pair remains free during testing on the App Store, iOS 17+, version
1.0.0 (build 220). No new iPhone binary is needed.
Changes
- Read the public certificate path from
hass.http.ssl_certificate, never
.storage/httpor private TLS keys. Missing/invalid certificate paths do not
disable normal iOS TLS validation. - Stop changing HA's internal Person collection. Assign a new BLE tracker in
Settings > People, adding it alongside existing GPS/Wi-Fi trackers.
Existing assignments are preserved; YAML-managed people are managed in YAML. - Report current assignment status from public states and the actual tracker ID
from the entity registry. Flag other-owner conflicts, ignore cached success
flags and keep tracker IDs out of anonymized diagnostics. - Update English/Italian onboarding, compatibility and final physical tests.
Upgrade
Back up HA and receiver configuration, update the integration through HACS and
restart HA outside an active pairing. Refresh the panel afterwards. Do not
delete working phone bonds or reset the adapter. Public 0.2.3 receivers use the
same BLE protocol and do not require reinstalling for these improvements; new
0.2.4 receiver packages align version metadata only. Verify SHA256SUMS.txt.
The HA ZIP is flat: extract directly into custom_components/presence_bridge.
Validation Boundary
Software tests cover certificate pins, real HA public state and permission
boundaries, preservation of Person data, diagnostics redaction and frontend
guidance. Windows/Linux CI, HACS and hassfest must pass on the release commit.
The final iPhone test
remains a physical acceptance step; unit tests are not a hardware certification.
Linux and untested hardware remain experimental. Integration/receivers are MIT;
the iPhone source remains proprietary.