home-assistant.io/source/_integrations/vesync.markdown

title, description, ha_category, ha_release, ha_iot_class, ha_config_flow, ha_codeowners, ha_domain, ha_platforms, ha_integration_type

title	description	ha_category	ha_release	ha_iot_class	ha_config_flow	ha_codeowners	ha_domain	ha_platforms	ha_integration_type
VeSync	Instructions on how to set up VeSync switches, outlets, and fans within Home Assistant.	Fan Light Number Switch	0.66	Cloud Polling	true	@markperdue @webdjoe @thegardenmonkey @cdnninja @iprak	vesync	binary_sensor diagnostics fan humidifier light number sensor switch	integration

The VeSync {% term 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 {% term integration %} can discover them.

The following platforms are supported:

• fan
• humidifier
• light
• number
• sensor
• switch

Supported devices

This {% term integration %} supports devices controllable by the VeSync App. The following devices are supported by this {% term integration %}:

Bulbs

• Etekcity WiFi Dimmable LED Bulb (ESL100)
• Etekcity WiFi Dimmable and Tunable White LED Bulb (ESL100CW)

Wall switches

• Etekcity In Wall Smart Switch (EWSL01-USA)
• Etekcity Wifi Dimmer Switch (ESD16)
• Etekcity Wifi Dimmer Switch (ESWD16)

Outlet plugs

• Etekcity 7 Amp US outlet - ESW01-USA (Round)
• Etekcity 10 Amp US outlet - ESW10-USA (Round)
• Etekcity 10 Amp EU outlet - ESW10-EU (Round)
• Etekcity 15 Amp US outlet - ESW15-USA (Rectangular)
• Etekcity 2 Plug Outdoor Outlet - ESO15-TB

Fans

• Core 200S: Smart True HEPA Air Purifier
• Core 300S: Smart True HEPA Air Purifier
• Core 400S: Smart True HEPA Air Purifier
• Core 600S: Smart True HEPA Air Purifier
• EverestAir: Smart Air Purifier
• Vital 100S Smart True HEPA Air Purifier (LAP-V102S-WUS)
• Vital 200S Smart True HEPA Air Purifier (LAP-V201S-WUS)
• LEVOIT Smart Wifi Air Purifier (LV-PUR131S)
• LEVOIT Smart Tower Fan (LTF-F422S-WUS)

Humidifiers

• Classic200S: Classic 200S Smart Ultrasonic Cool Mist Humidifier
• Classic300S: Classic 300S Ultrasonic Smart Humidifier

Prerequisite

Before you can use this {% term integration %}, all devices must be registered with the VeSync App. Once registration is complete, continue with the steps described in the configuration section below.

{% include integrations/config_flow.md %}

Actions

Action	Description
update_devices	Poll Vesync server to find and add any new devices

Power & energy sensors

Many VeSync outlets support power & energy monitoring. This data is exposed as sensor entities alongside the outlet itself. Note that prior versions of the {% term integration %} exposed these as state attributes on the outlet switch {% term entity %}.

Sensor	Description	Example
sensor.<outlet name>_current_power	The present power consumption of the switch in watts	7.89
sensor.<outlet name>_energy_use_today	The kilowatt hours used by the switch during the previous 24 hours	0.12
sensor.<outlet name>_voltage	The present voltage of the switch in Volts as a diagnostic sensor	120.32
sensor.<outlet name>_energy_use_weekly	Total energy usage for week starting from Monday 12:01AM in kWh	14.74
sensor.<outlet name>_energy_use_monthly	Total energy usage for month starting from 12:01AM on the first in kWh	52.30
sensor.<outlet name>_energy_use_yearly	Total energy usage for year start from 12:01AM on Jan 1 in kWh	105.25

Fan & air quality sensors

All VeSync air purifiers expose the remaining filter lifetime, and some also expose air quality measurements.

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

Fan exposed attributes

VeSync air purifiers will expose the following details depending on the features supported by the model:

Attribute	Description	Example
mode	The current mode the device is in. (LV-PUR131S, Core200S/300s/400s)	manual
speed	The current speed setting of the device. (LV-PUR131S, Core200S/300s/400s)	high
speed_list	The available list of speeds supported by the device. (LV-PUR131S)	high
active_time	The number of seconds since the device has been in a non-off mode. (LV-PUR131S)	1598
screen_status	The current status of the screen. (LV-PUR131S)	on
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 and settings exposed by VeSync humidifiers.

Sensor	Description	Example
humidity	Current humidity (in %)	35

Number	Description	Example
mist_level	Mist level intensity (Range: 1-9, Step: 1)	1

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.

In the example below, change all of the vesync_switch's to match your device's entity ID.

Adapted from the TP-Link integration.

{% raw %}

template:
  - sensor:
    - name: "Vesync voltage"
      state: "{{ state_attr('switch.vesync_switch', 'voltage') | float(default=0) }}"
      unit_of_measurement: "V"

{% endraw %}