jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-16 13:56:53 +00:00
Code Issues Packages Projects Releases Wiki Activity

Add support for VeSync Fans (#13590)

Browse Source
This commit is contained in:
Angelo Gagliano 2020-09-04 11:04:36 -04:00 committed by GitHub
parent 395b87a084
commit 143913ae43
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 24 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
source/_integrations/vesync.markdown
View File

@ -1,23 +1,26 @@
---
title: Etekcity VeSync
description: Instructions on how to set up Etekcity VeSync switches and outlets within Home Assistant.
title: VeSync
description: Instructions on how to set up VeSync switches, outlets, and fans within Home Assistant.
ha_category:
- Switch
- Fan
ha_release: 0.66
ha_config_flow: true
ha_codeowners:
- '@markperdue'
- '@webdjoe'
- '@thegardenmonkey'
ha_domain: vesync
---
The `vesync` integration enables you to control Etekcity smart switches and outlets connected to the VeSync App.
The `vesync` integration enables you to control smart switches and outlets connected to the VeSync App.
The devices must be added to the VeSync App before this integration can discover them.
The following platforms are supported:
- **switch**
- **fan**
## Supported Devices
@ -35,6 +38,10 @@ This integration supports devices controllable by the VeSync App. The following
- Etekcity In Wall Smart Switch (EWSL01-USA)
### Fans
- LEVOIT Smart Wifi Air Purifier (LV-PUR131S)
## Configuration
To use this integration, all devices must be registered with the VeSync App. Once registration is complete, you can add the VeSync integration by adding the VeSync integration in the configuration section of the frontend and entering your username and password. You can also use the traditional configuration method by adding the following to your `configuration.yaml` file:
@ -76,6 +83,20 @@ VeSync outlets will expose the following details for only the smart outlets. Ene
| `monthly_energy_total` | Total energy usage for month starting from 12:01AM on the first in kWh | 52.30 |
| `yearly_energy_total` | Total energy usage for year start from 12:01AM on Jan 1 in kWh | 105.25 |
## Fan Exposed Attributes
VeSync air purifiers will expose the following details.
| Attribute | Description | Example |
| ----------------------- | ----------------------------------------------------------------------- | --------------- |
| `mode` | The current mode the device is in. | auto |
| `speed` | The current speed setting of the device. | auto |
| `speed_list` | The available list of speeds supported by the device. | high |
| `active_time` | The number of seconds since the device has been in a non-off mode. | 1598 |
| `filter_life` | Remaining percentage of the filter. | 142 |
| `air_quality` | The current air quality reading. | excellent |
| `screen_status` | The current status of the screen. | on |
## Extracting Attribute data
In order to get the attributes readings from supported devices, such as energy from outlets or fan attributes, you'll have to create a [template sensor](/integrations/switch.template/).