From 2d23eb2fca017d66cf7f605fc5b7b6200608171b Mon Sep 17 00:00:00 2001
From: Jesse Rizzo <32472573+jesserizzo@users.noreply.github.com>
Date: Thu, 2 Aug 2018 18:45:11 -0500
Subject: [PATCH] Add documentation for new Enphase Envoy platform (#5638)

* Create documentation for Enphase Envoy component

* Add list of available conditions

* Upload Enphase logo

* Add second example configuration.yaml

* Fix minor formatting errors

* Fix configuration variables section

* Fix minor typo

* :pencil2: Removed duplicate header

* Changed ip to ip_address

* Minor fixes

Change title to sensor.enphase_envoy. Update version number. Fix typo in enphase logo file name.

* Remove name key from configuration
---
 .../_components/sensor.enphase_envoy.markdown | 55 +++++++++++++++++++
 .../images/supported_brands/enphase-logo.svg  |  1 +
 2 files changed, 56 insertions(+)
 create mode 100644 source/_components/sensor.enphase_envoy.markdown
 create mode 100644 source/images/supported_brands/enphase-logo.svg

diff --git a/source/_components/sensor.enphase_envoy.markdown b/source/_components/sensor.enphase_envoy.markdown
new file mode 100644
index 00000000000..fb04d906ed4
--- /dev/null
+++ b/source/_components/sensor.enphase_envoy.markdown
@@ -0,0 +1,55 @@
+---
+layout: page
+title: "Enphase Envoy"
+description: "Instructions on how to setup Enphase Envoy with Home Assistant."
+date: 2018-06-30 12:30
+sidebar: true
+comments: false
+sharing: true
+footer: true
+logo: enphase-logo.svg
+ha_category: Energy
+ha_release: 0.76
+ha_iot_class: "Local Polling"
+---
+
+A sensor platform for the [Enphase Envoy](https://enphase.com/en-us/products-and-services/envoy) solar energy monitor.
+
+### {% linkable_title Configuration %}
+
+To enable this sensor, add the following lines to your `configuration.yaml` file:
+
+```yaml
+# Example configuration.yaml entry
+sensor:
+  - platform: enphase_envoy
+    ip_address: ENVOY_LOCAL_IP_ADDRESS
+```
+
+{% configuration %}
+ip_address:
+  description: The local IP Address of your Envoy
+  required: true
+  type: string
+monitored_conditions:
+  description: The list of conditions to monitor
+  required: false
+  type: list
+  keys:
+    production:
+      description: The power in W being produced by the solar panels
+    daily_production:
+      description: The energy in Wh produced that day
+    7_days_production:
+      description: The energy in Wh produced the last 7 days
+    lifetime_production:
+      description: The energy in Wh produced in the lifetime of the Envoy
+    consumption:
+      description: The power in W being consumed in the whole house
+    daily_consumption:
+      description: The energy in Wh consumed that day
+    7_days_consumption:
+      description: The energy in Wh consumed the last 7 days
+    lifetime_consumption:
+      description: The energy in Wh consumed in the lifetime of the Envoy
+{% endconfiguration %}
diff --git a/source/images/supported_brands/enphase-logo.svg b/source/images/supported_brands/enphase-logo.svg
new file mode 100644
index 00000000000..3f8f7b3de38
--- /dev/null
+++ b/source/images/supported_brands/enphase-logo.svg
@@ -0,0 +1 @@
+<svg id="Layer_1" data-name="Layer 1" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 280 54.2"><defs><style>.cls-1{fill:#f37321;}.cls-2{fill:#4c4c4c;}</style></defs><title>Artboard 1</title><path class="cls-1" d="M24.27,52A24.64,24.64,0,0,1,2,37.89a3,3,0,1,1,5.43-2.58,18.66,18.66,0,0,0,33.74,0,3,3,0,1,1,5.44,2.57A24.61,24.61,0,0,1,25.3,52Z"/><path class="cls-1" d="M45.53,29.84H3a3,3,0,0,1,0-6H42.28a18.66,18.66,0,0,0-34.93-5.6A3,3,0,0,1,2,15.43a24.67,24.67,0,0,1,46.52,11.4,3,3,0,0,1-3,3Z"/><path class="cls-2" d="M84.81,37.85H69V29.13H80.23a2.72,2.72,0,1,0,0-5.44H69V16.15H83.66a2.72,2.72,0,1,0,0-5.44H66.31a2.72,2.72,0,0,0-2.72,2.72h0V40.57a2.72,2.72,0,0,0,2.72,2.72h18.5a2.72,2.72,0,0,0,0-5.44Z"/><path class="cls-2" d="M276.28,37.85H260.51V29.13H271.7a2.72,2.72,0,1,0,0-5.44H260.51V16.15h14.63a2.72,2.72,0,1,0,0-5.44H257.79a2.72,2.72,0,0,0-2.72,2.72h0V40.57a2.72,2.72,0,0,0,2.72,2.72h18.49a2.72,2.72,0,1,0,0-5.44Z"/><path class="cls-2" d="M220,39.52l-3.15-7.46h0L208.56,12.4v-.08l-.07-.14-.06-.11-.07-.12-.08-.11-.08-.1-.09-.1-.09-.1-.1-.09-.1-.09-.1-.08-.11-.08-.12-.07-.11-.07-.14-.07h-.09l-.15-.05h-.23a2.7,2.7,0,0,0-.57-.08h-.15a2.7,2.7,0,0,0-.62.09H205l-.13.06-.12.07-.11.07-.12.09-.1.07-.11.09-.09.08-.09.1-.09.1-.08.11-.08.11-.07.12-.06.11-.07.14v.08L195.2,32h0L192,39.52a2.72,2.72,0,1,0,5,2.11l2.45-5.81h13l2.45,5.81a2.72,2.72,0,0,0,5-2.11Zm-18.2-9.13,4.2-10,4.2,10Z"/><path class="cls-2" d="M118.33,43.29h-.69a2.72,2.72,0,0,1-2.14-1L98.6,20.6v20a2.72,2.72,0,0,1-5.44,0V13.43a2.72,2.72,0,0,1,2.72-2.72h.57a2.72,2.72,0,0,1,2.14,1l17,21.8V13.43a2.72,2.72,0,0,1,5.44,0V40.57A2.72,2.72,0,0,1,118.33,43.29Z"/><path class="cls-2" d="M183.49,10.71a2.72,2.72,0,0,0-2.72,2.72h0V23.69H165.26V13.43a2.72,2.72,0,1,0-5.44,0v13h0V40.57a2.72,2.72,0,1,0,5.44,0V29.13h15.51V40.57a2.72,2.72,0,0,0,5.44,0V13.43A2.72,2.72,0,0,0,183.49,10.71Z"/><path class="cls-2" d="M236.25,43.89A16.14,16.14,0,0,1,225,39.37a2.72,2.72,0,0,1,3.84-3.85A10.47,10.47,0,0,0,239,38a4.06,4.06,0,0,0,3.05-3.09c.23-1.53-.6-3-5.4-5l-1.17-.52c-.34-.16-.66-.29-1.13-.48-3-1.22-9.38-3.76-9.26-9.63a8.76,8.76,0,0,1,5.8-8,14.55,14.55,0,0,1,15.27,3.37,2.72,2.72,0,1,1-3.73,4l-.11-.11a9.09,9.09,0,0,0-9.39-2.18,3.32,3.32,0,0,0-2.4,3.09c0,2.11,3.79,3.65,5.85,4.47.6.24,1.12.45,1.54.66l.88.39c2.89,1.24,9.65,4.15,8.63,10.86a9.32,9.32,0,0,1-6.73,7.44A14.27,14.27,0,0,1,236.25,43.89Z"/><path class="cls-2" d="M132.33,43.29a2.72,2.72,0,0,1-2.72-2.72h0V13.43a2.72,2.72,0,0,1,2.72-2.72H143.5c6.09,0,10.5,4.29,10.5,10.16S149.59,31,143.5,31H135v9.54A2.72,2.72,0,0,1,132.33,43.29ZM135,25.6h8.45c3.09,0,5.09-1.86,5.09-4.73s-2-4.73-5.09-4.73H135Z"/></svg>
\ No newline at end of file