From 274827891d30bfdeb98381d3133fe078e51b8352 Mon Sep 17 00:00:00 2001
From: Johan du Plessis <johan@epicwin.co.za>
Date: Thu, 14 Nov 2024 13:15:02 +0000
Subject: [PATCH 1/2] Documentation for Victron Venus based integration. Ref
 Pull Request #130505 in core.

---
 source/_integrations/victronvenus.markdown | 74 ++++++++++++++++++++++
 1 file changed, 74 insertions(+)
 create mode 100644 source/_integrations/victronvenus.markdown

diff --git a/source/_integrations/victronvenus.markdown b/source/_integrations/victronvenus.markdown
new file mode 100644
index 000000000000..51759f65f653
--- /dev/null
+++ b/source/_integrations/victronvenus.markdown
@@ -0,0 +1,74 @@
+---
+title: "Victron Venus OS Integration"
+description: "Documentation for the Victron Venus integration"
+ha_release: "next"
+ha_category: Sensor
+ha_iot_class: "Local Push"
+ha_config_flow: true
+ha_codeowners:
+  - '@JohansLab'
+ha_domain: victronvenus
+
+---
+
+The Victron Venus OS integration allows connection to a Venus Victron OS device
+ that has local MQTT enabled. This add-on will automatically configure the
+  integration through UPnP/Simple Service Discovery Protocol if possible.
+
+### List of exposes sensors
+
+#### Grid Sensors
+
+- The number of grid phases e.g. 1 for single-phase, or 3 for three-phase.
+If there is a grid failure then the number of phases will be 0. This can be used
+detect grid failure.
+- The AC voltage, current and power for each of the available grid phases.
+- The combined voltage, current and power for the combined grid input.
+- The lifetime running total of all energy consumed from the grid, or fed back
+to the grid. These figures generally only makes sense as delta values.
+
+#### Solar Panels
+
+- The DC voltage, current and power of the solar panels.
+- The lifetime running total yield of the solar panels. These figures generally
+only makes sense as delta values.
+- The maximum power produced by the solar panels for the current day.
+
+#### Batteries
+
+- The DC voltage, current and power of the batteries.
+- The temperature of the battery.
+- The lifetime running total of energy charged and discharged from the battery.
+These figures generally only makes sense as delta values.
+- The current capacity and installed capacity of the batteries in Ampere-Hours (Ah).
+- The state of charge of the batteries.
+
+#### Consumption
+
+- The AC Load in watts on the inverter input.
+- The Critical Loads in watts on the inverter output.
+
+### Enabling local MQTT on a Victron Venus device
+
+If your Victron Venus device is not automatically detected ensure that MQTT on
+LAN is enabled. To enable MQTT on your device the following instructions can be
+followed (as tested on a Cerbo GX):
+
+- Connect to your device using a browser. By default the device should be
+ available at [http://venus.local.](http://venus.local./).
+- In the menu navigate to Settings > Services and ensure MQTT on LAN is switched
+ on.
+
+### Limitations
+
+The integration currently has the following limitations:
+
+- The integration was built and tested against an installation consisting of a
+single-phase grid-tied Multiplus Inverter, with a single MPPT Solar Charger and
+a battery that contains its own BMS. Your installation might have a different
+configuration.
+- The integration does not currently support generators and other configuration
+ options.
+- The integration currently only exposes sensors, it does not yet allow changing
+settings from Home Assistant.
+- This integration was not tested with MQTT with SSL.

From 0349389b22a648c9b2dbe032d2d8ab0fe2f1dc3b Mon Sep 17 00:00:00 2001
From: Johan du Plessis <johan@epicwin.co.za>
Date: Thu, 14 Nov 2024 13:23:32 +0000
Subject: [PATCH 2/2] Fix ha_release.

---
 source/_integrations/victronvenus.markdown | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/source/_integrations/victronvenus.markdown b/source/_integrations/victronvenus.markdown
index 51759f65f653..2f0f308df4d3 100644
--- a/source/_integrations/victronvenus.markdown
+++ b/source/_integrations/victronvenus.markdown
@@ -1,7 +1,7 @@
 ---
 title: "Victron Venus OS Integration"
 description: "Documentation for the Victron Venus integration"
-ha_release: "next"
+ha_release: "2024.12"
 ha_category: Sensor
 ha_iot_class: "Local Push"
 ha_config_flow: true