FHEMWiki - Benutzerbeiträge [de]

FRITZBOX

2018-11-20T12:28:35Z

Mark79: /* Ring auf mehreren Telefonen gleichzeitig */

{{Infobox Modul
|ModPurpose=Steuerung einer Fritz!Box über FHEM
|ModType=d
|ModForumArea=FRITZ!Box
|ModTechName=72_FRITZBOX.pm
|ModOwner=tupol/Topos ({{Link2FU|5432|Forum}} / [[Benutzer Diskussion:Topos|Wiki]])}}

Das Modul [[FRITZBOX]] ermöglicht die Steuerung einer [[AVM Fritz!Box]] und von AVM FRITZ!WLAN Repeatern durch FHEM . An Fritzboxen können sowohl Geräte abgefragt werden, auf denen FHEM selbst läuft (lokaler Modus), als auch entfernte (externe) Geräte.

== Voraussetzungen ==
=== Remote-Zugang ===
Für den Remote-Zugang müssen die Module JSON:XS, LWP und SOAP::Lite installiert sein; auf einem [[Raspberry Pi]] oder unter Ubuntu z. B. mit dem Befehl
:<code>sudo apt-get install libjson-perl libwww-perl libsoap-lite-perl libjson-xs-perl</code>

Teilweise ist derzeit zusätzlich die Installation der telnet Libraries erforderlich, auch wenn der Telnet-Zugang nicht genutzt werden soll. Siehe dazu den nachfolgenden Abschnitt.

=== Telnet ===
Das Modul basierte ursprünglich auf dem Zugriff auf die Fritzbox per Telnet. Ab FRITZ!OS 6.2x baut AVM den abgekündigten Telnet-Zugang sowie die webcm-Schnittstelle sukzessive zurück bzw. hat dies, je nach Firmware, schon ganz abgestellt (siehe {{Link2Forum|Topic=38586|LinkText=dieses Forenthema}}). Der zukunftssichere Zugriff auf die Fritzbox sollte also per TR-064 erfolgen. Der Vollständigkeit halber und für ältere Firmwareversionen:

# Wer den Zugang per Telnet (noch) nutzen (kann und) möchte, muss dies zuerst freischalten. Üblicherweise durch Eingabe von #96*7* an einem direkt an der entsprechenden FritzBox angeschlosssenen Telefon
# Auf dem System, auf dem FHEM läuft ([[Systemübersicht#Server|Server]]) muss Telnet installiert sein; auf einem [[Raspberry Pi]] und unter Ubuntu z. B. mit dem Befehl
::<code>sudo apt-get install libnet-telnet-perl</code>

== Installation ==
=== Erste Schritte ===
Zur Erstinstallation reicht ein einfaches <code>define FritzBox FRITZBOX</code>, dieses Modul funktioniert lokal (FHEM auf Fritzbox) sowie per Fernzugriff (FHEM auf einem anderen Server im Netz, siehe nächsten Schritt).

==== TR-064: Modul FRITZBOX für Zugriff auf einem externen Server einrichten ====
Für den Fernzugriff über TR-064 auf eine oder mehrere Fritzboxen und/oder einen FRITZ!WLAN Repeater sind die folgenden Schritte nötig (für jedes Gerät):

Fritzbox definieren:
:<code>define FritzBox FRITZBOX</code>

Wenn die Fritzbox nicht unter <nowiki>http://fritz.box</nowiki> erreichbar ist, IP im define setzen:
:<code>define FritzBox FRITZBOX 192.168.168.168</code>
192.168.168.168 dabei natürlich durch die passende IP ersetzen... Alternativ kann statt der IP auch der Hostname eingegeben werden.

Wenn ('''und nur wenn''') das Login auf der Benutzeroberfläche der FritzBox mit User und Passwort (und nicht nur per Passwort) geschieht, den User konfigurieren:
:<code>attr FritzBox boxUser ''Benutzername'' </code>
In der Fritzbox muss dann auch "Anmeldung mit FRITZ!Box-Benutzernamen und Kennwort" ausgewählt sein.

Passwort konfigurieren:
:<code>set FritzBox password ''Passwort''</code> - legt das zugehörige Passwort fest (nur einmal --> gehört nicht in die cfg-Datei)

Manuelle TR-064 Kommandos erlauben (Das Auslesen der Readings per TR-064 funktioniert auch ohne dieses Attribut.):
:<code>attr FritzBox allowTR064Command 1</code>

==== Telnet: Modul FRITZBOX für Zugriff auf einem externen Server einrichten ====
[[Datei:Screenshot_FritzBox_TelnetUser.png|mini|300px|rechts|Anlegen des Attributs telnetUser]]
Bei Fernzugriff über Telnet sind weitere Schritte nötig:
# Telnet auf der Fritzbox freischalten (Tastenkombination #96*7* am angeschlossenen Telefon (auch FritzFon)
# TelnetUser definieren (wie im Screenshot gezeigt)
# Passwort zum Benutzer auf der Fritzbox definieren

[[Datei:Screenshot_FritzBox_Passwort.png|mini|300px|rechts|Passwort definieren]]

(bitte die Buttons {{Taste|set}} und {{Taste|attr}} bei der Definition der jeweiligen Einträge nicht vergessen)

Wer stattdessen lieber das [[Konfiguration|Befehl-Eingabefeld]] verwendet:

:<code>define FritzBox FRITZBOX</code>
:<code>attr FritzBox telnetUser ''Benutzername'' </code> - legt den Benutzer fest
:<code>set FritzBox password ''Passwort'' </code> - legt das zugehörige Passwort fest

Wer keinen User konfiguriert hat, kann das Feld "telnetUser" leer lassen.

Wer sicher gehen möchte, dass auch tatsächlich Telnet und nicht andere Zugriffe benutzt werden, sollte außerdem noch setzen:

:<code>attr FritzBox forceTelnetConnection 1</code>

=== mögliche Fehlermeldungen ===
Sollte schon bei <code>define FritzBox FRITZBOX</code> die Fehlermeldung kommen, dass dieses Modul nicht existiert, dann bitte prüfen, ob FHEM auf dem aktuellen Stand ist und ggf. [[Update|aktualisieren]].

Kommt jetzt bei der erneuten Definition die Fehlermeldung <code>Error: Perl modul Net::Telnet is missing on this system</code> bitte wie oben schon erwähnt den Befehl
:<code>sudo apt-get install libnet-telnet-perl</code>
direkt per Telnet/SSH auf dem FHEM-Server ausführen und neu starten.
Sollte alles geklappt haben, seht ihr nun eure Fritzbox und könnt diverse Einstellungen manuell vornehmen und/oder automatisch vornehmen lassen.

== Anwendung ==
=== Define ===
Siehe {{Link2CmdRef|Lang=de|Anker=FRITZBOXdefine}}

=== Attribute ===
Siehe {{Link2CmdRef|Lang=de|Anker=FRITZBOXattr}}

=== TR-064 ===
Die offizielle Programmier-Schnittstelle der Fritz!Box läuft über das Protokoll TR-064.

mit dem Attribute 
<code>attr <device> allowTR064Command 1</code> 
kann man den Befehl 
<code>get <device> tr064Command <service> <control> <action> [[parameterName1 parameterValue1] ...]</code> 
freischalten und damit auf diese Schnittstelle zugreifen.

AVM hat die Schnittstellenbeschreibung unter [http://avm.de/service/schnittstellen/] veröffentlicht. Diese wird jedoch nur sehr sporadisch gepflegt. 
Ein besserer Einstiegspunkt befindet sich auf der Box unter http://fritz.box:49000/tr64desc.xml. 
Die möglichen TR-064-Aktionen kann man auch über den Befehl <code>get <device> tr064ServiceList</code> auslesen.

Folgende Service und Controls existieren (für den get-Befehl ''tr064Command'' werden nur die fett formatierten Wörter benötigt)

{| class="wikitable"
|-
!serviceType!!controlURL!!XML!!Dokument bei AVM
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''DeviceInfo:1'''||/upnp/control/'''deviceinfo'''||[http://fritz.box:49000/deviceinfoSCPD.xml deviceinfoSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/deviceinfoSCPD.pdf deviceinfoSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''DeviceConfig:1'''||/upnp/control/'''deviceconfig'''||[http://fritz.box:49000/deviceconfigSCPD.xml deviceconfigSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/deviceconfigSCPD.pdf deviceconfigSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''Layer3Forwarding:1'''||/upnp/control/'''layer3forwarding'''||[http://fritz.box:49000//layer3forwardingSCPD.xml layer3forwardingSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/layer3forwardingSCPD.pdf layer3forwardingSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''LANConfigSecurity:1'''||/upnp/control/'''lanconfigsecurity'''||[http://fritz.box:49000//lanconfigsecuritySCPD.xml lanconfigsecuritySCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/lanconfigsecuritySCPD.pdf lanconfigsecuritySCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''ManagementServer:1'''||/upnp/control/'''mgmsrv'''||[http://fritz.box:49000//mgmsrvSCPD.xml mgmsrvSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/mgmsrvSCPD.pdf mgmsrvSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''Time:1'''||/upnp/control/'''time'''||[http://fritz.box:49000//timeSCPD.xml timeSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/timeSCPD.pdf timeSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''UserInterface:1'''||/upnp/control/'''userif'''||[http://fritz.box:49000//userifSCPD.xml userifSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/userifSCPD.pdf userifSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''X_VoIP:1'''||/upnp/control/'''x_voip'''||[http://fritz.box:49000//x_voipSCPD.xml x_voipSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/x_voipSCPD.pdf x_voipSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''X_AVM-DE_Storage:1'''||/upnp/control/'''x_storage'''||[http://fritz.box:49000//x_storageSCPD.xml x_storageSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/x_storageSCPD.pdf x_storageSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''X_AVM-DE_OnTel:1'''||/upnp/control/'''x_contact'''||[http://fritz.box:49000//x_contactSCPD.xml x_contactSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/x_contactSCPD.pdf x_contactSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''X_AVM-DE_WebDAVClient:1'''||/upnp/control/'''x_webdav'''||[http://fritz.box:49000//x_webdavSCPD.xml x_webdavSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/x_webdavSCPD.pdf x_webdavSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''X_AVM-DE_UPnP:1'''||/upnp/control/'''x_upnp'''||[http://fritz.box:49000//x_upnpSCPD.xml x_upnpSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/x_upnp.pdf x_upnp.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''X_AVM-DE_RemoteAccess:1'''||/upnp/control/'''x_remote'''||[http://fritz.box:49000/x_remoteSCPD.xml x_remoteSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/x_remoteSCPD.pdf x_remoteSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''X_AVM-DE_MyFritz:1'''||/upnp/control/'''x_myfritz'''||[http://fritz.box:49000/x_myfritzSCPD.xml x_myfritzSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/x_myfritzSCPD.pdf x_myfritzSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''X_AVM-DE_TAM:1'''||/upnp/control/'''x_tam'''||[http://fritz.box:49000/x_tamSCPD.xml x_tamSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/x_tam.pdf x_tam.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''X_AVM-DE_AppSetup:1'''||/upnp/control/'''x_appsetup'''||[http://fritz.box:49000/x_homeautoSCPD.xml x_homeautoSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/x_appsetupSCPD.pdf x_appsetupSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''X_AVM-DE_Homeauto:1'''||/upnp/control/'''x_homeauto'''||[http://fritz.box:49000/x_homeautoSCPD.xml x_homeautoSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/x_homeautoSCPD.pdf x_homeautoSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''WLANConfiguration:1'''||/upnp/control/'''wlanconfig1'''||[http://fritz.box:49000/wlanconfigSCPD.xml wlanconfigSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/wlanconfigSCPD.pdf wlanconfigSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''WLANConfiguration:2'''||/upnp/control/'''wlanconfig2'''||[http://fritz.box:49000/wlanconfigSCPD.xml wlanconfigSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/wlanconfigSCPD.pdf wlanconfigSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''WLANConfiguration:3'''||/upnp/control/'''wlanconfig3'''||[http://fritz.box:49000/wlanconfigSCPD.xml wlanconfigSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/wlanconfigSCPD.pdf wlanconfigSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''Hosts:1'''||/upnp/control/'''hosts'''||[http://fritz.box:49000/hostsSCPD.xml hostsSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/hostsSCPD.pdf hostsSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''LANEthernetInterfaceConfig:1'''||/upnp/control/'''lanethernetifcfg'''||[http://fritz.box:49000/lanifconfigSCPD.xml lanifconfigSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/lanifconfigSCPD.pdf lanifconfigSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''LANHostConfigManagement:1'''||/upnp/control/'''lanhostconfigmgm'''||[http://fritz.box:49000/lanhostconfigmgmSCPD.xml lanhostconfigmgmSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/lanhostconfigmgmSCPD.pdf lanhostconfigmgmSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''WANCommonInterfaceConfig:1'''||/upnp/control/'''wancommonifconfig1'''||[http://fritz.box:49000/wancommonifconfigSCPD.xml wancommonifconfigSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/wancommonifconfigSCPD.pdf wancommonifconfigSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''WANDSLInterfaceConfig:1'''||/upnp/control/'''wandslifconfig1'''||[http://fritz.box:49000/wandslifconfigSCPD.xml wandslifconfigSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/wandslifconfigSCPD.pdf wandslifconfigSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''WANDSLLinkConfig:1'''||/upnp/control/'''wandsllinkconfig1'''||[http://fritz.box:49000/wandsllinkconfigSCPD.xml wandsllinkconfigSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/wandsllinkconfigSCPD.pdf wandsllinkconfigSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''WANEthernetLinkConfig:1'''||/upnp/control/'''wanethlinkconfig1'''||[http://fritz.box:49000/wanethlinkconfigSCPD.xml wanethlinkconfigSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/wanethlinkconfigSCPD.pdf wanethlinkconfigSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''WANPPPConnection:1'''||/upnp/control/'''wanpppconn1'''||[http://fritz.box:49000/wanpppconnSCPD.xml wanpppconnSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/wanpppconnSCPD.pdf wanpppconnSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''WANIPConnection:1'''||/upnp/control/'''wanipconnection1'''||[http://fritz.box:49000/wanipconnSCPD.xml wanipconnSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/wanipconnSCPD.pdf wanipconnSCPD.pdf]
|-
|}

=== Status-Symbol ===
<code>attr <device> devStateIcon .*on.*off:WLAN_on_gWLAN_off .*on.*on.*:WLAN_on_gWLAN_on WLAN..off.*:WLAN_off</code>

Im Verzeichnis www/images/default müssen die passenden Dateien "WLAN_on_gWLAN_off.png", "WLAN_on_gWLAN_on.png" und "WLAN_off.png" liegen. Wenn die PNGs fehlen, können sie {{Link2Forum|Topic=29725|Message=318113|LinkText=hier}} heruntergeladen werden.

== Anwendungsbeispiele ==
[[Datei:Screenshot_FritzBox1.png|mini|300px|rechts|FRITZBOX Gerät auf der FHEM Oberfläche]]
Sollte alles geklappt haben, seht ihr nun unter "Unsortiert" den im nebenstehenden Screenshot gezeigten Eintrag für das "Gerät" (hier mit dem Icon "it_router").

=== TR-064 Beispiele ===
*Box Reboot: <code>get <device> tr064Command DeviceConfig:1 deviceconfig Reboot</code>
*Internet Reconnect: <code>get <device> tr064Command WANIPConnection:1 wanipconnection1 ForceTermination</code>
*Daten eines Smart-Home-Gerätes auslesen: <code>get <device> tr064Command X_AVM-DE_Homeauto:1 x_homeauto GetGenericDeviceInfos NewIndex 0</code>

=== Klingel- und Sprachausgabe per TR-064 ===
Das geht derzeit nicht, da entsprechende Kommandos per TR-064 nicht verfügbar sind. Da Telnet sukzessive abgestellt wird, sollten sich Interessenten per Feature-Request an AVM wenden, wie {{Link2Forum|Topic=38586|LinkText=hier}} beschrieben.

Eine Alternative um Telefone klingeln zu lassen, ist die Nutzung des [[SIP-Client]]s.

=== Anwesenheitserkennung per regelmäßiger Abfrage über das PRESENCE Modul ===
Fritzboxen und die FRITZ!WLAN Repeater speichern den Status angemeldeter Geräte. Dieser Status lässt sich mittels des FRITZBOX Moduls über Readings abfragen, die das Format mac_AA_AA_AA_AA_AA_AA haben und die MAC-Adressen der jeweils angemeldeten Geräte (AA:AA:AA:AA:AA:AA) enthalten. Das Reading existiert, wenn das Gerät angemeldet ist. Wenn das Gerät abgemeldet ist, existiert es nicht mehr. Es gibt auch noch den Zwischenstatus "inactive", der anscheinend gesetzt wird, bevor das Reading gelöscht wird.

Mit Hilfe des [[PRESENCE]] Moduls (vgl. [[Anwesenheitserkennung]]) kann man auf diese Weise den Anwesenheitsstatus abfragen. Anregungen dazu gibt es im zugehörigen {{Link2Forum|Topic=39433|LinkText=Forenthread}} zur Anwesenheitserkennung und in [http://heinz-otto.blogspot.de/2015/07/die-zeiten-andern-sich.html diesem Blogpost]. Auf dieser Basis könnte eine einfache Implementierung zum Beispiel so aussehen:

Funktion in [[99_myUtils anlegen|99_myUtils]]:

<syntaxhighlight lang='perl'>sub checkFritzMACpresent($$) {
# Benötigt: Name der zu testenden Fritzbox ($Device),
# zu suchende MAC ($MAC),
# Rückgabe: 1 = Gerät gefunden
# 0 = Gerät nicht gefunden
my ($Device, $MAC) = @_;
my $Status = 0;
$MAC =~ tr/:/_/;
$MAC = "mac_".uc($MAC);
my $StatusFritz = ReadingsVal($Device, $MAC, "weg");
if ($StatusFritz eq "weg") {
Log 1, ("checkFritzMACpresent ($Device): $MAC nicht gefunden, abwesend.");
$Status = 0;
} elsif ($StatusFritz eq "inactive") {
Log 1, ("checkFritzMACpresent ($Device): $MAC ist >inactive<, also abwesend.");
$Status = 0;
} else {
# Reading existiert, Rückgabewert ist nicht "inactive", also ist das Gerät per WLAN angemeldet.
Log 4, ("checkFritzMACpresent ($Device): $MAC gefunden, Gerät heißt >$StatusFritz<.");
$Status = 1;
}
return $Status
}
</syntaxhighlight>

Nutzung dieser Funktion mit dem PRESENCE Modul definieren:
:<code>define <Name> PRESENCE function {checkFritzMACpresent("Fritzbox","AA:BB:CC:DD:EE:FF")} 60 60</code>
wobei
*<Name> ein beliebig zu wählender Name für die PRESENCE-Funktion ist,
*Fritzbox der Name ist, mit dem ihr die abzufragende Fritzbox als FRITZBOX definiert habt,
*AA:BB:CC:DD:EE:FF die MAC-Adresse des gesuchten Geräts ist.
* "60 60" sagt, dass der Anwesenheitsstatus im 60-Sekunden-Takt abgefragt wird. Das macht natürlich nur Sinn, wenn ihr mit <code>attr Fritzbox INTERVAL 60</code> den Abfrageinterval bei der Fritzbox auch entsprechend hochgesetzt habt. Der Standard ist 300.
* "Log 1" führt immer zum Loggen. Das ist zum Einrichten praktisch, ohne dass man gleich für das ganze Modul oder ganz FHEM <code>attr <device> verbose 5</code> setzen muss. Wenn es läuft, können die "Log 1"-Zeilen gelöscht, auskommentiert (# an den Zeilenanfang) oder in "Log 5" geändert werden.

=== Anwesenheitserkennung über mehrere Fritzboxen oder AVM Repeater und Fritzbox ===
Existiert ein AVM Repeater im Netzwerk, kann der als eigenständiges Gerät mit FRITZBOX definiert werden. WLAN Geräte an der Fritzbox werden in der Instanz der Fritzbox gelistet und WLAN Geräte am Repeater in der Repeater Instanz. Um trotzdem die Anwesenheit im Netzwerk einfach zu erkennen, muss die Subroutine in 99_myUtils.pm abgewandelt werden.

Existiert eine zweite Fritzbox im Accesspointmodus, werden die WLAN Geräte im Netzwerk alle in der Hauptfritzbox an einem LAN Anschluss gelistet. D.h. man sieht an der Hauptfritzbox nicht, dass sie im WLAN sind. Eine zweite Instanz mit dem FRITZBOX Modul muss wegen der Anwesenheitserkennung nicht gemacht werden. Die folgende Routine kann aber universell eingesetzt werden, unabhängig von der Anzahl der FRITZBOX Instanzen. Wer mitloggen will, kann das analog zur obigen Routine einbauen

<syntaxhighlight lang='perl'>sub checkAllFritzMACpresent($) {
# Benötigt: nur die zu suchende MAC ($MAC),
# Es werden alle Instanzen vom Type FRITZBOX abgefragt
#
# Rückgabe: 1 = Gerät gefunden
# 0 = Gerät nicht gefunden
my ($MAC) = @_;
# Wird in keiner Instanz die MAC Adresse gefunden bleibt der Status 0
my $Status = 0;
$MAC =~ tr/:/_/;
$MAC = "mac_".uc($MAC);
my @FBS = devspec2array("TYPE=FRITZBOX");
foreach( @FBS ) {
my $StatusFritz = ReadingsVal($_, $MAC, "weg");
if ($StatusFritz eq "weg") {
} elsif ($StatusFritz eq "inactive") {
} else {
# Reading existiert, Rückgabewert ist nicht "inactive", also ist das Gerät am Netzwerk angemeldet.
$Status = 1;
}
}
return $Status
}
</syntaxhighlight>

Da hiermit nach allen Instanzen mit dem TYPE=FRITZBOX durchsucht wird, braucht der Name der Fritzbox nicht angegeben werden.

:<code>define <Name> PRESENCE function {checkAllFritzMACpresent("AA:BB:CC:DD:EE:FF")} 60 60</code>

Die Abfrage auf einen bestimmten Status kann einfach erweitert werden, ist aber immer vom Entwicklunsgstand der Fritzbox Firmware und des FRITZBOX Moduls abhängig. Eventuell erreicht man bessere Reaktionszeiten auf Abwesenheit durch diesen Zusatz:
<syntaxhighlight lang='perl'>my $StatusFritz = ReadingsVal($_, $MAC, "weg");
if ($StatusFritz eq "weg") {
} elsif ($StatusFritz eq "inactive") {
} elsif ($StatusFritz =~ /(.*)s, 0/) {
# Dieser Zweig testet auf "<geraetename> (WLAN, 0 / 0 Mbit/s, 0)"
} else {
$Status = 1;
}
</syntaxhighlight>

Weitere Hinweise zu komplexeren Abfragen mehrere Boxen auf einmal etc. findet ihr auch im diesem {{Link2Forum|Topic=39433|LinkText=Forenthread}}.

=== Anwesenheitserkennung per Notify ===
Der von Fritzboxen und Fritz!WLAN Repeatern gespeicherte Status zum Status angemeldeter Geräte lässt sich (statt per PRESENCE, s.o.) auch per [[notify]] anfragen:

<syntaxhighlight lang="perl">define <Name> notify Fritzbox:mac_AA_BB_CC_DD_EE_FF:.* {
if (ReadingsVal("Fritzbox", "mac_AA_BB_CC_DD_EE_FF", "inactive") eq "inactive")
{
fhem("set anwesend_smartphone absent");
}
else
{
fhem("set anwesend_smartphone present");
}
}</syntaxhighlight>

Hinweise:
* <code>fhem("set anwesend_smartphone absent");</code> ist nur ein Beispiel, das einen Dummy auf den Status "absent" bzw. "present" setzt. Man kann hier natürlich auch gleich entsprechende Aktionen durchführen. Wer das Beispiel übernehmen möchte, sollte den Dummy vorher definieren (<code>define anwesend_smartphone dummy</code>).
* mac_AA_BB_CC_DD_EE_FF ist die MAC-Adresse des gesuchten Geräts.
* "Fritzbox" ist der Name, unter dem die Fritzbox als FRITZBOX-Modul definiert wurde.
* Das Notify funktioniert, weil Geräte, wenn sie sich abgemeldet haben, erst den Status "inactive" erhalten. Ist das Gerät ganz abgemeldet, verschwindet das mac_.*-Reading. Dabei löst das Notify nicht mehr aus. Da das mac-.*-Reading aber vorher auf "inactive" stand, wurde die Abwesend-Aktion schon ausgeführt.
* Damit der Notify nicht andauernd losgeht, sollte man mittels <code>attr Fritzbox [[event-on-change-reading]] mac_AA_BB_CC_DD_EE_FF</code> Events nur auslösen, wenn sich der Status des Gerätes ändert. Will man mehrere Geräte abfragen, sollte man <code>attr Fritzbox event-on-change-reading mac_AA_BB_CC_DD_EE_FF,mac_GG_HH_II_JJ_KK_LL</code> setzen, damit bei der Änderung jedes Readings ein Event ausgelöst wird.

=== Vergleich Anwesenheitserkennung PRESENCE/Notify ===
Die Anwesenheitserkennung per regelmäßiger PRESENCE-Abfrage hat den Vorteil, dass sie im Turnus der regelmäßigen Abfragen immer einen aktuellen Status produziert. Sie hat dafür den Nachteil, dass die PRESENCE-Funktionen regelmäßig abgearbeitet werden müssen, auch wenn sich gar nichts ändert. Außerdem aktualisiert sich der Status nicht sofort, sondern erst bei der nächsten regelmäßigen Abfrage. Durch häufiges Abfragen kann dieser Nachteil verringert werden (bei entsprechend höherer Systemlast).

Die Anwesenheitserkennung per Notify hat den Vorteil, dass ein sich ändernder Status sofort abgebildet wird. Ändert sich kein Status, werden keine Routinen ausgeführt, was die Systemlast gering hält. Der Nachteil ist, dass - z.B. nach einem Systemstart - die entsprechende Aktion erst bei einer Änderung des Status ausgeführt wird. D.h. ist das zu testende Gerät anwesend, wird dann FHEM beendet, das Gerät entfernt und FHEM wieder gestartet, ist der Status in FHEM immer noch "anwesend". Da das Reading für das Gerät nicht existiert, wird darauf auch erst wieder ein Notify ausgeführt, wenn sich der Status des Geräts wieder ändert, d.h. es wieder ankommt. Bis dahin ist der Status im System falsch.
Der Nachteil des Notify kann verringert werden, wenn man statt <code>attr Fritzbox event-on-change-reading mac_AA_BB_CC_DD_EE_FF</code> ein <code>attr Fritzbox [[event-on-update-reading]] mac_AA_BB_CC_DD_EE_FF</code> setzt. Das erhöht allerdings die Systemlast und funktioniert auch nur für den Status "anwesend". Bei "abwesend" ist kein Reading vorhanden, so dass auch event-on-update-reading nicht ausgeführt wird.
Eine weitere Möglichkeit, den Nachteil der Notify-Methode auszugleichen, ist, die Statusabfrage beim Systemstart einmal manuell auszuführen, durch ein notify auf "GLOBAL:initialized":
<syntaxhighlight lang="perl">
global:INITIALIZED {
Reset_Variables;
if (ReadingsVal("Fritzbox", "mac_AA_BB_CC_DD_EE_FF", "inactive") eq "inactive") {
fhem("set anwesend_smartphone absent");
} else {
fhem("set anwesend_smartphone present");
}
}
</syntaxhighlight>
Das hilft allerdings nur beim Systemstart. Nicht, wenn FHEM aufgrund irgendwelcher Hänger eine Aktualisierung des Status verpasst hat.

=== userReadings per ''get tr064Command'' oder ''get luaQuery'' ===
Um dem Gerätewert <userReadingName> den Wert von <VariabelName> aus der Rückgabe des get-Befehls ''tr064Command'' oder ''luaQuery'' zuzuordnen
<pre>
attr <device> userReadings <userReadingName> {my $resp=fhem("get <device> tr064Command <service> <control> <action> [[<argName1> <argValue1>] ...]",1);;$resp =~/\'<VariabelName>\' => '(.*)'/;;return $1;;}
</pre>
Beispielsweise
<pre>attr Fritzbox userReadings urMobilteil_1 {my $resp=fhem("get Fritzbox tr064Command X_AVM-DE_OnTel:1 x_contact GetDECTHandsetInfo NewDectID 1",1);;$resp =~/'NewHandsetName' => '(.*)'/;;return $1;;},
urDownstreamDSLRate {my $resp=fhem("get Fritzbox tr064Command WANDSLInterfaceConfig:1 wandslifconfig1 GetInfo",1);;$resp =~/'NewDownstreamCurrRate' => '(.*)'/;;return $1;;},
urUpstreamDSLRate {my $resp=fhem("get Fritzbox tr064Command WANDSLInterfaceConfig:1 wandslifconfig1 GetInfo",1);;$resp =~/'NewUpstreamCurrRate' => '(.*)'/;;return $1;;}</pre>
oder bei einzelnen Werte über ''get luaQuery''<pre>attr Fritzbox userReadings sip1_connect {my $resp=fhem("get Fritzbox luaQuery sip:settings/sip1/connect",1);;$resp =~/([0-9])$/;;return $1;;}</pre>

=== Klingelton-Einstellung und Abspielen von Sprachnachrichten bei Fritz!OS-Versionen >6.24 ===
Wenn die Fritzbox weder die Telnet- noch die webcmd-Schnittstelle hat, kann der Klingelton der Fritz!Fons nicht mehr verstellt und auch keine Sprachnachricht über ein Fritz!Fon ausgegeben werden.

Es gibt eine Behelfslösung über das Attribut ''useGuiHack''. Dadurch wird eine Eingabe in die WebGUI der Fritzbox simuliert.

'''ACHTUNG''': Vor allem nach einem Update der FritzBox kann es durch dieses Attribut zu ungewolltem Verstellen von Werten in der Fritzbox kommen.

Bei Verwendung der ring-Parameter "play:" und "say:" wird die abzuspielende URL in die M3U-Datei, die unter dem Internal ''M3U_LOCAL'' steht, eingetragen. 
Standardmäßig wird versucht, diese Datei im image-Verzeichnis von FHEM abzulegen. Diese kann dann vom Fritz!Fon über [[FHEMWEB]] abgespielt werden (IP-Freigaben beachten). Direkt nach dem ersten Anlegen der m3u-Datei kennt [[FHEMWEB]] diese noch nicht, daher bitte entweder ''set <webdevice> rereadicons'' ausführen oder FHEM neu starten. 

Aufgrund der Beschränkungen von [[FHEMWEB]] oder auch bei Authentifizierungsanforderungen ist es empfehlenswert, die Datei über das Attribute ''m3uFileLocal'' selber vorzugeben. Am besten auf einem Webserver, der auf dem FHEM-Server läuft und dessen Seiten-Verzeichnis durch FHEM beschreibbar ist. 
Beispiel: <code>attr Fritzbox m3uFileLocal /var/www/mp3/Fritzbox.m3u</code>

In dem Radioeintrag ''FHEM'' muss dann '''auf der FritzBox''', die '''Web'''-Adresse der entsprechenden Datei eingetragen werden. Dieser Sender sollte zu Testzwecken dann auch einmal am Fritz!Fon von Hand gestartet werden. 
Das Modul versucht, beim Start die einzutragende Radio-URL im image-Verzeichnis selber zu ermitteln (IP-Freigabe beachten). Gelingt dies, so steht diese im Internal ''M3U_URL''.

=== Ring auf mehreren Telefonen gleichzeitig ===

Damit mehrere Telefone per ring gleichzeitig Klingel, muss in der Fritzbox eine Rufgruppe definiert werden.
Sollte eine Türsprechanlage schon in Benutzung sein, kann die eventuell hierfür bereits eingerichtete Gruppe verwendet werden.
Das anlegen der Gruppe erfolgt wie in folgender AVM Anleitung erledigt werden. [https://avm.de/service/fritzbox/fritzbox-7390/wissensdatenbank/publication/show/1148_Interne-Rufgruppe-in-FRITZ-Box-einrichten-Gruppenruf/ AVM Interne Rufgruppe anlegen]

Es muss eine Kurzwahl bei der Gruppe zwingend hinterlegt sein.
Danach kann mit folgendem Beispiel Code gearbeitet werden:

<code>set FritzBox ring 791 15 show:Türklingel</code>

Name des Devices, Rufgruppen Nummer, Länge und gezeigter Text auf das gewünschte anpassen.

== Bekannte Probleme / Fehlersuche ==
=== Fehler nach Firmware Update ===
Typischer Fehler ist hier "Error: 403 Forbidden".
Nach einem Firmwareupdate der Fritzbox am besten auch FHEM neu starten.

=== Modul bleibt im Status "Check APIs" hängen===
Im Log steht die Meldung: "Error: Timeout when reading Fritz!Box data.".

Mögliche Ursache: Nutzung des FHEM-Befehls [[FHEM_Command_Beispiele#rereadcfg|rereadcfg]]. Dieser verträgt sich nicht mit dem Modul "blocking.pm", das für parallel laufende FHEM-Prozesse genutzt wird.

Abhilfe schafft ein Neustart <code>shutdown restart</code> oder das Einfügen eines zusätzlichen, lokalen Telnet-Ports z.B. durch <code>define tPortLocal telnet 7073</code>

=== Nachtschaltung Doppel-WLAN ===
Beim Abschalten des WLAN über das Modul wird (über TR064) zuerst das 2.4 GHz und dann das 5 GHz WLAN ausgeschaltet. Bei der gleichzeitigen Nutzung der WLAN-Nachtschaltung (Anschalten über das Fritz!OS) wird dann jedoch nur noch das 5 GHz WLAN wieder angeschaltet. Die Box interpretiert den TR064-Befehl anscheinend als ein komplettes Abwählen des 2.4 GHz WLAN.

Abhilfe schafft hier nur ein notify auf das 5 GHz WLAN mit einem nachträglichem Anschalten des 2.4 GHz WLAN.

Alternativ kann das Ausschalten des WLANs nicht direkt über TR064-Kommandos, sondern über einen indirekten Weg erfolgen: über TR064 ein set call abzusetzen und hier den Tastencode zum Ausschalten des WLANs einzugeben, bei einer FritzBox 7490 wäre dies z. B. #96*0*.
Schaltet man über diese Methode das WLAN aus, kann es über die Nachtschaltung wieder automatisch auf beiden Frequenzen angeschaltet werden.

=== Kabelboxen ===
Bei Fritz!Boxen für den Kabelanschluss (z.B. Kabel Deutschland) scheint neben Telnet auch die TR064-API nicht zu funktionieren. Vermutlich wurde die API von AVM auf Betreiberwunsch deaktiviert, da man sonst Dinge ändern kann, die das gesamte Kabelnetz stören können.

Zumindest für Unitymedia und einer FRITZ!Box 6490 Cable (lgi) mit FRITZ!OS:06.50 funktioniert TR064.

Eine Rufumleitung bei Abwesenheit (Modul PRESENCE) funktioniert mit einer vorher eingerichten Telefonnummer wie folgt:
<code>define Rufumleitung DOIF ([Anwesenheit.dum:state] eq "off") (set FritzBox6490 diversity 1 on) DOELSEIF ([Anwesenheit.dum:state] eq "on") (set FritzBox6490 diversity 1 off)</code>

=== Wenn's nicht klingelt ===
Das Klingeln erfolgt über die Wählhilfe. Eventuell muss über die Weboberfläche der Fritz!Box ein anderer Port eingestellt werden. Der aktuelle steht in "box_stdDialPort".

=== TR064-Transport-Error: 500 Can't connect to ...:49443 (certificate verify failed) ===
Eventuell hilft es, die Perl Module Net::HTTPS, Net::SSL und IO::Socket::SSL zu aktualisieren.

=== "Error: Old SID not valid anymore." nach Erlauben von IPv6 auf der Fritzbox ===
Ohne hier den genauen Grund zu kennen - es hilft die Angabe der IPv4-Adresse: also statt <code>define FritzBox FRITZBOX</code> dann <code>define FritzBox FRITZBOX <IP></code> (z.B. <code>define FritzBox FRITZBOX 192.168.10.1</code>), so dass das Modul nicht über IPv6 geht.

=== "Didn't get a session ID" ===
Bei gleichzeitiger Nutzung anderer Modul für die Fritzbox (z.B. {{Link2CmdRef|Anker=FBAHAHTTP|Lang=en|Label=FBAHAHTTP}}) muss der Zugang über Benutzername und Password erfolgen. 
:<code>attr <DEVICE> boxUser <USER></code>
Da das FRITZBOX-Modul eine inoffizielle Schnittstelle benutzt, muss dann auch der normale Zugang zur Box auf "Benutzername und Password" eingestellt sein. 
In der Firmware 6.92 wird der Zugang über die Menüs "System"->"Fritz!Box-Benutzer"->"Anmeldung im Heimnetz" eingestellt.

Oft wird aber auch ein falsches oder gar kein Passwort gesetzt.

:<code>set <DEVICE> password <PASSWORD></code>

=== TR064-Error 401:invalid action ===
Eventuell ist auf der Fritzbox ein Benutzer gesetzt und im Modul nicht korrekt angegeben bzw. mit falschen Rechten versehen (attribut boxUser).

== Links ==
* {{Link2Forum|Topic=29725|LinkText=Forenthread}} zu diesem Modul

[[Kategorie:FritzBox]]


[[Kategorie:Akustische Ausgabe]]

MQTT2-Module - Praxisbeispiele

2018-11-17T17:51:48Z

Mark79: /* Define eines MQTT2-Devices als "Bridge" */

== Einführung: MQTT2 vs. MQTT ==
Zur Einbindung von Geräten, welche mit einem MQTT-Server (früher: Broker) kommunizieren können, stehen unter FHEM zwei Optionen zur Verfügung: Man kann entweder einen dedizierten Server (wie z.B. mosquitto) nutzen, der dann über das Modul [[MQTT]] eingebunden wird und zu dem die Module [[MQTT_DEVICE]] und {{Link2CmdRef|Anker=MQTT_BRIDGE|Lang=en|Label=MQTT_BRIDGE}} gehören (bzw. noch MQTT_GENERIC_BRIDGE), oder man kann mit Hilfe des Moduls {{Link2CmdRef|Anker=MQTT2_SERVER|Lang=en|Label=MQTT2_SERVER}} FHEM selbst zum MQTT-Server machen.
{{Hinweis|Man kann auch beide Ansätze gleichzeitig nutzen, sollte dann aber darauf achten, dass man an dem MQTT-Device eine ''client-ID'' vergibt.}}

Gegenstand dieses Artikels sind Beispiele, wie MQTT-Client-Geräte mit Hilfe der MQTT2-Implementierung ohne einen weiteren Server wie mosquitto genutzt werden können. {{Link2CmdRef|Anker=MQTT2_DEVICE|Lang=en|Label=MQTT2_DEVICE}} unterstützt dabei die ''setextensions'' direkt, also z.B. ''on-for-timer''.

Für alle Beispiele wird vorausgesetzt, dass ein MQTT2_SERVER-Device als Server definiert wurde. Es wird in einer Installation nur ein eiziger MQTT2_SERVER benötigt. Für dieser sollte dabei ''autocreate'' aktiviert werden, damit die erforderlichen MQTT2_DEVICES soweit möglich automatisiert erstellt werden. Die nachfolgende Code-Darstellung ist jeweils im RAW-Format zum [[Import von Code Snippets]].

== zigbee2mqtt ==
[[Bild:MQTT2_zigbee2mqtt_Bulbs.png|400px|thumb|Darstellung in FHEMWEB]]
[https://https://github.com/Koenkk/zigbee2mqtt zigbee2mqtt] ist ein open-source Projekt, mit dem zigbee-Geräte über MQTT direkt angesprochen werden können, ohne dass hierfür eine Bridge eines Herstellers benötigt wird.
=== Installation von zigbee2mqtt ===
Die Installation ist auf der Homepage des Projekts beschrieben. Ergänzend muß in der configuration.yaml eine ''client_id'' unter ''mqtt'' (z.B. zigbee_pi) vergeben werden.

=== Define eines MQTT2-Devices als "Bridge" ===
Dann kann eine Art "Grund-Device" angelegt werden, über das die gesamte Kommunikation zu allen angeschlossenen Zigbee-Geräten dann läuft. In der Regel sollte dieses automatisch erstellt werden, wenn der zigbee2mqtt-Dienst (oder der betreffende Rechner) neu gestartet wird:

defmod MQTT2_zigbee_pi MQTT2_DEVICE zigbee_pi
attr MQTT2_zigbee_pi IODev MQTT2_FHEM_Server
attr MQTT2_zigbee_pi setList permit_join:true,false zigbee2mqtt/bridge/config/permit_join $EVTPART1
remove:textField zigbee2mqtt/bridge/config/remove $EVTPART1
log_level:debug,info,warn,error zigbee2mqtt/bridge/config/log_level $EVTPART1
rename:textField zigbee2mqtt/bridge/config/rename {"old":"$EVTPART1","new":"$EVTPART2"}
network_map:raw,graphviz zigbee2mqtt/bridge/networkmap $EVTPART1
devicelist:noArg zigbee2mqtt/bridge/config/devices

Ist dieses angelegt, kann zigbee2mqtt mit <code>set MQTT2_zigbee_pi permit_join true</code> in den Anlernmodus versetzt werden, anzulernende Geräte müssen dann nach Bedienungsanleitung in den Anlernmodus gebracht werden.

Nach einem Browser-refresh sollte das neue Device zusätzliche Readings in MQTT2_zigbee_pi erzeugt haben.
Wer möchte, kann die Devices dann umbenennen; da diese in FHEM aber nachfolgend sowieso eigene Namen erhalten, kann dieses auch unterbleiben.

=== Vereinzeln der eigentlichen Geräte ===

Anschließend kann man - am einfachsten über die Anpassung der RAW-Definition des "Bridge"-Devices - neue MQTT2_DEVICE-Geräte ableiten (also manuell anlegen), die dann jeweils nur den Teil der readingList abbilden, der zu einem einzelnen pysischen Gerät gehört.

Beispiele:
==== IKEA-Tradfri-Birne ====
Beispiel eines dimmbaren Tradfri-Leuchtmittels
defmod IKEA_Bulb2 MQTT2_DEVICE
attr IKEA_Bulb2 IODev MQTT2_FHEM_Server
attr IKEA_Bulb2 eventMap on:ON:off off:OFF:on
attr IKEA_Bulb2 icon light_control
attr IKEA_Bulb2 readingList zigbee_pi:zigbee2mqtt/Kueche_Durchgang_A2:.* { json2nameValue($EVENT) }
attr IKEA_Bulb2 setList on zigbee2mqtt/Kueche_Durchgang_A2/set {"state":"ON"}\
off zigbee2mqtt/Kueche_Durchgang_A2/set {"state":"OFF"}\
brightness:colorpicker,BRI,0,15,255 zigbee2mqtt/Kueche_Durchgang_A2/set {"state":"on","$EVTPART0":"$EVTPART1"}

attr IKEA_Bulb2 webCmd brightness

Kann man auch die Farbtemperatur einstellen, wird die setList wie folgt erweitert:
...
color_temp:colorpicker,CT,250,1,454 zigbee2mqtt/ikea_flur_oben/set {"$EVTPART0":"$EVTPART1"}
webCmd muß dann ebenfalls noch ergänzt werden.

Für ein dynamisches Icon, das die Helligkeit wiedergibt, kann man folgenden Code in [[99 myUtils anlegen|myUtils]] verwenden und mit <code>attr IKEA_Bulb2 devStateIcon {devStateIcon255($name)}</code> einbinden:

##############################################
# $Id: myUtils_Color.pm 08-15 2018-10-08 18:31:44Z Beta-User $
#

package main;

use strict;
use warnings;
use POSIX;

sub
myUtils_Color_Initialize($$)
{
my ($hash) = @_;
}

# Enter you functions below _this_ line.

sub devStateIcon255($) {
my $name = shift(@_);
return ".*:off:toggle" if( ReadingsVal($name,"state","ON") eq "OFF" );
my %dim_values = (
0 => "dim06%",
1 => "dim12%",
2 => "dim18%",
3 => "dim25%",
4 => "dim31%",
5 => "dim37%",
6 => "dim43%",
7 => "dim50%",
8 => "dim56%",
9 => "dim62%",
10 => "dim68%",
11 => "dim75%",
12 => "dim81%",
13 => "dim87%",
14 => "dim93%",
);

my $pct = ReadingsVal($name,"brightness","255");
my $s = $dim_values{int($pct/18)};
$s="on" if( $pct > 253 );
return ".*:$s:off";
}

1;

==== Temp/Hum. Sensor ====
tbd

== Tasmota ==
[https://github.com/arendst/Sonoff-Tasmota Tasmota] ist eine open-source Software für ESP8266-Geräte, die z.B. statt der originalen firmware für Sonoff-Geräte verwendet werden kann. {{Randnotiz|RNTyp=r|RNText=Bitte beachten Sie, dass versicherungsrechtliche Probleme entstehen können, wenn die die herstellereigene firmware ersetzt wird!}}

=== MQTT2_DEVICE ===
Dieses sollte bei aktiviertem ''autocreate'' am MQTT2_SERVER-Device automatisch angelegt werden, sobald das betreffende Gerät eingesteckt oder neu gestartet wird oder an einem evtl. vorhandenen Taster geschalten. Hier wurden Tasmota version(en) 6.1.1 und 6.2.1 getestet, Hardware war Sonoff Touch und S20.

=== Anpassungen ===
Die RAW-Definition kann dann beispielsweise wie folgt ergänzt werden:
defmod MQTT2_DVES_9B01BD MQTT2_DEVICE DVES_9B01BD
attr MQTT2_DVES_9B01BD IODev m2server
attr MQTT2_DVES_9B01BD readingList DVES_9B01BD:tele/sonoffkitchen/STATE:.* { json2nameValue($EVENT) }\
DVES_9B01BD:tele/sonoffkitchen/LWT:.* LWT\
DVES_9B01BD:cmnd/sonoffkitchen/POWER:.* POWER\
DVES_9B01BD:tele/sonoffkitchen/UPTIME:.* { json2nameValue($EVENT) }\
DVES_9B01BD:stat/sonoffkitchen/RESULT:.* { json2nameValue($EVENT) }\
DVES_9B01BD:stat/sonoffkitchen/POWER:.* POWER
attr MQTT2_DVES_9B01BD room MQTT2_DEVICE
attr MQTT2_DVES_9B01BD setList on cmnd/sonoff/POWER on\
off cmnd/sonoff/POWER off\
reboot cmnd/sonoff/Restart 1
attr MQTT2_DVES_9B01BD webCmd on:off:reboot

== Milight-Bridge ==
[[Bild:MQTT2 MiLight.png|400px|thumb|Darstellung in FHEMWEB]]
=== Vorbemerkung ===
Der [https://github.com/sidoh/esp8266_milight_hub esp8266_milight_hub] ist ein open source- Projekt, mit dem auf Basis von ''openmili'' eine Vielzahl von MiLight-Geräten gesteuert werden können. Der MiLight-Hub erstetzt dabei eine beliebige Zahl von Milight-Bridges und ist auch zu verschiedenen Versionen des MiLight-Protokols kompatibel.
Neben MQTT kann dieser auch mit HTTPMOD oder Wifilight (bzw. den MiLight-Modulen) gesteuert werden. Die Hardware entspriche dabei im Wesentlichen einem MySensors-Wifi-Gateway, es wird lediglich ein anderer CS-PIN genutzt, was allerdings in der Web-Oberfläche auch so umgestellt werden kann.
Hier wird vorausgesetzt, dass eine funktionierende Bridge vorhanden ist.
Der Vorteil der MQTT-Lösung liegt darin, dass man bei kompatiblen Fernbedienungen auch direkt Informationen über Schaltvorgänge erhält, die mit diesen ausgelöst werden.

=== Einstellungen am MiLight-Hub ===
Die zum FHEM-Server bzw. dem MQTT2_SERVER passenden Einstellungen sind im Web-Interface des Hub einzustellen. Um auch %-Werte für die Helligkeit zu erhalten, sollten diese ebenfalls als zu sendendes Element ausgewählt werden.

=== FHEM-Devices ===
==== Bridge ====
Danach wird ein zentrales "Bridge-Device" definiert, über das später alle Informationen aller MiLight-Kanäle laufen bzw. zurückgemeldet werden.
define Milight_Bridge MQTT2_DEVICE milight_hub_1370325
attr Milight_Bridge IODev MQTT2_FHEM_Server
attr Milight_Bridge readingList milight_hub_1370325:milight/updates/0xBE59/rgbw/0:.* { json2nameValue($EVENT) }\
milight_hub_1370325:milight/updates/0xBE59/rgbw/1:.* { json2nameValue($EVENT) }\
...
milight_hub_1370325:milight/states/0x..../rgb_cct/1:.* { json2nameValue($EVENT) }

==== Einzelne Leuchtmittel ====
Um dann einzelne Geräte für jedes Leuchtmittel bzw. jede zu schaltende Gruppe zu erhalten, kopiert man dann (am besten über die RAW-Definition) die relevanten Teile aus dem Bridge-Device. Beispiel:
define Licht_Essen MQTT2_DEVICE
attr Licht_Essen IODev MQTT2_FHEM_Server
attr Licht_Essen eventMap /set_white:Weiss/night_mode:Nacht/white_mode:white/on:on/off:off/ON:on/OFF:off/
attr Licht_Essen icon light_control
attr Licht_Essen readingList milight_hub_1370325:milight/states/0xBE59/rgbw/0:.* { json2nameValue($EVENT) }\
milight_hub_1370325:milight/states/0xBE59/rgbw/1:.* { json2nameValue($EVENT) }
attr Licht_Essen room Esszimmer
attr Licht_Essen setList on milight/0xBE59/rgbw/1 {"status":"ON"}\
off milight/0xBE59/rgbw/1 {"status":"OFF"}\
level:colorpicker,BRI,0,1,100 milight/0xBE59/rgbw/1 {"$EVTPART0":"$EVTPART1"}\
hue:colorpicker,HUE,0,1,359 milight/0xBE59/rgbw/1 {"$EVTPART0":"$EVTPART1"}\
command milight/0xBE59/rgbw/1 {"$EVTPART0":"$EVTPART1"}\
brightness milight/0xBE59/rgbw/1 {"$EVTPART0":"$EVTPART1"}\

attr Licht_Essen webCmd level:hue:command
attr Licht_Essen widgetOverride state command:uzsuSelectRadio,Weiss,Nacht

Indem man in der ''readingList'' sowohl den einzelnen Kanal wie die Gruppenadresse (''0'') angibt, erhält man auch Rückmeldungen über Schaltvorgänge, die die Gruppe betreffen.
Wer mag, kann dann noch ein Device anlegen, das nur den ''0''-Kanal abbildet; über dieses werden dann alle Leuchtmittel geschaltet, die zu der betreffenden Gruppenadresse gehören (im obigen Beispiel: 0xBE59).

Für ein dynamisches Icon kann derselbe code verwendet werden wir bei Tradfri beschrieben, dazu muss in der MQTT-Konfiguration des Milight-Hub auch "brightness" mit als zu sendendes Element eingestellt bleiben.

== Links ==
* {{Link2Forum|Topic=91394|LinkText=Thread, aus dem diese Anleitung ursprünglich entstanden ist}}
* {{Link2Forum|Topic=91807|LinkText=Thread zum Tasmota-Device}}

== Hinweise ==
<references />
[[Kategorie:HOWTOS]]
[[Kategorie:MQTT]]
[[Kategorie:Zigbee]]
[[Kategorie:IP Components|IP Komponenten]]
[[Kategorie:Other Components]]
[[Kategorie:Interfaces]]

Rock64

2018-06-14T16:10:39Z

Mark79:

Beim Rock64 handelt es sich um einen Einplatinencomputer von Pine64 [https://www.pine64.org/?page_id=7147] mit dem Rockchip RK3328 Quad-Core ARM Cortex A53 64-Bit Prozessor und wahlweise 1 GB, 2 GB, oder 4 GB LPDDR3 Ram Speicher. 
Das Board bietet 1x Gigabit LAN, 1x USB3, 2x USB2, eMMC-Modulsockel, 128Mb SPI Flash Speicher, MicroSD-Kartensteckplatz, native AES Verschlüsselung, Pi-2 Bus, Pi-P5+ Bus, IR Receiver 
 
Das Boardlayout ist von den Maßen baugleich mit dem Raspberry Pi 2-3. Allerdings hat das Rock64 eine runde Stromversorungsbuche, mit einer kleinen Modifikation können Gehäuse für den Raspberry 2-3, auch für den Rock64 verwendet werden. 
 
Ein Nachteil ist leider, das man kein HM-Funkmodul aufstecken kann. Der UART lässt sich nicht mit eigenen Treibern nutzen und ist fix auf 1.5MBaud eingestellt. 
Es empfiehlt sich daher das HM-Funkmodul per Seriellen USB Wandler, ESP8266, oder MapleCUN anzubinden. 
 
Zum Vergleich ist in der Tabelle, der (Rock64) und (Raspberry Pi 3b) aufgeführt. Die Tabelle soll nur einen Überblick darstellen und erhebt keinen Anspruch auf Vollständigkeit. 
{| class="wikitable zebra toptextcells" style="text-align:center"
! Eigenschaft !! Rock64 || Raspberry Pi '''3''' Model B
|-
| SOC || RK3328 || Broadcom BCM2837
|-
| ARM Cortex || A53 || A53
|-
| Takt || 4x 1.5 Ghz || 4x 1.2GHz
|-
| RAM || 1,2,4 Gbyte DDR 3 || 1Gbyte
|-
| Arbeitsspeicher || eMMC Slot 128Mb SPI Flash memory microSD || microSD
|-
| IR || Ja || Nein
|-
| Peripherie || 1x USB 3.0 Host 2x USB 2 Host (USB-OTG) Gigabit Ethernet HDMI 2.0a output up to 4K@60Hz 2x20 pins "Pi2" GPIO Header 2x11 pins "Pi P5+" GPIO Header (with 2nd 10/100Mbps Ethernet pins) || 4x USB 2 Host CSI camera port DSI display port Stereo Ausgang und Composite video Wifi+BT wireless 40-pin extended GPIO
|-
| Power || 5V 3A Stecker innen 1.35mm und außen 3.5mm (Type H Barrel type DC connector)|| 5V 2.5A micro USB
|-
| Preis ca. (Stand Dezember 2018) || ca 21-38€ || 38€
|-
|}

Das Rock64 Board gibt es in drei Versionen. Mit 1 GB, 2 GB oder 4 GB. 
 
__TOC__

== Vefügbare Betriebssysteme ==
[https://www.armbian.com/rock64/ Armbian Images (Empfohlen)] 
[https://dl.armbian.com/rock64/ Armbian DEV Images (Empfohlen)] 
[https://github.com/ayufan-rock64/linux-build ayufan Images] 
[http://wiki.pine64.org/index.php/ROCK64_Main_Page#CPU_Architecture weitere Rock64 Images] 

== Erste Inbetriebnahme ==
Als Betriebssystem eignet sich Armbian, oder die Ayufan Linux images. 
In diesem Artikel wird die Installation mit Armbian auf SD Karte mit Hilfe eines Windows PC beschrieben.

=== Download von Armbian und Vorbereitung der SD Karte ===
Von der obigen Image Auswahl kann ein Image heruntergeladen werden. Sofern der Rock64 hauptsächlich ohne Tastatur und Monitor betrieben wird, empfiehlt es sich sehr ein Headless Image zu verwenden.
Nach dem Auspacken unter Windows wird das Image mit dem Etcher Tool https://www.etcher.io/ auf die SD Karte geschrieben.
 
<syntaxhighlight lang=bash>
Die SD Karte in den Kartenleser am PC stecken, Etcher starten, das gewünschte Image auswählen, danach die Speicherkarte auswählen und zum Schluss wird mit "Flash!", der Flashvorgang gestartet.

Nach dem flashen die SD Karte in den Rock64 stecken.
Stromversorgung einschalten.
Warten bis Armbian das Dateisystem vorbereitet hat.
</syntaxhighlight>

=== Weiteres bearbeiten des Systems über SSH ===
Armbian kommt mit einem vorinstallierten SSH Server. Man sollte sich nach der installation über Putty mit dem System verbinden können.
<syntaxhighlight lang=bash>
username = root
password = 1234

Über den Befehl:
armbian-config
Hat man auf umfangreiche Einstellungen zugriff.
z.B.
Zeitzone einstellen
Router Verbindungen einstellen DHCP/Static etc.

</syntaxhighlight>

=== Update auf den neusten Kernel ===
Um gleich das System zu aktualisieren geht es gleich in der Bash weiter
<syntaxhighlight lang=bash>
apt-get update
apt-get dist-upgrade
</syntaxhighlight>

== Installation von FHEM ==
Die FHEM installation kann danach von der Bash aus gestartet werden.
Dazu über Putty Verbindung aufbauen und FHEM Installieren. Laut der FHEM for Debian Seite ist folgendes zu tun.
<syntaxhighlight lang=bash>
wget -qO - http://debian.fhem.de/archive.key | apt-key ad
</syntaxhighlight>

Zu der Datei /etc/apt/sources.list folgendes anfügen:
<syntaxhighlight lang=bash>
deb http://debian.fhem.de/nightly/ /
</syntaxhighlight>

danach
<syntaxhighlight lang=bash>
apt-get update
apt-get install fhem
reboot now
</syntaxhighlight>

Danach sollte FHEM unter eurer Rock64 IP erreichbar sein.
Als erstes in die FHEM Commandozeile folgendes eingeben
<syntaxhighlight lang=bash>
update all
</syntaxhighlight>

==Weitere Konfiguartion==
Zusätzlich zu der Grundinstallation lassen sich noch weitere Einstellungen vornhemen. Grundsätzlich sind alle Änderungen auch mit der Linux bash und apt-get etc. durchzuführen.

==Zusätzliche Perl Module==
Falls, je nach Nutzung von FHEM, noch zusätzliche FHEM Module installiert werden müssen konnte ich dies immer mit den Debian Paket Manager nach den Anleitungen aus dem FHEM Forum oder der WIKI für debian-jessie tun. 
Zum Beispiel
<syntaxhighlight lang=bash>
JSON
apt-get install libjson-perl

AES
apt-get install libcrypt-cbc-perl
apt-get install libcrypt-rijndael-perl
apt-get install libssl-dev
apt-get install make
apt-get install gcc
cpan Crypt/OpenSSL/AES.pm
</syntaxhighlight>
Einige Module sind schon vorhanden andere müssen eben wie gezeigt nachinstalliert werden.

==Links==
Link zum Rock64 [https://forum.pine64.org/ Pine64 Forum] 
Link zum Rock64 [https://wiki.pine64.org/ Pine64 Wiki] 
Link zum Armbian [https://forum.armbian.com/ Forum] 
Link zur [https://debian.fhem.de/ FHEM for Debian] Seite

[[Kategorie:Server Hardware]]

Rock64

2018-06-14T16:00:01Z

Mark79:

Beim Rock64 handelt es sich um einen Einplatinencomputer von Pine64 [https://www.pine64.org/?page_id=7147] mit dem Rockchip RK3328 Quad-Core ARM Cortex A53 64-Bit Prozessor und wahlweise 1 GB, 2 GB, oder 4 GB LPDDR3 Ram Speicher. 
Das Board bietet 1x Gigabit LAN, 1x USB3, 2x USB2, eMMC-Modulsockel, 128Mb SPI Flash Speicher, MicroSD-Kartensteckplatz, native AES Verschlüsselung, Pi-2 Bus, Pi-P5+ Bus, IR Receiver 
 
Das Boardlayout ist von den Maßen baugleich mit dem Raspberry Pi 2-3. Allerdings hat das Rock64 eine runde Stromversorungsbuche, mit einer kleinen Modifikation können Gehäuse für den Raspberry 2-3, auch für den Rock64 verwendet werden. 
 
Ein Nachteil ist leider, das man kein HM-Funkmodul aufstecken kann. Der UART lässt sich nicht mit eigenen Treibern nutzen und ist fix auf 1.5MBaud eingestellt. 
Es empfiehlt sich daher das HM-Funkmodul per Seriellen USB Wandler, ESP8266, oder MapleCUN anzubinden. 
 
Zum Vergleich ist in der Tabelle [[Rock64]] und [[Raspberry Pi 3b]] aufgeführt. Die Tabelle soll nur einen Überblick darstellen und erhebt keinen Anspruch auf Vollständigkeit. 
{| class="wikitable zebra toptextcells" style="text-align:center"
! Eigenschaft !! Rock64 || Raspberry Pi '''3''' Model B
|-
| SOC || RK3328 || Broadcom BCM2837
|-
| ARM Cortex || A53 || A53
|-
| Takt || 4x 1.5 Ghz || 4x 1.2GHz
|-
| RAM || 1,2,4 Gbyte DDR 3 || 1Gbyte
|-
| Arbeitsspeicher || eMMC Slot 128Mb SPI Flash memory microSD || microSD
|-
| IR || Ja || Nein
|-
| Peripherie || 1x USB 3.0 Host 2x USB 2 Host (USB-OTG) Gigabit Ethernet HDMI 2.0a output up to 4K@60Hz 2x20 pins "Pi2" GPIO Header 2x11 pins "Pi P5+" GPIO Header (with 2nd 10/100Mbps Ethernet pins) || 4x USB 2 Host CSI camera port DSI display port Stereo Ausgang und Composite video Wifi+BT wireless 40-pin extended GPIO
|-
| Power || 5V 3A Stecker innen 1.35mm und außen 3.5mm (Type H Barrel type DC connector)|| 5V 2.5A micro USB
|-
| Preis ca. (Stand Dezember 2018) || ca 21-38€ || 38€
|-
|}

Das Rock64 Board gibt es in drei Versionen. Mit 1 GB, 2 GB oder 4 GB. 
 
__TOC__

== Vefügbare Betriebssysteme ==
[https://www.armbian.com/rock64/ Armbian Images (Empfohlen)] 
[https://dl.armbian.com/rock64/ Armbian DEV Images (Empfohlen)] 
[https://github.com/ayufan-rock64/linux-build ayufan Images] 
[http://wiki.pine64.org/index.php/ROCK64_Main_Page#CPU_Architecture weitere Rock64 Images] 

== Erste Inbetriebnahme ==
Als Betriebssystem eignet sich Armbian, oder die Ayufan Linux images. 
In diesem Artikel wird die Installation mit Armbian auf SD Karte mit Hilfe eines Windows PC beschrieben.

=== Download von Armbian und Vorbereitung der SD Karte ===
Von der obigen Image Auswahl kann ein Image heruntergeladen werden. Sofern der Rock64 hauptsächlich ohne Tastatur und Monitor betrieben wird, empfiehlt es sich sehr ein Headless Image zu verwenden.
Nach dem Auspacken unter Windows wird das Image mit dem Etcher Tool https://www.etcher.io/ auf die SD Karte geschrieben.
 
<syntaxhighlight lang=bash>
Die SD Karte in den Kartenleser am PC stecken, Etcher starten, das gewünschte Image auswählen, danach die Speicherkarte auswählen und zum Schluss wird mit "Flash!", der Flashvorgang gestartet.

Nach dem flashen die SD Karte in den Rock64 stecken.
Stromversorgung einschalten.
Warten bis Armbian das Dateisystem vorbereitet hat.
</syntaxhighlight>

=== Weiteres bearbeiten des Systems über SSH ===
Armbian kommt mit einem vorinstallierten SSH Server. Man sollte sich nach der installation über Putty mit dem System verbinden können.
<syntaxhighlight lang=bash>
username = root
password = 1234

Über den Befehl:
armbian-config
Hat man auf umfangreiche Einstellungen zugriff.
z.B.
Zeitzone einstellen
Router Verbindungen einstellen DHCP/Static etc.

</syntaxhighlight>

=== Update auf den neusten Kernel ===
Um gleich das System zu aktualisieren geht es gleich in der Bash weiter
<syntaxhighlight lang=bash>
apt-get update
apt-get dist-upgrade
</syntaxhighlight>

== Installation von FHEM ==
Die FHEM installation kann danach von der Bash aus gestartet werden.
Dazu über Putty Verbindung aufbauen und FHEM Installieren. Laut der FHEM for Debian Seite ist folgendes zu tun.
<syntaxhighlight lang=bash>
wget -qO - http://debian.fhem.de/archive.key | apt-key ad
</syntaxhighlight>

Zu der Datei /etc/apt/sources.list folgendes anfügen:
<syntaxhighlight lang=bash>
deb http://debian.fhem.de/nightly/ /
</syntaxhighlight>

danach
<syntaxhighlight lang=bash>
apt-get update
apt-get install fhem
reboot now
</syntaxhighlight>

Danach sollte FHEM unter eurer Rock64 IP erreichbar sein.
Als erstes in die FHEM Commandozeile folgendes eingeben
<syntaxhighlight lang=bash>
update all
</syntaxhighlight>

==Weitere Konfiguartion==
Zusätzlich zu der Grundinstallation lassen sich noch weitere Einstellungen vornhemen. Grundsätzlich sind alle Änderungen auch mit der Linux bash und apt-get etc. durchzuführen.

==Zusätzliche Perl Module==
Falls, je nach Nutzung von FHEM, noch zusätzliche FHEM Module installiert werden müssen konnte ich dies immer mit den Debian Paket Manager nach den Anleitungen aus dem FHEM Forum oder der WIKI für debian-jessie tun. 
Zum Beispiel
<syntaxhighlight lang=bash>
JSON
apt-get install libjson-perl

AES
apt-get install libcrypt-cbc-perl
apt-get install libcrypt-rijndael-perl
apt-get install libssl-dev
apt-get install make
apt-get install gcc
cpan Crypt/OpenSSL/AES.pm
</syntaxhighlight>
Einige Module sind schon vorhanden andere müssen eben wie gezeigt nachinstalliert werden.

==Links==
Link zum Rock64 [https://forum.pine64.org/ Pine64 Forum] 
Link zum Rock64 [https://wiki.pine64.org/ Pine64 Wiki] 
Link zum Armbian [https://forum.armbian.com/ Forum] 
Link zur [https://debian.fhem.de/ FHEM for Debian] Seite

[[Kategorie:Server Hardware]]

Rock64

2018-06-14T15:58:44Z

Mark79: Die Seite wurde neu angelegt: „Beim Rock64 handelt es sich um einen Einplatinencomputer von Pine64 [https://www.pine64.org/?page_id=7147] mit dem Rockchip RK3328 Quad-Core ARM Cortex A53 64-…“

Beim Rock64 handelt es sich um einen Einplatinencomputer von Pine64 [https://www.pine64.org/?page_id=7147] mit dem Rockchip RK3328 Quad-Core ARM Cortex A53 64-Bit Prozessor und wahlweise 1 GB, 2 GB, oder 4 GB LPDDR3 Ram Speicher. 
Das Board bietet 1x Gigabit LAN, 1x USB3, 2x USB2, eMMC-Modulsockel, 128Mb SPI Flash Speicher, MicroSD-Kartensteckplatz, native AES Verschlüsselung, Pi-2 Bus, Pi-P5+ Bus, IR Receiver 
 
Das Boardlayout ist von den Maßen baugleich mit dem Raspberry Pi 2-3. Allerdings hat das Rock64 eine runde Stromversorungsbuche, mit einer kleinen Modifikation können Gehäuse für den Raspberry 2-3, auch für den Rock64 verwendet werden. 
 
Ein Nachteil ist leider, das man kein HM-Funkmodul aufstecken kann. Der UART lässt sich nicht mit eigenen Treibern nutzen und ist fix auf 1.5MBaud eingestellt. 
Es empfiehlt sich daher das HM-Funkmodul per Seriellen USB Wandler, ESP8266, oder MapleCUN anzubinden.
 
Zum Vergleich ist in der Tabelle [[Rock64]] und [[Raspberry Pi 3b]] aufgeführt. Die Tabelle soll nur einen Überblick darstellen und erhebt keinen Anspruch auf Vollständigkeit. 
 
{| class="wikitable zebra toptextcells" style="text-align:center"
! Eigenschaft !! Rock64 || Raspberry Pi '''3''' Model B
|-
| SOC || RK3328 || Broadcom BCM2837
|-
| ARM Cortex || A53 || A53
|-
| Takt || 4x 1.5 Ghz || 4x 1.2GHz
|-
| RAM || 1,2,4 Gbyte DDR 3 || 1Gbyte
|-
| Arbeitsspeicher || eMMC Slot 128Mb SPI Flash memory microSD || microSD
|-
| IR || Ja || Nein
|-
| Peripherie || 1x USB 3.0 Host 2x USB 2 Host (USB-OTG) Gigabit Ethernet HDMI 2.0a output up to 4K@60Hz 2x20 pins "Pi2" GPIO Header 2x11 pins "Pi P5+" GPIO Header (with 2nd 10/100Mbps Ethernet pins) || 4x USB 2 Host CSI camera port DSI display port Stereo Ausgang und Composite video Wifi+BT wireless 40-pin extended GPIO
|-
| Power || 5V 3A Stecker innen 1.35mm und außen 3.5mm (Type H Barrel type DC connector)|| 5V 2.5A micro USB
|-
| Preis ca. (Stand Dezember 2018) || ca 21-38€ || 38€
|-
|}

Das Rock64 Board gibt es in drei Versionen. Mit 1 GB, 2 GB oder 4 GB. 
 
__TOC__

== Vefügbare Betriebssysteme ==
[https://www.armbian.com/rock64/ Armbian Images (Empfohlen)] 
[https://dl.armbian.com/rock64/ Armbian DEV Images (Empfohlen)] 
[https://github.com/ayufan-rock64/linux-build ayufan Images] 
[http://wiki.pine64.org/index.php/ROCK64_Main_Page#CPU_Architecture weitere Rock64 Images] 

== Erste Inbetriebnahme ==
Als Betriebssystem eignet sich Armbian, oder die Ayufan Linux images. 
In diesem Artikel wird die Installation mit Armbian auf SD Karte mit Hilfe eines Windows PC beschrieben.

=== Download von Armbian und Vorbereitung der SD Karte ===
Von der obigen Image Auswahl kann ein Image heruntergeladen werden. Sofern der Rock64 hauptsächlich ohne Tastatur und Monitor betrieben wird, empfiehlt es sich sehr ein Headless Image zu verwenden.
Nach dem Auspacken unter Windows wird das Image mit dem Etcher Tool https://www.etcher.io/ auf die SD Karte geschrieben.
 
<syntaxhighlight lang=bash>
Die SD Karte in den Kartenleser am PC stecken, Etcher starten, das gewünschte Image auswählen, danach die Speicherkarte auswählen und zum Schluss wird mit "Flash!", der Flashvorgang gestartet.

Nach dem flashen die SD Karte in den Rock64 stecken.
Stromversorgung einschalten.
Warten bis Armbian das Dateisystem vorbereitet hat.
</syntaxhighlight>

=== Weiteres bearbeiten des Systems über SSH ===
Armbian kommt mit einem vorinstallierten SSH Server. Man sollte sich nach der installation über Putty mit dem System verbinden können.
<syntaxhighlight lang=bash>
username = root
password = 1234

Über den Befehl:
armbian-config
Hat man auf umfangreiche Einstellungen zugriff.
z.B.
Zeitzone einstellen
Router Verbindungen einstellen DHCP/Static etc.

</syntaxhighlight>

=== Update auf den neusten Kernel ===
Um gleich das System zu aktualisieren geht es gleich in der Bash weiter
<syntaxhighlight lang=bash>
apt-get update
apt-get dist-upgrade
</syntaxhighlight>

== Installation von FHEM ==
Die FHEM installation kann danach von der Bash aus gestartet werden.
Dazu über Putty Verbindung aufbauen und FHEM Installieren. Laut der FHEM for Debian Seite ist folgendes zu tun.
<syntaxhighlight lang=bash>
wget -qO - http://debian.fhem.de/archive.key | apt-key ad
</syntaxhighlight>

Zu der Datei /etc/apt/sources.list folgendes anfügen:
<syntaxhighlight lang=bash>
deb http://debian.fhem.de/nightly/ /
</syntaxhighlight>

danach
<syntaxhighlight lang=bash>
apt-get update
apt-get install fhem
reboot now
</syntaxhighlight>

Danach sollte FHEM unter eurer Rock64 IP erreichbar sein.
Als erstes in die FHEM Commandozeile folgendes eingeben
<syntaxhighlight lang=bash>
update all
</syntaxhighlight>

==Weitere Konfiguartion==
Zusätzlich zu der Grundinstallation lassen sich noch weitere Einstellungen vornhemen. Grundsätzlich sind alle Änderungen auch mit der Linux bash und apt-get etc. durchzuführen.

==Zusätzliche Perl Module==
Falls, je nach Nutzung von FHEM, noch zusätzliche FHEM Module installiert werden müssen konnte ich dies immer mit den Debian Paket Manager nach den Anleitungen aus dem FHEM Forum oder der WIKI für debian-jessie tun. 
Zum Beispiel
<syntaxhighlight lang=bash>
JSON
apt-get install libjson-perl

AES
apt-get install libcrypt-cbc-perl
apt-get install libcrypt-rijndael-perl
apt-get install libssl-dev
apt-get install make
apt-get install gcc
cpan Crypt/OpenSSL/AES.pm
</syntaxhighlight>
Einige Module sind schon vorhanden andere müssen eben wie gezeigt nachinstalliert werden.

==Links==
Link zum Rock64 [https://forum.pine64.org/ Pine64 Forum] 
Link zum Rock64 [https://wiki.pine64.org/ Pine64 Wiki] 
Link zum Armbian [https://forum.armbian.com/ Forum] 
Link zur [https://debian.fhem.de/ FHEM for Debian] Seite

[[Kategorie:Server Hardware]]