esphome-docs/components/sensor/total_daily_energy.rst

74 lines
2.3 KiB
ReStructuredText
Raw Normal View History

Total Daily Energy Sensor
=========================
2018-11-14 22:12:27 +01:00
.. seo::
:description: Instructions for setting up sensors that track the total daily energy usage per day and accumulate the power usage.
:image: sigma.png
2018-11-14 22:12:27 +01:00
The ``total_daily_energy`` sensor is a helper sensor that can use the energy value of
2021-08-16 02:02:25 +02:00
other sensors like the :doc:`HLW8012 <hlw8012>`, :doc:`CSE7766 <cse7766>`, :doc:`ATM90E32 <atm90e32>`, etc and integrate
it over time.
So this component allows you to convert readings in ``W`` or ``kW`` to readings of the total
daily energy usage in ``Wh`` or ``kWh``.
.. code-block:: yaml
# Example configuration entry
sensor:
- platform: total_daily_energy
name: "Total Daily Energy"
power_id: my_power
# The power sensor to convert, can be any power sensor
- platform: hlw8012
# ...
power:
id: my_power
# Enable time component to reset energy at midnight
time:
- platform: sntp
id: my_time
Configuration variables:
------------------------
- **power_id** (**Required**, :ref:`config-id`): The ID of the power sensor
to integrate over time.
- **name** (**Required**, string): The name of the sensor.
- **id** (*Optional*, :ref:`config-id`): Manually specify the ID used for code generation.
- **min_save_interval** (*Optional*, :ref:`config-time`): The minimum time span between saving updated values to storage. This is to keep wearout of memory low. Defaults to ``0s``.
- **method** (*Optional*, string): The method to use for calculating the total daily energy. One of
``trapezoid``, ``left`` or ``right``. Defaults to ``right``.
2019-02-17 12:28:17 +01:00
- All other options from :ref:`Sensor <config-sensor>`.
Converting from W to kW
-----------------------
Some sensors such as the :doc:`HLW8012 <hlw8012>` expose their power sensor with a unit of measurement of
``W``. To have your readings in ``kW``, use a filter:
2018-12-05 10:23:02 +01:00
.. code-block:: yaml
sensor:
# The power sensor to convert, can be any power sensor
- platform: hlw8012
# ...
power:
id: my_power
filters:
# Multiplication factor from W to kW is 0.001
- multiply: 0.001
unit_of_measurement: kW
See Also
--------
- :ref:`sensor-filters`
- :doc:`hlw8012`
- :doc:`cse7766`
- :doc:`/cookbook/power_meter`
2019-05-12 22:44:59 +02:00
- :apiref:`total_daily_energy/total_daily_energy.h`
- :ghedit:`Edit`