Make Ambi Climate compatible AppHomeKit via Homebridge

3 minutes of reading
PURPOSES OF THE GUIDE:
  • Equip Ambi Climate compatibility AppHomeKits thanks to integration with Homebridge
  • Difficulty level: medium low
CONCEPTS FACED:
  • Software installation and configuration
SOFTWARE COMPONENTS USED:
Prerequisites:
PHYSICAL DEVICES USED:
  • The device on which it resides Homebridge
  • One or more actuators for air conditioners Ambi Climate already configured via the proman app mobile (for iOS e Android).
GUIDE MOST INDICATED FOR:

Apple-200x200

Notes and disclaimer
  • qualsiasi eventuale modifica agli impianti domestici dev'essere progettata ed realizzata SOLO da personale qualificato;
  • any changes implemented in probefore is a propersonal responsibility as well as a profirst risk and danger (the contents of the present page are purely educational);
  • any changes implemented in proprior to a device it voids the guarantee, quality approvals and certifications.
Driving review: 1.0

Abstract

As unfortunately known, one of the most prestigious actuators for air conditioners - theAmbi Climate - as valuable as it does not count among the pronative features with native compatibility with Appthe HomeKits.

As often happens, this is not a proproblem: the adoption of Homebridge, in fact, it allows to make compatible with this standard many components that would not foresee it. Ambi Climate is among them.

To do this it is necessary to use not one but two plugins (in reality it is also possible to use only one of them as a choice), because:

Using both plugins therefore allows you to equip the proman app "Home" of all possible functionalities related to proprio Ambi Climate.

Installation

Installation, like all plugins for Homebridge - it's very simple.

Perform the following two commands - on unix-based systems (linux, Raspberry etc.) from the terminal, from systems Windows su procommand mpt:

sudo npm install -g homebridge-ambiclimate-thermostat
sudo npm install -g homebridge-ambiclimate

and wait for the end of proprocedure. In the case of systems Windows, remove the prefix "sudo".

Nb. In case Homebridge is already running as a service (as described in our installation guides), prosee to interrupt it before installing using the command:

sudo systemctl stop homebridge

OAuth Client

In order for both plugins to work (or individually) it is necessary to ask Ambi Climate the provision of a pair of personal access keys that allow Homebridge to access the cloud of proproducer and, from there, indirectly obtain data from profirst actuator.

For this purpose it is necessary to create one probefore OAuth Application at theAmbi Dev Portal. Once accessed via the profirst user Ambi Climate (the same used to configure theapp mobile), click below “OAuth Client"And then on"Create an App"

configuration as follows:

Ambi Climante - OAuth Client - Homebridge

Once the configuration is completed in the OAuth client list appa voice will appear "Homebridge"; by accessing it, it will be possible to read the two personal keys called “customer ID" and "Client Secret". Sign them, they will be useful soon.

Configuration

The plugins configuration includes the addition to the Home configuration filebridge of one or more accessories configured as follows:

"accessories": [
    {
        "accessory": "AmbiClimateThermostat",
        "name": "",
        "roomName": "",
        "locationName": "",
        "clientId": "",
        "clientSecret": "",
        "username": "",
        "password": ""
    },
    {
        "accessory": "AmbiClimate",
        "name": "",
        "roomName": "",
        "locationName": "",
        "clientId": "",
        "clientSecret": "",
        "username": "",
        "password": "",
        "onMode": "Comfort",
        "offMode": "Away_Temperature_Upper",
        "offValue": 25
    }
]

Explanation of the fields.

Plugin "homebridge-ambiclimate-thermostat "
FieldDescription
accessoryRequired - Must necessarily be "AmbiClimateThermostat"
nameRequired - Name of the accessory for how appwill come to "Casa"
roomName
The name of the room in which the Room is installed Climate. It must correspond to the one indicated on theapp phones.
locatioNameThe name of the location where the Room is installed Climate - understood as appartamento, casa. It must correspond to the one indicated on theapp phones.
clientIDThe first key defined thanks to the previous paragraph in the Ambi cloud Climate.
clientSecretThe first key defined thanks to the previous paragraph in the Ambi cloud Climate.
usernameThe username used to authenticate via theapp phones.
password
The password used to authenticate via theapp phones.
Plugin "homebridge-ambiclimate "
FieldDescription
accessoryRequired - Must necessarily be "AmbiClimate"
nameRequired - Name of the accessory for how appwill come to "Casa"
roomName
The name of the room in which the Room is installed Climate. It must correspond to the one indicated on theapp phones.
locatioNameThe name of the location where the Room is installed Climate - understood as appartamento, casa. It must correspond to the one indicated on theapp phones.
clientIDThe first key defined thanks to the previous paragraph in the Ambi cloud Climate.
clientSecretThe first key defined thanks to the previous paragraph in the Ambi cloud Climate.
usernameThe username used to authenticate via theapp phones.
password
The password used to authenticate via theapp phones.
onmode(Optional) The default mode when the thermostat is turned on. Choose from the following values: Comfort / Off / Away_Temperature_Upper / Away_Temperature_Lower / Away_Humidity_Upper / Temperature
offMode(Optional) The default mode when the thermostat is turned off. Choose from the following values: Comfort / Off / Away_Temperature_Upper / Away_Temperature_Lower / Away_Humidity_Upper / Temperature.
The default value is "off"
offValue(Optional) The default value for the "off"

utilization

As explained, the co-presence of both plugins allow the definition of disadvantages, different accessories. First and foremost, a thermostat and a virtual fan, secondly a series of comfortable sensors for consultation and automation.

Update Searchnamento

To update the plugins is sufficient execute the following commands:

sudo npm update -g -dev homebridge-ambiclimate-thermostat
sudo npm update -g -dev homebridge-ambiclimate

having previously taken care of having stopped any Home executionsbridge in progress.


Logo Appthe HomeKitsATTENZIONE: remember that there is on our FORUM community an ad hoc section dedicated to Appthe Homekits, for any doubt, question, information on the specific merit of these components.

inDomus telegram channel