2
0
mirror of https://github.com/fhem/fhem-mirror.git synced 2025-01-31 06:39:11 +00:00
fhem-mirror/fhem/docs/fhem.html

516 lines
20 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>
<style type="text/css">
body { background-color: #FFFFE7;}
#left { position:absolute; top:20px; left:20px; width:140px; }
#right { position:absolute; top:20px; left:180px; bottom:20px; right:10px; }
body>div#left { position:fixed; }
h3 { color:#52865D; line-height:1.3;
margin-top:1.5em; font-family:Arial,Sans-serif; }
h4 { color:#52865D; line-height:1.3;
margin-top:1.5em; font-family:Arial,Sans-serif; }
div#block { border:1px solid gray; background: #F8F8E0; padding:0.7em; }
div#dist { padding-top:0.3em; }
a { color: #278727; }
</style>
</head>
<body>
<div id="left">
<img src="fhem.png">
<br>
<br>
<div id="block">
<b>Content:</b>
<div id="dist"></div>
<div id="dist"><a href="#Description">Description</a></div>
<div id="dist"><a href="#Download">Download</a></div>
<div id="dist"><a href="#Screenshots">Screenshots</a></div>
<div id="dist"><a href="#Features">Features</a></div>
<div id="dist"><a href="#Hardware">Hardware</a></div>
<div id="dist"><a href="#Documentation">Documentation</a></div>
<div id="dist"><a href="#Links">Links</a></div>
<div id="dist"><a href="#Installation">Installation</a></div>
<div id="dist"><a href="#License">License</a></div>
</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-frontends,
telnet, command line program or TCP/IP directly.<br><br>
In order to use fhem you'll need a 24/7 server (PC, MacMini, Fritz!Box,
NAS, etc) with a perl interpreter and some hardware to access the
devices, see the "Supported hardware" section below. Some of the fhem
hardware-modules need special perl modules (e.g. Device::SerialPort) in
order to work, see the corresponding section in the commandref.html.
</ul>
<a name="Download"></a>
<h3>Download</h3>
<ul>
Current 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.image">fhem-=VERS=-fb7270.zip</a>
<br>
See the <a href="CHANGED">CHANGED</a> file for current changes.
<br>
Nightly CVS 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#updatefhem">updatefhem</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>.
</ul>
<a name="Screenshots"></a>
<h3>Frontend screenshots</h3>
<ul>
Builtin pgm2 / external pgm5 web frontend:
<a href="pgm2-1.png">overview</a>,
the same rendered for <a href="pgm2-4.png">smartphones</a>,
<a href="pgm2-2.png">detail</a>, <a
href="pgm2-3.png">SVG-plots</a>.
<br><br>
pgm3 web frontend: <a
href="http://www.martin-haas.de/fhz/screenshots.html">screenshot
gallery</a>
<br><br>
myHCE: <a
href="http://www.fischer-net.de/projekte/haustechnik/screenshots.html">
screenshot gallery</a>
<br><br>
fheME: <a href="http://www.phynx.de/?p=108"> screenshot gallery</a>
<br><br>
HomeMini: <a
href="http://heimserver.nendzig.net/wiki/index.php/HomeMini">
screenshot & download</a>
<br><br>
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>
</ul>
<a name="Features"></a>
<h3>Features</h3>
<ul>
<li>support for a lot of protocols used in house automation like FS20,
OneWire, X10, HomeMatic, KNX, EnOcean. See the <a
href="#Hardware">Hardware</a> section for more.
</li>
<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>
<li>logging events to files or databases, with regexp filters</li>
<li>notifying external programs or scripts when receiving certain
events</li>
<li>timed commands (e.g. switching a lamp on from sunset till midnight)
</li>
<li>watchdog (e.g. trigger if the HMS100-FIT is inactive for HH:MM:SS)
</li>
<li>modular architecture, easy to add your special device</li>
<li>different web frontends, choose your favorite</li>
</ul>
<a name="Hardware"></a>
<h3>Supported hardware</h3>
<ul>
<li>Via an attached CUL or CUN (see <a
href="http://www.busware.de">www.busware.de</a>) access to the
following protocols: FS20 (all devices), EM (EM1000EM, EM1000GZ and
EM1000WZ), FHT80b, HMS, S300 (KS300, S300TH, KS555, S555TH, etc),
HomeMatic (<a href="commandref.html#CUL_HM">selected</a> devices),
La Crosse TX2/TX3.</li>
<div id="dist"></div>
<li>Via an attached FHZ1000 or FHZ1300 access to the following protocols:
FS20 (all devices), FHT80b, HMS, KS300. <b>Note:</b> For the WLAN
version of the FHZ1300 see this <a
href="http://www.thinkwiki.org/wiki/User:Akw/FHZ">
link</a>.
</li>
<div id="dist"></div>
<li>reading and sending X10 events via the CM11 module (with access
to a X10 computer interface)</li>
<div id="dist"></div>
<li>S300 devices via an attached WS300</li>
<div id="dist"></div>
<li>EM1010PC and attached EM1000WZ, EM1000EM or EM1000GZ</li>
<div id="dist"></div>
<li>reading attached SCIVT devices</li>
<div id="dist"></div>
<li>reading attached M232 devices</li>
<div id="dist"></div>
<li>reading attached WS2000/WS25000 devices, also via raw network
converters (xport)</li>
<div id="dist"></div>
<li>extract sensor data from IPWE networked weather data receiver</li>
<div id="dist"></div>
<li>Via an attached <a
href="http://owfs.org/index.php?page=usb-ds9490r">DS9490R</a> or <a
href="http://owfs.org/index.php?page=com-ds9097-passive">DS9097</a>
access to the following Dallas 1-wire sensors: DS18S20, DS1820,
DS18B20</li>
<div id="dist"></div>
<li>Via an attached KM271 access to the Buderus Logamatic 2107</li>
<div id="dist"></div>
<li>Allnet devices: Allnet 3076, Temperatures sensors and Allnet 4027
relay box connected to an Allnet 4000</li>
<div id="dist"></div>
<li>Davis VantagePro2 weatherstation</li>
<div id="dist"></div>
<li>RFXCOM RF receivers/transmitters e.g for different Oregon Scientific
weather sensors. Tested: BTHR918N, THGR810, THR128, THWR288A,
WTGR800.</li>
<div id="dist"></div>
<li>Via the ELV USB-WDE1 access to the S300/S555 family of sensors.</li>
<div id="dist"></div>
<li>Via an eQ-3 HomeMatic Lan Configurator access to selected HomeMatic
devices.
<div id="dist"></div>
<li>Via the eibd or a TUL (see <a
href="http://www.busware.de">www.busware.de</a>) access to the EIB/KNX
protocol.
<div id="dist"></div>
<li>Via a TCM120 (e.g. the BSC BOR) or a TCM310 (e.g. busware EUL) access
to the EnOcean protocol.
<div id="dist"></div>
<div id="dist"></div>
<div id="dist"></div>
A detailed description is to be found in the <a
href="commandref.html">fhem reference</a>.
</ul>
<a name="Documentation"></a>
<h3>Documentation</h3>
<ul>
<div id="dist"><a href="fhem-fuer-Einsteiger_V1.pdf">fhem fuer
Einsteiger</a> (pdf, german)</div>
<div id="dist"><a href="HOWTO.html">HOWTO.html</a> for a short
installation/configuration.</div>
<div id="dist"><a href="commandref.html">commandref.html</a>
contains a detailed description of all features/modules.</div>
<div id="dist">Our wiki at <a
href="http://fhemwiki.de/index.php/FHEM">fhemwiki.de</a></div>
<div id="dist">Frequently Asked Questions: <a
href="faq.html">faq.html</a></div>
<div id="dist">Google-Group: <a
href="http://groups.google.com/group/fhem-users">
http://groups.google.com/group/fhem-users</a><br>Although most entries
are in german here, don't be afraid to ask something in english.</div>
<div id="dist"><a href="README.contrib">contrib/README</a> describes
some loosely coupled useful modules / scripts which can be used with
fhem.</div>
<div id="dist">Protocol descriptions and other useful stuff: <a
href="http://fhz4linux.info/">http://fhz4linux.info/</a></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 CVS@berlios: <a
href="http://developer.berlios.de/projects/fhem">
http://developer.berlios.de/projects/fhem</a><br>
<br>
Frontends:<br>
<ul>
<li>Martins Web frontend (webpgm3):
<a href="http://www.martin-haas.de/fhz">http://www.martin-haas.de/fhz</a><br>
<li>Another Martins Web frontend (myHCE):
<a href="http://www.fischer-net.de/projekte/haustechnik/myhce.html">
http://www.fischer-net.de/projekte/haustechnik/myhce.html</a><br>
<li>Frontend for the iPhone:
<a href="http://www.gschaden.com/wp/2009/01/18/fhem-iphone-gateway/">
http://www.gschaden.com/wp/2009/01/18/fhem-iphone-gateway/</a> or
<a href="http://www.dhs-computertechnik.de/support-iphone.html">
http://www.dhs-computertechnik.de/support-iphone.html</a>
<br>
<li>LinViex (home automation frontend):
<a href="http://sourceforge.net/projects/linviex">
http://sourceforge.net/projects/linviex</a><br>
</ul>
<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 the Allnet all6250:
<a href="http://wiki.dungeon.de/all6250_opennas_mit_fhem">
http://wiki.dungeon.de/all6250_opennas_mit_fhem</a></li>
<li>Linux driver installation:
<a href="http://fhem.de/linux.html">
http://fhem.de/linux.html</a></li>
<li>Misc USB problems:
<a href="http://fhem.de/USB.html">
http://fhem.de/USB.html</a></li>
<li>Russels Blog for Windows user:
<a href="http://www.eclipcecreate.co.uk/category/FHEM.aspx">
http://www.eclipcecreate.co.uk/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://www.koeniglich.de/culfw/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>See the detailed documentation <a href="fritzbox.html">here</a>, and
after installation connect to http://localhost:8083/fhem. Follow the <a
href="HOWTO.html">HOWTO</a> for adding devices.
</ul>
<h4>Debian/Ubuntu</h4>
<ul>
<li>Install <a href="http://fhem.de/fhem-=VERS=.deb">
this</a> package, and connect to http://localhost:8083/fhem. Follow
the <a href="HOWTO.html">HOWTO</a> for adding devices.
</ul>
<h4>Unix / OSX</h4>
<ul>
<li>Make sure you have perl. Install the module Device::SerialPort with
"sudo cpan Device::SerialPort" (OSX user can skip this part).</li>
<li>Check the Makefile for the installation path, then type make
install-pgm2.</li>
<li>Check the installed configuration file and start fhem as advised.
<li>Follow the <a href="HOWTO.html">HOWTO</a> for adding devices.
</ul>
<h4>Windows</h4>
<ul>
<b>Note:</b>If you are using cygwin for your perl installation you can
follow the guidelines for Unix.<br><br>
<li>Be sure you have perl.exe in your path (%PATH%), and the module
Win32::SerialPort is installed.</li>
<li>Make sure that you can access the serial USB device via virtual
COM-Port or via socket(e.g. <code>COMX or xport:10001</code>).</li>
<li>Create a configuration file (see the examples directory and
docs/commandref.html)</li>
<li>Start the server with <code>fhem.pl &lt;configfile&gt;</code></li>
</ul>
<br><br>
<div id="block">
<b>General notes for webfrontends:</b><br>
You don't have to install all of them, one is probably more than
enough :-).<br>
The numbering has historical reasons: not actively maintained versions
are not described here.<br>
<b>Important:</b> Make sure you add some protection (.htaccess, etc)
else everybody will be able to set your devices.<br>
</div>
<h3>Web frontend 2 (webfrontend/pgm2)</h3>
<ul>
This frontend is a FHEM module implementing a HTTP server, no further
programs are needed. It has support for grouping devices into rooms,
manipulating devices, direct fhem commands, displaying logfiles as text
or plot (SVG builtin or PNG by gnuplot), navigating/zooming in the
plots, HTTP basicAuth, HTTPS and IPV6 (with the IO::Socket::SSL and
IO::Socket:INET6 perl modules)
<br>
Screenshots: <a href="pgm2-1.png">overview</a>, <a
href="pgm2-2.png">detail</a>, <a href="pgm2-3.png">SVG-plots</a>.
<br><br>
It installed by default, but it can be deconfigured.<br>
</ul>
<h3>Web frontend 3 (webfrontend/pgm3)</h3>
<ul>
This frontend is PHP based and was contributed by Martin Haas.
Look at the webfrontends/pgm3/docs for more documentation.
A lot more details <a
href="http://www.martin-haas.de/fhz/screenshots.html">and screenshots</a>
can be found on Martins page: <a href="http://www.martin-haas.de/fhz">
http://www.martin-haas.de/fhz</a><br>
pgm3 may run on an other machine than fhem.<br> The Devices of 95% of the
users are detected and configured automatically. Further 4% are
adaptable by the function UserDef. See config.php for explanation.
<br><br>
Installation:
<ul>
<li>Install PHP5, the php5-Apache-Modules, gnuplot and php5-gd. Every
current distribution should do all the needed configuration without
your input.</li>
<li>Create a directory in the Apache2 DocumentRoot
(e.g.: /var/www/pgm3) and copy all the files from the
webfrontend/pgm3 to this directory.<br>Make sure that this directory
is writeable by the webserver (e.g. User www-data.www-data)!</li>
<li>Call &lt;your-site&gt;/pgm3/index.php and follow the instructions
on screen</li>
<li>The official WIKI of pgm3 is now <a
href="http://fhemwiki.de">http://fhemwiki.de</a></li>
<li>Troubleshooting: right-click on the graphic then "show
graphic".</li>
</ul>
</ul>
<h3>Web frontend 5 (webfrontend/pgm5)</h3>
<ul>
This frontend is CGI/CSS based. It has support for rooms, and FHT/KS300
logs. This webfrontend is an update of the former pgm2 (up to 4.2): It
resides in YOUR HTTP server, and doesn't provide an own, like the FHEMWEB
module does.<br><br>
Why to use this:<br>
1) If you want to stick with your Web-Servers (due to restrictions,
ports or any other reason)<br>
2) If you have a NAS (Network attached storage) and limited CPU-Power.
This frontend can render the graphics in the background (in
intervals) and sends only the rendered graphics to the HTML-Page.<br>
3) If you need the FHEMRENDERER to render the images for other/own
pages.<br>
<br>
A lot more details can be found on <a
href="http://www.dhs-computertechnik.de/support.html">http://www.dhs-computertechnik.de/support.html</a>
<br><br>
Installation:
<ul>
<li>Copy the file fhemweb.pl and *.css to your cgi-bin directory
(/home/httpd/cgi-bin), the icons (*.gif) to your httpd icons
(/home/httpd/icons), and commandref.html to the html directory
(/home/httpd/html) (or also to cgi-bin directory).<br>
Note: The program looks for icons in the following order: <br>
'device-name.state', 'device-name', 'device-type.state',
'device-type'</li>
<li>The *.gplot files should be reused from the built-in FHEMWEB and
should reside in the installed FHEM directory. Here we don't provide
specific *.gplot files as the mechanisms are exactly the same.</li>
<li>If you want to have access to plotted logs, then make sure that
gnuplot is installed and set the logtype for the FileLog device (see
commandref.html and example/04_log). Copy the file
contrib/99_weblink.pm to the installed FHEM directory.</li>
<li>Copy the file pgm5/02_FHEMRENDERER.pm to the installed FHEM
directory. This gives you a graphic rendering engine (gnuplot &
gnuplot-scroll at the moment), which can be configured to renderer
images in intervals.</li>
<li>Call 'your-site'/cgi-bin/fhemweb.pl </li>
</ul>
</ul>
</ul>
<a name="License"></a>
<h3>License:</h3>
<ul>
Copyright:<br>
<ul>
<li>Rudolf Koenig (r dot koenig at koeniglich dot de)</li>
<li>Raoul Matthiessen (webfrontends/pgm1)</li>
<li>Martin Haas (webfrontends/pgm3)</li>
<li>Olaf Droegehorn (webfrontends/pgm5)</li>
</ul>
License: GPL (v2)<br>
Thanks to TOSTi for inspiration and numerous other people for help. <br>
</ul>
</body>
</html>