Pushover: Unterschied zwischen den Versionen

Aus FHEMWiki
Keine Bearbeitungszusammenfassung
K (Vorlage Link2CmdRef)
 
(6 dazwischenliegende Versionen von 6 Benutzern werden nicht angezeigt)
Zeile 8: Zeile 8:
}}
}}


[[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]).
[[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, welche leider nicht kostenlos ist.
Um die Push-Nachrichten zu empfangen, muss die dazu passende App installiert werden (siehe unten). Der Dienst ist grundlegend kostenlos. Die App-Nutzung ist einmalig zu bezahlen. Es fallen keine Abo-Gebühren an (Stand 08.10.2015).
Es fallen keinen Abo gebühren an. (Stand 28.6.2014)


== Installation ==
== Installation ==
Es muss zwingend eine Pushover Account erstellen werden. Ist der Account angelegt muss auch auf der Pushover Website eine Application angelegt werden.
Es muss zwingend ein Pushover-Account erstellt werden. Anschließend ist auf der Pushover-Website eine Application zu hinterlegen (auf der Pushover-Website zu ''Apps & Plugins'' navigieren, Punkt ''Create a New Application'' wählen).
Die Application dient dazu die Nachrichten FHEM zuzuweisen und sie leichter erkennbar zu machen. (hier bekommt man dann den Token)
Die Application dient dazu, die Nachrichten FHEM zuzuweisen und sie leichter erkennbar zu machen. Für die Application wird von Pushover automatisch ein Token generiert (siehe Abschnitt ''API Token/Key'' auf der Pushover-Website).
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]
Nach Erstellung der Application müssen (nach erfolgter Registrierung auf der Webseite) die einzelnen Geräte, auf denen Nachrichten gesendet werden sollen, registriert werden.
* Android Geräte: [https://play.google.com/store/apps/details?id=net.superblock.pushover&hl=de Pushover App im Google Playstore]
Die Registrierung der Geräte erfolgt nach dem Anmelden in der App auf dem Endgerät automatisch.


'''Wichtig für Debian Nutzer'''
Auf dem Endgerät muss die Pushover-App installiert werden. Dies geschieht z. B. bei Apple-Geräten mit Hilfe des AppStores. Stand 08.10.2015 kostet diese Anwendung nach einer 7-tägigen kostenlosen Probephase 4,99 Euro (In-App-Kauf).
* 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'''<br />
Für das Modul ist noch eine Library notwendig:
Für das Modul ist noch eine Library notwendig:
<pre>sudo apt-get install libio-socket-ssl-perl</pre>
<pre>sudo apt-get install libio-socket-ssl-perl</pre>


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


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


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


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


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


== Erinnerungsfunktion mit Hilfe des Kalendermoduls ==
== 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:
Zuerst wird eine Textdatei mit den Daten für die Erinnerung im FHEM-Hauptverzeichnis erzeugt. Hier folgt ein Beispiel für den Fall, dass FHEM auf einer Fritzbox läuft:


<pre>
<pre>
Zeile 63: Zeile 63:
</pre>
</pre>
[[Datei:Define_events_holiday.png|mini|400px|rechts|Details des definierten Kalenders]]
[[Datei:Define_events_holiday.png|mini|400px|rechts|Details des definierten Kalenders]]
In Fhem muss der Kalender folgendermaßen definiert werden:
In FHEM muss der Kalender folgendermaßen definiert werden:
:<code>define events holiday</code>
:<code>define events holiday</code>


Das im Bild gezeigte ''Device'' sollte erscheinen.
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):
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>
:<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 ==
== Links ==
* Fhem Commandref [http://fhem.de/commandref_DE.html#Pushover Pushover]
* FHEM-{{Link2CmdRef|Lang=de|Anker=Pushover}} Pushover
* Thread über das Modul im [http://forum.fhem.de/index.php/topic,16215.0.html Fhem Forum]
* Thread über das Modul im {{Link2Forum|Topic=16215|LinkText=FHEM-Forum}}
* Pushover API [https://pushover.net/api https://pushover.net/api]
* Pushover-API [https://pushover.net/api https://pushover.net/api]


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

Aktuelle Version vom 31. Januar 2018, 14:34 Uhr

Pushover
Zweck / Funktion
Senden von sogenannten Push-Nachrichten auf Tablets oder Smartphones
Allgemein
Typ Gerätemodul
Details
Dokumentation EN / DE
Modulname 70_Pushover.pm
Ersteller Johannes B
Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!


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: pushover.net). Um die Push-Nachrichten zu empfangen, muss die dazu passende App installiert werden (siehe unten). Der Dienst ist grundlegend kostenlos. Die App-Nutzung ist einmalig zu bezahlen. Es fallen keine Abo-Gebühren an (Stand 08.10.2015).

Installation

Es muss zwingend ein Pushover-Account erstellt werden. Anschließend ist auf der Pushover-Website eine Application zu hinterlegen (auf der Pushover-Website zu Apps & Plugins navigieren, Punkt Create a New Application wählen). Die Application dient dazu, die Nachrichten FHEM zuzuweisen und sie leichter erkennbar zu machen. Für die Application wird von Pushover automatisch ein Token generiert (siehe Abschnitt API Token/Key auf der Pushover-Website).

Nach Erstellung der Application 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 dem Anmelden in der App auf dem Endgerät automatisch.

Auf dem Endgerät muss die Pushover-App installiert werden. Dies geschieht z. B. bei Apple-Geräten mit Hilfe des AppStores. Stand 08.10.2015 kostet diese Anwendung nach einer 7-tägigen kostenlosen Probephase 4,99 Euro (In-App-Kauf).

Wichtig für Debian-Nutzer
Für das Modul ist noch eine Library notwendig: 

sudo apt-get install libio-socket-ssl-perl

Einbinden des Dienstes in FHEM

Das Modul wird mit dem folgenden Befehl in FHEM definiert:

define pushmsg Pushover <TOKEN> <USER>

Die Token werden der Pushover-Seite entnommen.
TOKEN = API Token/Key (zu finden unter der angelegten Application)
USER = Your User Key (wird direkt nach dem Einloggen angezeigt)

Senden einer Nachricht mit FHEM

Syntax: 

You can send messages via the following command:
# set <Pushover_device> msg ['<title>'] '<msg>' ['<device>' <priority> '<sound>' [<retry> <expire> ['<url_title>' '<action>']]]

Beispiel:

fhem("set pushmsg msg 'fhem' 'Das Fenster wurde geschlossen!' 0 ");

Nachricht, sobald FHEM neu geladen wurde, mit Hilfe einer Notify-Anweisung: 

define notify_fhem_reload notify global:INITIALIZED set pushmsg msg 'fhem' 'Ich wurde neu geladen! - $EVENT' '' 0 ''

Erinnerungsfunktion mit Hilfe des Kalendermoduls

Zuerst wird eine Textdatei mit den Daten für die Erinnerung im FHEM-Hauptverzeichnis erzeugt. Hier folgt ein Beispiel für den Fall, dass FHEM auf einer Fritzbox läuft: 

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
Details des definierten Kalenders

In FHEM muss der Kalender folgendermaßen definiert werden:

define events holiday

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):

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 ");;}}

Links

Abgerufen von „http://wiki.fhem.de/w/index.php?title=Pushover&oldid=24993“