E-Mail senden

Linux

FB 7170 (non-chroot)

Datei 99_email.pm im Modul-Verzeichnis mit folgender Funktion anlegen (oder in bestehende 99_irgendwas.pm kopieren):

sub fb_mail {
 my $rcpt = $_[0];
 my $subject = $_[1];
 my $text = $_[2];
 system("/bin/echo \"$text\" | /usr/bin/mail send -i - -s \"$subject\" -t \"$rcpt\"");
}

Aufruf dann mittels { fb_mail('empfaenger@@mail.de','Subject','text 123') }

FB 7390 (AVM Fritz!Box)

Seit 10/2012 ist diese Funktion Bestandteil der fhem Standardauslieferung. Sie ist untergebracht in FritzBoxUtils.pm und heisst dort FB_mail($$$) (Groß-Kleinschreibung beachten) Da der Dateiname von FritzBoxUtils.pm nicht mit 99_ beginnt, wird diese Programmdatei nicht automatisch beim Start von fhem geladen. fhem muss zum Laden dieser Programmdatei aufgefordert werden. Dazu (zB in 99_myUtils.pm) die Zeile use FritzBoxUtils;einfügen. Mit dem install von AVM.de wird fhem in einer chroot-Umgebung ausgeführt, die den Zugriff auf die Mailfunktion der Fritzbox nicht zulässt. Daher muss fhem in der Version von fhem.de installiert sein. Sollte Ihre Fritzbox bisher mit dem install von AVM laufen, kann (nach einem backup!) das image von fhem.de einfach drüberinstalliert werden, es sollten dabei alle Einstellungen erhalten bleiben.

sub fb_mail {
 my $rcpt = $_[0];
 my $subject = $_[1];
 my $text = $_[2];
 system("/bin/echo \"$text\" > /var/tmp/fhem_nachricht.txt");
 system("/sbin/mailer send -i '/var/tmp/fhem_nachricht.txt' -s \"$subject\" -t \"$rcpt\"");
 system("rm /var/tmp/fhem_nachricht.txt");
}

Aufruf dann mittels { fb_mail('empfaenger@mail.de','Subject','text 123') } bzw. { FB_mail('empfaenger@mail.de','Subject','text 123') } Hinweis:Wenn der Aufruf der Mailfunktion aus einem notify oder at erfolgt, muss das @@ in der Adresse des mailempfängers gedoppelt werden, da ein einfaches @ sonst durch den getriggerten device-namen ersetzt würde. Bei Verwendung in der fhem-Kommandozeile oder einem eigenen *Utils.pm ist diese Doppelung nicht erforderlich. Bitte bei den ersten Mails ins Log schauen, ob die Mailadresse wie gewünscht verwendet wird.

Dem Mailer können noch weitere Parameter hinzugefügt werden. Mehr dazu siehe: Mailer

Synology DiskStation

Beim DSM 3.2 gab es keinen sendmail-Befehl, sondern nur eine Funktion für den Versand der System-Benachrichtigungen. Interessanterweise funktionierte aber der php-mail-Befehl, so dass man mittels folgendem Modul Mails frei versenden kann:

sub sendmail($$$) {
 my($empf, $subj, $nachricht) = @_;
 system("php -r 'mail(\"$empf\",\"$subj\",\"$nachricht\");'");
 undef;
}

Raspberry Pi

In der weezy-Version, wie sie von busware zur Verfügung gestellt wird, muss noch sendEmail nachinstalliert werden:

sudo apt-get update sudo apt-get install sendEmail

in der 99_myUtils folgende sub einfügen:

######## DebianMail  Mail auf dem RPi versenden ############ 
sub 
DebianMail 
{ 
 my $rcpt = shift;
 my $subject = shift; 
 my $text = shift; 
 my $ret = "";
 my $sender = "absender\@account.de"; 
 my $konto = "kontoname\@account.de";
 my $passwrd = "passwrd";
 my $provider = "smtp.provider.de";
 Log 1, "sendEmail RCP: $rcpt";
 Log 1, "sendEmail Subject: $subject";
 Log 1, "sendEmail Text: $text";
 
 $ret .= qx(sendEmail -f '$sender' -t '$rcpt' -u '$subject' -m '$text' -s '$provider' -xu '$konto' -xp '$passwrd' -o tls=no);
 $ret =~ s,[\r\n]*,,g;    # remove CR from return-string 
 Log 1, "sendEmail returned: $ret"; 
}

Beim Aufruf der Funktion gibt es zwei unterschiedliche Verhaltensweisen zu beachten. Wird DebianMail durch ein Fhem-Ereignis als Makro mit "Transferzeichen", wie @ oder % aufgerufen, so sind diese innerhalb des Aufrufs von DebianMail zu maskieren.

Siehe auch commandref: ◾The character @ will be replaced with the device name. To use @ in the text itself, use the double mode (@@). ◾The macro %<parameter> will expand to the current value of the named parameter. This can be either a parameter from the device definition or a parameter from the set or get command.

Beispiel:

define Sonstiges notify Fenster:Window:.*,.*Low.Batt*. {\
 DebianMail('email@@email.domain','Subject','Text');;\
}

in allen anderen Fällen muss die Maskierung entfallen:

Beispiel:

define Sonstiges at *01:00:00 {\
 DebianMail('email@email.domain','Subject','Text');;\
}

BeagleBoard-xM

Auf einem BeagleBoard-xM mit einem OpenSUSE 12.2 kann man ebenfalls das Perl-Programm sendEmailwie beim RPi nutzen. Dies gibt es aber nicht in den Repositorys von openSUSE, sondern man muss sich sendEmailals Source herunterladen. Das geht am einfachsten per wget, welches man ebenfalls erst installieren muss (aber aus einem Repository)

$ zypper in wget
 $ cd /opt
 $ wget http://caspian.dotconf.net/menu/Software/SendEmail/sendEmail-v1.56.tar.gz
 $ tar xvfz sendEmail-v1.56.tar.gz
 $ cd sendEmail-v1.56
 $ cp sendMail /usr/local/bin

Dann geht man weiter vor wie unter RPi beschrieben (anlegen der SUB-Routine in 99_myUtils usw.).

Hinweis:Die Version 1.56 von sendEmailist Stand Januar 2013 die aktuelle. Da diese Programmversion von 2009 stammt, ist mit neuen Versionen selten zu rechnen. Vlt. schauen Sie trotzdem vorher auf der Homepage von sendEmail nach.

Windows

1. Kopiere die Datei sendEmail.exe* in Dein FHEM Verzeichnis. (Hier c:\fhem-5.0\)

Quelle: http://caspian.dotconf.net/menu/Software/SendEmail/

2. Erstelle im FHEM Verzeichnis die Datei wmail.bat mit folgendem Inhalt (eine Zeile):

sendEmail -f absender@domain.de -u "%1" -m " " -s SMTP-SERVERAdresse -xu SMTP_USERNAME -xp SMTP_PASSWORT -t empfänger@domain.de -o message-header="X-Message-Flag: FHEM"

3. Beispiele fhem.cfg

3.a Mail wenn sich der Status von Heizung.* oder Hzg.* ändert

define Mail_Heizung notify Heizung.*|Hzg.* { system("wmail @:%")}

3.b Mail bei Signal Aussentemperatur (Für diese Beispiel wird getstate benötigt http://fhem.de/commandref.html#getstate)

define Mail_Aussentemperatur notify Aussentemperatur {\
my ($val);;\
$val = fhem "getstate @";;\
system("wmail \"@: $val\"");;\
}

Probleme

sendEmail

Falls man keine E-Mails verschicken kann, kann man als ersten Test prüfen, ob sendEmail als solches funktioniert und die Konfiguration (Benutzer, Passwort, Server-Name usw.) des Mail-Kontos, über das die Mails abgesetzt werden sollen, richtig ist.

Hierzu setzt man in der FHEM-Befehlszeile die folgende Anweisung ab:

{ SUB-Routinen-Name('EMailAdresse@Mail.Domain','Test','Test-Text');; }

und ersetzt SUB-Routinen-Namemit dem Namen der in 99_myUtils erzeugten Prozedur. Statt EMailAdresse@Mail.Domainträgt man noch eine gültige E-Mail-Adresse ein und bestätigt den Befehl dann mittels <Enter> (nicht "save"). Empfangen Sie nicht kurzfristig eine entsprechende E-Mail, ist sehr wahrscheinlich an den Zugangsdaten etwas verkehrt.