ac2mqtt

KO | EN

gitlite — search

#python #react #typescript #go #android #machine-learning #linux #macos #nodejs #awesome #pytorch #security #openai #mcp

(★ 10)

MQTT bridge for AC Infinity BLE controllers

ac2mqtt Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ac2mqtt

Inspired by zigbee2mqtt, ruuvi-go-gateway and ruuvi-bridge, ac2mqtt is intended to expose AC Infinity Controllers as HomeAssistant-friendly MQTT entities.

### Features

- Supports most BLE controller models as of August 2023
- Publishes sensor entities for temperature, humidity, and vapour-pressure deficit
- Publishes fan entities that support on/off switch and speed adjustment
- Supports multi-port controllers

### Runtime Requirements

- Linux-based OS
- Bluetooth adapter supporting Bluetooth Low Energy
- 10MB of disk space
- ~20MB of RAM

### Build Requirements

- [Go](https://golang.org) 1.18+

### Configuration

Check [config.sample.yml](./config.sample.yml) for a sample config. By default the gateway assumes to find a file called `config.yml` in the current working directory, but that can be overridden with `-config /path/to/config.yml` command line flag.

The systemd service file looks for a configuration file in `/etc/ac2mqtt/config.yml`

### Installation

```
make
sudo make install
```

Note that running the standalone binaries without root requires some extra capabilities be set to the binary to grant it permissions to scan for ble, this can be done with:

```sh
sudo setcap 'cap_net_raw,cap_net_admin+eip' ./ac2mqtt
```

### Troubleshooting

**send ATT request failed: io: read/write on closed pipe, mac: xx:xx:xx:xx:xx:xx**
    
Your controller is discoverable, but currently connected to by another device, most likely your phone app. Close the app, and try again.

ac2mqtt

ac2mqtt Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

ac2mqtt

ac2mqtt Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README