FHEMWiki - Benutzerbeiträge [de]

GardenaSmartBridge

2021-05-14T09:47:14Z

CoolTux: /* Define */

{{Infobox Modul
|ModPurpose=GardenaSmartBridge
|ModType=d
|ModForumArea=
|ModFTopic=75098
|ModTechName=73_GardenaSmartBridge.pm
|ModOwner={{Link2FU|13684|CoolTux}}
}}

Das Modul GardenaSmartBridge stellt zusammen mit dem Device [[GardenaSmartDevice]] die Kommunikation zwischen der '''Gardena Cloud''' und FHEM her.
Es können damit Rasenmäher, Bewässerungscomputer und Sensoren überwacht und gesteuert werden, die Steuerung erfolgt durch das Modul [[GardenaSmartDevice]].
''Informationen zum [[GardenaSmartSystem]]''

== Voraussetzungen ==
* Perl-Modul "SSL Packet"
* Internetanbinung
* Netzwerk mit W-Lan oder LAN (RJ45)
* Smart Gateway von Gardena
* Account bei https://developer.husqvarnagroup.cloud/ (alt: [https://sg-api.dss.husqvarnagroup.net/ Gardena])
* Smart Produkte von Gardena [[GardenaSmartSystem]]

== Anwendung ==
=== Define ===
<code> define <NAME> GardenaSmartBridge </code>

==== Beispiel ====
<code> define myGardenaBridge GardenaSmartBridge </code>

Diese Anweisung erstellt ein neues GardenaSmartBridge Device Namens myGardenaBridge.
Im folgendem wird automatisch ein neuer Raum ''GardenaSmart'' erstellt und nach setzen des Attributes gardenaAccountEmail und einem <code>set myGardenaBridge gardenaAccountPassword</code> alle dem [https://sg-api.dss.husqvarnagroup.net/ Gardena] Account bekannten Geräte
angelegt.

=== Attribute ===
* debugJSON -
* disable - aktivieren & deaktivieren der Bridge (0= aktiviert, 1= deaktiviert)
* interval - Abfrageinterval in Sekunden (300= default)
* gardenaAccountEmail - Email Adresse, die auch in der GardenaApp verwendet wurde

=== Readings ===

* address - bei Gardena verwendete Adresse
* city - bei Gardena hinterlegte Stadt
* devices - Anzahl der angelernten/verwendeten Geräte incl. des Gateways
* latitude - Längengrad
* longitude - Breitengrad
* name - Name des Gartens ''(Standard "MY GARDEN")''
* state - Status der Bridge (connect to cloud= Verbunden mit der Cloud)
* token - SessionID

== Anwendungsbeispiele ==

== Bekannte Probleme ==
* keine

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

[[Kategorie:Gerätemodul]]

NUKI

2021-01-20T16:28:09Z

CoolTux: Änderung für libjson-perl

<div style="float:right">
{{Infobox Modul
|ModPurpose=Einbindung der Nuki Bridge HW/APP
|ModType=d
|ModCmdRef=NUKIBridge
|ModForumArea=Sonstige Systeme
|ModTechName=73_NUKIBridge.pm
|ModOwner=CoolTux ({{Link2FU|13684|Forum}} / [[Benutzer:CoolTux|Wiki]])
}}
{{Infobox Modul
|ModPurpose=Steuern von Nuki Smartlocks über NUKIBridge
|ModType=d
|ModCmdRef=NUKIDevice
|ModForumArea=Sonstige Systeme
|ModTechName=73_NUKIDevice.pm
|ModOwner=CoolTux ({{Link2FU|13684|Forum}} / [[Benutzer:CoolTux|Wiki]])
}}
</div>

==NUKIBridge==
NUKIBridge - Steuert das Nuki Smartlock über die Nuki Bridge

Das Nuki Bridge Modul verbindet FHEM mit der Nuki Bridge und liest dann alle auf der Bridge verfügbaren Smartlocks ein. Desweiteren werden automatisch die erkannten Smartlocks als eigenständige Devices angelegt.

Für eine aktive Callback Funktion müssen noch zwei Attribute der Bridge eingerichtet werden:
* webhookFWinstance - zu verwendende Webinstanz (darf keine Passwortabfrage beinhalten)
* webhookHttpHostname - IP oder FQDN des FHEM Servers

Voraussetzung für ein fehlerfreies Laden ist die Installation von JSON (apt-get install libjson-perl).

===Definition===
:<code>define <name> NUKIBridge <HOST> <API-TOKEN></code>

'''Beispiel:'''
:<code>define NBridge1 NUKIBridge 192.168.0.23 F34HK6</code>

Diese Anweisung erstellt ein NUKIBridge Device mit Namen NBridge1 und der IP 192.168.0.23 sowie dem Token F34HK6. Nach dem Anlegen des Bridge Devices werden alle zur Verfügung stehende Smartlock automatisch in FHEM angelegt.

===Readings===
* 0_nukiId - ID des ersten gefundenen Nuki Smartlocks
* 0_name - Name des ersten gefunden Nuki Smartlocks
* smartlockCount - Anzahl aller gefundenen Smartlock
* bridgeAPI - API Version der Bridge
* bridgeType - Hardware oder Software/App Bridge
* currentTime - aktuelle Zeit auf der Bridge zum zeitpunkt des Info holens
* firmwareVersion - aktuell auf der Bridge verwendete Firmwareversion
* hardwareId - ID der Hardware Bridge
* lastError - gibt die letzte HTTP Errormeldung wieder
* serverConnected - true/false gibt an ob die Hardwarebridge Verbindung zur Nuki-Cloude hat.
* serverId - gibt die ID des Cloudeservers wieder
* uptime - Uptime der Bridge in Sekunden
* wifiFirmwareVersion- Firmwareversion des Wifi Modules der Bridge
* Die vorangestellte Zahl ist fortlaufend und gibt beginnend bei 0 die Eigenschaften eines Smartlocks wieder.

===Set===
* <s>autocreate - veranlasst ein erneutes Einlesen aller Smartlocks von der Bridge und falls noch nicht in FHEM vorhanden das automatische Anlegen.</s>
* callbackRemove - löschen einer Callback Instanz auf der Bridge. Die Instanz ID kann mittels get callbackList ermittelt werden
* clearLog - löscht das Logfile auf der Bridge
* fwUpdate - schaut nach einer neueren Firmware und installiert diese, sofern vorhanden
* info - holt aktuelle Informationen über die Bridge
* reboot - veranlasst einen reboot der Bridge

===Get===
* callbackList - gibt die Liste der eingetragenen Callback URLs wieder. Die Bridge nimmt maximal drei auf
* logFile - zeigt das Logfile der Bridge an

===Attribute===
* disable - deaktiviert die Nuki Bridge

==NUKIDevice==
NUKIDevice - Steuert das Nuki Smartlock

Das Nuki Modul verbindet FHEM über die Nuki Bridge mit einem Nuki Smartlock. Es ist dann möglich, das Schloss zu ver- und entriegeln. In der Regel werden die Nuki Devices automatisch durch das Bridgemodul angelegt.

===Definition===
:<code>define <name> NUKIDevice <Nuki-Id> <IODev-Device></code>

'''Beispiel:'''
:<code>define Haustuer NUKIDevice 1 NBridge1</code>

Diese Anweisung erstellt ein NUKIDevice mit Namen Haustuer, der NukiId 1 sowie dem IODev Device NBridge1. Nach dem Anlegen des Devices wird automatisch der aktuelle Zustand des Smartlocks aus der Bridge gelesen.
Damit das NUKIDevice auch Statusänderungen mitbekommt, die beispielsweise aus der nativen NUKI-App oder der manuellen Betätigung des Devices herrühren, ist es notwendig, die Attribute webhookFWinstance und webhookHttpHostname zu setzen.

:<code>attr Haustuer webhookFWinstance WEB (Name der FHEMWEB Instanz)</code>
:attr Haustuer webhookHttpHostname 192.168.0.1 (IP/FQDN vom FHEM Server)

Zum Überprüfen kann die Funktion
:<code>get NUKIBridge callbackList</code>
aufgerufen werden. Es sollte nur ein Callback eingetragen
sein, der in dieser Form hinterlegt sein sollte.
:<code><nowiki>0 http://192.168.0.1:8083/fhem/NUKIDevice-123456789</nowiki></code>

===Readings===
* state - Status des Smartlock bzw. Fehlermeldung von Fehler vorhanden.
* lockState - aktueller Schließstatus: uncalibrated, locked, unlocked, unlocked (lock ‘n’ go), unlatched, locking, unlocking, unlatching, motor blocked, undefined
* succes - true, false; gibt des Status des letzten Schließbefehles wieder. Geklappt oder nicht geklappt.
* batteryCritical - ist die Batterie in einem kritischen Zustand? true, false
* battery - Status der Batterie, ok, low

===Set===
* statusRequest - ruft den aktuellen Status des Smartlocks von der Bridge ab
* lock - verschließen
* unlock - aufschließen
* unlatch - entriegeln/Falle öffnen
* locknGo - verschließen wenn gegangen
* locknGoWithUnlatch - verschließen nachdem die Falle geöffnet wurde

===Attribute===
* disable - deaktiviert das Nuki Device
* webhookFWinstance - zu verwendene Webinstanz für den Callbackaufruf
* webhookHttpHostname - IP oder FQDN vom FHEM Server für den Callbackaufruf

== Links ==
* [https://nuki.io/de/ Webseite des Herstellers]

[[Kategorie:Türschlosssteuerung]]

UWZ

2019-03-10T20:52:46Z

CoolTux:

{{Infobox Modul
|ModPurpose=Daten von Unwetterzentrale.de holen
|ModType=d
|ModForumArea=Unterstützende Dienste/Wettermodule
|ModTechName=77_UWZ.pm
|ModOwner=Tdoe, CoolTux ({{Link2Forum|Topic=51233|LinkText=Forum}})
}}

Das Modul [[UWZ]] holt Informationen für eine zu spezifizierende Postleitzahl von der Seite [http://unwetterzentrale.de/ Unwetterzentrale.de] und bereitet sie für die Darstellung in FHEM auf.

== Voraussetzungen ==
{{Randnotiz|RNTyp=Fehl|RNText=Der Dienst wurde eingestellt, somit erhält das Modul keine Daten mehr und ist vorerst obsolet!!!
Diese Anleitung ist etwas in die Tage gekommen. Es hat viele Änderungen und Neuerungen gegeben. Die {{Link2CmdRef|Anker=UWZ}} ist aktuell und sollte eine gute Hilfestellung geben. Ansonsten bitte ins Forum schauen, ob hier bereits Lösungen zum Problem bestehen.

Die Wikiseite wird nach und nach aktualisiert. Wenn du dies liest und du dich mit dem Modul auskennst, bist du recht herzlich eingeladen, den Artikel zu aktualisieren. So bleibt uns (Entwicklern) mehr Zeit, um uns um das Modul zu kümmern und dies zu verbessern/erweitern.}}
Standardinstallation und eine Internetverbindung werden für das Funktionieren des Moduls benötigt.

== Installation ==
Das Modul wird als offizielles Modul per [[update]] verteilt und muss nicht extra installiert werden.

Falls nach dem "define" der Fehler "unable..." kommt und im Log "...Can't locate XML/Simple.pm in @INC (you may need to install the XML::Simple module)..." steht, so kommt man auf der Konsole mit der folgenden Installation weiter:

<code>cpan install XML::Simple</code>

Es geht auf der Konsole aber auch mit:

<code>apt-get install libxml-simple-perl</code>

== Anwendung ==
=== Define ===
Abhängig davon, ob man Unwetterwarnungen aus Deutschland oder einem anderen Land abfragen möchte, muss für das Attribut PLZ entweder die Postleitzahl (Deutschland) oder die AREA_ID (Rest der Welt) verwendet werden.

==== Deutschland ====
:<code><nowiki>define <name> UWZ <Ländercode> <PLZ> <INTERVAL> </nowiki></code>

==== Rest der Welt ====
:<code><nowiki>define <name> UWZ <Ländercode> <AREA_ID> <INTERVAL> </nowiki></code>

Die AREA_ID kann folgendermaßen ermittelt werden:

===== Geokoordinaten ermitteln =====
Dazu wird folgende URL aufgerufen, und am Ende der URL bei dem ''search'' Parameter der Name des Ortes eingegeben. Im Fall von Oberwaltersdorf AT:
:<code><nowiki>http://alertspro.geoservice.meteogroup.de/weatherpro/SearchFeed.php?search=oberwalt</nowiki></code>

Als Antwort bekommt man eine XML Struktur mit gefundenen Orten:
<pre>
<result>
<cities previousOffset="-1" nextOffset="-1">
<city country="49" city="8512" id="18226609" country-name="Germany" province-name="Bavaria" continent="6" inhabitants="7500" longitude="12.17092" latitude="48.57422" name="Oberwaltenkofen (Ergolding)" timezone="Europe/Berlin"/>
<city country="49" city="8671" id="18226768" country-name="Germany" province-name="Bavaria" continent="6" inhabitants="4000" longitude="12.51418" latitude="48.77301" name="Oberwalting (Leiblfing)" timezone="Europe/Berlin"/>
<city country="43" city="1161" id="18134912" country-name="Austria" province-name="Niederösterreich" continent="6" inhabitants="2500" longitude="16.3203" latitude="47.9756" name="Oberwaltersdorf" timezone="Europe/Vienna"/>
<city country="43" city="1305915" id="182199490" country-name="Austria" province-name="Niederösterreich" continent="6" inhabitants="150" longitude="15.0844" latitude="48.5394" name="Oberwaltenreith" timezone="Europe/Vienna"/>
</cities>
</result>
</pre>

Dort sucht man sich die beiden Attribute ''latitude'' und ''longitude'' für den passenden Ort heraus. Im verwendeten Beispiel wäre es für Oberwaltersdorf in Österreich:
:<code>latitude="47.9756" </code>
:<code>longitude="16.3203" </code>

===== AREA_ID abfragen =====
Mit diesen Werten wird nun die nächste URL zusammengebaut (Parameter ''lat'' + ''lon''):
:<code><nowiki> http://feed.alertspro.meteogroup.com/AlertsPro/AlertsProPollService.php?method=lookupCoord&lat=47.9756&lon=16.3203 </nowiki></code>

Das Resultat:
:<code><nowiki>[{"AREA_TYPE":"UWZ","AREA_ID":"UWZAT00234","CENTER_ID":"2"}] </nowiki></code>

Nun wissen wir, dass die AREA_ID für Oberwaltersdorf:
:<code>UWZAT00234 </code>
ist. Bei der Definition wird nun die Nummer ''00234'' anstelle der PLZ, und ''AT'' beim Ländercode verwendet:
:<code>define Unwetterzentrale UWZ AT 00234 3600 </code>

=== Attribute ===
Siehe Dokumentation.

== Anwendungsbeispiele ==
Zur Anzeige der Warnhinweise bietet das Modul vordefinierte Funktionen an, die in [[weblink|Weblinks]] benutzt werden können.


[[Datei:UWZAsHtmlFP.png|mini|right|400px|Warnmeldungen als reine Icons (Format ''UWZAsHtmlFP'') mit Teilen der Objektdetails]]
=== Anzeige der Warnhinweise nur als Icon ===
Die UWZ-Warnhinweise können über die Definition
:<code>define ''UnwetterFloorplan'' weblink htmlCode {UWZAsHtmlFP("''Unwetterzentrale''")}</code>
als reine Icons angezeigt werden. Diese Darstellung eignet sich besonders für die Einbindung in einen [[FLOORPLAN]].

Im gezeigten Beispiel ist ''Unwetterzentrale'' der Name des UWZ-Objekts und ''UnwetterDetailliert'' der Name des erzeugten weblink-Objekts.

 
[[Datei:UWZAsHtml.png|mini|right|400px|Warnmeldungen im Format ''UWZAsHtml'']]
=== Detaillierte Anzeige der Warnhinweise ===
Zur Anzeige der Warnhinweise in der ausführlichsten Form kann mit
:<code>define ''UnwetterDetailliert'' weblink htmlCode {UWZAsHtml("''Unwetterzentrale''")}</code>
ein weblink definiert werden.

Im gezeigten Beispiel ist ''Unwetterzentrale'' der Name des UWZ-Objekts und ''UnwetterDetailliert'' der Name des erzeugten weblink-Objekts.

=== Unwetterkarten ===
Auch diverse Unwetterkarten können eingebunden und gedownloadet werden.
Hierfür stehen eine Reihe von Karten zur Verfügung.
Mögliche Karten sind:
*europa

*deutschland
*deutschland-small
*bayern
*bremen
*baden-wuerttemberg
*brandenburg
*berlin
*hessen
*niedersachsen
*rheinland-pfalz
*saarland
*sachsen
*sachsen-anhalt
*thueringen
*nordrhein-westfalen
*mecklenburg-vorpommern
*schleswig-holstein
*hamburg

*oesterreich
*burgenland
*kaernten
*niederoesterreich
*oberoesterreich
*salzburg
*steiermark
*tirol
*vorarlberg
*wien

*schweiz
*aargau
*appenzell_ausserrhoden
*appenzell_innerrhoden
*basel_landschaft
*basel_stadt
*bern
*fribourg
*geneve
*glarus
*graubuenden
*jura
*luzern
*neuchatel
*nidwalden
*obwalden
*schaffhausen
*schwyz
*solothurn
*stgallen
*ticino
*thurgau
*uri
*waadt
*wallis
*zug
*zuerich

*liechtenstein

*belgique

*denmark

*finnland

*france

*letzebuerg

*nederland

*norwegen

*portugal

*sverige

*espana

*unitedkingdom
*eastofengland
*eastmidlands
*london
*northeastengland
*northernireland
*northwestengland
*scotland
*southeastengland
*southwestengland
*wales
*westmidlands
*yorkshireandthehumber

*isobaren1
*isobaren2
*isobaren3

==== Anzeige von Unwetterkarten ====
Dies erfolgt ebenfalls durch einem weblink.
:<code>define ''UnwetterKarteDeutschland'' weblink htmlCode {UWZAsHtmlKarteLand("''Unwetterzentrale''","''Deutschland''")}</code>

==== Download von Unwetterkarten ====
Um die Karten herunterzuladen um sie beispielsweise mit dem RSS Modul zu nutzen, muss dies am UWZ Device via Attribute konfiguriert werden.
Hierfür stehen folgende Attribute zur Verfügung:
*download [0|1]
*savepath (default:"/tmp/")
*maps (leerzeichen separierte Liste der zu speichernden Unwetterkarten)

:<code>attr ''Unwetterzentrale'' download 1</code>
:<code>attr ''Unwetterzentrale'' savepath /tmp/</code>
:<code>attr ''Unwetterzentrale'' maps deutschland europa bayern</code>

Die angegebenen Karten werden bei jedem Lauf erneut heruntergeladen und überschreiben das alte File.

==== Wetteranimation ====
Ab der Version 1.4.1 bietet das Modul auch die Möglichkeit diverse Wetteranimationen zu integrieren. Diese können ebenfalls mittels weblink genutzt werden.

Beispiel:
:<code>define ''UnwetterKarteMovie'' weblink htmlCode {UWZAsHtmlMovie("Unwetterzentrale","stroemung")}</code>

Der erste Parameter definiert das zugehörige UWZ Device.

Der zweite Parameter kann einer der folgenden sein:

*niederschlag-wolken
*stroemung
*temperatur

*niederschlag-wolken-de
*stroemung-de

*niederschlag-wolken-ch
*stroemung-ch

*niederschlag-wolken-at
*stroemung-at

*niederschlag-wolken-uk
*stroemung-uk

== Links ==
* [http://www.unwetterzentrale.de Unwetterzentrale] (für Deutschland)
* [http://unwetter.wetteralarm.at wetteralarm] (für Österreich)
* Geoservice [http://alertspro.geoservice.meteogroup.de/] zur Bestimmung von Geokoordinaten und Areacode
* Modulthread im Forum: {{Link2Forum|Topic=51233}}

UWZ

2019-03-10T20:45:40Z

CoolTux:

{{Infobox Modul
|ModPurpose=Daten von Unwetterzentrale.de holen
|ModType=d
|ModForumArea=Unterstützende Dienste/Wettermodule
|ModTechName=77_UWZ.pm
|ModOwner=Tdoe, CoolTux ({{Link2Forum|Topic=51233|LinkText=Forum}})
}}

Das Modul [[UWZ]] holt Informationen für eine zu spezifizierende Postleitzahl von der Seite [http://unwetterzentrale.de/ Unwetterzentrale.de] und bereitet sie für die Darstellung in FHEM auf.

== Voraussetzungen ==
{{Randnotiz|RNTyp=y|RNText=Der Dienst wurde eingestellt, somit erhält das Modul keine Daten mehr und ist vorerst obsolet!!! Diese Anleitung ist etwas in die Tage gekommen. Es hat viele Änderungen und Neuerungen gegeben. Die {{Link2CmdRef|Anker=UWZ}} ist aktuell und sollte eine gute Hilfestellung geben. Ansonsten bitte ins Forum schauen, ob hier bereits Lösungen zum Problem bestehen.

Die Wikiseite wird nach und nach aktualisiert. Wenn du dies liest und du dich mit dem Modul auskennst, bist du recht herzlich eingeladen, den Artikel zu aktualisieren. So bleibt uns (Entwicklern) mehr Zeit, um uns um das Modul zu kümmern und dies zu verbessern/erweitern.}}
Standardinstallation und eine Internetverbindung werden für das Funktionieren des Moduls benötigt.

== Installation ==
Das Modul wird als offizielles Modul per [[update]] verteilt und muss nicht extra installiert werden.

Falls nach dem "define" der Fehler "unable..." kommt und im Log "...Can't locate XML/Simple.pm in @INC (you may need to install the XML::Simple module)..." steht, so kommt man auf der Konsole mit der folgenden Installation weiter:

<code>cpan install XML::Simple</code>

Es geht auf der Konsole aber auch mit:

<code>apt-get install libxml-simple-perl</code>

== Anwendung ==
=== Define ===
Abhängig davon, ob man Unwetterwarnungen aus Deutschland oder einem anderen Land abfragen möchte, muss für das Attribut PLZ entweder die Postleitzahl (Deutschland) oder die AREA_ID (Rest der Welt) verwendet werden.

==== Deutschland ====
:<code><nowiki>define <name> UWZ <Ländercode> <PLZ> <INTERVAL> </nowiki></code>

==== Rest der Welt ====
:<code><nowiki>define <name> UWZ <Ländercode> <AREA_ID> <INTERVAL> </nowiki></code>

Die AREA_ID kann folgendermaßen ermittelt werden:

===== Geokoordinaten ermitteln =====
Dazu wird folgende URL aufgerufen, und am Ende der URL bei dem ''search'' Parameter der Name des Ortes eingegeben. Im Fall von Oberwaltersdorf AT:
:<code><nowiki>http://alertspro.geoservice.meteogroup.de/weatherpro/SearchFeed.php?search=oberwalt</nowiki></code>

Als Antwort bekommt man eine XML Struktur mit gefundenen Orten:
<pre>
<result>
<cities previousOffset="-1" nextOffset="-1">
<city country="49" city="8512" id="18226609" country-name="Germany" province-name="Bavaria" continent="6" inhabitants="7500" longitude="12.17092" latitude="48.57422" name="Oberwaltenkofen (Ergolding)" timezone="Europe/Berlin"/>
<city country="49" city="8671" id="18226768" country-name="Germany" province-name="Bavaria" continent="6" inhabitants="4000" longitude="12.51418" latitude="48.77301" name="Oberwalting (Leiblfing)" timezone="Europe/Berlin"/>
<city country="43" city="1161" id="18134912" country-name="Austria" province-name="Niederösterreich" continent="6" inhabitants="2500" longitude="16.3203" latitude="47.9756" name="Oberwaltersdorf" timezone="Europe/Vienna"/>
<city country="43" city="1305915" id="182199490" country-name="Austria" province-name="Niederösterreich" continent="6" inhabitants="150" longitude="15.0844" latitude="48.5394" name="Oberwaltenreith" timezone="Europe/Vienna"/>
</cities>
</result>
</pre>

Dort sucht man sich die beiden Attribute ''latitude'' und ''longitude'' für den passenden Ort heraus. Im verwendeten Beispiel wäre es für Oberwaltersdorf in Österreich:
:<code>latitude="47.9756" </code>
:<code>longitude="16.3203" </code>

===== AREA_ID abfragen =====
Mit diesen Werten wird nun die nächste URL zusammengebaut (Parameter ''lat'' + ''lon''):
:<code><nowiki> http://feed.alertspro.meteogroup.com/AlertsPro/AlertsProPollService.php?method=lookupCoord&lat=47.9756&lon=16.3203 </nowiki></code>

Das Resultat:
:<code><nowiki>[{"AREA_TYPE":"UWZ","AREA_ID":"UWZAT00234","CENTER_ID":"2"}] </nowiki></code>

Nun wissen wir, dass die AREA_ID für Oberwaltersdorf:
:<code>UWZAT00234 </code>
ist. Bei der Definition wird nun die Nummer ''00234'' anstelle der PLZ, und ''AT'' beim Ländercode verwendet:
:<code>define Unwetterzentrale UWZ AT 00234 3600 </code>

=== Attribute ===
Siehe Dokumentation.

== Anwendungsbeispiele ==
Zur Anzeige der Warnhinweise bietet das Modul vordefinierte Funktionen an, die in [[weblink|Weblinks]] benutzt werden können.


[[Datei:UWZAsHtmlFP.png|mini|right|400px|Warnmeldungen als reine Icons (Format ''UWZAsHtmlFP'') mit Teilen der Objektdetails]]
=== Anzeige der Warnhinweise nur als Icon ===
Die UWZ-Warnhinweise können über die Definition
:<code>define ''UnwetterFloorplan'' weblink htmlCode {UWZAsHtmlFP("''Unwetterzentrale''")}</code>
als reine Icons angezeigt werden. Diese Darstellung eignet sich besonders für die Einbindung in einen [[FLOORPLAN]].

Im gezeigten Beispiel ist ''Unwetterzentrale'' der Name des UWZ-Objekts und ''UnwetterDetailliert'' der Name des erzeugten weblink-Objekts.

 
[[Datei:UWZAsHtml.png|mini|right|400px|Warnmeldungen im Format ''UWZAsHtml'']]
=== Detaillierte Anzeige der Warnhinweise ===
Zur Anzeige der Warnhinweise in der ausführlichsten Form kann mit
:<code>define ''UnwetterDetailliert'' weblink htmlCode {UWZAsHtml("''Unwetterzentrale''")}</code>
ein weblink definiert werden.

Im gezeigten Beispiel ist ''Unwetterzentrale'' der Name des UWZ-Objekts und ''UnwetterDetailliert'' der Name des erzeugten weblink-Objekts.

=== Unwetterkarten ===
Auch diverse Unwetterkarten können eingebunden und gedownloadet werden.
Hierfür stehen eine Reihe von Karten zur Verfügung.
Mögliche Karten sind:
*europa

*deutschland
*deutschland-small
*bayern
*bremen
*baden-wuerttemberg
*brandenburg
*berlin
*hessen
*niedersachsen
*rheinland-pfalz
*saarland
*sachsen
*sachsen-anhalt
*thueringen
*nordrhein-westfalen
*mecklenburg-vorpommern
*schleswig-holstein
*hamburg

*oesterreich
*burgenland
*kaernten
*niederoesterreich
*oberoesterreich
*salzburg
*steiermark
*tirol
*vorarlberg
*wien

*schweiz
*aargau
*appenzell_ausserrhoden
*appenzell_innerrhoden
*basel_landschaft
*basel_stadt
*bern
*fribourg
*geneve
*glarus
*graubuenden
*jura
*luzern
*neuchatel
*nidwalden
*obwalden
*schaffhausen
*schwyz
*solothurn
*stgallen
*ticino
*thurgau
*uri
*waadt
*wallis
*zug
*zuerich

*liechtenstein

*belgique

*denmark

*finnland

*france

*letzebuerg

*nederland

*norwegen

*portugal

*sverige

*espana

*unitedkingdom
*eastofengland
*eastmidlands
*london
*northeastengland
*northernireland
*northwestengland
*scotland
*southeastengland
*southwestengland
*wales
*westmidlands
*yorkshireandthehumber

*isobaren1
*isobaren2
*isobaren3

==== Anzeige von Unwetterkarten ====
Dies erfolgt ebenfalls durch einem weblink.
:<code>define ''UnwetterKarteDeutschland'' weblink htmlCode {UWZAsHtmlKarteLand("''Unwetterzentrale''","''Deutschland''")}</code>

==== Download von Unwetterkarten ====
Um die Karten herunterzuladen um sie beispielsweise mit dem RSS Modul zu nutzen, muss dies am UWZ Device via Attribute konfiguriert werden.
Hierfür stehen folgende Attribute zur Verfügung:
*download [0|1]
*savepath (default:"/tmp/")
*maps (leerzeichen separierte Liste der zu speichernden Unwetterkarten)

:<code>attr ''Unwetterzentrale'' download 1</code>
:<code>attr ''Unwetterzentrale'' savepath /tmp/</code>
:<code>attr ''Unwetterzentrale'' maps deutschland europa bayern</code>

Die angegebenen Karten werden bei jedem Lauf erneut heruntergeladen und überschreiben das alte File.

==== Wetteranimation ====
Ab der Version 1.4.1 bietet das Modul auch die Möglichkeit diverse Wetteranimationen zu integrieren. Diese können ebenfalls mittels weblink genutzt werden.

Beispiel:
:<code>define ''UnwetterKarteMovie'' weblink htmlCode {UWZAsHtmlMovie("Unwetterzentrale","stroemung")}</code>

Der erste Parameter definiert das zugehörige UWZ Device.

Der zweite Parameter kann einer der folgenden sein:

*niederschlag-wolken
*stroemung
*temperatur

*niederschlag-wolken-de
*stroemung-de

*niederschlag-wolken-ch
*stroemung-ch

*niederschlag-wolken-at
*stroemung-at

*niederschlag-wolken-uk
*stroemung-uk

== Links ==
* [http://www.unwetterzentrale.de Unwetterzentrale] (für Deutschland)
* [http://unwetter.wetteralarm.at wetteralarm] (für Österreich)
* Geoservice [http://alertspro.geoservice.meteogroup.de/] zur Bestimmung von Geokoordinaten und Areacode
* Modulthread im Forum: {{Link2Forum|Topic=51233}}

AutoShuttersControl

2019-02-17T13:42:56Z

CoolTux: /* Attribute in den Rolllädendevices */

{{Baustelle}}
{{Infobox Modul
|ModPurpose=Steuerung von Rollläden
|ModCategory=Automatisierung
|ModType=d
|ModForumArea=Automatisierung
|ModTechName=73_AutoShuttersControl.pm
|ModOwner=CoolTux ({{Link2FU|13684|Forum}}/[[Benutzer Diskussion:CoolTux|Wiki]])}}

Mit [[AutoShuttersControl]] oder kurz ASC können typische Aufgabenstellungen im Zusammenhang mit Rollläden u.ä. automatisiert werden, wie zum Beispiel das Öffnen bei Sonnenaufgang, Schließen bei Sonnenuntergang oder das Anfahren von Lüftungspositionen beim Öffnen des zugehörigen Fensters.

{{Hinweis|Das Modul befindet sich derzeit noch in der Entwicklung; der jeweils aktuelle Stand ist diesem {{Link2Forum|Topic=90751|LinkText="Thread im Forum"}} zu entnehmen.}}

== Basics ==
Zur Nutzung des Moduls sollten folgende andere FHEM-Devices vorhanden sein:
* Rollläden
* Fensterkontakte und
* Bewohnerstatus auf Basis von Residents/Roomates in englisch. Ersatzweise andere Devices, z.B. Dummys, welche als ''state'' ''home'', ''asleep'', ''gotosleep'' und ''awoken'' setzen sowie ein Reading ''lastState''.
* Optional:
** Ein Helligkeitssensor (Steuerung nach Helligkeit und Beschattung)
** Ein Device zur Bestimmung des Sonnenstands (nur für Beschattungf). Unterstützt werden derzeit [[Astro]] und [[twilight]]<ref>Dabei müssen ggf. in [[global]] auch Angaben zu longitude und latitude vorhanden sein</ref>.
** Wenn Feiertage berücksichtigt werden sollen: Ein oder mehrere [[holiday2we]]-Angaben in [[global]] samt entsprechender [[holiday]]-Dateien<ref>Es kann auch z.B. ein Dummy-Device verwendet werden, dieses sollte dann aber auch in einem Reading ''tomorrow'' Angaben zu anstehenden Feiertagen enthalten.</ref> <ref>Bitte verfahren Sie entsprechend, wenn Urlaubs- oder Ferientage wie Feiertage behandelt werden sollen.</ref>.

Die Einrichtung des Moduls bzw. dessen Funktionalität erfolgt in mehreren Schritten:
* Definition des ASC-Devices
* Einstellung zentraler Vorgaben am ASC-Device
* Markieren der zukünftig zu steuernden Rollladen-Devices
* Einbinden der Rollladen-Devices in das ASC-Device
* Einstellen der individuellen Vorgaben je Rollladen (am Rollladen-Device)
Dabei geht man am einfachsten schrittweise vor und erweitert die Funktionalität nach und nach um die gewünschten Funktionen. Dann benötigt man jeweils nur einen kleinen Teil der vielen per Attribut einstellbaren Optionen, und kann die Auswirkungen der jeweiligen Änderung besser nachvollziehen.

== Einrichtung ==
{{Hinweis|ASC kann auch verwendet werden, um lediglich Teilaufgaben der Rollladensteuerung zu erfüllen, also z.B. nur das morgendliche Öffnen der Rollläden. Allerdings geht dabei ein erheblicher Teil des Komforts verloren, der dadurch entsteht, dass die Steuerung innerhalb der vollintegrierten Lösung jeweils nachvollzieht, aus welchem Grund eine Fahrt erfolgt war und dies ggf. bei der nächsten Aktion berücksichtigt.}}

=== Vorbereitung ===
Zunächst sollten die in den [[Basics]] beschriebenen Geräte vorhanden und funktionsfähig sein.

=== Define des ASC-Devices ===
Es genügt ein einfaches define ohne weitere Parameter.
<code>define <name> AutoShuttersControl</code>
Dies bewirkt neben der Anlage des Devices selbst auch, dass als weiteres globales Attribut ''ASC'' verfügbar wird.

=== Einstellung zentraler Vorgaben ===
Es stehen am ASC-Device einige Attribute zur Verfügung, über die sich das Verhalten des ASC-Devices insgesamt steuern lässt, z.B. zur Vermeidung von morgendlichen oder abendlichen Fahrten sowie bei Gefahr von Schäden an den Rollläden durch Frost oder zur Reaktion auf Fensterkontakte. Details sind der Commandref zu entnehmen.
Diese Attribute können auch nachträglich noch geändert werden.

=== Markieren zu steuernder Rollladen-Devices ===
Um einen oder mehrere Rollläden durch das ASC-Device zu steuern, wird für jeden Rollladen jeweils das neue globale Attribut ''ASC'' gesetzt. Der Wert ist mit 1 oder 2 festzulegen, wobei '''1''' bedeutet, dass
* die Offen-Position kleiner ist als die Geschlossen-Position, also typischerweise 0 ''offen'' bedeutet und 100 für ''geschlossen'' steht
* eine bestimmte Position mit '''position''' angefahren wird, also z.B. <code>set <name> position 70</code>.
Dies ist z.B. die passende Wahl für ROLLO-Devices

Die '''2''' steht für ein umgekehrtes Verhalten und den Befehlsteil ''pct'', also ''offen'' für <code>set <name> pct 100</code>. Typischer Vertreter dieses Typs sind HomeMatic (CUL_HM-) Geräte oder die Shelly2-Aktoren.

=== Einbinden in das ASC-Device ===
Nachdem man das obige Attribut bei einem oder mehreren Rollladen-Devices gesetzt hat, kann mit
<code>set <name> scanForShutters</code> ein Suchlauf gestartet werden, mit dem dann diese Rollläden durch das Modul gefunden und in die Steuerungslogik eingebunden werden.

=== Einstellen der individuellen Vorgaben ===
Nach der Einbindung sind an den Rollladen-Devices weitere Attribute verfügbar, mit denen die für den jeweiligen Rollladen geltenden Einstellungen vorgenommen werden können.
Die Beschreibung der Attribute ist in der commandref enthalten.

=== Einrichtungsbeispiel ===
==== Zielsetzung und Vorgaben ====
Es sollen alle Rollläden und Jalousien in einem Haus innerhalb bestimmter zeitlicher Grenzen Morgens und Abends sonnenstandsabhängig gefahren werden, an den Wochenenden und an Ferientagen soll etwas später geöffnet werden. Es sind Tür- und Fensterkontakte vorhanden (Türkontakte: twoState, Fensterkontakte: threeState), wobei bei jeder Öffnung ein eventuell geschlossener Rollladen geöffnet werden soll. Bei allen Rollladnaktoren, Tür- und Fensterkontakten handelt es sich um CUL_HM-Geräte.

==== Vorarbeiten ====
Im global-Device sind Angaben zu latitude und longitude vorhanden, holiday2we wie folgt<ref>ferien ist eine automatisiert erstellte holiday-Datei nach diesem Foren-Beitrag.</ref>:
attr global holiday2we bw,ferien
Weitere Angaben benötigen wir zunächst nicht, die Festlegung eines Astro-Devices erfolgt hier erst im Rahmen der Beschattung.
Dann erfolgt das ''Define des ASC-Devices'' wie oben beschrieben:
<code>define Rollladenautomatik AutoShuttersControl</code>
Folgen die einzubindenden Rollladenaktoren einem einheitlichen Namensschema, können diese sodann z.B. mit
attr (Jalousie|Rolladen)_.* ASC 2
auf einen Rutsch mit dem passenden ASC-Typ gekennzeichnet werden. Dann verteilen wir mir
set Rollladenautomatik scanForShutters
die nachfolgend weiter zu bearbeitenden Attribute.

===== Konfiguration des ASC-Devices =====
Da wir sonnenstandsabhängig Fahrzeiten wollen, legen wir erst einmal fest, dass dies morgens und abends berücksichtigt werden soll:
<pre>
attr Rollladenautomatik ASC_autoAstroModeEvening CIVIL
attr Rollladenautomatik ASC_autoAstroModeMorning CIVIL
attr Rollladenautomatik ASC_autoShuttersControlEvening on
attr Rollladenautomatik ASC_autoShuttersControlMorning on
</pre>
Aus der Angabe ''CIVIL'' und den Vorgaben in den einzelnen Rollladen wird dabei mit Hilfe von [[SUNRISE_EL]] die effektive Fahrzeit berechnet, dort finden sich auch weitere Hinweise, zu den meisten anderen Optionen für die ersten beiden Attribute.
Bei allen Fensteröffnungen soll auf Lüften-Position gefahren werden, also schalten wir diese Funktion ebenfalls zentral an<ref>Sonst wird bei threeState-Sensoren nur bei ''tilted'' gefahren.</ref>:
attr Rollladenautomatik ASC_autoShuttersControlComfort on

Zuletzt legen wir noch einen Temperatur-Sensor fest. Dieser wird beim Frostschutz sowie bei der Beschattung berücksichtigt.
<pre>
attr Rollladenautomatik ASC_temperatureSensor Aussentemperatur_Nord
attr Rollladenautomatik ASC_temperatureReading temperature
attr Rollladenautomatik ASC_freezeTemp 3
</pre>

tbd: Rain

===== Fahrzeiten =====
Zur Konfiguration der Fahrzeiten bietet es sich an, eine ReadingsGroup zu nutzen, wie unter [[Hilfsmittel]] dargestellt. Alternativ kann man die Zeiten auch manuell in den einzelnen Rollläden hinterlegen.

===== Fensterkontakte =====

== Readings ==

===Readings im ASC-Device selbst.===

{|class="wikitable"
|-
! Name !! Datentyp/ Wertebereich !! Bedeutung
|-
|..._nextAstroTimeEvent || ||Uhrzeit des nächsten Astro-Events, Sonnenauf- oder Sonnenuntergang oder feste Zeit pro Rollonamen
|-
|..._lastPosValue || ||zuletzt abgesetzter Fahrbefehl pro Rollonamen
|-
|..._lastDelayPosValue || ||zuletzt abgesetzter Fahrbefehl, welcher beim nächsten zulässigen Event ausgeführt wird
|-
|partyMode ||on, off || aktiviert den globalen Partymodus. Alle Rollläden, welche das Attribut ''AutoShuttersControl_Partymode'' bei sich auf ''on'' gestellt haben, werden nicht mehr gesteuert. Der letzte Schaltbefehl, welcher durch ein Fensterevent oder Bewohnerstatus an die Rollläden gesendet wurde, wird erst beim off-setzen (set <ASC-Device> partyMode off) ausgeführt
|-
|lockOut || on, off ||für das Aktivieren des Aussperrschutzes gemäß des entsprechenden Attributs ''AutoShuttersControl_lock-out'' im jeweiligen Rolladen (siehe Beschreibung bei den Attributen für die Rolladendevices)
|-
|room_... || ||Auflistung aller Rollläden, welche in den jeweiligen Räumen gefunden wurden, Bsp.: room_Schlafzimmer,Terrasse
|-
|state || ||Status des <ASC-Device> active, enabled, disabled
|-
|sunriseTimeWeHoliday|| on,off ||legt fest, ob das Rolladendevice das Attribut ''AutoShuttersControl_Time_Up_WE_Holiday'' beachtet oder nicht
|-
|userAttrList || rolled out ||Status der UserAttribute, welche an die Rollläden gesendet werden
|}

===Readings in den Rolllädendevices===

{|class="wikitable"
|-
! Name !! Bedeutung
|-
|ASC_Time_DriveUp ||Sonnenaufgangszeit für das Rollo
|-
|ASC_Time_DriveDown ||Sonnenuntergangszeit für das Rollo
|-
|ASC_ShuttersLastDrive ||Grund des letzten Fahrens vom Rolladen
|}

== Settings ==

===Set Befehle für ASC-Device===

{|class="wikitable"
|-
! Name !! Datentyp/ Wertebereich !! Beschreibung
|-
|partyMode ||on, off ||aktiviert den globalen Partymodus. Siehe Reading ''partyMode''
|-
|lockOut ||on, off ||aktiviert den globalen Aussperrschutz. Siehe Reading ''lockOut''
|-
|renewSetSunriseSunsetTimer || || erneuert bei allen Rollläden die Zeiten für Sunset und Sunrise und setzt die internen Timer neu.
|-
|scanForShutters || ||sucht alle FHEM Devices mit dem Attribut ''AutoShuttersControl'' ''1'' oder ''2''
|-
|sunriseTimeWeHoliday || on,off ||aktiviert/deaktiviert die Beachtung des Attributes ''AutoShuttersControl_Time_Up_WE_Holiday'' für Rollladen-Devices
|-
|createNewNotifyDev || ||Legt die interne Struktur für NOTIFYDEV neu an
|-
|selfDefence ||on, off||aktiviert/deaktiviert den Selbstschutz: wenn das Residents-Device ''absent'' meldet, ''selfDefence'' aktiv ist und ein Fenster im Haus noch offen steht, wird an diesem Fenster das Rollo runtergefahren
|-
|wiggle ||||bewegt einen Rollladen oder alle Rollläden (für Abschreckungszwecke bei der Alarmierung) um ''ASC_WiggleValue''-%, und nach 1 Minute wieder zurück zur Ursprungsposition
|-
|||||
|}

== Get ==

{|class="wikitable"
|-
! Name !! Beschreibung
|-
| showShuttersInformations ||zeigt eine Übersicht der Automatik-Fahrzeiten
|-
| showNotifyDevsInformations ||zeigt eine Übersicht der abgelegten NOTIFYDEV Struktur. Dient zur Kontrolle
|}
== Attribute ==

===Attribute im AutoShuttersControl Device selbst.===

{|class="wikitable"
|-
! Name !! Datentyp/ Wertebereich !! Default-Wert !! Beschreibung
|-
|ASC_antifreezeTemp || || ||Temperatur, ab welcher der Frostschutz greift und das Rollo nicht mehr fährt. Der letzte Fahrbefehl wird gespeichert
|-
|ASC_autoAstroModeEvening ||aktuell REAL, CIVIL, NAUTIC, ASTRONOMIC || || (in genau dieser Schreibweise)
|-
|ASC_autoAstroModeEveningHorizon || || || Höhe über Horizont, wenn beim Attribut ''AutoShuttersControl_autoAstroModeEvening'' ''HORIZON'' ausgewählt
|-
|ASC_autoAstroModeMorning ||aktuell REAL, CIVIL, NAUTIC, ASTRONOMIC || ||(in genau dieser Schreibweise)
|-
|ASC_autoAstroModeMorningHorizon || || ||Höhe über Horizont, wenn beim Attribut ''AutoShuttersControl_autoAstroModeMorning'' ''HORIZON'' ausgewählt
|-
|ASC_autoShuttersControlComfort ||on, off || ||aktiviert die Komfortfunktion. Bedeutet, dass ein Rollladen mit einem threestate (Drehgriff-) Sensor am Fenster beim Öffnen in die "Komfortposition" fährt. Diese wird beim Rollladendevice über das Attribut ''AutoShuttersControl_Pos_after_ComfortOpen'' eingestellt.
|-
|ASC_autoShuttersControlEvening ||on, off || ||ob Abends die Rollläden automatisch zeitgesteuert werden sollen
|-
|ASC_autoShuttersControlMorning ||on, off || ||ob Morgens die Rollläden automatisch zeitgesteuert werden sollen
|-
|ASC_temperatureReading || || ||Reading für die Außentemperatur
|-
|ASC_temperatureSensor || || ||Device für die Außentemperatur
|-
|ASC_timeUpHolidayDevice || || ||Device zur Urlaubserkennung oder Sonstiges / muss ''0'' oder ''1'' im Reading ''state'' beinhalten.
|-
|ASC_residentsDevice|| || ||Devicenamen des Residents-Device der obersten Ebene
|-
|ASC_residentsDeviceReading|| || ||Status Reading des Residents-Device der obersten Ebene
|-
|ASC_brightnessMinVal|| || ||minimaler Lichtwert, bei dem Schaltbedingungen noch geprüft werden sollen
|-
|ASC_brightnessMaxVal || || ||maximaler Lichtwert, bei dem Schaltbedingungen noch geprüft werden sollen
|-
|ASC_rainSensorDevice || || ||Device, welches bei Regen getriggert wird
|-
|ASC_rainSensorReading || || ||das ensprechende Reading zum Regendevice
|-
|ASC_rainSensorShuttersClosedPos || || ||Position in pct, welche der Rollladen bei Regen anfahren soll
|-
|ASC_shuttersDriveOffset || || ||maximale zufällige Verzögerung in Sekunden bei der Berechnung der Fahrzeiten, ''0'' bedeutet keine Verzögerung
|-
|ASC_twilightDevice || || ||Device, welches Informationen zum Sonnenstand liefert, wird unter anderem für die Beschattung verwendet.
|-
|ASC_expert || || ||bei ''1'' werden erweiterte Informationen bezüglich des NotifyDevs unter ''set'' und ''get'' angezeigt
|-
| || || ||
|-
| || || ||
|}

===Attribute in den Rolllädendevices===

{|class="wikitable"
|-
! Name !! Datentyp/ Wertebereich !! Default-Wert !! Beschreibung
|-
|ASC || 0, 1, 2|| ||0 = "kein Anlegen der Attribute beim ersten Scan bzw. keine Beachtung eines Fahrbefehles",1 = "Inverse oder Rollo - Bsp.: Rollo Oben 0, Rollo Unten 100 und der Befehl zum prozentualen Fahren ist position",2 = "Homematic Style - Bsp.: Rollo Oben 100, Rollo Unten 0 und der Befehl zum prozentualen Fahren ist pct
|-
|ASC_Antifreeze || soft, am, pm, hard, off|| ||Frostschutz, wenn ''soft'' fährt der Rollladen in die ''ASC_Antifreeze_Pos'', bei ''hard/am/pm'' wird gar nicht oder innerhalb der entsprechenden Tageszeit nicht gefahren
|-
|ASC_Antifreeze_Pos || || ||Position, die angefahren werden soll, wenn der Fahrbefehl komplett schließen lautet, aber der Frostschutz aktiv ist
|-
|ASC_AutoAstroModeEvening ||REAL, CIVIL, NAUTIC, ASTRONOMIC|| ||aktuell REAL,CIVIL,NAUTIC,ASTRONOMIC
|-
|ASC_AutoAstroModeEveningHorizon || || ||Höhe über Horizont, wenn beim Attribut ''ASC_autoAstroModeEvening'' ''HORIZON'' ausgewählt ist
|-
|ASC_AutoAstroModeMorning ||REAL, CIVIL, NAUTIC, ASTRONOMIC|| ||aktuell REAL,CIVIL,NAUTIC,ASTRONOMIC
|-
|ASC_AutoAstroModeMorningHorizon || || ||Höhe über Horizont, wenn beim Attribut ''ASC_autoAstroModeMorning'' ''HORIZON'' ausgewählt ist
|-
|ASC_Closed_Pos || || ||in 10er Schritten von 0 bis 100,default Vorgabe ist abhängig vom Attribut ''ASC''
|-
|ASC_Down || astro, time, brightness || ||bei ''astro'' wird Sonnenuntergang berechnet, bei ''time'' wird der Wert aus ''ASC_Time_Down_Early'' als Fahrzeit verwendet und bei ''brightness'' muss ''ASC_Time_Down_Early'' und ''ASC_Time_Down_Late'' korrekt gesetzt werden. Der Timer läuft dann nach ''ASC_Time_Down_Late''-Zeit,es wird aber in der Zeit zwischen ''ASC_Time_Down_Early'' und ''ASC_Time_Down_Late'' geschaut, ob die als Attribut im Moduldevice hinterlegte ''ASC_brightnessMinVal'' erreicht wurde. Wenn ja, wird der Rolladen runter gefahren
|-
|ASC_Mode_Down ||always, home, absent, off || ||wann darf die Automatik herunterfahren. immer, niemals oder bei Abwesenheit des Roommate (ist kein Roommate und ''absent'' eingestellt, wird gar nicht gesteuert)
|-
|ASC_Mode_Up ||always, home, absent, off || ||wann darf die Automatik hochfahren. immer, niemals oder bei Abwesenheit des Roommate (ist kein Roommate und ''absent'' eingestellt, wird gar nicht gesteuert)
|-
|ASC_Drive_Offset || || ||maximale zufällige Verzögerung in Sekunden bei der Berechnung der Fahrzeiten, ''0'' bedeutet sofort, ''-1'' bedeutet, dass das gleichwertige Attribut aus dem ASC-Device ausgewertet werden soll
|-
|ASC_Open_Pos || || ||in 10er-Schritten von 0 bis 100, default Vorgabe ist abhängig vom Attribut ''ASC''
|-
|ASC_Partymode || on, off || ||schaltet den Partymodus an oder aus. Wird dann am ASC Device ''set <ASC-DEVICE> partyMode on'' geschaltet, werden alle Fahrbefehle an den Rollläden, welche das Attribut auf ''on'' haben, zwischengespeichert und erst später ausgeführt
|-
|ASC_Pos_Reading || || ||Name des Readings, welches die Position des Rollladen in Prozent angibt. Wird bei unbekannten Device-Typen auch als ''set'' Befehl zum Fahren verwendet
|-
|ASC_Pos_after_ComfortOpen || || ||in 10er-Schritten von 0 bis 100, default Vorgabe ist abhängig vom Attribut ''ASC''
|-
|ASC_Roommate_Reading || || ||Reading des Roommate-Device, welches den Status wieder gibt
|-
|ASC_Roommate_Device || || ||mit Komma getrennte Namen des/der Roommate-Device/s welche den/die Bewohner des Rollladen-Raumes wiedergibt. Macht nur Sinn in Schlaf- oder Kinderzimmern
|-
|ASC_Time_Down_Early || || ||Sunset früheste Zeit zum Runterfahren
|-
|ASC_Time_Down_Late || || ||Sunset späteste Zeit zum Runterfahren
|-
|ASC_Time_Up_Early || || ||Sunrise früheste Zeit zum Hochfahren
|-
|ASC_Time_Up_Late || || ||Sunrise späteste Zeit zum Hochfahren
|-
|ASC_Time_Up_WE_Holiday || || ||Sunrise früheste Zeit zum Hochfahren am Wochenende und/oder Urlaub (holiday2we wird beachtet).
|-
|ASC_Up || astro, time, brightness || ||bei ''astro'' wird Sonnenaufgang berechnet, bei ''time'' wird der Wert aus ''ASC_Time_Up_Early'' als Fahrzeit verwendet und bei ''brightness'' müssen ''ASC_Time_Up_Early'' und ''ASC_Time_Up_Late'' korrekt gesetzt werden. Der Timer läuft dann nach ''ASC_Time_Up_Late''-Zeit, es wird aber in der Zeit zwischen ''ASC_Time_Up_Early'' und ''ASC_Time_Up_Late'' geschaut, ob die als Attribut im Moduldevice hinterlegte ''ASC_brightnessMinVal'' erreicht wurde. Wenn ja, wird der Rolladen runter gefahren
|-
|ASC_Ventilate_Pos || || ||in 10er-Schritten von 0 bis 100, default Vorgabe ist abhängig vom Attribut ''ASC''
|-
|ASC_Ventilate_Window_Open || || ||auf lüften, wenn das Fenster gekippt/geöffnet wird und aktuelle Position unterhalb der Lüften-Position ist
|-
|ASC_WindowRec || || ||Name des Fensterkontakts, an welchen Fenster der Rollladen angebracht ist. Sein Reading ''state'' muss die Werte ''open'', ''closed'' oder ''tilted'' enthalten.
|-
|ASC_WindowRec_subType || || ||Typ des verwendeten Fensterkontakts: ''twostate'' (optisch oder magnetisch) oder ''threestate'' (Drehgriffkontakt)
|-
|ASC_lock-out || soft, hard || ||stellt entsprechend den Aussperrschutz ein. Bei global aktiven Aussperrschutz (''set ASC-Device lockOut soft'') und einem Fensterkontakt ''open'' bleibt dann der Rolladen oben. Dies gilt nur bei Steuerbefehle über das ASC-Modul. Stellt man global auf ''hard'', wird bei entsprechender Möglichkeit versucht, den Rollladen hardwareseitig zu blockieren. Dann ist auch ein Fahren über die Taster nicht mehr möglich.
|-
|ASC_lock-outCmd || inhibit, blocked || ||set Befehl für das Rolladen-Device zum Sperren per Hardware. Der Befehl wird verwendet, wenn ''ASC_lock-out'' auf ''hard'' gesetzt ist
|-
|ASC_Self_Defense_Exclude || on, off || ||bei ''on'' wird dieser Rolladen bei aktiven ''selfDefence'' und offenen Fenster nicht runter gefahren, wenn Residents absent ist
|-
|ASC_Shading_Brightness_Sensor || || ||Sensor-Device, welches für die Lichtwerte verwendet wird. ACHTUNG! Findet auch Verwendung bei ASC_Down - brightness
|-
|ASC_BrightnessMinVal || || ||minimaler Lichtwert, bei dem Schaltbedingungen noch geprüft werden sollen / wird der Wert von ''-1'' nicht geändert, so wird automatisch der Wert aus dem Moduldevice genommen
|-
|ASC_BrightnessMaxVal || || ||maximaler Lichtwert, bei dem Schaltbedingungen noch geprüft werden sollen / wird der Wert von ''-1'' nicht geändert, so wird automatisch der Wert aus dem Moduldevice genommen
|-
|ASC_ShuttersPlace || window, terrace || ||wenn dieses Attribut auf ''terrace'' gesetzt ist und das Residents-Device in den Status ''gone'' geht und ''selfDefence'' aktiv ist, wird das Rollo geschlossen
|-
|ASC_WiggleValue || || ||Wert, um welchen sich die Position des Rollladens bei ''Wiggle'' ändern soll
|-
| || || ||
|-
| || || ||
|-
| || || ||
|-
| || || ||
|-
| || || ||
|-
| || || ||
|-
| || || ||
|}

== Hilfsmittel Allgemein==
Achtung: Die Device-Namen sind auf die entsprechende Konfiguration des einzelnen Anzupassen.

=== Hilfsmittel Übersicht ===

define ASC_Jalousie_Info weblink htmlCode {AutoShuttersControl::GetShuttersInformation($defs{'JalousieControl'})}

[[Datei:ASC Overview.JPG|600px|]]

== Hilfsmittel Reading Group für Homematic Devices==
readingsGroup, um die diversen Level einzustellen

Erfolgreich getestet mit Homematic Devices, Stand 2019-01-28 no_Legend

Achtung: Codezeilen wurden aus der Config Datei kopiert.

[[Datei:RG AutoShuttersControl Homematic.png|600px|]]

define rg_ASC_Rollaeden_Level readingsGroup <Gerät>,<ASC>,<Antifreeze>,<Antifreeze_Pos>,<Closed_Pos>,<Open_Pos>,<ASC_Ventilate_Pos> \
(.*Rollladen.*|.*Rollladen|Jalousie_.*):?ASC,?ASC_Antifreeze,?ASC_Antifreeze_Pos,?ASC_Closed_Pos,?ASC_Open_Pos,?ASC_Ventilate_Pos
setuuid rg_ASC_Rollaeden_Level 5c4308e1-f33f-abd1-167d-cc1b5f137cf793c8
attr rg_ASC_Rollaeden_Level commands {ASC => 'ASC:0,1,2',\
ASC_Antifreeze => 'ASC_Antifreeze:off,soft,hard,am,pm',\
ASC_Antifreeze_Pos =>'ASC_Antifreeze_Pos:0,10,20,30,35,40,45,50,55,60,65,70,75,80,85,90,95,100', \
ASC_Closed_Pos => 'ASC_Closed_Pos:0,10,20,30,35,40,45,50,55,60,65,70,75,80,85,90,95,100', \
ASC_Open_Pos => 'ASC_Open_Pos:0,10,20,30,35,40,45,50,55,60,65,70,75,80,85,90,95,100', \
ASC_Ventilate_Pos => 'ASC_Ventilate_Pos:0,10,20,30,35,40,45,50,55,60,65,70,75,80,85,90,95,100'}
attr rg_ASC_Rollaeden_Level room 9.72_Rolladen

define rg_ASC_Rollaeden_Times readingsGroup <Gerät>,<Position>,<Time_Up_Early>,<Time_Up_Late>,<Time_Up_WE/Hol>,<Time_Down_Early>,<Time_Down_Late>,<Mode_Down>,<Mode_Up> \
(.*Rollladen.*|.*Rollladen|Jalousie_.*):level,?ASC_Time_Up_Early,?ASC_Time_Up_Late,?ASC_Time_Up_WE_Holiday,?ASC_Time_Down_Early,?ASC_Time_Down_Late,?ASC_Mode_Down,?ASC_Mode_Up
setuuid rg_ASC_Rollaeden_Times 5c4308e1-f33f-abd1-94a7-fbf717635760f863
attr rg_ASC_Rollaeden_Times commands {level => 'pct:0,10,20,30,35,40,45,50,55,60,65,70,75,80,85,90,95,100', \
ASC_Time_Down_Early => 'ASC_Time_Down_Early:15:00,15:15,15:30,15:45,16:00,16:15,16:30,16:45,17:00,17:15,17:30,17:45,18:00,18:15,18:30,18:45,19:00,19:15,19:30,19:45,20:00,20:15,20:30,20:45,21:00,21:15,21:30,21:45,22:00', \
ASC_Time_Down_Late => 'ASC_Time_Down_Late:19:00,19:15,19:30,19:45,20:00,20:15,20:30,20:45,21:00,21:15,21:30,21:45,22:00,22:15,22:30,22:45,23:00,23:15,23:30', \
ASC_Time_Up_WE_Holiday => 'ASC_Time_Up_WE_Holiday:06:00,06:15,06:30,06:45,07:00,07:15,07:30,07:45,08:00,08:15,08:30,08:45,09:00,09:15,09:30,09:45,10:00',\
ASC_Time_Up_Early => 'ASC_Time_Up_Early:05:00,05:05,05:30,05:45,06:00,06:15,06:30,06:45,07:00,07:15,07:30,07:45,08:00,08:15,08:30,08:45,09:00,09:15,09:30,09:45,10:00', \
ASC_Time_Up_Late => 'ASC_Time_Up_Late:06:00,06:15,06:30,06:45,07:00,07:15,07:30,07:45,08:00,08:15,08:30,08:45,09:00,09:15,09:30,09:45,10:00', \
ASC_Mode_Down => 'ASC_Mode_Down:always,absent,off', \
ASC_Mode_Up => 'ASC_Mode_Up:always,absent,off' }
attr rg_ASC_Rollaeden_Times room 9.72_Rolladen

=== Hilfsmittel Reading Group für FIBARO Roller Shutter FGR-222 Devices===

Getestet von majestro84 https://forum.fhem.de/index.php/topic,92628.msg897099.html#msg897099

Stand 2019-01-28

[[Datei:ASC Jalousien Level.JPG|600px|]]

[[Datei:ASC Jalousien Times.JPG|600px|]]

define ASC_Jalousien_Times readingsGroup <Gerät>,<Stand>,<Time_Up_Early>,<Time_Up_WE>,<Time_Up_Late>,<Time_Down_Early>,<Time_Down_Late>,<Mode_Down>,<Mode_Up>,<PartyMode>,<LockOut> (.*_Jalousie.*):position,?ASC_Time_Up_Early,?ASC_Time_Up_WE_Holiday,?ASC_Time_Up_Late,?ASC_Time_Down_Early,?ASC_Time_Down_Late,?ASC_Mode_Down,?ASC_Mode_Up,?ASC_Partymode,?ASC_LockOut
attr ASC_Jalousien_Times commands {position => 'dim:0,10,20,30,35,40,45,50,55,60,65,70,75,80,85,90,95,99',
ASC_Mode_Down => 'ASC_Mode_Down:always,absent,off',
ASC_Mode_Up => 'ASC_Mode_Up:always,absent,off',
ASC_Partymode => 'ASC_Partymode:on,off',
ASC_LockOut => 'ASC_LockOut:soft,hard,off',
ASC_Time_Down_Early => 'ASC_Time_Down_Early:15:00,15:15,15:30,15:45,16:00,16:15,16:30,16:45,17:00,17:15,17:30,17:45,18:00,18:15,18:30,18:45,19:00,19:15,19:30,19:45,20:00,20:15,20:30,20:45,21:00,21:15,21:30,21:45,22:00',
ASC_Time_Down_Late => 'ASC_Time_Down_Late:20:15,20:30,20:45,21:00,21:15,21:30,21:45,22:00,22:15,22:30,22:45,23:00,23:15,23:30',
ASC_Time_Up_Early => 'ASC_Time_Up_Early:05:00,05:05,05:30,05:45,06:00,06:15,06:30,06:45,07:00,07:15,07:30,07:45,08:00,08:15,08:30,08:45,09:00,09:15,09:30,09:45,10:00',
ASC_Time_Up_Late =>'ASC_Time_Up_Late:06:00,06:15,06:30,06:45,07:00,07:15,07:30,07:45,08:00,08:15,08:30,08:45,09:00,09:15,09:30,09:45,10:00',
ASC_Time_Up_WE_Holiday => 'ASC_Time_Up_WE_Holiday:06:00,06:15,06:30,06:45,07:00,07:15,07:30,07:45,08:00,08:15,08:30,08:45,09:00,09:15,09:30,09:45,10:00'}
attr ASC_Jalousien_Times room Jalousien

define Jalousien_Level readingsGroup <Gerät>,<Closed_Pos>,<Open_Pos>,<Comfort_Pos>,<Ventilate_Pos>,<PrivacyDown_Pos>,<Shading_Pos> (.*_Jalousie.*):?ASC_Closed_Pos,?ASC_Open_Pos,?ASC_ComfortOpen_Pos,?ASC_Ventilate_Pos,?ASC_PrivacyDown_Pos,?ASC_Shading_Pos
attr Jalousien_Level commands { ASC_Closed_Pos => 'ASC_Closed_Pos:0,10,20,30,35,40,45,50,55,60,65,70,75,80,85,90,95,99',
ASC_Open_Pos => 'ASC_Open_Pos:0,10,20,30,35,40,45,50,55,60,65,70,75,80,85,90,95,99',
ASC_ComfortOpen_Pos => 'ASC_ComfortOpen_Pos:0,10,20,30,35,40,45,50,55,60,65,70,75,80,85,90,95,99',
ASC_Ventilate_Pos => 'ASC_Ventilate_Pos:0,10,20,30,35,40,45,50,55,60,65,70,75,80,85,90,95,99',
ASC_PrivacyDown_Pos => 'ASC_PrivacyDown_Pos:0,10,20,30,35,40,45,50,55,60,65,70,75,80,85,90,95,99',
ASC_Shading_Pos => 'ASC_Shading_Pos:0,10,20,30,35,40,45,50,55,60,65,70,75,80,85,90,95,99'}
attr Jalousien_Level room Jalousien

=== Hilfsmittel ===
tbd

readingsGroup, um die diversen Level einzustellen:

define rg_ASC_Rollaeden_Level readingsGroup <Gerät>,<Closed_Pos>,<Open_Pos>,<Shading_Pos>,<Ventilate_Pos> (Rolladen_.*|Jalousie_.*)..:?ASC_Closed_Pos,?ASC_Open_Pos,?ASC_Shading_Pos,?ASC_Ventilate_Pos
attr rg_ASC_Rollaeden_Level commands { ASC_Closed_Pos => 'ASC_Closed_Pos:0,10,20,30,35,40,45,50,55,60,65,70,75,80,85,90,95,100',\
ASC_Open_Pos => 'ASC_Open_Pos:0,10,20,30,35,40,45,50,55,60,65,70,75,80,85,90,95,100',\
ASC_Shading_Pos => 'ASC_Shading_Pos:0,10,20,30,35,40,45,50,55,60,65,70,75,80,85,90,95,100',\
ASC_Ventilate_Pos => 'ASC_Ventilate_Pos:0,10,20,30,35,40,45,50,55,60,65,70,75,80,85,90,95,100'}
[[Datei:ReadingsGroup ASC Level.png|600px|]]
readingsGroup, um die diversen Zeiten einzustellen:

define rg_ASC_Rollaeden_Times readingsGroup <Gerät>,<Stand>,<Time_Up_Early>,<Time_Up_WE>,<Time_Up_Late>,<Time_Down_Early>,<Time_Down_Late>,<Mode_Down>,<Mode_Up> (Rolladen_.*|Jalousie_.*)..:level,?ASC_Time_Up_Early,?ASC_Time_Up_WE_Holiday,?ASC_Time_Up_Late,?ASC_Time_Down_Early,?ASC_Time_Down_Late,?ASC_Mode_Down,?ASC_Mode_Up
attr rg_ASC_Rollaeden_Times commands {level => 'pct:0,10,20,30,35,40,45,50,55,60,65,70,75,80,85,90,95,100', \
ASC_Mode_Down => 'ASC_Mode_Down:always,absent,off',\
ASC_Mode_Up => 'ASC_Mode_Up:always,absent,off',\
ASC_Time_Down_Early => 'ASC_Time_Down_Early:15:00,15:15,15:30,15:45,16:00,16:15,16:30,16:45,17:00,17:15,17:30,17:45,18:00,18:15,18:30,18:45,19:00,19:15,19:30,19:45,20:00,20:15,20:30,20:45,21:00,21:15,21:30,21:45,22:00', \
ASC_Time_Down_Late => 'ASC_Time_Down_Late:20:15,20:30,20:45,21:00,21:15,21:30,21:45,22:00,22:15,22:30,22:45,23:00,23:15,23:30',\
ASC_Time_Up_Early => 'ASC_Time_Up_Early:05:00,05:05,05:30,05:45,06:00,06:15,06:30,06:45,07:00,07:15,07:30,07:45,08:00,08:15,08:30,08:45,09:00,09:15,09:30,09:45,10:00', \
ASC_Time_Up_Late =>'ASC_Time_Up_Late:06:00,06:15,06:30,06:45,07:00,07:15,07:30,07:45,08:00,08:15,08:30,08:45,09:00,09:15,09:30,09:45,10:00',ASC_Time_Up_WE_Holiday => 'ASC_Time_Up_WE_Holiday:06:00,06:15,06:30,06:45,07:00,07:15,07:30,07:45,08:00,08:15,08:30,08:45,09:00,09:15,09:30,09:45,10:00'}
[[Datei:ReadingsGroup ASC Times.png|600px|]]

== Weblinks ==
* {{Link2Forum|Topic=92628|LinkText="Thread zum Modul im Forum"}}
* {{Link2Forum|Topic=90751|LinkText="Thread zur Entwicklung im Forum"}}
* {{Link2Forum|Topic=73964|LinkText="Thread zu den Scripten von user cluni"}}, die der Entwicklung des Moduls zugrunde liegen

[[Kategorie:Code Snippets]]
[[Kategorie:Rollladensteuerung]]

AutoShuttersControl

2019-02-17T13:41:12Z

CoolTux: /* Attribute in den Rolllädendevices */

{{Baustelle}}
{{Infobox Modul
|ModPurpose=Steuerung von Rollläden
|ModCategory=Automatisierung
|ModType=d
|ModForumArea=Automatisierung
|ModTechName=73_AutoShuttersControl.pm
|ModOwner=CoolTux ({{Link2FU|13684|Forum}}/[[Benutzer Diskussion:CoolTux|Wiki]])}}

Mit [[AutoShuttersControl]] oder kurz ASC können typische Aufgabenstellungen im Zusammenhang mit Rollläden u.ä. automatisiert werden, wie zum Beispiel das Öffnen bei Sonnenaufgang, Schließen bei Sonnenuntergang oder das Anfahren von Lüftungspositionen beim Öffnen des zugehörigen Fensters.

{{Hinweis|Das Modul befindet sich derzeit noch in der Entwicklung; der jeweils aktuelle Stand ist diesem {{Link2Forum|Topic=90751|LinkText="Thread im Forum"}} zu entnehmen.}}

== Basics ==
Zur Nutzung des Moduls sollten folgende andere FHEM-Devices vorhanden sein:
* Rollläden
* Fensterkontakte und
* Bewohnerstatus auf Basis von Residents/Roomates in englisch. Ersatzweise andere Devices, z.B. Dummys, welche als ''state'' ''home'', ''asleep'', ''gotosleep'' und ''awoken'' setzen sowie ein Reading ''lastState''.
* Optional:
** Ein Helligkeitssensor (Steuerung nach Helligkeit und Beschattung)
** Ein Device zur Bestimmung des Sonnenstands (nur für Beschattungf). Unterstützt werden derzeit [[Astro]] und [[twilight]]<ref>Dabei müssen ggf. in [[global]] auch Angaben zu longitude und latitude vorhanden sein</ref>.
** Wenn Feiertage berücksichtigt werden sollen: Ein oder mehrere [[holiday2we]]-Angaben in [[global]] samt entsprechender [[holiday]]-Dateien<ref>Es kann auch z.B. ein Dummy-Device verwendet werden, dieses sollte dann aber auch in einem Reading ''tomorrow'' Angaben zu anstehenden Feiertagen enthalten.</ref> <ref>Bitte verfahren Sie entsprechend, wenn Urlaubs- oder Ferientage wie Feiertage behandelt werden sollen.</ref>.

Die Einrichtung des Moduls bzw. dessen Funktionalität erfolgt in mehreren Schritten:
* Definition des ASC-Devices
* Einstellung zentraler Vorgaben am ASC-Device
* Markieren der zukünftig zu steuernden Rollladen-Devices
* Einbinden der Rollladen-Devices in das ASC-Device
* Einstellen der individuellen Vorgaben je Rollladen (am Rollladen-Device)
Dabei geht man am einfachsten schrittweise vor und erweitert die Funktionalität nach und nach um die gewünschten Funktionen. Dann benötigt man jeweils nur einen kleinen Teil der vielen per Attribut einstellbaren Optionen, und kann die Auswirkungen der jeweiligen Änderung besser nachvollziehen.

== Einrichtung ==
{{Hinweis|ASC kann auch verwendet werden, um lediglich Teilaufgaben der Rollladensteuerung zu erfüllen, also z.B. nur das morgendliche Öffnen der Rollläden. Allerdings geht dabei ein erheblicher Teil des Komforts verloren, der dadurch entsteht, dass die Steuerung innerhalb der vollintegrierten Lösung jeweils nachvollzieht, aus welchem Grund eine Fahrt erfolgt war und dies ggf. bei der nächsten Aktion berücksichtigt.}}

=== Vorbereitung ===
Zunächst sollten die in den [[Basics]] beschriebenen Geräte vorhanden und funktionsfähig sein.

=== Define des ASC-Devices ===
Es genügt ein einfaches define ohne weitere Parameter.
<code>define <name> AutoShuttersControl</code>
Dies bewirkt neben der Anlage des Devices selbst auch, dass als weiteres globales Attribut ''ASC'' verfügbar wird.

=== Einstellung zentraler Vorgaben ===
Es stehen am ASC-Device einige Attribute zur Verfügung, über die sich das Verhalten des ASC-Devices insgesamt steuern lässt, z.B. zur Vermeidung von morgendlichen oder abendlichen Fahrten sowie bei Gefahr von Schäden an den Rollläden durch Frost oder zur Reaktion auf Fensterkontakte. Details sind der Commandref zu entnehmen.
Diese Attribute können auch nachträglich noch geändert werden.

=== Markieren zu steuernder Rollladen-Devices ===
Um einen oder mehrere Rollläden durch das ASC-Device zu steuern, wird für jeden Rollladen jeweils das neue globale Attribut ''ASC'' gesetzt. Der Wert ist mit 1 oder 2 festzulegen, wobei '''1''' bedeutet, dass
* die Offen-Position kleiner ist als die Geschlossen-Position, also typischerweise 0 ''offen'' bedeutet und 100 für ''geschlossen'' steht
* eine bestimmte Position mit '''position''' angefahren wird, also z.B. <code>set <name> position 70</code>.
Dies ist z.B. die passende Wahl für ROLLO-Devices

Die '''2''' steht für ein umgekehrtes Verhalten und den Befehlsteil ''pct'', also ''offen'' für <code>set <name> pct 100</code>. Typischer Vertreter dieses Typs sind HomeMatic (CUL_HM-) Geräte oder die Shelly2-Aktoren.

=== Einbinden in das ASC-Device ===
Nachdem man das obige Attribut bei einem oder mehreren Rollladen-Devices gesetzt hat, kann mit
<code>set <name> scanForShutters</code> ein Suchlauf gestartet werden, mit dem dann diese Rollläden durch das Modul gefunden und in die Steuerungslogik eingebunden werden.

=== Einstellen der individuellen Vorgaben ===
Nach der Einbindung sind an den Rollladen-Devices weitere Attribute verfügbar, mit denen die für den jeweiligen Rollladen geltenden Einstellungen vorgenommen werden können.
Die Beschreibung der Attribute ist in der commandref enthalten.

=== Einrichtungsbeispiel ===
==== Zielsetzung und Vorgaben ====
Es sollen alle Rollläden und Jalousien in einem Haus innerhalb bestimmter zeitlicher Grenzen Morgens und Abends sonnenstandsabhängig gefahren werden, an den Wochenenden und an Ferientagen soll etwas später geöffnet werden. Es sind Tür- und Fensterkontakte vorhanden (Türkontakte: twoState, Fensterkontakte: threeState), wobei bei jeder Öffnung ein eventuell geschlossener Rollladen geöffnet werden soll. Bei allen Rollladnaktoren, Tür- und Fensterkontakten handelt es sich um CUL_HM-Geräte.

==== Vorarbeiten ====
Im global-Device sind Angaben zu latitude und longitude vorhanden, holiday2we wie folgt<ref>ferien ist eine automatisiert erstellte holiday-Datei nach diesem Foren-Beitrag.</ref>:
attr global holiday2we bw,ferien
Weitere Angaben benötigen wir zunächst nicht, die Festlegung eines Astro-Devices erfolgt hier erst im Rahmen der Beschattung.
Dann erfolgt das ''Define des ASC-Devices'' wie oben beschrieben:
<code>define Rollladenautomatik AutoShuttersControl</code>
Folgen die einzubindenden Rollladenaktoren einem einheitlichen Namensschema, können diese sodann z.B. mit
attr (Jalousie|Rolladen)_.* ASC 2
auf einen Rutsch mit dem passenden ASC-Typ gekennzeichnet werden. Dann verteilen wir mir
set Rollladenautomatik scanForShutters
die nachfolgend weiter zu bearbeitenden Attribute.

===== Konfiguration des ASC-Devices =====
Da wir sonnenstandsabhängig Fahrzeiten wollen, legen wir erst einmal fest, dass dies morgens und abends berücksichtigt werden soll:
<pre>
attr Rollladenautomatik ASC_autoAstroModeEvening CIVIL
attr Rollladenautomatik ASC_autoAstroModeMorning CIVIL
attr Rollladenautomatik ASC_autoShuttersControlEvening on
attr Rollladenautomatik ASC_autoShuttersControlMorning on
</pre>
Aus der Angabe ''CIVIL'' und den Vorgaben in den einzelnen Rollladen wird dabei mit Hilfe von [[SUNRISE_EL]] die effektive Fahrzeit berechnet, dort finden sich auch weitere Hinweise, zu den meisten anderen Optionen für die ersten beiden Attribute.
Bei allen Fensteröffnungen soll auf Lüften-Position gefahren werden, also schalten wir diese Funktion ebenfalls zentral an<ref>Sonst wird bei threeState-Sensoren nur bei ''tilted'' gefahren.</ref>:
attr Rollladenautomatik ASC_autoShuttersControlComfort on

Zuletzt legen wir noch einen Temperatur-Sensor fest. Dieser wird beim Frostschutz sowie bei der Beschattung berücksichtigt.
<pre>
attr Rollladenautomatik ASC_temperatureSensor Aussentemperatur_Nord
attr Rollladenautomatik ASC_temperatureReading temperature
attr Rollladenautomatik ASC_freezeTemp 3
</pre>

tbd: Rain

===== Fahrzeiten =====
Zur Konfiguration der Fahrzeiten bietet es sich an, eine ReadingsGroup zu nutzen, wie unter [[Hilfsmittel]] dargestellt. Alternativ kann man die Zeiten auch manuell in den einzelnen Rollläden hinterlegen.

===== Fensterkontakte =====

== Readings ==

===Readings im ASC-Device selbst.===

{|class="wikitable"
|-
! Name !! Datentyp/ Wertebereich !! Bedeutung
|-
|..._nextAstroTimeEvent || ||Uhrzeit des nächsten Astro-Events, Sonnenauf- oder Sonnenuntergang oder feste Zeit pro Rollonamen
|-
|..._lastPosValue || ||zuletzt abgesetzter Fahrbefehl pro Rollonamen
|-
|..._lastDelayPosValue || ||zuletzt abgesetzter Fahrbefehl, welcher beim nächsten zulässigen Event ausgeführt wird
|-
|partyMode ||on, off || aktiviert den globalen Partymodus. Alle Rollläden, welche das Attribut ''AutoShuttersControl_Partymode'' bei sich auf ''on'' gestellt haben, werden nicht mehr gesteuert. Der letzte Schaltbefehl, welcher durch ein Fensterevent oder Bewohnerstatus an die Rollläden gesendet wurde, wird erst beim off-setzen (set <ASC-Device> partyMode off) ausgeführt
|-
|lockOut || on, off ||für das Aktivieren des Aussperrschutzes gemäß des entsprechenden Attributs ''AutoShuttersControl_lock-out'' im jeweiligen Rolladen (siehe Beschreibung bei den Attributen für die Rolladendevices)
|-
|room_... || ||Auflistung aller Rollläden, welche in den jeweiligen Räumen gefunden wurden, Bsp.: room_Schlafzimmer,Terrasse
|-
|state || ||Status des <ASC-Device> active, enabled, disabled
|-
|sunriseTimeWeHoliday|| on,off ||legt fest, ob das Rolladendevice das Attribut ''AutoShuttersControl_Time_Up_WE_Holiday'' beachtet oder nicht
|-
|userAttrList || rolled out ||Status der UserAttribute, welche an die Rollläden gesendet werden
|}

===Readings in den Rolllädendevices===

{|class="wikitable"
|-
! Name !! Bedeutung
|-
|ASC_Time_DriveUp ||Sonnenaufgangszeit für das Rollo
|-
|ASC_Time_DriveDown ||Sonnenuntergangszeit für das Rollo
|-
|ASC_ShuttersLastDrive ||Grund des letzten Fahrens vom Rolladen
|}

== Settings ==

===Set Befehle für ASC-Device===

{|class="wikitable"
|-
! Name !! Datentyp/ Wertebereich !! Beschreibung
|-
|partyMode ||on, off ||aktiviert den globalen Partymodus. Siehe Reading ''partyMode''
|-
|lockOut ||on, off ||aktiviert den globalen Aussperrschutz. Siehe Reading ''lockOut''
|-
|renewSetSunriseSunsetTimer || || erneuert bei allen Rollläden die Zeiten für Sunset und Sunrise und setzt die internen Timer neu.
|-
|scanForShutters || ||sucht alle FHEM Devices mit dem Attribut ''AutoShuttersControl'' ''1'' oder ''2''
|-
|sunriseTimeWeHoliday || on,off ||aktiviert/deaktiviert die Beachtung des Attributes ''AutoShuttersControl_Time_Up_WE_Holiday'' für Rollladen-Devices
|-
|createNewNotifyDev || ||Legt die interne Struktur für NOTIFYDEV neu an
|-
|selfDefence ||on, off||aktiviert/deaktiviert den Selbstschutz: wenn das Residents-Device ''absent'' meldet, ''selfDefence'' aktiv ist und ein Fenster im Haus noch offen steht, wird an diesem Fenster das Rollo runtergefahren
|-
|wiggle ||||bewegt einen Rollladen oder alle Rollläden (für Abschreckungszwecke bei der Alarmierung) um ''ASC_WiggleValue''-%, und nach 1 Minute wieder zurück zur Ursprungsposition
|-
|||||
|}

== Get ==

{|class="wikitable"
|-
! Name !! Beschreibung
|-
| showShuttersInformations ||zeigt eine Übersicht der Automatik-Fahrzeiten
|-
| showNotifyDevsInformations ||zeigt eine Übersicht der abgelegten NOTIFYDEV Struktur. Dient zur Kontrolle
|}
== Attribute ==

===Attribute im AutoShuttersControl Device selbst.===

{|class="wikitable"
|-
! Name !! Datentyp/ Wertebereich !! Default-Wert !! Beschreibung
|-
|ASC_antifreezeTemp || || ||Temperatur, ab welcher der Frostschutz greift und das Rollo nicht mehr fährt. Der letzte Fahrbefehl wird gespeichert
|-
|ASC_autoAstroModeEvening ||aktuell REAL, CIVIL, NAUTIC, ASTRONOMIC || || (in genau dieser Schreibweise)
|-
|ASC_autoAstroModeEveningHorizon || || || Höhe über Horizont, wenn beim Attribut ''AutoShuttersControl_autoAstroModeEvening'' ''HORIZON'' ausgewählt
|-
|ASC_autoAstroModeMorning ||aktuell REAL, CIVIL, NAUTIC, ASTRONOMIC || ||(in genau dieser Schreibweise)
|-
|ASC_autoAstroModeMorningHorizon || || ||Höhe über Horizont, wenn beim Attribut ''AutoShuttersControl_autoAstroModeMorning'' ''HORIZON'' ausgewählt
|-
|ASC_autoShuttersControlComfort ||on, off || ||aktiviert die Komfortfunktion. Bedeutet, dass ein Rollladen mit einem threestate (Drehgriff-) Sensor am Fenster beim Öffnen in die "Komfortposition" fährt. Diese wird beim Rollladendevice über das Attribut ''AutoShuttersControl_Pos_after_ComfortOpen'' eingestellt.
|-
|ASC_autoShuttersControlEvening ||on, off || ||ob Abends die Rollläden automatisch zeitgesteuert werden sollen
|-
|ASC_autoShuttersControlMorning ||on, off || ||ob Morgens die Rollläden automatisch zeitgesteuert werden sollen
|-
|ASC_temperatureReading || || ||Reading für die Außentemperatur
|-
|ASC_temperatureSensor || || ||Device für die Außentemperatur
|-
|ASC_timeUpHolidayDevice || || ||Device zur Urlaubserkennung oder Sonstiges / muss ''0'' oder ''1'' im Reading ''state'' beinhalten.
|-
|ASC_residentsDevice|| || ||Devicenamen des Residents-Device der obersten Ebene
|-
|ASC_residentsDeviceReading|| || ||Status Reading des Residents-Device der obersten Ebene
|-
|ASC_brightnessMinVal|| || ||minimaler Lichtwert, bei dem Schaltbedingungen noch geprüft werden sollen
|-
|ASC_brightnessMaxVal || || ||maximaler Lichtwert, bei dem Schaltbedingungen noch geprüft werden sollen
|-
|ASC_rainSensorDevice || || ||Device, welches bei Regen getriggert wird
|-
|ASC_rainSensorReading || || ||das ensprechende Reading zum Regendevice
|-
|ASC_rainSensorShuttersClosedPos || || ||Position in pct, welche der Rollladen bei Regen anfahren soll
|-
|ASC_shuttersDriveOffset || || ||maximale zufällige Verzögerung in Sekunden bei der Berechnung der Fahrzeiten, ''0'' bedeutet keine Verzögerung
|-
|ASC_twilightDevice || || ||Device, welches Informationen zum Sonnenstand liefert, wird unter anderem für die Beschattung verwendet.
|-
|ASC_expert || || ||bei ''1'' werden erweiterte Informationen bezüglich des NotifyDevs unter ''set'' und ''get'' angezeigt
|-
| || || ||
|-
| || || ||
|}

===Attribute in den Rolllädendevices===

{|class="wikitable"
|-
! Name !! Datentyp/ Wertebereich !! Default-Wert !! Beschreibung
|-
|ASC || 0, 1, 2|| ||0 = "kein Anlegen der Attribute beim ersten Scan bzw. keine Beachtung eines Fahrbefehles",1 = "Inverse oder Rollo - Bsp.: Rollo Oben 0, Rollo Unten 100 und der Befehl zum prozentualen Fahren ist position",2 = "Homematic Style - Bsp.: Rollo Oben 100, Rollo Unten 0 und der Befehl zum prozentualen Fahren ist pct
|-
|ASC_Antifreeze || soft, am, pm, hard, off|| ||Frostschutz, wenn ''soft'' fährt der Rollladen in die ''ASC_Antifreeze_Pos'', bei ''hard/am/pm'' wird gar nicht oder innerhalb der entsprechenden Tageszeit nicht gefahren
|-
|ASC_Antifreeze_Pos || || ||Position, die angefahren werden soll, wenn der Fahrbefehl komplett schließen lautet, aber der Frostschutz aktiv ist
|-
|ASC_AutoAstroModeEvening ||REAL, CIVIL, NAUTIC, ASTRONOMIC|| ||aktuell REAL,CIVIL,NAUTIC,ASTRONOMIC
|-
|ASC_AutoAstroModeEveningHorizon || || ||Höhe über Horizont, wenn beim Attribut ''ASC_autoAstroModeEvening'' ''HORIZON'' ausgewählt ist
|-
|ASC_AutoAstroModeMorning ||REAL, CIVIL, NAUTIC, ASTRONOMIC|| ||aktuell REAL,CIVIL,NAUTIC,ASTRONOMIC
|-
|ASC_AutoAstroModeMorningHorizon || || ||Höhe über Horizont, wenn beim Attribut ''ASC_autoAstroModeMorning'' ''HORIZON'' ausgewählt ist
|-
|ASC_Closed_Pos || || ||in 10er Schritten von 0 bis 100,default Vorgabe ist abhängig vom Attribut ''ASC''
|-
|ASC_Down || astro, time, brightness || ||bei ''astro'' wird Sonnenuntergang berechnet, bei ''time'' wird der Wert aus ''ASC_Time_Down_Early'' als Fahrzeit verwendet und bei ''brightness'' muss ''ASC_Time_Down_Early'' und ''ASC_Time_Down_Late'' korrekt gesetzt werden. Der Timer läuft dann nach ''ASC_Time_Down_Late''-Zeit,es wird aber in der Zeit zwischen ''ASC_Time_Down_Early'' und ''ASC_Time_Down_Late'' geschaut, ob die als Attribut im Moduldevice hinterlegte ''ASC_brightnessMinVal'' erreicht wurde. Wenn ja, wird der Rolladen runter gefahren
|-
|ASC_Mode_Down ||always, home, absent, off || ||wann darf die Automatik herunterfahren. immer, niemals oder bei Abwesenheit des Roommate (ist kein Roommate und ''absent'' eingestellt, wird gar nicht gesteuert)
|-
|ASC_Mode_Up ||always, home, absent, off || ||wann darf die Automatik hochfahren. immer, niemals oder bei Abwesenheit des Roommate (ist kein Roommate und ''absent'' eingestellt, wird gar nicht gesteuert)
|-
|ASC_Drive_Offset || || ||maximale zufällige Verzögerung in Sekunden bei der Berechnung der Fahrzeiten, ''0'' bedeutet sofort, ''-1'' bedeutet, dass das gleichwertige Attribut aus dem ASC-Device ausgewertet werden soll
|-
|ASC_Open_Pos || || ||in 10er-Schritten von 0 bis 100, default Vorgabe ist abhängig vom Attribut ''ASC''
|-
|ASC_Partymode || on, off || ||schaltet den Partymodus an oder aus. Wird dann am ASC Device ''set <ASC-DEVICE> partyMode on'' geschaltet, werden alle Fahrbefehle an den Rollläden, welche das Attribut auf ''on'' haben, zwischengespeichert und erst später ausgeführt
|-
|ASC_Pos_Reading || || ||Name des Readings, welches die Position des Rollladen in Prozent angibt. Wird bei unbekannten Device-Typen auch als ''set'' Befehl zum Fahren verwendet
|-
|ASC_Pos_after_ComfortOpen || || ||in 10er-Schritten von 0 bis 100, default Vorgabe ist abhängig vom Attribut ''ASC''
|-
|ASC_Roommate_Reading || || ||Reading des Roommate-Device, welches den Status wieder gibt
|-
|ASC_Roommate_Device || || ||mit Komma getrennte Namen des/der Roommate-Device/s welche den/die Bewohner des Rollladen-Raumes wiedergibt. Macht nur Sinn in Schlaf- oder Kinderzimmern
|-
|ASC_Time_Down_Early || || ||Sunset früheste Zeit zum Runterfahren
|-
|ASC_Time_Down_Late || || ||Sunset späteste Zeit zum Runterfahren
|-
|ASC_Time_Up_Early || || ||Sunrise früheste Zeit zum Hochfahren
|-
|ASC_Time_Up_Late || || ||Sunrise späteste Zeit zum Hochfahren
|-
|ASC_Time_Up_WE_Holiday || || ||Sunrise früheste Zeit zum Hochfahren am Wochenende und/oder Urlaub (we2holiday wird beachtet).
|-
|ASC_Up || astro, time, brightness || ||bei ''astro'' wird Sonnenaufgang berechnet, bei ''time'' wird der Wert aus ''ASC_Time_Up_Early'' als Fahrzeit verwendet und bei ''brightness'' müssen ''ASC_Time_Up_Early'' und ''ASC_Time_Up_Late'' korrekt gesetzt werden. Der Timer läuft dann nach ''ASC_Time_Up_Late''-Zeit, es wird aber in der Zeit zwischen ''ASC_Time_Up_Early'' und ''ASC_Time_Up_Late'' geschaut, ob die als Attribut im Moduldevice hinterlegte ''ASC_brightnessMinVal'' erreicht wurde. Wenn ja, wird der Rolladen runter gefahren
|-
|ASC_Ventilate_Pos || || ||in 10er-Schritten von 0 bis 100, default Vorgabe ist abhängig vom Attribut ''ASC''
|-
|ASC_Ventilate_Window_Open || || ||auf lüften, wenn das Fenster gekippt/geöffnet wird und aktuelle Position unterhalb der Lüften-Position ist
|-
|ASC_WindowRec || || ||Name des Fensterkontakts, an welchen Fenster der Rollladen angebracht ist. Sein Reading ''state'' muss die Werte ''open'', ''closed'' oder ''tilted'' enthalten.
|-
|ASC_WindowRec_subType || || ||Typ des verwendeten Fensterkontakts: ''twostate'' (optisch oder magnetisch) oder ''threestate'' (Drehgriffkontakt)
|-
|ASC_lock-out || soft, hard || ||stellt entsprechend den Aussperrschutz ein. Bei global aktiven Aussperrschutz (''set ASC-Device lockOut soft'') und einem Fensterkontakt ''open'' bleibt dann der Rolladen oben. Dies gilt nur bei Steuerbefehle über das ASC-Modul. Stellt man global auf ''hard'', wird bei entsprechender Möglichkeit versucht, den Rollladen hardwareseitig zu blockieren. Dann ist auch ein Fahren über die Taster nicht mehr möglich.
|-
|ASC_lock-outCmd || inhibit, blocked || ||set Befehl für das Rolladen-Device zum Sperren per Hardware. Der Befehl wird verwendet, wenn ''ASC_lock-out'' auf ''hard'' gesetzt ist
|-
|ASC_Self_Defense_Exclude || on, off || ||bei ''on'' wird dieser Rolladen bei aktiven ''selfDefence'' und offenen Fenster nicht runter gefahren, wenn Residents absent ist
|-
|ASC_Shading_Brightness_Sensor || || ||Sensor-Device, welches für die Lichtwerte verwendet wird. ACHTUNG! Findet auch Verwendung bei ASC_Down - brightness
|-
|ASC_BrightnessMinVal || || ||minimaler Lichtwert, bei dem Schaltbedingungen noch geprüft werden sollen / wird der Wert von ''-1'' nicht geändert, so wird automatisch der Wert aus dem Moduldevice genommen
|-
|ASC_BrightnessMaxVal || || ||maximaler Lichtwert, bei dem Schaltbedingungen noch geprüft werden sollen / wird der Wert von ''-1'' nicht geändert, so wird automatisch der Wert aus dem Moduldevice genommen
|-
|ASC_ShuttersPlace || window, terrace || ||wenn dieses Attribut auf ''terrace'' gesetzt ist und das Residents-Device in den Status ''gone'' geht und ''selfDefence'' aktiv ist, wird das Rollo geschlossen
|-
|ASC_WiggleValue || || ||Wert, um welchen sich die Position des Rollladens bei ''Wiggle'' ändern soll
|-
| || || ||
|-
| || || ||
|-
| || || ||
|-
| || || ||
|-
| || || ||
|-
| || || ||
|-
| || || ||
|}

== Hilfsmittel Allgemein==
Achtung: Die Device-Namen sind auf die entsprechende Konfiguration des einzelnen Anzupassen.

=== Hilfsmittel Übersicht ===

define ASC_Jalousie_Info weblink htmlCode {AutoShuttersControl::GetShuttersInformation($defs{'JalousieControl'})}

[[Datei:ASC Overview.JPG|600px|]]

== Hilfsmittel Reading Group für Homematic Devices==
readingsGroup, um die diversen Level einzustellen

Erfolgreich getestet mit Homematic Devices, Stand 2019-01-28 no_Legend

Achtung: Codezeilen wurden aus der Config Datei kopiert.

[[Datei:RG AutoShuttersControl Homematic.png|600px|]]

define rg_ASC_Rollaeden_Level readingsGroup <Gerät>,<ASC>,<Antifreeze>,<Antifreeze_Pos>,<Closed_Pos>,<Open_Pos>,<ASC_Ventilate_Pos> \
(.*Rollladen.*|.*Rollladen|Jalousie_.*):?ASC,?ASC_Antifreeze,?ASC_Antifreeze_Pos,?ASC_Closed_Pos,?ASC_Open_Pos,?ASC_Ventilate_Pos
setuuid rg_ASC_Rollaeden_Level 5c4308e1-f33f-abd1-167d-cc1b5f137cf793c8
attr rg_ASC_Rollaeden_Level commands {ASC => 'ASC:0,1,2',\
ASC_Antifreeze => 'ASC_Antifreeze:off,soft,hard,am,pm',\
ASC_Antifreeze_Pos =>'ASC_Antifreeze_Pos:0,10,20,30,35,40,45,50,55,60,65,70,75,80,85,90,95,100', \
ASC_Closed_Pos => 'ASC_Closed_Pos:0,10,20,30,35,40,45,50,55,60,65,70,75,80,85,90,95,100', \
ASC_Open_Pos => 'ASC_Open_Pos:0,10,20,30,35,40,45,50,55,60,65,70,75,80,85,90,95,100', \
ASC_Ventilate_Pos => 'ASC_Ventilate_Pos:0,10,20,30,35,40,45,50,55,60,65,70,75,80,85,90,95,100'}
attr rg_ASC_Rollaeden_Level room 9.72_Rolladen

define rg_ASC_Rollaeden_Times readingsGroup <Gerät>,<Position>,<Time_Up_Early>,<Time_Up_Late>,<Time_Up_WE/Hol>,<Time_Down_Early>,<Time_Down_Late>,<Mode_Down>,<Mode_Up> \
(.*Rollladen.*|.*Rollladen|Jalousie_.*):level,?ASC_Time_Up_Early,?ASC_Time_Up_Late,?ASC_Time_Up_WE_Holiday,?ASC_Time_Down_Early,?ASC_Time_Down_Late,?ASC_Mode_Down,?ASC_Mode_Up
setuuid rg_ASC_Rollaeden_Times 5c4308e1-f33f-abd1-94a7-fbf717635760f863
attr rg_ASC_Rollaeden_Times commands {level => 'pct:0,10,20,30,35,40,45,50,55,60,65,70,75,80,85,90,95,100', \
ASC_Time_Down_Early => 'ASC_Time_Down_Early:15:00,15:15,15:30,15:45,16:00,16:15,16:30,16:45,17:00,17:15,17:30,17:45,18:00,18:15,18:30,18:45,19:00,19:15,19:30,19:45,20:00,20:15,20:30,20:45,21:00,21:15,21:30,21:45,22:00', \
ASC_Time_Down_Late => 'ASC_Time_Down_Late:19:00,19:15,19:30,19:45,20:00,20:15,20:30,20:45,21:00,21:15,21:30,21:45,22:00,22:15,22:30,22:45,23:00,23:15,23:30', \
ASC_Time_Up_WE_Holiday => 'ASC_Time_Up_WE_Holiday:06:00,06:15,06:30,06:45,07:00,07:15,07:30,07:45,08:00,08:15,08:30,08:45,09:00,09:15,09:30,09:45,10:00',\
ASC_Time_Up_Early => 'ASC_Time_Up_Early:05:00,05:05,05:30,05:45,06:00,06:15,06:30,06:45,07:00,07:15,07:30,07:45,08:00,08:15,08:30,08:45,09:00,09:15,09:30,09:45,10:00', \
ASC_Time_Up_Late => 'ASC_Time_Up_Late:06:00,06:15,06:30,06:45,07:00,07:15,07:30,07:45,08:00,08:15,08:30,08:45,09:00,09:15,09:30,09:45,10:00', \
ASC_Mode_Down => 'ASC_Mode_Down:always,absent,off', \
ASC_Mode_Up => 'ASC_Mode_Up:always,absent,off' }
attr rg_ASC_Rollaeden_Times room 9.72_Rolladen

=== Hilfsmittel Reading Group für FIBARO Roller Shutter FGR-222 Devices===

Getestet von majestro84 https://forum.fhem.de/index.php/topic,92628.msg897099.html#msg897099

Stand 2019-01-28

[[Datei:ASC Jalousien Level.JPG|600px|]]

[[Datei:ASC Jalousien Times.JPG|600px|]]

define ASC_Jalousien_Times readingsGroup <Gerät>,<Stand>,<Time_Up_Early>,<Time_Up_WE>,<Time_Up_Late>,<Time_Down_Early>,<Time_Down_Late>,<Mode_Down>,<Mode_Up>,<PartyMode>,<LockOut> (.*_Jalousie.*):position,?ASC_Time_Up_Early,?ASC_Time_Up_WE_Holiday,?ASC_Time_Up_Late,?ASC_Time_Down_Early,?ASC_Time_Down_Late,?ASC_Mode_Down,?ASC_Mode_Up,?ASC_Partymode,?ASC_LockOut
attr ASC_Jalousien_Times commands {position => 'dim:0,10,20,30,35,40,45,50,55,60,65,70,75,80,85,90,95,99',
ASC_Mode_Down => 'ASC_Mode_Down:always,absent,off',
ASC_Mode_Up => 'ASC_Mode_Up:always,absent,off',
ASC_Partymode => 'ASC_Partymode:on,off',
ASC_LockOut => 'ASC_LockOut:soft,hard,off',
ASC_Time_Down_Early => 'ASC_Time_Down_Early:15:00,15:15,15:30,15:45,16:00,16:15,16:30,16:45,17:00,17:15,17:30,17:45,18:00,18:15,18:30,18:45,19:00,19:15,19:30,19:45,20:00,20:15,20:30,20:45,21:00,21:15,21:30,21:45,22:00',
ASC_Time_Down_Late => 'ASC_Time_Down_Late:20:15,20:30,20:45,21:00,21:15,21:30,21:45,22:00,22:15,22:30,22:45,23:00,23:15,23:30',
ASC_Time_Up_Early => 'ASC_Time_Up_Early:05:00,05:05,05:30,05:45,06:00,06:15,06:30,06:45,07:00,07:15,07:30,07:45,08:00,08:15,08:30,08:45,09:00,09:15,09:30,09:45,10:00',
ASC_Time_Up_Late =>'ASC_Time_Up_Late:06:00,06:15,06:30,06:45,07:00,07:15,07:30,07:45,08:00,08:15,08:30,08:45,09:00,09:15,09:30,09:45,10:00',
ASC_Time_Up_WE_Holiday => 'ASC_Time_Up_WE_Holiday:06:00,06:15,06:30,06:45,07:00,07:15,07:30,07:45,08:00,08:15,08:30,08:45,09:00,09:15,09:30,09:45,10:00'}
attr ASC_Jalousien_Times room Jalousien

define Jalousien_Level readingsGroup <Gerät>,<Closed_Pos>,<Open_Pos>,<Comfort_Pos>,<Ventilate_Pos>,<PrivacyDown_Pos>,<Shading_Pos> (.*_Jalousie.*):?ASC_Closed_Pos,?ASC_Open_Pos,?ASC_ComfortOpen_Pos,?ASC_Ventilate_Pos,?ASC_PrivacyDown_Pos,?ASC_Shading_Pos
attr Jalousien_Level commands { ASC_Closed_Pos => 'ASC_Closed_Pos:0,10,20,30,35,40,45,50,55,60,65,70,75,80,85,90,95,99',
ASC_Open_Pos => 'ASC_Open_Pos:0,10,20,30,35,40,45,50,55,60,65,70,75,80,85,90,95,99',
ASC_ComfortOpen_Pos => 'ASC_ComfortOpen_Pos:0,10,20,30,35,40,45,50,55,60,65,70,75,80,85,90,95,99',
ASC_Ventilate_Pos => 'ASC_Ventilate_Pos:0,10,20,30,35,40,45,50,55,60,65,70,75,80,85,90,95,99',
ASC_PrivacyDown_Pos => 'ASC_PrivacyDown_Pos:0,10,20,30,35,40,45,50,55,60,65,70,75,80,85,90,95,99',
ASC_Shading_Pos => 'ASC_Shading_Pos:0,10,20,30,35,40,45,50,55,60,65,70,75,80,85,90,95,99'}
attr Jalousien_Level room Jalousien

=== Hilfsmittel ===
tbd

readingsGroup, um die diversen Level einzustellen:

define rg_ASC_Rollaeden_Level readingsGroup <Gerät>,<Closed_Pos>,<Open_Pos>,<Shading_Pos>,<Ventilate_Pos> (Rolladen_.*|Jalousie_.*)..:?ASC_Closed_Pos,?ASC_Open_Pos,?ASC_Shading_Pos,?ASC_Ventilate_Pos
attr rg_ASC_Rollaeden_Level commands { ASC_Closed_Pos => 'ASC_Closed_Pos:0,10,20,30,35,40,45,50,55,60,65,70,75,80,85,90,95,100',\
ASC_Open_Pos => 'ASC_Open_Pos:0,10,20,30,35,40,45,50,55,60,65,70,75,80,85,90,95,100',\
ASC_Shading_Pos => 'ASC_Shading_Pos:0,10,20,30,35,40,45,50,55,60,65,70,75,80,85,90,95,100',\
ASC_Ventilate_Pos => 'ASC_Ventilate_Pos:0,10,20,30,35,40,45,50,55,60,65,70,75,80,85,90,95,100'}
[[Datei:ReadingsGroup ASC Level.png|600px|]]
readingsGroup, um die diversen Zeiten einzustellen:

define rg_ASC_Rollaeden_Times readingsGroup <Gerät>,<Stand>,<Time_Up_Early>,<Time_Up_WE>,<Time_Up_Late>,<Time_Down_Early>,<Time_Down_Late>,<Mode_Down>,<Mode_Up> (Rolladen_.*|Jalousie_.*)..:level,?ASC_Time_Up_Early,?ASC_Time_Up_WE_Holiday,?ASC_Time_Up_Late,?ASC_Time_Down_Early,?ASC_Time_Down_Late,?ASC_Mode_Down,?ASC_Mode_Up
attr rg_ASC_Rollaeden_Times commands {level => 'pct:0,10,20,30,35,40,45,50,55,60,65,70,75,80,85,90,95,100', \
ASC_Mode_Down => 'ASC_Mode_Down:always,absent,off',\
ASC_Mode_Up => 'ASC_Mode_Up:always,absent,off',\
ASC_Time_Down_Early => 'ASC_Time_Down_Early:15:00,15:15,15:30,15:45,16:00,16:15,16:30,16:45,17:00,17:15,17:30,17:45,18:00,18:15,18:30,18:45,19:00,19:15,19:30,19:45,20:00,20:15,20:30,20:45,21:00,21:15,21:30,21:45,22:00', \
ASC_Time_Down_Late => 'ASC_Time_Down_Late:20:15,20:30,20:45,21:00,21:15,21:30,21:45,22:00,22:15,22:30,22:45,23:00,23:15,23:30',\
ASC_Time_Up_Early => 'ASC_Time_Up_Early:05:00,05:05,05:30,05:45,06:00,06:15,06:30,06:45,07:00,07:15,07:30,07:45,08:00,08:15,08:30,08:45,09:00,09:15,09:30,09:45,10:00', \
ASC_Time_Up_Late =>'ASC_Time_Up_Late:06:00,06:15,06:30,06:45,07:00,07:15,07:30,07:45,08:00,08:15,08:30,08:45,09:00,09:15,09:30,09:45,10:00',ASC_Time_Up_WE_Holiday => 'ASC_Time_Up_WE_Holiday:06:00,06:15,06:30,06:45,07:00,07:15,07:30,07:45,08:00,08:15,08:30,08:45,09:00,09:15,09:30,09:45,10:00'}
[[Datei:ReadingsGroup ASC Times.png|600px|]]

== Weblinks ==
* {{Link2Forum|Topic=92628|LinkText="Thread zum Modul im Forum"}}
* {{Link2Forum|Topic=90751|LinkText="Thread zur Entwicklung im Forum"}}
* {{Link2Forum|Topic=73964|LinkText="Thread zu den Scripten von user cluni"}}, die der Entwicklung des Moduls zugrunde liegen

[[Kategorie:Code Snippets]]
[[Kategorie:Rollladensteuerung]]

FHEM mit HTTPS SSL-Zertifikat und eine eigene Zertifizierungsstelle

2019-02-16T08:29:23Z

CoolTux: /* Schlüssel für das Serverzertifikat erzeugen */

== Vorwort ==
=== Dein Anliegen ===
Du möchtest FHEM mit HTTPS betreiben, hasst es aber, ständig von Deinem Browser darauf aufmerksam gemacht zu werden, dass dies "keine sichere Verbindung" ist.
Oder Du möchtest einen weiteren Serverdienst aufsetzen, welcher verschlüsselte SSL oder TLS-Verbindungen anbietet (z.B. HTTPS, POP3S, IMAPS, LDAPS, SMTP mit TLS).

=== Die Schwierigkeit dabei ===
Um eine mit SSL/TLS abgesicherte Verbindung anzubieten, benötigst Du ein Serverzertifikat. Dieses muss von einer Zertifizierungsstelle (Certification Authority oder kurz CA) signiert sein.
Ein offizielles Serverzertifikat, welches von einer offiziellen Stelle signiert ist, ist leider nicht kostenlos. Meist werden jährliche Gebühren in Höhe von mehreren hundert Euro fällig.

=== Eine mögliche Lösung ===
Unter Linux kann man mit Bordmitteln eine eigene CA aufsetzen und selbst ein Zertifikate erstellen und signieren. Das ist ein Vorgang von wenigen Minuten. Alle Einzelheiten beschreibt dieser Artikel.
Der einzige Unterschied zu einem von einer anerkannten Stelle signierten Zertifikat ist, dass der Client (Emailprogramm, Browser, etc.) einmalig das root CA importieren muß.

== Genaues Vorgehen ==
=== OpenSSL installieren ===
Für die Verwaltung der Zertifikate und im übrigen auch für die Verschlüsselung der Verbindungen mit SSL und TLS kommt unter Linux fast immer OpenSSL zum Einsatz. Wahrscheinlich ist das auf Deinem Sytem deshalb bereits installiert, wenn nicht, musst Du das Paket openssl nachinstallieren. Du benötigst aus diesem Paket den Kommandozeilenbefehl openssl.

=== Erstellen der CA ===
Lege zunächst ein Verzeichnis an, in dem Du das Zertifikat ablegen willst. Wir nehmen in unserem Beispiel /root/ca:
<source lang="bash">
root@linux# mkdir /root/ca
root@linux# cd /root/ca</source>
Die Gültigkeit setzen wir mit 10 Jahren bewusst sehr hoch an. Läuft die CA aus, so werden nämlich auch alle damit signierten Serverzertifikate ungültig. Die CA enthält einen geheimen Schlüssel, welcher automatisch erzeugt und in der Datei cakey.pem abgelegt wird. Das CA-Zertifikat wird nach cacert.pem geschrieben. Der folgende Befehl erzeugt das einen Schlüssel für das Zertifikat mit einer Länge von 2048 Bit:
<source lang="bash">
root@linux# openssl req -new -x509 -newkey rsa:2048 -keyout cakey.pem -out cacert.pem -days 3650
Generating a 2048 bit RSA private key
..............................................................
..............................................................
.........................................+++
......................................+++
writing new private key to 'cakey.pem'</source>

Wer den geheimen Schlüssel der CA kennt, kann damit beliebige Serverzertifikate signieren. Deshalb wird diese Schlüsseldatei nicht im Klartext auf der Festplatte abgelegt, sondern mit einer Passphrase verschlüsselt. Diese Passphrase benötigst Du immer dann, wenn Du mit der CA neue Zertifikate ausstellen willst:
<nowiki>
Enter PEM pass phrase: sehrlangesgeheimespasswort
Verifying - Enter PEM pass phrase: sehrlangesgeheimespasswort</nowiki>
Nun werden wir gebeten, Daten einzugeben, welche die CA identifizieren. Diese werden dem Client angezeigt, wenn er aufgefordert wird, das Zertifikat zu akzeptieren oder abzulehnen. Der Code für Deutschland ist DE. Wenn Du ein Feld leer lassen möchtest, so gib einen Punkt ein. Ansonsten wird der in eckigen Klammern stehende Defaultwert eingetragen:
<nowiki>
-----
You are about to be asked to enter information that will be incorporated
into your certificate request.
What you are about to enter is what is called a Distinguished Name or a DN.
There are quite a few fields but you can leave some blank
For some fields there will be a default value,
If you enter '.', the field will be left blank.
-----
Country Name (2 letter code) [AU]: DE
State or Province Name (full name) [Some-State]:Brandenburg
Locality Name (eg, city) []:Potsdam
Organization Name (eg, company) [Internet Widgits Pty Ltd]:Familie AG
Organizational Unit Name (eg, section) []:EDV</nowiki>
Das Feld Common Name (CN) ist hier der offizielle Name der Zertifizierungsstelle. Für Dein eigenes CA kannst Du einfach Deinen eigenen Namen eintragen:
<nowiki>
Common Name (eg, YOUR name) []: Cool Tux
Email Address []: cooltux@gmail.tada</nowiki>
Fertig. Folgende zwei Dateien sind entstanden:
<nowiki>
root@linux# ll
insgesamt 9
drwxr-xr-x 2 root root 112 2006-04-30 12:08 .
drwx------ 12 root root 600 2006-04-30 11:54 ..
-rw-r--r-- 1 root root 1212 2006-04-30 12:08 cacert.pem
-rw-r--r-- 1 root root 963 2006-04-30 12:08 cakey.pem</nowiki>
Vorsichtshalber solltest Du die Rechte so setzen, dass die Schlüsseldatei nur für root lesbar ist:
<nowiki>
root@linux# chmod 600 cakey.pem</nowiki>
Du kannst nun ausprobieren, ob Du den Schlüssel mit der Passphrase wieder öffnen kannst:
<nowiki>
root@linux# openssl rsa -in cakey.pem -noout -text
Enter pass phrase for cakey.pem: wrzlprmpft
Private-Key: (1024 bit)
modulus:
00:d5:a5:37:51:e9:d9:fa:e3:97:e7:46:b2:88:1a:
b5:46:80:47:76:14:ae:2b:8b:3e:35:5c:ab:15:84:
53:d9:63:2e:7f:08:4b:ec:77:db:02:45:f8:c7:46:
58:cd:2d:f9:29:4d:96:3d:d8:6c:5d:9f:79:8a:04:
cf:b7:3a:89:da:a9:63:9f:44:b3:83:cf:0d:70:7d:</nowiki>
usw...

=== Schlüssel für das Serverzertifikat erzeugen ===
Nachdem wir nun eine eigene CA haben, kann diese nun endlich für unseren Server ein Zertifikat herausgeben. Dazu erzeugen wir zunächst einen 2048 Bit langen RSA Schlüssel, der mit AES 128 verschlüsselt auf der Platte abgelegt wird (ja wirklich, auch hier wieder ein verschlüsselter Schlüssel). Die Passphrase muss diesmal nicht sonderlich geheim sein, da wir sie ohnehin im Anschluss wieder entfernen werden. OpenSSL lässt allerdings keine leere Phrase zu:
<source lang="bash">
root@linux# openssl genrsa -out serverkey.pem -aes128 2048
Generating RSA private key, 2048 bit long modulus
....+++
.......................................+++
e is 65537 (0x10001)
Enter pass phrase for serverkey.pem: test
Verifying - Enter pass phrase for serverkey.pem: test</source>
So. Nun entfernen wir die Passphrase wieder. Warum? Der Serverdienst (Apache, Cyrus, etc.) muss schließlich in der Lage sein, den Schlüssel ohne Dein Zutun zu lesen. Oder möchtest Du bei jedem Booten des Servers ein Passwort eingeben müssen?
<source lang="bash">
root@linux# openssl rsa -in serverkey.pem -out serverkey.pem
Enter pass phrase for serverkey.pem: jaja
writing RSA key</source>

=== Certificate Signing Request erzeugen ===
Der nächste Schritt zum eigenen Zertifikat ist ein CSR. Dies muss dann nur noch von der CA signiert werden. Hier sind wieder Angaben analog zum Erstellen der CA nötig, was oft Verwirrung stiftet. Die allgemeinen Daten kann man ggfl. gleich wie oben eingeben:
<source lang="bash">
root@linux# openssl req -new -key serverkey.pem -out req.pem -nodes
You are about to be asked to enter information that will be incorporated
into your certificate request.
What you are about to enter is what is called a Distinguished Name or a DN.
There are quite a few fields but you can leave some blank
For some fields there will be a default value,
If you enter '.', the field will be left blank.
-----
Country Name (2 letter code) [AU]: DE
State or Province Name (full name) [Some-State]:Brandenburg
Locality Name (eg, city) []:Potsdam
Organization Name (eg, company) [Internet Widgits Pty Ltd]:Familie AG
Organizational Unit Name (eg, section) []:EDV</source>
ACHTUNG, jetzt kommt das Wichtige: Beim Serverzertifikat ist der Common Name von entscheidender Bedeutung. Hier muss der DNS-Name stehen, unter dem der Client den Server anspricht! Wird das Zertifikat für eine HTTPS-Verbindung zu fhem.local verwendet, so muss der Common Name eben genau fhem.local heißen. Anderfalls wird der Browser das Zertifikat nicht akzeptieren, da er davon ausgehen muss, auf dem falschen Server gelandet zu sein.
<nowiki>
Common Name (eg, YOUR name) []: fhem.local
Email Address []: admin.fhem.local</nowiki>
Weitere Optionen kann man einfach leer lassen:
<nowiki>
A challenge password []:
An optional company name []:</nowiki>
Mittlerweile tummeln sich schon vier Dateien in unserem Verzeichnis:
<source lang="bash">
root@linux# ll
insgesamt 17
drwxr-xr-x 2 root root 168 2006-04-30 12:29 .
drwx------ 12 root root 600 2006-04-30 11:54 ..
-rw-r--r-- 1 root root 1212 2006-04-30 12:08 cacert.pem
-rw------- 1 root root 963 2006-04-30 12:08 cakey.pem
-rw-r--r-- 1 root root 1017 2006-04-30 12:29 req.pem
-rw-r--r-- 1 root root 1679 2006-04-30 12:21 serverkey.pem</source>

=== OpenSSL-Konfiguration anpassen ===
Leider kann man bei OpenSSL nicht alle Daten als Kommandozeilenargumente übergeben. Einige Einstellungen muss man lästigerweise in der Datei /etc/ssl/openssl.cnf ändern, bevor man signieren kann. Öffne diese Datei und passe folgende Zeilen in der Sektion [ CA_default ] an:
<source lang="bash">
/etc/ssl/openssl.cnf:
dir = . # Where everything is kept
new_certs_dir = $dir # default place for new certs
private_key = $dir/cakey.pem # The private key
RANDFILE = $dir/.rand # private random number file
default_days = 3650 # how long to certify for</source>
Das Feld default_days ist auf 365 Tage voreingestellt und gibt die Gültigkeit des Zertifikates an. Abgelaufene Zertifikate sind im Übrigen ein sehr häufiges Problem. Wenn es soweit ist, kennt sich damit nämlich schon lange keiner mehr aus. Deswegen kannst Du wie im Beispiel angegeben die Lebensdauer z.B. auf 10 Jahre heraufsetzen.

Nun muss man noch einige Dateien anlegen:
<source lang="bash">
root@linux# echo 01 > serial
root@linux# touch index.txt</source>

=== Serverzertifikat signieren ===
Kommen wir zum feierlichen Abschluss: Unsere CA signiert nun das Zertifikat:
<source lang="bash">
root@linux# openssl ca -in req.pem -notext -out servercert.pem
Enter pass phrase for ./cakey.pem: langesgeheimespasswort

...

Certificate is to be certified until Apr 27 10:45:36 2016 GMT (3650 days)
Sign the certificate? [y/n]: y

1 out of 1 certificate requests certified, commit? [y/n] y
Write out database with 1 new entries
Data Base Updated</source>

=== Zertifikate installieren ===
Wie Du das Zertifikat in FHEM installierst, findest Du [[Raspberry_Pi_%26_HTTPS|hier]] und wenn Du ein Server Zertifikat für NGINX installieren möchtest, findest Du Infos dazu [[HTTPS-Absicherung_%26_Authentifizierung_via_nginx_Webserver|hier]]

== Nachwort ==
=== Einbinden der root CA in die Zertifizierungsstelle des Browsers ===
Beim Firefox importieren wir unsere cacert.pem unter Einstellungen -> Erweitert -> Zertifikate -> Zertifikate anzeigen -> Zertifizierungsstellen ein.
Unter Chrome/Chromium finden wir die Zertifikatsverwaltung unter Einstellungen -> Erweitert -> Zertifikate verwalten HTTPS/SSL-Zertifikate und -Einstellungen verwalten -> Zertifizierungsstellen

=== Bekannte Probleme ===
Für den Chrome/Chromium müssen wir zusätzlich "Subject Alternative Names (SAN)" in unser Zertifikat eintragen. Dies geschieht beim Serverzertifikat signieren. Dazu müssen wir uns eine weitere Datei anlegen:
<source lang="bash">
root@linux# vim oats.extensions.cnf

basicConstraints=CA:FALSE
subjectAltName=@my_subject_alt_names
subjectKeyIdentifier = hash

[ my_subject_alt_names ]
DNS.1 = fhem01.tuxnet.local
DNS.2 = fhem02.tuxnet.local
DNS.3 = fhem01-vpn.tuxnet.local</source>
Die Signierung unseres Serverzertifikates erfolgt dann mit folgendem Befehl:
<source lang="bash">
openssl ca -in req.pem -notext -extfile oats.extensions.cnf -out servercert.pem</source>

=== Prüfen von Zertifikaten ===
Zertifikate kann man im übrigen auf dieser [https://www.networking4all.com/en/ssl+certificates/csr+check/| Seite] prüfen lassen.
Dazu kopiert man den Inhalt der servercert.pem in das Eingabefeld der Seite und klickt dann auf Check CSR.

[[Kategorie:HOWTOS]]

Google Assistant FHEM Connect

2019-01-30T13:58:22Z

CoolTux:

'''FHEM Connect''' ist eine Weiterentwicklung von [[Alexa-Fhem|Alexa FHEM]] speziell für den Google Assistant. Mit FHEM Connect ist die Verknüpfung von FHEM und dem Google Assistant in wenigen Schritten getan. Damit kannst du Geräte die in FHEM verwaltet werden auch über den Google Assistant von beliebigen Geräten mit Google Assistant Support steuern.

Es sind keine großen Einrichtungen dafür notwendig und die Verbindung zwischen Google und deinem Client ist ebenso gesichert.

ACHTUNG!!! FHEM muß zwingend aktuell sein. Update > 28.01.2019

{{Infobox Modul
|ModPurpose=Anbindung von FHEM an Google Assistant
|ModType=x
|ModTechName=
|ModForumArea=Frontends/Sprachsteuerung
|ModOwner=dominik
}}

==Hintergrundinfos==
FHEM Connect basiert auf Google Firebase, welches die Plattform für die Kommunikation mit Google bietet. Der lokal installierte fhemconnect Client kommuniziert mit Google Firebase und übermittelt von dort die Daten an Google. Das hat 3 große Vorteile:
* Keine Portfreigaben notwendig
* Kommunikation läuft gesichert über HTTPS und die Authentifizierung über Auth0 mittels OAuth2
* Neue Funktionalitäten, wie zum Beispiel die Unterstützung von neuen Devices, sind immer gleich verfügbar sobald diese im Firebase Projekt implementiert wurden. Man muss also nicht regelmäßig aktualisieren um in den Genuss von neuen Google Assistant Features zu kommen.

==Installation (Kurzanleitung)==
Wichtig: Aktuell ist der Google Action noch im Beta Test und ihr müsst daher als Tester mit eurer GMail Adresse mit aufgenommen werden. Schickt mir dazu eine kurze private Nachricht im FHEM Forum ([https://forum.fhem.de/index.php?action=profile;u=15803 dominik]) mit eurer GMail Adresse. Sobald ich diese hinzugefügt habe, könnt ihr den Action in der Google Home App sehen.

'''Bevor ihr die Befehle unten ausführt, müsst ihr das Testaction aktivieren. Dazu bitte auf folgenden Link klicken:
'''

https://console.actions.google.com/project/fhem-connector-beta/simulatorcreate?isDeepLink

* 39_gassistant.pm von hier herunterladen: https://forum.fhem.de/index.php/topic,96696.0.html
* 39_gassistant.pm nach /opt/fhem/FHEM kopieren
<syntaxhighlight lang="bash" style="width:70%;">
sudo npm install -g gassistant-fhem --unsafe-perm
define gassistant gassistant
</syntaxhighlight>
* Ca. 30s warten bis ein Reading gassistantFHEM.loginURL erscheint
* Link öffnen und einloggen
* Den erhaltenen authcode in FHEM hinterlegen (set gassistant authcode ...)

* /opt/fhem/FHEM/gassistant-fhem.cfg bei Bedarf anpassen
* Geräte in den in der gassistant-fhem.cfg definierten Raum verschieben

==Architektur==
* fhemconnect Client
Lokale installierter Client der die Verbindung zu FHEM herstellt.

* Auth0
Auth0 wird sowohl von fhemconnect Client als auch von Google Assistant genutzt um den User zu authentifizieren. Damit erhält der User eine eindeutigen User ID.

* Firebase ("zentralerer Server", obwohl es Server-less betrieben wird)

* Firebase Firestore
Datenbank in welcher die Geräteinformationen gespeichert werden.

* Firebase Realtime DB
Datenbank in welcher der aktuelle Status der Geräte gespeichert wird.

* Firebase Cloud Functions
Die Cloud Function stellt einen Webaufruf im Internet zur Verfügung. Google ruft direkt eine solche Cloud Function auf. Des Weiteren wird diese auch für die Kommunikation vom fhemconnect Client zum Firebase Projekt ("Server") genutzt.

Die Dienste auth0 und Google Firebase wurden beide als EU Instanzen konfiguriert. Eure Daten liegen daher im EU Raum und unterliegen damit auch den EU Datenschutzvorgaben.

==Datenfluss==
Der Datenfluss und die Arbeitsweise von FHEM Connect wird anhand des folgenden Beispiels erklärt:
* Bei der Verknüpfung des Google Accounts mit FHEM Connect wird der Service von auth0 herangezogen. Dieser authentifiziert den User und generiert einen Access und Refresh Token mit welchem Google sich gegenüber FHEM Connect (“dem zentralen Service”) authentifiziert.
* Bei der Installation des fhemconnect Clients wird ebenso auth0 herangezogen. Der User wird auch dort über auth0 authentifiziert und damit kann sich auch fhemconnect am zentralen Service anmelden.
* Durch dieses Verfahren kann FHEM Connect die User ID aus dem fhemconnect Client und die User ID die über Google kommt matchen und damit Befehle dem richtigen User zuordnen. Ein Faken dieser User ID ist nicht möglich, da der übertragene Token (JSON Web Token) signiert ist und bei jeder Übertragung von auth0 verifiziert wird.
* Durch die Verknüpfung des Accounts weiß Google, dass es FHEM Connect gibt und es dorthin Smart Home Befehle schicken kann.
* Ein Befehl wie "Schalte das Nachtlicht ein" wird von Google interpretiert
* FHEM Connect (der zentrale Service der auf Firebase läuft) erhält den Befehl das Nachtlicht einzuschalten. Durch den von Google übertragenen Access Token, welcher die User ID beinhaltet, wird der User identifiziert.
* FHEM Connect weiß durch die User ID, welche es dem verifizierten Access Token entnommen hat, welchem User der Befehl zuzuordnen ist und schickt dieser über Firebase an den fhemconnect Client.
* Der fhemconnect Client schickt den Befehl direkt an FHEM weiter wo der Befehl ausgeführt wird.

==Update==
Es wird nur in seltenen Fällen ein Update benötigt, da der größte Teil der Anwendung in Firebase konfiguriert ist. Sollte der Client dennoch aktualisiert werden müssen, dann kann das mit folgenden Befehlen durchgeführt werden:
<syntaxhighlight lang="bash" style="width:70%;">
sudo npm install -g gassistant-fhem
</syntaxhighlight>
* gassistant über FHEM neu starten

==FAQs==
* "Method Not Allowed" Fehlermeldung bei der npm Installation?
<syntaxhighlight lang="bash" style="width:70%;">
sudo npm install -g npm
</syntaxhighlight>

==Kostenlos==
Aktuell wird der Service kostenlos betrieben. Abhängig von der Auslastung, könnte es zukünftig der Fall sein, dass die freien Limits bei Firebase und Auth0 überstiegen werden und damit Kosten anfallen. Solange das nicht der Fall ist, wird der Service kostenlos zur Verfügung gestellt.

NUKI

2018-10-02T23:00:41Z

CoolTux: /* Definition */

<div style="float:right">
{{Infobox Modul
|ModPurpose=Einbindung der Nuki Bridge HW/APP
|ModType=d
|ModCmdRef=NUKIBridge
|ModForumArea=Sonstige Systeme
|ModTechName=73_NUKIBridge.pm
|ModOwner=CoolTux ({{Link2FU|13684|Forum}} / [[Benutzer:CoolTux|Wiki]])
}}
{{Infobox Modul
|ModPurpose=Steuern von Nuki Smartlocks über NUKIBridge
|ModType=d
|ModCmdRef=NUKIDevice
|ModForumArea=Sonstige Systeme
|ModTechName=73_NUKIDevice.pm
|ModOwner=CoolTux ({{Link2FU|13684|Forum}} / [[Benutzer:CoolTux|Wiki]])
}}
</div>

==NUKIBridge==
NUKIBridge - Steuert das Nuki Smartlock über die Nuki Bridge

Das Nuki Bridge Modul verbindet FHEM mit der Nuki Bridge und liest dann alle auf der Bridge verfügbaren Smartlocks ein. Desweiteren werden automatisch die erkannten Smartlocks als eigenständige Devices angelegt.

Voraussetzung für ein fehlerfreies Laden ist die Installation von JSON (libperl-json).

===Definition===
<code>define <name> NUKIBridge <HOST> <API-TOKEN></code>

'''Beispiel:'''

<code>define NBridge1 NUKIBridge 192.168.0.23 F34HK6</code>

Diese Anweisung erstellt ein NUKIBridge Device mit Namen NBridge1 und der IP 192.168.0.23 sowie dem Token F34HK6.
Nach dem Anlegen des Bridge Devices werden alle zur Verfügung stehende Smartlock automatisch in FHEM angelegt.

===Readings===
* 0_nukiId - ID des ersten gefundenen Nuki Smartlocks
* 0_name - Name des ersten gefunden Nuki Smartlocks
* smartlockCount - Anzahl aller gefundenen Smartlock
* bridgeAPI - API Version der Bridge
* bridgeType - Hardware oder Software/App Bridge
* currentTime - aktuelle Zeit auf der Bridge zum zeitpunkt des Info holens
* firmwareVersion - aktuell auf der Bridge verwendete Firmwareversion
* hardwareId - ID der Hardware Bridge
* lastError - gibt die letzte HTTP Errormeldung wieder
* serverConnected - true/false gibt an ob die Hardwarebridge Verbindung zur Nuki-Cloude hat.
* serverId - gibt die ID des Cloudeservers wieder
* uptime - Uptime der Bridge in Sekunden
* wifiFirmwareVersion- Firmwareversion des Wifi Modules der Bridge
* Die vorangestellte Zahl ist forlaufend und gibt beginnend bei 0 die Eigenschaften Eines Smartlocks wieder.

===Set===
* autocreate - Veranlasst ein erneutes Einlesen aller Smartlocks von der Bridge und falls noch nicht in FHEM vorhanden das autimatische anlegen.
* callbackRemove - Löschen einer Callback Instanz auf der Bridge. Die Instanz ID kann mittels get callbackList ermittelt werden
* clearLog - löscht das Logfile auf der Bridge
* fwUpdate - schaut nach einer neueren Firmware und installiert diese sofern vorhanden
* info - holt aktuellen Informationen über die Bridge
* reboot - veranlässt ein reboot der Bridge

===Get===
* callbackList - Gibt die Liste der eingetragenen Callback URL's wieder. Die Bridge nimmt maximal 3 auf.
* logFile - Zeigt das Logfile der Bridge an

===Attribute===
* disable - deaktiviert die Nuki Bridge

==NUKIDevice==
NUKIDevice - Steuert das Nuki Smartlock

Das Nuki Modul verbindet FHEM über die Nuki Bridge mit einem Nuki Smartlock. Es ist dann möglich das Schloss zu ver- und entriegeln.
In der Regel werden die Nuki Devices automatisch durch das Bridgemodul angelegt.

===Definition===
<code>define <name> NUKIDevice <Nuki-Id> <IODev-Device></code>

'''Beispiel:'''

<code>define Haustuer NUKIDevice 1 NBridge1</code>

Diese Anweisung erstellt ein NUKIDevice mit Namen Haustuer, der NukiId 1 sowie dem IODev Device NBridge1. Nach dem Anlegen des Devices wird automatisch der aktuelle Zustand des Smartlocks aus der Bridge gelesen.
Damit das NUKIDevice auch Statusänderungen mitbekommt, die beispielsweise aus der nativen NUKI-App oder der manuellen Betätigung des Devices herrühren, ist es notwendig die Attribute webhookFWinstance und webhookHttpHostname zu setzen.

<code>
attr Haustuer webhookFWinstance WEB (Name der FHEMWEB Instanz)

attr Haustuer webhookHttpHostname 192.168.0.1 (IP/FQDN vom FHEM
Server)
</code>

Zum Überprüfen kann die Funktion
<code>get NUKIBridge callbackList</code>
aufgerufen werden. Es sollte nur ein Callback eingetragen
sein, der in dieser Form hinterlegt sein sollte.
0 http://192.168.0.1:8083/fhem/NUKIDevice-123456789

===Readings===
* state - Status des Smartlock bzw. Fehlermeldung von Fehler vorhanden.
* lockState - aktueller Schließstatus uncalibrated, locked, unlocked, unlocked (lock ‘n’ go), unlatched, locking, unlocking, unlatching, motor blocked, undefined.
* succes - true, false Gibt des Status des letzten Schließbefehles wieder. Geklappt oder nicht geklappt.
* batteryCritical - Ist die Batterie in einem kritischen Zustand? true, false
* battery - Status der Batterie, ok/low

===Set===
* statusRequest - ruft den aktuellen Status des Smartlocks von der Bridge ab.
* lock - verschließen
* unlock - aufschließen
* unlatch - entriegeln/Falle öffnen.
* locknGo - verschließen wenn gegangen
* locknGoWithUnlatch - verschließen nach dem die Falle geöffnet wurde.

===Attribute===
* disable - deaktiviert das Nuki Device
* webhookFWinstance - zu verwendene Webinstanz für den Callbackaufruf
* webhookHttpHostname - IP oder FQDN vom FHEM Server für den Callbackaufruf

AutoShuttersControl

2018-09-18T09:09:04Z

CoolTux: /* Readings im AutoShuttersControl Device selbst. */

{{Baustelle}}
{{Infobox Modul
|ModPurpose=Steuerung von Rollläden
|ModCategory=Automatisierung
|ModType=x

|ModForumArea=Automatisierung
|ModTechName=73_AutoShuttersControl.pm
|ModOwner=CoolTux}}
Mit [[AutoShuttersControl]] oder kurz ASC können typische Aufgabenstellungen im Zusammenhang mit Rollläden u.ä. automatisiert werden, wie zum Beispiel das Öffnen bei Sonnenaufgang, Schließen bei Sonnenuntergang oder das Anfahren von Lüftungspositionen beim Öffnen des zugehörigen Fensters.

{{Hinweis|Das Modul befindet sich derzeit noch in der Entwicklung; der jeweils aktuelle Stand ist diesem {{Link2Forum|Topic=90751|LinkText="Thread im Forum"}} zu entnehmen.}}

== Basics ==
Zur Nutzung des Moduls sollten folgende andere FHEM-Devices vorhanden sein:
* Rollläden
* Fensterkontakte und
* Bewohnerstatus auf Basis von Residents/Roomates in englisch. Ersatzweise andere Devices, z.B. Dummys, welche als ''state'' ''home'', ''asleep'', ''gotosleep'' und ''awoken'' setzen sowie ein Reading ''lastState''.

Die Einrichtung des Moduls bzw. dessen Funktionalität erfolgt in mehreren Schritten:
* Definition des ASC-Devices
* Einstellung zentraler Vorgaben am ASC-Device
* Markieren der zukünftig zu steuernden Rollladen-Devices
* Einbinden der Rollladen-Devices in das ASC-Device
* Einstellen der individuellen Vorgaben je Rollladen (am Rollladen-Device)

== Einrichtung ==

=== Vorbereitung ===

{{Hinweis|Ihr benötigt ein aktuelles FHEM. Update ab dem 04.09.2018 Voraussetzung!}}

Zunächst muß das Modul aus dem Link im Forum entpackt werden und die Datei 73_AutoShuttersControl.pm in das Unterverzeichnis für die Module kopiert werden und die Rechte angepaßt.

Speicherort für Linux-Standardinstallationen: /opt/fhem/FHEM
Rechte: <code>sudo chown 73_AutoShuttersControl.pm</code> und <code>sudo chmod 644 73_AutoShuttersControl.pm</code>

Danach sollte ein <code>reload AutoShuttersControl</code> in FHEM-Eingabefeld ausreichen, um das Modul verfügbar zu machen.

{{Hinweis|Eventuell muß FHEM auch einmalig neu gestartet werden, um das Modul nutzen zu können.}}

=== Define des ASC-Devices ===
Es genügt ein einfaches define ohne weitere Parameter.
<code>define <name> AutoShuttersControl</code>
Dies bewirkt neben der Anlage des Devices selbst auch, dass als weiteres globales Attribut ''AutoShuttersControl'' verfügbar wird.

=== Einstellung zentraler Vorgaben ===
Es stehen am ASC-Device einige Attribute zur Verfügung, über die sich das Verhalten des ASC-Devices insgesamt steuern läßt, z.B. zur Vermeidung von morgendlichen oder abendlichen Fahrten sowie bei Gefahr von Schäden an den Rollläden durch Frost oder zur Reaktion auf Fensterkontakte. Details sind der Commandref zu entnehmen.
Diese können auch nachträglich noch geändert werden.

=== Markieren zu steuernder Rollladen-Devices ===
Um einen oder mehrere Rollläden durch das ASC-Device zu steuern, wird für jeden Rollladen jeweils das neue globale Attribut ''AutoShuttersControl'' gesetzt. Der Wert ist mit 1 oder 2 festzulegen, wobei '''1''' bedeutet, dass
* die Offen-Position kleiner ist als die Geschlossen-Position, also typischerweise 0 ''offen'' bedeutet und 100 für ''geschlossen'' steht
* eine bestimmte Position mit '''position''' angefahren wird, also z.B. <code>set <name> position 70</code>.
Dies ist z.B. die passende Wahl für ROLLO-Devices

Die '''2''' steht für ein umgekehrtes Verhalten und den Befehlsteil ''pct'', also ''offen'' für <code>set <name> pct 100</code>. Typischer Vertreter dieses Typs sind HomeMatic (CUL_HM-) Geräte.

=== Einbinden in das ASC-Device ===
Nachdem man das obige Attribut bei einem oder mehreren Rollladen-Devices gesetzt hat, kann mit
<code>set <name> scanForShutters</code> ein Suchlauf gestartet werden, mit dem dann diese Rollläden durch das Modul gefunden und in die Steuerungslogik eingebunden werden.

=== Einstellen der individuellen Vorgaben ===
Danach sind jeweils an den Rollladen-Devices weitere Attribute verfügbar, mit denen die für den jeweiligen Rollladen geltenden Einstellungen vorgenommen werden können.
Die Beschreibung der Attribute ist in der commandref enthalten.

== Readings ==

===Readings im AutoShuttersControl Device selbst.===

{|class="wikitable"
|-
! Name !! Datentyp/ Wertebereich !! Bedeutung
|-
|..._nextAstroTimeEvent || ||Uhrzeit des nächsten Astro Events, Sonnenauf, Sonnenuntergang oder feste Zeit pro Rollonamen
|-
|..._lastPosValue || ||letzter abgesetzter Fahrbefehl pro Rollonamen
|-
|..._lastDelayPosValue || ||letzter abgesetzter Fahrbefehl welcher beim nächsten zulässigen Event ausgeführt wird.
|-
|partyMode ||on, off || aktiviert den globalen Partymodus, alle Rollläden welche das Attribut AutoShuttersControl_Partymode bei sich auf on gestellt haben werden nicht mehr gesteuert. Der letzte Schaltbefehle welcher durch ein Fensterevent oder Bewohnerstatus an die Rollläden gesendet wurde, wird beim off setzen durch set ASC-Device partyMode off ausgeführt
|-
|lockOut || on, off ||für das aktivieren des Aussperrschutzes gemäß dem entsprechenden Attribut AutoShuttersControl_lock-out im jeweiligen Rolladen. (siehe Beschreibung bei den Attributen für die Rolladendevices)
|-
|room_... || ||Auflistung aller Rollläden welche in den jeweiligen Rämen gefunden wurde, Bsp.: room_Schlafzimmer,Terrasse
|-
|state || ||Status des Devices active, enabled, disabled
|-
|sunriseTimeWeHoliday|| on,off ||wird das Rolladen Device Attribut Attributes AutoShuttersControl_Time_Up_WE_Holiday Beachtet oder nicht
|-
|userAttrList || rolled out ||Status der UserAttribute welche an die Rollläden gesendet werden
|}

===Readings in den Rolllädendevices===

{|class="wikitable"
|-
! Name !! Bedeutung
|-
|AutoShuttersControl_Time_Sunrise ||Sonnenaufgangszei für das Rollo
|-
|AutoShuttersControl_Time_Sunset ||Sonnenuntergangszeit für das Rollo
|}

== Settings ==

===Set Befehle für AutoShuttersControl Device===

{|class="wikitable"
|-
! Name !! Datentyp/ Wertebereich !! Beschreibung
|-
|partyMode ||on, off ||aktiviert den globalen Partymodus. Siehe Reading partyMode
|-
|lockOut ||on, off ||aktiviert den globalen Aussperrschutz. Siehe Reading partyMode
|-
|renewSetSunriseSunsetTimer || || erneuert bei allen Rollläden die Zeiten für Sunset und Sunrise und setzt die internen Timer neu.
|-
|scanForShutters || ||sucht alle FHEM Devices mit dem Attribut "AutoShuttersControl" 1/2
|-
|sunriseTimeWeHoliday || on,off ||aktiviert/deaktiviert die Beachtung des Rolladen Device Attributes AutoShuttersControl_Time_Up_WE_Holiday
|}

== Attribute ==

===Attribute im AutoShuttersControl Device selbst.===

{|class="wikitable"
|-
! Name !! Datentyp/ Wertebereich !! Default-Wert !! Beschreibung
|-
|AutoShuttersControl_antifreezeTemp || || ||Temperatur ab welcher der Frostschutz greifen soll und das Rollo nicht mehr fährt. Der letzte Fahrbefehl wird gespeichert.
|-
|AutoShuttersControl_autoAstroModeEvening ||aktuell REAL, CIVIL, NAUTIC, ASTRONOMIC || || (in genau dieser Schreibweise)
|-
|AutoShuttersControl_autoAstroModeEveningHorizon || || || Höhe über Horizont wenn beim Attribut AutoShuttersControl_autoAstroModeEvening HORIZON ausgewählt
|-
|AutoShuttersControl_autoAstroModeMorning ||aktuell REAL, CIVIL, NAUTIC, ASTRONOMIC || ||(in genau dieser Schreibweise)
|-
|AutoShuttersControl_autoAstroModeMorningHorizon || || ||Höhe über Horizont wenn beim Attribut AutoShuttersControl_autoAstroModeMorning HORIZON ausgewählt
|-
|AutoShuttersControl_autoShuttersControlComfort ||on, off || ||schaltet die Komfortfunktion an. Bedeutet das ein Rollladen mit einem threestate Sensor am Fenster beim öffnen in eine weit offen Position fährt. Die Offenposition wird beim Rollladen über das Attribut AutoShuttersControl_Pos_after_ComfortOpen eingestellt.
|-
|AutoShuttersControl_autoShuttersControlEvening ||on, off || ||ob Abends die Rollläden automatisch nach Zeit gesteuert werden sollen
|-
|AutoShuttersControl_autoShuttersControlMorning ||on, off || ||ob Morgens die Rollläden automatisch nach Zeit gesteuert werden sollen
|-
|AutoShuttersControl_temperatureReading || || ||Reading für die Aussentemperatur
|-
|AutoShuttersControl_temperatureSensor || || ||Device für die Aussentemperatur
|-
|AutoShuttersControl_timeUpHolidayDevice || || ||Device zur Urlaubserkennung oder Sonstiges / muss 0 oder 1 im Reading state beinhalten.
|}

===Attribute in den Rolllädendevices===

{|class="wikitable"
|-
! Name !! Datentyp/ Wertebereich !! Default-Wert !! Beschreibung
|-
|AutoShuttersControl || 0, 1, 2 || ||1 = "Inverse oder Rollo Bsp.: Rollo Oben 0, Rollo Unten 100 und der Befehl zum Prozentualen fahren ist position", 2 = "Homematic Style Bsp.: Rollo Oben 100, Rollo Unten 0 und der Befehl zum Prozentualen fahren ist pct
|-
|AutoShuttersControl_Antifreeze ||on, off || ||Frostschutz an oder aus
|-
|AutoShuttersControl_AutoAstroModeEvening ||aktuell REAL, CIVIL, NAUTIC, ASTRONOMIC || ||
|-
|AutoShuttersControl_AutoAstroModeEveningHorizon || || ||Höhe über Horizont wenn beim Attribut AutoShuttersControl_autoAstroModeEvening HORIZON ausgewählt
|-
|AutoShuttersControl_AutoAstroModeMorning ||aktuell REAL, CIVIL, NAUTIC, ASTRONOMIC || ||
|-
|AutoShuttersControl_AutoAstroModeMorningHorizon || || ||Höhe über Horizont wenn beim Attribut AutoShuttersControl_autoAstroModeMorning HORIZON ausgewählt
|-
|AutoShuttersControl_Closed_Pos || || ||in 10 Schritten von 0 bis 100, default Vorgabe ist abhängig vom Attribut AutoShuttersControl
|-
|AutoShuttersControl_Down ||astro, time || ||bei Astro wird Sonnenuntergang berechnet, bei time wird der Wert aus AutoShuttersControl_Time_Down_Early als Fahrzeit verwendet
|-
|AutoShuttersControl_Mode_Down ||always, absent, off || ||wann darf die Automatik steuern. immer, niemals, bei abwesenheit des Roomate (ist kein Roommate und absent eingestellt wird gar nicht gesteuert)
|-
|AutoShuttersControl_Mode_Up ||always, absent, off || ||wann darf die Automatik steuern. immer, niemals, bei abwesenheit des Roomate (ist kein Roommate und absent eingestellt wird gar nicht gesteuert)
|-
|AutoShuttersControl_Offset_Minutes_Evening || || ||maximale zufällige Verzögerung in Minuten (minimal 1) bei der Berechnung der Fahrzeiten für Abends
|-
|AutoShuttersControl_Offset_Minutes_Morning || || ||maximale zufällige Verzögerung in Minuten (minimal 1) bei der Berechnung der Fahrzeiten für Morgens
|-
|AutoShuttersControl_Open_Pos || || ||in 10 Schritten von 0 bis 100, default Vorgabe ist abhängig vom Attribut AutoShuttersControl
|-
|AutoShuttersControl_Partymode ||on, off || ||schaltet den Partymodus an oder aus, Wird dann am ASC Device set ASC-DEVICE partyMode on geschalten, werden alle Fahrbefehle an den Rollläden welche das Attribut auf on haben zwischen gespeichert und später erst ausgeführt
|-
|AutoShuttersControl_Pos_Cmd || || ||der set Befehl um den Rollladen in Prozent Angaben zu fahren, muss der selbe sein wie das Reading welches die Position des Rollladen in Prozent an gibt
|-
|AutoShuttersControl_Pos_after_ComfortOpen || || ||in 10 Schritten von 0 bis 100, default Vorgabe ist abhängig vom Attribut AutoShuttersControl
|-
|AutoShuttersControl_Roommate_Reading || || ||das Reading zum Roommate Device welches den Status wieder gibt
|-
|AutoShuttersControl_Roommate_Device || || ||Name des Roommate Devices welcher den Bewohner des Raumes vom Rollladen wieder gibt
|-
|AutoShuttersControl_Time_Down_Early || || ||Sunset frühste Zeit zum runter fahren
|-
|AutoShuttersControl_Time_Down_Late || || ||Sunset späteste Zeit zum runter fahren
|-
|AutoShuttersControl_Time_Up_Early || || ||Sunrise frühste Zeit zum hoch fahren
|-
|AutoShuttersControl_Time_Up_Late || || ||Sunrise späteste Zeit zum hoch fahren
|-
|AutoShuttersControl_Time_Up_WE_Holiday || || ||Sunrise frühste Zeit zum hochfahren am Wochenende und/oder Urlaub (we2holiday wird beachtet), Achtung sollte nicht größer sein wie AutoShuttersControl_Time_Up_Late sonst wird AutoShuttersControl_Time_Up_Late verwendet
|-
|AutoShuttersControl_Up ||astro, time || ||bei Astro wird Sonnenaufgang berechnet, bei time wird der Wert aus AutoShuttersControl_Time_Up_Early als Fahrzeit verwendet
|-
|AutoShuttersControl_Ventilate_Pos || || ||in 10 Schritten von 0 bis 100, default Vorgabe ist abhängig vom Attribut AutoShuttersControl
|-
|AutoShuttersControl_Ventilate_Window_Open || || ||auf lüften, wenn das Fenster gekippt/geöffnet wird und aktuelle Position unterhalb der Lüften-Position ist
|-
|AutoShuttersControl_WindowRec || || ||Name des Fensterkontaktes an welchen Fenster der Rolladen angebracht ist
|-
|AutoShuttersControl_WindowRec_subType || || ||Typ des verwendeten Fensterkontakts: twostate (optisch oder magnetisch) oder threestate (Drehgriffkontakt)
|-
|AutoShuttersControl_lock-out ||soft, hard || ||stellt entsprechend den Aussperrschutz ein. Bei global aktiven Aussperrschutz (set ASC-Device lockOut soft) und einem Fensterkontakt open bleibt dann der Rolladen oben. Dies gilt nur bei Steuerbefehle über das ASC Modul. Stellt man global auf hard, wird bei entsprechender Möglichkeit versucht den Rolladen Hardwareseitig zu blockieren. Dann ist auch ein fahren über die Taster nicht mehr möglich.
|-
|AutoShuttersControl_lock-outCmd ||inhibit, blocked || ||set Befehl für das Rolladen-Device zum Hardware sperren. Zum gesetzt werden wenn man "AutoShuttersControl_lock-out" auf hard setzt
|-
| || || ||
|-
|}

== Hilfsmittel ==
tbd

readingsGroup, um die diversen Level einzustellen:

define rg_ASC_Rollaeden_Level readingsGroup <Gerät>,<Closed_Pos>,<Open_Pos>,<Shading_Pos>,<Ventilate_Pos> (Rolladen_.*|Jalousie_.*)..:?AutoShuttersControl_Closed_Pos,?AutoShuttersControl_Open_Pos,?AutoShuttersControl_Shading_Pos,?AutoShuttesControl_Ventilate_Pos
attr rg_ASC_Rollaeden_Level commands { AutoShuttersControl_Closed_Pos => 'AutoShuttersControl_Closed_Pos:0,10,20,30,35,40,45,50,55,60,65,70,75,80,85,90,95,100',\
AutoShuttersControl_Open_Pos => 'AutoShuttersControl_Open_Pos:0,10,20,30,35,40,45,50,55,60,65,70,75,80,85,90,95,100',\
AutoShuttersControl_Shading_Pos => 'AutoShuttersControl_Shading_Pos:0,10,20,30,35,40,45,50,55,60,65,70,75,80,85,90,95,100',\
AutoShuttersControl_Ventilate_Pos => 'AutoShuttersControl_Ventilate_Pos:0,10,20,30,35,40,45,50,55,60,65,70,75,80,85,90,95,100'}
[[Datei:ReadingsGroup ASC Level.png|600px|]]
readingsGroup, um die diversen Zeiten einzustellen:

define rg_ASC_Rollaeden_Times readingsGroup <Gerät>,<Stand>,<Time_Up_Early>,<Time_Up_WE>,<Time_Up_Late>,<Time_Down_Early>,Time_Down_Late>,<Mode_Down>,<Mode_Up> (Rolladen_.*|Jalousie_.*)..:level,?AutoShuttersControl_Time_Up_Early,?AutoShuttersControl_Time_Up_WE_Holiday,?AutoShuttersControl_Time_Up_Late,?AutoShuttersControl_Time_Down_Early,?AutoShuttersControl_Time_Down_Late,?AutoShuttersControl_Mode_Down,?AutoShuttersControl_Mode_Up
attr rg_ASC_Rollaeden_Times commands {level => 'pct:0,10,20,30,35,40,45,50,55,60,65,70,75,80,85,90,95,100', \
AutoShuttersControl_Mode_Down => 'AutoShuttersControl_Mode_Down:always,absent,off',\
AutoShuttersControl_Mode_Up => 'AutoShuttersControl_Mode_Up:always,absent,off',\
AutoShuttersControl_Time_Down_Early => 'AutoShuttersControl_Time_Down_Early:15:00,15:15,15:30,15:45,16:00,16:15,16:30,16:45,17:00,17:15,17:30,17:45,18:00,18:15,18:30,18:45,19:00,19:15,19:30,19:45,20:00,20:15,20:30,20:45,21:00,21:15,21:30,21:45,22:00', \
AutoShuttersControl_Time_Down_Late => 'AutoShuttersControl_Time_Down_Late:20:15,20:30,20:45,21:00,21:15,21:30,21:45,22:00,22:15,22:30,22:45,23:00,23:15,23:30',\
AutoShuttersControl_Time_Up_Early => 'AutoShuttersControl_Time_Up_Early:05:00,05:05,05:30,05:45,06:00,06:15,06:30,06:45,07:00,07:15,07:30,07:45,08:00,08:15,08:30,08:45,09:00,09:15,09:30,09:45,10:00', \
AutoShuttersControl_Time_Up_Late =>'AutoShuttersControl_Time_Up_Late:06:00,06:15,06:30,06:45,07:00,07:15,07:30,07:45,08:00,08:15,08:30,08:45,09:00,09:15,09:30,09:45,10:00',AutoShuttersControl_Time_Up_WE_Holiday => 'AutoShuttersControl_Time_Up_WE_Holiday:06:00,06:15,06:30,06:45,07:00,07:15,07:30,07:45,08:00,08:15,08:30,08:45,09:00,09:15,09:30,09:45,10:00'}
[[Datei:ReadingsGroup ASC Times.png|600px|]]

== Weblinks ==
* {{Link2Forum|Topic=90751|LinkText="Thread zur Entwicklung im Forum"}}
* {{Link2Forum|Topic=73964|LinkText="Thread zu den Scripten von user cluni"}}, die der Entwicklung des Moduls zugrunde liegen

[[Kategorie:Codeschnipsel]]

AutoShuttersControl

2018-09-18T09:08:05Z

CoolTux: /* Set Befehle für AutoShuttersControl Device */

{{Baustelle}}
{{Infobox Modul
|ModPurpose=Steuerung von Rollläden
|ModCategory=Automatisierung
|ModType=x

|ModForumArea=Automatisierung
|ModTechName=73_AutoShuttersControl.pm
|ModOwner=CoolTux}}
Mit [[AutoShuttersControl]] oder kurz ASC können typische Aufgabenstellungen im Zusammenhang mit Rollläden u.ä. automatisiert werden, wie zum Beispiel das Öffnen bei Sonnenaufgang, Schließen bei Sonnenuntergang oder das Anfahren von Lüftungspositionen beim Öffnen des zugehörigen Fensters.

{{Hinweis|Das Modul befindet sich derzeit noch in der Entwicklung; der jeweils aktuelle Stand ist diesem {{Link2Forum|Topic=90751|LinkText="Thread im Forum"}} zu entnehmen.}}

== Basics ==
Zur Nutzung des Moduls sollten folgende andere FHEM-Devices vorhanden sein:
* Rollläden
* Fensterkontakte und
* Bewohnerstatus auf Basis von Residents/Roomates in englisch. Ersatzweise andere Devices, z.B. Dummys, welche als ''state'' ''home'', ''asleep'', ''gotosleep'' und ''awoken'' setzen sowie ein Reading ''lastState''.

Die Einrichtung des Moduls bzw. dessen Funktionalität erfolgt in mehreren Schritten:
* Definition des ASC-Devices
* Einstellung zentraler Vorgaben am ASC-Device
* Markieren der zukünftig zu steuernden Rollladen-Devices
* Einbinden der Rollladen-Devices in das ASC-Device
* Einstellen der individuellen Vorgaben je Rollladen (am Rollladen-Device)

== Einrichtung ==

=== Vorbereitung ===

{{Hinweis|Ihr benötigt ein aktuelles FHEM. Update ab dem 04.09.2018 Voraussetzung!}}

Zunächst muß das Modul aus dem Link im Forum entpackt werden und die Datei 73_AutoShuttersControl.pm in das Unterverzeichnis für die Module kopiert werden und die Rechte angepaßt.

Speicherort für Linux-Standardinstallationen: /opt/fhem/FHEM
Rechte: <code>sudo chown 73_AutoShuttersControl.pm</code> und <code>sudo chmod 644 73_AutoShuttersControl.pm</code>

Danach sollte ein <code>reload AutoShuttersControl</code> in FHEM-Eingabefeld ausreichen, um das Modul verfügbar zu machen.

{{Hinweis|Eventuell muß FHEM auch einmalig neu gestartet werden, um das Modul nutzen zu können.}}

=== Define des ASC-Devices ===
Es genügt ein einfaches define ohne weitere Parameter.
<code>define <name> AutoShuttersControl</code>
Dies bewirkt neben der Anlage des Devices selbst auch, dass als weiteres globales Attribut ''AutoShuttersControl'' verfügbar wird.

=== Einstellung zentraler Vorgaben ===
Es stehen am ASC-Device einige Attribute zur Verfügung, über die sich das Verhalten des ASC-Devices insgesamt steuern läßt, z.B. zur Vermeidung von morgendlichen oder abendlichen Fahrten sowie bei Gefahr von Schäden an den Rollläden durch Frost oder zur Reaktion auf Fensterkontakte. Details sind der Commandref zu entnehmen.
Diese können auch nachträglich noch geändert werden.

=== Markieren zu steuernder Rollladen-Devices ===
Um einen oder mehrere Rollläden durch das ASC-Device zu steuern, wird für jeden Rollladen jeweils das neue globale Attribut ''AutoShuttersControl'' gesetzt. Der Wert ist mit 1 oder 2 festzulegen, wobei '''1''' bedeutet, dass
* die Offen-Position kleiner ist als die Geschlossen-Position, also typischerweise 0 ''offen'' bedeutet und 100 für ''geschlossen'' steht
* eine bestimmte Position mit '''position''' angefahren wird, also z.B. <code>set <name> position 70</code>.
Dies ist z.B. die passende Wahl für ROLLO-Devices

Die '''2''' steht für ein umgekehrtes Verhalten und den Befehlsteil ''pct'', also ''offen'' für <code>set <name> pct 100</code>. Typischer Vertreter dieses Typs sind HomeMatic (CUL_HM-) Geräte.

=== Einbinden in das ASC-Device ===
Nachdem man das obige Attribut bei einem oder mehreren Rollladen-Devices gesetzt hat, kann mit
<code>set <name> scanForShutters</code> ein Suchlauf gestartet werden, mit dem dann diese Rollläden durch das Modul gefunden und in die Steuerungslogik eingebunden werden.

=== Einstellen der individuellen Vorgaben ===
Danach sind jeweils an den Rollladen-Devices weitere Attribute verfügbar, mit denen die für den jeweiligen Rollladen geltenden Einstellungen vorgenommen werden können.
Die Beschreibung der Attribute ist in der commandref enthalten.

== Readings ==

===Readings im AutoShuttersControl Device selbst.===

{|class="wikitable"
|-
! Name !! Datentyp/ Wertebereich !! Bedeutung
|-
|..._nextAstroTimeEvent || ||Uhrzeit des nächsten Astro Events, Sonnenauf, Sonnenuntergang oder feste Zeit pro Rollonamen
|-
|..._lastPosValue || ||letzter abgesetzter Fahrbefehl pro Rollonamen
|-
|..._lastDelayPosValue || ||letzter abgesetzter Fahrbefehl welcher beim nächsten zulässigen Event ausgeführt wird.
|-
|partyMode ||on, off || aktiviert den globalen Partymodus, alle Rollläden welche das Attribut AutoShuttersControl_Partymode bei sich auf on gestellt haben werden nicht mehr gesteuert. Der letzte Schaltbefehle welcher durch ein Fensterevent oder Bewohnerstatus an die Rollläden gesendet wurde, wird beim off setzen durch set ASC-Device partyMode off ausgeführt
|-
|lockOut || on, off ||für das aktivieren des Aussperrschutzes gemäß dem entsprechenden Attribut AutoShuttersControl_lock-out im jeweiligen Rolladen. (siehe Beschreibung bei den Attributen für die Rolladendevices)
|-
|room_... || ||Auflistung aller Rollläden welche in den jeweiligen Rämen gefunden wurde, Bsp.: room_Schlafzimmer,Terrasse
|-
|state || ||Status des Devices active, enabled, disabled
|-
|sunriseTimeWeHoliday|| on,off ||aktiviert/deaktiviert die Beachtung des Rolladen Device Attributes AutoShuttersControl_Time_Up_WE_Holiday
|-
|userAttrList || rolled out ||Status der UserAttribute welche an die Rollläden gesendet werden
|}

===Readings in den Rolllädendevices===

{|class="wikitable"
|-
! Name !! Bedeutung
|-
|AutoShuttersControl_Time_Sunrise ||Sonnenaufgangszei für das Rollo
|-
|AutoShuttersControl_Time_Sunset ||Sonnenuntergangszeit für das Rollo
|}

== Settings ==

===Set Befehle für AutoShuttersControl Device===

{|class="wikitable"
|-
! Name !! Datentyp/ Wertebereich !! Beschreibung
|-
|partyMode ||on, off ||aktiviert den globalen Partymodus. Siehe Reading partyMode
|-
|lockOut ||on, off ||aktiviert den globalen Aussperrschutz. Siehe Reading partyMode
|-
|renewSetSunriseSunsetTimer || || erneuert bei allen Rollläden die Zeiten für Sunset und Sunrise und setzt die internen Timer neu.
|-
|scanForShutters || ||sucht alle FHEM Devices mit dem Attribut "AutoShuttersControl" 1/2
|-
|sunriseTimeWeHoliday || on,off ||aktiviert/deaktiviert die Beachtung des Rolladen Device Attributes AutoShuttersControl_Time_Up_WE_Holiday
|}

== Attribute ==

===Attribute im AutoShuttersControl Device selbst.===

{|class="wikitable"
|-
! Name !! Datentyp/ Wertebereich !! Default-Wert !! Beschreibung
|-
|AutoShuttersControl_antifreezeTemp || || ||Temperatur ab welcher der Frostschutz greifen soll und das Rollo nicht mehr fährt. Der letzte Fahrbefehl wird gespeichert.
|-
|AutoShuttersControl_autoAstroModeEvening ||aktuell REAL, CIVIL, NAUTIC, ASTRONOMIC || || (in genau dieser Schreibweise)
|-
|AutoShuttersControl_autoAstroModeEveningHorizon || || || Höhe über Horizont wenn beim Attribut AutoShuttersControl_autoAstroModeEvening HORIZON ausgewählt
|-
|AutoShuttersControl_autoAstroModeMorning ||aktuell REAL, CIVIL, NAUTIC, ASTRONOMIC || ||(in genau dieser Schreibweise)
|-
|AutoShuttersControl_autoAstroModeMorningHorizon || || ||Höhe über Horizont wenn beim Attribut AutoShuttersControl_autoAstroModeMorning HORIZON ausgewählt
|-
|AutoShuttersControl_autoShuttersControlComfort ||on, off || ||schaltet die Komfortfunktion an. Bedeutet das ein Rollladen mit einem threestate Sensor am Fenster beim öffnen in eine weit offen Position fährt. Die Offenposition wird beim Rollladen über das Attribut AutoShuttersControl_Pos_after_ComfortOpen eingestellt.
|-
|AutoShuttersControl_autoShuttersControlEvening ||on, off || ||ob Abends die Rollläden automatisch nach Zeit gesteuert werden sollen
|-
|AutoShuttersControl_autoShuttersControlMorning ||on, off || ||ob Morgens die Rollläden automatisch nach Zeit gesteuert werden sollen
|-
|AutoShuttersControl_temperatureReading || || ||Reading für die Aussentemperatur
|-
|AutoShuttersControl_temperatureSensor || || ||Device für die Aussentemperatur
|-
|AutoShuttersControl_timeUpHolidayDevice || || ||Device zur Urlaubserkennung oder Sonstiges / muss 0 oder 1 im Reading state beinhalten.
|}

===Attribute in den Rolllädendevices===

{|class="wikitable"
|-
! Name !! Datentyp/ Wertebereich !! Default-Wert !! Beschreibung
|-
|AutoShuttersControl || 0, 1, 2 || ||1 = "Inverse oder Rollo Bsp.: Rollo Oben 0, Rollo Unten 100 und der Befehl zum Prozentualen fahren ist position", 2 = "Homematic Style Bsp.: Rollo Oben 100, Rollo Unten 0 und der Befehl zum Prozentualen fahren ist pct
|-
|AutoShuttersControl_Antifreeze ||on, off || ||Frostschutz an oder aus
|-
|AutoShuttersControl_AutoAstroModeEvening ||aktuell REAL, CIVIL, NAUTIC, ASTRONOMIC || ||
|-
|AutoShuttersControl_AutoAstroModeEveningHorizon || || ||Höhe über Horizont wenn beim Attribut AutoShuttersControl_autoAstroModeEvening HORIZON ausgewählt
|-
|AutoShuttersControl_AutoAstroModeMorning ||aktuell REAL, CIVIL, NAUTIC, ASTRONOMIC || ||
|-
|AutoShuttersControl_AutoAstroModeMorningHorizon || || ||Höhe über Horizont wenn beim Attribut AutoShuttersControl_autoAstroModeMorning HORIZON ausgewählt
|-
|AutoShuttersControl_Closed_Pos || || ||in 10 Schritten von 0 bis 100, default Vorgabe ist abhängig vom Attribut AutoShuttersControl
|-
|AutoShuttersControl_Down ||astro, time || ||bei Astro wird Sonnenuntergang berechnet, bei time wird der Wert aus AutoShuttersControl_Time_Down_Early als Fahrzeit verwendet
|-
|AutoShuttersControl_Mode_Down ||always, absent, off || ||wann darf die Automatik steuern. immer, niemals, bei abwesenheit des Roomate (ist kein Roommate und absent eingestellt wird gar nicht gesteuert)
|-
|AutoShuttersControl_Mode_Up ||always, absent, off || ||wann darf die Automatik steuern. immer, niemals, bei abwesenheit des Roomate (ist kein Roommate und absent eingestellt wird gar nicht gesteuert)
|-
|AutoShuttersControl_Offset_Minutes_Evening || || ||maximale zufällige Verzögerung in Minuten (minimal 1) bei der Berechnung der Fahrzeiten für Abends
|-
|AutoShuttersControl_Offset_Minutes_Morning || || ||maximale zufällige Verzögerung in Minuten (minimal 1) bei der Berechnung der Fahrzeiten für Morgens
|-
|AutoShuttersControl_Open_Pos || || ||in 10 Schritten von 0 bis 100, default Vorgabe ist abhängig vom Attribut AutoShuttersControl
|-
|AutoShuttersControl_Partymode ||on, off || ||schaltet den Partymodus an oder aus, Wird dann am ASC Device set ASC-DEVICE partyMode on geschalten, werden alle Fahrbefehle an den Rollläden welche das Attribut auf on haben zwischen gespeichert und später erst ausgeführt
|-
|AutoShuttersControl_Pos_Cmd || || ||der set Befehl um den Rollladen in Prozent Angaben zu fahren, muss der selbe sein wie das Reading welches die Position des Rollladen in Prozent an gibt
|-
|AutoShuttersControl_Pos_after_ComfortOpen || || ||in 10 Schritten von 0 bis 100, default Vorgabe ist abhängig vom Attribut AutoShuttersControl
|-
|AutoShuttersControl_Roommate_Reading || || ||das Reading zum Roommate Device welches den Status wieder gibt
|-
|AutoShuttersControl_Roommate_Device || || ||Name des Roommate Devices welcher den Bewohner des Raumes vom Rollladen wieder gibt
|-
|AutoShuttersControl_Time_Down_Early || || ||Sunset frühste Zeit zum runter fahren
|-
|AutoShuttersControl_Time_Down_Late || || ||Sunset späteste Zeit zum runter fahren
|-
|AutoShuttersControl_Time_Up_Early || || ||Sunrise frühste Zeit zum hoch fahren
|-
|AutoShuttersControl_Time_Up_Late || || ||Sunrise späteste Zeit zum hoch fahren
|-
|AutoShuttersControl_Time_Up_WE_Holiday || || ||Sunrise frühste Zeit zum hochfahren am Wochenende und/oder Urlaub (we2holiday wird beachtet), Achtung sollte nicht größer sein wie AutoShuttersControl_Time_Up_Late sonst wird AutoShuttersControl_Time_Up_Late verwendet
|-
|AutoShuttersControl_Up ||astro, time || ||bei Astro wird Sonnenaufgang berechnet, bei time wird der Wert aus AutoShuttersControl_Time_Up_Early als Fahrzeit verwendet
|-
|AutoShuttersControl_Ventilate_Pos || || ||in 10 Schritten von 0 bis 100, default Vorgabe ist abhängig vom Attribut AutoShuttersControl
|-
|AutoShuttersControl_Ventilate_Window_Open || || ||auf lüften, wenn das Fenster gekippt/geöffnet wird und aktuelle Position unterhalb der Lüften-Position ist
|-
|AutoShuttersControl_WindowRec || || ||Name des Fensterkontaktes an welchen Fenster der Rolladen angebracht ist
|-
|AutoShuttersControl_WindowRec_subType || || ||Typ des verwendeten Fensterkontakts: twostate (optisch oder magnetisch) oder threestate (Drehgriffkontakt)
|-
|AutoShuttersControl_lock-out ||soft, hard || ||stellt entsprechend den Aussperrschutz ein. Bei global aktiven Aussperrschutz (set ASC-Device lockOut soft) und einem Fensterkontakt open bleibt dann der Rolladen oben. Dies gilt nur bei Steuerbefehle über das ASC Modul. Stellt man global auf hard, wird bei entsprechender Möglichkeit versucht den Rolladen Hardwareseitig zu blockieren. Dann ist auch ein fahren über die Taster nicht mehr möglich.
|-
|AutoShuttersControl_lock-outCmd ||inhibit, blocked || ||set Befehl für das Rolladen-Device zum Hardware sperren. Zum gesetzt werden wenn man "AutoShuttersControl_lock-out" auf hard setzt
|-
| || || ||
|-
|}

== Hilfsmittel ==
tbd

readingsGroup, um die diversen Level einzustellen:

define rg_ASC_Rollaeden_Level readingsGroup <Gerät>,<Closed_Pos>,<Open_Pos>,<Shading_Pos>,<Ventilate_Pos> (Rolladen_.*|Jalousie_.*)..:?AutoShuttersControl_Closed_Pos,?AutoShuttersControl_Open_Pos,?AutoShuttersControl_Shading_Pos,?AutoShuttesControl_Ventilate_Pos
attr rg_ASC_Rollaeden_Level commands { AutoShuttersControl_Closed_Pos => 'AutoShuttersControl_Closed_Pos:0,10,20,30,35,40,45,50,55,60,65,70,75,80,85,90,95,100',\
AutoShuttersControl_Open_Pos => 'AutoShuttersControl_Open_Pos:0,10,20,30,35,40,45,50,55,60,65,70,75,80,85,90,95,100',\
AutoShuttersControl_Shading_Pos => 'AutoShuttersControl_Shading_Pos:0,10,20,30,35,40,45,50,55,60,65,70,75,80,85,90,95,100',\
AutoShuttersControl_Ventilate_Pos => 'AutoShuttersControl_Ventilate_Pos:0,10,20,30,35,40,45,50,55,60,65,70,75,80,85,90,95,100'}
[[Datei:ReadingsGroup ASC Level.png|600px|]]
readingsGroup, um die diversen Zeiten einzustellen:

define rg_ASC_Rollaeden_Times readingsGroup <Gerät>,<Stand>,<Time_Up_Early>,<Time_Up_WE>,<Time_Up_Late>,<Time_Down_Early>,Time_Down_Late>,<Mode_Down>,<Mode_Up> (Rolladen_.*|Jalousie_.*)..:level,?AutoShuttersControl_Time_Up_Early,?AutoShuttersControl_Time_Up_WE_Holiday,?AutoShuttersControl_Time_Up_Late,?AutoShuttersControl_Time_Down_Early,?AutoShuttersControl_Time_Down_Late,?AutoShuttersControl_Mode_Down,?AutoShuttersControl_Mode_Up
attr rg_ASC_Rollaeden_Times commands {level => 'pct:0,10,20,30,35,40,45,50,55,60,65,70,75,80,85,90,95,100', \
AutoShuttersControl_Mode_Down => 'AutoShuttersControl_Mode_Down:always,absent,off',\
AutoShuttersControl_Mode_Up => 'AutoShuttersControl_Mode_Up:always,absent,off',\
AutoShuttersControl_Time_Down_Early => 'AutoShuttersControl_Time_Down_Early:15:00,15:15,15:30,15:45,16:00,16:15,16:30,16:45,17:00,17:15,17:30,17:45,18:00,18:15,18:30,18:45,19:00,19:15,19:30,19:45,20:00,20:15,20:30,20:45,21:00,21:15,21:30,21:45,22:00', \
AutoShuttersControl_Time_Down_Late => 'AutoShuttersControl_Time_Down_Late:20:15,20:30,20:45,21:00,21:15,21:30,21:45,22:00,22:15,22:30,22:45,23:00,23:15,23:30',\
AutoShuttersControl_Time_Up_Early => 'AutoShuttersControl_Time_Up_Early:05:00,05:05,05:30,05:45,06:00,06:15,06:30,06:45,07:00,07:15,07:30,07:45,08:00,08:15,08:30,08:45,09:00,09:15,09:30,09:45,10:00', \
AutoShuttersControl_Time_Up_Late =>'AutoShuttersControl_Time_Up_Late:06:00,06:15,06:30,06:45,07:00,07:15,07:30,07:45,08:00,08:15,08:30,08:45,09:00,09:15,09:30,09:45,10:00',AutoShuttersControl_Time_Up_WE_Holiday => 'AutoShuttersControl_Time_Up_WE_Holiday:06:00,06:15,06:30,06:45,07:00,07:15,07:30,07:45,08:00,08:15,08:30,08:45,09:00,09:15,09:30,09:45,10:00'}
[[Datei:ReadingsGroup ASC Times.png|600px|]]

== Weblinks ==
* {{Link2Forum|Topic=90751|LinkText="Thread zur Entwicklung im Forum"}}
* {{Link2Forum|Topic=73964|LinkText="Thread zu den Scripten von user cluni"}}, die der Entwicklung des Moduls zugrunde liegen

[[Kategorie:Codeschnipsel]]

AutoShuttersControl

2018-09-18T09:07:16Z

CoolTux: /* Readings im AutoShuttersControl Device selbst. */

{{Baustelle}}
{{Infobox Modul
|ModPurpose=Steuerung von Rollläden
|ModCategory=Automatisierung
|ModType=x

|ModForumArea=Automatisierung
|ModTechName=73_AutoShuttersControl.pm
|ModOwner=CoolTux}}
Mit [[AutoShuttersControl]] oder kurz ASC können typische Aufgabenstellungen im Zusammenhang mit Rollläden u.ä. automatisiert werden, wie zum Beispiel das Öffnen bei Sonnenaufgang, Schließen bei Sonnenuntergang oder das Anfahren von Lüftungspositionen beim Öffnen des zugehörigen Fensters.

{{Hinweis|Das Modul befindet sich derzeit noch in der Entwicklung; der jeweils aktuelle Stand ist diesem {{Link2Forum|Topic=90751|LinkText="Thread im Forum"}} zu entnehmen.}}

== Basics ==
Zur Nutzung des Moduls sollten folgende andere FHEM-Devices vorhanden sein:
* Rollläden
* Fensterkontakte und
* Bewohnerstatus auf Basis von Residents/Roomates in englisch. Ersatzweise andere Devices, z.B. Dummys, welche als ''state'' ''home'', ''asleep'', ''gotosleep'' und ''awoken'' setzen sowie ein Reading ''lastState''.

Die Einrichtung des Moduls bzw. dessen Funktionalität erfolgt in mehreren Schritten:
* Definition des ASC-Devices
* Einstellung zentraler Vorgaben am ASC-Device
* Markieren der zukünftig zu steuernden Rollladen-Devices
* Einbinden der Rollladen-Devices in das ASC-Device
* Einstellen der individuellen Vorgaben je Rollladen (am Rollladen-Device)

== Einrichtung ==

=== Vorbereitung ===

{{Hinweis|Ihr benötigt ein aktuelles FHEM. Update ab dem 04.09.2018 Voraussetzung!}}

Zunächst muß das Modul aus dem Link im Forum entpackt werden und die Datei 73_AutoShuttersControl.pm in das Unterverzeichnis für die Module kopiert werden und die Rechte angepaßt.

Speicherort für Linux-Standardinstallationen: /opt/fhem/FHEM
Rechte: <code>sudo chown 73_AutoShuttersControl.pm</code> und <code>sudo chmod 644 73_AutoShuttersControl.pm</code>

Danach sollte ein <code>reload AutoShuttersControl</code> in FHEM-Eingabefeld ausreichen, um das Modul verfügbar zu machen.

{{Hinweis|Eventuell muß FHEM auch einmalig neu gestartet werden, um das Modul nutzen zu können.}}

=== Define des ASC-Devices ===
Es genügt ein einfaches define ohne weitere Parameter.
<code>define <name> AutoShuttersControl</code>
Dies bewirkt neben der Anlage des Devices selbst auch, dass als weiteres globales Attribut ''AutoShuttersControl'' verfügbar wird.

=== Einstellung zentraler Vorgaben ===
Es stehen am ASC-Device einige Attribute zur Verfügung, über die sich das Verhalten des ASC-Devices insgesamt steuern läßt, z.B. zur Vermeidung von morgendlichen oder abendlichen Fahrten sowie bei Gefahr von Schäden an den Rollläden durch Frost oder zur Reaktion auf Fensterkontakte. Details sind der Commandref zu entnehmen.
Diese können auch nachträglich noch geändert werden.

=== Markieren zu steuernder Rollladen-Devices ===
Um einen oder mehrere Rollläden durch das ASC-Device zu steuern, wird für jeden Rollladen jeweils das neue globale Attribut ''AutoShuttersControl'' gesetzt. Der Wert ist mit 1 oder 2 festzulegen, wobei '''1''' bedeutet, dass
* die Offen-Position kleiner ist als die Geschlossen-Position, also typischerweise 0 ''offen'' bedeutet und 100 für ''geschlossen'' steht
* eine bestimmte Position mit '''position''' angefahren wird, also z.B. <code>set <name> position 70</code>.
Dies ist z.B. die passende Wahl für ROLLO-Devices

Die '''2''' steht für ein umgekehrtes Verhalten und den Befehlsteil ''pct'', also ''offen'' für <code>set <name> pct 100</code>. Typischer Vertreter dieses Typs sind HomeMatic (CUL_HM-) Geräte.

=== Einbinden in das ASC-Device ===
Nachdem man das obige Attribut bei einem oder mehreren Rollladen-Devices gesetzt hat, kann mit
<code>set <name> scanForShutters</code> ein Suchlauf gestartet werden, mit dem dann diese Rollläden durch das Modul gefunden und in die Steuerungslogik eingebunden werden.

=== Einstellen der individuellen Vorgaben ===
Danach sind jeweils an den Rollladen-Devices weitere Attribute verfügbar, mit denen die für den jeweiligen Rollladen geltenden Einstellungen vorgenommen werden können.
Die Beschreibung der Attribute ist in der commandref enthalten.

== Readings ==

===Readings im AutoShuttersControl Device selbst.===

{|class="wikitable"
|-
! Name !! Datentyp/ Wertebereich !! Bedeutung
|-
|..._nextAstroTimeEvent || ||Uhrzeit des nächsten Astro Events, Sonnenauf, Sonnenuntergang oder feste Zeit pro Rollonamen
|-
|..._lastPosValue || ||letzter abgesetzter Fahrbefehl pro Rollonamen
|-
|..._lastDelayPosValue || ||letzter abgesetzter Fahrbefehl welcher beim nächsten zulässigen Event ausgeführt wird.
|-
|partyMode ||on, off || aktiviert den globalen Partymodus, alle Rollläden welche das Attribut AutoShuttersControl_Partymode bei sich auf on gestellt haben werden nicht mehr gesteuert. Der letzte Schaltbefehle welcher durch ein Fensterevent oder Bewohnerstatus an die Rollläden gesendet wurde, wird beim off setzen durch set ASC-Device partyMode off ausgeführt
|-
|lockOut || on, off ||für das aktivieren des Aussperrschutzes gemäß dem entsprechenden Attribut AutoShuttersControl_lock-out im jeweiligen Rolladen. (siehe Beschreibung bei den Attributen für die Rolladendevices)
|-
|room_... || ||Auflistung aller Rollläden welche in den jeweiligen Rämen gefunden wurde, Bsp.: room_Schlafzimmer,Terrasse
|-
|state || ||Status des Devices active, enabled, disabled
|-
|sunriseTimeWeHoliday|| on,off ||aktiviert/deaktiviert die Beachtung des Rolladen Device Attributes AutoShuttersControl_Time_Up_WE_Holiday
|-
|userAttrList || rolled out ||Status der UserAttribute welche an die Rollläden gesendet werden
|}

===Readings in den Rolllädendevices===

{|class="wikitable"
|-
! Name !! Bedeutung
|-
|AutoShuttersControl_Time_Sunrise ||Sonnenaufgangszei für das Rollo
|-
|AutoShuttersControl_Time_Sunset ||Sonnenuntergangszeit für das Rollo
|}

== Settings ==

===Set Befehle für AutoShuttersControl Device===

{|class="wikitable"
|-
! Name !! Datentyp/ Wertebereich !! Beschreibung
|-
|partyMode ||on, off ||aktiviert den globalen Partymodus. Siehe Reading partyMode
|-
|lockOut ||on, off ||aktiviert den globalen Aussperrschutz. Siehe Reading partyMode
|-
|renewSetSunriseSunsetTimer || || erneuert bei allen Rollläden die Zeiten für Sunset und Sunrise und setzt die internen Timer neu.
|-
|scanForShutters || ||sucht alle FHEM Devices mit dem Attribut "AutoShuttersControl" 1/2
|-
|sunriseTimeWeHoliday || ||
|}

== Attribute ==

===Attribute im AutoShuttersControl Device selbst.===

{|class="wikitable"
|-
! Name !! Datentyp/ Wertebereich !! Default-Wert !! Beschreibung
|-
|AutoShuttersControl_antifreezeTemp || || ||Temperatur ab welcher der Frostschutz greifen soll und das Rollo nicht mehr fährt. Der letzte Fahrbefehl wird gespeichert.
|-
|AutoShuttersControl_autoAstroModeEvening ||aktuell REAL, CIVIL, NAUTIC, ASTRONOMIC || || (in genau dieser Schreibweise)
|-
|AutoShuttersControl_autoAstroModeEveningHorizon || || || Höhe über Horizont wenn beim Attribut AutoShuttersControl_autoAstroModeEvening HORIZON ausgewählt
|-
|AutoShuttersControl_autoAstroModeMorning ||aktuell REAL, CIVIL, NAUTIC, ASTRONOMIC || ||(in genau dieser Schreibweise)
|-
|AutoShuttersControl_autoAstroModeMorningHorizon || || ||Höhe über Horizont wenn beim Attribut AutoShuttersControl_autoAstroModeMorning HORIZON ausgewählt
|-
|AutoShuttersControl_autoShuttersControlComfort ||on, off || ||schaltet die Komfortfunktion an. Bedeutet das ein Rollladen mit einem threestate Sensor am Fenster beim öffnen in eine weit offen Position fährt. Die Offenposition wird beim Rollladen über das Attribut AutoShuttersControl_Pos_after_ComfortOpen eingestellt.
|-
|AutoShuttersControl_autoShuttersControlEvening ||on, off || ||ob Abends die Rollläden automatisch nach Zeit gesteuert werden sollen
|-
|AutoShuttersControl_autoShuttersControlMorning ||on, off || ||ob Morgens die Rollläden automatisch nach Zeit gesteuert werden sollen
|-
|AutoShuttersControl_temperatureReading || || ||Reading für die Aussentemperatur
|-
|AutoShuttersControl_temperatureSensor || || ||Device für die Aussentemperatur
|-
|AutoShuttersControl_timeUpHolidayDevice || || ||Device zur Urlaubserkennung oder Sonstiges / muss 0 oder 1 im Reading state beinhalten.
|}

===Attribute in den Rolllädendevices===

{|class="wikitable"
|-
! Name !! Datentyp/ Wertebereich !! Default-Wert !! Beschreibung
|-
|AutoShuttersControl || 0, 1, 2 || ||1 = "Inverse oder Rollo Bsp.: Rollo Oben 0, Rollo Unten 100 und der Befehl zum Prozentualen fahren ist position", 2 = "Homematic Style Bsp.: Rollo Oben 100, Rollo Unten 0 und der Befehl zum Prozentualen fahren ist pct
|-
|AutoShuttersControl_Antifreeze ||on, off || ||Frostschutz an oder aus
|-
|AutoShuttersControl_AutoAstroModeEvening ||aktuell REAL, CIVIL, NAUTIC, ASTRONOMIC || ||
|-
|AutoShuttersControl_AutoAstroModeEveningHorizon || || ||Höhe über Horizont wenn beim Attribut AutoShuttersControl_autoAstroModeEvening HORIZON ausgewählt
|-
|AutoShuttersControl_AutoAstroModeMorning ||aktuell REAL, CIVIL, NAUTIC, ASTRONOMIC || ||
|-
|AutoShuttersControl_AutoAstroModeMorningHorizon || || ||Höhe über Horizont wenn beim Attribut AutoShuttersControl_autoAstroModeMorning HORIZON ausgewählt
|-
|AutoShuttersControl_Closed_Pos || || ||in 10 Schritten von 0 bis 100, default Vorgabe ist abhängig vom Attribut AutoShuttersControl
|-
|AutoShuttersControl_Down ||astro, time || ||bei Astro wird Sonnenuntergang berechnet, bei time wird der Wert aus AutoShuttersControl_Time_Down_Early als Fahrzeit verwendet
|-
|AutoShuttersControl_Mode_Down ||always, absent, off || ||wann darf die Automatik steuern. immer, niemals, bei abwesenheit des Roomate (ist kein Roommate und absent eingestellt wird gar nicht gesteuert)
|-
|AutoShuttersControl_Mode_Up ||always, absent, off || ||wann darf die Automatik steuern. immer, niemals, bei abwesenheit des Roomate (ist kein Roommate und absent eingestellt wird gar nicht gesteuert)
|-
|AutoShuttersControl_Offset_Minutes_Evening || || ||maximale zufällige Verzögerung in Minuten (minimal 1) bei der Berechnung der Fahrzeiten für Abends
|-
|AutoShuttersControl_Offset_Minutes_Morning || || ||maximale zufällige Verzögerung in Minuten (minimal 1) bei der Berechnung der Fahrzeiten für Morgens
|-
|AutoShuttersControl_Open_Pos || || ||in 10 Schritten von 0 bis 100, default Vorgabe ist abhängig vom Attribut AutoShuttersControl
|-
|AutoShuttersControl_Partymode ||on, off || ||schaltet den Partymodus an oder aus, Wird dann am ASC Device set ASC-DEVICE partyMode on geschalten, werden alle Fahrbefehle an den Rollläden welche das Attribut auf on haben zwischen gespeichert und später erst ausgeführt
|-
|AutoShuttersControl_Pos_Cmd || || ||der set Befehl um den Rollladen in Prozent Angaben zu fahren, muss der selbe sein wie das Reading welches die Position des Rollladen in Prozent an gibt
|-
|AutoShuttersControl_Pos_after_ComfortOpen || || ||in 10 Schritten von 0 bis 100, default Vorgabe ist abhängig vom Attribut AutoShuttersControl
|-
|AutoShuttersControl_Roommate_Reading || || ||das Reading zum Roommate Device welches den Status wieder gibt
|-
|AutoShuttersControl_Roommate_Device || || ||Name des Roommate Devices welcher den Bewohner des Raumes vom Rollladen wieder gibt
|-
|AutoShuttersControl_Time_Down_Early || || ||Sunset frühste Zeit zum runter fahren
|-
|AutoShuttersControl_Time_Down_Late || || ||Sunset späteste Zeit zum runter fahren
|-
|AutoShuttersControl_Time_Up_Early || || ||Sunrise frühste Zeit zum hoch fahren
|-
|AutoShuttersControl_Time_Up_Late || || ||Sunrise späteste Zeit zum hoch fahren
|-
|AutoShuttersControl_Time_Up_WE_Holiday || || ||Sunrise frühste Zeit zum hochfahren am Wochenende und/oder Urlaub (we2holiday wird beachtet), Achtung sollte nicht größer sein wie AutoShuttersControl_Time_Up_Late sonst wird AutoShuttersControl_Time_Up_Late verwendet
|-
|AutoShuttersControl_Up ||astro, time || ||bei Astro wird Sonnenaufgang berechnet, bei time wird der Wert aus AutoShuttersControl_Time_Up_Early als Fahrzeit verwendet
|-
|AutoShuttersControl_Ventilate_Pos || || ||in 10 Schritten von 0 bis 100, default Vorgabe ist abhängig vom Attribut AutoShuttersControl
|-
|AutoShuttersControl_Ventilate_Window_Open || || ||auf lüften, wenn das Fenster gekippt/geöffnet wird und aktuelle Position unterhalb der Lüften-Position ist
|-
|AutoShuttersControl_WindowRec || || ||Name des Fensterkontaktes an welchen Fenster der Rolladen angebracht ist
|-
|AutoShuttersControl_WindowRec_subType || || ||Typ des verwendeten Fensterkontakts: twostate (optisch oder magnetisch) oder threestate (Drehgriffkontakt)
|-
|AutoShuttersControl_lock-out ||soft, hard || ||stellt entsprechend den Aussperrschutz ein. Bei global aktiven Aussperrschutz (set ASC-Device lockOut soft) und einem Fensterkontakt open bleibt dann der Rolladen oben. Dies gilt nur bei Steuerbefehle über das ASC Modul. Stellt man global auf hard, wird bei entsprechender Möglichkeit versucht den Rolladen Hardwareseitig zu blockieren. Dann ist auch ein fahren über die Taster nicht mehr möglich.
|-
|AutoShuttersControl_lock-outCmd ||inhibit, blocked || ||set Befehl für das Rolladen-Device zum Hardware sperren. Zum gesetzt werden wenn man "AutoShuttersControl_lock-out" auf hard setzt
|-
| || || ||
|-
|}

== Hilfsmittel ==
tbd

readingsGroup, um die diversen Level einzustellen:

define rg_ASC_Rollaeden_Level readingsGroup <Gerät>,<Closed_Pos>,<Open_Pos>,<Shading_Pos>,<Ventilate_Pos> (Rolladen_.*|Jalousie_.*)..:?AutoShuttersControl_Closed_Pos,?AutoShuttersControl_Open_Pos,?AutoShuttersControl_Shading_Pos,?AutoShuttesControl_Ventilate_Pos
attr rg_ASC_Rollaeden_Level commands { AutoShuttersControl_Closed_Pos => 'AutoShuttersControl_Closed_Pos:0,10,20,30,35,40,45,50,55,60,65,70,75,80,85,90,95,100',\
AutoShuttersControl_Open_Pos => 'AutoShuttersControl_Open_Pos:0,10,20,30,35,40,45,50,55,60,65,70,75,80,85,90,95,100',\
AutoShuttersControl_Shading_Pos => 'AutoShuttersControl_Shading_Pos:0,10,20,30,35,40,45,50,55,60,65,70,75,80,85,90,95,100',\
AutoShuttersControl_Ventilate_Pos => 'AutoShuttersControl_Ventilate_Pos:0,10,20,30,35,40,45,50,55,60,65,70,75,80,85,90,95,100'}
[[Datei:ReadingsGroup ASC Level.png|600px|]]
readingsGroup, um die diversen Zeiten einzustellen:

define rg_ASC_Rollaeden_Times readingsGroup <Gerät>,<Stand>,<Time_Up_Early>,<Time_Up_WE>,<Time_Up_Late>,<Time_Down_Early>,Time_Down_Late>,<Mode_Down>,<Mode_Up> (Rolladen_.*|Jalousie_.*)..:level,?AutoShuttersControl_Time_Up_Early,?AutoShuttersControl_Time_Up_WE_Holiday,?AutoShuttersControl_Time_Up_Late,?AutoShuttersControl_Time_Down_Early,?AutoShuttersControl_Time_Down_Late,?AutoShuttersControl_Mode_Down,?AutoShuttersControl_Mode_Up
attr rg_ASC_Rollaeden_Times commands {level => 'pct:0,10,20,30,35,40,45,50,55,60,65,70,75,80,85,90,95,100', \
AutoShuttersControl_Mode_Down => 'AutoShuttersControl_Mode_Down:always,absent,off',\
AutoShuttersControl_Mode_Up => 'AutoShuttersControl_Mode_Up:always,absent,off',\
AutoShuttersControl_Time_Down_Early => 'AutoShuttersControl_Time_Down_Early:15:00,15:15,15:30,15:45,16:00,16:15,16:30,16:45,17:00,17:15,17:30,17:45,18:00,18:15,18:30,18:45,19:00,19:15,19:30,19:45,20:00,20:15,20:30,20:45,21:00,21:15,21:30,21:45,22:00', \
AutoShuttersControl_Time_Down_Late => 'AutoShuttersControl_Time_Down_Late:20:15,20:30,20:45,21:00,21:15,21:30,21:45,22:00,22:15,22:30,22:45,23:00,23:15,23:30',\
AutoShuttersControl_Time_Up_Early => 'AutoShuttersControl_Time_Up_Early:05:00,05:05,05:30,05:45,06:00,06:15,06:30,06:45,07:00,07:15,07:30,07:45,08:00,08:15,08:30,08:45,09:00,09:15,09:30,09:45,10:00', \
AutoShuttersControl_Time_Up_Late =>'AutoShuttersControl_Time_Up_Late:06:00,06:15,06:30,06:45,07:00,07:15,07:30,07:45,08:00,08:15,08:30,08:45,09:00,09:15,09:30,09:45,10:00',AutoShuttersControl_Time_Up_WE_Holiday => 'AutoShuttersControl_Time_Up_WE_Holiday:06:00,06:15,06:30,06:45,07:00,07:15,07:30,07:45,08:00,08:15,08:30,08:45,09:00,09:15,09:30,09:45,10:00'}
[[Datei:ReadingsGroup ASC Times.png|600px|]]

== Weblinks ==
* {{Link2Forum|Topic=90751|LinkText="Thread zur Entwicklung im Forum"}}
* {{Link2Forum|Topic=73964|LinkText="Thread zu den Scripten von user cluni"}}, die der Entwicklung des Moduls zugrunde liegen

[[Kategorie:Codeschnipsel]]

AMAD

2018-08-16T12:33:45Z

CoolTux: /* Lister aller Variablen für die AMADCommandBridge */

{{Infobox Modul
|ModPurpose=Steuern von Androidgeräten und Anzeige von bestimmten Informationen dieser Geräte
|ModType=d
|ModForumArea=Sonstige Systeme
|ModTechName=73_AMADCommBridge.pm, 74_AMADDevice.pm
|ModOwner=CoolTux ([http://forum.fhem.de/index.php?action=profile;u=13684 Forum] / [[Benutzer:CoolTux|Wiki]])
}}

= AMAD 4.2 [AMADNG] =
== 73_AMADCommBridge / 74_AMADDevice ==

= Vorwort =
=== Warum AMADNG ===
Nach fast 6 Monaten Entwicklungszeit wurde die neuste AMAD Version am 24.07.2017 offiziell frei gegeben. Diesmal lagen mir mehrere Dinge am Herzen.
In erster Linie wollte ich eine softwareseitige Trennung der AMADCommBridge vom eigentlichen Android Device. Daher ist die neue Version ein zweistufiges Modul geworden.
Im Laufe der Entwicklung kamen auch andere Anforderungen hinzu, die ich dann fähig war umzusetzen. Eine dieser Anforderungen war eine einfachere und besser funktionierende Installation. Herausgekommen ist ein Android Installationsassistant.
Mit ihm wird auf einfache Art und Weise direkt per Sprachführung und Eingabedialogen Automagic für AMAD konfiguriert und das Device in FHEM automatisch erstellt.

'''Es ist darauf zu achten, das Autocreate aktiv ist, da sonst kein Device mit Hilfe des Assistenten angelegt werden kann!'''

= Vorstellung =
Dieses 2-stufige Modul liefert, '''in Verbindung mit der Android App Automagic''', diverse Informationen von Android Geräten.
Die AndroidAPP Automagic (die nicht von mir stammt und 2.90 Euro kostet) funktioniert wie Tasker, ist aber bei weitem benutzungsfreundlicher.

=== Features / Funktionen ===
Im Auslieferungszustand werden folgende Zustände dargestellt:
* installierte Android Version
* Zustand von Automagic auf dem Gerät
* Spracheingabe
* Bluetooth An/Aus
* Zustand einer definierten App (läuft aktiv im Vordergrund oder nicht?)
* verbundene Bluetoothgeräte, inklusive deren MAC Adresse
* aktuell abgespieltes Musikalbum des verwendeten Mediaplayers
* aktuell abgespielter Musikinterpret des verwendeten Mediaplayers
* aktuell abgespielter Musiktitel des verwendeten Mediaplayers
* Status des Androidgerätes - Online/Offline
* nächster Alarmtag
* nächste Alarmzeit
* Batteriestatus in %
* Ladestatus - Netztei angeschlossen / nicht angeschlossen
* Bildschirmstatus An/Aus
* Bildschirmhelligkeit
* Vollbildmodus An/Aus
* Bildschirmausrichtung Auto/Landscape/Portrait
* Standardlautstärke
* Media Lautstärke
* ...

Mit etwas Einarbeitung können jegliche Informationen, die Automagic bereit stellt, in FHEM angezeigt werden. Hierzu bedarf es lediglich eines eigenen Flows, der seine Daten an die AMADCommBridge sendet. Das Modul gibt auch die Möglichkeit Androidgeräte zu steuern.

= AMADCommBridge - Kommunikationsbrücke für alle AMAD Geräte =
Dieses Modul ist das Ausgangsmodul zur erfolgreichen Integration von Androidgeräten in FHEM. Es stellt ferner eine Verbindungsebene zwischen AMAD unterstützten Geräten und FHEM zur Verfügung. Alle Kommunikation zwischen AMAD Android und FHEM läuft über diese Schnittstelle.
Daher erfolgt die Ersteinrichtung eines AMAD Devices auch genau über diese Modulinstanz.

Damit erfolgreich ein Androidgerät in FHEM eingerichtet werden kann, muss im ersten Schritt ein AMADCommBridge Device angelegt werden.

=== Definition in FHEM ===

<code>define <name> AMADCommBridge</code>

==== Beispiel ====

<code>define AMADBridge AMADCommBridge</code>

Diese Anweisung erstellt ein neues AMADCommBridge Device namens AMADBridge.

Im folgenden muß lediglich das Flowset auf dem Android Gerät installiert werden und der Flow 'First Run Assistent' ausgeführt werden. (einfach den Homebutton drücken)
Der Assistent geleitet dann durch die Einrichtung des AMAD Gerätes und sorgt dafür, dass am Ende des Installationsprozess das Androidgerät als AMAD Device in FHEM angelegt wird.

=== Readings ===
* JSON_ERROR - JSON Fehlermeldung, die von Perl gemeldet wird
* JSON_ERROR_STRING - der String, der die JSON Fehlermeldung verursacht hat
* fhemServerIP - die Ip-Adresse des FHEM Servers; wird vom Modul auf Basis des JSON Strings vom Installationsassistenten gesetzt. Kann aber auch mittels set Befehles vom User gesetzt werden
* receiveFhemCommand - ist das Attribut fhemControlMode auf trigger gestellt, wird das Reading gesetzt sobald ein FHEM Befehl übersendet wird. Hierauf kann dann ein Notify triggern. Wird anstelle von trigger setControl als Wert für fhemControlMode eingestellt, wird das Reading nicht gesetzt sondern der set Befehl sofort ausgeführt.
* receiveVoiceCommand - wird die Sprachsteuerung von AMAD aktiviert (set DEVICE activateVoiceInput) so wird der letzte erkannten Sprachbefehle in dieses Reading geschrieben.
* receiveVoiceDevice - Name des Devices von wo aus der letzte erkannte Sprachbefehl gesendet wurde
* state - Status der Bridge, open, closed

=== Attribute ===
* allowFrom - Regexp der erlaubten IP-Adressen oder Hostnamen. Wenn dieses Attribut gesetzt wurde, werden ausschließlich Verbindungen von diesen Adressen akzeptiert. Achtung: falls allowfrom nicht gesetzt ist, und keine gütige allowed Instanz definiert ist, und die Gegenstelle eine nicht lokale Adresse hat, dann wird die Verbindung abgewiesen. Folgende Adressen werden als local betrachtet: IPV4: 127/8, 10/8, 192.168/16, 172.16/10, 169.254/16, IPV6: ::1, fe80/10
* debugJSON - wenn auf 1 gesetzt, werden JSON Fehlermeldungen in Readings geschrieben. Siehe hierzu JSON_ERROR* unter Readings
* fhemControlMode - steuert die zulässige Art der Steuerung von FHEM Devices. Es können über die Bridge auf 2 Arten FHEM-Devices angesteuert werden: per direktem FHEM-Befehl aus einem Flow heraus oder als Sprachbefehl mittels Sprachsteuerung (set DEVICE activateVoiceInput)
** trigger - ist der Wert trigger gesetzt, werden alle an die Bridge gesendeten FHEM set Befehle in das Reading receiveFhemCommand geschrieben und können so mittels notify ausgeführt werden. Sprachsteuerung ist möglich, es werden Readings receiveVoice* gesetzt. Auf dem Androidgerät können bei Sprachsteuerung mehrere Sprachbefehle mittels "und" verknüpft/aneinander gereiht werden. Bsp: schalte die Lichtszene Abends an und schalte den Fernseher an
** setControl - alle set Befehle, die mittels eines Flows über die Bridge gesendet werden, werden automatisch ausgeführt. Das Triggern eines Readings ist nicht nötig. Die Steuerung mittels Sprache verhält sich wie beim Wert trigger
** thirdPartControl - verhält sich wie trigger, bei der Sprachsteuerung ist jedoch ein Anreihen von Sprachbefehlen mittels "und" nicht möglich. Dient der Sprachsteuerung über Module anderer Modulautoren ((z.B. 39_TEERKO.pm)

= AMADDevice - Automagic Android Device =
Dieses Modul liefert, in Verbindung mit der Android APP Automagic, diverse Informationen von Android Geräten. Die Android App Automagic (die nicht von mir stammt und 2.90 Euro kostet) funktioniert wie Tasker, ist aber bei weitem User freundlicher.
Mit etwas Einarbeitung können jegliche Informationen, die Automagic bereit stellt in FHEM angezeigt werden. Hierzu bedarf es lediglich eines eigenen Flows, der seine Daten an die AMADDeviceCommBridge sendet. Das Modul gibt auch die Möglichkeit Androidgeräte zu steuern.
Für all diese Aktionen und Informationen wird auf dem Androidgerät "Automagic" und ein so genannter Flow benötigt. Die App ist über den Google PlayStore zu beziehen. Das benötigte Flowset bekommt man aus dem FHEM Verzeichnis.

=== Wie genau verwendet man nun AMADDevice? ===
* sicherstellen, dass als allererstes die AMADCommBridge in FHEM definiert wurde
* installieren der App "Automagic Premium" aus dem PlayStore
* installieren des Flowset 74_AMADDeviceautomagicFlowset$VERSION.xml aus dem Ordner $INSTALLFHEM/FHEM/lib/ auf dem Androidgerät
* aktivieren des Installationsassistanten Flow in Automagic. Wenn man nun Automagic in den Hintergrund schickt, z.B. Hometaste drücken, startet der Assistant und legt automatisch ein Device für das Androidgerät an.

=== Ein AMADDevice Gerät von Hand anlegen. ===

Define

<code>define <name> AMADDevice <IP-ADRESSE> <AMAD_ID> <REMOTESERVER></code>

==== Beispiel ====

<code>define WandTabletWohnzimmer AMADDevice 192.168.0.23 123456 Automagic</code>

In diesem Fall wird ein AMADDevice von Hand angelegt. Die AMAD_ID, hier 123456, muß auch exakt so als globale Variable in Automagic eingetragen sein.

=== Readings ===
* airplanemode - Status des Flugmodus
* androidVersion - aktuell installierte Androidversion
* automagicState - Statusmeldungen von der Automagic App '''(Voraussetzung Android >4.3). Ist Android größer 4.3 vorhanden und im Reading steht "wird nicht unterstützt", muss in den Androideinstellungen unter Ton und Benachrichtigungen -> Benachrichtigungszugriff ein Haken für Automagic gesetzt werden'''
* batteryHealth - Zustand der Battery (1=unbekannt, 2=gut, 3=überhitzt, 4=tot, 5=Überspannung, 6=unbekannter Fehler, 7=kalt)
* batterytemperature - Temperatur der Batterie
* bluetooth - on/off, Bluetooth Status an oder aus
* checkActiveTask - Zustand einer zuvor definierten App. 0=nicht aktiv oder nicht aktiv im Vordergrund, 1=aktiv im Vordergrund, '''siehe Hinweis unten'''
* connectedBTdevices - eine Liste der verbundenen Gerät
* connectedBTdevicesMAC - eine Liste der MAC Adressen aller verbundender BT Geräte
* currentMusicAlbum - aktuell abgespieltes Musikalbum des verwendeten Mediaplayers
* currentMusicApp - aktuell verwendeter Mediaplayer (Amazon Music, Google Play Music, Google Play Video, Spotify, YouTube, TuneIn Player, Aldi Life Music)
* currentMusicArtist - aktuell abgespielter Musikinterpret des verwendeten Mediaplayers
* currentMusicIcon - Cover vom aktuell abgespielten Album '''Noch nicht fertig implementiert'''
* currentMusicState - Status des aktuellen/zuletzt verwendeten Mediaplayers
* currentMusicTrack - aktuell abgespielter Musiktitel des verwendeten Mediaplayers
* daydream - on/off, Daydream gestartet oder nicht
* deviceState - Status des Androidgerätes. unknown, online, offline.
* doNotDisturb - aktueller Status des Nicht-Stören-Modus
* dockingState - undocked/docked Status, ob sich das Gerät in einer Dockingstation befindet.
* flow_SetCommands - active/inactive, Status des SetCommands Flow
* flow_informations - active/inactive, Status des Informations Flow
* flowsetVersionAtDevice - aktuell installierte Flowsetversion auf dem Device
* incomingCallerName - Anrufername des eingehenden Anrufes
* incomingCallerNumber - Anrufernummer des eingehenden Anrufes
* incommingWhatsAppMessageFrom - letzte WhatsApp Nachricht
* incommingWhatsTelegramMessageFrom - letzte Telegram Nachricht
* intentRadioName - zuletzt gestreamter Intent Radio Name
* intentRadioState - Status des IntentRadio Players
* keyguardSet - 0/1 Displaysperre gesetzt 0=nein 1=ja, bedeutet nicht, dass sie gerade aktiv ist
* lastSetCommandError - letzte Fehlermeldung vom set Befehl
* lastSetCommandState - letzter Status vom set Befehl, Befehl erfolgreich/nicht erfolgreich gesendet
* lastStatusRequestError - letzte Fehlermeldung vom statusRequest Befehl
* lastStatusRequestState - letzter Status vom statusRequest Befehl, Befehl erfolgreich/nicht erfolgreich gesendet
* nextAlarmDay - aktiver Alarmtag
* nextAlarmState - aktueller Status des "Androidinternen" Weckers
* nextAlarmTime - aktive Alarmzeit
* powerLevel - Status der Batterie in %
* powerPlugged - Netzteil angeschlossen? 1=AC Adapter, 2=USB, 4=Kabellos 0=nicht eingesteckt
* screen - on locked/unlocked, off locked/unlocked gibt an ob der Bildschirm an oder aus ist und gleichzeitig gesperrt oder nicht gesperrt
* screenBrightness - Bildschirmhelligkeit von 0-255
* screenFullscreen - on/off, Vollbildmodus (An,Aus)
* screenOrientation - Landscape,Portrait, Bildschirmausrichtung (Horizontal,Vertikal)
* screenOrientationMode - auto/manual, Modus für die Ausrichtung (Automatisch, Manuell)
* state - aktueller Status
* userFlowState - aktueller Status eines Flows, festgelegt unter dem setUserFlowState Attribut
* volume - Media Lautstärkewert
* volumeNotification - Benachrichtigungs-Lautstärke

Beim Reading checkActivTask muß zuvor der Packagename der zu prüfenden App als Attribut checkActiveTask angegeben werden. Beispiel: attr Nexus10Wohnzimmer checkActiveTask com.android.chrome für den Chrome Browser.

=== Set ===
* activateVoiceInput - aktiviert die Spracheingabe
* bluetooth - on/off, aktiviert/deaktiviert Bluetooth
* clearNotificationBar - All,Automagic, löscht alle Meldungen oder nur die Automagic Meldungen in der Statusleiste
* closeCall - beendet einen laufenden Anruf
* currentFlowsetUpdate - führt ein Flowsetupdate auf dem Device durch
* doNotDisturb - schaltet den Nicht-Stören-Modus: always immer stören, never niemals stören, alarmClockOnly nur Wecker darf stören, onlyImportant nur wichtige Störungen
* installFlowSource - installiert einen Flow auf dem Device, das XML File muss unter /tmp/ liegen und die Endung xml haben. Bsp: set TabletWohnzimmer installFlowSource WlanUebwerwachen.xml
* mediaAmazonMusic - play, stop, next, back ,steuert den Amazon Musik Mediaplayer
* mediaGoogleMusic - play, stop, next, back ,steuert den Google Play Musik Mediaplayer
* mediaSpotifyMusic - play, stop, next, back ,steuert den Spotify Mediaplayer
* mediaTuneinRadio - play, stop, next, back ,steuert den TuneIn Radio Mediaplayer
* mediaAldiMusic - play, stop, next, back ,steuert den Aldi Musik Mediaplayer
* mediaAudible - play, stop, next, back ,steuert den Audible Mediaplayer
* mediaYouTube - play, stop, next, back ,steuert den YouTube Mediaplayer
* mediaVlcPlayer - play, stop, next, back ,steuert den VLC Mediaplayer
* nextAlarmTime - setzt die Alarmzeit. gilt aber nur innerhalb der nächsten 24 h
* openCall - ruft eine Nummer an und legt optional nach X Sekunden auf / set DEVICE openCall 01736458 10 / ruft die Nummer an und beendet den Anruf nach 10s
* screen - on/off/lock/unlock schaltet den Bildschirm ein/aus oder sperrt/entsperrt ihn
* screenBrightness - setzt die Bildschirmhelligkeit, von 0-255.
* screenMsg - versendet eine Bildschirmnachricht
* sendintent - sendet einen Intentstring Bsp: set $AMADDeviceDEVICE sendIntent org.smblott.intentradio.PLAY url http://stream.klassikradio.de/live/mp3-192/stream.klassikradio.de/play.m3u name Klassikradio, der erste Befehl ist die Aktion und der zweite das Extra. Es können immer zwei Extras mitgegeben werden.
* sendSMS - sendet eine SMS an eine bestimmte Telefonnummer. Bsp.: sendSMS Dies ist ein Test|555487263
* startDaydream - startet den Daydream
* statusRequest - Fordert einen neuen Statusreport beim Device an. Es können nicht von allen Readings per statusRequest die Daten geholt werden. Einige wenige geben nur bei Statusänderung ihren Status wieder.
* timer - setzt einen Timer innerhalb der als Standard definierten Clock-App auf dem Device. Es können nur Sekunden angegeben werden.
* ttsMsg - versendet eine Nachricht, die als Sprachnachricht ausgegeben wird
* userFlowState - aktiviert oder deaktiviert einen oder mehrere Flows,'''set Nexus7Wohnzimmer Badezimmer vorheizen:inactive oder set Nexus7Wohnzimmer Badezimmer vorheizen,Nachtlicht Steven:inactive'''
* vibrate - lässt das Androidgerät vibrieren
* volume - setzt die Medialautstärke. Entweder die internen Lautsprecher oder sofern angeschlossen die Bluetoothlautsprecher und per Klinkenstecker angeschlossene Lautsprecher, + oder - vor dem Wert reduziert die aktuelle Lautstärke um den Wert. Der maximale Sliderwert kann über das Attribut setVolMax geregelt werden.
* volumeUp - erhöht die Lautstärke um den angegeben Wert im entsprechenden Attribut. Ist kein Attribut angegeben wird per default 2 genommen.
* volumeDown - reduziert die Lautstärke um den angegeben Wert im entsprechenden Attribut. Ist kein Attribut angegeben wird per default 2 genommen.
* volumeNotification - setzt die Benachrichtigungslautstärke.

==== Set abhängig von gesetzten Attributen ====
* changetoBtDevice - wechselt zu einem anderen Bluetooth Gerät. Attribut setBluetoothDevice muß gesetzt sein. Siehe Hinweis unten!
* notifySndFile - spielt die angegebene Mediadatei auf dem Androidgerät ab. Die aufzurufende Mediadatei sollte sich im Ordner /storage/emulated/0/Notifications/ befinden. Ist dies nicht der Fall kann man über das Attribut setNotifySndFilePath einen Pfad vorgeben.
* openApp - öffnet eine ausgewählte App. Attribut setOpenApp
* openURL - öffnet eine URL im Standardbrowser, sofern kein anderer Browser über das Attribut setOpenUrlBrowser ausgewählt wurde. Bsp: attr Tablet setOpenUrlBrowser de.ozerov.fully|de.ozerov.fully.MainActivity, das erste ist der Package Name und das zweite der Class Name
* setAPSSID - setzt die AccessPoint SSID um ein WLAN sleep zu verhindern
* setScreenOnForTimer ändert die Zeitdauer, die das Display an bleiben soll!
* screenFullscreen - on/off, (aktiviert/deaktiviert) den Vollbildmodus. Attribut setFullscreen
* screenLock - Sperrt den Bildschirm mit Pinabfrage. Attribut setScreenlockPIN - hier die Pin dafür eingeben. Erlaubt sind nur Zahlen. Es müßen mindestens 4, bis max 16 Zeichen verwendet werden.
* screenOrientation - Auto,Landscape,Portait, aktiviert die Bildschirmausrichtung (Automatisch,Horizontal,Vertikal). Attribut setScreenOrientation
* system - setzt Systembefehle ab (nur bei gerootetet Geräten). reboot,shutdown,airplanemodeON (kann nur aktiviert werden) Attribut root, in den Automagic Einstellungen muss "Root Funktion" gesetzt werden
* setNotifySndFilePath - setzt den korrekten Systempfad zur Notifydatei (default ist /storage/emulated/0/Notifications/
* setTtsMsgSpeed - setzt die Sprachgeschwindigkeit bei der Sprachausgabe(Werte zwischen 0.5 bis 4.0 in 0.5er Schritten) default ist 1.0
* setTtsMsgSpeed - setzt die Sprache bei der Sprachausgabe, de oder en (default ist de)
* setVolUpDownStep - setzt den Step für volumeUp und volumeDown
* setVolMax - setzt die maximale Volume Größe für den Slider
* setNotifyVolMax - setzt den maximalen Lautstärkewert für Benachrichtigungslautstärke für den Slider
* setRingSoundVolMax - setzt den maximalen Lautstärkewert für Klingellautstärke für den Slider

'''Um openApp verwenden zu können, muss als Attribut der Package Name der App angegeben werden.

'''Um zwischen Bluetoothgeräten wechseln zu können, muss das Attribut setBluetoothDevice mit folgender Syntax gesetzt werden. attr <DEVICE> BTdeviceName1|MAC,BTDeviceName2|MAC Es muss zwingend darauf geachtet werden, dass beim BTdeviceName kein Leerzeichen vorhanden ist. Am besten zusammen oder mit Unterstrich. Bei der MAC ist darauf zu achten, dass wirklich nach jeder zweiten Zahl ein : steht

** '''Beispiel: attr Nexus10Wohnzimmer setBluetoothDevice Logitech_BT_Adapter|AB:12:CD:34:EF:32,Anker_A3565|GH:56:IJ:78:KL:76

=== state ===
* initialized - Ist der Status kurz nach einem define.
* active - die Geräteinstanz ist im aktiven Status.
* disabled - die Geräteinstanz wurde über das Attribut disable deaktiviert

==Anwendungsbeispiele==
=== Lademanagement ===
Ich habe die Ladegeräte für meine Androidgeräte an Funkschaltsteckdosen. Ein DOIF schaltet bei unter 30% die Steckdose ein und bei über 90% wieder aus.

Hier mal ein einfaches DOIF Beispiel für ein Lademanagment

<code>
... DOIF ([Nexus5Handy:powerLevel] < 30) (set LadenetzteilNexus5Handy:FILTER=STATE=off on) DOELSEIF ([Nexus5Handy:powerLevel] > 90) (set LadenetzteilNexus5Handy:FILTER=STATE=on off) DOELSE
</code>

=== Wecker ===
Morgens lasse ich mich über mein Tablet im Schlafzimmer mit Musik wecken. Verwendet wird hierzu der wakeuptimer des RESIDENTS Modules. Das Abspielen stoppe ich dann von Hand. Danach erfolgt noch eine Ansage wie das Wetter gerade ist und wird.

=== Mediacenter ===
Mein 10" Tablet im Wohnzimmer ist Mediaplayer für das Wohnzimmer mit Bluetoothlautsprechern. Die Lautstärke wird automatisch heruntergesetzt, wenn die Fritzbox einen Anruf auf das Wohnzimmer Handgerät signalisiert.

=== Sprachbefehl - Abfragen von Zuständen diverser Sensoren ===
Wenn ich die Spracheingabe aktiviere und nach der Temperatur im Wohnzimmer frage, bekomme ich diese angesagt.

Der Teil im Feld Daten ist ein klassisches ReadingsVal, halt nur ohne Komma und ohne Anführungszeichen

WIRD GERADE ÜBERARBEITET

=== Schaltbefehle vom Androidgerät an FHEM senden ===
Hierfür ist ein eigener Flow einzurichten. Wie das genau geht, verrät die Hilfe.
Um einen Schaltbefehl für FHEM zu erstellen, folgt nach dem Trigger eine Aktion als Script (Aktion Type: Script). Hier ist folgendes einzutragen:

setcmd = "LichtWohnzimmerLampeRechts on"

fhemcmd = "set"

In der ersten Zeile wird also der Schaltbefehl in der Variablem setcmd eingetragen und in der zweiten Zeile der FHEM Befehl in der Variablen fhemcmd.

Danach müsst Ihr nur noch in einer weiteren Aktion den Flow "Send Data to AMADCommBridge" ausführen (Aktion Type: Flows ausführen). Die Aktion sollte bereits in Eurer Liste Vorhanden sein.

[[Datei:Screenshot_20160717-134948.png|200px]]
[[Datei:Screenshot 17.07.2016 1-50-27.png|200px]]

Nun sollte Lampe1 angeschalten werden, wenn der Flow ausgeführt wird.

=== Mit FHEM ein Flow ausführen ===
Es gibt den set Befehl userFlowRun. Als Argument übergibt man einen Flownamen. '''Achtung dieser Flowname darf keine Sonder oder Leerzeichen enthalten!!!'''

=== Schaltbefehle an FHEM senden mit Hilfe eines eigenen Flows ===

==== Lister aller Variablen für die AMADCommandBridge ====
fhemcmd Variable
* Wert "set" - Variable für den Schaltbefehl 'setcmd'
* Wert "setreading" - Variable für die Readingswerte 'fhemdata'
* "readingsval" - Variable für die Abfragewerte 'readingsvalcmd'
* "fhemfunc" - Variable für den Funktionsnamen 'fhemsub'

'''Beispiele für Skriptinhalte:'''

Schalten einer Lampe

<code>
setcmd = "LichtWohnzimmerLampeRechts on";

fhemcmd = "set"
</code>

Status eines Device abfragen

<code>
readingsvalcmd = "DEVICE READING DEFAULT";

fhemcmd = "readingsval"
</code>

Die Rückgabevariable, die dann weiter verarbeitet werden kann, heißt '''respreadingsval'''

Aufruf einer 99_myUtils Subroutine

<code>
fhemsub = "mySub()"; oder natürlich auch "mySub('was_auch_immer')"

fhemcmd = "fhemfunc"
</code>

Die Rückgabevariable, die dann weiter verarbeitet werden kann, heißt '''respfhemfunc'''

== Bekannte Meldungen/Hinweise/Probleme ==

Wenn auf dem Android-Gerät die Fehlermeldung 'Accessibility service not running' von Automagic kommt oder im FHEM das reading state 'Flow Informations mit Fehler beendet' steht, dann muss der Accessibility Service auf dem Android-Device aktiviert werden: Einstellungen --> Bedienungshilfen --> Automagic Premium. Hier muss der Schalter auf 'an' stehen. Sollte dies der Fall sein, hilft u.U. ein kurzes Aus- und wieder Einschalten.

Gerät wird oft als offline angezeigt und es können keine set Befehle abgesetzt werden.
Mit der AMAD Version 2.2 hielt eine neue Behandlung des deviceState Readings Einzug. Das Reading stellt nun den tatsächlichen Status des Gerätes gegenüber FHEM da. Bei vielen Android 6 Geräten kommt es aber auf Grund vom DeepSleep Modus zum Wegfall der WLAN Verbindung. Hier hilft die neue KeepAlive Funktion in AMAD. Dafür muß lediglich unter
* Einstellungen --> Akku --> oben auf die drei Punkte - Akku Leistungsoptimierung --> alle Apps und dann Automagic auswählen und "Nicht optimieren"
ausgewählt werden und in FHEM für das Device das Attribut setAPSSID gesetzt werden. Alles andere macht das Modul selbst.

AMAD

2018-08-16T12:33:26Z

CoolTux: /* Mit FHEM ein Flow ausführen */

{{Infobox Modul
|ModPurpose=Steuern von Androidgeräten und Anzeige von bestimmten Informationen dieser Geräte
|ModType=d
|ModForumArea=Sonstige Systeme
|ModTechName=73_AMADCommBridge.pm, 74_AMADDevice.pm
|ModOwner=CoolTux ([http://forum.fhem.de/index.php?action=profile;u=13684 Forum] / [[Benutzer:CoolTux|Wiki]])
}}

= AMAD 4.2 [AMADNG] =
== 73_AMADCommBridge / 74_AMADDevice ==

= Vorwort =
=== Warum AMADNG ===
Nach fast 6 Monaten Entwicklungszeit wurde die neuste AMAD Version am 24.07.2017 offiziell frei gegeben. Diesmal lagen mir mehrere Dinge am Herzen.
In erster Linie wollte ich eine softwareseitige Trennung der AMADCommBridge vom eigentlichen Android Device. Daher ist die neue Version ein zweistufiges Modul geworden.
Im Laufe der Entwicklung kamen auch andere Anforderungen hinzu, die ich dann fähig war umzusetzen. Eine dieser Anforderungen war eine einfachere und besser funktionierende Installation. Herausgekommen ist ein Android Installationsassistant.
Mit ihm wird auf einfache Art und Weise direkt per Sprachführung und Eingabedialogen Automagic für AMAD konfiguriert und das Device in FHEM automatisch erstellt.

'''Es ist darauf zu achten, das Autocreate aktiv ist, da sonst kein Device mit Hilfe des Assistenten angelegt werden kann!'''

= Vorstellung =
Dieses 2-stufige Modul liefert, '''in Verbindung mit der Android App Automagic''', diverse Informationen von Android Geräten.
Die AndroidAPP Automagic (die nicht von mir stammt und 2.90 Euro kostet) funktioniert wie Tasker, ist aber bei weitem benutzungsfreundlicher.

=== Features / Funktionen ===
Im Auslieferungszustand werden folgende Zustände dargestellt:
* installierte Android Version
* Zustand von Automagic auf dem Gerät
* Spracheingabe
* Bluetooth An/Aus
* Zustand einer definierten App (läuft aktiv im Vordergrund oder nicht?)
* verbundene Bluetoothgeräte, inklusive deren MAC Adresse
* aktuell abgespieltes Musikalbum des verwendeten Mediaplayers
* aktuell abgespielter Musikinterpret des verwendeten Mediaplayers
* aktuell abgespielter Musiktitel des verwendeten Mediaplayers
* Status des Androidgerätes - Online/Offline
* nächster Alarmtag
* nächste Alarmzeit
* Batteriestatus in %
* Ladestatus - Netztei angeschlossen / nicht angeschlossen
* Bildschirmstatus An/Aus
* Bildschirmhelligkeit
* Vollbildmodus An/Aus
* Bildschirmausrichtung Auto/Landscape/Portrait
* Standardlautstärke
* Media Lautstärke
* ...

Mit etwas Einarbeitung können jegliche Informationen, die Automagic bereit stellt, in FHEM angezeigt werden. Hierzu bedarf es lediglich eines eigenen Flows, der seine Daten an die AMADCommBridge sendet. Das Modul gibt auch die Möglichkeit Androidgeräte zu steuern.

= AMADCommBridge - Kommunikationsbrücke für alle AMAD Geräte =
Dieses Modul ist das Ausgangsmodul zur erfolgreichen Integration von Androidgeräten in FHEM. Es stellt ferner eine Verbindungsebene zwischen AMAD unterstützten Geräten und FHEM zur Verfügung. Alle Kommunikation zwischen AMAD Android und FHEM läuft über diese Schnittstelle.
Daher erfolgt die Ersteinrichtung eines AMAD Devices auch genau über diese Modulinstanz.

Damit erfolgreich ein Androidgerät in FHEM eingerichtet werden kann, muss im ersten Schritt ein AMADCommBridge Device angelegt werden.

=== Definition in FHEM ===

<code>define <name> AMADCommBridge</code>

==== Beispiel ====

<code>define AMADBridge AMADCommBridge</code>

Diese Anweisung erstellt ein neues AMADCommBridge Device namens AMADBridge.

Im folgenden muß lediglich das Flowset auf dem Android Gerät installiert werden und der Flow 'First Run Assistent' ausgeführt werden. (einfach den Homebutton drücken)
Der Assistent geleitet dann durch die Einrichtung des AMAD Gerätes und sorgt dafür, dass am Ende des Installationsprozess das Androidgerät als AMAD Device in FHEM angelegt wird.

=== Readings ===
* JSON_ERROR - JSON Fehlermeldung, die von Perl gemeldet wird
* JSON_ERROR_STRING - der String, der die JSON Fehlermeldung verursacht hat
* fhemServerIP - die Ip-Adresse des FHEM Servers; wird vom Modul auf Basis des JSON Strings vom Installationsassistenten gesetzt. Kann aber auch mittels set Befehles vom User gesetzt werden
* receiveFhemCommand - ist das Attribut fhemControlMode auf trigger gestellt, wird das Reading gesetzt sobald ein FHEM Befehl übersendet wird. Hierauf kann dann ein Notify triggern. Wird anstelle von trigger setControl als Wert für fhemControlMode eingestellt, wird das Reading nicht gesetzt sondern der set Befehl sofort ausgeführt.
* receiveVoiceCommand - wird die Sprachsteuerung von AMAD aktiviert (set DEVICE activateVoiceInput) so wird der letzte erkannten Sprachbefehle in dieses Reading geschrieben.
* receiveVoiceDevice - Name des Devices von wo aus der letzte erkannte Sprachbefehl gesendet wurde
* state - Status der Bridge, open, closed

=== Attribute ===
* allowFrom - Regexp der erlaubten IP-Adressen oder Hostnamen. Wenn dieses Attribut gesetzt wurde, werden ausschließlich Verbindungen von diesen Adressen akzeptiert. Achtung: falls allowfrom nicht gesetzt ist, und keine gütige allowed Instanz definiert ist, und die Gegenstelle eine nicht lokale Adresse hat, dann wird die Verbindung abgewiesen. Folgende Adressen werden als local betrachtet: IPV4: 127/8, 10/8, 192.168/16, 172.16/10, 169.254/16, IPV6: ::1, fe80/10
* debugJSON - wenn auf 1 gesetzt, werden JSON Fehlermeldungen in Readings geschrieben. Siehe hierzu JSON_ERROR* unter Readings
* fhemControlMode - steuert die zulässige Art der Steuerung von FHEM Devices. Es können über die Bridge auf 2 Arten FHEM-Devices angesteuert werden: per direktem FHEM-Befehl aus einem Flow heraus oder als Sprachbefehl mittels Sprachsteuerung (set DEVICE activateVoiceInput)
** trigger - ist der Wert trigger gesetzt, werden alle an die Bridge gesendeten FHEM set Befehle in das Reading receiveFhemCommand geschrieben und können so mittels notify ausgeführt werden. Sprachsteuerung ist möglich, es werden Readings receiveVoice* gesetzt. Auf dem Androidgerät können bei Sprachsteuerung mehrere Sprachbefehle mittels "und" verknüpft/aneinander gereiht werden. Bsp: schalte die Lichtszene Abends an und schalte den Fernseher an
** setControl - alle set Befehle, die mittels eines Flows über die Bridge gesendet werden, werden automatisch ausgeführt. Das Triggern eines Readings ist nicht nötig. Die Steuerung mittels Sprache verhält sich wie beim Wert trigger
** thirdPartControl - verhält sich wie trigger, bei der Sprachsteuerung ist jedoch ein Anreihen von Sprachbefehlen mittels "und" nicht möglich. Dient der Sprachsteuerung über Module anderer Modulautoren ((z.B. 39_TEERKO.pm)

= AMADDevice - Automagic Android Device =
Dieses Modul liefert, in Verbindung mit der Android APP Automagic, diverse Informationen von Android Geräten. Die Android App Automagic (die nicht von mir stammt und 2.90 Euro kostet) funktioniert wie Tasker, ist aber bei weitem User freundlicher.
Mit etwas Einarbeitung können jegliche Informationen, die Automagic bereit stellt in FHEM angezeigt werden. Hierzu bedarf es lediglich eines eigenen Flows, der seine Daten an die AMADDeviceCommBridge sendet. Das Modul gibt auch die Möglichkeit Androidgeräte zu steuern.
Für all diese Aktionen und Informationen wird auf dem Androidgerät "Automagic" und ein so genannter Flow benötigt. Die App ist über den Google PlayStore zu beziehen. Das benötigte Flowset bekommt man aus dem FHEM Verzeichnis.

=== Wie genau verwendet man nun AMADDevice? ===
* sicherstellen, dass als allererstes die AMADCommBridge in FHEM definiert wurde
* installieren der App "Automagic Premium" aus dem PlayStore
* installieren des Flowset 74_AMADDeviceautomagicFlowset$VERSION.xml aus dem Ordner $INSTALLFHEM/FHEM/lib/ auf dem Androidgerät
* aktivieren des Installationsassistanten Flow in Automagic. Wenn man nun Automagic in den Hintergrund schickt, z.B. Hometaste drücken, startet der Assistant und legt automatisch ein Device für das Androidgerät an.

=== Ein AMADDevice Gerät von Hand anlegen. ===

Define

<code>define <name> AMADDevice <IP-ADRESSE> <AMAD_ID> <REMOTESERVER></code>

==== Beispiel ====

<code>define WandTabletWohnzimmer AMADDevice 192.168.0.23 123456 Automagic</code>

In diesem Fall wird ein AMADDevice von Hand angelegt. Die AMAD_ID, hier 123456, muß auch exakt so als globale Variable in Automagic eingetragen sein.

=== Readings ===
* airplanemode - Status des Flugmodus
* androidVersion - aktuell installierte Androidversion
* automagicState - Statusmeldungen von der Automagic App '''(Voraussetzung Android >4.3). Ist Android größer 4.3 vorhanden und im Reading steht "wird nicht unterstützt", muss in den Androideinstellungen unter Ton und Benachrichtigungen -> Benachrichtigungszugriff ein Haken für Automagic gesetzt werden'''
* batteryHealth - Zustand der Battery (1=unbekannt, 2=gut, 3=überhitzt, 4=tot, 5=Überspannung, 6=unbekannter Fehler, 7=kalt)
* batterytemperature - Temperatur der Batterie
* bluetooth - on/off, Bluetooth Status an oder aus
* checkActiveTask - Zustand einer zuvor definierten App. 0=nicht aktiv oder nicht aktiv im Vordergrund, 1=aktiv im Vordergrund, '''siehe Hinweis unten'''
* connectedBTdevices - eine Liste der verbundenen Gerät
* connectedBTdevicesMAC - eine Liste der MAC Adressen aller verbundender BT Geräte
* currentMusicAlbum - aktuell abgespieltes Musikalbum des verwendeten Mediaplayers
* currentMusicApp - aktuell verwendeter Mediaplayer (Amazon Music, Google Play Music, Google Play Video, Spotify, YouTube, TuneIn Player, Aldi Life Music)
* currentMusicArtist - aktuell abgespielter Musikinterpret des verwendeten Mediaplayers
* currentMusicIcon - Cover vom aktuell abgespielten Album '''Noch nicht fertig implementiert'''
* currentMusicState - Status des aktuellen/zuletzt verwendeten Mediaplayers
* currentMusicTrack - aktuell abgespielter Musiktitel des verwendeten Mediaplayers
* daydream - on/off, Daydream gestartet oder nicht
* deviceState - Status des Androidgerätes. unknown, online, offline.
* doNotDisturb - aktueller Status des Nicht-Stören-Modus
* dockingState - undocked/docked Status, ob sich das Gerät in einer Dockingstation befindet.
* flow_SetCommands - active/inactive, Status des SetCommands Flow
* flow_informations - active/inactive, Status des Informations Flow
* flowsetVersionAtDevice - aktuell installierte Flowsetversion auf dem Device
* incomingCallerName - Anrufername des eingehenden Anrufes
* incomingCallerNumber - Anrufernummer des eingehenden Anrufes
* incommingWhatsAppMessageFrom - letzte WhatsApp Nachricht
* incommingWhatsTelegramMessageFrom - letzte Telegram Nachricht
* intentRadioName - zuletzt gestreamter Intent Radio Name
* intentRadioState - Status des IntentRadio Players
* keyguardSet - 0/1 Displaysperre gesetzt 0=nein 1=ja, bedeutet nicht, dass sie gerade aktiv ist
* lastSetCommandError - letzte Fehlermeldung vom set Befehl
* lastSetCommandState - letzter Status vom set Befehl, Befehl erfolgreich/nicht erfolgreich gesendet
* lastStatusRequestError - letzte Fehlermeldung vom statusRequest Befehl
* lastStatusRequestState - letzter Status vom statusRequest Befehl, Befehl erfolgreich/nicht erfolgreich gesendet
* nextAlarmDay - aktiver Alarmtag
* nextAlarmState - aktueller Status des "Androidinternen" Weckers
* nextAlarmTime - aktive Alarmzeit
* powerLevel - Status der Batterie in %
* powerPlugged - Netzteil angeschlossen? 1=AC Adapter, 2=USB, 4=Kabellos 0=nicht eingesteckt
* screen - on locked/unlocked, off locked/unlocked gibt an ob der Bildschirm an oder aus ist und gleichzeitig gesperrt oder nicht gesperrt
* screenBrightness - Bildschirmhelligkeit von 0-255
* screenFullscreen - on/off, Vollbildmodus (An,Aus)
* screenOrientation - Landscape,Portrait, Bildschirmausrichtung (Horizontal,Vertikal)
* screenOrientationMode - auto/manual, Modus für die Ausrichtung (Automatisch, Manuell)
* state - aktueller Status
* userFlowState - aktueller Status eines Flows, festgelegt unter dem setUserFlowState Attribut
* volume - Media Lautstärkewert
* volumeNotification - Benachrichtigungs-Lautstärke

Beim Reading checkActivTask muß zuvor der Packagename der zu prüfenden App als Attribut checkActiveTask angegeben werden. Beispiel: attr Nexus10Wohnzimmer checkActiveTask com.android.chrome für den Chrome Browser.

=== Set ===
* activateVoiceInput - aktiviert die Spracheingabe
* bluetooth - on/off, aktiviert/deaktiviert Bluetooth
* clearNotificationBar - All,Automagic, löscht alle Meldungen oder nur die Automagic Meldungen in der Statusleiste
* closeCall - beendet einen laufenden Anruf
* currentFlowsetUpdate - führt ein Flowsetupdate auf dem Device durch
* doNotDisturb - schaltet den Nicht-Stören-Modus: always immer stören, never niemals stören, alarmClockOnly nur Wecker darf stören, onlyImportant nur wichtige Störungen
* installFlowSource - installiert einen Flow auf dem Device, das XML File muss unter /tmp/ liegen und die Endung xml haben. Bsp: set TabletWohnzimmer installFlowSource WlanUebwerwachen.xml
* mediaAmazonMusic - play, stop, next, back ,steuert den Amazon Musik Mediaplayer
* mediaGoogleMusic - play, stop, next, back ,steuert den Google Play Musik Mediaplayer
* mediaSpotifyMusic - play, stop, next, back ,steuert den Spotify Mediaplayer
* mediaTuneinRadio - play, stop, next, back ,steuert den TuneIn Radio Mediaplayer
* mediaAldiMusic - play, stop, next, back ,steuert den Aldi Musik Mediaplayer
* mediaAudible - play, stop, next, back ,steuert den Audible Mediaplayer
* mediaYouTube - play, stop, next, back ,steuert den YouTube Mediaplayer
* mediaVlcPlayer - play, stop, next, back ,steuert den VLC Mediaplayer
* nextAlarmTime - setzt die Alarmzeit. gilt aber nur innerhalb der nächsten 24 h
* openCall - ruft eine Nummer an und legt optional nach X Sekunden auf / set DEVICE openCall 01736458 10 / ruft die Nummer an und beendet den Anruf nach 10s
* screen - on/off/lock/unlock schaltet den Bildschirm ein/aus oder sperrt/entsperrt ihn
* screenBrightness - setzt die Bildschirmhelligkeit, von 0-255.
* screenMsg - versendet eine Bildschirmnachricht
* sendintent - sendet einen Intentstring Bsp: set $AMADDeviceDEVICE sendIntent org.smblott.intentradio.PLAY url http://stream.klassikradio.de/live/mp3-192/stream.klassikradio.de/play.m3u name Klassikradio, der erste Befehl ist die Aktion und der zweite das Extra. Es können immer zwei Extras mitgegeben werden.
* sendSMS - sendet eine SMS an eine bestimmte Telefonnummer. Bsp.: sendSMS Dies ist ein Test|555487263
* startDaydream - startet den Daydream
* statusRequest - Fordert einen neuen Statusreport beim Device an. Es können nicht von allen Readings per statusRequest die Daten geholt werden. Einige wenige geben nur bei Statusänderung ihren Status wieder.
* timer - setzt einen Timer innerhalb der als Standard definierten Clock-App auf dem Device. Es können nur Sekunden angegeben werden.
* ttsMsg - versendet eine Nachricht, die als Sprachnachricht ausgegeben wird
* userFlowState - aktiviert oder deaktiviert einen oder mehrere Flows,'''set Nexus7Wohnzimmer Badezimmer vorheizen:inactive oder set Nexus7Wohnzimmer Badezimmer vorheizen,Nachtlicht Steven:inactive'''
* vibrate - lässt das Androidgerät vibrieren
* volume - setzt die Medialautstärke. Entweder die internen Lautsprecher oder sofern angeschlossen die Bluetoothlautsprecher und per Klinkenstecker angeschlossene Lautsprecher, + oder - vor dem Wert reduziert die aktuelle Lautstärke um den Wert. Der maximale Sliderwert kann über das Attribut setVolMax geregelt werden.
* volumeUp - erhöht die Lautstärke um den angegeben Wert im entsprechenden Attribut. Ist kein Attribut angegeben wird per default 2 genommen.
* volumeDown - reduziert die Lautstärke um den angegeben Wert im entsprechenden Attribut. Ist kein Attribut angegeben wird per default 2 genommen.
* volumeNotification - setzt die Benachrichtigungslautstärke.

==== Set abhängig von gesetzten Attributen ====
* changetoBtDevice - wechselt zu einem anderen Bluetooth Gerät. Attribut setBluetoothDevice muß gesetzt sein. Siehe Hinweis unten!
* notifySndFile - spielt die angegebene Mediadatei auf dem Androidgerät ab. Die aufzurufende Mediadatei sollte sich im Ordner /storage/emulated/0/Notifications/ befinden. Ist dies nicht der Fall kann man über das Attribut setNotifySndFilePath einen Pfad vorgeben.
* openApp - öffnet eine ausgewählte App. Attribut setOpenApp
* openURL - öffnet eine URL im Standardbrowser, sofern kein anderer Browser über das Attribut setOpenUrlBrowser ausgewählt wurde. Bsp: attr Tablet setOpenUrlBrowser de.ozerov.fully|de.ozerov.fully.MainActivity, das erste ist der Package Name und das zweite der Class Name
* setAPSSID - setzt die AccessPoint SSID um ein WLAN sleep zu verhindern
* setScreenOnForTimer ändert die Zeitdauer, die das Display an bleiben soll!
* screenFullscreen - on/off, (aktiviert/deaktiviert) den Vollbildmodus. Attribut setFullscreen
* screenLock - Sperrt den Bildschirm mit Pinabfrage. Attribut setScreenlockPIN - hier die Pin dafür eingeben. Erlaubt sind nur Zahlen. Es müßen mindestens 4, bis max 16 Zeichen verwendet werden.
* screenOrientation - Auto,Landscape,Portait, aktiviert die Bildschirmausrichtung (Automatisch,Horizontal,Vertikal). Attribut setScreenOrientation
* system - setzt Systembefehle ab (nur bei gerootetet Geräten). reboot,shutdown,airplanemodeON (kann nur aktiviert werden) Attribut root, in den Automagic Einstellungen muss "Root Funktion" gesetzt werden
* setNotifySndFilePath - setzt den korrekten Systempfad zur Notifydatei (default ist /storage/emulated/0/Notifications/
* setTtsMsgSpeed - setzt die Sprachgeschwindigkeit bei der Sprachausgabe(Werte zwischen 0.5 bis 4.0 in 0.5er Schritten) default ist 1.0
* setTtsMsgSpeed - setzt die Sprache bei der Sprachausgabe, de oder en (default ist de)
* setVolUpDownStep - setzt den Step für volumeUp und volumeDown
* setVolMax - setzt die maximale Volume Größe für den Slider
* setNotifyVolMax - setzt den maximalen Lautstärkewert für Benachrichtigungslautstärke für den Slider
* setRingSoundVolMax - setzt den maximalen Lautstärkewert für Klingellautstärke für den Slider

'''Um openApp verwenden zu können, muss als Attribut der Package Name der App angegeben werden.

'''Um zwischen Bluetoothgeräten wechseln zu können, muss das Attribut setBluetoothDevice mit folgender Syntax gesetzt werden. attr <DEVICE> BTdeviceName1|MAC,BTDeviceName2|MAC Es muss zwingend darauf geachtet werden, dass beim BTdeviceName kein Leerzeichen vorhanden ist. Am besten zusammen oder mit Unterstrich. Bei der MAC ist darauf zu achten, dass wirklich nach jeder zweiten Zahl ein : steht

** '''Beispiel: attr Nexus10Wohnzimmer setBluetoothDevice Logitech_BT_Adapter|AB:12:CD:34:EF:32,Anker_A3565|GH:56:IJ:78:KL:76

=== state ===
* initialized - Ist der Status kurz nach einem define.
* active - die Geräteinstanz ist im aktiven Status.
* disabled - die Geräteinstanz wurde über das Attribut disable deaktiviert

==Anwendungsbeispiele==
=== Lademanagement ===
Ich habe die Ladegeräte für meine Androidgeräte an Funkschaltsteckdosen. Ein DOIF schaltet bei unter 30% die Steckdose ein und bei über 90% wieder aus.

Hier mal ein einfaches DOIF Beispiel für ein Lademanagment

<code>
... DOIF ([Nexus5Handy:powerLevel] < 30) (set LadenetzteilNexus5Handy:FILTER=STATE=off on) DOELSEIF ([Nexus5Handy:powerLevel] > 90) (set LadenetzteilNexus5Handy:FILTER=STATE=on off) DOELSE
</code>

=== Wecker ===
Morgens lasse ich mich über mein Tablet im Schlafzimmer mit Musik wecken. Verwendet wird hierzu der wakeuptimer des RESIDENTS Modules. Das Abspielen stoppe ich dann von Hand. Danach erfolgt noch eine Ansage wie das Wetter gerade ist und wird.

=== Mediacenter ===
Mein 10" Tablet im Wohnzimmer ist Mediaplayer für das Wohnzimmer mit Bluetoothlautsprechern. Die Lautstärke wird automatisch heruntergesetzt, wenn die Fritzbox einen Anruf auf das Wohnzimmer Handgerät signalisiert.

=== Sprachbefehl - Abfragen von Zuständen diverser Sensoren ===
Wenn ich die Spracheingabe aktiviere und nach der Temperatur im Wohnzimmer frage, bekomme ich diese angesagt.

Der Teil im Feld Daten ist ein klassisches ReadingsVal, halt nur ohne Komma und ohne Anführungszeichen

WIRD GERADE ÜBERARBEITET

=== Schaltbefehle vom Androidgerät an FHEM senden ===
Hierfür ist ein eigener Flow einzurichten. Wie das genau geht, verrät die Hilfe.
Um einen Schaltbefehl für FHEM zu erstellen, folgt nach dem Trigger eine Aktion als Script (Aktion Type: Script). Hier ist folgendes einzutragen:

setcmd = "LichtWohnzimmerLampeRechts on"

fhemcmd = "set"

In der ersten Zeile wird also der Schaltbefehl in der Variablem setcmd eingetragen und in der zweiten Zeile der FHEM Befehl in der Variablen fhemcmd.

Danach müsst Ihr nur noch in einer weiteren Aktion den Flow "Send Data to AMADCommBridge" ausführen (Aktion Type: Flows ausführen). Die Aktion sollte bereits in Eurer Liste Vorhanden sein.

[[Datei:Screenshot_20160717-134948.png|200px]]
[[Datei:Screenshot 17.07.2016 1-50-27.png|200px]]

Nun sollte Lampe1 angeschalten werden, wenn der Flow ausgeführt wird.

=== Mit FHEM ein Flow ausführen ===
Es gibt den set Befehl userFlowRun. Als Argument übergibt man einen Flownamen. '''Achtung dieser Flowname darf keine Sonder oder Leerzeichen enthalten!!!'''

=== Schaltbefehle an FHEM senden mit Hilfe eines eigenen Flows ===

== Lister aller Variablen für die AMADCommandBridge ==
fhemcmd Variable
* Wert "set" - Variable für den Schaltbefehl 'setcmd'
* Wert "setreading" - Variable für die Readingswerte 'fhemdata'
* "readingsval" - Variable für die Abfragewerte 'readingsvalcmd'
* "fhemfunc" - Variable für den Funktionsnamen 'fhemsub'

'''Beispiele für Skriptinhalte:'''

Schalten einer Lampe

<code>
setcmd = "LichtWohnzimmerLampeRechts on";

fhemcmd = "set"
</code>

Status eines Device abfragen

<code>
readingsvalcmd = "DEVICE READING DEFAULT";

fhemcmd = "readingsval"
</code>

Die Rückgabevariable, die dann weiter verarbeitet werden kann, heißt '''respreadingsval'''

Aufruf einer 99_myUtils Subroutine

<code>
fhemsub = "mySub()"; oder natürlich auch "mySub('was_auch_immer')"

fhemcmd = "fhemfunc"
</code>

Die Rückgabevariable, die dann weiter verarbeitet werden kann, heißt '''respfhemfunc'''

== Bekannte Meldungen/Hinweise/Probleme ==

Wenn auf dem Android-Gerät die Fehlermeldung 'Accessibility service not running' von Automagic kommt oder im FHEM das reading state 'Flow Informations mit Fehler beendet' steht, dann muss der Accessibility Service auf dem Android-Device aktiviert werden: Einstellungen --> Bedienungshilfen --> Automagic Premium. Hier muss der Schalter auf 'an' stehen. Sollte dies der Fall sein, hilft u.U. ein kurzes Aus- und wieder Einschalten.

Gerät wird oft als offline angezeigt und es können keine set Befehle abgesetzt werden.
Mit der AMAD Version 2.2 hielt eine neue Behandlung des deviceState Readings Einzug. Das Reading stellt nun den tatsächlichen Status des Gerätes gegenüber FHEM da. Bei vielen Android 6 Geräten kommt es aber auf Grund vom DeepSleep Modus zum Wegfall der WLAN Verbindung. Hier hilft die neue KeepAlive Funktion in AMAD. Dafür muß lediglich unter
* Einstellungen --> Akku --> oben auf die drei Punkte - Akku Leistungsoptimierung --> alle Apps und dann Automagic auswählen und "Nicht optimieren"
ausgewählt werden und in FHEM für das Device das Attribut setAPSSID gesetzt werden. Alles andere macht das Modul selbst.

AMAD

2018-08-16T12:32:49Z

CoolTux: /* Lister aller Variablen für die AMADCommandBridge */

{{Infobox Modul
|ModPurpose=Steuern von Androidgeräten und Anzeige von bestimmten Informationen dieser Geräte
|ModType=d
|ModForumArea=Sonstige Systeme
|ModTechName=73_AMADCommBridge.pm, 74_AMADDevice.pm
|ModOwner=CoolTux ([http://forum.fhem.de/index.php?action=profile;u=13684 Forum] / [[Benutzer:CoolTux|Wiki]])
}}

= AMAD 4.2 [AMADNG] =
== 73_AMADCommBridge / 74_AMADDevice ==

= Vorwort =
=== Warum AMADNG ===
Nach fast 6 Monaten Entwicklungszeit wurde die neuste AMAD Version am 24.07.2017 offiziell frei gegeben. Diesmal lagen mir mehrere Dinge am Herzen.
In erster Linie wollte ich eine softwareseitige Trennung der AMADCommBridge vom eigentlichen Android Device. Daher ist die neue Version ein zweistufiges Modul geworden.
Im Laufe der Entwicklung kamen auch andere Anforderungen hinzu, die ich dann fähig war umzusetzen. Eine dieser Anforderungen war eine einfachere und besser funktionierende Installation. Herausgekommen ist ein Android Installationsassistant.
Mit ihm wird auf einfache Art und Weise direkt per Sprachführung und Eingabedialogen Automagic für AMAD konfiguriert und das Device in FHEM automatisch erstellt.

'''Es ist darauf zu achten, das Autocreate aktiv ist, da sonst kein Device mit Hilfe des Assistenten angelegt werden kann!'''

= Vorstellung =
Dieses 2-stufige Modul liefert, '''in Verbindung mit der Android App Automagic''', diverse Informationen von Android Geräten.
Die AndroidAPP Automagic (die nicht von mir stammt und 2.90 Euro kostet) funktioniert wie Tasker, ist aber bei weitem benutzungsfreundlicher.

=== Features / Funktionen ===
Im Auslieferungszustand werden folgende Zustände dargestellt:
* installierte Android Version
* Zustand von Automagic auf dem Gerät
* Spracheingabe
* Bluetooth An/Aus
* Zustand einer definierten App (läuft aktiv im Vordergrund oder nicht?)
* verbundene Bluetoothgeräte, inklusive deren MAC Adresse
* aktuell abgespieltes Musikalbum des verwendeten Mediaplayers
* aktuell abgespielter Musikinterpret des verwendeten Mediaplayers
* aktuell abgespielter Musiktitel des verwendeten Mediaplayers
* Status des Androidgerätes - Online/Offline
* nächster Alarmtag
* nächste Alarmzeit
* Batteriestatus in %
* Ladestatus - Netztei angeschlossen / nicht angeschlossen
* Bildschirmstatus An/Aus
* Bildschirmhelligkeit
* Vollbildmodus An/Aus
* Bildschirmausrichtung Auto/Landscape/Portrait
* Standardlautstärke
* Media Lautstärke
* ...

Mit etwas Einarbeitung können jegliche Informationen, die Automagic bereit stellt, in FHEM angezeigt werden. Hierzu bedarf es lediglich eines eigenen Flows, der seine Daten an die AMADCommBridge sendet. Das Modul gibt auch die Möglichkeit Androidgeräte zu steuern.

= AMADCommBridge - Kommunikationsbrücke für alle AMAD Geräte =
Dieses Modul ist das Ausgangsmodul zur erfolgreichen Integration von Androidgeräten in FHEM. Es stellt ferner eine Verbindungsebene zwischen AMAD unterstützten Geräten und FHEM zur Verfügung. Alle Kommunikation zwischen AMAD Android und FHEM läuft über diese Schnittstelle.
Daher erfolgt die Ersteinrichtung eines AMAD Devices auch genau über diese Modulinstanz.

Damit erfolgreich ein Androidgerät in FHEM eingerichtet werden kann, muss im ersten Schritt ein AMADCommBridge Device angelegt werden.

=== Definition in FHEM ===

<code>define <name> AMADCommBridge</code>

==== Beispiel ====

<code>define AMADBridge AMADCommBridge</code>

Diese Anweisung erstellt ein neues AMADCommBridge Device namens AMADBridge.

Im folgenden muß lediglich das Flowset auf dem Android Gerät installiert werden und der Flow 'First Run Assistent' ausgeführt werden. (einfach den Homebutton drücken)
Der Assistent geleitet dann durch die Einrichtung des AMAD Gerätes und sorgt dafür, dass am Ende des Installationsprozess das Androidgerät als AMAD Device in FHEM angelegt wird.

=== Readings ===
* JSON_ERROR - JSON Fehlermeldung, die von Perl gemeldet wird
* JSON_ERROR_STRING - der String, der die JSON Fehlermeldung verursacht hat
* fhemServerIP - die Ip-Adresse des FHEM Servers; wird vom Modul auf Basis des JSON Strings vom Installationsassistenten gesetzt. Kann aber auch mittels set Befehles vom User gesetzt werden
* receiveFhemCommand - ist das Attribut fhemControlMode auf trigger gestellt, wird das Reading gesetzt sobald ein FHEM Befehl übersendet wird. Hierauf kann dann ein Notify triggern. Wird anstelle von trigger setControl als Wert für fhemControlMode eingestellt, wird das Reading nicht gesetzt sondern der set Befehl sofort ausgeführt.
* receiveVoiceCommand - wird die Sprachsteuerung von AMAD aktiviert (set DEVICE activateVoiceInput) so wird der letzte erkannten Sprachbefehle in dieses Reading geschrieben.
* receiveVoiceDevice - Name des Devices von wo aus der letzte erkannte Sprachbefehl gesendet wurde
* state - Status der Bridge, open, closed

=== Attribute ===
* allowFrom - Regexp der erlaubten IP-Adressen oder Hostnamen. Wenn dieses Attribut gesetzt wurde, werden ausschließlich Verbindungen von diesen Adressen akzeptiert. Achtung: falls allowfrom nicht gesetzt ist, und keine gütige allowed Instanz definiert ist, und die Gegenstelle eine nicht lokale Adresse hat, dann wird die Verbindung abgewiesen. Folgende Adressen werden als local betrachtet: IPV4: 127/8, 10/8, 192.168/16, 172.16/10, 169.254/16, IPV6: ::1, fe80/10
* debugJSON - wenn auf 1 gesetzt, werden JSON Fehlermeldungen in Readings geschrieben. Siehe hierzu JSON_ERROR* unter Readings
* fhemControlMode - steuert die zulässige Art der Steuerung von FHEM Devices. Es können über die Bridge auf 2 Arten FHEM-Devices angesteuert werden: per direktem FHEM-Befehl aus einem Flow heraus oder als Sprachbefehl mittels Sprachsteuerung (set DEVICE activateVoiceInput)
** trigger - ist der Wert trigger gesetzt, werden alle an die Bridge gesendeten FHEM set Befehle in das Reading receiveFhemCommand geschrieben und können so mittels notify ausgeführt werden. Sprachsteuerung ist möglich, es werden Readings receiveVoice* gesetzt. Auf dem Androidgerät können bei Sprachsteuerung mehrere Sprachbefehle mittels "und" verknüpft/aneinander gereiht werden. Bsp: schalte die Lichtszene Abends an und schalte den Fernseher an
** setControl - alle set Befehle, die mittels eines Flows über die Bridge gesendet werden, werden automatisch ausgeführt. Das Triggern eines Readings ist nicht nötig. Die Steuerung mittels Sprache verhält sich wie beim Wert trigger
** thirdPartControl - verhält sich wie trigger, bei der Sprachsteuerung ist jedoch ein Anreihen von Sprachbefehlen mittels "und" nicht möglich. Dient der Sprachsteuerung über Module anderer Modulautoren ((z.B. 39_TEERKO.pm)

= AMADDevice - Automagic Android Device =
Dieses Modul liefert, in Verbindung mit der Android APP Automagic, diverse Informationen von Android Geräten. Die Android App Automagic (die nicht von mir stammt und 2.90 Euro kostet) funktioniert wie Tasker, ist aber bei weitem User freundlicher.
Mit etwas Einarbeitung können jegliche Informationen, die Automagic bereit stellt in FHEM angezeigt werden. Hierzu bedarf es lediglich eines eigenen Flows, der seine Daten an die AMADDeviceCommBridge sendet. Das Modul gibt auch die Möglichkeit Androidgeräte zu steuern.
Für all diese Aktionen und Informationen wird auf dem Androidgerät "Automagic" und ein so genannter Flow benötigt. Die App ist über den Google PlayStore zu beziehen. Das benötigte Flowset bekommt man aus dem FHEM Verzeichnis.

=== Wie genau verwendet man nun AMADDevice? ===
* sicherstellen, dass als allererstes die AMADCommBridge in FHEM definiert wurde
* installieren der App "Automagic Premium" aus dem PlayStore
* installieren des Flowset 74_AMADDeviceautomagicFlowset$VERSION.xml aus dem Ordner $INSTALLFHEM/FHEM/lib/ auf dem Androidgerät
* aktivieren des Installationsassistanten Flow in Automagic. Wenn man nun Automagic in den Hintergrund schickt, z.B. Hometaste drücken, startet der Assistant und legt automatisch ein Device für das Androidgerät an.

=== Ein AMADDevice Gerät von Hand anlegen. ===

Define

<code>define <name> AMADDevice <IP-ADRESSE> <AMAD_ID> <REMOTESERVER></code>

==== Beispiel ====

<code>define WandTabletWohnzimmer AMADDevice 192.168.0.23 123456 Automagic</code>

In diesem Fall wird ein AMADDevice von Hand angelegt. Die AMAD_ID, hier 123456, muß auch exakt so als globale Variable in Automagic eingetragen sein.

=== Readings ===
* airplanemode - Status des Flugmodus
* androidVersion - aktuell installierte Androidversion
* automagicState - Statusmeldungen von der Automagic App '''(Voraussetzung Android >4.3). Ist Android größer 4.3 vorhanden und im Reading steht "wird nicht unterstützt", muss in den Androideinstellungen unter Ton und Benachrichtigungen -> Benachrichtigungszugriff ein Haken für Automagic gesetzt werden'''
* batteryHealth - Zustand der Battery (1=unbekannt, 2=gut, 3=überhitzt, 4=tot, 5=Überspannung, 6=unbekannter Fehler, 7=kalt)
* batterytemperature - Temperatur der Batterie
* bluetooth - on/off, Bluetooth Status an oder aus
* checkActiveTask - Zustand einer zuvor definierten App. 0=nicht aktiv oder nicht aktiv im Vordergrund, 1=aktiv im Vordergrund, '''siehe Hinweis unten'''
* connectedBTdevices - eine Liste der verbundenen Gerät
* connectedBTdevicesMAC - eine Liste der MAC Adressen aller verbundender BT Geräte
* currentMusicAlbum - aktuell abgespieltes Musikalbum des verwendeten Mediaplayers
* currentMusicApp - aktuell verwendeter Mediaplayer (Amazon Music, Google Play Music, Google Play Video, Spotify, YouTube, TuneIn Player, Aldi Life Music)
* currentMusicArtist - aktuell abgespielter Musikinterpret des verwendeten Mediaplayers
* currentMusicIcon - Cover vom aktuell abgespielten Album '''Noch nicht fertig implementiert'''
* currentMusicState - Status des aktuellen/zuletzt verwendeten Mediaplayers
* currentMusicTrack - aktuell abgespielter Musiktitel des verwendeten Mediaplayers
* daydream - on/off, Daydream gestartet oder nicht
* deviceState - Status des Androidgerätes. unknown, online, offline.
* doNotDisturb - aktueller Status des Nicht-Stören-Modus
* dockingState - undocked/docked Status, ob sich das Gerät in einer Dockingstation befindet.
* flow_SetCommands - active/inactive, Status des SetCommands Flow
* flow_informations - active/inactive, Status des Informations Flow
* flowsetVersionAtDevice - aktuell installierte Flowsetversion auf dem Device
* incomingCallerName - Anrufername des eingehenden Anrufes
* incomingCallerNumber - Anrufernummer des eingehenden Anrufes
* incommingWhatsAppMessageFrom - letzte WhatsApp Nachricht
* incommingWhatsTelegramMessageFrom - letzte Telegram Nachricht
* intentRadioName - zuletzt gestreamter Intent Radio Name
* intentRadioState - Status des IntentRadio Players
* keyguardSet - 0/1 Displaysperre gesetzt 0=nein 1=ja, bedeutet nicht, dass sie gerade aktiv ist
* lastSetCommandError - letzte Fehlermeldung vom set Befehl
* lastSetCommandState - letzter Status vom set Befehl, Befehl erfolgreich/nicht erfolgreich gesendet
* lastStatusRequestError - letzte Fehlermeldung vom statusRequest Befehl
* lastStatusRequestState - letzter Status vom statusRequest Befehl, Befehl erfolgreich/nicht erfolgreich gesendet
* nextAlarmDay - aktiver Alarmtag
* nextAlarmState - aktueller Status des "Androidinternen" Weckers
* nextAlarmTime - aktive Alarmzeit
* powerLevel - Status der Batterie in %
* powerPlugged - Netzteil angeschlossen? 1=AC Adapter, 2=USB, 4=Kabellos 0=nicht eingesteckt
* screen - on locked/unlocked, off locked/unlocked gibt an ob der Bildschirm an oder aus ist und gleichzeitig gesperrt oder nicht gesperrt
* screenBrightness - Bildschirmhelligkeit von 0-255
* screenFullscreen - on/off, Vollbildmodus (An,Aus)
* screenOrientation - Landscape,Portrait, Bildschirmausrichtung (Horizontal,Vertikal)
* screenOrientationMode - auto/manual, Modus für die Ausrichtung (Automatisch, Manuell)
* state - aktueller Status
* userFlowState - aktueller Status eines Flows, festgelegt unter dem setUserFlowState Attribut
* volume - Media Lautstärkewert
* volumeNotification - Benachrichtigungs-Lautstärke

Beim Reading checkActivTask muß zuvor der Packagename der zu prüfenden App als Attribut checkActiveTask angegeben werden. Beispiel: attr Nexus10Wohnzimmer checkActiveTask com.android.chrome für den Chrome Browser.

=== Set ===
* activateVoiceInput - aktiviert die Spracheingabe
* bluetooth - on/off, aktiviert/deaktiviert Bluetooth
* clearNotificationBar - All,Automagic, löscht alle Meldungen oder nur die Automagic Meldungen in der Statusleiste
* closeCall - beendet einen laufenden Anruf
* currentFlowsetUpdate - führt ein Flowsetupdate auf dem Device durch
* doNotDisturb - schaltet den Nicht-Stören-Modus: always immer stören, never niemals stören, alarmClockOnly nur Wecker darf stören, onlyImportant nur wichtige Störungen
* installFlowSource - installiert einen Flow auf dem Device, das XML File muss unter /tmp/ liegen und die Endung xml haben. Bsp: set TabletWohnzimmer installFlowSource WlanUebwerwachen.xml
* mediaAmazonMusic - play, stop, next, back ,steuert den Amazon Musik Mediaplayer
* mediaGoogleMusic - play, stop, next, back ,steuert den Google Play Musik Mediaplayer
* mediaSpotifyMusic - play, stop, next, back ,steuert den Spotify Mediaplayer
* mediaTuneinRadio - play, stop, next, back ,steuert den TuneIn Radio Mediaplayer
* mediaAldiMusic - play, stop, next, back ,steuert den Aldi Musik Mediaplayer
* mediaAudible - play, stop, next, back ,steuert den Audible Mediaplayer
* mediaYouTube - play, stop, next, back ,steuert den YouTube Mediaplayer
* mediaVlcPlayer - play, stop, next, back ,steuert den VLC Mediaplayer
* nextAlarmTime - setzt die Alarmzeit. gilt aber nur innerhalb der nächsten 24 h
* openCall - ruft eine Nummer an und legt optional nach X Sekunden auf / set DEVICE openCall 01736458 10 / ruft die Nummer an und beendet den Anruf nach 10s
* screen - on/off/lock/unlock schaltet den Bildschirm ein/aus oder sperrt/entsperrt ihn
* screenBrightness - setzt die Bildschirmhelligkeit, von 0-255.
* screenMsg - versendet eine Bildschirmnachricht
* sendintent - sendet einen Intentstring Bsp: set $AMADDeviceDEVICE sendIntent org.smblott.intentradio.PLAY url http://stream.klassikradio.de/live/mp3-192/stream.klassikradio.de/play.m3u name Klassikradio, der erste Befehl ist die Aktion und der zweite das Extra. Es können immer zwei Extras mitgegeben werden.
* sendSMS - sendet eine SMS an eine bestimmte Telefonnummer. Bsp.: sendSMS Dies ist ein Test|555487263
* startDaydream - startet den Daydream
* statusRequest - Fordert einen neuen Statusreport beim Device an. Es können nicht von allen Readings per statusRequest die Daten geholt werden. Einige wenige geben nur bei Statusänderung ihren Status wieder.
* timer - setzt einen Timer innerhalb der als Standard definierten Clock-App auf dem Device. Es können nur Sekunden angegeben werden.
* ttsMsg - versendet eine Nachricht, die als Sprachnachricht ausgegeben wird
* userFlowState - aktiviert oder deaktiviert einen oder mehrere Flows,'''set Nexus7Wohnzimmer Badezimmer vorheizen:inactive oder set Nexus7Wohnzimmer Badezimmer vorheizen,Nachtlicht Steven:inactive'''
* vibrate - lässt das Androidgerät vibrieren
* volume - setzt die Medialautstärke. Entweder die internen Lautsprecher oder sofern angeschlossen die Bluetoothlautsprecher und per Klinkenstecker angeschlossene Lautsprecher, + oder - vor dem Wert reduziert die aktuelle Lautstärke um den Wert. Der maximale Sliderwert kann über das Attribut setVolMax geregelt werden.
* volumeUp - erhöht die Lautstärke um den angegeben Wert im entsprechenden Attribut. Ist kein Attribut angegeben wird per default 2 genommen.
* volumeDown - reduziert die Lautstärke um den angegeben Wert im entsprechenden Attribut. Ist kein Attribut angegeben wird per default 2 genommen.
* volumeNotification - setzt die Benachrichtigungslautstärke.

==== Set abhängig von gesetzten Attributen ====
* changetoBtDevice - wechselt zu einem anderen Bluetooth Gerät. Attribut setBluetoothDevice muß gesetzt sein. Siehe Hinweis unten!
* notifySndFile - spielt die angegebene Mediadatei auf dem Androidgerät ab. Die aufzurufende Mediadatei sollte sich im Ordner /storage/emulated/0/Notifications/ befinden. Ist dies nicht der Fall kann man über das Attribut setNotifySndFilePath einen Pfad vorgeben.
* openApp - öffnet eine ausgewählte App. Attribut setOpenApp
* openURL - öffnet eine URL im Standardbrowser, sofern kein anderer Browser über das Attribut setOpenUrlBrowser ausgewählt wurde. Bsp: attr Tablet setOpenUrlBrowser de.ozerov.fully|de.ozerov.fully.MainActivity, das erste ist der Package Name und das zweite der Class Name
* setAPSSID - setzt die AccessPoint SSID um ein WLAN sleep zu verhindern
* setScreenOnForTimer ändert die Zeitdauer, die das Display an bleiben soll!
* screenFullscreen - on/off, (aktiviert/deaktiviert) den Vollbildmodus. Attribut setFullscreen
* screenLock - Sperrt den Bildschirm mit Pinabfrage. Attribut setScreenlockPIN - hier die Pin dafür eingeben. Erlaubt sind nur Zahlen. Es müßen mindestens 4, bis max 16 Zeichen verwendet werden.
* screenOrientation - Auto,Landscape,Portait, aktiviert die Bildschirmausrichtung (Automatisch,Horizontal,Vertikal). Attribut setScreenOrientation
* system - setzt Systembefehle ab (nur bei gerootetet Geräten). reboot,shutdown,airplanemodeON (kann nur aktiviert werden) Attribut root, in den Automagic Einstellungen muss "Root Funktion" gesetzt werden
* setNotifySndFilePath - setzt den korrekten Systempfad zur Notifydatei (default ist /storage/emulated/0/Notifications/
* setTtsMsgSpeed - setzt die Sprachgeschwindigkeit bei der Sprachausgabe(Werte zwischen 0.5 bis 4.0 in 0.5er Schritten) default ist 1.0
* setTtsMsgSpeed - setzt die Sprache bei der Sprachausgabe, de oder en (default ist de)
* setVolUpDownStep - setzt den Step für volumeUp und volumeDown
* setVolMax - setzt die maximale Volume Größe für den Slider
* setNotifyVolMax - setzt den maximalen Lautstärkewert für Benachrichtigungslautstärke für den Slider
* setRingSoundVolMax - setzt den maximalen Lautstärkewert für Klingellautstärke für den Slider

'''Um openApp verwenden zu können, muss als Attribut der Package Name der App angegeben werden.

'''Um zwischen Bluetoothgeräten wechseln zu können, muss das Attribut setBluetoothDevice mit folgender Syntax gesetzt werden. attr <DEVICE> BTdeviceName1|MAC,BTDeviceName2|MAC Es muss zwingend darauf geachtet werden, dass beim BTdeviceName kein Leerzeichen vorhanden ist. Am besten zusammen oder mit Unterstrich. Bei der MAC ist darauf zu achten, dass wirklich nach jeder zweiten Zahl ein : steht

** '''Beispiel: attr Nexus10Wohnzimmer setBluetoothDevice Logitech_BT_Adapter|AB:12:CD:34:EF:32,Anker_A3565|GH:56:IJ:78:KL:76

=== state ===
* initialized - Ist der Status kurz nach einem define.
* active - die Geräteinstanz ist im aktiven Status.
* disabled - die Geräteinstanz wurde über das Attribut disable deaktiviert

==Anwendungsbeispiele==
=== Lademanagement ===
Ich habe die Ladegeräte für meine Androidgeräte an Funkschaltsteckdosen. Ein DOIF schaltet bei unter 30% die Steckdose ein und bei über 90% wieder aus.

Hier mal ein einfaches DOIF Beispiel für ein Lademanagment

<code>
... DOIF ([Nexus5Handy:powerLevel] < 30) (set LadenetzteilNexus5Handy:FILTER=STATE=off on) DOELSEIF ([Nexus5Handy:powerLevel] > 90) (set LadenetzteilNexus5Handy:FILTER=STATE=on off) DOELSE
</code>

=== Wecker ===
Morgens lasse ich mich über mein Tablet im Schlafzimmer mit Musik wecken. Verwendet wird hierzu der wakeuptimer des RESIDENTS Modules. Das Abspielen stoppe ich dann von Hand. Danach erfolgt noch eine Ansage wie das Wetter gerade ist und wird.

=== Mediacenter ===
Mein 10" Tablet im Wohnzimmer ist Mediaplayer für das Wohnzimmer mit Bluetoothlautsprechern. Die Lautstärke wird automatisch heruntergesetzt, wenn die Fritzbox einen Anruf auf das Wohnzimmer Handgerät signalisiert.

=== Sprachbefehl - Abfragen von Zuständen diverser Sensoren ===
Wenn ich die Spracheingabe aktiviere und nach der Temperatur im Wohnzimmer frage, bekomme ich diese angesagt.

Der Teil im Feld Daten ist ein klassisches ReadingsVal, halt nur ohne Komma und ohne Anführungszeichen

WIRD GERADE ÜBERARBEITET

=== Schaltbefehle vom Androidgerät an FHEM senden ===
Hierfür ist ein eigener Flow einzurichten. Wie das genau geht, verrät die Hilfe.
Um einen Schaltbefehl für FHEM zu erstellen, folgt nach dem Trigger eine Aktion als Script (Aktion Type: Script). Hier ist folgendes einzutragen:

setcmd = "LichtWohnzimmerLampeRechts on"

fhemcmd = "set"

In der ersten Zeile wird also der Schaltbefehl in der Variablem setcmd eingetragen und in der zweiten Zeile der FHEM Befehl in der Variablen fhemcmd.

Danach müsst Ihr nur noch in einer weiteren Aktion den Flow "Send Data to AMADCommBridge" ausführen (Aktion Type: Flows ausführen). Die Aktion sollte bereits in Eurer Liste Vorhanden sein.

[[Datei:Screenshot_20160717-134948.png|200px]]
[[Datei:Screenshot 17.07.2016 1-50-27.png|200px]]

Nun sollte Lampe1 angeschalten werden, wenn der Flow ausgeführt wird.

=== Mit FHEM ein Flow ausführen ===
Es gibt den set Befehl userFlowRun. Als Argument übergibt man einen Flownamen. '''Achtung dieser Flowname darf keine Sonder oder Leerzeichen enthalten!!!'''

=== Schaltbefehle an FHEM senden mit Hilfe eines eigenen Flows
== Lister aller Variablen für die AMADCommandBridge ==
fhemcmd Variable
* Wert "set" - Variable für den Schaltbefehl 'setcmd'
* Wert "setreading" - Variable für die Readingswerte 'fhemdata'
* "readingsval" - Variable für die Abfragewerte 'readingsvalcmd'
* "fhemfunc" - Variable für den Funktionsnamen 'fhemsub'

'''Beispiele für Skriptinhalte:'''

Schalten einer Lampe

<code>
setcmd = "LichtWohnzimmerLampeRechts on";

fhemcmd = "set"
</code>

Status eines Device abfragen

<code>
readingsvalcmd = "DEVICE READING DEFAULT";

fhemcmd = "readingsval"
</code>

Die Rückgabevariable, die dann weiter verarbeitet werden kann, heißt '''respreadingsval'''

Aufruf einer 99_myUtils Subroutine

<code>
fhemsub = "mySub()"; oder natürlich auch "mySub('was_auch_immer')"

fhemcmd = "fhemfunc"
</code>

Die Rückgabevariable, die dann weiter verarbeitet werden kann, heißt '''respfhemfunc'''

== Bekannte Meldungen/Hinweise/Probleme ==

Wenn auf dem Android-Gerät die Fehlermeldung 'Accessibility service not running' von Automagic kommt oder im FHEM das reading state 'Flow Informations mit Fehler beendet' steht, dann muss der Accessibility Service auf dem Android-Device aktiviert werden: Einstellungen --> Bedienungshilfen --> Automagic Premium. Hier muss der Schalter auf 'an' stehen. Sollte dies der Fall sein, hilft u.U. ein kurzes Aus- und wieder Einschalten.

Gerät wird oft als offline angezeigt und es können keine set Befehle abgesetzt werden.
Mit der AMAD Version 2.2 hielt eine neue Behandlung des deviceState Readings Einzug. Das Reading stellt nun den tatsächlichen Status des Gerätes gegenüber FHEM da. Bei vielen Android 6 Geräten kommt es aber auf Grund vom DeepSleep Modus zum Wegfall der WLAN Verbindung. Hier hilft die neue KeepAlive Funktion in AMAD. Dafür muß lediglich unter
* Einstellungen --> Akku --> oben auf die drei Punkte - Akku Leistungsoptimierung --> alle Apps und dann Automagic auswählen und "Nicht optimieren"
ausgewählt werden und in FHEM für das Device das Attribut setAPSSID gesetzt werden. Alles andere macht das Modul selbst.

AMAD

2018-08-16T12:31:39Z

CoolTux: /* Mit FHEM ein Flow ausführen */

{{Infobox Modul
|ModPurpose=Steuern von Androidgeräten und Anzeige von bestimmten Informationen dieser Geräte
|ModType=d
|ModForumArea=Sonstige Systeme
|ModTechName=73_AMADCommBridge.pm, 74_AMADDevice.pm
|ModOwner=CoolTux ([http://forum.fhem.de/index.php?action=profile;u=13684 Forum] / [[Benutzer:CoolTux|Wiki]])
}}

= AMAD 4.2 [AMADNG] =
== 73_AMADCommBridge / 74_AMADDevice ==

= Vorwort =
=== Warum AMADNG ===
Nach fast 6 Monaten Entwicklungszeit wurde die neuste AMAD Version am 24.07.2017 offiziell frei gegeben. Diesmal lagen mir mehrere Dinge am Herzen.
In erster Linie wollte ich eine softwareseitige Trennung der AMADCommBridge vom eigentlichen Android Device. Daher ist die neue Version ein zweistufiges Modul geworden.
Im Laufe der Entwicklung kamen auch andere Anforderungen hinzu, die ich dann fähig war umzusetzen. Eine dieser Anforderungen war eine einfachere und besser funktionierende Installation. Herausgekommen ist ein Android Installationsassistant.
Mit ihm wird auf einfache Art und Weise direkt per Sprachführung und Eingabedialogen Automagic für AMAD konfiguriert und das Device in FHEM automatisch erstellt.

'''Es ist darauf zu achten, das Autocreate aktiv ist, da sonst kein Device mit Hilfe des Assistenten angelegt werden kann!'''

= Vorstellung =
Dieses 2-stufige Modul liefert, '''in Verbindung mit der Android App Automagic''', diverse Informationen von Android Geräten.
Die AndroidAPP Automagic (die nicht von mir stammt und 2.90 Euro kostet) funktioniert wie Tasker, ist aber bei weitem benutzungsfreundlicher.

=== Features / Funktionen ===
Im Auslieferungszustand werden folgende Zustände dargestellt:
* installierte Android Version
* Zustand von Automagic auf dem Gerät
* Spracheingabe
* Bluetooth An/Aus
* Zustand einer definierten App (läuft aktiv im Vordergrund oder nicht?)
* verbundene Bluetoothgeräte, inklusive deren MAC Adresse
* aktuell abgespieltes Musikalbum des verwendeten Mediaplayers
* aktuell abgespielter Musikinterpret des verwendeten Mediaplayers
* aktuell abgespielter Musiktitel des verwendeten Mediaplayers
* Status des Androidgerätes - Online/Offline
* nächster Alarmtag
* nächste Alarmzeit
* Batteriestatus in %
* Ladestatus - Netztei angeschlossen / nicht angeschlossen
* Bildschirmstatus An/Aus
* Bildschirmhelligkeit
* Vollbildmodus An/Aus
* Bildschirmausrichtung Auto/Landscape/Portrait
* Standardlautstärke
* Media Lautstärke
* ...

Mit etwas Einarbeitung können jegliche Informationen, die Automagic bereit stellt, in FHEM angezeigt werden. Hierzu bedarf es lediglich eines eigenen Flows, der seine Daten an die AMADCommBridge sendet. Das Modul gibt auch die Möglichkeit Androidgeräte zu steuern.

= AMADCommBridge - Kommunikationsbrücke für alle AMAD Geräte =
Dieses Modul ist das Ausgangsmodul zur erfolgreichen Integration von Androidgeräten in FHEM. Es stellt ferner eine Verbindungsebene zwischen AMAD unterstützten Geräten und FHEM zur Verfügung. Alle Kommunikation zwischen AMAD Android und FHEM läuft über diese Schnittstelle.
Daher erfolgt die Ersteinrichtung eines AMAD Devices auch genau über diese Modulinstanz.

Damit erfolgreich ein Androidgerät in FHEM eingerichtet werden kann, muss im ersten Schritt ein AMADCommBridge Device angelegt werden.

=== Definition in FHEM ===

<code>define <name> AMADCommBridge</code>

==== Beispiel ====

<code>define AMADBridge AMADCommBridge</code>

Diese Anweisung erstellt ein neues AMADCommBridge Device namens AMADBridge.

Im folgenden muß lediglich das Flowset auf dem Android Gerät installiert werden und der Flow 'First Run Assistent' ausgeführt werden. (einfach den Homebutton drücken)
Der Assistent geleitet dann durch die Einrichtung des AMAD Gerätes und sorgt dafür, dass am Ende des Installationsprozess das Androidgerät als AMAD Device in FHEM angelegt wird.

=== Readings ===
* JSON_ERROR - JSON Fehlermeldung, die von Perl gemeldet wird
* JSON_ERROR_STRING - der String, der die JSON Fehlermeldung verursacht hat
* fhemServerIP - die Ip-Adresse des FHEM Servers; wird vom Modul auf Basis des JSON Strings vom Installationsassistenten gesetzt. Kann aber auch mittels set Befehles vom User gesetzt werden
* receiveFhemCommand - ist das Attribut fhemControlMode auf trigger gestellt, wird das Reading gesetzt sobald ein FHEM Befehl übersendet wird. Hierauf kann dann ein Notify triggern. Wird anstelle von trigger setControl als Wert für fhemControlMode eingestellt, wird das Reading nicht gesetzt sondern der set Befehl sofort ausgeführt.
* receiveVoiceCommand - wird die Sprachsteuerung von AMAD aktiviert (set DEVICE activateVoiceInput) so wird der letzte erkannten Sprachbefehle in dieses Reading geschrieben.
* receiveVoiceDevice - Name des Devices von wo aus der letzte erkannte Sprachbefehl gesendet wurde
* state - Status der Bridge, open, closed

=== Attribute ===
* allowFrom - Regexp der erlaubten IP-Adressen oder Hostnamen. Wenn dieses Attribut gesetzt wurde, werden ausschließlich Verbindungen von diesen Adressen akzeptiert. Achtung: falls allowfrom nicht gesetzt ist, und keine gütige allowed Instanz definiert ist, und die Gegenstelle eine nicht lokale Adresse hat, dann wird die Verbindung abgewiesen. Folgende Adressen werden als local betrachtet: IPV4: 127/8, 10/8, 192.168/16, 172.16/10, 169.254/16, IPV6: ::1, fe80/10
* debugJSON - wenn auf 1 gesetzt, werden JSON Fehlermeldungen in Readings geschrieben. Siehe hierzu JSON_ERROR* unter Readings
* fhemControlMode - steuert die zulässige Art der Steuerung von FHEM Devices. Es können über die Bridge auf 2 Arten FHEM-Devices angesteuert werden: per direktem FHEM-Befehl aus einem Flow heraus oder als Sprachbefehl mittels Sprachsteuerung (set DEVICE activateVoiceInput)
** trigger - ist der Wert trigger gesetzt, werden alle an die Bridge gesendeten FHEM set Befehle in das Reading receiveFhemCommand geschrieben und können so mittels notify ausgeführt werden. Sprachsteuerung ist möglich, es werden Readings receiveVoice* gesetzt. Auf dem Androidgerät können bei Sprachsteuerung mehrere Sprachbefehle mittels "und" verknüpft/aneinander gereiht werden. Bsp: schalte die Lichtszene Abends an und schalte den Fernseher an
** setControl - alle set Befehle, die mittels eines Flows über die Bridge gesendet werden, werden automatisch ausgeführt. Das Triggern eines Readings ist nicht nötig. Die Steuerung mittels Sprache verhält sich wie beim Wert trigger
** thirdPartControl - verhält sich wie trigger, bei der Sprachsteuerung ist jedoch ein Anreihen von Sprachbefehlen mittels "und" nicht möglich. Dient der Sprachsteuerung über Module anderer Modulautoren ((z.B. 39_TEERKO.pm)

= AMADDevice - Automagic Android Device =
Dieses Modul liefert, in Verbindung mit der Android APP Automagic, diverse Informationen von Android Geräten. Die Android App Automagic (die nicht von mir stammt und 2.90 Euro kostet) funktioniert wie Tasker, ist aber bei weitem User freundlicher.
Mit etwas Einarbeitung können jegliche Informationen, die Automagic bereit stellt in FHEM angezeigt werden. Hierzu bedarf es lediglich eines eigenen Flows, der seine Daten an die AMADDeviceCommBridge sendet. Das Modul gibt auch die Möglichkeit Androidgeräte zu steuern.
Für all diese Aktionen und Informationen wird auf dem Androidgerät "Automagic" und ein so genannter Flow benötigt. Die App ist über den Google PlayStore zu beziehen. Das benötigte Flowset bekommt man aus dem FHEM Verzeichnis.

=== Wie genau verwendet man nun AMADDevice? ===
* sicherstellen, dass als allererstes die AMADCommBridge in FHEM definiert wurde
* installieren der App "Automagic Premium" aus dem PlayStore
* installieren des Flowset 74_AMADDeviceautomagicFlowset$VERSION.xml aus dem Ordner $INSTALLFHEM/FHEM/lib/ auf dem Androidgerät
* aktivieren des Installationsassistanten Flow in Automagic. Wenn man nun Automagic in den Hintergrund schickt, z.B. Hometaste drücken, startet der Assistant und legt automatisch ein Device für das Androidgerät an.

=== Ein AMADDevice Gerät von Hand anlegen. ===

Define

<code>define <name> AMADDevice <IP-ADRESSE> <AMAD_ID> <REMOTESERVER></code>

==== Beispiel ====

<code>define WandTabletWohnzimmer AMADDevice 192.168.0.23 123456 Automagic</code>

In diesem Fall wird ein AMADDevice von Hand angelegt. Die AMAD_ID, hier 123456, muß auch exakt so als globale Variable in Automagic eingetragen sein.

=== Readings ===
* airplanemode - Status des Flugmodus
* androidVersion - aktuell installierte Androidversion
* automagicState - Statusmeldungen von der Automagic App '''(Voraussetzung Android >4.3). Ist Android größer 4.3 vorhanden und im Reading steht "wird nicht unterstützt", muss in den Androideinstellungen unter Ton und Benachrichtigungen -> Benachrichtigungszugriff ein Haken für Automagic gesetzt werden'''
* batteryHealth - Zustand der Battery (1=unbekannt, 2=gut, 3=überhitzt, 4=tot, 5=Überspannung, 6=unbekannter Fehler, 7=kalt)
* batterytemperature - Temperatur der Batterie
* bluetooth - on/off, Bluetooth Status an oder aus
* checkActiveTask - Zustand einer zuvor definierten App. 0=nicht aktiv oder nicht aktiv im Vordergrund, 1=aktiv im Vordergrund, '''siehe Hinweis unten'''
* connectedBTdevices - eine Liste der verbundenen Gerät
* connectedBTdevicesMAC - eine Liste der MAC Adressen aller verbundender BT Geräte
* currentMusicAlbum - aktuell abgespieltes Musikalbum des verwendeten Mediaplayers
* currentMusicApp - aktuell verwendeter Mediaplayer (Amazon Music, Google Play Music, Google Play Video, Spotify, YouTube, TuneIn Player, Aldi Life Music)
* currentMusicArtist - aktuell abgespielter Musikinterpret des verwendeten Mediaplayers
* currentMusicIcon - Cover vom aktuell abgespielten Album '''Noch nicht fertig implementiert'''
* currentMusicState - Status des aktuellen/zuletzt verwendeten Mediaplayers
* currentMusicTrack - aktuell abgespielter Musiktitel des verwendeten Mediaplayers
* daydream - on/off, Daydream gestartet oder nicht
* deviceState - Status des Androidgerätes. unknown, online, offline.
* doNotDisturb - aktueller Status des Nicht-Stören-Modus
* dockingState - undocked/docked Status, ob sich das Gerät in einer Dockingstation befindet.
* flow_SetCommands - active/inactive, Status des SetCommands Flow
* flow_informations - active/inactive, Status des Informations Flow
* flowsetVersionAtDevice - aktuell installierte Flowsetversion auf dem Device
* incomingCallerName - Anrufername des eingehenden Anrufes
* incomingCallerNumber - Anrufernummer des eingehenden Anrufes
* incommingWhatsAppMessageFrom - letzte WhatsApp Nachricht
* incommingWhatsTelegramMessageFrom - letzte Telegram Nachricht
* intentRadioName - zuletzt gestreamter Intent Radio Name
* intentRadioState - Status des IntentRadio Players
* keyguardSet - 0/1 Displaysperre gesetzt 0=nein 1=ja, bedeutet nicht, dass sie gerade aktiv ist
* lastSetCommandError - letzte Fehlermeldung vom set Befehl
* lastSetCommandState - letzter Status vom set Befehl, Befehl erfolgreich/nicht erfolgreich gesendet
* lastStatusRequestError - letzte Fehlermeldung vom statusRequest Befehl
* lastStatusRequestState - letzter Status vom statusRequest Befehl, Befehl erfolgreich/nicht erfolgreich gesendet
* nextAlarmDay - aktiver Alarmtag
* nextAlarmState - aktueller Status des "Androidinternen" Weckers
* nextAlarmTime - aktive Alarmzeit
* powerLevel - Status der Batterie in %
* powerPlugged - Netzteil angeschlossen? 1=AC Adapter, 2=USB, 4=Kabellos 0=nicht eingesteckt
* screen - on locked/unlocked, off locked/unlocked gibt an ob der Bildschirm an oder aus ist und gleichzeitig gesperrt oder nicht gesperrt
* screenBrightness - Bildschirmhelligkeit von 0-255
* screenFullscreen - on/off, Vollbildmodus (An,Aus)
* screenOrientation - Landscape,Portrait, Bildschirmausrichtung (Horizontal,Vertikal)
* screenOrientationMode - auto/manual, Modus für die Ausrichtung (Automatisch, Manuell)
* state - aktueller Status
* userFlowState - aktueller Status eines Flows, festgelegt unter dem setUserFlowState Attribut
* volume - Media Lautstärkewert
* volumeNotification - Benachrichtigungs-Lautstärke

Beim Reading checkActivTask muß zuvor der Packagename der zu prüfenden App als Attribut checkActiveTask angegeben werden. Beispiel: attr Nexus10Wohnzimmer checkActiveTask com.android.chrome für den Chrome Browser.

=== Set ===
* activateVoiceInput - aktiviert die Spracheingabe
* bluetooth - on/off, aktiviert/deaktiviert Bluetooth
* clearNotificationBar - All,Automagic, löscht alle Meldungen oder nur die Automagic Meldungen in der Statusleiste
* closeCall - beendet einen laufenden Anruf
* currentFlowsetUpdate - führt ein Flowsetupdate auf dem Device durch
* doNotDisturb - schaltet den Nicht-Stören-Modus: always immer stören, never niemals stören, alarmClockOnly nur Wecker darf stören, onlyImportant nur wichtige Störungen
* installFlowSource - installiert einen Flow auf dem Device, das XML File muss unter /tmp/ liegen und die Endung xml haben. Bsp: set TabletWohnzimmer installFlowSource WlanUebwerwachen.xml
* mediaAmazonMusic - play, stop, next, back ,steuert den Amazon Musik Mediaplayer
* mediaGoogleMusic - play, stop, next, back ,steuert den Google Play Musik Mediaplayer
* mediaSpotifyMusic - play, stop, next, back ,steuert den Spotify Mediaplayer
* mediaTuneinRadio - play, stop, next, back ,steuert den TuneIn Radio Mediaplayer
* mediaAldiMusic - play, stop, next, back ,steuert den Aldi Musik Mediaplayer
* mediaAudible - play, stop, next, back ,steuert den Audible Mediaplayer
* mediaYouTube - play, stop, next, back ,steuert den YouTube Mediaplayer
* mediaVlcPlayer - play, stop, next, back ,steuert den VLC Mediaplayer
* nextAlarmTime - setzt die Alarmzeit. gilt aber nur innerhalb der nächsten 24 h
* openCall - ruft eine Nummer an und legt optional nach X Sekunden auf / set DEVICE openCall 01736458 10 / ruft die Nummer an und beendet den Anruf nach 10s
* screen - on/off/lock/unlock schaltet den Bildschirm ein/aus oder sperrt/entsperrt ihn
* screenBrightness - setzt die Bildschirmhelligkeit, von 0-255.
* screenMsg - versendet eine Bildschirmnachricht
* sendintent - sendet einen Intentstring Bsp: set $AMADDeviceDEVICE sendIntent org.smblott.intentradio.PLAY url http://stream.klassikradio.de/live/mp3-192/stream.klassikradio.de/play.m3u name Klassikradio, der erste Befehl ist die Aktion und der zweite das Extra. Es können immer zwei Extras mitgegeben werden.
* sendSMS - sendet eine SMS an eine bestimmte Telefonnummer. Bsp.: sendSMS Dies ist ein Test|555487263
* startDaydream - startet den Daydream
* statusRequest - Fordert einen neuen Statusreport beim Device an. Es können nicht von allen Readings per statusRequest die Daten geholt werden. Einige wenige geben nur bei Statusänderung ihren Status wieder.
* timer - setzt einen Timer innerhalb der als Standard definierten Clock-App auf dem Device. Es können nur Sekunden angegeben werden.
* ttsMsg - versendet eine Nachricht, die als Sprachnachricht ausgegeben wird
* userFlowState - aktiviert oder deaktiviert einen oder mehrere Flows,'''set Nexus7Wohnzimmer Badezimmer vorheizen:inactive oder set Nexus7Wohnzimmer Badezimmer vorheizen,Nachtlicht Steven:inactive'''
* vibrate - lässt das Androidgerät vibrieren
* volume - setzt die Medialautstärke. Entweder die internen Lautsprecher oder sofern angeschlossen die Bluetoothlautsprecher und per Klinkenstecker angeschlossene Lautsprecher, + oder - vor dem Wert reduziert die aktuelle Lautstärke um den Wert. Der maximale Sliderwert kann über das Attribut setVolMax geregelt werden.
* volumeUp - erhöht die Lautstärke um den angegeben Wert im entsprechenden Attribut. Ist kein Attribut angegeben wird per default 2 genommen.
* volumeDown - reduziert die Lautstärke um den angegeben Wert im entsprechenden Attribut. Ist kein Attribut angegeben wird per default 2 genommen.
* volumeNotification - setzt die Benachrichtigungslautstärke.

==== Set abhängig von gesetzten Attributen ====
* changetoBtDevice - wechselt zu einem anderen Bluetooth Gerät. Attribut setBluetoothDevice muß gesetzt sein. Siehe Hinweis unten!
* notifySndFile - spielt die angegebene Mediadatei auf dem Androidgerät ab. Die aufzurufende Mediadatei sollte sich im Ordner /storage/emulated/0/Notifications/ befinden. Ist dies nicht der Fall kann man über das Attribut setNotifySndFilePath einen Pfad vorgeben.
* openApp - öffnet eine ausgewählte App. Attribut setOpenApp
* openURL - öffnet eine URL im Standardbrowser, sofern kein anderer Browser über das Attribut setOpenUrlBrowser ausgewählt wurde. Bsp: attr Tablet setOpenUrlBrowser de.ozerov.fully|de.ozerov.fully.MainActivity, das erste ist der Package Name und das zweite der Class Name
* setAPSSID - setzt die AccessPoint SSID um ein WLAN sleep zu verhindern
* setScreenOnForTimer ändert die Zeitdauer, die das Display an bleiben soll!
* screenFullscreen - on/off, (aktiviert/deaktiviert) den Vollbildmodus. Attribut setFullscreen
* screenLock - Sperrt den Bildschirm mit Pinabfrage. Attribut setScreenlockPIN - hier die Pin dafür eingeben. Erlaubt sind nur Zahlen. Es müßen mindestens 4, bis max 16 Zeichen verwendet werden.
* screenOrientation - Auto,Landscape,Portait, aktiviert die Bildschirmausrichtung (Automatisch,Horizontal,Vertikal). Attribut setScreenOrientation
* system - setzt Systembefehle ab (nur bei gerootetet Geräten). reboot,shutdown,airplanemodeON (kann nur aktiviert werden) Attribut root, in den Automagic Einstellungen muss "Root Funktion" gesetzt werden
* setNotifySndFilePath - setzt den korrekten Systempfad zur Notifydatei (default ist /storage/emulated/0/Notifications/
* setTtsMsgSpeed - setzt die Sprachgeschwindigkeit bei der Sprachausgabe(Werte zwischen 0.5 bis 4.0 in 0.5er Schritten) default ist 1.0
* setTtsMsgSpeed - setzt die Sprache bei der Sprachausgabe, de oder en (default ist de)
* setVolUpDownStep - setzt den Step für volumeUp und volumeDown
* setVolMax - setzt die maximale Volume Größe für den Slider
* setNotifyVolMax - setzt den maximalen Lautstärkewert für Benachrichtigungslautstärke für den Slider
* setRingSoundVolMax - setzt den maximalen Lautstärkewert für Klingellautstärke für den Slider

'''Um openApp verwenden zu können, muss als Attribut der Package Name der App angegeben werden.

'''Um zwischen Bluetoothgeräten wechseln zu können, muss das Attribut setBluetoothDevice mit folgender Syntax gesetzt werden. attr <DEVICE> BTdeviceName1|MAC,BTDeviceName2|MAC Es muss zwingend darauf geachtet werden, dass beim BTdeviceName kein Leerzeichen vorhanden ist. Am besten zusammen oder mit Unterstrich. Bei der MAC ist darauf zu achten, dass wirklich nach jeder zweiten Zahl ein : steht

** '''Beispiel: attr Nexus10Wohnzimmer setBluetoothDevice Logitech_BT_Adapter|AB:12:CD:34:EF:32,Anker_A3565|GH:56:IJ:78:KL:76

=== state ===
* initialized - Ist der Status kurz nach einem define.
* active - die Geräteinstanz ist im aktiven Status.
* disabled - die Geräteinstanz wurde über das Attribut disable deaktiviert

==Anwendungsbeispiele==
=== Lademanagement ===
Ich habe die Ladegeräte für meine Androidgeräte an Funkschaltsteckdosen. Ein DOIF schaltet bei unter 30% die Steckdose ein und bei über 90% wieder aus.

Hier mal ein einfaches DOIF Beispiel für ein Lademanagment

<code>
... DOIF ([Nexus5Handy:powerLevel] < 30) (set LadenetzteilNexus5Handy:FILTER=STATE=off on) DOELSEIF ([Nexus5Handy:powerLevel] > 90) (set LadenetzteilNexus5Handy:FILTER=STATE=on off) DOELSE
</code>

=== Wecker ===
Morgens lasse ich mich über mein Tablet im Schlafzimmer mit Musik wecken. Verwendet wird hierzu der wakeuptimer des RESIDENTS Modules. Das Abspielen stoppe ich dann von Hand. Danach erfolgt noch eine Ansage wie das Wetter gerade ist und wird.

=== Mediacenter ===
Mein 10" Tablet im Wohnzimmer ist Mediaplayer für das Wohnzimmer mit Bluetoothlautsprechern. Die Lautstärke wird automatisch heruntergesetzt, wenn die Fritzbox einen Anruf auf das Wohnzimmer Handgerät signalisiert.

=== Sprachbefehl - Abfragen von Zuständen diverser Sensoren ===
Wenn ich die Spracheingabe aktiviere und nach der Temperatur im Wohnzimmer frage, bekomme ich diese angesagt.

Der Teil im Feld Daten ist ein klassisches ReadingsVal, halt nur ohne Komma und ohne Anführungszeichen

WIRD GERADE ÜBERARBEITET

=== Schaltbefehle vom Androidgerät an FHEM senden ===
Hierfür ist ein eigener Flow einzurichten. Wie das genau geht, verrät die Hilfe.
Um einen Schaltbefehl für FHEM zu erstellen, folgt nach dem Trigger eine Aktion als Script (Aktion Type: Script). Hier ist folgendes einzutragen:

setcmd = "LichtWohnzimmerLampeRechts on"

fhemcmd = "set"

In der ersten Zeile wird also der Schaltbefehl in der Variablem setcmd eingetragen und in der zweiten Zeile der FHEM Befehl in der Variablen fhemcmd.

Danach müsst Ihr nur noch in einer weiteren Aktion den Flow "Send Data to AMADCommBridge" ausführen (Aktion Type: Flows ausführen). Die Aktion sollte bereits in Eurer Liste Vorhanden sein.

[[Datei:Screenshot_20160717-134948.png|200px]]
[[Datei:Screenshot 17.07.2016 1-50-27.png|200px]]

Nun sollte Lampe1 angeschalten werden, wenn der Flow ausgeführt wird.

=== Mit FHEM ein Flow ausführen ===
Es gibt den set Befehl userFlowRun. Als Argument übergibt man einen Flownamen. '''Achtung dieser Flowname darf keine Sonder oder Leerzeichen enthalten!!!'''

=== Lister aller Variablen für die AMADCommandBridge ===
fhemcmd Variable
* Wert "set" - Variable für den Schaltbefehl 'setcmd'
* Wert "setreading" - Variable für die Readingswerte 'fhemdata'
* "readingsval" - Variable für die Abfragewerte 'readingsvalcmd'
* "fhemfunc" - Variable für den Funktionsnamen 'fhemsub'

'''Beispiele für Skriptinhalte:'''

Schalten einer Lampe

<code>
setcmd = "LichtWohnzimmerLampeRechts on";

fhemcmd = "set"
</code>

Status eines Device abfragen

<code>
readingsvalcmd = "DEVICE READING DEFAULT";

fhemcmd = "readingsval"
</code>

Die Rückgabevariable, die dann weiter verarbeitet werden kann, heißt '''respreadingsval'''

Aufruf einer 99_myUtils Subroutine

<code>
fhemsub = "mySub()"; oder natürlich auch "mySub('was_auch_immer')"

fhemcmd = "fhemfunc"
</code>

Die Rückgabevariable, die dann weiter verarbeitet werden kann, heißt '''respfhemfunc'''

== Bekannte Meldungen/Hinweise/Probleme ==

Wenn auf dem Android-Gerät die Fehlermeldung 'Accessibility service not running' von Automagic kommt oder im FHEM das reading state 'Flow Informations mit Fehler beendet' steht, dann muss der Accessibility Service auf dem Android-Device aktiviert werden: Einstellungen --> Bedienungshilfen --> Automagic Premium. Hier muss der Schalter auf 'an' stehen. Sollte dies der Fall sein, hilft u.U. ein kurzes Aus- und wieder Einschalten.

Gerät wird oft als offline angezeigt und es können keine set Befehle abgesetzt werden.
Mit der AMAD Version 2.2 hielt eine neue Behandlung des deviceState Readings Einzug. Das Reading stellt nun den tatsächlichen Status des Gerätes gegenüber FHEM da. Bei vielen Android 6 Geräten kommt es aber auf Grund vom DeepSleep Modus zum Wegfall der WLAN Verbindung. Hier hilft die neue KeepAlive Funktion in AMAD. Dafür muß lediglich unter
* Einstellungen --> Akku --> oben auf die drei Punkte - Akku Leistungsoptimierung --> alle Apps und dann Automagic auswählen und "Nicht optimieren"
ausgewählt werden und in FHEM für das Device das Attribut setAPSSID gesetzt werden. Alles andere macht das Modul selbst.

AMAD

2018-08-16T12:27:59Z

CoolTux: /* Mit FHEM ein Flow ausführen */

{{Infobox Modul
|ModPurpose=Steuern von Androidgeräten und Anzeige von bestimmten Informationen dieser Geräte
|ModType=d
|ModForumArea=Sonstige Systeme
|ModTechName=73_AMADCommBridge.pm, 74_AMADDevice.pm
|ModOwner=CoolTux ([http://forum.fhem.de/index.php?action=profile;u=13684 Forum] / [[Benutzer:CoolTux|Wiki]])
}}

= AMAD 4.2 [AMADNG] =
== 73_AMADCommBridge / 74_AMADDevice ==

= Vorwort =
=== Warum AMADNG ===
Nach fast 6 Monaten Entwicklungszeit wurde die neuste AMAD Version am 24.07.2017 offiziell frei gegeben. Diesmal lagen mir mehrere Dinge am Herzen.
In erster Linie wollte ich eine softwareseitige Trennung der AMADCommBridge vom eigentlichen Android Device. Daher ist die neue Version ein zweistufiges Modul geworden.
Im Laufe der Entwicklung kamen auch andere Anforderungen hinzu, die ich dann fähig war umzusetzen. Eine dieser Anforderungen war eine einfachere und besser funktionierende Installation. Herausgekommen ist ein Android Installationsassistant.
Mit ihm wird auf einfache Art und Weise direkt per Sprachführung und Eingabedialogen Automagic für AMAD konfiguriert und das Device in FHEM automatisch erstellt.

'''Es ist darauf zu achten, das Autocreate aktiv ist, da sonst kein Device mit Hilfe des Assistenten angelegt werden kann!'''

= Vorstellung =
Dieses 2-stufige Modul liefert, '''in Verbindung mit der Android App Automagic''', diverse Informationen von Android Geräten.
Die AndroidAPP Automagic (die nicht von mir stammt und 2.90 Euro kostet) funktioniert wie Tasker, ist aber bei weitem benutzungsfreundlicher.

=== Features / Funktionen ===
Im Auslieferungszustand werden folgende Zustände dargestellt:
* installierte Android Version
* Zustand von Automagic auf dem Gerät
* Spracheingabe
* Bluetooth An/Aus
* Zustand einer definierten App (läuft aktiv im Vordergrund oder nicht?)
* verbundene Bluetoothgeräte, inklusive deren MAC Adresse
* aktuell abgespieltes Musikalbum des verwendeten Mediaplayers
* aktuell abgespielter Musikinterpret des verwendeten Mediaplayers
* aktuell abgespielter Musiktitel des verwendeten Mediaplayers
* Status des Androidgerätes - Online/Offline
* nächster Alarmtag
* nächste Alarmzeit
* Batteriestatus in %
* Ladestatus - Netztei angeschlossen / nicht angeschlossen
* Bildschirmstatus An/Aus
* Bildschirmhelligkeit
* Vollbildmodus An/Aus
* Bildschirmausrichtung Auto/Landscape/Portrait
* Standardlautstärke
* Media Lautstärke
* ...

Mit etwas Einarbeitung können jegliche Informationen, die Automagic bereit stellt, in FHEM angezeigt werden. Hierzu bedarf es lediglich eines eigenen Flows, der seine Daten an die AMADCommBridge sendet. Das Modul gibt auch die Möglichkeit Androidgeräte zu steuern.

= AMADCommBridge - Kommunikationsbrücke für alle AMAD Geräte =
Dieses Modul ist das Ausgangsmodul zur erfolgreichen Integration von Androidgeräten in FHEM. Es stellt ferner eine Verbindungsebene zwischen AMAD unterstützten Geräten und FHEM zur Verfügung. Alle Kommunikation zwischen AMAD Android und FHEM läuft über diese Schnittstelle.
Daher erfolgt die Ersteinrichtung eines AMAD Devices auch genau über diese Modulinstanz.

Damit erfolgreich ein Androidgerät in FHEM eingerichtet werden kann, muss im ersten Schritt ein AMADCommBridge Device angelegt werden.

=== Definition in FHEM ===

<code>define <name> AMADCommBridge</code>

==== Beispiel ====

<code>define AMADBridge AMADCommBridge</code>

Diese Anweisung erstellt ein neues AMADCommBridge Device namens AMADBridge.

Im folgenden muß lediglich das Flowset auf dem Android Gerät installiert werden und der Flow 'First Run Assistent' ausgeführt werden. (einfach den Homebutton drücken)
Der Assistent geleitet dann durch die Einrichtung des AMAD Gerätes und sorgt dafür, dass am Ende des Installationsprozess das Androidgerät als AMAD Device in FHEM angelegt wird.

=== Readings ===
* JSON_ERROR - JSON Fehlermeldung, die von Perl gemeldet wird
* JSON_ERROR_STRING - der String, der die JSON Fehlermeldung verursacht hat
* fhemServerIP - die Ip-Adresse des FHEM Servers; wird vom Modul auf Basis des JSON Strings vom Installationsassistenten gesetzt. Kann aber auch mittels set Befehles vom User gesetzt werden
* receiveFhemCommand - ist das Attribut fhemControlMode auf trigger gestellt, wird das Reading gesetzt sobald ein FHEM Befehl übersendet wird. Hierauf kann dann ein Notify triggern. Wird anstelle von trigger setControl als Wert für fhemControlMode eingestellt, wird das Reading nicht gesetzt sondern der set Befehl sofort ausgeführt.
* receiveVoiceCommand - wird die Sprachsteuerung von AMAD aktiviert (set DEVICE activateVoiceInput) so wird der letzte erkannten Sprachbefehle in dieses Reading geschrieben.
* receiveVoiceDevice - Name des Devices von wo aus der letzte erkannte Sprachbefehl gesendet wurde
* state - Status der Bridge, open, closed

=== Attribute ===
* allowFrom - Regexp der erlaubten IP-Adressen oder Hostnamen. Wenn dieses Attribut gesetzt wurde, werden ausschließlich Verbindungen von diesen Adressen akzeptiert. Achtung: falls allowfrom nicht gesetzt ist, und keine gütige allowed Instanz definiert ist, und die Gegenstelle eine nicht lokale Adresse hat, dann wird die Verbindung abgewiesen. Folgende Adressen werden als local betrachtet: IPV4: 127/8, 10/8, 192.168/16, 172.16/10, 169.254/16, IPV6: ::1, fe80/10
* debugJSON - wenn auf 1 gesetzt, werden JSON Fehlermeldungen in Readings geschrieben. Siehe hierzu JSON_ERROR* unter Readings
* fhemControlMode - steuert die zulässige Art der Steuerung von FHEM Devices. Es können über die Bridge auf 2 Arten FHEM-Devices angesteuert werden: per direktem FHEM-Befehl aus einem Flow heraus oder als Sprachbefehl mittels Sprachsteuerung (set DEVICE activateVoiceInput)
** trigger - ist der Wert trigger gesetzt, werden alle an die Bridge gesendeten FHEM set Befehle in das Reading receiveFhemCommand geschrieben und können so mittels notify ausgeführt werden. Sprachsteuerung ist möglich, es werden Readings receiveVoice* gesetzt. Auf dem Androidgerät können bei Sprachsteuerung mehrere Sprachbefehle mittels "und" verknüpft/aneinander gereiht werden. Bsp: schalte die Lichtszene Abends an und schalte den Fernseher an
** setControl - alle set Befehle, die mittels eines Flows über die Bridge gesendet werden, werden automatisch ausgeführt. Das Triggern eines Readings ist nicht nötig. Die Steuerung mittels Sprache verhält sich wie beim Wert trigger
** thirdPartControl - verhält sich wie trigger, bei der Sprachsteuerung ist jedoch ein Anreihen von Sprachbefehlen mittels "und" nicht möglich. Dient der Sprachsteuerung über Module anderer Modulautoren ((z.B. 39_TEERKO.pm)

= AMADDevice - Automagic Android Device =
Dieses Modul liefert, in Verbindung mit der Android APP Automagic, diverse Informationen von Android Geräten. Die Android App Automagic (die nicht von mir stammt und 2.90 Euro kostet) funktioniert wie Tasker, ist aber bei weitem User freundlicher.
Mit etwas Einarbeitung können jegliche Informationen, die Automagic bereit stellt in FHEM angezeigt werden. Hierzu bedarf es lediglich eines eigenen Flows, der seine Daten an die AMADDeviceCommBridge sendet. Das Modul gibt auch die Möglichkeit Androidgeräte zu steuern.
Für all diese Aktionen und Informationen wird auf dem Androidgerät "Automagic" und ein so genannter Flow benötigt. Die App ist über den Google PlayStore zu beziehen. Das benötigte Flowset bekommt man aus dem FHEM Verzeichnis.

=== Wie genau verwendet man nun AMADDevice? ===
* sicherstellen, dass als allererstes die AMADCommBridge in FHEM definiert wurde
* installieren der App "Automagic Premium" aus dem PlayStore
* installieren des Flowset 74_AMADDeviceautomagicFlowset$VERSION.xml aus dem Ordner $INSTALLFHEM/FHEM/lib/ auf dem Androidgerät
* aktivieren des Installationsassistanten Flow in Automagic. Wenn man nun Automagic in den Hintergrund schickt, z.B. Hometaste drücken, startet der Assistant und legt automatisch ein Device für das Androidgerät an.

=== Ein AMADDevice Gerät von Hand anlegen. ===

Define

<code>define <name> AMADDevice <IP-ADRESSE> <AMAD_ID> <REMOTESERVER></code>

==== Beispiel ====

<code>define WandTabletWohnzimmer AMADDevice 192.168.0.23 123456 Automagic</code>

In diesem Fall wird ein AMADDevice von Hand angelegt. Die AMAD_ID, hier 123456, muß auch exakt so als globale Variable in Automagic eingetragen sein.

=== Readings ===
* airplanemode - Status des Flugmodus
* androidVersion - aktuell installierte Androidversion
* automagicState - Statusmeldungen von der Automagic App '''(Voraussetzung Android >4.3). Ist Android größer 4.3 vorhanden und im Reading steht "wird nicht unterstützt", muss in den Androideinstellungen unter Ton und Benachrichtigungen -> Benachrichtigungszugriff ein Haken für Automagic gesetzt werden'''
* batteryHealth - Zustand der Battery (1=unbekannt, 2=gut, 3=überhitzt, 4=tot, 5=Überspannung, 6=unbekannter Fehler, 7=kalt)
* batterytemperature - Temperatur der Batterie
* bluetooth - on/off, Bluetooth Status an oder aus
* checkActiveTask - Zustand einer zuvor definierten App. 0=nicht aktiv oder nicht aktiv im Vordergrund, 1=aktiv im Vordergrund, '''siehe Hinweis unten'''
* connectedBTdevices - eine Liste der verbundenen Gerät
* connectedBTdevicesMAC - eine Liste der MAC Adressen aller verbundender BT Geräte
* currentMusicAlbum - aktuell abgespieltes Musikalbum des verwendeten Mediaplayers
* currentMusicApp - aktuell verwendeter Mediaplayer (Amazon Music, Google Play Music, Google Play Video, Spotify, YouTube, TuneIn Player, Aldi Life Music)
* currentMusicArtist - aktuell abgespielter Musikinterpret des verwendeten Mediaplayers
* currentMusicIcon - Cover vom aktuell abgespielten Album '''Noch nicht fertig implementiert'''
* currentMusicState - Status des aktuellen/zuletzt verwendeten Mediaplayers
* currentMusicTrack - aktuell abgespielter Musiktitel des verwendeten Mediaplayers
* daydream - on/off, Daydream gestartet oder nicht
* deviceState - Status des Androidgerätes. unknown, online, offline.
* doNotDisturb - aktueller Status des Nicht-Stören-Modus
* dockingState - undocked/docked Status, ob sich das Gerät in einer Dockingstation befindet.
* flow_SetCommands - active/inactive, Status des SetCommands Flow
* flow_informations - active/inactive, Status des Informations Flow
* flowsetVersionAtDevice - aktuell installierte Flowsetversion auf dem Device
* incomingCallerName - Anrufername des eingehenden Anrufes
* incomingCallerNumber - Anrufernummer des eingehenden Anrufes
* incommingWhatsAppMessageFrom - letzte WhatsApp Nachricht
* incommingWhatsTelegramMessageFrom - letzte Telegram Nachricht
* intentRadioName - zuletzt gestreamter Intent Radio Name
* intentRadioState - Status des IntentRadio Players
* keyguardSet - 0/1 Displaysperre gesetzt 0=nein 1=ja, bedeutet nicht, dass sie gerade aktiv ist
* lastSetCommandError - letzte Fehlermeldung vom set Befehl
* lastSetCommandState - letzter Status vom set Befehl, Befehl erfolgreich/nicht erfolgreich gesendet
* lastStatusRequestError - letzte Fehlermeldung vom statusRequest Befehl
* lastStatusRequestState - letzter Status vom statusRequest Befehl, Befehl erfolgreich/nicht erfolgreich gesendet
* nextAlarmDay - aktiver Alarmtag
* nextAlarmState - aktueller Status des "Androidinternen" Weckers
* nextAlarmTime - aktive Alarmzeit
* powerLevel - Status der Batterie in %
* powerPlugged - Netzteil angeschlossen? 1=AC Adapter, 2=USB, 4=Kabellos 0=nicht eingesteckt
* screen - on locked/unlocked, off locked/unlocked gibt an ob der Bildschirm an oder aus ist und gleichzeitig gesperrt oder nicht gesperrt
* screenBrightness - Bildschirmhelligkeit von 0-255
* screenFullscreen - on/off, Vollbildmodus (An,Aus)
* screenOrientation - Landscape,Portrait, Bildschirmausrichtung (Horizontal,Vertikal)
* screenOrientationMode - auto/manual, Modus für die Ausrichtung (Automatisch, Manuell)
* state - aktueller Status
* userFlowState - aktueller Status eines Flows, festgelegt unter dem setUserFlowState Attribut
* volume - Media Lautstärkewert
* volumeNotification - Benachrichtigungs-Lautstärke

Beim Reading checkActivTask muß zuvor der Packagename der zu prüfenden App als Attribut checkActiveTask angegeben werden. Beispiel: attr Nexus10Wohnzimmer checkActiveTask com.android.chrome für den Chrome Browser.

=== Set ===
* activateVoiceInput - aktiviert die Spracheingabe
* bluetooth - on/off, aktiviert/deaktiviert Bluetooth
* clearNotificationBar - All,Automagic, löscht alle Meldungen oder nur die Automagic Meldungen in der Statusleiste
* closeCall - beendet einen laufenden Anruf
* currentFlowsetUpdate - führt ein Flowsetupdate auf dem Device durch
* doNotDisturb - schaltet den Nicht-Stören-Modus: always immer stören, never niemals stören, alarmClockOnly nur Wecker darf stören, onlyImportant nur wichtige Störungen
* installFlowSource - installiert einen Flow auf dem Device, das XML File muss unter /tmp/ liegen und die Endung xml haben. Bsp: set TabletWohnzimmer installFlowSource WlanUebwerwachen.xml
* mediaAmazonMusic - play, stop, next, back ,steuert den Amazon Musik Mediaplayer
* mediaGoogleMusic - play, stop, next, back ,steuert den Google Play Musik Mediaplayer
* mediaSpotifyMusic - play, stop, next, back ,steuert den Spotify Mediaplayer
* mediaTuneinRadio - play, stop, next, back ,steuert den TuneIn Radio Mediaplayer
* mediaAldiMusic - play, stop, next, back ,steuert den Aldi Musik Mediaplayer
* mediaAudible - play, stop, next, back ,steuert den Audible Mediaplayer
* mediaYouTube - play, stop, next, back ,steuert den YouTube Mediaplayer
* mediaVlcPlayer - play, stop, next, back ,steuert den VLC Mediaplayer
* nextAlarmTime - setzt die Alarmzeit. gilt aber nur innerhalb der nächsten 24 h
* openCall - ruft eine Nummer an und legt optional nach X Sekunden auf / set DEVICE openCall 01736458 10 / ruft die Nummer an und beendet den Anruf nach 10s
* screen - on/off/lock/unlock schaltet den Bildschirm ein/aus oder sperrt/entsperrt ihn
* screenBrightness - setzt die Bildschirmhelligkeit, von 0-255.
* screenMsg - versendet eine Bildschirmnachricht
* sendintent - sendet einen Intentstring Bsp: set $AMADDeviceDEVICE sendIntent org.smblott.intentradio.PLAY url http://stream.klassikradio.de/live/mp3-192/stream.klassikradio.de/play.m3u name Klassikradio, der erste Befehl ist die Aktion und der zweite das Extra. Es können immer zwei Extras mitgegeben werden.
* sendSMS - sendet eine SMS an eine bestimmte Telefonnummer. Bsp.: sendSMS Dies ist ein Test|555487263
* startDaydream - startet den Daydream
* statusRequest - Fordert einen neuen Statusreport beim Device an. Es können nicht von allen Readings per statusRequest die Daten geholt werden. Einige wenige geben nur bei Statusänderung ihren Status wieder.
* timer - setzt einen Timer innerhalb der als Standard definierten Clock-App auf dem Device. Es können nur Sekunden angegeben werden.
* ttsMsg - versendet eine Nachricht, die als Sprachnachricht ausgegeben wird
* userFlowState - aktiviert oder deaktiviert einen oder mehrere Flows,'''set Nexus7Wohnzimmer Badezimmer vorheizen:inactive oder set Nexus7Wohnzimmer Badezimmer vorheizen,Nachtlicht Steven:inactive'''
* vibrate - lässt das Androidgerät vibrieren
* volume - setzt die Medialautstärke. Entweder die internen Lautsprecher oder sofern angeschlossen die Bluetoothlautsprecher und per Klinkenstecker angeschlossene Lautsprecher, + oder - vor dem Wert reduziert die aktuelle Lautstärke um den Wert. Der maximale Sliderwert kann über das Attribut setVolMax geregelt werden.
* volumeUp - erhöht die Lautstärke um den angegeben Wert im entsprechenden Attribut. Ist kein Attribut angegeben wird per default 2 genommen.
* volumeDown - reduziert die Lautstärke um den angegeben Wert im entsprechenden Attribut. Ist kein Attribut angegeben wird per default 2 genommen.
* volumeNotification - setzt die Benachrichtigungslautstärke.

==== Set abhängig von gesetzten Attributen ====
* changetoBtDevice - wechselt zu einem anderen Bluetooth Gerät. Attribut setBluetoothDevice muß gesetzt sein. Siehe Hinweis unten!
* notifySndFile - spielt die angegebene Mediadatei auf dem Androidgerät ab. Die aufzurufende Mediadatei sollte sich im Ordner /storage/emulated/0/Notifications/ befinden. Ist dies nicht der Fall kann man über das Attribut setNotifySndFilePath einen Pfad vorgeben.
* openApp - öffnet eine ausgewählte App. Attribut setOpenApp
* openURL - öffnet eine URL im Standardbrowser, sofern kein anderer Browser über das Attribut setOpenUrlBrowser ausgewählt wurde. Bsp: attr Tablet setOpenUrlBrowser de.ozerov.fully|de.ozerov.fully.MainActivity, das erste ist der Package Name und das zweite der Class Name
* setAPSSID - setzt die AccessPoint SSID um ein WLAN sleep zu verhindern
* setScreenOnForTimer ändert die Zeitdauer, die das Display an bleiben soll!
* screenFullscreen - on/off, (aktiviert/deaktiviert) den Vollbildmodus. Attribut setFullscreen
* screenLock - Sperrt den Bildschirm mit Pinabfrage. Attribut setScreenlockPIN - hier die Pin dafür eingeben. Erlaubt sind nur Zahlen. Es müßen mindestens 4, bis max 16 Zeichen verwendet werden.
* screenOrientation - Auto,Landscape,Portait, aktiviert die Bildschirmausrichtung (Automatisch,Horizontal,Vertikal). Attribut setScreenOrientation
* system - setzt Systembefehle ab (nur bei gerootetet Geräten). reboot,shutdown,airplanemodeON (kann nur aktiviert werden) Attribut root, in den Automagic Einstellungen muss "Root Funktion" gesetzt werden
* setNotifySndFilePath - setzt den korrekten Systempfad zur Notifydatei (default ist /storage/emulated/0/Notifications/
* setTtsMsgSpeed - setzt die Sprachgeschwindigkeit bei der Sprachausgabe(Werte zwischen 0.5 bis 4.0 in 0.5er Schritten) default ist 1.0
* setTtsMsgSpeed - setzt die Sprache bei der Sprachausgabe, de oder en (default ist de)
* setVolUpDownStep - setzt den Step für volumeUp und volumeDown
* setVolMax - setzt die maximale Volume Größe für den Slider
* setNotifyVolMax - setzt den maximalen Lautstärkewert für Benachrichtigungslautstärke für den Slider
* setRingSoundVolMax - setzt den maximalen Lautstärkewert für Klingellautstärke für den Slider

'''Um openApp verwenden zu können, muss als Attribut der Package Name der App angegeben werden.

'''Um zwischen Bluetoothgeräten wechseln zu können, muss das Attribut setBluetoothDevice mit folgender Syntax gesetzt werden. attr <DEVICE> BTdeviceName1|MAC,BTDeviceName2|MAC Es muss zwingend darauf geachtet werden, dass beim BTdeviceName kein Leerzeichen vorhanden ist. Am besten zusammen oder mit Unterstrich. Bei der MAC ist darauf zu achten, dass wirklich nach jeder zweiten Zahl ein : steht

** '''Beispiel: attr Nexus10Wohnzimmer setBluetoothDevice Logitech_BT_Adapter|AB:12:CD:34:EF:32,Anker_A3565|GH:56:IJ:78:KL:76

=== state ===
* initialized - Ist der Status kurz nach einem define.
* active - die Geräteinstanz ist im aktiven Status.
* disabled - die Geräteinstanz wurde über das Attribut disable deaktiviert

==Anwendungsbeispiele==
=== Lademanagement ===
Ich habe die Ladegeräte für meine Androidgeräte an Funkschaltsteckdosen. Ein DOIF schaltet bei unter 30% die Steckdose ein und bei über 90% wieder aus.

Hier mal ein einfaches DOIF Beispiel für ein Lademanagment

<code>
... DOIF ([Nexus5Handy:powerLevel] < 30) (set LadenetzteilNexus5Handy:FILTER=STATE=off on) DOELSEIF ([Nexus5Handy:powerLevel] > 90) (set LadenetzteilNexus5Handy:FILTER=STATE=on off) DOELSE
</code>

=== Wecker ===
Morgens lasse ich mich über mein Tablet im Schlafzimmer mit Musik wecken. Verwendet wird hierzu der wakeuptimer des RESIDENTS Modules. Das Abspielen stoppe ich dann von Hand. Danach erfolgt noch eine Ansage wie das Wetter gerade ist und wird.

=== Mediacenter ===
Mein 10" Tablet im Wohnzimmer ist Mediaplayer für das Wohnzimmer mit Bluetoothlautsprechern. Die Lautstärke wird automatisch heruntergesetzt, wenn die Fritzbox einen Anruf auf das Wohnzimmer Handgerät signalisiert.

=== Sprachbefehl - Abfragen von Zuständen diverser Sensoren ===
Wenn ich die Spracheingabe aktiviere und nach der Temperatur im Wohnzimmer frage, bekomme ich diese angesagt.

Der Teil im Feld Daten ist ein klassisches ReadingsVal, halt nur ohne Komma und ohne Anführungszeichen

WIRD GERADE ÜBERARBEITET

=== Schaltbefehle vom Androidgerät an FHEM senden ===
Hierfür ist ein eigener Flow einzurichten. Wie das genau geht, verrät die Hilfe.
Um einen Schaltbefehl für FHEM zu erstellen, folgt nach dem Trigger eine Aktion als Script (Aktion Type: Script). Hier ist folgendes einzutragen:

setcmd = "LichtWohnzimmerLampeRechts on"

fhemcmd = "set"

In der ersten Zeile wird also der Schaltbefehl in der Variablem setcmd eingetragen und in der zweiten Zeile der FHEM Befehl in der Variablen fhemcmd.

Danach müsst Ihr nur noch in einer weiteren Aktion den Flow "Send Data to AMADCommBridge" ausführen (Aktion Type: Flows ausführen). Die Aktion sollte bereits in Eurer Liste Vorhanden sein.

[[Datei:Screenshot_20160717-134948.png|200px]]
[[Datei:Screenshot 17.07.2016 1-50-27.png|200px]]

Nun sollte Lampe1 angeschalten werden, wenn der Flow ausgeführt wird.

=== Mit FHEM ein Flow ausführen ===
In Automagic einen Trigger vom Type General Broadcast für den Flow wählen welchen man fern ausführen möchte. In der Trigger Definition steht unter Aktion ''automagic.NameDesFlows'' und auf Wunsch unter Access Intent Extra's ''param1 = getString("label1"); param2 = getString("label2");''. ''NameDesFlows'' ist natürlich die Name des Flows, der kein Leerzeichen enthält. Mit ein FHEM Command 'set ''AMADDevice'' sendIntent ''automagic.namederflow label1 param1 label2 param2''' wird dann der Flow aus geführt.

=== Lister aller Variablen für die AMADCommandBridge ===
fhemcmd Variable
* Wert "set" - Variable für den Schaltbefehl 'setcmd'
* Wert "setreading" - Variable für die Readingswerte 'fhemdata'
* "readingsval" - Variable für die Abfragewerte 'readingsvalcmd'
* "fhemfunc" - Variable für den Funktionsnamen 'fhemsub'

'''Beispiele für Skriptinhalte:'''

Schalten einer Lampe

<code>
setcmd = "LichtWohnzimmerLampeRechts on";

fhemcmd = "set"
</code>

Status eines Device abfragen

<code>
readingsvalcmd = "DEVICE READING DEFAULT";

fhemcmd = "readingsval"
</code>

Die Rückgabevariable, die dann weiter verarbeitet werden kann, heißt '''respreadingsval'''

Aufruf einer 99_myUtils Subroutine

<code>
fhemsub = "mySub()"; oder natürlich auch "mySub('was_auch_immer')"

fhemcmd = "fhemfunc"
</code>

Die Rückgabevariable, die dann weiter verarbeitet werden kann, heißt '''respfhemfunc'''

== Bekannte Meldungen/Hinweise/Probleme ==

Wenn auf dem Android-Gerät die Fehlermeldung 'Accessibility service not running' von Automagic kommt oder im FHEM das reading state 'Flow Informations mit Fehler beendet' steht, dann muss der Accessibility Service auf dem Android-Device aktiviert werden: Einstellungen --> Bedienungshilfen --> Automagic Premium. Hier muss der Schalter auf 'an' stehen. Sollte dies der Fall sein, hilft u.U. ein kurzes Aus- und wieder Einschalten.

Gerät wird oft als offline angezeigt und es können keine set Befehle abgesetzt werden.
Mit der AMAD Version 2.2 hielt eine neue Behandlung des deviceState Readings Einzug. Das Reading stellt nun den tatsächlichen Status des Gerätes gegenüber FHEM da. Bei vielen Android 6 Geräten kommt es aber auf Grund vom DeepSleep Modus zum Wegfall der WLAN Verbindung. Hier hilft die neue KeepAlive Funktion in AMAD. Dafür muß lediglich unter
* Einstellungen --> Akku --> oben auf die drei Punkte - Akku Leistungsoptimierung --> alle Apps und dann Automagic auswählen und "Nicht optimieren"
ausgewählt werden und in FHEM für das Device das Attribut setAPSSID gesetzt werden. Alles andere macht das Modul selbst.

AMAD

2018-08-16T12:24:55Z

CoolTux: /* AMAD 4.0 [AMADNG] */

{{Infobox Modul
|ModPurpose=Steuern von Androidgeräten und Anzeige von bestimmten Informationen dieser Geräte
|ModType=d
|ModForumArea=Sonstige Systeme
|ModTechName=73_AMADCommBridge.pm, 74_AMADDevice.pm
|ModOwner=CoolTux ([http://forum.fhem.de/index.php?action=profile;u=13684 Forum] / [[Benutzer:CoolTux|Wiki]])
}}

= AMAD 4.2 [AMADNG] =
== 73_AMADCommBridge / 74_AMADDevice ==

= Vorwort =
=== Warum AMADNG ===
Nach fast 6 Monaten Entwicklungszeit wurde die neuste AMAD Version am 24.07.2017 offiziell frei gegeben. Diesmal lagen mir mehrere Dinge am Herzen.
In erster Linie wollte ich eine softwareseitige Trennung der AMADCommBridge vom eigentlichen Android Device. Daher ist die neue Version ein zweistufiges Modul geworden.
Im Laufe der Entwicklung kamen auch andere Anforderungen hinzu, die ich dann fähig war umzusetzen. Eine dieser Anforderungen war eine einfachere und besser funktionierende Installation. Herausgekommen ist ein Android Installationsassistant.
Mit ihm wird auf einfache Art und Weise direkt per Sprachführung und Eingabedialogen Automagic für AMAD konfiguriert und das Device in FHEM automatisch erstellt.

'''Es ist darauf zu achten, das Autocreate aktiv ist, da sonst kein Device mit Hilfe des Assistenten angelegt werden kann!'''

= Vorstellung =
Dieses 2-stufige Modul liefert, '''in Verbindung mit der Android App Automagic''', diverse Informationen von Android Geräten.
Die AndroidAPP Automagic (die nicht von mir stammt und 2.90 Euro kostet) funktioniert wie Tasker, ist aber bei weitem benutzungsfreundlicher.

=== Features / Funktionen ===
Im Auslieferungszustand werden folgende Zustände dargestellt:
* installierte Android Version
* Zustand von Automagic auf dem Gerät
* Spracheingabe
* Bluetooth An/Aus
* Zustand einer definierten App (läuft aktiv im Vordergrund oder nicht?)
* verbundene Bluetoothgeräte, inklusive deren MAC Adresse
* aktuell abgespieltes Musikalbum des verwendeten Mediaplayers
* aktuell abgespielter Musikinterpret des verwendeten Mediaplayers
* aktuell abgespielter Musiktitel des verwendeten Mediaplayers
* Status des Androidgerätes - Online/Offline
* nächster Alarmtag
* nächste Alarmzeit
* Batteriestatus in %
* Ladestatus - Netztei angeschlossen / nicht angeschlossen
* Bildschirmstatus An/Aus
* Bildschirmhelligkeit
* Vollbildmodus An/Aus
* Bildschirmausrichtung Auto/Landscape/Portrait
* Standardlautstärke
* Media Lautstärke
* ...

Mit etwas Einarbeitung können jegliche Informationen, die Automagic bereit stellt, in FHEM angezeigt werden. Hierzu bedarf es lediglich eines eigenen Flows, der seine Daten an die AMADCommBridge sendet. Das Modul gibt auch die Möglichkeit Androidgeräte zu steuern.

= AMADCommBridge - Kommunikationsbrücke für alle AMAD Geräte =
Dieses Modul ist das Ausgangsmodul zur erfolgreichen Integration von Androidgeräten in FHEM. Es stellt ferner eine Verbindungsebene zwischen AMAD unterstützten Geräten und FHEM zur Verfügung. Alle Kommunikation zwischen AMAD Android und FHEM läuft über diese Schnittstelle.
Daher erfolgt die Ersteinrichtung eines AMAD Devices auch genau über diese Modulinstanz.

Damit erfolgreich ein Androidgerät in FHEM eingerichtet werden kann, muss im ersten Schritt ein AMADCommBridge Device angelegt werden.

=== Definition in FHEM ===

<code>define <name> AMADCommBridge</code>

==== Beispiel ====

<code>define AMADBridge AMADCommBridge</code>

Diese Anweisung erstellt ein neues AMADCommBridge Device namens AMADBridge.

Im folgenden muß lediglich das Flowset auf dem Android Gerät installiert werden und der Flow 'First Run Assistent' ausgeführt werden. (einfach den Homebutton drücken)
Der Assistent geleitet dann durch die Einrichtung des AMAD Gerätes und sorgt dafür, dass am Ende des Installationsprozess das Androidgerät als AMAD Device in FHEM angelegt wird.

=== Readings ===
* JSON_ERROR - JSON Fehlermeldung, die von Perl gemeldet wird
* JSON_ERROR_STRING - der String, der die JSON Fehlermeldung verursacht hat
* fhemServerIP - die Ip-Adresse des FHEM Servers; wird vom Modul auf Basis des JSON Strings vom Installationsassistenten gesetzt. Kann aber auch mittels set Befehles vom User gesetzt werden
* receiveFhemCommand - ist das Attribut fhemControlMode auf trigger gestellt, wird das Reading gesetzt sobald ein FHEM Befehl übersendet wird. Hierauf kann dann ein Notify triggern. Wird anstelle von trigger setControl als Wert für fhemControlMode eingestellt, wird das Reading nicht gesetzt sondern der set Befehl sofort ausgeführt.
* receiveVoiceCommand - wird die Sprachsteuerung von AMAD aktiviert (set DEVICE activateVoiceInput) so wird der letzte erkannten Sprachbefehle in dieses Reading geschrieben.
* receiveVoiceDevice - Name des Devices von wo aus der letzte erkannte Sprachbefehl gesendet wurde
* state - Status der Bridge, open, closed

=== Attribute ===
* allowFrom - Regexp der erlaubten IP-Adressen oder Hostnamen. Wenn dieses Attribut gesetzt wurde, werden ausschließlich Verbindungen von diesen Adressen akzeptiert. Achtung: falls allowfrom nicht gesetzt ist, und keine gütige allowed Instanz definiert ist, und die Gegenstelle eine nicht lokale Adresse hat, dann wird die Verbindung abgewiesen. Folgende Adressen werden als local betrachtet: IPV4: 127/8, 10/8, 192.168/16, 172.16/10, 169.254/16, IPV6: ::1, fe80/10
* debugJSON - wenn auf 1 gesetzt, werden JSON Fehlermeldungen in Readings geschrieben. Siehe hierzu JSON_ERROR* unter Readings
* fhemControlMode - steuert die zulässige Art der Steuerung von FHEM Devices. Es können über die Bridge auf 2 Arten FHEM-Devices angesteuert werden: per direktem FHEM-Befehl aus einem Flow heraus oder als Sprachbefehl mittels Sprachsteuerung (set DEVICE activateVoiceInput)
** trigger - ist der Wert trigger gesetzt, werden alle an die Bridge gesendeten FHEM set Befehle in das Reading receiveFhemCommand geschrieben und können so mittels notify ausgeführt werden. Sprachsteuerung ist möglich, es werden Readings receiveVoice* gesetzt. Auf dem Androidgerät können bei Sprachsteuerung mehrere Sprachbefehle mittels "und" verknüpft/aneinander gereiht werden. Bsp: schalte die Lichtszene Abends an und schalte den Fernseher an
** setControl - alle set Befehle, die mittels eines Flows über die Bridge gesendet werden, werden automatisch ausgeführt. Das Triggern eines Readings ist nicht nötig. Die Steuerung mittels Sprache verhält sich wie beim Wert trigger
** thirdPartControl - verhält sich wie trigger, bei der Sprachsteuerung ist jedoch ein Anreihen von Sprachbefehlen mittels "und" nicht möglich. Dient der Sprachsteuerung über Module anderer Modulautoren ((z.B. 39_TEERKO.pm)

= AMADDevice - Automagic Android Device =
Dieses Modul liefert, in Verbindung mit der Android APP Automagic, diverse Informationen von Android Geräten. Die Android App Automagic (die nicht von mir stammt und 2.90 Euro kostet) funktioniert wie Tasker, ist aber bei weitem User freundlicher.
Mit etwas Einarbeitung können jegliche Informationen, die Automagic bereit stellt in FHEM angezeigt werden. Hierzu bedarf es lediglich eines eigenen Flows, der seine Daten an die AMADDeviceCommBridge sendet. Das Modul gibt auch die Möglichkeit Androidgeräte zu steuern.
Für all diese Aktionen und Informationen wird auf dem Androidgerät "Automagic" und ein so genannter Flow benötigt. Die App ist über den Google PlayStore zu beziehen. Das benötigte Flowset bekommt man aus dem FHEM Verzeichnis.

=== Wie genau verwendet man nun AMADDevice? ===
* sicherstellen, dass als allererstes die AMADCommBridge in FHEM definiert wurde
* installieren der App "Automagic Premium" aus dem PlayStore
* installieren des Flowset 74_AMADDeviceautomagicFlowset$VERSION.xml aus dem Ordner $INSTALLFHEM/FHEM/lib/ auf dem Androidgerät
* aktivieren des Installationsassistanten Flow in Automagic. Wenn man nun Automagic in den Hintergrund schickt, z.B. Hometaste drücken, startet der Assistant und legt automatisch ein Device für das Androidgerät an.

=== Ein AMADDevice Gerät von Hand anlegen. ===

Define

<code>define <name> AMADDevice <IP-ADRESSE> <AMAD_ID> <REMOTESERVER></code>

==== Beispiel ====

<code>define WandTabletWohnzimmer AMADDevice 192.168.0.23 123456 Automagic</code>

In diesem Fall wird ein AMADDevice von Hand angelegt. Die AMAD_ID, hier 123456, muß auch exakt so als globale Variable in Automagic eingetragen sein.

=== Readings ===
* airplanemode - Status des Flugmodus
* androidVersion - aktuell installierte Androidversion
* automagicState - Statusmeldungen von der Automagic App '''(Voraussetzung Android >4.3). Ist Android größer 4.3 vorhanden und im Reading steht "wird nicht unterstützt", muss in den Androideinstellungen unter Ton und Benachrichtigungen -> Benachrichtigungszugriff ein Haken für Automagic gesetzt werden'''
* batteryHealth - Zustand der Battery (1=unbekannt, 2=gut, 3=überhitzt, 4=tot, 5=Überspannung, 6=unbekannter Fehler, 7=kalt)
* batterytemperature - Temperatur der Batterie
* bluetooth - on/off, Bluetooth Status an oder aus
* checkActiveTask - Zustand einer zuvor definierten App. 0=nicht aktiv oder nicht aktiv im Vordergrund, 1=aktiv im Vordergrund, '''siehe Hinweis unten'''
* connectedBTdevices - eine Liste der verbundenen Gerät
* connectedBTdevicesMAC - eine Liste der MAC Adressen aller verbundender BT Geräte
* currentMusicAlbum - aktuell abgespieltes Musikalbum des verwendeten Mediaplayers
* currentMusicApp - aktuell verwendeter Mediaplayer (Amazon Music, Google Play Music, Google Play Video, Spotify, YouTube, TuneIn Player, Aldi Life Music)
* currentMusicArtist - aktuell abgespielter Musikinterpret des verwendeten Mediaplayers
* currentMusicIcon - Cover vom aktuell abgespielten Album '''Noch nicht fertig implementiert'''
* currentMusicState - Status des aktuellen/zuletzt verwendeten Mediaplayers
* currentMusicTrack - aktuell abgespielter Musiktitel des verwendeten Mediaplayers
* daydream - on/off, Daydream gestartet oder nicht
* deviceState - Status des Androidgerätes. unknown, online, offline.
* doNotDisturb - aktueller Status des Nicht-Stören-Modus
* dockingState - undocked/docked Status, ob sich das Gerät in einer Dockingstation befindet.
* flow_SetCommands - active/inactive, Status des SetCommands Flow
* flow_informations - active/inactive, Status des Informations Flow
* flowsetVersionAtDevice - aktuell installierte Flowsetversion auf dem Device
* incomingCallerName - Anrufername des eingehenden Anrufes
* incomingCallerNumber - Anrufernummer des eingehenden Anrufes
* incommingWhatsAppMessageFrom - letzte WhatsApp Nachricht
* incommingWhatsTelegramMessageFrom - letzte Telegram Nachricht
* intentRadioName - zuletzt gestreamter Intent Radio Name
* intentRadioState - Status des IntentRadio Players
* keyguardSet - 0/1 Displaysperre gesetzt 0=nein 1=ja, bedeutet nicht, dass sie gerade aktiv ist
* lastSetCommandError - letzte Fehlermeldung vom set Befehl
* lastSetCommandState - letzter Status vom set Befehl, Befehl erfolgreich/nicht erfolgreich gesendet
* lastStatusRequestError - letzte Fehlermeldung vom statusRequest Befehl
* lastStatusRequestState - letzter Status vom statusRequest Befehl, Befehl erfolgreich/nicht erfolgreich gesendet
* nextAlarmDay - aktiver Alarmtag
* nextAlarmState - aktueller Status des "Androidinternen" Weckers
* nextAlarmTime - aktive Alarmzeit
* powerLevel - Status der Batterie in %
* powerPlugged - Netzteil angeschlossen? 1=AC Adapter, 2=USB, 4=Kabellos 0=nicht eingesteckt
* screen - on locked/unlocked, off locked/unlocked gibt an ob der Bildschirm an oder aus ist und gleichzeitig gesperrt oder nicht gesperrt
* screenBrightness - Bildschirmhelligkeit von 0-255
* screenFullscreen - on/off, Vollbildmodus (An,Aus)
* screenOrientation - Landscape,Portrait, Bildschirmausrichtung (Horizontal,Vertikal)
* screenOrientationMode - auto/manual, Modus für die Ausrichtung (Automatisch, Manuell)
* state - aktueller Status
* userFlowState - aktueller Status eines Flows, festgelegt unter dem setUserFlowState Attribut
* volume - Media Lautstärkewert
* volumeNotification - Benachrichtigungs-Lautstärke

Beim Reading checkActivTask muß zuvor der Packagename der zu prüfenden App als Attribut checkActiveTask angegeben werden. Beispiel: attr Nexus10Wohnzimmer checkActiveTask com.android.chrome für den Chrome Browser.

=== Set ===
* activateVoiceInput - aktiviert die Spracheingabe
* bluetooth - on/off, aktiviert/deaktiviert Bluetooth
* clearNotificationBar - All,Automagic, löscht alle Meldungen oder nur die Automagic Meldungen in der Statusleiste
* closeCall - beendet einen laufenden Anruf
* currentFlowsetUpdate - führt ein Flowsetupdate auf dem Device durch
* doNotDisturb - schaltet den Nicht-Stören-Modus: always immer stören, never niemals stören, alarmClockOnly nur Wecker darf stören, onlyImportant nur wichtige Störungen
* installFlowSource - installiert einen Flow auf dem Device, das XML File muss unter /tmp/ liegen und die Endung xml haben. Bsp: set TabletWohnzimmer installFlowSource WlanUebwerwachen.xml
* mediaAmazonMusic - play, stop, next, back ,steuert den Amazon Musik Mediaplayer
* mediaGoogleMusic - play, stop, next, back ,steuert den Google Play Musik Mediaplayer
* mediaSpotifyMusic - play, stop, next, back ,steuert den Spotify Mediaplayer
* mediaTuneinRadio - play, stop, next, back ,steuert den TuneIn Radio Mediaplayer
* mediaAldiMusic - play, stop, next, back ,steuert den Aldi Musik Mediaplayer
* mediaAudible - play, stop, next, back ,steuert den Audible Mediaplayer
* mediaYouTube - play, stop, next, back ,steuert den YouTube Mediaplayer
* mediaVlcPlayer - play, stop, next, back ,steuert den VLC Mediaplayer
* nextAlarmTime - setzt die Alarmzeit. gilt aber nur innerhalb der nächsten 24 h
* openCall - ruft eine Nummer an und legt optional nach X Sekunden auf / set DEVICE openCall 01736458 10 / ruft die Nummer an und beendet den Anruf nach 10s
* screen - on/off/lock/unlock schaltet den Bildschirm ein/aus oder sperrt/entsperrt ihn
* screenBrightness - setzt die Bildschirmhelligkeit, von 0-255.
* screenMsg - versendet eine Bildschirmnachricht
* sendintent - sendet einen Intentstring Bsp: set $AMADDeviceDEVICE sendIntent org.smblott.intentradio.PLAY url http://stream.klassikradio.de/live/mp3-192/stream.klassikradio.de/play.m3u name Klassikradio, der erste Befehl ist die Aktion und der zweite das Extra. Es können immer zwei Extras mitgegeben werden.
* sendSMS - sendet eine SMS an eine bestimmte Telefonnummer. Bsp.: sendSMS Dies ist ein Test|555487263
* startDaydream - startet den Daydream
* statusRequest - Fordert einen neuen Statusreport beim Device an. Es können nicht von allen Readings per statusRequest die Daten geholt werden. Einige wenige geben nur bei Statusänderung ihren Status wieder.
* timer - setzt einen Timer innerhalb der als Standard definierten Clock-App auf dem Device. Es können nur Sekunden angegeben werden.
* ttsMsg - versendet eine Nachricht, die als Sprachnachricht ausgegeben wird
* userFlowState - aktiviert oder deaktiviert einen oder mehrere Flows,'''set Nexus7Wohnzimmer Badezimmer vorheizen:inactive oder set Nexus7Wohnzimmer Badezimmer vorheizen,Nachtlicht Steven:inactive'''
* vibrate - lässt das Androidgerät vibrieren
* volume - setzt die Medialautstärke. Entweder die internen Lautsprecher oder sofern angeschlossen die Bluetoothlautsprecher und per Klinkenstecker angeschlossene Lautsprecher, + oder - vor dem Wert reduziert die aktuelle Lautstärke um den Wert. Der maximale Sliderwert kann über das Attribut setVolMax geregelt werden.
* volumeUp - erhöht die Lautstärke um den angegeben Wert im entsprechenden Attribut. Ist kein Attribut angegeben wird per default 2 genommen.
* volumeDown - reduziert die Lautstärke um den angegeben Wert im entsprechenden Attribut. Ist kein Attribut angegeben wird per default 2 genommen.
* volumeNotification - setzt die Benachrichtigungslautstärke.

==== Set abhängig von gesetzten Attributen ====
* changetoBtDevice - wechselt zu einem anderen Bluetooth Gerät. Attribut setBluetoothDevice muß gesetzt sein. Siehe Hinweis unten!
* notifySndFile - spielt die angegebene Mediadatei auf dem Androidgerät ab. Die aufzurufende Mediadatei sollte sich im Ordner /storage/emulated/0/Notifications/ befinden. Ist dies nicht der Fall kann man über das Attribut setNotifySndFilePath einen Pfad vorgeben.
* openApp - öffnet eine ausgewählte App. Attribut setOpenApp
* openURL - öffnet eine URL im Standardbrowser, sofern kein anderer Browser über das Attribut setOpenUrlBrowser ausgewählt wurde. Bsp: attr Tablet setOpenUrlBrowser de.ozerov.fully|de.ozerov.fully.MainActivity, das erste ist der Package Name und das zweite der Class Name
* setAPSSID - setzt die AccessPoint SSID um ein WLAN sleep zu verhindern
* setScreenOnForTimer ändert die Zeitdauer, die das Display an bleiben soll!
* screenFullscreen - on/off, (aktiviert/deaktiviert) den Vollbildmodus. Attribut setFullscreen
* screenLock - Sperrt den Bildschirm mit Pinabfrage. Attribut setScreenlockPIN - hier die Pin dafür eingeben. Erlaubt sind nur Zahlen. Es müßen mindestens 4, bis max 16 Zeichen verwendet werden.
* screenOrientation - Auto,Landscape,Portait, aktiviert die Bildschirmausrichtung (Automatisch,Horizontal,Vertikal). Attribut setScreenOrientation
* system - setzt Systembefehle ab (nur bei gerootetet Geräten). reboot,shutdown,airplanemodeON (kann nur aktiviert werden) Attribut root, in den Automagic Einstellungen muss "Root Funktion" gesetzt werden
* setNotifySndFilePath - setzt den korrekten Systempfad zur Notifydatei (default ist /storage/emulated/0/Notifications/
* setTtsMsgSpeed - setzt die Sprachgeschwindigkeit bei der Sprachausgabe(Werte zwischen 0.5 bis 4.0 in 0.5er Schritten) default ist 1.0
* setTtsMsgSpeed - setzt die Sprache bei der Sprachausgabe, de oder en (default ist de)
* setVolUpDownStep - setzt den Step für volumeUp und volumeDown
* setVolMax - setzt die maximale Volume Größe für den Slider
* setNotifyVolMax - setzt den maximalen Lautstärkewert für Benachrichtigungslautstärke für den Slider
* setRingSoundVolMax - setzt den maximalen Lautstärkewert für Klingellautstärke für den Slider

'''Um openApp verwenden zu können, muss als Attribut der Package Name der App angegeben werden.

'''Um zwischen Bluetoothgeräten wechseln zu können, muss das Attribut setBluetoothDevice mit folgender Syntax gesetzt werden. attr <DEVICE> BTdeviceName1|MAC,BTDeviceName2|MAC Es muss zwingend darauf geachtet werden, dass beim BTdeviceName kein Leerzeichen vorhanden ist. Am besten zusammen oder mit Unterstrich. Bei der MAC ist darauf zu achten, dass wirklich nach jeder zweiten Zahl ein : steht

** '''Beispiel: attr Nexus10Wohnzimmer setBluetoothDevice Logitech_BT_Adapter|AB:12:CD:34:EF:32,Anker_A3565|GH:56:IJ:78:KL:76

=== state ===
* initialized - Ist der Status kurz nach einem define.
* active - die Geräteinstanz ist im aktiven Status.
* disabled - die Geräteinstanz wurde über das Attribut disable deaktiviert

==Anwendungsbeispiele==
=== Lademanagement ===
Ich habe die Ladegeräte für meine Androidgeräte an Funkschaltsteckdosen. Ein DOIF schaltet bei unter 30% die Steckdose ein und bei über 90% wieder aus.

Hier mal ein einfaches DOIF Beispiel für ein Lademanagment

<code>
... DOIF ([Nexus5Handy:powerLevel] < 30) (set LadenetzteilNexus5Handy:FILTER=STATE=off on) DOELSEIF ([Nexus5Handy:powerLevel] > 90) (set LadenetzteilNexus5Handy:FILTER=STATE=on off) DOELSE
</code>

=== Wecker ===
Morgens lasse ich mich über mein Tablet im Schlafzimmer mit Musik wecken. Verwendet wird hierzu der wakeuptimer des RESIDENTS Modules. Das Abspielen stoppe ich dann von Hand. Danach erfolgt noch eine Ansage wie das Wetter gerade ist und wird.

=== Mediacenter ===
Mein 10" Tablet im Wohnzimmer ist Mediaplayer für das Wohnzimmer mit Bluetoothlautsprechern. Die Lautstärke wird automatisch heruntergesetzt, wenn die Fritzbox einen Anruf auf das Wohnzimmer Handgerät signalisiert.

=== Sprachbefehl - Abfragen von Zuständen diverser Sensoren ===
Wenn ich die Spracheingabe aktiviere und nach der Temperatur im Wohnzimmer frage, bekomme ich diese angesagt.

Der Teil im Feld Daten ist ein klassisches ReadingsVal, halt nur ohne Komma und ohne Anführungszeichen

WIRD GERADE ÜBERARBEITET

=== Schaltbefehle vom Androidgerät an FHEM senden ===
Hierfür ist ein eigener Flow einzurichten. Wie das genau geht, verrät die Hilfe.
Um einen Schaltbefehl für FHEM zu erstellen, folgt nach dem Trigger eine Aktion als Script (Aktion Type: Script). Hier ist folgendes einzutragen:

setcmd = "LichtWohnzimmerLampeRechts on"

fhemcmd = "set"

In der ersten Zeile wird also der Schaltbefehl in der Variablem setcmd eingetragen und in der zweiten Zeile der FHEM Befehl in der Variablen fhemcmd.

Danach müsst Ihr nur noch in einer weiteren Aktion den Flow "Send Data to AMADCommBridge" ausführen (Aktion Type: Flows ausführen). Die Aktion sollte bereits in Eurer Liste Vorhanden sein.

[[Datei:Screenshot_20160717-134948.png|200px]]
[[Datei:Screenshot 17.07.2016 1-50-27.png|200px]]

Nun sollte Lampe1 angeschalten werden, wenn der Flow ausgeführt wird.

=== Mit FHEM ein Flow ausführen ===
In Automagic einen Triggervom Type General Broadcast für den Flow wählen welchen man fern ausführen möchte. In der Trigger Definition steht unter Aktion ''automagic.NameDesFlows'' und auf Wunsch unter Access Intent Extra's ''param1 = getString("label1"); param2 = getString("label2");''. ''NameDesFlows'' ist natürlich die Name des Flows, der kein Leerzeichen enthält. Mit ein FHEM Command 'set ''AMADDevice'' sendIntent ''automagic.namederflow label1 param1 label2 param2''' wird dann der Flow aus geführt.

=== Lister aller Variablen für die AMADCommandBridge ===
fhemcmd Variable
* Wert "set" - Variable für den Schaltbefehl 'setcmd'
* Wert "setreading" - Variable für die Readingswerte 'fhemdata'
* "readingsval" - Variable für die Abfragewerte 'readingsvalcmd'
* "fhemfunc" - Variable für den Funktionsnamen 'fhemsub'

'''Beispiele für Skriptinhalte:'''

Schalten einer Lampe

<code>
setcmd = "LichtWohnzimmerLampeRechts on";

fhemcmd = "set"
</code>

Status eines Device abfragen

<code>
readingsvalcmd = "DEVICE READING DEFAULT";

fhemcmd = "readingsval"
</code>

Die Rückgabevariable, die dann weiter verarbeitet werden kann, heißt '''respreadingsval'''

Aufruf einer 99_myUtils Subroutine

<code>
fhemsub = "mySub()"; oder natürlich auch "mySub('was_auch_immer')"

fhemcmd = "fhemfunc"
</code>

Die Rückgabevariable, die dann weiter verarbeitet werden kann, heißt '''respfhemfunc'''

== Bekannte Meldungen/Hinweise/Probleme ==

Wenn auf dem Android-Gerät die Fehlermeldung 'Accessibility service not running' von Automagic kommt oder im FHEM das reading state 'Flow Informations mit Fehler beendet' steht, dann muss der Accessibility Service auf dem Android-Device aktiviert werden: Einstellungen --> Bedienungshilfen --> Automagic Premium. Hier muss der Schalter auf 'an' stehen. Sollte dies der Fall sein, hilft u.U. ein kurzes Aus- und wieder Einschalten.

Gerät wird oft als offline angezeigt und es können keine set Befehle abgesetzt werden.
Mit der AMAD Version 2.2 hielt eine neue Behandlung des deviceState Readings Einzug. Das Reading stellt nun den tatsächlichen Status des Gerätes gegenüber FHEM da. Bei vielen Android 6 Geräten kommt es aber auf Grund vom DeepSleep Modus zum Wegfall der WLAN Verbindung. Hier hilft die neue KeepAlive Funktion in AMAD. Dafür muß lediglich unter
* Einstellungen --> Akku --> oben auf die drei Punkte - Akku Leistungsoptimierung --> alle Apps und dann Automagic auswählen und "Nicht optimieren"
ausgewählt werden und in FHEM für das Device das Attribut setAPSSID gesetzt werden. Alles andere macht das Modul selbst.

AMAD

2018-08-10T14:42:20Z

CoolTux: /* Warum AMADNG */

{{Infobox Modul
|ModPurpose=Steuern von Androidgeräten und Anzeige von bestimmten Informationen dieser Geräte
|ModType=d
|ModForumArea=Sonstige Systeme
|ModTechName=73_AMADCommBridge.pm, 74_AMADDevice.pm
|ModOwner=CoolTux ([http://forum.fhem.de/index.php?action=profile;u=13684 Forum] / [[Benutzer:CoolTux|Wiki]])
}}

= AMAD 4.0 [AMADNG] =
== 73_AMADCommBridge / 74_AMADDevice ==

= Vorwort =
=== Warum AMADNG ===
Nach fast 6 Monaten Entwicklungszeit wurde die neuste AMAD Version am 24.07.2017 offiziell frei gegeben. Diesmal lagen mir mehrere Dinge am Herzen.
In erster Linie wollte ich eine softwareseitige Trennung der AMADCommBridge vom eigentlichen Android Device. Daher ist die neue Version ein zweistufiges Modul geworden.
Im Laufe der Entwicklung kamen auch andere Anforderungen hinzu, die ich dann fähig war umzusetzen. Eine dieser Anforderungen war eine einfachere und besser funktionierende Installation. Herausgekommen ist ein Android Installationsassistant.
Mit ihm wird auf einfache Art und Weise direkt per Sprachführung und Eingabedialogen Automagic für AMAD konfiguriert und das Device in FHEM automatisch erstellt.

'''Es ist darauf zu achten, das Autocreate aktiv ist, da sonst kein Device mit Hilfe des Assistenten angelegt werden kann!'''

= Vorstellung =
Dieses 2-stufige Modul liefert, '''in Verbindung mit der Android App Automagic''', diverse Informationen von Android Geräten.
Die AndroidAPP Automagic (die nicht von mir stammt und 2.90 Euro kostet) funktioniert wie Tasker, ist aber bei weitem benutzungsfreundlicher.

=== Features / Funktionen ===
Im Auslieferungszustand werden folgende Zustände dargestellt:
* installierte Android Version
* Zustand von Automagic auf dem Gerät
* Spracheingabe
* Bluetooth An/Aus
* Zustand einer definierten App (läuft aktiv im Vordergrund oder nicht?)
* verbundene Bluetoothgeräte, inklusive deren MAC Adresse
* aktuell abgespieltes Musikalbum des verwendeten Mediaplayers
* aktuell abgespielter Musikinterpret des verwendeten Mediaplayers
* aktuell abgespielter Musiktitel des verwendeten Mediaplayers
* Status des Androidgerätes - Online/Offline
* nächster Alarmtag
* nächste Alarmzeit
* Batteriestatus in %
* Ladestatus - Netztei angeschlossen / nicht angeschlossen
* Bildschirmstatus An/Aus
* Bildschirmhelligkeit
* Vollbildmodus An/Aus
* Bildschirmausrichtung Auto/Landscape/Portrait
* Standardlautstärke
* Media Lautstärke
* ...

Mit etwas Einarbeitung können jegliche Informationen, die Automagic bereit stellt, in FHEM angezeigt werden. Hierzu bedarf es lediglich eines eigenen Flows, der seine Daten an die AMADCommBridge sendet. Das Modul gibt auch die Möglichkeit Androidgeräte zu steuern.

= AMADCommBridge - Kommunikationsbrücke für alle AMAD Geräte =
Dieses Modul ist das Ausgangsmodul zur erfolgreichen Integration von Androidgeräten in FHEM. Es stellt ferner eine Verbindungsebene zwischen AMAD unterstützten Geräten und FHEM zur Verfügung. Alle Kommunikation zwischen AMAD Android und FHEM läuft über diese Schnittstelle.
Daher erfolgt die Ersteinrichtung eines AMAD Devices auch genau über diese Modulinstanz.

Damit erfolgreich ein Androidgerät in FHEM eingerichtet werden kann, muss im ersten Schritt ein AMADCommBridge Device angelegt werden.

=== Definition in FHEM ===

<code>define <name> AMADCommBridge</code>

==== Beispiel ====

<code>define AMADBridge AMADCommBridge</code>

Diese Anweisung erstellt ein neues AMADCommBridge Device namens AMADBridge.

Im folgenden muß lediglich das Flowset auf dem Android Gerät installiert werden und der Flow 'First Run Assistent' ausgeführt werden. (einfach den Homebutton drücken)
Der Assistent geleitet dann durch die Einrichtung des AMAD Gerätes und sorgt dafür, dass am Ende des Installationsprozess das Androidgerät als AMAD Device in FHEM angelegt wird.

=== Readings ===
* JSON_ERROR - JSON Fehlermeldung, die von Perl gemeldet wird
* JSON_ERROR_STRING - der String, der die JSON Fehlermeldung verursacht hat
* fhemServerIP - die Ip-Adresse des FHEM Servers; wird vom Modul auf Basis des JSON Strings vom Installationsassistenten gesetzt. Kann aber auch mittels set Befehles vom User gesetzt werden
* receiveFhemCommand - ist das Attribut fhemControlMode auf trigger gestellt, wird das Reading gesetzt sobald ein FHEM Befehl übersendet wird. Hierauf kann dann ein Notify triggern. Wird anstelle von trigger setControl als Wert für fhemControlMode eingestellt, wird das Reading nicht gesetzt sondern der set Befehl sofort ausgeführt.
* receiveVoiceCommand - wird die Sprachsteuerung von AMAD aktiviert (set DEVICE activateVoiceInput) so wird der letzte erkannten Sprachbefehle in dieses Reading geschrieben.
* receiveVoiceDevice - Name des Devices von wo aus der letzte erkannte Sprachbefehl gesendet wurde
* state - Status der Bridge, open, closed

=== Attribute ===
* allowFrom - Regexp der erlaubten IP-Adressen oder Hostnamen. Wenn dieses Attribut gesetzt wurde, werden ausschließlich Verbindungen von diesen Adressen akzeptiert. Achtung: falls allowfrom nicht gesetzt ist, und keine gütige allowed Instanz definiert ist, und die Gegenstelle eine nicht lokale Adresse hat, dann wird die Verbindung abgewiesen. Folgende Adressen werden als local betrachtet: IPV4: 127/8, 10/8, 192.168/16, 172.16/10, 169.254/16, IPV6: ::1, fe80/10
* debugJSON - wenn auf 1 gesetzt, werden JSON Fehlermeldungen in Readings geschrieben. Siehe hierzu JSON_ERROR* unter Readings
* fhemControlMode - steuert die zulässige Art der Steuerung von FHEM Devices. Es können über die Bridge auf 2 Arten FHEM-Devices angesteuert werden: per direktem FHEM-Befehl aus einem Flow heraus oder als Sprachbefehl mittels Sprachsteuerung (set DEVICE activateVoiceInput)
** trigger - ist der Wert trigger gesetzt, werden alle an die Bridge gesendeten FHEM set Befehle in das Reading receiveFhemCommand geschrieben und können so mittels notify ausgeführt werden. Sprachsteuerung ist möglich, es werden Readings receiveVoice* gesetzt. Auf dem Androidgerät können bei Sprachsteuerung mehrere Sprachbefehle mittels "und" verknüpft/aneinander gereiht werden. Bsp: schalte die Lichtszene Abends an und schalte den Fernseher an
** setControl - alle set Befehle, die mittels eines Flows über die Bridge gesendet werden, werden automatisch ausgeführt. Das Triggern eines Readings ist nicht nötig. Die Steuerung mittels Sprache verhält sich wie beim Wert trigger
** thirdPartControl - verhält sich wie trigger, bei der Sprachsteuerung ist jedoch ein Anreihen von Sprachbefehlen mittels "und" nicht möglich. Dient der Sprachsteuerung über Module anderer Modulautoren ((z.B. 39_TEERKO.pm)

= AMADDevice - Automagic Android Device =
Dieses Modul liefert, in Verbindung mit der Android APP Automagic, diverse Informationen von Android Geräten. Die Android App Automagic (die nicht von mir stammt und 2.90 Euro kostet) funktioniert wie Tasker, ist aber bei weitem User freundlicher.
Mit etwas Einarbeitung können jegliche Informationen, die Automagic bereit stellt in FHEM angezeigt werden. Hierzu bedarf es lediglich eines eigenen Flows, der seine Daten an die AMADDeviceCommBridge sendet. Das Modul gibt auch die Möglichkeit Androidgeräte zu steuern.
Für all diese Aktionen und Informationen wird auf dem Androidgerät "Automagic" und ein so genannter Flow benötigt. Die App ist über den Google PlayStore zu beziehen. Das benötigte Flowset bekommt man aus dem FHEM Verzeichnis.

=== Wie genau verwendet man nun AMADDevice? ===
* sicherstellen, dass als allererstes die AMADCommBridge in FHEM definiert wurde
* installieren der App "Automagic Premium" aus dem PlayStore
* installieren des Flowset 74_AMADDeviceautomagicFlowset$VERSION.xml aus dem Ordner $INSTALLFHEM/FHEM/lib/ auf dem Androidgerät
* aktivieren des Installationsassistanten Flow in Automagic. Wenn man nun Automagic in den Hintergrund schickt, z.B. Hometaste drücken, startet der Assistant und legt automatisch ein Device für das Androidgerät an.

=== Ein AMADDevice Gerät von Hand anlegen. ===

Define

<code>define <name> AMADDevice <IP-ADRESSE> <AMAD_ID> <REMOTESERVER></code>

==== Beispiel ====

<code>define WandTabletWohnzimmer AMADDevice 192.168.0.23 123456 Automagic</code>

In diesem Fall wird ein AMADDevice von Hand angelegt. Die AMAD_ID, hier 123456, muß auch exakt so als globale Variable in Automagic eingetragen sein.

=== Readings ===
* airplanemode - Status des Flugmodus
* androidVersion - aktuell installierte Androidversion
* automagicState - Statusmeldungen von der Automagic App '''(Voraussetzung Android >4.3). Ist Android größer 4.3 vorhanden und im Reading steht "wird nicht unterstützt", muss in den Androideinstellungen unter Ton und Benachrichtigungen -> Benachrichtigungszugriff ein Haken für Automagic gesetzt werden'''
* batteryHealth - Zustand der Battery (1=unbekannt, 2=gut, 3=überhitzt, 4=tot, 5=Überspannung, 6=unbekannter Fehler, 7=kalt)
* batterytemperature - Temperatur der Batterie
* bluetooth - on/off, Bluetooth Status an oder aus
* checkActiveTask - Zustand einer zuvor definierten App. 0=nicht aktiv oder nicht aktiv im Vordergrund, 1=aktiv im Vordergrund, '''siehe Hinweis unten'''
* connectedBTdevices - eine Liste der verbundenen Gerät
* connectedBTdevicesMAC - eine Liste der MAC Adressen aller verbundender BT Geräte
* currentMusicAlbum - aktuell abgespieltes Musikalbum des verwendeten Mediaplayers
* currentMusicApp - aktuell verwendeter Mediaplayer (Amazon Music, Google Play Music, Google Play Video, Spotify, YouTube, TuneIn Player, Aldi Life Music)
* currentMusicArtist - aktuell abgespielter Musikinterpret des verwendeten Mediaplayers
* currentMusicIcon - Cover vom aktuell abgespielten Album '''Noch nicht fertig implementiert'''
* currentMusicState - Status des aktuellen/zuletzt verwendeten Mediaplayers
* currentMusicTrack - aktuell abgespielter Musiktitel des verwendeten Mediaplayers
* daydream - on/off, Daydream gestartet oder nicht
* deviceState - Status des Androidgerätes. unknown, online, offline.
* doNotDisturb - aktueller Status des Nicht-Stören-Modus
* dockingState - undocked/docked Status, ob sich das Gerät in einer Dockingstation befindet.
* flow_SetCommands - active/inactive, Status des SetCommands Flow
* flow_informations - active/inactive, Status des Informations Flow
* flowsetVersionAtDevice - aktuell installierte Flowsetversion auf dem Device
* incomingCallerName - Anrufername des eingehenden Anrufes
* incomingCallerNumber - Anrufernummer des eingehenden Anrufes
* incommingWhatsAppMessageFrom - letzte WhatsApp Nachricht
* incommingWhatsTelegramMessageFrom - letzte Telegram Nachricht
* intentRadioName - zuletzt gestreamter Intent Radio Name
* intentRadioState - Status des IntentRadio Players
* keyguardSet - 0/1 Displaysperre gesetzt 0=nein 1=ja, bedeutet nicht, dass sie gerade aktiv ist
* lastSetCommandError - letzte Fehlermeldung vom set Befehl
* lastSetCommandState - letzter Status vom set Befehl, Befehl erfolgreich/nicht erfolgreich gesendet
* lastStatusRequestError - letzte Fehlermeldung vom statusRequest Befehl
* lastStatusRequestState - letzter Status vom statusRequest Befehl, Befehl erfolgreich/nicht erfolgreich gesendet
* nextAlarmDay - aktiver Alarmtag
* nextAlarmState - aktueller Status des "Androidinternen" Weckers
* nextAlarmTime - aktive Alarmzeit
* powerLevel - Status der Batterie in %
* powerPlugged - Netzteil angeschlossen? 1=AC Adapter, 2=USB, 4=Kabellos 0=nicht eingesteckt
* screen - on locked/unlocked, off locked/unlocked gibt an ob der Bildschirm an oder aus ist und gleichzeitig gesperrt oder nicht gesperrt
* screenBrightness - Bildschirmhelligkeit von 0-255
* screenFullscreen - on/off, Vollbildmodus (An,Aus)
* screenOrientation - Landscape,Portrait, Bildschirmausrichtung (Horizontal,Vertikal)
* screenOrientationMode - auto/manual, Modus für die Ausrichtung (Automatisch, Manuell)
* state - aktueller Status
* userFlowState - aktueller Status eines Flows, festgelegt unter dem setUserFlowState Attribut
* volume - Media Lautstärkewert
* volumeNotification - Benachrichtigungs-Lautstärke

Beim Reading checkActivTask muß zuvor der Packagename der zu prüfenden App als Attribut checkActiveTask angegeben werden. Beispiel: attr Nexus10Wohnzimmer checkActiveTask com.android.chrome für den Chrome Browser.

=== Set ===
* activateVoiceInput - aktiviert die Spracheingabe
* bluetooth - on/off, aktiviert/deaktiviert Bluetooth
* clearNotificationBar - All,Automagic, löscht alle Meldungen oder nur die Automagic Meldungen in der Statusleiste
* closeCall - beendet einen laufenden Anruf
* currentFlowsetUpdate - führt ein Flowsetupdate auf dem Device durch
* doNotDisturb - schaltet den Nicht-Stören-Modus: always immer stören, never niemals stören, alarmClockOnly nur Wecker darf stören, onlyImportant nur wichtige Störungen
* installFlowSource - installiert einen Flow auf dem Device, das XML File muss unter /tmp/ liegen und die Endung xml haben. Bsp: set TabletWohnzimmer installFlowSource WlanUebwerwachen.xml
* mediaAmazonMusic - play, stop, next, back ,steuert den Amazon Musik Mediaplayer
* mediaGoogleMusic - play, stop, next, back ,steuert den Google Play Musik Mediaplayer
* mediaSpotifyMusic - play, stop, next, back ,steuert den Spotify Mediaplayer
* mediaTuneinRadio - play, stop, next, back ,steuert den TuneIn Radio Mediaplayer
* mediaAldiMusic - play, stop, next, back ,steuert den Aldi Musik Mediaplayer
* mediaAudible - play, stop, next, back ,steuert den Audible Mediaplayer
* mediaYouTube - play, stop, next, back ,steuert den YouTube Mediaplayer
* mediaVlcPlayer - play, stop, next, back ,steuert den VLC Mediaplayer
* nextAlarmTime - setzt die Alarmzeit. gilt aber nur innerhalb der nächsten 24 h
* openCall - ruft eine Nummer an und legt optional nach X Sekunden auf / set DEVICE openCall 01736458 10 / ruft die Nummer an und beendet den Anruf nach 10s
* screen - on/off/lock/unlock schaltet den Bildschirm ein/aus oder sperrt/entsperrt ihn
* screenBrightness - setzt die Bildschirmhelligkeit, von 0-255.
* screenMsg - versendet eine Bildschirmnachricht
* sendintent - sendet einen Intentstring Bsp: set $AMADDeviceDEVICE sendIntent org.smblott.intentradio.PLAY url http://stream.klassikradio.de/live/mp3-192/stream.klassikradio.de/play.m3u name Klassikradio, der erste Befehl ist die Aktion und der zweite das Extra. Es können immer zwei Extras mitgegeben werden.
* sendSMS - sendet eine SMS an eine bestimmte Telefonnummer. Bsp.: sendSMS Dies ist ein Test|555487263
* startDaydream - startet den Daydream
* statusRequest - Fordert einen neuen Statusreport beim Device an. Es können nicht von allen Readings per statusRequest die Daten geholt werden. Einige wenige geben nur bei Statusänderung ihren Status wieder.
* timer - setzt einen Timer innerhalb der als Standard definierten Clock-App auf dem Device. Es können nur Sekunden angegeben werden.
* ttsMsg - versendet eine Nachricht, die als Sprachnachricht ausgegeben wird
* userFlowState - aktiviert oder deaktiviert einen oder mehrere Flows,'''set Nexus7Wohnzimmer Badezimmer vorheizen:inactive oder set Nexus7Wohnzimmer Badezimmer vorheizen,Nachtlicht Steven:inactive'''
* vibrate - lässt das Androidgerät vibrieren
* volume - setzt die Medialautstärke. Entweder die internen Lautsprecher oder sofern angeschlossen die Bluetoothlautsprecher und per Klinkenstecker angeschlossene Lautsprecher, + oder - vor dem Wert reduziert die aktuelle Lautstärke um den Wert. Der maximale Sliderwert kann über das Attribut setVolMax geregelt werden.
* volumeUp - erhöht die Lautstärke um den angegeben Wert im entsprechenden Attribut. Ist kein Attribut angegeben wird per default 2 genommen.
* volumeDown - reduziert die Lautstärke um den angegeben Wert im entsprechenden Attribut. Ist kein Attribut angegeben wird per default 2 genommen.
* volumeNotification - setzt die Benachrichtigungslautstärke.

==== Set abhängig von gesetzten Attributen ====
* changetoBtDevice - wechselt zu einem anderen Bluetooth Gerät. Attribut setBluetoothDevice muß gesetzt sein. Siehe Hinweis unten!
* notifySndFile - spielt die angegebene Mediadatei auf dem Androidgerät ab. Die aufzurufende Mediadatei sollte sich im Ordner /storage/emulated/0/Notifications/ befinden. Ist dies nicht der Fall kann man über das Attribut setNotifySndFilePath einen Pfad vorgeben.
* openApp - öffnet eine ausgewählte App. Attribut setOpenApp
* openURL - öffnet eine URL im Standardbrowser, sofern kein anderer Browser über das Attribut setOpenUrlBrowser ausgewählt wurde. Bsp: attr Tablet setOpenUrlBrowser de.ozerov.fully|de.ozerov.fully.MainActivity, das erste ist der Package Name und das zweite der Class Name
* setAPSSID - setzt die AccessPoint SSID um ein WLAN sleep zu verhindern
* setScreenOnForTimer ändert die Zeitdauer, die das Display an bleiben soll!
* screenFullscreen - on/off, (aktiviert/deaktiviert) den Vollbildmodus. Attribut setFullscreen
* screenLock - Sperrt den Bildschirm mit Pinabfrage. Attribut setScreenlockPIN - hier die Pin dafür eingeben. Erlaubt sind nur Zahlen. Es müßen mindestens 4, bis max 16 Zeichen verwendet werden.
* screenOrientation - Auto,Landscape,Portait, aktiviert die Bildschirmausrichtung (Automatisch,Horizontal,Vertikal). Attribut setScreenOrientation
* system - setzt Systembefehle ab (nur bei gerootetet Geräten). reboot,shutdown,airplanemodeON (kann nur aktiviert werden) Attribut root, in den Automagic Einstellungen muss "Root Funktion" gesetzt werden
* setNotifySndFilePath - setzt den korrekten Systempfad zur Notifydatei (default ist /storage/emulated/0/Notifications/
* setTtsMsgSpeed - setzt die Sprachgeschwindigkeit bei der Sprachausgabe(Werte zwischen 0.5 bis 4.0 in 0.5er Schritten) default ist 1.0
* setTtsMsgSpeed - setzt die Sprache bei der Sprachausgabe, de oder en (default ist de)
* setVolUpDownStep - setzt den Step für volumeUp und volumeDown
* setVolMax - setzt die maximale Volume Größe für den Slider
* setNotifyVolMax - setzt den maximalen Lautstärkewert für Benachrichtigungslautstärke für den Slider
* setRingSoundVolMax - setzt den maximalen Lautstärkewert für Klingellautstärke für den Slider

'''Um openApp verwenden zu können, muss als Attribut der Package Name der App angegeben werden.

'''Um zwischen Bluetoothgeräten wechseln zu können, muss das Attribut setBluetoothDevice mit folgender Syntax gesetzt werden. attr <DEVICE> BTdeviceName1|MAC,BTDeviceName2|MAC Es muss zwingend darauf geachtet werden, dass beim BTdeviceName kein Leerzeichen vorhanden ist. Am besten zusammen oder mit Unterstrich. Bei der MAC ist darauf zu achten, dass wirklich nach jeder zweiten Zahl ein : steht

** '''Beispiel: attr Nexus10Wohnzimmer setBluetoothDevice Logitech_BT_Adapter|AB:12:CD:34:EF:32,Anker_A3565|GH:56:IJ:78:KL:76

=== state ===
* initialized - Ist der Status kurz nach einem define.
* active - die Geräteinstanz ist im aktiven Status.
* disabled - die Geräteinstanz wurde über das Attribut disable deaktiviert

==Anwendungsbeispiele==
=== Lademanagement ===
Ich habe die Ladegeräte für meine Androidgeräte an Funkschaltsteckdosen. Ein DOIF schaltet bei unter 30% die Steckdose ein und bei über 90% wieder aus.

Hier mal ein einfaches DOIF Beispiel für ein Lademanagment

<code>
... DOIF ([Nexus5Handy:powerLevel] < 30) (set LadenetzteilNexus5Handy:FILTER=STATE=off on) DOELSEIF ([Nexus5Handy:powerLevel] > 90) (set LadenetzteilNexus5Handy:FILTER=STATE=on off) DOELSE
</code>

=== Wecker ===
Morgens lasse ich mich über mein Tablet im Schlafzimmer mit Musik wecken. Verwendet wird hierzu der wakeuptimer des RESIDENTS Modules. Das Abspielen stoppe ich dann von Hand. Danach erfolgt noch eine Ansage wie das Wetter gerade ist und wird.

=== Mediacenter ===
Mein 10" Tablet im Wohnzimmer ist Mediaplayer für das Wohnzimmer mit Bluetoothlautsprechern. Die Lautstärke wird automatisch heruntergesetzt, wenn die Fritzbox einen Anruf auf das Wohnzimmer Handgerät signalisiert.

=== Sprachbefehl - Abfragen von Zuständen diverser Sensoren ===
Wenn ich die Spracheingabe aktiviere und nach der Temperatur im Wohnzimmer frage, bekomme ich diese angesagt.

Der Teil im Feld Daten ist ein klassisches ReadingsVal, halt nur ohne Komma und ohne Anführungszeichen

WIRD GERADE ÜBERARBEITET

=== Schaltbefehle vom Androidgerät an FHEM senden ===
Hierfür ist ein eigener Flow einzurichten. Wie das genau geht, verrät die Hilfe.
Um einen Schaltbefehl für FHEM zu erstellen, folgt nach dem Trigger eine Aktion als Script (Aktion Type: Script). Hier ist folgendes einzutragen:

setcmd = "LichtWohnzimmerLampeRechts on"

fhemcmd = "set"

In der ersten Zeile wird also der Schaltbefehl in der Variablem setcmd eingetragen und in der zweiten Zeile der FHEM Befehl in der Variablen fhemcmd.

Danach müsst Ihr nur noch in einer weiteren Aktion den Flow "Send Data to AMADCommBridge" ausführen (Aktion Type: Flows ausführen). Die Aktion sollte bereits in Eurer Liste Vorhanden sein.

[[Datei:Screenshot_20160717-134948.png|200px]]
[[Datei:Screenshot 17.07.2016 1-50-27.png|200px]]

Nun sollte Lampe1 angeschalten werden, wenn der Flow ausgeführt wird.

=== Mit FHEM ein Flow ausführen ===
In Automagic einen Triggervom Type General Broadcast für den Flow wählen welchen man fern ausführen möchte. In der Trigger Definition steht unter Aktion ''automagic.NameDesFlows'' und auf Wunsch unter Access Intent Extra's ''param1 = getString("label1"); param2 = getString("label2");''. ''NameDesFlows'' ist natürlich die Name des Flows, der kein Leerzeichen enthält. Mit ein FHEM Command 'set ''AMADDevice'' sendIntent ''automagic.namederflow label1 param1 label2 param2''' wird dann der Flow aus geführt.

=== Lister aller Variablen für die AMADCommandBridge ===
fhemcmd Variable
* Wert "set" - Variable für den Schaltbefehl 'setcmd'
* Wert "setreading" - Variable für die Readingswerte 'fhemdata'
* "readingsval" - Variable für die Abfragewerte 'readingsvalcmd'
* "fhemfunc" - Variable für den Funktionsnamen 'fhemsub'

'''Beispiele für Skriptinhalte:'''

Schalten einer Lampe

<code>
setcmd = "LichtWohnzimmerLampeRechts on";

fhemcmd = "set"
</code>

Status eines Device abfragen

<code>
readingsvalcmd = "DEVICE READING DEFAULT";

fhemcmd = "readingsval"
</code>

Die Rückgabevariable, die dann weiter verarbeitet werden kann, heißt '''respreadingsval'''

Aufruf einer 99_myUtils Subroutine

<code>
fhemsub = "mySub()"; oder natürlich auch "mySub('was_auch_immer')"

fhemcmd = "fhemfunc"
</code>

Die Rückgabevariable, die dann weiter verarbeitet werden kann, heißt '''respfhemfunc'''

== Bekannte Meldungen/Hinweise/Probleme ==

Wenn auf dem Android-Gerät die Fehlermeldung 'Accessibility service not running' von Automagic kommt oder im FHEM das reading state 'Flow Informations mit Fehler beendet' steht, dann muss der Accessibility Service auf dem Android-Device aktiviert werden: Einstellungen --> Bedienungshilfen --> Automagic Premium. Hier muss der Schalter auf 'an' stehen. Sollte dies der Fall sein, hilft u.U. ein kurzes Aus- und wieder Einschalten.

Gerät wird oft als offline angezeigt und es können keine set Befehle abgesetzt werden.
Mit der AMAD Version 2.2 hielt eine neue Behandlung des deviceState Readings Einzug. Das Reading stellt nun den tatsächlichen Status des Gerätes gegenüber FHEM da. Bei vielen Android 6 Geräten kommt es aber auf Grund vom DeepSleep Modus zum Wegfall der WLAN Verbindung. Hier hilft die neue KeepAlive Funktion in AMAD. Dafür muß lediglich unter
* Einstellungen --> Akku --> oben auf die drei Punkte - Akku Leistungsoptimierung --> alle Apps und dann Automagic auswählen und "Nicht optimieren"
ausgewählt werden und in FHEM für das Device das Attribut setAPSSID gesetzt werden. Alles andere macht das Modul selbst.

AMAD

2018-08-10T09:49:36Z

CoolTux: /* Ein AMADDevice Gerät von Hand anlegen. */

{{Infobox Modul
|ModPurpose=Steuern von Androidgeräten und Anzeige von bestimmten Informationen dieser Geräte
|ModType=d
|ModForumArea=Sonstige Systeme
|ModTechName=73_AMADCommBridge.pm, 74_AMADDevice.pm
|ModOwner=CoolTux ([http://forum.fhem.de/index.php?action=profile;u=13684 Forum] / [[Benutzer:CoolTux|Wiki]])
}}

= AMAD 4.0 [AMADNG] =
== 73_AMADCommBridge / 74_AMADDevice ==

= Vorwort =
=== Warum AMADNG ===
Nach fast 6 Monaten Entwicklungszeit wurde die neuste AMAD Version am 24.07.2017 offiziell frei gegeben. Diesmal lagen mir mehrere Dinge am Herzen.
In erster Linie wollte ich eine softwareseitige Trennung der AMADCommBridge vom eigentlichen Android Device. Daher ist die neue Version ein zweistufiges Modul geworden.
Im Laufe der Entwicklung kamen auch andere Anforderungen hinzu, die ich dann fähig war umzusetzen. Eine dieser Anforderungen war eine einfachere und besser funktionierende Installation. Herausgekommen ist ein Android Installationsassistant.
Mit ihm wird auf einfache Art und Weise direkt per Sprachführung und Eingabedialogen Automagic für AMAD konfiguriert und das Device in FHEM automatisch erstellt. Es ist darauf zu achten, das Autocreate aktiv ist, da sonst kein Device mit Hilfe des Assistenten angelegt werden kann!

= Vorstellung =
Dieses 2-stufige Modul liefert, '''in Verbindung mit der Android App Automagic''', diverse Informationen von Android Geräten.
Die AndroidAPP Automagic (die nicht von mir stammt und 2.90 Euro kostet) funktioniert wie Tasker, ist aber bei weitem benutzungsfreundlicher.

=== Features / Funktionen ===
Im Auslieferungszustand werden folgende Zustände dargestellt:
* installierte Android Version
* Zustand von Automagic auf dem Gerät
* Spracheingabe
* Bluetooth An/Aus
* Zustand einer definierten App (läuft aktiv im Vordergrund oder nicht?)
* verbundene Bluetoothgeräte, inklusive deren MAC Adresse
* aktuell abgespieltes Musikalbum des verwendeten Mediaplayers
* aktuell abgespielter Musikinterpret des verwendeten Mediaplayers
* aktuell abgespielter Musiktitel des verwendeten Mediaplayers
* Status des Androidgerätes - Online/Offline
* nächster Alarmtag
* nächste Alarmzeit
* Batteriestatus in %
* Ladestatus - Netztei angeschlossen / nicht angeschlossen
* Bildschirmstatus An/Aus
* Bildschirmhelligkeit
* Vollbildmodus An/Aus
* Bildschirmausrichtung Auto/Landscape/Portrait
* Standardlautstärke
* Media Lautstärke
* ...

Mit etwas Einarbeitung können jegliche Informationen, die Automagic bereit stellt, in FHEM angezeigt werden. Hierzu bedarf es lediglich eines eigenen Flows, der seine Daten an die AMADCommBridge sendet. Das Modul gibt auch die Möglichkeit Androidgeräte zu steuern.

= AMADCommBridge - Kommunikationsbrücke für alle AMAD Geräte =
Dieses Modul ist das Ausgangsmodul zur erfolgreichen Integration von Androidgeräten in FHEM. Es stellt ferner eine Verbindungsebene zwischen AMAD unterstützten Geräten und FHEM zur Verfügung. Alle Kommunikation zwischen AMAD Android und FHEM läuft über diese Schnittstelle.
Daher erfolgt die Ersteinrichtung eines AMAD Devices auch genau über diese Modulinstanz.

Damit erfolgreich ein Androidgerät in FHEM eingerichtet werden kann, muss im ersten Schritt ein AMADCommBridge Device angelegt werden.

=== Definition in FHEM ===

<code>define <name> AMADCommBridge</code>

==== Beispiel ====

<code>define AMADBridge AMADCommBridge</code>

Diese Anweisung erstellt ein neues AMADCommBridge Device namens AMADBridge.

Im folgenden muß lediglich das Flowset auf dem Android Gerät installiert werden und der Flow 'First Run Assistent' ausgeführt werden. (einfach den Homebutton drücken)
Der Assistent geleitet dann durch die Einrichtung des AMAD Gerätes und sorgt dafür, dass am Ende des Installationsprozess das Androidgerät als AMAD Device in FHEM angelegt wird.

=== Readings ===
* JSON_ERROR - JSON Fehlermeldung, die von Perl gemeldet wird
* JSON_ERROR_STRING - der String, der die JSON Fehlermeldung verursacht hat
* fhemServerIP - die Ip-Adresse des FHEM Servers; wird vom Modul auf Basis des JSON Strings vom Installationsassistenten gesetzt. Kann aber auch mittels set Befehles vom User gesetzt werden
* receiveFhemCommand - ist das Attribut fhemControlMode auf trigger gestellt, wird das Reading gesetzt sobald ein FHEM Befehl übersendet wird. Hierauf kann dann ein Notify triggern. Wird anstelle von trigger setControl als Wert für fhemControlMode eingestellt, wird das Reading nicht gesetzt sondern der set Befehl sofort ausgeführt.
* receiveVoiceCommand - wird die Sprachsteuerung von AMAD aktiviert (set DEVICE activateVoiceInput) so wird der letzte erkannten Sprachbefehle in dieses Reading geschrieben.
* receiveVoiceDevice - Name des Devices von wo aus der letzte erkannte Sprachbefehl gesendet wurde
* state - Status der Bridge, open, closed

=== Attribute ===
* allowFrom - Regexp der erlaubten IP-Adressen oder Hostnamen. Wenn dieses Attribut gesetzt wurde, werden ausschließlich Verbindungen von diesen Adressen akzeptiert. Achtung: falls allowfrom nicht gesetzt ist, und keine gütige allowed Instanz definiert ist, und die Gegenstelle eine nicht lokale Adresse hat, dann wird die Verbindung abgewiesen. Folgende Adressen werden als local betrachtet: IPV4: 127/8, 10/8, 192.168/16, 172.16/10, 169.254/16, IPV6: ::1, fe80/10
* debugJSON - wenn auf 1 gesetzt, werden JSON Fehlermeldungen in Readings geschrieben. Siehe hierzu JSON_ERROR* unter Readings
* fhemControlMode - steuert die zulässige Art der Steuerung von FHEM Devices. Es können über die Bridge auf 2 Arten FHEM-Devices angesteuert werden: per direktem FHEM-Befehl aus einem Flow heraus oder als Sprachbefehl mittels Sprachsteuerung (set DEVICE activateVoiceInput)
** trigger - ist der Wert trigger gesetzt, werden alle an die Bridge gesendeten FHEM set Befehle in das Reading receiveFhemCommand geschrieben und können so mittels notify ausgeführt werden. Sprachsteuerung ist möglich, es werden Readings receiveVoice* gesetzt. Auf dem Androidgerät können bei Sprachsteuerung mehrere Sprachbefehle mittels "und" verknüpft/aneinander gereiht werden. Bsp: schalte die Lichtszene Abends an und schalte den Fernseher an
** setControl - alle set Befehle, die mittels eines Flows über die Bridge gesendet werden, werden automatisch ausgeführt. Das Triggern eines Readings ist nicht nötig. Die Steuerung mittels Sprache verhält sich wie beim Wert trigger
** thirdPartControl - verhält sich wie trigger, bei der Sprachsteuerung ist jedoch ein Anreihen von Sprachbefehlen mittels "und" nicht möglich. Dient der Sprachsteuerung über Module anderer Modulautoren ((z.B. 39_TEERKO.pm)

= AMADDevice - Automagic Android Device =
Dieses Modul liefert, in Verbindung mit der Android APP Automagic, diverse Informationen von Android Geräten. Die Android App Automagic (die nicht von mir stammt und 2.90 Euro kostet) funktioniert wie Tasker, ist aber bei weitem User freundlicher.
Mit etwas Einarbeitung können jegliche Informationen, die Automagic bereit stellt in FHEM angezeigt werden. Hierzu bedarf es lediglich eines eigenen Flows, der seine Daten an die AMADDeviceCommBridge sendet. Das Modul gibt auch die Möglichkeit Androidgeräte zu steuern.
Für all diese Aktionen und Informationen wird auf dem Androidgerät "Automagic" und ein so genannter Flow benötigt. Die App ist über den Google PlayStore zu beziehen. Das benötigte Flowset bekommt man aus dem FHEM Verzeichnis.

=== Wie genau verwendet man nun AMADDevice? ===
* sicherstellen, dass als allererstes die AMADCommBridge in FHEM definiert wurde
* installieren der App "Automagic Premium" aus dem PlayStore
* installieren des Flowset 74_AMADDeviceautomagicFlowset$VERSION.xml aus dem Ordner $INSTALLFHEM/FHEM/lib/ auf dem Androidgerät
* aktivieren des Installationsassistanten Flow in Automagic. Wenn man nun Automagic in den Hintergrund schickt, z.B. Hometaste drücken, startet der Assistant und legt automatisch ein Device für das Androidgerät an.

=== Ein AMADDevice Gerät von Hand anlegen. ===

Define

<code>define <name> AMADDevice <IP-ADRESSE> <AMAD_ID> <REMOTESERVER></code>

==== Beispiel ====

<code>define WandTabletWohnzimmer AMADDevice 192.168.0.23 123456 Automagic</code>

In diesem Fall wird ein AMADDevice von Hand angelegt. Die AMAD_ID, hier 123456, muß auch exakt so als globale Variable in Automagic eingetragen sein.

=== Readings ===
* airplanemode - Status des Flugmodus
* androidVersion - aktuell installierte Androidversion
* automagicState - Statusmeldungen von der Automagic App '''(Voraussetzung Android >4.3). Ist Android größer 4.3 vorhanden und im Reading steht "wird nicht unterstützt", muss in den Androideinstellungen unter Ton und Benachrichtigungen -> Benachrichtigungszugriff ein Haken für Automagic gesetzt werden'''
* batteryHealth - Zustand der Battery (1=unbekannt, 2=gut, 3=überhitzt, 4=tot, 5=Überspannung, 6=unbekannter Fehler, 7=kalt)
* batterytemperature - Temperatur der Batterie
* bluetooth - on/off, Bluetooth Status an oder aus
* checkActiveTask - Zustand einer zuvor definierten App. 0=nicht aktiv oder nicht aktiv im Vordergrund, 1=aktiv im Vordergrund, '''siehe Hinweis unten'''
* connectedBTdevices - eine Liste der verbundenen Gerät
* connectedBTdevicesMAC - eine Liste der MAC Adressen aller verbundender BT Geräte
* currentMusicAlbum - aktuell abgespieltes Musikalbum des verwendeten Mediaplayers
* currentMusicApp - aktuell verwendeter Mediaplayer (Amazon Music, Google Play Music, Google Play Video, Spotify, YouTube, TuneIn Player, Aldi Life Music)
* currentMusicArtist - aktuell abgespielter Musikinterpret des verwendeten Mediaplayers
* currentMusicIcon - Cover vom aktuell abgespielten Album '''Noch nicht fertig implementiert'''
* currentMusicState - Status des aktuellen/zuletzt verwendeten Mediaplayers
* currentMusicTrack - aktuell abgespielter Musiktitel des verwendeten Mediaplayers
* daydream - on/off, Daydream gestartet oder nicht
* deviceState - Status des Androidgerätes. unknown, online, offline.
* doNotDisturb - aktueller Status des Nicht-Stören-Modus
* dockingState - undocked/docked Status, ob sich das Gerät in einer Dockingstation befindet.
* flow_SetCommands - active/inactive, Status des SetCommands Flow
* flow_informations - active/inactive, Status des Informations Flow
* flowsetVersionAtDevice - aktuell installierte Flowsetversion auf dem Device
* incomingCallerName - Anrufername des eingehenden Anrufes
* incomingCallerNumber - Anrufernummer des eingehenden Anrufes
* incommingWhatsAppMessageFrom - letzte WhatsApp Nachricht
* incommingWhatsTelegramMessageFrom - letzte Telegram Nachricht
* intentRadioName - zuletzt gestreamter Intent Radio Name
* intentRadioState - Status des IntentRadio Players
* keyguardSet - 0/1 Displaysperre gesetzt 0=nein 1=ja, bedeutet nicht, dass sie gerade aktiv ist
* lastSetCommandError - letzte Fehlermeldung vom set Befehl
* lastSetCommandState - letzter Status vom set Befehl, Befehl erfolgreich/nicht erfolgreich gesendet
* lastStatusRequestError - letzte Fehlermeldung vom statusRequest Befehl
* lastStatusRequestState - letzter Status vom statusRequest Befehl, Befehl erfolgreich/nicht erfolgreich gesendet
* nextAlarmDay - aktiver Alarmtag
* nextAlarmState - aktueller Status des "Androidinternen" Weckers
* nextAlarmTime - aktive Alarmzeit
* powerLevel - Status der Batterie in %
* powerPlugged - Netzteil angeschlossen? 1=AC Adapter, 2=USB, 4=Kabellos 0=nicht eingesteckt
* screen - on locked/unlocked, off locked/unlocked gibt an ob der Bildschirm an oder aus ist und gleichzeitig gesperrt oder nicht gesperrt
* screenBrightness - Bildschirmhelligkeit von 0-255
* screenFullscreen - on/off, Vollbildmodus (An,Aus)
* screenOrientation - Landscape,Portrait, Bildschirmausrichtung (Horizontal,Vertikal)
* screenOrientationMode - auto/manual, Modus für die Ausrichtung (Automatisch, Manuell)
* state - aktueller Status
* userFlowState - aktueller Status eines Flows, festgelegt unter dem setUserFlowState Attribut
* volume - Media Lautstärkewert
* volumeNotification - Benachrichtigungs-Lautstärke

Beim Reading checkActivTask muß zuvor der Packagename der zu prüfenden App als Attribut checkActiveTask angegeben werden. Beispiel: attr Nexus10Wohnzimmer checkActiveTask com.android.chrome für den Chrome Browser.

=== Set ===
* activateVoiceInput - aktiviert die Spracheingabe
* bluetooth - on/off, aktiviert/deaktiviert Bluetooth
* clearNotificationBar - All,Automagic, löscht alle Meldungen oder nur die Automagic Meldungen in der Statusleiste
* closeCall - beendet einen laufenden Anruf
* currentFlowsetUpdate - führt ein Flowsetupdate auf dem Device durch
* doNotDisturb - schaltet den Nicht-Stören-Modus: always immer stören, never niemals stören, alarmClockOnly nur Wecker darf stören, onlyImportant nur wichtige Störungen
* installFlowSource - installiert einen Flow auf dem Device, das XML File muss unter /tmp/ liegen und die Endung xml haben. Bsp: set TabletWohnzimmer installFlowSource WlanUebwerwachen.xml
* mediaAmazonMusic - play, stop, next, back ,steuert den Amazon Musik Mediaplayer
* mediaGoogleMusic - play, stop, next, back ,steuert den Google Play Musik Mediaplayer
* mediaSpotifyMusic - play, stop, next, back ,steuert den Spotify Mediaplayer
* mediaTuneinRadio - play, stop, next, back ,steuert den TuneIn Radio Mediaplayer
* mediaAldiMusic - play, stop, next, back ,steuert den Aldi Musik Mediaplayer
* mediaAudible - play, stop, next, back ,steuert den Audible Mediaplayer
* mediaYouTube - play, stop, next, back ,steuert den YouTube Mediaplayer
* mediaVlcPlayer - play, stop, next, back ,steuert den VLC Mediaplayer
* nextAlarmTime - setzt die Alarmzeit. gilt aber nur innerhalb der nächsten 24 h
* openCall - ruft eine Nummer an und legt optional nach X Sekunden auf / set DEVICE openCall 01736458 10 / ruft die Nummer an und beendet den Anruf nach 10s
* screen - on/off/lock/unlock schaltet den Bildschirm ein/aus oder sperrt/entsperrt ihn
* screenBrightness - setzt die Bildschirmhelligkeit, von 0-255.
* screenMsg - versendet eine Bildschirmnachricht
* sendintent - sendet einen Intentstring Bsp: set $AMADDeviceDEVICE sendIntent org.smblott.intentradio.PLAY url http://stream.klassikradio.de/live/mp3-192/stream.klassikradio.de/play.m3u name Klassikradio, der erste Befehl ist die Aktion und der zweite das Extra. Es können immer zwei Extras mitgegeben werden.
* sendSMS - sendet eine SMS an eine bestimmte Telefonnummer. Bsp.: sendSMS Dies ist ein Test|555487263
* startDaydream - startet den Daydream
* statusRequest - Fordert einen neuen Statusreport beim Device an. Es können nicht von allen Readings per statusRequest die Daten geholt werden. Einige wenige geben nur bei Statusänderung ihren Status wieder.
* timer - setzt einen Timer innerhalb der als Standard definierten Clock-App auf dem Device. Es können nur Sekunden angegeben werden.
* ttsMsg - versendet eine Nachricht, die als Sprachnachricht ausgegeben wird
* userFlowState - aktiviert oder deaktiviert einen oder mehrere Flows,'''set Nexus7Wohnzimmer Badezimmer vorheizen:inactive oder set Nexus7Wohnzimmer Badezimmer vorheizen,Nachtlicht Steven:inactive'''
* vibrate - lässt das Androidgerät vibrieren
* volume - setzt die Medialautstärke. Entweder die internen Lautsprecher oder sofern angeschlossen die Bluetoothlautsprecher und per Klinkenstecker angeschlossene Lautsprecher, + oder - vor dem Wert reduziert die aktuelle Lautstärke um den Wert. Der maximale Sliderwert kann über das Attribut setVolMax geregelt werden.
* volumeUp - erhöht die Lautstärke um den angegeben Wert im entsprechenden Attribut. Ist kein Attribut angegeben wird per default 2 genommen.
* volumeDown - reduziert die Lautstärke um den angegeben Wert im entsprechenden Attribut. Ist kein Attribut angegeben wird per default 2 genommen.
* volumeNotification - setzt die Benachrichtigungslautstärke.

==== Set abhängig von gesetzten Attributen ====
* changetoBtDevice - wechselt zu einem anderen Bluetooth Gerät. Attribut setBluetoothDevice muß gesetzt sein. Siehe Hinweis unten!
* notifySndFile - spielt die angegebene Mediadatei auf dem Androidgerät ab. Die aufzurufende Mediadatei sollte sich im Ordner /storage/emulated/0/Notifications/ befinden. Ist dies nicht der Fall kann man über das Attribut setNotifySndFilePath einen Pfad vorgeben.
* openApp - öffnet eine ausgewählte App. Attribut setOpenApp
* openURL - öffnet eine URL im Standardbrowser, sofern kein anderer Browser über das Attribut setOpenUrlBrowser ausgewählt wurde. Bsp: attr Tablet setOpenUrlBrowser de.ozerov.fully|de.ozerov.fully.MainActivity, das erste ist der Package Name und das zweite der Class Name
* setAPSSID - setzt die AccessPoint SSID um ein WLAN sleep zu verhindern
* setScreenOnForTimer ändert die Zeitdauer, die das Display an bleiben soll!
* screenFullscreen - on/off, (aktiviert/deaktiviert) den Vollbildmodus. Attribut setFullscreen
* screenLock - Sperrt den Bildschirm mit Pinabfrage. Attribut setScreenlockPIN - hier die Pin dafür eingeben. Erlaubt sind nur Zahlen. Es müßen mindestens 4, bis max 16 Zeichen verwendet werden.
* screenOrientation - Auto,Landscape,Portait, aktiviert die Bildschirmausrichtung (Automatisch,Horizontal,Vertikal). Attribut setScreenOrientation
* system - setzt Systembefehle ab (nur bei gerootetet Geräten). reboot,shutdown,airplanemodeON (kann nur aktiviert werden) Attribut root, in den Automagic Einstellungen muss "Root Funktion" gesetzt werden
* setNotifySndFilePath - setzt den korrekten Systempfad zur Notifydatei (default ist /storage/emulated/0/Notifications/
* setTtsMsgSpeed - setzt die Sprachgeschwindigkeit bei der Sprachausgabe(Werte zwischen 0.5 bis 4.0 in 0.5er Schritten) default ist 1.0
* setTtsMsgSpeed - setzt die Sprache bei der Sprachausgabe, de oder en (default ist de)
* setVolUpDownStep - setzt den Step für volumeUp und volumeDown
* setVolMax - setzt die maximale Volume Größe für den Slider
* setNotifyVolMax - setzt den maximalen Lautstärkewert für Benachrichtigungslautstärke für den Slider
* setRingSoundVolMax - setzt den maximalen Lautstärkewert für Klingellautstärke für den Slider

'''Um openApp verwenden zu können, muss als Attribut der Package Name der App angegeben werden.

'''Um zwischen Bluetoothgeräten wechseln zu können, muss das Attribut setBluetoothDevice mit folgender Syntax gesetzt werden. attr <DEVICE> BTdeviceName1|MAC,BTDeviceName2|MAC Es muss zwingend darauf geachtet werden, dass beim BTdeviceName kein Leerzeichen vorhanden ist. Am besten zusammen oder mit Unterstrich. Bei der MAC ist darauf zu achten, dass wirklich nach jeder zweiten Zahl ein : steht

** '''Beispiel: attr Nexus10Wohnzimmer setBluetoothDevice Logitech_BT_Adapter|AB:12:CD:34:EF:32,Anker_A3565|GH:56:IJ:78:KL:76

=== state ===
* initialized - Ist der Status kurz nach einem define.
* active - die Geräteinstanz ist im aktiven Status.
* disabled - die Geräteinstanz wurde über das Attribut disable deaktiviert

==Anwendungsbeispiele==
=== Lademanagement ===
Ich habe die Ladegeräte für meine Androidgeräte an Funkschaltsteckdosen. Ein DOIF schaltet bei unter 30% die Steckdose ein und bei über 90% wieder aus.

Hier mal ein einfaches DOIF Beispiel für ein Lademanagment

<code>
... DOIF ([Nexus5Handy:powerLevel] < 30) (set LadenetzteilNexus5Handy:FILTER=STATE=off on) DOELSEIF ([Nexus5Handy:powerLevel] > 90) (set LadenetzteilNexus5Handy:FILTER=STATE=on off) DOELSE
</code>

=== Wecker ===
Morgens lasse ich mich über mein Tablet im Schlafzimmer mit Musik wecken. Verwendet wird hierzu der wakeuptimer des RESIDENTS Modules. Das Abspielen stoppe ich dann von Hand. Danach erfolgt noch eine Ansage wie das Wetter gerade ist und wird.

=== Mediacenter ===
Mein 10" Tablet im Wohnzimmer ist Mediaplayer für das Wohnzimmer mit Bluetoothlautsprechern. Die Lautstärke wird automatisch heruntergesetzt, wenn die Fritzbox einen Anruf auf das Wohnzimmer Handgerät signalisiert.

=== Sprachbefehl - Abfragen von Zuständen diverser Sensoren ===
Wenn ich die Spracheingabe aktiviere und nach der Temperatur im Wohnzimmer frage, bekomme ich diese angesagt.

Der Teil im Feld Daten ist ein klassisches ReadingsVal, halt nur ohne Komma und ohne Anführungszeichen

WIRD GERADE ÜBERARBEITET

=== Schaltbefehle vom Androidgerät an FHEM senden ===
Hierfür ist ein eigener Flow einzurichten. Wie das genau geht, verrät die Hilfe.
Um einen Schaltbefehl für FHEM zu erstellen, folgt nach dem Trigger eine Aktion als Script (Aktion Type: Script). Hier ist folgendes einzutragen:

setcmd = "LichtWohnzimmerLampeRechts on"

fhemcmd = "set"

In der ersten Zeile wird also der Schaltbefehl in der Variablem setcmd eingetragen und in der zweiten Zeile der FHEM Befehl in der Variablen fhemcmd.

Danach müsst Ihr nur noch in einer weiteren Aktion den Flow "Send Data to AMADCommBridge" ausführen (Aktion Type: Flows ausführen). Die Aktion sollte bereits in Eurer Liste Vorhanden sein.

[[Datei:Screenshot_20160717-134948.png|200px]]
[[Datei:Screenshot 17.07.2016 1-50-27.png|200px]]

Nun sollte Lampe1 angeschalten werden, wenn der Flow ausgeführt wird.

=== Mit FHEM ein Flow ausführen ===
In Automagic einen Triggervom Type General Broadcast für den Flow wählen welchen man fern ausführen möchte. In der Trigger Definition steht unter Aktion ''automagic.NameDesFlows'' und auf Wunsch unter Access Intent Extra's ''param1 = getString("label1"); param2 = getString("label2");''. ''NameDesFlows'' ist natürlich die Name des Flows, der kein Leerzeichen enthält. Mit ein FHEM Command 'set ''AMADDevice'' sendIntent ''automagic.namederflow label1 param1 label2 param2''' wird dann der Flow aus geführt.

=== Lister aller Variablen für die AMADCommandBridge ===
fhemcmd Variable
* Wert "set" - Variable für den Schaltbefehl 'setcmd'
* Wert "setreading" - Variable für die Readingswerte 'fhemdata'
* "readingsval" - Variable für die Abfragewerte 'readingsvalcmd'
* "fhemfunc" - Variable für den Funktionsnamen 'fhemsub'

'''Beispiele für Skriptinhalte:'''

Schalten einer Lampe

<code>
setcmd = "LichtWohnzimmerLampeRechts on";

fhemcmd = "set"
</code>

Status eines Device abfragen

<code>
readingsvalcmd = "DEVICE READING DEFAULT";

fhemcmd = "readingsval"
</code>

Die Rückgabevariable, die dann weiter verarbeitet werden kann, heißt '''respreadingsval'''

Aufruf einer 99_myUtils Subroutine

<code>
fhemsub = "mySub()"; oder natürlich auch "mySub('was_auch_immer')"

fhemcmd = "fhemfunc"
</code>

Die Rückgabevariable, die dann weiter verarbeitet werden kann, heißt '''respfhemfunc'''

== Bekannte Meldungen/Hinweise/Probleme ==

Wenn auf dem Android-Gerät die Fehlermeldung 'Accessibility service not running' von Automagic kommt oder im FHEM das reading state 'Flow Informations mit Fehler beendet' steht, dann muss der Accessibility Service auf dem Android-Device aktiviert werden: Einstellungen --> Bedienungshilfen --> Automagic Premium. Hier muss der Schalter auf 'an' stehen. Sollte dies der Fall sein, hilft u.U. ein kurzes Aus- und wieder Einschalten.

Gerät wird oft als offline angezeigt und es können keine set Befehle abgesetzt werden.
Mit der AMAD Version 2.2 hielt eine neue Behandlung des deviceState Readings Einzug. Das Reading stellt nun den tatsächlichen Status des Gerätes gegenüber FHEM da. Bei vielen Android 6 Geräten kommt es aber auf Grund vom DeepSleep Modus zum Wegfall der WLAN Verbindung. Hier hilft die neue KeepAlive Funktion in AMAD. Dafür muß lediglich unter
* Einstellungen --> Akku --> oben auf die drei Punkte - Akku Leistungsoptimierung --> alle Apps und dann Automagic auswählen und "Nicht optimieren"
ausgewählt werden und in FHEM für das Device das Attribut setAPSSID gesetzt werden. Alles andere macht das Modul selbst.

AMAD

2018-08-10T09:49:13Z

CoolTux: /* Ein AMADDevice Gerät von Hand anlegen. */

{{Infobox Modul
|ModPurpose=Steuern von Androidgeräten und Anzeige von bestimmten Informationen dieser Geräte
|ModType=d
|ModForumArea=Sonstige Systeme
|ModTechName=73_AMADCommBridge.pm, 74_AMADDevice.pm
|ModOwner=CoolTux ([http://forum.fhem.de/index.php?action=profile;u=13684 Forum] / [[Benutzer:CoolTux|Wiki]])
}}

= AMAD 4.0 [AMADNG] =
== 73_AMADCommBridge / 74_AMADDevice ==

= Vorwort =
=== Warum AMADNG ===
Nach fast 6 Monaten Entwicklungszeit wurde die neuste AMAD Version am 24.07.2017 offiziell frei gegeben. Diesmal lagen mir mehrere Dinge am Herzen.
In erster Linie wollte ich eine softwareseitige Trennung der AMADCommBridge vom eigentlichen Android Device. Daher ist die neue Version ein zweistufiges Modul geworden.
Im Laufe der Entwicklung kamen auch andere Anforderungen hinzu, die ich dann fähig war umzusetzen. Eine dieser Anforderungen war eine einfachere und besser funktionierende Installation. Herausgekommen ist ein Android Installationsassistant.
Mit ihm wird auf einfache Art und Weise direkt per Sprachführung und Eingabedialogen Automagic für AMAD konfiguriert und das Device in FHEM automatisch erstellt. Es ist darauf zu achten, das Autocreate aktiv ist, da sonst kein Device mit Hilfe des Assistenten angelegt werden kann!

= Vorstellung =
Dieses 2-stufige Modul liefert, '''in Verbindung mit der Android App Automagic''', diverse Informationen von Android Geräten.
Die AndroidAPP Automagic (die nicht von mir stammt und 2.90 Euro kostet) funktioniert wie Tasker, ist aber bei weitem benutzungsfreundlicher.

=== Features / Funktionen ===
Im Auslieferungszustand werden folgende Zustände dargestellt:
* installierte Android Version
* Zustand von Automagic auf dem Gerät
* Spracheingabe
* Bluetooth An/Aus
* Zustand einer definierten App (läuft aktiv im Vordergrund oder nicht?)
* verbundene Bluetoothgeräte, inklusive deren MAC Adresse
* aktuell abgespieltes Musikalbum des verwendeten Mediaplayers
* aktuell abgespielter Musikinterpret des verwendeten Mediaplayers
* aktuell abgespielter Musiktitel des verwendeten Mediaplayers
* Status des Androidgerätes - Online/Offline
* nächster Alarmtag
* nächste Alarmzeit
* Batteriestatus in %
* Ladestatus - Netztei angeschlossen / nicht angeschlossen
* Bildschirmstatus An/Aus
* Bildschirmhelligkeit
* Vollbildmodus An/Aus
* Bildschirmausrichtung Auto/Landscape/Portrait
* Standardlautstärke
* Media Lautstärke
* ...

Mit etwas Einarbeitung können jegliche Informationen, die Automagic bereit stellt, in FHEM angezeigt werden. Hierzu bedarf es lediglich eines eigenen Flows, der seine Daten an die AMADCommBridge sendet. Das Modul gibt auch die Möglichkeit Androidgeräte zu steuern.

= AMADCommBridge - Kommunikationsbrücke für alle AMAD Geräte =
Dieses Modul ist das Ausgangsmodul zur erfolgreichen Integration von Androidgeräten in FHEM. Es stellt ferner eine Verbindungsebene zwischen AMAD unterstützten Geräten und FHEM zur Verfügung. Alle Kommunikation zwischen AMAD Android und FHEM läuft über diese Schnittstelle.
Daher erfolgt die Ersteinrichtung eines AMAD Devices auch genau über diese Modulinstanz.

Damit erfolgreich ein Androidgerät in FHEM eingerichtet werden kann, muss im ersten Schritt ein AMADCommBridge Device angelegt werden.

=== Definition in FHEM ===

<code>define <name> AMADCommBridge</code>

==== Beispiel ====

<code>define AMADBridge AMADCommBridge</code>

Diese Anweisung erstellt ein neues AMADCommBridge Device namens AMADBridge.

Im folgenden muß lediglich das Flowset auf dem Android Gerät installiert werden und der Flow 'First Run Assistent' ausgeführt werden. (einfach den Homebutton drücken)
Der Assistent geleitet dann durch die Einrichtung des AMAD Gerätes und sorgt dafür, dass am Ende des Installationsprozess das Androidgerät als AMAD Device in FHEM angelegt wird.

=== Readings ===
* JSON_ERROR - JSON Fehlermeldung, die von Perl gemeldet wird
* JSON_ERROR_STRING - der String, der die JSON Fehlermeldung verursacht hat
* fhemServerIP - die Ip-Adresse des FHEM Servers; wird vom Modul auf Basis des JSON Strings vom Installationsassistenten gesetzt. Kann aber auch mittels set Befehles vom User gesetzt werden
* receiveFhemCommand - ist das Attribut fhemControlMode auf trigger gestellt, wird das Reading gesetzt sobald ein FHEM Befehl übersendet wird. Hierauf kann dann ein Notify triggern. Wird anstelle von trigger setControl als Wert für fhemControlMode eingestellt, wird das Reading nicht gesetzt sondern der set Befehl sofort ausgeführt.
* receiveVoiceCommand - wird die Sprachsteuerung von AMAD aktiviert (set DEVICE activateVoiceInput) so wird der letzte erkannten Sprachbefehle in dieses Reading geschrieben.
* receiveVoiceDevice - Name des Devices von wo aus der letzte erkannte Sprachbefehl gesendet wurde
* state - Status der Bridge, open, closed

=== Attribute ===
* allowFrom - Regexp der erlaubten IP-Adressen oder Hostnamen. Wenn dieses Attribut gesetzt wurde, werden ausschließlich Verbindungen von diesen Adressen akzeptiert. Achtung: falls allowfrom nicht gesetzt ist, und keine gütige allowed Instanz definiert ist, und die Gegenstelle eine nicht lokale Adresse hat, dann wird die Verbindung abgewiesen. Folgende Adressen werden als local betrachtet: IPV4: 127/8, 10/8, 192.168/16, 172.16/10, 169.254/16, IPV6: ::1, fe80/10
* debugJSON - wenn auf 1 gesetzt, werden JSON Fehlermeldungen in Readings geschrieben. Siehe hierzu JSON_ERROR* unter Readings
* fhemControlMode - steuert die zulässige Art der Steuerung von FHEM Devices. Es können über die Bridge auf 2 Arten FHEM-Devices angesteuert werden: per direktem FHEM-Befehl aus einem Flow heraus oder als Sprachbefehl mittels Sprachsteuerung (set DEVICE activateVoiceInput)
** trigger - ist der Wert trigger gesetzt, werden alle an die Bridge gesendeten FHEM set Befehle in das Reading receiveFhemCommand geschrieben und können so mittels notify ausgeführt werden. Sprachsteuerung ist möglich, es werden Readings receiveVoice* gesetzt. Auf dem Androidgerät können bei Sprachsteuerung mehrere Sprachbefehle mittels "und" verknüpft/aneinander gereiht werden. Bsp: schalte die Lichtszene Abends an und schalte den Fernseher an
** setControl - alle set Befehle, die mittels eines Flows über die Bridge gesendet werden, werden automatisch ausgeführt. Das Triggern eines Readings ist nicht nötig. Die Steuerung mittels Sprache verhält sich wie beim Wert trigger
** thirdPartControl - verhält sich wie trigger, bei der Sprachsteuerung ist jedoch ein Anreihen von Sprachbefehlen mittels "und" nicht möglich. Dient der Sprachsteuerung über Module anderer Modulautoren ((z.B. 39_TEERKO.pm)

= AMADDevice - Automagic Android Device =
Dieses Modul liefert, in Verbindung mit der Android APP Automagic, diverse Informationen von Android Geräten. Die Android App Automagic (die nicht von mir stammt und 2.90 Euro kostet) funktioniert wie Tasker, ist aber bei weitem User freundlicher.
Mit etwas Einarbeitung können jegliche Informationen, die Automagic bereit stellt in FHEM angezeigt werden. Hierzu bedarf es lediglich eines eigenen Flows, der seine Daten an die AMADDeviceCommBridge sendet. Das Modul gibt auch die Möglichkeit Androidgeräte zu steuern.
Für all diese Aktionen und Informationen wird auf dem Androidgerät "Automagic" und ein so genannter Flow benötigt. Die App ist über den Google PlayStore zu beziehen. Das benötigte Flowset bekommt man aus dem FHEM Verzeichnis.

=== Wie genau verwendet man nun AMADDevice? ===
* sicherstellen, dass als allererstes die AMADCommBridge in FHEM definiert wurde
* installieren der App "Automagic Premium" aus dem PlayStore
* installieren des Flowset 74_AMADDeviceautomagicFlowset$VERSION.xml aus dem Ordner $INSTALLFHEM/FHEM/lib/ auf dem Androidgerät
* aktivieren des Installationsassistanten Flow in Automagic. Wenn man nun Automagic in den Hintergrund schickt, z.B. Hometaste drücken, startet der Assistant und legt automatisch ein Device für das Androidgerät an.

=== Ein AMADDevice Gerät von Hand anlegen. ===

Define

<code>define <name> AMADDevice <IP-ADRESSE> <AMAD_ID> remoteServer</code>

==== Beispiel ====

<code>define WandTabletWohnzimmer AMADDevice 192.168.0.23 123456 Automagic</code>

In diesem Fall wird ein AMADDevice von Hand angelegt. Die AMAD_ID, hier 123456, muß auch exakt so als globale Variable in Automagic eingetragen sein.

=== Readings ===
* airplanemode - Status des Flugmodus
* androidVersion - aktuell installierte Androidversion
* automagicState - Statusmeldungen von der Automagic App '''(Voraussetzung Android >4.3). Ist Android größer 4.3 vorhanden und im Reading steht "wird nicht unterstützt", muss in den Androideinstellungen unter Ton und Benachrichtigungen -> Benachrichtigungszugriff ein Haken für Automagic gesetzt werden'''
* batteryHealth - Zustand der Battery (1=unbekannt, 2=gut, 3=überhitzt, 4=tot, 5=Überspannung, 6=unbekannter Fehler, 7=kalt)
* batterytemperature - Temperatur der Batterie
* bluetooth - on/off, Bluetooth Status an oder aus
* checkActiveTask - Zustand einer zuvor definierten App. 0=nicht aktiv oder nicht aktiv im Vordergrund, 1=aktiv im Vordergrund, '''siehe Hinweis unten'''
* connectedBTdevices - eine Liste der verbundenen Gerät
* connectedBTdevicesMAC - eine Liste der MAC Adressen aller verbundender BT Geräte
* currentMusicAlbum - aktuell abgespieltes Musikalbum des verwendeten Mediaplayers
* currentMusicApp - aktuell verwendeter Mediaplayer (Amazon Music, Google Play Music, Google Play Video, Spotify, YouTube, TuneIn Player, Aldi Life Music)
* currentMusicArtist - aktuell abgespielter Musikinterpret des verwendeten Mediaplayers
* currentMusicIcon - Cover vom aktuell abgespielten Album '''Noch nicht fertig implementiert'''
* currentMusicState - Status des aktuellen/zuletzt verwendeten Mediaplayers
* currentMusicTrack - aktuell abgespielter Musiktitel des verwendeten Mediaplayers
* daydream - on/off, Daydream gestartet oder nicht
* deviceState - Status des Androidgerätes. unknown, online, offline.
* doNotDisturb - aktueller Status des Nicht-Stören-Modus
* dockingState - undocked/docked Status, ob sich das Gerät in einer Dockingstation befindet.
* flow_SetCommands - active/inactive, Status des SetCommands Flow
* flow_informations - active/inactive, Status des Informations Flow
* flowsetVersionAtDevice - aktuell installierte Flowsetversion auf dem Device
* incomingCallerName - Anrufername des eingehenden Anrufes
* incomingCallerNumber - Anrufernummer des eingehenden Anrufes
* incommingWhatsAppMessageFrom - letzte WhatsApp Nachricht
* incommingWhatsTelegramMessageFrom - letzte Telegram Nachricht
* intentRadioName - zuletzt gestreamter Intent Radio Name
* intentRadioState - Status des IntentRadio Players
* keyguardSet - 0/1 Displaysperre gesetzt 0=nein 1=ja, bedeutet nicht, dass sie gerade aktiv ist
* lastSetCommandError - letzte Fehlermeldung vom set Befehl
* lastSetCommandState - letzter Status vom set Befehl, Befehl erfolgreich/nicht erfolgreich gesendet
* lastStatusRequestError - letzte Fehlermeldung vom statusRequest Befehl
* lastStatusRequestState - letzter Status vom statusRequest Befehl, Befehl erfolgreich/nicht erfolgreich gesendet
* nextAlarmDay - aktiver Alarmtag
* nextAlarmState - aktueller Status des "Androidinternen" Weckers
* nextAlarmTime - aktive Alarmzeit
* powerLevel - Status der Batterie in %
* powerPlugged - Netzteil angeschlossen? 1=AC Adapter, 2=USB, 4=Kabellos 0=nicht eingesteckt
* screen - on locked/unlocked, off locked/unlocked gibt an ob der Bildschirm an oder aus ist und gleichzeitig gesperrt oder nicht gesperrt
* screenBrightness - Bildschirmhelligkeit von 0-255
* screenFullscreen - on/off, Vollbildmodus (An,Aus)
* screenOrientation - Landscape,Portrait, Bildschirmausrichtung (Horizontal,Vertikal)
* screenOrientationMode - auto/manual, Modus für die Ausrichtung (Automatisch, Manuell)
* state - aktueller Status
* userFlowState - aktueller Status eines Flows, festgelegt unter dem setUserFlowState Attribut
* volume - Media Lautstärkewert
* volumeNotification - Benachrichtigungs-Lautstärke

Beim Reading checkActivTask muß zuvor der Packagename der zu prüfenden App als Attribut checkActiveTask angegeben werden. Beispiel: attr Nexus10Wohnzimmer checkActiveTask com.android.chrome für den Chrome Browser.

=== Set ===
* activateVoiceInput - aktiviert die Spracheingabe
* bluetooth - on/off, aktiviert/deaktiviert Bluetooth
* clearNotificationBar - All,Automagic, löscht alle Meldungen oder nur die Automagic Meldungen in der Statusleiste
* closeCall - beendet einen laufenden Anruf
* currentFlowsetUpdate - führt ein Flowsetupdate auf dem Device durch
* doNotDisturb - schaltet den Nicht-Stören-Modus: always immer stören, never niemals stören, alarmClockOnly nur Wecker darf stören, onlyImportant nur wichtige Störungen
* installFlowSource - installiert einen Flow auf dem Device, das XML File muss unter /tmp/ liegen und die Endung xml haben. Bsp: set TabletWohnzimmer installFlowSource WlanUebwerwachen.xml
* mediaAmazonMusic - play, stop, next, back ,steuert den Amazon Musik Mediaplayer
* mediaGoogleMusic - play, stop, next, back ,steuert den Google Play Musik Mediaplayer
* mediaSpotifyMusic - play, stop, next, back ,steuert den Spotify Mediaplayer
* mediaTuneinRadio - play, stop, next, back ,steuert den TuneIn Radio Mediaplayer
* mediaAldiMusic - play, stop, next, back ,steuert den Aldi Musik Mediaplayer
* mediaAudible - play, stop, next, back ,steuert den Audible Mediaplayer
* mediaYouTube - play, stop, next, back ,steuert den YouTube Mediaplayer
* mediaVlcPlayer - play, stop, next, back ,steuert den VLC Mediaplayer
* nextAlarmTime - setzt die Alarmzeit. gilt aber nur innerhalb der nächsten 24 h
* openCall - ruft eine Nummer an und legt optional nach X Sekunden auf / set DEVICE openCall 01736458 10 / ruft die Nummer an und beendet den Anruf nach 10s
* screen - on/off/lock/unlock schaltet den Bildschirm ein/aus oder sperrt/entsperrt ihn
* screenBrightness - setzt die Bildschirmhelligkeit, von 0-255.
* screenMsg - versendet eine Bildschirmnachricht
* sendintent - sendet einen Intentstring Bsp: set $AMADDeviceDEVICE sendIntent org.smblott.intentradio.PLAY url http://stream.klassikradio.de/live/mp3-192/stream.klassikradio.de/play.m3u name Klassikradio, der erste Befehl ist die Aktion und der zweite das Extra. Es können immer zwei Extras mitgegeben werden.
* sendSMS - sendet eine SMS an eine bestimmte Telefonnummer. Bsp.: sendSMS Dies ist ein Test|555487263
* startDaydream - startet den Daydream
* statusRequest - Fordert einen neuen Statusreport beim Device an. Es können nicht von allen Readings per statusRequest die Daten geholt werden. Einige wenige geben nur bei Statusänderung ihren Status wieder.
* timer - setzt einen Timer innerhalb der als Standard definierten Clock-App auf dem Device. Es können nur Sekunden angegeben werden.
* ttsMsg - versendet eine Nachricht, die als Sprachnachricht ausgegeben wird
* userFlowState - aktiviert oder deaktiviert einen oder mehrere Flows,'''set Nexus7Wohnzimmer Badezimmer vorheizen:inactive oder set Nexus7Wohnzimmer Badezimmer vorheizen,Nachtlicht Steven:inactive'''
* vibrate - lässt das Androidgerät vibrieren
* volume - setzt die Medialautstärke. Entweder die internen Lautsprecher oder sofern angeschlossen die Bluetoothlautsprecher und per Klinkenstecker angeschlossene Lautsprecher, + oder - vor dem Wert reduziert die aktuelle Lautstärke um den Wert. Der maximale Sliderwert kann über das Attribut setVolMax geregelt werden.
* volumeUp - erhöht die Lautstärke um den angegeben Wert im entsprechenden Attribut. Ist kein Attribut angegeben wird per default 2 genommen.
* volumeDown - reduziert die Lautstärke um den angegeben Wert im entsprechenden Attribut. Ist kein Attribut angegeben wird per default 2 genommen.
* volumeNotification - setzt die Benachrichtigungslautstärke.

==== Set abhängig von gesetzten Attributen ====
* changetoBtDevice - wechselt zu einem anderen Bluetooth Gerät. Attribut setBluetoothDevice muß gesetzt sein. Siehe Hinweis unten!
* notifySndFile - spielt die angegebene Mediadatei auf dem Androidgerät ab. Die aufzurufende Mediadatei sollte sich im Ordner /storage/emulated/0/Notifications/ befinden. Ist dies nicht der Fall kann man über das Attribut setNotifySndFilePath einen Pfad vorgeben.
* openApp - öffnet eine ausgewählte App. Attribut setOpenApp
* openURL - öffnet eine URL im Standardbrowser, sofern kein anderer Browser über das Attribut setOpenUrlBrowser ausgewählt wurde. Bsp: attr Tablet setOpenUrlBrowser de.ozerov.fully|de.ozerov.fully.MainActivity, das erste ist der Package Name und das zweite der Class Name
* setAPSSID - setzt die AccessPoint SSID um ein WLAN sleep zu verhindern
* setScreenOnForTimer ändert die Zeitdauer, die das Display an bleiben soll!
* screenFullscreen - on/off, (aktiviert/deaktiviert) den Vollbildmodus. Attribut setFullscreen
* screenLock - Sperrt den Bildschirm mit Pinabfrage. Attribut setScreenlockPIN - hier die Pin dafür eingeben. Erlaubt sind nur Zahlen. Es müßen mindestens 4, bis max 16 Zeichen verwendet werden.
* screenOrientation - Auto,Landscape,Portait, aktiviert die Bildschirmausrichtung (Automatisch,Horizontal,Vertikal). Attribut setScreenOrientation
* system - setzt Systembefehle ab (nur bei gerootetet Geräten). reboot,shutdown,airplanemodeON (kann nur aktiviert werden) Attribut root, in den Automagic Einstellungen muss "Root Funktion" gesetzt werden
* setNotifySndFilePath - setzt den korrekten Systempfad zur Notifydatei (default ist /storage/emulated/0/Notifications/
* setTtsMsgSpeed - setzt die Sprachgeschwindigkeit bei der Sprachausgabe(Werte zwischen 0.5 bis 4.0 in 0.5er Schritten) default ist 1.0
* setTtsMsgSpeed - setzt die Sprache bei der Sprachausgabe, de oder en (default ist de)
* setVolUpDownStep - setzt den Step für volumeUp und volumeDown
* setVolMax - setzt die maximale Volume Größe für den Slider
* setNotifyVolMax - setzt den maximalen Lautstärkewert für Benachrichtigungslautstärke für den Slider
* setRingSoundVolMax - setzt den maximalen Lautstärkewert für Klingellautstärke für den Slider

'''Um openApp verwenden zu können, muss als Attribut der Package Name der App angegeben werden.

'''Um zwischen Bluetoothgeräten wechseln zu können, muss das Attribut setBluetoothDevice mit folgender Syntax gesetzt werden. attr <DEVICE> BTdeviceName1|MAC,BTDeviceName2|MAC Es muss zwingend darauf geachtet werden, dass beim BTdeviceName kein Leerzeichen vorhanden ist. Am besten zusammen oder mit Unterstrich. Bei der MAC ist darauf zu achten, dass wirklich nach jeder zweiten Zahl ein : steht

** '''Beispiel: attr Nexus10Wohnzimmer setBluetoothDevice Logitech_BT_Adapter|AB:12:CD:34:EF:32,Anker_A3565|GH:56:IJ:78:KL:76

=== state ===
* initialized - Ist der Status kurz nach einem define.
* active - die Geräteinstanz ist im aktiven Status.
* disabled - die Geräteinstanz wurde über das Attribut disable deaktiviert

==Anwendungsbeispiele==
=== Lademanagement ===
Ich habe die Ladegeräte für meine Androidgeräte an Funkschaltsteckdosen. Ein DOIF schaltet bei unter 30% die Steckdose ein und bei über 90% wieder aus.

Hier mal ein einfaches DOIF Beispiel für ein Lademanagment

<code>
... DOIF ([Nexus5Handy:powerLevel] < 30) (set LadenetzteilNexus5Handy:FILTER=STATE=off on) DOELSEIF ([Nexus5Handy:powerLevel] > 90) (set LadenetzteilNexus5Handy:FILTER=STATE=on off) DOELSE
</code>

=== Wecker ===
Morgens lasse ich mich über mein Tablet im Schlafzimmer mit Musik wecken. Verwendet wird hierzu der wakeuptimer des RESIDENTS Modules. Das Abspielen stoppe ich dann von Hand. Danach erfolgt noch eine Ansage wie das Wetter gerade ist und wird.

=== Mediacenter ===
Mein 10" Tablet im Wohnzimmer ist Mediaplayer für das Wohnzimmer mit Bluetoothlautsprechern. Die Lautstärke wird automatisch heruntergesetzt, wenn die Fritzbox einen Anruf auf das Wohnzimmer Handgerät signalisiert.

=== Sprachbefehl - Abfragen von Zuständen diverser Sensoren ===
Wenn ich die Spracheingabe aktiviere und nach der Temperatur im Wohnzimmer frage, bekomme ich diese angesagt.

Der Teil im Feld Daten ist ein klassisches ReadingsVal, halt nur ohne Komma und ohne Anführungszeichen

WIRD GERADE ÜBERARBEITET

=== Schaltbefehle vom Androidgerät an FHEM senden ===
Hierfür ist ein eigener Flow einzurichten. Wie das genau geht, verrät die Hilfe.
Um einen Schaltbefehl für FHEM zu erstellen, folgt nach dem Trigger eine Aktion als Script (Aktion Type: Script). Hier ist folgendes einzutragen:

setcmd = "LichtWohnzimmerLampeRechts on"

fhemcmd = "set"

In der ersten Zeile wird also der Schaltbefehl in der Variablem setcmd eingetragen und in der zweiten Zeile der FHEM Befehl in der Variablen fhemcmd.

Danach müsst Ihr nur noch in einer weiteren Aktion den Flow "Send Data to AMADCommBridge" ausführen (Aktion Type: Flows ausführen). Die Aktion sollte bereits in Eurer Liste Vorhanden sein.

[[Datei:Screenshot_20160717-134948.png|200px]]
[[Datei:Screenshot 17.07.2016 1-50-27.png|200px]]

Nun sollte Lampe1 angeschalten werden, wenn der Flow ausgeführt wird.

=== Mit FHEM ein Flow ausführen ===
In Automagic einen Triggervom Type General Broadcast für den Flow wählen welchen man fern ausführen möchte. In der Trigger Definition steht unter Aktion ''automagic.NameDesFlows'' und auf Wunsch unter Access Intent Extra's ''param1 = getString("label1"); param2 = getString("label2");''. ''NameDesFlows'' ist natürlich die Name des Flows, der kein Leerzeichen enthält. Mit ein FHEM Command 'set ''AMADDevice'' sendIntent ''automagic.namederflow label1 param1 label2 param2''' wird dann der Flow aus geführt.

=== Lister aller Variablen für die AMADCommandBridge ===
fhemcmd Variable
* Wert "set" - Variable für den Schaltbefehl 'setcmd'
* Wert "setreading" - Variable für die Readingswerte 'fhemdata'
* "readingsval" - Variable für die Abfragewerte 'readingsvalcmd'
* "fhemfunc" - Variable für den Funktionsnamen 'fhemsub'

'''Beispiele für Skriptinhalte:'''

Schalten einer Lampe

<code>
setcmd = "LichtWohnzimmerLampeRechts on";

fhemcmd = "set"
</code>

Status eines Device abfragen

<code>
readingsvalcmd = "DEVICE READING DEFAULT";

fhemcmd = "readingsval"
</code>

Die Rückgabevariable, die dann weiter verarbeitet werden kann, heißt '''respreadingsval'''

Aufruf einer 99_myUtils Subroutine

<code>
fhemsub = "mySub()"; oder natürlich auch "mySub('was_auch_immer')"

fhemcmd = "fhemfunc"
</code>

Die Rückgabevariable, die dann weiter verarbeitet werden kann, heißt '''respfhemfunc'''

== Bekannte Meldungen/Hinweise/Probleme ==

Wenn auf dem Android-Gerät die Fehlermeldung 'Accessibility service not running' von Automagic kommt oder im FHEM das reading state 'Flow Informations mit Fehler beendet' steht, dann muss der Accessibility Service auf dem Android-Device aktiviert werden: Einstellungen --> Bedienungshilfen --> Automagic Premium. Hier muss der Schalter auf 'an' stehen. Sollte dies der Fall sein, hilft u.U. ein kurzes Aus- und wieder Einschalten.

Gerät wird oft als offline angezeigt und es können keine set Befehle abgesetzt werden.
Mit der AMAD Version 2.2 hielt eine neue Behandlung des deviceState Readings Einzug. Das Reading stellt nun den tatsächlichen Status des Gerätes gegenüber FHEM da. Bei vielen Android 6 Geräten kommt es aber auf Grund vom DeepSleep Modus zum Wegfall der WLAN Verbindung. Hier hilft die neue KeepAlive Funktion in AMAD. Dafür muß lediglich unter
* Einstellungen --> Akku --> oben auf die drei Punkte - Akku Leistungsoptimierung --> alle Apps und dann Automagic auswählen und "Nicht optimieren"
ausgewählt werden und in FHEM für das Device das Attribut setAPSSID gesetzt werden. Alles andere macht das Modul selbst.

FHEM mit HTTPS SSL-Zertifikat und eine eigene Zertifizierungsstelle

2018-06-26T21:49:08Z

CoolTux: /* Einbinden der root CA in die Zertifizierungsstelle des Browsers */

== Vorwort ==
=== Dein Anliegen ===
Du möchtest FHEM mit HTTPS betreiben, hasst es aber, ständig von Deinem Browser darauf aufmerksam gemacht zu werden, dass dies "keine sichere Verbindung" ist.
Oder Du möchtest einen weiteren Serverdienst aufsetzen, welcher verschlüsselte SSL oder TLS-Verbindungen anbietet (z.B. HTTPS, POP3S, IMAPS, LDAPS, SMTP mit TLS).

=== Die Schwierigkeit dabei ===
Um eine mit SSL/TLS abgesicherte Verbindung anzubieten, benötigst Du ein Serverzertifikat. Dieses muss von einer Zertifizierungsstelle (Certification Authority oder kurz CA) signiert sein.
Ein offizielles Serverzertifikat, welches von einer offiziellen Stelle signiert ist, ist leider nicht kostenlos. Meist werden jährliche Gebühren in Höhe von mehreren hundert Euro fällig.

=== Eine mögliche Lösung ===
Unter Linux kann man mit Bordmitteln eine eigene CA aufsetzen und selbst ein Zertifikate erstellen und signieren. Das ist ein Vorgang von wenigen Minuten. Alle Einzelheiten beschreibt dieser Artikel.
Der einzige Unterschied zu einem von einer anerkannten Stelle signierten Zertifikat ist, dass der Client (Emailprogramm, Browser, etc.) einmalig das root CA importieren muß.

== Genaues Vorgehen ==
=== OpenSSL installieren ===
Für die Verwaltung der Zertifikate und im übrigen auch für die Verschlüsselung der Verbindungen mit SSL und TLS kommt unter Linux fast immer OpenSSL zum Einsatz. Wahrscheinlich ist das auf Deinem Sytem deshalb bereits installiert, wenn nicht, musst Du das Paket openssl nachinstallieren. Du benötigst aus diesem Paket den Kommandozeilenbefehl openssl.

=== Erstellen der CA ===
Lege zunächst ein Verzeichnis an, in dem Du das Zertifikat ablegen willst. Wir nehmen in unserem Beispiel /root/ca:
<source lang="bash">
root@linux# mkdir /root/ca
root@linux# cd /root/ca</source>
Die Gültigkeit setzen wir mit 10 Jahren bewusst sehr hoch an. Läuft die CA aus, so werden nämlich auch alle damit signierten Serverzertifikate ungültig. Die CA enthält einen geheimen Schlüssel, welcher automatisch erzeugt und in der Datei cakey.pem abgelegt wird. Das CA-Zertifikat wird nach cacert.pem geschrieben. Der folgende Befehl erzeugt das einen Schlüssel für das Zertifikat mit einer Länge von 2048 Bit:
<source lang="bash">
root@linux# openssl req -new -x509 -newkey rsa:2048 -keyout cakey.pem -out cacert.pem -days 3650
Generating a 2048 bit RSA private key
..............................................................
..............................................................
.........................................+++
......................................+++
writing new private key to 'cakey.pem'</source>

Wer den geheimen Schlüssel der CA kennt, kann damit beliebige Serverzertifikate signieren. Deshalb wird diese Schlüsseldatei nicht im Klartext auf der Festplatte abgelegt, sondern mit einer Passphrase verschlüsselt. Diese Passphrase benötigst Du immer dann, wenn Du mit der CA neue Zertifikate ausstellen willst:
<nowiki>
Enter PEM pass phrase: sehrlangesgeheimespasswort
Verifying - Enter PEM pass phrase: sehrlangesgeheimespasswort</nowiki>
Nun werden wir gebeten, Daten einzugeben, welche die CA identifizieren. Diese werden dem Client angezeigt, wenn er aufgefordert wird, das Zertifikat zu akzeptieren oder abzulehnen. Der Code für Deutschland ist DE. Wenn Du ein Feld leer lassen möchtest, so gib einen Punkt ein. Ansonsten wird der in eckigen Klammern stehende Defaultwert eingetragen:
<nowiki>
-----
You are about to be asked to enter information that will be incorporated
into your certificate request.
What you are about to enter is what is called a Distinguished Name or a DN.
There are quite a few fields but you can leave some blank
For some fields there will be a default value,
If you enter '.', the field will be left blank.
-----
Country Name (2 letter code) [AU]: DE
State or Province Name (full name) [Some-State]:Brandenburg
Locality Name (eg, city) []:Potsdam
Organization Name (eg, company) [Internet Widgits Pty Ltd]:Familie AG
Organizational Unit Name (eg, section) []:EDV</nowiki>
Das Feld Common Name (CN) ist hier der offizielle Name der Zertifizierungsstelle. Für Dein eigenes CA kannst Du einfach Deinen eigenen Namen eintragen:
<nowiki>
Common Name (eg, YOUR name) []: Cool Tux
Email Address []: cooltux@gmail.tada</nowiki>
Fertig. Folgende zwei Dateien sind entstanden:
<nowiki>
root@linux# ll
insgesamt 9
drwxr-xr-x 2 root root 112 2006-04-30 12:08 .
drwx------ 12 root root 600 2006-04-30 11:54 ..
-rw-r--r-- 1 root root 1212 2006-04-30 12:08 cacert.pem
-rw-r--r-- 1 root root 963 2006-04-30 12:08 cakey.pem</nowiki>
Vorsichtshalber solltest Du die Rechte so setzen, dass die Schlüsseldatei nur für root lesbar ist:
<nowiki>
root@linux# chmod 600 cakey.pem</nowiki>
Du kannst nun ausprobieren, ob Du den Schlüssel mit der Passphrase wieder öffnen kannst:
<nowiki>
root@linux# openssl rsa -in cakey.pem -noout -text
Enter pass phrase for cakey.pem: wrzlprmpft
Private-Key: (1024 bit)
modulus:
00:d5:a5:37:51:e9:d9:fa:e3:97:e7:46:b2:88:1a:
b5:46:80:47:76:14:ae:2b:8b:3e:35:5c:ab:15:84:
53:d9:63:2e:7f:08:4b:ec:77:db:02:45:f8:c7:46:
58:cd:2d:f9:29:4d:96:3d:d8:6c:5d:9f:79:8a:04:
cf:b7:3a:89:da:a9:63:9f:44:b3:83:cf:0d:70:7d:</nowiki>
usw...

=== Schlüssel für das Serverzertifikat erzeugen ===
Nachdem wir nun eine eigene CA haben, kann diese nun endlich für unseren Server ein Zertifikat herausgeben. Dazu erzeugen wir zunächst einen 2048 Bit langen RSA Schlüssel, der mit AES 128 verschlüsselt auf der Platte abgelegt wird (ja wirklich, auch hier wieder ein verschlüsselter Schlüssel). Die Passphrase muss diesmal nicht sonderlich geheim sein, da wir sie ohnehin im Anschluss wieder entfernen werden. OpenSSL lässt allerdings keine leere Phrase zu:
<source lang="bash">
root@linux# openssl genrsa -out serverkey.pem -aes128 2048 -days 3650
Generating RSA private key, 2048 bit long modulus
....+++
.......................................+++
e is 65537 (0x10001)
Enter pass phrase for serverkey.pem: test
Verifying - Enter pass phrase for serverkey.pem: test</source>
So. Nun entfernen wir die Passphrase wieder. Warum? Der Serverdienst (Apache, Cyrus, etc.) muss schließlich in der Lage sein, den Schlüssel ohne Dein Zutun zu lesen. Oder möchtest Du bei jedem Booten des Servers ein Passwort eingeben müssen?
<source lang="bash">
root@linux# openssl rsa -in serverkey.pem -out serverkey.pem
Enter pass phrase for serverkey.pem: jaja
writing RSA key</source>

=== Certificate Signing Request erzeugen ===
Der nächste Schritt zum eigenen Zertifikat ist ein CSR. Dies muss dann nur noch von der CA signiert werden. Hier sind wieder Angaben analog zum Erstellen der CA nötig, was oft Verwirrung stiftet. Die allgemeinen Daten kann man ggfl. gleich wie oben eingeben:
<source lang="bash">
root@linux# openssl req -new -key serverkey.pem -out req.pem -nodes
You are about to be asked to enter information that will be incorporated
into your certificate request.
What you are about to enter is what is called a Distinguished Name or a DN.
There are quite a few fields but you can leave some blank
For some fields there will be a default value,
If you enter '.', the field will be left blank.
-----
Country Name (2 letter code) [AU]: DE
State or Province Name (full name) [Some-State]:Brandenburg
Locality Name (eg, city) []:Potsdam
Organization Name (eg, company) [Internet Widgits Pty Ltd]:Familie AG
Organizational Unit Name (eg, section) []:EDV</source>
ACHTUNG, jetzt kommt das Wichtige: Beim Serverzertifikat ist der Common Name von entscheidender Bedeutung. Hier muss der DNS-Name stehen, unter dem der Client den Server anspricht! Wird das Zertifikat für eine HTTPS-Verbindung zu fhem.local verwendet, so muss der Common Name eben genau fhem.local heißen. Anderfalls wird der Browser das Zertifikat nicht akzeptieren, da er davon ausgehen muss, auf dem falschen Server gelandet zu sein.
<nowiki>
Common Name (eg, YOUR name) []: fhem.local
Email Address []: admin.fhem.local</nowiki>
Weitere Optionen kann man einfach leer lassen:
<nowiki>
A challenge password []:
An optional company name []:</nowiki>
Mittlerweile tummeln sich schon vier Dateien in unserem Verzeichnis:
<source lang="bash">
root@linux# ll
insgesamt 17
drwxr-xr-x 2 root root 168 2006-04-30 12:29 .
drwx------ 12 root root 600 2006-04-30 11:54 ..
-rw-r--r-- 1 root root 1212 2006-04-30 12:08 cacert.pem
-rw------- 1 root root 963 2006-04-30 12:08 cakey.pem
-rw-r--r-- 1 root root 1017 2006-04-30 12:29 req.pem
-rw-r--r-- 1 root root 1679 2006-04-30 12:21 serverkey.pem</source>

=== OpenSSL-Konfiguration anpassen ===
Leider kann man bei OpenSSL nicht alle Daten als Kommandozeilenargumente übergeben. Einige Einstellungen muss man lästigerweise in der Datei /etc/ssl/openssl.cnf ändern, bevor man signieren kann. Öffne diese Datei und passe folgende Zeilen in der Sektion [ CA_default ] an:
<source lang="bash">
/etc/ssl/openssl.cnf:
dir = . # Where everything is kept
new_certs_dir = $dir # default place for new certs
private_key = $dir/cakey.pem # The private key
RANDFILE = $dir/.rand # private random number file
default_days = 3650 # how long to certify for</source>
Das Feld default_days ist auf 365 Tage voreingestellt und gibt die Gültigkeit des Zertifikates an. Abgelaufene Zertifikate sind im Übrigen ein sehr häufiges Problem. Wenn es soweit ist, kennt sich damit nämlich schon lange keiner mehr aus. Deswegen kannst Du wie im Beispiel angegeben die Lebensdauer z.B. auf 10 Jahre heraufsetzen.

Nun muss man noch einige Dateien anlegen:
<source lang="bash">
root@linux# echo 01 > serial
root@linux# touch index.txt</source>

=== Serverzertifikat signieren ===
Kommen wir zum feierlichen Abschluss: Unsere CA signiert nun das Zertifikat:
<source lang="bash">
root@linux# openssl ca -in req.pem -notext -out servercert.pem
Enter pass phrase for ./cakey.pem: langesgeheimespasswort

...

Certificate is to be certified until Apr 27 10:45:36 2016 GMT (3650 days)
Sign the certificate? [y/n]: y

1 out of 1 certificate requests certified, commit? [y/n] y
Write out database with 1 new entries
Data Base Updated</source>

=== Zertifikate installieren ===
Wie Du das Zertifikat in FHEM installierst, findest Du [[Raspberry_Pi_%26_HTTPS|hier]] und wenn Du ein Server Zertifikat für NGINX installieren möchtest, findest Du Infos dazu [[HTTPS-Absicherung_%26_Authentifizierung_via_nginx_Webserver|hier]]

== Nachwort ==
=== Einbinden der root CA in die Zertifizierungsstelle des Browsers ===
Beim Firefox importieren wir unsere cacert.pem unter Einstellungen -> Erweitert -> Zertifikate -> Zertifikate anzeigen -> Zertifizierungsstellen ein.
Unter Chrome/Chromium finden wir die Zertifikatsverwaltung unter Einstellungen -> Erweitert -> Zertifikate verwalten HTTPS/SSL-Zertifikate und -Einstellungen verwalten -> Zertifizierungsstellen

=== Bekannte Probleme ===
Für den Chrome/Chromium müssen wir zusätzlich "Subject Alternative Names (SAN)" in unser Zertifikat eintragen. Dies geschieht beim Serverzertifikat signieren. Dazu müssen wir uns eine weitere Datei anlegen:
<source lang="bash">
root@linux# vim oats.extensions.cnf

basicConstraints=CA:FALSE
subjectAltName=@my_subject_alt_names
subjectKeyIdentifier = hash

[ my_subject_alt_names ]
DNS.1 = fhem01.tuxnet.local
DNS.2 = fhem02.tuxnet.local
DNS.3 = fhem01-vpn.tuxnet.local</source>
Die Signierung unseres Serverzertifikates erfolgt dann mit folgendem Befehl:
<source lang="bash">
openssl ca -in req.pem -notext -extfile oats.extensions.cnf -out servercert.pem</source>

=== Prüfen von Zertifikaten ===
Zertifikate kann man im übrigen auf dieser [https://www.networking4all.com/en/ssl+certificates/csr+check/| Seite] prüfen lassen.
Dazu kopiert man den Inhalt der servercert.pem in das Eingabefeld der Seite und klickt dann auf Check CSR.

[[Kategorie:HOWTOS]]

GardenaSmartBridge

2018-04-09T06:55:18Z

CoolTux:

{{Infobox Modul
|ModPurpose=GardenaSmartBridge
|ModType=d
|ModForumArea=
|ModFTopic=75098
|ModTechName=73_GardenaSmartBridge.pm
|ModOwner={{Link2FU|13684|CoolTux}}
}}

Das Modul GardenaSmartBridge stellt zusammen mit dem Device [[GardenaSmartDevice]] die Kommunikation zwischen der '''Gardena Cloud''' und FHEM her.
Es können damit Rasenmäher, Bewässerungscomputer und Sensoren überwacht und gesteuert werden, die Steuerung erfolgt durch das Modul [[GardenaSmartDevice]].
''Informationen zum [[GardenaSmartSystem]]''

== Voraussetzungen ==
* Perl-Modul "SSL Packet"
* Internetanbinung
* Netzwerk mit W-Lan oder LAN (RJ45)
* Smart Gateway von Gardena
* Account bei [https://sg-api.dss.husqvarnagroup.net/ Gardena]
* Smart Produkte von Gardena [[GardenaSmartSystem]]

== Anwendung ==
=== Define ===
<code> define <NAME> GardenaSmartBridge </code>

==== Beispiel ====
<code> define myGardenaBridge GardenaSmartBridge </code>

Diese Anweisung erstellt ein neues GardenaSmartBridge Device Namens myGardenaBridge.
Im folgendem wird automatisch ein neuer Raum ''GardenaSmart'' erstellt und nach setzen des Attributes gardenaAccountEmail und einem <code>set myGardenaBridge gardenaAccountPassword</code> alle dem [https://sg-api.dss.husqvarnagroup.net/ Gardena] Account bekannten Geräte
angelegt.

=== Attribute ===
* debugJSON -
* disable - aktivieren & deaktivieren der Bridge (0= aktiviert, 1= deaktiviert)
* interval - Abfrageinterval in Minuten (5= default)
* gardenaAccountEmail - Email Adresse, die auch in der GardenaApp verwendet wurde

=== Readings ===

* address - bei Gardena verwendete Adresse
* city - bei Gardena hinterlegte Stadt
* devices - Anzahl der angelernten/verwendeten Geräte incl. des Gateways
* latitude - Längengrad
* longitude - Breitengrad
* name - Name des Gartens ''(Standard "MY GARDEN")''
* state - Status der Bridge (connect to cloud= Verbunden mit der Cloud)
* token - SessionID

== Anwendungsbeispiele ==

== Bekannte Probleme ==
* keine

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

[[Kategorie:Gerätemodul]]

XiaomiBTLESens

2018-03-30T07:44:20Z

CoolTux: /* Attribute */

{{Infobox Modul
|ModPurpose=Auslesen unterstützter Xiaomi BTLE Sensoren
|ModType=d
|ModForumArea=Sonstige Systeme
|ModTechName=74_XiaomiBTLESens.pm
|ModOwner=CoolTux ({{Link2FU|13684|Forum}} / [[Benutzer:CoolTux|Wiki]])
}}

==Beschreibung==
Mit diesem Modul ist es möglich, diverse BTLE Sensoren der Firma Xiaomi auszulesen und die entsprechenden Daten als Readings darzustellen, z. B. den XiaomiFlowerMonitor (XiaomiFlowerSens).
{{Hinweis|Das Modul ist der Nachfolger und eine Verallgemeinerung des '''''bisherigen Moduls XiaomiFlowerSens''''' (74_XiaomiFlowerSens). Letzteres ist weiter erreichbar, wird aber nicht mehr weiterentwickelt oder fehlerbereinigt.}}

== Voraussetzung zur Verwendung des Modules ==
Auf dem Rechner wird
* libjson-perl
* bluez (gatttool und hcitool)
vorausgesetzt.

Für die Konfiguration wird die Bluetooth-Adresse (BT-MAC) des jeweiligen Sensors benötigt, die mit Hilfe von
<code>hcitool lescan</code>
aus der Liste der vom Rechner erkannten aktiven Bluetooth Low Energy Geräten der Umgebung herausgefunden werden kann. Die Identifikation eines konkreten Sensors kann durch Vergleich der Liste mit und ohne aktivem Sensor (Batterie entfernen!) geschehen.
{{Hinweis|Auf einem Debian Wheezy scheint es Probleme mit dem Bluetooth Stack zu geben. Selbst wenn man ein aktuelles BT 5.x selbst kompiliert und installiert gibt spätestens das gatttool keine Daten mehr aus. Es sollte daher unbedingt auf Debian Jessie gewechselt werden (empfohlen wird eine Neuinstallation).}}

==Definition==
<code>define <name> XiaomiBTLESens <BT-MAC></code>

'''Beispiel:'''
:<code>define Weihnachtskaktus XiaomiBTLESens C4:7C:8D:62:42:6F</code>

Diese Anweisung erstellt ein XiaomiBTLESens Device mit dem Namen Weihnachtskaktus und der BT-MAC C4:7C:8D:62:42:6F.
Als nächstes sollte auf jeden Fall das Attribut model gesetzt werden, um das korrekte Gerät anzusprechen.

==Readings==
* state - aktueller Status des Device.
* battery - Status der Batterie in Abhängigkeit des batteryLevel Readings.
* batteryLevel - Füllstand der Batterie in Prozent.
* fertility - Nährstoffgehalt des Pflanzenbodens (Dünger) - Bodenleitfähigkeit
* firmware - aktuelle Firmware auf dem Device
* lux - aktuelle Lichtintensität
* moisture - Wassergehalt (Feuchtigkeit) des Pflanzenbodens
* temperature - Umgebungstemperatur

==Set==
* devicename - setzt einen Devicenamen

==Get==
* sensorData - aktive Abfrage der Sensors Werte
* devicename - liest den Devicenamen aus
* firmware - liest die Firmeware aus

==Attribute==
* interval - Intervallzeit in Sekunden, nach der der nächste automatische Datenabruf erfolgen soll
* model - Auswahl eines unterstützten Gerätes
* disable - deaktiviert die Kommunikation mit dem Gerät, den Abruf von Daten
* disabledForIntervals - deaktiviert das Gerät für den angegebenen Zeitintervall (13:00-18:30 or 13:00-18:30 22:00-23:00)
* minFertility - min. Fruchtbarkeits-Grenzwert für ein Ereignis minFertility low
* maxFertility - max. Fruchtbarkeits-Grenzwert für ein Ereignis maxFertility high
* minMoisture - min. Feuchtigkeits-Grenzwert für ein Ereignis minMoisture low
* maxMoisture - max. Feuchtigkeits-Grenzwert für ein Ereignis maxMoisture high
* minTemp - min. Temperatur-Grenzwert für ein Ereignis minTemp low
* maxTemp - max. Temperatur-Grenzwert für ein Ereignis maxTemp high
* minlux - min. Helligkeits-Grenzwert für ein Ereignis minlux low
* maxlux - max. Helligkeits-Grenzwert für ein Ereignis maxlux high
*:Beispiele für min/max-Ereignisse:
*::2017-03-16 11:08:05 XiaomiFlowerSens Dracaena minMoisture low
*::2017-03-16 11:08:06 XiaomiFlowerSens Dracaena maxTemp high
* sshHost - FQDN oder IP-Adresse eines entfernten SSH-Systems. Das SSH-System ist auf Keyfile basierte Authentifizierung zu konfigurieren. Am elegantesten geschieht das mit einer .ssh/config Datei auf dem SSH-Client.

AMAD

2018-01-27T11:04:47Z

CoolTux: /* Readings */

{{Infobox Modul
|ModPurpose=Steuern von Androidgeräten und Anzeige von bestimmten Informationen dieser Geräte
|ModType=d
|ModForumArea=Sonstige Systeme
|ModTechName=73_AMADCommBridge.pm, 74_AMADDevice.pm
|ModOwner=CoolTux ([http://forum.fhem.de/index.php?action=profile;u=13684 Forum] / [[Benutzer:CoolTux|Wiki]])
}}

= AMAD 4.0 [AMADNG] =
== 73_AMADCommBridge / 74_AMADDevice ==

= Vorwort =
=== Warum AMADNG ===
Nach fast 6 Monaten Entwicklungszeit wurde die neuste AMAD Version am 24.07.2017 offiziell frei gegeben. Diesmal lagen mir mehrere Dinge am Herzen.
In erster Linie wollte ich eine softwareseitige Trennung der AMADCommBridge vom eigentlichen Android Device. Daher ist die neue Version ein zweistufiges Modul geworden.
Im Laufe der Entwicklung kamen auch andere Anforderungen hinzu, die ich dann fähig war umzusetzen. Eine dieser Anforderungen war eine einfachere und besser funktionierende Installation. Herausgekommen ist ein Android Installationsassistant.
Mit ihm wird auf einfache Art und Weise direkt per Sprachführung und Eingabedialogen Automagic für AMAD konfiguriert und das Device in FHEM automatisch erstellt. Es ist darauf zu achten, das Autocreate aktiv ist, da sonst kein Device mit Hilfe des Assistenten angelegt werden kann!

= Vorstellung =
Dieses 2-stufige Modul liefert, '''in Verbindung mit der Android App Automagic''', diverse Informationen von Android Geräten.
Die AndroidAPP Automagic (die nicht von mir stammt und 2.90 Euro kostet) funktioniert wie Tasker, ist aber bei weitem benutzungsfreundlicher.

=== Features / Funktionen ===
Im Auslieferungszustand werden folgende Zustände dargestellt:
* installierte Android Version
* Zustand von Automagic auf dem Gerät
* Spracheingabe
* Bluetooth An/Aus
* Zustand einer definierten App (läuft aktiv im Vordergrund oder nicht?)
* verbundene Bluetoothgeräte, inklusive deren MAC Adresse
* aktuell abgespieltes Musikalbum des verwendeten Mediaplayers
* aktuell abgespielter Musikinterpret des verwendeten Mediaplayers
* aktuell abgespielter Musiktitel des verwendeten Mediaplayers
* Status des Androidgerätes - Online/Offline
* nächster Alarmtag
* nächste Alarmzeit
* Batteriestatus in %
* Ladestatus - Netztei angeschlossen / nicht angeschlossen
* Bildschirmstatus An/Aus
* Bildschirmhelligkeit
* Vollbildmodus An/Aus
* Bildschirmausrichtung Auto/Landscape/Portrait
* Standardlautstärke
* Media Lautstärke
* ...

Mit etwas Einarbeitung können jegliche Informationen, die Automagic bereit stellt, in FHEM angezeigt werden. Hierzu bedarf es lediglich eines eigenen Flows, der seine Daten an die AMADCommBridge sendet. Das Modul gibt auch die Möglichkeit Androidgeräte zu steuern.

= AMADCommBridge - Kommunikationsbrücke für alle AMAD Geräte =
Dieses Modul ist das Ausgangsmodul zur erfolgreichen Integration von Androidgeräten in FHEM. Es stellt ferner eine Verbindungsebene zwischen AMAD unterstützten Geräten und FHEM zur Verfügung. Alle Kommunikation zwischen AMAD Android und FHEM läuft über diese Schnittstelle.
Daher erfolgt die Ersteinrichtung eines AMAD Devices auch genau über diese Modulinstanz.

Damit erfolgreich ein Androidgerät in FHEM eingerichtet werden kann, muss im ersten Schritt ein AMADCommBridge Device angelegt werden.

=== Definition in FHEM ===

<code>define <name> AMADCommBridge</code>

==== Beispiel ====

<code>define AMADBridge AMADCommBridge</code>

Diese Anweisung erstellt ein neues AMADCommBridge Device namens AMADBridge.

Im folgenden muß lediglich das Flowset auf dem Android Gerät installiert werden und der Flow 'First Run Assistent' ausgeführt werden. (einfach den Homebutton drücken)
Der Assistent geleitet dann durch die Einrichtung des AMAD Gerätes und sorgt dafür, dass am Ende des Installationsprozess das Androidgerät als AMAD Device in FHEM angelegt wird.

=== Readings ===
* JSON_ERROR - JSON Fehlermeldung, die von Perl gemeldet wird
* JSON_ERROR_STRING - der String, der die JSON Fehlermeldung verursacht hat
* fhemServerIP - die Ip-Adresse des FHEM Servers; wird vom Modul auf Basis des JSON Strings vom Installationsassistenten gesetzt. Kann aber auch mittels set Befehles vom User gesetzt werden
* receiveFhemCommand - ist das Attribut fhemControlMode auf trigger gestellt, wird das Reading gesetzt sobald ein FHEM Befehl übersendet wird. Hierauf kann dann ein Notify triggern. Wird anstelle von trigger setControl als Wert für fhemControlMode eingestellt, wird das Reading nicht gesetzt sondern der set Befehl sofort ausgeführt.
* receiveVoiceCommand - wird die Sprachsteuerung von AMAD aktiviert (set DEVICE activateVoiceInput) so wird der letzte erkannten Sprachbefehle in dieses Reading geschrieben.
* receiveVoiceDevice - Name des Devices von wo aus der letzte erkannte Sprachbefehl gesendet wurde
* state - Status der Bridge, open, closed

=== Attribute ===
* allowFrom - Regexp der erlaubten IP-Adressen oder Hostnamen. Wenn dieses Attribut gesetzt wurde, werden ausschließlich Verbindungen von diesen Adressen akzeptiert. Achtung: falls allowfrom nicht gesetzt ist, und keine gütige allowed Instanz definiert ist, und die Gegenstelle eine nicht lokale Adresse hat, dann wird die Verbindung abgewiesen. Folgende Adressen werden als local betrachtet: IPV4: 127/8, 10/8, 192.168/16, 172.16/10, 169.254/16, IPV6: ::1, fe80/10
* debugJSON - wenn auf 1 gesetzt, werden JSON Fehlermeldungen in Readings geschrieben. Siehe hierzu JSON_ERROR* unter Readings
* fhemControlMode - steuert die zulässige Art der Steuerung von FHEM Devices. Es können über die Bridge auf 2 Arten FHEM-Devices angesteuert werden: per direktem FHEM-Befehl aus einem Flow heraus oder als Sprachbefehl mittels Sprachsteuerung (set DEVICE activateVoiceInput)
** trigger - ist der Wert trigger gesetzt, werden alle an die Bridge gesendeten FHEM set Befehle in das Reading receiveFhemCommand geschrieben und können so mittels notify ausgeführt werden. Sprachsteuerung ist möglich, es werden Readings receiveVoice* gesetzt. Auf dem Androidgerät können bei Sprachsteuerung mehrere Sprachbefehle mittels "und" verknüpft/aneinander gereiht werden. Bsp: schalte die Lichtszene Abends an und schalte den Fernseher an
** setControl - alle set Befehle, die mittels eines Flows über die Bridge gesendet werden, werden automatisch ausgeführt. Das Triggern eines Readings ist nicht nötig. Die Steuerung mittels Sprache verhält sich wie beim Wert trigger
** thirdPartControl - verhält sich wie trigger, bei der Sprachsteuerung ist jedoch ein Anreihen von Sprachbefehlen mittels "und" nicht möglich. Dient der Sprachsteuerung über Module anderer Modulautoren ((z.B. 39_TEERKO.pm)

= AMADDevice - Automagic Android Device =
Dieses Modul liefert, in Verbindung mit der Android APP Automagic, diverse Informationen von Android Geräten. Die Android App Automagic (die nicht von mir stammt und 2.90 Euro kostet) funktioniert wie Tasker, ist aber bei weitem User freundlicher.
Mit etwas Einarbeitung können jegliche Informationen, die Automagic bereit stellt in FHEM angezeigt werden. Hierzu bedarf es lediglich eines eigenen Flows, der seine Daten an die AMADDeviceCommBridge sendet. Das Modul gibt auch die Möglichkeit Androidgeräte zu steuern.
Für all diese Aktionen und Informationen wird auf dem Androidgerät "Automagic" und ein so genannter Flow benötigt. Die App ist über den Google PlayStore zu beziehen. Das benötigte Flowset bekommt man aus dem FHEM Verzeichnis.

=== Wie genau verwendet man nun AMADDevice? ===
* sicherstellen, dass als allererstes die AMADCommBridge in FHEM definiert wurde
* installieren der App "Automagic Premium" aus dem PlayStore
* installieren des Flowset 74_AMADDeviceautomagicFlowset$VERSION.xml aus dem Ordner $INSTALLFHEM/FHEM/lib/ auf dem Androidgerät
* aktivieren des Installationsassistanten Flow in Automagic. Wenn man nun Automagic in den Hintergrund schickt, z.B. Hometaste drücken, startet der Assistant und legt automatisch ein Device für das Androidgerät an.

=== Ein AMADDevice Gerät von Hand anlegen. ===

Define

<code>define <name> AMADDevice <IP-ADRESSE> <AMAD_ID> IODev=<IODEVICE> </code>

==== Beispiel ====

<code>define WandTabletWohnzimmer AMADDevice 192.168.0.23 123456 IODev=NAME_des_AMADCommBridge_Devices</code>

In diesem Fall wird ein AMADDevice von Hand angelegt. Die AMAD_ID, hier 123456, muß auch exakt so als globale Variable in Automagic eingetragen sein.

=== Readings ===
* airplanemode - Status des Flugmodus
* androidVersion - aktuell installierte Androidversion
* automagicState - Statusmeldungen von der Automagic App '''(Voraussetzung Android >4.3). Ist Android größer 4.3 vorhanden und im Reading steht "wird nicht unterstützt", muss in den Androideinstellungen unter Ton und Benachrichtigungen -> Benachrichtigungszugriff ein Haken für Automagic gesetzt werden'''
* batteryHealth - Zustand der Battery (1=unbekannt, 2=gut, 3=überhitzt, 4=tot, 5=Überspannung, 6=unbekannter Fehler, 7=kalt)
* batterytemperature - Temperatur der Batterie
* bluetooth - on/off, Bluetooth Status an oder aus
* checkActiveTask - Zustand einer zuvor definierten App. 0=nicht aktiv oder nicht aktiv im Vordergrund, 1=aktiv im Vordergrund, '''siehe Hinweis unten'''
* connectedBTdevices - eine Liste der verbundenen Gerät
* connectedBTdevicesMAC - eine Liste der MAC Adressen aller verbundender BT Geräte
* currentMusicAlbum - aktuell abgespieltes Musikalbum des verwendeten Mediaplayers
* currentMusicApp - aktuell verwendeter Mediaplayer (Amazon Music, Google Play Music, Google Play Video, Spotify, YouTube, TuneIn Player, Aldi Life Music)
* currentMusicArtist - aktuell abgespielter Musikinterpret des verwendeten Mediaplayers
* currentMusicIcon - Cover vom aktuell abgespielten Album '''Noch nicht fertig implementiert'''
* currentMusicState - Status des aktuellen/zuletzt verwendeten Mediaplayers
* currentMusicTrack - aktuell abgespielter Musiktitel des verwendeten Mediaplayers
* daydream - on/off, Daydream gestartet oder nicht
* deviceState - Status des Androidgerätes. unknown, online, offline.
* doNotDisturb - aktueller Status des Nicht-Stören-Modus
* dockingState - undocked/docked Status, ob sich das Gerät in einer Dockingstation befindet.
* flow_SetCommands - active/inactive, Status des SetCommands Flow
* flow_informations - active/inactive, Status des Informations Flow
* flowsetVersionAtDevice - aktuell installierte Flowsetversion auf dem Device
* incomingCallerName - Anrufername des eingehenden Anrufes
* incomingCallerNumber - Anrufernummer des eingehenden Anrufes
* incommingWhatsAppMessageFrom - letzte WhatsApp Nachricht
* incommingWhatsTelegramMessageFrom - letzte Telegram Nachricht
* intentRadioName - zuletzt gestreamter Intent Radio Name
* intentRadioState - Status des IntentRadio Players
* keyguardSet - 0/1 Displaysperre gesetzt 0=nein 1=ja, bedeutet nicht, dass sie gerade aktiv ist
* lastSetCommandError - letzte Fehlermeldung vom set Befehl
* lastSetCommandState - letzter Status vom set Befehl, Befehl erfolgreich/nicht erfolgreich gesendet
* lastStatusRequestError - letzte Fehlermeldung vom statusRequest Befehl
* lastStatusRequestState - letzter Status vom statusRequest Befehl, Befehl erfolgreich/nicht erfolgreich gesendet
* nextAlarmDay - aktiver Alarmtag
* nextAlarmState - aktueller Status des "Androidinternen" Weckers
* nextAlarmTime - aktive Alarmzeit
* powerLevel - Status der Batterie in %
* powerPlugged - Netzteil angeschlossen? 1=AC Adapter, 2=USB, 4=Kabellos 0=nicht eingesteckt
* screen - on locked/unlocked, off locked/unlocked gibt an ob der Bildschirm an oder aus ist und gleichzeitig gesperrt oder nicht gesperrt
* screenBrightness - Bildschirmhelligkeit von 0-255
* screenFullscreen - on/off, Vollbildmodus (An,Aus)
* screenOrientation - Landscape,Portrait, Bildschirmausrichtung (Horizontal,Vertikal)
* screenOrientationMode - auto/manual, Modus für die Ausrichtung (Automatisch, Manuell)
* state - aktueller Status
* userFlowState - aktueller Status eines Flows, festgelegt unter dem setUserFlowState Attribut
* volume - Media Lautstärkewert
* volumeNotification - Benachrichtigungs-Lautstärke

Beim Reading checkActivTask muß zuvor der Packagename der zu prüfenden App als Attribut checkActiveTask angegeben werden. Beispiel: attr Nexus10Wohnzimmer checkActiveTask com.android.chrome für den Chrome Browser.

=== Set ===
* activateVoiceInput - aktiviert die Spracheingabe
* bluetooth - on/off, aktiviert/deaktiviert Bluetooth
* clearNotificationBar - All,Automagic, löscht alle Meldungen oder nur die Automagic Meldungen in der Statusleiste
* closeCall - beendet einen laufenden Anruf
* currentFlowsetUpdate - führt ein Flowsetupdate auf dem Device durch
* doNotDisturb - schaltet den Nicht-Stören-Modus: always immer stören, never niemals stören, alarmClockOnly nur Wecker darf stören, onlyImportant nur wichtige Störungen
* installFlowSource - installiert einen Flow auf dem Device, das XML File muss unter /tmp/ liegen und die Endung xml haben. Bsp: set TabletWohnzimmer installFlowSource WlanUebwerwachen.xml
* mediaAmazonMusic - play, stop, next, back ,steuert den Amazon Musik Mediaplayer
* mediaGoogleMusic - play, stop, next, back ,steuert den Google Play Musik Mediaplayer
* mediaSpotifyMusic - play, stop, next, back ,steuert den Spotify Mediaplayer
* mediaTuneinRadio - play, stop, next, back ,steuert den TuneIn Radio Mediaplayer
* mediaAldiMusic - play, stop, next, back ,steuert den Aldi Musik Mediaplayer
* mediaAudible - play, stop, next, back ,steuert den Audible Mediaplayer
* mediaYouTube - play, stop, next, back ,steuert den YouTube Mediaplayer
* mediaVlcPlayer - play, stop, next, back ,steuert den VLC Mediaplayer
* nextAlarmTime - setzt die Alarmzeit. gilt aber nur innerhalb der nächsten 24 h
* openCall - ruft eine Nummer an und legt optional nach X Sekunden auf / set DEVICE openCall 01736458 10 / ruft die Nummer an und beendet den Anruf nach 10s
* screen - on/off/lock/unlock schaltet den Bildschirm ein/aus oder sperrt/entsperrt ihn
* screenBrightness - setzt die Bildschirmhelligkeit, von 0-255.
* screenMsg - versendet eine Bildschirmnachricht
* sendintent - sendet einen Intentstring Bsp: set $AMADDeviceDEVICE sendIntent org.smblott.intentradio.PLAY url http://stream.klassikradio.de/live/mp3-192/stream.klassikradio.de/play.m3u name Klassikradio, der erste Befehl ist die Aktion und der zweite das Extra. Es können immer zwei Extras mitgegeben werden.
* sendSMS - sendet eine SMS an eine bestimmte Telefonnummer. Bsp.: sendSMS Dies ist ein Test|555487263
* startDaydream - startet den Daydream
* statusRequest - Fordert einen neuen Statusreport beim Device an. Es können nicht von allen Readings per statusRequest die Daten geholt werden. Einige wenige geben nur bei Statusänderung ihren Status wieder.
* timer - setzt einen Timer innerhalb der als Standard definierten Clock-App auf dem Device. Es können nur Sekunden angegeben werden.
* ttsMsg - versendet eine Nachricht, die als Sprachnachricht ausgegeben wird
* userFlowState - aktiviert oder deaktiviert einen oder mehrere Flows,'''set Nexus7Wohnzimmer Badezimmer vorheizen:inactive oder set Nexus7Wohnzimmer Badezimmer vorheizen,Nachtlicht Steven:inactive'''
* vibrate - lässt das Androidgerät vibrieren
* volume - setzt die Medialautstärke. Entweder die internen Lautsprecher oder sofern angeschlossen die Bluetoothlautsprecher und per Klinkenstecker angeschlossene Lautsprecher, + oder - vor dem Wert reduziert die aktuelle Lautstärke um den Wert. Der maximale Sliderwert kann über das Attribut setVolMax geregelt werden.
* volumeUp - erhöht die Lautstärke um den angegeben Wert im entsprechenden Attribut. Ist kein Attribut angegeben wird per default 2 genommen.
* volumeDown - reduziert die Lautstärke um den angegeben Wert im entsprechenden Attribut. Ist kein Attribut angegeben wird per default 2 genommen.
* volumeNotification - setzt die Benachrichtigungslautstärke.

==== Set abhängig von gesetzten Attributen ====
* changetoBtDevice - wechselt zu einem anderen Bluetooth Gerät. Attribut setBluetoothDevice muß gesetzt sein. Siehe Hinweis unten!
* notifySndFile - spielt die angegebene Mediadatei auf dem Androidgerät ab. Die aufzurufende Mediadatei sollte sich im Ordner /storage/emulated/0/Notifications/ befinden. Ist dies nicht der Fall kann man über das Attribut setNotifySndFilePath einen Pfad vorgeben.
* openApp - öffnet eine ausgewählte App. Attribut setOpenApp
* openURL - öffnet eine URL im Standardbrowser, sofern kein anderer Browser über das Attribut setOpenUrlBrowser ausgewählt wurde. Bsp: attr Tablet setOpenUrlBrowser de.ozerov.fully|de.ozerov.fully.MainActivity, das erste ist der Package Name und das zweite der Class Name
* setAPSSID - setzt die AccessPoint SSID um ein WLAN sleep zu verhindern
* setScreenOnForTimer ändert die Zeitdauer, die das Display an bleiben soll!
* screenFullscreen - on/off, (aktiviert/deaktiviert) den Vollbildmodus. Attribut setFullscreen
* screenLock - Sperrt den Bildschirm mit Pinabfrage. Attribut setScreenlockPIN - hier die Pin dafür eingeben. Erlaubt sind nur Zahlen. Es müßen mindestens 4, bis max 16 Zeichen verwendet werden.
* screenOrientation - Auto,Landscape,Portait, aktiviert die Bildschirmausrichtung (Automatisch,Horizontal,Vertikal). Attribut setScreenOrientation
* system - setzt Systembefehle ab (nur bei gerootetet Geräten). reboot,shutdown,airplanemodeON (kann nur aktiviert werden) Attribut root, in den Automagic Einstellungen muss "Root Funktion" gesetzt werden
* setNotifySndFilePath - setzt den korrekten Systempfad zur Notifydatei (default ist /storage/emulated/0/Notifications/
* setTtsMsgSpeed - setzt die Sprachgeschwindigkeit bei der Sprachausgabe(Werte zwischen 0.5 bis 4.0 in 0.5er Schritten) default ist 1.0
* setTtsMsgSpeed - setzt die Sprache bei der Sprachausgabe, de oder en (default ist de)
* setVolUpDownStep - setzt den Step für volumeUp und volumeDown
* setVolMax - setzt die maximale Volume Größe für den Slider
* setNotifyVolMax - setzt den maximalen Lautstärkewert für Benachrichtigungslautstärke für den Slider
* setRingSoundVolMax - setzt den maximalen Lautstärkewert für Klingellautstärke für den Slider

'''Um openApp verwenden zu können, muss als Attribut der Package Name der App angegeben werden.

'''Um zwischen Bluetoothgeräten wechseln zu können, muss das Attribut setBluetoothDevice mit folgender Syntax gesetzt werden. attr <DEVICE> BTdeviceName1|MAC,BTDeviceName2|MAC Es muss zwingend darauf geachtet werden, dass beim BTdeviceName kein Leerzeichen vorhanden ist. Am besten zusammen oder mit Unterstrich. Bei der MAC ist darauf zu achten, dass wirklich nach jeder zweiten Zahl ein : steht

** '''Beispiel: attr Nexus10Wohnzimmer setBluetoothDevice Logitech_BT_Adapter|AB:12:CD:34:EF:32,Anker_A3565|GH:56:IJ:78:KL:76

=== state ===
* initialized - Ist der Status kurz nach einem define.
* active - die Geräteinstanz ist im aktiven Status.
* disabled - die Geräteinstanz wurde über das Attribut disable deaktiviert

==Anwendungsbeispiele==
=== Lademanagement ===
Ich habe die Ladegeräte für meine Androidgeräte an Funkschaltsteckdosen. Ein DOIF schaltet bei unter 30% die Steckdose ein und bei über 90% wieder aus.

Hier mal ein einfaches DOIF Beispiel für ein Lademanagment

<code>
... DOIF ([Nexus5Handy:powerLevel] < 30) (set LadenetzteilNexus5Handy:FILTER=STATE=off on) DOELSEIF ([Nexus5Handy:powerLevel] > 90) (set LadenetzteilNexus5Handy:FILTER=STATE=on off) DOELSE
</code>

=== Wecker ===
Morgens lasse ich mich über mein Tablet im Schlafzimmer mit Musik wecken. Verwendet wird hierzu der wakeuptimer des RESIDENTS Modules. Das Abspielen stoppe ich dann von Hand. Danach erfolgt noch eine Ansage wie das Wetter gerade ist und wird.

=== Mediacenter ===
Mein 10" Tablet im Wohnzimmer ist Mediaplayer für das Wohnzimmer mit Bluetoothlautsprechern. Die Lautstärke wird automatisch heruntergesetzt, wenn die Fritzbox einen Anruf auf das Wohnzimmer Handgerät signalisiert.

=== Sprachbefehl - Abfragen von Zuständen diverser Sensoren ===
Wenn ich die Spracheingabe aktiviere und nach der Temperatur im Wohnzimmer frage, bekomme ich diese angesagt.

Der Teil im Feld Daten ist ein klassisches ReadingsVal, halt nur ohne Komma und ohne Anführungszeichen

WIRD GERADE ÜBERARBEITET

=== Schaltbefehle vom Androidgerät an FHEM senden ===
Hierfür ist ein eigener Flow einzurichten. Wie das genau geht, verrät die Hilfe.
Um einen Schaltbefehl für FHEM zu erstellen, folgt nach dem Trigger eine Aktion als Script (Aktion Type: Script). Hier ist folgendes einzutragen:

setcmd = "LichtWohnzimmerLampeRechts on"

fhemcmd = "set"

In der ersten Zeile wird also der Schaltbefehl in der Variablem setcmd eingetragen und in der zweiten Zeile der FHEM Befehl in der Variablen fhemcmd.

Danach müsst Ihr nur noch in einer weiteren Aktion den Flow "Send Data to AMADCommBridge" ausführen (Aktion Type: Flows ausführen). Die Aktion sollte bereits in Eurer Liste Vorhanden sein.

[[Datei:Screenshot_20160717-134948.png|200px]]
[[Datei:Screenshot 17.07.2016 1-50-27.png|200px]]

Nun sollte Lampe1 angeschalten werden, wenn der Flow ausgeführt wird.

=== Mit FHEM ein Flow ausführen ===
In Automagic einen Triggervom Type General Broadcast für den Flow wählen welchen man fern ausführen möchte. In der Trigger Definition steht unter Aktion ''automagic.NameDesFlows'' und auf Wunsch unter Access Intent Extra's ''param1 = getString("label1"); param2 = getString("label2");''. ''NameDesFlows'' ist natürlich die Name des Flows, der kein Leerzeichen enthält. Mit ein FHEM Command 'set ''AMADDevice'' sendIntent ''automagic.namederflow label1 param1 label2 param2''' wird dann der Flow aus geführt.

=== Lister aller Variablen für die AMADCommandBridge ===
fhemcmd Variable
* Wert "set" - Variable für den Schaltbefehl 'setcmd'
* Wert "setreading" - Variable für die Readingswerte 'fhemdata'
* "readingsval" - Variable für die Abfragewerte 'readingsvalcmd'
* "fhemfunc" - Variable für den Funktionsnamen 'fhemsub'

'''Beispiele für Skriptinhalte:'''

Schalten einer Lampe

<code>
setcmd = "LichtWohnzimmerLampeRechts on";

fhemcmd = "set"
</code>

Status eines Device abfragen

<code>
readingsvalcmd = "DEVICE READING DEFAULT";

fhemcmd = "readingsval"
</code>

Die Rückgabevariable, die dann weiter verarbeitet werden kann, heißt '''respreadingsval'''

Aufruf einer 99_myUtils Subroutine

<code>
fhemsub = "mySub()"; oder natürlich auch "mySub('was_auch_immer')"

fhemcmd = "fhemfunc"
</code>

Die Rückgabevariable, die dann weiter verarbeitet werden kann, heißt '''respfhemfunc'''

== Bekannte Meldungen/Hinweise/Probleme ==

Wenn auf dem Android-Gerät die Fehlermeldung 'Accessibility service not running' von Automagic kommt oder im FHEM das reading state 'Flow Informations mit Fehler beendet' steht, dann muss der Accessibility Service auf dem Android-Device aktiviert werden: Einstellungen --> Bedienungshilfen --> Automagic Premium. Hier muss der Schalter auf 'an' stehen. Sollte dies der Fall sein, hilft u.U. ein kurzes Aus- und wieder Einschalten.

Gerät wird oft als offline angezeigt und es können keine set Befehle abgesetzt werden.
Mit der AMAD Version 2.2 hielt eine neue Behandlung des deviceState Readings Einzug. Das Reading stellt nun den tatsächlichen Status des Gerätes gegenüber FHEM da. Bei vielen Android 6 Geräten kommt es aber auf Grund vom DeepSleep Modus zum Wegfall der WLAN Verbindung. Hier hilft die neue KeepAlive Funktion in AMAD. Dafür muß lediglich unter
* Einstellungen --> Akku --> oben auf die drei Punkte - Akku Leistungsoptimierung --> alle Apps und dann Automagic auswählen und "Nicht optimieren"
ausgewählt werden und in FHEM für das Device das Attribut setAPSSID gesetzt werden. Alles andere macht das Modul selbst.

AMAD

2018-01-27T11:03:06Z

CoolTux: /* Mit FHEM ein Flow ausführen */

{{Infobox Modul
|ModPurpose=Steuern von Androidgeräten und Anzeige von bestimmten Informationen dieser Geräte
|ModType=d
|ModForumArea=Sonstige Systeme
|ModTechName=73_AMADCommBridge.pm, 74_AMADDevice.pm
|ModOwner=CoolTux ([http://forum.fhem.de/index.php?action=profile;u=13684 Forum] / [[Benutzer:CoolTux|Wiki]])
}}

= AMAD 4.0 [AMADNG] =
== 73_AMADCommBridge / 74_AMADDevice ==

= Vorwort =
=== Warum AMADNG ===
Nach fast 6 Monaten Entwicklungszeit wurde die neuste AMAD Version am 24.07.2017 offiziell frei gegeben. Diesmal lagen mir mehrere Dinge am Herzen.
In erster Linie wollte ich eine softwareseitige Trennung der AMADCommBridge vom eigentlichen Android Device. Daher ist die neue Version ein zweistufiges Modul geworden.
Im Laufe der Entwicklung kamen auch andere Anforderungen hinzu, die ich dann fähig war umzusetzen. Eine dieser Anforderungen war eine einfachere und besser funktionierende Installation. Herausgekommen ist ein Android Installationsassistant.
Mit ihm wird auf einfache Art und Weise direkt per Sprachführung und Eingabedialogen Automagic für AMAD konfiguriert und das Device in FHEM automatisch erstellt. Es ist darauf zu achten, das Autocreate aktiv ist, da sonst kein Device mit Hilfe des Assistenten angelegt werden kann!

= Vorstellung =
Dieses 2-stufige Modul liefert, '''in Verbindung mit der Android App Automagic''', diverse Informationen von Android Geräten.
Die AndroidAPP Automagic (die nicht von mir stammt und 2.90 Euro kostet) funktioniert wie Tasker, ist aber bei weitem benutzungsfreundlicher.

=== Features / Funktionen ===
Im Auslieferungszustand werden folgende Zustände dargestellt:
* installierte Android Version
* Zustand von Automagic auf dem Gerät
* Spracheingabe
* Bluetooth An/Aus
* Zustand einer definierten App (läuft aktiv im Vordergrund oder nicht?)
* verbundene Bluetoothgeräte, inklusive deren MAC Adresse
* aktuell abgespieltes Musikalbum des verwendeten Mediaplayers
* aktuell abgespielter Musikinterpret des verwendeten Mediaplayers
* aktuell abgespielter Musiktitel des verwendeten Mediaplayers
* Status des Androidgerätes - Online/Offline
* nächster Alarmtag
* nächste Alarmzeit
* Batteriestatus in %
* Ladestatus - Netztei angeschlossen / nicht angeschlossen
* Bildschirmstatus An/Aus
* Bildschirmhelligkeit
* Vollbildmodus An/Aus
* Bildschirmausrichtung Auto/Landscape/Portrait
* Standardlautstärke
* Media Lautstärke
* ...

Mit etwas Einarbeitung können jegliche Informationen, die Automagic bereit stellt, in FHEM angezeigt werden. Hierzu bedarf es lediglich eines eigenen Flows, der seine Daten an die AMADCommBridge sendet. Das Modul gibt auch die Möglichkeit Androidgeräte zu steuern.

= AMADCommBridge - Kommunikationsbrücke für alle AMAD Geräte =
Dieses Modul ist das Ausgangsmodul zur erfolgreichen Integration von Androidgeräten in FHEM. Es stellt ferner eine Verbindungsebene zwischen AMAD unterstützten Geräten und FHEM zur Verfügung. Alle Kommunikation zwischen AMAD Android und FHEM läuft über diese Schnittstelle.
Daher erfolgt die Ersteinrichtung eines AMAD Devices auch genau über diese Modulinstanz.

Damit erfolgreich ein Androidgerät in FHEM eingerichtet werden kann, muss im ersten Schritt ein AMADCommBridge Device angelegt werden.

=== Definition in FHEM ===

<code>define <name> AMADCommBridge</code>

==== Beispiel ====

<code>define AMADBridge AMADCommBridge</code>

Diese Anweisung erstellt ein neues AMADCommBridge Device namens AMADBridge.

Im folgenden muß lediglich das Flowset auf dem Android Gerät installiert werden und der Flow 'First Run Assistent' ausgeführt werden. (einfach den Homebutton drücken)
Der Assistent geleitet dann durch die Einrichtung des AMAD Gerätes und sorgt dafür, dass am Ende des Installationsprozess das Androidgerät als AMAD Device in FHEM angelegt wird.

=== Readings ===
* JSON_ERROR - JSON Fehlermeldung, die von Perl gemeldet wird
* JSON_ERROR_STRING - der String, der die JSON Fehlermeldung verursacht hat
* fhemServerIP - die Ip-Adresse des FHEM Servers; wird vom Modul auf Basis des JSON Strings vom Installationsassistenten gesetzt. Kann aber auch mittels set Befehles vom User gesetzt werden
* receiveFhemCommand - ist das Attribut fhemControlMode auf trigger gestellt, wird das Reading gesetzt sobald ein FHEM Befehl übersendet wird. Hierauf kann dann ein Notify triggern. Wird anstelle von trigger setControl als Wert für fhemControlMode eingestellt, wird das Reading nicht gesetzt sondern der set Befehl sofort ausgeführt.
* receiveVoiceCommand - wird die Sprachsteuerung von AMAD aktiviert (set DEVICE activateVoiceInput) so wird der letzte erkannten Sprachbefehle in dieses Reading geschrieben.
* receiveVoiceDevice - Name des Devices von wo aus der letzte erkannte Sprachbefehl gesendet wurde
* state - Status der Bridge, open, closed

=== Attribute ===
* allowFrom - Regexp der erlaubten IP-Adressen oder Hostnamen. Wenn dieses Attribut gesetzt wurde, werden ausschließlich Verbindungen von diesen Adressen akzeptiert. Achtung: falls allowfrom nicht gesetzt ist, und keine gütige allowed Instanz definiert ist, und die Gegenstelle eine nicht lokale Adresse hat, dann wird die Verbindung abgewiesen. Folgende Adressen werden als local betrachtet: IPV4: 127/8, 10/8, 192.168/16, 172.16/10, 169.254/16, IPV6: ::1, fe80/10
* debugJSON - wenn auf 1 gesetzt, werden JSON Fehlermeldungen in Readings geschrieben. Siehe hierzu JSON_ERROR* unter Readings
* fhemControlMode - steuert die zulässige Art der Steuerung von FHEM Devices. Es können über die Bridge auf 2 Arten FHEM-Devices angesteuert werden: per direktem FHEM-Befehl aus einem Flow heraus oder als Sprachbefehl mittels Sprachsteuerung (set DEVICE activateVoiceInput)
** trigger - ist der Wert trigger gesetzt, werden alle an die Bridge gesendeten FHEM set Befehle in das Reading receiveFhemCommand geschrieben und können so mittels notify ausgeführt werden. Sprachsteuerung ist möglich, es werden Readings receiveVoice* gesetzt. Auf dem Androidgerät können bei Sprachsteuerung mehrere Sprachbefehle mittels "und" verknüpft/aneinander gereiht werden. Bsp: schalte die Lichtszene Abends an und schalte den Fernseher an
** setControl - alle set Befehle, die mittels eines Flows über die Bridge gesendet werden, werden automatisch ausgeführt. Das Triggern eines Readings ist nicht nötig. Die Steuerung mittels Sprache verhält sich wie beim Wert trigger
** thirdPartControl - verhält sich wie trigger, bei der Sprachsteuerung ist jedoch ein Anreihen von Sprachbefehlen mittels "und" nicht möglich. Dient der Sprachsteuerung über Module anderer Modulautoren ((z.B. 39_TEERKO.pm)

= AMADDevice - Automagic Android Device =
Dieses Modul liefert, in Verbindung mit der Android APP Automagic, diverse Informationen von Android Geräten. Die Android App Automagic (die nicht von mir stammt und 2.90 Euro kostet) funktioniert wie Tasker, ist aber bei weitem User freundlicher.
Mit etwas Einarbeitung können jegliche Informationen, die Automagic bereit stellt in FHEM angezeigt werden. Hierzu bedarf es lediglich eines eigenen Flows, der seine Daten an die AMADDeviceCommBridge sendet. Das Modul gibt auch die Möglichkeit Androidgeräte zu steuern.
Für all diese Aktionen und Informationen wird auf dem Androidgerät "Automagic" und ein so genannter Flow benötigt. Die App ist über den Google PlayStore zu beziehen. Das benötigte Flowset bekommt man aus dem FHEM Verzeichnis.

=== Wie genau verwendet man nun AMADDevice? ===
* sicherstellen, dass als allererstes die AMADCommBridge in FHEM definiert wurde
* installieren der App "Automagic Premium" aus dem PlayStore
* installieren des Flowset 74_AMADDeviceautomagicFlowset$VERSION.xml aus dem Ordner $INSTALLFHEM/FHEM/lib/ auf dem Androidgerät
* aktivieren des Installationsassistanten Flow in Automagic. Wenn man nun Automagic in den Hintergrund schickt, z.B. Hometaste drücken, startet der Assistant und legt automatisch ein Device für das Androidgerät an.

=== Ein AMADDevice Gerät von Hand anlegen. ===

Define

<code>define <name> AMADDevice <IP-ADRESSE> <AMAD_ID> IODev=<IODEVICE> </code>

==== Beispiel ====

<code>define WandTabletWohnzimmer AMADDevice 192.168.0.23 123456 IODev=NAME_des_AMADCommBridge_Devices</code>

In diesem Fall wird ein AMADDevice von Hand angelegt. Die AMAD_ID, hier 123456, muß auch exakt so als globale Variable in Automagic eingetragen sein.

=== Readings ===
* airplanemode - Status des Flugmodus
* androidVersion - aktuell installierte Androidversion
* automagicState - Statusmeldungen von der Automagic App '''(Voraussetzung Android >4.3). Ist Android größer 4.3 vorhanden und im Reading steht "wird nicht unterstützt", muss in den Androideinstellungen unter Ton und Benachrichtigungen -> Benachrichtigungszugriff ein Haken für Automagic gesetzt werden'''
* batteryHealth - Zustand der Battery (1=unbekannt, 2=gut, 3=überhitzt, 4=tot, 5=Überspannung, 6=unbekannter Fehler, 7=kalt)
* batterytemperature - Temperatur der Batterie
* bluetooth - on/off, Bluetooth Status an oder aus
* checkActiveTask - Zustand einer zuvor definierten App. 0=nicht aktiv oder nicht aktiv im Vordergrund, 1=aktiv im Vordergrund, '''siehe Hinweis unten'''
* connectedBTdevices - eine Liste der verbundenen Gerät
* connectedBTdevicesMAC - eine Liste der MAC Adressen aller verbundender BT Geräte
* currentMusicAlbum - aktuell abgespieltes Musikalbum des verwendeten Mediaplayers
* currentMusicApp - aktuell verwendeter Mediaplayer (Amazon Music, Google Play Music, Google Play Video, Spotify, YouTube, TuneIn Player, Aldi Life Music)
* currentMusicArtist - aktuell abgespielter Musikinterpret des verwendeten Mediaplayers
* currentMusicIcon - Cover vom aktuell abgespielten Album '''Noch nicht fertig implementiert'''
* currentMusicState - Status des aktuellen/zuletzt verwendeten Mediaplayers
* currentMusicTrack - aktuell abgespielter Musiktitel des verwendeten Mediaplayers
* daydream - on/off, Daydream gestartet oder nicht
* deviceState - Status des Androidgerätes. unknown, online, offline.
* doNotDisturb - aktueller Status des Nicht-Stören-Modus
* dockingState - undocked/docked Status, ob sich das Gerät in einer Dockingstation befindet.
* flow_SetCommands - active/inactive, Status des SetCommands Flow
* flow_informations - active/inactive, Status des Informations Flow
* flowsetVersionAtDevice - aktuell installierte Flowsetversion auf dem Device
* incomingCallerName - Anrufername des eingehenden Anrufes
* incomingCallerNumber - Anrufernummer des eingehenden Anrufes
* incommingWhatsAppMessageFrom - letzte WhatsApp Nachricht
* incommingWhatsTelegramMessageFrom - letzte Telegram Nachricht
* intentRadioName - zuletzt gestreamter Intent Radio Name
* intentRadioState - Status des IntentRadio Players
* keyguardSet - 0/1 Displaysperre gesetzt 0=nein 1=ja, bedeutet nicht, dass sie gerade aktiv ist
* lastSetCommandError - letzte Fehlermeldung vom set Befehl
* lastSetCommandState - letzter Status vom set Befehl, Befehl erfolgreich/nicht erfolgreich gesendet
* lastStatusRequestError - letzte Fehlermeldung vom statusRequest Befehl
* lastStatusRequestState - letzter Status vom statusRequest Befehl, Befehl erfolgreich/nicht erfolgreich gesendet
* nextAlarmDay - aktiver Alarmtag
* nextAlarmState - aktueller Status des "Androidinternen" Weckers
* nextAlarmTime - aktive Alarmzeit
* powerLevel - Status der Batterie in %
* powerPlugged - Netzteil angeschlossen? 0=NEIN, 1|2=JA
* screen - on locked/unlocked, off locked/unlocked gibt an ob der Bildschirm an oder aus ist und gleichzeitig gesperrt oder nicht gesperrt
* screenBrightness - Bildschirmhelligkeit von 0-255
* screenFullscreen - on/off, Vollbildmodus (An,Aus)
* screenOrientation - Landscape,Portrait, Bildschirmausrichtung (Horizontal,Vertikal)
* screenOrientationMode - auto/manual, Modus für die Ausrichtung (Automatisch, Manuell)
* state - aktueller Status
* userFlowState - aktueller Status eines Flows, festgelegt unter dem setUserFlowState Attribut
* volume - Media Lautstärkewert
* volumeNotification - Benachrichtigungs-Lautstärke

Beim Reading checkActivTask muß zuvor der Packagename der zu prüfenden App als Attribut checkActiveTask angegeben werden. Beispiel: attr Nexus10Wohnzimmer checkActiveTask com.android.chrome für den Chrome Browser.

=== Set ===
* activateVoiceInput - aktiviert die Spracheingabe
* bluetooth - on/off, aktiviert/deaktiviert Bluetooth
* clearNotificationBar - All,Automagic, löscht alle Meldungen oder nur die Automagic Meldungen in der Statusleiste
* closeCall - beendet einen laufenden Anruf
* currentFlowsetUpdate - führt ein Flowsetupdate auf dem Device durch
* doNotDisturb - schaltet den Nicht-Stören-Modus: always immer stören, never niemals stören, alarmClockOnly nur Wecker darf stören, onlyImportant nur wichtige Störungen
* installFlowSource - installiert einen Flow auf dem Device, das XML File muss unter /tmp/ liegen und die Endung xml haben. Bsp: set TabletWohnzimmer installFlowSource WlanUebwerwachen.xml
* mediaAmazonMusic - play, stop, next, back ,steuert den Amazon Musik Mediaplayer
* mediaGoogleMusic - play, stop, next, back ,steuert den Google Play Musik Mediaplayer
* mediaSpotifyMusic - play, stop, next, back ,steuert den Spotify Mediaplayer
* mediaTuneinRadio - play, stop, next, back ,steuert den TuneIn Radio Mediaplayer
* mediaAldiMusic - play, stop, next, back ,steuert den Aldi Musik Mediaplayer
* mediaAudible - play, stop, next, back ,steuert den Audible Mediaplayer
* mediaYouTube - play, stop, next, back ,steuert den YouTube Mediaplayer
* mediaVlcPlayer - play, stop, next, back ,steuert den VLC Mediaplayer
* nextAlarmTime - setzt die Alarmzeit. gilt aber nur innerhalb der nächsten 24 h
* openCall - ruft eine Nummer an und legt optional nach X Sekunden auf / set DEVICE openCall 01736458 10 / ruft die Nummer an und beendet den Anruf nach 10s
* screen - on/off/lock/unlock schaltet den Bildschirm ein/aus oder sperrt/entsperrt ihn
* screenBrightness - setzt die Bildschirmhelligkeit, von 0-255.
* screenMsg - versendet eine Bildschirmnachricht
* sendintent - sendet einen Intentstring Bsp: set $AMADDeviceDEVICE sendIntent org.smblott.intentradio.PLAY url http://stream.klassikradio.de/live/mp3-192/stream.klassikradio.de/play.m3u name Klassikradio, der erste Befehl ist die Aktion und der zweite das Extra. Es können immer zwei Extras mitgegeben werden.
* sendSMS - sendet eine SMS an eine bestimmte Telefonnummer. Bsp.: sendSMS Dies ist ein Test|555487263
* startDaydream - startet den Daydream
* statusRequest - Fordert einen neuen Statusreport beim Device an. Es können nicht von allen Readings per statusRequest die Daten geholt werden. Einige wenige geben nur bei Statusänderung ihren Status wieder.
* timer - setzt einen Timer innerhalb der als Standard definierten Clock-App auf dem Device. Es können nur Sekunden angegeben werden.
* ttsMsg - versendet eine Nachricht, die als Sprachnachricht ausgegeben wird
* userFlowState - aktiviert oder deaktiviert einen oder mehrere Flows,'''set Nexus7Wohnzimmer Badezimmer vorheizen:inactive oder set Nexus7Wohnzimmer Badezimmer vorheizen,Nachtlicht Steven:inactive'''
* vibrate - lässt das Androidgerät vibrieren
* volume - setzt die Medialautstärke. Entweder die internen Lautsprecher oder sofern angeschlossen die Bluetoothlautsprecher und per Klinkenstecker angeschlossene Lautsprecher, + oder - vor dem Wert reduziert die aktuelle Lautstärke um den Wert. Der maximale Sliderwert kann über das Attribut setVolMax geregelt werden.
* volumeUp - erhöht die Lautstärke um den angegeben Wert im entsprechenden Attribut. Ist kein Attribut angegeben wird per default 2 genommen.
* volumeDown - reduziert die Lautstärke um den angegeben Wert im entsprechenden Attribut. Ist kein Attribut angegeben wird per default 2 genommen.
* volumeNotification - setzt die Benachrichtigungslautstärke.

==== Set abhängig von gesetzten Attributen ====
* changetoBtDevice - wechselt zu einem anderen Bluetooth Gerät. Attribut setBluetoothDevice muß gesetzt sein. Siehe Hinweis unten!
* notifySndFile - spielt die angegebene Mediadatei auf dem Androidgerät ab. Die aufzurufende Mediadatei sollte sich im Ordner /storage/emulated/0/Notifications/ befinden. Ist dies nicht der Fall kann man über das Attribut setNotifySndFilePath einen Pfad vorgeben.
* openApp - öffnet eine ausgewählte App. Attribut setOpenApp
* openURL - öffnet eine URL im Standardbrowser, sofern kein anderer Browser über das Attribut setOpenUrlBrowser ausgewählt wurde. Bsp: attr Tablet setOpenUrlBrowser de.ozerov.fully|de.ozerov.fully.MainActivity, das erste ist der Package Name und das zweite der Class Name
* setAPSSID - setzt die AccessPoint SSID um ein WLAN sleep zu verhindern
* setScreenOnForTimer ändert die Zeitdauer, die das Display an bleiben soll!
* screenFullscreen - on/off, (aktiviert/deaktiviert) den Vollbildmodus. Attribut setFullscreen
* screenLock - Sperrt den Bildschirm mit Pinabfrage. Attribut setScreenlockPIN - hier die Pin dafür eingeben. Erlaubt sind nur Zahlen. Es müßen mindestens 4, bis max 16 Zeichen verwendet werden.
* screenOrientation - Auto,Landscape,Portait, aktiviert die Bildschirmausrichtung (Automatisch,Horizontal,Vertikal). Attribut setScreenOrientation
* system - setzt Systembefehle ab (nur bei gerootetet Geräten). reboot,shutdown,airplanemodeON (kann nur aktiviert werden) Attribut root, in den Automagic Einstellungen muss "Root Funktion" gesetzt werden
* setNotifySndFilePath - setzt den korrekten Systempfad zur Notifydatei (default ist /storage/emulated/0/Notifications/
* setTtsMsgSpeed - setzt die Sprachgeschwindigkeit bei der Sprachausgabe(Werte zwischen 0.5 bis 4.0 in 0.5er Schritten) default ist 1.0
* setTtsMsgSpeed - setzt die Sprache bei der Sprachausgabe, de oder en (default ist de)
* setVolUpDownStep - setzt den Step für volumeUp und volumeDown
* setVolMax - setzt die maximale Volume Größe für den Slider
* setNotifyVolMax - setzt den maximalen Lautstärkewert für Benachrichtigungslautstärke für den Slider
* setRingSoundVolMax - setzt den maximalen Lautstärkewert für Klingellautstärke für den Slider

'''Um openApp verwenden zu können, muss als Attribut der Package Name der App angegeben werden.

'''Um zwischen Bluetoothgeräten wechseln zu können, muss das Attribut setBluetoothDevice mit folgender Syntax gesetzt werden. attr <DEVICE> BTdeviceName1|MAC,BTDeviceName2|MAC Es muss zwingend darauf geachtet werden, dass beim BTdeviceName kein Leerzeichen vorhanden ist. Am besten zusammen oder mit Unterstrich. Bei der MAC ist darauf zu achten, dass wirklich nach jeder zweiten Zahl ein : steht

** '''Beispiel: attr Nexus10Wohnzimmer setBluetoothDevice Logitech_BT_Adapter|AB:12:CD:34:EF:32,Anker_A3565|GH:56:IJ:78:KL:76

=== state ===
* initialized - Ist der Status kurz nach einem define.
* active - die Geräteinstanz ist im aktiven Status.
* disabled - die Geräteinstanz wurde über das Attribut disable deaktiviert

==Anwendungsbeispiele==
=== Lademanagement ===
Ich habe die Ladegeräte für meine Androidgeräte an Funkschaltsteckdosen. Ein DOIF schaltet bei unter 30% die Steckdose ein und bei über 90% wieder aus.

Hier mal ein einfaches DOIF Beispiel für ein Lademanagment

<code>
... DOIF ([Nexus5Handy:powerLevel] < 30) (set LadenetzteilNexus5Handy:FILTER=STATE=off on) DOELSEIF ([Nexus5Handy:powerLevel] > 90) (set LadenetzteilNexus5Handy:FILTER=STATE=on off) DOELSE
</code>

=== Wecker ===
Morgens lasse ich mich über mein Tablet im Schlafzimmer mit Musik wecken. Verwendet wird hierzu der wakeuptimer des RESIDENTS Modules. Das Abspielen stoppe ich dann von Hand. Danach erfolgt noch eine Ansage wie das Wetter gerade ist und wird.

=== Mediacenter ===
Mein 10" Tablet im Wohnzimmer ist Mediaplayer für das Wohnzimmer mit Bluetoothlautsprechern. Die Lautstärke wird automatisch heruntergesetzt, wenn die Fritzbox einen Anruf auf das Wohnzimmer Handgerät signalisiert.

=== Sprachbefehl - Abfragen von Zuständen diverser Sensoren ===
Wenn ich die Spracheingabe aktiviere und nach der Temperatur im Wohnzimmer frage, bekomme ich diese angesagt.

Der Teil im Feld Daten ist ein klassisches ReadingsVal, halt nur ohne Komma und ohne Anführungszeichen

WIRD GERADE ÜBERARBEITET

=== Schaltbefehle vom Androidgerät an FHEM senden ===
Hierfür ist ein eigener Flow einzurichten. Wie das genau geht, verrät die Hilfe.
Um einen Schaltbefehl für FHEM zu erstellen, folgt nach dem Trigger eine Aktion als Script (Aktion Type: Script). Hier ist folgendes einzutragen:

setcmd = "LichtWohnzimmerLampeRechts on"

fhemcmd = "set"

In der ersten Zeile wird also der Schaltbefehl in der Variablem setcmd eingetragen und in der zweiten Zeile der FHEM Befehl in der Variablen fhemcmd.

Danach müsst Ihr nur noch in einer weiteren Aktion den Flow "Send Data to AMADCommBridge" ausführen (Aktion Type: Flows ausführen). Die Aktion sollte bereits in Eurer Liste Vorhanden sein.

[[Datei:Screenshot_20160717-134948.png|200px]]
[[Datei:Screenshot 17.07.2016 1-50-27.png|200px]]

Nun sollte Lampe1 angeschalten werden, wenn der Flow ausgeführt wird.

=== Mit FHEM ein Flow ausführen ===
In Automagic einen Triggervom Type General Broadcast für den Flow wählen welchen man fern ausführen möchte. In der Trigger Definition steht unter Aktion ''automagic.NameDesFlows'' und auf Wunsch unter Access Intent Extra's ''param1 = getString("label1"); param2 = getString("label2");''. ''NameDesFlows'' ist natürlich die Name des Flows, der kein Leerzeichen enthält. Mit ein FHEM Command 'set ''AMADDevice'' sendIntent ''automagic.namederflow label1 param1 label2 param2''' wird dann der Flow aus geführt.

=== Lister aller Variablen für die AMADCommandBridge ===
fhemcmd Variable
* Wert "set" - Variable für den Schaltbefehl 'setcmd'
* Wert "setreading" - Variable für die Readingswerte 'fhemdata'
* "readingsval" - Variable für die Abfragewerte 'readingsvalcmd'
* "fhemfunc" - Variable für den Funktionsnamen 'fhemsub'

'''Beispiele für Skriptinhalte:'''

Schalten einer Lampe

<code>
setcmd = "LichtWohnzimmerLampeRechts on";

fhemcmd = "set"
</code>

Status eines Device abfragen

<code>
readingsvalcmd = "DEVICE READING DEFAULT";

fhemcmd = "readingsval"
</code>

Die Rückgabevariable, die dann weiter verarbeitet werden kann, heißt '''respreadingsval'''

Aufruf einer 99_myUtils Subroutine

<code>
fhemsub = "mySub()"; oder natürlich auch "mySub('was_auch_immer')"

fhemcmd = "fhemfunc"
</code>

Die Rückgabevariable, die dann weiter verarbeitet werden kann, heißt '''respfhemfunc'''

== Bekannte Meldungen/Hinweise/Probleme ==

Wenn auf dem Android-Gerät die Fehlermeldung 'Accessibility service not running' von Automagic kommt oder im FHEM das reading state 'Flow Informations mit Fehler beendet' steht, dann muss der Accessibility Service auf dem Android-Device aktiviert werden: Einstellungen --> Bedienungshilfen --> Automagic Premium. Hier muss der Schalter auf 'an' stehen. Sollte dies der Fall sein, hilft u.U. ein kurzes Aus- und wieder Einschalten.

Gerät wird oft als offline angezeigt und es können keine set Befehle abgesetzt werden.
Mit der AMAD Version 2.2 hielt eine neue Behandlung des deviceState Readings Einzug. Das Reading stellt nun den tatsächlichen Status des Gerätes gegenüber FHEM da. Bei vielen Android 6 Geräten kommt es aber auf Grund vom DeepSleep Modus zum Wegfall der WLAN Verbindung. Hier hilft die neue KeepAlive Funktion in AMAD. Dafür muß lediglich unter
* Einstellungen --> Akku --> oben auf die drei Punkte - Akku Leistungsoptimierung --> alle Apps und dann Automagic auswählen und "Nicht optimieren"
ausgewählt werden und in FHEM für das Device das Attribut setAPSSID gesetzt werden. Alles andere macht das Modul selbst.

XiaomiBTLESens

2018-01-16T14:33:15Z

CoolTux:

{{Infobox Modul
|ModPurpose=Auslesen unterstützter Xiaomi BTLE Sensoren
|ModType=d
|ModForumArea=Sonstige Systeme
|ModTechName=74_XiaomiBTLESens.pm
|ModOwner=CoolTux ({{Link2FU|13684|Forum}} / [[Benutzer:CoolTux|Wiki]])
}}

==Beschreibung==
Mit diesem Modul ist es möglich diverse BTLE Sensoren der Firma Xiaomi aus zu lesen auszulesen und die entsprechenden Daten als Readings darzustellen. Zum Beispiel den XiaomiFlowerMonitor.

Voraussetzung zur Verwendung des Modules ist:
* libjson-perl
* bluez (gatttool und hcitool)

Mittels <code>hcitool lescan</code> bekommt man die BT-MAC, die benötigte Bluetooth MAC Adresse.

Achtung: auf einem Debian Wheezy scheint es Probleme mit dem Bluetooth Stack zu geben. Selbst wenn man ein aktuelles BT 5.x selbst kompiliert und installiert gibt spätestens das gatttool keine Daten mehr aus. Es muss zwingend auf Debian Jessie geupgraded werden.

===Definition===
<code>define <name> XiaomiBTLESens <BT-MAC></code>

'''Beispiel:'''

<code>define Weihnachtskaktus XiaomiBTLESens C4:7C:8D:62:42:6F</code>

Diese Anweisung erstellt ein XiaomiBTLESens Device mit dem Namen Weihnachtskaktus und der BT MAC C4:7C:8D:62:42:6F.
Als nächstes sollte auf jeden Fall das Attribut model gesetzt werden, um das korrekte Gerät an zu sprechen.

===Readings===
* state - aktueller Status des Device.
* battery - Status der Batterie in Abhängigkeit des batteryLevel Readings.
* batteryLevel - Füllstand der Batterie in Prozent.
* fertility - Nährstoffgehalt des Pflanzenbodens (Dünger) - Bodenleitfähigkeit
* firmware - aktuelle Firmware auf dem Device
* lux - aktuelle Lichtintensität
* moisture - Wassergehalt (Feuchtigkeit) des Pflanzenbodens
* temperature - Umgebungstemperatur

===Set===
* devicename - setzt einen Devicenamen

===Get===
* sensorData - aktive Abfrage der Sensors Werte
* devicename - liest den Devicenamen aus
* firmware - liest die Firmeware aus

===Attribute===
* interval - Intervallzeit in Sekunden, nach der der nächste automatische Datenabruf erfolgen soll
* model - Auswahl eines unterstützten Gerätes
* disable - deaktiviert die den Abruf
* disabledForIntervals - deaktiviert das Gerät für den angegebenen Zeitinterval (13:00-18:30 or 13:00-18:30 22:00-23:00)
* minFertility - min Fruchtbarkeits-Grenzwert für ein Ereignis minFertility low
* maxFertility - max Fruchtbarkeits-Grenzwert für ein Ereignis maxFertility high
* minMoisture - min Feuchtigkeits-Grenzwert für ein Ereignis minMoisture low
* maxMoisture - max Feuchtigkeits-Grenzwert für ein Ereignis maxMoisture high
* minTemp - min Temperatur-Grenzwert für ein Ereignis minTemp low
* maxTemp - max Temperatur-Grenzwert für ein Ereignis maxTemp high
* minlux - min Helligkeits-Grenzwert für ein Ereignis minlux low
* maxlux - max Helligkeits-Grenzwert für ein Ereignis maxlux high
*:Beispiele für min/max-Ereignisse:
*::2017-03-16 11:08:05 XiaomiFlowerSens Dracaena minMoisture low
*::2017-03-16 11:08:06 XiaomiFlowerSens Dracaena maxTemp high
* sshHost - FQDN oder IP-Adresse eines entfernten SSH-Systems. Das SSH-System ist auf eine Zertifikat basierte Authentifizierung zu konfigurieren. Am elegantesten geschieht das mit einer .ssh/config Datei auf dem SSH-Client.

Diskussion:XiaomiBTLESens

2018-01-16T14:32:10Z

CoolTux: Die Seite wurde neu angelegt: „Kann bitte ein Moderator den Seitentitel ändern in XiaomiBTLESens. Danke“

Kann bitte ein Moderator den Seitentitel ändern in XiaomiBTLESens.

Danke

XiaomiBTLESens

2018-01-16T14:31:11Z

CoolTux:

{{Infobox Modul
|ModPurpose=Auslesen eines Xiaomi Flower Sensors
|ModType=d
|ModForumArea=Sonstige Systeme
|ModTechName=74_XiaomiBTLESens.pm
|ModOwner=CoolTux ({{Link2FU|13684|Forum}} / [[Benutzer:CoolTux|Wiki]])
}}

==Beschreibung==
Mit diesem Modul ist es möglich diverse BTLE Sensoren der Firma Xiaomi aus zu lesen auszulesen und die entsprechenden Daten als Readings darzustellen. Zum Beispiel den XiaomiFlowerMonitor.

Voraussetzung zur Verwendung des Modules ist:
* libjson-perl
* bluez (gatttool und hcitool)

Mittels <code>hcitool lescan</code> bekommt man die BT-MAC, die benötigte Bluetooth MAC Adresse.

Achtung: auf einem Debian Wheezy scheint es Probleme mit dem Bluetooth Stack zu geben. Selbst wenn man ein aktuelles BT 5.x selbst kompiliert und installiert gibt spätestens das gatttool keine Daten mehr aus. Es muss zwingend auf Debian Jessie geupgraded werden.

===Definition===
<code>define <name> XiaomiBTLESens <BT-MAC></code>

'''Beispiel:'''

<code>define Weihnachtskaktus XiaomiBTLESens C4:7C:8D:62:42:6F</code>

Diese Anweisung erstellt ein XiaomiBTLESens Device mit dem Namen Weihnachtskaktus und der BT MAC C4:7C:8D:62:42:6F.
Als nächstes sollte auf jeden Fall das Attribut model gesetzt werden, um das korrekte Gerät an zu sprechen.

===Readings===
* state - aktueller Status des Device.
* battery - Status der Batterie in Abhängigkeit des batteryLevel Readings.
* batteryLevel - Füllstand der Batterie in Prozent.
* fertility - Nährstoffgehalt des Pflanzenbodens (Dünger) - Bodenleitfähigkeit
* firmware - aktuelle Firmware auf dem Device
* lux - aktuelle Lichtintensität
* moisture - Wassergehalt (Feuchtigkeit) des Pflanzenbodens
* temperature - Umgebungstemperatur

===Set===
* devicename - setzt einen Devicenamen

===Get===
* sensorData - aktive Abfrage der Sensors Werte
* devicename - liest den Devicenamen aus
* firmware - liest die Firmeware aus

===Attribute===
* interval - Intervallzeit in Sekunden, nach der der nächste automatische Datenabruf erfolgen soll
* model - Auswahl eines unterstützten Gerätes
* disable - deaktiviert die den Abruf
* disabledForIntervals - deaktiviert das Gerät für den angegebenen Zeitinterval (13:00-18:30 or 13:00-18:30 22:00-23:00)
* minFertility - min Fruchtbarkeits-Grenzwert für ein Ereignis minFertility low
* maxFertility - max Fruchtbarkeits-Grenzwert für ein Ereignis maxFertility high
* minMoisture - min Feuchtigkeits-Grenzwert für ein Ereignis minMoisture low
* maxMoisture - max Feuchtigkeits-Grenzwert für ein Ereignis maxMoisture high
* minTemp - min Temperatur-Grenzwert für ein Ereignis minTemp low
* maxTemp - max Temperatur-Grenzwert für ein Ereignis maxTemp high
* minlux - min Helligkeits-Grenzwert für ein Ereignis minlux low
* maxlux - max Helligkeits-Grenzwert für ein Ereignis maxlux high
*:Beispiele für min/max-Ereignisse:
*::2017-03-16 11:08:05 XiaomiFlowerSens Dracaena minMoisture low
*::2017-03-16 11:08:06 XiaomiFlowerSens Dracaena maxTemp high
* sshHost - FQDN oder IP-Adresse eines entfernten SSH-Systems. Das SSH-System ist auf eine Zertifikat basierte Authentifizierung zu konfigurieren. Am elegantesten geschieht das mit einer .ssh/config Datei auf dem SSH-Client.

FHEM mit HTTPS SSL-Zertifikat und eine eigene Zertifizierungsstelle

2017-11-14T14:10:03Z

CoolTux:

= Vorwort =
=== Dein Anliegen ===
Du möchtest FHEM mit HTTPS betreiben, hasst es aber ständig von Deinem Browser darauf aufmerksam gemacht zu werden das dies "keine sichere Verbindung" ist.
Oder Du möchtest einen weiteren Serverdienst aufsetzen, welcher verschlüsselte SSL oder TLS-Verbindungen anbietet (z.B. HTTPS, POP3S, IMAPS, LDAPS, SMTP mit TLS).

=== Die Schwierigkeit dabei ===
Um eine mit SSL/TLS abgesicherte Verbindung anzubieten, benötigst Du ein Serverzertifikat. Dieses muss von einer Zertifizierungsstelle (Certification Authority oder kurz CA) signiert sein.
Ein offizielles Serverzertifikat, welches von einer offiziellen Stelle signiert ist, ist leider nicht kostenlos. Meist werden jährliche Gebühren in Höhe von mehreren hundert Euro fällig.

=== Eine mögliche Lösung ===
Unter Linux kann man mit Bordmitteln eine eigene CA aufsetzen und ein selbst Zertifikate erstellen und signieren. Das ist ein Vorgang von wenigen Minuten. Alle Einzelheiten beschreibt dieser Artikel.
Der einzige Unterschied zu einem von einer anerkannten Stelle signierten Zertifikat ist, dass der Client (Emailprogramm, Browser, etc.) einmalig das root CA importieren muß.

= Genaues Vorgehen =
== 1. OpenSSL installieren ==
Für die Verwaltung der Zertifikate und im übrigen auch für die Verschlüsselung der Verbindungen mit SSL und TLS kommt unter Linux fast immer OpenSSL zum Einsatz. Wahrscheinlich ist das auf Deinem Sytem deshalb bereits installiert. Wenn nicht, musst Du das Paket openssl nachinstallieren. Du benötigst aus diesem Paket den Kommandozeilenbefehl openssl.

== 2. Erstellen der CA ==
Lege zunächst ein Verzeichnis an, in dem Du das Zertifikat ablegen willst. Wir nehmen in unserem Beispiel /root/ca:
<nowiki>
root@linux# mkdir /root/ca
root@linux# cd /root/ca</nowiki>
Die Gültigkeit setzen wir mit 10 Jahren bewusst sehr hoch an. Läuft die CA aus, so werden nämlich auch alle damit signierten Serverzertifikate ungültig. Die CA enthält einen geheimen Schlüssel, welcher automatisch erzeugt und in der Datei cakey.pem abgelegt wird. Das CA-Zertifikat wird nach cacert.pem geschrieben. Der folgende Befehl erzeugt das einen Schlüssel für das Zertifikat mit einer Länge von 2048 Bit:
<nowiki>
root@linux# openssl req -new -x509 -newkey rsa:2048 -keyout cakey.pem -out cacert.pem -days 3650
Generating a 2048 bit RSA private key
..............................................................
..............................................................
.........................................+++
......................................+++
writing new private key to 'cakey.pem'</nowiki>
Wer den geheimen Schlüssel der CA kennt, kann damit beliebige Serverzertifikate signieren. Deshalb wird diese Schlüsseldatei nicht im Klartext auf der Festplatte abgelegt, sondern mit einer Passphrase verschlüsselt. Diese Passphrase benötigst Du immer dann, wenn Du mit der CA neue Zertifikate ausstellen willst:
<nowiki>
Enter PEM pass phrase: sehrlangesgeheimespasswort
Verifying - Enter PEM pass phrase: sehrlangesgeheimespasswort</nowiki>
Nun werden wir gebeten, Daten einzugeben, welche die CA identifizieren. Diese werden dem Client angezeigt, wenn er aufgefordert wird, das Zertifikat zu akzeptieren oder abzulehnen. Der Code für Deutschland ist DE. Wenn Du ein Feld leer lassen möchtest, so gib einen Punkt ein. Ansonsten wird der in eckigen Klammern stehende Defaultwert eingetragen:
<nowiki>
-----
You are about to be asked to enter information that will be incorporated
into your certificate request.
What you are about to enter is what is called a Distinguished Name or a DN.
There are quite a few fields but you can leave some blank
For some fields there will be a default value,
If you enter '.', the field will be left blank.
-----
Country Name (2 letter code) [AU]: DE
State or Province Name (full name) [Some-State]:Brandenburg
Locality Name (eg, city) []:Potsdam
Organization Name (eg, company) [Internet Widgits Pty Ltd]:Familie AG
Organizational Unit Name (eg, section) []:EDV</nowiki>
Das Feld Common Name (CN) ist hier der offizielle Name der Zertifizierungsstelle. Für Dein eigenes CA kannst Du einfach Deinen eigenen Namen eintragen:
<nowiki>
Common Name (eg, YOUR name) []: Cool Tux
Email Address []: cooltux@gmail.tada</nowiki>
Fertig. Folgende zwei Dateien sind entstanden:
<nowiki>
root@linux# ll
insgesamt 9
drwxr-xr-x 2 root root 112 2006-04-30 12:08 .
drwx------ 12 root root 600 2006-04-30 11:54 ..
-rw-r--r-- 1 root root 1212 2006-04-30 12:08 cacert.pem
-rw-r--r-- 1 root root 963 2006-04-30 12:08 cakey.pem</nowiki>
Vorsichtshalber solltest Du die Rechte so setzen, dass die Schlüsseldatei nur für root lesbar ist:
<nowiki>
root@linux# chmod 600 cakey.pem</nowiki>
Du kannst nun ausprobieren, ob Du den Schlüssel mit der Passphrase wieder öffnen kannst:
<nowiki>
root@linux# openssl rsa -in cakey.pem -noout -text
Enter pass phrase for cakey.pem: wrzlprmpft
Private-Key: (1024 bit)
modulus:
00:d5:a5:37:51:e9:d9:fa:e3:97:e7:46:b2:88:1a:
b5:46:80:47:76:14:ae:2b:8b:3e:35:5c:ab:15:84:
53:d9:63:2e:7f:08:4b:ec:77:db:02:45:f8:c7:46:
58:cd:2d:f9:29:4d:96:3d:d8:6c:5d:9f:79:8a:04:
cf:b7:3a:89:da:a9:63:9f:44:b3:83:cf:0d:70:7d:</nowiki>
usw...

== 3. Schlüssel für das Serverzertifikat erzeugen ==
Nachdem wir nun eine eigene CA haben, kann diese nun endlich für unseren Server ein Zertifikat herausgeben. Dazu erzeugen wir zunächst einen 2048 Bit langen RSA Schlüssel, der mit AES 128 verschlüsselt auf der Platte abgelegt wird (ja wirklich, auch hier wieder ein verschlüsselter Schlüssel). Die Passphrase muss diesmal nicht sonderlich geheim sein, da wir sie ohnehin im Anschluss wieder entfernen werden. OpenSSL lässt allerdings keine leere Phrase zu:
<nowiki>
root@linux# openssl genrsa -out serverkey.pem -aes128 2048 -days 3650
Generating RSA private key, 2048 bit long modulus
....+++
.......................................+++
e is 65537 (0x10001)
Enter pass phrase for serverkey.pem: test
Verifying - Enter pass phrase for serverkey.pem: test</nowiki>
So. Nun entfernen wir die Passphrase wieder. Warum? Der Serverdienst (Apache, Cyrus, etc.) muss schließlich in der Lage sein, den Schlüssel ohne Dein Zutun zu lesen. Oder möchtest Du bei jedem Booten des Servers ein Passwort eingeben müssen?
<nowiki>
root@linux# openssl rsa -in serverkey.pem -out serverkey.pem
Enter pass phrase for serverkey.pem: jaja
writing RSA key</nowiki>

== 4. Certificate Signing Request erzeugen ==
Der nächste Schritt zum eigenen Zertifikat ist ein CSR. Dies muss dann nur noch von der CA signiert werden. Hier sind wieder Angaben analog zum Erstellen der CA nötig, was oft Verwirrung stiftet. Die allgemeinen Daten kann man ggfl. gleich wie oben eingeben:
<nowiki>
root@linux# openssl req -new -key serverkey.pem -out req.pem -nodes
You are about to be asked to enter information that will be incorporated
into your certificate request.
What you are about to enter is what is called a Distinguished Name or a DN.
There are quite a few fields but you can leave some blank
For some fields there will be a default value,
If you enter '.', the field will be left blank.
-----
Country Name (2 letter code) [AU]: DE
State or Province Name (full name) [Some-State]:Brandenburg
Locality Name (eg, city) []:Potsdam
Organization Name (eg, company) [Internet Widgits Pty Ltd]:Familie AG
Organizational Unit Name (eg, section) []:EDV</nowiki>
ACHTUNG, jetzt kommt das Wichtige: Beim Serverzertifikat ist der Common Name von entscheidender Bedeutung. Hier muss der DNS-Name stehen, unter dem der Client den Server anspricht! Wird das Zertifikat für eine HTTPS-Verbindung zu fhem.local verwendet, so muss der Common Name eben genau fhem.local heißen. Anderfalls wird der Browser das Zertifikat nicht akzeptieren, da er davon ausgehen muss, auf dem falschen Server gelandet zu sein.
<nowiki>
Common Name (eg, YOUR name) []: fhem.local
Email Address []: admin.fhem.local</nowiki>
Weitere Optionen kann man einfach leer lassen:
<nowiki>
A challenge password []:</nowiki>
An optional company name []:</nowiki>
Mittlerweile tummeln sich schon vier Dateien in unserem Verzeichnis:
<nowiki>
root@linux# ll
insgesamt 17
drwxr-xr-x 2 root root 168 2006-04-30 12:29 .
drwx------ 12 root root 600 2006-04-30 11:54 ..
-rw-r--r-- 1 root root 1212 2006-04-30 12:08 cacert.pem
-rw------- 1 root root 963 2006-04-30 12:08 cakey.pem
-rw-r--r-- 1 root root 1017 2006-04-30 12:29 req.pem
-rw-r--r-- 1 root root 1679 2006-04-30 12:21 serverkey.pem</nowiki>

== 5. OpenSSL-Konfiguration anpassen ==
Leider kann man bei OpenSSL nicht alle Daten als Kommandozeilenargumente übergeben. Einige Einstellungen muss man lästigerweise in der Datei /etc/ssl/openssl.cnf ändern, bevor man signieren kann. Öffne diese Datei und passe folgende Zeilen in der Sektion [ CA_default ] an:
<nowiki>
/etc/ssl/openssl.cnf:
dir = . # Where everything is kept
new_certs_dir = $dir # default place for new certs
private_key = $dir/cakey.pem # The private key
RANDFILE = $dir/.rand # private random number file
default_days = 3650 # how long to certify for</nowiki>
Das Feld default_days ist auf 365 Tage voreingestellt und gibt die Gültigkeit des Zertifikates an. Abgelaufene Zertifikate sind im Übrigen ein sehr häufiges Problem. Wenn es soweit ist, kennt sich damit nämlich schon lange keiner mehr aus. Deswegen kannst Du wie im Beispiel angegeben die Lebensdauer z.B. auf 10 Jahre heraufsetzen.

Nun muss man noch einige Dateien anlegen:
<nowiki>
root@linux# echo 01 > serial
root@linux# touch index.txt</nowiki>

== 6. Serverzertifikat signieren ==
Kommen wir zum feierlichen Abschluss: Unsere CA signiert nun das Zertifikat:
<nowiki>
root@linux# openssl ca -in req.pem -notext -out servercert.pem
Enter pass phrase for ./cakey.pem: langesgeheimespasswort

...

Certificate is to be certified until Apr 27 10:45:36 2016 GMT (3650 days)
Sign the certificate? [y/n]: y

1 out of 1 certificate requests certified, commit? [y/n] y
Write out database with 1 new entries
Data Base Updated</nowiki>

== 7. Zertifikate installieren ==
Wie Du das Zertifikat in FHEM installierst findest Du [[Raspberry_Pi_%26_HTTPS|hier]] und wenn Du ein Server Zertifikat für NGINX installieren möchtest findest Du Infos dazu [[HTTPS-Absicherung_%26_Authentifizierung_via_nginx_Webserver|hier]]

= Nachwort =
== Einbinden der root CA in die Zertifizierungsstelle des Browsers ==
Beim Firefox importieren wir unsere servercert.pem unter Einstellungen -> Erweitert -> Zertifikate -> Zertifikate anzeigen -> Zertifizierungsstellen ein.
Unter Chrome/Chromium finden wir die Zertifikatsverwaltung unter Einstellungen -> Erweitert -> Zertifikate verwalten HTTPS/SSL-Zertifikate und -Einstellungen verwalten -> Zertifizierungsstellen

== Bekannte Probleme ==
Für den Chrome/Chromium müssen wir zusätzlich "Subject Alternative Names (SAN)" in unser Zertifikat eintragen. Dies geschieht beim Serverzertifikat signieren. Dazu müssen wir uns eine weitere Datei anlegen:
<nowiki>
root@linux# vim oats.extensions.cnf

basicConstraints=CA:FALSE
subjectAltName=@my_subject_alt_names
subjectKeyIdentifier = hash

[ my_subject_alt_names ]
DNS.1 = fhem01.tuxnet.local
DNS.2 = fhem02.tuxnet.local
DNS.3 = fhem01-vpn.tuxnet.local</nowiki>
Die signierung unseres Serverzertifikates erfolgt dann mit folgendem Befehl:
<nowiki>
openssl ca -in req.pem -notext -extfile oats.extensions.cnf -out servercert.pem</nowiki>

== Prüfen von Zertifikaten ==
Zertifikate kann man im übrigen auf dieser [https://www.networking4all.com/en/ssl+certificates/csr+check/| Seite] prüfen lassen.
Dazu kopiert man den Inhalt der servercert.pem in das Eingabefeld der Seite und klickt dann auf Check CSR

FHEM mit HTTPS SSL-Zertifikat und eine eigene Zertifizierungsstelle

2017-11-14T14:03:31Z

CoolTux: Die Seite wurde neu angelegt: „= Vorwort = === Dein Anliegen === Du möchtest FHEM mit HTTPS betreiben, hasst es aber ständig von Deinem Browser darauf aufmerksam gemacht zu werden das dies…“

Gleitende Mittelwerte berechnen und loggen

2017-09-25T09:53:59Z

CoolTux: /* Subroutine movingAverage in 99_MyUtils anlegen */

Für verschiedene Wettersensoren ist es oftmals wünschenswert, gleitende Mittelwerte (fälschlich auch als "relative" Mittelwerte bezeichnet) über ein bestimmtes Zeitfenster auszugeben oder in den Logs zu speichern und zu plotten. Beispiele:
* Die momentanen Winddaten eines KS300 sind oft stark schwankend. Hier wäre ein Mittelwert z.B. der letzten 2-3 Stunden interessant.
* Für die Außentemperatur ist anhand eines Mittelwertes der letzten 24 Stunden evtl. ein gewisser Trend der generellen Entwicklung der Temperatur ableitbar.

Mit Modulen wie ''rain'' oder ''average'' ist konzeptbedingt nur ein Mittelwert von fixen Zeiträumen (aktueller Tag, Monat, etc.) möglich.

Im Nachfolgenden werden deshalb zwei Programme vorgestellt, die solche gleitenden Mittelwerte bereitstellen. Beide Programme werden in die Datei [[99 myUtils anlegen|99_MyUtils.pm]] eingetragen und dann von FHEM aufgerufen. Das erste Programm macht dies für beliebige Readings beliebiger Devices, das zweite Programm greift auf beliebige [[FileLog|File-]] oder [[DbLog|DbLogs]] zurück.

== Gleitender Mittelwert für beliebige Readings ==
=== Subroutine movingAverage in 99_MyUtils anlegen ===
Zuerst muss die Subroutine ''movingAverage'' in die 99_MyUtils übernommen werden. Wenn noch nicht vorhanden, sollte die Datei dann so aussehen:

<nowiki>package main;
use strict;
use warnings;
use POSIX;
sub
MyUtils_Initialize($$)
{
my ($hash) = @_;
}
###############################################################################
#
# Moving average
#
# Aufruf: movingAverage(devicename,readingname,zeitspanne in s)
#
###############################################################################

sub movingAverage($$$){
my ($name,$reading,$avtime) = @_;
my $hash = $defs{$name};
my @new = my ($val,$time) = (ReadingsVal($name,$reading,undef),ReadingsTimestamp($name,$reading,undef));
my ($cyear, $cmonth, $cday, $chour, $cmin, $csec) = $time =~ /(\d{4})-(\d{2})-(\d{2})\s(\d{2}):(\d{2}):(\d{2})/;
my $ctime = $csec+60*$cmin+3600*$chour;
my $num;
my $arr;
#-- initialize if requested
if( ($avtime eq "-1") ){
$hash->{helper}{history}=undef;
}
#-- test for existence
if( !$hash->{helper}{history}){
#Log 1,"ARRAY CREATED";
push(@{$hash->{helper}{history}},\@new);
$num = 1;
$arr=\@{$hash->{helper}{history}};
} else {
$num = int(@{$hash->{helper}{history}});
$arr=\@{$hash->{helper}{history}};
my $starttime = $arr->[0][1];
my ($syear, $smonth, $sday, $shour, $smin, $ssec) = $starttime =~ /(\d{4})-(\d{2})-(\d{2})\s(\d{2}):(\d{2}):(\d{2})/;
my $stime = $ssec+60*$smin+3600*$shour;
#-- correct for daybreak
$stime-=86400
if( $stime > $ctime);
if( ($num < 25)&&( ($ctime-$stime)<$avtime) ){
#Log 1,"ARRAY has $num elements, adding another one";
push(@{$hash->{helper}{history}},\@new);
}else{
shift(@{$hash->{helper}{history}});
push(@{$hash->{helper}{history}},\@new);
}
}
#-- output and average
my $average = 0;
for(my $i=0;$i<$num;$i++){
$average+=$arr->[$i][0];
Log 4,"[$name moving average] Value = ".$arr->[$i][0]." Time = ".$arr->[$i][1];
}
$average=sprintf( "%5.3f", $average/$num);
#--average
Log 4,"[$name moving average] calculated over $num values is $average";
return $average;
}
1;</nowiki>

=== Funktion movingAverage() aufrufen und nutzen ===
Bei jedem Aufruf schiebt die obige Funktion den gegenwärtigen Wert sowie den Zeitpunkt eines Readings (zweiter Parameter) ans Ende eines Arrays (maximal 25 Einträge) und wirft dafür den ersten Eintrag heraus. Die Anzahl der Einträge im Array wird so gewählt, dass die Zeitpunkte der Readings größer oder gleich der gewünschten Zeitspanne für die Mittelung sind. Über diese Werte wird dann gemittelt und der Wert zurückgegeben.

Zur Anwendung empfiehlt sich, dem gewünschten Device ein userReading zu geben:
:<code>attr devicename userReading readingname.av {movingAverage("devicename","readingname",zeitspanne)}</code>

Dieses wird dann automatisch bei jedem neuen Wert des Readings mit dem neuen gleitenden Mittelwert über die vergangene Zeitspanne gefüllt.

Beispiel: Das Reading "pressure" des Devices "A.OWB" wird alle 5 Minuten aktualisiert. Das Device bekommt nun ein userReading:
:<code>attr A.OWB userReading pressure.av {movingAverage("A.OWB","pressure",1800)}</code>

Dieses schreibt bei jeder Aktualisierung von "pressure" einen neuen Eintrag in sein Array - allerdings maximal sechs Werte, dann wird immer der älteste Eintrag gelöscht. Damit ist sichergestellt, dass diese mindestens 1800 Sekunden abdecken - also sechs Einträge.

== Gleitender Mittelwert aus Log-Dateien ==
=== Subroutine myAverage() in 99_MyUtils anlegen ===
Zuerst muss die Subroutine myAverage in die 99_MyUtils übernommen werden. Wenn noch nicht vorhanden, sollte die Datei dann so aussehen:

<nowiki>package main;
use strict;
use warnings;
use POSIX;
sub
MyUtils_Initialize($$)
{
my ($hash) = @_;
}
##########################################################
# myAverage
# berechnet den Mittelwert aus LogFiles über einen beliebigen Zeitraum
sub
myAverage($$$)
{
my ($offset,$logfile,$cspec) = @_;
my $period_s = strftime "%Y-%m-%d\x5f%H:%M:%S", localtime(time-$offset);
my $period_e = strftime "%Y-%m-%d\x5f%H:%M:%S", localtime;
my $oll = $attr{global}{verbose};
$attr{global}{verbose} = 0;
my @logdata = split("\n", fhem("get $logfile - - $period_s $period_e $cspec"));
$attr{global}{verbose} = $oll;
my ($cnt, $cum, $avg) = (0)x3;
foreach (@logdata){
my @line = split(" ", $_);
if(defined $line[1] && "$line[1]" ne ""){
$cnt += 1;
$cum += $line[1];
}
}
if("$cnt" > 0){$avg = sprintf("%0.1f", $cum/$cnt)};
Log 4, ("myAverage: File: $logfile, Field: $cspec, Period: $period_s bis $period_e, Count: $cnt, Cum: $cum, Average: $avg");
return $avg;
}
##########################################################
1;</nowiki>

=== Funktion myAverage() aufrufen und nutzen ===
Jetzt kann die Funktion <code>myAverage(<offset>, <logfile>, <column-spec>)</code> ganz normal auf der FHEM-Konsole (telnet localhost 7072) genutzt werden. Hier z.B. die Ausgabe des Mittelwertes des Windsensors, eines KS300, über die letzten drei Stunden (Angabe in 3*3600s) oder der Temperaturmittelwert der letzten 24 Stunden.

Mit FileLog:

<nowiki>fhem> {myAverage("10800", "FileLog_KS300", "8:::")}
6.3
fhem> {myAverage("86400", "FileLog_KS300", "4:::")}
-2.7
fhem></nowiki>

Mit DbLog:

<nowiki>fhem> {myAverage("10800", "myDbLog", "KS300:wind::")}
5.9
fhem> {myAverage("86400", "myDbLog", "KS300:temperature::")}
-2.7
fhem></nowiki>

Ähnlich ist die Verwendung in perl-Code in der [[Konfiguration|fhem.cfg]]:

<nowiki>my $avg = myAverage("10800", "FileLog_KS300", "8:::");;\</nowiki>
Ein [[notify]], welches bei jedem neuen Sensorwert die Mitteltemperatur der letzten 24 Stunden als Event "average-temp xy" ins Logfile schreibt, sieht dann wie folgt aus:

<nowiki>define KS300_T_notify notify KS300:temperature.* {\
fhem('trigger KS300 average-temp: '.myAverage("86400", "FileLog_KS300", "4:::"));;\
}</nowiki>


Analog dazu wäre mit den Winddaten zu verfahren.

=== Eigenes Filelog und Plot ===
==== Definitionen ====
Ich schreibe ein komplett eigenes Logfile und lasse über eine spezielle gplot-Definition die Temperatur- und Winddaten loggen und plotten.

<nowiki>define KS300_W dummy
define KS300_W_notify notify KS300:wind.* {\
my $avg = myAverage("10800", "FileLog_KS300", "8:::");;\
my $event = sprintf("Wc: %0.1f Wd: %0.1f Wm: %0.1f Wlh: %0.1f", ReadingsVal("KS300","wind","0"), ReadingsVal("KS300","W_avg_day","0"), ReadingsVal("KS300","W_avg_month","0"), $avg);;\
Log 2, ("K300_W: Event: $event");;\
fhem("trigger KS300_W data: $event");;\
fhem("trigger KS300 average-wind: $avg");;\
}
define FileLog_KS300_W FileLog ./log/KS300_W-%Y.log KS300_W.*
attr FileLog_KS300_W logtype text
attr FileLog_KS300_W room Logs
define KS300_TH dummy
define KS300_TH_notify notify KS300:temperature.* {\
my $avg = myAverage("86400", "FileLog_KS300", "4:::");;\
my $event = sprintf("Tc: %0.1f Hc: %0.1f Tavg: %0.1f", ReadingsVal("KS300","temperature","0"), ReadingsVal("KS300","humidity","0"), $avg);;\
Log 2, ("K300_TH: Event: $event");;\
fhem("trigger KS300_TH data: $event");;\
fhem('trigger KS300 average-temp: '.$avg);;\
}
define FileLog_KS300_TH FileLog ./log/KS300_TH-%Y.log KS300_TH.*
attr FileLog_KS300_TH logtype text
attr FileLog_KS300_TH room Logs</nowiki>
Die Definitionen für die Plots schauen so aus:

<nowiki>define weblink_KS300_W weblink fileplot FileLog_KS300_W:ks300_wind:CURRENT
attr weblink_KS300_W label "Wind - Min: $data{min1}, Max: $data{max1}, Last: $data{currval1}"
attr weblink_KS300_W room Dachterasse
define weblink_KS300_TH weblink fileplot FileLog_KS300_TH:ks300_temphum:CURRENT
attr weblink_KS300_TH label "Temperatur/Feuchte - Min: $data{min1}, Max: $data{max1}, Last: $data{currval1}"
attr weblink_KS300_TH room Dachterasse
define weblink_KS300_R weblink fileplot FileLog_KS300:ks300_rain10:CURRENT
attr weblink_KS300_R label "Regen - Min: $data{min1}, Max: $data{max1}, Last: $data{currval1}"
attr weblink_KS300_R room Dachterasse</nowiki>

==== Angepasste gplot-Dateien ====
Nun noch die speziellen gplot-Dateien.
ks300_wind.gplot

<nowiki>############################
# Display the wind values of a KS300.
# Corresponding FileLog definition:
# define <filelogname> FileLog ./log/KS300_W-%Y.log KS300_W.*
set terminal png transparent size <SIZE> crop
set output '<OUT>.png'
set xdata time
set timefmt "%Y-%m-%d_%H:%M:%S"
set xlabel " "
set ytics nomirror
#set y2tics
set ytics
set title '<L1>'
set grid xtics ytics
set yrange [0:]
set y2range [0:]
set ylabel "Wind (aktuell) [km/h]"
set y2label "Wind (gemittelt) [km/h]"
set format y2 "%0.1f"
#FileLog 5:Wc\x3a:0:
#FileLog 11:Wlh\x3a:0:
plot "<IN>" using 1:5 ls l7fill axes x1y1 title 'Wind (aktuell)' with lines,\
"<IN>" using 1:11 ls l5 axes x1y2 title 'Wind (3h-Mittel)' with steps,\</nowiki>

ks300_temphum.gplot

<nowiki>############################
# Display the Temperature und Humidity values of a KS300.
# Corresponding FileLog definition:
# define <filelogname> FileLog ./log/KS300_TH-%Y.log KS300_TH.*
set terminal png transparent size <SIZE> crop
set output '<OUT>.png'
set xdata time
set timefmt "%Y-%m-%d_%H:%M:%S"
set xlabel " "
set ytics nomirror
set y2tics
#set ytics
set title '<L1>'
set grid xtics y2tics
set y2label "Temperatur [°C]"
set ylabel "Luftfeuchte [%]"
#FileLog 5:Tc\x3a:0:
#FileLog 9:Tavg\x3a:0:
#FileLog 7:Hc\x3a:0:
plot "<IN>" using 1:5 axes x1y2 ls l0 title 'Temperatur' with lines,\
"<IN>" using 1:9 axes x1y2 ls l10 title 'Temperatur (24h-Mittel)' with lines,\
"<IN>" using 1:7 axes x1y1 ls l2fill title 'Luftfeuchte' with lines</nowiki>
Den Plot für den Regen habe ich noch um Punkt-Plots für den israining-Status erweitert, so dass Punkte bei "yes" geplottet werden.

ks300_rain10.gplot

<nowiki>############################
# Display the Rain values of a KS300.
# Corresponding FileLog definition:
# define <filelogname> FileLog ./log/KS300-%Y.log KS300:T:.*
set terminal png transparent size <SIZE> crop
set output '<OUT>.png'
set xdata time
set timefmt "%Y-%m-%d_%H:%M:%S"
set xlabel " "
set ytics nomirror
#set y2tics
set ytics
set title '<L1>'
set grid xtics ytics
set y2range [0.5:1.5]
set y2tics ("" 0, "Regen" 1)
set pointsize 7
set ylabel "Regen (l/m²)"
set yrange [0:]
# Computing Rain/h and Rain/d values by accumulating the changes.
#FileLog 10:IR\x3a:0:delta-h
#FileLog 10:IR\x3a:0:delta-d
#FileLog 12:IR:0:$fld[11]=~"yes"?1:0
plot "<grep -v avg_ <IN> | perl -ane '\
@a = split(\"[_:]\", $F[0]);\
if(defined($lh) && $lh ne $a[1])\
{ printf(\"${ld}_$lh:30:00 %f\n\", $hv); $hv = 0; }\
if($lv) { $hv += ($F[9]-$lv); }\
$lh = $a[1]; $ld = $a[0]; $lv = $F[9];\
END { printf(\"${ld}_$lh:30:00 %f\n\", $hv) }'"\
using 1:2 axes x1y1 ls l1fill title 'Regen pro Stunde' with histeps,\
"<grep -v avg_ <IN> | perl -ane '\
@a = split(\"[_]\", $F[0]);\
if(defined($ld) && $ld ne $a[0]) {\
printf(\"${ld}_12:00:00 %f\n\", $dv); $dv = 0; }\
if($lv) { $dv += ($F[9]-$lv); }\
$ld = $a[0]; $lv = $F[9];\
END {printf(\"${ld}_12:00:00 %f\n\", $dv)}'"\
using 1:2 axes x1y1 ls l7 title 'Regen pro Tag' with histeps
"<grep -v avg_ <IN> | awk '{print $1, $12==\"yes\"? 1 : 0; }'"\
using 1:2 axes x1y2 ls l11fill title 'Regen aktuell' with points</nowiki>
Eventuell müssen in den gplots noch die Linienstile/Farben den eigenen Bedürfnissen angepasst werden. Ich verwende hier eigene Farben und Füllungen.

[[Kategorie:HOWTOS]]
[[Kategorie:Code Snippets]]

FHEM startet nicht - Tipps zur Fehlersuche

2017-08-01T11:13:50Z

CoolTux: /* Fehlernachrichten von FHEM bei dessen Start analysieren */

'''Kein Zugriff auf FHEMWEB/FHEM startet nicht - Was kann ich tun???'''

Deine FHEMWEB-Seite ist nicht erreichbar? Ist FHEM tot, oder ist das Netzwerk kaputt? Was kann ich machen, um zu prüfen, woran es genau liegt?

In diesem Wiki Artikel soll es darum gehen, wie Du für Dich prüfen kannst, ob ein Fehler bei FHEM, im Netzwerk oder ein anderes Problem vorliegt.
== Prüfen: Läuft überhaupt ein FHEM-Prozess? ==
Man kann sich unter einem Linuxsystem sämtliche laufende Prozesse auflisten lassen

<code>ps ax</code>

Der Befehl ps listet je nach Argument alle laufende Prozesse auf. Die Liste kann man nun noch nach einem bestimmten Prozess filtern. Aufruf und Ausgabe einer Prozessliste mit einem Filter nach perl sieht z. B. so aus:

<code>ps ax | grep perl</code>

<code>cooltux@fhem01-cluster:~> ps ax | grep perl</code>

<code>11320 pts/0 S+ 0:00 grep --color=auto perl</code>

Wie wir sehen, wird hier lediglich der gerade ausgeführte Befehl ps gefunden (weil das Wort ''perl'' in der Aufrufzeile stand. Es wird hier überhaupt kein Perl-Prozess gelistet. Aktuell läuft also definitiv kein FHEM, das ja ein Perl-Programm/Prozess ist.

Eine Prozessliste mit einem laufenden FHEM-Prozess könnte so aussehen:

<code>[11:31 root@fhem01-cluster cooltux] > ps ax | grep perl</code>

<code>15852 ? R 2119:09 /usr/bin/perl fhem.pl configDB</code>

<code>21447 pts/0 S+ 0:00 grep perl</code>

FHEM (''perl fhem.pl ...'') ist in diesem Fall also aktiv.
== Prüfen: Ist der laufende FHEM-Prozess überlastet? ==
Ich sollte mir anschauen, ob der FHEM-Prozess vielleicht zu sehr ausgelastet ist, der Prozess also 100 Prozent CPU Auslastung produziert?

Ein weiterer Linuxbefehl ''pre'' wird uns hierbei behilflich sein:
<pre style="white-space: pre;">
[11:38 root@fhem01-cluster cooltux] > top
top - 11:38:18 up 11 days, 18:58, 1 user, load average: 1,07, 1,03, 1,00
Tasks: 125 total, 2 running, 123 sleeping, 0 stopped, 0 zombie
%Cpu(s): 24,9 us, 0,9 sy, 0,0 ni, 74,1 id, 0,0 wa, 0,0 hi, 0,1 si, 0,0 st
KiB Mem: 945524 total, 833532 used, 111992 free, 41552 buffers
KiB Swap: 102396 total, 46564 used, 55832 free. 496240 cached Mem
PID USER PR NI VIRT RES SHR S %CPU %MEM TIME+ COMMAND
15852 fhem 20 0 103652 82160 5068 R 100,0 8,7 2125:41 perl
21683 root 20 0 5740 2560 2092 R 1,0 0,3 0:00.37 top
19129 cooltux 20 0 86204 22348 3668 S 0,3 2,4 64:16.90 insync-portable
21350 cooltux 20 0 11436 2848 2248 S 0,3 0,3 0:00.10 sshd
1 root 20 0 23292 2368 1380 S 0,0 0,3 0:54.23 systemd
2 root 20 0 0 0 0 S 0,0 0,0 0:01.09 kthreadd
3 root 20 0 0 0 0 S 0,0 0,0 3:37.20 ksoftirqd/0
5 root 0 -20 0 0 0 S 0,0 0,0 0:00.00 kworker/0:0H
7 root 20 0 0 0 0 S 0,0 0,0 8:20.71 rcu_sched
8 root 20 0 0 0 0 S 0,0 0,0 0:00.00 rcu_bh
9 root rt 0 0 0 0 S 0,0 0,0 0:05.45 migration/0
</pre>
Hier können wir nun eindeutig erkennen, das unser FHEM die CPU mit 100 Prozent auslastet. FHEM hat also ein Problem!

Zum Vergleich ein FHEM/Perl-Prozess ohne Probleme:
<pre style="white-space: pre;">
[11:50 root@fhem01-cluster cooltux] > top
top - 11:50:33 up 11 days, 19:10, 1 user, load average: 0,84, 1,03, 1,00
Tasks: 133 total, 1 running, 132 sleeping, 0 stopped, 0 zombie
%Cpu(s): 0,6 us, 0,8 sy, 0,0 ni, 98,6 id, 0,0 wa, 0,0 hi, 0,0 si, 0,0 st
KiB Mem: 945524 total, 818344 used, 127180 free, 43748 buffers
KiB Swap: 102396 total, 46820 used, 55576 free. 489652 cached Mem
PID USER PR NI VIRT RES SHR S %CPU %MEM TIME+ COMMAND
22074 fhem 20 0 86424 68516 7200 S 1,3 7,2 0:47.64 perl
22294 root 20 0 5740 2564 2092 R 1,3 0,3 0:00.19 top
22296 fhem 20 0 86424 63556 2240 S 1,3 6,7 0:00.04 perl
22297 fhem 20 0 2088 408 328 S 0,7 0,0 0:00.02 ping
7 root 20 0 0 0 0 S 0,3 0,0 8:21.23 rcu_sched
1366 mysql 20 0 620608 157132 5736 S 0,3 16,6 70:12.59 mysqld
19481 root 20 0 0 0 0 S 0,3 0,0 0:02.35 kworker/3:0
1 root 20 0 23292 2408 1420 S 0,0 0,3 0:54.27 systemd
2 root 20 0 0 0 0 S 0,0 0,0 0:01.09 kthreadd
3 root 20 0 0 0 0 S 0,0 0,0 3:37.42 ksoftirqd/0
5 root 0 -20 0 0 0 S 0,0 0,0 0:00.00 kworker/0:0H
</pre>
== Und wenn sich gar nichts mehr tut? ==
=== Fehlernachrichten von FHEM bei dessen Start analysieren ===
In der Regel werden die Ausgaben von FHEM, auch die bei seinem Start, gemeinsam mit vielen anderen Nachrichten in ein Logfile geschrieben. Dort kann natürlich nach Ursachen geforscht werden.

Eine einfachere Auswertung wird möglich, wenn man diese Meldungen zeitweilig in einem Terminalfenster (das Ding, um Kommandozeilenbefehle einzugeben) angezeigt bekommt. Das erreicht man z.B. auf folgendem Weg:

# Starte ein Terminalfenster bzw. einen Terminalemulator
# Wechsle in das FHEM-Installationsverzeichnis (meist: ''/opt/fhem'')
#: <code>cd /opt/fhem</code>
# Erstelle eine Kopie Deiner fhem.cfg, z.B. fhem.cfg.debug
#: <code>cp fhem.cfg fhem.cfg.debug</code>
# Bearbeite diese Kopie fhem.cfg.debug nun, um die Meldungen in das Terminalfenster zu leiten, in dem der FHEM-Start versucht wird:
#: <code>nano ./fhem.cfg.debug</code>
#:
#: In der Zeile mit "attr global logfile" ist der Dateiname durch ein - (Minuszeichen) zu ersetzen. Dadurch werden die FHEM-Ausgaben auf STDOUT (in das Terminalfenster) geschrieben, und FHEM geht nicht in den Hintergrund.

# Starte FHEM im Terminalfenster '''mit der angepassten Konfigurationsdatei''':
#: <code>perl fhem.pl fhem.cfg.debug</code>
#: Das Terminalfenster nun nicht schliessen, die Meldungen tauchen hier auf.
#: ... Die Fehlermeldungen sind nun zu interpretieren. Gegebenenfalls kann man sie kopieren und als wichtige Information bei einer Hilfeanfrage (z.B. im Forum) verwenden.
# Wenn man genug analysiert hat, FHEM mit Ctrl-C/Strg-C stoppen

'''Neue Möglichkeit des debuggen'''

seit dem 01.08.2017 gibt es die Möglichkeit beim manuellen starten von FHEM den Schalter -d zu verwenden. Dieser startet FHEM mit global verbose 5 und gibt somit alle Meldungen aus

<code>
perl fhem.pl -d fhem.cfg
perl fhem.pl -d configDB
</code>

AMAD

2017-08-01T10:15:24Z

CoolTux: /* Bekannte Meldungen/Hinweise/Probleme */

{{Infobox Modul
|ModPurpose=Steuern von Adroidgeräten und Anzeige von bestimmten Informationen dieser Geräte
|ModType=d
|ModForumArea=Sonstige Systeme
|ModTechName=73_AMADCommBridge.pm, 74_AMADDevice.pm
|ModOwner=CoolTux ([http://forum.fhem.de/index.php?action=profile;u=13684 Forum] / [[Benutzer:CoolTux|Wiki]])
}}

= AMAD 4.0 [AMADNG] =
== 73_AMADCommBridge / 74_AMADDevice ==

= Vorwort =
=== Warum AMADNG ===
Nach fast 6 Monaten Entwicklungszeit wurde die neuste AMAD Version am 24.07.2017 offiziell frei gegeben. Diesmal lagen mir mehrere Dinge am Herzen.
In erster Linie wollte ich eine softwareseitige Trennung der AMADCommBridge vom eigentlichen Android Device. Daher ist die neue Version ein zweistufiges Modul geworden.
Im Laufe der Entwicklung kamen auch andere Anforderungen hinzu, welche ich dann fähig war um zu setzen. Eine dieser Anforderungen war eine einfachere und besser funktionierende Installation. Raus gekommen ist ein Android Installationsassistant.
Mit ihm wird auf einfache Art und Weise direkt per Sprachführung und Eingabedialogen Automagic für AMAD konfiguriert und das Device in FHEM automatisch erstellt. Autocreate!

= Vorstellung =
Dieses 2-stufige Modul liefert, '''in Verbindung mit der Android APP Automagic''', diverse Informationen von Android Geräten.
Die AndroidAPP Automagic (welche nicht von mir stammt und 2.90 Euro kostet) funktioniert wie Tasker, ist aber bei weitem User freundlicher.

=== Features / Funktionen ===
Im Auslieferiungszustand werden folgende Zustände dargestellt:
* installierte Android Version
* Zustand von Automagic auf dem Gerät
* Spracheingabe
* Bluetooth An/Aus
* Zustand einer definierten App (läuft aktiv im Vordergrund oder nicht?)
* verbundene Bluetoothgeräte, inklusive deren MAC Adresse
* aktuell abgespieltes Musikalbum des verwendeten Mediaplayers
* aktuell abgespielter Musikinterpret des verwendeten Mediaplayers
* aktuell abgespielter Musiktitel des verwendeten Mediaplayers
* Status des Androidgerätes - Online/Offline
* nächster Alarmtag
* nächste Alarmzeit
* Batteriestatus in %
* Ladestatus - Netztei angeschlossen / nicht angeschlossen
* Bildschirmstatus An/Aus
* Bildschirmhelligkeit
* Vollbildmodus An/Aus
* Bildschirmausrichtung Auto/Landscape/Portrait
* Standardlautstärke
* Media Lautstärke
* ...

Mit etwas Einarbeitung können jegliche Informationen welche Automagic bereit stellt, in FHEM angezeigt werden. Hierzu bedarf es lediglich eines eigenen Flows welcher seine Daten an die AMADCommBridge sendet. Das Modul gibt auch die Möglichkeit Androidgeräte zu steuern.

= AMADCommBridge - Kommunikationsbrücke für alle AMAD Geräte =
Dieses Modul ist das Ausgangsmodul zur erfolgreichen Integration von Androidgeräten in FHEM. Es stellt ferner eine Verbindungsebene zwischen AMAD unterstützten Geräten und FHEM zur Verfügung. Alle Kommunikation zwischen AMAD Android und FHEM läuft über diese Schnittstelle.
Daher erfolgt die Ersteinrichtung eines AMAD Devices auch genau über diese Modulinstanz.

Damit erfolgreich ein Androidgerät in FHEM eingerichtet werden kann, muss im ersten Schritt ein AMADCommBridge Device angelegt werden.

=== Definition in FHEM ===

<code>define <name> AMADCommBridge</code>

==== Beispiel ====

<code>define AMADBridge AMADCommBridge</code>

Diese Anweisung erstellt ein neues AMADCommBridge Device Namens AMADBridge.

Im folgenden muß lediglich das Flowset auf dem Android Gerät installiert werden und der Flow 'First Run Assistent' ausgeführt werden. (einfach den Homebutton drücken)
Der Assistent geleitet Dich dann durch die Einrichtung Deines AMAD Gerätes und sorgt dafür das am Ende des Installationsprozess das Androidgerät als AMAD Device in FHEM angelegt wird.

=== Readings ===
* JSON_ERROR - JSON Fehlermeldung welche von Perl gemeldet wird
* JSON_ERROR_STRING - der String welcher die JSON Fehlermeldung verursacht hat
* fhemServerIP - die Ip-Adresse des FHEM Servers, wird vom Modul auf Basis des JSON Strings vom Installationsassistenten gesetzt. Kann aber auch mittels set Befehles vom User gesetzt werden
* receiveFhemCommand - ist das Attribut fhemControlMode auf trigger gestellt, wird das Reading gesetzt sobald ein FHEM Befehl übersendet wird. Hierauf kann dann ein Notify triggern. Wird anstelle von trigger setControl als Wert für fhemControlMode eingestellt, wird das Reading nicht gestzt sondern der set Befehl sofort ausgeführt.
* receiveVoiceCommand - wird die Sprachsteuerung von AMAD aktiviert (set DEVICE activateVoiceInput) so wird der letzte erkannten Sprachbefehle in dieses Reading geschrieben.
* receiveVoiceDevice - Name des Devices von wo aus der letzte erkannte Sprachbefehl gesendet wurde
* state - Status der Bridge, open, closed

=== Attribute ===
* allowFrom - Regexp der erlaubten IP-Adressen oder Hostnamen. Wenn dieses Attribut gesetzt wurde, werden ausschließlich Verbindungen von diesen Adressen akzeptiert. Achtung: falls allowfrom nicht gesetzt ist, und keine gütige allowed Instanz definiert ist, und die Gegenstelle eine nicht lokale Adresse hat, dann wird die Verbindung abgewiesen. Folgende Adressen werden als local betrachtet: IPV4: 127/8, 10/8, 192.168/16, 172.16/10, 169.254/16, IPV6: ::1, fe80/10
* debugJSON - wenn auf 1 gesetzt, werden JSON Fehlermeldungen in Readings geschrieben. Siehe hierzu JSON_ERROR* unter Readings
* fhemControlMode - steuert die zulässige Art der Kontrolle von FHEM Devices. Du kannst über die Bridge auf 2 Arten FHEM Devices steuern. Entweder per direktem FHEM Befehl aus einem Flow heraus, oder als Sprachbefehl mittels Sprachsteuerung (set DEVICE activateVoiceInput)
** trigger - ist der Wert trigger gesetzt, werden alle an die Bridge gesendeten FHEM set Befehle in das Reading receiveFhemCommand geschrieben und können so mittels notify ausgeführt werden. Sprachsteuerung ist möglich, es werden Readings receiveVoice* gesetzt. Auf dem Androidgerät können bei Sprachsteuerung mehrere Sprachbefehle mittels "und" verknüpft/aneinander gereiht werden. Bsp: schalte die Lichtszene Abends an und schalte den Fernsehr an
** setControl - alle set Befehle welche mittels eines Flows über die Bridge gesendet werden, werden automatisch ausgeführt. Das triggern eines Readings ist nicht nötig. Die Steuerung mittels Sprache verhält sich wie beim Wert trigger
** thirdPartControl - verhält sich wie trigger, bei der Sprachsteuerung ist jedoch ein anreihen von Sprachbefehlen mittels "und" nicht möglich. Dient der Sprachsteuerung über Module anderer Modulautoren ((z.B. 39_TEERKO.pm)

= AMADDevice - Automagic Android Device =
Dieses Modul liefert, in Verbindung mit der Android APP Automagic, diverse Informationen von Android Geräten. Die AndroidAPP Automagic (welche nicht von mir stammt und 2.90 Euro kostet) funktioniert wie Tasker, ist aber bei weitem User freundlicher.
Mit etwas Einarbeitung können jegliche Informationen welche Automagic bereit stellt in FHEM angezeigt werden. Hierzu bedarf es lediglich eines eigenen Flows welcher seine Daten an die AMADDeviceCommBridge sendet. Das Modul gibt auch die Möglichkeit Androidgeräte zu steuern.
Für all diese Aktionen und Informationen wird auf dem Androidgerät "Automagic" und ein so genannter Flow benötigt. Die App ist über den Google PlayStore zu beziehen. Das benötigte Flowset bekommt man aus dem FHEM Verzeichnis.

=== Wie genau verwendet man nun AMADDevice? ===
* stelle sicher das als aller erstes die AMADCommBridge in FHEM definiert wurde
* installiere die App "Automagic Premium" aus dem PlayStore.
* installiere das Flowset 74_AMADDeviceautomagicFlowset$VERSION.xml aus dem Ordner $INSTALLFHEM/FHEM/lib/ auf dem Androidgerät
* aktiviere den Installationsassistanten Flow in Automagic. Wenn man nun Automagic in den Hintergrund schickt, z.B. Hometaste drücken, startet der Assistant und legt automatisch ein Device für das Androidgerät an.

=== Ein AMADDevice Gerät von Hand anlegen. ===

Define

<code>define <name> AMADDevice <IP-ADRESSE> <AMAD_ID> IODev=<IODEVICE> </code>

==== Beispiel ====

<code>define WandTabletWohnzimmer AMADDevice 192.168.0.23 123456 IODev=NAME_des_AMADCommBridge_Devices</code>

In diesem Fall wird ein AMADDevice von Hand angelegt. Die AMAD_ID, hier 123456, muß auch exakt so als globale Variable in Automagic eingetragen sein.

=== Readings ===
* airplanemode - Status des Flugmodus
* androidVersion - aktuell installierte Androidversion
* automagicState - Statusmeldungen von der AutomagicApp '''(Voraussetzung Android >4.3). Ist Android größer 4.3 vorhanden und im Reading steht "wird nicht unterstützt", muß in den Androideinstellungen unter Ton und Benachrichtigungen -> Benachrichtigungszugriff ein Haken für Automagic gesetzt werden'''
* batteryHealth - Zustand der Battery (1=unbekannt, 2=gut, 3=Überhitzt, 4=tot, 5=Überspannung, 6=unbekannter Fehler, 7=kalt)
* batterytemperature - Temperatur der Batterie
* bluetooth - on/off, Bluetooth Status an oder aus
* checkActiveTask - Zustand einer zuvor definierten APP. 0=nicht aktiv oder nicht aktiv im Vordergrund, 1=aktiv im Vordergrund, '''siehe Hinweis unten'''
* connectedBTdevices - eine Liste der verbundenen Gerät
* connectedBTdevicesMAC - eine Liste der MAC Adressen aller verbundender BT Geräte
* currentMusicAlbum - aktuell abgespieltes Musikalbum des verwendeten Mediaplayers
* currentMusicApp - aktuell verwendeter Mediaplayer (Amazon Music, Google Play Music, Google Play Video, Spotify, YouTube, TuneIn Player, Aldi Life Music)
* currentMusicArtist - aktuell abgespielter Musikinterpret des verwendeten Mediaplayers
* currentMusicIcon - Cover vom aktuell abgespielten Album '''Noch nicht fertig implementiert'''
* currentMusicState - Status des aktuellen/zuletzt verwendeten Mediaplayers
* currentMusicTrack - aktuell abgespielter Musiktitel des verwendeten Mediaplayers
* daydream - on/off, Daydream gestartet oder nicht
* deviceState - Status des Androidgerätes. unknown, online, offline.
* doNotDisturb - aktueller Status des nicht stören Modus
* dockingState - undocked/docked Status ob sich das Gerät in einer Dockinstation befindet.
* flow_SetCommands - active/inactive, Status des SetCommands Flow
* flow_informations - active/inactive, Status des Informations Flow
* flowsetVersionAtDevice - aktuell installierte Flowsetversion auf dem Device
* incomingCallerName - Anrufername des eingehenden Anrufes
* incomingCallerNumber - Anrufernummer des eingehenden Anrufes
* incommingWhatsAppMessageFrom - letzte WhatsApp Nachricht
* incommingWhatsTelegramMessageFrom - letzte Telegram Nachricht
* intentRadioName - zuletzt gesrreamter Intent Radio Name
* intentRadioState - Status des IntentRadio Players
* keyguardSet - 0/1 Displaysperre gesetzt 0=nein 1=ja, bedeutet nicht das sie gerade aktiv ist
* lastSetCommandError - letzte Fehlermeldung vom set Befehl
* lastSetCommandState - letzter Status vom set Befehl, Befehl erfolgreich/nicht erfolgreich gesendet
* lastStatusRequestError - letzte Fehlermeldung vom statusRequest Befehl
* lastStatusRequestState - letzter Status vom statusRequest Befehl, Befehl erfolgreich/nicht erfolgreich gesendet
* nextAlarmDay - aktiver Alarmtag
* nextAlarmState - aktueller Status des "Androidinternen" Weckers
* nextAlarmTime - aktive Alarmzeit
* powerLevel - Status der Batterie in %
* powerPlugged - Netzteil angeschlossen? 0=NEIN, 1|2=JA
* screen - on locked/unlocked, off locked/unlocked gibt an ob der Bildschirm an oder aus ist und gleichzeitig gesperrt oder nicht gesperrt
* screenBrightness - Bildschirmhelligkeit von 0-255
* screenFullscreen - on/off, Vollbildmodus (An,Aus)
* screenOrientation - Landscape,Portrait, Bildschirmausrichtung (Horizontal,Vertikal)
* screenOrientationMode - auto/manual, Modus für die Ausrichtung (Automatisch, Manuell)
* state - aktueller Status
* userFlowState - aktueller Status eines Flows, festgelegt unter dem setUserFlowState Attribut
* volume - Media Lautstärkewert
* volumeNotification - Benachrichtigungs Lautstärke

Beim Reading checkActivTask muß zuvor der Packagename der zu prüfenden App als Attribut checkActiveTask angegeben werden. Beispiel: attr Nexus10Wohnzimmer checkActiveTask com.android.chrome für den Chrome Browser.

=== Set ===
* activateVoiceInput - aktiviert die Spracheingabe
* bluetooth - on/off, aktiviert/deaktiviert Bluetooth
* clearNotificationBar - All,Automagic, löscht alle Meldungen oder nur die Automagic Meldungen in der Statusleiste
* closeCall - beendet einen laufenden Anruf
* currentFlowsetUpdate - fürt ein Flowsetupdate auf dem Device durch
* doNotDisturb - schaltet den nicht stören Modus, always immer stören, never niemals stören, alarmClockOnly nur Wecker darf stören, onlyImportant nur wichtige Störungen
* installFlowSource - installiert einen Flow auf dem Device, das XML File muss unter /tmp/ liegen und die Endung xml haben. Bsp: set TabletWohnzimmer installFlowSource WlanUebwerwachen.xml
* mediaAmazonMusic - play, stop, next, back ,steuert den Amazon Musik Mediaplayer
* mediaGoogleMusic - play, stop, next, back ,steuert den Google Play Musik Mediaplayer
* mediaSpotifyMusic - play, stop, next, back ,steuert den Spotify Mediaplayer
* mediaTuneinRadio - play, stop, next, back ,steuert den TuneIn Radio Mediaplayer
* mediaAldiMusic - play, stop, next, back ,steuert den Aldi Musik Mediaplayer
* mediaAudible - play, stop, next, back ,steuert den Audible Mediaplayer
* mediaYouTube - play, stop, next, back ,steuert den YouTube Mediaplayer
* mediaVlcPlayer - play, stop, next, back ,steuert den VLC Mediaplayer
* nextAlarmTime - setzt die Alarmzeit. gilt aber nur innerhalb der nächsten 24Std.
* openCall - ruft eine Nummer an und legt optional nach X Sekunden auf / set DEVICE openCall 01736458 10 / ruft die Nummer an und beendet den Anruf nach 10s
* screen - on/off/lock/unlock schaltet den Bildschirm ein/aus oder sperrt/entsperrt ihn
* screenBrightness - setzt die Bildschirmhelligkeit, von 0-255.
* screenMsg - versendet eine Bildschirmnachricht
* sendintent - sendet einen Intentstring Bsp: set $AMADDeviceDEVICE sendIntent org.smblott.intentradio.PLAY url http://stream.klassikradio.de/live/mp3-192/stream.klassikradio.de/play.m3u name Klassikradio, der erste Befehl ist die Aktion und der zweite das Extra. Es können immer zwei Extras mitgegeben werden.
* sendSMS - sendet eine SMS an eine bestimmte Telefonnummer. Bsp.: sendSMS Dies ist ein Test|555487263
* startDaydream - startet den Daydream
* statusRequest - Fordert einen neuen Statusreport beim Device an. Es können nicht von allen Readings per statusRequest die Daten geholt werden. Einige wenige geben nur bei Statusänderung ihren Status wieder.
* timer - setzt einen Timer innerhalb der als Standard definierten ClockAPP auf dem Device. Es können nur Sekunden angegeben werden.
* ttsMsg - versendet eine Nachricht welche als Sprachnachricht ausgegeben wird
* userFlowState - aktiviert oder deaktiviert einen oder mehrere Flows,'''set Nexus7Wohnzimmer Badezimmer vorheizen:inactive oder set Nexus7Wohnzimmer Badezimmer vorheizen,Nachtlicht Steven:inactive'''
* vibrate - lässt das Androidgerät vibrieren
* volume - setzt die Medialautstärke. Entweder die internen Lautsprecher oder sofern angeschlossen die Bluetoothlautsprecher und per Klinkenstecker angeschlossene Lautsprecher, + oder - vor dem Wert reduziert die aktuelle Lautstärke um den Wert. Der maximale Sliderwert kann über das Attribut setVolMax geregelt werden.
* volumeUp - erhöh;t die Lautstärke um den angegeben Wert im entsprechenden Attribut. Ist kein Attribut angegeben wird per default 2 genommen.
* volumeDown - reduziert die Lautstärke um den angegeben Wert im entsprechenden Attribut. Ist kein Attribut angegeben wird per default 2 genommen.
* volumeNotification - setzt die Benachrichtigungslautstärke.

==== Set abhängig von gesetzten Attributen ====
* changetoBtDevice - wechselt zu einem anderen Bluetooth Gerät. Attribut setBluetoothDevice muß gesetzt sein. Siehe Hinweis unten!
* notifySndFile - spielt die angegebene Mediadatei auf dem Androidgerät ab. Die aufzurufende Mediadatei sollte sich im Ordner /storage/emulated/0/Notifications/ befinden. Ist dies nicht der Fall kann man über das Attribut setNotifySndFilePath einen Pfad vorgeben.
* openApp - öffnet eine ausgewählte App. Attribut setOpenApp
* openURL - öffnet eine URL im Standardbrowser, sofern kein anderer Browser über das Attribut setOpenUrlBrowser ausgewählt wurde. Bsp: attr Tablet setOpenUrlBrowser de.ozerov.fully|de.ozerov.fully.MainActivity, das erste ist der Package Name und das zweite der Class Name
* setAPSSID - setzt die AccessPoint SSID um ein WLAN sleep zu verhindern
* setScreenOnForTimer ändert die Zeit wie lange das Display an bleiben soll!
* screenFullscreen - on/off, (aktiviert/deaktiviert) den Vollbildmodus. Attribut setFullscreen
* screenLock - Sperrt den Bildschirm mit Pinabfrage. Attribut setScreenlockPIN - hier die Pin dafür eingeben. Erlaubt sind nur Zahlen. Es müßen mindestens 4, bis max 16 Zeichen verwendet werden.
* screenOrientation - Auto,Landscape,Portait, aktiviert die Bildschirmausrichtung (Automatisch,Horizontal,Vertikal). Attribut setScreenOrientation
* system - setzt Systembefehle ab (nur bei gerootetet Geräen). reboot,shutdown,airplanemodeON (kann nur aktiviert werden) Attribut root, in den Automagic Einstellungen muss "Root Funktion" gesetzt werden
* setNotifySndFilePath - setzt den korrekten Systempfad zur Notifydatei (default ist /storage/emulated/0/Notifications/
* setTtsMsgSpeed - setzt die Sprachgeschwindigkeit bei der Sprachausgabe(Werte zwischen 0.5 bis 4.0 in 0.5er Schritten) default ist 1.0
* setTtsMsgSpeed - setzt die Sprache bei der Sprachausgabe, de oder en (default ist de)
* setVolUpDownStep - setzt den Step für volumeUp und volumeDown
* setVolMax - setzt die maximale Volume Gr&uoml;e für den Slider
* setNotifyVolMax - setzt den maximalen Lautstärkewert für Benachrichtigungslautstärke für den Slider
* setRingSoundVolMax - setzt den maximalen Lautstärkewert für Klingellautstärke für den Slider

'''Um openApp verwenden zu können, muss als Attribut der Package Name der App angegeben werden.

'''Um zwischen Bluetoothgeräten wechseln zu können, muß das Attribut setBluetoothDevice mit folgender Syntax gesetzt werden. attr <DEVICE> BTdeviceName1|MAC,BTDeviceName2|MAC Es muss zwingend darauf geachtet werden das beim BTdeviceName kein Leerzeichen vorhanden ist. Am besten zusammen oder mit Unterstrich. Achtet bei der MAC darauf das Ihr wirklich nach jeder zweiten Zahl auch einen : drin habt

** '''Beispiel: attr Nexus10Wohnzimmer setBluetoothDevice Logitech_BT_Adapter|AB:12:CD:34:EF:32,Anker_A3565|GH:56:IJ:78:KL:76

=== state ===
* initialized - Ist der Status kurz nach einem define.
* active - die Geräteinstanz ist im aktiven Status.
* disabled - die Geräteinstanz wurde über das Attribut disable deaktiviert

==Anwendungsbeispiele==
=== Lademanagement ===
Ich habe die Ladegeräte für meine Androidgeräte an Funkschaltsteckdosen. ein DOIF schaltet bei unter 30% die Steckdose ein und bei über 90% wieder aus.

Hier mal ein einfaches DOIF Beispiel für ein Lademanagment

<code>
... DOIF ([Nexus5Handy:powerLevel] < 30) (set LadenetzteilNexus5Handy:FILTER=STATE=off on) DOELSEIF ([Nexus5Handy:powerLevel] > 90) (set LadenetzteilNexus5Handy:FILTER=STATE=on off) DOELSE
</code>

=== Wecker ===
Morgens lasse ich mich über mein Tablet im Schlafzimmer mit Musik wecken. Verwendet wird hierzu der wakeuptimer des RESIDENTS Modules. Das abspielen stoppe ich dann von Hand. Danach erfolgt noch eine Ansage wie das Wetter gerade ist und wird.

=== Mediacenter ===
Mein 10" Tablet im Wohnzimmer ist Mediaplayer für das Wohnzimmer mit Bluetoothlautsprechern. Die Lautstärke wird automatisch runter gesetzt wenn die Fritzbox einen Anruf auf das Wohnzimmer Handgerät signalisiert.

=== Sprachbefehl - Abfragen von Zuständen diverser Sensoren ===
Wenn ich die Spracheingabe aktiviere und nach der Temperatur im Wohnzimmer frage, bekomme ich diese angesagt.

Der Teil im Feld Daten ist ein klassisches RadingsVal, halt nur ohne Komma und ohne Anführungszeichen

WIRD GERADE ÜBERARBEITET

=== Schaltbefehle vom Androidgerät an FHEM senden ===
Hierfür richte bitte einen eigen Flow ein. Wie das genau geht, verrät Dir die Hilfe.
Um einen Schaltbefehl für FHEM zu erstellen, folgt nach dem Trigger eine Aktion als Script (Aktion Type: Script). Hier trägst Du folgendes ein

setcmd = "LichtWohnzimmerLampeRechts on"

fhemcmd = "set"

In der ersten Zeile wird also der Schaltbefehl in der Variablem setcmd eingetragen und in der zweiten Zeile der FHEM Befehl in der Variablen fhemcmd.

Danach müsst Ihr nur noch in einer weiteren Aktion den Flow "Send Data to AMADCommBridge" ausführen (Aktion Type: Flows ausführen). Die Aktion sollte bereits in Eurer Liste Vorhanden sein.

[[Datei:Screenshot_20160717-134948.png|200px]]
[[Datei:Screenshot 17.07.2016 1-50-27.png|200px]]

Nun sollte Lampe1 angeschalten werden wenn der Flow ausgeführt wird.

=== Lister aller Variablen für die AMADCommandBridge ===
fhemcmd Variable
* Wert "set" - Variable für den Schaltbefehl 'setcmd'
* Wert "setreading" - Variable für die Readingswerte 'fhemdata'
* "readingsval" - Variable für die Abfragewerte 'readingsvalcmd'
* "fhemfunc" - Variable für den Funktionsnamen 'fhemsub'

'''Beispiele für Skriptinhalte:'''

Schalten einer Lampe

<code>
setcmd = "LichtWohnzimmerLampeRechts on";

fhemcmd = "set"
</code>

Status eines Device abfragen

<code>
readingsvalcmd = "DEVICE READING DEFAULT";

fhemcmd = "readingsval"
</code>

Die Rückgabevariable welche dann weiter verarbeitet werden kann, heißt '''respreadingsval'''

Aufruf einer 99_myUtils Subroutine

<code>
fhemsub = "mySub()"; oder natürlich auch "mySub('was_auch_immer')"

fhemcmd = "fhemfunc"
</code>

Die Rückgabevariable welche dann weiter verarbeitet werden kann, heißt '''respfhemfunc'''

== Bekannte Meldungen/Hinweise/Probleme ==

Wenn auf dem Android-Gerät die Fehlermeldung 'Accessibility service not running' von Automagic kommt, oder im FHEM das reading state 'Flow Informations mit Fehler beendet' steht, dann muss der Accessibility Service auf dem Android-Device aktiviert werden: Einstellungen --> Bedienungshilfen --> Automagic Premium. Hier muss der Schalter auf 'an' stehen. Sollte dies der Fall sein, hilft u.U. ein kurzes Aus- und wieder Einschalten.

Gerät wird oft als offline angezeigt und es können keine set Befehle abgesetzt werden.
Mit der AMAD Version 2.2 hielt eine neue Behandlung des deviceState Readings Einzug. Das Reading stellt nun den tatsächlichen Status des Gerätes gegenüber FHEM da. Bei vielen Android 6 Geräten kommt es aber auf Grund vom DeepSleep Modus zum wegfall der WLAN Verbindung. Hier hilft die neue KeepAlive Funktion in AMAD. Dafür muß lediglich unter
* Einstellungen --> Akku --> oben auf die drei Punkte - Akku Leistungsoptimierung --> alle Apps und dann Automagic auswählen und "Nicht optimieren"
ausgewählt werden und in FHEM für das Device das Attribut setAPSSID gesetzt werden. Alles andere macht das Modul selbst.

AMAD

2017-08-01T10:13:14Z

CoolTux: /* Anwendungsbeispiele */

AMAD

2017-07-25T12:10:10Z

CoolTux: /* Ein AMADDevice Gerät von Hand anlegen. */

{{Infobox Modul
|ModPurpose=Steuern von Adroidgeräten und Anzeige von bestimmten Informationen dieser Geräte
|ModType=d
|ModForumArea=Sonstige Systeme
|ModTechName=73_AMADCommBridge.pm, 74_AMADDevice.pm
|ModOwner=CoolTux ([http://forum.fhem.de/index.php?action=profile;u=13684 Forum] / [[Benutzer:CoolTux|Wiki]])
}}

= AMAD 4.0 [AMADNG] =
== 73_AMADCommBridge / 74_AMADDevice ==

= Vorwort =
=== Warum AMADNG ===
Nach fast 6 Monaten Entwicklungszeit wurde die neuste AMAD Version am 24.07.2017 offiziell frei gegeben. Diesmal lagen mir mehrere Dinge am Herzen.
In erster Linie wollte ich eine softwareseitige Trennung der AMADCommBridge vom eigentlichen Android Device. Daher ist die neue Version ein zweistufiges Modul geworden.
Im Laufe der Entwicklung kamen auch andere Anforderungen hinzu, welche ich dann fähig war um zu setzen. Eine dieser Anforderungen war eine einfachere und besser funktionierende Installation. Raus gekommen ist ein Android Installationsassistant.
Mit ihm wird auf einfache Art und Weise direkt per Sprachführung und Eingabedialogen Automagic für AMAD konfiguriert und das Device in FHEM automatisch erstellt. Autocreate!

= Vorstellung =
Dieses 2-stufige Modul liefert, '''in Verbindung mit der Android APP Automagic''', diverse Informationen von Android Geräten.
Die AndroidAPP Automagic (welche nicht von mir stammt und 2.90 Euro kostet) funktioniert wie Tasker, ist aber bei weitem User freundlicher.

=== Features / Funktionen ===
Im Auslieferiungszustand werden folgende Zustände dargestellt:
* installierte Android Version
* Zustand von Automagic auf dem Gerät
* Spracheingabe
* Bluetooth An/Aus
* Zustand einer definierten App (läuft aktiv im Vordergrund oder nicht?)
* verbundene Bluetoothgeräte, inklusive deren MAC Adresse
* aktuell abgespieltes Musikalbum des verwendeten Mediaplayers
* aktuell abgespielter Musikinterpret des verwendeten Mediaplayers
* aktuell abgespielter Musiktitel des verwendeten Mediaplayers
* Status des Androidgerätes - Online/Offline
* nächster Alarmtag
* nächste Alarmzeit
* Batteriestatus in %
* Ladestatus - Netztei angeschlossen / nicht angeschlossen
* Bildschirmstatus An/Aus
* Bildschirmhelligkeit
* Vollbildmodus An/Aus
* Bildschirmausrichtung Auto/Landscape/Portrait
* Standardlautstärke
* Media Lautstärke
* ...

Mit etwas Einarbeitung können jegliche Informationen welche Automagic bereit stellt, in FHEM angezeigt werden. Hierzu bedarf es lediglich eines eigenen Flows welcher seine Daten an die AMADCommBridge sendet. Das Modul gibt auch die Möglichkeit Androidgeräte zu steuern.

= AMADCommBridge - Kommunikationsbrücke für alle AMAD Geräte =
Dieses Modul ist das Ausgangsmodul zur erfolgreichen Integration von Androidgeräten in FHEM. Es stellt ferner eine Verbindungsebene zwischen AMAD unterstützten Geräten und FHEM zur Verfügung. Alle Kommunikation zwischen AMAD Android und FHEM läuft über diese Schnittstelle.
Daher erfolgt die Ersteinrichtung eines AMAD Devices auch genau über diese Modulinstanz.

Damit erfolgreich ein Androidgerät in FHEM eingerichtet werden kann, muss im ersten Schritt ein AMADCommBridge Device angelegt werden.

=== Definition in FHEM ===

<code>define <name> AMADCommBridge</code>

==== Beispiel ====

<code>define AMADBridge AMADCommBridge</code>

Diese Anweisung erstellt ein neues AMADCommBridge Device Namens AMADBridge.

Im folgenden muß lediglich das Flowset auf dem Android Gerät installiert werden und der Flow 'First Run Assistent' ausgeführt werden. (einfach den Homebutton drücken)
Der Assistent geleitet Dich dann durch die Einrichtung Deines AMAD Gerätes und sorgt dafür das am Ende des Installationsprozess das Androidgerät als AMAD Device in FHEM angelegt wird.

=== Readings ===
* JSON_ERROR - JSON Fehlermeldung welche von Perl gemeldet wird
* JSON_ERROR_STRING - der String welcher die JSON Fehlermeldung verursacht hat
* fhemServerIP - die Ip-Adresse des FHEM Servers, wird vom Modul auf Basis des JSON Strings vom Installationsassistenten gesetzt. Kann aber auch mittels set Befehles vom User gesetzt werden
* receiveFhemCommand - ist das Attribut fhemControlMode auf trigger gestellt, wird das Reading gesetzt sobald ein FHEM Befehl übersendet wird. Hierauf kann dann ein Notify triggern. Wird anstelle von trigger setControl als Wert für fhemControlMode eingestellt, wird das Reading nicht gestzt sondern der set Befehl sofort ausgeführt.
* receiveVoiceCommand - wird die Sprachsteuerung von AMAD aktiviert (set DEVICE activateVoiceInput) so wird der letzte erkannten Sprachbefehle in dieses Reading geschrieben.
* receiveVoiceDevice - Name des Devices von wo aus der letzte erkannte Sprachbefehl gesendet wurde
* state - Status der Bridge, open, closed

=== Attribute ===
* allowFrom - Regexp der erlaubten IP-Adressen oder Hostnamen. Wenn dieses Attribut gesetzt wurde, werden ausschließlich Verbindungen von diesen Adressen akzeptiert. Achtung: falls allowfrom nicht gesetzt ist, und keine gütige allowed Instanz definiert ist, und die Gegenstelle eine nicht lokale Adresse hat, dann wird die Verbindung abgewiesen. Folgende Adressen werden als local betrachtet: IPV4: 127/8, 10/8, 192.168/16, 172.16/10, 169.254/16, IPV6: ::1, fe80/10
* debugJSON - wenn auf 1 gesetzt, werden JSON Fehlermeldungen in Readings geschrieben. Siehe hierzu JSON_ERROR* unter Readings
* fhemControlMode - steuert die zulässige Art der Kontrolle von FHEM Devices. Du kannst über die Bridge auf 2 Arten FHEM Devices steuern. Entweder per direktem FHEM Befehl aus einem Flow heraus, oder als Sprachbefehl mittels Sprachsteuerung (set DEVICE activateVoiceInput)
** trigger - ist der Wert trigger gesetzt, werden alle an die Bridge gesendeten FHEM set Befehle in das Reading receiveFhemCommand geschrieben und können so mittels notify ausgeführt werden. Sprachsteuerung ist möglich, es werden Readings receiveVoice* gesetzt. Auf dem Androidgerät können bei Sprachsteuerung mehrere Sprachbefehle mittels "und" verknüpft/aneinander gereiht werden. Bsp: schalte die Lichtszene Abends an und schalte den Fernsehr an
** setControl - alle set Befehle welche mittels eines Flows über die Bridge gesendet werden, werden automatisch ausgeführt. Das triggern eines Readings ist nicht nötig. Die Steuerung mittels Sprache verhält sich wie beim Wert trigger
** thirdPartControl - verhält sich wie trigger, bei der Sprachsteuerung ist jedoch ein anreihen von Sprachbefehlen mittels "und" nicht möglich. Dient der Sprachsteuerung über Module anderer Modulautoren ((z.B. 39_TEERKO.pm)

= AMADDevice - Automagic Android Device =
Dieses Modul liefert, in Verbindung mit der Android APP Automagic, diverse Informationen von Android Geräten. Die AndroidAPP Automagic (welche nicht von mir stammt und 2.90 Euro kostet) funktioniert wie Tasker, ist aber bei weitem User freundlicher.
Mit etwas Einarbeitung können jegliche Informationen welche Automagic bereit stellt in FHEM angezeigt werden. Hierzu bedarf es lediglich eines eigenen Flows welcher seine Daten an die AMADDeviceCommBridge sendet. Das Modul gibt auch die Möglichkeit Androidgeräte zu steuern.
Für all diese Aktionen und Informationen wird auf dem Androidgerät "Automagic" und ein so genannter Flow benötigt. Die App ist über den Google PlayStore zu beziehen. Das benötigte Flowset bekommt man aus dem FHEM Verzeichnis.

=== Wie genau verwendet man nun AMADDevice? ===
* stelle sicher das als aller erstes die AMADCommBridge in FHEM definiert wurde
* installiere die App "Automagic Premium" aus dem PlayStore.
* installiere das Flowset 74_AMADDeviceautomagicFlowset$VERSION.xml aus dem Ordner $INSTALLFHEM/FHEM/lib/ auf dem Androidgerät
* aktiviere den Installationsassistanten Flow in Automagic. Wenn man nun Automagic in den Hintergrund schickt, z.B. Hometaste drücken, startet der Assistant und legt automatisch ein Device für das Androidgerät an.

=== Ein AMADDevice Gerät von Hand anlegen. ===

Define

<code>define <name> AMADDevice <IP-ADRESSE> <AMAD_ID> IODev=<IODEVICE> </code>

==== Beispiel ====

<code>define WandTabletWohnzimmer AMADDevice 192.168.0.23 123456 IODev=NAME_des_AMADCommBridge_Devices</code>

In diesem Fall wird ein AMADDevice von Hand angelegt. Die AMAD_ID, hier 123456, muß auch exakt so als globale Variable in Automagic eingetragen sein.

=== Readings ===
* airplanemode - Status des Flugmodus
* androidVersion - aktuell installierte Androidversion
* automagicState - Statusmeldungen von der AutomagicApp '''(Voraussetzung Android >4.3). Ist Android größer 4.3 vorhanden und im Reading steht "wird nicht unterstützt", muß in den Androideinstellungen unter Ton und Benachrichtigungen -> Benachrichtigungszugriff ein Haken für Automagic gesetzt werden'''
* batteryHealth - Zustand der Battery (1=unbekannt, 2=gut, 3=Überhitzt, 4=tot, 5=Überspannung, 6=unbekannter Fehler, 7=kalt)
* batterytemperature - Temperatur der Batterie
* bluetooth - on/off, Bluetooth Status an oder aus
* checkActiveTask - Zustand einer zuvor definierten APP. 0=nicht aktiv oder nicht aktiv im Vordergrund, 1=aktiv im Vordergrund, '''siehe Hinweis unten'''
* connectedBTdevices - eine Liste der verbundenen Gerät
* connectedBTdevicesMAC - eine Liste der MAC Adressen aller verbundender BT Geräte
* currentMusicAlbum - aktuell abgespieltes Musikalbum des verwendeten Mediaplayers
* currentMusicApp - aktuell verwendeter Mediaplayer (Amazon Music, Google Play Music, Google Play Video, Spotify, YouTube, TuneIn Player, Aldi Life Music)
* currentMusicArtist - aktuell abgespielter Musikinterpret des verwendeten Mediaplayers
* currentMusicIcon - Cover vom aktuell abgespielten Album '''Noch nicht fertig implementiert'''
* currentMusicState - Status des aktuellen/zuletzt verwendeten Mediaplayers
* currentMusicTrack - aktuell abgespielter Musiktitel des verwendeten Mediaplayers
* daydream - on/off, Daydream gestartet oder nicht
* deviceState - Status des Androidgerätes. unknown, online, offline.
* doNotDisturb - aktueller Status des nicht stören Modus
* dockingState - undocked/docked Status ob sich das Gerät in einer Dockinstation befindet.
* flow_SetCommands - active/inactive, Status des SetCommands Flow
* flow_informations - active/inactive, Status des Informations Flow
* flowsetVersionAtDevice - aktuell installierte Flowsetversion auf dem Device
* incomingCallerName - Anrufername des eingehenden Anrufes
* incomingCallerNumber - Anrufernummer des eingehenden Anrufes
* incommingWhatsAppMessageFrom - letzte WhatsApp Nachricht
* incommingWhatsTelegramMessageFrom - letzte Telegram Nachricht
* intentRadioName - zuletzt gesrreamter Intent Radio Name
* intentRadioState - Status des IntentRadio Players
* keyguardSet - 0/1 Displaysperre gesetzt 0=nein 1=ja, bedeutet nicht das sie gerade aktiv ist
* lastSetCommandError - letzte Fehlermeldung vom set Befehl
* lastSetCommandState - letzter Status vom set Befehl, Befehl erfolgreich/nicht erfolgreich gesendet
* lastStatusRequestError - letzte Fehlermeldung vom statusRequest Befehl
* lastStatusRequestState - letzter Status vom statusRequest Befehl, Befehl erfolgreich/nicht erfolgreich gesendet
* nextAlarmDay - aktiver Alarmtag
* nextAlarmState - aktueller Status des "Androidinternen" Weckers
* nextAlarmTime - aktive Alarmzeit
* powerLevel - Status der Batterie in %
* powerPlugged - Netzteil angeschlossen? 0=NEIN, 1|2=JA
* screen - on locked/unlocked, off locked/unlocked gibt an ob der Bildschirm an oder aus ist und gleichzeitig gesperrt oder nicht gesperrt
* screenBrightness - Bildschirmhelligkeit von 0-255
* screenFullscreen - on/off, Vollbildmodus (An,Aus)
* screenOrientation - Landscape,Portrait, Bildschirmausrichtung (Horizontal,Vertikal)
* screenOrientationMode - auto/manual, Modus für die Ausrichtung (Automatisch, Manuell)
* state - aktueller Status
* userFlowState - aktueller Status eines Flows, festgelegt unter dem setUserFlowState Attribut
* volume - Media Lautstärkewert
* volumeNotification - Benachrichtigungs Lautstärke

Beim Reading checkActivTask muß zuvor der Packagename der zu prüfenden App als Attribut checkActiveTask angegeben werden. Beispiel: attr Nexus10Wohnzimmer checkActiveTask com.android.chrome für den Chrome Browser.

=== Set ===
* activateVoiceInput - aktiviert die Spracheingabe
* bluetooth - on/off, aktiviert/deaktiviert Bluetooth
* clearNotificationBar - All,Automagic, löscht alle Meldungen oder nur die Automagic Meldungen in der Statusleiste
* closeCall - beendet einen laufenden Anruf
* currentFlowsetUpdate - fürt ein Flowsetupdate auf dem Device durch
* doNotDisturb - schaltet den nicht stören Modus, always immer stören, never niemals stören, alarmClockOnly nur Wecker darf stören, onlyImportant nur wichtige Störungen
* installFlowSource - installiert einen Flow auf dem Device, das XML File muss unter /tmp/ liegen und die Endung xml haben. Bsp: set TabletWohnzimmer installFlowSource WlanUebwerwachen.xml
* mediaAmazonMusic - play, stop, next, back ,steuert den Amazon Musik Mediaplayer
* mediaGoogleMusic - play, stop, next, back ,steuert den Google Play Musik Mediaplayer
* mediaSpotifyMusic - play, stop, next, back ,steuert den Spotify Mediaplayer
* mediaTuneinRadio - play, stop, next, back ,steuert den TuneIn Radio Mediaplayer
* mediaAldiMusic - play, stop, next, back ,steuert den Aldi Musik Mediaplayer
* mediaAudible - play, stop, next, back ,steuert den Audible Mediaplayer
* mediaYouTube - play, stop, next, back ,steuert den YouTube Mediaplayer
* mediaVlcPlayer - play, stop, next, back ,steuert den VLC Mediaplayer
* nextAlarmTime - setzt die Alarmzeit. gilt aber nur innerhalb der nächsten 24Std.
* openCall - ruft eine Nummer an und legt optional nach X Sekunden auf / set DEVICE openCall 01736458 10 / ruft die Nummer an und beendet den Anruf nach 10s
* screen - on/off/lock/unlock schaltet den Bildschirm ein/aus oder sperrt/entsperrt ihn
* screenBrightness - setzt die Bildschirmhelligkeit, von 0-255.
* screenMsg - versendet eine Bildschirmnachricht
* sendintent - sendet einen Intentstring Bsp: set $AMADDeviceDEVICE sendIntent org.smblott.intentradio.PLAY url http://stream.klassikradio.de/live/mp3-192/stream.klassikradio.de/play.m3u name Klassikradio, der erste Befehl ist die Aktion und der zweite das Extra. Es können immer zwei Extras mitgegeben werden.
* sendSMS - sendet eine SMS an eine bestimmte Telefonnummer. Bsp.: sendSMS Dies ist ein Test|555487263
* startDaydream - startet den Daydream
* statusRequest - Fordert einen neuen Statusreport beim Device an. Es können nicht von allen Readings per statusRequest die Daten geholt werden. Einige wenige geben nur bei Statusänderung ihren Status wieder.
* timer - setzt einen Timer innerhalb der als Standard definierten ClockAPP auf dem Device. Es können nur Sekunden angegeben werden.
* ttsMsg - versendet eine Nachricht welche als Sprachnachricht ausgegeben wird
* userFlowState - aktiviert oder deaktiviert einen oder mehrere Flows,'''set Nexus7Wohnzimmer Badezimmer vorheizen:inactive oder set Nexus7Wohnzimmer Badezimmer vorheizen,Nachtlicht Steven:inactive'''
* vibrate - lässt das Androidgerät vibrieren
* volume - setzt die Medialautstärke. Entweder die internen Lautsprecher oder sofern angeschlossen die Bluetoothlautsprecher und per Klinkenstecker angeschlossene Lautsprecher, + oder - vor dem Wert reduziert die aktuelle Lautstärke um den Wert. Der maximale Sliderwert kann über das Attribut setVolMax geregelt werden.
* volumeUp - erhöh;t die Lautstärke um den angegeben Wert im entsprechenden Attribut. Ist kein Attribut angegeben wird per default 2 genommen.
* volumeDown - reduziert die Lautstärke um den angegeben Wert im entsprechenden Attribut. Ist kein Attribut angegeben wird per default 2 genommen.
* volumeNotification - setzt die Benachrichtigungslautstärke.

==== Set abhängig von gesetzten Attributen ====
* changetoBtDevice - wechselt zu einem anderen Bluetooth Gerät. Attribut setBluetoothDevice muß gesetzt sein. Siehe Hinweis unten!
* notifySndFile - spielt die angegebene Mediadatei auf dem Androidgerät ab. Die aufzurufende Mediadatei sollte sich im Ordner /storage/emulated/0/Notifications/ befinden. Ist dies nicht der Fall kann man über das Attribut setNotifySndFilePath einen Pfad vorgeben.
* openApp - öffnet eine ausgewählte App. Attribut setOpenApp
* openURL - öffnet eine URL im Standardbrowser, sofern kein anderer Browser über das Attribut setOpenUrlBrowser ausgewählt wurde. Bsp: attr Tablet setOpenUrlBrowser de.ozerov.fully|de.ozerov.fully.MainActivity, das erste ist der Package Name und das zweite der Class Name
* setAPSSID - setzt die AccessPoint SSID um ein WLAN sleep zu verhindern
* setScreenOnForTimer ändert die Zeit wie lange das Display an bleiben soll!
* screenFullscreen - on/off, (aktiviert/deaktiviert) den Vollbildmodus. Attribut setFullscreen
* screenLock - Sperrt den Bildschirm mit Pinabfrage. Attribut setScreenlockPIN - hier die Pin dafür eingeben. Erlaubt sind nur Zahlen. Es müßen mindestens 4, bis max 16 Zeichen verwendet werden.
* screenOrientation - Auto,Landscape,Portait, aktiviert die Bildschirmausrichtung (Automatisch,Horizontal,Vertikal). Attribut setScreenOrientation
* system - setzt Systembefehle ab (nur bei gerootetet Geräen). reboot,shutdown,airplanemodeON (kann nur aktiviert werden) Attribut root, in den Automagic Einstellungen muss "Root Funktion" gesetzt werden
* setNotifySndFilePath - setzt den korrekten Systempfad zur Notifydatei (default ist /storage/emulated/0/Notifications/
* setTtsMsgSpeed - setzt die Sprachgeschwindigkeit bei der Sprachausgabe(Werte zwischen 0.5 bis 4.0 in 0.5er Schritten) default ist 1.0
* setTtsMsgSpeed - setzt die Sprache bei der Sprachausgabe, de oder en (default ist de)
* setVolUpDownStep - setzt den Step für volumeUp und volumeDown
* setVolMax - setzt die maximale Volume Gr&uoml;e für den Slider
* setNotifyVolMax - setzt den maximalen Lautstärkewert für Benachrichtigungslautstärke für den Slider
* setRingSoundVolMax - setzt den maximalen Lautstärkewert für Klingellautstärke für den Slider

'''Um openApp verwenden zu können, muss als Attribut der Package Name der App angegeben werden.

'''Um zwischen Bluetoothgeräten wechseln zu können, muß das Attribut setBluetoothDevice mit folgender Syntax gesetzt werden. attr <DEVICE> BTdeviceName1|MAC,BTDeviceName2|MAC Es muss zwingend darauf geachtet werden das beim BTdeviceName kein Leerzeichen vorhanden ist. Am besten zusammen oder mit Unterstrich. Achtet bei der MAC darauf das Ihr wirklich nach jeder zweiten Zahl auch einen : drin habt

** '''Beispiel: attr Nexus10Wohnzimmer setBluetoothDevice Logitech_BT_Adapter|AB:12:CD:34:EF:32,Anker_A3565|GH:56:IJ:78:KL:76

=== state ===
* initialized - Ist der Status kurz nach einem define.
* active - die Geräteinstanz ist im aktiven Status.
* disabled - die Geräteinstanz wurde über das Attribut disable deaktiviert

==Anwendungsbeispiele==
=== Lademanagement ===
Ich habe die Ladegeräte für meine Androidgeräte an Funkschaltsteckdosen. ein DOIF schaltet bei unter 30% die Steckdose ein und bei über 90% wieder aus.

Hier mal ein einfaches DOIF Beispiel für ein Lademanagment

<code>
... DOIF ([Nexus5Handy:powerLevel] < 30) (set LadenetzteilNexus5Handy:FILTER=STATE=off on) DOELSEIF ([Nexus5Handy:powerLevel] > 90) (set LadenetzteilNexus5Handy:FILTER=STATE=on off) DOELSE
</code>

=== Wecker ===
Morgens lasse ich mich über mein Tablet im Schlafzimmer mit Musik wecken. Verwendet wird hierzu der wakeuptimer des RESIDENTS Modules. Das abspielen stoppe ich dann von Hand. Danach erfolgt noch eine Ansage wie das Wetter gerade ist und wird.

=== Mediacenter ===
Mein 10" Tablet im Wohnzimmer ist Mediaplayer für das Wohnzimmer mit Bluetoothlautsprechern. Die Lautstärke wird automatisch runter gesetzt wenn die Fritzbox einen Anruf auf das Wohnzimmer Handgerät signalisiert.

=== Sprachbefehl - Abfragen von Zuständen diverser Sensoren ===
Wenn ich die Spracheingabe aktiviere und nach der Temperatur im Wohnzimmer frage, bekomme ich diese angesagt.

Der Teil im Feld Daten ist ein klassisches RadingsVal, halt nur ohne Komma und ohne Anführungszeichen

WIRD GERADE ÜBERARBEITET

=== Schaltbefehle vom Androidgerät an FHEM senden ===
Hierfür richte bitte einen eigen Flow ein. Wie das genau geht, verrät Dir die Hilfe.
Um einen Schaltbefehl für FHEM zu erstellen, folgt nach dem Trigger eine Aktion als Script (Aktion Type: Script). Hier trägst Du folgendes ein

setcmd = "LichtWohnzimmerLampeRechts on"

fhemcmd = "set"

In der ersten Zeile wird also der Schaltbefehl in der Variablem setcmd eingetragen und in der zweiten Zeile der FHEM Befehl in der Variablen fhemcmd.

Danach müsst Ihr nur noch in einer weiteren Aktion den Flow "Send Data to AMADCommBridge" ausführen (Aktion Type: Flows ausführen). Die Aktion sollte bereits in Eurer Liste Vorhanden sein.

[[Datei:Screenshot_20160717-134948.png|200px]]
[[Datei:Screenshot 17.07.2016 1-50-27.png|200px]]

Nun sollte Lampe1 angeschalten werden wenn der Flow ausgeführt wird.

== Bekannte Meldungen/Hinweise/Probleme ==

Wenn auf dem Android-Gerät die Fehlermeldung 'Accessibility service not running' von Automagic kommt, oder im FHEM das reading state 'Flow Informations mit Fehler beendet' steht, dann muss der Accessibility Service auf dem Android-Device aktiviert werden: Einstellungen --> Bedienungshilfen --> Automagic Premium. Hier muss der Schalter auf 'an' stehen. Sollte dies der Fall sein, hilft u.U. ein kurzes Aus- und wieder Einschalten.

Gerät wird oft als offline angezeigt und es können keine set Befehle abgesetzt werden.
Mit der AMAD Version 2.2 hielt eine neue Behandlung des deviceState Readings Einzug. Das Reading stellt nun den tatsächlichen Status des Gerätes gegenüber FHEM da. Bei vielen Android 6 Geräten kommt es aber auf Grund vom DeepSleep Modus zum wegfall der WLAN Verbindung. Hier hilft die neue KeepAlive Funktion in AMAD. Dafür muß lediglich unter
* Einstellungen --> Akku --> oben auf die drei Punkte - Akku Leistungsoptimierung --> alle Apps und dann Automagic auswählen und "Nicht optimieren"
ausgewählt werden. Alles andere macht das Modul selbst.

AMAD

2017-07-25T12:09:07Z

CoolTux: /* Warum AMADNG */

{{Infobox Modul
|ModPurpose=Steuern von Adroidgeräten und Anzeige von bestimmten Informationen dieser Geräte
|ModType=d
|ModForumArea=Sonstige Systeme
|ModTechName=73_AMADCommBridge.pm, 74_AMADDevice.pm
|ModOwner=CoolTux ([http://forum.fhem.de/index.php?action=profile;u=13684 Forum] / [[Benutzer:CoolTux|Wiki]])
}}

= AMAD 4.0 [AMADNG] =
== 73_AMADCommBridge / 74_AMADDevice ==

= Vorwort =
=== Warum AMADNG ===
Nach fast 6 Monaten Entwicklungszeit wurde die neuste AMAD Version am 24.07.2017 offiziell frei gegeben. Diesmal lagen mir mehrere Dinge am Herzen.
In erster Linie wollte ich eine softwareseitige Trennung der AMADCommBridge vom eigentlichen Android Device. Daher ist die neue Version ein zweistufiges Modul geworden.
Im Laufe der Entwicklung kamen auch andere Anforderungen hinzu, welche ich dann fähig war um zu setzen. Eine dieser Anforderungen war eine einfachere und besser funktionierende Installation. Raus gekommen ist ein Android Installationsassistant.
Mit ihm wird auf einfache Art und Weise direkt per Sprachführung und Eingabedialogen Automagic für AMAD konfiguriert und das Device in FHEM automatisch erstellt. Autocreate!

= Vorstellung =
Dieses 2-stufige Modul liefert, '''in Verbindung mit der Android APP Automagic''', diverse Informationen von Android Geräten.
Die AndroidAPP Automagic (welche nicht von mir stammt und 2.90 Euro kostet) funktioniert wie Tasker, ist aber bei weitem User freundlicher.

=== Features / Funktionen ===
Im Auslieferiungszustand werden folgende Zustände dargestellt:
* installierte Android Version
* Zustand von Automagic auf dem Gerät
* Spracheingabe
* Bluetooth An/Aus
* Zustand einer definierten App (läuft aktiv im Vordergrund oder nicht?)
* verbundene Bluetoothgeräte, inklusive deren MAC Adresse
* aktuell abgespieltes Musikalbum des verwendeten Mediaplayers
* aktuell abgespielter Musikinterpret des verwendeten Mediaplayers
* aktuell abgespielter Musiktitel des verwendeten Mediaplayers
* Status des Androidgerätes - Online/Offline
* nächster Alarmtag
* nächste Alarmzeit
* Batteriestatus in %
* Ladestatus - Netztei angeschlossen / nicht angeschlossen
* Bildschirmstatus An/Aus
* Bildschirmhelligkeit
* Vollbildmodus An/Aus
* Bildschirmausrichtung Auto/Landscape/Portrait
* Standardlautstärke
* Media Lautstärke
* ...

Mit etwas Einarbeitung können jegliche Informationen welche Automagic bereit stellt, in FHEM angezeigt werden. Hierzu bedarf es lediglich eines eigenen Flows welcher seine Daten an die AMADCommBridge sendet. Das Modul gibt auch die Möglichkeit Androidgeräte zu steuern.

= AMADCommBridge - Kommunikationsbrücke für alle AMAD Geräte =
Dieses Modul ist das Ausgangsmodul zur erfolgreichen Integration von Androidgeräten in FHEM. Es stellt ferner eine Verbindungsebene zwischen AMAD unterstützten Geräten und FHEM zur Verfügung. Alle Kommunikation zwischen AMAD Android und FHEM läuft über diese Schnittstelle.
Daher erfolgt die Ersteinrichtung eines AMAD Devices auch genau über diese Modulinstanz.

Damit erfolgreich ein Androidgerät in FHEM eingerichtet werden kann, muss im ersten Schritt ein AMADCommBridge Device angelegt werden.

=== Definition in FHEM ===

<code>define <name> AMADCommBridge</code>

==== Beispiel ====

<code>define AMADBridge AMADCommBridge</code>

Diese Anweisung erstellt ein neues AMADCommBridge Device Namens AMADBridge.

Im folgenden muß lediglich das Flowset auf dem Android Gerät installiert werden und der Flow 'First Run Assistent' ausgeführt werden. (einfach den Homebutton drücken)
Der Assistent geleitet Dich dann durch die Einrichtung Deines AMAD Gerätes und sorgt dafür das am Ende des Installationsprozess das Androidgerät als AMAD Device in FHEM angelegt wird.

=== Readings ===
* JSON_ERROR - JSON Fehlermeldung welche von Perl gemeldet wird
* JSON_ERROR_STRING - der String welcher die JSON Fehlermeldung verursacht hat
* fhemServerIP - die Ip-Adresse des FHEM Servers, wird vom Modul auf Basis des JSON Strings vom Installationsassistenten gesetzt. Kann aber auch mittels set Befehles vom User gesetzt werden
* receiveFhemCommand - ist das Attribut fhemControlMode auf trigger gestellt, wird das Reading gesetzt sobald ein FHEM Befehl übersendet wird. Hierauf kann dann ein Notify triggern. Wird anstelle von trigger setControl als Wert für fhemControlMode eingestellt, wird das Reading nicht gestzt sondern der set Befehl sofort ausgeführt.
* receiveVoiceCommand - wird die Sprachsteuerung von AMAD aktiviert (set DEVICE activateVoiceInput) so wird der letzte erkannten Sprachbefehle in dieses Reading geschrieben.
* receiveVoiceDevice - Name des Devices von wo aus der letzte erkannte Sprachbefehl gesendet wurde
* state - Status der Bridge, open, closed

=== Attribute ===
* allowFrom - Regexp der erlaubten IP-Adressen oder Hostnamen. Wenn dieses Attribut gesetzt wurde, werden ausschließlich Verbindungen von diesen Adressen akzeptiert. Achtung: falls allowfrom nicht gesetzt ist, und keine gütige allowed Instanz definiert ist, und die Gegenstelle eine nicht lokale Adresse hat, dann wird die Verbindung abgewiesen. Folgende Adressen werden als local betrachtet: IPV4: 127/8, 10/8, 192.168/16, 172.16/10, 169.254/16, IPV6: ::1, fe80/10
* debugJSON - wenn auf 1 gesetzt, werden JSON Fehlermeldungen in Readings geschrieben. Siehe hierzu JSON_ERROR* unter Readings
* fhemControlMode - steuert die zulässige Art der Kontrolle von FHEM Devices. Du kannst über die Bridge auf 2 Arten FHEM Devices steuern. Entweder per direktem FHEM Befehl aus einem Flow heraus, oder als Sprachbefehl mittels Sprachsteuerung (set DEVICE activateVoiceInput)
** trigger - ist der Wert trigger gesetzt, werden alle an die Bridge gesendeten FHEM set Befehle in das Reading receiveFhemCommand geschrieben und können so mittels notify ausgeführt werden. Sprachsteuerung ist möglich, es werden Readings receiveVoice* gesetzt. Auf dem Androidgerät können bei Sprachsteuerung mehrere Sprachbefehle mittels "und" verknüpft/aneinander gereiht werden. Bsp: schalte die Lichtszene Abends an und schalte den Fernsehr an
** setControl - alle set Befehle welche mittels eines Flows über die Bridge gesendet werden, werden automatisch ausgeführt. Das triggern eines Readings ist nicht nötig. Die Steuerung mittels Sprache verhält sich wie beim Wert trigger
** thirdPartControl - verhält sich wie trigger, bei der Sprachsteuerung ist jedoch ein anreihen von Sprachbefehlen mittels "und" nicht möglich. Dient der Sprachsteuerung über Module anderer Modulautoren ((z.B. 39_TEERKO.pm)

= AMADDevice - Automagic Android Device =
Dieses Modul liefert, in Verbindung mit der Android APP Automagic, diverse Informationen von Android Geräten. Die AndroidAPP Automagic (welche nicht von mir stammt und 2.90 Euro kostet) funktioniert wie Tasker, ist aber bei weitem User freundlicher.
Mit etwas Einarbeitung können jegliche Informationen welche Automagic bereit stellt in FHEM angezeigt werden. Hierzu bedarf es lediglich eines eigenen Flows welcher seine Daten an die AMADDeviceCommBridge sendet. Das Modul gibt auch die Möglichkeit Androidgeräte zu steuern.
Für all diese Aktionen und Informationen wird auf dem Androidgerät "Automagic" und ein so genannter Flow benötigt. Die App ist über den Google PlayStore zu beziehen. Das benötigte Flowset bekommt man aus dem FHEM Verzeichnis.

=== Wie genau verwendet man nun AMADDevice? ===
* stelle sicher das als aller erstes die AMADCommBridge in FHEM definiert wurde
* installiere die App "Automagic Premium" aus dem PlayStore.
* installiere das Flowset 74_AMADDeviceautomagicFlowset$VERSION.xml aus dem Ordner $INSTALLFHEM/FHEM/lib/ auf dem Androidgerät
* aktiviere den Installationsassistanten Flow in Automagic. Wenn man nun Automagic in den Hintergrund schickt, z.B. Hometaste drücken, startet der Assistant und legt automatisch ein Device für das Androidgerät an.

=== Ein AMADDevice Gerät von Hand anlegen. ===

Define

<code>10.6.9.10 1496497380000 IODev=AMADBridge define <name> AMADDevice <IP-ADRESSE> <AMAD_ID> IODev=<IODEVICE> </code>

==== Beispiel ====

<code>define WandTabletWohnzimmer AMADDevice 192.168.0.23 123456 IODev=NAME_des_AMADCommBridge_Devices</code>

In diesem Fall wird ein AMADDevice von Hand angelegt. Die AMAD_ID, hier 123456, muß auch exakt so als globale Variable in Automagic eingetragen sein.

=== Readings ===
* airplanemode - Status des Flugmodus
* androidVersion - aktuell installierte Androidversion
* automagicState - Statusmeldungen von der AutomagicApp '''(Voraussetzung Android >4.3). Ist Android größer 4.3 vorhanden und im Reading steht "wird nicht unterstützt", muß in den Androideinstellungen unter Ton und Benachrichtigungen -> Benachrichtigungszugriff ein Haken für Automagic gesetzt werden'''
* batteryHealth - Zustand der Battery (1=unbekannt, 2=gut, 3=Überhitzt, 4=tot, 5=Überspannung, 6=unbekannter Fehler, 7=kalt)
* batterytemperature - Temperatur der Batterie
* bluetooth - on/off, Bluetooth Status an oder aus
* checkActiveTask - Zustand einer zuvor definierten APP. 0=nicht aktiv oder nicht aktiv im Vordergrund, 1=aktiv im Vordergrund, '''siehe Hinweis unten'''
* connectedBTdevices - eine Liste der verbundenen Gerät
* connectedBTdevicesMAC - eine Liste der MAC Adressen aller verbundender BT Geräte
* currentMusicAlbum - aktuell abgespieltes Musikalbum des verwendeten Mediaplayers
* currentMusicApp - aktuell verwendeter Mediaplayer (Amazon Music, Google Play Music, Google Play Video, Spotify, YouTube, TuneIn Player, Aldi Life Music)
* currentMusicArtist - aktuell abgespielter Musikinterpret des verwendeten Mediaplayers
* currentMusicIcon - Cover vom aktuell abgespielten Album '''Noch nicht fertig implementiert'''
* currentMusicState - Status des aktuellen/zuletzt verwendeten Mediaplayers
* currentMusicTrack - aktuell abgespielter Musiktitel des verwendeten Mediaplayers
* daydream - on/off, Daydream gestartet oder nicht
* deviceState - Status des Androidgerätes. unknown, online, offline.
* doNotDisturb - aktueller Status des nicht stören Modus
* dockingState - undocked/docked Status ob sich das Gerät in einer Dockinstation befindet.
* flow_SetCommands - active/inactive, Status des SetCommands Flow
* flow_informations - active/inactive, Status des Informations Flow
* flowsetVersionAtDevice - aktuell installierte Flowsetversion auf dem Device
* incomingCallerName - Anrufername des eingehenden Anrufes
* incomingCallerNumber - Anrufernummer des eingehenden Anrufes
* incommingWhatsAppMessageFrom - letzte WhatsApp Nachricht
* incommingWhatsTelegramMessageFrom - letzte Telegram Nachricht
* intentRadioName - zuletzt gesrreamter Intent Radio Name
* intentRadioState - Status des IntentRadio Players
* keyguardSet - 0/1 Displaysperre gesetzt 0=nein 1=ja, bedeutet nicht das sie gerade aktiv ist
* lastSetCommandError - letzte Fehlermeldung vom set Befehl
* lastSetCommandState - letzter Status vom set Befehl, Befehl erfolgreich/nicht erfolgreich gesendet
* lastStatusRequestError - letzte Fehlermeldung vom statusRequest Befehl
* lastStatusRequestState - letzter Status vom statusRequest Befehl, Befehl erfolgreich/nicht erfolgreich gesendet
* nextAlarmDay - aktiver Alarmtag
* nextAlarmState - aktueller Status des "Androidinternen" Weckers
* nextAlarmTime - aktive Alarmzeit
* powerLevel - Status der Batterie in %
* powerPlugged - Netzteil angeschlossen? 0=NEIN, 1|2=JA
* screen - on locked/unlocked, off locked/unlocked gibt an ob der Bildschirm an oder aus ist und gleichzeitig gesperrt oder nicht gesperrt
* screenBrightness - Bildschirmhelligkeit von 0-255
* screenFullscreen - on/off, Vollbildmodus (An,Aus)
* screenOrientation - Landscape,Portrait, Bildschirmausrichtung (Horizontal,Vertikal)
* screenOrientationMode - auto/manual, Modus für die Ausrichtung (Automatisch, Manuell)
* state - aktueller Status
* userFlowState - aktueller Status eines Flows, festgelegt unter dem setUserFlowState Attribut
* volume - Media Lautstärkewert
* volumeNotification - Benachrichtigungs Lautstärke

Beim Reading checkActivTask muß zuvor der Packagename der zu prüfenden App als Attribut checkActiveTask angegeben werden. Beispiel: attr Nexus10Wohnzimmer checkActiveTask com.android.chrome für den Chrome Browser.

=== Set ===
* activateVoiceInput - aktiviert die Spracheingabe
* bluetooth - on/off, aktiviert/deaktiviert Bluetooth
* clearNotificationBar - All,Automagic, löscht alle Meldungen oder nur die Automagic Meldungen in der Statusleiste
* closeCall - beendet einen laufenden Anruf
* currentFlowsetUpdate - fürt ein Flowsetupdate auf dem Device durch
* doNotDisturb - schaltet den nicht stören Modus, always immer stören, never niemals stören, alarmClockOnly nur Wecker darf stören, onlyImportant nur wichtige Störungen
* installFlowSource - installiert einen Flow auf dem Device, das XML File muss unter /tmp/ liegen und die Endung xml haben. Bsp: set TabletWohnzimmer installFlowSource WlanUebwerwachen.xml
* mediaAmazonMusic - play, stop, next, back ,steuert den Amazon Musik Mediaplayer
* mediaGoogleMusic - play, stop, next, back ,steuert den Google Play Musik Mediaplayer
* mediaSpotifyMusic - play, stop, next, back ,steuert den Spotify Mediaplayer
* mediaTuneinRadio - play, stop, next, back ,steuert den TuneIn Radio Mediaplayer
* mediaAldiMusic - play, stop, next, back ,steuert den Aldi Musik Mediaplayer
* mediaAudible - play, stop, next, back ,steuert den Audible Mediaplayer
* mediaYouTube - play, stop, next, back ,steuert den YouTube Mediaplayer
* mediaVlcPlayer - play, stop, next, back ,steuert den VLC Mediaplayer
* nextAlarmTime - setzt die Alarmzeit. gilt aber nur innerhalb der nächsten 24Std.
* openCall - ruft eine Nummer an und legt optional nach X Sekunden auf / set DEVICE openCall 01736458 10 / ruft die Nummer an und beendet den Anruf nach 10s
* screen - on/off/lock/unlock schaltet den Bildschirm ein/aus oder sperrt/entsperrt ihn
* screenBrightness - setzt die Bildschirmhelligkeit, von 0-255.
* screenMsg - versendet eine Bildschirmnachricht
* sendintent - sendet einen Intentstring Bsp: set $AMADDeviceDEVICE sendIntent org.smblott.intentradio.PLAY url http://stream.klassikradio.de/live/mp3-192/stream.klassikradio.de/play.m3u name Klassikradio, der erste Befehl ist die Aktion und der zweite das Extra. Es können immer zwei Extras mitgegeben werden.
* sendSMS - sendet eine SMS an eine bestimmte Telefonnummer. Bsp.: sendSMS Dies ist ein Test|555487263
* startDaydream - startet den Daydream
* statusRequest - Fordert einen neuen Statusreport beim Device an. Es können nicht von allen Readings per statusRequest die Daten geholt werden. Einige wenige geben nur bei Statusänderung ihren Status wieder.
* timer - setzt einen Timer innerhalb der als Standard definierten ClockAPP auf dem Device. Es können nur Sekunden angegeben werden.
* ttsMsg - versendet eine Nachricht welche als Sprachnachricht ausgegeben wird
* userFlowState - aktiviert oder deaktiviert einen oder mehrere Flows,'''set Nexus7Wohnzimmer Badezimmer vorheizen:inactive oder set Nexus7Wohnzimmer Badezimmer vorheizen,Nachtlicht Steven:inactive'''
* vibrate - lässt das Androidgerät vibrieren
* volume - setzt die Medialautstärke. Entweder die internen Lautsprecher oder sofern angeschlossen die Bluetoothlautsprecher und per Klinkenstecker angeschlossene Lautsprecher, + oder - vor dem Wert reduziert die aktuelle Lautstärke um den Wert. Der maximale Sliderwert kann über das Attribut setVolMax geregelt werden.
* volumeUp - erhöh;t die Lautstärke um den angegeben Wert im entsprechenden Attribut. Ist kein Attribut angegeben wird per default 2 genommen.
* volumeDown - reduziert die Lautstärke um den angegeben Wert im entsprechenden Attribut. Ist kein Attribut angegeben wird per default 2 genommen.
* volumeNotification - setzt die Benachrichtigungslautstärke.

==== Set abhängig von gesetzten Attributen ====
* changetoBtDevice - wechselt zu einem anderen Bluetooth Gerät. Attribut setBluetoothDevice muß gesetzt sein. Siehe Hinweis unten!
* notifySndFile - spielt die angegebene Mediadatei auf dem Androidgerät ab. Die aufzurufende Mediadatei sollte sich im Ordner /storage/emulated/0/Notifications/ befinden. Ist dies nicht der Fall kann man über das Attribut setNotifySndFilePath einen Pfad vorgeben.
* openApp - öffnet eine ausgewählte App. Attribut setOpenApp
* openURL - öffnet eine URL im Standardbrowser, sofern kein anderer Browser über das Attribut setOpenUrlBrowser ausgewählt wurde. Bsp: attr Tablet setOpenUrlBrowser de.ozerov.fully|de.ozerov.fully.MainActivity, das erste ist der Package Name und das zweite der Class Name
* setAPSSID - setzt die AccessPoint SSID um ein WLAN sleep zu verhindern
* setScreenOnForTimer ändert die Zeit wie lange das Display an bleiben soll!
* screenFullscreen - on/off, (aktiviert/deaktiviert) den Vollbildmodus. Attribut setFullscreen
* screenLock - Sperrt den Bildschirm mit Pinabfrage. Attribut setScreenlockPIN - hier die Pin dafür eingeben. Erlaubt sind nur Zahlen. Es müßen mindestens 4, bis max 16 Zeichen verwendet werden.
* screenOrientation - Auto,Landscape,Portait, aktiviert die Bildschirmausrichtung (Automatisch,Horizontal,Vertikal). Attribut setScreenOrientation
* system - setzt Systembefehle ab (nur bei gerootetet Geräen). reboot,shutdown,airplanemodeON (kann nur aktiviert werden) Attribut root, in den Automagic Einstellungen muss "Root Funktion" gesetzt werden
* setNotifySndFilePath - setzt den korrekten Systempfad zur Notifydatei (default ist /storage/emulated/0/Notifications/
* setTtsMsgSpeed - setzt die Sprachgeschwindigkeit bei der Sprachausgabe(Werte zwischen 0.5 bis 4.0 in 0.5er Schritten) default ist 1.0
* setTtsMsgSpeed - setzt die Sprache bei der Sprachausgabe, de oder en (default ist de)
* setVolUpDownStep - setzt den Step für volumeUp und volumeDown
* setVolMax - setzt die maximale Volume Gr&uoml;e für den Slider
* setNotifyVolMax - setzt den maximalen Lautstärkewert für Benachrichtigungslautstärke für den Slider
* setRingSoundVolMax - setzt den maximalen Lautstärkewert für Klingellautstärke für den Slider

'''Um openApp verwenden zu können, muss als Attribut der Package Name der App angegeben werden.

'''Um zwischen Bluetoothgeräten wechseln zu können, muß das Attribut setBluetoothDevice mit folgender Syntax gesetzt werden. attr <DEVICE> BTdeviceName1|MAC,BTDeviceName2|MAC Es muss zwingend darauf geachtet werden das beim BTdeviceName kein Leerzeichen vorhanden ist. Am besten zusammen oder mit Unterstrich. Achtet bei der MAC darauf das Ihr wirklich nach jeder zweiten Zahl auch einen : drin habt

** '''Beispiel: attr Nexus10Wohnzimmer setBluetoothDevice Logitech_BT_Adapter|AB:12:CD:34:EF:32,Anker_A3565|GH:56:IJ:78:KL:76

=== state ===
* initialized - Ist der Status kurz nach einem define.
* active - die Geräteinstanz ist im aktiven Status.
* disabled - die Geräteinstanz wurde über das Attribut disable deaktiviert

==Anwendungsbeispiele==
=== Lademanagement ===
Ich habe die Ladegeräte für meine Androidgeräte an Funkschaltsteckdosen. ein DOIF schaltet bei unter 30% die Steckdose ein und bei über 90% wieder aus.

Hier mal ein einfaches DOIF Beispiel für ein Lademanagment

<code>
... DOIF ([Nexus5Handy:powerLevel] < 30) (set LadenetzteilNexus5Handy:FILTER=STATE=off on) DOELSEIF ([Nexus5Handy:powerLevel] > 90) (set LadenetzteilNexus5Handy:FILTER=STATE=on off) DOELSE
</code>

=== Wecker ===
Morgens lasse ich mich über mein Tablet im Schlafzimmer mit Musik wecken. Verwendet wird hierzu der wakeuptimer des RESIDENTS Modules. Das abspielen stoppe ich dann von Hand. Danach erfolgt noch eine Ansage wie das Wetter gerade ist und wird.

=== Mediacenter ===
Mein 10" Tablet im Wohnzimmer ist Mediaplayer für das Wohnzimmer mit Bluetoothlautsprechern. Die Lautstärke wird automatisch runter gesetzt wenn die Fritzbox einen Anruf auf das Wohnzimmer Handgerät signalisiert.

=== Sprachbefehl - Abfragen von Zuständen diverser Sensoren ===
Wenn ich die Spracheingabe aktiviere und nach der Temperatur im Wohnzimmer frage, bekomme ich diese angesagt.

Der Teil im Feld Daten ist ein klassisches RadingsVal, halt nur ohne Komma und ohne Anführungszeichen

WIRD GERADE ÜBERARBEITET

=== Schaltbefehle vom Androidgerät an FHEM senden ===
Hierfür richte bitte einen eigen Flow ein. Wie das genau geht, verrät Dir die Hilfe.
Um einen Schaltbefehl für FHEM zu erstellen, folgt nach dem Trigger eine Aktion als Script (Aktion Type: Script). Hier trägst Du folgendes ein

setcmd = "LichtWohnzimmerLampeRechts on"

fhemcmd = "set"

In der ersten Zeile wird also der Schaltbefehl in der Variablem setcmd eingetragen und in der zweiten Zeile der FHEM Befehl in der Variablen fhemcmd.

Danach müsst Ihr nur noch in einer weiteren Aktion den Flow "Send Data to AMADCommBridge" ausführen (Aktion Type: Flows ausführen). Die Aktion sollte bereits in Eurer Liste Vorhanden sein.

[[Datei:Screenshot_20160717-134948.png|200px]]
[[Datei:Screenshot 17.07.2016 1-50-27.png|200px]]

Nun sollte Lampe1 angeschalten werden wenn der Flow ausgeführt wird.

== Bekannte Meldungen/Hinweise/Probleme ==

Wenn auf dem Android-Gerät die Fehlermeldung 'Accessibility service not running' von Automagic kommt, oder im FHEM das reading state 'Flow Informations mit Fehler beendet' steht, dann muss der Accessibility Service auf dem Android-Device aktiviert werden: Einstellungen --> Bedienungshilfen --> Automagic Premium. Hier muss der Schalter auf 'an' stehen. Sollte dies der Fall sein, hilft u.U. ein kurzes Aus- und wieder Einschalten.

Gerät wird oft als offline angezeigt und es können keine set Befehle abgesetzt werden.
Mit der AMAD Version 2.2 hielt eine neue Behandlung des deviceState Readings Einzug. Das Reading stellt nun den tatsächlichen Status des Gerätes gegenüber FHEM da. Bei vielen Android 6 Geräten kommt es aber auf Grund vom DeepSleep Modus zum wegfall der WLAN Verbindung. Hier hilft die neue KeepAlive Funktion in AMAD. Dafür muß lediglich unter
* Einstellungen --> Akku --> oben auf die drei Punkte - Akku Leistungsoptimierung --> alle Apps und dann Automagic auswählen und "Nicht optimieren"
ausgewählt werden. Alles andere macht das Modul selbst.

HEOS

2017-07-24T12:34:35Z

CoolTux:

{{Infobox Modul
|ModPurpose=Steuern und auslesen des Denon Multiroom-Soundsystem
|ModType=d
|ModForumArea=Multimedia
|ModTechName=21_HEOSMaster, 21_HEOSPlayer, 21_HEOSGroup
|ModOwner=CoolTux ([http://forum.fhem.de/index.php?action=profile;u=13684 Forum] / [[Benutzer:CoolTux|Wiki]])
}}

= HEOSMaster / HEOSPlayer / HEOSGroup =

== HEOSMaster ==
In Kombination mit HEOSPlayer und HEOSGroup steuert dieses FHEM Modul das Denon Multiroom-Soundsystem mit Hilfe einer telnet Socket-Verbindung und dem HEOS Command Line Interface (CLI).

=== Voraussetzung ===
Installation der folgenden Pakete: apt-get install libjson-perl libnet-telnet-perl libencode-perl

=== Define ===

<code>define <name> HEOSMaster <IP address></code>

Beispiel:

<code>define MyMasterBox HEOSMaster 192.168.178.67</code>

<IP address> ist die IP-Adresse des HEOS Receivers oder der HEOS Box. Das Master Device wird im Raum HEOS angelegt und danach erfolgt das Einlesen und automatische Anlegen der Player. Von nun an können die Player gesteuert werden. Außerdem wird der Status und die Media Readings der Player entsprechend geändert, wenn man in der HEOS-App oder direkt am Receiver etwas ändert.

=== Readings ===
* enableChangeEvents - Status der Event Wiedergabe auf dem CLI Master
* heosAccount - signed_out | signed_in as <HEOSAccount>
* lastCommand - zuletzt ausgeführtes Kommando
* lastPlayerId - Player-Id des Geräts, welches das Kommando ausgeführt hat
* lastPlayerName - Player-Name des Geräts, welches das Kommando ausgeführt hat
* lastResult - Ergebnis des zuletzt ausgeführten Kommandos
* state - Status des HEOSMaster

=== Set ===
* checkAccount - prüft das HEOS Konto
* enableChangeEvents - aktiviert die Event Wiedergabe auf dem CLI Master
* getGroups - holt eine Liste aller Gruppen und legt die Devices an, sofern noch nicht geschehen
* getPlayers - holt eine Liste aller Player und legt die Devices an, sofern noch nicht vorhanden
* password - setzt das Passwort des HEOS Kontos
* reboot - rebootet das CLI Interface am Master
* reopen - versucht eine neue Socket-Verbindung zum CLI Master aufzubauen
* signAccount In|Out - anmelden|abmelden am HEOS Konto (attr MyMasterBox heosUsername <username>)

=== Get ===
* ShowAccount - zeigt das HEOS Konto an

=== State ===
* connected - der HEOSmaster ist mit dem CLI Master verbunden
* not connected - der HEOSmaster ist nicht mit dem CLI Master verbunden

=== Attribute ===
* heosUsername - Benutzername des HEOS Kontos

== HEOSPlayer ==
In Kombination mit HEOSMaster and HEOSGroup steuert dieses FHEM Modul das Denon Multiroom-Soundsystem mit Hilfe einer telnet Socket-Verbindung und dem HEOS Command Line Interface (CLI).

Nachdem der Master einmal angelegt ist werden die Player und Gruppierungen des Systems automatisch erkannt und in FHEM angelegt. Von da an können die Player und Gruppierungen gesteuert werden und Veränderungen in der HEOS App oder am Reveiver werden mit dem Status und den Media Readings der Player und Gruppierungen synchronisiert.

=== Readings ===
* channel - Nr des gerade abgespielten Favoriten
* currentAlbum - Name des gerade abgespielten Albums
* currentArtist - Name des gerade abgespielten Künstlers
* currentImageUrl - URL des Albumcovers, Senderlogos, etc.
* currentMedia - Medientyp des gerade abgespielten Streams (song|station|genre|artist|album|container)
* currentMid - media ID
* currentQid - queue ID
* currentSid - source ID
* currentStation - Name des gerade abgespielten Senders
* currentTitle - Name des gerade abgespielten Titels
* error - letzte Fehlermeldung
* gid - ID der Gruppe, in der der Player Mitglied ist
* ip-address - IP-Adresse des Players
* lineout - lineout level type (variable|Fixed)
* model - Modell des HEOS Lautsprechers (z.B. HEOS 1)
* mute - Player mute Status (on|off)
* name - Name des Players (aus der App übernommen)
* network - Netzwerkverbindung (wired|wifi)
* playStatus - Status des Players (play|pause|stop)
* repeat - Player Repeat Status (on_all|on_one|off)
* shuffle - Player Shuffle Status (on|off)
* state - Status der Player-Verbindung (on|off)
* version - Softwareversion des HEOS Lautsprechers
* volume - aktuelle Lautstärke (0-100)
* volumeDown - Schrittweite Lautstärke (1-10, default 5)
* volumeUp - Schrittweite Lautstärke (1-10, default 5)

=== Set ===
* aux - aktiviert die Quelle am AUX-Eingang des Players
* channel <nr> - spielt den vorher mit der App erstellten Favoriten <nr> ab
* channelUp - schaltet auf den nächsten Favoriten in der Favoritenliste um
* channelDown- schaltet auf vorherigen Favoriten in der Favoritenliste um
* clear queue - löscht die Warteschlange
* deletePlaylist <myList> - löscht die Playlist <myList>
* set <hp1> groupWithMember <hp2> - erzeugt eine Gruppierung mit hp1 als Leader und hp2 als Mitglied
* input sid[,cid][,mid] - setze input source-id[,container-id][,media-id]
**Beispiel: set Küche input 1027,1772574848,inputs/tvaudio, startet "TV-Audio" auf dem Player "Küche"
* mute on|off - setzt den mute Status on|off
* next - spielt nächsten Titel in Warteschlange
* pause - setzt den Status des Players auf "pause"
* play - setzt den Status des Players auf "play"
* playPlaylist <myList> - spielt die Playlist <myList> ab
* playQueueItem <nr> - spielt Titel <nr> in Warteschlange
* prev - spielt vorherigen Titel in Warteschlange
* repeat - setzt den Player Repeat Status (on_all|on_one|off)
* saveQueue <myList> - speichert die Warteschlange als Playlist <myList>
* shuffle - setzt den Player Shuffle Status auf on|off
* stop - setzt den Status des Players auf "stop"
* volume - setzt die Lautstärke auf 0..100
* volumeDown - verringert die Lautstärke um <volumeDown>
* volumeUp - erhöht die Lautstärke um <volumeUp>

=== Get ===
* ls - listet Musikquellen (Eingänge, Playlists, Favoriten, Musik-Dienste, ...)
* channelscount - Anzahl der Favoriten

=== state ===
Status der Player-Verbindung (on|off)

=== Attribute ===
* channelring - Beim Erreichen des letzten Favoriten schaltet ChannelUp/Down im Kreis, also wieder auf den ersten/letzten Favoriten
* mute2play - Beim Betätigen der Mute-Taste am Lautsprecher wird auch der Stream angehalten

== HEOSGroup ==
In Kombination mit HEOSMaster and HEOSPlayer steuert dieses FHEM Modul das Denon Multiroom-Soundsystem mit Hilfe einer telnet Socket-Verbindung und dem HEOS Command Line Interface (CLI).

Nachdem der Master einmal angelegt ist werden die Player und Gruppierungen des Systems automatisch erkannt und in FHEM angelegt. Von da an können die Player und Gruppierungen gesteuert werden und Veränderungen in der HEOS App oder am Reveiver werden mit dem Status und den Media Readings der Player und Gruppierungen synchronisiert.

Gruppierungen können aus einem Player heraus mit "groupWithMember" erzeugt werden.

=== Beispiel ===

<code>set Wohnzimmer groupWithMember Küche</code>

... erzeugt eine Gruppierung namens "Wohnzimmer+Küche" mit dem Player "Wohnzimmer" als Leader und dem Player "Küche" als Mitglied.

=== Readings ===
* channel - Nr des gerade abgespielten Favoriten
* currentAlbum - Name des gerade abgespielten Albums
* currentArtist - Name des gerade abgespielten Künstlers
* currentImageUrl - URL des Albumcovers, Senderlogos, etc.
* currentMedia - Medientyp des gerade abgespielten Streams (song|station|genre|artist|album|container)
* currentMid - media ID
* currentQid - queue ID
* currentSid - source ID
* currentStation - Name des gerade abgespielten Senders
* currentTitle - Name des gerade abgespielten Titels
* error - letzte Fehlermeldung
* gid - Gruppen-ID
* leader - Leader der Gruppierung
* member - Mitglied(er) der Gruppierung
* mute - Player mute Status (on|off)
* name - Name der Gruppierung
* playStatus - Status des Players (play|pause|stop)
* repeat - Player Repeat Status (on_all|on_one|off)
* shuffle - Player Shuffle Status (on|off)
* state - Status der Player-Verbindung (on|off)
* volume - aktuelle Lautstärke (0-100)
* volumeDown - Schrittweite Lautstärke (1-10, default 5)
* volumeUp - Schrittweite Lautstärke (1-10, default 5)

=== Set ===
* channel <nr> - spielt den vorher mit der App erstellten Favoriten <nr> ab
* channelUp - schaltet auf den nächsten Favoriten in der Favoritenliste um
* channelDown- schaltet auf vorherigen Favoriten in der Favoritenliste um
* clearGroup - Auflösen der Gruppierung (setzt state auf off)
* getGroupInfo - holt die Media-Informationen der Gruppierung
* mute on|off - setze den mute Status on|off
* next - spielt nächsten Titel in Warteschlange
* pause - setzt den Status des Players auf "pause"
* play - setzt den Status des Players auf "play"
* playPlaylist <myList> - spielt die Playlist <myList> ab
* prev - spielt vorherigen Titel in Warteschlange
* repeat - setzt den Player Repeat Status (on_all|on_one|off)
* shuffle - setzt den Player Shuffle Status auf on|off
* stop - setzt den Status des Players auf "stop"
* volume - setzt die Lautstärke auf 0..100
* volumeDown - verringert die Lautstärke um <volumeDown>
* volumeUp - erhöht die Lautstärke um <volumeUp>

=== State ===
* Status der Gruppierung (on|off)

HEOS

2017-07-24T12:30:16Z

CoolTux: Die Seite wurde neu angelegt: „= HEOSMaster / HEOSPlayer / HEOSGroup = == HEOSMaster == In Kombination mit HEOSPlayer und HEOSGroup steuert dieses FHEM Modul das Denon Multiroom-Soundsyst…“

= HEOSMaster / HEOSPlayer / HEOSGroup =

== HEOSMaster ==
In Kombination mit HEOSPlayer und HEOSGroup steuert dieses FHEM Modul das Denon Multiroom-Soundsystem mit Hilfe einer telnet Socket-Verbindung und dem HEOS Command Line Interface (CLI).

=== Voraussetzung ===
Installation der folgenden Pakete: apt-get install libjson-perl libnet-telnet-perl libencode-perl

=== Define ===

<code>define <name> HEOSMaster <IP address></code>

Beispiel:

<code>define MyMasterBox HEOSMaster 192.168.178.67</code>

<IP address> ist die IP-Adresse des HEOS Receivers oder der HEOS Box. Das Master Device wird im Raum HEOS angelegt und danach erfolgt das Einlesen und automatische Anlegen der Player. Von nun an können die Player gesteuert werden. Außerdem wird der Status und die Media Readings der Player entsprechend geändert, wenn man in der HEOS-App oder direkt am Receiver etwas ändert.

=== Readings ===
* enableChangeEvents - Status der Event Wiedergabe auf dem CLI Master
* heosAccount - signed_out | signed_in as <HEOSAccount>
* lastCommand - zuletzt ausgeführtes Kommando
* lastPlayerId - Player-Id des Geräts, welches das Kommando ausgeführt hat
* lastPlayerName - Player-Name des Geräts, welches das Kommando ausgeführt hat
* lastResult - Ergebnis des zuletzt ausgeführten Kommandos
* state - Status des HEOSMaster

=== Set ===
* checkAccount - prüft das HEOS Konto
* enableChangeEvents - aktiviert die Event Wiedergabe auf dem CLI Master
* getGroups - holt eine Liste aller Gruppen und legt die Devices an, sofern noch nicht geschehen
* getPlayers - holt eine Liste aller Player und legt die Devices an, sofern noch nicht vorhanden
* password - setzt das Passwort des HEOS Kontos
* reboot - rebootet das CLI Interface am Master
* reopen - versucht eine neue Socket-Verbindung zum CLI Master aufzubauen
* signAccount In|Out - anmelden|abmelden am HEOS Konto (attr MyMasterBox heosUsername <username>)

=== Get ===
* ShowAccount - zeigt das HEOS Konto an

=== State ===
* connected - der HEOSmaster ist mit dem CLI Master verbunden
* not connected - der HEOSmaster ist nicht mit dem CLI Master verbunden

=== Attribute ===
* heosUsername - Benutzername des HEOS Kontos

== HEOSPlayer ==
In Kombination mit HEOSMaster and HEOSGroup steuert dieses FHEM Modul das Denon Multiroom-Soundsystem mit Hilfe einer telnet Socket-Verbindung und dem HEOS Command Line Interface (CLI).

Nachdem der Master einmal angelegt ist werden die Player und Gruppierungen des Systems automatisch erkannt und in FHEM angelegt. Von da an können die Player und Gruppierungen gesteuert werden und Veränderungen in der HEOS App oder am Reveiver werden mit dem Status und den Media Readings der Player und Gruppierungen synchronisiert.

=== Readings ===
* channel - Nr des gerade abgespielten Favoriten
* currentAlbum - Name des gerade abgespielten Albums
* currentArtist - Name des gerade abgespielten Künstlers
* currentImageUrl - URL des Albumcovers, Senderlogos, etc.
* currentMedia - Medientyp des gerade abgespielten Streams (song|station|genre|artist|album|container)
* currentMid - media ID
* currentQid - queue ID
* currentSid - source ID
* currentStation - Name des gerade abgespielten Senders
* currentTitle - Name des gerade abgespielten Titels
* error - letzte Fehlermeldung
* gid - ID der Gruppe, in der der Player Mitglied ist
* ip-address - IP-Adresse des Players
* lineout - lineout level type (variable|Fixed)
* model - Modell des HEOS Lautsprechers (z.B. HEOS 1)
* mute - Player mute Status (on|off)
* name - Name des Players (aus der App übernommen)
* network - Netzwerkverbindung (wired|wifi)
* playStatus - Status des Players (play|pause|stop)
* repeat - Player Repeat Status (on_all|on_one|off)
* shuffle - Player Shuffle Status (on|off)
* state - Status der Player-Verbindung (on|off)
* version - Softwareversion des HEOS Lautsprechers
* volume - aktuelle Lautstärke (0-100)
* volumeDown - Schrittweite Lautstärke (1-10, default 5)
* volumeUp - Schrittweite Lautstärke (1-10, default 5)

=== Set ===
* aux - aktiviert die Quelle am AUX-Eingang des Players
* channel <nr> - spielt den vorher mit der App erstellten Favoriten <nr> ab
* channelUp - schaltet auf den nächsten Favoriten in der Favoritenliste um
* channelDown- schaltet auf vorherigen Favoriten in der Favoritenliste um
* clear queue - löscht die Warteschlange
* deletePlaylist <myList> - löscht die Playlist <myList>
* set <hp1> groupWithMember <hp2> - erzeugt eine Gruppierung mit hp1 als Leader und hp2 als Mitglied
* input sid[,cid][,mid] - setze input source-id[,container-id][,media-id]
**Beispiel: set Küche input 1027,1772574848,inputs/tvaudio, startet "TV-Audio" auf dem Player "Küche"
* mute on|off - setzt den mute Status on|off
* next - spielt nächsten Titel in Warteschlange
* pause - setzt den Status des Players auf "pause"
* play - setzt den Status des Players auf "play"
* playPlaylist <myList> - spielt die Playlist <myList> ab
* playQueueItem <nr> - spielt Titel <nr> in Warteschlange
* prev - spielt vorherigen Titel in Warteschlange
* repeat - setzt den Player Repeat Status (on_all|on_one|off)
* saveQueue <myList> - speichert die Warteschlange als Playlist <myList>
* shuffle - setzt den Player Shuffle Status auf on|off
* stop - setzt den Status des Players auf "stop"
* volume - setzt die Lautstärke auf 0..100
* volumeDown - verringert die Lautstärke um <volumeDown>
* volumeUp - erhöht die Lautstärke um <volumeUp>

=== Get ===
* ls - listet Musikquellen (Eingänge, Playlists, Favoriten, Musik-Dienste, ...)
* channelscount - Anzahl der Favoriten

=== state ===
Status der Player-Verbindung (on|off)

=== Attribute ===
* channelring - Beim Erreichen des letzten Favoriten schaltet ChannelUp/Down im Kreis, also wieder auf den ersten/letzten Favoriten
* mute2play - Beim Betätigen der Mute-Taste am Lautsprecher wird auch der Stream angehalten

== HEOSGroup ==
In Kombination mit HEOSMaster and HEOSPlayer steuert dieses FHEM Modul das Denon Multiroom-Soundsystem mit Hilfe einer telnet Socket-Verbindung und dem HEOS Command Line Interface (CLI).

Nachdem der Master einmal angelegt ist werden die Player und Gruppierungen des Systems automatisch erkannt und in FHEM angelegt. Von da an können die Player und Gruppierungen gesteuert werden und Veränderungen in der HEOS App oder am Reveiver werden mit dem Status und den Media Readings der Player und Gruppierungen synchronisiert.

Gruppierungen können aus einem Player heraus mit "groupWithMember" erzeugt werden.

=== Beispiel ===

<code>set Wohnzimmer groupWithMember Küche</code>

... erzeugt eine Gruppierung namens "Wohnzimmer+Küche" mit dem Player "Wohnzimmer" als Leader und dem Player "Küche" als Mitglied.

=== Readings ===
* channel - Nr des gerade abgespielten Favoriten
* currentAlbum - Name des gerade abgespielten Albums
* currentArtist - Name des gerade abgespielten Künstlers
* currentImageUrl - URL des Albumcovers, Senderlogos, etc.
* currentMedia - Medientyp des gerade abgespielten Streams (song|station|genre|artist|album|container)
* currentMid - media ID
* currentQid - queue ID
* currentSid - source ID
* currentStation - Name des gerade abgespielten Senders
* currentTitle - Name des gerade abgespielten Titels
* error - letzte Fehlermeldung
* gid - Gruppen-ID
* leader - Leader der Gruppierung
* member - Mitglied(er) der Gruppierung
* mute - Player mute Status (on|off)
* name - Name der Gruppierung
* playStatus - Status des Players (play|pause|stop)
* repeat - Player Repeat Status (on_all|on_one|off)
* shuffle - Player Shuffle Status (on|off)
* state - Status der Player-Verbindung (on|off)
* volume - aktuelle Lautstärke (0-100)
* volumeDown - Schrittweite Lautstärke (1-10, default 5)
* volumeUp - Schrittweite Lautstärke (1-10, default 5)

=== Set ===
* channel <nr> - spielt den vorher mit der App erstellten Favoriten <nr> ab
* channelUp - schaltet auf den nächsten Favoriten in der Favoritenliste um
* channelDown- schaltet auf vorherigen Favoriten in der Favoritenliste um
* clearGroup - Auflösen der Gruppierung (setzt state auf off)
* getGroupInfo - holt die Media-Informationen der Gruppierung
* mute on|off - setze den mute Status on|off
* next - spielt nächsten Titel in Warteschlange
* pause - setzt den Status des Players auf "pause"
* play - setzt den Status des Players auf "play"
* playPlaylist <myList> - spielt die Playlist <myList> ab
* prev - spielt vorherigen Titel in Warteschlange
* repeat - setzt den Player Repeat Status (on_all|on_one|off)
* shuffle - setzt den Player Shuffle Status auf on|off
* stop - setzt den Status des Players auf "stop"
* volume - setzt die Lautstärke auf 0..100
* volumeDown - verringert die Lautstärke um <volumeDown>
* volumeUp - erhöht die Lautstärke um <volumeUp>

=== State ===
* Status der Gruppierung (on|off)

AMAD

2017-07-24T11:15:28Z

CoolTux:

{{Infobox Modul
|ModPurpose=Steuern von Adroidgeräten und Anzeige von bestimmten Informationen dieser Geräte
|ModType=d
|ModForumArea=Sonstige Systeme
|ModTechName=73_AMADCommBridge.pm, 74_AMADDevice.pm
|ModOwner=CoolTux ([http://forum.fhem.de/index.php?action=profile;u=13684 Forum] / [[Benutzer:CoolTux|Wiki]])
}}

= AMAD 4.0 [AMADNG] =
== 73_AMADCommBridge / 74_AMADDevice ==

= Vorwort =
=== Warum AMADNG ===
Nach nun fast 6 Monaten Entwicklungszeit nähert sich die Fertigstellung der neusten AMAD Version. Diesmal lagen mir mehrere Dinge am Herzen.
In erster Linie wollte ich eine softwareseitige Trennung der AMADCommBridge vom eigentlichen Android Device. Daher ist die neue Version ein zweistufiges Modul geworden.
Im Laufe der Entwicklung kamen auch andere Anforderungen welche ich nun fähig bin um zu setzen. Eine dieser Anforderungen war eine einfachere und besser funktionierende Installation. Raus gekommen ist ein Android Installationsassistant.
Mit ihm wird auf einfache Art und Weise direkt per Sprachführung und Eingabedialogen Automagic für AMAD konfiguriert und das Device in FHEM automatisch erstellt. Autocreate!

= Vorstellung =
Dieses 2-stufige Modul liefert, '''in Verbindung mit der Android APP Automagic''', diverse Informationen von Android Geräten.
Die AndroidAPP Automagic (welche nicht von mir stammt und 2.90 Euro kostet) funktioniert wie Tasker, ist aber bei weitem User freundlicher.

=== Features / Funktionen ===
Im Auslieferiungszustand werden folgende Zustände dargestellt:
* installierte Android Version
* Zustand von Automagic auf dem Gerät
* Spracheingabe
* Bluetooth An/Aus
* Zustand einer definierten App (läuft aktiv im Vordergrund oder nicht?)
* verbundene Bluetoothgeräte, inklusive deren MAC Adresse
* aktuell abgespieltes Musikalbum des verwendeten Mediaplayers
* aktuell abgespielter Musikinterpret des verwendeten Mediaplayers
* aktuell abgespielter Musiktitel des verwendeten Mediaplayers
* Status des Androidgerätes - Online/Offline
* nächster Alarmtag
* nächste Alarmzeit
* Batteriestatus in %
* Ladestatus - Netztei angeschlossen / nicht angeschlossen
* Bildschirmstatus An/Aus
* Bildschirmhelligkeit
* Vollbildmodus An/Aus
* Bildschirmausrichtung Auto/Landscape/Portrait
* Standardlautstärke
* Media Lautstärke
* ...

Mit etwas Einarbeitung können jegliche Informationen welche Automagic bereit stellt, in FHEM angezeigt werden. Hierzu bedarf es lediglich eines eigenen Flows welcher seine Daten an die AMADCommBridge sendet. Das Modul gibt auch die Möglichkeit Androidgeräte zu steuern.

= AMADCommBridge - Kommunikationsbrücke für alle AMAD Geräte =
Dieses Modul ist das Ausgangsmodul zur erfolgreichen Integration von Androidgeräten in FHEM. Es stellt ferner eine Verbindungsebene zwischen AMAD unterstützten Geräten und FHEM zur Verfügung. Alle Kommunikation zwischen AMAD Android und FHEM läuft über diese Schnittstelle.
Daher erfolgt die Ersteinrichtung eines AMAD Devices auch genau über diese Modulinstanz.

Damit erfolgreich ein Androidgerät in FHEM eingerichtet werden kann, muss im ersten Schritt ein AMADCommBridge Device angelegt werden.

=== Definition in FHEM ===

<code>define <name> AMADCommBridge</code>

==== Beispiel ====

<code>define AMADBridge AMADCommBridge</code>

Diese Anweisung erstellt ein neues AMADCommBridge Device Namens AMADBridge.

Im folgenden muß lediglich das Flowset auf dem Android Gerät installiert werden und der Flow 'First Run Assistent' ausgeführt werden. (einfach den Homebutton drücken)
Der Assistent geleitet Dich dann durch die Einrichtung Deines AMAD Gerätes und sorgt dafür das am Ende des Installationsprozess das Androidgerät als AMAD Device in FHEM angelegt wird.

=== Readings ===
* JSON_ERROR - JSON Fehlermeldung welche von Perl gemeldet wird
* JSON_ERROR_STRING - der String welcher die JSON Fehlermeldung verursacht hat
* fhemServerIP - die Ip-Adresse des FHEM Servers, wird vom Modul auf Basis des JSON Strings vom Installationsassistenten gesetzt. Kann aber auch mittels set Befehles vom User gesetzt werden
* receiveFhemCommand - ist das Attribut fhemControlMode auf trigger gestellt, wird das Reading gesetzt sobald ein FHEM Befehl übersendet wird. Hierauf kann dann ein Notify triggern. Wird anstelle von trigger setControl als Wert für fhemControlMode eingestellt, wird das Reading nicht gestzt sondern der set Befehl sofort ausgeführt.
* receiveVoiceCommand - wird die Sprachsteuerung von AMAD aktiviert (set DEVICE activateVoiceInput) so wird der letzte erkannten Sprachbefehle in dieses Reading geschrieben.
* receiveVoiceDevice - Name des Devices von wo aus der letzte erkannte Sprachbefehl gesendet wurde
* state - Status der Bridge, open, closed

=== Attribute ===
* allowFrom - Regexp der erlaubten IP-Adressen oder Hostnamen. Wenn dieses Attribut gesetzt wurde, werden ausschließlich Verbindungen von diesen Adressen akzeptiert. Achtung: falls allowfrom nicht gesetzt ist, und keine gütige allowed Instanz definiert ist, und die Gegenstelle eine nicht lokale Adresse hat, dann wird die Verbindung abgewiesen. Folgende Adressen werden als local betrachtet: IPV4: 127/8, 10/8, 192.168/16, 172.16/10, 169.254/16, IPV6: ::1, fe80/10
* debugJSON - wenn auf 1 gesetzt, werden JSON Fehlermeldungen in Readings geschrieben. Siehe hierzu JSON_ERROR* unter Readings
* fhemControlMode - steuert die zulässige Art der Kontrolle von FHEM Devices. Du kannst über die Bridge auf 2 Arten FHEM Devices steuern. Entweder per direktem FHEM Befehl aus einem Flow heraus, oder als Sprachbefehl mittels Sprachsteuerung (set DEVICE activateVoiceInput)
** trigger - ist der Wert trigger gesetzt, werden alle an die Bridge gesendeten FHEM set Befehle in das Reading receiveFhemCommand geschrieben und können so mittels notify ausgeführt werden. Sprachsteuerung ist möglich, es werden Readings receiveVoice* gesetzt. Auf dem Androidgerät können bei Sprachsteuerung mehrere Sprachbefehle mittels "und" verknüpft/aneinander gereiht werden. Bsp: schalte die Lichtszene Abends an und schalte den Fernsehr an
** setControl - alle set Befehle welche mittels eines Flows über die Bridge gesendet werden, werden automatisch ausgeführt. Das triggern eines Readings ist nicht nötig. Die Steuerung mittels Sprache verhält sich wie beim Wert trigger
** thirdPartControl - verhält sich wie trigger, bei der Sprachsteuerung ist jedoch ein anreihen von Sprachbefehlen mittels "und" nicht möglich. Dient der Sprachsteuerung über Module anderer Modulautoren ((z.B. 39_TEERKO.pm)

= AMADDevice - Automagic Android Device =
Dieses Modul liefert, in Verbindung mit der Android APP Automagic, diverse Informationen von Android Geräten. Die AndroidAPP Automagic (welche nicht von mir stammt und 2.90 Euro kostet) funktioniert wie Tasker, ist aber bei weitem User freundlicher.
Mit etwas Einarbeitung können jegliche Informationen welche Automagic bereit stellt in FHEM angezeigt werden. Hierzu bedarf es lediglich eines eigenen Flows welcher seine Daten an die AMADDeviceCommBridge sendet. Das Modul gibt auch die Möglichkeit Androidgeräte zu steuern.
Für all diese Aktionen und Informationen wird auf dem Androidgerät "Automagic" und ein so genannter Flow benötigt. Die App ist über den Google PlayStore zu beziehen. Das benötigte Flowset bekommt man aus dem FHEM Verzeichnis.

=== Wie genau verwendet man nun AMADDevice? ===
* stelle sicher das als aller erstes die AMADCommBridge in FHEM definiert wurde
* installiere die App "Automagic Premium" aus dem PlayStore.
* installiere das Flowset 74_AMADDeviceautomagicFlowset$VERSION.xml aus dem Ordner $INSTALLFHEM/FHEM/lib/ auf dem Androidgerät
* aktiviere den Installationsassistanten Flow in Automagic. Wenn man nun Automagic in den Hintergrund schickt, z.B. Hometaste drücken, startet der Assistant und legt automatisch ein Device für das Androidgerät an.

=== Ein AMADDevice Gerät von Hand anlegen. ===

Define

<code>10.6.9.10 1496497380000 IODev=AMADBridge define <name> AMADDevice <IP-ADRESSE> <AMAD_ID> IODev=<IODEVICE> </code>

==== Beispiel ====

<code>define WandTabletWohnzimmer AMADDevice 192.168.0.23 123456 IODev=NAME_des_AMADCommBridge_Devices</code>

In diesem Fall wird ein AMADDevice von Hand angelegt. Die AMAD_ID, hier 123456, muß auch exakt so als globale Variable in Automagic eingetragen sein.

=== Readings ===
* airplanemode - Status des Flugmodus
* androidVersion - aktuell installierte Androidversion
* automagicState - Statusmeldungen von der AutomagicApp '''(Voraussetzung Android >4.3). Ist Android größer 4.3 vorhanden und im Reading steht "wird nicht unterstützt", muß in den Androideinstellungen unter Ton und Benachrichtigungen -> Benachrichtigungszugriff ein Haken für Automagic gesetzt werden'''
* batteryHealth - Zustand der Battery (1=unbekannt, 2=gut, 3=Überhitzt, 4=tot, 5=Überspannung, 6=unbekannter Fehler, 7=kalt)
* batterytemperature - Temperatur der Batterie
* bluetooth - on/off, Bluetooth Status an oder aus
* checkActiveTask - Zustand einer zuvor definierten APP. 0=nicht aktiv oder nicht aktiv im Vordergrund, 1=aktiv im Vordergrund, '''siehe Hinweis unten'''
* connectedBTdevices - eine Liste der verbundenen Gerät
* connectedBTdevicesMAC - eine Liste der MAC Adressen aller verbundender BT Geräte
* currentMusicAlbum - aktuell abgespieltes Musikalbum des verwendeten Mediaplayers
* currentMusicApp - aktuell verwendeter Mediaplayer (Amazon Music, Google Play Music, Google Play Video, Spotify, YouTube, TuneIn Player, Aldi Life Music)
* currentMusicArtist - aktuell abgespielter Musikinterpret des verwendeten Mediaplayers
* currentMusicIcon - Cover vom aktuell abgespielten Album '''Noch nicht fertig implementiert'''
* currentMusicState - Status des aktuellen/zuletzt verwendeten Mediaplayers
* currentMusicTrack - aktuell abgespielter Musiktitel des verwendeten Mediaplayers
* daydream - on/off, Daydream gestartet oder nicht
* deviceState - Status des Androidgerätes. unknown, online, offline.
* doNotDisturb - aktueller Status des nicht stören Modus
* dockingState - undocked/docked Status ob sich das Gerät in einer Dockinstation befindet.
* flow_SetCommands - active/inactive, Status des SetCommands Flow
* flow_informations - active/inactive, Status des Informations Flow
* flowsetVersionAtDevice - aktuell installierte Flowsetversion auf dem Device
* incomingCallerName - Anrufername des eingehenden Anrufes
* incomingCallerNumber - Anrufernummer des eingehenden Anrufes
* incommingWhatsAppMessageFrom - letzte WhatsApp Nachricht
* incommingWhatsTelegramMessageFrom - letzte Telegram Nachricht
* intentRadioName - zuletzt gesrreamter Intent Radio Name
* intentRadioState - Status des IntentRadio Players
* keyguardSet - 0/1 Displaysperre gesetzt 0=nein 1=ja, bedeutet nicht das sie gerade aktiv ist
* lastSetCommandError - letzte Fehlermeldung vom set Befehl
* lastSetCommandState - letzter Status vom set Befehl, Befehl erfolgreich/nicht erfolgreich gesendet
* lastStatusRequestError - letzte Fehlermeldung vom statusRequest Befehl
* lastStatusRequestState - letzter Status vom statusRequest Befehl, Befehl erfolgreich/nicht erfolgreich gesendet
* nextAlarmDay - aktiver Alarmtag
* nextAlarmState - aktueller Status des "Androidinternen" Weckers
* nextAlarmTime - aktive Alarmzeit
* powerLevel - Status der Batterie in %
* powerPlugged - Netzteil angeschlossen? 0=NEIN, 1|2=JA
* screen - on locked/unlocked, off locked/unlocked gibt an ob der Bildschirm an oder aus ist und gleichzeitig gesperrt oder nicht gesperrt
* screenBrightness - Bildschirmhelligkeit von 0-255
* screenFullscreen - on/off, Vollbildmodus (An,Aus)
* screenOrientation - Landscape,Portrait, Bildschirmausrichtung (Horizontal,Vertikal)
* screenOrientationMode - auto/manual, Modus für die Ausrichtung (Automatisch, Manuell)
* state - aktueller Status
* userFlowState - aktueller Status eines Flows, festgelegt unter dem setUserFlowState Attribut
* volume - Media Lautstärkewert
* volumeNotification - Benachrichtigungs Lautstärke

Beim Reading checkActivTask muß zuvor der Packagename der zu prüfenden App als Attribut checkActiveTask angegeben werden. Beispiel: attr Nexus10Wohnzimmer checkActiveTask com.android.chrome für den Chrome Browser.

=== Set ===
* activateVoiceInput - aktiviert die Spracheingabe
* bluetooth - on/off, aktiviert/deaktiviert Bluetooth
* clearNotificationBar - All,Automagic, löscht alle Meldungen oder nur die Automagic Meldungen in der Statusleiste
* closeCall - beendet einen laufenden Anruf
* currentFlowsetUpdate - fürt ein Flowsetupdate auf dem Device durch
* doNotDisturb - schaltet den nicht stören Modus, always immer stören, never niemals stören, alarmClockOnly nur Wecker darf stören, onlyImportant nur wichtige Störungen
* installFlowSource - installiert einen Flow auf dem Device, das XML File muss unter /tmp/ liegen und die Endung xml haben. Bsp: set TabletWohnzimmer installFlowSource WlanUebwerwachen.xml
* mediaAmazonMusic - play, stop, next, back ,steuert den Amazon Musik Mediaplayer
* mediaGoogleMusic - play, stop, next, back ,steuert den Google Play Musik Mediaplayer
* mediaSpotifyMusic - play, stop, next, back ,steuert den Spotify Mediaplayer
* mediaTuneinRadio - play, stop, next, back ,steuert den TuneIn Radio Mediaplayer
* mediaAldiMusic - play, stop, next, back ,steuert den Aldi Musik Mediaplayer
* mediaAudible - play, stop, next, back ,steuert den Audible Mediaplayer
* mediaYouTube - play, stop, next, back ,steuert den YouTube Mediaplayer
* mediaVlcPlayer - play, stop, next, back ,steuert den VLC Mediaplayer
* nextAlarmTime - setzt die Alarmzeit. gilt aber nur innerhalb der nächsten 24Std.
* openCall - ruft eine Nummer an und legt optional nach X Sekunden auf / set DEVICE openCall 01736458 10 / ruft die Nummer an und beendet den Anruf nach 10s
* screen - on/off/lock/unlock schaltet den Bildschirm ein/aus oder sperrt/entsperrt ihn
* screenBrightness - setzt die Bildschirmhelligkeit, von 0-255.
* screenMsg - versendet eine Bildschirmnachricht
* sendintent - sendet einen Intentstring Bsp: set $AMADDeviceDEVICE sendIntent org.smblott.intentradio.PLAY url http://stream.klassikradio.de/live/mp3-192/stream.klassikradio.de/play.m3u name Klassikradio, der erste Befehl ist die Aktion und der zweite das Extra. Es können immer zwei Extras mitgegeben werden.
* sendSMS - sendet eine SMS an eine bestimmte Telefonnummer. Bsp.: sendSMS Dies ist ein Test|555487263
* startDaydream - startet den Daydream
* statusRequest - Fordert einen neuen Statusreport beim Device an. Es können nicht von allen Readings per statusRequest die Daten geholt werden. Einige wenige geben nur bei Statusänderung ihren Status wieder.
* timer - setzt einen Timer innerhalb der als Standard definierten ClockAPP auf dem Device. Es können nur Sekunden angegeben werden.
* ttsMsg - versendet eine Nachricht welche als Sprachnachricht ausgegeben wird
* userFlowState - aktiviert oder deaktiviert einen oder mehrere Flows,'''set Nexus7Wohnzimmer Badezimmer vorheizen:inactive oder set Nexus7Wohnzimmer Badezimmer vorheizen,Nachtlicht Steven:inactive'''
* vibrate - lässt das Androidgerät vibrieren
* volume - setzt die Medialautstärke. Entweder die internen Lautsprecher oder sofern angeschlossen die Bluetoothlautsprecher und per Klinkenstecker angeschlossene Lautsprecher, + oder - vor dem Wert reduziert die aktuelle Lautstärke um den Wert. Der maximale Sliderwert kann über das Attribut setVolMax geregelt werden.
* volumeUp - erhöh;t die Lautstärke um den angegeben Wert im entsprechenden Attribut. Ist kein Attribut angegeben wird per default 2 genommen.
* volumeDown - reduziert die Lautstärke um den angegeben Wert im entsprechenden Attribut. Ist kein Attribut angegeben wird per default 2 genommen.
* volumeNotification - setzt die Benachrichtigungslautstärke.

==== Set abhängig von gesetzten Attributen ====
* changetoBtDevice - wechselt zu einem anderen Bluetooth Gerät. Attribut setBluetoothDevice muß gesetzt sein. Siehe Hinweis unten!
* notifySndFile - spielt die angegebene Mediadatei auf dem Androidgerät ab. Die aufzurufende Mediadatei sollte sich im Ordner /storage/emulated/0/Notifications/ befinden. Ist dies nicht der Fall kann man über das Attribut setNotifySndFilePath einen Pfad vorgeben.
* openApp - öffnet eine ausgewählte App. Attribut setOpenApp
* openURL - öffnet eine URL im Standardbrowser, sofern kein anderer Browser über das Attribut setOpenUrlBrowser ausgewählt wurde. Bsp: attr Tablet setOpenUrlBrowser de.ozerov.fully|de.ozerov.fully.MainActivity, das erste ist der Package Name und das zweite der Class Name
* setAPSSID - setzt die AccessPoint SSID um ein WLAN sleep zu verhindern
* setScreenOnForTimer ändert die Zeit wie lange das Display an bleiben soll!
* screenFullscreen - on/off, (aktiviert/deaktiviert) den Vollbildmodus. Attribut setFullscreen
* screenLock - Sperrt den Bildschirm mit Pinabfrage. Attribut setScreenlockPIN - hier die Pin dafür eingeben. Erlaubt sind nur Zahlen. Es müßen mindestens 4, bis max 16 Zeichen verwendet werden.
* screenOrientation - Auto,Landscape,Portait, aktiviert die Bildschirmausrichtung (Automatisch,Horizontal,Vertikal). Attribut setScreenOrientation
* system - setzt Systembefehle ab (nur bei gerootetet Geräen). reboot,shutdown,airplanemodeON (kann nur aktiviert werden) Attribut root, in den Automagic Einstellungen muss "Root Funktion" gesetzt werden
* setNotifySndFilePath - setzt den korrekten Systempfad zur Notifydatei (default ist /storage/emulated/0/Notifications/
* setTtsMsgSpeed - setzt die Sprachgeschwindigkeit bei der Sprachausgabe(Werte zwischen 0.5 bis 4.0 in 0.5er Schritten) default ist 1.0
* setTtsMsgSpeed - setzt die Sprache bei der Sprachausgabe, de oder en (default ist de)
* setVolUpDownStep - setzt den Step für volumeUp und volumeDown
* setVolMax - setzt die maximale Volume Gr&uoml;e für den Slider
* setNotifyVolMax - setzt den maximalen Lautstärkewert für Benachrichtigungslautstärke für den Slider
* setRingSoundVolMax - setzt den maximalen Lautstärkewert für Klingellautstärke für den Slider

'''Um openApp verwenden zu können, muss als Attribut der Package Name der App angegeben werden.

'''Um zwischen Bluetoothgeräten wechseln zu können, muß das Attribut setBluetoothDevice mit folgender Syntax gesetzt werden. attr <DEVICE> BTdeviceName1|MAC,BTDeviceName2|MAC Es muss zwingend darauf geachtet werden das beim BTdeviceName kein Leerzeichen vorhanden ist. Am besten zusammen oder mit Unterstrich. Achtet bei der MAC darauf das Ihr wirklich nach jeder zweiten Zahl auch einen : drin habt

** '''Beispiel: attr Nexus10Wohnzimmer setBluetoothDevice Logitech_BT_Adapter|AB:12:CD:34:EF:32,Anker_A3565|GH:56:IJ:78:KL:76

=== state ===
* initialized - Ist der Status kurz nach einem define.
* active - die Geräteinstanz ist im aktiven Status.
* disabled - die Geräteinstanz wurde über das Attribut disable deaktiviert

==Anwendungsbeispiele==
=== Lademanagement ===
Ich habe die Ladegeräte für meine Androidgeräte an Funkschaltsteckdosen. ein DOIF schaltet bei unter 30% die Steckdose ein und bei über 90% wieder aus.

Hier mal ein einfaches DOIF Beispiel für ein Lademanagment

<code>
... DOIF ([Nexus5Handy:powerLevel] < 30) (set LadenetzteilNexus5Handy:FILTER=STATE=off on) DOELSEIF ([Nexus5Handy:powerLevel] > 90) (set LadenetzteilNexus5Handy:FILTER=STATE=on off) DOELSE
</code>

=== Wecker ===
Morgens lasse ich mich über mein Tablet im Schlafzimmer mit Musik wecken. Verwendet wird hierzu der wakeuptimer des RESIDENTS Modules. Das abspielen stoppe ich dann von Hand. Danach erfolgt noch eine Ansage wie das Wetter gerade ist und wird.

=== Mediacenter ===
Mein 10" Tablet im Wohnzimmer ist Mediaplayer für das Wohnzimmer mit Bluetoothlautsprechern. Die Lautstärke wird automatisch runter gesetzt wenn die Fritzbox einen Anruf auf das Wohnzimmer Handgerät signalisiert.

=== Sprachbefehl - Abfragen von Zuständen diverser Sensoren ===
Wenn ich die Spracheingabe aktiviere und nach der Temperatur im Wohnzimmer frage, bekomme ich diese angesagt.

Der Teil im Feld Daten ist ein klassisches RadingsVal, halt nur ohne Komma und ohne Anführungszeichen

WIRD GERADE ÜBERARBEITET

=== Schaltbefehle vom Androidgerät an FHEM senden ===
Hierfür richte bitte einen eigen Flow ein. Wie das genau geht, verrät Dir die Hilfe.
Um einen Schaltbefehl für FHEM zu erstellen, folgt nach dem Trigger eine Aktion als Script (Aktion Type: Script). Hier trägst Du folgendes ein

setcmd = "LichtWohnzimmerLampeRechts on"

fhemcmd = "set"

In der ersten Zeile wird also der Schaltbefehl in der Variablem setcmd eingetragen und in der zweiten Zeile der FHEM Befehl in der Variablen fhemcmd.

Danach müsst Ihr nur noch in einer weiteren Aktion den Flow "Send Data to AMADCommBridge" ausführen (Aktion Type: Flows ausführen). Die Aktion sollte bereits in Eurer Liste Vorhanden sein.

[[Datei:Screenshot_20160717-134948.png|200px]]
[[Datei:Screenshot 17.07.2016 1-50-27.png|200px]]

Nun sollte Lampe1 angeschalten werden wenn der Flow ausgeführt wird.

== Bekannte Meldungen/Hinweise/Probleme ==

Wenn auf dem Android-Gerät die Fehlermeldung 'Accessibility service not running' von Automagic kommt, oder im FHEM das reading state 'Flow Informations mit Fehler beendet' steht, dann muss der Accessibility Service auf dem Android-Device aktiviert werden: Einstellungen --> Bedienungshilfen --> Automagic Premium. Hier muss der Schalter auf 'an' stehen. Sollte dies der Fall sein, hilft u.U. ein kurzes Aus- und wieder Einschalten.

Gerät wird oft als offline angezeigt und es können keine set Befehle abgesetzt werden.
Mit der AMAD Version 2.2 hielt eine neue Behandlung des deviceState Readings Einzug. Das Reading stellt nun den tatsächlichen Status des Gerätes gegenüber FHEM da. Bei vielen Android 6 Geräten kommt es aber auf Grund vom DeepSleep Modus zum wegfall der WLAN Verbindung. Hier hilft die neue KeepAlive Funktion in AMAD. Dafür muß lediglich unter
* Einstellungen --> Akku --> oben auf die drei Punkte - Akku Leistungsoptimierung --> alle Apps und dann Automagic auswählen und "Nicht optimieren"
ausgewählt werden. Alles andere macht das Modul selbst.

FHEM startet nicht - Tipps zur Fehlersuche

2017-07-20T09:58:16Z

CoolTux: Die Seite wurde neu angelegt: „= Kein Zugriff auf FHEMWEB / FHEM startet nicht - Was kann ich tun??? = Deine FHEMWEB Seite ist nicht erreichbar? Ist FHEM tot, oder ist das Netzwerk kaputt?…“

= Kein Zugriff auf FHEMWEB / FHEM startet nicht - Was kann ich tun??? =

Deine FHEMWEB Seite ist nicht erreichbar? Ist FHEM tot, oder ist das Netzwerk kaputt? Was kann ich machen um zu prüfen woran es genau liegt.
In diesem Wiki Artikel soll es darum gehen wir Du für Dich prüfen kannst ob ein FHEM / Netzwerk oder ein anderes Problem vorliegt.

== Prüfen in wie fern der FHEM Prozess tatsächlich nicht läuft ==
Man kann sich unter einem Linuxsystem sämtliche laufende Prozesse auflisten lassen

<code>ps ax</code>

Der ps Befehl listet je nach Argument alle laufende Prozesse auf. Die Liste kann man nun noch nach einem bestimmten Prozess filtern.

<code>ps ax | grep perl</code>

<code>
cooltux@fhem01-cluster:~> ps ax | grep perl

11320 pts/0 S+ 0:00 grep --color=auto perl

cooltux@fhem01-cluster:~>
</code>

Die obrige Ausgabe zeigt ein Prozesslisting mit einem Filter nach perl. Wie wir sehen wird hier lediglich der ps Befehl an sich gefunden. Es ist also kein weiterer Perlprozess gelistet. Hier läuft also definitiv kein FHEM

<code>
[11:31 root@fhem01-cluster cooltux] > ps ax | grep perl

15852 ? R 2119:09 /usr/bin/perl fhem.pl configDB

21447 pts/0 S+ 0:00 grep perl

[11:31 root@fhem01-cluster cooltux] >
</code>

Hier sehen wie nun wie ein Prozesslisting mit einem laufenden FHEM Prozess aussehen kann.

FHEM ist also aktiv, doch wie sehr ist es aktiv? Eventuell zu aktiv?

Wie kann ich mir anschauen ob der FHEM Prozess vielleicht zu sehr ausgelastet ist, der Prozess also 100 Prozent CPU Auslastung produziert?

Ein weiterer Linuxbefehl wird uns hierbei behilflich sein. <code>top</code>
<code>
top - 11:38:18 up 11 days, 18:58, 1 user, load average: 1,07, 1,03, 1,00
Tasks: 125 total, 2 running, 123 sleeping, 0 stopped, 0 zombie
%Cpu(s): 24,9 us, 0,9 sy, 0,0 ni, 74,1 id, 0,0 wa, 0,0 hi, 0,1 si, 0,0 st
KiB Mem: 945524 total, 833532 used, 111992 free, 41552 buffers
KiB Swap: 102396 total, 46564 used, 55832 free. 496240 cached Mem
PID USER PR NI VIRT RES SHR S %CPU %MEM TIME+ COMMAND
15852 fhem 20 0 103652 82160 5068 R 100,0 8,7 2125:41 perl
21683 root 20 0 5740 2560 2092 R 1,0 0,3 0:00.37 top
19129 cooltux 20 0 86204 22348 3668 S 0,3 2,4 64:16.90 insync-portable
21350 cooltux 20 0 11436 2848 2248 S 0,3 0,3 0:00.10 sshd
1 root 20 0 23292 2368 1380 S 0,0 0,3 0:54.23 systemd
2 root 20 0 0 0 0 S 0,0 0,0 0:01.09 kthreadd
3 root 20 0 0 0 0 S 0,0 0,0 3:37.20 ksoftirqd/0
5 root 0 -20 0 0 0 S 0,0 0,0 0:00.00 kworker/0:0H
7 root 20 0 0 0 0 S 0,0 0,0 8:20.71 rcu_sched
8 root 20 0 0 0 0 S 0,0 0,0 0:00.00 rcu_bh
9 root rt 0 0 0 0 S 0,0 0,0 0:05.45 migration/0
</code>
Hier können wir nun eindeutig erkennen, das unser FHEM die CPU mit 100 Prozent auslastet. FHEM hat also ein Problem

Zum Vergleich ein FHEM/Perl Prozess ohne Probleme
<code>
top - 11:50:33 up 11 days, 19:10, 1 user, load average: 0,84, 1,03, 1,00
Tasks: 133 total, 1 running, 132 sleeping, 0 stopped, 0 zombie
%Cpu(s): 0,6 us, 0,8 sy, 0,0 ni, 98,6 id, 0,0 wa, 0,0 hi, 0,0 si, 0,0 st
KiB Mem: 945524 total, 818344 used, 127180 free, 43748 buffers
KiB Swap: 102396 total, 46820 used, 55576 free. 489652 cached Mem
PID USER PR NI VIRT RES SHR S %CPU %MEM TIME+ COMMAND
22074 fhem 20 0 86424 68516 7200 S 1,3 7,2 0:47.64 perl
22294 root 20 0 5740 2564 2092 R 1,3 0,3 0:00.19 top
22296 fhem 20 0 86424 63556 2240 S 1,3 6,7 0:00.04 perl
22297 fhem 20 0 2088 408 328 S 0,7 0,0 0:00.02 ping
7 root 20 0 0 0 0 S 0,3 0,0 8:21.23 rcu_sched
1366 mysql 20 0 620608 157132 5736 S 0,3 16,6 70:12.59 mysqld
19481 root 20 0 0 0 0 S 0,3 0,0 0:02.35 kworker/3:0
1 root 20 0 23292 2408 1420 S 0,0 0,3 0:54.27 systemd
2 root 20 0 0 0 0 S 0,0 0,0 0:01.09 kthreadd
3 root 20 0 0 0 0 S 0,0 0,0 3:37.42 ksoftirqd/0
5 root 0 -20 0 0 0 S 0,0 0,0 0:00.00 kworker/0:0H
</code>

== Was tun wenn sich gar nichts mehr tut? ==
=== Fehleranalyse mit: " fhem mit "attr global logfile -" in der command-Fenster starten, und diesen Fenster nicht schliessen." ===

* erstelle eine Kopie Deiner fhem.cfg / Bsp.: fhem.cfg.debug
* fhem.cfg.debug editieren, und in der "attr global logfile" Zeile den Dateinamen gegen - (Minuszeichen) tauschen. Dadurch werden die FHEM Ausgaben auf STDOUT (in die Konsole) geschrieben, und FHEM geht nicht in den Hintergrund.
* Terminal/Terminal-Emulator/cmd/etc (das Ding, um Kommandozeilenbefehle einzugeben) öffnen, nach /opt/fhem (bzw. Installationspfad) wechseln (cd /opt/fhem) und FHEM starten (perl fhem.pl fhem.cfg.debug).
* Terminal nicht schliessen, die Meldungen tauchen hier auf.
* Wenn man genug von FHEM hat, dann mit CTRL-C stoppen (d.h. erst CTRL druecken, nicht loslassen, dann C druecken, dann beide loslassen).

Auf die Art ist es Möglich ein wirklich nicht startendes FHEM zu debuggen.

Anwesenheitserkennung

2017-07-04T04:54:57Z

CoolTux: /* Problemlösungen */

Viele Benutzer führen bereits eine eigene '''Anwesenheitserkennung''' durch. Diese basiert in den meisten Fällen auf Ping Checks oder bei [[AVM Fritz!Box|FritzBoxen]] auf dem Befehl ''ctlmgr_ctl''. Diese Lösungen können aber je nach Aufbau und Funktion FHEM massiv beeinträchtigen. Aufgrund des Aufbaus vom FHEM kann dieses dadurch für mehrere Sekunden zum völligen Stillstand gebracht werden.

In FHEM gibt es mittlerweile mehrere Module, die eine zuverlässige Anwesenheitserkennung bieten, ohne dabei FHEM bei der Ausführung zu beeinträchtigen.

Eine erweiterte Funktion der Anwesenheitserkennung ist die Standortverfolgung, die sich nicht nur auf ein oder sehr wenige mit (eigenem) WLAN versorgte Gebiete beschränkt.

== Vorüberlegungen ==
Generell gibt es mehrere Ansätze um Anwesenheitserkennung mit Handys/Smartphones durchzuführen.

* via PING Checks im gesamten WLAN
* Aktivitätsprüfung auf einer FritzBox
* Bluetooth Checks in der gesamten Wohnung
* eigene Perl-Funktion
* aktive Benachrichtigung des Smartphones, ausgelöst z.B. über Geo-Lokation/Geofence

Dabei gilt bei der Auswahl der Art darauf zu achten wie sich das jeweilige Device verhält. Aufgrund der Vielfältigkeit kann man hier keine allgemeine Vorgehensweise empfehlen. Als einfacher Start (zumindest für Nicht-Apfel Telefone) eignet sich die Ping-Überprüfung und die FritzBox-Abfrage sehr gut.

=== Randbedingungen ===
Es gibt Geräte, die ihr WLAN/Bluetooth auch im Standby ständig aktiv haben und auf Anfragen antworten können (fast alle Android-Geräte). Gerade bei Tests über WLAN kann sich das aber signifikant auf die Akku Leistung auswirken.

Andere Geräte wiederum schalten WLAN im Standby Betrieb aus, um Akkukapazität zu sparen. Bluetooth hingegen bleibt weiterhin aktiviert und kann auf Anfragen reagieren. (iPhone)

Wenn man bei einem iPhone die Funktion "über WLAN synchronisieren" aktiviert hat, so ist dies auch im Standby jederzeit pingbar, wenn der Recher auf dem iTunes zum synchroniseren läuft auch an ist. Ansonsten ist bei iPhone Geräten nur die Aktivitätsprüfung mit einer FritzBox oder das überwachen der DHCP Lease auf einer Airport Basestation wirklich zuverlässig.

Auch wenn Bluetooth aktiviert ist, so bleiben einige Mobiltelefone erst dann empfangsbereit, wenn sie bereits zu irgend einem Bluetoothgerät gekoppelt wurden. Sind diese Geräte noch nie gekoppelt worden, deaktivieren diese ihren Bluetooth Empfänger beim verlassen des Bluetooth-Menüs im Gerät (iPhone).

Hier gilt es vor allem auszuprobieren, wie stark der Akku durch eine Anwesenheitserkennung belastet wird. Entscheidend ist hier, in welchem Abstand man eine Anwesenheitserkennung durchführt. Viele Abfragen wirken sich stärker auf den Akku aus als wenige. Wenige Abfragen bieten aber keine zuverlässige und zeitnahe Erkennung.

Als Alternative, unabhängig vom WLAN und der Erkennung, ob ein Gerät dort eingebucht ist oder nicht, bzw. unabhängig von Bluetooth kann zumindest bei einem iPhone die seit iOS 7 nochmals stark verbesserte Geo-Lokation (Geofencing) genutzt werden. Die iPhone Apps [http://geofency.com/ Geofency] oder [http://geofancy.com/ Geofancy] werden über das FHEM-Modul GEOFANCY angebunden und übertragen ihren Status immer dann, wenn ein definierter Standort betreten oder verlassen wird. Gekoppelt mit entsprechenden Notify und/oder Watchdog Kommandos ist so ebenfalls eine sehr zuverlässige Anwesenheitserkennung möglich (und das nicht nur für das eigene Zuhause).

== Das PRESENCE Modul ==
Das [[PRESENCE]] Modul bietet für die Anwesenheitserkennung mehrere Varianten an. Diese sind aktuell folgende:

* '''lan-ping''' - Das Überwachen via PING Checks, die durch den FHEM Server versandt werden.
* '''fritzbox''' - Das Überwachen von Geräten auf einer FritzBox via ctlmgr_ctl (Nur auf einer FritzBox möglich)
* '''local-bluetooth''' - Das Überwachen via Bluetooth Checks, die vom FHEM Server direkt durchgeführt werden (angeschlossener Bluetooth-Stick und die Software bluez voraussgesetzt)
* '''lan-bluetooth''' - Das Überwachen von Bluetoothgeräte, über Netzwerk. Auf einer oder mehreren Maschinen im Netzwerk (z.B. [[:Kategorie:Raspberry Pi|Raspberry Pi]]) läuft ein Presence-Daemon, der nach Bluetooth-Geräten sucht. Um mehrere Presence-Daemon mit FHEM zu verbinden, gibt es den Collector-Daemon, der sich zu allen Presence-Damons im Netzwerk verbindet und das Ergebnis von allen zusammenfasst.
* '''function''' - Das Überwachen mithilfe einer selbst geschrieben Perl-Funktion, die den Anwesenheitsstatus zurückgibt (0 oder 1)
* '''shell-script''' - Das Überwachen mithilfe eines selbst geschriebenen Shell-Programms/Skript, das eine 0 oder 1 ausgibt, um den Anwesenheitsstatus mitzuteilen.

=== Ping-Überwachung von Geräten im WLAN/LAN ===
{{Randnotiz|RNText=Um diese Methode auf einer FritzBox nutzen zu können, muss FHEM mit root-Rechten laufen. Dies ist standardmäßig nicht der Fall. Bitte dazu den Wiki Artikel [[FritzBox: fhem unter root starten]] beachten.}}
Um ein Gerät via Ping zu überwachen, muss folgende Definition durchgeführt werden:
:<code>define Handy PRESENCE lan-ping 192.168.0.30</code>

Dadurch wird die IP-Addresse 192.168.0.30 alle 30 Sekunden geprüft, ob sie erreichbar ist. Wenn sie erreichbar ist, ist der Status "present" (anwesend), ansonsten "absent" (abwesend).

Der Timeout kann verändert werden, indem ein Wert (in Sekunden) an das Define anhängt wird:
:<code>define Handy PRESENCE lan-ping 192.168.0.30 '''60'''</code>

Nun würde das Handy alle 60 Sekunden geprüft werden.

Nur wenn bei einem iPhone/iPad die Funktion "über WLAN synchronisieren" aktiviert ist, ist es auch im Standby zuverlässig pingbar. Standardmäßig deaktivieren Apple-Geräte ihr WLAN im Standby-Betrieb um die Akkulaufzeit zu verlängern.

Sollte die Fehlermeldung
:<code> PRESENCE (Handy) - ping command returned with output: ping: icmp open socket: Operation not permitted </code>
im Log auftauchen und lan-ping dadurch nicht funktionieren, liegt ein Berechtigungsproblem vor. Kein Grund den User fhem zu root zu machen!
Prüfe zu erst als User root ob die Capabilities gesetzt sind.
:<code>getcap /bin/ping</code>
Sollte folgendes Ergeben zu Tage fördern.
:<code>/bin/ping = cap_net_raw+ep</code>
Ist dem nicht so, setzen wir die benötigten Capabilities
:<code>setcap cap_net_raw+ep /bin/ping</code>
Mehr Informationen zum Thema Capabilities [https://manpages.debian.org/jessie/manpages-de/capabilities.7.de.html].

=== FritzBox: direktes Abfragen der Aktivität via ctlmgr_ctl ===
{{Randnotiz|RNText=Um diese Methode auf einer FritzBox nutzen zu können, muss FHEM mit root-Rechten laufen. Dies ist standardmäßig nicht der Fall. Bitte dazu den Wiki Artikel [[FritzBox: fhem unter root starten]] beachten.}}
Eine sehr häufige und auch zuverlässige Methode ist auf einer FritzBox die Abfrage mittels ctlmgr_ctl Befehl. Über diesen lassen sich alle Geräte abfragen ob sie aktiv sind. Ist ein Gerät aktiv, so gilt es als anwesend.

Dieser Modus kann allerdings nur in FHEM Installationen direkt auf einer FritzBox verwendet werden. Des weiteren muss FHEM unter dem User root laufen. Um ein Gerät zu überwachen, wird lediglich der Gerätename benötigt, so wie er unter dem Menüpunkt "Heimnetz" auftaucht.

Die erforderliche Definition:
:<code>define Handy PRESENCE fritzbox iPhone-4S</code>

=== Bluetooth-Überwachung von Geräten durch den FHEM Server ===
[[Datei:Bluetooth-Adresse-iPhone.png|thumb|Bluetooth-Adresse eines iPhones]]
Jenach Aufstellungsort des FHEM Servers kann es sinnvoll sein, eine Bluetooth-Überwachung direkt durch den FHEM Server durchzuführen. Hierbei gilt allerdings zu beachten, dass Bluetooth nicht für große Reichweiten gedacht ist und in den meisten Fällen keine Wände überwinden kann. Das heisst, dass in den meisten Fällen damit nur ein Raum überwacht werden kann.

Je nach Einsatzzweck kann das auch so gewollt sein. Bluetooth USB Sticks, die bereits Bluetooth 4.0 unterstützen, können höhere Reichweiten über Zimmerwände hinaus erreichen. Vorausgesetzt, das Mobilgerät unterstützt Bluetooth 4.0.

Um eine Überwachung per Bluetooth durchführen zu können, benötigt man die Bluetooth-Adresse eines Gerätes. Diese ähnelt vom Aufbau einer MAC-Adresse. Generell wird die Adresse in den Telefon-Informationen bei Smartphones angezeigt.

Um eine Anwesenheitserkennung via Bluetooth durchzuführen, wird folgende Definition in der [[Konfiguration]] benötigt:
:<code>define Handy PRESENCE local-bluetooth XX:XX:XX:XX:XX:XX</code>

=== Bluetooth-Überwachung von Geräten durch verteilte Agenten in der Wohnung (presenced/collectord) ===
[[Datei:Raspberry-Pi-mit-WLAN-und-Bluetooth-Stick.jpg|thumb|left|Raspberry Pi mit Bluetooth- und WLAN-USB-Stick]]
Um eine zuverlässige und flächendeckende Bluetooth-Anwesenheitserkennung durchzuführen, ist es unerlässlich, mehrere Bluetooth-Empfänger zu verwenden, die auf mehrere oder alle Räume verteilt sind.

Hierfür bietet sich zum Beispiel ein [[Raspberry Pi]] mit einem Mini-Bluetooth-USB-Stick und evtl. einem WLAN-USB-Stick an. Jeder Raum wird mit solch einem Raspberry ausgestattet und ist im WLAN Netz verfügbar.

Dieses Netz aus Raspberrys wird mit dem presenced (Download-Link ist in der [http://fhem.de/commandref_DE.html#PRESENCE Commandref] zum Modul enthalten) ausgestattet. Es stehen bereits entsprechende Pakete für den Raspberry zur Verfügung.

Beide Programme (presenced/collectord) sind Perl-Skripte, die als Daemon im Hintergrund laufen und auf Anfragen via Netzwerk warten. Es wird lediglich eine vollständige Perl-Grundinstallation mit Standardmodulen benötigt. Nach Installation der *.deb Pakete sollten diese noch angewiesen werden, automatisch beim Rechner-Neustart gestartet zu werden:

<pre>
sudo update-rc.d presenced defaults
sudo update-rc.d collectord defaults
</pre>

Eine detaillierte Benutzung von presenced ist in der [http://fhem.de/commandref_DE.html#PRESENCE Commandref] Beschreibung zum PRESENCE Modul enthalten.

==== Jeden Raum einzeln ansprechen (presenced) ====
Nun kann zuallererst jeder Raum einzeln angesprochen werden. Dabei ist zu beachten, dass pro Definition in der Konfiguration nur ein Gerät in einem Raum spezifisch überwacht werden kann.

Eine Definition sieht dabei folgendermaßen aus:
:<code>define Handy_Wohnzimmer PRESENCE lan-bluetooth XX:XX:XX:XX:XX:XX 192.168.0.10:5111</code>

Damit wird nun das Gerät nur im Wohnzimmer (Raspberry mit IP 192.168.0.10) überwacht.

==== Alle Räume gemeinsam ansprechen (collectord) ====
Um jedoch alle Räume gemeinsam zu verwenden, gibt es den Collector-Daemon. Dieser kennt alle presenced-Installationen im Netzwerk und führt eine koordinierte Suche nach den gewünschten Geräten durch. Sobald ein Gerät in einem Raum erkannt wurde, meldet der collectord den Status einschließlich der Angabe des Raumes, in dem das Gerät erkannt wurde.

Um alle Räume zu kennen, müssen diese mit einem Config-File dem collectord mitgeteilt werden. Dieses sieht folgendermaßen aus:

<pre>
[Schlafzimmer] # Name des Raumes (wird in FHEM als Reading angezeigt)
address=192.168.179.31 # IP-Adresse oder Hostname des presenced
port=5111 # TCP Port, der verwendet werden soll (standardmäßig Port 5111)
presence_timeout=120 # Prüfinterval, das verwendet werden soll, wenn ein Gerät anwesend ist
absence_timeout=20 # Prüfinterval, das verwendet werden soll, wenn ein Gerät abwesend ist

[Wohnzimmer]
address=192.168.179.34
port=5111
presence_timeout=180
absence_timeout=20
</pre>

Standardmäßig ist dieses Config-File unter /etc/collectord.conf zu finden. Mit dieser Konfiguration kann der Collectord gestartet werden. Es empfiehlt sich diesen mit auf dem FHEM Server zu betreiben. Die erforderliche Definition in der FHEM-Konfiguration:
:<code>define Handy PRESENCE lan-bluetooth XX:XX:XX:XX:XX:XX 127.0.0.1:5222</code>

Sobald das Handy irgendwo in der Wohnung erkannt wurde, meldet der Collectord dies sofort an FHEM und teilt den Raum mit.

Eine detaillierte Benutzung von collectord findet man in der [http://fhem.de/commandref.html#PRESENCE Commandref zum PRESENCE Modul].

=== Überwachung von Geräten mit Perl-Code ===
Es ist möglich zum Überwachen von Geräten eine eigene Perl-Funktion zu verwenden die dann vom PRESENCE Modul im Hintergrund aufgerufen wird.

define <name> PRESENCE function {...} [ <check-interval> [ <present-check-interval> ] ]

Sobald die Funktion den Rückgabewert 1 hat, ist das Gerät anwesend, bei 0 abwesend.

==== Beispiel DHCP Überwachung auf Airport Basestation ====
Die hier vorgestellte Überwachung der DHCP Lease auf Airport Basestations per SNMP ist absolut robust gegenüber dem Ruhezustand von iOS und setzt keine weitere Konfiguration auf dem iPhone voraus. Das Abmelden beim Verlassen des Empfangsbereiches der Basestation geschieht mit etwa 5-10 Minuten Verzögerung und ist somit auch vor kurzzeitigen Empfangsproblemen sicher. Das nebenstehende Bild (???) verdeutlicht noch mal die Unterschiede zwischen einer IP-Basierten Ping-Überwachung und der Überwachung auf Ebene der Basestation oder FritzBox.

Bevor der folgende Code verwendet werden kann ist das Perl Modul Net:SNMP zu installieren (z. B. mit: <code>cpan install use Net::SNMP</code>).

Zuerst ist folgender Code in 99_myUtils.pm einzufügen, sollte diese noch nicht vorhanden sein muss diese aus dem Template welches unter Edit Files zu finden ist erzeugt werden.
'''Achtung, das ist nicht der komplette Inhalt der 99_myUtils!''' Das ist nur die einzelne Routine

<pre>
use Net::SNMP;
sub
snmpCheck($$)
{
my ($airport,$client)= @_;

my $community = "public";
my $host = $airport;
my $oid = ".1.3.6.1.2.1.3.1.1.2";
#my $oid = ".1.3.6.1.2.1.3.1.1.2.25.1.10.0.1";

my ( $session, $error ) = Net::SNMP->session(
-hostname => $host,
-community => $community,
-port => 161,
-version => 1
);

if( !defined($session) ) {
return 0;
return "Can't connect to host $host.";
}

my @snmpoids = ();

my $response = $session->get_next_request($oid);
my @nextid = keys %$response;
while ( @nextid && $nextid[0] && $nextid[0] =~ m/^$oid/ ) {
push( @snmpoids, $nextid[0] );

$response = $session->get_next_request( $nextid[0] );
@nextid = keys %$response;
}

if( !defined($response = $session->get_request( @snmpoids ) ) ) {
return 0;
}

foreach my $value (values %$response) {
return 1 if( $value eq $client )
}

return 0;
}
</pre>

Danach lässt sich das Mobilgerät so überwachen:
:<code>define iPhone PRESENCE function {snmpCheck("10.0.1.1","0x44d77429f35c")} 30 30</code>

wobei 10.0.1.1 durch die IP-Adresse der Basestation und 0x44d77429f35c durch die MAC Adresse des Geräts als HEX-Zahl ersetzt werden muss.

==== Beispiel Anwesenheitserkennung mittels UniFi Controller ====

Die Anwesenheitserkennung bei Geräten in Verbindung mit UniFi-Produkten funktioniert selbst dann, wenn sich die Geräte im PowerSave-Modus befinden.

Beachte: Die Geräte werden erst ungefähr nach 5 Minuten, nachdem das Gerät das WLAN verlassen hat als disconnected angezeigt.

<code>define <NAME> PRESENCE function {ReadingsVal("<UniFi>","<NamedDevice>","") eq "connected" ? 1:0}</code>

=== Eventbasierte Anwesenheitserkennung am Beispiel mittels UniFi Controller ===
Der Vorteil gegenüber der Function-Variante ist, dass diese Variante ohne Blocking.pm-Overhead direkt ausgeführt werden kann und in "Echtzeit" abläuft (siehe {{Link2Forum|Topic=40287|Message=562823}}).

<code>define <NAME> PRESENCE event UniFi:NamedDevice:.disconnected UniFi:NamedDevice:.connected</code>

== Das GEOFANCY Modul ==
Das Modul ermöglicht über einen sogenannten Webhook Mechanismus (umgangssprachlich oft auch als "Push" benannt) das aktive Melden des aktuellen Standortes. Die iPhone Apps [http://geofency.com/ Geofency] und [http://geofancy.com/ Geofancy] können dann aktiv und quasi in dem Moment, wo man den Wohnbereich betritt oder verlässt, benachrichtigen. Android Nutzern können [https://play.google.com/store/apps/details?id=de.egi.geofence.geozone&hl=de EgiGeoZone Geofence] nutzen. Das geht nochmals um einiges schneller, als die Erkennung im WLAN, bei der die Anwesenheit nur in (engen) Zyklen aktiv geprüft werden muss. Gleichzeitig werden Ressourcen in FHEM geschont. Die aktuelle Implementierung im iPhone 5S mit dediziert für das Tracking zuständigem Chip ist so gut, dass der Akku ebenfalls sehr geschont wird.

=== Modul in FHEM einrichten ===
Das Modul ist mit einer einfachen Definition sofort betriebsbereit:
:<code>define geofancy GEOFANCY geo</code>

Damit nimmt FHEM unter <nowiki>http://192.168.178.1:8083/fhem/geo</nowiki> entsprechende Meldungen des iPhones entgegen. Damit das nicht nur über das lokale WLAN funktioniert, bedarf es allerdings noch einiger zusätzlicher Maßnahmen. FHEM muss vom Internet erreichbar gemacht werden, dabei sollte unbedingt an die Absicherung des Zugriffs gedacht werden.

Zunächst einmal habe ich bei mir eine eigene FHEMWEB Instanz dafür angelegt:
<pre>
define WEBhook FHEMWEB 8088 global
attr WEBhook column Alarms: Apartment: Living: Bedroom: Kitchen: Sonos: Residents: Weather: Bathroom: Logs: Statistics: DashboardRoom: System: hidden: all:
attr WEBhook hiddenroom input,detail,save,Unsorted,Everything,CUL_HM,FS20,Commandref,style,Edit files,Select style,Logfile,Floorplans,Remote doc,FileLogs,Apartment,Bathroom,Bedroom,Kitchen,Living,Residents,System,Weather,Event monitor,NEW
attr WEBhook room hidden
attr WEBhook webname webhook
</pre>

Damit ist unter der URL <nowiki>http://192.168.178.1:8088/webhook/geo</nowiki> das GEOFANCY Modul erreichbar. Ich verstecke in dieser Ansicht noch alle Räume, die ich so habe. Wer die Raumnamen allerdings kennt, kann sie trotzdem aufrufen. Die Anzeige in den Räumen kann man mit dem Attribut column und entsprechend leeren Definitionen verstecken. Nun muss man explizit den Devicenamen kennen, um noch etwas über die Konfiguration in Erfahrung bringen zu können.
Auch wenn das Security-by-Obscurity ist - ich fühle mich wohler damit.

=== Webhook weiter absichern ===
Mit Hilfe eines [http://fhem.de/commandref.html#allowed allowed]-Devices lässt sich die FHEMWEB Instanz noch weiter absichern indem nur die tatsächlich benötigten Kommandos erlaubt werden (in diesem Fall keine) und damit alle anderen nicht erlaubten (attr,define,get,set,...) automatisch nicht mehr zur Verfügung stehen:
<pre>
define allowedWEBhook allowed
attr allowedWEBhook allowedCommands ,
attr allowedWEBhook allowedDevices ,
attr allowedWEBhook validFor WEBhook
</pre>

Außerdem ist dringend zu empfehlen, den Zugriff über TLS/SSL und HTTP Basic-Authentication weiter abzusichern. Läuft FHEM auf einem Raspberry Pi, dann empfehle ich dazu die Konfiguration eines ReverseProxy (vorzugsweise HAproxy, Pound oder Varnish, notfalls auch Nginx oder Apache); damit ist man am flexibelsten und kann auch alle FHEMWEB Instanzen direkt über einen einzigen Port (meist 443, der HTTPS Standard Port) zusammenfassen. Ich möchte hier allerdings beschreiben, wie weit man mit FHEM Bordmitteln kommt und nehme das Beispiel einer Installation auf einer Fritzbox.

Wie TLS aktiviert wird, steht in der Commandref für [[FHEMWEB]]. Um die Kommandos auf der Fritzbox ausführen zu können, muss zuerst Telnet aktiviert werden (bitte Google benutzen). Anschließend wechselt man auf der Fritzbox ins Verzeichnis /var/media/ftp/fhem und kann dann den Hinweisen aus der [http://fhem.de/commandref.html#FHEMWEB Commandref] unter dem Punkt HTTPS folgen. Letztlich fehlt noch das entsprechende Attribut:

<pre>
attr WEBhook HTTPS
</pre>

Als nächstes aktivieren wir Benutzername+Passwort für den Zugriff. Die commandref für allowed gibt auch hier unter dem Punkt basicAuth entsprechende Hinweise. Wir fügen hier einfach mal einen Benutzer "webhook" mit dem Passwort "Geofancy" hinzu, das sieht dann so aus:

<pre>
attr allowedWEBhook basicAuth { "$user:$password" eq "webhook:Geofancy" }
</pre>

Weitere Infos zur Absicherung gibt auch [[FritzBox Webzugriff absichern]].

Um zu testen, ob unsere Absicherung erfolgreich war, kann man die URL <nowiki>https://192.168.178.1:8088/webhook/geo</nowiki> aufrufen (wichtig ist, dass man jetzt https und nicht mehr http eingibt; ansonsten bekommt man keine Antwort). Eine Zertifikatswarnung kann getrost ignoriert werden, verschlüsselt wird trotzdem. Es sollte auch eine Passwort Abfrage kommen und die Eingabe der entsprechenden Daten sollte dann zu einer entsprechenden Meldung vom GEOFANCY Modul führen:

<pre>
NOK No data received, see API information on http://wiki.geofancy.com
</pre>

Das ist ok, schließlich sind wir keine App, sondern der Mensch, der nur mal eben prüfen will :-)

=== Zugriff vom Internet ermöglichen ===
Das ist je nach Fritzbox und Software Version unterschiedlich. Grundsätzlich gilt: Eine Weiterleitung des ports 8088 vom Internet auf das laufende FHEM auf Port 8088 intern ist von AVM so nicht vorgesehen.
Bei mir führte folgendes zum Erfolg:

* Einloggen per Telnet auf der Fritzbox (ich habe FritzOS 6 installiert)
* Konfiguration editieren mittels "nvi /var/flash/ar7.cfg"
* Suchen nach richtiger Zeile durch Eingabe von "/internet_forwardrules" und Enter
* Hinzufügen einer weiteren Zeile (Vorsicht, die bestehende Zeile endet mit ; und das muss in , umgeändert werden, so dass das ; schließlich am Ende der Zeile steht.

So sieht es bei mir vorher aus:
:<code>internet_forwardrules = "tcp 0.0.0.0:488 0.0.0.0:488 0";</code>
Hinterher:
:<code>internet_forwardrules = "tcp 0.0.0.0:488 0.0.0.0:488 0", "tcp 0.0.0.0:8088 0.0.0.0:8088 0";</code>

Danach mittels ":x" abspeichern und sofort per "reboot" die Box neu starten, um diese Änderungen zu aktivieren. Das ist wichtig; ansonsten zeigt die Erfahrung, dass die Änderung nicht dauerhaft erhalten bleibt und die gerade gemachten Änderungen verloren gehen.

Wer die Einstellungen zu "internet_forwardrules" bei sich nicht finden kann, hat womöglich eine andere Version als ich oder ein leicht anderes Gerät und bemüht am besten Google, was er tun kann, um das Gleiche zu erreichen. Möglicherweise tauchen die Einträge auch erst auf, wenn man mal über das Webinterface ein Forwarding eingerichtet hatte.

Hat man einen DynDNS Dienst oder myFritz auf der Fritzbox aktiviert, so kann man jetzt auch von draußen auf den Webhook zugreifen. Das kann man prüfen, indem man das iPhone aus dem WLAN ausbucht und einmal die externe Adresse eingibt, also z.B. https://meindyndns.org:8088/webhook/geo.

=== Weitere Alternativen für den Zugriff aus dem Internet ===
Als Alternative zum Port Forwarding kann man sich auch per VPN in das lokale Netzwerk einwählen. iOS bietet dazu auch eine automatische Aktivierung des VPN (VPN on Demand), wie z.B. [http://forum.loxone.com/dede/netzwerk-firewall-and-security/8121-vpn-demand-ios-8-1-1-fritz-box-kleine-how.html hier] beschrieben wird.

Auch eine Alternative ist, das Portforwarding nicht direkt an FHEM einzurichten, sondern an einem im Netzwerk laufenden Reverse-Proxy, der dann seinerseits die Anfragen an FHEM weiterleitet. Dies kann z.B. Apache, Nginx oder am besten HAproxy sein.
Letzterer ist dabei sehr flexibel, allerdings nicht unbedingt einfach zu konfigurieren. Ein paar Inspirationen diesbezüglich gibt es z.B. [https://github.com/Hoanoho/HSE/tree/develop/lib/cfg/any/stat/etc/haproxy hier] und [https://github.com/Hoanoho/HSE/tree/develop/lib/cfg/any/dyn/etc/haproxy hier]. Wer pfSense nutzt, findet [http://loredo.me/post/116633549315/geeking-out-with-haproxy-on-pfsense-the-ultimate diesen Artikel] womöglich auch interessant. Er zeigt auch, dass mit HAproxy noch weit mehr möglich ist.
Der Reverse-Proxy sollte dabei auch unbedingt der TLS Termination Point sein (TLS Offloading). Nicht nur spart man sich dann die Aktivierung von TLS in FHEM, sondern man hat auch mehr Einfluss darauf, wie TLS arbeitet (z.B. Deaktivierung von SSLv3, forcieren von TLSv1.2, nur als sicher eingestufte Cipher Suite... siehe auch Infos auf der [https://wiki.mozilla.org/Security/Server_Side_TLS Mozilla Website]).

=== Einrichten in der Geof[e|a]ncy.app ===
Hat das alles soweit geklappt, können endlich in der Geofency.app bzw. Geofancy.app am iPhone die gewünschten Bereiche definiert werden. Am Besten zuvor in den Global Settings die folgenden Einstellungen hinterlegen:

* URL: https://meindyndns.org:8088/webhook/geo
* POST (oder GET, ist egal - das FHEM Modul kann beides)
* HTTP Basic Authentication: EIN (entsprechend Username und Password eintragen)

Anfänglich ist es empfehlenswert noch "Notification on success" und "Notification on Failure" einzuschalten. Ersteres kann man ausmachen wenn man weiß, dass es soweit funktioniert. Über "Send Test-Request" kann man einmal einen Test schicken und erhält das Ergebnis entsprechend dargestellt. Es sollte sowas kommen wie
:<code>POST Success: test OK</code>. In Geofancy.app gibt es keine Rückmeldung über den Erfolg des Testrequests. In FHEM sollten sich durch den Testrequest jedoch die Readings sofort aktualisieren (Ggf. ist ein Reload der FHEMWEB-Seite nötig da zusätzliche Tabellenzeilen nicht via Longpoll ergänzt werden).

Funktioniert das soweit, kann man eine neue Lokation als sein Zuhause anlegen. Es empfiehlt sich einen ID-Namen zu setzen; dieser ist dann in FHEM als Name für die Lokation sichtbar. Für die eigene Wohnung empfiehlt sich hier "home" (da dies auch direkt vom RESIDENTS Modul so verwendet werden kann). Man kann auch Trigger für andere Standorte anlegen. FHEM weiß dann sogar, wenn ihr im Büro seid und könnte sich dabei auch unterschiedlich verhalten, als wenn ihr "auf Achse" seid. Bei letzterem ist der Status im GEOFANCY Modul "underway", was so viel heißt wie "unbekannter Aufenthaltsort".

Hinweis: Zumindest für Geofancy.app liefert ein Testrequest wohl zufällige Locations zurück. Die eigenen Location-IDs werden also nicht übergeben, selbst wenn man sich in einem Geofence befindet. Um zu testen muss man sich wohl oder übel selbst bewegen ;-).

=== GEOFANCY Modul individualisieren ===
Die im GEOFANCY Modul dargestellten Readings sind nun in etwa so, wenn ihr euch bewegt:

<pre>
Readings:
2014-01-18 14:37:42 lastDevice -
2014-01-18 14:37:42 lastDeviceUUID 51F23894-AAAA-BBBB-CCCC-0123456789AB
2014-01-18 14:37:42 state dev:51F23894-AAAA-BBBB-CCCC-0123456789AB trig:test id:home lat:48.9999 long:11.9999
</pre>

Wer genauer hinschaut sieht: Mein iPhone heißt wohl 51F23894-AAAA-BBBB-CCCC-0123456789AB.
Damit nun die Readings für mein iPhone richtig angelegt werden, muss ein Device Alias gesetzt werden. Sinnvoll erscheint mir der Vorname des Besitzers:
:<code>attr geofancy devAlias 51F23894-AAAA-BBBB-CCCC-0123456789AB:Julian</code>

Weitere Alias-Namen können mit Leerzeichen einfach angehängt werden.
Jetzt werden weitere Readings angelegt, sobald GEOFANCY entsprechende Daten vom Mobilgerät empfängt:

<pre>
Readings:
2014-01-18 14:37:42 Julian arrived home
2014-01-18 14:37:42 currLocLat_Julian 48.9999
2014-01-18 14:37:42 currLocLong_Julian 11.9999
2014-01-18 14:37:42 currLocTime_Julian 2014-01-18 14:37:42
2014-01-18 14:37:42 currLoc_Julian home
2014-01-17 19:18:23 lastArr Julian home
2014-01-17 18:41:46 lastDep Julian Office
2014-01-18 14:37:42 lastDevice Julian
2014-01-18 14:37:42 lastDeviceUUID 51F23894-AAAA-BBBB-CCCC-0123456789AB
2014-01-17 18:41:46 lastLocArr_Julian 2014-01-17 08:58:37
2014-01-17 18:41:46 lastLocDep_Julian 2014-01-17 18:41:46
2014-01-17 18:41:46 lastLocLat_Julian 48.1111
2014-01-17 18:41:46 lastLocLong_Julian 11.1111
2014-01-17 18:41:46 lastLoc_Julian Office
2014-01-18 14:37:42 state dev:Julian trig:test id:home lat:48.9999 long:11.9999
</pre>

Möchte man nun etwas bestimmtes tun, wenn man nach Hause kommt oder das Heim verlässt, kann man am Besten ein entsprechendes Notify auf das Reading currLoc_Name setzen. Ich aktualisiere lediglich zwei Dummies, durch die dann alle weiteren Notifies ausgelöst werden:

<pre>
define n_Julian.Presence notify geofancy:currLoc_Julian:.home set Julian.homestatus:FILTER=STATE!=home home
attr n_Julian.Presence room Residents
define n_Julian.absence notify geofancy:currLoc_Julian:.underway {\
if (Value("Julian.homestatus") ne "gone") {\
fhem("set Julian.homestatus:FILTER=STATE!=absent absent");;\
}\
}
define n_Julian.whereabout notify geofancy:currLoc_Julian:.* set Julian.whereabout:FILTER=STATE!=$EVTPART1 $EVTPART1
</pre>

Wer es noch einfacher möchte (bzw. auch noch mehr Features) schaut sich einmal die neue Modulfamilie aus RESIDENTS[http://fhem.de/commandref_DE.html#RESIDENTS], ROOMMATE[http://fhem.de/commandref_DE.html#ROOMMATE] und GUEST[http://fhem.de/commandref_DE.html#GUEST] an. Diese sind direkt auf GEOFANCY abgestimmt. Dabei kann das devAlias Attribut entfallen und man hinterlegt die UUID stattdessen direkt im ROOMMATE oder GUEST Device (Attribut r*_geofenceUUIDs). Das erspart es für jeden Bewohner und jedes Device zig unterschiedliche Devices der Typen Notify, DOIF oder Watchdog anlegen und pflegen zu müssen.

Wer mehr Kontrolle möchte kann natürlich bei notify, DOIF und Co. bleiben: <code>define n_rr_Julian.location notify geofancy:currLoc_Julian:.* set rr_Julian:FILTER=location!=$EVTPART1 location $EVTPART1</code>. Wobei "Julian" dabei als devAlias in GEOFANCY eingtragen wurde, rr_Julian der Name des ROOMMATE aus RESIDENTS ist. Außerdem wurden die Location-IDs in der Geofency.app bzw. Geofancy.app so gewählt, dass diese direkt einem ROOMMATE-Status entsprechen (also z.B. home, wayhome...).

== Beispiele für die Nutzung der Anwesenheitserkennung ==
Hier sollen Beispiele für den Nutzen von Anwesenheitserkennung aufgezeigt werden.

=== Abschalten aller Verbraucher (Licht, Musikanlage) beim Verlassen der Wohnung ===
Typisches Szenario: Man geht ausser Haus, aber hat vergessen im Bad das Licht aus zu machen. Allerdings geht man heutzutage fast garnicht mehr ohne Handy aus dem Haus.

Nun soll FHEM in der gesamten Wohnung das Licht, sowie sonstige Verbraucher ausschalten, wenn ich länger als 15 Minuten ausser Haus bin. Dazu benötigt man zuerst eine structure, die alle Verbraucher und sonstigen Devices, die das betrifft, zusammenfasst.

<pre>
define Gesamte_Wohnung structure Gesamtes_Licht Licht_Wohnzimmer Licht_Kueche LED_Kueche Licht_Bad Licht_Schlafzimmer AV_Receiver TV_Steckdose
attr Gesamte_Wohnung room Wohnung
</pre>

Nun kann man mittels eines watchdogs eine Überwachung für sein Handy anlegen:

<pre>
# Überwachen der gesamten Wohnung mittels collectord sowie presenced in jedem Raum
define Handy PRESENCE lan-bluetooth XX:XX:XX:XX:XX:XX 127.0.0.1:5222
attr Handy event-on-change-reading state # Ein Event soll nur bei der Änderung des Anwesenheitsstatus (Reading: status) erfolgen. Wichtig für den watchdog!!!

# Nach 15 Minuten Abwesenheit (Handy im Status "absent") soll die gesamte Wohnung ausgeschaltet werden.
define watchdog_Anwesenheit watchdog Handy:absent 00:15 Handy:present set Gesamte_Wohnung off ; trigger watchdog_Anwesenheit .
attr watchdog_Anwesenheit regexp1WontReactivate 1
</pre>

=== Benachrichtigung bei Batteriewechsel ===
Mit Hilfe des PRESENCE-Moduls kann man auch bei batteriebetriebenen Geräten eine Meldung ausgeben, sobald ein Batteriewechsel ansteht. Hier im Beispiel wird der Eve-Room-Sensor von Elgato eingebunden und anschließend mit einer DOIF-Nachricht ausgestattet.
Die Bluetooth-Adresse des Sensors kann mittels eines BLE-Scanners ermittelt werden.

<pre>
# PRESENCE-Modul für Elgato Eve Room Sensor mit Aktualisierung aller 6 Minuten
define Eve_Room_BLE lan-bluetooth <Bluetooth-Adresse> 127.0.0.1:5333 360
</pre>

Anschließend wird eine DOIF-Regel definiert, die eine Nachricht an die installiere [[FHEM_APP|FHEM App]] absendet:
<pre>
define Eve_Room_BLE_Battery_Msg DOIF ([Eve_Room_BLE] eq "absent") (set Msg_iPhone message 'Batteriewechsel beim Eve Room Sensor im Wohnzimmer.')
attr Eve_Room_BLE_Battery_Msg wait 600
</pre>

Die Aktualisierung des PRESENCE-Eintrages sollte nicht größer sein als das WAIT-Attribut der DOIF-Regel. Ansonsten könnte eine kurze Systemstörung zum Fehlalarm führen.

== Anwesenheitserkennung Bluetooth PebbleBee mit PRESENCE Modul ==
Im Forum gibt es einen {{Link2Forum|Topic=28753|LinkText=langen Beitrag}} über die Einrichtung eines BT-Tag an einem RaspberryPI mit FHEM. Dabei werden Skripte wie blescan.pl und lepresenced genannt.
Da mittlerweile viele neue Informationen zusammen gekommen sind wurde der Wiki Eintrag erstellt.

Im Folgenden wird die Konfiguration für '''LE Deviced (z.B. Gtags,Pebbles etc.)''' und '''NICHT LE Device (z.B. IPhone)''' beschreiben.

{{Randnotiz|RNText=Beide hier beschriebenen Wege (presenced/lepresenced) können parallel auf dem selben BT-Dongle laufen, da sich die Ports unterscheiden! }}
'''Wo finde ich denn lepresenced?'''

lepresenced kann über Github heruntergeladen werden (Link weiter unten)

'''Was ist der Vorteil gegenüber blescan.pl?'''

blescan.pl hat u. a. das Problem, dass dank der wundervollen Bluetooth-Implementierung unter Linux ab und zu der Scan fehlschlägt und das Interface resettet werden muss. Das tut blescan.pl auch mit aller Gewalt. Dazu kommt, dass bei längeren Scanzeiten und vielen Tags sich die Prozesse anstauen, weil immer nur auf einen Tag "gewartet" wird. Außerdem wurden mit der Einführung von lepresenced sämtliche Supportverträge gekündigt lepresenced läuft dauerhaft und merkt sich bei allen sendenden Tags den Zeitstempel des letzten Empfangs.

=== Getestete Hardware/Software===
* '''Raspbian System''' - wheezy, Jessie
* '''BT-Dongle''' - CSL NET BT USB2.0 Stick, Bluetooth V4.0, Nano '''Achtung''': Es muss ein BT V4.0 oder höher verwendet werden. Nur dieser unterstützt ''LowEnergy''
* '''BT-TAG''' - Gtag von Gigaset, TrackR, UDOO Neo, PebbleBee, iTag von Unitec, X4-LIFE Multifunkti BL-Anhänger, iTag Wireless Anti, Trackr bravo

=== BT Dongel am PI installieren ===

Um den BT Dongle ''(hier: CSL NET BT USB2.0)'' am PI verwenden zu können, müssen die notwendigen Pakete über die Paketverwaltung von debain nachinstalliert werden.
Wer bereits ein BT-Dongle installiert hat, kann diesen Schritt überspringen.
<pre>
apt-get install bluetooth
</pre>
Nach erfolgreicher Installation der Pakete sollte der RaspberryPI neu gestartet werden.
<pre>
sudo reboot
</pre>

Nach dem erfolgten Reboot bitte das Log des Raspberry auf folgende Einträge prüfen:
<pre>
Feb 12 19:52:55 fhem kernel: [ 4.773600] Bluetooth: Core ver 2.20
Feb 12 19:52:55 fhem kernel: [ 4.773748] NET: Registered protocol family 31
Feb 12 19:52:55 fhem kernel: [ 4.773765] Bluetooth: HCI device and connection manager initialized
Feb 12 19:52:55 fhem kernel: [ 4.773797] Bluetooth: HCI socket layer initialized
Feb 12 19:52:55 fhem kernel: [ 4.773821] Bluetooth: L2CAP socket layer initialized
Feb 12 19:52:55 fhem kernel: [ 4.773890] Bluetooth: SCO socket layer initialized
Feb 12 19:52:55 fhem kernel: [ 4.797531] usbcore: registered new interface driver btusb
</pre>
Sobald der BT-Dongle erkannt wurde ''leuchtet'' (wenn vorhanden) auch die ''blaue/gelbe'' LED am Dongle auf.

=== BT-Tags aktivieren ===
Jetzt kann der BT-Tag aktiviert werden. Bei einigen Tags muss dafür die '''Batteriesicherung''' gezogen werden.

Einen Tag wird mit folgendem Befehl auf der Konsole gesucht:
<source lang="bash">
sudo hcitool lescan

Ausgabe z.B.:
LE Scan ...
7C:2F:80:A1:XA:XD (unknown)
7C:2F:80:A1:XA:XD Gigaset G-tag
7C:2F:80:A1:X4:X1 (unknown)</source>
Eine Übersicht über die möglichen Befehle von hcitool gibt es mit der Eingabe von:
<pre>
sudo hcitool

Ausgabe z.B.:
hcitool - HCI Tool ver 5.23
Usage:
hcitool [options] <command> [command parameters]
Options:
--help Display help
-i dev HCI device
Commands:
dev Display local devices
inq Inquire remote devices
scan Scan for remote devices
name Get name from remote device
info Get information from remote device
spinq Start periodic inquiry
epinq Exit periodic inquiry
cmd Submit arbitrary HCI commands
con Display active connections
cc Create connection to remote device
dc Disconnect from remote device
sr Switch master/slave role
cpt Change connection packet type
rssi Display connection RSSI
lq Display link quality
tpl Display transmit power level
afh Display AFH channel map
lp Set/display link policy settings
lst Set/display link supervision timeout
auth Request authentication
enc Set connection encryption
key Change connection link key
clkoff Read clock offset
clock Read local or remote clock
lescan Start LE scan
lewladd Add device to LE White List
lewlrm Remove device from LE White List
lewlsz Read size of LE White List
lewlclr Clear LE White list
lecc Create a LE Connection
ledc Disconnect a LE Connection
lecup LE Connection Update
</pre>

Falls beim SCAN kein Tag gefunden wird, sollte das BT Interface neu gestartet werden. Dazu ist kein Reboot des PI notwendig.
<source lang="bash">
sudo hciconfig hci0 down
sudo hciconfig hci0 up
sudo hcitool dev
</source>

=== Anleitung für ein LE Device (z.B. Gtags,Pebbles etc.) ===

Die Software lepresenced kann aktuell über drei Varianten installiert werden. Dabei ist die bevorzugte Variante (Variante 1) die Installation über das bereitgestellte .deb-Paket.
Die Variante 2 setzt voraus, dass im FHEM contrib Verzeichnis (/opt/fhem/contrib) die aktuelle Version des .deb-Pakets liegt. Die Variante 3 ist dafür gedacht, wenn man keine .deb-Pakete installieren kann/will oder es aus anderen Gründen nicht funktioniert. Es wird davon abgeraten die Variante 3 zu verwenden. Vollständigkeithalber wird sie aber aufgeführt.

====Installation per .deb-Paket====

Die bevorzugte Variante ist die Installation von lepresenced durch die passenden .deb Pakete.

'''1.Variante:'''
Herunterladen der aktuellen lepresenced-0.81-1.deb Datei über den Webbrowser
[https://svn.fhem.de/trac/export/HEAD/trunk/fhem/contrib/PRESENCE/deb/ SVN-Repository]. Im SVN die passende Datei auswählen und in der folgende Webseite den Link unter:
<pre>
Download in other formats:
Original Format
</pre>
anklicken und die Datei herunterladen.
Die Datei kann jetzt auf den RPi kopiert und mit folgenden Befehlen ausgeführt werden (ggf. Berechtigungen anpassen).

Alternativ per wget Befehl direkt auf den RPi
https://svn.fhem.de/trac/export/13992/trunk/fhem/contrib/PRESENCE/deb/lepresenced-0.81-1.deb

'''2.Variante:'''
Herunterladen aus dem fhem contrib Verzeichnis:
Hierzu muss das contrib auf dem aktuellen Stand sein. Dazu wird die Installation von subversion (normal bereits vorhanden) benötigt.

sudo apt-get install subversion

Danach kann per
sudo svn checkout https://svn.fhem.de/fhem/trunk/fhem/contrib svnrepo

Das aktuelle Repository auf den Pi heruntergeladen werden. Danach sollte im gewählten Verzeichnis die eingecheckten Dateien verfügbar sein.
/opt/fhem/svnrepo/PRESENCE/deb

''' Installation der Variante 1 oder 2 '''
Egal welche Variante gewählt wurde, kann nun mit folgenden Befehlen das Paket installiert werden. Bitte Pfade ggf. anpassen.

sudo dpkg -i lepresenced-0.81-1.deb

sudo apt-get -f install

Die Ausgabe der Installation sollte am Ende ein [ ok ] Starting lepresenced (via systemctl): lepresenced.service. ausgeben.

<pre>
Paketlisten werden gelesen... Fertig
Abhängigkeitsbaum wird aufgebaut.
Statusinformationen werden eingelesen.... Fertig
Abhängigkeiten werden korrigiert ... Fertig
Die folgenden zusätzlichen Pakete werden installiert:
bluez-hcidump
Die folgenden NEUEN Pakete werden installiert:
bluez-hcidump
0 aktualisiert, 1 neu installiert, 0 zu entfernen und 0 nicht aktualisiert.
1 nicht vollständig installiert oder entfernt.
Es müssen 157 kB an Archiven heruntergeladen werden.
Nach dieser Operation werden 490 kB Plattenplatz zusätzlich benutzt.
Möchten Sie fortfahren? [J/n]
Holen: 1 http://archive.raspberrypi.org/debian/ jessie/main bluez-hcidump armhf 5.23-2+rpi2 [157 kB]
Es wurden 157 kB in 0 s geholt (921 kB/s).
Vormals nicht ausgewähltes Paket bluez-hcidump wird gewählt.
(Lese Datenbank ... 42033 Dateien und Verzeichnisse sind derzeit installiert.)
Vorbereitung zum Entpacken von .../bluez-hcidump_5.23-2+rpi2_armhf.deb ...
Entpacken von bluez-hcidump (5.23-2+rpi2) ...
Trigger für man-db (2.7.0.2-5) werden verarbeitet ...
bluez-hcidump (5.23-2+rpi2) wird eingerichtet ...
lepresenced (0.81-1) wird eingerichtet ...
[ ok ] Starting lepresenced (via systemctl): lepresenced.service.
</pre>

Ab hier kann, wenn alles problemlos funktioniert hat mit der [[Einrichtung der G-Tags über FHEM]] weitergemacht werden.

'''3.Variante:'''

Bei dieser Variante wird das aktuellste lepresenced Skript aus github heruntergeladen. Das bedeutet, dass jegliche Konfiguration wie automatischer Start, Berechtigungen etc.
manuell konfiguriert werden muss. Diese Variante eignet sich nur für diejenigen, die keine .deb-Pakete installieren wollen/können oder die genau Wissen, was sie tun!
<pre>
https://github.com/mhop/fhem-mirror/blob/master/fhem/contrib/PRESENCE/lepresenced
</pre>

Zur "Installation" des Skripts folgendermaßen vorgehen:
Unter /fhem manuell den Ordner „script“ anlegen:
<pre>
mkdir script
</pre>
Datei lepresenced reinkopieren und ausführbar machen:
<pre>
sudo chmod +x /opt/fhem/script/lepresenced
sudo chgrp -cR dialout lepresenced
</pre>
Skript erstmalig starten:
<pre>
sudo ./lepresenced --loglevel LOG_EMERG -d
</pre>
Kommt beim Starten des Skript eine Fehlermeldung, müssen die Abhängigkeiten aufgelöst werden.
<pre>
Can't locate Net/Server/Daemonize.pm in @INC (@INC contains: /etc/perl /usr/local/lib/perl/5.14.2 /usr/local/share/perl/5.14.2 /usr/lib/perl5 /usr/share/perl5 / usr/lib/perl/5.14 /usr/share/perl/5.14 /usr/local/lib/site_perl .) at /opt/fhem/lepresenced line 17.
BEGIN failed--compilation aborted at /opt/fhem/lepresenced line 17.
</pre>
Um die Abhängigkeiten aufzulösen muss folgendes nachinstalliert werden und anschließend ein Reboot durchgeführt werden.
<pre>
sudo apt-get install libnet-server-*
</pre>

====Einrichtung der G-Tags über FHEM====

Nach dem letzten Schritt sind alle Bedingungen für eine abschließende Konfiguration der BT-Tags in FHEM abgeschlossen worden.
Jetzt kann der Tag dem FHEM-Server bekannt gemacht werden.
<pre>
-- Name Modul Modus MAC vom Gtag IP vom PI Port Abfragezeit in Sekunden
define MeinGtAG PRESENCE lan-bluetooth xx:xx:xx:xx:xx:xx 127.0.0.1:5333 120
</pre>

Den absent und present Mode kann man einfach testen, in dem man den Gtag mit Alufolie einwickelt.

=== Anleitung für ein NICHT LE Device (z.B. IPhone) ===
Die Installation kann (wie in der commanref beschrieben) über Debian Pakete erfolgen.
<pre>
.deb package for Debian (noarch): presenced-1.4.deb https://svn.fhem.de/fhem/trunk/fhem/contrib/PRESENCE/deb/presenced-1.4.deb

.deb package for Raspberry Pi (raspbian): presenced-rpi-1.4.deb https://svn.fhem.de/fhem/trunk/fhem/contrib/PRESENCE/deb/presenced-rpi-1.4.deb
</pre>

<pre>
sudo dpkg -i presenced-rpi-1.4.de
</pre>

Installation perl script file (Auszug commanref)
<pre>
direct perl script file: presenced https://svn.fhem.de/fhem/trunk/fhem/contrib/PRESENCE/presenced
</pre>

Nach dem letzten Schritt sind alle Bedingungen für eine abschließende Konfiguration der BT-Tags in FHEM abgeschlossen worden.
Jetzt kann der Tag dem FHEM-Server bekannt gemacht werden.
{{Randnotiz|RNText=Wenn man mit collectord arbeitet muß man die Erkennung bei allen Devices auf port 5222 setzen.
lan-bluetooth xx:xx:80:xx:xx:AC 127.0.0.1:5222 20 120}}
<pre>
-- Name Modul Modus MAC vom Gtag IP vom PI Port Abfragezeit in Sekunden
define MeinGtAG PRESENCE lan-bluetooth xx:xx:xx:xx:xx:xx 127.0.0.1:5333 120
</pre>

=== Automatischer Start ===

Wurde leprecend mit der oben genannten Variante 1 oder 2 installiert worden sein, wird per systemctl der automatische Start direkt eingerichtet. Es ist somit keine extra Konfiguration per Cron oder init.d notwendig.

Wurde die Variante 3 - die manuelle Installation - durchgeführt; bitte folgende Schritte für den automatischen Start befolgen:

Damit das leprecend Skript beim Systemstart mitgestartet wird, sollte eine Crontab Eintrag gesetzt werden. Alternativ die rc.local anpassen.
Ersteres würde so aussehen:

Ein sh-Skript mit dem Inhalt:
<pre>
sudo start-stop-daemon -d /opt/fhem/script -S -x /opt/fhem/script/lepresenced &
</pre>
unter dem Verzeichnis /home/pi ablegen, welches sich init_start.sh nennt.

Das Skript dann unter: sudo crontab -e einhängen mit folgender Folge:
<pre>
@reboot /home/pi/init_start.sh
</pre>

Zweiteres so:
<pre>
sudo nano /etc/rc.local
</pre>

Datei rc.local, freie Stelle suchen, vor "exit 0":

<pre>
# Start lepresenced
/opt/fhem/script/lepresenced --loglevel LOG_EMERG -d
exit 0
</pre>

=== Batterieüberwachung (aktuell nur G-Tags) ===

Leider überträgt der G-Tag nach der Einrichtung als Device in FHEM kein Reading mit seinem aktuellen Batteriestatus.
Dem wurde mit Hilfe des Forum Abhilfe geschaffen.
Im Folgenden wird erläutert wie die Batterieüberwachung eingerichtet werden kann.

'''Voraussetzung:'''

bc - Basiscalculator [https://packages.debian.org/de/sid/bc Bc-Paket]
<pre> sudo apt-get install bc </pre>

Anlegen eines Shellskript auf dem Raspberry System.
Die Parameter <<MAC-Adresse>> und <<TagName>> müssen durch die Werte des auszulesenden G-Tags ersetzt werden.
<pre>
#!/bin/bash
stringZ=$(sudo gatttool -b 5C:2B:80:C1:14:41 --char-read --handle=0x001b)
stringZ=${stringZ:33:2}
stringZ=$(echo "$stringZ" | tr a-f A-F)
decimal=$(echo "ibase=16; $stringZ" | bc)
perl /opt/fhem/fhem.pl 7072 "setreading MeinGtag Batterie $decimal"
</pre>

Dem Device in FHEM (hier MeinGtag) ein userReading mit dem Namen '''Batterie''' hinzufügen.
Das Shellskript mit folgendem Befehl starten:
<pre>
./GtagBatterie.sh
</pre>
'''Wichtig ist hierbei,''' dass Skript mit "./" und nicht mit "sh" aufzurufen. Beim Aufruf mit "sh GtagBatterie.sh" produziert es einen Fehler
<pre>GtagBatterie.sh: 3: GtagBatterie.sh: Bad substitution </pre>

Das Reading wird auf den ausgelesenen Wert der Batterie gesetzt.

Hinweis: Es sollte für jeden G-Tag ein eigenes Skript abgelegt werden. Das Skript kann per crontab oder fhem Kommando (system) regelmäßig aufgerufen werden.

=== Batterieüberwachung (alle Devices vom Typ "MODE=lan-bluetooth") ===

Es gibt eine weitere Möglichkeit um den Batteriestatus von LE Devices abzurufen und in FHEM als Reading darzustellen.
Dabei wird der Batteriezustand für alle LE Devices, die bereits in FHEM konfiguriert sind und per lepresenced überwacht werden, automatisch in einem shell-Script ermittelt.
Näheres dazu im Forumartikel {{Link2Forum|Topic=56960|LinkText=Erweiterung: Anwesenheitserkennung/Batterieüberwachung}}.

Vorteile:
* Automatische Ermittlung aller in FHEM konfigurierten LE Devices
* Möglichkeit, diese Devices alternativ manuell im Script einzutragen
* Es werden nur Devices abgefragt, die im Status "present" sind, also mit ziemlicher Sicherheit auch verfügbar sind
* Ein eventuell auf dem FHEM telnet-Port gesetztes Passwort kann im Script hinterlegt werden

'''Voraussetzung:'''

'''Funktionierendes lepresenced''' - siehe [[Anwesenheitserkennung#Anleitung_f.C3.BCr_ein_LE_Device_.28z.B._Gtags.2CPebbles_etc..29|Anleitung für ein LE Device (z.B. Gtags,Pebbles etc.)]]

'''socat''' - TCP port forwarder
<pre>
sudo apt-get update && sudo apt-get install socat
</pre>

'''gawk''' - Zum extrahieren der Daten
<pre>
sudo apt-get update && sudo apt-get install gawk
</pre>

'''gatttool''' - Bestandteil von bluez

gatttool ist auf den meisten Distributionen im bluez-Paket, allerdings nicht bei Opensuse. Dort muss man das Sourcepaket von bluez installieren und selbst kompilieren.
gatttool sollte dann nach /usr/bin oder /usr/local/bin kopiert werden,

Zusätzlich zu den notwendigen Erweiterungen werden für die Ausführung von gatttool '''Root-Rechte benötigt'''!

Das Script selbst gibt es hier: [https://raw.githubusercontent.com/micky0867/lebattery/master/lebattery lebattery]

Am Besten unter /opt/fhem/script/lebattery speichern und ausführbar machen:
<source lang="bash">
sudo su -
mkdir /opt/fhem/script
cd /opt/fhem/script
wget https://raw.githubusercontent.com/micky0867/lebattery/master/lebattery
chmod 755 lebattery
</source>

Je nach Bedarf können im Script noch die folgenden 3 Parameter angepasst werden:
<source lang="bash">
# If allowed_telnetPort is protected by a password, add the password here
TELNETPASSWORD=""
# Attribute for batterylevel in FHEM
ATTRIBUT="batterylevel"
# Use this, if you dont want the script to determine the tags on its own
LETAGS=""
</source>

Das Skript wird dann unter root folgendermaßen gestartet:
<pre>
/opt/fhem/script/lebattery -v
</pre>

Ausgabe des Skripts, wenn es mit dem Verbose Parameter -v gestartet wird.

Beide Devices sind vom Typ NUT mini, das Device mit dem FHEM-Namen '''nut_Micky''' ist im Status '''absent'''. Das zweite Device ist im Status '''present'''.
<pre>
Determining address for nut_Micky ...
nut_Micky is in state absent, no further action required

Determining address for nut_Test ...
Fetching batterylevel for nut_Test (F3:44:04:81:54:89) ...
Setting batterylevel for nut_Test to 100%
</pre>

Mein crontab-Eintrag (User root) sieht so aus:
<pre>
3 3 * * * /opt/fhem/script/lebattery -v >/opt/fhem/script/lebattery.log 2>&1
</pre>
Damit wird jeden Morgen um 3 Minuten nach 3 Uhr der Zustand der Batterien aller Devices ermittelt und in FHEM abgespeichert. 
Bevor man das mit crontab macht, sollte man allerdings zunächst sicher stellen, dass es auch ohne crontab funktioniert....

Bei Problemen kann man auch erstmal schauen, ob das mit dem gattool überhaupt funktioniert:
<pre>
gatttool -t <Typ> -b <MAC-Adresse> --char-read --uuid 0x2a19

handle: 0x0017 value: 64
</pre>
In diesem Fall hat die Batterie noch 100% (hex 64). 
Der Typ ist abhängig vom Hersteller und kann public (G-Tags) bzw. random (Nut) sein. Im Zweifelsfall beides ausprobieren.

=== Anwesenheitserkennung / Anwesenheitsbenachrichtigung mit G-Tags ===

Ein Skript zur Nutzung der Gigaset G-TAGs zur Alarmierung bei öffnen und schließen von Türen und zur Anwesenheitserkennung, um die Alarmierung zu aktivieren bzw. deaktivieren.
Es kann verwendet werden um die Anwesenheit von mehrern Personen im Haushalt zu erkennen. Dabei wird eingeschränkt, dass nur bestimmte Personen die Alarmierung aktivieren können ( Eltern/Kind -Beziehung ).
Des Weiteren werden im Beispiel die Eltern benachrichtigt wenn eins der Kinder das Haus verlässt und die Eltern nicht anwesend sind.

{{Randnotiz|RNText= Namen der G-Tags in den Skripten bitte Anpassen!}}

Für die ''Notify'' und die ''RESIDENTS-Erweiterung'' wird ein Dummy benötigt.
<pre>
define Alarm dummy
attr Alarm devStateIcon aktiv:secur_locked@red inaktiv:secur_open@lightgreen
attr Alarm eventMap on:aktiv off:inaktiv
attr Alarm setList on off
attr Alarm webCmd aktiv:inaktiv
attr Alarm room Alarm
</pre>

====Mit Notify ====
<pre>
gtag.*.presence:.* {Anwesenheit_check("$EVTPART1", "$NAME")}
</pre>

Code für die 99_myUtils.pm
<pre>
### GTAG ANWESENHEITS CHECK
sub Anwesenheit_check($$) {
my ($EVENT, $NAME) = @_;

# gtag_rot - Alias Marco
# gtag_schwarz - Alias Ulli
# gtag_gruen - Alias Frida
# gtag_orange - Alias Hannah

my $RESIDENT = "rr_"; # Alle GTAGs sind Standardmäßig Residents Roommate
# $RESIDENT = "rg_" if (($NAME eq "gtag_orange") xor ($NAME eq "gtag_weis")); # Hier nur Gäste (Roomguest) Auskommentiert, da ich es so nicht brauche
my $ROOMMATE = ("$RESIDENT" . "$NAME"); # Residentsname zusammenbauen
my $ALIASNAME = AttrVal($ROOMMATE,'alias',$ROOMMATE); # ALIAS des Roommates auslesen

my $GTAG1 = Value('gtag_rot'); # ELTERN
my $GTAG2 = Value('gtag_schwarz'); # ELTERN

my $STATUS = "wahrscheinlich gerade los";
$STATUS = "anwesend" if ($EVENT eq "present"); # Status: anwesend
$STATUS = "unterwegs" if ($EVENT eq "absent"); # Status: unterwegs

Log 1, "$ALIASNAME ist $STATUS."; # LOG Eintrag erzeugen

if (($EVENT eq "present" && Value("Alarm") eq "aktiv") && ($NAME eq "gtag_gruen" xor $NAME eq "gtag_orange")) {
fhem("set teleBot send ALARMIERUNG BLEIBT AKTIV: $ALIASNAME ist da..."); # Telegram
# fhem("set Infopush msg 'ALARMIERUNG BLEIBT AKTIV' '$ALIASNAME ist da...'"); # Pushover
}
elsif (($EVENT eq "present" && Value("Alarm") eq "aktiv") && ($NAME eq "gtag_rot" xor $NAME eq "gtag_schwarz")) {
fhem("set teleBot send ALARMIERUNG INAKTIV: $ALIASNAME ist da...; set Alarm inaktiv"); # Telegram
# fhem("set Infopush msg 'ALARMIERUNG INAKTIV' '$ALIASNAME ist da...'; set Alarm inaktiv"); # Pushover
}
elsif (($EVENT eq "absent" && Value("Alarm") eq "aktiv") && ($NAME eq "gtag_gruen" xor $NAME eq "gtag_orange")) {
fhem("set teleBot send ALARMIERUNG BLEIBT AKTIV: $ALIASNAME hat das Haus verlassen."); # Telegram
# fhem("set Infopush msg 'ALARMIERUNG BLEIBT AKTIV' '$ALIASNAME hat das Haus verlassen.'"); # Pushover
}
elsif (($EVENT eq "absent" && Value("Alarm") eq "inaktiv") && ($GTAG1 eq "absent" && $GTAG2 eq "absent")) {
fhem("set Alarm aktiv; set teleBot send ALARMIERUNG AKTIV: $ALIASNAME hat das Haus verlassen."); # Telegram
# fhem("set Alarm aktiv; set Infopush msg 'ALARMIERUNG AKTIV' '$ALIASNAME hat das Haus verlassen.' '' 0 ''"); # Pushover
}
}
</pre>

 

====Mit Notify und Integration des RESIDENTS-MODUL====

Der hier beschriebene Code erweitert die Funktionen unter dem Punkt 5.93.
Das Notify muss daher mit der folgenden Zeile erweitert werden.

<pre>
define Alarm_AnwesenheitCheck notify gtag.*.presence:.* { Anwesenheit_check("$EVTPART1", "$NAME"), Anwesenheit_check_resi("$NAME") }
</pre>

Zusätzlicher Code für die 99_myUtils.pm um die RESIDENTS Funktion nutzen zu können:
<pre>
### RESIDENTS
sub Anwesenheit_check_resi($) {
my ($NAME) = @_;
my $ALIASNAME = AttrVal($NAME,'alias',$NAME); # ALIASNAME des GTAGs auslesen

my $RESIDENT = "rr_"; # Als Standard sind alle GTAGs Roommates
$RESIDENT = "rg_" if (($NAME eq "gtag_orange") xor ($NAME eq "gtag_weis")); # Hier nur GTAG Namen der Gäste (Roomguest)
my $ROOMMATE = ("$RESIDENT" . "$ALIASNAME"); # Residentsname zusammenbauen

if (ReadingsVal($NAME,'presence',$NAME) eq "absent") {
fhem("set $ROOMMATE absent"); # Resisents Status von Roommates setzen
}
elsif(ReadingsVal($NAME,'presence',$NAME) eq "present") {
fhem("set $ROOMMATE home"); # Resisents Status von Roommates setzen
}
}
</pre>
 

====Mit Notify und Fenster/Tür. -Kontakt Überwachung====

Erweiterung für die Überwachung von Fenster/Tür. -Kontakten. Dazu sind zwei weitere Notifys notwendig die auf die Trigger der Kontakte regagieren
und so eine weitere Funktion in der 99_myUtils.pm ansprechen. Die Notifys triggern auf Kontakte die mit dem Namen Kontakt* beginnen.
Sollten die eigenen Fenster/Tür. -Kontakt anderen Namen besitzen, müssen die Skripte dementsprechend angepasst werden.
<pre>
define Alarm_Kontaktmeldung notify Kontakt.*:contact:.* {Kontakt_Meldung("$EVTPART1", "$NAME")}
</pre>
<pre>
define Alarm_Sabotagealarm notify Kontakt.*.sabotageError:.on {Kontakt_Sabotage("$EVTPART1", "$NAME")}
</pre>

Zusätzlicher Code für die 99_myUtils.pm um die TÜRKONTAKTE-Meldung nutzen zu können:
<pre>
### TÜRKONTAKTE-Meldung/Zustand
sub Kontakt_Meldung($$) {
my ($EVENT, $NAME) = @_;
my $ALIASNAME = AttrVal($NAME,'alias',$NAME);
Log 1, "$ALIASNAME wurde $EVENT";
if (ReadingsVal("Alarm", "state", "on") eq "on") {
fhem("set teleBot send $ALIASNAME wurde $EVENT"); # Nachricht über Telegram
# fhem("set Infopush msg '$ALIASNAME' '$ALIASNAME wurde $EVENT'"); # Nachricht über Pushover
}
}

### TÜRKONTAKTE-Sabotagealarm

sub Kontakt_Sabotage($$) {
my ($EVENT, $NAME) = @_;
my $ALIASNAME = AttrVal($NAME,'alias',$NAME);
Log 1, "$ALIASNAME meldet Sabotagealarm";
fhem("set teleBot send Alarm: $ALIASNAME meldet Sabotagealarm"); # Nachricht über Telegram
# fhem("set Infopush msg 'Alarmanlage' '$ALIASNAME meldet Sabotagealarm' '' 2 ' ' 60 600 "); # Nachricht über Pushover
}
</pre>
 

==== Hinweis zur Benutzung / Fehlerhandling ====

Der Alarm dummy hat den Zustand on:off. Die Bezeichnungen und Namen müssen 1:1 übernommen werden damit das Script funktioniert.
Andernfalls müssen die Bezeichnungen für z.B. absent:unterwegs und present:anwesend - angepasst werden.
Die Benachrichtigung kann aktuell per ''Telegram'' sowie ''Pushover'' ('''Achtung mit zweiterem sind Abokosten verbunden!''') realisiert werden.
Diskussion zum Thema im Forum unter: {{Link2Forum|Topic=64080}}
 

=== Verwendung von Collectord bei mehreren PRESENCE Installationen mit LE-Devices ===

Um zwei presence Installation zu verbinden wird der collectored Daemon von Markus Bloch benötigt.
Hierfür gibt es im Wiki auch eine kurze Erläuterung sowie die Commandref.

'''Aufbau:''' 
RPi1 (Hautpinstanz): fhem nebst presence Installation sowie collectord
RPi2 (Zweitsystem): fhem nebst presence Installation

'''Installation:''' 

auf RPi1 wird wie in der Commandref und im Wiki beschriebendas Presence Paket (https://svn.fhem.de/trac/export/HEAD/trunk/fhem/contrib/PRESENCE/deb/) heruntergeladen, installiert und konfiguriert.
Alle BT-Tags werden dann wie im Wiki beschrieben konfiguriert.

auf RPi2 wird wie in der Commandref und im Wiki beschriebendas Presence Paket (https://svn.fhem.de/trac/export/HEAD/trunk/fhem/contrib/PRESENCE/deb/) heruntergeladen, installiert und konfiguriert.
Alle BT-Tags werden dann wie im Wiki beschrieben konfiguriert.

Somit sollte auf beiden Systemen eine identische Konfiguration vorliegen.

Jetzt wird das collectord heruntergeladen und installiert:
https://svn.fhem.de/trac/export/HEAD/trunk/fhem/contrib/PRESENCE/deb/collectord-1.7.deb
<pre>
sudo apt-get install collectord-1.7.deb
</pre>

Nach der Installation befindet sich im Verzeichnis: /etc/collectord.conf die Konfigurationsdatei für das collectord.

'''Konfiguration Shell:''' 
<pre>
sudo vi /etc/collectord.conf
</pre>

Diese Datei muss jetzt nach folgender Vorlage angepasst werden.
<pre>
# room definition
#[room-name] # name of the room
#address=192.168.0.10 # ip-address or hostname
#port=5111 # tcp port which should be used (5111 is default)
#presence_timeout=120 # timeout in seconds for each check when devices are present
#absence_timeout=20 # timeout in secondsfor each check when devices are absent

[RPi1] # Name (wird als Reading room bei den BT-Tags angezeigt) der presence Instanze
address=127.0.0.1 # Lokale Adresse RPi1 , da hier das Collectord später laufen soll!
port=5111 # Port der Presence Installation
presence_timeout=60 # Selbstgewaelte Pruefintervalle
absence_timeout=60 # Selbstgewaelte Pruefintervalle

[RPi2] # Name (wird als Reading room bei den BT-Tags angezeigt) der presence Instanze
address=192.168.178.127 # IP-Adresse der Instanz, wo nur das Presence laueft, also RPi2
port=5111 # Port der Presence Installation
presence_timeout=60 # Selbstgewaelte Pruefintervalle
absence_timeout=60 # Selbstgewaelte Pruefintervalle
</pre>

Hinweis: Es dürfen keine [Namen] mit Leerzeichen verwendet werden.

'''Konfiguration FHEM:''' 
RPi1
define Gtag PRESENCE lan-bluetooth XX:XX:XX:XX:XX:XX 127.0.0.1:5222 60
Hinweis: Der Port ist der, des Collectord!! Also hier, Standard 5222
 
RPi2
define Gtag PRESENCE lan-bluetooth XX:XX:XX:XX:XX:XX 192.168.178.27:5222 60
Hinweis: Der Port ist der, des Collectord!! Also hier, Standard 5222 die IP-Adresse von RPi1

Nach der Konfiguration kann der Daemon gestartet werden. Um eine visuelle Log-Ausgabe mit dem Aufruf:
<pre>
sudo /usr/bin/perl /usr/sbin/collectord -vv -c /etc/collectord.conf
</pre>
<pre>
2017-04-02 17:52:55 - =================================================
2017-04-02 17:52:55 - started with PID 15554
2017-04-02 17:52:55 - reading configuration file
2017-04-02 17:52:55 - no config errors found
2017-04-02 17:52:55 - forked with PID 15556
2017-04-02 17:52:56 - created socket on 0.0.0.0 with port 5111
2017-04-02 17:53:20 - new connection from 127.0.0.1:48656
2017-04-02 17:53:20 - created thread 1 for processing device 7C:2F:80:E1:14:31 in room RPi2 for peer 127.0.0.1 (UUID: d0beb79dd4771532eb5e207c7bf31788)
2017-04-02 17:53:20 - created thread 2 for processing device 7C:2F:80:E1:14:31 in room RPi1 for peer 127.0.0.1 (UUID: d0beb79dd4771532eb5e207c7bf31788)
2017-04-02 17:53:20 - new connection from 127.0.0.1:48662
2017-04-02 17:53:20 - new connection from 127.0.0.1:48664
2017-04-02 17:53:20 - created thread 3 for processing device 7C:2F:80:ED:BC:F7 in room RPi2 for peer 127.0.0.1 (UUID: 7495a112063d5db45e6335d3fe305e36)
2017-04-02 17:53:20 - created thread 4 for processing device 7C:2F:80:ED:BC:F7 in room RPi1 for peer 127.0.0.1 (UUID: 7495a112063d5db45e6335d3fe305e36)
2017-04-02 17:53:20 - created thread 5 for processing device 7C:2F:80:E1:2A:4D in room RPi2 for peer 127.0.0.1 (UUID: c228f8d4d33b06787f995c7903c02760)
2017-04-02 17:53:20 - created thread 6 for processing device 7C:2F:80:E1:2A:4D in room RPi1 for peer 127.0.0.1 (UUID: c228f8d4d33b06787f995c7903c02760)
2017-04-02 17:53:22 - new connection from 192.168.xxx.xxx:51638
2017-04-02 17:53:22 - created thread 7 for processing device 7C:2F:80:E1:14:31 in room RPi2 for peer 192.168.xxx.xxx (UUID: 5db7012e709d6dc2fcd8159fc0344e40)
2017-04-02 17:53:22 - created thread 8 for processing device 7C:2F:80:E1:14:31 in room RPi1 for peer 192.168.xxx.xxx (UUID: 5db7012e709d6dc2fcd8159fc0344e40)
2017-04-02 17:53:22 - new connection from 192.168.xxx.xxx:51640
2017-04-02 17:53:22 - created thread 9 for processing device 7C:2F:80:ED:BC:F7 in room RPi2 for peer 192.168.xxx.xxx (UUID: c4b4d7c654132cf88e8c1fec3a956d3d)
2017-04-02 17:53:23 - created thread 10 for processing device 7C:2F:80:ED:BC:F7 in room RPi1 for peer 192.168.xxx.xxx (UUID: c4b4d7c654132cf88e8c1fec3a956d3d)
2017-04-02 17:53:29 - new connection from 192.168.xxx.xxx:51642
2017-04-02 17:53:29 - created thread 11 for processing device 7C:2F:80:E1:2A:4D in room RPi2 for peer 192.168.xxx.xxx (UUID: ecd7081e5ae3a0d8e735c8750cb116a1)
2017-04-02 17:53:29 - created thread 12 for processing device 7C:2F:80:E1:2A:4D in room RPi1 for peer 192.168.xxx.xxx (UUID: ecd7081e5ae3a0d8e735c8750cb116a1)
</pre>

Wenn das Log wie oben abgebildet aussieht wurde alles richtig gemacht und unter dem Device in fhem erscheint ein neues Reading "rooms" mit dem Wert der Erkannten PRESENCE Installation.

'''Automatischer Start:''' 
Wenn das Collectord per .deb Paket installiert wurde, startet es automatisch bei einem Reboot mit.
Manuell Starten als Daemon mit:
<pre>
sudo /usr/bin/perl /usr/sbin/collectord -c /etc/collectord.conf -d -v -l /var/log/collectord.log
</pre>

=== Problemlösungen ===
Falls es '''Probleme beim Starten des Skripts''' gibt bzw. man das Skript ohne Reboot des Systems neustarten möchte, kann man dies per kill Befehl erledigen.
<source lang="bash">
ps -ef | grep lepresenced
sudo kill <pid>
</source>

Debuglevel lepresenced setzen:
{{Randnotiz|RNText=Um Debug-Meldungen zu bekommen (Vorsicht bei SD-Karten-Systemen wie dem RPi) - Hierbei werden die Schreibzyklen auf die SD-Karte erhöht.}}

Der Log Level muss im lepresenced-Skript selbst verändert werden. Um den Log-Level auf INFO/WARNING/DEBUG zu setzen, dass Skript lepresenced mit einem Editor öffnen und die Stellen, wo LOG_WARNING zu finden sind durch den nötigen LOG-Eintrag ersetzen.

<pre>
lepresenced --loglevel LOG_DEBUG
</pre>
Nur das wichtigste Loggen:
<pre>
lepresenced --loglevel LOG_WARNING
</pre>
Keinerlei LOG-Einträge
<pre>
lepresenced --loglevel LOG_EMERG
</pre>

Bei '''Problemen mit der Batterieüberwachung''' der Tags kann die Pi Firmeware mit folgenden Befehl auf eine ältere Version zurückgesetzt werden.
Fehlermeldung beim Aufruf des lebattery oder anderen Batterietestskripten:
<pre>connect: Connection refused (111)</pre>

Lösung (vorübergehend)
<pre>
sudo rpi-update 8521fd34c8f66b6d109acce943f6e25ec93ec005
</pre>

Mehr dazu unter: {{Link2Forum|Topic=56960|Message=589165}}

'''Das BT-Device ist ständig "absent"''' 
Eine Mögliche Lösung kann sein, dass Paket bluez-hcidump zu installieren. Das Werkzeug hcidump erlaubt die Beobachtung von Bluetooth-Aktivität.
Dies ist nicht notwendig, wenn bereits bluez installiert ist, da dies Teil des bluez Paketes ist
<pre>
sudo apt-get install bluez-hcidump
</pre>

'''Fehler in Logdateien /var/log/syslog und /var/log/kernel'''
Jul 29 15:08:11 raspberrypi kernel: [ 4905.634211] bt_err_ratelimited: 1 callbacks suppressed
Jul 29 15:08:11 raspberrypi kernel: [ 4905.634231] Bluetooth: hci0 advertising data length corrected
Jul 29 15:08:12 raspberrypi kernel: [ 4906.647350] Bluetooth: hci0 advertising data length corrected
Jul 29 15:08:13 raspberrypi kernel: [ 4907.532081] Bluetooth: hci0 advertising data length corrected
Jul 29 15:08:13 raspberrypi kernel: [ 4907.655564] Bluetooth: hci0 advertising data length corrected

Die Ursache des Problems ist noch nicht ergründet, allerdings betrifft dies aktuell nur den RPi3. Die Fehlermeldungen werden in verschiedene log's geschrieben. Darunter maßgeblich "syslog" und "kern.log".

Lösung (vorübergehend)
Unterbinden der Einträge durch Anlage eines blocklist Eintrag:

1. Unter "/etc/rsyslog.d" eine Datei erzeugen mit dem Namen "01-blocklist.conf"
2. Inhalt: (Die Ausdrücke in den "" sind diejenigen, die aus dem log verschwinden sollen. - bei mir waren es die unten stehenden")
:msg,contains,"Bluetooth: hci0 advertising data length corrected" stop
:msg,contains,"bt_err_ratelimited:" stop
3. Dienst neu starten "sudo service rsyslog restart"

Weiter Infos werden im offiziellen Thema [[https://forum.fhem.de/index.php/topic,28753.msg499184/topicseen.html#msg499184]] diskutiert.

==== Ansprechpartner ====
# {{Link2FU|5068|PatrikR}} (Patrick) für lepresenced
# [[Benutzer Diskussion:Devender|Devender]] ({{Link2FU|20043|Dirk}}) für Wiki und Doku

[[Kategorie:Code Snippets]]
[[Kategorie:Glossary]]

Anwesenheitserkennung

2017-06-23T18:39:48Z

CoolTux: /* Das PRESENCE Modul */

Viele Benutzer führen bereits eine eigene '''Anwesenheitserkennung''' durch. Diese basiert in den meisten Fällen auf Ping Checks oder bei [[AVM Fritz!Box|FritzBoxen]] auf dem Befehl ''ctlmgr_ctl''. Diese Lösungen können aber je nach Aufbau und Funktion FHEM massiv beeinträchtigen. Aufgrund des Aufbaus vom FHEM kann dieses dadurch für mehrere Sekunden zum völligen Stillstand gebracht werden.

In FHEM gibt es mittlerweile mehrere Module, die eine zuverlässige Anwesenheitserkennung bieten, ohne dabei FHEM bei der Ausführung zu beeinträchtigen.

Eine erweiterte Funktion der Anwesenheitserkennung ist die Standortverfolgung, die sich nicht nur auf ein oder sehr wenige mit (eigenem) WLAN versorgte Gebiete beschränkt.

== Vorüberlegungen ==
Generell gibt es mehrere Ansätze um Anwesenheitserkennung mit Handys/Smartphones durchzuführen.

* via PING Checks im gesamten WLAN
* Aktivitätsprüfung auf einer FritzBox
* Bluetooth Checks in der gesamten Wohnung
* eigene Perl-Funktion
* aktive Benachrichtigung des Smartphones, ausgelöst z.B. über Geo-Lokation/Geofence

Dabei gilt bei der Auswahl der Art darauf zu achten wie sich das jeweilige Device verhält. Aufgrund der Vielfältigkeit kann man hier keine allgemeine Vorgehensweise empfehlen. Als einfacher Start (zumindest für Nicht-Apfel Telefone) eignet sich die Ping-Überprüfung und die FritzBox-Abfrage sehr gut.

=== Randbedingungen ===
Es gibt Geräte, die ihr WLAN/Bluetooth auch im Standby ständig aktiv haben und auf Anfragen antworten können (fast alle Android-Geräte). Gerade bei Tests über WLAN kann sich das aber signifikant auf die Akku Leistung auswirken.

Andere Geräte wiederum schalten WLAN im Standby Betrieb aus, um Akkukapazität zu sparen. Bluetooth hingegen bleibt weiterhin aktiviert und kann auf Anfragen reagieren. (iPhone)

Wenn man bei einem iPhone die Funktion "über WLAN synchronisieren" aktiviert hat, so ist dies auch im Standby jederzeit pingbar, wenn der Recher auf dem iTunes zum synchroniseren läuft auch an ist. Ansonsten ist bei iPhone Geräten nur die Aktivitätsprüfung mit einer FritzBox oder das überwachen der DHCP Lease auf einer Airport Basestation wirklich zuverlässig.

Auch wenn Bluetooth aktiviert ist, so bleiben einige Mobiltelefone erst dann empfangsbereit, wenn sie bereits zu irgend einem Bluetoothgerät gekoppelt wurden. Sind diese Geräte noch nie gekoppelt worden, deaktivieren diese ihren Bluetooth Empfänger beim verlassen des Bluetooth-Menüs im Gerät (iPhone).

Hier gilt es vor allem auszuprobieren, wie stark der Akku durch eine Anwesenheitserkennung belastet wird. Entscheidend ist hier, in welchem Abstand man eine Anwesenheitserkennung durchführt. Viele Abfragen wirken sich stärker auf den Akku aus als wenige. Wenige Abfragen bieten aber keine zuverlässige und zeitnahe Erkennung.

Als Alternative, unabhängig vom WLAN und der Erkennung, ob ein Gerät dort eingebucht ist oder nicht, bzw. unabhängig von Bluetooth kann zumindest bei einem iPhone die seit iOS 7 nochmals stark verbesserte Geo-Lokation (Geofencing) genutzt werden. Die iPhone Apps [http://geofency.com/ Geofency] oder [http://geofancy.com/ Geofancy] werden über das FHEM-Modul GEOFANCY angebunden und übertragen ihren Status immer dann, wenn ein definierter Standort betreten oder verlassen wird. Gekoppelt mit entsprechenden Notify und/oder Watchdog Kommandos ist so ebenfalls eine sehr zuverlässige Anwesenheitserkennung möglich (und das nicht nur für das eigene Zuhause).

== Das PRESENCE Modul ==
Das [[PRESENCE]] Modul bietet für die Anwesenheitserkennung mehrere Varianten an. Diese sind aktuell folgende:

* '''lan-ping''' - Das Überwachen via PING Checks, die durch den FHEM Server versandt werden.
* '''fritzbox''' - Das Überwachen von Geräten auf einer FritzBox via ctlmgr_ctl (Nur auf einer FritzBox möglich)
* '''local-bluetooth''' - Das Überwachen via Bluetooth Checks, die vom FHEM Server direkt durchgeführt werden (angeschlossener Bluetooth-Stick und die Software bluez voraussgesetzt)
* '''lan-bluetooth''' - Das Überwachen von Bluetoothgeräte, über Netzwerk. Auf einer oder mehreren Maschinen im Netzwerk (z.B. [[:Kategorie:Raspberry Pi|Raspberry Pi]]) läuft ein Presence-Daemon, der nach Bluetooth-Geräten sucht. Um mehrere Presence-Daemon mit FHEM zu verbinden, gibt es den Collector-Daemon, der sich zu allen Presence-Damons im Netzwerk verbindet und das Ergebnis von allen zusammenfasst.
* '''function''' - Das Überwachen mithilfe einer selbst geschrieben Perl-Funktion, die den Anwesenheitsstatus zurückgibt (0 oder 1)
* '''shell-script''' - Das Überwachen mithilfe eines selbst geschriebenen Shell-Programms/Skript, das eine 0 oder 1 ausgibt, um den Anwesenheitsstatus mitzuteilen.

=== Ping-Überwachung von Geräten im WLAN/LAN ===
{{Randnotiz|RNText=Um diese Methode auf einer FritzBox nutzen zu können, muss FHEM mit root-Rechten laufen. Dies ist standardmäßig nicht der Fall. Bitte dazu den Wiki Artikel [[FritzBox: fhem unter root starten]] beachten.}}
Um ein Gerät via Ping zu überwachen, muss folgende Definition durchgeführt werden:
:<code>define Handy PRESENCE lan-ping 192.168.0.30</code>

Dadurch wird die IP-Addresse 192.168.0.30 alle 30 Sekunden geprüft, ob sie erreichbar ist. Wenn sie erreichbar ist, ist der Status "present" (anwesend), ansonsten "absent" (abwesend).

Der Timeout kann verändert werden, indem ein Wert (in Sekunden) an das Define anhängt wird:
:<code>define Handy PRESENCE lan-ping 192.168.0.30 '''60'''</code>

Nun würde das Handy alle 60 Sekunden geprüft werden.

Nur wenn bei einem iPhone/iPad die Funktion "über WLAN synchronisieren" aktiviert ist, ist es auch im Standby zuverlässig pingbar. Standardmäßig deaktivieren Apple-Geräte ihr WLAN im Standby-Betrieb um die Akkulaufzeit zu verlängern.

Sollte die Fehlermeldung
:<code> PRESENCE (Handy) - ping command returned with output: ping: icmp open socket: Operation not permitted </code>
im Log auftauchen und lan-ping dadurch nicht funktionieren, liegt ein Berechtigungsproblem vor. Kein Grund den User fhem zu root zu machen!
Prüfe zu erst als User root ob die Capabilities gesetzt sind.
:<code>getcap /bin/ping</code>
Sollte folgendes Ergeben zu Tage fördern.
:<code>/bin/ping = cap_net_raw+ep</code>
Ist dem nicht so, setzen wir die benötigten Capabilities
:<code>setcap cap_net_raw+ep /bin/ping</code>
Mehr Informationen zum Thema Capabilities [https://manpages.debian.org/jessie/manpages-de/capabilities.7.de.html].

=== FritzBox: direktes Abfragen der Aktivität via ctlmgr_ctl ===
{{Randnotiz|RNText=Um diese Methode auf einer FritzBox nutzen zu können, muss FHEM mit root-Rechten laufen. Dies ist standardmäßig nicht der Fall. Bitte dazu den Wiki Artikel [[FritzBox: fhem unter root starten]] beachten.}}
Eine sehr häufige und auch zuverlässige Methode ist auf einer FritzBox die Abfrage mittels ctlmgr_ctl Befehl. Über diesen lassen sich alle Geräte abfragen ob sie aktiv sind. Ist ein Gerät aktiv, so gilt es als anwesend.

Dieser Modus kann allerdings nur in FHEM Installationen direkt auf einer FritzBox verwendet werden. Des weiteren muss FHEM unter dem User root laufen. Um ein Gerät zu überwachen, wird lediglich der Gerätename benötigt, so wie er unter dem Menüpunkt "Heimnetz" auftaucht.

Die erforderliche Definition:
:<code>define Handy PRESENCE fritzbox iPhone-4S</code>

=== Bluetooth-Überwachung von Geräten durch den FHEM Server ===
[[Datei:Bluetooth-Adresse-iPhone.png|thumb|Bluetooth-Adresse eines iPhones]]
Jenach Aufstellungsort des FHEM Servers kann es sinnvoll sein, eine Bluetooth-Überwachung direkt durch den FHEM Server durchzuführen. Hierbei gilt allerdings zu beachten, dass Bluetooth nicht für große Reichweiten gedacht ist und in den meisten Fällen keine Wände überwinden kann. Das heisst, dass in den meisten Fällen damit nur ein Raum überwacht werden kann.

Je nach Einsatzzweck kann das auch so gewollt sein. Bluetooth USB Sticks, die bereits Bluetooth 4.0 unterstützen, können höhere Reichweiten über Zimmerwände hinaus erreichen. Vorausgesetzt, das Mobilgerät unterstützt Bluetooth 4.0.

Um eine Überwachung per Bluetooth durchführen zu können, benötigt man die Bluetooth-Adresse eines Gerätes. Diese ähnelt vom Aufbau einer MAC-Adresse. Generell wird die Adresse in den Telefon-Informationen bei Smartphones angezeigt.

Um eine Anwesenheitserkennung via Bluetooth durchzuführen, wird folgende Definition in der [[Konfiguration]] benötigt:
:<code>define Handy PRESENCE local-bluetooth XX:XX:XX:XX:XX:XX</code>

=== Bluetooth-Überwachung von Geräten durch verteilte Agenten in der Wohnung (presenced/collectord) ===
[[Datei:Raspberry-Pi-mit-WLAN-und-Bluetooth-Stick.jpg|thumb|left|Raspberry Pi mit Bluetooth- und WLAN-USB-Stick]]
Um eine zuverlässige und flächendeckende Bluetooth-Anwesenheitserkennung durchzuführen, ist es unerlässlich, mehrere Bluetooth-Empfänger zu verwenden, die auf mehrere oder alle Räume verteilt sind.

Hierfür bietet sich zum Beispiel ein [[Raspberry Pi]] mit einem Mini-Bluetooth-USB-Stick und evtl. einem WLAN-USB-Stick an. Jeder Raum wird mit solch einem Raspberry ausgestattet und ist im WLAN Netz verfügbar.

Dieses Netz aus Raspberrys wird mit dem presenced (Download-Link ist in der [http://fhem.de/commandref_DE.html#PRESENCE Commandref] zum Modul enthalten) ausgestattet. Es stehen bereits entsprechende Pakete für den Raspberry zur Verfügung.

Beide Programme (presenced/collectord) sind Perl-Skripte, die als Daemon im Hintergrund laufen und auf Anfragen via Netzwerk warten. Es wird lediglich eine vollständige Perl-Grundinstallation mit Standardmodulen benötigt. Nach Installation der *.deb Pakete sollten diese noch angewiesen werden, automatisch beim Rechner-Neustart gestartet zu werden:

<pre>
sudo update-rc.d presenced defaults
sudo update-rc.d collectord defaults
</pre>

Eine detaillierte Benutzung von presenced ist in der [http://fhem.de/commandref_DE.html#PRESENCE Commandref] Beschreibung zum PRESENCE Modul enthalten.

==== Jeden Raum einzeln ansprechen (presenced) ====
Nun kann zuallererst jeder Raum einzeln angesprochen werden. Dabei ist zu beachten, dass pro Definition in der Konfiguration nur ein Gerät in einem Raum spezifisch überwacht werden kann.

Eine Definition sieht dabei folgendermaßen aus:
:<code>define Handy_Wohnzimmer PRESENCE lan-bluetooth XX:XX:XX:XX:XX:XX 192.168.0.10:5111</code>

Damit wird nun das Gerät nur im Wohnzimmer (Raspberry mit IP 192.168.0.10) überwacht.

==== Alle Räume gemeinsam ansprechen (collectord) ====
Um jedoch alle Räume gemeinsam zu verwenden, gibt es den Collector-Daemon. Dieser kennt alle presenced-Installationen im Netzwerk und führt eine koordinierte Suche nach den gewünschten Geräten durch. Sobald ein Gerät in einem Raum erkannt wurde, meldet der collectord den Status einschließlich der Angabe des Raumes, in dem das Gerät erkannt wurde.

Um alle Räume zu kennen, müssen diese mit einem Config-File dem collectord mitgeteilt werden. Dieses sieht folgendermaßen aus:

<pre>
[Schlafzimmer] # Name des Raumes (wird in FHEM als Reading angezeigt)
address=192.168.179.31 # IP-Adresse oder Hostname des presenced
port=5111 # TCP Port, der verwendet werden soll (standardmäßig Port 5111)
presence_timeout=120 # Prüfinterval, das verwendet werden soll, wenn ein Gerät anwesend ist
absence_timeout=20 # Prüfinterval, das verwendet werden soll, wenn ein Gerät abwesend ist

[Wohnzimmer]
address=192.168.179.34
port=5111
presence_timeout=180
absence_timeout=20
</pre>

Standardmäßig ist dieses Config-File unter /etc/collectord.conf zu finden. Mit dieser Konfiguration kann der Collectord gestartet werden. Es empfiehlt sich diesen mit auf dem FHEM Server zu betreiben. Die erforderliche Definition in der FHEM-Konfiguration:
:<code>define Handy PRESENCE lan-bluetooth XX:XX:XX:XX:XX:XX 127.0.0.1:5222</code>

Sobald das Handy irgendwo in der Wohnung erkannt wurde, meldet der Collectord dies sofort an FHEM und teilt den Raum mit.

Eine detaillierte Benutzung von collectord findet man in der [http://fhem.de/commandref.html#PRESENCE Commandref zum PRESENCE Modul].

=== Überwachung von Geräten mit Perl-Code ===
Es ist möglich zum Überwachen von Geräten eine eigene Perl-Funktion zu verwenden die dann vom PRESENCE Modul im Hintergrund aufgerufen wird.

define <name> PRESENCE function {...} [ <check-interval> [ <present-check-interval> ] ]

Sobald die Funktion den Rückgabewert 1 hat, ist das Gerät anwesend, bei 0 abwesend.

==== Beispiel DHCP Überwachung auf Airport Basestation ====
Die hier vorgestellte Überwachung der DHCP Lease auf Airport Basestations per SNMP ist absolut robust gegenüber dem Ruhezustand von iOS und setzt keine weitere Konfiguration auf dem iPhone voraus. Das Abmelden beim Verlassen des Empfangsbereiches der Basestation geschieht mit etwa 5-10 Minuten Verzögerung und ist somit auch vor kurzzeitigen Empfangsproblemen sicher. Das nebenstehende Bild (???) verdeutlicht noch mal die Unterschiede zwischen einer IP-Basierten Ping-Überwachung und der Überwachung auf Ebene der Basestation oder FritzBox.

Bevor der folgende Code verwendet werden kann ist das Perl Modul Net:SNMP zu installieren (z. B. mit: <code>cpan install use Net::SNMP</code>).

Zuerst ist folgender Code in 99_myUtils.pm einzufügen, sollte diese noch nicht vorhanden sein muss diese aus dem Template welches unter Edit Files zu finden ist erzeugt werden.
'''Achtung, das ist nicht der komplette Inhalt der 99_myUtils!''' Das ist nur die einzelne Routine

<pre>
use Net::SNMP;
sub
snmpCheck($$)
{
my ($airport,$client)= @_;

my $community = "public";
my $host = $airport;
my $oid = ".1.3.6.1.2.1.3.1.1.2";
#my $oid = ".1.3.6.1.2.1.3.1.1.2.25.1.10.0.1";

my ( $session, $error ) = Net::SNMP->session(
-hostname => $host,
-community => $community,
-port => 161,
-version => 1
);

if( !defined($session) ) {
return 0;
return "Can't connect to host $host.";
}

my @snmpoids = ();

my $response = $session->get_next_request($oid);
my @nextid = keys %$response;
while ( @nextid && $nextid[0] && $nextid[0] =~ m/^$oid/ ) {
push( @snmpoids, $nextid[0] );

$response = $session->get_next_request( $nextid[0] );
@nextid = keys %$response;
}

if( !defined($response = $session->get_request( @snmpoids ) ) ) {
return 0;
}

foreach my $value (values %$response) {
return 1 if( $value eq $client )
}

return 0;
}
</pre>

Danach lässt sich das Mobilgerät so überwachen:
:<code>define iPhone PRESENCE function {snmpCheck("10.0.1.1","0x44d77429f35c")} 30 30</code>

wobei 10.0.1.1 durch die IP-Adresse der Basestation und 0x44d77429f35c durch die MAC Adresse des Geräts als HEX-Zahl ersetzt werden muss.

==== Beispiel Anwesenheitserkennung mittels UniFi Controller ====

Die Anwesenheitserkennung bei Geräten in Verbindung mit UniFi-Produkten funktioniert selbst dann, wenn sich die Geräte im PowerSave-Modus befinden.

Beachte: Die Geräte werden erst ungefähr nach 5 Minuten, nachdem das Gerät das WLAN verlassen hat als disconnected angezeigt.

<code>define <NAME> PRESENCE function {ReadingsVal("<UniFi>","<NamedDevice>","") eq "connected" ? 1:0}</code>

=== Eventbasierte Anwesenheitserkennung am Beispiel mittels UniFi Controller ===
Der Vorteil gegenüber der Function-Variante ist, dass diese Variante ohne Blocking.pm-Overhead direkt ausgeführt werden kann und in "Echtzeit" abläuft (siehe {{Link2Forum|Topic=40287|Message=562823}}).

<code>define <NAME> PRESENCE event UniFi:NamedDevice:.disconnected UniFi:NamedDevice:.connected</code>

== Das GEOFANCY Modul ==
Das Modul ermöglicht über einen sogenannten Webhook Mechanismus (umgangssprachlich oft auch als "Push" benannt) das aktive Melden des aktuellen Standortes. Die iPhone Apps [http://geofency.com/ Geofency] und [http://geofancy.com/ Geofancy] können dann aktiv und quasi in dem Moment, wo man den Wohnbereich betritt oder verlässt, benachrichtigen. Android Nutzern können [https://play.google.com/store/apps/details?id=de.egi.geofence.geozone&hl=de EgiGeoZone Geofence] nutzen. Das geht nochmals um einiges schneller, als die Erkennung im WLAN, bei der die Anwesenheit nur in (engen) Zyklen aktiv geprüft werden muss. Gleichzeitig werden Ressourcen in FHEM geschont. Die aktuelle Implementierung im iPhone 5S mit dediziert für das Tracking zuständigem Chip ist so gut, dass der Akku ebenfalls sehr geschont wird.

=== Modul in FHEM einrichten ===
Das Modul ist mit einer einfachen Definition sofort betriebsbereit:
:<code>define geofancy GEOFANCY geo</code>

Damit nimmt FHEM unter <nowiki>http://192.168.178.1:8083/fhem/geo</nowiki> entsprechende Meldungen des iPhones entgegen. Damit das nicht nur über das lokale WLAN funktioniert, bedarf es allerdings noch einiger zusätzlicher Maßnahmen. FHEM muss vom Internet erreichbar gemacht werden, dabei sollte unbedingt an die Absicherung des Zugriffs gedacht werden.

Zunächst einmal habe ich bei mir eine eigene FHEMWEB Instanz dafür angelegt:
<pre>
define WEBhook FHEMWEB 8088 global
attr WEBhook column Alarms: Apartment: Living: Bedroom: Kitchen: Sonos: Residents: Weather: Bathroom: Logs: Statistics: DashboardRoom: System: hidden: all:
attr WEBhook hiddenroom input,detail,save,Unsorted,Everything,CUL_HM,FS20,Commandref,style,Edit files,Select style,Logfile,Floorplans,Remote doc,FileLogs,Apartment,Bathroom,Bedroom,Kitchen,Living,Residents,System,Weather,Event monitor,NEW
attr WEBhook room hidden
attr WEBhook webname webhook
</pre>

Damit ist unter der URL <nowiki>http://192.168.178.1:8088/webhook/geo</nowiki> das GEOFANCY Modul erreichbar. Ich verstecke in dieser Ansicht noch alle Räume, die ich so habe. Wer die Raumnamen allerdings kennt, kann sie trotzdem aufrufen. Die Anzeige in den Räumen kann man mit dem Attribut column und entsprechend leeren Definitionen verstecken. Nun muss man explizit den Devicenamen kennen, um noch etwas über die Konfiguration in Erfahrung bringen zu können.
Auch wenn das Security-by-Obscurity ist - ich fühle mich wohler damit.

=== Webhook weiter absichern ===
Mit Hilfe eines [http://fhem.de/commandref.html#allowed allowed]-Devices lässt sich die FHEMWEB Instanz noch weiter absichern indem nur die tatsächlich benötigten Kommandos erlaubt werden (in diesem Fall keine) und damit alle anderen nicht erlaubten (attr,define,get,set,...) automatisch nicht mehr zur Verfügung stehen:
<pre>
define allowedWEBhook allowed
attr allowedWEBhook allowedCommands ,
attr allowedWEBhook allowedDevices ,
attr allowedWEBhook validFor WEBhook
</pre>

Außerdem ist dringend zu empfehlen, den Zugriff über TLS/SSL und HTTP Basic-Authentication weiter abzusichern. Läuft FHEM auf einem Raspberry Pi, dann empfehle ich dazu die Konfiguration eines ReverseProxy (vorzugsweise HAproxy, Pound oder Varnish, notfalls auch Nginx oder Apache); damit ist man am flexibelsten und kann auch alle FHEMWEB Instanzen direkt über einen einzigen Port (meist 443, der HTTPS Standard Port) zusammenfassen. Ich möchte hier allerdings beschreiben, wie weit man mit FHEM Bordmitteln kommt und nehme das Beispiel einer Installation auf einer Fritzbox.

Wie TLS aktiviert wird, steht in der Commandref für [[FHEMWEB]]. Um die Kommandos auf der Fritzbox ausführen zu können, muss zuerst Telnet aktiviert werden (bitte Google benutzen). Anschließend wechselt man auf der Fritzbox ins Verzeichnis /var/media/ftp/fhem und kann dann den Hinweisen aus der [http://fhem.de/commandref.html#FHEMWEB Commandref] unter dem Punkt HTTPS folgen. Letztlich fehlt noch das entsprechende Attribut:

<pre>
attr WEBhook HTTPS
</pre>

Als nächstes aktivieren wir Benutzername+Passwort für den Zugriff. Die commandref für allowed gibt auch hier unter dem Punkt basicAuth entsprechende Hinweise. Wir fügen hier einfach mal einen Benutzer "webhook" mit dem Passwort "Geofancy" hinzu, das sieht dann so aus:

<pre>
attr allowedWEBhook basicAuth { "$user:$password" eq "webhook:Geofancy" }
</pre>

Weitere Infos zur Absicherung gibt auch [[FritzBox Webzugriff absichern]].

Um zu testen, ob unsere Absicherung erfolgreich war, kann man die URL <nowiki>https://192.168.178.1:8088/webhook/geo</nowiki> aufrufen (wichtig ist, dass man jetzt https und nicht mehr http eingibt; ansonsten bekommt man keine Antwort). Eine Zertifikatswarnung kann getrost ignoriert werden, verschlüsselt wird trotzdem. Es sollte auch eine Passwort Abfrage kommen und die Eingabe der entsprechenden Daten sollte dann zu einer entsprechenden Meldung vom GEOFANCY Modul führen:

<pre>
NOK No data received, see API information on http://wiki.geofancy.com
</pre>

Das ist ok, schließlich sind wir keine App, sondern der Mensch, der nur mal eben prüfen will :-)

=== Zugriff vom Internet ermöglichen ===
Das ist je nach Fritzbox und Software Version unterschiedlich. Grundsätzlich gilt: Eine Weiterleitung des ports 8088 vom Internet auf das laufende FHEM auf Port 8088 intern ist von AVM so nicht vorgesehen.
Bei mir führte folgendes zum Erfolg:

* Einloggen per Telnet auf der Fritzbox (ich habe FritzOS 6 installiert)
* Konfiguration editieren mittels "nvi /var/flash/ar7.cfg"
* Suchen nach richtiger Zeile durch Eingabe von "/internet_forwardrules" und Enter
* Hinzufügen einer weiteren Zeile (Vorsicht, die bestehende Zeile endet mit ; und das muss in , umgeändert werden, so dass das ; schließlich am Ende der Zeile steht.

So sieht es bei mir vorher aus:
:<code>internet_forwardrules = "tcp 0.0.0.0:488 0.0.0.0:488 0";</code>
Hinterher:
:<code>internet_forwardrules = "tcp 0.0.0.0:488 0.0.0.0:488 0", "tcp 0.0.0.0:8088 0.0.0.0:8088 0";</code>

Danach mittels ":x" abspeichern und sofort per "reboot" die Box neu starten, um diese Änderungen zu aktivieren. Das ist wichtig; ansonsten zeigt die Erfahrung, dass die Änderung nicht dauerhaft erhalten bleibt und die gerade gemachten Änderungen verloren gehen.

Wer die Einstellungen zu "internet_forwardrules" bei sich nicht finden kann, hat womöglich eine andere Version als ich oder ein leicht anderes Gerät und bemüht am besten Google, was er tun kann, um das Gleiche zu erreichen. Möglicherweise tauchen die Einträge auch erst auf, wenn man mal über das Webinterface ein Forwarding eingerichtet hatte.

Hat man einen DynDNS Dienst oder myFritz auf der Fritzbox aktiviert, so kann man jetzt auch von draußen auf den Webhook zugreifen. Das kann man prüfen, indem man das iPhone aus dem WLAN ausbucht und einmal die externe Adresse eingibt, also z.B. https://meindyndns.org:8088/webhook/geo.

=== Weitere Alternativen für den Zugriff aus dem Internet ===
Als Alternative zum Port Forwarding kann man sich auch per VPN in das lokale Netzwerk einwählen. iOS bietet dazu auch eine automatische Aktivierung des VPN (VPN on Demand), wie z.B. [http://forum.loxone.com/dede/netzwerk-firewall-and-security/8121-vpn-demand-ios-8-1-1-fritz-box-kleine-how.html hier] beschrieben wird.

Auch eine Alternative ist, das Portforwarding nicht direkt an FHEM einzurichten, sondern an einem im Netzwerk laufenden Reverse-Proxy, der dann seinerseits die Anfragen an FHEM weiterleitet. Dies kann z.B. Apache, Nginx oder am besten HAproxy sein.
Letzterer ist dabei sehr flexibel, allerdings nicht unbedingt einfach zu konfigurieren. Ein paar Inspirationen diesbezüglich gibt es z.B. [https://github.com/Hoanoho/HSE/tree/develop/lib/cfg/any/stat/etc/haproxy hier] und [https://github.com/Hoanoho/HSE/tree/develop/lib/cfg/any/dyn/etc/haproxy hier]. Wer pfSense nutzt, findet [http://loredo.me/post/116633549315/geeking-out-with-haproxy-on-pfsense-the-ultimate diesen Artikel] womöglich auch interessant. Er zeigt auch, dass mit HAproxy noch weit mehr möglich ist.
Der Reverse-Proxy sollte dabei auch unbedingt der TLS Termination Point sein (TLS Offloading). Nicht nur spart man sich dann die Aktivierung von TLS in FHEM, sondern man hat auch mehr Einfluss darauf, wie TLS arbeitet (z.B. Deaktivierung von SSLv3, forcieren von TLSv1.2, nur als sicher eingestufte Cipher Suite... siehe auch Infos auf der [https://wiki.mozilla.org/Security/Server_Side_TLS Mozilla Website]).

=== Einrichten in der Geof[e|a]ncy.app ===
Hat das alles soweit geklappt, können endlich in der Geofency.app bzw. Geofancy.app am iPhone die gewünschten Bereiche definiert werden. Am Besten zuvor in den Global Settings die folgenden Einstellungen hinterlegen:

* URL: https://meindyndns.org:8088/webhook/geo
* POST (oder GET, ist egal - das FHEM Modul kann beides)
* HTTP Basic Authentication: EIN (entsprechend Username und Password eintragen)

Anfänglich ist es empfehlenswert noch "Notification on success" und "Notification on Failure" einzuschalten. Ersteres kann man ausmachen wenn man weiß, dass es soweit funktioniert. Über "Send Test-Request" kann man einmal einen Test schicken und erhält das Ergebnis entsprechend dargestellt. Es sollte sowas kommen wie
:<code>POST Success: test OK</code>. In Geofancy.app gibt es keine Rückmeldung über den Erfolg des Testrequests. In FHEM sollten sich durch den Testrequest jedoch die Readings sofort aktualisieren (Ggf. ist ein Reload der FHEMWEB-Seite nötig da zusätzliche Tabellenzeilen nicht via Longpoll ergänzt werden).

Funktioniert das soweit, kann man eine neue Lokation als sein Zuhause anlegen. Es empfiehlt sich einen ID-Namen zu setzen; dieser ist dann in FHEM als Name für die Lokation sichtbar. Für die eigene Wohnung empfiehlt sich hier "home" (da dies auch direkt vom RESIDENTS Modul so verwendet werden kann). Man kann auch Trigger für andere Standorte anlegen. FHEM weiß dann sogar, wenn ihr im Büro seid und könnte sich dabei auch unterschiedlich verhalten, als wenn ihr "auf Achse" seid. Bei letzterem ist der Status im GEOFANCY Modul "underway", was so viel heißt wie "unbekannter Aufenthaltsort".

Hinweis: Zumindest für Geofancy.app liefert ein Testrequest wohl zufällige Locations zurück. Die eigenen Location-IDs werden also nicht übergeben, selbst wenn man sich in einem Geofence befindet. Um zu testen muss man sich wohl oder übel selbst bewegen ;-).

=== GEOFANCY Modul individualisieren ===
Die im GEOFANCY Modul dargestellten Readings sind nun in etwa so, wenn ihr euch bewegt:

<pre>
Readings:
2014-01-18 14:37:42 lastDevice -
2014-01-18 14:37:42 lastDeviceUUID 51F23894-AAAA-BBBB-CCCC-0123456789AB
2014-01-18 14:37:42 state dev:51F23894-AAAA-BBBB-CCCC-0123456789AB trig:test id:home lat:48.9999 long:11.9999
</pre>

Wer genauer hinschaut sieht: Mein iPhone heißt wohl 51F23894-AAAA-BBBB-CCCC-0123456789AB.
Damit nun die Readings für mein iPhone richtig angelegt werden, muss ein Device Alias gesetzt werden. Sinnvoll erscheint mir der Vorname des Besitzers:
:<code>attr geofancy devAlias 51F23894-AAAA-BBBB-CCCC-0123456789AB:Julian</code>

Weitere Alias-Namen können mit Leerzeichen einfach angehängt werden.
Jetzt werden weitere Readings angelegt, sobald GEOFANCY entsprechende Daten vom Mobilgerät empfängt:

<pre>
Readings:
2014-01-18 14:37:42 Julian arrived home
2014-01-18 14:37:42 currLocLat_Julian 48.9999
2014-01-18 14:37:42 currLocLong_Julian 11.9999
2014-01-18 14:37:42 currLocTime_Julian 2014-01-18 14:37:42
2014-01-18 14:37:42 currLoc_Julian home
2014-01-17 19:18:23 lastArr Julian home
2014-01-17 18:41:46 lastDep Julian Office
2014-01-18 14:37:42 lastDevice Julian
2014-01-18 14:37:42 lastDeviceUUID 51F23894-AAAA-BBBB-CCCC-0123456789AB
2014-01-17 18:41:46 lastLocArr_Julian 2014-01-17 08:58:37
2014-01-17 18:41:46 lastLocDep_Julian 2014-01-17 18:41:46
2014-01-17 18:41:46 lastLocLat_Julian 48.1111
2014-01-17 18:41:46 lastLocLong_Julian 11.1111
2014-01-17 18:41:46 lastLoc_Julian Office
2014-01-18 14:37:42 state dev:Julian trig:test id:home lat:48.9999 long:11.9999
</pre>

Möchte man nun etwas bestimmtes tun, wenn man nach Hause kommt oder das Heim verlässt, kann man am Besten ein entsprechendes Notify auf das Reading currLoc_Name setzen. Ich aktualisiere lediglich zwei Dummies, durch die dann alle weiteren Notifies ausgelöst werden:

<pre>
define n_Julian.Presence notify geofancy:currLoc_Julian:.home set Julian.homestatus:FILTER=STATE!=home home
attr n_Julian.Presence room Residents
define n_Julian.absence notify geofancy:currLoc_Julian:.underway {\
if (Value("Julian.homestatus") ne "gone") {\
fhem("set Julian.homestatus:FILTER=STATE!=absent absent");;\
}\
}
define n_Julian.whereabout notify geofancy:currLoc_Julian:.* set Julian.whereabout:FILTER=STATE!=$EVTPART1 $EVTPART1
</pre>

Wer es noch einfacher möchte (bzw. auch noch mehr Features) schaut sich einmal die neue Modulfamilie aus RESIDENTS[http://fhem.de/commandref_DE.html#RESIDENTS], ROOMMATE[http://fhem.de/commandref_DE.html#ROOMMATE] und GUEST[http://fhem.de/commandref_DE.html#GUEST] an. Diese sind direkt auf GEOFANCY abgestimmt. Dabei kann das devAlias Attribut entfallen und man hinterlegt die UUID stattdessen direkt im ROOMMATE oder GUEST Device (Attribut r*_geofenceUUIDs). Das erspart es für jeden Bewohner und jedes Device zig unterschiedliche Devices der Typen Notify, DOIF oder Watchdog anlegen und pflegen zu müssen.

Wer mehr Kontrolle möchte kann natürlich bei notify, DOIF und Co. bleiben: <code>define n_rr_Julian.location notify geofancy:currLoc_Julian:.* set rr_Julian:FILTER=location!=$EVTPART1 location $EVTPART1</code>. Wobei "Julian" dabei als devAlias in GEOFANCY eingtragen wurde, rr_Julian der Name des ROOMMATE aus RESIDENTS ist. Außerdem wurden die Location-IDs in der Geofency.app bzw. Geofancy.app so gewählt, dass diese direkt einem ROOMMATE-Status entsprechen (also z.B. home, wayhome...).

== Beispiele für die Nutzung der Anwesenheitserkennung ==
Hier sollen Beispiele für den Nutzen von Anwesenheitserkennung aufgezeigt werden.

=== Abschalten aller Verbraucher (Licht, Musikanlage) beim Verlassen der Wohnung ===
Typisches Szenario: Man geht ausser Haus, aber hat vergessen im Bad das Licht aus zu machen. Allerdings geht man heutzutage fast garnicht mehr ohne Handy aus dem Haus.

Nun soll FHEM in der gesamten Wohnung das Licht, sowie sonstige Verbraucher ausschalten, wenn ich länger als 15 Minuten ausser Haus bin. Dazu benötigt man zuerst eine structure, die alle Verbraucher und sonstigen Devices, die das betrifft, zusammenfasst.

<pre>
define Gesamte_Wohnung structure Gesamtes_Licht Licht_Wohnzimmer Licht_Kueche LED_Kueche Licht_Bad Licht_Schlafzimmer AV_Receiver TV_Steckdose
attr Gesamte_Wohnung room Wohnung
</pre>

Nun kann man mittels eines watchdogs eine Überwachung für sein Handy anlegen:

<pre>
# Überwachen der gesamten Wohnung mittels collectord sowie presenced in jedem Raum
define Handy PRESENCE lan-bluetooth XX:XX:XX:XX:XX:XX 127.0.0.1:5222
attr Handy event-on-change-reading state # Ein Event soll nur bei der Änderung des Anwesenheitsstatus (Reading: status) erfolgen. Wichtig für den watchdog!!!

# Nach 15 Minuten Abwesenheit (Handy im Status "absent") soll die gesamte Wohnung ausgeschaltet werden.
define watchdog_Anwesenheit watchdog Handy:absent 00:15 Handy:present set Gesamte_Wohnung off ; trigger watchdog_Anwesenheit .
attr watchdog_Anwesenheit regexp1WontReactivate 1
</pre>

=== Benachrichtigung bei Batteriewechsel ===
Mit Hilfe des PRESENCE-Moduls kann man auch bei batteriebetriebenen Geräten eine Meldung ausgeben, sobald ein Batteriewechsel ansteht. Hier im Beispiel wird der Eve-Room-Sensor von Elgato eingebunden und anschließend mit einer DOIF-Nachricht ausgestattet.
Die Bluetooth-Adresse des Sensors kann mittels eines BLE-Scanners ermittelt werden.

<pre>
# PRESENCE-Modul für Elgato Eve Room Sensor mit Aktualisierung aller 6 Minuten
define Eve_Room_BLE lan-bluetooth <Bluetooth-Adresse> 127.0.0.1:5333 360
</pre>

Anschließend wird eine DOIF-Regel definiert, die eine Nachricht an die installiere [[FHEM_APP|FHEM App]] absendet:
<pre>
define Eve_Room_BLE_Battery_Msg DOIF ([Eve_Room_BLE] eq "absent") (set Msg_iPhone message 'Batteriewechsel beim Eve Room Sensor im Wohnzimmer.')
attr Eve_Room_BLE_Battery_Msg wait 600
</pre>

Die Aktualisierung des PRESENCE-Eintrages sollte nicht größer sein als das WAIT-Attribut der DOIF-Regel. Ansonsten könnte eine kurze Systemstörung zum Fehlalarm führen.

== Anwesenheitserkennung Bluetooth PebbleBee mit PRESENCE Modul ==
Im Forum gibt es einen {{Link2Forum|Topic=28753|LinkText=langen Beitrag}} über die Einrichtung eines BT-Tag an einem RaspberryPI mit FHEM. Dabei werden Skripte wie blescan.pl und lepresenced genannt.
Da mittlerweile viele neue Informationen zusammen gekommen sind wurde der Wiki Eintrag erstellt.

Im Folgenden wird die Konfiguration für '''LE Deviced (z.B. Gtags,Pebbles etc.)''' und '''NICHT LE Device (z.B. IPhone)''' beschreiben.

{{Randnotiz|RNText=Beide hier beschriebenen Wege (presenced/lepresenced) können parallel auf dem selben BT-Dongle laufen, da sich die Ports unterscheiden! }}
'''Wo finde ich denn lepresenced?'''

lepresenced kann über Github heruntergeladen werden (Link weiter unten)

'''Was ist der Vorteil gegenüber blescan.pl?'''

blescan.pl hat u. a. das Problem, dass dank der wundervollen Bluetooth-Implementierung unter Linux ab und zu der Scan fehlschlägt und das Interface resettet werden muss. Das tut blescan.pl auch mit aller Gewalt. Dazu kommt, dass bei längeren Scanzeiten und vielen Tags sich die Prozesse anstauen, weil immer nur auf einen Tag "gewartet" wird. Außerdem wurden mit der Einführung von lepresenced sämtliche Supportverträge gekündigt lepresenced läuft dauerhaft und merkt sich bei allen sendenden Tags den Zeitstempel des letzten Empfangs.

=== Getestete Hardware/Software===
* '''Raspbian System''' - wheezy, Jessie
* '''BT-Dongle''' - CSL NET BT USB2.0 Stick, Bluetooth V4.0, Nano '''Achtung''': Es muss ein BT V4.0 oder höher verwendet werden. Nur dieser unterstützt ''LowEnergy''
* '''BT-TAG''' - Gtag von Gigaset, TrackR, UDOO Neo, PebbleBee, iTag von Unitec, X4-LIFE Multifunkti BL-Anhänger, iTag Wireless Anti, Trackr bravo

=== BT Dongel am PI installieren ===

Um den BT Dongle ''(hier: CSL NET BT USB2.0)'' am PI verwenden zu können, müssen die notwendigen Pakete über die Paketverwaltung von debain nachinstalliert werden.
Wer bereits ein BT-Dongle installiert hat, kann diesen Schritt überspringen.
<pre>
apt-get install bluetooth
</pre>
Nach erfolgreicher Installation der Pakete sollte der RaspberryPI neu gestartet werden.
<pre>
sudo reboot
</pre>

Nach dem erfolgten Reboot bitte das Log des Raspberry auf folgende Einträge prüfen:
<pre>
Feb 12 19:52:55 fhem kernel: [ 4.773600] Bluetooth: Core ver 2.20
Feb 12 19:52:55 fhem kernel: [ 4.773748] NET: Registered protocol family 31
Feb 12 19:52:55 fhem kernel: [ 4.773765] Bluetooth: HCI device and connection manager initialized
Feb 12 19:52:55 fhem kernel: [ 4.773797] Bluetooth: HCI socket layer initialized
Feb 12 19:52:55 fhem kernel: [ 4.773821] Bluetooth: L2CAP socket layer initialized
Feb 12 19:52:55 fhem kernel: [ 4.773890] Bluetooth: SCO socket layer initialized
Feb 12 19:52:55 fhem kernel: [ 4.797531] usbcore: registered new interface driver btusb
</pre>
Sobald der BT-Dongle erkannt wurde ''leuchtet'' (wenn vorhanden) auch die ''blaue/gelbe'' LED am Dongle auf.

=== BT-Tags aktivieren ===
Jetzt kann der BT-Tag aktiviert werden. Bei einigen Tags muss dafür die '''Batteriesicherung''' gezogen werden.

Einen Tag wird mit folgendem Befehl auf der Konsole gesucht:
<source lang="bash">
sudo hcitool lescan

Ausgabe z.B.:
LE Scan ...
7C:2F:80:A1:XA:XD (unknown)
7C:2F:80:A1:XA:XD Gigaset G-tag
7C:2F:80:A1:X4:X1 (unknown)</source>
Eine Übersicht über die möglichen Befehle von hcitool gibt es mit der Eingabe von:
<pre>
sudo hcitool

Ausgabe z.B.:
hcitool - HCI Tool ver 5.23
Usage:
hcitool [options] <command> [command parameters]
Options:
--help Display help
-i dev HCI device
Commands:
dev Display local devices
inq Inquire remote devices
scan Scan for remote devices
name Get name from remote device
info Get information from remote device
spinq Start periodic inquiry
epinq Exit periodic inquiry
cmd Submit arbitrary HCI commands
con Display active connections
cc Create connection to remote device
dc Disconnect from remote device
sr Switch master/slave role
cpt Change connection packet type
rssi Display connection RSSI
lq Display link quality
tpl Display transmit power level
afh Display AFH channel map
lp Set/display link policy settings
lst Set/display link supervision timeout
auth Request authentication
enc Set connection encryption
key Change connection link key
clkoff Read clock offset
clock Read local or remote clock
lescan Start LE scan
lewladd Add device to LE White List
lewlrm Remove device from LE White List
lewlsz Read size of LE White List
lewlclr Clear LE White list
lecc Create a LE Connection
ledc Disconnect a LE Connection
lecup LE Connection Update
</pre>

Falls beim SCAN kein Tag gefunden wird, sollte das BT Interface neu gestartet werden. Dazu ist kein Reboot des PI notwendig.
<source lang="bash">
sudo hciconfig hci0 down
sudo hciconfig hci0 up
sudo hcitool dev
</source>

=== Anleitung für ein LE Device (z.B. Gtags,Pebbles etc.) ===

Die Software lepresenced kann aktuell über drei Varianten installiert werden. Dabei ist die bevorzugte Variante (Variante 1) die Installation über das bereitgestellte .deb-Paket.
Die Variante 2 setzt voraus, dass im FHEM contrib Verzeichnis (/opt/fhem/contrib) die aktuelle Version des .deb-Pakets liegt. Die Variante 3 ist dafür gedacht, wenn man keine .deb-Pakete installieren kann/will oder es aus anderen Gründen nicht funktioniert. Es wird davon abgeraten die Variante 3 zu verwenden. Vollständigkeithalber wird sie aber aufgeführt.

====Installation per .deb-Paket====

Die bevorzugte Variante ist die Installation von lepresenced durch die passenden .deb Pakete.

'''1.Variante:'''
Herunterladen der aktuellen lepresenced-0.81-1.deb Datei über den Webbrowser
[https://svn.fhem.de/trac/export/HEAD/trunk/fhem/contrib/PRESENCE/deb/ SVN-Repository]. Im SVN die passende Datei auswählen und in der folgende Webseite den Link unter:
<pre>
Download in other formats:
Original Format
</pre>
anklicken und die Datei herunterladen.
Die Datei kann jetzt auf den RPi kopiert und mit folgenden Befehlen ausgeführt werden (ggf. Berechtigungen anpassen).

Alternativ per wget Befehl direkt auf den RPi
https://svn.fhem.de/trac/export/13992/trunk/fhem/contrib/PRESENCE/deb/lepresenced-0.81-1.deb

'''2.Variante:'''
Herunterladen aus dem fhem contrib Verzeichnis:
Hierzu muss das contrib auf dem aktuellen Stand sein. Dazu wird die Installation von subversion (normal bereits vorhanden) benötigt.

sudo apt-get install subversion

Danach kann per
sudo svn checkout svn://svn.code.sf.net/p/fhem/code/trunk/fhem/contrib svnrepo

Das aktuelle Repository auf den Pi heruntergeladen werden. Danach sollte im gewählten Verzeichnis die eingecheckten Dateien verfügbar sein.
/opt/fhem/svnrepo/PRESENCE/deb

''' Installation der Variante 1 oder 2 '''
Egal welche Variante gewählt wurde, kann nun mit folgenden Befehlen das Paket installiert werden. Bitte Pfade ggf. anpassen.

sudo dpkg -i lepresenced-0.81-1.deb

sudo apt-get -f install

Die Ausgabe der Installation sollte am Ende ein [ ok ] Starting lepresenced (via systemctl): lepresenced.service. ausgeben.

<pre>
Paketlisten werden gelesen... Fertig
Abhängigkeitsbaum wird aufgebaut.
Statusinformationen werden eingelesen.... Fertig
Abhängigkeiten werden korrigiert ... Fertig
Die folgenden zusätzlichen Pakete werden installiert:
bluez-hcidump
Die folgenden NEUEN Pakete werden installiert:
bluez-hcidump
0 aktualisiert, 1 neu installiert, 0 zu entfernen und 0 nicht aktualisiert.
1 nicht vollständig installiert oder entfernt.
Es müssen 157 kB an Archiven heruntergeladen werden.
Nach dieser Operation werden 490 kB Plattenplatz zusätzlich benutzt.
Möchten Sie fortfahren? [J/n]
Holen: 1 http://archive.raspberrypi.org/debian/ jessie/main bluez-hcidump armhf 5.23-2+rpi2 [157 kB]
Es wurden 157 kB in 0 s geholt (921 kB/s).
Vormals nicht ausgewähltes Paket bluez-hcidump wird gewählt.
(Lese Datenbank ... 42033 Dateien und Verzeichnisse sind derzeit installiert.)
Vorbereitung zum Entpacken von .../bluez-hcidump_5.23-2+rpi2_armhf.deb ...
Entpacken von bluez-hcidump (5.23-2+rpi2) ...
Trigger für man-db (2.7.0.2-5) werden verarbeitet ...
bluez-hcidump (5.23-2+rpi2) wird eingerichtet ...
lepresenced (0.81-1) wird eingerichtet ...
[ ok ] Starting lepresenced (via systemctl): lepresenced.service.
</pre>

Ab hier kann, wenn alles problemlos funktioniert hat mit der [[Einrichtung der G-Tags über FHEM]] weitergemacht werden.

'''3.Variante:'''

Bei dieser Variante wird das aktuellste lepresenced Skript aus github heruntergeladen. Das bedeutet, dass jegliche Konfiguration wie automatischer Start, Berechtigungen etc.
manuell konfiguriert werden muss. Diese Variante eignet sich nur für diejenigen, die keine .deb-Pakete installieren wollen/können oder die genau Wissen, was sie tun!
<pre>
https://github.com/mhop/fhem-mirror/blob/master/fhem/contrib/PRESENCE/lepresenced
</pre>

Zur "Installation" des Skripts folgendermaßen vorgehen:
Unter /fhem manuell den Ordner „script“ anlegen:
<pre>
mkdir script
</pre>
Datei lepresenced reinkopieren und ausführbar machen:
<pre>
sudo chmod +x /opt/fhem/script/lepresenced
sudo chgrp -cR dialout lepresenced
</pre>
Skript erstmalig starten:
<pre>
sudo ./lepresenced --loglevel LOG_EMERG -d
</pre>
Kommt beim Starten des Skript eine Fehlermeldung, müssen die Abhängigkeiten aufgelöst werden.
<pre>
Can't locate Net/Server/Daemonize.pm in @INC (@INC contains: /etc/perl /usr/local/lib/perl/5.14.2 /usr/local/share/perl/5.14.2 /usr/lib/perl5 /usr/share/perl5 / usr/lib/perl/5.14 /usr/share/perl/5.14 /usr/local/lib/site_perl .) at /opt/fhem/lepresenced line 17.
BEGIN failed--compilation aborted at /opt/fhem/lepresenced line 17.
</pre>
Um die Abhängigkeiten aufzulösen muss folgendes nachinstalliert werden und anschließend ein Reboot durchgeführt werden.
<pre>
sudo apt-get install libnet-server-*
</pre>

====Einrichtung der G-Tags über FHEM====

Nach dem letzten Schritt sind alle Bedingungen für eine abschließende Konfiguration der BT-Tags in FHEM abgeschlossen worden.
Jetzt kann der Tag dem FHEM-Server bekannt gemacht werden.
<pre>
-- Name Modul Modus MAC vom Gtag IP vom PI Port Abfragezeit in Sekunden
define MeinGtAG PRESENCE lan-bluetooth xx:xx:xx:xx:xx:xx 127.0.0.1:5333 120
</pre>

Den absent und present Mode kann man einfach testen, in dem man den Gtag mit Alufolie einwickelt.

=== Anleitung für ein NICHT LE Device (z.B. IPhone) ===
Die Installation kann (wie in der commanref beschrieben) über Debian Pakete erfolgen.
<pre>
.deb package for Debian (noarch): presenced-1.3.deb http://svn.code.sf.net/p/fhem/code/trunk/fhem/contrib/PRESENCE/deb/presenced-1.3.deb

.deb package for Raspberry Pi (raspbian): presenced-rpi-1.3.deb http://svn.code.sf.net/p/fhem/code/trunk/fhem/contrib/PRESENCE/deb/presenced-rpi-1.3.deb
</pre>

<pre>
sudo dpkg -i presenced-rpi-1.3.de
</pre>

Installation perl script file (Auszug commanref)
<pre>
direct perl script file: presenced http://svn.code.sf.net/p/fhem/code/trunk/fhem/contrib/PRESENCE/presenced
</pre>

Nach dem letzten Schritt sind alle Bedingungen für eine abschließende Konfiguration der BT-Tags in FHEM abgeschlossen worden.
Jetzt kann der Tag dem FHEM-Server bekannt gemacht werden.
{{Randnotiz|RNText=Wenn man mit collectord arbeitet muß man die Erkennung bei allen Devices auf port 5222 setzen.
lan-bluetooth xx:xx:80:xx:xx:AC 127.0.0.1:5222 20 120}}
<pre>
-- Name Modul Modus MAC vom Gtag IP vom PI Port Abfragezeit in Sekunden
define MeinGtAG PRESENCE lan-bluetooth xx:xx:xx:xx:xx:xx 127.0.0.1:5333 120
</pre>

=== Automatischer Start ===

Wurde leprecend mit der oben genannten Variante 1 oder 2 installiert worden sein, wird per systemctl der automatische Start direkt eingerichtet. Es ist somit keine extra Konfiguration per Cron oder init.d notwendig.

Wurde die Variante 3 - die manuelle Installation - durchgeführt; bitte folgende Schritte für den automatischen Start befolgen:

Damit das leprecend Skript beim Systemstart mitgestartet wird, sollte eine Crontab Eintrag gesetzt werden. Alternativ die rc.local anpassen.
Ersteres würde so aussehen:

Ein sh-Skript mit dem Inhalt:
<pre>
sudo start-stop-daemon -d /opt/fhem/script -S -x /opt/fhem/script/lepresenced &
</pre>
unter dem Verzeichnis /home/pi ablegen, welches sich init_start.sh nennt.

Das Skript dann unter: sudo crontab -e einhängen mit folgender Folge:
<pre>
@reboot /home/pi/init_start.sh
</pre>

Zweiteres so:
<pre>
sudo nano /etc/rc.local
</pre>

Datei rc.local, freie Stelle suchen, vor "exit 0":

<pre>
# Start lepresenced
/opt/fhem/script/lepresenced --loglevel LOG_EMERG -d
exit 0
</pre>

=== Batterieüberwachung (aktuell nur G-Tags) ===

Leider überträgt der G-Tag nach der Einrichtung als Device in FHEM kein Reading mit seinem aktuellen Batteriestatus.
Dem wurde mit Hilfe des Forum Abhilfe geschaffen.
Im Folgenden wird erläutert wie die Batterieüberwachung eingerichtet werden kann.

'''Voraussetzung:'''

bc - Basiscalculator [https://packages.debian.org/de/sid/bc Bc-Paket]
<pre> sudo apt-get install bc </pre>

Anlegen eines Shellskript auf dem Raspberry System.
Die Parameter <<MAC-Adresse>> und <<TagName>> müssen durch die Werte des auszulesenden G-Tags ersetzt werden.
<pre>
#!/bin/bash
stringZ=$(sudo gatttool -b 5C:2B:80:C1:14:41 --char-read --handle=0x001b)
stringZ=${stringZ:33:2}
stringZ=$(echo "$stringZ" | tr a-f A-F)
decimal=$(echo "ibase=16; $stringZ" | bc)
perl /opt/fhem/fhem.pl 7072 "setreading MeinGtag Batterie $decimal"
</pre>

Dem Device in FHEM (hier MeinGtag) ein userReading mit dem Namen '''Batterie''' hinzufügen.
Das Shellskript mit folgendem Befehl starten:
<pre>
./GtagBatterie.sh
</pre>
'''Wichtig ist hierbei,''' dass Skript mit "./" und nicht mit "sh" aufzurufen. Beim Aufruf mit "sh GtagBatterie.sh" produziert es einen Fehler
<pre>GtagBatterie.sh: 3: GtagBatterie.sh: Bad substitution </pre>

Das Reading wird auf den ausgelesenen Wert der Batterie gesetzt.

Hinweis: Es sollte für jeden G-Tag ein eigenes Skript abgelegt werden. Das Skript kann per crontab oder fhem Kommando (system) regelmäßig aufgerufen werden.

=== Batterieüberwachung (alle Devices vom Typ "MODE=lan-bluetooth") ===

Es gibt eine weitere Möglichkeit um den Batteriestatus von LE Devices abzurufen und in FHEM als Reading darzustellen.
Dabei wird der Batteriezustand für alle LE Devices, die bereits in FHEM konfiguriert sind und per lepresenced überwacht werden, automatisch in einem shell-Script ermittelt.
Näheres dazu im Forumartikel {{Link2Forum|Topic=56960|LinkText=Erweiterung: Anwesenheitserkennung/Batterieüberwachung}}.

Vorteile:
* Automatische Ermittlung aller in FHEM konfigurierten LE Devices
* Möglichkeit, diese Devices alternativ manuell im Script einzutragen
* Es werden nur Devices abgefragt, die im Status "present" sind, also mit ziemlicher Sicherheit auch verfügbar sind
* Ein eventuell auf dem FHEM telnet-Port gesetztes Passwort kann im Script hinterlegt werden

'''Voraussetzung:'''

'''Funktionierendes lepresenced''' - siehe [[Anwesenheitserkennung#Anleitung_f.C3.BCr_ein_LE_Device_.28z.B._Gtags.2CPebbles_etc..29|Anleitung für ein LE Device (z.B. Gtags,Pebbles etc.)]]

'''socat''' - TCP port forwarder
<pre>
sudo apt-get update && sudo apt-get install socat
</pre>

'''gawk''' - Zum extrahieren der Daten
<pre>
sudo apt-get update && sudo apt-get install gawk
</pre>

'''gatttool''' - Bestandteil von bluez

gatttool ist auf den meisten Distributionen im bluez-Paket, allerdings nicht bei Opensuse. Dort muss man das Sourcepaket von bluez installieren und selbst kompilieren.
gatttool sollte dann nach /usr/bin oder /usr/local/bin kopiert werden,

Zusätzlich zu den notwendigen Erweiterungen werden für die Ausführung von gatttool '''Root-Rechte benötigt'''!

Das Script selbst gibt es hier: [https://raw.githubusercontent.com/micky0867/lebattery/master/lebattery lebattery]

Am Besten unter /opt/fhem/script/lebattery speichern und ausführbar machen:
<source lang="bash">
sudo su -
mkdir /opt/fhem/script
cd /opt/fhem/script
wget https://raw.githubusercontent.com/micky0867/lebattery/master/lebattery
chmod 755 lebattery
</source>

Je nach Bedarf können im Script noch die folgenden 3 Parameter angepasst werden:
<source lang="bash">
# If allowed_telnetPort is protected by a password, add the password here
TELNETPASSWORD=""
# Attribute for batterylevel in FHEM
ATTRIBUT="batterylevel"
# Use this, if you dont want the script to determine the tags on its own
LETAGS=""
</source>

Das Skript wird dann unter root folgendermaßen gestartet:
<pre>
/opt/fhem/script/lebattery -v
</pre>

Ausgabe des Skripts, wenn es mit dem Verbose Parameter -v gestartet wird.

Beide Devices sind vom Typ NUT mini, das Device mit dem FHEM-Namen '''nut_Micky''' ist im Status '''absent'''. Das zweite Device ist im Status '''present'''.
<pre>
Determining address for nut_Micky ...
nut_Micky is in state absent, no further action required

Determining address for nut_Test ...
Fetching batterylevel for nut_Test (F3:44:04:81:54:89) ...
Setting batterylevel for nut_Test to 100%
</pre>

Mein crontab-Eintrag (User root) sieht so aus:
<pre>
3 3 * * * /opt/fhem/script/lebattery -v >/opt/fhem/script/lebattery.log 2>&1
</pre>
Damit wird jeden Morgen um 3 Minuten nach 3 Uhr der Zustand der Batterien aller Devices ermittelt und in FHEM abgespeichert. 
Bevor man das mit crontab macht, sollte man allerdings zunächst sicher stellen, dass es auch ohne crontab funktioniert....

Bei Problemen kann man auch erstmal schauen, ob das mit dem gattool überhaupt funktioniert:
<pre>
gatttool -t <Typ> -b <MAC-Adresse> --char-read --uuid 0x2a19

handle: 0x0017 value: 64
</pre>
In diesem Fall hat die Batterie noch 100% (hex 64). 
Der Typ ist abhängig vom Hersteller und kann public (G-Tags) bzw. random (Nut) sein. Im Zweifelsfall beides ausprobieren.

=== Anwesenheitserkennung / Anwesenheitsbenachrichtigung mit G-Tags ===

Ein Skript zur Nutzung der Gigaset G-TAGs zur Alarmierung bei öffnen und schließen von Türen und zur Anwesenheitserkennung, um die Alarmierung zu aktivieren bzw. deaktivieren.
Es kann verwendet werden um die Anwesenheit von mehrern Personen im Haushalt zu erkennen. Dabei wird eingeschränkt, dass nur bestimmte Personen die Alarmierung aktivieren können ( Eltern/Kind -Beziehung ).
Des Weiteren werden im Beispiel die Eltern benachrichtigt wenn eins der Kinder das Haus verlässt und die Eltern nicht anwesend sind.

{{Randnotiz|RNText= Namen der G-Tags in den Skripten bitte Anpassen!}}

Für die ''Notify'' und die ''RESIDENTS-Erweiterung'' wird ein Dummy benötigt.
<pre>
define Alarm dummy
attr Alarm devStateIcon aktiv:secur_locked@red inaktiv:secur_open@lightgreen
attr Alarm eventMap on:aktiv off:inaktiv
attr Alarm setList on off
attr Alarm webCmd aktiv:inaktiv
attr Alarm room Alarm
</pre>

====Mit Notify ====
<pre>
gtag.*.presence:.* {Anwesenheit_check("$EVTPART1", "$NAME")}
</pre>

Code für die 99_myUtils.pm
<pre>
### GTAG ANWESENHEITS CHECK
sub Anwesenheit_check($$) {
my ($EVENT, $NAME) = @_;

# gtag_rot - Alias Marco
# gtag_schwarz - Alias Ulli
# gtag_gruen - Alias Frida
# gtag_orange - Alias Hannah

my $RESIDENT = "rr_"; # Alle GTAGs sind Standardmäßig Residents Roommate
# $RESIDENT = "rg_" if (($NAME eq "gtag_orange") xor ($NAME eq "gtag_weis")); # Hier nur Gäste (Roomguest) Auskommentiert, da ich es so nicht brauche
my $ROOMMATE = ("$RESIDENT" . "$NAME"); # Residentsname zusammenbauen
my $ALIASNAME = AttrVal($ROOMMATE,'alias',$ROOMMATE); # ALIAS des Roommates auslesen

my $GTAG1 = Value('gtag_rot'); # ELTERN
my $GTAG2 = Value('gtag_schwarz'); # ELTERN

my $STATUS = "wahrscheinlich gerade los";
$STATUS = "anwesend" if ($EVENT eq "present"); # Status: anwesend
$STATUS = "unterwegs" if ($EVENT eq "absent"); # Status: unterwegs

Log 1, "$ALIASNAME ist $STATUS."; # LOG Eintrag erzeugen

if (($EVENT eq "present" && Value("Alarm") eq "aktiv") && ($NAME eq "gtag_gruen" xor $NAME eq "gtag_orange")) {
fhem("set teleBot send ALARMIERUNG BLEIBT AKTIV: $ALIASNAME ist da..."); # Telegram
# fhem("set Infopush msg 'ALARMIERUNG BLEIBT AKTIV' '$ALIASNAME ist da...'"); # Pushover
}
elsif (($EVENT eq "present" && Value("Alarm") eq "aktiv") && ($NAME eq "gtag_rot" xor $NAME eq "gtag_schwarz")) {
fhem("set teleBot send ALARMIERUNG INAKTIV: $ALIASNAME ist da...; set Alarm inaktiv"); # Telegram
# fhem("set Infopush msg 'ALARMIERUNG INAKTIV' '$ALIASNAME ist da...'; set Alarm inaktiv"); # Pushover
}
elsif (($EVENT eq "absent" && Value("Alarm") eq "aktiv") && ($NAME eq "gtag_gruen" xor $NAME eq "gtag_orange")) {
fhem("set teleBot send ALARMIERUNG BLEIBT AKTIV: $ALIASNAME hat das Haus verlassen."); # Telegram
# fhem("set Infopush msg 'ALARMIERUNG BLEIBT AKTIV' '$ALIASNAME hat das Haus verlassen.'"); # Pushover
}
elsif (($EVENT eq "absent" && Value("Alarm") eq "inaktiv") && ($GTAG1 eq "absent" && $GTAG2 eq "absent")) {
fhem("set Alarm aktiv; set teleBot send ALARMIERUNG AKTIV: $ALIASNAME hat das Haus verlassen."); # Telegram
# fhem("set Alarm aktiv; set Infopush msg 'ALARMIERUNG AKTIV' '$ALIASNAME hat das Haus verlassen.' '' 0 ''"); # Pushover
}
}
</pre>

 

====Mit Notify und Integration des RESIDENTS-MODUL====

Der hier beschriebene Code erweitert die Funktionen unter dem Punkt 5.93.
Das Notify muss daher mit der folgenden Zeile erweitert werden.

<pre>
define Alarm_AnwesenheitCheck notify gtag.*.presence:.* { Anwesenheit_check("$EVTPART1", "$NAME"), Anwesenheit_check_resi("$NAME") }
</pre>

Zusätzlicher Code für die 99_myUtils.pm um die RESIDENTS Funktion nutzen zu können:
<pre>
### RESIDENTS
sub Anwesenheit_check_resi($) {
my ($NAME) = @_;
my $ALIASNAME = AttrVal($NAME,'alias',$NAME); # ALIASNAME des GTAGs auslesen

my $RESIDENT = "rr_"; # Als Standard sind alle GTAGs Roommates
$RESIDENT = "rg_" if (($NAME eq "gtag_orange") xor ($NAME eq "gtag_weis")); # Hier nur GTAG Namen der Gäste (Roomguest)
my $ROOMMATE = ("$RESIDENT" . "$ALIASNAME"); # Residentsname zusammenbauen

if (ReadingsVal($NAME,'presence',$NAME) eq "absent") {
fhem("set $ROOMMATE absent"); # Resisents Status von Roommates setzen
}
elsif(ReadingsVal($NAME,'presence',$NAME) eq "present") {
fhem("set $ROOMMATE home"); # Resisents Status von Roommates setzen
}
}
</pre>
 

====Mit Notify und Fenster/Tür. -Kontakt Überwachung====

Erweiterung für die Überwachung von Fenster/Tür. -Kontakten. Dazu sind zwei weitere Notifys notwendig die auf die Trigger der Kontakte regagieren
und so eine weitere Funktion in der 99_myUtils.pm ansprechen. Die Notifys triggern auf Kontakte die mit dem Namen Kontakt* beginnen.
Sollten die eigenen Fenster/Tür. -Kontakt anderen Namen besitzen, müssen die Skripte dementsprechend angepasst werden.
<pre>
define Alarm_Kontaktmeldung notify Kontakt.*:contact:.* {Kontakt_Meldung("$EVTPART1", "$NAME")}
</pre>
<pre>
define Alarm_Sabotagealarm notify Kontakt.*.sabotageError:.on {Kontakt_Sabotage("$EVTPART1", "$NAME")}
</pre>

Zusätzlicher Code für die 99_myUtils.pm um die TÜRKONTAKTE-Meldung nutzen zu können:
<pre>
### TÜRKONTAKTE-Meldung/Zustand
sub Kontakt_Meldung($$) {
my ($EVENT, $NAME) = @_;
my $ALIASNAME = AttrVal($NAME,'alias',$NAME);
Log 1, "$ALIASNAME wurde $EVENT";
if (ReadingsVal("Alarm", "state", "on") eq "on") {
fhem("set teleBot send $ALIASNAME wurde $EVENT"); # Nachricht über Telegram
# fhem("set Infopush msg '$ALIASNAME' '$ALIASNAME wurde $EVENT'"); # Nachricht über Pushover
}
}

### TÜRKONTAKTE-Sabotagealarm

sub Kontakt_Sabotage($$) {
my ($EVENT, $NAME) = @_;
my $ALIASNAME = AttrVal($NAME,'alias',$NAME);
Log 1, "$ALIASNAME meldet Sabotagealarm";
fhem("set teleBot send Alarm: $ALIASNAME meldet Sabotagealarm"); # Nachricht über Telegram
# fhem("set Infopush msg 'Alarmanlage' '$ALIASNAME meldet Sabotagealarm' '' 2 ' ' 60 600 "); # Nachricht über Pushover
}
</pre>
 

==== Hinweis zur Benutzung / Fehlerhandling ====

Der Alarm dummy hat den Zustand on:off. Die Bezeichnungen und Namen müssen 1:1 übernommen werden damit das Script funktioniert.
Andernfalls müssen die Bezeichnungen für z.B. absent:unterwegs und present:anwesend - angepasst werden.
Die Benachrichtigung kann aktuell per ''Telegram'' sowie ''Pushover'' ('''Achtung mit zweiterem sind Abokosten verbunden!''') realisiert werden.
Diskussion zum Thema im Forum unter: {{Link2Forum|Topic=64080}}
 

=== Verwendung von Collectord bei mehreren PRESENCE Installationen mit LE-Devices ===

Um zwei presence Installation zu verbinden wird der collectored Daemon von Markus Bloch benötigt.
Hierfür gibt es im Wiki auch eine kurze Erläuterung sowie die Commandref.

'''Aufbau:''' 
RPi1 (Hautpinstanz): fhem nebst presence Installation sowie collectord
RPi2 (Zweitsystem): fhem nebst presence Installation

'''Installation:''' 

auf RPi1 wird wie in der Commandref und im Wiki beschriebendas Presence Paket (https://svn.fhem.de/trac/export/HEAD/trunk/fhem/contrib/PRESENCE/deb/) heruntergeladen, installiert und konfiguriert.
Alle BT-Tags werden dann wie im Wiki beschrieben konfiguriert.

auf RPi2 wird wie in der Commandref und im Wiki beschriebendas Presence Paket (https://svn.fhem.de/trac/export/HEAD/trunk/fhem/contrib/PRESENCE/deb/) heruntergeladen, installiert und konfiguriert.
Alle BT-Tags werden dann wie im Wiki beschrieben konfiguriert.

Somit sollte auf beiden Systemen eine identische Konfiguration vorliegen.

Jetzt wird das collectord heruntergeladen und installiert:
https://svn.fhem.de/trac/export/HEAD/trunk/fhem/contrib/PRESENCE/deb/collectord-1.7.deb
<pre>
sudo apt-get install collectord-1.7.deb
</pre>

Nach der Installation befindet sich im Verzeichnis: /etc/collectord.conf die Konfigurationsdatei für das collectord.

'''Konfiguration Shell:''' 
<pre>
sudo vi /etc/collectord.conf
</pre>

Diese Datei muss jetzt nach folgender Vorlage angepasst werden.
<pre>
# room definition
#[room-name] # name of the room
#address=192.168.0.10 # ip-address or hostname
#port=5111 # tcp port which should be used (5111 is default)
#presence_timeout=120 # timeout in seconds for each check when devices are present
#absence_timeout=20 # timeout in secondsfor each check when devices are absent

[RPi1] # Name (wird als Reading room bei den BT-Tags angezeigt) der presence Instanze
address=127.0.0.1 # Lokale Adresse RPi1 , da hier das Collectord später laufen soll!
port=5111 # Port der Presence Installation
presence_timeout=60 # Selbstgewaelte Pruefintervalle
absence_timeout=60 # Selbstgewaelte Pruefintervalle

[RPi2] # Name (wird als Reading room bei den BT-Tags angezeigt) der presence Instanze
address=192.168.178.127 # IP-Adresse der Instanz, wo nur das Presence laueft, also RPi2
port=5111 # Port der Presence Installation
presence_timeout=60 # Selbstgewaelte Pruefintervalle
absence_timeout=60 # Selbstgewaelte Pruefintervalle
</pre>

Hinweis: Es dürfen keine [Namen] mit Leerzeichen verwendet werden.

'''Konfiguration FHEM:''' 
RPi1
define Gtag PRESENCE lan-bluetooth XX:XX:XX:XX:XX:XX 127.0.0.1:5222 60
Hinweis: Der Port ist der, des Collectord!! Also hier, Standard 5222
 
RPi2
define Gtag PRESENCE lan-bluetooth XX:XX:XX:XX:XX:XX 192.168.178.27:5222 60
Hinweis: Der Port ist der, des Collectord!! Also hier, Standard 5222 die IP-Adresse von RPi1

Nach der Konfiguration kann der Daemon gestartet werden. Um eine visuelle Log-Ausgabe mit dem Aufruf:
<pre>
sudo /usr/bin/perl /usr/sbin/collectord -vv -c /etc/collectord.conf
</pre>
<pre>
2017-04-02 17:52:55 - =================================================
2017-04-02 17:52:55 - started with PID 15554
2017-04-02 17:52:55 - reading configuration file
2017-04-02 17:52:55 - no config errors found
2017-04-02 17:52:55 - forked with PID 15556
2017-04-02 17:52:56 - created socket on 0.0.0.0 with port 5111
2017-04-02 17:53:20 - new connection from 127.0.0.1:48656
2017-04-02 17:53:20 - created thread 1 for processing device 7C:2F:80:E1:14:31 in room RPi2 for peer 127.0.0.1 (UUID: d0beb79dd4771532eb5e207c7bf31788)
2017-04-02 17:53:20 - created thread 2 for processing device 7C:2F:80:E1:14:31 in room RPi1 for peer 127.0.0.1 (UUID: d0beb79dd4771532eb5e207c7bf31788)
2017-04-02 17:53:20 - new connection from 127.0.0.1:48662
2017-04-02 17:53:20 - new connection from 127.0.0.1:48664
2017-04-02 17:53:20 - created thread 3 for processing device 7C:2F:80:ED:BC:F7 in room RPi2 for peer 127.0.0.1 (UUID: 7495a112063d5db45e6335d3fe305e36)
2017-04-02 17:53:20 - created thread 4 for processing device 7C:2F:80:ED:BC:F7 in room RPi1 for peer 127.0.0.1 (UUID: 7495a112063d5db45e6335d3fe305e36)
2017-04-02 17:53:20 - created thread 5 for processing device 7C:2F:80:E1:2A:4D in room RPi2 for peer 127.0.0.1 (UUID: c228f8d4d33b06787f995c7903c02760)
2017-04-02 17:53:20 - created thread 6 for processing device 7C:2F:80:E1:2A:4D in room RPi1 for peer 127.0.0.1 (UUID: c228f8d4d33b06787f995c7903c02760)
2017-04-02 17:53:22 - new connection from 192.168.xxx.xxx:51638
2017-04-02 17:53:22 - created thread 7 for processing device 7C:2F:80:E1:14:31 in room RPi2 for peer 192.168.xxx.xxx (UUID: 5db7012e709d6dc2fcd8159fc0344e40)
2017-04-02 17:53:22 - created thread 8 for processing device 7C:2F:80:E1:14:31 in room RPi1 for peer 192.168.xxx.xxx (UUID: 5db7012e709d6dc2fcd8159fc0344e40)
2017-04-02 17:53:22 - new connection from 192.168.xxx.xxx:51640
2017-04-02 17:53:22 - created thread 9 for processing device 7C:2F:80:ED:BC:F7 in room RPi2 for peer 192.168.xxx.xxx (UUID: c4b4d7c654132cf88e8c1fec3a956d3d)
2017-04-02 17:53:23 - created thread 10 for processing device 7C:2F:80:ED:BC:F7 in room RPi1 for peer 192.168.xxx.xxx (UUID: c4b4d7c654132cf88e8c1fec3a956d3d)
2017-04-02 17:53:29 - new connection from 192.168.xxx.xxx:51642
2017-04-02 17:53:29 - created thread 11 for processing device 7C:2F:80:E1:2A:4D in room RPi2 for peer 192.168.xxx.xxx (UUID: ecd7081e5ae3a0d8e735c8750cb116a1)
2017-04-02 17:53:29 - created thread 12 for processing device 7C:2F:80:E1:2A:4D in room RPi1 for peer 192.168.xxx.xxx (UUID: ecd7081e5ae3a0d8e735c8750cb116a1)
</pre>

Wenn das Log wie oben abgebildet aussieht wurde alles richtig gemacht und unter dem Device in fhem erscheint ein neues Reading "rooms" mit dem Wert der Erkannten PRESENCE Installation.

'''Automatischer Start:''' 
Wenn das Collectord per .deb Paket installiert wurde, startet es automatisch bei einem Reboot mit.
Manuell Starten als Daemon mit:
<pre>
sudo /usr/bin/perl /usr/sbin/collectord -c /etc/collectord.conf -d -v -l /var/log/collectord.log
</pre>

=== Problemlösungen ===
Falls es '''Probleme beim Starten des Skripts''' gibt bzw. man das Skript ohne Reboot des Systems neustarten möchte, kann man dies per kill Befehl erledigen.
<source lang="bash">
ps -ef | grep lepresenced
sudo kill <pid>
</source>

Debuglevel lepresenced setzen:
{{Randnotiz|RNText=Um Debug-Meldungen zu bekommen (Vorsicht bei SD-Karten-Systemen wie dem RPi) - Hierbei werden die Schreibzyklen auf die SD-Karte erhöht.}}

Der Log Level muss im lepresenced-Skript selbst verändert werden. Um den Log-Level auf INFO/WARNING/DEBUG zu setzen, dass Skript lepresenced mit einem Editor öffnen und die Stellen, wo LOG_WARNING zu finden sind durch den nötigen LOG-Eintrag ersetzen.

<pre>
lepresenced --loglevel LOG_DEBUG
</pre>
Nur das wichtigste Loggen:
<pre>
lepresenced --loglevel LOG_WARNING
</pre>
Keinerlei LOG-Einträge
<pre>
lepresenced --loglevel LOG_EMERG
</pre>

Bei '''Problemen mit der Batterieüberwachung''' der Tags kann die Pi Firmeware mit folgenden Befehl auf eine ältere Version zurückgesetzt werden.
Fehlermeldung beim Aufruf des lebattery oder anderen Batterietestskripten:
<pre>connect: Connection refused (111)</pre>

Lösung (vorübergehend)
<pre>
sudo rpi-update 8521fd34c8f66b6d109acce943f6e25ec93ec005
</pre>

Mehr dazu unter: {{Link2Forum|Topic=56960|Message=589165}}

'''Das BT-Device ist ständig "absent"''' 
Eine Mögliche Lösung kann sein, dass Paket bluez-hcidump zu installieren. Das Werkzeug hcidump erlaubt die Beobachtung von Bluetooth-Aktivität.
Dies ist nicht notwendig, wenn bereits bluez installiert ist, da dies Teil des bluez Paketes ist
<pre>
sudo apt-get install bluez-hcidump
</pre>

'''Fehler in Logdateien /var/log/syslog und /var/log/kernel'''
Jul 29 15:08:11 raspberrypi kernel: [ 4905.634211] bt_err_ratelimited: 1 callbacks suppressed
Jul 29 15:08:11 raspberrypi kernel: [ 4905.634231] Bluetooth: hci0 advertising data length corrected
Jul 29 15:08:12 raspberrypi kernel: [ 4906.647350] Bluetooth: hci0 advertising data length corrected
Jul 29 15:08:13 raspberrypi kernel: [ 4907.532081] Bluetooth: hci0 advertising data length corrected
Jul 29 15:08:13 raspberrypi kernel: [ 4907.655564] Bluetooth: hci0 advertising data length corrected

Die Ursache des Problems ist noch nicht ergründet, allerdings betrifft dies aktuell nur den RPi3. Die Fehlermeldungen werden in verschiedene log's geschrieben. Darunter maßgeblich "syslog" und "kern.log".

Lösung (vorübergehend)
Unterbinden der Einträge durch Anlage eines blocklist Eintrag:

1. Unter "/etc/rsyslog.d" eine Datei erzeugen mit dem Namen "01-blocklist.conf"
2. Inhalt: (Die Ausdrücke in den "" sind diejenigen, die aus dem log verschwinden sollen. - bei mir waren es die unten stehenden")
:msg,contains,"Bluetooth: hci0 advertising data length corrected" ~
:msg,contains,"bt_err_ratelimited:" ~
3. Dienst neu starten "sudo service rsyslog restart"

Weiter Infos werden im offiziellen Thema [[https://forum.fhem.de/index.php/topic,28753.msg499184/topicseen.html#msg499184]] diskutiert.

==== Ansprechpartner ====
# {{Link2FU|5068|PatrikR}} (Patrick) für lepresenced
# [[Benutzer Diskussion:Devender|Devender]] ({{Link2FU|20043|Dirk}}) für Wiki und Doku

[[Kategorie:Code Snippets]]
[[Kategorie:Glossary]]

AMAD

2017-05-26T09:29:54Z

CoolTux:

{{Infobox Modul
|ModPurpose=Steuern von Adroidgeräten und Anzeige von bestimmten Informationen dieser Geräte
|ModType=d
|ModForumArea=Sonstige Systeme
|ModTechName=74_AMAD.pm
|ModOwner=CoolTux ([http://forum.fhem.de/index.php?action=profile;u=13684 Forum] / [[Benutzer:CoolTux|Wiki]])
}}

==Vorwort==
===Warum AMAD2===
Bei der Entwicklung der ersten Version von AMAD musste ich auf Grund meines damaligen Wissenstandes ein einfaches Konzept zum Erhalt von Daten wählen. Hierfür wählte ich das Prinzip des pullens. Die Daten wurden alle 3 min vom Gerät angefordert.
Mit AMAD ab Version 2.0, also der 2. Version von AMAD werden die Daten nun vom Androidgerät selbst nach FHEM gepusht. So kommen Statusänderungen quasi in Echtzeit als Reading ins Device.

==Vorstellung==
Dieses Modul liefert, '''in Verbindung mit der Android APP Automagic''', diverse Informationen von Android Geräten.
Die AndroidAPP Automagic (welche nicht von mir stammt und 2.90 Euro kostet) funktioniert wie Tasker, ist aber bei weitem User freundlicher.

== Features / Funktionen ==
Im Auslieferiungszustand werden folgende Zustände dargestellt:
* installierte Android Version
* Zustand von Automagic auf dem Gerät
* Spracheingabe
* Bluetooth An/Aus
* Zustand einer definierten App (läuft aktiv im Vordergrund oder nicht?)
* verbundene Bluetoothgeräte, inklusive deren MAC Adresse
* aktuell abgespieltes Musikalbum des verwendeten Mediaplayers
* aktuell abgespielter Musikinterpret des verwendeten Mediaplayers
* aktuell abgespielter Musiktitel des verwendeten Mediaplayers
* Status des Androidgerätes - Online/Offline
* nächster Alarmtag
* nächste Alarmzeit
* Batteriestatus in %
* Ladestatus - Netztei angeschlossen / nicht angeschlossen
* Bildschirmstatus An/Aus
* Bildschirmhelligkeit
* Vollbildmodus An/Aus
* Bildschirmausrichtung Auto/Landscape/Portrait
* Standardlautstärke
* Media Lautstärke
* ...

Mit etwas Einarbeitung können jegliche Informationen welche Automagic bereit stellt, in FHEM angezeigt werden. Hierzu bedarf es lediglich eines eigenen Flows welcher seine Daten an die AMADCommBridge sendet. Das Modul gibt auch die Möglichkeit Androidgeräte zu steuern.

Das Modul gibt Dir auch die Möglichkeit Deine Androidgeräte zu steuern. So können folgende Aktionen durchgeführt werden:
* Bluetooth Ein/Aus schalten
* zu einem bestimmten Bluetoothgerät wechseln/verbinden
* Status des Gerätes (Online,Offline)
* Mediaplayer steuern (Play, Stop, nächster Titel, vorheriger Titel)
* nächste Alarmzeit setzen
* ein Benachrichtigungston abspielen (Notificationsound)
* eine App auf dem Gerät öffnen
* eine URL im Browser öffnen
* Bildschirm An/Aus machen
* Bildschirmhelligkeit einstellen
* Vollbildmodus einschalten
* eine Nachricht senden welche am Bildschirm angezeigt wird
* Bildschirmausrichtung einstellen (Auto,Landscape,Portrait)
* neuen Statusreport des Gerätes anfordern
* Systembefehle setzen (Reboot)
* eine Nachricht senden welche angesagt wird (TTS)
* Medienlautstärke regeln
* ...

== Hinweise zum Betrieb mit FHEM ==
Für all diese Aktionen und Informationen wird auf dem Androidgerät die App Automagic und ein so genannter Flow benötigt. Automagic Premium könnt Ihr Euch aus dem App Store installieren wohingegen die Flows im Ordner $FHEMINSTALL/FHEM/lib/ unter dem Dateinamen 74_AMADautomagicFlowset''$VERSION''.xml zu finden sind, wobei ''$VERSION'' die höchste sein sollte. Diese Datei müsst ihr auf das Gerät kopieren (Ort ist nicht entscheidend, nach dem Import kann die Datei theoretisch gelöscht werden).

== AutomagicApp Anweisung ==
* installiert die App
* importiert das Flowset 74_AMADautomagicFlowset$VERSION.xml aus dem Ordner $INSTALLFHEM/FHEM/lib/ auf Eurem Androidgerät (Menü -> Verwalten -> Flows importierten). '''Wichtig: ''' Die Flows dürfen noch nicht aktiviert werden!

==Definition in FHEM==
<code>define <name> AMAD <IP-ADRESSE></code>

'''!!! Wichtig - Es dürfen ausschließlich nur IP Adressen verwendet werden, keine FQDN !!!'''

'''Beispiel:'''

<code>define WandTabletWohnzimmer AMAD 192.168.0.23</code>

Die Anweisung im Beispiel erstellt zwei neue AMAD-Devices im Raum AMAD:
* "WandTabletWohnzimmer", wobei der Parameter <IP-ADRESSE> die IP Adresse des Android Gerätes festlegt. !!!Comming Soon!!! Wer den Port ändern möchte, kann dies über das Attribut "port" tun. Ihr solltet aber wissen was Ihr tut, da dieser Port im HTTP Request Trigger der beiden Flows eingestellt ist. Demzufolge muß der Port dort auch geändert werden.
* "AMADCommBridge", welches als Kommunikationsbrücke vom Androidgerät zu FHEM dient. Wenn notwendig kann der Port für die Bridge ohne Probleme im Bridge Device mittels dem Attribut "port" verändert werden.

===AMAD Communication Bridge===
Beim ersten anlegen einer AMAD Deviceinstanz wird, wie angesprochen, automatisch ein Gerät Namens AMADCommBridge im Raum AMAD angelegt. Dieses Gerät dient zur Kommunikation vom Androidgerät zu FHEM ohne das zuvor eine Anfrage von FHEM aus ging. Damit das Androidgerät die IP von FHEM kennt, '''muss''' diese sofort nach dem anlegen der Bridge über den set Befehl in ein entsprechendes Reading in die Bridge geschrieben werden. '''DAS IST SUPER WICHTIG UND FÜR DIE FUNKTION DER BRIDGE NOTWENDIG.'''
Bitte führt hierzu folgenden Befehl aus:
<code>set AMADCommBridge fhemServerIP <FHEM-IP></code>

Als zweites Reading könnt ihr ''expertMode'' setzen. Mit diesem Reading wird eine unmittelbare Kommunikation vom Gerät zu FHEM erreicht ohne die Einschränkung, über ein Notify gehen zu müssen und nur reine set Befehle ausführen zu können.

=== Aktivierung ===
Nach der erfolgreichen Konfiguration des FHEM Moduls und der Automagic App können nun die Flows auf dem Gerät aktiviert werden.

Sofern die Geräteinstanz korrekt angelegt wurde und die fhemServerIP in der CommBridge gesetzt wurde, sollten nach spätestens 15 Sekunden bereits die ersten Readings reinkommen. Nun wird alle 15 Sekunden probiert einen Status Request erfolgreich ab zu schließen. Wenn der Status sich über einen längeren Zeitraum nicht auf "activ" ändert, sollte man im Log nach eventuellen Fehlern suchen.

Es gibt die Möglichkeit einer Abfrage des Status jeglicher Geräte in FHEM über das Androidgerät und Auswertung auf dem Androidgerät.

'''Beispiel:'''
Erstelle einen Flow mit einer HTTP Request Aktion mit folgendem Inhalt:

<code>
URL
http://{global_fhemip}:8090

REQUEST METHODE
POST

CONTENT TYP
Genereller Text
text/plain

DATEN
(hier kommen die drei Werte für ein ReadingsVal Aufruf rein, getrennt durch Leerzeichen)
TempFeuchtSensorSchlafzimmer temperature 300

(haken)Setze eigenen Header
FHEMDEVICE: {global_fhemdevice}
FHEMCMD: readingsval

SPEICHERE ANTWORT ...
Variable

VARIABLE
response
</code>

Du erhältst dann den Rückgabewert in der Response-Variablen. Diesen kannst Du dann innerhalb Deines Flows weiter verarbeiten z.B. in einem Text für eine Ansage.

==Readings==
* airplanemode - Status des Flugmodus
* androidVersion - aktuell installierte Androidversion
* automagicState - Statusmeldungen von der AutomagicApp '''(Voraussetzung Android >4.3). Wer ein Android >4.3 hat und im Reading steht "wird nicht unterstützt", muß in den Androideinstellungen unter Ton und Benachrichtigungen -> Benachrichtigungszugriff ein Haken setzen für Automagic'''
* bluetooth on/off - ist auf dem Gerät Bluetooth an oder aus
* checkActiveTask - Zustand einer zuvor definierten APP. 0=nicht aktiv oder nicht aktiv im Vordergrund, 1=aktiv im Vordergrund, '''siehe Hinweis unten'''
* connectedBTdevices - eine Liste der verbundenen Gerät
* connectedBTdevicesMAC - eine Liste der MAC Adressen aller verbundender BT Geräte
* currentMusicAlbum - aktuell abgespieltes Musikalbum des verwendeten Mediaplayers
* currentMusicApp - aktuell verwendeter Mediaplayers
* currentMusicArtist - aktuell abgespielter Musikinterpret des verwendeten Mediaplayers
* currentMusicTrack - aktuell abgespielter Musiktitel des verwendeten Mediaplayers
* daydream - on/off Daydream gestartet oder nicht
* deviceState - Status des Androidgerätes / unknown, online, offline
* doNotDisturb - aktueller Status des nicht stören Modus
* dockingState - undocked/docked Status ob das Gerät in einer Dockinstation ist oder nicht.
* flow_SetCommands - active/inactive, gibt den Status des SetCommands Flow wieder
* flow_informations - active/inactive, gibt den Status des Informations Flow wieder
* flowsetVersionAtDevice - aktuell installiertes Flowset auf dem Device
* intentRadioName - zu letzt eingestellter Intent Radio Name
* intentRadioState - Status des IntentRadio Players
* keyguardSet - 0/1 Displaysperre gesetzt 0=nein 1=ja, bedeutet nicht das sie gerade aktiv ist
* lastSetCommandError - letzte Fehlermeldung vom set Befehl
* lastSetCommandState - letzter Status vom set Befehl, Befehl erfolgreich/nicht erfolgreich gesendet
* lastStatusRequestError - letzte Fehlermeldung vom statusRequest Befehl
* lastStatusRequestState - letzter Status vom statusRequest Befehl, Befehl erfolgreich/nicht erfolgreich gesendet
* nextAlarmDay - aktiver Alarmtag
* nextAlarmState - aktueller Status des Androidinternen Weckers
* nextAlarmTime - aktive Alarmzeit
* powerLevel - Status der Batterie in %
* powerPlugged - Netzteil angeschlossen? 0=NEIN, 1|2=JA
* screen - on locked/unlocked, off locked/unlocked zeigt an ob der Bildschirm an oder aus ist und gleichzeitig gesperrt oder nicht gesperrt
* screenBrightness - Bildschirmhelligkeit von 0-255
* screenFullscreen - Vollbildmodus (On,Off)
* screenOrientation - (Landscape,Portrait) Bildschirmausrichtung
* screenOrientationMode - (auto, manual) Modus für die Ausrichtung
* state - aktueller Status des Devices
* volume - Media Lautstärkewert
* volumeNotification - Benachrichtigungs Lautstärke

Beim Reading checkActivTask muß zuvor der Packagename der zu prüfenden App als Attribut checkActiveTask angegeben werden. Beispiel: attr Nexus10Wohnzimmer checkActiveTask com.android.chrome für den Chrome Browser.

==Befehle==

===Set===
* activateVoiceInput - schaltet die Spracheingabe ein
* bluetooth - Schaltet Bluetooth on/off
* clearNotificationBar - (All,Automagic) löscht alle Meldungen oder nur die Automagic Meldungen in der Statusleiste
* currentFlowsetUpdate - fürt ein Flowset Update auf dem Device aus
* deviceState - setzt den Device Status Online/Offline. Siehe Readings
* installFlowSource - installiert einen Flow auf dem Device, das XML File muss unter /tmp/ liegen und die Endung xml haben. '''Bsp:''' set TabletWohnzimmer installFlowSource WlanUebwerwachen.xml
* doNotDisturb - schaltet den nicht stören Modus, always immer Stören, never niemals stören, alarmClockOnly nur Wecker darf stören, onlyImportant nur wichtige Störungen
* mediaPlayer - steuert den Standard Mediaplayer. play, stop, Titel zürück, Titel vor.
* nextAlarmTime - setzt die Alarmzeit. Geht aber nur innerhalb der nächsten 24Std.
* notifySndFile - spielt die angegebende Mediadatei auf dem Androidgerät ab. '''Die aufzurufende Mediadatei muß sich im Ordner /storage/emulated/0/Notifications/ befinden.'''
* screenBrightness - setzt die Bildschirmhelligkeit, von 0-255.
* screenMsg - versendet eine Bildschirmnachricht
* sendintent - sendet einen Intentstring Bsp: set $AMADDEVICE sendIntent org.smblott.intentradio.PLAY url http://stream.klassikradio.de/live/mp3-192/stream.klassikradio.de/play.m3u name Klassikradio, der erste Befehl ist die Aktion un der zweite das Extra. Es können immer zwei Extras mitgegeben werden.
* statusRequest - Fordert einen neuen Statusreport beim Device an. Es können nicht von allen Readings per statusRequest die Daten geholt werden. Einige wenige geben nur bei Statusänderung ihren Status wieder.
* timer - setzt einen Timer innerhalb der als Standard definierten ClockAPP auf dem Device. Es können nur Sekunden angegeben werden.
* ttsMsg - versendet eine Nachricht welche als Sprachnachricht ausgegeben wird
* vibrate - lässt das Androidgerät vibrieren
* volume - setzt die Medialautstärke. Entweder die internen Lautsprecher oder sofern angeschlossen die Bluetoothlautsprecher und per Klinkenstecker angeschlossenen Lautsprecher, + oder - vor dem Wert reduziert die aktuelle Lautstärke um den Wert
* volumeNotification - setzt die Benachrichtigungslautstärke.

===Set abhängig von gesetzten Attributen===
* changetoBtDevice - wechselt zu einem anderen Bluetooth Gerät. '''Attribut setBluetoothDevice muß gesetzt sein. Siehe Hinweis unten!'''
* openApp - öffnet eine ausgewählte App. '''Attribut setOpenApp'''
* openURL - öffnet eine URL im Standardbrowser, sofern kein anderer Browser über das Attribut setOpenUrlBrowser ausgewählt wurde. '''Bsp:''' ''attr Tablet setOpenUrlBrowser de.ozerov.fully|de.ozerov.fully.MainActivity'', das erste ist der Package Name und das zweite der Class Name
* screen - on/off/lock/unlock schaltet den Bildschirm ein/aus oder sperrt/entsperrt ihn, in den Automagic Einstellungen muss "Admin Funktion" gesetzt werden sonst funktioniert "Screen off" nicht. '''Attribut setScreenOnForTimer''' ändert die Zeit wie lange das Display an bleiben soll!
* screenFullscreen - Schaltet den Vollbildmodus on/off. '''Attribut setFullscreen'''
* screenLock - Sperrt den Bildschirm mit Pinabfrage. '''Attribut setScreenlockPIN''' - hier die Pin dafür eingeben. Erlaubt sind nur Zahlen. Es müßen mindestens 4 bis max 16 Zeichen sein.
* screenOrientation - Schaltet die Bildschirmausrichtung Auto/Landscape/Portait. '''Attribut setScreenOrientation'''
* setAPSSID - setzt die Acces Point SSID um WLAN Sleeps zu verhindern'''
* setTtsMsgSpeed - setzt die Sprachgeschwindigkeit bei der Sprachausgabe '''(Werte zwischen 0.5 bis 4.0 in 0.5er Schritten) default ist 1.0'''
* setTtsMsgLang - setzt die Sprache der Sprachausgabe, (de-Deutsch - en Englisch) default ist de'''
* system - setzt Systembefehle ab (nur bei gerootetet Geräen). reboot,shutdown,airplanemodeON (kann nur aktiviert werden) '''Attribut root''', in den Automagic Einstellungen muss "Root Funktion" gesetzt werden
* setNotifySndFilePath - setzt den korrekten Systempfad zur Notifydatei '''(default ist /storage/emulated/0/Notifications/'''

Um openApp verwenden zu können, muss als Attribut der Package Name der App angegeben werden.

Um zwischen Bluetoothgeräten wechseln zu können, muß das Attribut setBluetoothDevice mit folgender Syntax gesetzt werden. ''attr <DEVICE> BTdeviceName1|MAC,BTDeviceName2|MAC'' Es muss zwingend darauf geachtet werden das beim BTdeviceName kein Leerzeichen vorhanden ist. Am besten zusammen oder mit Unterstrich. Achtet bei der MAC darauf das Ihr wirklich nach jeder zweiten Zahl auch einen : drin habt '''Beispiel:''' ''attr Nexus10Wohnzimmer setBluetoothDevice Logitech_BT_Adapter|AB:12:CD:34:EF:32,Anker_A3565|GH:56:IJ:78:KL:76''

==STATE==
* initialized - Ist der Status kurz nach einem define..
* active - die Geräteinstanz ist im aktiven Status.
* disabled - die Geräteinstanz wurde über das Attribut disable deaktiviert

==deviceState==
* online - Das Gerät ist online und kann set Befehle entgegennehmen.
* offline - Ein Gerät wird in den folgenden 3 Szenarien in den Status offline gesetzt:
** Das Gerät wird mittels shutdown über FHEM runtergefahren.
** Der Airplainmod (Flugmodus) wird über FHEM aktiviert.
** Es wurde mehr als 5 mal ein statusRequest erfolglos und mehr als 3 mal ein set Command erfolglos abgeschickt.
Es bleibt also dem User überlassen das Gerät nach erneuter Verfügbarkeit wieder in den Status online zu setzen. Das kann z.B. über das Presence Modul erzeugt werden (set DEVICE deviceState online)

==Anwendungsbeispiele==
=== Lademanagement ===
Ich habe die Ladegeräte für meine Androidgeräte an Funkschaltsteckdosen. ein DOIF schaltet bei unter 30% die Steckdose ein und bei über 90% wieder aus.

Hier mal ein einfaches DOIF Beispiel für ein Lademanagment

<code>
... DOIF ([Nexus5Handy:powerLevel] < 30) (set LadenetzteilNexus5Handy:FILTER=STATE=off on) DOELSEIF ([Nexus5Handy:powerLevel] > 90) (set LadenetzteilNexus5Handy:FILTER=STATE=on off) DOELSE
</code>

=== Wecker ===
Morgens lasse ich mich über mein Tablet im Schlafzimmer mit Musik wecken. Verwendet wird hierzu der wakeuptimer des RESIDENTS Modules. Das abspielen stoppe ich dann von Hand. Danach erfolgt noch eine Ansage wie das Wetter gerade ist und wird.

=== Mediacenter ===
Mein 10" Tablet im Wohnzimmer ist Mediaplayer für das Wohnzimmer mit Bluetoothlautsprechern. Die Lautstärke wird automatisch runter gesetzt wenn die Fritzbox einen Anruf auf das Wohnzimmer Handgerät signalisiert.

=== Sprachbefehl - Abfragen von Zuständen diverser Sensoren ===
Wenn ich die Spracheingabe aktiviere und nach der Temperatur im Wohnzimmer frage, bekomme ich diese angesagt.

Der Teil im Feld Daten ist ein klassisches RadingsVal, halt nur ohne Komma und ohne Anführungszeichen

WIRD GERADE ÜBERARBEITET

=== Schaltbefehle vom Androidgerät an FHEM senden ===
Hierfür richte bitte einen eigen Flow ein. Wie das genau geht, verrät Dir die Hilfe.
Um einen Schaltbefehl für FHEM zu erstellen, folgt nach dem Trigger eine Aktion als Script (Aktion Type: Script). Hier trägst Du folgendes ein

setcmd = "LichtWohnzimmerLampeRechts on"

fhemcmd = "set"

In der ersten Zeile wird also der Schaltbefehl in der Variablem setcmd eingetragen und in der zweiten Zeile der FHEM Befehl in der Variablen fhemcmd.

Danach müsst Ihr nur noch in einer weiteren Aktion den Flow "Send Data to AMADCommBridge" ausführen (Aktion Type: Flows ausführen). Die Aktion sollte bereits in Eurer Liste Vorhanden sein.

[[Datei:Screenshot_20160717-134948.png|200px]]
[[Datei:Screenshot 17.07.2016 1-50-27.png|200px]]

Nun sollte Lampe1 angeschalten werden wenn der Flow ausgeführt wird.

== Bekannte Meldungen/Hinweise/Probleme ==
<code>PERL WARNING: Use of uninitialized value in hash element at /opt/fhem/FHEM/74_AMAD.pm line 14X</code>
Ist ab Version 2.2.2 gefixt. {{Link2Forum|Topic=54433|LinkText=Dickes Danke an Andy(gandy)}}

Wenn auf dem Android-Gerät die Fehlermeldung 'Accessibility service not running' von Automagic kommt, oder im FHEM das reading state 'Flow Informations mit Fehler beendet' steht, dann muss der Accessibility Service auf dem Android-Device aktiviert werden: Einstellungen --> Bedienungshilfen --> Automagic Premium. Hier muss der Schalter auf 'an' stehen. Sollte dies der Fall sein, hilft u.U. ein kurzes Aus- und wieder Einschalten.

Gerät wird oft als offline angezeigt und es können keine set Befehle abgesetzt werden.
Mit der AMAD Version 2.2 hielt eine neue Behandlung des deviceState Readings Einzug. Das Reading stellt nun den tatsächlichen Status des Gerätes gegenüber FHEM da. Bei vielen Android 6 Geräten kommt es aber auf Grund vom DeepSleep Modus zum wegfall der WLAN Verbindung. Hier hilft die neue KeepAlive Funktion in AMAD. Dafür muß lediglich unter
* Einstellungen --> Akku --> oben auf die drei Punkte - Akku Leistungsoptimierung --> alle Apps und dann Automagic auswählen und "Nicht optimieren"
ausgewählt werden. Alles andere macht das Modul selbst.

HOMBOT

2017-05-26T09:28:16Z

CoolTux:

{{Infobox Modul
|ModPurpose=Steuern von LG Hombot Staubsaugerrobotern und Anzeige von Status Informationen
|ModType=d
|ModForumArea=Sonstige Systeme
|ModTechName=74_HOMBOT.pm
|ModOwner=CoolTux ({{Link2Forum|Topic=44923|LinkText=Forum}} / [[Benutzer:CoolTux|Wiki]])
}}

Dieses Modul gibt Euch die Möglichkeit Euren Hombot [http://www.roboter-forum.com/showthread.php?10009-LG-Hombot-3-0-WLAN-amp-Kamera-Steuerung-per-Weboberfl%E4che nach erfolgreichen Hack] in FHEM ein zu binden. Voraussetzung ist das Ihr den Hombot Hack gemacht und einen WLAN Stick eingebaut habt. Als Schnittstelle zwischen FHEM und Bot wird der Luigi HTTP Server verwendet. Was genau könnt Ihr nun mit dem Modul machen:

== Features / Funktionen ==
* Readings über den Status des Hombots werden angelegt
* Auswahl des Reinigungsmodus ist möglich
* Starten der Reinigung
* Beenden der Reinigung
* zurück zur Homebase schicken
* Namen vergeben
* Wochenprogramm einstellen
* Repeat und Turbo aktivieren
* Kamerabild

== !!! Voraussetzungen schaffen !!! ==
Ihr benötigt zum verwenden des Modules die Programme '''ssh''' und '''sshpass'''. Desweiteren muß im Homeverzeichnis des fhem Users das Verzeichniss .ssh existieren und darin die Datei '''known_hosts'''. Diese sollte eine Passphrass des Bots beinhalten. Am besten Ihr macht als normaler User eine ssh Session zum Bot und kopiert danach die known_hosts Eures normalen Users in das .ssh Verzeichnis des fhem Users. Rechte anpassen nicht vergessen.

== Definition ==
<code>define <name> HOMBOT <IP-ADRESSE></code>

'''Beispiel:'''

<code>define Roberta HOMBOT 192.168.0.23</code>

Diese Anweisung erstellt ein neues HOMBOT-Device im Raum HOMBOT. Der Parameter <IP-ADRESSE> legt die IP Adresse des LG Hombot fest.
Das Standard Abfrageinterval ist 180 Sekunden und kann über das Attribut intervall geändert werden. Das Interval ist in Abhängigkeit des Arbeitsstatus dynamisch. Im Status WORKING beträgt es z.B. 30 Sekunden.

== readings ==
* at_* - Reading für das Wochenprogramm. Startzeit für den jeweiligen Tag
* batteryPercent - Status der Batterie in %
* cleanMode - aktuell eingestellter Reinigungsmodus
* cpu_* - Informationen über die Prozessorauslastung
* currentBumping - Anzahl der Zusammenstöße mit Hindernissen
* firmware - aktuell installierte Firmwareversion
* hombotState - Status des Hombots
* lastClean - Datum und Uhrzeit der letzten Reinigung
* lastSetCommandError - letzte Fehlermeldung vom set Befehl
* lastSetCommandState - letzter Status vom set Befehl, Befehl erfolgreich/nicht erfolgreich gesendet
* lastStatusRequestError - letzte Fehlermeldung vom statusRequest Befehl
* lastStatusRequestState - letzter Status vom statusRequest Befehl, Befehl erfolgreich/nicht erfolgreich gesendet
* luigiSrvVersion - Version des Luigi HTTP Servers auf dem Hombot
* nickname - Name des Hombot
* num* - Bisher begonnene und beendete Reinigungen im entsprechenden Modus
* repeat - Reinigung wird wiederholt Ja/Nein
* state - Modulstatus
* turbo - Turbo aktiv Ja/Nein

== Befehle ==

=== set ===
* cleanMode - setzen des Reinigungsmodus (ZZ-ZickZack / SB-Cell by Cell / SPOT-Spiralreinigung
* cleanStart - Reinigung starten
* homing - Beendet die Reinigung und lässt die Bot zurück zur Bases kommen
* nickname - setzt des Bot-Namens. Wird im Reading erst nach einem neustart des Luigiservers oder des Bots sichtbar
* pause - lässt den Reinigungsproßess pausieren
* repeat - Reinigung wiederholen? (true/false)
* schedule - setzen des Wochenprogrammes Bsp. set Roberta schedule Mo=13:30 Di= Mi=14:00,ZZ Do=15:20 Fr= Sa=11:20 So= Man kann also auch den Modus mitgeben!
* statusRequest - Fordert einen neuen Statusreport beim Device an
* turbo - aktivieren des Turbomodus (true/false)

== STATE ==
* initialized - Ist der Status kurz nach einem define..
* active - die Geräteinstanz ist im aktiven Status.
* disabled - die Geräteinstanz wurde über das Attribut disable deaktiviert

== Bekannte Probleme ==
Keine

== Kameraunterstützung experimentell==
Die Unterstützung für die Kamera ist Momentan noch experimentell und ausserhalb des Modules. Es ist nicht davon aus zu gehen das die Kameraunterstützung Einzug ins Modul hält. Grund hiefür ist unter anderem das es bereits Module für Kamerasupport gibt und möglichst nichts doppelt programmiert werden soll. Daher sollte der Wunsch dahin gehen das IPCam Modul so fit zu machen das es den Bot unterstützt.

[http://www.roboter-forum.com/showthread.php?6415-Hom-Bot-3-0-Hacking&p=138428&viewfull=1#post138428 Ab Version v2.34 des Hombot Hacking Packetes ist der Kamera Support integriert.]

=== Einbindung ins TabletUI ===
Damit wir über unser TabletUI das Kamerabild sehen können müssen wir zu erst das im Zipfile befindliche hombotCam.js ist js Verzeichnis von unserer TabletUI kopieren, danach öffnet Ihr das File und passt die IP in der Zeile
<code>
yuvUrl = 'http://192.168.240.249:6260/images/snapshot.yuv',
</code>
entsprechend der Bot IP Eures Bot's an.

Nun muß lediglich das html File in das entsprechende Verzeichnis bei Euch wo auch die anderen Tablet html Dateien liegen. In dieser html Datei sind lediglich ein paar Anpassungen gemacht worden.
<code>
..head>
...
..script type="text/javascript" src="/fhem/tablet/js/hombotCam.js"></script>
...
../head>
..body onload="drawSnapshot()" >
...
...data-type="label" class="darker">Roberta Livecam Stream</div>
..div id="cam"><canvas id="cam_canvas" width="320" height="240"></canvas></div>
...
</code>

Hier musste etwas geschummelt werde, da man wohl kein HTML Code ins Wiki bekommt.

Fertig das wares, nun sollte auf Euer TabletUI Oberfläche das Kamerabild zu sehen sein.

Link zum [https://drive.google.com/file/d/0B9QFkuMrbcG_VkQ5aW84UGo0Uk0/view?usp=sharing ZipFile]

LGTV WebOS

2017-04-04T12:34:11Z

CoolTux:

<div style="float:right">
{{Infobox Modul
|ModPurpose=Steuern und Abfragen eines LGTV Gerätes mit WebOS
|ModType=d
|ModCmdRef=LGTV_WebOS
|ModForumArea=Multimedia
|ModTechName=82_LGTV_WebOS.pm
|ModOwner=CoolTux ({{Link2FU|13684|Forum}} / [[Benutzer:CoolTux|Wiki]])
}}
</div>

==LGTV_WebOS==

Dieses Modul steuert SmartTV's des Herstellers LG mit dem Betriebssystem WebOS über die Netzwerkschnittstelle. Es bietet die Möglichkeit den aktuellen TV Kanal zu steuern, sowie Apps zu starten, Fernbedienungsbefehle zu senden, sowie den aktuellen Status abzufragen.

===Definition===
<code>define <name> LGTV_WebOS <IP-Addresse></code>

Bei der Definition eines LGTV_WebOS-Moduls wird eine interne Routine in Gang gesetzt, welche regelmäßig alle 15s den Status des TV abfragt und entsprechende Notify-/FileLog-Definitionen triggert.

'''Beispiel:'''

<code>define TV LGTV_WebOS 192.168.0.10</code>

===Readings===
* 3D - Status des 3D-Wiedergabemodus ("on" => 3D Wiedergabemodus aktiv, "off" => 3D Wiedergabemodus nicht aktiv)
* 3DMode - Anzeigemodus (2d, 2dto3d, side_side_half, line_interleave_half, column_interleave, check_board)
* channel - Die Nummer des aktuellen TV-Kanals
* channelName - Der Name des aktuellen TV-Kanals
* channelMedia - Senderinformation
* channelCurrentEndTime - Ende der laufenden Sendung (Beta)
* channelCurrentStartTime - Start der laufenden Sendung (Beta)
* channelCurrentTitle - Der Name der laufenden Sendung (Beta)
* channelNextEndTime - Ende der nächsten Sendung (Beta)
* channelNextStartTime - Start der nächsten Sendung (Beta)
* channelNextTitle - Der Name der nächsten Sendung (Beta)
* extInput_<Geräteeingang> - Status der Eingangsquelle (connect_true, connect_false)
* input - Derzeit aktiver Geräteeingang
* lastResponse - Status der letzten Anfrage (ok, error <Fehlertext>)
* launchApp <Anwendung> - Gegenwärtige aktive Anwendung
* lgKey - Der Client-Key, der für die Verbindung verwendet wird
* mute on,off - Der aktuelle Stumm-Status ("on" => Stumm, "off" => Laut)
* pairing paired, unpaired - Der Status des Pairing
* presence absent, present - Der aktuelle Power-Status ("present" => eingeschaltet, "absent" => ausgeschaltet)
* state on, off - Status des Fernsehers (ähnlich presence)
* volume - Der aktuelle Lautstärkepegel -1, 0-100 (-1 invalider Wert)

===Set===
* connect - Verbindet sich zum Fernseher unter der IP wie definiert, führt beim ersten mal automatisch ein pairing durch
* pairing - Berechtigungsanfrage an den Fernseher, hier muss die Anfrage mit der Fernbedienung bestätigt werden
* screenMsg <Text> - zeigt für ca 3-5s eine Nachricht auf dem Fernseher oben rechts an
* mute on, off - Schaltet den Fernseher Stumm, je nach Anschluss des Audiosignals, muss dieses am Verstärker (AV Receiver) geschehen (siehe Volume)
* volume 0-100, Schieberegler - Setzt die Lautstärke des Fernsehers, je nach Anschluss des Audiosignals, muss dieses am Verstärker (AV Receiver) geschehen (siehe mute)
* volumeUp - Erhöht die Lautstärke um den Wert 1
* volumeDown - Verringert die Lautstärke um den Wert 1
* channelUp - Schaltet auf den nächsten Kanal um
* channelDown - Schaltet auf den vorherigen Kanal um
* getServiceList - Fragt die laufenden Dienste des Fernsehers an (derzeit noch in Beta-Phase)
* on - Schaltet den Fernseher ein, wenn WLAN oder LAN ebenfalls im Aus-Zustand aktiv ist (siehe Bedienungsanleitung da Typabhängig)
* off - Schaltet den Fernseher aus, wenn eine Connection aktiv ist
* launchApp <Anwendung> - Aktiviert eine Anwendung aus der Liste (Maxdome, AmazonVideo, YouTube, Netflix, TV, GooglePlay, Browser, Chili, TVCast, Smartshare, Scheduler, Miracast, TV), !!!Achtung: TV ist hier eine Anwendung, und kein Geräteeingang!!!
* 3D on,off - 3D Modus kann hier ein- und ausgeschaltet werden, je nach Fernseher können mehrere 3D Modi unterstützt werden (z.B. Side-by-Side, Top-Bottom)
* stop - Stop-Befehl (anwendungsabhängig)
* play - Play-Befehl (anwendungsabhängig)
* pause - Pause-Befehl (anwendungsabhängig)
* rewind - Zurückspulen-Befehl (anwendungsabhängig)
* fastForward - Schneller-Vorlauf-Befehl (anwendungsabhängig)
* clearInputList - Löscht die Liste der Geräteeingänge
* input - Wählt den Geräteeingang aus (Abhängig von Typ und angeschossenen Geräten), Beispiele: extInput_AV-1, extInput_HDMI-1, extInput_HDMI-2, extInput_HDMI-3)

===Attribute===
* disable - Optionales Attribut zur Deaktivierung des zyklischen Status-Updates. Ein manuelles Update via statusRequest-Befehl ist dennoch möglich. Mögliche Werte: 0 => zyklische Status-Updates, 1 => keine zyklischen Status-Updates.
* channelGuide - Optionales Attribut zur Deaktivierung der zyklischen Updates des TV-Guides, dieses beansprucht je nach Hardware einigen Netzwerkverkehr und Prozessorlast. Mögliche Werte: 0 => keine zyklischen TV-Guide-Updates, 1 => zyklische TV-Guide-Updates

===bekannte Probleme===
Stellt man im TV in den Einstellungen die Funktion: Quick Start (schnelleres starten des TV`s mit höherem Energieverbrauch) ein, gibt es Probleme mit dem Modul bis hin zum vollen blockieren für 5-7 Minuten.

<code>Wenn dieser eingeschalten ist und der TV ausgeschalten wird, bleibt das LG-Modul für 5 weitere Minuten im state:on. Nach den 5min hängt sich fhem für ca- 5-10min komplett auf, dann läuft fhem wieder und im LG-Modul wird stare:off angezeigt</code>

CsrfToken-HowTo

2017-03-19T22:01:32Z

CoolTux:

{{SEITENTITEL:csrfToken-HowTo}}
FHEM hat mit der Version 5.8 eine Sicherheitsmaßnahme scharfgeschaltet, den csrfToken.
Dieser Token wird bei jedem Neustart von FHEM neu gebildet.

Dieses Feature erhöht die Sicherheit, führt aber dazu, dass man nicht mehr mit einem einfachen http Link auf das [[FHEMWEB]] zugreifen kann.

==Einzeiler==

Was früher so ging:

<nowiki>http://localhost:8083/fhem?cmd=set%20Office%20on</nowiki>

muss jetzt etwas ergänzt werden. Mit dem Einzeiler

<nowiki>curl -s -D - 'http://localhost:8083/fhem?XHR=1' | awk '/X-FHEM-csrfToken/{print $2}'</nowiki>

kann man den aktuellle csrfToken aus dem Header extrahieren und muss ihn nur noch an den Aufruf anhängen.
Erste Variante:

<nowiki>curl --data-raw "fwcsrf=$(curl -s -D - 'http://localhost:8083/fhem?XHR=1' | awk '/X-FHEM-csrfToken/{print $2}')" http://localhost:8083/fhem?cmd=set%20Office%20on</nowiki>

Zweite Variante, in dieser wird cr+lf am Ende des ermittelten csrfTokens abgeschnitten:

<nowiki>curl "http://fhem.example.org:8083/fhem?cmd=set%20Office%20on?XHR=1&fwcsrf="`curl -s -D - 'http://fhem.example.org:8083/fhem?XHR=1' | awk '/X-FHEM-csrfToken/{print $2}' | tr -d "\r\n"`</nowiki>

Man kann auch in Scripten den token zunächst abspeichern:

<nowiki>token=$(curl -s -D - 'http://localhost:8083/fhem?XHR=1' | awk '/X-FHEM-csrfToken/{print $2}')
curl --data-raw "fwcsrf=$token" http://localhost:8083/fhem?cmd=set%20Office%20on</nowiki>

==API Web==
Falls man ohne den Token arbeiten will, könnte man ein eigenes API Web erstellen und den Zugriff darauf beschränken. In vorhandenen Scripten / Applikationen müsste dann lediglich der Port geändert werden.

define WEBapi FHEMWEB 8088 global
attr WEBapi csrfToken none
attr WEBapi allowFrom 192.168.178.83|127.0.0.1

Im Forum ist ganz gut beschrieben wie man die Gestaltung des regEx für die IP Adresse machen kann -> Links

==csrfToken festlegen==
Dies kann man tun, falls die dynamische Abfrage zur Laufzeit des Tokens nicht möglich ist.

attr WEB.* csrfToken <beliebige Folge aus Zeichen und Zahlen>

Damit können feste URLs verwendet werden:

<nowiki>http://localhost:8083/fhem?cmd=set%20Office%20on&fwcsrf=<fester token></nowiki>

==csrfToken abschalten==
Dies sollte man als erste Hilfe tun, aber unbedingt darüber nachdenken wie man die Applikation umstellt.

attr WEB.* csrfToken none

==Featurelevel==
Eine weitere temporäre Notfallmaßnahme wäre den Featurelevel nach dem Update einfach wieder zurückzudrehen

attr global featurelevel 5.7

==Python==
Falls mal jemand aus python (hier für python 2.7) heraus fhem ansteuern möchte

<nowiki>import sys
import urllib2
import urllib
import ssl
import urlparse
BASEURL = 'https://user:password@server_ip:8083/fhem?'
url = BASEURL + 'cmd=set+licht+on'
def get_token(url):
nurl = urlparse.urlsplit(url)
username = nurl.username
password = nurl.password
url = url.replace(username + ':' + password + '@', '')
url = url.replace(" ", "%20")
ssl._create_default_https_context = ssl._create_unverified_context
p = urllib2.HTTPPasswordMgrWithDefaultRealm()
p.add_password(None, url, username, password)
handler = urllib2.HTTPBasicAuthHandler(p)
opener = urllib2.build_opener(handler)
urllib2.install_opener(opener)
try:
uu = urllib2.urlopen(
url=url,
data=None,
timeout=10
)
token = uu.read()
token = token[token.find('csrf_'):]
token = token[:token.find("\'")]
return token
except urllib2.URLError, urllib2.URLError.reason:
print('URLError: %s' % urllib2.URLError.reason)
return False

def fire_command(url):
# type: (object) -> object
if "@" in url:
token = get_token(BASEURL)
data = {'fwcsrf': token}
data = urllib.urlencode(data)
nurl = urlparse.urlsplit(url)
username = nurl.username
password = nurl.password
url = url.replace(username + ':' + password + '@', '')
url = url.replace(" ", "%20")
ssl._create_default_https_context = ssl._create_unverified_context
p = urllib2.HTTPPasswordMgrWithDefaultRealm()
p.add_password(None, url, username, password)
handler = urllib2.HTTPBasicAuthHandler(p)
opener = urllib2.build_opener(handler)
urllib2.install_opener(opener)
try:
urllib2.urlopen(
url=url,
data=data,
timeout=10
)
except urllib2.URLError, urllib2.URLError.reason:
print('URLError: %s' % urllib2.URLError.reason)
return False</nowiki>

==Links==
* https://forum.fhem.de/index.php?topic=23994.0
* [https://de.wikipedia.org/wiki/Cross-Site-Request-Forgery Wikipedia - Cross Site Request Forgery (csrf)]

FHEMWEB

2017-03-06T13:43:41Z

CoolTux: /* Sicherheit */

{{Infobox Modul
|ModPurpose=Standard Fhem-Webfrontend
|ModType=h
|ModForumArea=Frontends
|ModTechName=01_FHEMWEB.pm
|ModOwner=Rudolf König/rudolfkoenig ({{Link2FU|8|Forum}}/[[Benutzer Diskussion:Rudolfkoenig|Wiki]])
}}

[[FHEMWEB]] ist das Standard Webfrontend von Fhem, es implementiert auch einen einfachen Webserver (optional mit Basic-Auth und HTTPS). Aus historischen Gründen wird es auch als [[PGM2]] bezeichnet.

== Voraussetzungen ==
keine.

== Anwendung ==
=== Define ===
siehe commandref.
=== Attribute ===
siehe commandref.

== Anwendungsbeispiele ==
=== devStateIcon ===
siehe [[devStateIcon]]

=== sortby ===
* Beispiele zur Sortierung mit sortby: {{Link2Forum|Topic=11940|Message=70664}}, {{Link2Forum|Topic=26733|Message=197127}}

=== title ===
* Titel der Seite. Überschreibt das globale Attribut "title", das ansonsten für alle FHEMWEB Instanzen gilt
* Beispiel für einen dynamischen Seiten-Titel: {{Link2Forum|Topic=48668|Message=403260}}

=== menuEntries ===
* [[Backup#Backup_manuell_ausf.C3.BChren_.28Weboberfl.C3.A4che.29|Backup-Befehl in FHEM-Menü einbinden]]

=== webCmd ===
siehe [[webCmd]]

=== widgetOverride ===
Mit dem Attribut <code>widgetOverride</code> kann ein anderes als das vom Modulautor vorgegebene Bedienelement für einen Parameter (set/get/Attribut) festgelegt werden. Beispiele:
* [[WifiLight#Color-Picker_aktivieren|Color-Picker]]
* [[EnOcean-FUD61NPN-Funk-Universal-Dimmaktor#Anzeige_eines_alternativen_Bedienelementes|knob]]
* usuzu (= universelle Zeitschaltuhr): {{Link2Forum|Topic=32660}}

== Sicherheit ==
=== CSRF Token ===
siehe [[srfToken-HowTo]]

=== apiWeb Instanz ===
Die apiWeb Instanz dient dazu externe Zugriffe auf das FHEM System kontrolliert zu steuern.
Im Grunde wird nichts anderes gemacht wie eine zweite FHEM Webinstanz ein zu richten, welche dann gesondert abgesichert wird.

Man legt sich hierfür eine FHEMWEB Instanz an:

<pre>
define apiWEB FHEMWEB 8088 global
attr apiWEB column Alarms: Apartment: Living: Bedroom: Kitchen: Sonos: Residents: Weather: Bathroom: Logs: Statistics: DashboardRoom: System: hidden: all:
attr apiWEB hiddenroom input,detail,save,Unsorted,Everything,CUL_HM,FS20,Commandref,style,Edit files,Select style,Logfile,Floorplans,Remote doc,FileLogs,Apartment,Bathroom,Bedroom,Kitchen,Living,Residents,System,Weather,Event monitor,NEW
attr apiWEB room hidden
attr apiWEB webname webhook
</pre>

Diese wird dann weiter mit Hilfe eines [http://fhem.de/commandref.html#allowed allowed]-Devices abgesichert, indem nur die tatsächlich benötigten Kommandos erlaubt werden und damit alle anderen nicht erlaubten (attr,define,get,set,...) automatisch nicht mehr zur Verfügung stehen:
<pre>
define allowedApiWEB allowed
attr allowedApiWEB allowedCommands set
attr allowedApiWEB allowedDevices Lampe1
attr allowedApiWEB validFor apiWEB
</pre>

Desweiteren ist dringend an zu raten, den Zugriff über TLS/SSL und HTTP Basic-Authentication weiter abzusichern. Nähere Informationen findet man hierzu in der [http://fhem.de/commandref.html#FHEMWEB Commandref] unter dem Punkt HTTPS. Letztlich fehlt noch das entsprechende Attribut:

<pre>
attr WEBhook HTTPS
</pre>

Als nächstes aktivieren wir Benutzername+Passwort für den Zugriff. Die commandref für allowed gibt auch hier unter dem Punkt basicAuth entsprechende Hinweise.

== Links ==
* Begriffserklärung zur Unterscheidung von [[eventMap]], [[devStateIcon]], [[webCmd]] und [[setList]] mit Beispielen in diesem {{Link2Forum|Topic=12080|LinkText=Forenthread}}
* [[Icons]]

[[Kategorie:FHEM Frontends]]

FHEMWEB

2017-03-06T13:14:24Z

CoolTux:

LGTV WebOS

2017-02-28T09:53:01Z

CoolTux: Die Seite wurde neu angelegt: „<div style="float:right"> {{Infobox Modul |ModPurpose=Steuern und Abfragen eines LGTV Gerätes mit WebOS |ModType=d |ModCmdRef=LGTV_WebOS |ModForumArea=Multime…“