Pushover

2014-11-12T07:01:51Z

Dklueh: /* Senden eine Nachricht mit Fhem; '' 0 '' am Ende wurde durch :code verschluckt */

{{Infobox Modul
|ModPurpose=Senden von sogenannten Push-Nachrichten auf Tablets oder Smartphones
|ModType=d


|ModTechName=70_Pushover.pm
|ModOwner=Johannes B
}}

[[Pushover]] ist ein Dienst, mit dem es möglich ist, sogenannte "Push" Nachrichten auf ein Apple oder Android Gerät zu schicken (Link zum Dienst: [https://pushover.net pushover.net]).
Der Dienst in grundlegend kostenlos. Um die Pushnachrichten zu empfangen muss die dazu passende App installiert werden, die leider nicht kostenlos ist.
Es fallen keinen Abo gebühren an. (Stand 28.6.2014)

== Installation ==
Es muss zwingend eine Pushover Account erstellen werden. Ist der Account angelegt muss auch auf der Pushover Website eine Application angelegt werden.
Die Application dient dazu die Nachrichten FHEM zuzuweisen und sie leichter erkennbar zu machen. (hier bekommt man dann den Token)
Auf dem Endgerät muss die Applikation "pushover" installiert werden. Dies geschieht z.B. bei Apple-Geräten mit Hilfe des AppStores. Momentan kostet diese Anwendung im AppStore 4,49€.
Danach müssen (nach erfolgter Registrierung auf der Webseite) die einzelnen Geräte, auf denen Nachrichten gesendet werden sollen, registriert werden.
Die Registrierung der Geräte erfolgt nach anmelden in der App auf dem Endgerät automatisch.

* Apple Geräte: [https://itunes.apple.com/de/app/pushover-notifications/id506088175?mt=8 Pushover App im Apple Store]
* Android Geräte: [https://play.google.com/store/apps/details?id=net.superblock.pushover&hl=de Pushover App im Google Playstore]

'''Wichtig für Debian Nutzer'''
Für das Modul ist noch eine Library notwendig:
<pre>sudo apt-get install libio-socket-ssl-perl</pre>

== Einbinden des Dienstes in Fhem ==
Das Modul wird mit dem folgenden Befehl in fhem definiert:
:<code>define pushmsg Pushover <TOKEN> <USER></code>

Die Tokens werden von der Pushover Seite entnommen.
TOKEN = Api Token / Key (zu finden unter der angelegten App)
USER = Your User Key (wird direkt nach dem Einloggen benötigtet)

== Senden eine Nachricht mit Fhem ==
Syntax:
<pre>You can send messages via the following command:
# set <Pushover_device> msg <title> <msg> <device> <priority> <sound> [<retry> <expire>]
</pre>

Beispiel:
:<code>fhem("set pushmsg msg 'fhem' 'Das Fenster wurde geschlossen!' '' 0 ''");</code>

Nachricht, sobald Fhem neu geladen wurde, mit Hilfe eines "notify":
<pre>define notify_fhem_reload notify global:INITIALIZED set pushmsg msg 'fhem' 'Ich wurde neu geladen! - $EVENT' '' 0 '' </pre>

== Erinnerungsfunktion mit Hilfe des Kalendermoduls ==
Zuerst wird eine Textdatei mit den Daten für die Erinnerung im Fhem Hauptverzeichnis erzeugt. Hier das Beispiel für den Fall, dass Fhem auf einer Fritzbox läuft:

<pre>
telnet fritz.box
cd /var/media/ftp/fhem/opt/fhem/FHEM/
vi events.holiday

# ESC-i drücken um in den vi-Editmodus zu gelangen

# Format fur einzelne Tage: 1 MM-DD <Text>
1 03-23 Schwarze Tonne rausstellen
1 03-24 Gelbe Tonne rausstellen

# mit ESC:wq die Datei speichern
</pre>
[[Datei:Define_events_holiday.png|mini|400px|rechts|Details des definierten Kalenders]]
In Fhem muss der Kalender folgendermaßen definiert werden:
:<code>define events holiday</code>

Das im Bild gezeigte ''Device'' sollte erscheinen.

Der Befehl für die Zeitsteuerung wird mit dem folgenden '''at''' definiert (dieser Befehl muss ohne Zeilenumbrüche in die [[Konfiguration]] übernommen werden, vorzugsweise durch Eingabe in das Befehlsfeld):
:<code>define CheckEventToday at *20:15:00 {my $Eventname;;my $EventHeute;;$EventHeute=fhem("get events today");;print $EventHeute;;if ($EventHeute ne "none"){ $Eventname="Ereignis: $EventHeute";;fhem("set pushmsg msg 'fhem' 'Erinnerung an: $Eventname' '' 0 ''");;}}</code>

== Links ==
* Fhem Commandref [http://fhem.de/commandref_DE.html#Pushover Pushover]
* Thread über das Modul im [http://forum.fhem.de/index.php/topic,16215.0.html Fhem Forum]
* Pushover API [https://pushover.net/api https://pushover.net/api]

[[Kategorie:Code Snippets]]

FHEMWiki - Benutzerbeiträge [de]

Pushover