@townsen/homebridge-ds18b20 v0.9.8

homebridge-ds18b20

Features

• Supports the graphing feature of the Eve app for trends

Installation

Setup the Hardware

First ensure you have a 4.7k pullup resistor wired between the data pin and positive supply. Then choose which GPIO pin to use. The default is GPIO 4 but since I2C devices are often connected in that area I use header pins 14(gnd), 15(gpio 22) and 17 (3v3).

Configure the OS

1. Setup the correct GPIO pin in /boot/config.txt with dtoverlay=w1-gpio,gpiopin=22.
2. Alternatively dynamically load it with dtoverlay w1-gpio gpiopin=22 pullup=0
3. Install Homebridge using npm install -g homebridge
4. Install this plugin npm install -g @townsen/homebridge-ds18b20
5. Update your configuration file - see below for an example

Local Install

In this plugin directory issue:

npm install
sudo npm link

Configuration

• accessory: "DS18B20"
• name: descriptive name
• refresh: Optional, time interval for refreshing data in seconds, defaults to 30 seconds.
• device_id: the 1-wire device identifier. Find this by listing the directory /sys/bus/w1/devices
• recordpath: Optional, used by the fakegato history code to create an on-disk record of the observations. This preserves the history in case of a restart, and can be used to extract the observations manually. The name and the device_id are used to name the sensor device, which is then used as the filename.

Simple Configuration

{
  "bridge": {
    "name": "DS18B20",
    "username": "CB:22:33:E2:CE:31",
    "port": 51826,
    "pin": "033-44-254"
  },
  "accessories": [
    {
      "accessory": "DS18B20",
      "name": "Water Temperature",
      "refresh": 60,
      "device_id": "28-3c01d6077a95"
    }
  ],
  "platforms": []
}

License

MIT