From 190a7c7c86dc43c380117f678407f59d025b07d2 Mon Sep 17 00:00:00 2001
From: dev0 <>
Date: Thu, 27 Apr 2017 09:28:03 +0000
Subject: [PATCH] 34_ESPEasy.pm: support ESPEasy commands tone/rtttl

git-svn-id: https://svn.fhem.de/fhem/trunk@14118 2b470e98-0d58-463d-a4d8-8e2adae1ed80
---
 fhem/CHANGED            |  1 +
 fhem/FHEM/34_ESPEasy.pm | 20 +++++++++++++++++++-
 2 files changed, 20 insertions(+), 1 deletion(-)

diff --git a/fhem/CHANGED b/fhem/CHANGED
index 946a075df..0da1aee4d 100644
--- a/fhem/CHANGED
+++ b/fhem/CHANGED
@@ -1,5 +1,6 @@
 # Add changes at the top of the list. Keep it in ASCII, and 80-char wide.
 # Do not insert empty lines here, update check depends on it.
+  - feature: 34_ESPEasy: added ESPEasy commands: tone and rtttl
   - bugfix:  88_HMCCU: fixed config commands
   - feature: 30_pilight_contact: add battery reading if information is available
   - update:  88_HMCCU: Homematic firmware download, advanced scripting
diff --git a/fhem/FHEM/34_ESPEasy.pm b/fhem/FHEM/34_ESPEasy.pm
index 60ac82981..a903e737a 100644
--- a/fhem/FHEM/34_ESPEasy.pm
+++ b/fhem/FHEM/34_ESPEasy.pm
@@ -36,7 +36,7 @@ use Color;
 # ------------------------------------------------------------------------------
 # global/default values
 # ------------------------------------------------------------------------------
-my $module_version    = 1.04;       # Version of this module
+my $module_version    = 1.05;       # Version of this module
 my $minEEBuild        = 128;        # informational
 my $minJsonVersion    = 1.02;       # checked in received data
 
@@ -82,6 +82,8 @@ my %ESPEasy_setCmds = (
   "help"           => "1",
   "lights"         => "1",
   "dots"           => "1",
+  "tone"           => "3",
+  "rtttl"          => "1"
 );
 
 # ------------------------------------------------------------------------------
@@ -116,6 +118,8 @@ my %ESPEasy_setCmdsUsage = (
   "help"           => "help <".join("|", sort keys %ESPEasy_setCmds).">",
   "lights"         => "light <rgb|ct|pct|on|off|toggle> [color] [fading time] [pct]",
   "dots"           => "dots <params>",
+  "tone"           => "tone <pin> <freq> <duration>",
+  "rtttl"          => "rtttl <RTTTL>",
 
   #Lights
   "rgb"            => "rgb <rrggbb> [fading time]",
@@ -2837,6 +2841,20 @@ sub ESPEasy_removeGit($)
       eg. <code>irsend NEC 7E81542B 32</code>
       </li><br>
       
+    <li><a name="">tone</a><br>
+      Play a tone on a pin via a speaker or piezo element (ESPEasy &gt;= 
+      2.0.0-dev6)
+      <br>
+      required arguments: &lt;pin&gt; &lt;freq&gt; &lt;duration&gt;
+      </li><br>
+      
+    <li><a name="">rtttl</a><br>
+      Play melodies via <a target="_NEW" href="https://en.wikipedia.org/wiki/Ring_Tone_Transfer_Language#Technical_specification">RTTTL</a>
+      (ESPEasy &gt;= 2.0.0-dev6)
+      <br>
+      required arguments: &lt;pin&gt; &lt;freq&gt; &lt;duration&gt;
+      </li><br>
+      
     <li><a name="">status</a><br>
       Request esp device status (eg. gpio)<br>
       required values: <code>&lt;device&gt; &lt;pin&gt;</code><br>