0.8.2 • Published 2 days ago

@townsen/homebridge-dht-lgpio v0.8.2

Weekly downloads
-
License
MIT
Repository
gitlab
Last release
2 days ago

homebridge-dht-lgpio

A temperature/humidity sensor service plugin for Homebridge. It uses a DHTxx connected via the LGPIO package. This is required for kernels 5.11 and above.

  • Display of temperature, humidity from a DHTxx connected to a RaspberryPI.
  • Support the graphing feature of the Eve app for trends

Installation

  1. Install Homebridge using npm install -g homebridge
  2. Install this plugin npm install -g @townsen/homebridge-dht-lgpio
  3. Update your configuration file - see below for an example

Configuration

  • accessory: "DHTxx"
  • name: descriptive name
  • loglevel: 0 = none, 1 = each reading, errors are always logged
  • gpiochip: the gpio chip to use (optional, default 0)
  • gpio: the pin to which the device is connected (optional, default 4)
  • name_temperature (optional): descriptive name for the temperature sensor
  • name_humidity (optional): descriptive name for the humidity sensor
  • refresh: Optional, time interval for refreshing data in seconds, defaults to 30 seconds.
  • 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 sensor device is named dht-<gpiochip>-<gpio> which is then used to create the filename: homebridge_<device>_persist.json.

Simple Configuration

This is fine if you just have one device called "Temperature", but if you have more then their persisted readings will collide!

{
  "bridge": {
    "name": "Example for DHT22 using LGPIO",
    "username": "AB:A2:44:66:6E:36",
    "port": 51826,
    "pin": "023-66-204"
  },
  "accessories": [
    {
      "accessory": "DHTxx",
      "name": "Sensor",
      "name_temperature": "Temperature",
      "name_humidity": "Humidity",
      "recordpath": "/save/me",
      "refresh": 35,
      "hostname": "remote.machine",
      "gpiochip": 0
      "gpio": 5
    }
  ],
  "platforms": []
}

This plugin creates two services: TemperatureSensor and HumiditySensor.

Credits

This was adapted from the two projects below:

  • homebridge-bme280
  • homebridge-am2320

The python script to read the DHT devices came from

License

MIT

0.8.1

2 days ago

0.8.0

2 days ago

0.8.2

2 days ago

0.7.8

1 year ago

0.7.7

1 year ago

0.7.5

2 years ago

0.7.4

2 years ago

0.7.3

2 years ago

0.7.2

2 years ago

0.7.1

2 years ago

0.7.0

2 years ago

0.6.9

2 years ago

0.6.8

2 years ago

0.6.7

2 years ago

0.6.6

2 years ago

0.6.5

2 years ago

0.6.0

2 years ago

0.5.0

2 years ago