diff --git a/source/_docs/energy.markdown b/source/_docs/energy.markdown index 9d59a7c45327..cb3ef2aea651 100644 --- a/source/_docs/energy.markdown +++ b/source/_docs/energy.markdown @@ -20,4 +20,6 @@ Home Assistant is an open platform and so home energy management is not restrict If you have a sensor that returns instantaneous power readings (W or kW), then to add a sensor that returns energy usage or generation (kWh), refer to the [Riemann sum integral integration](/integrations/integration/#energy). +You can also configure power sensors alongside energy sensors in the Energy dashboard. Power inputs accept sensors with `state_class: measurement` and appropriate units (for example `W` or `kW`). + Visual representation of how all different energy forms relate. diff --git a/source/_docs/energy/electricity-grid.markdown b/source/_docs/energy/electricity-grid.markdown index 226399590809..58955c94455d 100644 --- a/source/_docs/energy/electricity-grid.markdown +++ b/source/_docs/energy/electricity-grid.markdown @@ -75,7 +75,7 @@ If you manually integrate your sensors, for example, using the [MQTT](/integrati ### Troubleshooting -If you are unable to select your energy sensor in the grid consumption drop-down, make sure that its value is being recorded in the Recorder settings. +If you are unable to select your energy or power sensor in the grid consumption drop-down, make sure that its value is being recorded in the Recorder settings. [Energy integrations](/integrations/#energy) diff --git a/source/_docs/energy/faq.markdown b/source/_docs/energy/faq.markdown index 2c6a524d865d..b5c07bfeace5 100644 --- a/source/_docs/energy/faq.markdown +++ b/source/_docs/energy/faq.markdown @@ -42,12 +42,13 @@ You are trying to add a sensor to the energy dashboard, but it does not appear i ### Resolution To find out why the sensor is not showing, check the following points: + - The sensor must have the appropriate attributes. Check your entity attributes in {% my developer_states title="**Developer Tools** > **States**" %} to confirm the following: - - `device_class` must be `energy` for electricity grid, solar, or battery categories. It must be `gas` for gas, or `water` for water. - - `state_class` must be `total` or `total_increasing`. + - `device_class` must be `energy` or `power` for electricity grid, solar, or battery categories. It must be `gas` for gas, or `water` for water. + - `state_class` must be `measurement` for power sensors and `total` or `total_increasing` for all others. - The sensor must have an appropriate `unit_of_measurement`. See the help text for each category to see which units are accepted. Units containing an exponent must match superscript characters exactly as defined, e.g. `m³` is accepted, `m3` is not. If any of the attributes are not correct, please open an issue against the integration that provides your sensor, or if you are developing custom template sensors, make sure the templates have the correct settings. - + - The entity must be a `sensor`. If you are trying to add something from another domain (for example an `input_number`), then you must first create a template sensor from it. - The entity must not have any statistics errors. Go to {% my developer_statistics title="**Developer Tools** > **Statistics**" %} to check your specific entity. If your unit has a listed issue here, you must fix the issue before it can be added to the dashboard. diff --git a/source/_docs/energy/individual-devices.markdown b/source/_docs/energy/individual-devices.markdown index 9a2c734ee24b..6e3806737989 100644 --- a/source/_docs/energy/individual-devices.markdown +++ b/source/_docs/energy/individual-devices.markdown @@ -19,7 +19,7 @@ Smart relays sit behind your "normal" switches and make them smart. It allows yo ## Devices with power (W) sensors -Some smart devices, such as air conditioning, boilers, and others, may provide a power sensor, measured in Watts. You can use the [Integration (Riemann sum integral) integration](/integrations/integration/#energy) to calculate the energy your device is using. You can then use the energy sensor in the Energy Dashboard, as individual devices. For information on setting up an entity for use in the **Energy** dashboard, refer to the [energy FAQ](/docs/energy/faq/#troubleshooting-missing-entities). +Some smart devices, such as air conditioning, boilers, and others, may provide a power sensor, measured in Watts. You can use the [Integration (Riemann sum integral) integration](/integrations/integration/#energy) to calculate the energy your device is using. You can then use the energy sensor in the Energy Dashboard, as individual devices. You can add the power sensor directly if it has the appropriate attributes. For information on setting up an entity for use in the **Energy** dashboard, refer to the [energy FAQ](/docs/energy/faq/#troubleshooting-missing-entities). Graphic showing energy flowing from the home to individual devices.