Homebridge plugin for AC Infinity UIS controllers.
- Fan speed control (0-100%)
- Temperature and humidity monitoring
- VPD sensor support
- External probe support (temperature, humidity, CO2, soil, water)
- Auto/Manual mode detection
- Automatic device discovery
- Per-port device control
npm install -g homebridge-acinfinityAdd to your Homebridge config.json:
{
"platforms": [
{
"platform": "ACInfinity",
"name": "AC Infinity",
"email": "your-email@example.com",
"password": "your-password",
"pollingInterval": 10
}
]
}| Option | Type | Required | Default | Description |
|---|---|---|---|---|
platform |
string | Yes | - | Must be "ACInfinity" |
name |
string | Yes | - | Display name for the platform |
email |
string | Yes | - | AC Infinity account email |
password |
string | Yes | - | AC Infinity account password |
pollingInterval |
integer | No | 10 | Update interval in seconds (5-600) |
exposeSensors |
boolean | No | false | Expose temperature/humidity sensors |
exposePortDevices |
boolean | No | true | Expose port devices as fans |
host |
string | No | http://www.acinfinityserver.com | API host URL |
debug |
boolean | No | false | Enable debug logging |
| Device | Model | Type | Status |
|---|---|---|---|
| UIS Controller 89 AI+ | CTR89Q | 20 | ✅ Supported |
| UIS Controller 69 Pro+ | CTR69Q | 18 | ✅ Supported |
| UIS Controller 69 Pro | CTR69P | 11 | ✅ Supported |
| Sensor Type | Model | Features |
|---|---|---|
| Temperature Probe | AC-SPC24 | Temperature, Humidity, VPD |
| CO2 + Light Sensor | AC-COS3 | CO2, Light Level |
| Water Sensor | AC-WDS3 | Water Temperature, pH, EC/TDS |
| Soil Sensor | AC-SLS3 | Soil Moisture |
| Device | Status | Notes |
|---|---|---|
| Airtap T4/T6 Register Fans | ❌ Not Supported | Standalone devices without controller architecture. See "Help Wanted" below. |
| Controller 67 (Bluetooth) | ❌ Not Supported | Bluetooth-only, no cloud API access |
| Controller 69 (Base) | ❌ Not Supported | Bluetooth-only, no cloud API access |
Each controller exposes:
- Temperature Sensor (optional, via
exposeSensors) - Humidity Sensor (optional, via
exposeSensors)
Each connected port device exposes:
- Fan Service
- Active (On/Off)
- Rotation Speed (0-100%)
- Current Fan State (Idle/Blowing Air)
- Target Fan State (Manual/Auto)
External sensors expose appropriate HomeKit services:
- Temperature sensors
- Humidity sensors
- CO2 sensors
- Custom characteristics for water sensors
No Devices Found
- Verify devices are online in the AC Infinity mobile app
- Check credentials are correct
- Ensure devices are registered to your account
Authentication Failed
- Verify email and password
- Password is limited to first 25 characters
Speed Changes Not Persisting
- Update to v1.3.2 or later
- This was a known issue with Controller 69 Pro, now fixed
Slow Updates
- Adjust
pollingInterval(minimum 5 seconds) - Lower values increase responsiveness but may cause rate limiting
Enable debug logging to troubleshoot:
{
"platform": "ACInfinity",
"debug": true
}Debug logs show:
- Device discovery and detection
- API calls and responses
- Controller type detection
- Error details and stack traces
We need help adding support for Airtap T4/T6 register booster fans. These standalone devices use a different API structure than controller-based devices.
How you can help:
- Create a GitHub issue titled "Airtap Support - Device Data"
- Enable debug mode (
"debug": true) - Share the device data from logs (look for
=== DETAILED DEVICE DEBUG INFO ===) - Or contact maintainers to arrange temporary test account access
Alternative: The ESP32 module replacement provides ESPHome/Home Assistant integration.
See API_REFERENCE.md for:
- AC Infinity API endpoints and payload formats
- Controller-specific implementation details
- Network analysis methodology
- Common API issues and solutions
- Uses the same API as the official AC Infinity mobile app
- All communication over HTTP (not HTTPS)
- Temperature values reported in Celsius
- Fan speed mapped from 0-10 (AC Infinity) to 0-100% (HomeKit)
Based on homeassistant-acinfinity by @dalinicus.
MIT