Homebridge HTTP Leak Sensor

Description

This homebridge plugin exposes a web-based Leak Sensor to Apple's HomeKit. Using simple HTTP requests, the plugin allows you to monitor the status of leak sensors.

Leak sensors enabled with this plugin will appear in Homekit as sensors. You will be able to check whether or not they detect a leak. When a leak is detected Homekit will send you CRITICAL alert notifications.

Installation

1. Install homebridge
2. Install this plugin. npm install -g homebridge-http-leak-sensor.
3. Configure the accessory in config.json.

Configuration

"accessories": [
    {
        "accessory": "HomebridgeHTTPLeakSensor",
        "name": "Leak Sensor",
        "url": "http://192.168.1.54/status",
        "pollInterval": 60,
        "failedRequestsLimit": 100,
        "manufacturer": "Homebridge",
        "model": "Leak Sensor",
        "serialNumber": "ESP-32"
    }
]

Required

| Key | Description | Default | | --- | --- | --- | | accessory | Must be "HomebridgeHTTPLeakSensor" | | | name | Name to appear in the Home app | | | url | URL route to your device | |

Optional

| Key | Description | Default | | --- | --- | --- | | pollInterval | Time (in seconds) to check device status. | 60 | | failedRequestsLimit | Limit of failed requests that can be made to url before the plugin stops making requests. Value of 0 allows unlimited failed requests. | 120 | | model | Appears under the Model field for the accessory | "Leak Sensor" | | serial | Appears under the Serial field for the accessory | "000000" | | manufacturer | Appears under the Manufacturer field for the accessory | "Homebridge" |

Device API

Your Leak Sensor API should be able to return JSON information when it receives /status:

{
    "currentState": "WET"
}

| State | Description | | ----- | --- | | "WET" | Device is detecting a leak. | | "DRY" | Device is not detecting a leak. |

Sensors

This plugin is intended to communicate with very simple DIY leak sensors. To build your own Leak Sensor see sample code in the /examples folder.