AC Infinity BLE

AC Infinity BLE Controller

Installation

Install this via pip (or your favourite package manager):

pip install ac-infinity-ble

Protocol and compatibility

The library requires Python 3.12+, Bleak 3.0.2+ (3.x), and bleak-retry-connector 4.7.0+ (4.x). See the APK-derived protocol documentation for frame layouts, device families, control coverage, and hardware validation. The architecture describes family routing, multiport state, Bluetooth revision reads, and Home Assistant identity/migration.

Commands validate length, both CRCs, command and sequence while unsolicited telemetry continues updating state. Connections are released after five idle seconds; always await controller.stop() when finished.

Build with poetry build, or install a checkout with pip install -e . for development.

Read the documentation directly in this repository. See installation and upgrade notes and the usage guide for the bounded scanner example, immutable state, per-port controls and cleanup. Home Assistant targets 30-second port telemetry freshness and five-minute saved-settings refreshes, with background failure backoff and no delay imposed on user commands. Ruff handles Python lint/format; Prettier retains non-Python formatting. See contributing for rule choices, CI checks and the release dry run.

Contributors ✨

Thanks goes to these wonderful people (emoji key):

This project follows the all-contributors specification. Contributions of any kind welcome!

Credits

This package was created with Copier and the browniebroke/pypackage-template project template.