From ca1d19c7757017d47c16dad67fd21b830e763649 Mon Sep 17 00:00:00 2001
From: rudolfkoenig <rudolfkoenig@2b470e98-0d58-463d-a4d8-8e2adae1ed80>
Date: Wed, 7 Aug 2013 11:18:15 +0000
Subject: [PATCH] displayattr command added

git-svn-id: svn://svn.code.sf.net/p/fhem/code/trunk@3601 2b470e98-0d58-463d-a4d8-8e2adae1ed80
---
 fhem/CHANGED                       |   1 +
 fhem/docs/commandref_frame.html    |  30 ++++++
 fhem/docs/commandref_frame_DE.html | 142 +++++++++++++++++------------
 fhem/fhem.pl                       |  38 ++++++++
 4 files changed, 155 insertions(+), 56 deletions(-)

diff --git a/fhem/CHANGED b/fhem/CHANGED
index 484d3fd27..725710e74 100644
--- a/fhem/CHANGED
+++ b/fhem/CHANGED
@@ -1,5 +1,6 @@
 # Add changes at the top of the list. Keep it in ASCII
 - SVN
+  - feature: displayattr command added
   - feature: SYSSTAT: allow (remote) monitoring system uptime
   - feature: new module 98_openweathermap.pm added (betateilchen)
   - feature: WeatherAsHtmlH(), WeatherAsHtmlD() added to 59_Weather.pm (Boris)
diff --git a/fhem/docs/commandref_frame.html b/fhem/docs/commandref_frame.html
index dfeec032a..47f24af2f 100644
--- a/fhem/docs/commandref_frame.html
+++ b/fhem/docs/commandref_frame.html
@@ -38,6 +38,7 @@
       <a href="#delete">delete</a> &nbsp;
       <a href="#deleteattr">deleteattr</a> &nbsp;
       <a href="#deletereading">deletereading</a> &nbsp;
+      <a href="#displayattr">displayattr</a> &nbsp;
       <a href="#fheminfo">fheminfo</a> &nbsp;
       <a href="#get">get</a> &nbsp;
       <a href="#getstate">getstate</a> &nbsp;
@@ -250,6 +251,7 @@ A line ending with \ will be concatenated with the next one, so long lines
   The commands
     <a href="#attr">attr</a>,
     <a href="#deleteattr">deleteattr</a>,
+    <a href="#displayattr">displayattr</a>,
     <a href="#delete">delete</a>,
     <a href="#get">get</a>,
     <a href="#list">list</a>,
@@ -569,6 +571,7 @@ A line ending with \ will be concatenated with the next one, so long lines
   <br>
 </ul>
 
+
 <a name="deletereading"></a>
 <h3>deletereading</h3>
 <ul>
@@ -589,6 +592,33 @@ A line ending with \ will be concatenated with the next one, so long lines
   <br>
 </ul>
 
+
+<a name="displayattr"></a>
+<h3>displayattr</h3>
+<ul>
+  <code>displayattr &lt;devspec&gt; [&lt;attrname&gt;]</code> <br>
+  <br>
+  Display either the value of a single attribute (see the <a href="#attr">attr</a> command)
+  or all attributes for a device (if no &lt;attrname&gt; is defined).
+  See the <a href="#devspec">Device specification</a> section for details on
+  &lt;devspec&gt;.<br>
+  If more then one device is specified, then the device name will also included
+  in the output.
+  <br>
+
+  Examples:
+  <ul>
+    <code>
+    fhem&gt; di WEB<br>
+    menuEntries AlarmOn,/fhem?cmd=set%20alarm%20on<br>
+    room Misc.<br>
+    fhem&gt di WEB room<br>
+    Misc.<br>
+    </code>
+  </ul>
+  <br>
+</ul>
+
 <a name="get"></a>
 <h3>get</h3>
 <ul>
diff --git a/fhem/docs/commandref_frame_DE.html b/fhem/docs/commandref_frame_DE.html
index e035b6a20..e57a511bc 100644
--- a/fhem/docs/commandref_frame_DE.html
+++ b/fhem/docs/commandref_frame_DE.html
@@ -201,8 +201,7 @@ telnet-Prompt eingegeben werden:
 SHELL-Kommandos werden im Hintergrund ausgef&uuml;hrt, 
 PERL-Ausdr&uuml;cke und FHEM-Kommandos werden im Haupt-"thread" ausgef&uuml;hrt. Um 
 PERL-Ausdr&uuml;cke leichter eingeben zu k&ouml;nnen, sind einige Spezialfunktionen und 
-Variablen verf&uuml;gbar. Lesen Sie sich bitte die Abschnitte
-<a href="file:///C:/Inetpub/wwwroot/www.fhem.de/commandref_frame_DE.html#perl" style="color: #278727; text-decoration: underline; text-underline: single">
+Variablen verf&uuml;gbar. Lesen Sie sich bitte die Abschnitte <a href="#perl">
 Perl special</a> zum besseren Verst&auml;ndnis durch.</p>
 <p>Um FHEM-Befehle in einen SHELL-Script zu triggern (dies ist 
 eine "andere" M&ouml;glichkeit), benutzen Sie bitte die oben beschriebene Client-Form 
@@ -251,16 +250,13 @@ Zeilen erstreckende Befehle, indem man keine \ am Zeilenende eingeben muss.</p>
 <a name="devspec"></a>
 <h3>Ger&auml;te-Spezifikation (devspec)</h3>
 <ul>
-  Die Befehle
+  Befehle wie
     <a href="#attr">attr</a>,
-    <a href="#deleteattr">deleteattr</a>,<a href="#delete">delete</a>,
-    <a href="#get">get</a>,
-    <a href="#list">list</a>,
     <a href="#set">set</a>,
-    <a href="#setstate">setstate</a>,<a href="file:///C:/Inetpub/wwwroot/www.fhem.de/commandref_frame_DE.html#setstate"><span style="text-decoration: underline">
-  </span></a>k&ouml;nnen eine komplexere 
-  Ger&auml;tespezifikation als Argumente enthalten, die auch eine Anzahl von Ger&auml;ten 
-  betreffen kann. Eine Ger&auml;tespezifikation (Kurzfassung) kann z.B. so aussehen:
+    <a href="#get">get</a>, usw.
+  k&ouml;nnen eine komplexere Ger&auml;tespezifikation als Argumente enthalten,
+  die auch eine Anzahl von Ger&auml;ten betreffen kann. Eine
+  Ger&auml;tespezifikation (Kurzfassung) kann z.B. so aussehen:
   <ul>
   <li>ein einzelner Ger&auml;tename. Dies ist der 
   meist vorkommende Fall.</li>
@@ -322,11 +318,15 @@ Zeilen erstreckende Befehle, indem man keine \ am Zeilenende eingeben muss.</p>
   <code>attr &lt;devspec&gt; &lt;attrname&gt; [&lt;value&gt;] </code><br>
 
   <br>
-   Dieser Befehl setzt ein Attribut f&uuml;r ein Ger&auml;t welches mit <a href="#define">define</a> definiert wurde. Sie k&ouml;nnen auch 
-  Ihre eigenen Attribute definieren, um sie in anderen Applikationen anzuwenden. 
-  Geben Sie "&lt;attr &lt;name&gt; ?" ein, um eine Liste verf&uuml;gbarer Attribute 
-  anzuzeigen. Bitte lesen Sie das Kapitel <a href="#devspec">Device specification</a>&nbsp; 
-  um Detail-Informationen zu &lt;devspec&gt; zu erhalten.
+   Dieser Befehl setzt ein Attribut f&uuml;r ein Ger&auml;t welches mit <a
+   href="#define">define</a> definiert wurde. Sie k&ouml;nnen auch Ihre eigenen
+   Attribute definieren, um sie in anderen Applikationen anzuwenden.  Geben Sie
+   "&lt;attr &lt;name&gt; ?" ein, um eine Liste verf&uuml;gbarer Attribute
+   anzuzeigen. 
+
+  Siehe den Abschnitt &uuml;ber <a href="#devspec">Ger&auml;te-Spezifikation</a>
+  f&uuml;r Details der &lt;devspec&gt;.<br>
+
   <p>Attribute, die f&uuml;r 
   alle Ger&auml;te anwendbar sind: </p>
   <ul>
@@ -553,13 +553,14 @@ Zeilen erstreckende Befehle, indem man keine \ am Zeilenende eingeben muss.</p>
 <ul>
   <code>delete &lt;devspec&gt;</code> <br>
   <br>
-  L&ouml;scht etwas was mit dem <a href="#define">define</a> Befehl erstellt worden
-  ist.
-  Lesen Sie sich bitte den Abschnitt <a href="#devspec">Device specification</a>&nbsp; f&uuml;r
-  Details von
-  &lt;devspec&gt; durch.<br>
-  Nach dem l&ouml;schen, wird das globale Ereignis "DELETED" erzeugt. Lesen Sie bitte
-  den Abschnitt zu &quot;notify&quot; f&uuml;r genauere Informationen durch.<br>
+  L&ouml;scht etwas was mit dem <a href="#define">define</a> Befehl erstellt
+  worden ist.<br>
+
+  Siehe den Abschnitt &uuml;ber <a href="#devspec">Ger&auml;te-Spezifikation</a>
+  f&uuml;r Details der &lt;devspec&gt;.<br>
+
+  Nach dem l&ouml;schen, wird das globale Ereignis "DELETED" erzeugt.<br>
+
   Beispiel:
   <ul>
     <code>delete lamp</code><br>
@@ -572,12 +573,11 @@ Zeilen erstreckende Befehle, indem man keine \ am Zeilenende eingeben muss.</p>
 <ul>
   <code>deleteattr &lt;devspec&gt; [&lt;attrname&gt;]</code> <br>
   <br>
-  L&ouml;scht entweder ein einzelnes Attribut (siehe Abschnitt <a href="#attr">attr</a> )
-  oder alle Attribute eines Ger&auml;tes (falls kein&nbsp; &lt;attrname&gt; angegeben 
-  wird).
-  Lesen Sie bitte den&nbsp; <a href="#devspec">Device specification</a> 
-  Abschnitt f&uuml;r
-  &lt;devspec&gt; durch.<br>
+  L&ouml;scht entweder ein einzelnes Attribut (siehe Abschnitt <a
+  href="#attr">attr</a> ) oder alle Attribute eines Ger&auml;tes (falls
+  kein &lt;attrname&gt; angegeben wird).<br>
+  Siehe den Abschnitt &uuml;ber <a href="#devspec">Ger&auml;te-Spezifikation</a>
+  f&uuml;r Details der &lt;devspec&gt;.<br>
   <br>
 
   Beispiele:
@@ -593,14 +593,18 @@ Zeilen erstreckende Befehle, indem man keine \ am Zeilenende eingeben muss.</p>
 <ul>
   <code>deletereading &lt;devspec&gt; &lt;readingname&gt;</code> <br>
   <br>
-  Delete the reading &lt;readingname&gt;
-  for a device. &lt;readingname&gt; is a perl regular expression that must match the whole name of the reading.
-  Use with greatest care! FHEM might crash if you delete vital readings of a device.
-  See the <a href="#devspec">Device specification</a> section for details on
-  &lt;devspec&gt;.<br>
+  Entfernt das Reading &lt;readingname&gt; f&uuml;r das spezifizierte
+  Ger&auml;t.  &lt;readingname&gt; ist ein perl Regular-Expression, was den
+  vollst&auml;ndigen Namen des Readings erfassen muss.
+
+  Mit gr&ouml;&szlig;ter Sorgfalt verwenden! FHEM kann abst&uuml;rzen, falls
+  man lebenswichtige Readings entfernt.<br>
+
+  Siehe den Abschnitt &uuml;ber <a href="#devspec">Ger&auml;te-Spezifikation</a>
+  f&uuml;r Details der &lt;devspec&gt;.<br>
   <br>
 
-  Examples:
+  Beispiele:
   <ul>
     <code>deletereading mySensor temp1</code><br>
     <code>deletereading mySensor temp\d+</code><br>
@@ -608,6 +612,34 @@ Zeilen erstreckende Befehle, indem man keine \ am Zeilenende eingeben muss.</p>
   <br>
 </ul>
 
+<a name="displayattr"></a>
+<h3>displayattr</h3>
+<ul>
+  <code>displayattr &lt;devspec&gt; [&lt;attrname&gt;]</code> <br>
+  <br>
+  Zeigt entweder den Wert eines Attributes an (falls &lt;attrname&gt;
+  spezifiziert wurde) oder alle Attribute eines Ger&auml;tes.
+
+  Siehe den Abschnitt &uuml;ber <a href="#devspec">Ger&auml;te-Spezifikation</a>
+  f&uuml;r Details der &lt;devspec&gt;.<br>
+
+  Falls mehrere Ger&auml;te spezifiziert wurden, dann enth&auml;lt die Ausgabe
+  den Namen der Ger&auml;te.
+  <br>
+
+  Beispiele:
+  <ul>
+    <code>
+    fhem&gt; di WEB<br>
+    menuEntries AlarmOn,/fhem?cmd=set%20alarm%20on<br>
+    room Misc.<br>
+    fhem&gt di WEB room<br>
+    Misc.<br>
+    </code>
+  </ul>
+  <br>
+</ul>
+
 <a name="get"></a>
 <h3>get</h3>
 <ul>
@@ -617,10 +649,8 @@ Zeilen erstreckende Befehle, indem man keine \ am Zeilenende eingeben muss.</p>
   Antwort. Eine allgemeine Liste m&ouml;glicher Paramter erhalten Sie mit<ul>
     <code>get &lt;device&gt; ?</code>
   </ul>
-  Lesen Sie den Abschnitt <a href="#devspec">Device specification</a> f&uuml;r 
-  Details zu
-  &lt;devspec&gt; durch.<br>
-  <br>
+  Siehe den Abschnitt &uuml;ber <a href="#devspec">Ger&auml;te-Spezifikation</a>
+  f&uuml;r Details der &lt;devspec&gt;.<br>
   Jedes Ger&auml;t hat unterschiedliche &quot;get&quot;-Parameter. Lesen Sie Details bitte im 
   zugeh&ouml;rigen Abschnitt nach.<br>
   <br>
@@ -685,13 +715,13 @@ Zeilen erstreckende Befehle, indem man keine \ am Zeilenende eingeben muss.</p>
   <code>list [devspec] [value]</code>
   <br><br>
   Auflistung aller &quot;definitions&quot;, &quot;notify&quot; und &quot;at&quot;-Definitionen. Dies ist eines 
-  der wenigen Befehle, die im Normalfall eine Zeichenkette ausgeben. Bitte lesen 
-  Sie den Abschnitt <a href="#devspec">Device specification</a> f&uuml;r Details zu
-  &lt;devspec&gt;.
+  der wenigen Befehle, die im Normalfall eine Zeichenkette ausgeben.<br>
+  Siehe den Abschnitt &uuml;ber <a href="#devspec">Ger&auml;te-Spezifikation</a>
+  f&uuml;r Details der &lt;devspec&gt;.<br>
+  
   <br>
-  Wenn value angegeben ist, der von ( DEF, TYPE, usw) oder
-  reading (actuator, measured-temp) f&uuml;r alle Ger&auml;te die in devspec angegeben 
-  sind.
+  Wenn value angegeben ist, der von ( DEF, TYPE, usw) oder reading (actuator,
+  measured-temp) f&uuml;r alle Ger&auml;te die in devspec angegeben sind.
   <br><br>
   Beispiel:
   <pre><code>  fhem&gt; list
@@ -870,9 +900,10 @@ Zeilen erstreckende Befehle, indem man keine \ am Zeilenende eingeben muss.</p>
   <ul>
     <code>set &lt;name&gt; ?</code>
   </ul>
-  Lesen Sie bitte den Abschnitt <a href="#devspec">Device specification</a>
-  f&uuml;r Details zu &lt;devspec&gt;. Der &quot;set&quot;-Befehl gibt nur bei
-  Fehler einen Wert zur&uuml;ck.
+  Siehe den Abschnitt &uuml;ber <a href="#devspec">Ger&auml;te-Spezifikation</a>
+  f&uuml;r Details der &lt;devspec&gt;.<br>
+
+  Der &quot;set&quot;-Befehl gibt nur bei Fehler einen Wert zur&uuml;ck.
   <br><br>
   Jedes Ger&auml;t hat verschiedene Parameter die mit &quot;set&quot; gesetzt
   werden k&ouml;nnen.  Lesen Sie bitte den entsprechenden Abschnitt f&uuml;r
@@ -936,11 +967,10 @@ Zeilen erstreckende Befehle, indem man keine \ am Zeilenende eingeben muss.</p>
   Der Befehl setzt den "STATUS&quot; f&uuml;r <code>&lt;name&gt;</code> , wie im Befehl
   <a href="#list">list</a> beschrieben, auf den Wert <code>&lt;value&gt;</code> 
   ohne an das Ger&auml;t ein Signal zu senden. Dieser Befehl wird auch im <a href="#statefile">statefile</a> 
-  benutzt.
-  Lesen Sie bitte den Abschnitt <a href="#devspec">Device specification</a>&nbsp; f&uuml;r 
-  Details zu
-  &lt;devspec&gt;.
-  <br><br>
+  benutzt.<br>
+  Siehe den Abschnitt &uuml;ber <a href="#devspec">Ger&auml;te-Spezifikation</a>
+  f&uuml;r Details der &lt;devspec&gt;.<br>
+  <br>
   Examples:
   <ul>
     setstate lamp on
@@ -975,10 +1005,10 @@ Zeilen erstreckende Befehle, indem man keine \ am Zeilenende eingeben muss.</p>
 <ul>
   <code>trigger &lt;devspec&gt; &lt;state&gt;</code>
   <br><br>
-  Triggert eine <a href="#notify">notify</a> Definition.
-  Siehe <a href="#devspec">Ger&auml;te-Spezifikation (devspec)</a>&nbsp;
-  f&uuml;r Details zu &lt;devspec&gt;.
-  <br><br>
+  Triggert eine <a href="#notify">notify</a> Definition.<br>
+  Siehe den Abschnitt &uuml;ber <a href="#devspec">Ger&auml;te-Spezifikation</a>
+  f&uuml;r Details der &lt;devspec&gt;.<br>
+  <br>
   Beispiel:
   <ul>
     <code>trigger btn3 on</code>
diff --git a/fhem/fhem.pl b/fhem/fhem.pl
index 59a221a60..808990163 100755
--- a/fhem/fhem.pl
+++ b/fhem/fhem.pl
@@ -231,6 +231,8 @@ $readingFnAttributes = "event-on-change-reading event-on-update-reading ".
             Hlp=>"<devspec> [<attrname>],delete user defined reading for <devspec>" },
   "delete"  => { Fn=>"CommandDelete",
 	    Hlp=>"<devspec>,delete the corresponding definition(s)"},
+  "displayattr"=> { Fn=>"CommandDisplayAttr",
+	    Hlp=>"<devspec> [attrname],display attributes" },
   "get"     => { Fn=>"CommandGet",
 	    Hlp=>"<devspec> <type dependent>,request data from <devspec>" },
   "help"    => { Fn=>"CommandHelp",
@@ -1490,6 +1492,42 @@ CommandDeleteAttr($$)
   return join("\n", @rets);
 }
 
+#############
+sub
+CommandDisplayAttr($$)
+{
+  my ($cl, $def) = @_;
+
+  my @a = split(" ", $def, 2);
+  return "Usage: displayattr <name> [<attrname>]\n$namedef" if(@a < 1);
+
+  my @rets;
+  my @devspec = devspec2array($a[0]);
+
+  foreach my $sdev (@devspec) {
+
+    if(!defined($defs{$sdev})) {
+      push @rets, "Please define $sdev first";
+      next;
+    }
+
+    my $ap = $attr{$sdev};
+    next if(!$ap);
+    my $d = (@devspec > 1 ? "$sdev " : "");
+
+    if(defined($a[1])) {
+      push @rets, "$d$ap->{$a[1]}" if(defined($ap->{$a[1]}));
+
+    } else {
+      push @rets, map { "$d$_ $ap->{$_}" } sort keys %{$ap};
+
+    }
+
+  }
+
+  return join("\n", @rets);
+}
+
 #############
 sub
 CommandDeleteReading($$)