mirror of
https://github.com/fhem/fhem-mirror.git
synced 2025-04-20 01:06:04 +00:00
add HMLAN german commandref
git-svn-id: https://svn.fhem.de/fhem/trunk@5449 2b470e98-0d58-463d-a4d8-8e2adae1ed80
This commit is contained in:
martinp876
parent
b3926017df
commit
56a5928908
@ -1090,4 +1090,154 @@ sub HMLAN_getVerbLvl ($$$$){#get verboseLevel for message
|
||||
</ul>
|
||||
|
||||
=end html
|
||||
=begin html_DE
|
||||
<a name="HMLAN"></a>
|
||||
<h3>HMLAN</h3>
|
||||
<ul>
|
||||
Das HMLAN ist das fhem-Modul für den eQ-3 HomeMatic LAN Configurator welcher als IO
|
||||
in FHEM fungiert. Siehe <a href="http://www.fhemwiki.de/wiki/HM-CFG-LAN_LAN_Konfigurations-Adapter">HM-CFG-LAN_LAN_Konfigurations-Adapter</a> zur Konfiguration.<br>
|
||||
Eine weitere Beschreibung, wie der HomeMatic USB Konfigurations-Adapter
|
||||
<a href="https://git.zerfleddert.de/cgi-bin/gitweb.cgi/hmcfgusb">(HM-CFG-USB)</a>
|
||||
verwendet werden kann, ist unter dem angegebenen Link zu finden.<br/>
|
||||
<br>
|
||||
Dieses Gerät kann gleichzeitig mit einer CCU und (nur lesend) mit FHEM verwendet werden.
|
||||
Hierfür ist wie folgt vorzugehen:
|
||||
<ul>
|
||||
<li>Starten des fhem/contrib/tcptee.pl Programms</li>
|
||||
<li>Umleiten der CCU zum local host</li>
|
||||
<li>Ausschalten der LAN-Encryption auf der CCU für den LAN-Configurator</li>
|
||||
<li>Setzen des dummy Attributes für das HMLAN Gerät in FHEM</li>
|
||||
</ul>
|
||||
<br><br>
|
||||
|
||||
<a name="HMLANdefine"><b>Define</b></a>
|
||||
<ul>
|
||||
<code>define <name> HMLAN <ip-address>[:port]</code><br>
|
||||
<br>
|
||||
Der Standard-Port lautet: 1000.<br/>
|
||||
Wenn keine IP-Adresse angegeben wird, wird auch kein Gerät geöffnet; man kann
|
||||
also auch ohne angeschlossene Hardware experimentieren.
|
||||
</ul>
|
||||
<br><br>
|
||||
|
||||
<a name="HMLANset"><b>Set</b></a>
|
||||
<ul>
|
||||
<li><a href="#hmPairForSec">hmPairForSec</a></li>
|
||||
<li><a href="#hmPairSerial">hmPairSerial</a></li>
|
||||
</ul>
|
||||
<br><br>
|
||||
|
||||
<a name="HMLANget"><b>Get</b></a>
|
||||
<ul>
|
||||
N/A
|
||||
</ul>
|
||||
<br><br>
|
||||
|
||||
<a name="HMLANattr"><b>Attributes</b></a>
|
||||
<ul>
|
||||
<li><a href="#do_not_notify">do_not_notify</a></li><br>
|
||||
<li><a href="#attrdummy">dummy</a></li><br>
|
||||
<li><a href="#addvaltrigger">addvaltrigger</a></li><br>
|
||||
<li><a href="#HMLANlogIDs">logIDs</a><br>
|
||||
Schaltet selektives Aufzeichnen der HMLAN Meldungen ein. Eine Liste der
|
||||
HMIds oder Namen, die aufgezeichnet werden sollen, können - getrennt durch
|
||||
Kommata - eingegeben werden.<br>
|
||||
Die Attribute erlauben ausschließlich die Angabe von Device-IDs und keine Kanal-IDs.
|
||||
Die Kanal-IDs werden automatisch in Device-IDs umgewandelt.<br>
|
||||
<b>all</b> zeichnet die Original-Meldungen für alle HMIds auf.<br>
|
||||
<b>sys</b> zeichnet alle systemrelevanten Meldungen wie keep-alive auf.<br>
|
||||
<b>all,sys</b> damit wird die Aufzeichnung aller Meldungen eingeschaltet<br>
|
||||
</li>
|
||||
<li><a name="HMLANhmMsgLowLimit">hmMsgLowLimit</a><br>
|
||||
maximale Anzahl der Meldungen, die HMLAN für weniger wichtige Meldungen zur
|
||||
Ausführung zulässt. Bei darüber hinaus gehenden Meldungen wird die Verarbeitung aufgeschoben. <br>
|
||||
HMLAM erlaubt eine maximale Anzahl von Meldungen pro Stunde. Wird diese überschritten,
|
||||
wird die Aussendung der Meldungen blockiert. Nach ungefähr 90% der maximalen Anzahl
|
||||
wird die Liste der weniger wichtigen Meldungen (momentan nur CUL_HM autoReadReg)
|
||||
solange verzögert abgearbeitet, bis die Rahmenbedingungen eine weitere Verarbeitung
|
||||
wieder zulassen. <br>
|
||||
hmMsgLowLimit ermöglicht eine weitere Reduzierung dieses Grenzwertes.<br>
|
||||
Hinweis: Der HMLAN berechnet die maximale Anzahl der auszusendenden Meldungen
|
||||
auf Basis einiger Annahmen und ist deshalb mit einer Toleranz behaftet.<br>
|
||||
</li><br>
|
||||
<li><a href="#hmId">hmId</a></li><br>
|
||||
<li><a name="HMLANhmKey">hmKey</a></li><br>
|
||||
<li><a name="HMLANhmKey2">hmKey2</a></li><br>
|
||||
<li><a name="HMLANhmKey3">hmKey3</a></li><br>
|
||||
<li><a name="HMLANhmKey4">hmKey4</a></li><br>
|
||||
<li><a name="HMLANhmKey5">hmKey5</a><br>
|
||||
AES Schlüssel für den HMLAN Adapter. <br>
|
||||
Der Schlüssel wird in eine hash-Zeichenfolge umgewandelt. Wenn eine Hash-Folge unmittelbar
|
||||
eingegeben wird, erfolgt keine Umwandlung, sondern eine eine direkte Benutzung der Hash-Folge.
|
||||
Deshalb kann der Originalschlüssel auch nicht entschlüsselt werden.<br>
|
||||
</li>
|
||||
<li><a href="#hmProtocolEvents">hmProtocolEvents</a></li><br>
|
||||
<li><a name="HMLANrespTime">respTime</a><br>
|
||||
Definiert die maximale Antwortzeit des HMLAN-Adapters in Sekunden. Standardwert ist 1 Sekunde.<br/>
|
||||
Längere Zeiten können übergangsweise in langsamen und instabilen Systemen oder in
|
||||
LAN-Konfigurationen verwendet werden.</li>
|
||||
<li><a name="HMLAN#wdTimer">wdTimer</a><br>
|
||||
Zeit in Sekunden, um den HMLAN zu triggern. Werte zwischen 5 und 25 sind zulässig.
|
||||
Standardwert ist 25 Sekunden.<br>
|
||||
Es wird <B>davon abgeraten</B> diesen Timer zu verändern. Wenn Probleme mit
|
||||
HMLAN-Abbrüchen bestehen wird empfohlen die Ursache des Problems zu finden
|
||||
und zu beheben und nicht die Symptom.</li>
|
||||
<li><a name="HMLANhmLanQlen">hmLanQlen</a><br>
|
||||
Definiert die Länge der Warteschlange des HMLAN Interfaces. Es ist deshalb die Anzahl
|
||||
der gleichzeitig zu sendenden Meldungen. Erhöhung des Wertes kann eine Steigerung der
|
||||
Übertragungsgeschwindigkeit verursachen, ebenso können wiederholte Aussendungen
|
||||
Datenverlust bewirken.<br>
|
||||
Die Auswirkungen werden durch die Ereignisse im Protokoll sichtbar.<br>
|
||||
1 - ist ein Wert auf der sicheren Seite und deshalb der Standardwert<br>
|
||||
5 - ist eine kritische Länge und verursacht wahrscheinlich Meldungsverluste</li>
|
||||
</ul>
|
||||
<a name="HMLANparameter"><b>parameter</b></a>
|
||||
<ul>
|
||||
<li><B>assignedIDs</B><br>
|
||||
HMIds, die einem HMLAM zugeordnet sind und verarbeitet werden. Z.B. ACK werden intern generiert.</li>
|
||||
<li><B>assignedIDsCnt</B><br>
|
||||
Anzahl der IDs, die von FHEM einem HMLAN zugeordnet sind</li>
|
||||
<li><B>assignedIDsReport</B><br>
|
||||
Anzahl der HMIDs, die vom HMLAN als zugeordnet gemeldet werden.
|
||||
Diese Anzahl sollte mit assignedIDsCnt identisch sein.</li>
|
||||
<li><B>msgKeepAlive</B><br>
|
||||
Güte der keep-alive Meldungen. <br>
|
||||
<B>dlyMax</B>: maximale Verzögerungsdauer zwischen dem geplanten Meldungszeitpunkt
|
||||
und der tatsächlich gesendeten Meldung.<br>
|
||||
<B>bufferMin</B>: minimal verfügbarer Speicher bevor HMLAN voraussichtlich
|
||||
unterbrochen wird bedingt durch die fehlende keepAlive Meldung. bufferMin
|
||||
wird auf 30 Sekunden zurückgesetzt wenn das Attribut wdTimer verändert wird.<br>
|
||||
Wenn dlyMax hoch ist (mehrere Sekunden) oder bufferMin geht gegen "0" (normal ist 4)
|
||||
leidet das System unter den internen Verzögerungen. Den Gründen hierfür muss
|
||||
nachgegangen werdensystem. Als schnelle Lösung kann der Wert für wdTimer
|
||||
verkleinert werden, um HMLAN schneller zu triggern.</li>
|
||||
<li><B>msgLoadEst</B><br>
|
||||
Abschätzung der Last auf dem HMLAN. Da HMLAN nur eine begrenzte Kapzität hat,
|
||||
um je Stunde eine bestimmte Anzahl an Meldungen abzusetzen, versucht FHEM
|
||||
diese Last vorauszuberechnen - siehe auch
|
||||
<a href="#hmMsgLowLimit">hmMsgLowLimit</a><br></li>
|
||||
<li><B>msgParseDly</B><br>
|
||||
Kalkuliert die Verzögerungen einer Meldung vom Zeitpunkt des Abschickens im HMLAN
|
||||
bis zu Verarbeitung in FHEM. Deshalb ist dies ein Indikator für die Leistungsfähigkeit
|
||||
des Systems von FHEM.
|
||||
</li>
|
||||
</ul>
|
||||
<a name="HMLANreadings"><b>Parameter und Readings</b></a>
|
||||
<ul>
|
||||
<li><B>prot_disconnect</B> <br>letzter HMLAN disconnect</li>
|
||||
<li><B>prot_init</B> <br>letzter HMLAN init</li>
|
||||
<li><B>prot_keepAlive</B> <br>HMLAN unterbrochen, wahrscheinlich um langsame
|
||||
keep-alive Meldungen zu senden.</li>
|
||||
<li><B>prot_ok</B> <br>letzte HMLAN ok Bedingung</li>
|
||||
<li><B>prot_timeout</B> <br>letzter HMLAN Timeout</li>
|
||||
<li><B>prot_Warning-HighLoad</B> <br>hohe Auslastung erreicht -
|
||||
HMLAN hat nur noch 10% seiner Leistungsfähigkeit übrig</li>
|
||||
<li><B>prot_ERROR-Overload</B> <br>Überlastung -
|
||||
HMLAN wird zwar Meldungen empfangen aber keine Meldungen mehr absenden</li>
|
||||
<li><B>prot_Overload-released</B><br>Überlastung beendet - normale Arbeitsweise ist möglich</li>
|
||||
</ul>
|
||||
|
||||
</ul>
|
||||
=end html
|
||||
|
||||
=cut
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user