homebridge-tfiac v1.0.30

Homebridge Tfiac

Homebridge Tfiac is a Homebridge plugin that enables you to control air conditioners using the TFIAC protocol – the same protocol used by the popular iOS application CloudAircon for both local network and cloud-based control. CloudAircon supports a wide range of models—reportedly over 15 different air conditioner models from leading manufacturers—and appears to be implemented on modules that utilize Broadcom chipsets. By reverse-engineering this protocol, Homebridge Tfiac brings full HomeKit integration to your air conditioners, allowing you to manage power, temperature, operating mode, fan speed, and swing settings seamlessly through Siri, Home apps, or automations.

Features

• Power Control: Turn your AC unit on or off.
• Temperature Setting: Adjust the target temperature.
• Mode Selection: Switch between cooling, heating, or auto modes.
• Fan Speed: Set the fan speed (Low, Medium, High, or Auto).
• Swing Control: Control the horizontal/vertical swing settings.
• Real-Time Status Updates: Polling mechanism to update the current state of your AC.
• Dynamic Platform: Easily manage multiple AC units from a single configuration.

Requirements

• Node.js: v16 or later.
• Homebridge: v1.8.0 or later (v2.0.0-beta.0 supported).
• Air Conditioners: Devices that support the TFIAC protocol via UDP.

Installation

• Install Homebridge if you haven’t already. Follow the Homebridge Installation Guide.
• Install Homebridge Tfiac as a global npm package or via Homebridge Config UI X:

npm install -g homebridge-tfiac

Or add it as a custom repository in Homebridge Config UI X.

Configuration

The plugin is registered as a dynamic platform. Add a new platform entry in your Homebridge config.json similar to the example below:

{
  "platforms": [
    {
      "platform": "TfiacPlatform",
      "name": "TfiacPlatform",
      "devices": [
        {
          "name": "Living Room AC",
          "ip": "192.168.1.100",
          "mac": "B4:43:0D:BA:A6:CC",
          "updateInterval": 30
        },
        {
          "name": "Bedroom AC",
          "ip": "192.168.1.101",
          "mac": "B4:43:0D:BA:A4:07",
          "updateInterval": 60
        }
      ]
    }
  ]
}

Config Schema

If you are using Homebridge Config UI X, the plugin provides a JSON schema (config.schema.json) that allows you to edit the configuration via the UI. Ensure that the pluginAlias in the schema is set to "TfiacPlatform" and the pluginType is "platform".

Usage

After configuring, restart Homebridge. The plugin will:

• Create accessories for each configured AC unit.
• Poll each device at the specified interval to update its status.
• Allow you to control power, temperature, mode, fan speed, and swing through HomeKit-enabled apps.

You can control your ACs using Siri, HomeKit apps, or through automations set up in Homebridge Config UI X.