Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add support for VeSync Humidifiers #25320

Closed
wants to merge 3 commits into from
Closed

Add support for VeSync Humidifiers #25320

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
f88565e
Added humidifier platform for VeSync
kevin-brown Dec 17, 2022
5d22d11
Add list of supported humidifiers and sensors
kevin-brown Dec 17, 2022
cba699a
Made VeSync table style consistent throughout the docs
kevin-brown Dec 17, 2022
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
33 changes: 26 additions & 7 deletions source/_integrations/vesync.markdown
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,7 @@ title: VeSync
description: Instructions on how to set up VeSync switches, outlets, and fans within Home Assistant.
ha_category:
- Fan
- Humidifier
- Light
- Switch
ha_release: 0.66
Expand All @@ -15,6 +16,7 @@ ha_codeowners:
ha_domain: vesync
ha_platforms:
- fan
- humidifier
- light
- sensor
- switch
Expand All @@ -27,10 +29,11 @@ The devices must be added to the VeSync App before this integration can discover

The following platforms are supported:

- **light**
- **switch**
- **fan**
- **humidifier**
- **light**
- **sensor**
- **switch**

## Supported Devices

Expand Down Expand Up @@ -62,6 +65,14 @@ This integration supports devices controllable by the VeSync App. The following
- Core 600S: Smart True HEPA Air Purifier
- LEVOIT Smart Wifi Air Purifier (LV-PUR131S)

### Humidifiers

- Classic 200S: Smart Ultrasonic Cool Mist Humidifier
- Classic 300S: Ultrasonic Smart Humidifier
- Dual 200S: Smart Top-Fill Humidifier
- LV600S: Smart Hybrid Ultrasonic Humidifier
- OasisMist™ Smart Humidifier

## Prerequisite

Before you can use this integration, all devices must be registered with the
Expand All @@ -72,8 +83,8 @@ the configuration section below.

## Services

| Service | Description |
|---------|-------------|
| Service | Description |
|------------------|----------------------------------------------------|
| `update_devices` | Poll Vesync server to find and add any new devices |

## Power & Energy Sensors
Expand All @@ -93,9 +104,9 @@ itself. Note that prior versions of the integration exposed these as state attri
## Fan & Air Quality Sensors
All VeSync air purifiers expose the remaining filter life, and some also expose air quality measurements.

| Sensor | Description | Example |
| --------------------------------------- | ------------------------------------------------------------------ | ------- |
| `filter_life` | Remaining percentage of the filter. (LV-PUR131S, Core200S/300s/400s/600s) | 142 |
| Sensor | Description | Example |
| ----------------------- | -------------------------------------------------------------------------------------- | --------- |
| `filter_life` | Remaining percentage of the filter. (LV-PUR131S, Core200S/300s/400s/600s) | 142 |
| `air_quality` | The current air quality reading. (LV-PUR131S, Core300s/400s/600s) | excellent |
| `pm2_5` | The current air quality reading. (Core300s/400s/600s) | 8 |

Expand All @@ -113,6 +124,14 @@ VeSync air purifiers will expose the following details depending on the features
| `night_light` | The current status of the night light (Core200S/Core400s) | off |
| `child_lock` | The current status of the child lock (Core200S/300s/400s) | off |

## Humidifier Sensors

All VeSync humidifiers will expose the current room's humidity:

| Sensor | Description | Example |
| ----------------------- | --------------------------------------------------------------------------------- | --------------- |
| `humidity` | The current humidity of the room that the device is in. | 50% |

## Extracting Attribute data

In order to get the attributes readings from supported devices, such as voltage from outlets or fan attributes, you'll have to create a [template sensor](/integrations/template#state-based-template-sensors/).
Expand Down