2008-05-10 21:09:10 +00:00
|
|
|
<!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>
|
2010-02-27 10:09:32 +00:00
|
|
|
|
|
|
|
|
<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; }
|
2011-07-08 07:35:05 +00:00
|
|
|
h4 { color:#52865D; line-height:1.3;
|
|
|
|
|
margin-top:1.5em; font-family:Arial,Sans-serif; }
|
2010-02-27 10:09:32 +00:00
|
|
|
div#block { border:1px solid gray; background: #F8F8E0; padding:0.7em; }
|
|
|
|
|
div#dist { padding-top:0.3em; }
|
|
|
|
|
a { color: #278727; }
|
|
|
|
|
</style>
|
|
|
|
|
|
2008-05-10 21:09:10 +00:00
|
|
|
</head>
|
|
|
|
|
|
2010-02-27 10:09:32 +00:00
|
|
|
|
|
|
|
|
<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.
|
|
|
|
|
</ul>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<a name="Download"></a>
|
|
|
|
|
<h3>Download</h3>
|
|
|
|
|
<ul>
|
|
|
|
|
Current Version: (as of =DATE=):
|
2011-07-08 08:32:54 +00:00
|
|
|
<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> or
|
|
|
|
|
<a href="http://fhem.de/fhem-=VERS=-fb7390.image">fhem-=VERS=-fb7390.image</a> or
|
2010-02-27 10:09:32 +00:00
|
|
|
<br>
|
|
|
|
|
See the <a href="CHANGED">CHANGED</a> file for current changes.
|
2010-11-07 11:39:49 +00:00
|
|
|
<br>
|
2011-07-08 07:35:05 +00:00
|
|
|
Nightly CVS version: a
|
2010-11-07 11:39:49 +00:00
|
|
|
<a href="http://www.dhs-computertechnik.de/downloads/fhem-cvs.tgz">
|
2011-07-08 07:35:05 +00:00
|
|
|
tarball</a>, or from the fhem commandline via <a
|
|
|
|
|
href="commandref.html#updatefhem">updatefhem</a>. <br><br>
|
2010-11-07 11:39:49 +00:00
|
|
|
|
|
|
|
|
|
2010-12-26 08:39:58 +00:00
|
|
|
Please fill out our <a href="http://fhem.de/tinc?key=Erq0O0LU&formname=FHEM_used_modules">survey</a>,
|
2010-09-18 07:02:30 +00:00
|
|
|
as we'd like to know which FHEM modules are in use. Here are the <a
|
|
|
|
|
href="surveyresults.html">results</a>.
|
|
|
|
|
</ul>
|
2010-02-27 10:09:32 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
<a name="Screenshots"></a>
|
|
|
|
|
<h3>Frontend screenshots</h3>
|
|
|
|
|
<ul>
|
|
|
|
|
|
2010-07-06 12:31:04 +00:00
|
|
|
Builtin pgm2 / external pgm5 web frontend:
|
|
|
|
|
<a href="pgm2-1.png">overview</a>,
|
2011-03-13 08:46:36 +00:00
|
|
|
the same rendered for <a href="pgm2-4.png">smartphones</a>,
|
2010-07-06 12:31:04 +00:00
|
|
|
<a href="pgm2-2.png">detail</a>, <a
|
2010-02-27 10:09:32 +00:00
|
|
|
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>
|
|
|
|
|
|
2010-04-02 10:22:38 +00:00
|
|
|
fheME: <a href="http://www.phynx.de/?p=108"> screenshot gallery</a>
|
|
|
|
|
<br><br>
|
|
|
|
|
|
2010-02-27 10:09:32 +00:00
|
|
|
iPhone frontends:
|
2010-09-18 07:02:30 +00:00
|
|
|
<a href="itms://itunes.apple.com/us/app/fhemobile/id389951065?mt=8">Fhemobile</a> (native app),
|
2010-02-27 10:09:32 +00:00
|
|
|
<a href="http://www.gschaden.com/wp/2009/01/18/fhem-iphone-gateway/">
|
2010-03-23 09:03:04 +00:00
|
|
|
fhemgw</a>,
|
2010-02-27 10:09:32 +00:00
|
|
|
<a href="http://www.dhs-computertechnik.de/support-iphone.html">
|
2010-03-23 09:03:04 +00:00
|
|
|
dhs-computertechnik</a> or
|
|
|
|
|
<a href="http://code.google.com/p/phyfhem/">phyfhem</a>
|
2010-02-27 10:09:32 +00:00
|
|
|
</ul>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<a name="Features"></a>
|
|
|
|
|
<h3>Features</h3>
|
2008-12-12 11:07:36 +00:00
|
|
|
<ul>
|
2010-02-27 10:09:32 +00:00
|
|
|
<li>support for a lot of protocols used in house automation like FS20,
|
2011-07-08 07:35:05 +00:00
|
|
|
FHT, HMS, OneWire, X10, S300, EM, HomeMatic, KNX. See the <a
|
2010-02-27 10:09:32 +00:00
|
|
|
href="#Hardware">Hardware</a> section for more.
|
|
|
|
|
</li>
|
2011-07-08 07:35:05 +00:00
|
|
|
<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>
|
2010-02-27 10:09:32 +00:00
|
|
|
<li>logging events to files or databases, with regexp filters</li>
|
2011-07-08 07:35:05 +00:00
|
|
|
<li>notifying external programs or scripts when receiving certain
|
2010-02-27 10:09:32 +00:00
|
|
|
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
|
2010-04-02 10:22:38 +00:00
|
|
|
following protocols: FS20 (all devices), EM (EM1000EM, EM1000GZ and
|
2011-03-13 08:46:36 +00:00
|
|
|
EM1000WZ), FHT80b, HMS, S300 (KS300, S300TH, KS555, S555TH, etc),
|
|
|
|
|
HomeMatic (<a href="commandref.html#CUL_HM">selected</a> devices)</li>
|
|
|
|
|
<div id="dist"></div>
|
2010-02-27 10:09:32 +00:00
|
|
|
<li>Via an attached FHZ1000 or FHZ1300 access to the following protocols:
|
|
|
|
|
FS20 (all devices), FHT80b, HMS, KS300. <b>Note:</b> The FHZ1350 WLAN
|
|
|
|
|
works with fhem if you replace the standard (avisario) WLAN module with
|
|
|
|
|
one that won't encrypt the data.</li>
|
2011-03-13 08:46:36 +00:00
|
|
|
<div id="dist"></div>
|
2010-02-27 10:09:32 +00:00
|
|
|
|
2010-03-13 11:22:13 +00:00
|
|
|
<li>reading and sending X10 events via the CM11 module (with access
|
2010-02-27 10:09:32 +00:00
|
|
|
to a X10 computer interface)</li>
|
2011-03-13 08:46:36 +00:00
|
|
|
<div id="dist"></div>
|
2010-02-27 10:09:32 +00:00
|
|
|
|
|
|
|
|
<li>S300 devices via an attached WS300</li>
|
2011-03-13 08:46:36 +00:00
|
|
|
<div id="dist"></div>
|
2010-02-27 10:09:32 +00:00
|
|
|
|
|
|
|
|
<li>EM1010PC and attached EM1000WZ, EM1000EM or EM1000GZ</li>
|
2011-03-13 08:46:36 +00:00
|
|
|
<div id="dist"></div>
|
2010-02-27 10:09:32 +00:00
|
|
|
|
|
|
|
|
<li>reading attached SCIVT devices</li>
|
2011-03-13 08:46:36 +00:00
|
|
|
<div id="dist"></div>
|
2010-02-27 10:09:32 +00:00
|
|
|
|
|
|
|
|
<li>reading attached M232 devices</li>
|
2011-03-13 08:46:36 +00:00
|
|
|
<div id="dist"></div>
|
2010-02-27 10:09:32 +00:00
|
|
|
|
|
|
|
|
<li>reading attached WS2000/WS25000 devices, also via raw network
|
|
|
|
|
converters (xport)</li>
|
2011-03-13 08:46:36 +00:00
|
|
|
<div id="dist"></div>
|
2010-02-27 10:09:32 +00:00
|
|
|
|
|
|
|
|
<li>extract sensor data from IPWE networked weather data receiver</li>
|
2011-03-13 08:46:36 +00:00
|
|
|
<div id="dist"></div>
|
2010-02-27 10:09:32 +00:00
|
|
|
|
2010-02-28 19:25:10 +00:00
|
|
|
<li>Via an attached <a
|
2010-04-02 10:22:38 +00:00
|
|
|
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>
|
2010-08-14 11:42:46 +00:00
|
|
|
access to the following Dallas 1-wire sensors: DS18S20, DS1820,
|
|
|
|
|
DS18B20</li>
|
2011-03-13 08:46:36 +00:00
|
|
|
<div id="dist"></div>
|
2010-04-02 10:22:38 +00:00
|
|
|
|
|
|
|
|
<li>Via an attached KM271 access to the Buderus Logamatic 2107</li>
|
2011-03-13 08:46:36 +00:00
|
|
|
<div id="dist"></div>
|
2010-08-14 11:42:46 +00:00
|
|
|
|
|
|
|
|
<li>Allnet devices: Allnet 3076, Temperatures sensors and Allnet 4027
|
|
|
|
|
relay box connected to an Allnet 4000</li>
|
2011-03-13 08:46:36 +00:00
|
|
|
<div id="dist"></div>
|
2010-08-14 11:42:46 +00:00
|
|
|
|
|
|
|
|
<li>Davis VantagePro2 weatherstation</li>
|
2011-03-13 08:46:36 +00:00
|
|
|
<div id="dist"></div>
|
2010-08-14 11:42:46 +00:00
|
|
|
|
|
|
|
|
<li>RFXCOM RF receivers/transmitters e.g for different Oregon Scientific
|
|
|
|
|
weather sensors. Tested: BTHR918N, THGR810, THR128, THWR288A,
|
|
|
|
|
WTGR800.</li>
|
2011-03-13 08:46:36 +00:00
|
|
|
<div id="dist"></div>
|
2010-08-14 11:42:46 +00:00
|
|
|
|
|
|
|
|
<li>Via the ELV USB-WDE1 access to the S300/S555 family of sensors.</li>
|
2011-03-13 08:46:36 +00:00
|
|
|
<div id="dist"></div>
|
|
|
|
|
|
|
|
|
|
<li>Via an eQ-3 HomeMatic Lan Configurator access to selected HomeMatic
|
|
|
|
|
devices.
|
|
|
|
|
<div id="dist"></div>
|
|
|
|
|
|
2011-07-08 07:35:05 +00:00
|
|
|
<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>
|
|
|
|
|
<div id="dist"></div>
|
|
|
|
|
<div id="dist"></div>
|
|
|
|
|
|
|
|
|
|
A detailed description is to be found in the <a
|
|
|
|
|
href="commandref.html">fhem reference</a>.
|
|
|
|
|
|
2010-08-14 11:42:46 +00:00
|
|
|
|
2008-12-12 11:07:36 +00:00
|
|
|
</ul>
|
2010-02-27 10:09:32 +00:00
|
|
|
|
|
|
|
|
<a name="Documentation"></a>
|
|
|
|
|
<h3>Documentation</h3>
|
2008-12-12 11:07:36 +00:00
|
|
|
<ul>
|
2010-02-27 10:09:32 +00:00
|
|
|
|
|
|
|
|
<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>
|
|
|
|
|
|
2010-12-26 09:01:23 +00:00
|
|
|
<div id="dist">Our wiki at <a
|
2010-02-27 10:09:32 +00:00
|
|
|
href="http://fhemwiki.de/index.php/FHEM">fhemwiki.de</a></div>
|
|
|
|
|
|
2010-12-26 09:01:23 +00:00
|
|
|
<div id="dist">Frequently Asked Questions: <a
|
|
|
|
|
href="faq.html">faq.html</a></div>
|
2010-02-27 10:09:32 +00:00
|
|
|
|
2011-07-08 07:35:05 +00:00
|
|
|
<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>
|
|
|
|
|
|
2010-02-27 10:09:32 +00:00
|
|
|
<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>
|
|
|
|
|
|
2008-12-12 11:07:36 +00:00
|
|
|
</ul>
|
2010-02-27 10:09:32 +00:00
|
|
|
|
|
|
|
|
<a name="Links"></a>
|
|
|
|
|
<h3>Links</h3>
|
|
|
|
|
<ul>
|
2010-12-26 08:39:58 +00:00
|
|
|
Homepage: <a href="http://fhem.de/fhem.html">
|
|
|
|
|
http://fhem.de/fhem.html</a><br>
|
2010-02-27 10:09:32 +00:00
|
|
|
Development source at CVS@berlios: <a
|
|
|
|
|
href="http://developer.berlios.de/projects/fhem">
|
|
|
|
|
http://developer.berlios.de/projects/fhem</a><br>
|
|
|
|
|
<br>
|
|
|
|
|
|
|
|
|
|
Frontends:<br>
|
2009-05-23 07:32:08 +00:00
|
|
|
<ul>
|
2010-02-27 10:09:32 +00:00
|
|
|
<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):
|
2008-12-12 11:07:36 +00:00
|
|
|
<a href="http://www.fischer-net.de/projekte/haustechnik/myhce.html">
|
|
|
|
|
http://www.fischer-net.de/projekte/haustechnik/myhce.html</a><br>
|
2010-02-27 10:09:32 +00:00
|
|
|
<li>Frontend for the iPhone:
|
2009-01-18 11:11:39 +00:00
|
|
|
<a href="http://www.gschaden.com/wp/2009/01/18/fhem-iphone-gateway/">
|
2009-09-24 18:24:27 +00:00
|
|
|
http://www.gschaden.com/wp/2009/01/18/fhem-iphone-gateway/</a> or
|
|
|
|
|
<a href="http://www.dhs-computertechnik.de/support-iphone.html">
|
2010-02-27 10:09:32 +00:00
|
|
|
http://www.dhs-computertechnik.de/support-iphone.html</a>
|
2009-09-24 18:24:27 +00:00
|
|
|
<br>
|
2010-02-27 10:09:32 +00:00
|
|
|
<li>LinViex (home automation frontend):
|
2008-05-10 21:09:10 +00:00
|
|
|
<a href="http://sourceforge.net/projects/linviex">
|
2008-12-12 11:07:36 +00:00
|
|
|
http://sourceforge.net/projects/linviex</a><br>
|
2010-02-27 10:09:32 +00:00
|
|
|
</ul>
|
|
|
|
|
<br>
|
|
|
|
|
|
|
|
|
|
Device/OS Specific installation guides:<br>
|
|
|
|
|
<ul>
|
2011-07-08 07:35:05 +00:00
|
|
|
<li>Instructions for the Fritz!Box:
|
|
|
|
|
<a href="fritzbox7390.html">7390</a>, <a
|
|
|
|
|
href="http://fhemwiki.de/index.php/AVM_Fritz!Box">7170@fhemwiki</a>
|
|
|
|
|
and <a href="fritzbox.html">7170/7270</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>
|
2010-02-27 10:09:32 +00:00
|
|
|
<li>Linux driver installation:
|
2010-12-26 08:39:58 +00:00
|
|
|
<a href="http://fhem.de/linux.html">
|
|
|
|
|
http://fhem.de/linux.html</a></li>
|
2010-11-05 20:28:29 +00:00
|
|
|
<li>Misc USB problems:
|
2010-12-26 08:39:58 +00:00
|
|
|
<a href="http://fhem.de/USB.html">
|
|
|
|
|
http://fhem.de/USB.html</a></li>
|
2010-11-05 20:28:29 +00:00
|
|
|
<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>
|
2010-02-27 10:09:32 +00:00
|
|
|
<li>Windows driver installation:
|
2008-05-12 12:10:44 +00:00
|
|
|
<a href="http://fhz4linux.info/tiki-index.php?page=Driver%20installation">
|
|
|
|
|
http://fhz4linux.info/tiki-index.php?page=Driver%20installation</a> <br>
|
2010-02-27 10:09:32 +00:00
|
|
|
(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>
|
2011-07-08 07:35:05 +00:00
|
|
|
<h4>Fritz!Box 7390</h4>
|
|
|
|
|
<ul>
|
|
|
|
|
<li>Install a current Lab version first, then <a
|
|
|
|
|
href="http://fhem.de/fhem-=VERS=-fb7390.image">this</a> image, and
|
|
|
|
|
connect to http://localhost:8083/fhem. Follow the <a
|
|
|
|
|
href="HOWTO.html">HOWTO</a> for adding devices.
|
|
|
|
|
</ul>
|
2010-02-27 10:09:32 +00:00
|
|
|
|
2011-07-08 07:35:05 +00:00
|
|
|
<h4>Debian/Ubuntu</h4>
|
2010-08-02 12:47:55 +00:00
|
|
|
<ul>
|
2010-12-26 08:39:58 +00:00
|
|
|
<li>Install <a href="http://fhem.de/fhem-=VERS=.deb">
|
2011-03-13 08:46:36 +00:00
|
|
|
this</a> package, and connect to http://localhost:8083/fhem. Follow
|
|
|
|
|
the <a href="HOWTO.html">HOWTO</a> for adding devices.
|
|
|
|
|
</ul>
|
2010-08-02 12:47:55 +00:00
|
|
|
|
2011-07-08 07:35:05 +00:00
|
|
|
<h4>Unix / OSX</h4>
|
2010-02-27 10:09:32 +00:00
|
|
|
<ul>
|
|
|
|
|
<li>Make sure you have perl. Install the module Device::SerialPort with
|
2011-07-08 07:35:05 +00:00
|
|
|
"sudo cpan Device::SerialPort" (OSX user can skip this part).</li>
|
2010-02-27 10:09:32 +00:00
|
|
|
<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.
|
2010-08-03 08:02:53 +00:00
|
|
|
<li>Follow the <a href="HOWTO.html">HOWTO</a> for adding devices.
|
2010-02-27 10:09:32 +00:00
|
|
|
</ul>
|
|
|
|
|
|
2011-07-08 07:35:05 +00:00
|
|
|
<h4>Windows</h4>
|
2010-02-27 10:09:32 +00:00
|
|
|
<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 <configfile></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
|
2010-11-07 11:39:49 +00:00
|
|
|
are not described here.<br>
|
2010-02-27 10:09:32 +00:00
|
|
|
<b>Important:</b> Make sure you add some protection (.htaccess, etc)
|
2010-11-07 11:39:49 +00:00
|
|
|
else everybody will be able to set your devices.<br>
|
2010-02-27 10:09:32 +00:00
|
|
|
</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
|
2011-07-08 07:35:05 +00:00
|
|
|
plots, HTTP basicAuth, HTTPS and IPV6 (with the IO::Socket::SSL and
|
|
|
|
|
IO::Socket:INET6 perl modules)
|
|
|
|
|
<br>
|
2010-02-27 10:09:32 +00:00
|
|
|
|
|
|
|
|
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>
|
2011-07-08 07:35:05 +00:00
|
|
|
It installed by default, but it can be deconfigured.<br>
|
2010-02-27 10:09:32 +00:00
|
|
|
</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 <your-site>/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>
|
2009-11-16 11:49:16 +00:00
|
|
|
<ul>
|
2010-02-27 10:09:32 +00:00
|
|
|
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>
|
