add VeSync voltage and yearly, weekly, montly energy sensors (#22990)

Co-authored-by: Martin Hjelmare <marhje52@gmail.com>
Co-authored-by: Franck Nijhof <frenck@frenck.nl>
This commit is contained in:
b3nj1 2022-06-09 02:47:54 -07:00 committed by GitHub
parent bf09990dae
commit b12bf81378
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -78,24 +78,17 @@ the configuration section below.
## Power & Energy Sensors ## Power & Energy Sensors
Many VeSync outlets support power & energy monitoring. These data are exposed as diagnostic sensor entities alongside the outlet Many VeSync outlets support power & energy monitoring. This data is exposed as sensor entities alongside the outlet
itself. Note that prior versions of the integration exposed these as state attributes on the outlet switch entity. itself. Note that prior versions of the integration exposed these as state attributes on the outlet switch entity.
| Sensor | Description | Example | | Sensor | Description | Example |
| --------------------------------------- | ------------------------------------------------------------------ | ------- | | ------------------------------------------|-------------------------------------------------------------------------|---------|
| `sensor.<outlet name>_current_power` | The present power consumption of the switch in watts | 7.89 | | `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>_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 |
## Outlet Exposed Attributes | `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 |
VeSync outlets will expose the following details for only the smart outlets. Energy monitoring not available for in-wall switches. | `sensor.<outlet name>_energy_use_yearly` | Total energy usage for year start from 12:01AM on Jan 1 in kWh | 105.25 |
| Attribute | Description | Example |
| ----------------------- | ----------------------------------------------------------------------- | --------------- |
| `voltage` | Current voltage of the device | 120.32 |
| `weekly_energy_total` | Total energy usage for week starting from Monday 12:01AM in kWh | 14.74 |
| `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 & Air Quality Sensors ## Fan & Air Quality Sensors
All VeSync air purifiers expose the remaining filter life, and some also expose air quality measurements. All VeSync air purifiers expose the remaining filter life, and some also expose air quality measurements.