Homebridge Levoit Humidifiers

This is a Homebridge plugin to control Levoit Humidifiers with via the VeSync Platform.

If you have the version 400S or 200S and you have issues, please open a issue and if it can be fixed without owning one of those models i will fix it, if not i will omit the specified model from the plugin.

This plugin uses similar API calls as homebridge-levoitcore-client but with differences on API implementation and extra features.

Any device from VeSync that is not listed in the supported versions are automatically skipped when discovering devices.

Features

#. MistLevel option:

• 0 -> Off
• 1 -> Sleep Mode
• 2 -> Level 1
• 3 -> Level 2
• 4 -> Level 3
• 5 -> Level 4 (Only for Core 400S and 400S Pro)

#. Mode change

• Auto
• Manual

The read data is cached for 5 seconds to not trigger the rate limiter for the API. Each request is delayed by 500ms to not trigger the rate limiter if a huge number of requests are sent.

The timers are not included because you can accomplish similar results by using Home App's Automatization or the Shortcuts app

Configuration

• Via the Homebridge UI, enter the Homebridge VeSync Client plugin settings.
• Enter your VeSync app credentials.
• Setup the platform plugin as a child bridge for better performance
• Save and restart Homebridge.

This plugin requires your VeSync credentials as it communicates with the VeSync devices via VeSync's own API. Your credentials are only stored in the Homebridge config and not sent to any server except VeSync's.

You can also do this directly via the homebridge config by adding your credentials to the config file under platforms. Replace the values of username and password by your credentials.

{
  "platforms": [
    {
      "name": "Levoit Humidifiers",
      "email": "email",
      "password": "password",
      "platform": "LevoitHumidifiers"
    }
  ]
}

Enabling Debug Mode

In the config file, add enableDebugMode: true

{
  "platforms": [
    {
      "name": "Levoit Humidifiers",
      "email": "email",
      "password": "password",
      "platform": "LevoitHumidifiers",
      "enableDebugMode": true
    }
  ]
}

Local Development

To setup the local project clone the files and inside the root directory of the project run:

yarn install

After that to start the local server use

yarn watch