Adapt documentation of kostal plenticore to match changes in core. (home-assistant#29811)

stegm · c0ffeeca7 · web-flow · commit 92fcec1a8fc1 · 2023-11-29T14:50:42.000+01:00
* Change documentation to change of core.

* Add style to new text.

* tiny tweaks

---------

Co-authored-by: c0ffeeca7 &lt;38767475+c0ffeeca7@users.noreply.github.com&gt;
diff --git a/source/_integrations/kostal_plenticore.markdown b/source/_integrations/kostal_plenticore.markdown
@@ -39,7 +39,7 @@ The following sensors are available in the library:
 | Name                    | Unit | Description   |
 |-------------------------|------|:-------------------------------------------|
 | Inverter State          |      | State of the inverter. |
-| Solar Power             | W    | Sum of all DC strings. |
+| Solar Power             | W    | Sum of all DC strings (including battery). |
 | Grid Power              | W    | Power from (+)/to (-) the grid. |
 | Home Power from Battery | W    | Power from the battery for home consumption. |
 | Home Power from Grid    | W    | Power from the grid for home consumption. |
@@ -108,42 +108,37 @@ The following sensors are available in the library:
 | Battery Charge from Grid Month  | kWh  | Energy charged to the battery from the Grid of the current month. |
 | Battery Charge from Grid Year   | kWh  | Energy charged to the battery from the Grid of the current year. |
 | Battery Charge from Grid Total  | kWh  | Energy charged to the battery from the Grid total. |
-| Battery Charge from PV Day    | kWh  | Energy charged to the battery from the PV of the current day. |
-| Battery Charge from PV Month  | kWh  | Energy charged to the battery from the PV of the current month. |
-| Battery Charge from PV Year   | kWh  | Energy charged to the battery from the PV of the current year. |
-| Battery Charge from PV Total  | kWh  | Energy charged to the battery from the PV total. |
+| Battery Charge from PV Day    | kWh  | Energy to the battery on the DC side charged by PV during the current day. |
+| Battery Charge from PV Month  | kWh  | Energy to the battery on the DC side charged by PV during the current month. |
+| Battery Charge from PV Year   | kWh  | Energy to the battery on the DC side charged by PV during the current year. |
+| Battery Charge from PV Total  | kWh  | Energy to the battery on the DC side charged by PV  total. |
+| Battery Discharge Day | kWh | Energy from the battery on the DC side discharged during the current day. |
+| Battery Discharge Month | kWh | Energy from PV on DC-side used to charge the battery of the current month. |
+| Battery Discharge Year | kWh | Energy from PV on DC-side used to charge the battery of the current year. |
+| Battery Discharge Total | kWh | Energy from PV on DC-side used to charge the battery total. |
+| Energy to Grid Day | kWh | Energy fed into the grid for the current day. |
+| Energy to Grid Month | kWh | Energy fed into the grid for the current month. |
+| Energy to Grid Year | kWh | Energy fed into the grid for the current year. |
+| Energy to Grid Total | kWh | Energy fed into the grid in total, since the system was installed. |
+| Sum power of all PV DC inputs | W | Total sum of power provided by all PV inputs together. |
 
 <div class='note'>
-The inverter does not provide any data on the energy that is going to the grid directly.
+The inverter does not provide any data about the energy that is fed into the grid directly, but the `pykoplenti` library provides it via virtual process data.
 </div>
 
-#### Common template sensors
-
-##### Energy to grid total
-
-{% raw %}
-
-```yaml
-template:
-  - sensor:
-    - name: "Plenticore Energy PV to Grid Total (Template)"
-      unit_of_measurement: "kWh"
-      device_class: energy
-      state_class: total
-      state: >
-        {% set yield = states('sensor.scb_energy_yield_total') | float %}
-        {% set batteryToHome = states('sensor.scb_home_consumption_from_battery_total') | float %}
-        {% set pvToHome = states('sensor.scb_home_consumption_from_pv_total') | float %}
-        {{ yield - pvToHome - batteryToHome }}
-```
-
-The `sensor.scb_energy_yield_total` entity contains the total energy. This includes
-both the energy delivered to the home as well as the energy from the battery to the
-home. Think of it like all energy that leaves the inverter on the AC side.
-Hence, to calculate the amount of energy flowing into the grid, you have to subtract the energy from the battery and PV to the
-home.
-
-{% endraw %}
+#### Configuration of the energy dashboard
+
+The following sensors can be used in the [energy dashboard](/docs/energy/):
+
+| Energy dashboard | Sensor |
+|------------------|:-------|
+| Grid consumption | Home Consumption from Grid Total |
+| Solar production | Energy PV1 Total, Energy PV2 Total, Energy PV3 Total |
+| Battery systems  | Battery Discharge Total, Battery Charge from PV Total |
+
+<div class='note'>
+Some of the energy is measured on the DC side and some on the AC side, so the values may differ slightly due to losses between DC and AC.
+</div>
 
 ### Settings Sensors
 
