This is a plugin for 1-Wire temperature and humidity sensors (DS18B20
, for example) as well as the DS2408
and DS2403
(switches). As Pre-requisite, you need to have OWFS installed on your RPi.
From version 1.1.0, this plugin relies on OWSERVER protocol to poll 1-wire devices (previous versions used owfs directly through fs access). Historical display of temperature and humidity data is available via HomeKit apps thats support graphing.
The following 1-Wire Sensors (types) are pre-configured:
OWFS_DS18B20
: temperatureOWFS_DS2438
: temperature, humidityOWFS_EDS0064
: temperatureOWFS_EDS0065
: temperature, humidityOWFS_EDS0066
: temperatureOWFS_EDS0067
: temperatureOWFS_EDS0068
: temperatureAny 1-Wire sensor that provides temperature or humidity should be configurable. It is also possible to pull alternate temperature and humidity values supplied by some devices.
sudo npm install -g homebridge-owfs
{
"bridge": {
"name": "HomeBridge",
"username": "CC:22:3D:E3:CE:30",
"port": 51826,
"pin": "031-45-154"
},
"description": "",
"accessories": [
{
"accessory": "OWFS_Sensor",
"type": "OWFS_DS2408",
"name": "GardenSwitch",
"device": "29.67C6697351FF",
"switches": [
{ "name": "Main Light", "port" : "1" },
{ "name": "water", "port" : "2" },
{ "name": "Barbecue", "port" : "3" }
],
"host_ip": "raspberrypi.local or whatever IP address, can be omitted if local board is used",
"host_port: "4304 can be omitted if default 4304 port is used"
},
{
"accessory": "OWFS_Sensor",
"type": "OWFS_DS18B20",
"name": "Temperature Sensor",
"device": "28.0000063f4ead",
"host_ip": "raspberrypi.local or whatever IP address, can be omitted if local board is used",
"host_port: "4304 can be omitted if default 4304 port is used"
},
{
"accessory": "OWFS_Sensor",
"capabilities": {
"temperature": "EDS0065/temperature",
"humidity": "EDS0065/humidity"
},
"name": "Downstairs",
"device": "34.0000063f4eaa",
"host_ip": "raspberrypi.local or whatever IP address, can be omitted if local board is used",
"host_port": "4304 can be omitted if default 4304 port is used"
}
],
"platforms": []
}
Set accessory
to OWFS_Sensor
.
type
- Use a pre-configured sensor type. If the type does not exist, you must specify the capabilities
, or it will default to a simple temperature sensor setup.capabilities
- This represents the capabilities of the device
temperature
- Add this key if the 1-Wire sensor supports temperature. The value is the owfs target for the value. In the example above for the sensor named Downstairs
, the owfs full path would be /34.0000063f4eaa/EDS0065/temperature
.humidity
- Same as temperature, but for humidity.If both capabilities
and type
are omitted, the default of a simple temperature sensor will be used.
update_interval
- time, in minutes, between automatic updates to HomeKit (default: 2)log_days
- number of days of historical data to keep (default: 365)For switches sensors, set type to OWFS_DS2408 or other switch device