homebridge-mqtt-humiditydeprecated

A HomeBridge plugin for MQTT relative humidity sensors.

Usage no npm install needed!

<script type="module">
  import homebridgeMqttHumidity from 'https://cdn.skypack.dev/homebridge-mqtt-humidity';
</script>

README

DEPRECATION NOTICE


This package is deprecated. Please use homebridge-mqtthing instead. It is more mature, better tested, and offers additional-features.


homebridge-mqtt-humidity

Get Humidity Sensor data via MQTT in Homebridge

Installation

sudo npm install -g homebridge-mqtt-humidity

Sample HomeBridge Configuration

{
  "bridge": {
    "name": "HomeBridge",
    "username": "CC:33:3B:D3:CE:32",
    "port": 51826,
    "pin": "321-45-123"
  },

  "description": "",

  "accessories": [
            {
      "accessory": "mqtt-humidity",
      "name": "Living Room Humidity",
      "url": "mqtt://10.0.0.5",
      "topic": "home/livingroom/humidity/percentage",
      "refresh_topic": "home/livingroom/humidity/get",
      "charge_topic": "home/livingroom/humidity/charge",
      "batt_topic: "home/livingroom/humidity/battery",
      "batt_low_perc": "25",
      "username": "username",
      "password": "password",
      "serial": "HMH-54D3X"
            }
  ],

  "platforms": []
}

serial allows you to change the serial number to a custom value if you need it.

batt_topic, charge_topic and bat_low_perc are for battery powered sensors.

  • batt_low_perc overrides the default 20% value.
  • charge_topic is for charging state. It requires values of either 0 or 1 for off and on respectively.

refresh_topic lets you publish to a topic to refresh the current temperature value. This is useful in cases where your device publishes infrequently and you need an update between intervals. It requires your device to monitor this topic for requests. A request will published everytime homebridge makes a request, for example on opening the app.

All five options are are optional as well as username and password if you don't use MQTT authentication.

Credits

homebridge-mqttswitch

homebridge-mqttgaragedoor

homebridge-ds18b20