Pushover: Unterschied zwischen den Versionen

Aus FHEMWiki
(Formatierung überarbeitet; kleinere Korrekturen; Wiki-Link(s) korrigiert)
Zeile 1: Zeile 1:
{{Infobox Modul
{{Infobox Modul
|ModPurpose=Senden von sog. Push-Nachrichten auf Tablets o. Mobiltelefone
|ModPurpose=Senden von sogenannten Push-Nachrichten auf Tablets oder Smartphones
|ModType=Modul
|ModType=Modul
<!-- |ModCategory= (noch?) nicht verwendet -->
<!-- |ModCategory= (noch?) nicht verwendet -->
Zeile 8: Zeile 8:
}}
}}


== Pushover ==
[[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, sog. "Push" Nachrichten auf ein Apple oder Android Gerät zu schicken. (Link zum Dienst: [https://pushover.net])


== Installation ==
== Installation ==
Auf dem Gerä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€.
Auf dem Gerä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 Registraion auf der Webseite) die einzelnen Geräte auf denen Nachrichten gesendet werden sollen registriert werden.
Danach müssen (nach erfolgter Registrierung auf der Webseite) die einzelnen Geräte, auf denen Nachrichten gesendet werden sollen, registriert werden.
Weiterhin wird eine "Userkey" und ein "Token" generiert, der bei der Einbindung in die verschiedenen Anwendungen und Dienste benötigt wird.
Weiterhin wird ein "Userkey" und ein "Token" generiert, der bei der Einbindung in die verschiedenen Anwendungen und Dienste benötigt wird.


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


== 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:
<pre>
:<code>define pushmsg Pushover <USERID> <TOKEN></code>
define pushmsg Pushover <USERID> <TOKEN>
</pre>
 


== Senden eine Nachricht mit fhem ==
== Senden eine Nachricht mit Fhem ==
Syntax:
Syntax:
<pre>You can send messages via the following command:
<pre>You can send messages via the following command:
Zeile 33: Zeile 29:


Beispiel:
Beispiel:
<pre>fhem("set pushmsg msg 'fhem' 'Das Fenster wurde geschlossen!' '' 0 ''");</pre>
:<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 eines "notify":
<pre>
:<code>define notify_fhem_reload notify global:INITIALIZED set pushmsg msg 'fhem' 'Ich wurde neu geladen! - $EVENT' '' 0 '' </code>
define notify_fhem_reload notify global:INITIALIZED set pushmsg msg 'fhem' 'Ich wurde neu geladen! - $EVENT' '' 0 ''
</pre>


== Erinnerungsfunktion mit Hilfe des Kalendar Moduls ==
== Erinnerungsfunktion mit Hilfe des Kalendermoduls ==
Zuerst wird eine Textdatei mit den Daten für die Erinnerung im FHEM Hauptverzeichnis erzeugt.  
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:
Hier das Beispiel sofern fhem auf einer Fritzbox läuft:


<pre>
<pre>
Zeile 57: Zeile 50:
# mit ESC:wq die Datei speichern
# mit ESC:wq die Datei speichern
</pre>
</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>


In fhem muss dann der Kalendar definiert werden.
Das im Bild gezeigte ''Device'' sollte erscheinen.
<pre>define events holiday</pre>


 
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):
Das folgende ''Device'' sollte erscheinen
:<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>
 
[[Datei:Define_events_holiday.png]]
 
Nun noch den sog. AT (zeitgesteuerte Befehl) definieren. Einfach den Code in die Webfrontend Befehlszeile kopieren.
 
<pre>
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 ''");;}}
</pre>


== Links ==
== Links ==
* fhem Commandref [http://fhem.de/commandref_DE.html#Pushover Pushover]
* 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]
* 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]
* Pushover API [https://pushover.net/api https://pushover.net/api]

Version vom 24. März 2014, 10:57 Uhr

Pushover
Zweck / Funktion
Senden von sogenannten Push-Nachrichten auf Tablets oder Smartphones
Allgemein
Typ undefiniert
Details
Dokumentation ModUndef
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).

Installation

Auf dem Gerä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. Weiterhin wird ein "Userkey" und ein "Token" generiert, der bei der Einbindung in die verschiedenen Anwendungen und Dienste benötigt wird.

Einbinden des Dienstes in Fhem

Das Modul wird mit dem folgenden Befehl in fhem definiert:

define pushmsg Pushover <USERID> <TOKEN>

Senden eine Nachricht mit Fhem

Syntax:

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

Beispiel:

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

Nachricht, sobald Fhem neu geladen wurde, mit Hilfe eines "notify":

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 das 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