homebridge-fujitsu-airstage

A Homebridge plugin to control devices that use the Fujitsu Airstage API.

Prerequisites

Before using this, you should have already installed the Airstage app on your iOS or Android device, signed up for an account, and configured your devices.

Configuration

The easiest way to configure this plugin is to use Homebridge UI.

Here is an example of what you'll see in your Homebridge config once you've installed and configured this plugin:

{
    "platforms": [
        {
            "name": "Airstage Platform",
            "platform": "fujitsu-airstage",
            "region": "us",
            "country": "United States",
            "language": "en",
            "email": "test@example.com",
            "password": "test1234",
            "rememberEmailAndPassword": false,
            "accessToken": null,
            "accessTokenExpiry": null,
            "refreshToken": null,
            "enableThermostat": true,
            "enableFan": true,
            "enableVerticalAirflowDirection": false,
            "enableDryModeSwitch": false,
            "enableEconomySwitch": false,
            "enableEnergySavingFanSwitch": false,
            "enableFanModeSwitch": false,
            "enableMinimumHeatModeSwitch": false,
            "enablePowerfulSwitch": false
        }
    ]
}

If the rememberEmailAndPassword option is disabled, the email and password values will only be set until authentication with the Airstage API has been completed successfully. At that point, they will be set to null. This is the default behavior, in order to prevent your Airstage credentials from being stored in plaintext in the Homebridge config.

If the rememberEmailAndPassword option is enabled, the email and password values will continue to be set after authentication with the Airstage API has been completed successfully. This is useful for when the access token can't be refreshed for whatever reason, and you need to re-authenticate with the Airstage API.

Once authentication with the Airstage API has been completed successfully, the accessToken, accessTokenExpiry, and refreshToken values will be set. These values will be used to authenticate with the Airstage API going forward.

Accessories

For each device in your Airstage account, this plugin offers several accessories that you can use in order to control them. You can enable these accessories for your devices in the plugin config.

Thermostat

This accessory allows you to control the temperature, operating mode (cool/heat/auto), and power state (on/off) of your device. This is enabled by default.

Fan

This accessory allows you to control the fan speed, fan mode (auto/manual), oscillation state (on/off), and power state (on/off) of your device. This is enabled by default.

Vertical Airflow Direction

This accessory allows you to control the position of the vertical slats of your device. Unfortunately, Apple Home does currently support the "Slats" service, so this is represented in the plugin using the "Fanv2" service instead.

The fan speed of this accessory represents the position of the vertical slats. If the accessory is off, the vertical slats will oscillate.

"Dry Mode" Switch

This accessory allows you to control the operating mode (dry) of your device.

"Economy" Switch

This accessory allows you to control the "Economy" setting (on/off) of your device.

"Energy Saving Fan" Switch

This accessory allows you to control the "Energy Saving Fan" setting (on/off) of your device.

"Fan Mode" Switch

This accessory allows you to control the operating mode (fan) of your device.

"Minimum Heat Mode" Switch

This accessory allows you to control the operating mode (minimum heat) of your device.

"Powerful" Switch

This accessory allows you to control the "Powerful" setting (on/off) of your device.