Homebridge-levoit-humidifiers NPM

Homebridge Levoit Humidifiers

This is a Homebridge plugin to control Levoit Humidifiers from Apple HomeKit.

Supported Versions	Auto Mode	Cool Mode	Sleep Mode	Night Light	Display Toggle	Humidity Sensor	Warm Mode
OasisMist 1000S	✅	✅	✅	❌	✅	✅	❌
OasisMist 450S	✅	✅	✅	❌	✅	✅	✅
LV600S	✅	✅	✅	❌	✅	✅	✅
Classic 300S	✅	✅	✅	✅	✅	✅	❌
Classic 200S	✅	✅	❌	❌	✅	✅	❌
Dual 200S	✅	✅	❌	✅	✅	✅	❌

This plugin was forked from RaresAil's Levoit Air Purifiers repo and adds logic for the Levoit Humidifers.

Features

Humidifier / Auto Mode
- Sets humidifier to Auto / Humidity and sets the Target Humidity to the desired level.
- Can also change Target Humidity in Sleep Mode, except on LV600 / Oasis.
  - For LV600s and Oasis, the Humidifier slider will be set to 0% when Sleep Mode is on.
- For LV600s and Oasis, the Auto humidity range is 40-80%. All other models are 30-80%.
  - Selecting values outside the Auto range will set the Target Humidity to the lowest or highest number in the range.
Cool Mist Level
- Sets humidifier to Manual mode (except on LV600s / Oasis) and sets the Cool Mist Level to the desired level.
  - Note: LV600s / Oasis supports changing mist levels while in Auto mode.
- When set to Level 0, turns the device off.
- Levels 1-9 on Classic300s, Classic200s, LV600s, and Oasis
- Levels 1-2 on Dual200s
Warm Mist Level
- Sets Warm Mist Level to the desired level.
- Levels 0-3 on LV600s / Oasis only.
Sleep Mode
- This switches the device between Sleep Mode (On) and Auto Mode (Off)
- Sleep Mode Target Humidity is controlled by the Target Humidity slider, except on LV600s / Oasis.
- On LV600s / Oasis, Sleep Mode Target Humidity is set by VeSync at 50–60% and cannot be changed.
- The LV600s / Oasis turns off Warm Mist by default to keep the humidifier quiet. It can be turned back on with the Warm Mist slider.
Night Light
- Supported on Classic300s
- 4 brightness levels
Display Toggle
- Toggles the display on/off
Humidity Sensor
- Sensor that displays current Humidity %

Details

Configuration

Via the Homebridge UI, enter the Homebridge VeSync Client plugin settings.
Enter your VeSync app credentials.
Select which controls you want exposed. Humidifier (Auto Mode) and the Humidity Sensor can not be hidden.
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 with your credentials.

You can turn off optional controls via the accessories section of the config or through the plugin UI settings. The Humidifier (Auto mode) slider and the Humidity sensor cannot be turned off and will always be exposed.

Via UI:

Via config.json:

{
  "platforms": [
    {
      "name": "Levoit Humidifiers",
      "email": "email",
      "password": "password",
      "platform": "LevoitHumidifiers",
      "accessories": {
        "display": false,
        "sleep_mode": false,
        "cool_mist": false,
        "warm_mist": false,
        "night_light": false
      },
      "options": {
        "showOffWhenDisconnected": false
      }
    }
  ]
}

Note to Seasonal Humidifier Users:

By default, if you disconnect a humidifier from WiFi, it will begin showing as "Not Responding" in HomeKit. Restarting Homebridge will remove the cached device from HomeKit. Once you've re-connected the humidifier, restart Homebridge again for it to display back in HomeKit.

If you prefer the disconnected device to be visible in HomeKit at all times, set showOffWhenDisconnected to true in the config. The humidifiers will remain in HomeKit in an Off state. Note: This will cause benign errors in the Homebridge logs that the device could not be contacted.

Enabling Debug Mode

In the config file, add enableDebugMode: true

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