From 2bf8e2135ba4d0892c8ee7b9204beee035d61280 Mon Sep 17 00:00:00 2001
From: Jonathan Keljo <jkeljo@users.noreply.github.com>
Date: Thu, 1 Nov 2018 04:39:06 -0700
Subject: [PATCH] GreenEye Monitor component docs (#6177)

* GreenEye Monitor component docs

* Update for consolidation of sensor components

* Apply suggested changes

* :fire: Removed featured tag
---
 source/_components/greeneye_monitor.markdown  | 126 ++++++++++++++++++
 .../sensor.greeneye_monitor.markdown          |  18 +++
 source/images/supported_brands/brultech.png   | Bin 0 -> 8783 bytes
 3 files changed, 144 insertions(+)
 create mode 100644 source/_components/greeneye_monitor.markdown
 create mode 100644 source/_components/sensor.greeneye_monitor.markdown
 create mode 100644 source/images/supported_brands/brultech.png

diff --git a/source/_components/greeneye_monitor.markdown b/source/_components/greeneye_monitor.markdown
new file mode 100644
index 00000000000..596751358d5
--- /dev/null
+++ b/source/_components/greeneye_monitor.markdown
@@ -0,0 +1,126 @@
+---
+layout: page
+title: "GreenEye Monitor"
+description: "Instructions on how to integrate your GreenEye Monitor within Home Assistant."
+date: 2018-09-02 11:15
+sidebar: true
+comments: false
+sharing: true
+footer: true
+logo: brultech.png
+ha_category: Hub
+ha_release: 0.82
+ha_iot_class: "Local Push"
+---
+
+The [GreenEye Monitor (GEM)](http://www.brultech.com/greeneye/) integration for Home Assistant allows you to create sensors for the various data channels of the GEM. Each current transformer (CT) channel, pulse counter, and temperature sensor appears in Home Assistant as a sensor, and can be used in automations.
+
+Configure your GEM(s) to produce binary-format packets (for example, "Bin32 NET" for a 32-channel GEM with some channels configured for net metering) and send them to an unused port on your Home Assistant machine. (These settings are in the "Packet Send" and "Network" pages of the GEM UI.) Then specify that port and information about your monitor(s) and the data channels you wish to monitor in your `configuration.yaml`:
+
+```yaml
+# Example configuration.yaml entry
+greeneye_monitor:
+  port: 8000
+  monitors:
+    - serial_number: YOUR_SERIAL_NUMBER
+      channels:
+        - number: 1
+          name: total_power
+        - number: 2
+          name: solar_panels_power
+          net_metering: true
+      pulse_counters:
+        - number: 1
+          name: sprinklers_water_usage
+          counted_quantity: "gal"
+          counted_quantity_per_pulse: 1
+          time_unit: "min"
+      temperature_sensors:
+        - number: 1
+          name: back_porch_temperature
+```
+
+By default, GEM will send updates every 5 seconds. That's a lot of data, and the databases used by the [`recorder`](/components/recorder) component for history don't do well with that much data, so it is recommended to configure the [`influxdb`](/components/influxdb) component and exclude the GEM sensors from `recorder`.
+
+{% configuration %}
+port:
+  description: The port on which Home Assistant should listen for packets from your GEM. Must match the port set in the "Network" tab of the GEM setup UI.
+  required: true
+  type: string
+monitors:
+  description: The list of monitors that should appear in Home Assistant. Data from other monitors will be ignored.
+  required: false
+  type: list
+  keys:
+    serial_number:
+      description: The last five digits (omitting leading zeroes) of your GEM serial number.
+      required: true
+      type: integer
+    channels:
+      description: The list of channels that should appear in Home Assistant for this monitor. Data from other channels will be ignored.
+      required: false
+      type: list
+      keys:
+        number:
+          description: The channel number as it appears in the GEM UI.
+          required: true
+          type: integer
+        name:
+          description: The name that should be used for this channel's sensor in Home Assistant.
+          required: true
+          type: string
+        net_metering:
+          description: Set to `true` if the channel is configured for net metering in the GEM, otherwise `false`.
+          required: false
+          type: bool
+          default: false
+    temperature_sensors:
+      description: Configuration for temperature sensors
+      required: false
+      keys:
+        temperature_unit:
+          description: The unit of measure to use for the temperature (F or C)
+          type: string
+          required: true
+        sensors:
+          description: The list of temperature sensors that should appear in Home Assistant for this monitor. Data from other sensors will be ignored.
+          required: true
+          type: list
+          keys:
+            number:
+              description: The sensor number as it appears in the GEM UI.
+              required: true
+              type: integer
+            name:
+              description: The name that should be used for this sensor in Home Assistant.
+              required: true
+              type: string
+    pulse_counters:
+      description: The list of pulse counters that should appear in Home Assistant for this monitor. Data from other pulse counters will be ignored.
+      required: false
+      type: list
+      keys:
+        number:
+          description: The pulse counter's number as it appears in the GEM UI.
+          required: true
+          type: integer
+        name:
+          description: The name that should be used for this pulse counter in Home Assistant.
+          required: true
+          type: string
+        counted_quantity:
+          description: The unit being counted by this pulse counter (e.g., gal, L)
+          required: true
+          type: string
+        counted_quantity_per_pulse:
+          description: The number of the counted quantity represented by each pulse.
+          required: false
+          type: float
+          default: 1.0
+        time_unit:
+          description: The time unit to use when computing rates (s, min, or h)
+          required: false
+          type: string
+          default: s
+{% endconfiguration %}
+
diff --git a/source/_components/sensor.greeneye_monitor.markdown b/source/_components/sensor.greeneye_monitor.markdown
new file mode 100644
index 00000000000..ed0de5f7268
--- /dev/null
+++ b/source/_components/sensor.greeneye_monitor.markdown
@@ -0,0 +1,18 @@
+---
+layout: page
+title: "GreenEye Monitor Sensors"
+description: "Instructions on how to integrate the various sensors on your Greeneye Monitor into Home Assistant."
+date: 2018-09-02 14:13
+sidebar: true
+comments: false
+sharing: true
+footer: true
+logo: brultech.png
+ha_category: Sensor
+ha_iot_class: "Local Push"
+ha_release: 0.82
+---
+
+The [GreenEye Monitor (GEM)](http://www.brultech.com/greeneye/) integration for Home Assistant allows you to create sensors for the various data channels of the GEM.
+
+Add sensors via the configuration for the hub [GreenEye Monitor component](/components/greeneye_monitor/).
diff --git a/source/images/supported_brands/brultech.png b/source/images/supported_brands/brultech.png
new file mode 100644
index 0000000000000000000000000000000000000000..7b0fe6e02049a327709f3190248c8a4a05e701e0
GIT binary patch
literal 8783
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
IoO$^F0B$^>g#Z8m

literal 0
HcmV?d00001