HOWTO_DE.html 24 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
  2. <html xmlns="http://www.w3.org/1999/xhtml"><head>
  3. <title>Mit FHEM beginnen</title>
  4. <script type="text/javascript" src="fhemdoc.js"></script>
  5. <noscript>
  6. <link rel="stylesheet" type="text/css" href="../www/pgm2/style.css" />
  7. </noscript>
  8. <meta http-equiv="Content-type" content="text/html; charset=UTF-8">
  9. </head>
  10. <body>
  11. <div id="menuScrollArea">
  12. <div id="logo"></div>
  13. <div id="menu">
  14. <h3>FHEM Howto</h3>
  15. Version: <a href="HOWTO.html">EN</a>&nbsp;<b>DE</b>
  16. <br>
  17. <br>
  18. <table class="room">
  19. <tr><td></td></tr>
  20. <tr><td><b>Inhalt:</b></td></tr>
  21. <tr><td><a href="#starting">Start</a></td></tr>
  22. <tr><td><a href="#attaching">USB Geräte</a></td></tr>
  23. <tr><td><a href="#sensors">Sensoren</a></td></tr>
  24. <tr><td><a href="#actors">Aktoren</a></td></tr>
  25. <tr><td><a href="#at">At/Notify</a></td></tr>
  26. <tr><td><a href="#logging">Daten loggen</a></td></tr>
  27. <tr><td><a href="#plotting">Plotten</a></td></tr>
  28. <tr><td><a href="#security">Sicherheit</a></td></tr>
  29. <tr><td><a href="#fhemweb">Anpassungen</a></td></tr>
  30. <tr><td><a href="#structure">Strukturen</a></td></tr>
  31. <tr><td>
  32. </table>
  33. </div>
  34. </div>
  35. <div id="right">
  36. <a name="starting"></a>
  37. <h3>Mit FHEM beginnen</h3>
  38. <ul>
  39. Diesen Abschnitt k&ouml;nnen Sie &uuml;berspringen wenn Sie FHEM entweder mittels eines Debian-<a href="http://fhem.de/fhem-5.3.deb">Paketes</a> oder mittels
  40. einer <a href="http://fhem.de/fhem-5.3-fb7390.image">Imagedatei</a> auf der FRITZ!Box oder mittels des <a href="http://fhem.de/fhem-5.3-fb7270.zip">Zip-Files</a> f&uuml;r die FRITZ!Box 7170/7270
  41. installiert haben.
  42. <p>Viele FHEM-Installationen verbinden die Au&szlig;enwelt &uuml;ber ein USB-Ger&auml;t&nbsp; welches mit dem FHEM-Rechner verbunden ist (diese
  43. Ger&auml;te sind z.B. CUL, FHZ1x00, TUL, EUL etc). Diese Installationen ben&ouml;tigen
  44. die PERL serial-Module. In dem commandref-Abschnitt des jeweiligen USB-Ger&auml;tes sehen
  45. Sie, ob das entsprechende Modul ben&ouml;tigt wird.
  46. Sie ben&ouml;tigen dieses Modul nicht, wenn das Ger&auml;t &uuml;ber Ethernet angeschlossen wird (z.B. HM-LAN oder CUNO).</p>
  47. <p>Wenn Sie dieses Modul ben&ouml;tigen, k&ouml;nnen Sie es mit dem Kommando sudo cpan Device::SerialPort nachtr&auml;glich installieren. Es
  48. gibt aber auch schon bereits vorkompilierte Debian-Pakete (libdevice-serialport-perl) und im OSX 10.5 ist das Paket auch bereits enthalten. Wenn Sie das Paket
  49. nicht installieren k&ouml;nnen, dann schauen Sie sich die @directio-Option auf der commandref.html-Seite als m&ouml;gliche Informationsquelle an.</p>
  50. <p>Die Standard-Installation installiert FHEM in das Verzeichnis /opt/fhem.
  51. Wenn Sie jedoch lieber in ein anderes Verzeichnis installieren wollen, so
  52. &auml;ndern Sie das Installationsverzeichnis im Makefile von FHEM.</p>
  53. <p>Sie k&ouml;nnen FHEM auch direkt von dem Verzeichnis wo Sie es entpackt haben starten. Um FHEM zu entpacken und gleichzeitig zu
  54. starten geben Sie folgendes ein:</p>
  55. <pre> make
  56. cd /opt/fhem
  57. perl fhem.pl fhem.cfg</pre>
  58. <p>Danach sollten die Eintr&auml;ge im FHEM-Logfile des
  59. Log-Verzeichnisses wie folgend aussehen:</p>
  60. <pre> 2012.10.27 17:14:28 1: Including fhem.cfg
  61. 2012.10.27 17:14:28 3: WEB: port 8083 opened
  62. 2012.10.27 17:14:28 3: WEBphone: port 8084 opened
  63. 2012.10.27 17:14:28 3: WEBtablet: port 8085 opened
  64. 2012.10.27 17:14:28 1: Including /tmp/fhem.save
  65. 2012.10.27 17:14:28 3: telnetPort: port 7072 opened
  66. 2012.10.27 17:14:28 1: usb create starting
  67. 2012.10.27 17:14:28 1: usb create end
  68. 2012.10.27 17:14:28 2: SecurityCheck: ...
  69. 2012.10.27 17:14:28 0: Server started (version Fhem 5.3 ...</pre>
  70. <p>Die Sicherheits-Warnung sagt Ihnen, dass einige der
  71. FHEM-Webseiten ohne die Eingabe eines Passwortes ge&ouml;ffnet worden sind. Sie
  72. sollten entweder &uuml;r jede Webseite, wie weiter unten angegeben, ein
  73. Passwort festlegen oder das globale Attribut setzen um diese Meldung zu unterdr&uuml;cken wenn Sie sicher sind das kein Passwort ben&ouml;tigt werden soll.</p>
  74. </ul>
  75. <a name="attaching"></a>
  76. <h3>Anschlie&szlig;en des USB-Ger&auml;tes an den PC/die FRITZ!Box (CUL/FHZ1x00PC etc.)</h3>
  77. <ul>
  78. <p>Verbinden Sie sich mit FHEM indem Sie im Internet-Browser bei Verwendung eines normalen Desktop-Rechners
  79. <a href="http://fhem-host:8083/fhem">
  80. http://fhem-host:8083/fhem</a> oder bei Verwendung eines Smartphones <a href="http://fhem-host:8084/fhem">
  81. http://fhem-host:8084/fhem</a> oder bei Verwendung eines Tablets wie dem iPad <a href="http://fhem-host:8085/fhem">
  82. http://fhem-host:8085/fhem</a> eingeben.</p>
  83. <p><br>
  84. <b>Achtung:</b> In der Standardkonfiguration &uuml;r die FRITZ!Box ist die Passwortabfrage f&uuml;r alle FHEM-Webseiten voreingestellt. Der Benutzername
  85. kann frei bleiben, aber das einzugebende Passwort muss dem FRITZ!Box-Passwort entsprechen</p>
  86. <p>
  87. In der Standard-Konfiguration sucht FHEM beim Start nach &uuml;ber USB verbundenen Ger&auml;ten wie FHZ, CUL, COC, ZWave oder TCM und erstellt
  88. automatisch die entsprechenden Eintr&auml;ge in der fhem.cfg. Schlie&szlig;en Sie also diese Ger&auml;te vor dem Start von FHEM an.</p>
  89. <p>
  90. Unter dem Betriebssystem LINUX (speziell bei der FRITZ!Box 7390) wird FHEM
  91. versuchen einen bereits angesteckten aber noch unprogrammierten CUL zu
  92. programmieren. Details dazu entnehmen Sie bitte den Beschreibungen der
  93. Befehle usb und CUL flash in der commandref.html. Die neu angelegten
  94. Ger&auml;te werden im Raum/Men?unkt Unsorted angezeigt. Achtung: Die
  95. Umschaltung eines CUL in den HomeMatic Modus erfolgt nicht automatisch,
  96. sondern muss manuell erfolgen.<br><br>
  97. Um Ger&auml;te mit USB-Anschluss manuell zu definieren (oder falls FHEM diese nicht automatisch erkennt), schlie&szlig;en Sie das USB-Ger&auml;t (CUL,
  98. FHZ1000PC/FHZ1300, TUL, EUL, etc) zuerst an Ihren Computer an. Dann sehen Sie im Verzeichnis /dev nach der dort entsprechend eingetragenen
  99. Ger&auml;tebezeichnung. F&uuml;r einen CUL wird eine Datei mit der Bezeichnung /dev/ttyACM* unter dem Betriebssystem LINUX und /dev/cu.usbmodem* unter dem
  100. Betriebssystem OS x angelegt. Beachten Sie die exakte Bezeichnung des Ger&auml;tes. Definieren Sie es in FHEM, indem Sie folgenden Eintrag in die
  101. FHEM Kommandozeile der Webseite eingeben:</p>
  102. <pre> define CUL1 CUL /dev/ttyACM0@9600 1234</pre>
  103. <p>Details &uuml;ber die Parameter zur Definition eines CUL finden Sie <a href="commandref_DE.html#CUL">hier</a></p>
  104. <p>Ein <a href="commandref_DE.html#FHZ">FHZ-Ger&auml;t</a> wird ebenso, aber mit anderen Parametern, angelegt </p>
  105. </p>
  106. <pre> define FHZ1 FHZ /dev/ttyUSB0</pre>
  107. <p>
  108. <b>Achtung/Bemerkungen:</b> </p>
  109. <ul>
  110. <li>
  111. Vergessen Sie nicht, den save-Button neben der FHEM-Befehlseingabezeile nach der Eingabe einer Ger&auml;tedefinition oder
  112. eines Ger&auml;teattributes zu dr&uuml;cken. In diesem Fall werden die erfolgten Eingaben nicht in der Konfigurationsdatei gespeichert und bei einem
  113. Neustart von FHEM nicht mehr ber&uuml;cksichtigt.</p>
  114. </li>
  115. <li>
  116. Zur Ausf&uuml;hrung von in der FHEM Befehlszeile eingegebenen Anweisungen dr&uuml;cken
  117. Sie Enter auf der Tastatur. Bet&auml;tigen des save-Buttons
  118. f&uuml;hrt diese eingegebenen Anweisungen nicht aus.</p>
  119. </li>
  120. <li>
  121. Sie erhalten den CUL vom Hersteller ohne Firmware. Sie k&ouml;nnen ihn
  122. mittels des CULflash Kommandos programmieren wenn das Programm dfu-programmer
  123. im Verzeichnis fhem vorhanden ist. Das Programm dfu-programmer ist Bestandteil des Images f&uuml;r die FRITZ!Box 7390.</span></li></ul>
  124. </ul>
  125. <h3>
  126. Konfiguration der Sender (Sensoren)</h3>
  127. <ul>
  128. <p>Viele funkgesteuerte Ger&auml;te werden in der default-Konfiguration wegen
  129. der voreingestellten autocreate-Funktion automatisch erstellt.</p>
  130. <p>Diese Funktion erstellt automatisch diese Ger&auml;teeintragungen bei Empfang einer Nachricht von diesen Ger&auml;ten (z.B.
  131. eines Sensors wie dem S300 oder FHT). Bitte warten Sie eine gewisse Zeit, beobachten Sie die Logeintr&auml;ge und aktualisieren Sie Ihren Browser um neu
  132. erreichte Ger&auml;te angezeigt zu bekommen. Sie k&ouml;nnen den Befehl rename benutzen, um automatisch erstellte Ger&auml;teeintr&auml;ge umzubenennen. Geben Sie
  133. den Befehl mit den entsprechenden Parametern in der Befehlszeile der Webseite ein. Z.B.:</p>
  134. <br>
  135. <ul>
  136. <code>rename FHT_1234 fht.kitchen
  137. </code></ul>
  138. <br>
  139. <b>Achtung:</b>
  140. Wenn Sie das Ger&auml;t selbst umbenennen, werden auch die zugeh&ouml;rigen Logfiles und Weblinks automatisch mit umbenannt. Wenn Sie entweder die Weblinks
  141. oder Logfiles selbst umbenennen, werden die zugeh&ouml;rigen Ger&auml;te nicht mit umbenannt!<br><br>
  142. Wenn Sie das Ger&auml;t manuell umbenennen wollen, dann gehen Sie folgenderma&szlig;en vor:<br>
  143. <p>Warten Sie eine Weile bis Daten &uuml;bertragen werden. Im Logfile (zu erreichen unter Webseite Men&uuml;punkt Unsorted-&gt; FileLog -&gt; Logfile -&gt;
  144. text) erscheint z.B. folgende Textzeile:</p>
  145. <ul><code>
  146. FS20 Unknown device &lt;HOUSECODE&gt;, Button &lt;BTN&gt; Code
  147. &lt;CDE&gt;, please define it
  148. </code></ul>
  149. &nbsp;<p>Definieren Sie dieses neue Ger&auml;t mittels folgendem Eintrag:</p>
  150. <ul><code>
  151. define piri1 FS20 &lt;HOUSECODE&gt; &lt;BTN&gt;
  152. </code></ul>
  153. &nbsp;<p>Setzen sie das model-Attribut des Ger&auml;tes: </p>
  154. <ul><code>
  155. attr piri1 model fs20piri
  156. </code></ul>
  157. &nbsp;<p>um nur die f&uuml;r dieses Ger&auml;t verf&uuml;gbaren Attribute angezeigt zu bekommen.
  158. <a href="commandref_DE.html#model">Hier</a> sehen Sie eine
  159. komplette Liste der FS20 Modelle.<br>
  160. Bei einem anderen neuen Ger&auml;ten sollte eine &auml;hnliche Nachricht im Logfile
  161. erscheinen.</p>
  162. <p>HomeMatic Ger&auml;te m&uuml;ssen nicht mit FHEM gepairt werden, andererseits wird FHM solche Ger&auml;te
  163. nur automatisch eintragen wenn es eine pairing-Anfrage erh&auml;lt. Dazu m&uuml;ssen Sie FHEM
  164. mit dem Befehl set CUL hmPairForSec 600 in Empfangsbereitschaft versetzen.
  165. Gleiches Vorgehen gilt f&uuml;r das pairing von ZWave-Ger&auml;ten</p>
  166. </ul>
  167. <a name="actors"></a>
  168. <h3>Konfiguration von Empf&auml;ngern (Aktoren)</h3>
  169. <ul>
  170. Definieren Sie das <a href="commandref_DE.html#FS20">FS20</a> Ger&auml;t mit z.B folgendem Eintrag in die fhem.cfg:</p>
  171. <pre> define lamp1 FS20 1234 56</pre>
  172. <p>Dann dr&uuml;cken Sie den Anmeldeknopf an dem Ger&auml;t solange, bis die LED blinkt. Anschlie&szlig;end klicken sie auf den on Link
  173. auf der FHEM Webseite um das Kommando zu senden. Die LED sollte aufh&ouml;ren zu blinken. Das Ger&auml;t ist nun auf den Hauscode 1234 Ger&auml;tecode 56
  174. programmiert. Sie k&ouml;nnen alternativ die 4-base ELV-Notation benutzen.
  175. Anschlie&szlig;end k&ouml;nnen Sie modellspezifische Attribute &uuml;r das Ger&auml;t setzen.
  176. Z.B.:</p>
  177. <pre> attr lamp1 model fs20st</pre>
  178. <p>Mit diesem Eintrag bekommen Sie nunmehr nur die f&uuml;r dieses Ger&auml;t relevanten Kommandos angezeigt</p>
  179. <p>Andere Systeme (EnOcean/HomeMatic/ZWave) brauchen eine umfangreichere Prozedur und das entsprechende Ger&auml;t
  180. muss zuerst in den pairing mode versetzt werden. Bitte sehen Sie sich den entsprechenden Eintrag auf der commandref.html-Seite f&uuml;r Ihr Ger&auml;t zur
  181. Information an. </p>
  182. <p>Das automatische oder manuelle eintragen von FHT/HomeMatic/EnOcean-Ger&auml;ten in FHEM bedeutet nicht automatisch, dass der CUL oder die FHZ mit FHEM gepairt
  183. ist.</p>
  184. <ul>
  185. <li>FHT:<br>
  186. Damit FHT neue Ger&auml;te akzeptiert aktivieren Sie am FHT mit Prog:Cent:N/A
  187. und senden Sie ein Kommando an FHT (z.B. set fht.kitchen desired-temp 20).
  188. Wenn das Signal nach einer Weile nicht eingetroffen ist, lesen Sie sich
  189. bitte den entsprechenden Eintrag in den FAQ durch.<br>
  190. </li>
  191. <li>HomeMatic:<br>
  192. Versetzen Sie den CUL/HMLAN in den pairing-Modus mit dem Befehl:<ul><code>
  193. set CUL hmPairForSec 600
  194. </code></ul>
  195. <p>Dann dr&uuml;cken Sie den Anmeldeknopf am HomeMatic-Ger&auml;t. Wenn das pairing
  196. erfolgreich war sehen Sie CommandAccepted:
  197. yes im Detailfenster des Ger&auml;tes auf der FHEM Webseite.</li></ul>
  198. </ul>
  199. <a name="at"></a>
  200. <h3>Zeitabh&auml;ngige Kommandos (at)/Notifikationen (notify, watchdog)</h3>
  201. <ul>
  202. Um at-Kommandos zu einer bestimmten Zeit/periodisch
  203. auszuf&uuml;hren m&uuml;ssen Sie Ger&auml;te vom Typ at definieren. Entsprechende Beispiele und Definitionen finden Sie <a href="commandref_DE.html#at">hier</a>.</p>
  204. <br><br>
  205. Um Kommandos ausf&uuml;hren zu lassen wenn ein Ger&auml;t eine Nachricht aussendet, m&uuml;ssen Sie Ger&auml;te vom Typ <a href="commandref_DE.html#notify">notify</a> oder
  206. <a href="commandref_DE.html#watchdog">watchdog</a> definieren.
  207. Um die in FHEM auftretenden Ereignisse besser zu verstehen/erkennen sollten Sie eine Telnet-Verbindung zu Ihrem FHEM aufbauen. </span>
  208. Geben Sie z.B. in der Eingabeaufforderung folgendes ein:<ul>&nbsp;<p>
  209. <code>
  210. telnet &lt;fhemhost&gt; 7072
  211. </code></p>
  212. </ul><br>
  213. Nachdem die Verbindung aufgebaut wurde geben Sie ein:<br><br><ul><code>
  214. inform timer
  215. </code></ul><br>
  216. Nun sehen Sie in dieser telnet-Verbindung alle Ereignisse wie z.B.:<p>&nbsp;</p>
  217. <ul><code>
  218. 2011-12-16 21:51:55 FS20 myPiri on-for-timer 120
  219. </code></ul><br>
  220. Gem&auml;&szlig; diesem Eintrag k&ouml;nnen Sie eine Aktion wie folgt definieren:<br><br><ul><code>
  221. define lampNotify notify myPiri set myLamp on
  222. </code></ul>
  223. oder
  224. <ul><code>
  225. define lampNotify notify myPiri:on.* set myLamp on
  226. </code></ul><br>
  227. Um dieses notify zu testen k&ouml;nnen Sie die Ereignisse unter Verwendung des trigger-Kommandos simulieren. <span lang="EN-US">Z.B.:</span><p>&nbsp;</p>
  228. <ul><code>
  229. trigger myPiri on-for-timer 120
  230. </code></ul><br>
  231. &nbsp;<p>at, notify und watchdog verwenden entweder vordefinierte FHEM-Kommandos, SHELL-Scripte
  232. oder PERL-oneliners
  233. als Argumente. F&uuml;r Details und Tipps f&uuml;r perl onliners lesen Sie bitte die <a href="commandref_DE.html#perl">PERL-specials</a> Abschnitte in der commandref.html.</p>
  234. </ul>
  235. <a name="logging"></a>
  236. <h3>Daten loggen</h3>
  237. <ul>
  238. Um Daten/Nachrichten/Ereignisse in einer Datei zu speichern m&uuml;ssen Sie ein Ger&auml;t vom Typ <a href="commandref_DE.html#FileLog">FileLog</a>
  239. anlegen. Die Funktion autocreate erstellt
  240. f&uuml;r neu erkannte Ger&auml;te automatisch eine Logdatei. Sie k&ouml;nnen jedoch die Funktion <a href="commandref_DE.html#createlog">createlog</a> nutzen, um sp&auml;ter eine weitere Logdatei
  241. hinzuzu&uuml;gen.
  242. <p>Um Daten/Nachrichten/Ereignisse in einer Datenbank zu speichern informieren Sie sich im Verzeichnis contrib/dblog der FHEM Distribution.</p>
  243. <p><br>
  244. FHEMWEB hat eine vordefinierte Funktionen Anzeige von Dateien des Typs FileLog.
  245. Weitere Informationen im folgenden Abschnitt <a href="#plot">plot</a>.
  246. </p>
  247. <p>
  248. Die Ger&auml;te einer jeden Logdatei (<a href="commandref_DE.html#FileLog">FileLog</a>)wird durch die eingegebenen Logkriterien (z.B. Jahr/Monat/Woche/Tag)
  249. bestimmt. Sie k?nen das Archivieren mit den Attributen <a href="commandref_DE.html#nrarchive">nrarchive</a></span><span style="font-size: 11.0pt; line-height: 115%; font-family: Arial,sans-serif">
  250. oder <a href="commandref_DE.html#archivedir">archivecmd</a> erlauben.
  251. </p>
  252. </ul>
  253. <a name="plotting"></a>
  254. <h3>Inhalte von Logdateien plotten (zeichnen)</h3>
  255. <ul>
  256. <p>Die Funktion autocreate erstellt Weblinks (d.h. Plots) f&uuml;r neu erkannte Ger&auml;te. Der folgende Abschnitt beschreibt wie man
  257. z.B. Plots von unterschiedlichen Sensoren gemeinsam ausgibt.</p>
  258. <p>Die Daten f&uuml;r einen Plot stammen jeweils aus seiner FileLog-Datei. &auml;ndern Sie ggf. die Filterkriterien (regexp) wenn noch andere Daten geplottet werden sollen. Als n&auml;chsten Schritt setzen Sie das <a href="commandref_DE.html#logtype">logtype</a>
  259. Attribut des FileLog. Damit bestimmen Sie, welche Plotvorlagedatei (.gplot) benutzt werden soll. Die
  260. &uuml;bersicht &uuml;ber die vorhandenen gnuplot-Dateien
  261. finden Sie unter dem Men?unkt Edit files. Die gnuplot-Dateien enthalten die zugeh&ouml;rigen FileLog Beispiele.</p>
  262. <p>Beachten Sie bitte, dass die .gnuplot-Dateien ebenfalls bei der Darstellung von SVG anstelle des Gnuplot Backends benutzt werden. </span>
  263. </p>
  264. <p>
  265. Die gnuplot-Dateien m&uuml;ssen #Filelog-Eintr&auml;ge haben, damit sie mit gnuplot scroll oder SVG benutzt werden k&ouml;nnen (Diese Zeilen werden von gnuplot,
  266. aber nichrt von FHEM, als Kommentare behandelt). Wenn die Auswahl mittels der FileLog get-Funktion erfolgen soll, dann lesen Sie sich f&uuml;r die
  267. Syntax die mitgelieferten gnuplot-Dateien oder den column_spec Abschnitt hier durch.</p>
  268. <p>
  269. Beispiele:</p>
  270. <pre> attr em1000log logtype power8:Power,text
  271. attr fs20_log logtype fs20:Plot,text
  272. attr hms100th_log logtype temp4hum6:Plot,text
  273. </pre>
  274. <p>Lassen Sie sich das Diagramm (/denPlot) anzeigen, indem Sie darauf klicken und erstellen Sie einen <a href="commandref_DE.html#weblink">Weblink</a> der seine eigenen
  275. Attribute hat. Wenn der Weblink zur aktuellen Logdatei geh&ouml;rt, dann wird er als aktueller Weblink gespeichert und angezeigt (Sie m&uuml;ssen ihn nicht
  276. erneut definieren, wenn sich in seinem Dateinamen die Bezeichnungen f&uuml;r
  277. Jahr/Monat/Datum &auml;ndern).</p>
  278. <p>Die Logs k&ouml;nnen entweder mit gnuplot (welches im aktuellen Pfad installiert sein muss), oder mittels des im Programm
  279. enthaltenen SVG-Moduls erstellt werden. In diesem Fall muss Ihr Browser SVG unterst&uuml;tzen. Alle Browser unterst&uuml;tzen SVG, ausser dem Internet
  280. Explorer vor der Version 9 und Android vor der Version 3.0. Wenn Sie ein Ger&auml;t mit diesen Android-Versionen benutzen, dann versuchen Sie bitte als
  281. Browser Opera oder Firefox.</p>
  282. <p><br>Der voreingestellte Modus ist SVG. Um das zu &auml;ndern, setzen Sie die <a href="commandref_DE.html#plotmode">plotmode</a>
  283. Attribute auf gnuplot oder gnuplot scroll.<br><br>
  284. Um &auml;ltere Daten anzeigen zu lassen, erstellen Sie bitte einen anderen
  285. Weblink und setzen das fixedrange-Attribut auf z.B.:</p>
  286. <ul><code>
  287. attr weblink_1 fixedrange 2006-01-01 2007-01-01
  288. </code></ul>
  289. <p>Um fremde (nicht unter FHEM erfasste) Daten als Plot oder als normalen
  290. Text anzuzeigen, erstellen Sie bitte ein fake-Logfile
  291. mit dem korrekten Dateinamen und einer unbenutzten regexp, z.B.: </p>
  292. <pre> define messages FileLog /var/log/messages fakelog</pre>
  293. </ul>
  294. <a name="security"></a>
  295. <h3>Sicherheit</h3>
  296. <ul>
  297. <li>
  298. <p>Beide Standard TCP/IP Weboberfl&auml;chen in FHEM (telnet und FHEMWEB) k?nen mit einem Passwort und zus&auml;tzlich mit
  299. Verschl&ouml;sselung (HTTPS/SSL) gesichert werden.</p>
  300. &nbsp;<ul>
  301. <li>f&uuml;r <a href="commandref_DE.html#FHEMWEB">FHEMWEB</a>
  302. benutzen Sie die
  303. <a href="commandref_DE.html#basicAuth">basicAuth</a>
  304. und
  305. <a href="commandref_DE.html#HTTPS">HTTPS</a>
  306. Attribute
  307. </li><li>f&uuml;r <a href="commandref_DE.html#telnet">telnet</a> (welches
  308. mehr oder weniger ein TCP/IP Port ist) benutzen Sie die
  309. <a href="commandref_DE.html#password">password</a> und
  310. <a href="commandref_DE.html#SSL">SSL</a> Attribute
  311. </li></ul>
  312. <p>Das ist jedoch nicht der Standard f&uuml;r die meisten Konfigurationen und es ist der Grund weshalb Sie eine
  313. Sicherheitswarnung nach der Installation erhalten.</p>
  314. <br></li>
  315. <li>
  316. <p>Ein anderer Weg, einen sicheren Zugriff von Aussen auf FHEM zu erhalten, ist es eine VPN-Verbindung zu verwenden. Die
  317. Verbindung z.B. zu einer FRITZ!Box mittels VPN funktioniert sowohl f&uuml;r Ger&auml;te mit iOS als auch mit Android Betriebssystemen obwohl letzteres im
  318. Setup komplizierter ist.</p>
  319. <br></li>
  320. <li>
  321. <p>Sie k&ouml;nnen FHEM ebenfalls durch Nutzung eines Apache-Servers absichern, indem Sie basicAuth/HTTPS als Prefix
  322. f&uuml;r Ihre FHEMWEB Instanz aktivieren. F&uuml;gen Sie die folgenden Zeilen ihrer Datei http.conf des Apache-Servers hinzu.</p>
  323. <pre> &lt;Proxy *&gt;
  324. AuthType Basic
  325. AuthName "Password Required"
  326. AuthUserFile /home/httpd/etc/passwd
  327. Require valid-user
  328. Allow from 127.0.0.1
  329. &lt;/Proxy&gt;
  330. ProxyPass /fhem http://localhost:8083/fhem
  331. ProxyPassReverse /fhem http://localhost:8083/fhem</pre>
  332. Dann starten Sie den Apache-Server erneut mit dem Kommando apachectl
  333. graceful. Um die Passwortdatei zu erzeugen geben Sie bitte folgende
  334. Befehlszeile ein:
  335. <ul><code>
  336. htpasswd -c /home/httpd/etc/passwd &lt;username&gt;
  337. </code></ul>
  338. Eine ausf&uuml;hrlichere Dokumentation findet man <a
  339. href="http://fhemwiki.de/wiki/Apache_Authentication_Proxy">hier</a>, eine
  340. noch bessere, mit client/server Zertifikaten <a
  341. href="https://gist.github.com/gbirke/8608543">hier</a>.
  342. <br><br>
  343. Um das Protokoll HTTPS zu verwenden editieren Sie die http.conf folgenderma&szlig;en:<p>
  344. <br>
  345. <ul>
  346. <li>f&uuml;gen Sie folgende Zeilen hinzu:
  347. <pre>LoadModule ssl_module lib/apache/mod_ssl.so
  348. Include /etc/httpd/conf/ssl.conf</pre></li>
  349. <li>erstellen Sie ein Server-Zertifikat</li>
  350. </ul>
  351. <p>&nbsp;<ul>
  352. <li>
  353. <p>Starten Sie den httpd-Deamon mit der startssl-Option (SSL muss in einer Ihrer Systemdateien, z.B. /etc/init.d/http),
  354. gesetzt sein.</li>
  355. </ul>
  356. </li></ul>
  357. <a name="fhemweb"></a>
  358. <h3>FHEMWEB (pgm2) anpassen</h3>
  359. <ul>
  360. <p>Es macht Sinn, Ihre Ger&auml;te in R&auml;umen zu gruppieren, indem Sie das group-Attribut setzen. FHEMWEB zeigt Ger&auml;te
  361. ohne Raum-Attribut im Raum (Men&uuml;punkt) Unsorted. F&uuml;gen Sie Ger&auml;ten das hidden Raumattribut
  362. hinzu, so werden diese Ger&auml;te nicht auf der Webseite
  363. angezeigt.</p>
  364. <br>
  365. Sie k&ouml;nnen ein k&uuml;rzeres Men&uuml; auf der Webseite erzeugen, indem Sie
  366. Men&uuml;punkte die nicht angezeigt werden sollen mit dem Attribut <a href="commandref_DE.html#hiddenroom">hiddenroom</a>
  367. versehen.<p><br>
  368. Farben und Schriften k&ouml;nnen Sie durch Anpassung der Datei style.css &auml;ndern
  369. (Edit files -&gt; style.css) oder Sie erstellen Ihren eigenen Stil (siehe
  370. auch <a href="commandref_DE.html#stylesheetPrefix">stylesheetPrefix</a>)
  371. dann wird Ihr neuer Stil auch nicht beim n&auml;chsten Ausf&uuml;hren des <a href="commandref_DE.html#updatefhem">update</a><span style="font-size: 11.0pt; line-height: 115%; font-family: Arial,sans-serif">-Kommandos
  372. &uuml;berschrieben.
  373. <br><br>
  374. </p>
  375. </ul>
  376. <a name="structure"></a>
  377. <h3>Komplexe Strukturen</h3>
  378. <ul>
  379. <p>
  380. Definieren Sie Ihre Ger&auml;te in verschiedenen R&auml;umen. Dann k&ouml;nnen Sie die room=&lt;roomname&gt; Spezifikation verwenden um gleichzeitig verschiedene Ger&auml;te auf einmal anzusprechen. Details entnehmen sie bitten dem&nbsp; <a href="commandref_DE.html#devspec">
  381. devspec</a>
  382. Abschnitt.</p>
  383. <p>F&uuml;r noch komplexere Szenarien informieren sie sich bitte &uuml;ber das <a href="commandref_DE.html#structure">structure</a>-Modul.
  384. Sie k&ouml;nnen verschiedene Ebenen wie Flure, Geb&auml;ude usw. definieren und alle
  385. Ger&auml;te einer definierten Struktur auf einmal ansprechen.</p>
  386. </ul>
  387. </div>
  388. </body></html>