From 0f52a3cad972acd6e4e60e8f013fda064aad8e24 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Wolf-Bastian=20P=C3=B6ttner?= Date: Mon, 27 Feb 2017 06:37:12 +0100 Subject: [PATCH] Add documentation for eQ-3 MAX! Cube integration (#2093) --- source/_components/maxcube.markdown | 37 +++++++++++++++++++++ source/images/supported_brands/maxcube.png | Bin 0 -> 18278 bytes 2 files changed, 37 insertions(+) create mode 100644 source/_components/maxcube.markdown create mode 100644 source/images/supported_brands/maxcube.png diff --git a/source/_components/maxcube.markdown b/source/_components/maxcube.markdown new file mode 100644 index 00000000000..edf96e5b5ed --- /dev/null +++ b/source/_components/maxcube.markdown @@ -0,0 +1,37 @@ +--- +layout: page +title: "eQ-3 MAX! Cube" +description: "Instructions on how to integrate eQ-3 MAX! components with Home Assistant via eQ-3 MAX! Cube." +date: 2017-02-04 22:00 +sidebar: true +comments: false +sharing: true +footer: true +logo: maxcube.png +ha_category: DIY +ha_release: 0.38 +ha_iot_class: "Local Polling" +--- + +[eQ-3 MAX!](http://www.eq-3.com/products/max.html) integration for Home Assistant allows you to connect eQ-3 MAX! components via the eQ-3 MAX! Cube. The components connects to the eQ-3 MAX! Cube via TCP and automatically makes all supported components available in Home Assistant. The name for each device is created by concatenating the MAX! room and device names. + +Limitations: +- Configuring weekly schedules is not possible +- Implementation is based on the reverse engineered [MAX! protocol](https://github.com/Bouni/max-cube-protocol) + +Supported Devices: +- MAX! Radiator Thermostat (tested) +- MAX! Radiator Thermostat+ +- MAX! Window Sensor (tested) +- MAX! Wall Thermostat (tested) + +A `maxcube` section must be present in the `configuration.yaml` file and contain the following options as required: + +```yaml +# Example configuration.yaml entry +maxcube: + host: 192.168.0.20 +``` + +- **host** (*Required*): The IP address of the eQ-3 MAX! Cube to use. +- **port** (*Optional*): The UDP port number. Defaults to `62910`. diff --git a/source/images/supported_brands/maxcube.png b/source/images/supported_brands/maxcube.png new file mode 100644 index 0000000000000000000000000000000000000000..2c3883b68e687d4fb1866688f2208ac0fdcba781 GIT binary patch literal 18278 zcmb?iV`E%hv`&-sjT+l%8r!yQOw=@XW81cE+qT`lX0i4*MVQyIY!k9|A&>URq38&29a>d(BaI)cxV# zsel>Q7Y;P&Hox5-)uL}I1w~`)n9@yWV;WT};e?$N++u_7=*iOAs0uCP zbcyS9V?g+?1~qJ=_fJwUaGh&UXj=1*n@&%xuIG7-4hkPdCHdVx*cj6u$fP#8Y;$-$ z^j^WT^jdFZNX}T*OyD!#kgLBQDusbmNQA=R(G_M@x5ct|)J0WKGTJVgQ~QRiIplwN zEbyo?h=U_j@|+aD9&-fOgumc9CqK^P1u=;fOa{-qrkblA481}l39%udv)lKISVdpH zaK!|wz*Cd|N)Nuw$6V@8!b`F|J0jCPp7>XNy!i1|1wZ*8ldAb8K^B#LK?u7ts1_Rf zEEh~`Sm^rYGM^k8ttrUqzam!3*~)T#j%z_kqyU|j8i(?KRQoUi35-7WQ_CbBZ zq|J5$R6!cBge1;>)=Ua!u?$6>QqHwTOUv1G`n{iYEsS|Fx-4BxKkf(_wOv8RfLh%C z6^U~;*W}7tke;UxE&^6vtRN1QIB7g)LjL%|!8hM`; z<_GC%nhb;<1t9%}Na0Y*B3`J1;HblHUeFj!kOpXXEKMsaGNuigeCA2@8_}jWmkC z6xt6S{4;q@B<(RTPD~-y1LLvu(SZFu9$85b%G~s8Ld61OZo|WCs%?x7%bND z%{+Qe;!235>6%#vv1bl;v@Ep;>rn-5ch>^8NGLpEj$7nw@Bk{LCcG|;ng9ghuGB4q z^NE`>Y!Z`=&KzA}FhLlE4E11gqQlH54(y`r1T5H|%S4&tizgnC72oXF%xOr|xRIr- zCxgfBb>rYt)KyozophDovdWXe7|t6DGFC~;q=%8_L$ZDGkfZD?3HhNceNo9NGYl%{ z+2)*qF09Zj!3hkY6b;#OesX~r4cOYT?D)(_R`;M~^Uo~HGNi_jsLU@8_hw}}Cp8AW zGk1Sh(lfHykdL{F7Azu$f9wyV{9eQ(L}VisW1Fl!J2!cXz?}bXjp0(FE`tjFNf?ER zn|nO|t0dJFMqG^C)WP*qQPC}BV^}eGmkWuIkkER&%Uw7~0oMOd2P&znv2l=WDuey; z3?b`DbBPk&J`aP8Cen{i5gF>W9vj}t6h;I_YmK1x|GHHwe*b1;X6_%3#7<93gJq<& ztYK)Gor>6>>n_Ty-e{3Hk9@G;7t!izpe=6mdSVF-43tw)kQlJe-SGKRza|P1^A*l3 zSB_(PFqRMPE*vh?0v00!LgiBq)xPY?-_O)4WYZDVyeA&!oJ~z4G*B#1JcvaDZn=

h%sv$!2Yd|yX>josXEs+}#! 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 literal 0 HcmV?d00001