From 899fea9e442ddb2294517c37a16756c0ce0c9c0a Mon Sep 17 00:00:00 2001 From: Franck Nijhof Date: Wed, 16 Apr 2025 15:59:54 +0000 Subject: [PATCH 1/3] Document and clarify upstream devices and hierachies --- source/_docs/energy/individual-devices.markdown | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/source/_docs/energy/individual-devices.markdown b/source/_docs/energy/individual-devices.markdown index ec6222a18c22..e951d0b5627e 100644 --- a/source/_docs/energy/individual-devices.markdown +++ b/source/_docs/energy/individual-devices.markdown @@ -22,3 +22,20 @@ Smart relays sit behind your "normal" switches and make them smart. It allows yo 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). Graphic showing energy flowing from the home to individual devices. + +## Upstream devices and hierarchies + +You can create a hierarchy of devices by setting one device as an "upstream device" of another. This means you can now create a device hierarchy within your energy configuration, establishing parent-child relationships between devices. + +For example, imagine having a breaker monitoring the total energy consumption of a circuit, but also separately tracking individual devices connected to that circuit. With setting the device hierarchies Home Assistant might double-count this usage–by setting the hierarchy, it understands these relationships and accurately shows the individual device usage without duplication. + +To set up an upstream device relationship: + +1. Add an energy consumption entity as an individual device. +2. Then, when configuring other individual devices, you can select the previously added individual entity as their upstream device. + +This hierarchical view helps you understand which devices are consuming power from which sources and prevents energy from being counted multiple times. + +{% important %} +To set up a hierarchy, you must first add all related entities as individual devices in the energy dashboard. Only devices that are already listed under individual devices can be selected as "upstream device" for other devices. +{% endimportant %} From 1216ac57f1d74fa31c8e5dee0c7918289995a16d Mon Sep 17 00:00:00 2001 From: Franck Nijhof Date: Wed, 16 Apr 2025 18:01:47 +0200 Subject: [PATCH 2/3] Update source/_docs/energy/individual-devices.markdown Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- source/_docs/energy/individual-devices.markdown | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/source/_docs/energy/individual-devices.markdown b/source/_docs/energy/individual-devices.markdown index e951d0b5627e..94a68daa1c4f 100644 --- a/source/_docs/energy/individual-devices.markdown +++ b/source/_docs/energy/individual-devices.markdown @@ -27,8 +27,7 @@ Some smart devices, such as air conditioning, boilers, and others, may provide a You can create a hierarchy of devices by setting one device as an "upstream device" of another. This means you can now create a device hierarchy within your energy configuration, establishing parent-child relationships between devices. -For example, imagine having a breaker monitoring the total energy consumption of a circuit, but also separately tracking individual devices connected to that circuit. With setting the device hierarchies Home Assistant might double-count this usage–by setting the hierarchy, it understands these relationships and accurately shows the individual device usage without duplication. - +For example, imagine having a breaker monitoring the total energy consumption of a circuit, but also separately tracking individual devices connected to that circuit. Without setting the device hierarchies, Home Assistant might double-count this usage. By setting the hierarchy, it understands these relationships and accurately shows the individual device usage without duplication. To set up an upstream device relationship: 1. Add an energy consumption entity as an individual device. From be421701d2ee5fe57795f0d9290708cc05732579 Mon Sep 17 00:00:00 2001 From: Franck Nijhof Date: Wed, 16 Apr 2025 20:11:26 +0200 Subject: [PATCH 3/3] Update individual-devices.markdown MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Abílio Costa --- source/_docs/energy/individual-devices.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_docs/energy/individual-devices.markdown b/source/_docs/energy/individual-devices.markdown index 94a68daa1c4f..9a2c734ee24b 100644 --- a/source/_docs/energy/individual-devices.markdown +++ b/source/_docs/energy/individual-devices.markdown @@ -25,7 +25,7 @@ Some smart devices, such as air conditioning, boilers, and others, may provide a ## Upstream devices and hierarchies -You can create a hierarchy of devices by setting one device as an "upstream device" of another. This means you can now create a device hierarchy within your energy configuration, establishing parent-child relationships between devices. +You can create a hierarchy of devices by setting one device as an "upstream device" of another. This means you can now establish parent-child relationships between devices within your energy configuration. For example, imagine having a breaker monitoring the total energy consumption of a circuit, but also separately tracking individual devices connected to that circuit. Without setting the device hierarchies, Home Assistant might double-count this usage. By setting the hierarchy, it understands these relationships and accurately shows the individual device usage without duplication. To set up an upstream device relationship: