homebridge-http-moisture-sensor v1.0.4

homebridge-http-moisture-sensor

This plugin is a fork of homebridge-http-humidity-sensor.

• Characteristic.CurrentRelativeHumidity
• Characteristic.StatusLowBattery

What is this fork doing?

Often humidity or moisture sensors are placed outside in the garden and are battery powered. In this case, battery capacity is important. To minimize the battery consumption the sensor should wake up, measure, send data and go back into deep sleep mode. This fork support that behavior by using the functionality of the homebridge-http-notification-server, add the "StatusLowBattery" characteristic and caching the received data. This prevent unintentionally device wake ups and save battery capacity. The sensor itself (ex. triggered by the device RTC) decided, when data should be sent. If the plugin starts at first or been reset, the CurrentRelativeHumidity is 0 and StatusLowBattery is 1 (see HAP Specification HumiditySensor). Send the sensor data, the values will be overwritten immediately and cached until the next data will be received.

Installation

1. Install homebridge by using: npm install -g homebridge
2. Install the notification server by using: npm install -g homebridge-http-notification-server
3. Prepare the homebridge config script to let the notification server work properly homebridge-http-notification-server
4. Install the moisture plugin by using: npm install -g homebridge-http-moisture-sensor
5. Configure the homebridge config script parameter for the moisture sensors
6. Prepare the sensor to send correct json data (see homebridge-http-notification-server)

Example config.json

{
    "accessories": [
        {
          "accessory": "HTTP-MOISTURE",
          "name": "Moisture Sensor",
          "notificationID": "my-moisture-sensor",
          "notificationPassword": "superSecretPassword",
          "getUrl": "http://192.168.0.xxx/",
          "Humidity_MinValue": 0,
          "Humidity_MaxValue": 100

        }   
           ]
 }

• accessory (mandatory) "HTTP-MOISTURE" (type: string)
• name | (mandatory) It will appear in the Home app (type: string)
• password (optional) if you use secure communication to your device (type: string)
• notificationID (mandatory) Identifier to use the notification server (type: string)
• getUrl (mandatory) your sensor
• Humidity_MinValue and Humidity_MaxValue(optional) Homekit expect 0 an 100 for these values. There are many different sensor types, with different value ranges, on the market. Additionally, the chemically characteristic of the measured substance (ex. soil) is different. You can play with these parameters. Without these parameters, 0 and 100 are set as default value. (type: integer or float)