homebridge-dht-mqttpub/README.md

Homebridge accessory plugin that reads Temperature/Humidity values from DHT Sensors connected to a Raspberry PI.

# homebridge-dht-mqttpub
Integrate DHT sensor into homebridge and publish sensor data via mqtt

# Installation
tbd

# Configuration - with RPI cpu temperature sensor, requires cputemp program ( Optional )

```
{
  "bridge": {
    "name": "MyHomebridge",
    "username": "CC:22:3D:E3:CD:33",
    "port": 51826,
    "pin": "031-45-154"
  },
  "description": "HomeBridge DHT22",

  "platforms": [
  ],
  "accessories": [
    {
      "accessory": "Dht",
      "name": "CPU Temperature",
      "service": "Temperature",
      "refresh": "15"
    }, {
      "accessory": "Dht",
      "name": "dht22",
      "name_temperature": "Temperature",
      "name_humidity": "Humidity",
      "service": "dht22",
      "gpio": "4",
      "refresh": "15"
    }
  ]
}
```
# Configuration - without cputemp
```
{
  "bridge": {
    "name": "MyHomebridge",
    "username": "CC:22:3D:E3:CD:33",
    "port": 51826,
    "pin": "031-45-154"
  },
  "description": "HomeBridge DHT22",

  "platforms": [
  ],
  "accessories": [
    {
      "accessory": "Dht",
      "name": "dht22",
      "name_temperature": "Temperature",
      "name_humidity": "Humidity",
      "service": "dht22",
      "gpio": "4",
      "refresh": "15"
    }
  ]
}
```
# or with multiple DHT22's
```
{
  "accessory":          "Dht",
  "name":               "dht22 - indoor",
  "name_temperature":   "Indoor Temperature",
  "name_humidity":      "Indoor Humdity",
  "gpio":               "4",
  "service":            "dht22",
  "refresh":            "60"
},
{
  "accessory":          "Dht",
  "name":               "dht22 - outdoor",
  "name_temperature":   "Outdoor Temperature",
  "name_humidity":      "Outdoor Humdity",
  "gpio":               "2",
  "service":            "dht22",
  "refresh":            "30"
}

```

# Configuration Options

Optional parameters includes

| Config Item | Description |
| --- | --- |
| `dhtExec` | Full command including path to read dht22 sensor.  Not needed unless dht22 is installed in a location not on the path.  Defaults to dht22 ie "dhtExec": "/usr/local/bin/dht22" |
| `cputemp` | Full command including path to read cpu temp sensor.  Not needed unless cputemp is installed in a location not on the path.  Defaults to cputemp ie "cputemp": "/usr/local/bin/cputemp" |
| `gpio` | Gpio pin to read for dht22 sensor.  Defaults to 4 ie "gpio": "4" |
| `Refresh` | Frequency of data refresh. Defaults to 1 minute |
| `name` | descriptive name |
| `name_temperature` (optional)| descriptive name for the temperature sensor |
| `name_humidity` (optional)| descriptive name for the humidity sensor |


# Optional cputemp script - install in /usr/local/bin
```
#!/bin/bash
cpuTemp0=$(cat /sys/class/thermal/thermal_zone0/temp)
cpuTemp1=$(($cpuTemp0/1000))
cpuTemp2=$(($cpuTemp0/100))
cpuTempM=$(($cpuTemp2 % $cpuTemp1))

echo $cpuTemp1" C"
#echo GPU $(/opt/vc/bin/vcgencmd measure_temp)
```
# ToDo

* tbd

# Credits

* name here