Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/0skillallluck/homebridge-argo
Homebridge plugin for Argo air conditioners
https://github.com/0skillallluck/homebridge-argo
air-conditioner homebridge homebridge-plugin
Last synced: 4 months ago
JSON representation
Homebridge plugin for Argo air conditioners
- Host: GitHub
- URL: https://github.com/0skillallluck/homebridge-argo
- Owner: 0SkillAllLuck
- License: apache-2.0
- Created: 2024-06-28T13:57:17.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2024-10-09T05:11:09.000Z (4 months ago)
- Last Synced: 2024-10-09T22:01:40.286Z (4 months ago)
- Topics: air-conditioner, homebridge, homebridge-plugin
- Language: TypeScript
- Homepage:
- Size: 399 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Homebridge Argo
[](https://github.com/homebridge/homebridge/wiki/Verified-Plugins)
[](https://www.npmjs.com/package/homebridge-argo)
[](https://www.npmjs.com/package/homebridge-argo)
[](https://github.com/0skillallluck/homebridge-argo/issues)
[](https://github.com/0skillallluck/homebridge-argo/pulls)
## Homebridge plugin for Argo air conditioners
This [Homebridge](https://github.com/homebridge/homebridge) plugin exposes [Argo](https://www.argoclima.com/en/) air conditioners,
capable of WiFi, to Apple's [HomeKit](https://www.apple.com/ios/home/).
*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.
```json
"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.
```json
"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.
```json
"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:
```bash
iptables -t nat -I PREROUTING -s 0.0.0.0/0 -d 31.14.128.210 -p tcp -j DNAT --to-destination :
```
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:
```bash
iptables -t nat -D PREROUTING -s 0.0.0.0/0 -d 31.14.128.210 -p tcp -j DNAT --to-destination :
```
#### 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
```json
"platforms": [
{
"platform": "Argo",
"devices": [
{
"name": "Example Display Name",
"ip": "192.168.5.30"
}
],
"usePush": true,
"port": 80,
"host": "31.14.128.210",
}
]
```