2
0
mirror of https://github.com/fhem/fhem-mirror.git synced 2025-01-31 12:49:34 +00:00
fhem-mirror/fhem/docs/fhem.html

374 lines
14 KiB
HTML
Raw Normal View History

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>Home of FHEM</title>
<script type="text/javascript" src="fhemdoc.js"></script>
<noscript>
<link rel="stylesheet" type="text/css" href="../www/pgm2/style.css" />
</noscript>
<meta http-equiv="Content-type" content="text/html;charset=ISO-8859-1"/>
<link rel="shortcut icon" href="favicon.ico"/>
</head>
<body>
<div id="menuScrollArea">
<div id="logo"></div>
<div id="menu">
Version: <b>EN</b>&nbsp;<a href="fhem_DE.html">DE</a>
<table><tr><td> <!-- Playing with the width -->
<table class="room">
<tr><td></td></tr>
<tr><td><b>Content:</b></td></tr>
<tr><td></td></tr>
<tr><td><a href="#Description">Description</a></td></tr>
<tr><td></td></tr>
<tr><td><a href="#Download">Download</a></td></tr>
<tr><td></td></tr>
<tr><td><a href="#Screenshots">Screenshots</a></td></tr>
<tr><td></td></tr>
<tr><td><a href="#Features">Features</a></td></tr>
<tr><td></td></tr>
<tr><td><a href="#Protocols">Protocols</a></td></tr>
<tr><td></td></tr>
<tr><td><a href="#Documentation">Documentation</a></td></tr>
<tr><td></td></tr>
<tr><td><a href="#Links">Links</a></td></tr>
<tr><td></td></tr>
<tr><td><a href="#Installation">Installation</a></td></tr>
<tr><td></td></tr>
<tr><td><a href="#License">License</a></td></tr>
<tr><td></td></tr>
</table>
</td></tr></table>
<img src="cloudfree.png"/>
</div>
</div>
<div id="right">
<a name="Description"></a>
<h3>Description</h3>
<ul>
Fhem is a GPL'd perl server for house automation. It is used to automate
some common tasks in the household like switching lamps / shutters /
heating / etc. and to log events like temperature / humidity / power
consumption.<br><br>
The program runs as a server, you can control it via web or smartphone
frontends, telnet or TCP/IP directly.<br><br>
In order to use FHEM you'll need a 24/7 server (Fritz!Box, NAS, RPi, PC,
MacMini, etc) with a perl interpreter and some attached hardware like the
CUL, FHZ1300PC, etc. to access the actors and sensors. See the "Supported
hardware" section below.</ul>
<a name="Download"></a>
<h3>Download</h3>
<ul>
Last released version: (as of =DATE=):
<a href="http://fhem.de/fhem-=VERS=.tar.gz">fhem-=VERS=.tar.gz</a>,
<a href="http://fhem.de/fhem-=VERS=.deb">fhem-=VERS=.deb</a>,
<a href="http://fhem.de/fhem-=VERS=-fb7390.image">fhem-=VERS=-fb7390.image</a>,
<a href="http://fhem.de/fhem-=VERS=-fb7270.zip">fhem-=VERS=-fb7270.zip</a>
<br>
See the <a href="CHANGED">CHANGED</a> file for the change history or the
<a href="SVNLOG">svn log</a> for a more detailed log.
<br>
Nightly SVN version: a
<a href="http://www.dhs-computertechnik.de/downloads/fhem-cvs.tgz">
tarball</a>, or from the fhem commandline via <a
href="commandref.html#update">update</a>. <br><br>
Please fill out our <a href="survey.pl">survey</a>,
as we'd like to know which FHEM modules are in use. Here are the <a
href="surveyresults.html">results</a>.<br>
Or use the fheminfo command to automatically generate <a
href="/stats/statistics.html">this</a> statistics.
</ul>
<a name="Screenshots"></a>
<h3>Frontend screenshots</h3>
<ul>
<li>Builtin web frontend: overview on the
<a href="pgm2-1.png">desktop</a> or on the
<a href="pgm2-3.png">smartphone</a>,
<a href="pgm2-2.png">SVG-plots</a>.</li>
<div class="dist"></div>
<li>The FHEM FLOORPLAN module:
<a href="tirreG.jpg">Example1</a>,
<a href="Benji.png">Example2</a>.</li>
<div class="dist"></div>
<li>Charting frontend
<a href="http://www.fhemwiki.de/wiki/Neues_Charting_Frontend">in
fhemwiki</a>.</li>
<div class="dist"></div>
<li>YAF (Yet another frontend), see the introduction in the <a
href="http://forum.fhem.de/index.php/topic,12629.0.html">forum
duscussion</a>.</li>
<div class="dist"></div>
<li>pgm3 web frontend:
<a href="http://www.martin-haas.de/fhz/screenshots.html">screenshot
gallery</a></li>
<div class="dist"></div>
<li>myHCE:
<a href="http://www.fischer-net.de/hausautomation/myhce/screenshots.html">
screenshot gallery</a></li>
<div class="dist"></div>
<li>fheME: <a href="http://www.phynx.de/?p=108"> screenshot gallery</a>
</li>
<div class="dist"></div>
<li>HomeMini: <a
href="http://heimserver.nendzig.net/wiki/index.php/HomeMini">
screenshot & download</a></li>
<div class="dist"></div>
<li>iPhone frontends:
<a href="itms://itunes.apple.com/us/app/fhemobile/id389951065?mt=8">Fhemobile</a> (native app),
<a href="http://www.dhs-computertechnik.de/support-iphone.html">
dhs-computertechnik</a> or
<a href="http://code.google.com/p/phyfhem/">phyfhem</a></li>
<div class="dist"></div>
<li>Android frontends:
<a href="http://andFHEM.klass.li">andFHEM</a> (native app),
<a href="http://forum.fhem.de/index.php/topic,10628.0.html">
Fullscreen Browser App</a>,
<a href="http://forum.fhem.de/index.php/topic,12624.0.html">ORCA addition</a>,
<a href="http://www.homegroup.de/index.php/android/notify-app">notify-app</a>
</li>
<div class="dist"></div>
</ul>
<a name="Features"></a>
<h3>Features</h3>
<ul>
<li>support for a lot of protocols used in house automation, audio/video
devices, weather services, online calendars and more.
</li>
<div class="dist"></div>
<li>autocreating devices/logs when receiving data from a new device:
start FHEM and watch how the plots of your sensors are appearing
automatically.</li>
<div class="dist"></div>
<li>logging events to files or a database, with regexp filters</li>
<div class="dist"></div>
<li>notifying external programs or scripts when receiving certain
events</li>
<div class="dist"></div>
<li>timed commands (e.g. switching a lamp on from sunset till midnight)
</li>
<div class="dist"></div>
<li>lot of interfaces: simple text, JSON, XML, each of them over plain
TCP/IP, SSL or HTTP.
<div class="dist"></div>
<li>modular architecture with currently over 150 modules, easy to add
your special device</li>
<div class="dist"></div>
<li>lot of frontends, choose your favorite</li>
<div class="dist"></div>
</ul>
<a name="Protocols"></a>
<h3>Supported protocols</h3>
<ul>
<li>eQ3 specific: FS20, HomeMatic, MAX!, EM1000, FHT80b, HMS, S300,
ESA2000</li>
<div class="dist"></div>
<li>KNX, ZWave, EnOcean, X10, FRITZ!Dect, Intertechno, HomeEasy,
Philipps HUE</li>
<div class="dist"></div>
<li>1Wire, Firmata, webio, panStamp, LIRC, JeeLink, RFXCOM/RFXTRX, TellStick</li>
<div class="dist"></div>
<li>Davis VantagePro2, Oregon Scientific, Allnet</li>
<div class="dist"></div>
<li>TVs from Samsung/Panasonic/LG/Philips, devices from Sonos/Squeezebox,
amplifier from Yamaha/Denon/Onkyo, iTunes/AppleTV, Enigma2, XBMC</li>
<div class="dist"></div>
<br>
A complete list of all FHEM-modules with a detailed description can be
found in the <a href="commandref.html">commandref</a> document.
</ul>
<a name="Documentation"></a>
<h3>Documentation</h3>
<ul>
<div class="dist"><a href="Heimautomatisierung-mit-fhem.pdf">
Heimautomatisierung-mit-fhem.pdf</a> (pdf, german)</div>
<div class="dist"></div>
<div class="dist"><a href="HOWTO.html">HOWTO.html</a> for a short
installation/configuration.</div>
<div class="dist"></div>
<div class="dist"><a href="commandref.html">commandref.html</a>
contains a detailed description of all features/modules.</div>
<div class="dist"></div>
<div class="dist">Our wiki at <a
href="http://fhemwiki.de/index.php/FHEM">fhemwiki.de</a></div>
<div class="dist"></div>
<div class="dist">Frequently Asked Questions: <a
href="faq.html">faq.html</a></div>
<div class="dist"></div>
<div class="dist">Forum: <a href="http://forum.fhem.de">
http://forum.fhem.de</a><br>Although most entries are in german here,
don't be afraid to ask something in english.</div>
<div class="dist"></div>
<div class="dist"><a href="README.contrib">contrib/README</a> describes
some loosely coupled useful modules / scripts which can be used with
FHEM.</div>
<div class="dist"></div>
</ul>
<a name="Links"></a>
<h3>Links</h3>
<ul>
Homepage: <a href="http://fhem.de/fhem.html">
http://fhem.de/fhem.html</a><br>
Development source at SVN@sourceforge: <a
href="https://sourceforge.net/p/fhem/code/HEAD/tree/trunk/fhem/">
https://sourceforge.net/p/fhem/code/HEAD/tree/trunk/fhem/</a><br>
<br>
Device/OS Specific installation guides:<br>
<ul>
<li>Instructions for the <a href="fritzbox.html">Fritz!Box</a></li>
<li>Instructions for Nas/Routers (NSLU2):
<a href="http://www.martin-haas.de/fhz/nslu2fhz">
http://www.martin-haas.de/fhz/nslu2fhz</a></li>
<li>Instructions for Synology Diskstation / Rackstation:
<a href="http://www.fischer-net.de/hausautomation/fhem.html">
http://www.fischer-net.de/hausautomation/fhem.html</a></li>
<li>Instructions for the Allnet all6250:
<a href="http://wiki.dungeon.de/all6250_opennas_mit_fhem">
http://wiki.dungeon.de/all6250_opennas_mit_fhem</a></li>
<li>Raspberry PI with <a href="http://www.enocean.com/fileadmin/redaktion/pdf/white_paper/wp_Raspberry_talks_EnOcean.pdf">EnOcean</a></li>
<li>Linux driver installation:
<a href="linux.html">linux.html</a></li>
<li>Misc USB problems:
<a href="USB.html">USB.html</a></li>
<li>Russels Blog for Windows user:
<a href="http://russellallen.info/category/FHEM.aspx">
http://russellallen.info/category/FHEM.aspx</a> <br>
<li>Windows driver installation:
<a href="http://fhz4linux.info/tiki-index.php?page=Driver%20installation">
http://fhz4linux.info/tiki-index.php?page=Driver%20installation</a> <br>
(use "Solution B", only COM1..COM9 is supported)</li>
</ul>
<br>
Commercial products:
<ul>
<li><a href="http://www.dhs-computertechnik.de/">
http://www.dhs-computertechnik.de</a>:
Integration of FHZ and NAS running FHEM. Using an enhanced
transmitter to achieve more distant transmission. Full integrated
solution for Home-Control and beyond (other service like UPS management,
etc. are also available).
<br>
<li>CUL:
<a href=http://shop.busware.de/product_info.php?products_id=29">
Hardware shop</a>,
<a href="http://culfw.de/culfw.html">firmware homepage</a>,
<a href="http://groups.google.com/group/cul-fans">
CUL fans google group</a></li>
</ul>
</ul>
<a name="Installation"></a>
<h3>Installation</h3>
<ul>
<h4>Fritz!Box</h4>
<ul>
<li>On the FB7390 or FB7490 install <a
href="http://fhem.de/fhem-=VERS=-fb7390.image">this</a> image. Note: it
is needed <i>additionally</i> to the OS image from AVM.<br>
<li>On the FB7270 unpack <a
href="http://fhem.de/fhem-=VERS=-fb7270.zip">this</a> zip file to a USB-Disk,
attach the disk to the FritzBox, log in, and start FHEM from there.
<li>See also the detailed documentation <a href="fritzbox.html">here</a>.
</ul>
<h4>Debian/Ubuntu</h4>
<ul>
<li>Install <a href="http://fhem.de/fhem-=VERS=.deb">this</a> package.
<b>Note:</b> For upgrading from 5.2 or earlier it is necessary to purge
the old package (dpkg -P fhem), as the directory structure has changed to
be the same as with .tar.gz or fritzbox.
</ul>
<h4>Unix / OSX</h4>
<ul>
<li>Make sure you have perl. Most certainly you will need the
Device::SerialPort perl module, install it with "sudo cpan
Device::SerialPort" or "apt-get install libdevice-serialport-perl".
</li>
<li>Download the <a href="http://fhem.de/fhem-=VERS=.tar.gz">
.tar.gz</a> package, unpack it, and change to the unpacked directory.
<li>start FHEM directly from this directory (perl fhem.pl fhem.cfg).
</ul>
<h4>Windows</h4>
<ul>
<li>See the <a href="HOWTO_Windows.html">HOWTO_Windows.html</a> for a
detailed description.</li>
<li>If you are using cygwin for your perl installation you can
follow the guidelines for Unix.</li>
</ul>
<br><br>
After the installation follow the <a href="HOWTO.html">HOWTO</a> for adding
devices or try out the demo configuration by starting fhem with:<br>
<ul><code>
perl fhem.pl fhem.cfg.demo
</code></ul>
</ul>
<a name="License"></a>
<h3>License:</h3>
<ul>
Copyright:<br>
<ul>
<li>Rudolf Koenig (r dot koenig at koeniglich dot de. Note: I <b>do
not</b> provide fhem-support via private mail, use the forum
instead)</li>
<li>Martin Haas (webfrontends/pgm3)</li>
<li>Olaf Droegehorn (webfrontends/pgm5)</li>
<li><a href="MAINTAINER.txt">Numerous other people with their FHEM modules</a></li>
</ul>
License: GPL (v2)<br>
Thanks to TOSTi for inspiration and numerous other people for help. <br>
</ul>
</body>
</html>