homebridge-actronair v3.0.12

homebridge-actronair

An unoffical Homebridge community plugin for ActronAir Airconditioners

Disclaimers

This community plugin is not officially endorsed by Homebridge or ActronAir. Despite best efforts, there is no gaurentee the plugin will behave as expected. Use at your own risk. Setup requries basic knowledge of HTTP protocol and browser inspectors.

Acknowledgements

This plugin was inspired by iainelliott's work in progress, homebridge-actron.

Features

• Support for multiple accessories
• Turn accessory on and off
• Set accessory mode to 'AUTO', 'HEAT' or 'COOL'
• View current temperature
• Set target temperature
• Install through Homebridge app

Installation

IMPORTANT: This a plugin for Homebridge. For help getting started with Homebridge, consult their setup guides.

From your server's web interface, simply navigate to 'Plugins', search for homebridge-actronair and click 'INSTALL'.

To install using NPM, run the following in your server's root directory:

npm i homebridge-actronair

Configuration

To configure the plugin using the server's web interface, navigate to 'Plugins' and click 'SETTINGS'. Add an accessory and complete the required details.

The Zone object is defined as:

{
    name: string
    index: number
}

You can also edit your config file directly, though it is not recommended.

How to find device_token and user_token

Login to http://www.actronair.com.au/aconnect/#/Auth. Using the browser inspector (hit F12 key for Google Chrome), start capturing network events. Toggle your aircon state (ON or OFF) and inspect the PUT request sent. Extract the device_token and user_token from the destination URL. Example destination URL:

https://que.actronair.com.au/rest/v0/device/device_token?user_access_token=user_token

Use the extracted device_token and user_token in the plugin config.

Planned Features and ToDo

X Allow toggling of zones

[] Simplify config file

[] Auto fetch user_token and device_token from supplied username and password

X Siri compatibility

[] Convert GETs to async update characteristics

Issues

Report issues on GitHub.