homebridge-advanced-thermostat
This is a HomeBridge plugin. Allows HomeKit to use your own Temperature + Humidity Sensor under HTTP protocol.
Installation
You need to be root or use command "sudo" to install this packages.
*Is necessary has installed node.js with npm.
- Install homebridge using: npm install -g homebridge
- Install this plugin using: npm install -g homebridge-advanced-dht-sensor
- Update your configuration file. See bellow for a sample.
note If you are experimenting problems to install this plugin try to add "-unsafe--perm" (without ") - sudo npm install -g -unsafe--perm homebridge-advanced-dht-sensor -
Configuration
Configuration sample:
{
"bridge": {
...
},
"description": "...",
"accessories": [
{
"accessory": "DHT-SENSOR",
"name": "Sensor name",
"apiAdress": "http://url",
"username": "user", // Optional
"password": "pass" // Optional
"this.http_method": "get"; // Optional
"manufacturer": "manufacturer", // Optional
"model": "model", // Optional
"serial_number": "serial number", // Optional
"humidity": "true" // Optional (enable "true" or disable "false" Humidity Sensor)
"units": "C" // Optional (Default C = Celsius) F = Fahrenheit
"battery": "true" // Optional (enable "true" or disable "false" Battery Status)
}
],
"platforms":[]
}
Node(API) Configuration or whatever be your Temperature Sensor platform (What the plugin expects to receive)
The apiAdress
is used for two main calls: Get and Set data to the Thermostat. Your Node(API) should provide it
- Get Current Temperature and Current Humidity from Temp + Hum Sensor.
JSON Format with:
GET /dht
{
"temperature": FLOAT_VALUE, // Current Temperature
"humidity": FLOAT_VALUE // Current Humidity
}
- Get Current Battery Status from Temp + Hum Sensor.
JSON Format with:
GET /battery
{
"level": INT_VALUE // Current Battery Level Value of 0 to 100
"charging": INT_VALUE // Current Charging State 0 NOT CHARGING 1 CHARGING 2 CAN NOT CHARGE
"low": INT_VALUE // Current Low Battery State 0 DESACTIVATED 1 ACTIVATED
}