fhem.html 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
  2. "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
  3. <html xmlns="http://www.w3.org/1999/xhtml">
  4. <head>
  5. <title>Home of FHEM</title>
  6. <script type="text/javascript" src="fhemdoc.js"></script>
  7. <noscript>
  8. <link rel="stylesheet" type="text/css" href="../www/pgm2/style.css" />
  9. </noscript>
  10. <meta http-equiv="Content-type" content="text/html;charset=ISO-8859-1"/>
  11. <link rel="shortcut icon" href="favicon.ico"/>
  12. </head>
  13. <body>
  14. <div id="menuScrollArea">
  15. <div id="logo"></div>
  16. <div id="menu">
  17. Version: <b>EN</b>&nbsp;<a href="fhem_DE.html">DE</a>
  18. <table><tr><td> <!-- Playing with the width -->
  19. <table class="room">
  20. <tr><td></td></tr>
  21. <tr><td><b>Content:</b></td></tr>
  22. <tr><td></td></tr>
  23. <tr><td><a href="#Description">Description</a></td></tr>
  24. <tr><td></td></tr>
  25. <tr><td><a href="#Download">Download</a></td></tr>
  26. <tr><td></td></tr>
  27. <tr><td><a href="#Screenshots">Screenshots</a></td></tr>
  28. <tr><td></td></tr>
  29. <tr><td><a href="#Features">Features</a></td></tr>
  30. <tr><td></td></tr>
  31. <tr><td><a href="#Protocols">Protocols</a></td></tr>
  32. <tr><td></td></tr>
  33. <tr><td><a href="#Documentation">Documentation</a></td></tr>
  34. <tr><td></td></tr>
  35. <tr><td><a href="#Links">Links</a></td></tr>
  36. <tr><td></td></tr>
  37. <tr><td><a href="#Installation">Installation</a></td></tr>
  38. <tr><td></td></tr>
  39. <tr><td><a href="#License">License</a></td></tr>
  40. <tr><td></td></tr>
  41. <tr><td><hr/></td></tr>
  42. <tr><td><b>FHEM Links:</b></td></tr>
  43. <tr><td></td></tr>
  44. <tr><td><a href="https://forum.fhem.de" target="_blank">Forum</a></td></tr>
  45. <tr><td></td></tr>
  46. <tr><td><a href="https://svn.fhem.de/" target="_blank">SVN</a></td></tr>
  47. <tr><td></td></tr>
  48. <tr><td><a href="https://wiki.fhem.de" target="_blank">Wiki</a></td></tr>
  49. <tr><td></td></tr>
  50. <tr><td><a href="https://forum.fhem.de/index.php/board,90.0.html" target="_blank">Verein</a></td></tr>
  51. <tr><td></td></tr>
  52. <tr><td></td></tr>
  53. </table>
  54. </td></tr></table>
  55. <img id="cloudfree" src="cloudfree.png"/>
  56. </div>
  57. </div>
  58. <div id="right">
  59. <a name="Description"></a>
  60. <h3>Description</h3>
  61. <ul>
  62. FHEM (TM) is a GPL'd perl server for house automation. It is used to
  63. automate some common tasks in the household like switching lamps /
  64. shutters / heating / etc. and to log events like temperature / humidity
  65. / power consumption.<br><br>
  66. The program runs as a server, you can control it via web or smartphone
  67. frontends, telnet or TCP/IP directly.<br><br>
  68. In order to use FHEM you'll need a 24/7 server (Fritz!Box, NAS, RPi, PC,
  69. MacMini, etc) with a perl interpreter and some attached hardware like the
  70. CUL, FHZ1300PC, etc. to access the actors and sensors. See the "Supported
  71. hardware" section below.
  72. <br><br>
  73. It is pronounced without the h, like in feminine.</ul>
  74. <a name="Download"></a>
  75. <h3>Download</h3>
  76. <ul>
  77. Last released version: (as of 2017-02-19):
  78. <a href="http://fhem.de/fhem-5.8.tar.gz">fhem-5.8.tar.gz</a>,
  79. <a href="http://fhem.de/fhem-5.8.deb">fhem-5.8.deb</a>,
  80. <br>
  81. See the <a href="CHANGED">CHANGED</a> file for the change history or the
  82. <a href="SVNLOG">svn log</a> for a more detailed log.<br><br>
  83. <b>Note</b>: the FHEM development is a continuous one, and a release is
  84. only a starting point for the update process.<br>
  85. Use the <a href="commandref.html#update">update</a> command to get the
  86. most recent version, especially if you want to report issues in the
  87. forum.<br>
  88. Nightly versions:
  89. <a href="http://www.dhs-computertechnik.de/downloads/fhem-cvs.tgz">
  90. fhem-cvs.tgz</a>, <a href="http://debian.fhem.de/">debian.fhem.de</a>
  91. <br><br>
  92. Please use <a href="commandref.html#fheminfo">fheminfo</a> command to
  93. automatically generate <a href="/stats/statistics.html">this</a>
  94. statistics as we'd like to know which FHEM modules are in use.
  95. </ul>
  96. <a name="Screenshots"></a>
  97. <h3>Frontend screenshots</h3>
  98. <ul>
  99. <li>Builtin web frontend: overview on the
  100. <a href="pgm2-1.png">desktop</a> or on the
  101. <a href="pgm2-3.png">smartphone</a>,
  102. <a href="pgm2-2.png">SVG-plots</a>.</li>
  103. <div class="dist"></div>
  104. <li>The FHEM FLOORPLAN module:
  105. <a href="tirreG.jpg">Example1</a>,
  106. <a href="Benji.png">Example2</a>,
  107. <a href="forum_22336.jpg">LCars</a>.</li>
  108. <div class="dist"></div>
  109. <li>The <a href="InfoPanel.png">InfoPanel</a> module,
  110. FHEM Tablet UI</a>: <a href="TabletUI_1.png">Example1</a>,
  111. <a href="TabletUI_2.png">Example2</a>
  112. and <a href="SmartVisu.png">SmartVisu</a>
  113. </li><div class="dist"></div>
  114. <li>The <a href="https://wiki.fhem.de/wiki/Neues_Charting_Frontend">
  115. Charting frontend</a> and
  116. <a href="http://forum.fhem.de/index.php/topic,12629.0.html">YAF</a>
  117. (Yet Another Frontend).
  118. </li><div class="dist"></div>
  119. <li>myHCE: <a
  120. href="http://www.fischer-net.de/hausautomation/myhce/screenshots.html">
  121. screenshot gallery</a>,
  122. HomeMini:
  123. <a href="http://heimserver.nendzig.net/wiki/index.php/HomeMini">
  124. screenshot & download</a>
  125. </li><div class="dist"></div>
  126. <li>iPhone frontends:
  127. <a href="itms://itunes.apple.com/us/app/fhemobile/id389951065?mt=8">
  128. Fhemobile</a> (native app),
  129. <a href="http://www.dhs-computertechnik.de/support-iphone.html">
  130. dhs-computertechnik</a> or
  131. <a href="http://code.google.com/p/phyfhem/">phyfhem</a></li>
  132. <div class="dist"></div>
  133. <li>Android frontends:
  134. <a href="http://andFHEM.klass.li">andFHEM</a> (native app),
  135. <a href="http://forum.fhem.de/index.php/topic,10628.0.html">
  136. Fullscreen Browser App</a>,
  137. <a href="http://forum.fhem.de/index.php/topic,12624.0.html">ORCA addition</a>
  138. </li>
  139. <div class="dist"></div>
  140. </ul>
  141. <a name="Features"></a>
  142. <h3>Features</h3>
  143. <ul>
  144. <li>support for a lot of protocols used in house automation, audio/video
  145. devices, weather services, online calendars and more.
  146. </li>
  147. <div class="dist"></div>
  148. <li>autocreating devices/logs when receiving data from a new device:
  149. start FHEM and watch how the plots of your sensors are appearing
  150. automatically.</li>
  151. <div class="dist"></div>
  152. <li>logging events to files or a database, with regexp filters</li>
  153. <div class="dist"></div>
  154. <li>notifying external programs or scripts when receiving certain
  155. events</li>
  156. <div class="dist"></div>
  157. <li>timed commands (e.g. switching a lamp on from sunset till midnight)
  158. </li>
  159. <div class="dist"></div>
  160. <li>lot of interfaces: simple text, JSON, XML, each of them over plain
  161. TCP/IP, SSL or HTTP.
  162. <div class="dist"></div>
  163. <li>modular architecture with currently over 250 modules, easy to add
  164. your special device</li>
  165. <div class="dist"></div>
  166. <li>lot of frontends, choose your favorite</li>
  167. <div class="dist"></div>
  168. </ul>
  169. <a name="Protocols"></a>
  170. <h3>Supported protocols (excerpt)</h3>
  171. <ul>
  172. <li>eQ3 specific: FS20, HomeMatic, MAX!, EM1000, FHT80b, HMS, S300,
  173. ESA2000</li>
  174. <div class="dist"></div>
  175. <li>KNX, ZWave, EnOcean, X10, FRITZ!Dect, Intertechno, HomeEasy,
  176. Philipps HUE</li>
  177. <div class="dist"></div>
  178. <li>1Wire, Firmata, webio, panStamp, LIRC, JeeLink, RFXCOM/RFXTRX, TellStick</li>
  179. <div class="dist"></div>
  180. <li>Davis VantagePro2, Oregon Scientific, Allnet</li>
  181. <div class="dist"></div>
  182. <li>TVs from Samsung/Panasonic/LG/Philips, devices from Sonos/Squeezebox,
  183. amplifier from Yamaha/Denon/Onkyo, iTunes/AppleTV, Enigma2, XBMC</li>
  184. <div class="dist"></div>
  185. <br>
  186. A complete list of all FHEM-modules with a detailed description can be
  187. found in the <a href="commandref.html">commandref</a> document.
  188. </ul>
  189. <a name="Documentation"></a>
  190. <h3>Documentation</h3>
  191. <ul>
  192. <div class="dist"><a href="Heimautomatisierung-mit-fhem.pdf">
  193. Heimautomatisierung-mit-fhem.pdf</a> (pdf, german)</div>
  194. <div class="dist"></div>
  195. <div class="dist"><a href="commandref.html">commandref.html</a>
  196. contains a detailed description of all features/modules.</div>
  197. <div class="dist"></div>
  198. <div class="dist">Our wiki at <a
  199. href="https://wiki.fhem.de">https://wiki.fhem.de</a></div>
  200. <div class="dist"></div>
  201. <div class="dist">Forum: <a href="https://forum.fhem.de">
  202. https://forum.fhem.de</a><br>Although most entries are in german here,
  203. don't be afraid to ask something in english.</div>
  204. <div class="dist"></div>
  205. <div class="dist"><a href="http://meintechblog.de/category/fhem">
  206. meintechblog.de</a>: Blog with guides focused on FHEM</dist>
  207. <div class="dist"></div>
  208. <div class="dist">Frequently Asked Questions: <a
  209. href="faq.html">faq.html</a></div>
  210. <div class="dist"></div>
  211. <div class="dist"><a href="HOWTO.html">HOWTO.html</a> for a short
  212. installation/configuration.</div>
  213. <div class="dist"></div>
  214. <div class="dist"><a href="README.contrib">contrib/README</a> describes
  215. some loosely coupled useful modules / scripts which can be used with
  216. FHEM.</div>
  217. <div class="dist"></div>
  218. </ul>
  219. <a name="Links"></a>
  220. <h3>Links</h3>
  221. <ul>
  222. Homepage: <a href="http://fhem.de/fhem.html">
  223. http://fhem.de/fhem.html</a><br>
  224. Development source: <a href="https://svn.fhem.de">
  225. https://svn.fhem.de</a><br>
  226. <br>
  227. Device/OS Specific installation guides:<br>
  228. <ul>
  229. <li>Instructions for the <a href="fritzbox.html">Fritz!Box</a></li>
  230. <li>Instructions for Nas/Routers (NSLU2):
  231. <a href="http://www.martin-haas.de/fhz/nslu2fhz">
  232. http://www.martin-haas.de/fhz/nslu2fhz</a></li>
  233. <li>Instructions for Synology Diskstation / Rackstation:
  234. <a href="http://www.fischer-net.de/hausautomation/fhem.html">
  235. http://www.fischer-net.de/hausautomation/fhem.html</a></li>
  236. <li>Instructions for the Allnet all6250:
  237. <a href="http://wiki.dungeon.de/all6250_opennas_mit_fhem">
  238. http://wiki.dungeon.de/all6250_opennas_mit_fhem</a></li>
  239. <li>Raspberry PI with <a href="http://www.enocean.com/fileadmin/redaktion/pdf/white_paper/wp_Raspberry_talks_EnOcean.pdf">EnOcean</a></li>
  240. <li>Linux driver installation:
  241. <a href="linux.html">linux.html</a></li>
  242. <li>Misc USB problems:
  243. <a href="USB.html">USB.html</a></li>
  244. <li>Russels Blog for Windows user:
  245. <a href="http://russellallen.info/category/FHEM.aspx">
  246. http://russellallen.info/category/FHEM.aspx</a> <br>
  247. <li>Windows driver installation:
  248. <a href="http://fhz4linux.info/tiki-index.php?page=Driver%20installation">
  249. http://fhz4linux.info/tiki-index.php?page=Driver%20installation</a> <br>
  250. (use "Solution B", only COM1..COM9 is supported)</li>
  251. </ul>
  252. <br>
  253. Commercial products:
  254. <ul>
  255. <li><a href="http://www.dhs-computertechnik.de/">
  256. http://www.dhs-computertechnik.de</a>:
  257. Integration of FHZ and NAS running FHEM. Using an enhanced
  258. transmitter to achieve more distant transmission. Full integrated
  259. solution for Home-Control and beyond (other service like UPS management,
  260. etc. are also available).
  261. <br>
  262. <li>CUL:
  263. <a href=http://shop.busware.de/product_info.php?products_id=29">
  264. Hardware shop</a>,
  265. <a href="http://culfw.de/culfw.html">firmware homepage</a>
  266. </ul>
  267. </ul>
  268. <a name="Installation"></a>
  269. <h3>Installation</h3>
  270. <ul>
  271. <h4>Debian/Ubuntu</h4>
  272. <ul>
  273. <li>Install <a href="http://fhem.de/fhem-5.8.deb">this</a> package.
  274. For a better integration check out <a
  275. href="http://debian.fhem.de/">debian.fhem.de</a>
  276. </ul>
  277. <h4>Unix / OSX</h4>
  278. <ul>
  279. <li>Make sure you have perl. Most certainly you will need the
  280. Device::SerialPort perl module, install it with "sudo cpan
  281. Device::SerialPort" or "apt-get install libdevice-serialport-perl".
  282. </li>
  283. <li>Download the <a href="http://fhem.de/fhem-5.8.tar.gz">
  284. .tar.gz</a> package, unpack it, and change to the unpacked directory.
  285. <li>start FHEM directly from this directory (perl fhem.pl fhem.cfg).
  286. </ul>
  287. <h4>Windows</h4>
  288. <ul>
  289. <li>See the <a href="HOWTO_Windows.html">HOWTO_Windows.html</a> for a
  290. detailed description.</li>
  291. <li>If you are using cygwin for your perl installation you can
  292. follow the guidelines for Unix.</li>
  293. </ul>
  294. <h4>Fritz!BOX</h4>
  295. <ul>
  296. As of Fritz!OS 6.20 AVM decided to remove all possibilities to start
  297. "foreign" programs automatically after a reboot, that is why I advise
  298. against deploying FHEM on the Fritz!BOX, see also <a
  299. href="http://forum.fhem.de/index.php?topic=25066.0">this</a> discussion
  300. (in german). If you still insist:
  301. <li>On the FB7390 or FB7490 install <a
  302. href="http://fhem.de/fhem-5.8-fb7390.image">this</a> image. Note: it
  303. is needed <i>additionally</i> to the OS image from AVM.<br>
  304. <li>On the FB7270 unpack <a
  305. href="http://fhem.de/fhem-5.8-fb7270.zip">this</a> zip file to a
  306. USB-Disk, attach the disk to the FritzBox, log in, and start FHEM from
  307. there.
  308. </ul>
  309. <br><br>
  310. After the installation follow the <a href="HOWTO.html">HOWTO</a> for adding
  311. devices or try out the demo configuration by starting fhem with:<br>
  312. <ul><code>
  313. perl fhem.pl fhem.cfg.demo
  314. </code></ul>
  315. </ul>
  316. <a name="License"></a>
  317. <h3>License:</h3>
  318. <ul>
  319. Copyright:<br>
  320. <ul>
  321. <li>Rudolf Koenig (r dot koenig at koeniglich dot de. Note: I <b>do
  322. not</b> provide fhem-support via private mail, use the forum
  323. instead)</li>
  324. <li><a href="MAINTAINER.txt">Numerous other people with their FHEM modules</a></li>
  325. </ul>
  326. License: GPL (v2)<br><br>
  327. Thanks to TOSTi for inspiration. <br>
  328. </ul>
  329. <footer><center><a href="Impressum.html">Impressum / Datenschutz</a></center></footer>
  330. </body>
  331. </html>