homebridge-argo
v1.7.1
Published
Homebridge plugin for Argo air conditioners
Downloads
58
Maintainers
Readme
Homebridge Argo
Homebridge plugin for Argo air conditioners
This Homebridge plugin exposes Argo air conditioners, capable of WiFi, to Apple's HomeKit.
Currently only the Ulisse 13 DCI Eco WiFi is confirmed to work
Configuration
To configure the plugin simply install it and use the config UI to configure.
Alternatively you can configure it using the config.json
file of Homebridge. Simply add the Argo platform to the platforms and configure your devices.
"platforms": [
{
"platform": "Argo",
"devices": [
{
"name": "Example Display Name",
"ip": "192.168.5.30"
}
]
}
]
Advanced device settings
In some cases Argo devices don't accurately report the temperate. In those cases you can set a offset in the device configuration to help compensate for the inaccuracy.
"platforms": [
{
"platform": "Argo",
"devices": [
{
"name": "Example Display Name",
"ip": "192.168.5.30",
"offset": 2.5,
}
]
}
]
In the above example the temperature would be adjusted by 2.5 degrees. Meaning that the read temperature will be 2.5 degrees higher and all settings will be 2.5 degrees lower to compensate. this also affects min/max setpoints
Advanced settings
Argo devices have a lot of issues with their connectivity as they seem to require a connection to their home server. To help with this we can let the device push updates to Homebridge instead of polling the device constantly. As the device is configured to only communicate with its home serverwe need to redirect traffic to that server to our Homebridge instance instead.
To achieve this first we need to start the listener build into this plugin, you can do so by setting the usePush
flag to true and defining a port
to use.
After changing the config restart homebridge.
"platforms": [
{
"platform": "Argo",
"devices": [
{
"name": "Example Display Name",
"ip": "192.168.5.30"
}
],
"usePush": true,
"port": 42420
}
]
Afterwards you need to tell your router to redirect traffic to your Homebridge instance. You can do so by running:
iptables -t nat -I PREROUTING -s 0.0.0.0/0 -d 31.14.128.210 -p tcp -j DNAT --to-destination <your-homebridge-ip>:<your-port>
After this the Plugin will no longer poll but will listen for updates from the device instead.
To remove the traffic redirect in the future just run:
iptables -t nat -D PREROUTING -s 0.0.0.0/0 -d 31.14.128.210 -p tcp -j DNAT --to-destination <your-homebridge-ip>:<your-port>
Alternative setup
You can alternatively configure the homebridge server with the IP 31.14.128.210
and tell your router to statically route 31.14.128.210
to your homebridge instance.
If you decide to do so please configure the listener to listen on port 80 and 31.14.128.210
"platforms": [
{
"platform": "Argo",
"devices": [
{
"name": "Example Display Name",
"ip": "192.168.5.30"
}
],
"usePush": true,
"port": 80,
"host": "31.14.128.210",
}
]