acinf 0.0.2

AC Infinity Controller 69 Pro command-line and API

About

This software provides basic CLI and API functionality for controlling a single fan and reading sensor values from the AC Infinity Controller 69 Pro.

Install

pip install acinf

This script was authored for python 3.10 and Linux, but other python versions and operating systems may work.

Usage

If everything is installed correctly, command acinf should have the following output:

$ acinf
usage: acinf [-h] [--log-level {debug,info,warning,error}] mac_address {get,set} [value]
acinf: error: the following arguments are required: mac_address, action

To set fan level to 5 use command for example MAC address DE:AD:BE:EF:CA:FE:

acinf DE:AD:BE:EF:CA:FE set 5

To show all values to stdout in json format:

$ acinf DE:AD:BE:EF:CA:FE get
{
    "temperature_c": 18.56,
    "temperature_f": 65.408,
    "humidity": 70.03,
    "vpd_kpa": 0.61
}

To retrieve just a single value as ASCII float to stdout, combine get with any of the following values temperature_c, temperature_f, humidity, vpd_kpa:

$ acinf DE:AD:BE:EF:CA:FE get temperature_f
65.408

MAC address

To determine the MAC address of your AC Infinity controller on Linux, ensure the bluetooth package is installed and execute bluetoothctl, then, command scan on, examine devices marked ‘NEW’, or, enter command devices.

AC infinity controllers are marked ‘ACI-E’, as in the example below:

linux# bluetoothctl
Agent registered
[CHG] Controller 00:11:22:33:44:66 Pairable: yes
[bluetooth]# scan on
Discovery started
[CHG] Controller 00:11:22:33:44:66 Discovering: yes
[NEW] Device AB:CD:EF:AB:CD:EF AB-CD-EF-AB-CD-EF
[NEW] Device DE:AD:BE:EF:CA:FE ACI-E
[NEW] Device AB:CD:EF:AB:CD:FF AB-CD-EF-AB-CD-FF

Pairing

If you haven’t previously paired with your device, do that now. Press and Hold the bluetooth button on the controller until it begins flashing, then, enter bluetoothctl command, pair DE:AD:BE:EF:CA:FE.

About

This software is not affiliated with AC Infinity. AC Infinity is a trademark of AC Infinity Inc. This software is not guaranteed to work with any particular AC Infinity product. It is not guaranteed to work at all. Use at your own risk.

Caveats

• Although 4 fans may be connected to the controller, this software only supports controlling a single fan.

• Do not execute more than 1 of these processes at a time. All ‘get’ and ‘set’ commands are failed if they exceed 1 minute, and so any scheduled execution of this command should be limited to approximately once per 2 minutes.

• This API and software has a very slow startup time, because it reconnects to the bluetooth device each time. Although it is possible to re-use a connection, I found persistent connections to be unreliable over long durations.

• Errors may often report to stderr, about timeout or failure to discover or connect, especially for long receiver distances, but all get or set operations are automatically retried for a full minute before failure.

Contributing

This project is not very serious, if you wish to expand it for more features and devices, consider making a pull requests and becoming a co-maintainer and feel free to fork. Thanks, enjoy, and best wishes!