homebridge-ambient-realtime
Ambient platform plugin for Homebridge.
About
Supports Ambiant weather station and additional sensors using Ambiant's realtime API, no polling required, incoming data events are recieved once evey minute.
If you have more than one weather station on account you may filter the weather stations for each home based on the location name assigned in the app for the location you want to display in HomeKit.
Once the plugin starts the last data set Ambient has for your weather station will be shown in the homebridge log as the inital data from the subscribe event. Any item on that list can be configured as a custom sensor using those values as the data points. For details on these values see Ambient device specs.
Note the examples in the sample config below. The actual recieved value will be stored in the sensor as light level value.
I can test agaist the devices I have available, other sensors have only been tested agaist Ambient's API documentaion.
For now custom sensors only trigger when the threshold is exceeded.
Installation
- Install this plugin using: npm install -g homebridge-ambient-realtime
- Use plugin settings to edit
config.json
and add your account info. - Run Homebridge
- Pair to HomeKit
Config.json example with child bridge
{
"name": "Ambient",
"api_app_key": "application key",
"api_key": "your key goes here",
"locationAddress": "123 Easy Street",
"showOutdoor": true,
"showIndoor": true,
"showAqin": true,
"showIndoorAir": false,
"showOutdoorAir": true,
"showOtherTemp": false,
"showLeak": false,
"sensors": [
{
"name": "Wind",
"dataPoint": "windspeedmph",
"threshold": 4,
"type": 0
},
{
"name": "Rain",
"dataPoint": "eventrainin",
"threshold": 0,
"type": 0
},
{
"name": "Lightning",
"dataPoint": "lightning_hour",
"threshold": 0,
"type": 1
}
],
"showSocketData": false,
"_bridge": {
"username": "0E:43:35:74:24:77"
},
"platform": "ambient"
}