homebridge-electra-smart

Homebridge plugin for Electra A/C that works with Electra Smart app.

Requirements

check with: node -v & homebridge -V and update if needed

Installation

This plugin is Homebridge verified and HOOBS certified and can be easily installed and configured through their UI.

To use this plugin you must provide token and imei which can be obtain in 2 different ways:

1. Using the latest Homebridge config UI version (v4.32.0), you can obtain token and imei easily through the plugin settings and fill all the needed configuration.

2. After installing the plugin, open the terminal and run the command: electra-extract. follow the instructions to get the token & imei.

* All methods require to have your phone (the one that was signed in to Electra Smart)

1. Install homebridge using: sudo npm install -g homebridge --unsafe-perm
2. Install this plugin using: sudo npm install -g homebridge-electra-smart
3. Run the command electra-extract in terminal and follow instructions to extract token and imei.
4. Update your configuration file. See config-sample.json in this repository for a sample.

* install from git: sudo npm install -g git+https://github.com/nitaybz/homebridge-electra-smart.git

Config file

Easy config (required):

"platforms": [
    {
        "platform": "ElectraSmart",
        "imei": "2b950000*************",
        "token": "**************************"
    }
]

Advanced config (optional):

"platforms": [
    {
        "platform": "ElectraSmart",
        "imei": "2b950000*************",
        "token": "**************************",
        "disableFan": false,
        "disableDry": false,
        "minTemperature": 16,
        "maxTemperature": 30,
        "swingDirection": "both",
        "statePollingInterval": 90,
        "debug": false
    }
]

Configurations Table

| Parameter | Description | Required | Default | type | | -------------------------------- | ------------------------------------------------------- |:--------:|:--------:|:--------:| | platform | always "ElectraSmart" | ✓ | - | String | | imei | Generated IMEI: obtain from terminal command - electra-extract | ✓ | - | String | | token | Access Token: obtain from terminal command - electra-extract | ✓ | - | String | | disableFan       | When set to true, it will disable the FAN accessory |       | false | Boolean | | disableDry       | When set to true, it will disable the DRY accessory  |         | false | Boolean | | statePollingInterval   | Time in seconds between each status polling of the Electra devices (set to 0 for no polling)    | 90 | Integer | | swingDirection       | Choose what kind of swing you would like to control in HomeKit. can be "vertical", "horizontal" or "both"  |         | "both" | Boolean | | minTemperature       | Minimum Temperature to show in HomeKit Control   |         | 16 | Integer | | maxTemperature       | Maximum Temperature to show in HomeKit Control  |         | 30 | Integer | | debug       | When set to true, the plugin will produce extra logs for debugging purposes |       | false | Boolean |

Fan speeds & "AUTO" speed

Since HomeKit control over fan speed is with a slider between 0-100, the plugin converts the steps you have in the Electra app to values between 1 to 100, when 100 is highest and 1 is lowest. Setting the fan speed to 0, should actually set it to "AUTO" speed.

Available fan speeds: AUTO, LOW, MED, HIGH

Swing

Swing support is added automatically if supported. Since HomeKit only have one control for swing, you can choose which swing type you would like HomeKit to control: vertical, horizontal or both (default).

Issues & Debug

I can't control the device, it always goes to previous state

Check the internet connection and that you can control the device from Electra Smart app. If that doesn't help, turn on debug logs in the plugin settings and look for errors.

Log error shows "intruder lockout"

Electra detected that the plugin is spamming the api and consider it as intruder. To fix this issue immediately you can refresh the token and imei by deleting them in the config UI and clicking on the button to fetch them back. You can potentially prevent this error by setting polling interval to a very high number or 0.

others

If you experience any issues with the plugins please refer to the Issues tab or electra-smart Discord channel and check if your issue is already described there, if it doesn't, please create a new issue with as much detailed information as you can give (logs are crucial).

if you want to even speed up the process, you can add "debug": true to your config, which will give me more details on the logs and speed up fixing the issue.

Support homebridge-electra-smart

homebridge-electra-smart is a free plugin under the GNU license. it was developed as a contribution to the homebridge/hoobs community with lots of love and thoughts. Creating and maintaining Homebridge plugins consume a lot of time and effort and if you would like to share your appreciation, feel free to "Star" or donate.