Energy updates (#18708)

* Energy updates

* Tweak

Co-authored-by: Franck Nijhof <git@frenck.dev>

source/_docs/energy/electricity-grid.markdown

@@ -7,17 +7,17 @@ Energy management is all about knowing how much energy you’re consuming, where
 
 Almost all houses are connected to the electricity grid which provides the energy your home will need. The energy usage is being tracked by your energy meter and is billed to you by your energy provider. Energy prices can differ based on a schedule or change according to market price.
 
-<img src='/images/docs/energy/grid.png' alt='Graphic showing energy flowing from the grid to Home Assistant.' style='border: 0;box-shadow: none;'>
+<img src='/images/docs/energy/grid.png' alt='Graphic showing energy flowing from the grid to Home Assistant.' style='border: 0;box-shadow: none; display: block; max-height: 400px; margin: 0 auto;'>
 
 ## Tariffs
 
 It has become popular for energy utilities to split the price of energy based on time of the day; this is done in order to incentivise consumers to shift their power needs towards times where the grid has lower loads. These periods of time are commonly referred to as Peak and Off Peak, exactly because they match periods of time where everyone is consuming energy (Peak) and periods of time where the energy is abundant but no one is using it (Off Peak). Therefore Peak energy is more expensive then Off Peak energy.
 
-If you are using a 3rd party device (e.g. not reading directly from your utility meter device or from the utility provider cloud service) you need HA to split your energy measurements into 2 (or more) tariffs, in order to track these energy consumptions separately. To accomplish such, you might use [the utility_meter integration](/integrations/utility_meter/). With the utility_meter integration you define as many tariffs as required (in accordance to your utility provider contract) and HA will be able to differentiate energy consumptions in each of the tariffs. Please note that each utility provider has their own time schedules for peak and off peak and you are required to create an automation that switches the utility_meter entity from one tariff to the other.
+If you want to split energy usage into multiple tariffs, [read this](/docs/energy/faq/#split-consumption-by-tariffs).
 
 ## Hardware
 
-Home Assistant will need to know the amount of energy flowing through your meter. This can be done in various ways.
+Home Assistant will need to know the amount of energy flowing through your meter. This data can be tracked in various ways.
 
 ### Using a CT clamp sensor
 
@@ -25,9 +25,7 @@ CT clamp sensors measure the instantaneous current passing through an electrical
 
 In Home Assistant we have support for off-the-shelf CT clamp sensors and you can build your own with ESPHome's [CT Clamp Current sensor](https://esphome.io/components/sensor/ct_clamp.html).
 
-The off-the-shelf solution that we advice is the [Shelly EM](https://shop.shelly.cloud/shelly-em-120a-clamp-wifi-smart-home-automation#143). The device has a local API, updates are pushed to Home Assistant and it has a high quality integration.
+The off-the-shelf solution that we advice is the [Shelly EM](https://shop.shelly.cloud/shelly-em-2-x-120a-clamp-wifi-smart-home-automation?tracking=A7FsiPIfUWsFpnfKHa8SRyUYLXjr2hPq). The device has a local API, updates are pushed to Home Assistant and it has a high quality integration.
-
-Devices like Shelly EM/3EM, Iotawatt, Openenergymonitor (EmonPi) measure both current and voltage.
 
 In case of three-phase electrical systems, attention should be drawn to the fact that the current measurement of a given phase is matched to the voltage of the same phase, otherwise the power measurements will be incorrect.
 
@@ -37,20 +35,26 @@ _Attention! Installing CT clamp sensor devices requires opening your electrical
 
 The best way to get this data is directly from your electricity meter that sits between your house and the grid. In certain countries these meters contain standardized ways of reading out the information locally.
 
-### Connect using a P1 port
+#### Connect using a P1 port
 
 The P1 port is a standardized port in the Netherlands, Belgium and Luxembourg. A P1 reader can connect to this port and receive real-time information.
 
-We have worked with creator Marcel Zuidwijk to develop [Slimme Lezer](https://www.slimmelezer.nl). It's a P1 reader powered by ESPHome that will seamlessly integrate this information in Home Assistant. It is being sold on his website.
+We have worked with creator [Marcel Zuidwijk](https://www.zuidwijk.com) to develop [SlimmeLezer](https://www.slimmelezer.nl). It's an affordable P1 reader powered by [ESPHome](https://esphome.io) that will seamlessly integrate this information in Home Assistant. It is being sold on [his website](https://www.slimmelezer.nl) and the firmware is open source [on GitHub](https://github.com/zuidwijk/dsmr).
 
-### Reading the meter via a pulse counter
+![Photo of SlimmeLezer attached to a smart electricity meter](/images/docs/energy/slimmelezer.jpg)
+
+#### Reading the meter via a pulse counter
 
 Many meters, including older ones, have an LED that will flash whenever energy passes through it. For example, each flash is a 1/1000th kWh. By monitoring the time between flashes it’s possible to determine the energy consumption.
 
 We have developed [Home Assistant Glow](https://github.com/klaasnicolaas/home-assistant-glow), an open source solution powered by ESPHome's [pulse meter sensor](https://esphome.io/components/sensor/pulse_meter.html).
 
+![Photo of Home Assistant Glow attached to an electricity meter](/images/docs/energy/home-assistant-glow.jpg)
+
 ### Data provided by your energy provider
 
 Some energy providers will provide you real-time information about your usage and have this data integrated into Home Assistant.
 
+[Energy integrations](/integrations/#energy)
+
 _Disclaimer: Some links on this page are affiliate links._

source/_docs/energy/faq.markdown

@@ -12,3 +12,9 @@ Electrical Power is usually measured in Watts (W) and Electrical Energy is usual
 This difference is very important as you need to use the proper entities and/or convert between the two. Energy (Watt-Hour) is not an average of the Power you are consuming over a given period of time, but the sum of the power function: Power is the derivative of Energy over time.
 
 Think of this in a parallel to speed and distance: Power is the speed you are going and Energy is the distance driven.
+
+## Split consumption by tariffs
+
+If you are using a 3rd party device (e.g. not reading directly from your utility meter device or from the utility provider cloud service) you need HA to split your energy measurements into 2 (or more) tariffs, in order to track these energy consumptions separately.
+
+To accomplish such, you can use [the utility_meter integration](/integrations/utility_meter/). With this integration, you define as many tariffs as required (in accordance with your utility provider contract) and HA will be able to differentiate energy consumptions in each of the tariffs. Please note that each utility provider has its own time schedules for peak and off-peak and you are required to create an automation that switches the utility_meter entity from one tariff to the other.

source/_docs/energy/individual-devices.markdown

@@ -3,10 +3,25 @@ title: "Integrating individual device energy usage"
 description: "Learn how to add information about individual device energy usage to Home Assistant home energy management."
 ---
 
-Home Assistant can integrate the energy usage of individual devices into Home Assistant. This usage is generally measured by a smart plug sitting between the device and the outlet.
+Home Assistant can integrate the energy usage of individual devices into Home Assistant. That way you can see the impact of individual devices on your total enery consumption.
+
+## Hardware
+
+### Smart plugs
+
+Smart plugs sit between the device and the outlet and measure the energy flowing through the device.
 
 Depending on what protocols you use at home, you can use Zigbee, Z-Wave or Wi-Fi based plugs.
 
-<img src='/images/docs/energy/devices.png' alt='Graphic showing energy flowing from the home to individual devices.' style='border: 0;box-shadow: none;'>
+### Smart Relays
+
+Smart relays sit behind your "normal" switches and make them smart. It allows you to control the devices via Home Assistant and via the connected buttons/switches.
+
+We recommend the Shelly brand because they have a local API that updates Home Assistant as soon as something happens and it has a high quality integration:
+
+ - [Shelly 1L](https://shop.shelly.cloud/shelly-1l-wifi-smart-home-automation?tracking=A7FsiPIfUWsFpnfKHa8SRyUYLXjr2hPq)
+ - [Shelly 2.5](https://shop.shelly.cloud/shelly-2.5-ce-ul-wifi-smart-home-automation?tracking=A7FsiPIfUWsFpnfKHa8SRyUYLXjr2hPq)
+
+<img src='/images/docs/energy/devices.png' alt='Graphic showing energy flowing from the home to individual devices.' style='border: 0;box-shadow: none; display: block; max-height: 400px; margin: 0 auto;'>
 
 _Disclaimer: Some links on this page are affiliate links._

source/_docs/energy/solar-panels.markdown

@@ -7,7 +7,7 @@ Gain insight into your energy production by integrating your solar panels into H
 
 If you also set up [the Solar Forecast integration](/integrations/forecast_solar), you will be able to see expected solar production and automate based on planned production.
 
-<img src='/images/docs/energy/solar.png' alt='Graphic showing energy flowing from the solar panels to Home Assistant and back to the grid.' style='border: 0;box-shadow: none;'>
+<img src='/images/docs/energy/solar.png' alt='Graphic showing energy flowing from the solar panels to Home Assistant and back to the grid.' style='border: 0;box-shadow: none; display: block; max-height: 400px; margin: 0 auto;'>
 
 ## Hardware
 
@@ -19,10 +19,12 @@ CT clamp sensors measure the instantaneous current passing through an electrical
 
 In Home Assistant we have support for off-the-shelf CT clamp sensors and you can build your own with ESPHome's [CT Clamp Current sensor](https://esphome.io/components/sensor/ct_clamp.html).
 
-The off-the-shelf solution that we advice is the [Shelly EM](https://shop.shelly.cloud/shelly-em-120a-clamp-wifi-smart-home-automation#143). The device has a local API, updates are pushed to Home Assistant and it has a high quality integration.
+The off-the-shelf solution that we advice is the [Shelly EM](https://shop.shelly.cloud/shelly-em-2-x-120a-clamp-wifi-smart-home-automation?tracking=A7FsiPIfUWsFpnfKHa8SRyUYLXjr2hPq). The device has a local API, updates are pushed to Home Assistant and it has a high quality integration.
-
-Devices like Shelly EM/3EM, Iotawatt, Openenergymonitor (EmonPi) measure both current and voltage.
-
-In case of three-phase electrical systems, attention should be drawn to the fact that the current measurement of a given phase is matched to the voltage of the same phase, otherwise the power measurements will be incorrect.
 
 _Attention! Installing CT clamp sensor devices requires opening your electrical cabinet. This work should be done by someone familiar with electrical wiring. Your qualified installer will know how to do this._
+
+### Connecting to your inverter
+
+Some solar inverters have APIs that can be read by Home Assistant.
+
+[Energy integrations](/integrations/#energy)

source/_includes/asides/docs_navigation.html

@@ -49,6 +49,7 @@
           <li>{% active_link /docs/energy/electricity-grid/ Electricity Grid %}</li>
           <li>{% active_link /docs/energy/solar-panels/ Solar Panels %}</li>
           <li>{% active_link /docs/energy/individual-devices/ Individual Devices %}</li>
+          <li>{% active_link /docs/energy/faq/ FAQ %}</li>
         </ul>
       </li>
       <li>