FHEMWiki - Benutzerbeiträge [de]

JUDO iSoft Plus

2018-10-06T04:30:48Z

Loungelizard: /* Readings auslesen */

{{Infobox Hardware
|Bild=judo-soft-plus.jpg|200px
|Bildbeschreibung=JUDO iSoft Plus Wasserenthärtungsanlage
|HWProtocol=IP
|HWType=Wasserenthärter
|HWCategory=IP
|HWVoltage=230 V
|HWPoweredBy=AC
|HWSize=39x67x45 cm (BxHxT)
|HWComm=n/a
|HWChannels=n/a
|HWPowerConsumption=?
|HWDeviceFHEM=[[HTTPMOD]]

|HWManufacturer=Judo GmbH
}}
__TOC__

Die JUDO i-soft plus Enthärtungsanlage [https://judo.eu/produkt/judo-i-soft-plus-vollautomatische-enthaertungsanlage/] ist eine Wasserenthärtungsanlage mit IP-Konnektivität.
Sie verfügt über LAN und WLAN-Anschluss und ist auf die Steuerung via App des Herstellers ausgelegt.

Für eine erfolgreiche Integration in FHEM muss die Anlage über das Menü beim Hersteller registriert werden.
Die folgenden Informationen sind erforderlich:

* Benutzername: Selbst gewählter Login-Name auf der iSoft plus (vgl. Gerätehandbuch)
* Kennwort: Selbst gewähltes Kennwort
* Seriennummer: Seriennummer des Geräts. Diese ist entweder über das Menü auslesbar oder alternativ auch über die APP des Herstellers.
* IP-Adresse: Die IP-Adresse des Geräts im Heimnetz.

== Einbindung in FHEM ==

Das Gerät wird mittels des Moduls HTTPMOD eingebunden. Dazu gilt zunächst die folgende Konfiguration als Basis.
Zunächst legen wir die Standardanfrage an das Modul fest. Die Portnummer 8124 ist vom Hersteller vorgegeben. Wir vergeben gleich ein paar Platzhalter, die später in den Aufrufen und den Antworten ersetzt werden, damit wir die Werte nur an einer zentralen Stelle konfigurieren müssen.

<pre>
define JUDO_iSoft HTTPMOD https://%JUDO_ipaddress%:8124/?group=waterstop&command=valve&msgnumber=4&token=%token% 300
</pre>
Mit dieser Definition wird als Standard-Anfrage die Statusabfrage nach dem Wasserstop gesendet. Diese wird zyklisch alle 300 Sekunden wiederholt.
Wem das nicht reicht, der kann den Zyklus herunter setzen oder auch nach anderen Standard-Werten abfragen. Wer das kontinuierliche Pollen vermeiden will, setzt den Wert auf 0.

Nach erfolgreicher Authentifizierung wird von der iSoft ein Token generiert und muss bei jedem Aufruf übergeben werden:

<pre>
attr JUDO_iSoft replacement01Mode reading
attr JUDO_iSoft replacement01Regex %token%
attr JUDO_iSoft replacement01Value token
</pre>

Anschließend legen wir die Ersetzungen für die anderen Platzhalter fest:

<pre>
attr JUDO_iSoft replacement02Mode text
attr JUDO_iSoft replacement02Regex %JUDO_ipaddress%
attr JUDO_iSoft replacement02Value <hier eigene IP Adresse im lokalen Netz eintragen>
attr JUDO_iSoft replacement03Mode text
attr JUDO_iSoft replacement03Regex %JUDO_password%
attr JUDO_iSoft replacement03Value <hier Kennwort eintragen>
attr JUDO_iSoft replacement04Mode text
attr JUDO_iSoft replacement04Regex %JUDO_username%
attr JUDO_iSoft replacement04Value <hier Benutzername eintragen>
attr JUDO_iSoft replacement05Mode text
attr JUDO_iSoft replacement05Regex %JUDO_serial%
attr JUDO_iSoft replacement05Value <hier Seriennummer eintragen>
</pre>

Die Authentifizierung der Anlage erfolgt zwei-stufig. Zunächst muss ein Aufruf mit Benutzername und Kennwort erfolgen. Als Antwort erhält man einen JSON-String, der das Token beinhaltet. Mit diesem Token wird anschließend die Funktion connect aufgerufen und die Seriennummer des Geräts mit übergeben.
HTTPMOD erkennt, wenn ein neues Login erforderlich ist, wenn die Judo die Rückmeldung "no token" oder "not logged in" liefert.

Achtung: Als Parameter muss ebenfalls der Typ "i-soft plus" übergeben werden. Vermutlich ist dieser bei anderen Geräten des Herstellers anders. Ich habe ihn hier fix eingetragen, da ich keine Möglichkeit zum Testen anderer Geräte habe.

<pre>
attr JUDO_iSoft showError 1
attr JUDO_iSoft authRetries 2
attr JUDO_iSoft reAuthRegex (no token)|(not logged in)
attr JUDO_iSoft sid01ParseResponse 1
attr JUDO_iSoft sid01URL https://%JUDO_ipaddress%:8124/?group=register&command=login&msgnumber=1&name=login&user=%JUDO_username%&password=%JUDO_password%&role=customer
attr JUDO_iSoft sid02URL https://%JUDO_ipaddress%:8124/?group=register&command=connect&msgnumber=6&token=%token%&parameter=i-soft%20plus&serial%20number=%JUDO_serial%
</pre>

Damit ist die Grundkonfiguration hergestellt und die Anlage kann sich connecten.
In den einzelnen JSON-Rückantworten der Anlage werden die Werte zur jeweilige Anfrage immer als "data" zurück geliefert. Mit der Standard-Konfiguration

<pre>
attr JUDO_iSoft extractAllJSON 1
</pre>

werden daraus automatisch entsprechernde Readings angelegt. Da wir aber dann immer das Reading "data" überschreiben würde, kommt eine weitere Ersetzung zum Einsatz. In der Antwort steht neben einer Kaskadierung (group) auch der zugehörige Befehl (command). Ich habe mich dafür entschieden, ein neues Reading mit dem jeweiligen Command-Namen anzulegen. Die zugehörigen Ersetzungen sind wie folgt.
Erklärung zum Ausdruck reading03OExpr: Zunächst werden die Leerzeichen im Rückgabewert ($val) durch "-" ersetzt. Mit dem so veränderten String erzeugen wir ein neues Reading mit dem Wert aus dem Reading data.

<pre>
attr JUDO_iSoft reading01JSON data
attr JUDO_iSoft reading01Name token
attr JUDO_iSoft reading01Regex "token":"([^"]+)"
attr JUDO_iSoft reading02JSON group
attr JUDO_iSoft reading03JSON command
attr JUDO_iSoft reading03OExpr $val =~ s/\s/-/;; $val; readingsBulkUpdate($hash,$val,ReadingsVal("JUDO_iSoft","data",""))
</pre>
Noch ein paar ergänzende Attribute gesetzt:
<pre>
attr JUDO_iSoft enableControlSet 1
attr JUDO_iSoft getHeader1 Content-Type: application/json
attr JUDO_iSoft getHeader2 Accept: */*
attr JUDO_iSoft room 10_Räume->UG->Keller,
attr JUDO_iSoft showError
attr JUDO_iSoft timeout 5
</pre>

Damit sind alle Voraussetzungen erledigt. Ab jetzt können wir die einzelnen Get-Befehle implementieren:

<pre>
attr JUDO_iSoft get01Name SerialNumber
attr JUDO_iSoft get01URL https://%JUDO_ipaddress%:8124/?group=spare%20part&command=serial%20number&msgnumber=5&token=%token%

attr JUDO_iSoft get02Name WaterCurrent
attr JUDO_iSoft get02URL https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20current&msgnumber=1&token=%token%

attr JUDO_iSoft get03Name SaltRange
attr JUDO_iSoft get03URL https://%JUDO_ipaddress%:8124/?group=consumption&command=salt%20range&msgnumber=1&token=%token%

attr JUDO_iSoft get04Name SaltQuantity
attr JUDO_iSoft get04URL https://%JUDO_ipaddress%:8124/?group=consumption&command=salt%20quantity&msgnumber=1&token=%token%

attr JUDO_iSoft get05Name ResidualHardness
attr JUDO_iSoft get05URL https://%JUDO_ipaddress%:8124/?group=settings&command=residual%20hardness&msgnumber=1&token=%token%

attr JUDO_iSoft get06Name NaturalHardness
attr JUDO_iSoft get06URL https://%JUDO_ipaddress%:8124/?group=info&command=natural%20hardness&msgnumber=1&token=%token%

attr JUDO_iSoft get07Name WaterStop
attr JUDO_iSoft get07URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=valve&msgnumber=1&token=%token%

attr JUDO_iSoft get08Name FlowRate
attr JUDO_iSoft get08URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=flow%20rate&msgnumber=1&token=%token%

attr JUDO_iSoft get09Name SoftwareVersion
attr JUDO_iSoft get09URL https://%JUDO_ipaddress%:8124/?group=version&command=software%20version&msgnumber=1&token=%token%

attr JUDO_iSoft get10Name HardwareVersion
attr JUDO_iSoft get10URL https://%JUDO_ipaddress%:8124/?group=version&command=hardware%20version&msgnumber=1&token=%token%

attr JUDO_iSoft get11Name InstallationDate
attr JUDO_iSoft get11URL https://%JUDO_ipaddress%:8124/?group=contract&command=init%20date&msgnumber=1&token=%token%

attr JUDO_iSoft get12Name ServiceDate
attr JUDO_iSoft get12URL https://%JUDO_ipaddress%:8124/?group=contract&command=service%20date&msgnumber=1&token=%token%

attr JUDO_iSoft get13Name WaterTotal
attr JUDO_iSoft get13URL https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20total&msgnumber=1&token=%token%

attr JUDO_iSoft get14Name WaterAverage
attr JUDO_iSoft get14URL https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20average&msgnumber=1&token=%token%

attr JUDO_iSoft get15Name Vacation
attr JUDO_iSoft get15URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=vacation&msgnumber=1&token=%token%

attr JUDO_iSoft get16Name Quantity
attr JUDO_iSoft get16URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=quantity&msgnumber=1&token=%token%

attr JUDO_iSoft get17Name WaterDaily
attr JUDO_iSoft get17URL https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20daily&msgnumber=1&token=%token%

attr JUDO_iSoft get18Name ValveState
attr JUDO_iSoft get18URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=valve&msgnumber=4&&token=%token%

</pre>

Zum Setzen einiger Werte werden die folgenden Kommandos zum Schließen und Öffnen des Wasserstopps sowie das Setzen der Wunschwasserhärte implementiert

<pre>
attr JUDO_iSoft set01Name CloseValve
attr JUDO_iSoft set01URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=valve&msgnumber=1&token=%token%&parameter=close
attr JUDO_iSoft set02Name OpenValve
attr JUDO_iSoft set02URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=valve&msgnumber=1&token=%token%&parameter=open
attr JUDO_iSoft set03Name residual-hardness
attr JUDO_iSoft set03URL https://%JUDO_ipaddress%:8124/?group=settings&command=residual%20hardness&msgnumber=1&token=%token%&parameter=$val
</pre>

'''Userreadings'''

Um die Originalwerte aus der Anlage benutzerfreundlicher darzzustellen, werden noch Userreadings angelegt.

Die Salzrestdauer soll in Wochen angegeben (Rückgemeldet werden Tage) werden, die verbleibende Salzmenge in Prozent.
Die Salzemnge wird in Gramm angegeben, 50.000 entsprechen 100%.
Wichtig: Bei den Userreadings muss darauf geachtet werden, dass diese mit Komma separiert und in einer Zeile geschrieben werden.
<pre>

attr JUDO_iSoft saltRangeInWeeks { int( (ReadingsVal("JUDO_iSoft","salt-range",0)/7))} , saltQuantityInPercent { int( (ReadingsVal("JUDO_iSoft","salt-quantity",0)/50000)*100)}
</pre>

== Readings auslesen ==
Die Art der Anbindung liefert veränderter Readings nur, wenn man sie regelmäßig abfragt. Dazu habe ich dazu einen Timer aufgesetzt, der 1x am Tag die relevanten Werte abfragt. Das ist eigentlich nur wichtig, falls man ab und an doch noch über einen anderen Weg z.B. die Apps des Herstellers auf die JUDO zugreift und Wert verändert. Bei mir sieht das dann so aus:
<pre>
Internals:
COMMAND get JUDO_iSoft SaltQuantity;
get JUDO_iSoft SaltRange;
get JUDO_iSoft WaterDaily;
get JUDO_iSoft WaterTotal;
get JUDO_iSoft WaterAverage;
get JUDO_iSoft FlowRate;
get JUDO_iSoft ResidualHardness;

DEF *23:55:00
get JUDO_iSoft SaltQuantity;
get JUDO_iSoft SaltRange;
get JUDO_iSoft WaterDaily;
get JUDO_iSoft WaterTotal;
get JUDO_iSoft WaterAverage;
get JUDO_iSoft FlowRate;
get JUDO_iSoft ResidualHardness;
NAME at_Judo_DailyStats
NR 1595
PERIODIC yes
RELATIVE no
REP -1
STATE Next: 23:55:00
TIMESPEC 23:55:00
TRIGGERTIME 1538862900
TRIGGERTIME_FMT 2018-10-06 23:55:00
TYPE at
READINGS:
2018-10-06 06:06:14 state Next: 23:55:00
Attributes:
room ,00_Masterswitches,10_Räume->UG->Keller

</pre>

Um 1x pro Stunde gegen Ende der vollen Stunde den Wasserbrauch der aktuellen Stunde abzugreifen setze ich einen weiteren Timer auf. Bei mir jeweils um :58 der aktuellen STunde. Das ist natürlich nicht ganz exakt. Wenn sich die Uhr der Judo und von fhem auseinander driften bekommt man ggf. schon wieder den Wert der nächsten Stunde.
<pre>
Internals:
CFGFN
COMMAND get JUDO_iSoft WaterCurrent
DEF +*01:00:00 get JUDO_iSoft WaterCurrent
NAME at_Judo_HourlyStats
NR 34559
NTM 06:58:00
PERIODIC yes
RELATIVE yes
REP -1
STATE Next: 06:58:00
TIMESPEC 01:00:00
TRIGGERTIME 1538801880
TRIGGERTIME_FMT 2018-10-06 06:58:00
TYPE at
READINGS:
2018-10-06 06:20:53 state Next: 06:58:00
Attributes:
alignTime 00:58
room ,00_Masterswitches,10_Räume->UG->Keller
</pre>

== Statistiken ==
Die iSoftPlus liefert verschiedene Statistiken zum Wasserverbrauch zurück. Die werden allerdings etwas eigentümlich zurückgemeldet.
Unter water-current ist der jeweilige Verbrauch je Stunde zusammengefasst. Ich hole kurz vor der vollen Stunde diesen Wert ab, damit er danach im Logfile landet.
Unter water-daily werden Tagesstatistiken geliefert. Kurioserweise in 3-Stunden-Paketen, d.h. 8 Werte. Die ersten Wert sind von 0h-3h, 3h-6h usw.
Ich habe mich aktuell darauf beschränkt, den stündlichen Verbrauch zu erfassen und zu protokollieren. Es lassen sich aber auch bei Bedarf detaillierte Datumsbezogene Statistiken abrufen. Ich habe noch keinen sinnvollen Weg gefunden, das mit fhem zu verbinden.

== Darstellung in Tablet UI ==
Ich nutze Tablet UI für die Visualisierung.
Zur Darstellung der Restmengen Salz nutze ich das knob-widget, für das Setzen des Härtegrades den spinner.

[[Datei:Screenshot judo 2.jpg|mini|Visualisierung der Judo im TabletUI|200px]]

<pre>
<div class="hbox">

<div class="vbox phone-width">
<div class="card lift">
<header>Zustand Salz</header>
<div class="sheet">

<div class="row">
<div class="cell-50 top-align center-align left-space">
<div class="big">Restmenge</div>
<div data-type="knob" data-device="JUDO_iSoft"
data-get="saltQuantityInPercent"
data-unit="%"
data-step="1"
data-min="0"
data-max="100"
data-bgcolor="#FF0000"
data-fgcolor="#00FF1A"
class="small readonly">
</div>

</div>
<div class="cell-50 top-align center-align left-space">
<div class="big">Reichweite</div>

<div data-type="knob" data-device="JUDO_iSoft"
data-get="saltRangeInWeeks"
data-unit="w"
data-step="1"
data-min="0"
data-max="52"
data-bgcolor="#FF0000"
data-fgcolor="#00FF1A"
class="small readonly">
</div>

</div>
</div>
</div>
</div>
</div>
<div class="vbox phone-width">
<div class="card lift">
<header>Wasserstopp</header>
<div class="sheet">
<div class="row top-space">

<div class="cell left-align top-align left-space">
<div data-type="symbol" data-device="JUDO_iSoft" data-get="valve"
data-icons='["fa-close","fa-close","oa-sani_water_tap","oa-sani_water_tap"]'
data-get-on='["closed","closing","opening","opened"]'
data-on-colors='["#ad3333","#ff6633","#3399ff","#33ad33"]' class="big compressed"></div>
</div>
<div class="cell-60 top-align center-align">
<div class="big">

<div data-type="label"
data-get="valve"
class="valueonly"
data-substitution='["opened","geöffnet","opening","öffnet gerade","closed","geschlossen","closing","schließt gerade"]'
data-device="JUDO_iSoft"
data-color="lightgrey">
</div>
</div>

</div>

<div class="cell left-align top-align left-space">
<div data-type="push" data-device="JUDO_iSoft" data-set-on="CloseValve 1" data-get-on="valve" data-background-icon="fa-stop-circle-o" data-icon="" class="small"></div>

</div>
<div class="cell right-align top-align right-space">

<div data-type="push" data-device="JUDO_iSoft" data-set-on="OpenValve 1" data-get-on="valve" data-background-icon="mi-play_circle_filled" data-icon="" class="small"></div>
</div>
</div>
</div>
</div>
</div>

<div class="vbox phone-width">
<div class="card lift">
<header>Wasserhärtegrad</header>

<div class="sheet">
<div class="row">

<div class="cell-20 center-align top-align left-space">
<div data-type="symbol"
data-device="JUDO_iSoft"
data-icon="none"
data-color='none'
data-height="100"
data-background-icon="fa-circle"
data-background-colors='["red","blue"]'
data-limits='["0","1"]'>
<div data-type="label"
data-get="natural-hardness"
data-unit="°h"
class="valueonly"
data-device="JUDO_iSoft"
data-color="lightgrey">
</div>
</div>
</div>

<div class="cell-20 top-align center-align left-space">
<div data-type="image" data-size="50%" data-url="images/judo.png"></div>
</div>

<div class="cell-60 top-align center-align left-space">

<div data-type="spinner"
data-device="JUDO_iSoft"
data-get="residual-hardness"
data-set="residual-hardness"
data-min=5"
data-max="12"
data-step="1"
data-unit="°h"
data-longdelay="800"
data-width="200"
data-height="60"
data-icon-left-color="blue"
data-icon-right-color="red"

class="valueonly">

</div>
</div>
</div>
</div>
</div>

</div>

<div class="vbox phone-width">
<div class="card lift">
<header>Wasserverbrauch</header>
<section>
<div id="JUDO_iSoft"
data-type="highchart"
data-device="JUDO_iSoft"
data-logdevice="FileLog_JUDO_ISoft"
data-columnspec="4:water-current"
data-style="ftui l0fill"
data-linenames="Verbrauch"
data-linetypes="line"
data-yaxis="0,1"
data-height="300"
data-xunit="Uhrzeit"
data-yunit="l"
data-tooltip="{series.name} <b>{point.y:,.1f}</b>"
data-daysago="7"
data-yticks="auto"
data-legendalign="right">

</section>

</div
</div>
</div>
</pre>
== Ähnliche Systeme ==

== Projekte der FHEM-Community ==

== Links ==
* {{Link2Forum|Topic=56455|Message=800960}}
* [https://blog.muwave.de/2017/06/monitoring-and-controlling-a-judo-i-soft-plus-water-softening-device-via-lan/ ursprünglicher Beitrag bzgl. des verwendeten Protokolls]

[[Kategorie:IP Components]]
[[Kategorie:Other Components]]

JUDO iSoft Plus

2018-10-06T04:28:14Z

Loungelizard: HTML-Seite neu formatiert

{{Infobox Hardware
|Bild=judo-soft-plus.jpg|200px
|Bildbeschreibung=JUDO iSoft Plus Wasserenthärtungsanlage
|HWProtocol=IP
|HWType=Wasserenthärter
|HWCategory=IP
|HWVoltage=230 V
|HWPoweredBy=AC
|HWSize=39x67x45 cm (BxHxT)
|HWComm=n/a
|HWChannels=n/a
|HWPowerConsumption=?
|HWDeviceFHEM=[[HTTPMOD]]

|HWManufacturer=Judo GmbH
}}
__TOC__

Die JUDO i-soft plus Enthärtungsanlage [https://judo.eu/produkt/judo-i-soft-plus-vollautomatische-enthaertungsanlage/] ist eine Wasserenthärtungsanlage mit IP-Konnektivität.
Sie verfügt über LAN und WLAN-Anschluss und ist auf die Steuerung via App des Herstellers ausgelegt.

Für eine erfolgreiche Integration in FHEM muss die Anlage über das Menü beim Hersteller registriert werden.
Die folgenden Informationen sind erforderlich:

* Benutzername: Selbst gewählter Login-Name auf der iSoft plus (vgl. Gerätehandbuch)
* Kennwort: Selbst gewähltes Kennwort
* Seriennummer: Seriennummer des Geräts. Diese ist entweder über das Menü auslesbar oder alternativ auch über die APP des Herstellers.
* IP-Adresse: Die IP-Adresse des Geräts im Heimnetz.

== Einbindung in FHEM ==

Das Gerät wird mittels des Moduls HTTPMOD eingebunden. Dazu gilt zunächst die folgende Konfiguration als Basis.
Zunächst legen wir die Standardanfrage an das Modul fest. Die Portnummer 8124 ist vom Hersteller vorgegeben. Wir vergeben gleich ein paar Platzhalter, die später in den Aufrufen und den Antworten ersetzt werden, damit wir die Werte nur an einer zentralen Stelle konfigurieren müssen.

<pre>
define JUDO_iSoft HTTPMOD https://%JUDO_ipaddress%:8124/?group=waterstop&command=valve&msgnumber=4&token=%token% 300
</pre>
Mit dieser Definition wird als Standard-Anfrage die Statusabfrage nach dem Wasserstop gesendet. Diese wird zyklisch alle 300 Sekunden wiederholt.
Wem das nicht reicht, der kann den Zyklus herunter setzen oder auch nach anderen Standard-Werten abfragen. Wer das kontinuierliche Pollen vermeiden will, setzt den Wert auf 0.

Nach erfolgreicher Authentifizierung wird von der iSoft ein Token generiert und muss bei jedem Aufruf übergeben werden:

<pre>
attr JUDO_iSoft replacement01Mode reading
attr JUDO_iSoft replacement01Regex %token%
attr JUDO_iSoft replacement01Value token
</pre>

Anschließend legen wir die Ersetzungen für die anderen Platzhalter fest:

<pre>
attr JUDO_iSoft replacement02Mode text
attr JUDO_iSoft replacement02Regex %JUDO_ipaddress%
attr JUDO_iSoft replacement02Value <hier eigene IP Adresse im lokalen Netz eintragen>
attr JUDO_iSoft replacement03Mode text
attr JUDO_iSoft replacement03Regex %JUDO_password%
attr JUDO_iSoft replacement03Value <hier Kennwort eintragen>
attr JUDO_iSoft replacement04Mode text
attr JUDO_iSoft replacement04Regex %JUDO_username%
attr JUDO_iSoft replacement04Value <hier Benutzername eintragen>
attr JUDO_iSoft replacement05Mode text
attr JUDO_iSoft replacement05Regex %JUDO_serial%
attr JUDO_iSoft replacement05Value <hier Seriennummer eintragen>
</pre>

Die Authentifizierung der Anlage erfolgt zwei-stufig. Zunächst muss ein Aufruf mit Benutzername und Kennwort erfolgen. Als Antwort erhält man einen JSON-String, der das Token beinhaltet. Mit diesem Token wird anschließend die Funktion connect aufgerufen und die Seriennummer des Geräts mit übergeben.
HTTPMOD erkennt, wenn ein neues Login erforderlich ist, wenn die Judo die Rückmeldung "no token" oder "not logged in" liefert.

Achtung: Als Parameter muss ebenfalls der Typ "i-soft plus" übergeben werden. Vermutlich ist dieser bei anderen Geräten des Herstellers anders. Ich habe ihn hier fix eingetragen, da ich keine Möglichkeit zum Testen anderer Geräte habe.

<pre>
attr JUDO_iSoft showError 1
attr JUDO_iSoft authRetries 2
attr JUDO_iSoft reAuthRegex (no token)|(not logged in)
attr JUDO_iSoft sid01ParseResponse 1
attr JUDO_iSoft sid01URL https://%JUDO_ipaddress%:8124/?group=register&command=login&msgnumber=1&name=login&user=%JUDO_username%&password=%JUDO_password%&role=customer
attr JUDO_iSoft sid02URL https://%JUDO_ipaddress%:8124/?group=register&command=connect&msgnumber=6&token=%token%&parameter=i-soft%20plus&serial%20number=%JUDO_serial%
</pre>

Damit ist die Grundkonfiguration hergestellt und die Anlage kann sich connecten.
In den einzelnen JSON-Rückantworten der Anlage werden die Werte zur jeweilige Anfrage immer als "data" zurück geliefert. Mit der Standard-Konfiguration

<pre>
attr JUDO_iSoft extractAllJSON 1
</pre>

werden daraus automatisch entsprechernde Readings angelegt. Da wir aber dann immer das Reading "data" überschreiben würde, kommt eine weitere Ersetzung zum Einsatz. In der Antwort steht neben einer Kaskadierung (group) auch der zugehörige Befehl (command). Ich habe mich dafür entschieden, ein neues Reading mit dem jeweiligen Command-Namen anzulegen. Die zugehörigen Ersetzungen sind wie folgt.
Erklärung zum Ausdruck reading03OExpr: Zunächst werden die Leerzeichen im Rückgabewert ($val) durch "-" ersetzt. Mit dem so veränderten String erzeugen wir ein neues Reading mit dem Wert aus dem Reading data.

<pre>
attr JUDO_iSoft reading01JSON data
attr JUDO_iSoft reading01Name token
attr JUDO_iSoft reading01Regex "token":"([^"]+)"
attr JUDO_iSoft reading02JSON group
attr JUDO_iSoft reading03JSON command
attr JUDO_iSoft reading03OExpr $val =~ s/\s/-/;; $val; readingsBulkUpdate($hash,$val,ReadingsVal("JUDO_iSoft","data",""))
</pre>
Noch ein paar ergänzende Attribute gesetzt:
<pre>
attr JUDO_iSoft enableControlSet 1
attr JUDO_iSoft getHeader1 Content-Type: application/json
attr JUDO_iSoft getHeader2 Accept: */*
attr JUDO_iSoft room 10_Räume->UG->Keller,
attr JUDO_iSoft showError
attr JUDO_iSoft timeout 5
</pre>

Damit sind alle Voraussetzungen erledigt. Ab jetzt können wir die einzelnen Get-Befehle implementieren:

<pre>
attr JUDO_iSoft get01Name SerialNumber
attr JUDO_iSoft get01URL https://%JUDO_ipaddress%:8124/?group=spare%20part&command=serial%20number&msgnumber=5&token=%token%

attr JUDO_iSoft get02Name WaterCurrent
attr JUDO_iSoft get02URL https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20current&msgnumber=1&token=%token%

attr JUDO_iSoft get03Name SaltRange
attr JUDO_iSoft get03URL https://%JUDO_ipaddress%:8124/?group=consumption&command=salt%20range&msgnumber=1&token=%token%

attr JUDO_iSoft get04Name SaltQuantity
attr JUDO_iSoft get04URL https://%JUDO_ipaddress%:8124/?group=consumption&command=salt%20quantity&msgnumber=1&token=%token%

attr JUDO_iSoft get05Name ResidualHardness
attr JUDO_iSoft get05URL https://%JUDO_ipaddress%:8124/?group=settings&command=residual%20hardness&msgnumber=1&token=%token%

attr JUDO_iSoft get06Name NaturalHardness
attr JUDO_iSoft get06URL https://%JUDO_ipaddress%:8124/?group=info&command=natural%20hardness&msgnumber=1&token=%token%

attr JUDO_iSoft get07Name WaterStop
attr JUDO_iSoft get07URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=valve&msgnumber=1&token=%token%

attr JUDO_iSoft get08Name FlowRate
attr JUDO_iSoft get08URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=flow%20rate&msgnumber=1&token=%token%

attr JUDO_iSoft get09Name SoftwareVersion
attr JUDO_iSoft get09URL https://%JUDO_ipaddress%:8124/?group=version&command=software%20version&msgnumber=1&token=%token%

attr JUDO_iSoft get10Name HardwareVersion
attr JUDO_iSoft get10URL https://%JUDO_ipaddress%:8124/?group=version&command=hardware%20version&msgnumber=1&token=%token%

attr JUDO_iSoft get11Name InstallationDate
attr JUDO_iSoft get11URL https://%JUDO_ipaddress%:8124/?group=contract&command=init%20date&msgnumber=1&token=%token%

attr JUDO_iSoft get12Name ServiceDate
attr JUDO_iSoft get12URL https://%JUDO_ipaddress%:8124/?group=contract&command=service%20date&msgnumber=1&token=%token%

attr JUDO_iSoft get13Name WaterTotal
attr JUDO_iSoft get13URL https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20total&msgnumber=1&token=%token%

attr JUDO_iSoft get14Name WaterAverage
attr JUDO_iSoft get14URL https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20average&msgnumber=1&token=%token%

attr JUDO_iSoft get15Name Vacation
attr JUDO_iSoft get15URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=vacation&msgnumber=1&token=%token%

attr JUDO_iSoft get16Name Quantity
attr JUDO_iSoft get16URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=quantity&msgnumber=1&token=%token%

attr JUDO_iSoft get17Name WaterDaily
attr JUDO_iSoft get17URL https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20daily&msgnumber=1&token=%token%

attr JUDO_iSoft get18Name ValveState
attr JUDO_iSoft get18URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=valve&msgnumber=4&&token=%token%

</pre>

Zum Setzen einiger Werte werden die folgenden Kommandos zum Schließen und Öffnen des Wasserstopps sowie das Setzen der Wunschwasserhärte implementiert

<pre>
attr JUDO_iSoft set01Name CloseValve
attr JUDO_iSoft set01URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=valve&msgnumber=1&token=%token%&parameter=close
attr JUDO_iSoft set02Name OpenValve
attr JUDO_iSoft set02URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=valve&msgnumber=1&token=%token%&parameter=open
attr JUDO_iSoft set03Name residual-hardness
attr JUDO_iSoft set03URL https://%JUDO_ipaddress%:8124/?group=settings&command=residual%20hardness&msgnumber=1&token=%token%&parameter=$val
</pre>

'''Userreadings'''

Um die Originalwerte aus der Anlage benutzerfreundlicher darzzustellen, werden noch Userreadings angelegt.

Die Salzrestdauer soll in Wochen angegeben (Rückgemeldet werden Tage) werden, die verbleibende Salzmenge in Prozent.
Die Salzemnge wird in Gramm angegeben, 50.000 entsprechen 100%.
Wichtig: Bei den Userreadings muss darauf geachtet werden, dass diese mit Komma separiert und in einer Zeile geschrieben werden.
<pre>

attr JUDO_iSoft saltRangeInWeeks { int( (ReadingsVal("JUDO_iSoft","salt-range",0)/7))} , saltQuantityInPercent { int( (ReadingsVal("JUDO_iSoft","salt-quantity",0)/50000)*100)}
</pre>

== Readings auslesen ==
Da die Art der Anbindung nur angepasste Readings liefert, wenn man sie regelmäßig abfragt, habe ich dazu einen Timer aufgesetzt, der 1x am Tag die relevanten Werte abfragt. Das ist eigentlich nur wichtig, falls man ab und an doch noch über einen anderen Weg z.B. die Apps des Herstellers auf die JUDO zugreift und Wert verändert. Bei mir sieht das dann so aus:
<pre>
Internals:
COMMAND get JUDO_iSoft SaltQuantity;
get JUDO_iSoft SaltRange;
get JUDO_iSoft WaterDaily;
get JUDO_iSoft WaterTotal;
get JUDO_iSoft WaterAverage;
get JUDO_iSoft FlowRate;
get JUDO_iSoft ResidualHardness;

DEF *23:55:00
get JUDO_iSoft SaltQuantity;
get JUDO_iSoft SaltRange;
get JUDO_iSoft WaterDaily;
get JUDO_iSoft WaterTotal;
get JUDO_iSoft WaterAverage;
get JUDO_iSoft FlowRate;
get JUDO_iSoft ResidualHardness;
</pre>

Um 1x pro Stunde gegen Ende der vollen Stunde den Wasserbrauch der aktuellen Stunde abzugreifen setze ich einen weiteren Timer auf. Bei mir jewils um :58 der aktuellen STunde. Das ist natürlich nicht ganz exakt. Wenn sich die Uhr der Judo und von fhem auseinander driften bekommt man ggf. schon wieder den Wert der nächsten Stunde.
<pre>
Internals:
CFGFN
COMMAND get JUDO_iSoft WaterCurrent
DEF +*01:00:00 get JUDO_iSoft WaterCurrent
NAME at_Judo_HourlyStats
NR 34559
NTM 06:58:00
PERIODIC yes
RELATIVE yes
REP -1
STATE Next: 06:58:00
TIMESPEC 01:00:00
TRIGGERTIME 1538801880
TRIGGERTIME_FMT 2018-10-06 06:58:00
TYPE at
READINGS:
2018-10-06 06:20:53 state Next: 06:58:00
Attributes:
alignTime 00:58
room ,00_Masterswitches,10_Räume->UG->Keller
</pre>

== Statistiken ==
Die iSoftPlus liefert verschiedene Statistiken zum Wasserverbrauch zurück. Die werden allerdings etwas eigentümlich zurückgemeldet.
Unter water-current ist der jeweilige Verbrauch je Stunde zusammengefasst. Ich hole kurz vor der vollen Stunde diesen Wert ab, damit er danach im Logfile landet.
Unter water-daily werden Tagesstatistiken geliefert. Kurioserweise in 3-Stunden-Paketen, d.h. 8 Werte. Die ersten Wert sind von 0h-3h, 3h-6h usw.
Ich habe mich aktuell darauf beschränkt, den stündlichen Verbrauch zu erfassen und zu protokollieren. Es lassen sich aber auch bei Bedarf detaillierte Datumsbezogene Statistiken abrufen. Ich habe noch keinen sinnvollen Weg gefunden, das mit fhem zu verbinden.

== Darstellung in Tablet UI ==
Ich nutze Tablet UI für die Visualisierung.
Zur Darstellung der Restmengen Salz nutze ich das knob-widget, für das Setzen des Härtegrades den spinner.

[[Datei:Screenshot judo 2.jpg|mini|Visualisierung der Judo im TabletUI|200px]]

<pre>
<div class="hbox">

<div class="vbox phone-width">
<div class="card lift">
<header>Zustand Salz</header>
<div class="sheet">

<div class="row">
<div class="cell-50 top-align center-align left-space">
<div class="big">Restmenge</div>
<div data-type="knob" data-device="JUDO_iSoft"
data-get="saltQuantityInPercent"
data-unit="%"
data-step="1"
data-min="0"
data-max="100"
data-bgcolor="#FF0000"
data-fgcolor="#00FF1A"
class="small readonly">
</div>

</div>
<div class="cell-50 top-align center-align left-space">
<div class="big">Reichweite</div>

<div data-type="knob" data-device="JUDO_iSoft"
data-get="saltRangeInWeeks"
data-unit="w"
data-step="1"
data-min="0"
data-max="52"
data-bgcolor="#FF0000"
data-fgcolor="#00FF1A"
class="small readonly">
</div>

</div>
</div>
</div>
</div>
</div>
<div class="vbox phone-width">
<div class="card lift">
<header>Wasserstopp</header>
<div class="sheet">
<div class="row top-space">

<div class="cell left-align top-align left-space">
<div data-type="symbol" data-device="JUDO_iSoft" data-get="valve"
data-icons='["fa-close","fa-close","oa-sani_water_tap","oa-sani_water_tap"]'
data-get-on='["closed","closing","opening","opened"]'
data-on-colors='["#ad3333","#ff6633","#3399ff","#33ad33"]' class="big compressed"></div>
</div>
<div class="cell-60 top-align center-align">
<div class="big">

<div data-type="label"
data-get="valve"
class="valueonly"
data-substitution='["opened","geöffnet","opening","öffnet gerade","closed","geschlossen","closing","schließt gerade"]'
data-device="JUDO_iSoft"
data-color="lightgrey">
</div>
</div>

</div>

<div class="cell left-align top-align left-space">
<div data-type="push" data-device="JUDO_iSoft" data-set-on="CloseValve 1" data-get-on="valve" data-background-icon="fa-stop-circle-o" data-icon="" class="small"></div>

</div>
<div class="cell right-align top-align right-space">

<div data-type="push" data-device="JUDO_iSoft" data-set-on="OpenValve 1" data-get-on="valve" data-background-icon="mi-play_circle_filled" data-icon="" class="small"></div>
</div>
</div>
</div>
</div>
</div>

<div class="vbox phone-width">
<div class="card lift">
<header>Wasserhärtegrad</header>

<div class="sheet">
<div class="row">

<div class="cell-20 center-align top-align left-space">
<div data-type="symbol"
data-device="JUDO_iSoft"
data-icon="none"
data-color='none'
data-height="100"
data-background-icon="fa-circle"
data-background-colors='["red","blue"]'
data-limits='["0","1"]'>
<div data-type="label"
data-get="natural-hardness"
data-unit="°h"
class="valueonly"
data-device="JUDO_iSoft"
data-color="lightgrey">
</div>
</div>
</div>

<div class="cell-20 top-align center-align left-space">
<div data-type="image" data-size="50%" data-url="images/judo.png"></div>
</div>

<div class="cell-60 top-align center-align left-space">

<div data-type="spinner"
data-device="JUDO_iSoft"
data-get="residual-hardness"
data-set="residual-hardness"
data-min=5"
data-max="12"
data-step="1"
data-unit="°h"
data-longdelay="800"
data-width="200"
data-height="60"
data-icon-left-color="blue"
data-icon-right-color="red"

class="valueonly">

</div>
</div>
</div>
</div>
</div>

</div>

<div class="vbox phone-width">
<div class="card lift">
<header>Wasserverbrauch</header>
<section>
<div id="JUDO_iSoft"
data-type="highchart"
data-device="JUDO_iSoft"
data-logdevice="FileLog_JUDO_ISoft"
data-columnspec="4:water-current"
data-style="ftui l0fill"
data-linenames="Verbrauch"
data-linetypes="line"
data-yaxis="0,1"
data-height="300"
data-xunit="Uhrzeit"
data-yunit="l"
data-tooltip="{series.name} <b>{point.y:,.1f}</b>"
data-daysago="7"
data-yticks="auto"
data-legendalign="right">

</section>

</div
</div>
</div>
</pre>
== Ähnliche Systeme ==

== Projekte der FHEM-Community ==

== Links ==
* {{Link2Forum|Topic=56455|Message=800960}}
* [https://blog.muwave.de/2017/06/monitoring-and-controlling-a-judo-i-soft-plus-water-softening-device-via-lan/ ursprünglicher Beitrag bzgl. des verwendeten Protokolls]

[[Kategorie:IP Components]]
[[Kategorie:Other Components]]

JUDO iSoft Plus

2018-10-06T04:24:31Z

Loungelizard: Timer ergänzt

{{Infobox Hardware
|Bild=judo-soft-plus.jpg|200px
|Bildbeschreibung=JUDO iSoft Plus Wasserenthärtungsanlage
|HWProtocol=IP
|HWType=Wasserenthärter
|HWCategory=IP
|HWVoltage=230 V
|HWPoweredBy=AC
|HWSize=39x67x45 cm (BxHxT)
|HWComm=n/a
|HWChannels=n/a
|HWPowerConsumption=?
|HWDeviceFHEM=[[HTTPMOD]]

|HWManufacturer=Judo GmbH
}}
__TOC__

Die JUDO i-soft plus Enthärtungsanlage [https://judo.eu/produkt/judo-i-soft-plus-vollautomatische-enthaertungsanlage/] ist eine Wasserenthärtungsanlage mit IP-Konnektivität.
Sie verfügt über LAN und WLAN-Anschluss und ist auf die Steuerung via App des Herstellers ausgelegt.

Für eine erfolgreiche Integration in FHEM muss die Anlage über das Menü beim Hersteller registriert werden.
Die folgenden Informationen sind erforderlich:

* Benutzername: Selbst gewählter Login-Name auf der iSoft plus (vgl. Gerätehandbuch)
* Kennwort: Selbst gewähltes Kennwort
* Seriennummer: Seriennummer des Geräts. Diese ist entweder über das Menü auslesbar oder alternativ auch über die APP des Herstellers.
* IP-Adresse: Die IP-Adresse des Geräts im Heimnetz.

== Einbindung in FHEM ==

Das Gerät wird mittels des Moduls HTTPMOD eingebunden. Dazu gilt zunächst die folgende Konfiguration als Basis.
Zunächst legen wir die Standardanfrage an das Modul fest. Die Portnummer 8124 ist vom Hersteller vorgegeben. Wir vergeben gleich ein paar Platzhalter, die später in den Aufrufen und den Antworten ersetzt werden, damit wir die Werte nur an einer zentralen Stelle konfigurieren müssen.

<pre>
define JUDO_iSoft HTTPMOD https://%JUDO_ipaddress%:8124/?group=waterstop&command=valve&msgnumber=4&token=%token% 300
</pre>
Mit dieser Definition wird als Standard-Anfrage die Statusabfrage nach dem Wasserstop gesendet. Diese wird zyklisch alle 300 Sekunden wiederholt.
Wem das nicht reicht, der kann den Zyklus herunter setzen oder auch nach anderen Standard-Werten abfragen. Wer das kontinuierliche Pollen vermeiden will, setzt den Wert auf 0.

Nach erfolgreicher Authentifizierung wird von der iSoft ein Token generiert und muss bei jedem Aufruf übergeben werden:

<pre>
attr JUDO_iSoft replacement01Mode reading
attr JUDO_iSoft replacement01Regex %token%
attr JUDO_iSoft replacement01Value token
</pre>

Anschließend legen wir die Ersetzungen für die anderen Platzhalter fest:

<pre>
attr JUDO_iSoft replacement02Mode text
attr JUDO_iSoft replacement02Regex %JUDO_ipaddress%
attr JUDO_iSoft replacement02Value <hier eigene IP Adresse im lokalen Netz eintragen>
attr JUDO_iSoft replacement03Mode text
attr JUDO_iSoft replacement03Regex %JUDO_password%
attr JUDO_iSoft replacement03Value <hier Kennwort eintragen>
attr JUDO_iSoft replacement04Mode text
attr JUDO_iSoft replacement04Regex %JUDO_username%
attr JUDO_iSoft replacement04Value <hier Benutzername eintragen>
attr JUDO_iSoft replacement05Mode text
attr JUDO_iSoft replacement05Regex %JUDO_serial%
attr JUDO_iSoft replacement05Value <hier Seriennummer eintragen>
</pre>

Die Authentifizierung der Anlage erfolgt zwei-stufig. Zunächst muss ein Aufruf mit Benutzername und Kennwort erfolgen. Als Antwort erhält man einen JSON-String, der das Token beinhaltet. Mit diesem Token wird anschließend die Funktion connect aufgerufen und die Seriennummer des Geräts mit übergeben.
HTTPMOD erkennt, wenn ein neues Login erforderlich ist, wenn die Judo die Rückmeldung "no token" oder "not logged in" liefert.

Achtung: Als Parameter muss ebenfalls der Typ "i-soft plus" übergeben werden. Vermutlich ist dieser bei anderen Geräten des Herstellers anders. Ich habe ihn hier fix eingetragen, da ich keine Möglichkeit zum Testen anderer Geräte habe.

<pre>
attr JUDO_iSoft showError 1
attr JUDO_iSoft authRetries 2
attr JUDO_iSoft reAuthRegex (no token)|(not logged in)
attr JUDO_iSoft sid01ParseResponse 1
attr JUDO_iSoft sid01URL https://%JUDO_ipaddress%:8124/?group=register&command=login&msgnumber=1&name=login&user=%JUDO_username%&password=%JUDO_password%&role=customer
attr JUDO_iSoft sid02URL https://%JUDO_ipaddress%:8124/?group=register&command=connect&msgnumber=6&token=%token%&parameter=i-soft%20plus&serial%20number=%JUDO_serial%
</pre>

Damit ist die Grundkonfiguration hergestellt und die Anlage kann sich connecten.
In den einzelnen JSON-Rückantworten der Anlage werden die Werte zur jeweilige Anfrage immer als "data" zurück geliefert. Mit der Standard-Konfiguration

<pre>
attr JUDO_iSoft extractAllJSON 1
</pre>

werden daraus automatisch entsprechernde Readings angelegt. Da wir aber dann immer das Reading "data" überschreiben würde, kommt eine weitere Ersetzung zum Einsatz. In der Antwort steht neben einer Kaskadierung (group) auch der zugehörige Befehl (command). Ich habe mich dafür entschieden, ein neues Reading mit dem jeweiligen Command-Namen anzulegen. Die zugehörigen Ersetzungen sind wie folgt.
Erklärung zum Ausdruck reading03OExpr: Zunächst werden die Leerzeichen im Rückgabewert ($val) durch "-" ersetzt. Mit dem so veränderten String erzeugen wir ein neues Reading mit dem Wert aus dem Reading data.

<pre>
attr JUDO_iSoft reading01JSON data
attr JUDO_iSoft reading01Name token
attr JUDO_iSoft reading01Regex "token":"([^"]+)"
attr JUDO_iSoft reading02JSON group
attr JUDO_iSoft reading03JSON command
attr JUDO_iSoft reading03OExpr $val =~ s/\s/-/;; $val; readingsBulkUpdate($hash,$val,ReadingsVal("JUDO_iSoft","data",""))
</pre>
Noch ein paar ergänzende Attribute gesetzt:
<pre>
attr JUDO_iSoft enableControlSet 1
attr JUDO_iSoft getHeader1 Content-Type: application/json
attr JUDO_iSoft getHeader2 Accept: */*
attr JUDO_iSoft room 10_Räume->UG->Keller,
attr JUDO_iSoft showError
attr JUDO_iSoft timeout 5
</pre>

Damit sind alle Voraussetzungen erledigt. Ab jetzt können wir die einzelnen Get-Befehle implementieren:

<pre>
attr JUDO_iSoft get01Name SerialNumber
attr JUDO_iSoft get01URL https://%JUDO_ipaddress%:8124/?group=spare%20part&command=serial%20number&msgnumber=5&token=%token%

attr JUDO_iSoft get02Name WaterCurrent
attr JUDO_iSoft get02URL https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20current&msgnumber=1&token=%token%

attr JUDO_iSoft get03Name SaltRange
attr JUDO_iSoft get03URL https://%JUDO_ipaddress%:8124/?group=consumption&command=salt%20range&msgnumber=1&token=%token%

attr JUDO_iSoft get04Name SaltQuantity
attr JUDO_iSoft get04URL https://%JUDO_ipaddress%:8124/?group=consumption&command=salt%20quantity&msgnumber=1&token=%token%

attr JUDO_iSoft get05Name ResidualHardness
attr JUDO_iSoft get05URL https://%JUDO_ipaddress%:8124/?group=settings&command=residual%20hardness&msgnumber=1&token=%token%

attr JUDO_iSoft get06Name NaturalHardness
attr JUDO_iSoft get06URL https://%JUDO_ipaddress%:8124/?group=info&command=natural%20hardness&msgnumber=1&token=%token%

attr JUDO_iSoft get07Name WaterStop
attr JUDO_iSoft get07URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=valve&msgnumber=1&token=%token%

attr JUDO_iSoft get08Name FlowRate
attr JUDO_iSoft get08URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=flow%20rate&msgnumber=1&token=%token%

attr JUDO_iSoft get09Name SoftwareVersion
attr JUDO_iSoft get09URL https://%JUDO_ipaddress%:8124/?group=version&command=software%20version&msgnumber=1&token=%token%

attr JUDO_iSoft get10Name HardwareVersion
attr JUDO_iSoft get10URL https://%JUDO_ipaddress%:8124/?group=version&command=hardware%20version&msgnumber=1&token=%token%

attr JUDO_iSoft get11Name InstallationDate
attr JUDO_iSoft get11URL https://%JUDO_ipaddress%:8124/?group=contract&command=init%20date&msgnumber=1&token=%token%

attr JUDO_iSoft get12Name ServiceDate
attr JUDO_iSoft get12URL https://%JUDO_ipaddress%:8124/?group=contract&command=service%20date&msgnumber=1&token=%token%

attr JUDO_iSoft get13Name WaterTotal
attr JUDO_iSoft get13URL https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20total&msgnumber=1&token=%token%

attr JUDO_iSoft get14Name WaterAverage
attr JUDO_iSoft get14URL https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20average&msgnumber=1&token=%token%

attr JUDO_iSoft get15Name Vacation
attr JUDO_iSoft get15URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=vacation&msgnumber=1&token=%token%

attr JUDO_iSoft get16Name Quantity
attr JUDO_iSoft get16URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=quantity&msgnumber=1&token=%token%

attr JUDO_iSoft get17Name WaterDaily
attr JUDO_iSoft get17URL https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20daily&msgnumber=1&token=%token%

attr JUDO_iSoft get18Name ValveState
attr JUDO_iSoft get18URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=valve&msgnumber=4&&token=%token%

</pre>

Zum Setzen einiger Werte werden die folgenden Kommandos zum Schließen und Öffnen des Wasserstopps sowie das Setzen der Wunschwasserhärte implementiert

<pre>
attr JUDO_iSoft set01Name CloseValve
attr JUDO_iSoft set01URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=valve&msgnumber=1&token=%token%&parameter=close
attr JUDO_iSoft set02Name OpenValve
attr JUDO_iSoft set02URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=valve&msgnumber=1&token=%token%&parameter=open
attr JUDO_iSoft set03Name residual-hardness
attr JUDO_iSoft set03URL https://%JUDO_ipaddress%:8124/?group=settings&command=residual%20hardness&msgnumber=1&token=%token%&parameter=$val
</pre>

'''Userreadings'''

Um die Originalwerte aus der Anlage benutzerfreundlicher darzzustellen, werden noch Userreadings angelegt.

Die Salzrestdauer soll in Wochen angegeben (Rückgemeldet werden Tage) werden, die verbleibende Salzmenge in Prozent.
Die Salzemnge wird in Gramm angegeben, 50.000 entsprechen 100%.
Wichtig: Bei den Userreadings muss darauf geachtet werden, dass diese mit Komma separiert und in einer Zeile geschrieben werden.
<pre>

attr JUDO_iSoft saltRangeInWeeks { int( (ReadingsVal("JUDO_iSoft","salt-range",0)/7))} , saltQuantityInPercent { int( (ReadingsVal("JUDO_iSoft","salt-quantity",0)/50000)*100)}
</pre>

== Readings auslesen ==
Da die Art der Anbindung nur angepasste Readings liefert, wenn man sie regelmäßig abfragt, habe ich dazu einen Timer aufgesetzt, der 1x am Tag die relevanten Werte abfragt. Das ist eigentlich nur wichtig, falls man ab und an doch noch über einen anderen Weg z.B. die Apps des Herstellers auf die JUDO zugreift und Wert verändert. Bei mir sieht das dann so aus:
<pre>
Internals:
COMMAND get JUDO_iSoft SaltQuantity;
get JUDO_iSoft SaltRange;
get JUDO_iSoft WaterDaily;
get JUDO_iSoft WaterTotal;
get JUDO_iSoft WaterAverage;
get JUDO_iSoft FlowRate;
get JUDO_iSoft ResidualHardness;

DEF *23:55:00
get JUDO_iSoft SaltQuantity;
get JUDO_iSoft SaltRange;
get JUDO_iSoft WaterDaily;
get JUDO_iSoft WaterTotal;
get JUDO_iSoft WaterAverage;
get JUDO_iSoft FlowRate;
get JUDO_iSoft ResidualHardness;
</pre>

Um 1x pro Stunde gegen Ende der vollen Stunde den Wasserbrauch der aktuellen Stunde abzugreifen setze ich einen weiteren Timer auf. Bei mir jewils um :58 der aktuellen STunde. Das ist natürlich nicht ganz exakt. Wenn sich die Uhr der Judo und von fhem auseinander driften bekommt man ggf. schon wieder den Wert der nächsten Stunde.
<pre>
Internals:
CFGFN
COMMAND get JUDO_iSoft WaterCurrent
DEF +*01:00:00 get JUDO_iSoft WaterCurrent
NAME at_Judo_HourlyStats
NR 34559
NTM 06:58:00
PERIODIC yes
RELATIVE yes
REP -1
STATE Next: 06:58:00
TIMESPEC 01:00:00
TRIGGERTIME 1538801880
TRIGGERTIME_FMT 2018-10-06 06:58:00
TYPE at
READINGS:
2018-10-06 06:20:53 state Next: 06:58:00
Attributes:
alignTime 00:58
room ,00_Masterswitches,10_Räume->UG->Keller
</pre>

== Statistiken ==
Die iSoftPlus liefert verschiedene Statistiken zum Wasserverbrauch zurück. Die werden allerdings etwas eigentümlich zurückgemeldet.
Unter water-current ist der jeweilige Verbrauch je Stunde zusammengefasst. Ich hole kurz vor der vollen Stunde diesen Wert ab, damit er danach im Logfile landet.
Unter water-daily werden Tagesstatistiken geliefert. Kurioserweise in 3-Stunden-Paketen, d.h. 8 Werte. Die ersten Wert sind von 0h-3h, 3h-6h usw.
Ich habe mich aktuell darauf beschränkt, den stündlichen Verbrauch zu erfassen und zu protokollieren. Es lassen sich aber auch bei Bedarf detaillierte Datumsbezogene Statistiken abrufen. Ich habe noch keinen sinnvollen Weg gefunden, das mit fhem zu verbinden.

== Darstellung in Tablet UI ==
Ich nutze Tablet UI für die Visualisierung.
Zur Darstellung der Restmengen Salz nutze ich das knob-widget, für das Setzen des Härtegrades den spinner.

[[Datei:Screenshot judo 2.jpg|mini|Visualisierung der Judo im TabletUI|200px]]

<pre>
<div class="hbox">

<div class="vbox phone-width">
<div class="card lift">
<header>Zustand Salz</header>
<div class="sheet">

<div class="row">
<div class="cell-50 top-align center-align left-space">
<div class="big">Restmenge</div>
<div data-type="knob" data-device="JUDO_iSoft"
data-get="saltQuantityInPercent"
data-unit="%"
data-step="1"
data-min="0"
data-max="100"
data-bgcolor="#FF0000"
data-fgcolor="#00FF1A"
class="small readonly">
</div>

</div>
<div class="cell-50 top-align center-align left-space">
<div class="big">Reichweite</div>

<div data-type="knob" data-device="JUDO_iSoft"
data-get="saltRangeInWeeks"
data-unit="w"
data-step="1"
data-min="0"
data-max="52"
data-bgcolor="#FF0000"
data-fgcolor="#00FF1A"
class="small readonly">
</div>

</div>
</div>
</div>
</div>
</div>
<div class="vbox phone-width">
<div class="card lift">
<header>Wasserstopp</header>
<div class="sheet">
<div class="row top-space">

<div class="cell left-align top-align left-space">
<div data-type="symbol" data-device="JUDO_iSoft" data-get="valve"
data-icons='["fa-close","fa-close","oa-sani_water_tap","oa-sani_water_tap"]'
data-get-on='["closed","closing","opening","opened"]'
data-on-colors='["#ad3333","#ff6633","#3399ff","#33ad33"]' class="big compressed"></div>
</div>
<div class="cell-60 top-align center-align">
<div class="big">

<div data-type="label"
data-get="valve"
class="valueonly"
data-substitution='["opened","geöffnet","opening","öffnet gerade","closed","geschlossen","closing","schließt gerade"]'
data-device="JUDO_iSoft"
data-color="lightgrey">
</div>
</div>

</div>

<div class="cell left-align top-align left-space">
<div data-type="push" data-device="JUDO_iSoft" data-set-on="CloseValve 1" data-get-on="valve" data-background-icon="fa-stop-circle-o" data-icon="" class="small"></div>

</div>
<div class="cell right-align top-align right-space">

<div data-type="push" data-device="JUDO_iSoft" data-set-on="OpenValve 1" data-get-on="valve" data-background-icon="mi-play_circle_filled" data-icon="" class="small"></div>
</div>
</div>
</div>
</div>
</div>

<div class="vbox phone-width">
<div class="card lift">
<header>Wasserhärtegrad</header>

<div class="sheet">
<div class="row">

<div class="cell-20 center-align top-align left-space">
<div data-type="symbol"
data-device="JUDO_iSoft"
data-icon="none"
data-color='none'
data-height="100"
data-background-icon="fa-circle"
data-background-colors='["red","blue"]'
data-limits='["0","1"]'>
<div data-type="label"
data-get="natural-hardness"
data-unit="°h"
class="valueonly"
data-device="JUDO_iSoft"
data-color="lightgrey">
</div>
</div>
</div>

<div class="cell-20 top-align center-align left-space">
<div data-type="image" data-size="50%" data-url="images/judo.png"></div>
</div>

<div class="cell-60 top-align center-align left-space">

<div data-type="spinner"
data-device="JUDO_iSoft"
data-get="residual-hardness"
data-set="residual-hardness"
data-min=5"
data-max="12"
data-step="1"
data-unit="°h"
data-longdelay="800"
data-width="200"
data-height="60"
data-icon-left-color="blue"
data-icon-right-color="red"

class="valueonly">

</div>
</div>
</div>
</div>
</div>

</div>

<div class="vbox phone-width">
<div class="card lift">
<header>Wasserverbrauch</header>
<section>
<div id="JUDO_iSoft"
data-type="highchart"
data-device="JUDO_iSoft"
data-logdevice="FileLog_JUDO_ISoft"
data-columnspec="4:water-current"
data-style="ftui l0fill"
data-linenames="Verbrauch"
data-linetypes="line"
data-yaxis="0,1"
data-height="300"
data-xunit="Uhrzeit"
data-yunit="l"
data-tooltip="{series.name} <b>{point.y:,.1f}</b>"
data-daysago="7"
data-yticks="auto"
data-legendalign="right">

</section>

</div
</div>
</div>
</pre>

== Ähnliche Systeme ==

== Projekte der FHEM-Community ==

== Links ==
* {{Link2Forum|Topic=56455|Message=800960}}
* [https://blog.muwave.de/2017/06/monitoring-and-controlling-a-judo-i-soft-plus-water-softening-device-via-lan/ ursprünglicher Beitrag bzgl. des verwendeten Protokolls]

[[Kategorie:IP Components]]
[[Kategorie:Other Components]]

JUDO iSoft Plus

2018-10-06T04:02:13Z

Loungelizard: /* Einbindung in FHEM */ - Standard-Abfrage geändert

{{Infobox Hardware
|Bild=judo-soft-plus.jpg|200px
|Bildbeschreibung=JUDO iSoft Plus Wasserenthärtungsanlage
|HWProtocol=IP
|HWType=Wasserenthärter
|HWCategory=IP
|HWVoltage=230 V
|HWPoweredBy=AC
|HWSize=39x67x45 cm (BxHxT)
|HWComm=n/a
|HWChannels=n/a
|HWPowerConsumption=?
|HWDeviceFHEM=[[HTTPMOD]]

|HWManufacturer=Judo GmbH
}}
__TOC__

Die JUDO i-soft plus Enthärtungsanlage [https://judo.eu/produkt/judo-i-soft-plus-vollautomatische-enthaertungsanlage/] ist eine Wasserenthärtungsanlage mit IP-Konnektivität.
Sie verfügt über LAN und WLAN-Anschluss und ist auf die Steuerung via App des Herstellers ausgelegt.

Für eine erfolgreiche Integration in FHEM muss die Anlage über das Menü beim Hersteller registriert werden.
Die folgenden Informationen sind erforderlich:

* Benutzername: Selbst gewählter Login-Name auf der iSoft plus (vgl. Gerätehandbuch)
* Kennwort: Selbst gewähltes Kennwort
* Seriennummer: Seriennummer des Geräts. Diese ist entweder über das Menü auslesbar oder alternativ auch über die APP des Herstellers.
* IP-Adresse: Die IP-Adresse des Geräts im Heimnetz.

== Einbindung in FHEM ==

Das Gerät wird mittels des Moduls HTTPMOD eingebunden. Dazu gilt zunächst die folgende Konfiguration als Basis.
Zunächst legen wir die Standardanfrage an das Modul fest. Die Portnummer 8124 ist vom Hersteller vorgegeben. Wir vergeben gleich ein paar Platzhalter, die später in den Aufrufen und den Antworten ersetzt werden, damit wir die Werte nur an einer zentralen Stelle konfigurieren müssen.

<pre>
define JUDO_iSoft HTTPMOD https://%JUDO_ipaddress%:8124/?group=waterstop&command=valve&msgnumber=4&token=%token% 300
</pre>
Mit dieser Definition wird als Standard-Anfrage die Statusabfrage nach dem Wasserstop gesendet. Diese wird zyklisch alle 300 Sekunden wiederholt.
Wem das nicht reicht, der kann den Zyklus herunter setzen oder auch nach anderen Standard-Werten abfragen. Wer das kontinuierliche Pollen vermeiden will, setzt den Wert auf 0.

Nach erfolgreicher Authentifizierung wird von der iSoft ein Token generiert und muss bei jedem Aufruf übergeben werden:

<pre>
attr JUDO_iSoft replacement01Mode reading
attr JUDO_iSoft replacement01Regex %token%
attr JUDO_iSoft replacement01Value token
</pre>

Anschließend legen wir die Ersetzungen für die anderen Platzhalter fest:

<pre>
attr JUDO_iSoft replacement02Mode text
attr JUDO_iSoft replacement02Regex %JUDO_ipaddress%
attr JUDO_iSoft replacement02Value <hier eigene IP Adresse im lokalen Netz eintragen>
attr JUDO_iSoft replacement03Mode text
attr JUDO_iSoft replacement03Regex %JUDO_password%
attr JUDO_iSoft replacement03Value <hier Kennwort eintragen>
attr JUDO_iSoft replacement04Mode text
attr JUDO_iSoft replacement04Regex %JUDO_username%
attr JUDO_iSoft replacement04Value <hier Benutzername eintragen>
attr JUDO_iSoft replacement05Mode text
attr JUDO_iSoft replacement05Regex %JUDO_serial%
attr JUDO_iSoft replacement05Value <hier Seriennummer eintragen>
</pre>

Die Authentifizierung der Anlage erfolgt zwei-stufig. Zunächst muss ein Aufruf mit Benutzername und Kennwort erfolgen. Als Antwort erhält man einen JSON-String, der das Token beinhaltet. Mit diesem Token wird anschließend die Funktion connect aufgerufen und die Seriennummer des Geräts mit übergeben.
HTTPMOD erkennt, wenn ein neues Login erforderlich ist, wenn die Judo die Rückmeldung "no token" oder "not logged in" liefert.

Achtung: Als Parameter muss ebenfalls der Typ "i-soft plus" übergeben werden. Vermutlich ist dieser bei anderen Geräten des Herstellers anders. Ich habe ihn hier fix eingetragen, da ich keine Möglichkeit zum Testen anderer Geräte habe.

<pre>
attr JUDO_iSoft showError 1
attr JUDO_iSoft authRetries 2
attr JUDO_iSoft reAuthRegex (no token)|(not logged in)
attr JUDO_iSoft sid01ParseResponse 1
attr JUDO_iSoft sid01URL https://%JUDO_ipaddress%:8124/?group=register&command=login&msgnumber=1&name=login&user=%JUDO_username%&password=%JUDO_password%&role=customer
attr JUDO_iSoft sid02URL https://%JUDO_ipaddress%:8124/?group=register&command=connect&msgnumber=6&token=%token%&parameter=i-soft%20plus&serial%20number=%JUDO_serial%
</pre>

Damit ist die Grundkonfiguration hergestellt und die Anlage kann sich connecten.
In den einzelnen JSON-Rückantworten der Anlage werden die Werte zur jeweilige Anfrage immer als "data" zurück geliefert. Mit der Standard-Konfiguration

<pre>
attr JUDO_iSoft extractAllJSON 1
</pre>

werden daraus automatisch entsprechernde Readings angelegt. Da wir aber dann immer das Reading "data" überschreiben würde, kommt eine weitere Ersetzung zum Einsatz. In der Antwort steht neben einer Kaskadierung (group) auch der zugehörige Befehl (command). Ich habe mich dafür entschieden, ein neues Reading mit dem jeweiligen Command-Namen anzulegen. Die zugehörigen Ersetzungen sind wie folgt.
Erklärung zum Ausdruck reading03OExpr: Zunächst werden die Leerzeichen im Rückgabewert ($val) durch "-" ersetzt. Mit dem so veränderten String erzeugen wir ein neues Reading mit dem Wert aus dem Reading data.

<pre>
attr JUDO_iSoft reading01JSON data
attr JUDO_iSoft reading01Name token
attr JUDO_iSoft reading01Regex "token":"([^"]+)"
attr JUDO_iSoft reading02JSON group
attr JUDO_iSoft reading03JSON command
attr JUDO_iSoft reading03OExpr $val =~ s/\s/-/;; $val; readingsBulkUpdate($hash,$val,ReadingsVal("JUDO_iSoft","data",""))
</pre>
Noch ein paar ergänzende Attribute gesetzt:
<pre>
attr JUDO_iSoft enableControlSet 1
attr JUDO_iSoft getHeader1 Content-Type: application/json
attr JUDO_iSoft getHeader2 Accept: */*
attr JUDO_iSoft room 10_Räume->UG->Keller,
attr JUDO_iSoft showError
attr JUDO_iSoft timeout 5
</pre>

Damit sind alle Voraussetzungen erledigt. Ab jetzt können wir die einzelnen Get-Befehle implementieren:

<pre>
attr JUDO_iSoft get01Name SerialNumber
attr JUDO_iSoft get01URL https://%JUDO_ipaddress%:8124/?group=spare%20part&command=serial%20number&msgnumber=5&token=%token%

attr JUDO_iSoft get02Name WaterCurrent
attr JUDO_iSoft get02URL https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20current&msgnumber=1&token=%token%

attr JUDO_iSoft get03Name SaltRange
attr JUDO_iSoft get03URL https://%JUDO_ipaddress%:8124/?group=consumption&command=salt%20range&msgnumber=1&token=%token%

attr JUDO_iSoft get04Name SaltQuantity
attr JUDO_iSoft get04URL https://%JUDO_ipaddress%:8124/?group=consumption&command=salt%20quantity&msgnumber=1&token=%token%

attr JUDO_iSoft get05Name ResidualHardness
attr JUDO_iSoft get05URL https://%JUDO_ipaddress%:8124/?group=settings&command=residual%20hardness&msgnumber=1&token=%token%

attr JUDO_iSoft get06Name NaturalHardness
attr JUDO_iSoft get06URL https://%JUDO_ipaddress%:8124/?group=info&command=natural%20hardness&msgnumber=1&token=%token%

attr JUDO_iSoft get07Name WaterStop
attr JUDO_iSoft get07URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=valve&msgnumber=1&token=%token%

attr JUDO_iSoft get08Name FlowRate
attr JUDO_iSoft get08URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=flow%20rate&msgnumber=1&token=%token%

attr JUDO_iSoft get09Name SoftwareVersion
attr JUDO_iSoft get09URL https://%JUDO_ipaddress%:8124/?group=version&command=software%20version&msgnumber=1&token=%token%

attr JUDO_iSoft get10Name HardwareVersion
attr JUDO_iSoft get10URL https://%JUDO_ipaddress%:8124/?group=version&command=hardware%20version&msgnumber=1&token=%token%

attr JUDO_iSoft get11Name InstallationDate
attr JUDO_iSoft get11URL https://%JUDO_ipaddress%:8124/?group=contract&command=init%20date&msgnumber=1&token=%token%

attr JUDO_iSoft get12Name ServiceDate
attr JUDO_iSoft get12URL https://%JUDO_ipaddress%:8124/?group=contract&command=service%20date&msgnumber=1&token=%token%

attr JUDO_iSoft get13Name WaterTotal
attr JUDO_iSoft get13URL https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20total&msgnumber=1&token=%token%

attr JUDO_iSoft get14Name WaterAverage
attr JUDO_iSoft get14URL https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20average&msgnumber=1&token=%token%

attr JUDO_iSoft get15Name Vacation
attr JUDO_iSoft get15URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=vacation&msgnumber=1&token=%token%

attr JUDO_iSoft get16Name Quantity
attr JUDO_iSoft get16URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=quantity&msgnumber=1&token=%token%

attr JUDO_iSoft get17Name WaterDaily
attr JUDO_iSoft get17URL https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20daily&msgnumber=1&token=%token%

attr JUDO_iSoft get18Name ValveState
attr JUDO_iSoft get18URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=valve&msgnumber=4&&token=%token%

</pre>

Zum Setzen einiger Werte werden die folgenden Kommandos zum Schließen und Öffnen des Wasserstopps sowie das Setzen der Wunschwasserhärte implementiert

<pre>
attr JUDO_iSoft set01Name CloseValve
attr JUDO_iSoft set01URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=valve&msgnumber=1&token=%token%&parameter=close
attr JUDO_iSoft set02Name OpenValve
attr JUDO_iSoft set02URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=valve&msgnumber=1&token=%token%&parameter=open
attr JUDO_iSoft set03Name residual-hardness
attr JUDO_iSoft set03URL https://%JUDO_ipaddress%:8124/?group=settings&command=residual%20hardness&msgnumber=1&token=%token%&parameter=$val
</pre>

'''Userreadings'''

Um die Originalwerte aus der Anlage benutzerfreundlicher darzzustellen, werden noch Userreadings angelegt.

Die Salzrestdauer soll in Wochen angegeben (Rückgemeldet werden Tage) werden, die verbleibende Salzmenge in Prozent.
Die Salzemnge wird in Gramm angegeben, 50.000 entsprechen 100%.
Wichtig: Bei den Userreadings muss darauf geachtet werden, dass diese mit Komma separiert und in einer Zeile geschrieben werden.
<pre>

attr JUDO_iSoft saltRangeInWeeks { int( (ReadingsVal("JUDO_iSoft","salt-range",0)/7))} , saltQuantityInPercent { int( (ReadingsVal("JUDO_iSoft","salt-quantity",0)/50000)*100)}
</pre>

== Statistiken ==
Die iSoftPlus liefert verschiedene Statistiken zum Wasserverbrauch zurück. Die werden allerdings etwas eigentümlich zurückgemeldet.
Unter water-current ist der jeweilige Verbrauch je Stunde zusammengefasst. Ich hole kurz vor der vollen Stunde diesen Wert ab, damit er danach im Logfile landet.
Unter water-daily werden Tagesstatistiken geliefert. Kurioserweise in 3-Stunden-Paketen, d.h. 8 Werte. Die ersten Wert sind von 0h-3h, 3h-6h usw.
Ich habe mich aktuell darauf beschränkt, den stündlichen Verbrauch zu erfassen und zu protokollieren. Es lassen sich aber auch bei Bedarf detaillierte Datumsbezogene Statistiken abrufen. Ich habe noch keinen sinnvollen Weg gefunden, das mit fhem zu verbinden.

== Darstellung in Tablet UI ==
Ich nutze Tablet UI für die Visualisierung.
Zur Darstellung der Restmengen Salz nutze ich das knob-widget, für das Setzen des Härtegrades den spinner.

[[Datei:Screenshot judo 2.jpg|mini|Visualisierung der Judo im TabletUI|200px]]

<pre>
<div class="hbox">

<div class="vbox phone-width">
<div class="card lift">
<header>Zustand Salz</header>
<div class="sheet">

<div class="row">
<div class="cell-50 top-align center-align left-space">
<div class="big">Restmenge</div>
<div data-type="knob" data-device="JUDO_iSoft"
data-get="saltQuantityInPercent"
data-unit="%"
data-step="1"
data-min="0"
data-max="100"
data-bgcolor="#FF0000"
data-fgcolor="#00FF1A"
class="small readonly">
</div>

</div>
<div class="cell-50 top-align center-align left-space">
<div class="big">Reichweite</div>

<div data-type="knob" data-device="JUDO_iSoft"
data-get="saltRangeInWeeks"
data-unit="w"
data-step="1"
data-min="0"
data-max="52"
data-bgcolor="#FF0000"
data-fgcolor="#00FF1A"
class="small readonly">
</div>

</div>
</div>
</div>
</div>
</div>
<div class="vbox phone-width">
<div class="card lift">
<header>Wasserstopp</header>
<div class="sheet">
<div class="row top-space">

<div class="cell left-align top-align left-space">
<div data-type="symbol" data-device="JUDO_iSoft" data-get="valve"
data-icons='["fa-close","fa-close","oa-sani_water_tap","oa-sani_water_tap"]'
data-get-on='["closed","closing","opening","opened"]'
data-on-colors='["#ad3333","#ff6633","#3399ff","#33ad33"]' class="big compressed"></div>
</div>
<div class="cell-60 top-align center-align">
<div class="big">

<div data-type="label"
data-get="valve"
class="valueonly"
data-substitution='["opened","geöffnet","opening","öffnet gerade","closed","geschlossen","closing","schließt gerade"]'
data-device="JUDO_iSoft"
data-color="lightgrey">
</div>
</div>

</div>

<div class="cell left-align top-align left-space">
<div data-type="push" data-device="JUDO_iSoft" data-set-on="CloseValve 1" data-get-on="valve" data-background-icon="fa-stop-circle-o" data-icon="" class="small"></div>

</div>
<div class="cell right-align top-align right-space">

<div data-type="push" data-device="JUDO_iSoft" data-set-on="OpenValve 1" data-get-on="valve" data-background-icon="mi-play_circle_filled" data-icon="" class="small"></div>
</div>
</div>
</div>
</div>
</div>

<div class="vbox phone-width">
<div class="card lift">
<header>Wasserhärtegrad</header>

<div class="sheet">
<div class="row">

<div class="cell-20 center-align top-align left-space">
<div data-type="symbol"
data-device="JUDO_iSoft"
data-icon="none"
data-color='none'
data-height="100"
data-background-icon="fa-circle"
data-background-colors='["red","blue"]'
data-limits='["0","1"]'>
<div data-type="label"
data-get="natural-hardness"
data-unit="°h"
class="valueonly"
data-device="JUDO_iSoft"
data-color="lightgrey">
</div>
</div>
</div>

<div class="cell-20 top-align center-align left-space">
<div data-type="image" data-size="50%" data-url="images/judo.png"></div>
</div>

<div class="cell-60 top-align center-align left-space">

<div data-type="spinner"
data-device="JUDO_iSoft"
data-get="residual-hardness"
data-set="residual-hardness"
data-min=5"
data-max="12"
data-step="1"
data-unit="°h"
data-longdelay="800"
data-width="200"
data-height="60"
data-icon-left-color="blue"
data-icon-right-color="red"

class="valueonly">

</div>
</div>
</div>
</div>
</div>

</div>

<div class="vbox phone-width">
<div class="card lift">
<header>Wasserverbrauch</header>
<section>
<div id="JUDO_iSoft"
data-type="highchart"
data-device="JUDO_iSoft"
data-logdevice="FileLog_JUDO_ISoft"
data-columnspec="4:water-current"
data-style="ftui l0fill"
data-linenames="Verbrauch"
data-linetypes="line"
data-yaxis="0,1"
data-height="300"
data-xunit="Uhrzeit"
data-yunit="l"
data-tooltip="{series.name} <b>{point.y:,.1f}</b>"
data-daysago="7"
data-yticks="auto"
data-legendalign="right">

</section>

</div
</div>
</div>
</pre>

== Ähnliche Systeme ==

== Projekte der FHEM-Community ==

== Links ==
* {{Link2Forum|Topic=56455|Message=800960}}
* [https://blog.muwave.de/2017/06/monitoring-and-controlling-a-judo-i-soft-plus-water-softening-device-via-lan/ ursprünglicher Beitrag bzgl. des verwendeten Protokolls]

[[Kategorie:IP Components]]
[[Kategorie:Other Components]]

JUDO iSoft Plus

2018-10-05T22:20:04Z

Loungelizard: Neuer Screenshot

{{Infobox Hardware
|Bild=judo-soft-plus.jpg|200px
|Bildbeschreibung=JUDO iSoft Plus Wasserenthärtungsanlage
|HWProtocol=IP
|HWType=Wasserenthärter
|HWCategory=IP
|HWVoltage=230 V
|HWPoweredBy=AC
|HWSize=39x67x45 cm (BxHxT)
|HWComm=n/a
|HWChannels=n/a
|HWPowerConsumption=?
|HWDeviceFHEM=[[HTTPMOD]]

|HWManufacturer=Judo GmbH
}}
__TOC__

Die JUDO i-soft plus Enthärtungsanlage [https://judo.eu/produkt/judo-i-soft-plus-vollautomatische-enthaertungsanlage/] ist eine Wasserenthärtungsanlage mit IP-Konnektivität.
Sie verfügt über LAN und WLAN-Anschluss und ist auf die Steuerung via App des Herstellers ausgelegt.

Für eine erfolgreiche Integration in FHEM muss die Anlage über das Menü beim Hersteller registriert werden.
Die folgenden Informationen sind erforderlich:

* Benutzername: Selbst gewählter Login-Name auf der iSoft plus (vgl. Gerätehandbuch)
* Kennwort: Selbst gewähltes Kennwort
* Seriennummer: Seriennummer des Geräts. Diese ist entweder über das Menü auslesbar oder alternativ auch über die APP des Herstellers.
* IP-Adresse: Die IP-Adresse des Geräts im Heimnetz.

== Einbindung in FHEM ==

Das Gerät wird mittels des Moduls HTTPMOD eingebunden. Dazu gilt zunächst die folgende Konfiguration als Basis.
Zunächst legen wir die Standardanfrage an das Modul fest. Die Portnummer 8124 ist vom Hersteller vorgegeben. Wir vergeben gleich ein paar Platzhalter, die später in den Aufrufen und den Antworten ersetzt werden, damit wir die Werte nur an einer zentralen Stelle konfigurieren müssen.

<pre>
define JUDO_iSoft HTTPMOD https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20current&msgnumber=1&token=%token%
</pre>

Nach erfolgreicher Authentifizierung wird von der iSoft ein Token generiert und muss bei jedem Aufruf übergeben werden:

<pre>
attr JUDO_iSoft replacement01Mode reading
attr JUDO_iSoft replacement01Regex %token%
attr JUDO_iSoft replacement01Value token
</pre>

Anschließend legen wir die Ersetzungen für die anderen Platzhalter fest:

<pre>
attr JUDO_iSoft replacement02Mode text
attr JUDO_iSoft replacement02Regex %JUDO_ipaddress%
attr JUDO_iSoft replacement02Value <hier eigene IP Adresse im lokalen Netz eintragen>
attr JUDO_iSoft replacement03Mode text
attr JUDO_iSoft replacement03Regex %JUDO_password%
attr JUDO_iSoft replacement03Value <hier Kennwort eintragen>
attr JUDO_iSoft replacement04Mode text
attr JUDO_iSoft replacement04Regex %JUDO_username%
attr JUDO_iSoft replacement04Value <hier Benutzername eintragen>
attr JUDO_iSoft replacement05Mode text
attr JUDO_iSoft replacement05Regex %JUDO_serial%
attr JUDO_iSoft replacement05Value <hier Seriennummer eintragen>
</pre>

Die Authentifizierung der Anlage erfolgt zwei-stufig. Zunächst muss ein Aufruf mit Benutzername und Kennwort erfolgen. Als Antwort erhält man einen JSON-String, der das Token beinhaltet. Mit diesem Token wird anschließend die Funktion connect aufgerufen und die Seriennummer des Geräts mit übergeben.
HTTPMOD erkennt, wenn ein neues Login erforderlich ist, wenn die Judo die Rückmeldung "no token" oder "not logged in" liefert.

Achtung: Als Parameter muss ebenfalls der Typ "i-soft plus" übergeben werden. Vermutlich ist dieser bei anderen Geräten des Herstellers anders. Ich habe ihn hier fix eingetragen, da ich keine Möglichkeit zum Testen anderer Geräte habe.

<pre>
attr JUDO_iSoft showError 1
attr JUDO_iSoft authRetries 2
attr JUDO_iSoft reAuthRegex (no token)|(not logged in)
attr JUDO_iSoft sid01ParseResponse 1
attr JUDO_iSoft sid01URL https://%JUDO_ipaddress%:8124/?group=register&command=login&msgnumber=1&name=login&user=%JUDO_username%&password=%JUDO_password%&role=customer
attr JUDO_iSoft sid02URL https://%JUDO_ipaddress%:8124/?group=register&command=connect&msgnumber=6&token=%token%&parameter=i-soft%20plus&serial%20number=%JUDO_serial%
</pre>

Damit ist die Grundkonfiguration hergestellt und die Anlage kann sich connecten.
In den einzelnen JSON-Rückantworten der Anlage werden die Werte zur jeweilige Anfrage immer als "data" zurück geliefert. Mit der Standard-Konfiguration

<pre>
attr JUDO_iSoft extractAllJSON 1
</pre>

werden daraus automatisch entsprechernde Readings angelegt. Da wir aber dann immer das Reading "data" überschreiben würde, kommt eine weitere Ersetzung zum Einsatz. In der Antwort steht neben einer Kaskadierung (group) auch der zugehörige Befehl (command). Ich habe mich dafür entschieden, ein neues Reading mit dem jeweiligen Command-Namen anzulegen. Die zugehörigen Ersetzungen sind wie folgt.
Erklärung zum Ausdruck reading03OExpr: Zunächst werden die Leerzeichen im Rückgabewert ($val) durch "-" ersetzt. Mit dem so veränderten String erzeugen wir ein neues Reading mit dem Wert aus dem Reading data.

<pre>
attr JUDO_iSoft reading01JSON data
attr JUDO_iSoft reading01Name token
attr JUDO_iSoft reading01Regex "token":"([^"]+)"
attr JUDO_iSoft reading02JSON group
attr JUDO_iSoft reading03JSON command
attr JUDO_iSoft reading03OExpr $val =~ s/\s/-/;; $val; readingsBulkUpdate($hash,$val,ReadingsVal("JUDO_iSoft","data",""))
</pre>
Noch ein paar ergänzende Attribute gesetzt:
<pre>
attr JUDO_iSoft enableControlSet 1
attr JUDO_iSoft getHeader1 Content-Type: application/json
attr JUDO_iSoft getHeader2 Accept: */*
attr JUDO_iSoft room 10_Räume->UG->Keller,
attr JUDO_iSoft showError
attr JUDO_iSoft timeout 5
</pre>

Damit sind alle Voraussetzungen erledigt. Ab jetzt können wir die einzelnen Get-Befehle implementieren:

<pre>
attr JUDO_iSoft get01Name SerialNumber
attr JUDO_iSoft get01URL https://%JUDO_ipaddress%:8124/?group=spare%20part&command=serial%20number&msgnumber=5&token=%token%

attr JUDO_iSoft get02Name WaterCurrent
attr JUDO_iSoft get02URL https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20current&msgnumber=1&token=%token%

attr JUDO_iSoft get03Name SaltRange
attr JUDO_iSoft get03URL https://%JUDO_ipaddress%:8124/?group=consumption&command=salt%20range&msgnumber=1&token=%token%

attr JUDO_iSoft get04Name SaltQuantity
attr JUDO_iSoft get04URL https://%JUDO_ipaddress%:8124/?group=consumption&command=salt%20quantity&msgnumber=1&token=%token%

attr JUDO_iSoft get05Name ResidualHardness
attr JUDO_iSoft get05URL https://%JUDO_ipaddress%:8124/?group=settings&command=residual%20hardness&msgnumber=1&token=%token%

attr JUDO_iSoft get06Name NaturalHardness
attr JUDO_iSoft get06URL https://%JUDO_ipaddress%:8124/?group=info&command=natural%20hardness&msgnumber=1&token=%token%

attr JUDO_iSoft get07Name WaterStop
attr JUDO_iSoft get07URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=valve&msgnumber=1&token=%token%

attr JUDO_iSoft get08Name FlowRate
attr JUDO_iSoft get08URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=flow%20rate&msgnumber=1&token=%token%

attr JUDO_iSoft get09Name SoftwareVersion
attr JUDO_iSoft get09URL https://%JUDO_ipaddress%:8124/?group=version&command=software%20version&msgnumber=1&token=%token%

attr JUDO_iSoft get10Name HardwareVersion
attr JUDO_iSoft get10URL https://%JUDO_ipaddress%:8124/?group=version&command=hardware%20version&msgnumber=1&token=%token%

attr JUDO_iSoft get11Name InstallationDate
attr JUDO_iSoft get11URL https://%JUDO_ipaddress%:8124/?group=contract&command=init%20date&msgnumber=1&token=%token%

attr JUDO_iSoft get12Name ServiceDate
attr JUDO_iSoft get12URL https://%JUDO_ipaddress%:8124/?group=contract&command=service%20date&msgnumber=1&token=%token%

attr JUDO_iSoft get13Name WaterTotal
attr JUDO_iSoft get13URL https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20total&msgnumber=1&token=%token%

attr JUDO_iSoft get14Name WaterAverage
attr JUDO_iSoft get14URL https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20average&msgnumber=1&token=%token%

attr JUDO_iSoft get15Name Vacation
attr JUDO_iSoft get15URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=vacation&msgnumber=1&token=%token%

attr JUDO_iSoft get16Name Quantity
attr JUDO_iSoft get16URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=quantity&msgnumber=1&token=%token%

attr JUDO_iSoft get17Name WaterDaily
attr JUDO_iSoft get17URL https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20daily&msgnumber=1&token=%token%

attr JUDO_iSoft get18Name ValveState
attr JUDO_iSoft get18URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=valve&msgnumber=4&&token=%token%

</pre>

Zum Setzen einiger Werte werden die folgenden Kommandos zum Schließen und Öffnen des Wasserstopps sowie das Setzen der Wunschwasserhärte implementiert

<pre>
attr JUDO_iSoft set01Name CloseValve
attr JUDO_iSoft set01URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=valve&msgnumber=1&token=%token%&parameter=close
attr JUDO_iSoft set02Name OpenValve
attr JUDO_iSoft set02URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=valve&msgnumber=1&token=%token%&parameter=open
attr JUDO_iSoft set03Name residual-hardness
attr JUDO_iSoft set03URL https://%JUDO_ipaddress%:8124/?group=settings&command=residual%20hardness&msgnumber=1&token=%token%&parameter=$val
</pre>

'''Userreadings'''

Um die Originalwerte aus der Anlage benutzerfreundlicher darzzustellen, werden noch Userreadings angelegt.

Die Salzrestdauer soll in Wochen angegeben (Rückgemeldet werden Tage) werden, die verbleibende Salzmenge in Prozent.
Die Salzemnge wird in Gramm angegeben, 50.000 entsprechen 100%.
Wichtig: Bei den Userreadings muss darauf geachtet werden, dass diese mit Komma separiert und in einer Zeile geschrieben werden.
<pre>

attr JUDO_iSoft saltRangeInWeeks { int( (ReadingsVal("JUDO_iSoft","salt-range",0)/7))} , saltQuantityInPercent { int( (ReadingsVal("JUDO_iSoft","salt-quantity",0)/50000)*100)}
</pre>

== Statistiken ==
Die iSoftPlus liefert verschiedene Statistiken zum Wasserverbrauch zurück. Die werden allerdings etwas eigentümlich zurückgemeldet.
Unter water-current ist der jeweilige Verbrauch je Stunde zusammengefasst. Ich hole kurz vor der vollen Stunde diesen Wert ab, damit er danach im Logfile landet.
Unter water-daily werden Tagesstatistiken geliefert. Kurioserweise in 3-Stunden-Paketen, d.h. 8 Werte. Die ersten Wert sind von 0h-3h, 3h-6h usw.
Ich habe mich aktuell darauf beschränkt, den stündlichen Verbrauch zu erfassen und zu protokollieren. Es lassen sich aber auch bei Bedarf detaillierte Datumsbezogene Statistiken abrufen. Ich habe noch keinen sinnvollen Weg gefunden, das mit fhem zu verbinden.

== Darstellung in Tablet UI ==
Ich nutze Tablet UI für die Visualisierung.
Zur Darstellung der Restmengen Salz nutze ich das knob-widget, für das Setzen des Härtegrades den spinner.

[[Datei:Screenshot judo 2.jpg|mini|Visualisierung der Judo im TabletUI|200px]]

<pre>
<div class="hbox">

<div class="vbox phone-width">
<div class="card lift">
<header>Zustand Salz</header>
<div class="sheet">

<div class="row">
<div class="cell-50 top-align center-align left-space">
<div class="big">Restmenge</div>
<div data-type="knob" data-device="JUDO_iSoft"
data-get="saltQuantityInPercent"
data-unit="%"
data-step="1"
data-min="0"
data-max="100"
data-bgcolor="#FF0000"
data-fgcolor="#00FF1A"
class="small readonly">
</div>

</div>
<div class="cell-50 top-align center-align left-space">
<div class="big">Reichweite</div>

<div data-type="knob" data-device="JUDO_iSoft"
data-get="saltRangeInWeeks"
data-unit="w"
data-step="1"
data-min="0"
data-max="52"
data-bgcolor="#FF0000"
data-fgcolor="#00FF1A"
class="small readonly">
</div>

</div>
</div>
</div>
</div>
</div>
<div class="vbox phone-width">
<div class="card lift">
<header>Wasserstopp</header>
<div class="sheet">
<div class="row top-space">

<div class="cell left-align top-align left-space">
<div data-type="symbol" data-device="JUDO_iSoft" data-get="valve"
data-icons='["fa-close","fa-close","oa-sani_water_tap","oa-sani_water_tap"]'
data-get-on='["closed","closing","opening","opened"]'
data-on-colors='["#ad3333","#ff6633","#3399ff","#33ad33"]' class="big compressed"></div>
</div>
<div class="cell-60 top-align center-align">
<div class="big">

<div data-type="label"
data-get="valve"
class="valueonly"
data-substitution='["opened","geöffnet","opening","öffnet gerade","closed","geschlossen","closing","schließt gerade"]'
data-device="JUDO_iSoft"
data-color="lightgrey">
</div>
</div>

</div>

<div class="cell left-align top-align left-space">
<div data-type="push" data-device="JUDO_iSoft" data-set-on="CloseValve 1" data-get-on="valve" data-background-icon="fa-stop-circle-o" data-icon="" class="small"></div>

</div>
<div class="cell right-align top-align right-space">

<div data-type="push" data-device="JUDO_iSoft" data-set-on="OpenValve 1" data-get-on="valve" data-background-icon="mi-play_circle_filled" data-icon="" class="small"></div>
</div>
</div>
</div>
</div>
</div>

<div class="vbox phone-width">
<div class="card lift">
<header>Wasserhärtegrad</header>

<div class="sheet">
<div class="row">

<div class="cell-20 center-align top-align left-space">
<div data-type="symbol"
data-device="JUDO_iSoft"
data-icon="none"
data-color='none'
data-height="100"
data-background-icon="fa-circle"
data-background-colors='["red","blue"]'
data-limits='["0","1"]'>
<div data-type="label"
data-get="natural-hardness"
data-unit="°h"
class="valueonly"
data-device="JUDO_iSoft"
data-color="lightgrey">
</div>
</div>
</div>

<div class="cell-20 top-align center-align left-space">
<div data-type="image" data-size="50%" data-url="images/judo.png"></div>
</div>

<div class="cell-60 top-align center-align left-space">

<div data-type="spinner"
data-device="JUDO_iSoft"
data-get="residual-hardness"
data-set="residual-hardness"
data-min=5"
data-max="12"
data-step="1"
data-unit="°h"
data-longdelay="800"
data-width="200"
data-height="60"
data-icon-left-color="blue"
data-icon-right-color="red"

class="valueonly">

</div>
</div>
</div>
</div>
</div>

</div>

<div class="vbox phone-width">
<div class="card lift">
<header>Wasserverbrauch</header>
<section>
<div id="JUDO_iSoft"
data-type="highchart"
data-device="JUDO_iSoft"
data-logdevice="FileLog_JUDO_ISoft"
data-columnspec="4:water-current"
data-style="ftui l0fill"
data-linenames="Verbrauch"
data-linetypes="line"
data-yaxis="0,1"
data-height="300"
data-xunit="Uhrzeit"
data-yunit="l"
data-tooltip="{series.name} <b>{point.y:,.1f}</b>"
data-daysago="7"
data-yticks="auto"
data-legendalign="right">

</section>

</div
</div>
</div>
</pre>

== Ähnliche Systeme ==

== Projekte der FHEM-Community ==

== Links ==
* {{Link2Forum|Topic=56455|Message=800960}}
* [https://blog.muwave.de/2017/06/monitoring-and-controlling-a-judo-i-soft-plus-water-softening-device-via-lan/ ursprünglicher Beitrag bzgl. des verwendeten Protokolls]

[[Kategorie:IP Components]]
[[Kategorie:Other Components]]

Datei:Screenshot judo 2.jpg

2018-10-05T22:18:40Z

Loungelizard:

Visualisierung Tablet UI der Judo iSoft

JUDO iSoft Plus

2018-10-05T22:17:18Z

Loungelizard: /* Darstellung in Tablet UI */

{{Infobox Hardware
|Bild=judo-soft-plus.jpg|200px
|Bildbeschreibung=JUDO iSoft Plus Wasserenthärtungsanlage
|HWProtocol=IP
|HWType=Wasserenthärter
|HWCategory=IP
|HWVoltage=230 V
|HWPoweredBy=AC
|HWSize=39x67x45 cm (BxHxT)
|HWComm=n/a
|HWChannels=n/a
|HWPowerConsumption=?
|HWDeviceFHEM=[[HTTPMOD]]

|HWManufacturer=Judo GmbH
}}
__TOC__

Die JUDO i-soft plus Enthärtungsanlage [https://judo.eu/produkt/judo-i-soft-plus-vollautomatische-enthaertungsanlage/] ist eine Wasserenthärtungsanlage mit IP-Konnektivität.
Sie verfügt über LAN und WLAN-Anschluss und ist auf die Steuerung via App des Herstellers ausgelegt.

Für eine erfolgreiche Integration in FHEM muss die Anlage über das Menü beim Hersteller registriert werden.
Die folgenden Informationen sind erforderlich:

* Benutzername: Selbst gewählter Login-Name auf der iSoft plus (vgl. Gerätehandbuch)
* Kennwort: Selbst gewähltes Kennwort
* Seriennummer: Seriennummer des Geräts. Diese ist entweder über das Menü auslesbar oder alternativ auch über die APP des Herstellers.
* IP-Adresse: Die IP-Adresse des Geräts im Heimnetz.

== Einbindung in FHEM ==

Das Gerät wird mittels des Moduls HTTPMOD eingebunden. Dazu gilt zunächst die folgende Konfiguration als Basis.
Zunächst legen wir die Standardanfrage an das Modul fest. Die Portnummer 8124 ist vom Hersteller vorgegeben. Wir vergeben gleich ein paar Platzhalter, die später in den Aufrufen und den Antworten ersetzt werden, damit wir die Werte nur an einer zentralen Stelle konfigurieren müssen.

<pre>
define JUDO_iSoft HTTPMOD https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20current&msgnumber=1&token=%token%
</pre>

Nach erfolgreicher Authentifizierung wird von der iSoft ein Token generiert und muss bei jedem Aufruf übergeben werden:

<pre>
attr JUDO_iSoft replacement01Mode reading
attr JUDO_iSoft replacement01Regex %token%
attr JUDO_iSoft replacement01Value token
</pre>

Anschließend legen wir die Ersetzungen für die anderen Platzhalter fest:

<pre>
attr JUDO_iSoft replacement02Mode text
attr JUDO_iSoft replacement02Regex %JUDO_ipaddress%
attr JUDO_iSoft replacement02Value <hier eigene IP Adresse im lokalen Netz eintragen>
attr JUDO_iSoft replacement03Mode text
attr JUDO_iSoft replacement03Regex %JUDO_password%
attr JUDO_iSoft replacement03Value <hier Kennwort eintragen>
attr JUDO_iSoft replacement04Mode text
attr JUDO_iSoft replacement04Regex %JUDO_username%
attr JUDO_iSoft replacement04Value <hier Benutzername eintragen>
attr JUDO_iSoft replacement05Mode text
attr JUDO_iSoft replacement05Regex %JUDO_serial%
attr JUDO_iSoft replacement05Value <hier Seriennummer eintragen>
</pre>

Die Authentifizierung der Anlage erfolgt zwei-stufig. Zunächst muss ein Aufruf mit Benutzername und Kennwort erfolgen. Als Antwort erhält man einen JSON-String, der das Token beinhaltet. Mit diesem Token wird anschließend die Funktion connect aufgerufen und die Seriennummer des Geräts mit übergeben.
HTTPMOD erkennt, wenn ein neues Login erforderlich ist, wenn die Judo die Rückmeldung "no token" oder "not logged in" liefert.

Achtung: Als Parameter muss ebenfalls der Typ "i-soft plus" übergeben werden. Vermutlich ist dieser bei anderen Geräten des Herstellers anders. Ich habe ihn hier fix eingetragen, da ich keine Möglichkeit zum Testen anderer Geräte habe.

<pre>
attr JUDO_iSoft showError 1
attr JUDO_iSoft authRetries 2
attr JUDO_iSoft reAuthRegex (no token)|(not logged in)
attr JUDO_iSoft sid01ParseResponse 1
attr JUDO_iSoft sid01URL https://%JUDO_ipaddress%:8124/?group=register&command=login&msgnumber=1&name=login&user=%JUDO_username%&password=%JUDO_password%&role=customer
attr JUDO_iSoft sid02URL https://%JUDO_ipaddress%:8124/?group=register&command=connect&msgnumber=6&token=%token%&parameter=i-soft%20plus&serial%20number=%JUDO_serial%
</pre>

Damit ist die Grundkonfiguration hergestellt und die Anlage kann sich connecten.
In den einzelnen JSON-Rückantworten der Anlage werden die Werte zur jeweilige Anfrage immer als "data" zurück geliefert. Mit der Standard-Konfiguration

<pre>
attr JUDO_iSoft extractAllJSON 1
</pre>

werden daraus automatisch entsprechernde Readings angelegt. Da wir aber dann immer das Reading "data" überschreiben würde, kommt eine weitere Ersetzung zum Einsatz. In der Antwort steht neben einer Kaskadierung (group) auch der zugehörige Befehl (command). Ich habe mich dafür entschieden, ein neues Reading mit dem jeweiligen Command-Namen anzulegen. Die zugehörigen Ersetzungen sind wie folgt.
Erklärung zum Ausdruck reading03OExpr: Zunächst werden die Leerzeichen im Rückgabewert ($val) durch "-" ersetzt. Mit dem so veränderten String erzeugen wir ein neues Reading mit dem Wert aus dem Reading data.

<pre>
attr JUDO_iSoft reading01JSON data
attr JUDO_iSoft reading01Name token
attr JUDO_iSoft reading01Regex "token":"([^"]+)"
attr JUDO_iSoft reading02JSON group
attr JUDO_iSoft reading03JSON command
attr JUDO_iSoft reading03OExpr $val =~ s/\s/-/;; $val; readingsBulkUpdate($hash,$val,ReadingsVal("JUDO_iSoft","data",""))
</pre>
Noch ein paar ergänzende Attribute gesetzt:
<pre>
attr JUDO_iSoft enableControlSet 1
attr JUDO_iSoft getHeader1 Content-Type: application/json
attr JUDO_iSoft getHeader2 Accept: */*
attr JUDO_iSoft room 10_Räume->UG->Keller,
attr JUDO_iSoft showError
attr JUDO_iSoft timeout 5
</pre>

Damit sind alle Voraussetzungen erledigt. Ab jetzt können wir die einzelnen Get-Befehle implementieren:

<pre>
attr JUDO_iSoft get01Name SerialNumber
attr JUDO_iSoft get01URL https://%JUDO_ipaddress%:8124/?group=spare%20part&command=serial%20number&msgnumber=5&token=%token%

attr JUDO_iSoft get02Name WaterCurrent
attr JUDO_iSoft get02URL https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20current&msgnumber=1&token=%token%

attr JUDO_iSoft get03Name SaltRange
attr JUDO_iSoft get03URL https://%JUDO_ipaddress%:8124/?group=consumption&command=salt%20range&msgnumber=1&token=%token%

attr JUDO_iSoft get04Name SaltQuantity
attr JUDO_iSoft get04URL https://%JUDO_ipaddress%:8124/?group=consumption&command=salt%20quantity&msgnumber=1&token=%token%

attr JUDO_iSoft get05Name ResidualHardness
attr JUDO_iSoft get05URL https://%JUDO_ipaddress%:8124/?group=settings&command=residual%20hardness&msgnumber=1&token=%token%

attr JUDO_iSoft get06Name NaturalHardness
attr JUDO_iSoft get06URL https://%JUDO_ipaddress%:8124/?group=info&command=natural%20hardness&msgnumber=1&token=%token%

attr JUDO_iSoft get07Name WaterStop
attr JUDO_iSoft get07URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=valve&msgnumber=1&token=%token%

attr JUDO_iSoft get08Name FlowRate
attr JUDO_iSoft get08URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=flow%20rate&msgnumber=1&token=%token%

attr JUDO_iSoft get09Name SoftwareVersion
attr JUDO_iSoft get09URL https://%JUDO_ipaddress%:8124/?group=version&command=software%20version&msgnumber=1&token=%token%

attr JUDO_iSoft get10Name HardwareVersion
attr JUDO_iSoft get10URL https://%JUDO_ipaddress%:8124/?group=version&command=hardware%20version&msgnumber=1&token=%token%

attr JUDO_iSoft get11Name InstallationDate
attr JUDO_iSoft get11URL https://%JUDO_ipaddress%:8124/?group=contract&command=init%20date&msgnumber=1&token=%token%

attr JUDO_iSoft get12Name ServiceDate
attr JUDO_iSoft get12URL https://%JUDO_ipaddress%:8124/?group=contract&command=service%20date&msgnumber=1&token=%token%

attr JUDO_iSoft get13Name WaterTotal
attr JUDO_iSoft get13URL https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20total&msgnumber=1&token=%token%

attr JUDO_iSoft get14Name WaterAverage
attr JUDO_iSoft get14URL https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20average&msgnumber=1&token=%token%

attr JUDO_iSoft get15Name Vacation
attr JUDO_iSoft get15URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=vacation&msgnumber=1&token=%token%

attr JUDO_iSoft get16Name Quantity
attr JUDO_iSoft get16URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=quantity&msgnumber=1&token=%token%

attr JUDO_iSoft get17Name WaterDaily
attr JUDO_iSoft get17URL https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20daily&msgnumber=1&token=%token%

attr JUDO_iSoft get18Name ValveState
attr JUDO_iSoft get18URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=valve&msgnumber=4&&token=%token%

</pre>

Zum Setzen einiger Werte werden die folgenden Kommandos zum Schließen und Öffnen des Wasserstopps sowie das Setzen der Wunschwasserhärte implementiert

<pre>
attr JUDO_iSoft set01Name CloseValve
attr JUDO_iSoft set01URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=valve&msgnumber=1&token=%token%&parameter=close
attr JUDO_iSoft set02Name OpenValve
attr JUDO_iSoft set02URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=valve&msgnumber=1&token=%token%&parameter=open
attr JUDO_iSoft set03Name residual-hardness
attr JUDO_iSoft set03URL https://%JUDO_ipaddress%:8124/?group=settings&command=residual%20hardness&msgnumber=1&token=%token%&parameter=$val
</pre>

'''Userreadings'''

Um die Originalwerte aus der Anlage benutzerfreundlicher darzzustellen, werden noch Userreadings angelegt.

Die Salzrestdauer soll in Wochen angegeben (Rückgemeldet werden Tage) werden, die verbleibende Salzmenge in Prozent.
Die Salzemnge wird in Gramm angegeben, 50.000 entsprechen 100%.
Wichtig: Bei den Userreadings muss darauf geachtet werden, dass diese mit Komma separiert und in einer Zeile geschrieben werden.
<pre>

attr JUDO_iSoft saltRangeInWeeks { int( (ReadingsVal("JUDO_iSoft","salt-range",0)/7))} , saltQuantityInPercent { int( (ReadingsVal("JUDO_iSoft","salt-quantity",0)/50000)*100)}
</pre>

== Statistiken ==
Die iSoftPlus liefert verschiedene Statistiken zum Wasserverbrauch zurück. Die werden allerdings etwas eigentümlich zurückgemeldet.
Unter water-current ist der jeweilige Verbrauch je Stunde zusammengefasst. Ich hole kurz vor der vollen Stunde diesen Wert ab, damit er danach im Logfile landet.
Unter water-daily werden Tagesstatistiken geliefert. Kurioserweise in 3-Stunden-Paketen, d.h. 8 Werte. Die ersten Wert sind von 0h-3h, 3h-6h usw.
Ich habe mich aktuell darauf beschränkt, den stündlichen Verbrauch zu erfassen und zu protokollieren. Es lassen sich aber auch bei Bedarf detaillierte Datumsbezogene Statistiken abrufen. Ich habe noch keinen sinnvollen Weg gefunden, das mit fhem zu verbinden.

== Darstellung in Tablet UI ==
Ich nutze Tablet UI für die Visualisierung.
Zur Darstellung der Restmengen Salz nutze ich das knob-widget, für das Setzen des Härtegrades den spinner.
[[Datei:Judo isoft plus tabletui.png|200px]]
<pre>
<div class="hbox">

<div class="vbox phone-width">
<div class="card lift">
<header>Zustand Salz</header>
<div class="sheet">

<div class="row">
<div class="cell-50 top-align center-align left-space">
<div class="big">Restmenge</div>
<div data-type="knob" data-device="JUDO_iSoft"
data-get="saltQuantityInPercent"
data-unit="%"
data-step="1"
data-min="0"
data-max="100"
data-bgcolor="#FF0000"
data-fgcolor="#00FF1A"
class="small readonly">
</div>

</div>
<div class="cell-50 top-align center-align left-space">
<div class="big">Reichweite</div>

<div data-type="knob" data-device="JUDO_iSoft"
data-get="saltRangeInWeeks"
data-unit="w"
data-step="1"
data-min="0"
data-max="52"
data-bgcolor="#FF0000"
data-fgcolor="#00FF1A"
class="small readonly">
</div>

</div>
</div>
</div>
</div>
</div>
<div class="vbox phone-width">
<div class="card lift">
<header>Wasserstopp</header>
<div class="sheet">
<div class="row top-space">

<div class="cell left-align top-align left-space">
<div data-type="symbol" data-device="JUDO_iSoft" data-get="valve"
data-icons='["fa-close","fa-close","oa-sani_water_tap","oa-sani_water_tap"]'
data-get-on='["closed","closing","opening","opened"]'
data-on-colors='["#ad3333","#ff6633","#3399ff","#33ad33"]' class="big compressed"></div>
</div>
<div class="cell-60 top-align center-align">
<div class="big">

<div data-type="label"
data-get="valve"
class="valueonly"
data-substitution='["opened","geöffnet","opening","öffnet gerade","closed","geschlossen","closing","schließt gerade"]'
data-device="JUDO_iSoft"
data-color="lightgrey">
</div>
</div>

</div>

<div class="cell left-align top-align left-space">
<div data-type="push" data-device="JUDO_iSoft" data-set-on="CloseValve 1" data-get-on="valve" data-background-icon="fa-stop-circle-o" data-icon="" class="small"></div>

</div>
<div class="cell right-align top-align right-space">

<div data-type="push" data-device="JUDO_iSoft" data-set-on="OpenValve 1" data-get-on="valve" data-background-icon="mi-play_circle_filled" data-icon="" class="small"></div>
</div>
</div>
</div>
</div>
</div>

<div class="vbox phone-width">
<div class="card lift">
<header>Wasserhärtegrad</header>

<div class="sheet">
<div class="row">

<div class="cell-20 center-align top-align left-space">
<div data-type="symbol"
data-device="JUDO_iSoft"
data-icon="none"
data-color='none'
data-height="100"
data-background-icon="fa-circle"
data-background-colors='["red","blue"]'
data-limits='["0","1"]'>
<div data-type="label"
data-get="natural-hardness"
data-unit="°h"
class="valueonly"
data-device="JUDO_iSoft"
data-color="lightgrey">
</div>
</div>
</div>

<div class="cell-20 top-align center-align left-space">
<div data-type="image" data-size="50%" data-url="images/judo.png"></div>
</div>

<div class="cell-60 top-align center-align left-space">

<div data-type="spinner"
data-device="JUDO_iSoft"
data-get="residual-hardness"
data-set="residual-hardness"
data-min=5"
data-max="12"
data-step="1"
data-unit="°h"
data-longdelay="800"
data-width="200"
data-height="60"
data-icon-left-color="blue"
data-icon-right-color="red"

class="valueonly">

</div>
</div>
</div>
</div>
</div>

</div>

<div class="vbox phone-width">
<div class="card lift">
<header>Wasserverbrauch</header>
<section>
<div id="JUDO_iSoft"
data-type="highchart"
data-device="JUDO_iSoft"
data-logdevice="FileLog_JUDO_ISoft"
data-columnspec="4:water-current"
data-style="ftui l0fill"
data-linenames="Verbrauch"
data-linetypes="line"
data-yaxis="0,1"
data-height="300"
data-xunit="Uhrzeit"
data-yunit="l"
data-tooltip="{series.name} <b>{point.y:,.1f}</b>"
data-daysago="7"
data-yticks="auto"
data-legendalign="right">

</section>

</div
</div>
</div>
</pre>

== Ähnliche Systeme ==

== Projekte der FHEM-Community ==

== Links ==
* {{Link2Forum|Topic=56455|Message=800960}}
* [https://blog.muwave.de/2017/06/monitoring-and-controlling-a-judo-i-soft-plus-water-softening-device-via-lan/ ursprünglicher Beitrag bzgl. des verwendeten Protokolls]

[[Kategorie:IP Components]]
[[Kategorie:Other Components]]

JUDO iSoft Plus

2018-10-05T22:16:36Z

Loungelizard: Ergänzung von Kommandos zum Setzen von Werten und Auswertung in Statistiken, Tablet UI erweitert

{{Infobox Hardware
|Bild=judo-soft-plus.jpg|200px
|Bildbeschreibung=JUDO iSoft Plus Wasserenthärtungsanlage
|HWProtocol=IP
|HWType=Wasserenthärter
|HWCategory=IP
|HWVoltage=230 V
|HWPoweredBy=AC
|HWSize=39x67x45 cm (BxHxT)
|HWComm=n/a
|HWChannels=n/a
|HWPowerConsumption=?
|HWDeviceFHEM=[[HTTPMOD]]

|HWManufacturer=Judo GmbH
}}
__TOC__

Die JUDO i-soft plus Enthärtungsanlage [https://judo.eu/produkt/judo-i-soft-plus-vollautomatische-enthaertungsanlage/] ist eine Wasserenthärtungsanlage mit IP-Konnektivität.
Sie verfügt über LAN und WLAN-Anschluss und ist auf die Steuerung via App des Herstellers ausgelegt.

Für eine erfolgreiche Integration in FHEM muss die Anlage über das Menü beim Hersteller registriert werden.
Die folgenden Informationen sind erforderlich:

* Benutzername: Selbst gewählter Login-Name auf der iSoft plus (vgl. Gerätehandbuch)
* Kennwort: Selbst gewähltes Kennwort
* Seriennummer: Seriennummer des Geräts. Diese ist entweder über das Menü auslesbar oder alternativ auch über die APP des Herstellers.
* IP-Adresse: Die IP-Adresse des Geräts im Heimnetz.

== Einbindung in FHEM ==

Das Gerät wird mittels des Moduls HTTPMOD eingebunden. Dazu gilt zunächst die folgende Konfiguration als Basis.
Zunächst legen wir die Standardanfrage an das Modul fest. Die Portnummer 8124 ist vom Hersteller vorgegeben. Wir vergeben gleich ein paar Platzhalter, die später in den Aufrufen und den Antworten ersetzt werden, damit wir die Werte nur an einer zentralen Stelle konfigurieren müssen.

<pre>
define JUDO_iSoft HTTPMOD https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20current&msgnumber=1&token=%token%
</pre>

Nach erfolgreicher Authentifizierung wird von der iSoft ein Token generiert und muss bei jedem Aufruf übergeben werden:

<pre>
attr JUDO_iSoft replacement01Mode reading
attr JUDO_iSoft replacement01Regex %token%
attr JUDO_iSoft replacement01Value token
</pre>

Anschließend legen wir die Ersetzungen für die anderen Platzhalter fest:

<pre>
attr JUDO_iSoft replacement02Mode text
attr JUDO_iSoft replacement02Regex %JUDO_ipaddress%
attr JUDO_iSoft replacement02Value <hier eigene IP Adresse im lokalen Netz eintragen>
attr JUDO_iSoft replacement03Mode text
attr JUDO_iSoft replacement03Regex %JUDO_password%
attr JUDO_iSoft replacement03Value <hier Kennwort eintragen>
attr JUDO_iSoft replacement04Mode text
attr JUDO_iSoft replacement04Regex %JUDO_username%
attr JUDO_iSoft replacement04Value <hier Benutzername eintragen>
attr JUDO_iSoft replacement05Mode text
attr JUDO_iSoft replacement05Regex %JUDO_serial%
attr JUDO_iSoft replacement05Value <hier Seriennummer eintragen>
</pre>

Die Authentifizierung der Anlage erfolgt zwei-stufig. Zunächst muss ein Aufruf mit Benutzername und Kennwort erfolgen. Als Antwort erhält man einen JSON-String, der das Token beinhaltet. Mit diesem Token wird anschließend die Funktion connect aufgerufen und die Seriennummer des Geräts mit übergeben.
HTTPMOD erkennt, wenn ein neues Login erforderlich ist, wenn die Judo die Rückmeldung "no token" oder "not logged in" liefert.

Achtung: Als Parameter muss ebenfalls der Typ "i-soft plus" übergeben werden. Vermutlich ist dieser bei anderen Geräten des Herstellers anders. Ich habe ihn hier fix eingetragen, da ich keine Möglichkeit zum Testen anderer Geräte habe.

<pre>
attr JUDO_iSoft showError 1
attr JUDO_iSoft authRetries 2
attr JUDO_iSoft reAuthRegex (no token)|(not logged in)
attr JUDO_iSoft sid01ParseResponse 1
attr JUDO_iSoft sid01URL https://%JUDO_ipaddress%:8124/?group=register&command=login&msgnumber=1&name=login&user=%JUDO_username%&password=%JUDO_password%&role=customer
attr JUDO_iSoft sid02URL https://%JUDO_ipaddress%:8124/?group=register&command=connect&msgnumber=6&token=%token%&parameter=i-soft%20plus&serial%20number=%JUDO_serial%
</pre>

Damit ist die Grundkonfiguration hergestellt und die Anlage kann sich connecten.
In den einzelnen JSON-Rückantworten der Anlage werden die Werte zur jeweilige Anfrage immer als "data" zurück geliefert. Mit der Standard-Konfiguration

<pre>
attr JUDO_iSoft extractAllJSON 1
</pre>

werden daraus automatisch entsprechernde Readings angelegt. Da wir aber dann immer das Reading "data" überschreiben würde, kommt eine weitere Ersetzung zum Einsatz. In der Antwort steht neben einer Kaskadierung (group) auch der zugehörige Befehl (command). Ich habe mich dafür entschieden, ein neues Reading mit dem jeweiligen Command-Namen anzulegen. Die zugehörigen Ersetzungen sind wie folgt.
Erklärung zum Ausdruck reading03OExpr: Zunächst werden die Leerzeichen im Rückgabewert ($val) durch "-" ersetzt. Mit dem so veränderten String erzeugen wir ein neues Reading mit dem Wert aus dem Reading data.

<pre>
attr JUDO_iSoft reading01JSON data
attr JUDO_iSoft reading01Name token
attr JUDO_iSoft reading01Regex "token":"([^"]+)"
attr JUDO_iSoft reading02JSON group
attr JUDO_iSoft reading03JSON command
attr JUDO_iSoft reading03OExpr $val =~ s/\s/-/;; $val; readingsBulkUpdate($hash,$val,ReadingsVal("JUDO_iSoft","data",""))
</pre>
Noch ein paar ergänzende Attribute gesetzt:
<pre>
attr JUDO_iSoft enableControlSet 1
attr JUDO_iSoft getHeader1 Content-Type: application/json
attr JUDO_iSoft getHeader2 Accept: */*
attr JUDO_iSoft room 10_Räume->UG->Keller,
attr JUDO_iSoft showError
attr JUDO_iSoft timeout 5
</pre>

Damit sind alle Voraussetzungen erledigt. Ab jetzt können wir die einzelnen Get-Befehle implementieren:

<pre>
attr JUDO_iSoft get01Name SerialNumber
attr JUDO_iSoft get01URL https://%JUDO_ipaddress%:8124/?group=spare%20part&command=serial%20number&msgnumber=5&token=%token%

attr JUDO_iSoft get02Name WaterCurrent
attr JUDO_iSoft get02URL https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20current&msgnumber=1&token=%token%

attr JUDO_iSoft get03Name SaltRange
attr JUDO_iSoft get03URL https://%JUDO_ipaddress%:8124/?group=consumption&command=salt%20range&msgnumber=1&token=%token%

attr JUDO_iSoft get04Name SaltQuantity
attr JUDO_iSoft get04URL https://%JUDO_ipaddress%:8124/?group=consumption&command=salt%20quantity&msgnumber=1&token=%token%

attr JUDO_iSoft get05Name ResidualHardness
attr JUDO_iSoft get05URL https://%JUDO_ipaddress%:8124/?group=settings&command=residual%20hardness&msgnumber=1&token=%token%

attr JUDO_iSoft get06Name NaturalHardness
attr JUDO_iSoft get06URL https://%JUDO_ipaddress%:8124/?group=info&command=natural%20hardness&msgnumber=1&token=%token%

attr JUDO_iSoft get07Name WaterStop
attr JUDO_iSoft get07URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=valve&msgnumber=1&token=%token%

attr JUDO_iSoft get08Name FlowRate
attr JUDO_iSoft get08URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=flow%20rate&msgnumber=1&token=%token%

attr JUDO_iSoft get09Name SoftwareVersion
attr JUDO_iSoft get09URL https://%JUDO_ipaddress%:8124/?group=version&command=software%20version&msgnumber=1&token=%token%

attr JUDO_iSoft get10Name HardwareVersion
attr JUDO_iSoft get10URL https://%JUDO_ipaddress%:8124/?group=version&command=hardware%20version&msgnumber=1&token=%token%

attr JUDO_iSoft get11Name InstallationDate
attr JUDO_iSoft get11URL https://%JUDO_ipaddress%:8124/?group=contract&command=init%20date&msgnumber=1&token=%token%

attr JUDO_iSoft get12Name ServiceDate
attr JUDO_iSoft get12URL https://%JUDO_ipaddress%:8124/?group=contract&command=service%20date&msgnumber=1&token=%token%

attr JUDO_iSoft get13Name WaterTotal
attr JUDO_iSoft get13URL https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20total&msgnumber=1&token=%token%

attr JUDO_iSoft get14Name WaterAverage
attr JUDO_iSoft get14URL https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20average&msgnumber=1&token=%token%

attr JUDO_iSoft get15Name Vacation
attr JUDO_iSoft get15URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=vacation&msgnumber=1&token=%token%

attr JUDO_iSoft get16Name Quantity
attr JUDO_iSoft get16URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=quantity&msgnumber=1&token=%token%

attr JUDO_iSoft get17Name WaterDaily
attr JUDO_iSoft get17URL https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20daily&msgnumber=1&token=%token%

attr JUDO_iSoft get18Name ValveState
attr JUDO_iSoft get18URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=valve&msgnumber=4&&token=%token%

</pre>

Zum Setzen einiger Werte werden die folgenden Kommandos zum Schließen und Öffnen des Wasserstopps sowie das Setzen der Wunschwasserhärte implementiert

<pre>
attr JUDO_iSoft set01Name CloseValve
attr JUDO_iSoft set01URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=valve&msgnumber=1&token=%token%&parameter=close
attr JUDO_iSoft set02Name OpenValve
attr JUDO_iSoft set02URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=valve&msgnumber=1&token=%token%&parameter=open
attr JUDO_iSoft set03Name residual-hardness
attr JUDO_iSoft set03URL https://%JUDO_ipaddress%:8124/?group=settings&command=residual%20hardness&msgnumber=1&token=%token%&parameter=$val
</pre>

'''Userreadings'''

Um die Originalwerte aus der Anlage benutzerfreundlicher darzzustellen, werden noch Userreadings angelegt.

Die Salzrestdauer soll in Wochen angegeben (Rückgemeldet werden Tage) werden, die verbleibende Salzmenge in Prozent.
Die Salzemnge wird in Gramm angegeben, 50.000 entsprechen 100%.
Wichtig: Bei den Userreadings muss darauf geachtet werden, dass diese mit Komma separiert und in einer Zeile geschrieben werden.
<pre>

attr JUDO_iSoft saltRangeInWeeks { int( (ReadingsVal("JUDO_iSoft","salt-range",0)/7))} , saltQuantityInPercent { int( (ReadingsVal("JUDO_iSoft","salt-quantity",0)/50000)*100)}
</pre>

== Statistiken ==
Die iSoftPlus liefert verschiedene Statistiken zum Wasserverbrauch zurück. Die werden allerdings etwas eigentümlich zurückgemeldet.
Unter water-current ist der jeweilige Verbrauch je Stunde zusammengefasst. Ich hole kurz vor der vollen Stunde diesen Wert ab, damit er danach im Logfile landet.
Unter water-daily werden Tagesstatistiken geliefert. Kurioserweise in 3-Stunden-Paketen, d.h. 8 Werte. Die ersten Wert sind von 0h-3h, 3h-6h usw.
Ich habe mich aktuell darauf beschränkt, den stündlichen Verbrauch zu erfassen und zu protokollieren. Es lassen sich aber auch bei Bedarf detaillierte Datumsbezogene Statistiken abrufen. Ich habe noch keinen sinnvollen Weg gefunden, das mit fhem zu verbinden.

== Darstellung in Tablet UI ==
Ich nutze Tablet UI für die Visualisierung.
Zur Darstellung der Restmengen Salz nutze ich das knob-widget, für das (noch nicht implementierte) Setzen des Härtegrades den spinner.
[[Datei:Judo isoft plus tabletui.png|200px]]
<pre>
<div class="hbox">

<div class="vbox phone-width">
<div class="card lift">
<header>Zustand Salz</header>
<div class="sheet">

<div class="row">
<div class="cell-50 top-align center-align left-space">
<div class="big">Restmenge</div>
<div data-type="knob" data-device="JUDO_iSoft"
data-get="saltQuantityInPercent"
data-unit="%"
data-step="1"
data-min="0"
data-max="100"
data-bgcolor="#FF0000"
data-fgcolor="#00FF1A"
class="small readonly">
</div>

</div>
<div class="cell-50 top-align center-align left-space">
<div class="big">Reichweite</div>

<div data-type="knob" data-device="JUDO_iSoft"
data-get="saltRangeInWeeks"
data-unit="w"
data-step="1"
data-min="0"
data-max="52"
data-bgcolor="#FF0000"
data-fgcolor="#00FF1A"
class="small readonly">
</div>

</div>
</div>
</div>
</div>
</div>
<div class="vbox phone-width">
<div class="card lift">
<header>Wasserstopp</header>
<div class="sheet">
<div class="row top-space">

<div class="cell left-align top-align left-space">
<div data-type="symbol" data-device="JUDO_iSoft" data-get="valve"
data-icons='["fa-close","fa-close","oa-sani_water_tap","oa-sani_water_tap"]'
data-get-on='["closed","closing","opening","opened"]'
data-on-colors='["#ad3333","#ff6633","#3399ff","#33ad33"]' class="big compressed"></div>
</div>
<div class="cell-60 top-align center-align">
<div class="big">

<div data-type="label"
data-get="valve"
class="valueonly"
data-substitution='["opened","geöffnet","opening","öffnet gerade","closed","geschlossen","closing","schließt gerade"]'
data-device="JUDO_iSoft"
data-color="lightgrey">
</div>
</div>

</div>

<div class="cell left-align top-align left-space">
<div data-type="push" data-device="JUDO_iSoft" data-set-on="CloseValve 1" data-get-on="valve" data-background-icon="fa-stop-circle-o" data-icon="" class="small"></div>

</div>
<div class="cell right-align top-align right-space">

<div data-type="push" data-device="JUDO_iSoft" data-set-on="OpenValve 1" data-get-on="valve" data-background-icon="mi-play_circle_filled" data-icon="" class="small"></div>
</div>
</div>
</div>
</div>
</div>

<div class="vbox phone-width">
<div class="card lift">
<header>Wasserhärtegrad</header>

<div class="sheet">
<div class="row">

<div class="cell-20 center-align top-align left-space">
<div data-type="symbol"
data-device="JUDO_iSoft"
data-icon="none"
data-color='none'
data-height="100"
data-background-icon="fa-circle"
data-background-colors='["red","blue"]'
data-limits='["0","1"]'>
<div data-type="label"
data-get="natural-hardness"
data-unit="°h"
class="valueonly"
data-device="JUDO_iSoft"
data-color="lightgrey">
</div>
</div>
</div>

<div class="cell-20 top-align center-align left-space">
<div data-type="image" data-size="50%" data-url="images/judo.png"></div>
</div>

<div class="cell-60 top-align center-align left-space">

<div data-type="spinner"
data-device="JUDO_iSoft"
data-get="residual-hardness"
data-set="residual-hardness"
data-min=5"
data-max="12"
data-step="1"
data-unit="°h"
data-longdelay="800"
data-width="200"
data-height="60"
data-icon-left-color="blue"
data-icon-right-color="red"

class="valueonly">

</div>
</div>
</div>
</div>
</div>

</div>

<div class="vbox phone-width">
<div class="card lift">
<header>Wasserverbrauch</header>
<section>
<div id="JUDO_iSoft"
data-type="highchart"
data-device="JUDO_iSoft"
data-logdevice="FileLog_JUDO_ISoft"
data-columnspec="4:water-current"
data-style="ftui l0fill"
data-linenames="Verbrauch"
data-linetypes="line"
data-yaxis="0,1"
data-height="300"
data-xunit="Uhrzeit"
data-yunit="l"
data-tooltip="{series.name} <b>{point.y:,.1f}</b>"
data-daysago="7"
data-yticks="auto"
data-legendalign="right">

</section>

</div
</div>
</div>
</pre>

== Ähnliche Systeme ==

== Projekte der FHEM-Community ==

== Links ==
* {{Link2Forum|Topic=56455|Message=800960}}
* [https://blog.muwave.de/2017/06/monitoring-and-controlling-a-judo-i-soft-plus-water-softening-device-via-lan/ ursprünglicher Beitrag bzgl. des verwendeten Protokolls]

[[Kategorie:IP Components]]
[[Kategorie:Other Components]]

JUDO iSoft Plus

2018-05-12T09:50:11Z

Loungelizard: Darstellung Tablet UI

{{Infobox Hardware
|Bild=judo-soft-plus.jpg|200px
|Bildbeschreibung=JUDO iSoft Plus Wasserenthärtungsanlage
|HWProtocol=IP
|HWType=[[Wasserenthärter|Wasserenthärter]]
|HWCategory=IP
|HWVoltage=230 V
|HWPoweredBy=AC
|HWSize=39x67x45 cm (BxHxT)
|HWComm=n/a
|HWChannels=n/a
|HWPowerConsumption=?

|HWDeviceFHEM=[[HTTPMOD]]

|HWManufacturer=Judo GmbH
}}
__TOC__

Die JUDO i-soft plus Enthärtungsanlage [https://judo.eu/produkt/judo-i-soft-plus-vollautomatische-enthaertungsanlage/] ist eine Wasserenthärtungsanlage mit IP-Konnektivität.
Sie verfügt über LAN und WLAN-Anschluss und ist auf die Steuerung via App des Herstellers ausgelegt.

Für eine erfolgreiche Integration in FHEM muss die Anlage über das Menü beim Hersteller registriert werden.
Die folgenden Informationen sind erforderlich:

* Benutzername: Selbst gewählter Login-Name auf der iSoft plus (vgl. Gerätehandbuch)
* Kennwort: Selbst gewähltes Kennwort
* Seriennummer: Seriennummer des Geräts. Diese ist entweder über das Menü auslesbar oder alternativ auch über die APP des Herstellers.
* IP-Adresse: Die IP-Adresse des Geräts im Heimnetz.

== Einbindung in FHEM ==

Das Gerät wird mittels des Moduls HTTPMOD eingebunden. Dazu gilt zunächst die folgende Konfiguration als Basis.
Zunächst legen wir die Standardanfrage an das Modul fest. Die Portnummer 8124 ist vom Hersteller vorgegeben. Wir vergeben gleich ein paar Platzhalter, die später in den Aufrufen und den Antworten ersetzt werden, damit wir die Werte nur an einer zentralen Stelle konfigurieren müssen.

<pre>
define JUDO_iSoft HTTPMOD https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20current&msgnumber=1&token=%token%
</pre>

Nach erfolgreicher Authentifizierung wird von der iSoft ein Token generiert und muss bei jedem Aufruf übergeben werden:

<pre>
attr JUDO_iSoft replacement01Mode reading
attr JUDO_iSoft replacement01Regex %token%
attr JUDO_iSoft replacement01Value token
</pre>

Anschließend legen wir die Ersetzungen für die anderen Platzhalter fest:

<pre>
attr JUDO_iSoft replacement02Mode text
attr JUDO_iSoft replacement02Regex %JUDO_ipaddress%
attr JUDO_iSoft replacement02Value <hier eigene IP Adresse im lokalen Netz eintragen>
attr JUDO_iSoft replacement03Mode text
attr JUDO_iSoft replacement03Regex %JUDO_password%
attr JUDO_iSoft replacement03Value <hier Kennwort eintragen>
attr JUDO_iSoft replacement04Mode text
attr JUDO_iSoft replacement04Regex %JUDO_username%
attr JUDO_iSoft replacement04Value <hier Benutzername eintragen>
attr JUDO_iSoft replacement05Mode text
attr JUDO_iSoft replacement05Regex %JUDO_serial%
attr JUDO_iSoft replacement05Value <hier Seriennummer eintragen>
</pre>

Die Authentifizierung der Anlage erfolgt zwei-stufig. Zunächst muss ein Aufruf mit Benutzername und Kennwort erfolgen. Als Antwort erhält man einen JSON-String, der das Token beinhaltet. Mit diesem Token wird anschließend die Funktion connect aufgerufen und die Seriennummer des Geräts mit übergeben.
HTTPMOD erkennt, wenn ein neues Login erforderlich ist, wenn die Judo die Rückmeldung "no token" oder "not logged in" liefert.

Achtung: Als Parameter muss ebenfalls der Typ "i-soft plus" übergeben werden. Vermutlich ist dieser bei anderen Geräten des Herstellers anders. Ich habe ihn hier fix eingetragen, da ich keine Möglichkeit zum Testen anderer Geräte habe.

<pre>
attr JUDO_iSoft showError 1
attr JUDO_iSoft authRetries 2
attr JUDO_iSoft reAuthRegex (no token)|(not logged in)
attr JUDO_iSoft sid01ParseResponse 1
attr JUDO_iSoft sid01URL https://%JUDO_ipaddress%:8124/?group=register&command=login&msgnumber=1&name=login&user=%JUDO_username%&password=%JUDO_password%&role=customer
attr JUDO_iSoft sid02URL https://%JUDO_ipaddress%:8124/?group=register&command=connect&msgnumber=6&token=%token%&parameter=i-soft%20plus&serial%20number=%JUDO_serial%
</pre>

Damit ist die Grundkonfiguration hergestellt und die Anlage kann sich connecten.
In den einzelnen JSON-Rückantworten der Anlage werden die Werte zur jeweilige Anfrage immer als "data" zurück geliefert. Mit der Standard-Konfiguration

<pre>
attr JUDO_iSoft extractAllJSON 1
</pre>

werden daraus automatisch entsprechernde Readings angelegt. Da wir aber dann immer das Reading "data" überschreiben würde, kommt eine weitere Ersetzung zum Einsatz. In der Antwort steht neben einer Kaskadierung (group) auch der zugehörige Befehl (command). Ich habe mich dafür entschieden, ein neues Reading mit dem jeweiligen Command-Namen anzulegen. Die zugehörigen Ersetzungen sind wie folgt.
Erklärung zum Ausdruck reading03OExpr: Zunächst werden die Leerzeichen im Rückgabewert ($val) durch "-" ersetzt. Mit dem so veränderten String erzeugen wir ein neues Reading mit dem Wert aus dem Reading data.

<pre>
attr JUDO_iSoft reading01JSON data
attr JUDO_iSoft reading01Name token
attr JUDO_iSoft reading01Regex "token":"([^"]+)"
attr JUDO_iSoft reading02JSON group
attr JUDO_iSoft reading03JSON command
attr JUDO_iSoft reading03OExpr $val =~ s/\s/-/;; $val; readingsBulkUpdate($hash,$val,ReadingsVal("JUDO_iSoft","data",""))
</pre>
Noch ein paar ergänzende Attribute gesetzt:
<pre>
attr JUDO_iSoft enableControlSet 1
attr JUDO_iSoft getHeader1 Content-Type: application/json
attr JUDO_iSoft getHeader2 Accept: */*
attr JUDO_iSoft room 10_Räume->UG->Keller,
attr JUDO_iSoft showError
attr JUDO_iSoft timeout 5
</pre>

Damit sind alle Voraussetzungen erledigt. Ab jetzt können wir die einzelnen Get-Befehle implementieren:

<pre>
attr JUDO_iSoft get01Name SerialNumber
attr JUDO_iSoft get01URL https://%JUDO_ipaddress%:8124/?group=spare%20part&command=serial%20number&msgnumber=5&token=%token%

attr JUDO_iSoft get02Name WaterCurrent
attr JUDO_iSoft get02URL https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20current&msgnumber=1&token=%token%

attr JUDO_iSoft get03Name SaltRange
attr JUDO_iSoft get03URL https://%JUDO_ipaddress%:8124/?group=consumption&command=salt%20range&msgnumber=1&token=%token%

attr JUDO_iSoft get04Name SaltQuantity
attr JUDO_iSoft get04URL https://%JUDO_ipaddress%:8124/?group=consumption&command=salt%20quantity&msgnumber=1&token=%token%

attr JUDO_iSoft get05Name ResidualHardness
attr JUDO_iSoft get05URL https://%JUDO_ipaddress%:8124/?group=settings&command=residual%20hardness&msgnumber=1&token=%token%

attr JUDO_iSoft get06Name NaturalHardness
attr JUDO_iSoft get06URL https://%JUDO_ipaddress%:8124/?group=info&command=natural%20hardness&msgnumber=1&token=%token%

attr JUDO_iSoft get07Name WaterStop
attr JUDO_iSoft get07URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=valve&msgnumber=1&token=%token%

attr JUDO_iSoft get08Name FlowRate
attr JUDO_iSoft get08URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=flow%20rate&msgnumber=1&token=%token%

attr JUDO_iSoft get09Name SoftwareVersion
attr JUDO_iSoft get09URL https://%JUDO_ipaddress%:8124/?group=version&command=software%20version&msgnumber=1&token=%token%

attr JUDO_iSoft get10Name HardwareVersion
attr JUDO_iSoft get10URL https://%JUDO_ipaddress%:8124/?group=version&command=hardware%20version&msgnumber=1&token=%token%

attr JUDO_iSoft get11Name InstallationDate
attr JUDO_iSoft get11URL https://%JUDO_ipaddress%:8124/?group=contract&command=init%20date&msgnumber=1&token=%token%

attr JUDO_iSoft get12Name ServiceDate
attr JUDO_iSoft get12URL https://%JUDO_ipaddress%:8124/?group=contract&command=service%20date&msgnumber=1&token=%token%

attr JUDO_iSoft get13Name WaterTotal
attr JUDO_iSoft get13URL https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20total&msgnumber=1&token=%token%

attr JUDO_iSoft get14Name WaterAverage
attr JUDO_iSoft get14URL https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20average&msgnumber=1&token=%token%

attr JUDO_iSoft get15Name Vacation
attr JUDO_iSoft get15URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=vacation&msgnumber=1&token=%token%

attr JUDO_iSoft get16Name Quantity
attr JUDO_iSoft get16URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=quantity&msgnumber=1&token=%token%
</pre>

'''Userreadings'''

Um die Originalwerte aus der Anlage benutzerfreundlicher darzzustellen, werden noch Userreadings angelegt.

Die Salzrestdauer soll in Wochen angegeben (Rückgemeldet werden Tage) werden, die verbleibende Salzmenge in Prozent.
Die Salzemnge wird in Gramm angegeben, 50.000 entsprechen 100%.
Wichtig: Bei den Userreadings muss darauf geachtet werden, dass diese mit Komma separiert und in einer Zeile geschrieben werden.
<pre>

attr JUDO_iSoft saltRangeInWeeks { int( (ReadingsVal("JUDO_iSoft","salt-range",0)/7))} , saltQuantityInPercent { int( (ReadingsVal("JUDO_iSoft","salt-quantity",0)/50000)*100)}
</pre>

Weitere Befehle insbesondere zum Setzen und die Auswertung der Verbrauchswerte folgen.

== Darstellung in Tablet UI ==
Ich nutze Tablet UI für die Visualisierung.
Zur Darstellung der Restmengen Salz nutze ich das knob-widget, für das (noch nicht implementierte) Setzen des Härtegrades den spinner.
[[Datei:Judo isoft plus tabletui.png|200px]]

'''Salzmengen'''

<pre>
<header>Zustand Salz</header>
<div class="row">
<div class="cell center-align left-space">
<div class="big">Restmenge</div>
<div data-type="knob" data-device="JUDO_iSoft"
data-get="saltQuantityInPercent"
data-unit="%"
data-step="1"
data-min="0"
data-max="100"
data-bgcolor="#FF0000"
data-fgcolor="#00FF1A"
class="small readonly">
</div>

</div>
<div class="cell center-align left-space">
<div class="big">Reichweite in Wochen</div>

<div data-type="knob" data-device="JUDO_iSoft"
data-get="saltRangeInWeeks"
data-unit="w"
data-step="1"
data-min="0"
data-max="52"
data-bgcolor="#FF0000"
data-fgcolor="#00FF1A"
class="small readonly">
</div>

</div>

</pre>

'''Einstellen des Härtegrades'''

<pre>
<div class="card lift">
<header>Wasserhärtegrad</header>
<div class="row">
<div class="cell center-align left-space">
<div data-type="symbol"
data-device="JUDO_iSoft"
data-icon="none"
data-color='none'
data-height="100"
data-background-icon="fa-circle"
data-background-colors='["red","blue"]'
data-limits='["0","1"]'>
<div data-type="label"
data-get="natural-hardness"
data-unit="°h"
class="valueonly"
data-device="JUDO_iSoft"
data-color="lightgrey">
</div>
</div>
</div>

<div class="cell center-align left-space">
<div data-type="image" data-size="50%" data-url="images/judo.png"></div>
</div>

<div class="cell center-align left-space">

<div data-type="spinner"
data-device="JUDO_iSoft"
data-get="residual-hardness"
data-set="residual-hardness"
data-min=5"
data-max="12"
data-step="1"
data-unit="°h"
data-longdelay="800"
data-width="300"
data-height="60"
data-icon-left-color="blue"
data-icon-right-color="red"

class="valueonly">

</div>
</div>
</div>
</div>
</pre>

== Ähnliche Systeme ==

== Projekte der FHEM-Community ==

== Links ==
* {{Link2Forum|Topic=56455|Message=800960}}
* [https://blog.muwave.de/2017/06/monitoring-and-controlling-a-judo-i-soft-plus-water-softening-device-via-lan/ ursprünglicher Beitrag bzgl. des verwendeten Protokolls]

[[Kategorie:IP Components]]
[[Kategorie:Other Components]]

Datei:Judo isoft plus tabletui.png

2018-05-12T09:44:31Z

Loungelizard:

JUDO iSoft Plus

2018-05-12T09:37:58Z

Loungelizard: Userreadings ergänz

{{Infobox Hardware
|Bild=judo-soft-plus.jpg|200px
|Bildbeschreibung=JUDO iSoft Plus Wasserenthärtungsanlage
|HWProtocol=IP
|HWType=[[Wasserenthärter|Wasserenthärter]]
|HWCategory=IP
|HWVoltage=230 V
|HWPoweredBy=AC
|HWSize=39x67x45 cm (BxHxT)
|HWComm=n/a
|HWChannels=n/a
|HWPowerConsumption=?

|HWDeviceFHEM=[[HTTPMOD]]

|HWManufacturer=Judo GmbH
}}
__TOC__

Die JUDO i-soft plus Enthärtungsanlage [https://judo.eu/produkt/judo-i-soft-plus-vollautomatische-enthaertungsanlage/] ist eine Wasserenthärtungsanlage mit IP-Konnektivität.
Sie verfügt über LAN und WLAN-Anschluss und ist auf die Steuerung via App des Herstellers ausgelegt.

Für eine erfolgreiche Integration in FHEM muss die Anlage über das Menü beim Hersteller registriert werden.
Die folgenden Informationen sind erforderlich:

* Benutzername: Selbst gewählter Login-Name auf der iSoft plus (vgl. Gerätehandbuch)
* Kennwort: Selbst gewähltes Kennwort
* Seriennummer: Seriennummer des Geräts. Diese ist entweder über das Menü auslesbar oder alternativ auch über die APP des Herstellers.
* IP-Adresse: Die IP-Adresse des Geräts im Heimnetz.

== Einbindung in FHEM ==

Das Gerät wird mittels des Moduls HTTPMOD eingebunden. Dazu gilt zunächst die folgende Konfiguration als Basis.
Zunächst legen wir die Standardanfrage an das Modul fest. Die Portnummer 8124 ist vom Hersteller vorgegeben. Wir vergeben gleich ein paar Platzhalter, die später in den Aufrufen und den Antworten ersetzt werden, damit wir die Werte nur an einer zentralen Stelle konfigurieren müssen.

<pre>
define JUDO_iSoft HTTPMOD https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20current&msgnumber=1&token=%token%
</pre>

Nach erfolgreicher Authentifizierung wird von der iSoft ein Token generiert und muss bei jedem Aufruf übergeben werden:

<pre>
attr JUDO_iSoft replacement01Mode reading
attr JUDO_iSoft replacement01Regex %token%
attr JUDO_iSoft replacement01Value token
</pre>

Anschließend legen wir die Ersetzungen für die anderen Platzhalter fest:

<pre>
attr JUDO_iSoft replacement02Mode text
attr JUDO_iSoft replacement02Regex %JUDO_ipaddress%
attr JUDO_iSoft replacement02Value <hier eigene IP Adresse im lokalen Netz eintragen>
attr JUDO_iSoft replacement03Mode text
attr JUDO_iSoft replacement03Regex %JUDO_password%
attr JUDO_iSoft replacement03Value <hier Kennwort eintragen>
attr JUDO_iSoft replacement04Mode text
attr JUDO_iSoft replacement04Regex %JUDO_username%
attr JUDO_iSoft replacement04Value <hier Benutzername eintragen>
attr JUDO_iSoft replacement05Mode text
attr JUDO_iSoft replacement05Regex %JUDO_serial%
attr JUDO_iSoft replacement05Value <hier Seriennummer eintragen>
</pre>

Die Authentifizierung der Anlage erfolgt zwei-stufig. Zunächst muss ein Aufruf mit Benutzername und Kennwort erfolgen. Als Antwort erhält man einen JSON-String, der das Token beinhaltet. Mit diesem Token wird anschließend die Funktion connect aufgerufen und die Seriennummer des Geräts mit übergeben.
HTTPMOD erkennt, wenn ein neues Login erforderlich ist, wenn die Judo die Rückmeldung "no token" oder "not logged in" liefert.

Achtung: Als Parameter muss ebenfalls der Typ "i-soft plus" übergeben werden. Vermutlich ist dieser bei anderen Geräten des Herstellers anders. Ich habe ihn hier fix eingetragen, da ich keine Möglichkeit zum Testen anderer Geräte habe.

<pre>
attr JUDO_iSoft showError 1
attr JUDO_iSoft authRetries 2
attr JUDO_iSoft reAuthRegex (no token)|(not logged in)
attr JUDO_iSoft sid01ParseResponse 1
attr JUDO_iSoft sid01URL https://%JUDO_ipaddress%:8124/?group=register&command=login&msgnumber=1&name=login&user=%JUDO_username%&password=%JUDO_password%&role=customer
attr JUDO_iSoft sid02URL https://%JUDO_ipaddress%:8124/?group=register&command=connect&msgnumber=6&token=%token%&parameter=i-soft%20plus&serial%20number=%JUDO_serial%
</pre>

Damit ist die Grundkonfiguration hergestellt und die Anlage kann sich connecten.
In den einzelnen JSON-Rückantworten der Anlage werden die Werte zur jeweilige Anfrage immer als "data" zurück geliefert. Mit der Standard-Konfiguration

<pre>
attr JUDO_iSoft extractAllJSON 1
</pre>

werden daraus automatisch entsprechernde Readings angelegt. Da wir aber dann immer das Reading "data" überschreiben würde, kommt eine weitere Ersetzung zum Einsatz. In der Antwort steht neben einer Kaskadierung (group) auch der zugehörige Befehl (command). Ich habe mich dafür entschieden, ein neues Reading mit dem jeweiligen Command-Namen anzulegen. Die zugehörigen Ersetzungen sind wie folgt.
Erklärung zum Ausdruck reading03OExpr: Zunächst werden die Leerzeichen im Rückgabewert ($val) durch "-" ersetzt. Mit dem so veränderten String erzeugen wir ein neues Reading mit dem Wert aus dem Reading data.

<pre>
attr JUDO_iSoft reading01JSON data
attr JUDO_iSoft reading01Name token
attr JUDO_iSoft reading01Regex "token":"([^"]+)"
attr JUDO_iSoft reading02JSON group
attr JUDO_iSoft reading03JSON command
attr JUDO_iSoft reading03OExpr $val =~ s/\s/-/;; $val; readingsBulkUpdate($hash,$val,ReadingsVal("JUDO_iSoft","data",""))
</pre>
Noch ein paar ergänzende Attribute gesetzt:
<pre>
attr JUDO_iSoft enableControlSet 1
attr JUDO_iSoft getHeader1 Content-Type: application/json
attr JUDO_iSoft getHeader2 Accept: */*
attr JUDO_iSoft room 10_Räume->UG->Keller,
attr JUDO_iSoft showError
attr JUDO_iSoft timeout 5
</pre>

Damit sind alle Voraussetzungen erledigt. Ab jetzt können wir die einzelnen Get-Befehle implementieren:

<pre>
attr JUDO_iSoft get01Name SerialNumber
attr JUDO_iSoft get01URL https://%JUDO_ipaddress%:8124/?group=spare%20part&command=serial%20number&msgnumber=5&token=%token%

attr JUDO_iSoft get02Name WaterCurrent
attr JUDO_iSoft get02URL https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20current&msgnumber=1&token=%token%

attr JUDO_iSoft get03Name SaltRange
attr JUDO_iSoft get03URL https://%JUDO_ipaddress%:8124/?group=consumption&command=salt%20range&msgnumber=1&token=%token%

attr JUDO_iSoft get04Name SaltQuantity
attr JUDO_iSoft get04URL https://%JUDO_ipaddress%:8124/?group=consumption&command=salt%20quantity&msgnumber=1&token=%token%

attr JUDO_iSoft get05Name ResidualHardness
attr JUDO_iSoft get05URL https://%JUDO_ipaddress%:8124/?group=settings&command=residual%20hardness&msgnumber=1&token=%token%

attr JUDO_iSoft get06Name NaturalHardness
attr JUDO_iSoft get06URL https://%JUDO_ipaddress%:8124/?group=info&command=natural%20hardness&msgnumber=1&token=%token%

attr JUDO_iSoft get07Name WaterStop
attr JUDO_iSoft get07URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=valve&msgnumber=1&token=%token%

attr JUDO_iSoft get08Name FlowRate
attr JUDO_iSoft get08URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=flow%20rate&msgnumber=1&token=%token%

attr JUDO_iSoft get09Name SoftwareVersion
attr JUDO_iSoft get09URL https://%JUDO_ipaddress%:8124/?group=version&command=software%20version&msgnumber=1&token=%token%

attr JUDO_iSoft get10Name HardwareVersion
attr JUDO_iSoft get10URL https://%JUDO_ipaddress%:8124/?group=version&command=hardware%20version&msgnumber=1&token=%token%

attr JUDO_iSoft get11Name InstallationDate
attr JUDO_iSoft get11URL https://%JUDO_ipaddress%:8124/?group=contract&command=init%20date&msgnumber=1&token=%token%

attr JUDO_iSoft get12Name ServiceDate
attr JUDO_iSoft get12URL https://%JUDO_ipaddress%:8124/?group=contract&command=service%20date&msgnumber=1&token=%token%

attr JUDO_iSoft get13Name WaterTotal
attr JUDO_iSoft get13URL https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20total&msgnumber=1&token=%token%

attr JUDO_iSoft get14Name WaterAverage
attr JUDO_iSoft get14URL https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20average&msgnumber=1&token=%token%

attr JUDO_iSoft get15Name Vacation
attr JUDO_iSoft get15URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=vacation&msgnumber=1&token=%token%

attr JUDO_iSoft get16Name Quantity
attr JUDO_iSoft get16URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=quantity&msgnumber=1&token=%token%
</pre>

'''Userreadings'''

Um die Originalwerte aus der Anlage benutzerfreundlicher darzzustellen, werden noch Userreadings angelegt.

Die Salzrestdauer soll in Wochen angegeben (Rückgemeldet werden Tage) werden, die verbleibende Salzmenge in Prozent.
Die Salzemnge wird in Gramm angegeben, 50.000 entsprechen 100%.
Wichtig: Bei den Userreadings muss darauf geachtet werden, dass diese mit Komma separiert und in einer Zeile geschrieben werden.
<pre>

attr JUDO_iSoft saltRangeInWeeks { int( (ReadingsVal("JUDO_iSoft","salt-range",0)/7))} , saltQuantityInPercent { int( (ReadingsVal("JUDO_iSoft","salt-quantity",0)/50000)*100)}
</pre>

Weitere Befehle insbesondere zum Setzen und die Auswertung der Verbrauchswerte folgen.

== Ähnliche Systeme ==

== Projekte der FHEM-Community ==

== Links ==
* {{Link2Forum|Topic=56455|Message=800960}}
* [https://blog.muwave.de/2017/06/monitoring-and-controlling-a-judo-i-soft-plus-water-softening-device-via-lan/ ursprünglicher Beitrag bzgl. des verwendeten Protokolls]

[[Kategorie:IP Components]]
[[Kategorie:Other Components]]

JUDO iSoft Plus

2018-05-11T16:50:39Z

Loungelizard: Korrektur der Erzeugung der Readings (Readings mit Leerzeichen können nicht vernünftig weiter verarbeitet werden)

{{Infobox Hardware
|Bild=judo-soft-plus.jpg|200px
|Bildbeschreibung=JUDO iSoft Plus Wasserenthärtungsanlage
|HWProtocol=IP
|HWType=[[Wasserenthärter|Wasserenthärter]]
|HWCategory=IP
|HWVoltage=230 V
|HWPoweredBy=AC
|HWSize=39x67x45 cm (BxHxT)
|HWComm=n/a
|HWChannels=n/a
|HWPowerConsumption=?

|HWDeviceFHEM=[[HTTPMOD]]

|HWManufacturer=Judo GmbH
}}
__TOC__

Die JUDO i-soft plus Enthärtungsanlage [https://judo.eu/produkt/judo-i-soft-plus-vollautomatische-enthaertungsanlage/] ist eine Wasserenthärtungsanlage mit IP-Konnektivität.
Sie verfügt über LAN und WLAN-Anschluss und ist auf die Steuerung via App des Herstellers ausgelegt.

Für eine erfolgreiche Integration in FHEM muss die Anlage über das Menü beim Hersteller registriert werden.
Die folgenden Informationen sind erforderlich:

* Benutzername: Selbst gewählter Login-Name auf der iSoft plus (vgl. Gerätehandbuch)
* Kennwort: Selbst gewähltes Kennwort
* Seriennummer: Seriennummer des Geräts. Diese ist entweder über das Menü auslesbar oder alternativ auch über die APP des Herstellers.
* IP-Adresse: Die IP-Adresse des Geräts im Heimnetz.

== Einbindung in FHEM ==

Das Gerät wird mittels des Moduls HTTPMOD eingebunden. Dazu gilt zunächst die folgende Konfiguration als Basis.
Zunächst legen wir die Standardanfrage an das Modul fest. Die Portnummer 8124 ist vom Hersteller vorgegeben. Wir vergeben gleich ein paar Platzhalter, die später in den Aufrufen und den Antworten ersetzt werden, damit wir die Werte nur an einer zentralen Stelle konfigurieren müssen.

<pre>
define JUDO_iSoft HTTPMOD https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20current&msgnumber=1&token=%token%
</pre>

Nach erfolgreicher Authentifizierung wird von der iSoft ein Token generiert und muss bei jedem Aufruf übergeben werden:

<pre>
attr JUDO_iSoft replacement01Mode reading
attr JUDO_iSoft replacement01Regex %token%
attr JUDO_iSoft replacement01Value token
</pre>

Anschließend legen wir die Ersetzungen für die anderen Platzhalter fest:

<pre>
attr JUDO_iSoft replacement02Mode text
attr JUDO_iSoft replacement02Regex %JUDO_ipaddress%
attr JUDO_iSoft replacement02Value <hier eigene IP Adresse im lokalen Netz eintragen>
attr JUDO_iSoft replacement03Mode text
attr JUDO_iSoft replacement03Regex %JUDO_password%
attr JUDO_iSoft replacement03Value <hier Kennwort eintragen>
attr JUDO_iSoft replacement04Mode text
attr JUDO_iSoft replacement04Regex %JUDO_username%
attr JUDO_iSoft replacement04Value <hier Benutzername eintragen>
attr JUDO_iSoft replacement05Mode text
attr JUDO_iSoft replacement05Regex %JUDO_serial%
attr JUDO_iSoft replacement05Value <hier Seriennummer eintragen>
</pre>

Die Authentifizierung der Anlage erfolgt zwei-stufig. Zunächst muss ein Aufruf mit Benutzername und Kennwort erfolgen. Als Antwort erhält man einen JSON-String, der das Token beinhaltet. Mit diesem Token wird anschließend die Funktion connect aufgerufen und die Seriennummer des Geräts mit übergeben.
HTTPMOD erkennt, wenn ein neues Login erforderlich ist, wenn die Judo die Rückmeldung "no token" oder "not logged in" liefert.

Achtung: Als Parameter muss ebenfalls der Typ "i-soft plus" übergeben werden. Vermutlich ist dieser bei anderen Geräten des Herstellers anders. Ich habe ihn hier fix eingetragen, da ich keine Möglichkeit zum Testen anderer Geräte habe.

<pre>
attr JUDO_iSoft showError 1
attr JUDO_iSoft authRetries 2
attr JUDO_iSoft reAuthRegex (no token)|(not logged in)
attr JUDO_iSoft sid01ParseResponse 1
attr JUDO_iSoft sid01URL https://%JUDO_ipaddress%:8124/?group=register&command=login&msgnumber=1&name=login&user=%JUDO_username%&password=%JUDO_password%&role=customer
attr JUDO_iSoft sid02URL https://%JUDO_ipaddress%:8124/?group=register&command=connect&msgnumber=6&token=%token%&parameter=i-soft%20plus&serial%20number=%JUDO_serial%
</pre>

Damit ist die Grundkonfiguration hergestellt und die Anlage kann sich connecten.
In den einzelnen JSON-Rückantworten der Anlage werden die Werte zur jeweilige Anfrage immer als "data" zurück geliefert. Mit der Standard-Konfiguration

<pre>
attr JUDO_iSoft extractAllJSON 1
</pre>

werden daraus automatisch entsprechernde Readings angelegt. Da wir aber dann immer das Reading "data" überschreiben würde, kommt eine weitere Ersetzung zum Einsatz. In der Antwort steht neben einer Kaskadierung (group) auch der zugehörige Befehl (command). Ich habe mich dafür entschieden, ein neues Reading mit dem jeweiligen Command-Namen anzulegen. Die zugehörigen Ersetzungen sind wie folgt.
Erklärung zum Ausdruck reading03OExpr: Zunächst werden die Leerzeichen im Rückgabewert ($val) durch "-" ersetzt. Mit dem so veränderten String erzeugen wir ein neues Reading mit dem Wert aus dem Reading data.

<pre>
attr JUDO_iSoft reading01JSON data
attr JUDO_iSoft reading01Name token
attr JUDO_iSoft reading01Regex "token":"([^"]+)"
attr JUDO_iSoft reading02JSON group
attr JUDO_iSoft reading03JSON command
attr JUDO_iSoft reading03OExpr $val =~ s/\s/-/;; $val; readingsBulkUpdate($hash,$val,ReadingsVal("JUDO_iSoft","data",""))
</pre>
Noch ein paar ergänzende Attribute gesetzt:
<pre>
attr JUDO_iSoft enableControlSet 1
attr JUDO_iSoft getHeader1 Content-Type: application/json
attr JUDO_iSoft getHeader2 Accept: */*
attr JUDO_iSoft room 10_Räume->UG->Keller,
attr JUDO_iSoft showError
attr JUDO_iSoft timeout 5
</pre>

Damit sind alle Voraussetzungen erledigt. Ab jetzt können wir die einzelnen Get-Befehle implementieren:

<pre>
attr JUDO_iSoft get01Name SerialNumber
attr JUDO_iSoft get01URL https://%JUDO_ipaddress%:8124/?group=spare%20part&command=serial%20number&msgnumber=5&token=%token%

attr JUDO_iSoft get02Name WaterCurrent
attr JUDO_iSoft get02URL https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20current&msgnumber=1&token=%token%

attr JUDO_iSoft get03Name SaltRange
attr JUDO_iSoft get03URL https://%JUDO_ipaddress%:8124/?group=consumption&command=salt%20range&msgnumber=1&token=%token%

attr JUDO_iSoft get04Name SaltQuantity
attr JUDO_iSoft get04URL https://%JUDO_ipaddress%:8124/?group=consumption&command=salt%20quantity&msgnumber=1&token=%token%

attr JUDO_iSoft get05Name ResidualHardness
attr JUDO_iSoft get05URL https://%JUDO_ipaddress%:8124/?group=settings&command=residual%20hardness&msgnumber=1&token=%token%

attr JUDO_iSoft get06Name NaturalHardness
attr JUDO_iSoft get06URL https://%JUDO_ipaddress%:8124/?group=info&command=natural%20hardness&msgnumber=1&token=%token%

attr JUDO_iSoft get07Name WaterStop
attr JUDO_iSoft get07URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=valve&msgnumber=1&token=%token%

attr JUDO_iSoft get08Name FlowRate
attr JUDO_iSoft get08URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=flow%20rate&msgnumber=1&token=%token%

attr JUDO_iSoft get09Name SoftwareVersion
attr JUDO_iSoft get09URL https://%JUDO_ipaddress%:8124/?group=version&command=software%20version&msgnumber=1&token=%token%

attr JUDO_iSoft get10Name HardwareVersion
attr JUDO_iSoft get10URL https://%JUDO_ipaddress%:8124/?group=version&command=hardware%20version&msgnumber=1&token=%token%

attr JUDO_iSoft get11Name InstallationDate
attr JUDO_iSoft get11URL https://%JUDO_ipaddress%:8124/?group=contract&command=init%20date&msgnumber=1&token=%token%

attr JUDO_iSoft get12Name ServiceDate
attr JUDO_iSoft get12URL https://%JUDO_ipaddress%:8124/?group=contract&command=service%20date&msgnumber=1&token=%token%

attr JUDO_iSoft get13Name WaterTotal
attr JUDO_iSoft get13URL https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20total&msgnumber=1&token=%token%

attr JUDO_iSoft get14Name WaterAverage
attr JUDO_iSoft get14URL https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20average&msgnumber=1&token=%token%

attr JUDO_iSoft get15Name Vacation
attr JUDO_iSoft get15URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=vacation&msgnumber=1&token=%token%

attr JUDO_iSoft get16Name Quantity
attr JUDO_iSoft get16URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=quantity&msgnumber=1&token=%token%
</pre>

Weitere Befehle insbesondere zum Setzen und die Auswertung der Verbrauchswerte folgen.

== Ähnliche Systeme ==

== Projekte der FHEM-Community ==

== Links ==
[https://forum.fhem.de/index.php/topic,56455.msg800960.html#msg800960] Forumsbeitrag
[https://blog.muwave.de/2017/06/monitoring-and-controlling-a-judo-i-soft-plus-water-softening-device-via-lan/] ursprünglicher Beitrag bzgl. des verwendeten Protokolls

[[Kategorie:IP Components]]
[[Kategorie:Other Components]]

JUDO iSoft Plus

2018-05-11T13:01:03Z

Loungelizard: /* Einbindung in FHEM */

{{Infobox Hardware
|Bild=judo-soft-plus.jpg|200px
|Bildbeschreibung=JUDO iSoft Plus Wasserenthärtungsanlage
|HWProtocol=IP
|HWType=[[Wasserenthärter|Wasserenthärter]]
|HWCategory=IP
|HWVoltage=230 V
|HWPoweredBy=AC
|HWSize=39x67x45 cm (BxHxT)
|HWComm=n/a
|HWChannels=n/a
|HWPowerConsumption=?

|HWDeviceFHEM=[[HTTPMOD]]

|HWManufacturer=Judo GmbH
}}
__TOC__

Die JUDO i-soft plus Enthärtungsanlage [https://judo.eu/produkt/judo-i-soft-plus-vollautomatische-enthaertungsanlage/] ist eine Wasserenthärtungsanlage mit IP-Konnektivität.
Sie verfügt über LAN und WLAN-Anschluss und ist auf die Steuerung via App des Herstellers ausgelegt.

Für eine erfolgreiche Integration in FHEM muss die Anlage über das Menü beim Hersteller registriert werden.
Die folgenden Informationen sind erforderlich:

* Benutzername: Selbst gewählter Login-Name auf der iSoft plus (vgl. Gerätehandbuch)
* Kennwort: Selbst gewähltes Kennwort
* Seriennummer: Seriennummer des Geräts. Diese ist entweder über das Menü auslesbar oder alternativ auch über die APP des Herstellers.
* IP-Adresse: Die IP-Adresse des Geräts im Heimnetz.

== Einbindung in FHEM ==

Das Gerät wird mittels des Moduls HTTPMOD eingebunden. Dazu gilt zunächst die folgende Konfiguration als Basis.
Zunächst legen wir die Standardanfrage an das Modul fest. Die Portnummer 8124 ist vom Hersteller vorgegeben. Wir vergeben gleich ein paar Platzhalter, die später in den Aufrufen und den Antworten ersetzt werden, damit wir die Werte nur an einer zentralen Stelle konfigurieren müssen.

<pre>
define JUDO_iSoft HTTPMOD https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20current&msgnumber=1&token=%token%
</pre>

Nach erfolgreicher Authentifizierung wird von der iSoft ein Token generiert und muss bei jedem Aufruf übergeben werden:

<pre>
attr JUDO_iSoft replacement01Mode reading
attr JUDO_iSoft replacement01Regex %token%
attr JUDO_iSoft replacement01Value token
</pre>

Anschließend legen wir die Ersetzungen für die anderen Platzhalter fest:

<pre>
attr JUDO_iSoft replacement02Mode text
attr JUDO_iSoft replacement02Regex %JUDO_ipaddress%
attr JUDO_iSoft replacement02Value <hier eigene IP Adresse im lokalen Netz eintragen>
attr JUDO_iSoft replacement03Mode text
attr JUDO_iSoft replacement03Regex %JUDO_password%
attr JUDO_iSoft replacement03Value <hier Kennwort eintragen>
attr JUDO_iSoft replacement04Mode text
attr JUDO_iSoft replacement04Regex %JUDO_username%
attr JUDO_iSoft replacement04Value <hier Benutzername eintragen>
attr JUDO_iSoft replacement05Mode text
attr JUDO_iSoft replacement05Regex %JUDO_serial%
attr JUDO_iSoft replacement05Value <hier Seriennummer eintragen>
</pre>

Die Authentifizierung der Anlage erfolgt zwei-stufig. Zunächst muss ein Aufruf mit Benutzername und Kennwort erfolgen. Als Antwort erhält man einen JSON-String, der das Token beinhaltet. Mit diesem Token wird anschließend die Funktion connect aufgerufen und die Seriennummer des Geräts mit übergeben.
HTTPMOD erkennt, wenn ein neues Login erforderlich ist, wenn die Judo die Rückmeldung "no token" oder "not logged in" liefert.

Achtung: Als Parameter muss ebenfalls der Typ "i-soft plus" übergeben werden. Vermutlich ist dieser bei anderen Geräten des Herstellers anders. Ich habe ihn hier fix eingetragen, da ich keine Möglichkeit zum Testen anderer Geräte habe.

<pre>
attr JUDO_iSoft showError 1
attr JUDO_iSoft authRetries 2
attr JUDO_iSoft reAuthRegex (no token)|(not logged in)
attr JUDO_iSoft sid01ParseResponse 1
attr JUDO_iSoft sid01URL https://%JUDO_ipaddress%:8124/?group=register&command=login&msgnumber=1&name=login&user=%JUDO_username%&password=%JUDO_password%&role=customer
attr JUDO_iSoft sid02URL https://%JUDO_ipaddress%:8124/?group=register&command=connect&msgnumber=6&token=%token%&parameter=i-soft%20plus&serial%20number=%JUDO_serial%
</pre>

Damit ist die Grundkonfiguration hergestellt und die Anlage kann sich connecten.
In den einzelnen JSON-Rückantworten der Anlage werden die Werte zur jeweilige Anfrage immer als "data" zurück geliefert. Mit der Standard-Konfiguration

<pre>
attr JUDO_iSoft extractAllJSON 1
</pre>

werden daraus automatisch entsprechernde Readings angelegt. Da wir aber dann immer das Reading "data" überschreiben würde, kommt eine weitere Ersetzung zum Einsatz. In der Antwort steht neben einer Kaskadierung (group) auch der zugehörige Befehl (command). Ich habe mich dafür entschieden, ein neues Reading mit dem jeweiligen Command-Namen anzulegen. Die zugehörigen Ersetzungen sind wie folg:

<pre>
attr JUDO_iSoft reading01JSON data
attr JUDO_iSoft reading01Name token
attr JUDO_iSoft reading01Regex "token":"([^"]+)"
attr JUDO_iSoft reading02JSON group
attr JUDO_iSoft reading03JSON command
attr JUDO_iSoft reading03OExpr readingsBulkUpdate($hash,$val,ReadingsVal("JUDO_iSoft","data",""))
</pre>
Noch ein paar ergänzende Attribute gesetzt:
<pre>
attr JUDO_iSoft enableControlSet 1
attr JUDO_iSoft getHeader1 Content-Type: application/json
attr JUDO_iSoft getHeader2 Accept: */*
attr JUDO_iSoft room 10_Räume->UG->Keller,
attr JUDO_iSoft showError
attr JUDO_iSoft timeout 5
</pre>

Damit sind alle Voraussetzungen erledigt. Ab jetzt können wir die einzelnen Get-Befehle implementieren:

<pre>
attr JUDO_iSoft get01Name SerialNumber
attr JUDO_iSoft get01URL https://%JUDO_ipaddress%:8124/?group=spare%20part&command=serial%20number&msgnumber=5&token=%token%

attr JUDO_iSoft get02Name WaterCurrent
attr JUDO_iSoft get02URL https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20current&msgnumber=1&token=%token%

attr JUDO_iSoft get03Name SaltRange
attr JUDO_iSoft get03URL https://%JUDO_ipaddress%:8124/?group=consumption&command=salt%20range&msgnumber=1&token=%token%

attr JUDO_iSoft get04Name SaltQuantity
attr JUDO_iSoft get04URL https://%JUDO_ipaddress%:8124/?group=consumption&command=salt%20quantity&msgnumber=1&token=%token%

attr JUDO_iSoft get05Name ResidualHardness
attr JUDO_iSoft get05URL https://%JUDO_ipaddress%:8124/?group=settings&command=residual%20hardness&msgnumber=1&token=%token%

attr JUDO_iSoft get06Name NaturalHardness
attr JUDO_iSoft get06URL https://%JUDO_ipaddress%:8124/?group=info&command=natural%20hardness&msgnumber=1&token=%token%

attr JUDO_iSoft get07Name WaterStop
attr JUDO_iSoft get07URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=valve&msgnumber=1&token=%token%

attr JUDO_iSoft get08Name FlowRate
attr JUDO_iSoft get08URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=flow%20rate&msgnumber=1&token=%token%

attr JUDO_iSoft get09Name SoftwareVersion
attr JUDO_iSoft get09URL https://%JUDO_ipaddress%:8124/?group=version&command=software%20version&msgnumber=1&token=%token%

attr JUDO_iSoft get10Name HardwareVersion
attr JUDO_iSoft get10URL https://%JUDO_ipaddress%:8124/?group=version&command=hardware%20version&msgnumber=1&token=%token%

attr JUDO_iSoft get11Name InstallationDate
attr JUDO_iSoft get11URL https://%JUDO_ipaddress%:8124/?group=contract&command=init%20date&msgnumber=1&token=%token%

attr JUDO_iSoft get12Name ServiceDate
attr JUDO_iSoft get12URL https://%JUDO_ipaddress%:8124/?group=contract&command=service%20date&msgnumber=1&token=%token%

attr JUDO_iSoft get13Name WaterTotal
attr JUDO_iSoft get13URL https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20total&msgnumber=1&token=%token%

attr JUDO_iSoft get14Name WaterAverage
attr JUDO_iSoft get14URL https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20average&msgnumber=1&token=%token%

attr JUDO_iSoft get15Name Vacation
attr JUDO_iSoft get15URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=vacation&msgnumber=1&token=%token%

attr JUDO_iSoft get16Name Quantity
attr JUDO_iSoft get16URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=quantity&msgnumber=1&token=%token%
</pre>

Weitere Befehle insbesondere zum Setzen und die Auswertung der Verbrauchswerte folgen.

== Ähnliche Systeme ==

== Projekte der FHEM-Community ==

== Links ==
[https://forum.fhem.de/index.php/topic,56455.msg800960.html#msg800960] Forumsbeitrag
[https://blog.muwave.de/2017/06/monitoring-and-controlling-a-judo-i-soft-plus-water-softening-device-via-lan/] ursprünglicher Beitrag bzgl. des verwendeten Protokolls

[[Kategorie:IP Components]]
[[Kategorie:Other Components]]

JUDO iSoft Plus

2018-05-11T12:52:12Z

Loungelizard: Weitere get-Befehle ergänz

{{Infobox Hardware
|Bild=judo-soft-plus.jpg|200px
|Bildbeschreibung=JUDO iSoft Plus Wasserenthärtungsanlage
|HWProtocol=IP
|HWType=[[Wasserenthärter|Wasserenthärter]]
|HWCategory=IP
|HWVoltage=230 V
|HWPoweredBy=AC
|HWSize=39x67x45 cm (BxHxT)
|HWComm=n/a
|HWChannels=n/a
|HWPowerConsumption=?

|HWDeviceFHEM=[[HTTPMOD]]

|HWManufacturer=Judo GmbH
}}
__TOC__

Die JUDO i-soft plus Enthärtungsanlage [https://judo.eu/produkt/judo-i-soft-plus-vollautomatische-enthaertungsanlage/] ist eine Wasserenthärtungsanlage mit IP-Konnektivität.
Sie verfügt über LAN und WLAN-Anschluss und ist auf die Steuerung via App des Herstellers ausgelegt.

Für eine erfolgreiche Integration in FHEM muss die Anlage über das Menü beim Hersteller registriert werden.
Die folgenden Informationen sind erforderlich:

* Benutzername: Selbst gewählter Login-Name auf der iSoft plus (vgl. Gerätehandbuch)
* Kennwort: Selbst gewähltes Kennwort
* Seriennummer: Seriennummer des Geräts. Diese ist entweder über das Menü auslesbar oder alternativ auch über die APP des Herstellers.
* IP-Adresse: Die IP-Adresse des Geräts im Heimnetz.

== Einbindung in FHEM ==

Das Gerät wird mittels des Moduls HTTPMOD eingebunden. Dazu gilt zunächst die folgende Konfiguration als Basis.
Zunächst legen wir die Standardanfrage an das Modul fest. Die Portnummer 8124 ist vom Hersteller vorgegeben. Wir vergeben gleich ein paar Platzhalter, die später in den Aufrufen und den Antworten ersetzt werden, damit wir die Werte nur an einer zentralen Stelle konfigurieren müssen.

<pre>
define JUDO_iSoft HTTPMOD https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20current&msgnumber=1&token=%token%
</pre>

Nach erfolgreicher Authentifizierung wird von der iSoft ein Token generiert und muss bei jedem Aufruf übergeben werden:

<pre>
attr JUDO_iSoft replacement01Mode reading
attr JUDO_iSoft replacement01Regex %token%
attr JUDO_iSoft replacement01Value token
</pre>

Anschließend legen wir die Ersetzungen für die anderen Platzhalter fest:

<pre>
attr JUDO_iSoft replacement02Mode text
attr JUDO_iSoft replacement02Regex %JUDO_ipaddress%
attr JUDO_iSoft replacement02Value <hier eigene IP Adresse im lokalen Netz eintragen>
attr JUDO_iSoft replacement03Mode text
attr JUDO_iSoft replacement03Regex %JUDO_password%
attr JUDO_iSoft replacement03Value <hier Kennwort eintragen>
attr JUDO_iSoft replacement04Mode text
attr JUDO_iSoft replacement04Regex %JUDO_username%
attr JUDO_iSoft replacement04Value <hier Benutzername eintragen>
attr JUDO_iSoft replacement05Mode text
attr JUDO_iSoft replacement05Regex %JUDO_serial%
attr JUDO_iSoft replacement05Value <hier Seriennummer eintragen>
</pre>

Die Authentifizierung der Anlage erfolgt zwei-stufig. Zunächst muss ein Aufruf mit Benutzername und Kennwort erfolgen. Als Antwort erhält man einen JSON-String, der das Token beinhaltet. Mit diesem Token wird anschließend die Funktion connect aufgerufen und die Seriennummer des Geräts mit übergeben.
HTTPMOD erkennt, wenn ein neues Login erforderlich ist, wenn die Judo die Rückmeldung "no token" oder "not logged in" liefert.

Achtung: Als Parameter muss ebenfalls der Typ "i-soft plus" übergeben werden. Vermutlich ist dieser bei anderen Geräten des Herstellers anders. Ich habe ihn hier fix eingetragen, da ich keine Möglichkeit zum Testen anderer Geräte habe.

<pre>
attr JUDO_iSoft showError 1
attr JUDO_iSoft authRetries 2
attr JUDO_iSoft reAuthRegex (no token)|(not logged in)
attr JUDO_iSoft sid01ParseResponse 1
attr JUDO_iSoft sid01URL https://%JUDO_ipaddress%:8124/?group=register&command=login&msgnumber=1&name=login&user=%JUDO_username%&password=%JUDO_password%&role=customer
attr JUDO_iSoft sid02URL https://%JUDO_ipaddress%:8124/?group=register&command=connect&msgnumber=6&token=%token%&parameter=i-soft%20plus&serial%20number=%JUDO_serial%
</pre>

Damit ist die Grundkonfiguration hergestellt und die Anlage kann sich connecten.
In den einzelnen JSON-Rückantworten der Anlage werden die Werte zur jeweilige Anfrage immer als "data" zurück geliefert. Mit der Standard-Konfiguration

<pre>
attr JUDO_iSoft extractAllJSON 1
</pre>

werden daraus automatisch entsprechernde Readings angelegt. Da wir aber dann immer das Reading "data" überschreiben würde, kommt eine weitere Ersetzung zum Einsatz. In der Antwort steht neben einer Kaskadierung (group) auch der zugehörige Befehl (command). Ich habe mich dafür entschieden, ein neues Reading mit dem jeweiligen Command-Namen anzulegen. Die zugehörigen Ersetzungen sind wie folg:

<pre>
attr JUDO_iSoft reading01JSON data
attr JUDO_iSoft reading01Name token
attr JUDO_iSoft reading01Regex "token":"([^"]+)"
attr JUDO_iSoft reading02JSON group
attr JUDO_iSoft reading03JSON command
attr JUDO_iSoft reading03OExpr readingsBulkUpdate($hash,$val,ReadingsVal("JUDO_iSoft","data",""))
</pre>
Noch ein paar ergänzende Attribute gesetzt:
<pre>
attr JUDO_iSoft enableControlSet 1
attr JUDO_iSoft getHeader1 Content-Type: application/json
attr JUDO_iSoft getHeader2 Accept: */*
attr JUDO_iSoft room 10_Räume->UG->Keller,
attr JUDO_iSoft showError
attr JUDO_iSoft timeout 5
</pre>

Damit sind alle Voraussetzungen erledigt. Ab jetzt können wir die einzelnen Get-Befehle implementieren:

<pre>
attr JUDO_iSoft get01Name SerialNumber
attr JUDO_iSoft get01URL https://%JUDO_ipaddress%:8124/?group=spare%20part&command=serial%20number&msgnumber=5&token=%token%

attr JUDO_iSoft get02Name WaterCurrent
attr JUDO_iSoft get02URL https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20current&msgnumber=1&token=%token%

attr JUDO_iSoft get03Name SaltRange
attr JUDO_iSoft get03URL https://%JUDO_ipaddress%:8124/?group=consumption&command=salt%20range&msgnumber=1&token=%token%

attr JUDO_iSoft get04Name SaltQuantity
attr JUDO_iSoft get04URL https://%JUDO_ipaddress%:8124/?group=consumption&command=salt%20quantity&msgnumber=1&token=%token%

attr JUDO_iSoft get05Name ResidualHardness
attr JUDO_iSoft get05URL https://%JUDO_ipaddress%:8124/?group=settings&command=residual%20hardness&msgnumber=1&token=%token%

attr JUDO_iSoft get06Name NaturalHardness
attr JUDO_iSoft get06URL https://%JUDO_ipaddress%:8124/?group=info&command=natural%20hardness&msgnumber=1&token=%token%

attr JUDO_iSoft get07Name WaterStop
attr JUDO_iSoft get07URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=valve&msgnumber=1&token=%token%

attr JUDO_iSoft get08Name FlowRate
attr JUDO_iSoft get08URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=flow%20rate&msgnumber=1&token=%token%

attr JUDO_iSoft get09Name SoftwareVersion
attr JUDO_iSoft get09URL https://%JUDO_ipaddress%:8124/?group=version&command=software%20version&msgnumber=1&token=%token%

attr JUDO_iSoft get10Name HardwareVersion
attr JUDO_iSoft get10URL https://%JUDO_ipaddress%:8124/?group=version&command=hardware%20version&msgnumber=1&token=%token%

attr JUDO_iSoft get11Name InstallationDate
attr JUDO_iSoft get11URL https://%JUDO_ipaddress%:8124/?group=contract&command=init%20date&msgnumber=1&token=%token%

attr JUDO_iSoft get12Name ServiceDate
attr JUDO_iSoft get12URL https://%JUDO_ipaddress%:8124/?group=contract&command=service%20date&msgnumber=1&token=%token%

attr JUDO_iSoft get13Name WaterTotal
attr JUDO_iSoft get13URL https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20total&msgnumber=1&token=%token%

attr JUDO_iSoft get14Name WaterAverage
attr JUDO_iSoft get14URL https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20average&msgnumber=1&token=%token%

attr JUDO_iSoft get14Name WaterAverage
attr JUDO_iSoft get14URL https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20average&msgnumber=1&token=%token%

attr JUDO_iSoft get14Name WaterAverage
attr JUDO_iSoft get14URL https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20average&msgnumber=1&token=%token%

</pre>

Weitere Befehle insbesondere zum Setzen und die Auswertung der Verbrauchswerte folgen.

== Ähnliche Systeme ==

== Projekte der FHEM-Community ==

== Links ==
[https://forum.fhem.de/index.php/topic,56455.msg800960.html#msg800960] Forumsbeitrag
[https://blog.muwave.de/2017/06/monitoring-and-controlling-a-judo-i-soft-plus-water-softening-device-via-lan/] ursprünglicher Beitrag bzgl. des verwendeten Protokolls

[[Kategorie:IP Components]]
[[Kategorie:Other Components]]

JUDO iSoft Plus

2018-05-11T12:40:21Z

Loungelizard: Bild ersetzt, Links ergänzt

JUDO iSoft Plus

2018-05-11T12:37:14Z

Loungelizard: Bild ersetzt

Datei:Judo-soft-plus.jpg

2018-05-11T12:35:31Z

Loungelizard:

JUDO iSoft Plus

2018-05-11T09:11:56Z

Loungelizard: Initiale Erstellung der Integration einer JUDO iSoft Plus auf Basis HTTPMOD

{{Infobox Hardware
|Bild=Judo-soft-plus.png|200px
|Bildbeschreibung=JUDO iSoft Plus Wasserenthärtungsanlage
|HWProtocol=IP
|HWType=[[Wasserenthärter|Wasserenthärter]]
|HWCategory=IP
|HWVoltage=230 V
|HWPowerConsumption=180 mA
|HWPoweredBy=AC
|HWSize=39x67x45 cm (BxHxT)
|HWComm=n/a
|HWChannels=n/a
|HWPowerConsumption=?

|HWDeviceFHEM=[[HTTPMOD]]

|HWManufacturer=Judo GmbH
}}
__TOC__

Die JUDO i-soft plus Enthärtungsanlage [https://judo.eu/produkt/judo-i-soft-plus-vollautomatische-enthaertungsanlage/] ist eine Wasserenthärtungsanlage mit IP-Konnektivität.
Sie verfügt über LAN und WLAN-Anschluss und ist auf die Steuerung via App des Herstellers ausgelegt.

Für eine erfolgreiche Integration in FHEM muss die Anlage über das Menü beim Hersteller registriert werden.
Die folgenden Informationen sind erforderlich:

* Benutzername: Selbst gewählter Login-Name auf der iSoft plus (vgl. Gerätehandbuch)
* Kennwort: Selbst gewähltes Kennwort
* Seriennummer: Seriennummer des Geräts. Diese ist entweder über das Menü auslesbar oder alternativ auch über die APP des Herstellers.
* IP-Adresse: Die IP-Adresse des Geräts im Heimnetz.

== Einbindung in FHEM ==

Das Gerät wird mittels des Moduls HTTPMOD eingebunden. Dazu gilt zunächst die folgende Konfiguration als Basis.
Zunächst legen wir die Standardanfrage an das Modul fest. Die Portnummer 8124 ist vom Hersteller vorgegeben. Wir vergeben gleich ein paar Platzhalter, die später in den Aufrufen und den Antworten ersetzt werden, und damit wir die Werte nur an einer zentralen Stelle konfigurieren müssen.

<pre>
define JUDO_iSoft HTTPMOD https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20current&msgnumber=1&token=%token%
</pre>

Nach erfolgreicher Authentifizierung wird von der iSoft ein Token generiert und muss bei jedem Aufruf übergeben werden:

<pre>
attr JUDO_iSoft replacement01Mode reading
attr JUDO_iSoft replacement01Regex %token%
attr JUDO_iSoft replacement01Value token
</pre>

Anschließend legen wir die Ersetzungen für die anderen Platzhalter fest:

<pre>
attr JUDO_iSoft replacement02Mode text
attr JUDO_iSoft replacement02Regex %JUDO_ipaddress%
attr JUDO_iSoft replacement02Value <hier eigene IP Adresse im lokalen Netz eintragen>
attr JUDO_iSoft replacement03Mode text
attr JUDO_iSoft replacement03Regex %JUDO_password%
attr JUDO_iSoft replacement03Value <hier Kennwort eintragen>
attr JUDO_iSoft replacement04Mode text
attr JUDO_iSoft replacement04Regex %JUDO_username%
attr JUDO_iSoft replacement04Value <hier Benutzername eintragen>
attr JUDO_iSoft replacement05Mode text
attr JUDO_iSoft replacement05Regex %JUDO_serial%
attr JUDO_iSoft replacement05Value <hier Seriennummer eintragen>
</pre>

Die Authentifizierung der Anlage erfolgt zwei-stufig. Zunächst muss ein Aufruf mit Benutzername und Kennwort erfolgen. Als Antwort erhält man einen JSON-String, der das Token beinhaltet. Mit diesem Token wird anschließend die Funktion connect aufgerufen und die Seriennummer des Geräts mit übergeben.
HTTPMOD erkennt, wenn ein neues Login erforderlich ist, wenn die Judo die Rückmeldung "no token" oder "not logged in" liefert.

Achtung: Als Parameter muss ebenfalls der Typ "i-soft plus" übergeben werden. Vermutlich ist dieser bei anderen Geräten des Herstellers anders. Ich habe ihn hier fix eingetragen, da ich keine Möglichkeit zum Testen anderer Geräte habe.

<pre>
attr JUDO_iSoft showError 1
attr JUDO_iSoft authRetries 2
attr JUDO_iSoft reAuthRegex (no token)|(not logged in)
attr JUDO_iSoft sid01ParseResponse 1
attr JUDO_iSoft sid01URL https://%JUDO_ipaddress%:8124/?group=register&command=login&msgnumber=1&name=login&user=%JUDO_username%&password=%JUDO_password%&role=customer
attr JUDO_iSoft sid02URL https://%JUDO_ipaddress%:8124/?group=register&command=connect&msgnumber=6&token=%token%&parameter=i-soft%20plus&serial%20number=%JUDO_serial%
</pre>

Damit ist die Grundkonfiguration hergestellt und die Anlage kann sich connecten.
In den einzelnen JSON-Rückantworten der Anlage werden die Werte zur jeweilige Anfrage immer als "data" zurück geliefert. Mit der Standard-Konfiguration

<pre>
attr JUDO_iSoft extractAllJSON 1
</pre>

werden daraus automatisch entsprechernde Readings angelegt. Da wir aber dann immer das Reading "data" überschreiben würde, kommt eine weitere Ersetzung zum Einsatz. In der Antwort steht neben einer Kaskadierung (group) auch der zugehörige Befehl (command). Ich habe mich dafür entschieden, ein neues Reading mit dem jeweiligen Command-Namen anzulegen. Die zugehörigen Ersetzungen sind wie folg:

<pre>
attr JUDO_iSoft reading01JSON data
attr JUDO_iSoft reading01Name token
attr JUDO_iSoft reading01Regex "token":"([^"]+)"
attr JUDO_iSoft reading02JSON group
attr JUDO_iSoft reading03JSON command
attr JUDO_iSoft reading03OExpr readingsBulkUpdate($hash,$val,ReadingsVal("JUDO_iSoft","data",""))
</pre>
Noch ein paar ergänzende Attribute gesetzt:
<pre>
attr JUDO_iSoft enableControlSet 1
attr JUDO_iSoft getHeader1 Content-Type: application/json
attr JUDO_iSoft getHeader2 Accept: */*
attr JUDO_iSoft room 10_Räume->UG->Keller,
attr JUDO_iSoft showError
attr JUDO_iSoft timeout 5
</pre>

Damit sind alle Voraussetzungen erledigt. Ab jetzt können wir die einzelnen Get-Befehle implementieren:

<pre>
attr JUDO_iSoft get01Name SerialNumber
attr JUDO_iSoft get01URL https://%JUDO_ipaddress%:8124/?group=spare%20part&command=serial%20number&msgnumber=5&token=%token%
attr JUDO_iSoft get02Name WaterCurrent
attr JUDO_iSoft get02URL https://%JUDO_ipaddress%:8124/?group=consumption&command=water%20current&msgnumber=1&token=%token%
attr JUDO_iSoft get03Name SaltRange
attr JUDO_iSoft get03URL https://%JUDO_ipaddress%:8124/?group=consumption&command=salt%20range&msgnumber=1&token=%token%
attr JUDO_iSoft get04Name SaltRange
attr JUDO_iSoft get04URL https://%JUDO_ipaddress%:8124/?group=consumption&command=salt%20range&msgnumber=1&token=%token%
attr JUDO_iSoft get05Name ResidualHardness
attr JUDO_iSoft get05URL https://%JUDO_ipaddress%:8124/?group=settings&command=residual%20hardness&msgnumber=1&token=%token%
attr JUDO_iSoft get06Name NaturalHardness
attr JUDO_iSoft get06URL https://%JUDO_ipaddress%:8124/?group=info&command=natural%20hardness&msgnumber=1&token=%token%
attr JUDO_iSoft get07Name WaterStop
attr JUDO_iSoft get07URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=valve&msgnumber=1&token=%token%
attr JUDO_iSoft get08Name FlowRate
attr JUDO_iSoft get08URL https://%JUDO_ipaddress%:8124/?group=waterstop&command=flow%20rate&msgnumber=1&token=%token%
</pre>

Weitere Befehle insbesondere zum Setzen und die Auswertung der Verbrauchswerte folgen.

== Ähnliche Systeme ==

== Projekte der FHEM-Community ==

== Links ==
[[https://forum.fhem.de/index.php/topic,56455.msg800960.html#msg800960]]

[[Kategorie:IP Components]]
[[Kategorie:Other Components]]

IPCAM

2018-03-04T11:36:50Z

Loungelizard: Xiaomi Dafang ergänzt

{{Infobox Modul
|ModPurpose=Einbindung von Netzwerkkameras
|ModType=d
|ModForumArea=Sonstiges
|ModTechName=49_IPCAM.pm
|ModOwner=mfr69bs ({{Link2FU|6|Martin Fischer}})}}

[[IPCAM]] ermöglicht die ereignis- oder zeitgesteuerte Erzeugung von Mitschnitten bei Netzwerkkameras. Außerdem ist es möglich, die Kamera im PTZ-Modus oder über eigene Befehle zu steuern.

== Voraussetzungen ==
Die Kamera(bilder) müssen über eine URL erreichbar sein.

== Definition ==
Das IPCAM Objekt wird angelegt mit
:<code><nowiki>define <name> IPCAM <ip[:port]> </nowiki></code>

Zusätzlich zum obigen Define muss zwingend noch das ''path'' Attribut gesetzt werden.

== Attribute ==
Die wichtigsten Attribute von ''IPCAM'' werden im Folgenden aufgeführt, die komplette Liste findet sich in der {{Link2CmdRef|Anker=IPCAMattr}}.

=== Authentifizierung ===
;basicauth
:Hinterlegung von Benutzernamen und Passwort

=== Eigene Befehle ===
;cmd01, cmd02, ... cmd15
:Festlegung von Befehlen, die nicht zu den vordefinierten gehören, z.B. <code>attr ipcam cmd01 led_mode=0</code>

=== Vordefinierte Befehle ===
;cmdPanLeft, cmdPanRight, cmdTiltUp, cmdTiltDown, cmdStep
:Diesen Befehlen können die Kameraspezifischen Werte zugeordnet werden, z.B. <code>attr ipcam cmdTiltUp command=0</code>

=== Pfade ===
;path
:...

== Unterstützte Netzwerkkameras ==
{{Randnotiz|RNText=Die Aufzählungen der unterstützten und der problematischen Netzwerkkameras sollten ergänzt werden, sobald neue Erkenntnisse vorliegen; beide Listen sind nicht vollständig.}}
Bei den folgenden Netzwerkkameras ist gesichert, dass sie durch das ''IPCAM'' Modul unterstützt sind:
* {{Link2Forum|Topic=33347|Message=257115|LinkText=Foscam 9805W}}
* Foscam FI9831P
* {{Link2Forum|Topic=13826|LinkText=Instar 2905}}
* {{Link2Forum|Topic=36201|LinkText=IN-6001HD}}
* {{Link2Forum|Topic=11664|LinkText=Instar 6011, 6012, 2905}}
* {{Link2Forum|Topic=58676|LinkText=Instar IN-5905HD, IN-5907HD, IN-6014HD, IN-6012HD-PoE}}
* {{Link2Forum|Topic=15217|LinkText=WansView (Modell nicht näher spezifiziert)}}
* {{Link2Forum|Topic=11664|Message=158052|LinkText=Wansview 620, 625, 6012}}
* Axis 205
* D-Link DCS-933
* Xiaomi Dafang (nur mit alternativer Firmware)

Nicht gesichert, ob die Kamera unterstützt wird bzw. ob alle Funktionen nutzbar sind:
* {{Link2Forum|Topic=33347|LinkText=Foscam FI9831W}}

=== Pfad-Parameter für Axis 205 ===
<pre>
attr Cam1 path /jpg/image.jpg
</pre>

=== Pfad-Parameter für D-Link DCS-933 ===
<pre>attr Cam1 path image.jpg</pre>

=== Parameter für Hikvision DS-2CD2032-I ===
Mit folgenden Parameter wurde (lt. diesem {{Link2Forum|Topic=39932|Message=322269|LinkText=Forenbeitrag}}) die Hikvision DS-2CD2032-I erfolgreich betrieben:
<pre>
define Cam1 IPCAM 192.168.xxx.xxx
attr Cam1 basicauth <username>:<passwort>
attr Cam1 delay 0
attr Cam1 group Kamera
attr Cam1 icon it_camera
attr Cam1 path Streaming/channels/1/picture?snapShotImageType=JPEG
attr Cam1 snapshots 1
attr Cam1 storage /opt/fhem/www/snapshots/cam1
</pre>

=== Pfad-Parameter für Foscam FI9831P ===
Die Version ist ohne basicauth und hat Nutzer und Passwort direkt in der URL. Kann natürlich geändert werden.
Sämtliche Befehle für die Foscam HD Kameras findet man [https://www.manualslib.com/manual/728928/Foscam-Ip-Camera.html hier]
<pre>
define IPKamera IPCAM <ip>:<port>
attr IPKamera cmd01 cmd=ptzStopRun&usr=xxx&pwd=xxx
attr IPKamera cmdPanLeft cmd=ptzMoveLeft&usr=xxx&pwd=xxx
attr IPKamera cmdPanRight cmd=ptzMoveRight&usr=xxx&pwd=xxx
attr IPKamera cmdPos01 cmd=ptzGotoPresetPoint&name=<Nameposition>&usr=xxx&pwd=xxx
attr IPKamera cmdTiltDown cmd=ptzMoveDown&usr=xxx&pwd=xxx
attr IPKamera cmdTiltUp cmd=ptzMoveUp&usr=xxx&pwd=xxx
attr IPKamera path cgi-bin/CGIProxy.fcgi?usr=xxx&pwd=xxx&cmd=snapPicture2
attr IPKamera pathCmd cgi-bin/CGIProxy.fcgi
attr IPKamera pathPanTilt cgi-bin/CGIProxy.fcgi?usr=xxx&pwd=xxx
attr IPKamera storage ./www/images/webcam
</pre>

=== Einstellungen für Foscam C2 und Foscam R2 ===
Eine ausführliche Beschreibung zur Benutzung der IP Kameras Foscam C2 und Foscam R2 findet sich in {{Link2Forum|Topic=84677|LinkText=diesem Forenthread}}.

=== Parameter für Xiaomi Dafang ===
Diese Parameter gelten bei installierter alternativer Firmware von [https://github.com/EliasKotlyar/Xiaomi-Dafang-Hacks hier]
<pre>

Attributes:
attr IPKamera cmdPanLeft cmd=motor_left
attr IPKamera cmdPanRight cmd=motor_right
attr IPKamera cmdTiltDown cmd=motor_down
attr IPKamera cmdTiltUp cmd=motor_up
attr IPKamera delay 10
attr IPKamera event-on-update-reading snapshots
attr IPKamera icon it_camera
attr IPKamera path cgi-bin/currentpic.cgi
attr IPKamera pathPanTilt cgi-bin/action.cgi?
attr IPKamera snapshots 5
attr IPKamera storage /opt/fhem/www/ipcamera/dafang_1/shot
</pre>

== Nicht unterstützte Netzwerkkameras ==
{{Randnotiz|RNTyp=y|RNText=Die hier aufgeführten Netzwerkkameras sind definitiv nicht unterstützt oder es gibt gravierende, hier beschriebene Einschränkungen.}}
;TRENDnet TV-IP320PI
:Aufruf der Funktion <code>get ''myCam'' image</code> führt zur Fehlermeldung ''...invalid Format''; auf Kamerabild oder Stream kann jedoch über die URL camHostnameOrIP/Streaming/channels/1/Picture (Bild) bzw. camHostnameOrIP/Streaming/channels/1/httpPreview (Stream) zugegriffen werden.

== Generierte Ereignisse ==
Das Modul ''IPCAM'' generiert die Ereignisse
* <code><nowiki>last: <name_of_device>_snapshot.<image_extension></nowiki></code>
* <code><nowiki>snapshots: <total_number_of_taken_snapshots_at_end></nowiki></code>

== Bekannte Probleme ==
Derzeit (08/2015) ist das Logging aus dem Modul zumindest lückenhaft und verbesserungsfähig. So sollten z.B. einige weitere Meldungen zur Fehlereingrenzung bei der Einrichtung eines IPCAM Objekts eingefügt werden:
* Ausgabe des kompletten Pfads / der URL, die bei der Erzeugung eines Snapshots aus einzelnen Bestandteilen zusammengesetzt wird
* Die Zuordnung von Meldungen zu ''verbose''-Leveln sollte kontrolliert und ggf. umgestellt werden
* siehe auch diesen {{Link2Forum|Topic=39932|LinkText=Forenthread}}, der Beschreibung von Problemen, eine Hikvision IPCam in Betrieb zu nehmen

Außerdem müsste das Modul dringend auf die aktuelle Form des Logging, [[verbose|verbose/Log3]], umgestellt werden.

Eine mögliche Lösung für das Problem "Wrong or not supported image format: unknown" habe ich hier beschrieben: {{Link2Forum|Topic=10772|Message=425265|LinkText=Forenbeitrag}}

== Links ==
* Forenthread zur {{Link2Forum|Topic=10772|LinkText=Erweiterung des IPCAM Moduls}}
* Forenthread zum Thema {{Link2Forum|Topic=21005|LinkText=Bewegungserkennung}}
* Forenthread zum Thema {{Link2Forum|Topic=30723|LinkText=Bewegungsmelder der Kamera "anzapfen"}}
* Webseite des Modulautors zum Thema [http://www.fischer-net.de/hausautomation/videoueberwachung.html Videoüberwachung]

Intertechno Code Berechnung

2016-10-11T19:32:27Z

Loungelizard: Neue Passage für OBI-Zwischenstecker eingeführt

'''Intertechno''' Systemkomponenten sind kostengünstige und weit verbreitete Funkschalter/-dimmer im 433 MHz Bereich, die man in fast jedem Baumarkt unter den Markennamen Intertechno, düwi, KlikAanKlikUit usw. erhalten kann.

Es gibt eine Anzahl weiterer Hersteller/Handelsmarken mit ähnlicher Kodierung oder Einstellmöglichkeiten mit DIP Schaltern, die ebenfalls mit dem Intertechno Code geschaltet werden können. Dazu zählen von Usern bereits erfolgreich getestete Geräte von Elro AB440, FLS-100/m-e, Wetekom/Westfalia und weitere, theoretisch mögliche aber ungetestete Systeme wie Unitec oder Arctech Steckdosen (siehe [http://avr.börke.de/E-Funk.htm Börkes-HP])

== Voraussetzungen in Fhem ==
Schalten kann man die Intertechno Funkkomponenten in Fhem über verschiedene Wege. So z.B. über CUL/CUNO, Tellstick, [[AVR-NET-IO]].

Hier beschrieben ist die Ansteuerung über CUL/CUNO, dessen Firmware für Intertechno erweitert wurde (Danke an Olaf Droegehorn). Momentan ist in CUL/CUNO das SENDEN von Intertechno Funk implementiert. Die Firmware muss mindestens den Stand 1.44 haben (Kontrolle der Version in den Fhem Detaildaten zum [[CUL]]/[[CUNO]]). Die CUL433/CUNO433 haben dabei volle Reichweite, die Versionen CUL868/CUNO868 funktionieren ebenfalls, haben aufgrund der nicht optimalen Antennenlänge und falschen Abstimmung für den Frequenzbereich aber nur eine eingeschränke Reichweite.

=== Definition ===
Die Definition des IT Gerätes in FHEM sieht für '''alte Geräte''' so aus:
<source lang=text>
define myITSwitch IT <housecode><group_switch> <on-code> <off-code> [<dimup-code> <dimdown-code>]
attr myITSwitch IODev CUL_x (CUNO_x)
attr myITSwitch model itswitch
</source>
Die weitere Anleitung soll die Bildung der Bitfolge für die Zusammensetzung des Schaltcodes erklären.
Wichtig zu wissen ist auch, dass es sich um einen 3state code handelt, d.h. jedes Bit kann '''0,1 oder F''' sein!

Die selbst '''lernenden''' neue '''Geräte''' definiert man in FHEM so:
<source lang=text>
define <name> IT <26-Bit Adresse> <1-Bit Gruppen Bit> <4-Bit Gerät>
</source>
Dabei kann man die 26-Bit Adresse frei wählen, so dass Kollisionen mit Nachbarn sehr unwahrscheinlich werden.
Einen GRR-3500 der über einen CUL gesteuert werden soll definiert man z.B. so
<source lang=text>
define sw_it_outdoor IT 01010101010101010101010101 0 0000
attr myITSwitch IODev CUL_0
attr myITSwitch model itswitch
</source>
Danach die {{Taste|CODE}}-Taste am Funkschalter betätigen (die LED blinkt) und über FHEM den Einschaltcode senden.

== Original Intertechno System ==

Durch Kombination von Hauscode und Geräetecode können maximal 256 Geräte verwendet werden. Dannn würde allerdings alle Hauscodes belegt, was eventuell zu Störungen mit Nachbarinstallationen führen könnte.

=== Hauscode (die ersten vier Stellen (0-3) ===
Der Hauscode wird auf dem Drehschalter auf der Rückseite eingestellt und hat die Bezeichnung '''A-P'''

[[File:Img_3324_small.png|thumb|Intertechno Schalter]]
{| class="wikitable"
! Drehschalter !! Stelle 0-3
|-
| A || 0000
|-
| B || F000
|-
| C || 0F00
|-
| D || FF00
|-
| E || 00F0
|-
| F || F0F0
|-
| G || 0FF0
|-
| H || FFF0
|-
| I || 000F
|-
| J || F00F
|-
| K || 0F0F
|-
| L || FF0F
|-
| M || 00FF
|-
| N || F0FF
|-
| O || 0FFF
|-
| P || FFFF
|}

=== Gruppen-/Gerätecode (Stelle 4-7) ===
Der zweite Drehschalter ist mit den Zahlen von 1-16 beschriftet. Das ist eine Zusammensetzung von Gruppe und Gerätecode und ergibt die nächsten 4 Stellen. Die dritte Spalte in der Tabelle zeigt die Zuordnung einer Intertechno YCT-100 / ITS-150 Fernbedienung. Diese ist mit Drehschalter auf der Rückseite (A-P), einem Gruppenschalter (1-4) , und je vier ein-/aus-Tasten belegt.

[[File:Img_3325_small.png|right|thumb|Intertechno Fernbedienung]]

{| class="wikitable"
! Drehschalter !! Stelle 4-7 !! Fernbedienung Gruppe/Taste
|-
| 01 || 0000 || 1 - 1
|-
| 02 || F000 || 1 - 2
|-
| 03 || 0F00 || 1 - 3
|-
| 04 || FF00 || 1 - 4
|-
| 05 || 00F0 || 2 - 1
|-
| 06 || F0F0 || 2 - 2
|-
| 07 || 0FF0 || 2 - 3
|-
| 08 || FFF0 || 2 - 4
|-
| 09 || 000F || 3 - 1
|-
| 10 || F00F || 3 - 2
|-
| 11 || 0F0F || 3 - 3
|-
| 12 || FF0F || 3 - 4
|-
| 13 || 00FF || 4 - 1
|-
| 14 || F0FF || 4 - 2
|-
| 15 || 0FFF || 4 - 3
|-
| 16 || FFFF || 4 - 4
|}

=== Stellen 8-9 (Festwert 0F) ===
<nowiki>Die Positionen 8-9 sind immer fest auf '''0F'''zu stellen</nowiki>

=== Stellen 10-11 (Ein/Aus) ===
Bei den beiden letzten Stellen steht als Codierung für ON = FF und OFF = F0.

=== Beispiele ===
Drehschalter/Hauscode auf '''A'''
<nowiki> Schalter 1 -> 000000000F FF F0 (entspricht Fernbedienung Gruppe I und Schalter 1)
Schalter 2 -> 0000F0000F FF F0 (entspricht Fernbedienung Gruppe I und Schalter 2)
Schalter 3 -> 00000F000F FF F0 (entspricht Fernbedienung Gruppe I und Schalter 3)
Schalter 4 -> 0000FF000F FF F0 (entspricht Fernbedienung Gruppe I und Schalter 4)</nowiki>

Drehschalter/Hauscode auf '''L'''
<nowiki> Schalter 11 -> FF0F0F0F0F FF F0 (entspricht Fernbedienung Gruppe III und Schalter 3)
Schalter 16 -> FF0FFFFF0F FF F0 (entspricht Fernbedienung Gruppe IV und Schalter 4)</nowiki>
komplett für die fhem cfg also z.B. Hauscode A und Gruppe 1 Gerät/Schalter 1 und CUL Bezeichnung CUL1:

<nowiki> define schalter1 IT 000000000F FF F0
attr schalter1 IODev CUL1
attr schalter1 model itswitch</nowiki>

=== Selbstlernende Intertechno Funksteckdosen (z.B. ITR-1500) ===
Die selbst lernenden Intertechno Funksteckdosen haben ein neues erweitertes Protokoll bei dem ein 32-Bit Wort gesendet wird. Sie sind aber weiterhin kompatibel zum bisherigen 12-Bit Protokoll. In der culfw wird das alte Protokoll mit "Intertechno V1" und das neue mit "Intertechno V3" bezeichnet.

==== Mit altem Protokoll anlernen ====
{{Randnotiz|RNTyp=Fehl|RNText=Schon aus Gründen der Störsicherheit ist davon abzuraten bei neuen selbst lernenden Intertechno Geräten den alten 12-Bit Code zu verwenden. Dieser wird nur unterstützt um rückwärts kompatibel zu sein.}}
Zum Anlernen der selbst lernenden Funksteckdosen muss ein gültiger(!) ON-Befehl in den ersten fünf Sekunden nach dem Einstecken der Funksteckdose in eine normalen Steckdose gesendet werden. Die Funksteckdosen haben drei Speicherplätze, so dass man beispielsweise ein ITR-1500 Set zuerst mit der Fernbedienung anlernen und anschließend eigene Codes von Fhem senden lassen kann. Damit man einen gültigen Code sendet, sucht man sich einfach eine beliebige Kombination aus der obigen Tabelle aus (z.B. C-1, C-2 und C-3) und ergänzt entsprechend um die immer identischen Stellen 8 und 9 (0F) und den ON- und OFF-Code (FF/F0).
Das Senden der Codes von Fhem erfolgt am einfachsten, indem man sich die Steckdosen vorher in der Konfiguration so anlegt, wie man sie haben möchte und anschließend über die Weboberfläche den ON-Befehl gibt.

Mitunter funktioniert das reine Senden des ON Befehls aber nicht, da einige dieser Steckdosen einen längeren ON Befehl benötigen und die Sendedauer bei Fhem/CUL/CUNO nicht beeinflusst werden kann. In diesem Fall nimmt man eine YCT-100 oder ITS-150 Fernbedienung, an der die gewünschte Adresse eingestellt werden kann. Zum Anlernen drückt man nun etwas länger auf den passenden Einschaltknopf, danach kann die Dose von Fhem normal geschaltet werden.

==== Angelernten Code löschen ====
Hier gibt es zwei Möglichkeiten.
# Man sendet wie beim Anlernen innerhalb der ersten 5 Sekunden einen OFF-Befehl. Die Funksteckdosen quittiert diesen mit zweimaligem einschalten. Anschließend reagiert sie auf diesen Code nicht mehr.
# Manche neueren Intertechno Geräte (z.B. GRR-3500) haben eine {{Taste|CODE}}-Taste. Durch kurzes drücken wird die Funksteckdose für 5 Sekunden in den Betrieb zum Anlernen gesetzt. Hält man diese Taste bis die LED hektisch blinkt, lässt sie dann los und drückt sie noch einmal kurz, so wird der gesammte Speicher für angelernte Codes gelöscht. Die Funksteckdose quittiert das wie üblich durch zweimaliges Einschalten.

==== Mit neuem Protokoll anlernen ====
Die neuen Funksteckdosen können laut Werbung ''"67 Millionen verschiedene Codes"'', das sind 26-Bits (2^26 = 67108864). Da hat die Werbung tatsächlich mal untertrieben. Tatsächlich arbeitet das neue Protokoll mit einem 32-Bit Wort. Jede neue Fernbedienung (z.B. ITT-1500) bekommt ab Werk einen fest einprogrammierten (und hoffentlich weltweit eindeutigen) ID-Code aus 26 Bits. Daran hängt sie ein 2-Bit Kommando und eine 4-Bit Geräte bzw. Tastenpaar Nummer:
{| class="wikitable" style="border-style:solid; border-width:4px"
|-
|style="border-style:solid; border-width:4px"| 26-Bit ID des steuernden Geräts (Fernbedienung)
|style="border-style:solid; border-width:4px"| 2-Bit Kommando
|style="border-style:solid; border-width:4px"| 4-Bit Kanal-ID (Tastenpaar)
|-
|}
Das 2-Bit Kommando ist ein ON oder OFF Befehl an ein einzelnes Gerät oder eine Gruppe.
{| class="wikitable"
|-
! Befehl !! Bedeutung
|-
| 0 0 || Ein Gerät einschalten
|-
| 0 1 || Ein Gerät ausschalten
|-
| 1 0 || Alle Geräte (dieser Gruppe) einschalten
|-
| 1 1 || Alle Geräte (dieser Gruppe) ausschalten
|-
|}
Die ITT-1500 hat zwar eine {{Taste|ALL OFF}}-Taste aber keine {{Taste|ALL ON}}.
Ob das Einschalten als Gruppe generell unterstützt wird ist nicht bekannt.
Einen gültiger Einschaltbefehl kann man am [[CUL]] z.B. mit diesem Kommando senden:
<source lang=text>
is01010010101011101000000110010011
</source>
Im Gegensatz zum alten Protokoll (Intertechno V1) wird das Binärwort hier nicht mit 0 und '''F''' sondern 0 und '''1''' gesendet.
{| class="wikitable" style="border-style:solid; border-width:4px"
|-
|style="border-style:solid; border-width:4px"| '''is''' ''(Sende Intertechno Kommando)''
|style="border-style:solid; border-width:4px"| '''01010010101011101000000110''' ''(Gerätecode Fernbedienung)''
|style="border-style:solid; border-width:4px"| '''01''' ''(Kommando ON)''
|style="border-style:solid; border-width:4px"| '''0011''' ''(Tastenpaar 4)''
|-
|}
Die culfw unterscheidet anhand der Kommandolänge ob es sich um einen alten (12 Zeichen) oder neuen (32 Zeichen) Intertechno Befehl handelt.
Genauso unterscheidet das IT-Modul in FHEM die beiden Formate:
define <name> IT <10-bit-housecode> <off-code> <on-code> [<dimup-code>] [<dimdown-code>]
und
define <name> IT <26 bit Address> <1 bit group bit> <4 bit unit>
und setzt das Reading <code>protocol</code> auf <code>V3</code>.

== FLS 100 ==
[[File:FLS100.jpg|right|thumb|FLS100 - konfiguriert auf IV/3]]

Beim FLS 100 von m-e.de gibt es nur 4 mögliche Einstellungen: '''I, II, III und IV'''. Dies entspricht der Gruppe auf der Fernbedienung.

{| class="wikitable"
! Drehschalter !! Stelle 0-3
|-
| I || 0FFF
|-
| II || F0FF
|-
| III || FF0F
|-
| IV || FFF0
|}

Die nächsten vier Stellen geben die Geräte ID an; diese ist identisch mit der Taste an der Fernbedienung.
{| class="wikitable"
! Drehschalter !! Stelle 4-7 !! Fernbedienung Taste
|-
| 1 || 0FFF || 1
|-
| 2 || F0FF || 2
|-
| 3 || FF0F || 3
|-
| 4 || FFF0 || 4
|}

Beim FLS 100 ist nur die letzte Stelle relevant, mit ON: F oder OFF: 0

== REV Telecontrol ==
[[File:Rev-funksteckdose-telecontrol-3500-w-008345.png|right|thumb|REV Telecontrol]]

Die REV Telecontrol haben einen Dreh-Wahlschalter auf der Rückseite, mit dem sich der Hauscode (A - D) und der Gerätecode (1 - 3) bestimmen lässt.

Die Codierung ist dabei:
{| class="wikitable"
! Hauscode !! Stelle 1-4
|-
| A || 1FFF
|-
| B || F1FF
|-
| C || FF1F
|-
| D || FFF1
|}

{| class="wikitable"
! Gerätecode !! Stelle 5-7
|-
| 1 || 1FF
|-
| 2 || F1F
|-
| 3 || FF1
|}

Dazu (Stelle 8+9+10) noch drei statische Werte: 0FF.

Der Code für '''An''' ist FF, für '''Aus''' 00.

Beispiel:
:<code>define My_Switch IT 1FFF1FF0FF FF 00 für A1</code>
Erfolgreich getestet mit CULfw V 1.49 CUL868.

== Elro AB440 ==
=== Möglichkeit 1: zu Intertechno-Codes umdippen ===
[[File:ELRO-AB440_Funkschalter.jpg|right|thumb|Élro AB440 Funkschalter]]

Günstige ELRO Funkschalter/Dimmer der Serie 440 lassen sich auch problemlos auf Intertechno Codierung "umdippen" und damit voll kompatibel mit allen möglichen A-P / 1-16 Intertechno Schaltcodes von Fhem aus nutzen. Dazu müssen die Dipschalter-Stellungen entsprechend Intertechno umgerechnet und gesetzt werden (1=ON, 0=OFF).

Beispiele:
{| class="wikitable"
! Intertechno !! Elro Hauscode<br>1234 !! Elro Gerätecode<br>5ABCDE
|-
| A1 || 1111 || 111110
|-
| A2 || 1111 || 011110
|-
| A3 || 1111 || 101110
|-
| A4 || 1111 || 001110
|-
| A5 || 1111 || 110110
|-
| A6 || 1111 || 010110
|-
| A7 || 1111 || 100110
|-
| A8 || 1111 || 000110
|-
| A9 || 1111 || 111010
|-
| A10 || 1111 || 011010
|-
| A16 || 1111 || 000010
|-
| C1 || 1011 || 111110
|-
| C2 || 1011 || 011110
|}

Weitere Erklärungen sind z.B. im [http://isn-systems.com/tools/it2elro Tool] der Fa. ISN-systems online berechnen lassen.

Einziger Nachteil: Die originale Elro Fernbedienung funktioniert dann nicht mehr uneingeschränkt mit den Funkschaltern (eine Intertechno Fernbedienung funktioniert uneingeschränkt). Wenn man den Hauscode an der Fernbedienung einstellt, kann man durch drücken von z.T. mehreren Tasten gleichzeitig auch Intertechno schalten. Das ist aber nur was für den Notfall oder für Handakrobaten.

<nowiki>15/16 -> D
13/14 -> A+D
11/12 -> B+D
09/10 -> A+B+D
07/08 -> C+D
05/06 -> A+C+D
03/04 -> B+C+D
01/02 -> A+B+C+D</nowiki>

=== Möglichkeit 2: aus der vorhanden DIP-Schalterstellung den entsprechenden 10-digit InterTechno Code bestimmen ===
Das ist prinzipiell ganz einfach. Hat man folgende DIP-Schalter-Stellung so muss man von links nach rechts einfach für jeden DIP gleich "ON" eine "0" und für "OFF" ein "F" definieren. Für die dargestellte DIP-Einstellung ergibt sich der damit der darunterstehende InterTechno Code:

[[File:ELRO_0100101111.png]]

<code>0F00F0FFFF</code>

Analog dazu ergeben sich für den gleichen Hauscode (Schalter 1-5) folgende Codes für die Funksteckdosen B bis E, wobei die Dose E mit der Originalfernbedienung nicht adressierbar ist, sich mit FHEM aber wunderbar schalten lässt.

[[File:ELRO_0100110111.png]]

<code>0F00FF0FFF</code>

[[File:ELRO_0100111011.png]]

<code>0F00FFF0FF</code>

[[File:ELRO_0100111101.png]]

<code>0F00FFFF0F</code>

[[File:ELRO_0100111110.png]]

<code>0F00FFFFF0</code>

Dazu noch die Codes für AN = FF und AUS = F0 schaut eine vollständige Definition eines ELRO440 Funkschalters dann bsw. so aus:

<nowiki> define ELRO_10110_A IT 0F00F0FFFF FF F0
attr ELRO_10110_A IODev CUL_0
attr ELRO_10110_A alias Stehlampe
attr ELRO_10110_A fp_Grundriss 340,50,1,Stehlampe
attr ELRO_10110_A group Schalter
attr ELRO_10110_A model itswitch
attr ELRO_10110_A room Wohnzimmer</nowiki>

[[File:b1-Funksteckdose-von-Toom.jpg|right|thumb|b1 Funksteckdose von Toom]]
== b1 / Toom ==
Das "Funksteckdosen-Set" der Marke b1 aus dem Toom-Baumarkt (3 Funksteckdosen + 1 Fernbedienung mit 4x ein/aus) funktioniert exakt wie ELRO, auch die DIP-Schalter sind genauso belegt.

== Wetekom/Westfalia ==
[[File:Westfalia-Funksteckdose.jpg|right|thumb|Westfalia Funksteckdose ZTC-S316A.]]
Der eingestellte Hauscode ist F00F0FFF0F.

In den Westfalia-Baumärkten gibt es Funksteckdosen mit Westfalia-Branding. Auf der Bedienungsanleitung steht aber Wetekom.

Die Funksteckdosen selbst haben zehn DIP-Switches: 1234FEDCBA, während die Fernbedienung nur sechs hat: ABCDEF. Damit die Fernbedienung mit den Funksteckdosen funktioniert, darf man nur einen der DIP-Switches 1234 pro Funksteckdose auf ON schalten.

Die Schaltung der DIP-Switches ABCDEF4321 entspricht direkt und in dieser Reihenfolge (also andersrum als direkt an der Funksteckdose) dem Hauscode und zwar entspricht ein Switch auf OFF einem F im Hauscode und ein Switch auf ON einer 0 im Hauscode.

Die Steckdosen werden dann mit 01 ein- und mit 10 ausgeschaltet.

Beispiel:
define wf_steckdose IT F00F0FFF0F 01 10

== Pollin Funksteckdosen ==

Vom Aussehen sind die Steckdosen von Pollin (z.B. 3fach Set 550666) mit den Westfalia ZTC identisch, aber:

* die DIP Schalter sind beschriftet von 0 bis 10;
* der Adresscode entspricht dem invertierten ELRO 440 Code ->also (0=ON, 1=OFF)
* der Code für "An" ist 0F, für "Aus" F0

Beispiel für Adresse C2:

define IT_C2 IT 0F00F0000F 0F F0

== me micro-electric AS 73 ==

[[Datei:Me_AS_73.JPG|right|thumb|micro-electric Funksteckdose AS 73]]

Die micro-electric Funksteckdosen haben 10 DIP-Schalter: 123456ABCD.

Der Hauscode wird an Sender und Steckdose mit 1-6 eingestellt, der Empfängercode A-D entspricht den Kanälen auf dem Handsender.

DIP-Schalterstellung OFF entspricht F und ON entspricht 0.

Die Steckdosen werden mit F0 ein- und mit 0F ausgeschaltet.

Empfängercodes:
{| class="wikitable"
! Kanal !! Position 7-10
|-
| A || 0FFF
|-
| B || F0FF
|-
| C || FFF0 (Achtung: bei C und D sind die Codes vertauscht)
|-
| D || FF0F
|}

Beispiel:
:<code>define Schalter_ME_A IT 0F0F000FFF F0 0F</code>
:<code>attr Schalter_ME_A IODev CUL1</code>
:<code>attr Schalter_ME_A model itswitch</code>

== Conrad / McPower Funkschaltset 3+1 ==
Dieses Funkschaltset wird unter mehreren Namen in verschiedenen Bau- und Heimwerkermärkten sowie bei Conrad (Best Nr. 640475 - 62) vertrieben. Teilweise auch mit unterschiedlichen Schaltleistungen.
Die Konfiguration funktioniert genauso wie beim [http://www.fhemwiki.de/wiki/Intertechno_Code_Berechnung#FLS_100 FLS100]

== CMI / OBI / LUX IP44-Funkschaltset 2+1 ==
[[File:RCS_14G_Funksteckdose_Obi_klein.png|right|thumb|Rückansicht der OBI / Lux Funksteckdose]]
Dieses Set wird u.a. bei OBI verkauft, als Hersteller wird die Emil Lux GmbH angegeben. Typennummer RCS-14G, Artikel Nummer 308555
Die Steckdosen sind IP44 geschützt und damit auch für den Außeneinsatz geeignet.
Die Steckdosen verfügen lediglich über einen Kanal-Schalter von 1-4. Diese Kanal-Nummeren korrespondieren mit der folgenden Übersetzung:

{| class="wikitable"
! Kanal !! Code (Stelle 1-10)
|-
| 1 || 000FF0F0FF
|-
| 2 || 000FFF00FF
|-
| 3 || 000F0FF0FF
|-
| 4 || 0000FFF0FF
|}

Die Steckdosen werden dann mit FF ein- und mit F0 ausgeschaltet.

Beispiel:
:<code>define Schalter_OBI_Code_1 IT 000FF0F0FF FF F0</code>
:<code>attr Schalter_OBI_Code_1 IODev CUL1</code>
:<code>attr Schalter_OBI_Code_1 model itswitch</code>

== Noch nicht aufgeführte Geräte ==
Wer ein Intertechno-ähnliches Gerät besitzt, das in dieser Liste noch nicht aufgeführt ist, muss die Kodierung selbst bestimmen. Dazu gibt es verschiedene Möglichkeiten, die in diesem Abschnitt aufgeführt werden. Die Ergebnisse bitte hier eintragen, um Nachfolgern die Arbeit zu ersparen!

=== Audio-Eingang zur Messung ===
Hier wird die Fernbedienung oder der Empfänger mit einer entsprechenden Schaltung an den Mikrofon-Eingang eines Rechners angeschlossen und mit einem Audio-Programm werden die Signalverläufe aufgenommen. Diese Methode wird [http://avr.börke.de/E-Funk.htm hier] näher erläutert.

=== Platine analysieren ===
[[File:Westfalia-Funkfernbedienung-hinten.jpg|right|thumb|Platine der Westfalia Funkfernbedienung ZTC-TC von hinten.]]
[[File:Westfalia-Funkfernbedienung-vorne.jpg|right|thumb|Platine der Westfalia Funkfernbedienung ZTC-TC von vorne.]]

Platine der Fernbedienung oder des Empfängers betrachten und so die Beschaltung des Decoder/Encoder Chips ermitteln. Bei der Wetekom-Fernbedienung wird beispielsweise der Chip LP801b verwendet, der funktional identisch zum PT2262 ist. Im [http://www.escol.com.my/Datasheets_specs/pt2262_1.pdf Datenblatt des PT2262] kann man dann die Beschaltung nachsehen. Nun betrachtet man den Verlauf der Leiterbahnen auf der Platine, um die Beschaltung des Chips zu ermitteln. So kann man beispielsweise bei der Wetekom-Fernbedienung sehen, dass die DIP-Switches A bis F auf die Eingänge A0 bis A5 geschaltet sind. Außerdem sieht man, mit welchen Eingängen die einzelnen Taster verbunden sind.

Nun kann man messen, zwischen welchen Chip-Eingängen und Batteriepolen eine Spannung anliegt, bzw. (ohne Batterie) zwischen welchen Chip-Eingängen und Batteriepolen es einen Durchgang gibt, um zu ermitteln, wie die DIP-Switches schalten. Im Fall der Wetekom-Fernbedienung liegt keine Spannung zwischen den Eingängen und den beiden Batteriepolen an, wenn die DIP-Switches auf OFF stehen: Der Eingang liegt also auf F (Float). Wenn die DIP-Switches auf ON stehen, liegt nur eine Spannung zwischen dem Pluspol der Batterie und dem Eingang an, es gibt also einen Durchgang zwischen dem Minuspol und dem Eingang, so dass der Eingang auf V_SS liegt und damit 0 eingestellt ist.

Bei den Eingängen D0 und D1 sieht man, dass der Batterie-Pluspol immer über einen Widerstand mit dem Dateneingang verbunden ist, also normalerweise 1 anliegt. Ist aber ein Ein-Taster gedrückt, wird der Eingang D1 direkt mit dem Minuspol der Batterie verbunden, bei den Aus-Tastern der Eingang D0 (die Verbindung der Aus-Taster ist auf den Bildern nicht besonders gut zu erkennen). Durch diese Verbindung wird der Eingang auf V_SS heruntergezogen und damit ist 0 eingestellt.

=== Mit [[CUL]] im Debug-Modus Rohsignale empfangen und analysieren ===
* Wurde im {{Link2Forum|Topic=5599|LinkText=Forum}} diskutiert.
Ein 433MHz CUL kann mit dem Befehl <code>X67</code> Intertechno Kommandos mitlesen.
Allerdings funktioniert das bei der "üblichen" Firmware nur lückenhaft.
Dazu wurde bereits eine spezielle Variante der culfw entwickelt (siehe {{Link2Forum|Topic=24436|Message=105|LinkText=Forum}}).
Die Ausgaben sind aber dann als doppelt so langes Binärwort im Hex-Format.
Man muss quasi jedes zweite Bit streichen, da die einzelnen Bits als steigende bzw. fallende Flanken übertragen werden.
Man kann aber damit auch einer neuen ITT-1500 ihre Kommandos und vor allem ihre 26-Bit ID entlocken.

==== Mit CUL868 433MHz mitlesen ====
Man kann auch mit der 868MHz Version des CUL Fernbedienungen von Intertechno mitlesen.
Dazu die gewünschte Trägerfrequenz 433.92MHz * 2^16 / 26MHz = 1093745 = 0x10B071 als 24-Bit Teiler in die Register <code>FREQ[2-0]</code> schreiben und einen Reset ausführen.
W0F10
W10B0
W1171
B
Danach kann man mit <code>X67</code> auf der Frequenz mitlesen. Mit <code>e</code> kann der EEPROM wieder auf den Default 0x21656A, 868.30MHz gestellt werden.

[[Kategorie:Intertechno]]
[[Kategorie:HOWTOS]]

Datei:RCS 14G Funksteckdose Obi klein.png

2016-10-11T19:12:44Z

Loungelizard: Rückansicht Funksteckdose Obi / Lux / RCS-14G

Rückansicht Funksteckdose Obi / Lux / RCS-14G