homebridge-smartdry-v2

homebridge-smartdry

What This Plugin Is

This is a plugin for homebridge. It provides sensor data from the SmartDry Sensor.

How the Plugin Works

SmartDry data is stored in AWS RDS. This API periodically queries the database for information pertaining to your sensor and then updates virtual sensors with the data.

The Occupancy Sensor will stay Occupied as long as the sensor is running. The minimum amount of time is 15 minutes. To automate an action (such as sending a notification), you can put an action on when the sensor stops detecting occupancy.

The Leak Sensor will show if the clothes are truly dry. This runs external to the load time. So it is theoretically possible for the SmartDry sensor to not be "running" but the clothes are still wet. NOTE The Leak Sensor uses Critical Alerts in modern versions of the Home app. Please be careful when using it or you could generate scary notifications.

Installation

Before installing this plugin, you should install Homebridge using the official instructions.

Install via Homebridge Config UI X

1. Search for Homebridge SmartDry v2 on the Plugins tab of Config UI X.
2. Install the Homebridge SmartDry v2 plugin and use the form to enter your configuration.

Manual Installation

2. Install this plug-in using: npm install -g homebridge-smartdry-v2
3. Update your configuration file. See example config.json snippet below.

Manual Configuration

Platform Schema

Field	Required	Data Type	Description	Default Value
platform	Yes	string	Must always be set to HomebridgeSmartDryV2.	N/A
name	Yes	string	Set the platform name for display in the Homebridge logs.	Homebridge SmartDry v2
sensors	Yes	sensor[]	An array of configurations for SmartDry sensors.	N/A
pollingSeconds	No	number	Time in seconds for how often to ping the clock.	30 (30000 milliseconds)

Sensor Schema

Field	Required	Data Type	Description	Default Value
name	Yes	string	The name of the SmartDry Sensor. It will be used as a prefix for all of the accessories it exposes.	N/A
ip	Yes	string	ID of the SmartDry sensor.	N/A
occupancySensor	Yes	sensorConfig	Settings for virtual occupancy sensor.	N/A
temperatureSensor	Yes	sensorConfig	Settings for virtual temperature sensor.	N/A
humiditySensor	Yes	sensorConfig	Settings for the virtual humidity sensor.	N/A
leakSensor	Yes	sensorConfig	Settings for the virtual leak sensor.	N/A

SensorConfig Schema

Field	Required	Data Type	Description	Default Value
isEnabled	No	boolean	Determines whether or not to expose the sensor.	true

Config Examples

Simplest Configuration

This configuration will expose all items and use the default polling interval with the least work.

{
  "name": "Homebridge SmartDry v2",
  "sensors": [
    {
      "name": "Laundry Room Dryer",
      "id": "[INSERT_ID_HERE]"
    }
  ],
  "platform": "HomebridgeSmartDryV2"
}

Most Verbose Configuration

This configuration will expose all items with default values, but is very verbose. It is presented here to help visualize the JSON structure.

{
  "name": "Homebridge SmartDry v2",
  "sensors": [
    {
      "name": "Laundry Room Dryer",
      "id": "[INSERT_ID_HERE]",
      "occupancySensor": {
        "isEnabled": true
      },
      "temperatureSensor": {
        "isEnabled": true
      },
      "humiditySensor": {
        "isEnabled": true
      },
      "leakSensor": {
        "isEnabled": true
      }
    }
  ],
  "platform": "HomebridgeSmartDryV2"
}

Future Plans

• Better error handling. I am a Java developer by trade and am still learning Typescript :).

Recognition

Thanks to:

• homebridge - For creating a great template to get started with.
• ablyler - For creating an original SmartDry plugin.
• doublebishop - For simplifying the "wetness" algorithm.