Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/maxnowack/homebridge-eq3ble
Homebridge plugin to control EQ3 bluetooth thermostats
https://github.com/maxnowack/homebridge-eq3ble
Last synced: 4 days ago
JSON representation
Homebridge plugin to control EQ3 bluetooth thermostats
- Host: GitHub
- URL: https://github.com/maxnowack/homebridge-eq3ble
- Owner: maxnowack
- License: gpl-3.0
- Created: 2016-11-09T19:33:52.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2022-12-02T23:09:53.000Z (almost 2 years ago)
- Last Synced: 2024-11-01T18:42:44.300Z (11 days ago)
- Language: JavaScript
- Size: 252 KB
- Stars: 21
- Watchers: 8
- Forks: 8
- Open Issues: 14
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## Homebridge EQ3BLE
Homebridge plugin to control EQ3 bluetooth thermostats.
It's possible to report MQTT topic's messages as current temperature of this thermostat.
### Usage
````json
{
"bridge": {
"name": "Homebridge",
"username": "CC:22:3D:E3:CE:30",
"port": 51826,
"pin": "031-45-154"
},
"accessories": [{
"accessory": "EQ3-Thermostat",
"name": "Thermostat",
"address": "00:1a:22:07:48:77"
}]
}
````
## Options
You can configure the homebridge integration for the thermostat with the following options
| Option | Default value | Description |
| --- | --- | --- |
| `address` *(required)* | | Address of the thermostat |
| `discoverTimeout` | `60000` | time in milliseconds before a timeout error will be triggered |
| `connectionTimeout` | `10000` | time in milliseconds before homebridge will disconnect from the device after last action |
| `disableBoostSwitch` | `false` | if set to true, the boost switch won't be published from homebridge |
| `currentTemperature` | | MQTT configuration for current temperature |
### External current temperature configuration options
| Option | Description |
| --- | --- |
| `url` *(required)* | MQTT URL |
| `topic` *(required)* | MQTT Topic name |
| `username` | Username for accessing MQTT server |
| `password` | Password for accessing MQTT server |
## Usage with external current temperature sensor
````json
{
"bridge": {
"name": "Homebridge",
"username": "CC:22:3D:E3:CE:30",
"port": 51826,
"pin": "031-45-154"
},
"accessories": [{
"accessory": "EQ3-Thermostat",
"name": "Bedroom Thermostat",
"address": "00:1a:22:07:48:77",
"currentTemperature": {
"url": "mqtt://localhost",
"topic": "/home/sensors/bedroom/temperature",
"username": "sensors",
"password": "Sensors!"
}
}]
}
````
## License
Licensed under GPLv3 license. Copyright (c) 2015 Max Nowack
## Contributions
Contributions are welcome. Please open issues and/or file Pull Requests.
## Maintainers
- Max Nowack ([maxnowack](https://github.com/maxnowack))