mod-AMAD

installiert Euch die App "Automagic Premium" aus dem App Store oder die Testversion von hier
installiert das Flowset 74_AMADautomagicFlows$VERSION.xml aus dem Ordner $INSTALLFHEM/FHEM/lib/ auf Eurem Androidgerät und aktiviert erstmal nur den "Informations" Flow.

Define

define <name> AMAD <IP-ADRESSE>

define WandTabletWohnzimmer AMAD 192.168.0.23

Ihr solltet aber wissen was Ihr tut, da dieser Port im HTTP Response Trigger der beiden Flows eingestellt ist. Demzufolge muß dieser dort auch verädert werden.

Fertig! Nach anlegen der Geräteinstanz sollten nach spätestens 3 Minuten bereits die ersten Readings reinkommen.

AMAD Communication Bridge

BITTE NIEMALS DEN NAMEN DER BRIDGE ÄNDERN!!!

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.

set AMADCommBridge fhemServerIP <FHEM-IP>.

expertMode

Readings

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
currentMusicArtist - aktuell abgespielter Musikinterpret des verwendeten Mediaplayers
currentMusicTrack - aktuell abgespielter Musiktitel des verwendeten Mediaplayers
deviceState - Status des Androidgerätes, muss selbst mit setreading gesetzt werden z.B. über die Anwesenheitskontrolle.
Ist Offline gesetzt, wird der Intervall zum Informationsabruf aus gesetzt.
flow_SetCommands active/inactive - gibt den Status des SetCommands Flow wieder
flow_informations active/inactive - gibt den Status des Informations Flow wieder
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
nextAlarmTime - aktive Alarmzeit
powerLevel - Status der Batterie in %
powerPlugged - Netzteil angeschlossen? 0=NEIN, 1|2=JA
screen - Bildschirm An oderAus
screenBrightness - Bildschirmhelligkeit von 0-255
screenFullscreen - Vollbildmodus (On,Off)
screenOrientation - Bildschirmausrichtung (Auto,Landscape,Portrait)
volume - Lautstärkewert welcher über "set volume" gesetzt wurde.
volumeMusikBluetooth - Media Lautstärke von angeschlossenden Bluetooth Lautsprechern
volumeMusikSpeaker - Media Lautstärke der internen Lautsprecher

checkActiveTask

attr Nexus10Wohnzimmer checkActiveTask com.android.chrome

Eigene Readings im AMAD-Device erstellen

zunächst erstellt man sich, soweit nicht bereits geschehen, einen Automagic-Flow der die Information, die in ein Reading übernommen werden soll zur Verfügung stellt
diese Information speichert man nun mittels Automagic Action Script in eine globale Variable namens global_reading_ (beim auf Groß- und Kleinschreibung achten):


      Beispiel: Das Reading Touch soll den Wert "ja" erhalten
      Action Script: global_reading_Touch="ja"

abschließend muss noch die Übertragung des Wertes initiiert werden. Dies erfolgt, indem der Wert der Variable global_own_reading auf den Wert _ gesetzt wird (auch hier auf Groß- und Kleinschreibung achten):


	Beispiel: Das Reading Touch soll übertragen werden

	Action Script: global_own_reading="{getDate()}_Touch"

	Hinweis: man kann auch beide Aktionen in ein Script packen:
	
	  global_reading_Touch="ja";global_own_reading="{getDate()}_Touch"

Möchte man nun als nächstes z.B. eine sofortige Benachrichtigung, wenn das Display des Tablets an- oder ausgeschaltet wird, könnte man sich Flows bauen, welche beim De-/Aktivieren des Display ausgeführt werden:


	  Action Script beim Aktivieren des Displays: global_reading_Display="an";global_own_reading="{getDate()}_Display"
	  Action Script beim Deaktivieren des Displays: global_reading_Display="aus";global_own_reading="{getDate()}_Display"

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
deviceState - setzt den Device Status Online/Offline. Siehe Readings
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.
openURL - öffnet eine URL im Standardbrowser
screen - setzt den Bildschirm on/off mit Sperre, in den Automagic Einstellungen muss "Admin Funktion" gesetzt werden sonst funktioniert "Screen off" nicht.
screenMsg - versendet eine Bildschirmnachricht
statusRequest - Fordert einen neuen Statusreport beim Device an
ttsMsg - versendet eine Nachricht welche als Sprachnachricht ausgegeben wird
volume - setzt die Medialautstärke. Entweder die internen Lautsprecher oder sofern angeschlossen die Bluetoothlautsprecher

Set abhängig von gesetzten Attributen

changetoBtDevice - wechselt zu einem anderen Bluetooth Gerät. Attribut setBluetoothDevice muß gesetzt sein. Siehe Hinweis unten!
mediaPlayer - steuert den Standard Mediaplayer. play, stop, Titel zürück, Titel vor. Attribut fhemServerIP
openApp - öffnet eine ausgewählte App. Attribut setOpenApp
screenBrightness - setzt die Bildschirmhelligkeit, von 0-255 Attribut setScreenBrightness
screenFullscreen - Schaltet den Vollbildmodus on/off. Attribut setFullscreen
screenOrientation - Schaltet die Bildschirmausrichtung Auto/Landscape/Portait. Attribut setScreenOrientation
system - setzt Systembefehle ab (nur bei gerootetet Geräen). Reboot Attribut root, in den Automagic Einstellungen muss "Root Funktion" gesetzt werden

attr <DEVICE> BTdeviceName1|MAC,BTDeviceName2|MAC

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: