From 89d16ab4a119bcd9bbb6ca8975b870e24cd9f2e3 Mon Sep 17 00:00:00 2001
From: Martin Fuchs <39280548+fucm@users.noreply.github.com>
Date: Mon, 15 Apr 2019 02:15:56 +0200
Subject: [PATCH] Initial STIEBEL ELTRON documentation (#8763)

* Initial stiebel eltron docu

* Put YOUR_IP instead of an IP

* Add default value for optional parameter

* Prepare for sensor platform integration

* Reflect the state mappings

* Update ha_release to 0.92

* Remove redirect

* :pencil2: Tweak

* :pencil2: Tweak

* :pencil2: Tweak
---
 source/_components/stiebel_eltron.markdown    |  83 ++++++++++++++++++
 .../supported_brands/stiebel_eltron.png       | Bin 0 -> 1102 bytes
 2 files changed, 83 insertions(+)
 create mode 100644 source/_components/stiebel_eltron.markdown
 create mode 100644 source/images/supported_brands/stiebel_eltron.png

diff --git a/source/_components/stiebel_eltron.markdown b/source/_components/stiebel_eltron.markdown
new file mode 100644
index 00000000000..979d8065093
--- /dev/null
+++ b/source/_components/stiebel_eltron.markdown
@@ -0,0 +1,83 @@
+---
+layout: page
+title: "STIEBEL ELTRON"
+description: "Instructions on how to integrate STIEBEL ELTRON integral ventilation and heat pump units into Home Assistant."
+date: 2019-04-14 21:00 +0200
+sidebar: true
+comments: false
+sharing: true
+footer: true
+logo: stiebel_eltron.png
+ha_category:
+  - Climate
+ha_release: 0.92
+ha_iot_class: Local Polling
+---
+
+The `stiebel_eltron` component lets you control integral ventilation or heat pump units of [STIEBEL ELTRON](https://www.stiebel-eltron.com).
+
+It requires the following components:
+
+- Compatible STIEBEL ELTRON unit (see "Compatibility overview" in [Software Documentation Modbus TCP/IP](https://www.stiebel-eltron.ch/content/dam/ste/ch/de/downloads/kundenservice/smart-home/Modbus/Modbus%20Bedienungsanleitung.pdf))
+- [ISG web](https://www.stiebel-eltron.com/en/home/products-solutions/renewables/controller_energymanagement/internet_servicegateway/isg_web.html), with the [Modbus module](https://www.stiebel-eltron.ch/de/home/service/smart-home/modbus.html) enabled
+- IP network connection to the ISG web
+
+## {% linkable_title Supported units %}
+
+By now, the following units are tested:
+
+- LWZ504e
+- LWZ304
+
+## {% linkable_title Operation modes %}
+
+Only the standard HA operation modes are supported. The STIEBEL ELTRON modes are mapped and configurable as follows:
+
+- Auto (STATE_AUTO): Automatic mode
+- Eco (STATE_ECO): Standby mode
+- Manual (STATE_MANUAL): Manual mode
+- Off (STATE_OFF): DHW mode (domestic hot water mode, heating is switched off)
+
+The HA operation mode 'On' is displayed, if the following STIEBEL ELTRON modes are configured directly on the unit:
+
+- On (STATE_ON): Day mode, Setback mode or Emergency operation
+
+## {% linkable_title Configuration %}
+
+To enable this component, add the following lines to your `configuration.yaml` file:
+
+```yaml
+# Example configuration.yaml entry
+stiebel_eltron:
+  name: LWZ504e
+```
+
+{% configuration %}
+name:
+  description: Displayed name of the unit.
+  required: false
+  default: Unnamed Device
+  type: string
+hub:
+  description: The name of the hub where this slave is located.
+  required: false
+  default: default
+  type: string
+{% endconfiguration %}
+
+<p class='note'>
+This component requires the [Modbus](/components/modbus/) component to be set up to work
+</p>
+
+Full configuration example including modbus setup shown below:
+
+```yaml
+# Full example configuration.yaml entry
+modbus:
+  type: tcp
+  host: YOUR_ISGWEB_IP
+  port: 502
+
+stiebel_eltron:
+  name: LWZ504e
+```
diff --git a/source/images/supported_brands/stiebel_eltron.png b/source/images/supported_brands/stiebel_eltron.png
new file mode 100644
index 0000000000000000000000000000000000000000..472affa0af70665e324aa9be622b2c8e573eb302
GIT binary patch
literal 1102
zcmeAS@N?(olHy`uVBq!ia0vp^6M<NTgBeKfW7N0~q-F;Agt!9fN322*Sp^@n3O!;F
ze8V6F6d5S+h(+iT8^{5V*o0q}ibw!ih9yCM!3>9=+>z$H^F!Mx@BO+Zk1dP;?o;Gm
z{xV8J@Y>;Ehf{r>>D$#R5-!Z0IjOnc^&k7$6??x_t1vJy8+*DqhD02GJ2|uXmVrRq
zeUr7R(n;6Ze>~Z6R+MSUtN;HC@5XX+xEs$cTlSdW#yCOOX?Oop(R=mZy7g^Meto=R
z{9$c=gM~_7(|`YoB0Ic|f}*m&zS36gQhIx_m~F}_1J*f=!RIWGpD~<bY4qz|L5gHg
zrvgV=#*6#1HKnH_*DTt5Z6cSO-i(rm0io#=n<O+tyY706SbkuO%BZb9wD`QXz>NY{
zo;MqOGG}g6d0?v7H^=BoS<*uPCrh_!@Hf1^;SrbN(L8ZQrmRBR?3-1lYi>_F-fYnq
zn|(xZqu}DJ6E^Gg1U?YhDe_IP=ai;k)MBeXZK<BeJ9K5d%%+HlPUtz>yT55pZ^tnS
z%LVhVU-D7NNIIcjW7L%>ae~XsUPzhsVMdAcT=VxoemyZ-dfe-Etrpj8nV)UxYbO?^
zD!4UE^~C1&rX_{c8cbsSY;XLl?)-{P>{HaMXV3K4@G{sUo7fY@H)s2weSsg`T9Uq8
z+M{LbcV?yOX`S15jc5HllHW7O^M&@R9=EFAlNno71QT<6tS)cKnl^9xa&_g0Z|~eJ
zo?~5Im7UVDt|zW%qN}gL^z4HL$MYgp5?1^4OxUvRz(Jk;rcpAz5kC&S_#LbKb!MPR
zqr}q$p*n9vtsio0Z*;tPcInr@t%84dadpP@r0uS9dmg_zaEjpW;zY+qY1?o6)+LMR
zR46AcmTS6M7;AVaWxXW(p@j=K>^0oABip;m=O^Dh>)+Q-xP9-{N>HwSeDa*Z`cL-7
z5z*NuIZy7fUw11u%+l}m+O_3>N{EK$zC|K?JQqGXyxpz+ltgINo{zI9W+vqQ;8sp|
z{E>8J-`PsfVw<hI^p<=m+Zl5$LFE&tf7|P~Wv}BUPcFN{p&TTY+wOH{jiAuGYm@j6
zJrddO)@CRj*)*j`M^RjiDLdt(z0aHTZie4;RCZ6&%ngwAb31Wl#ciIHw8@WeWfUZf
zY~{3*`Z-^^aN&zX9;;q+J_wz)(nh9thN-k*UTnK&%9C9`f4;0@6W`DrqNYAgq%vc|
zw1p>(MKod-dSBR?$K+vDDP}T3%JbS4&KA8TQfCf+w))b)zLxoY{I8?J^MENmeUJV3
kZgrcA4-XDDv)7;1PsmVRzT?kaZcrKE>FVdQ&MBb@0JYJ;Jpcdz

literal 0
HcmV?d00001