Home of FHEM

GPL'd server for house automation. Formerly known as fhz1000.pl

Current Version: (as of =DATE=) is =VERS=
See the CHANGED file for current changes, or the webfrontends section for screenshots.

Description

fhem

Via the FHZ module (with access to one or more FHZ1000/FHZ1300 device):
- reading and sending FS20 events (on/off/dimming, timer commands)
- support of FS20 address features function group, local and global master
- reading and changing FHT80b parameters (temp, actuator, etc).
  The FHT8b seems to work too. Note: the FHT8 wont work.
  Internal software buffer to prevent lost commands.
- reading HMS data (HMS100-T,-TF,-WD,-MG,-TFK,-CO,-FIT and RM100-2,3)
- reading KS300 data
Note: The FHZ1350 WLAN works with fhem if you replace the standard (AVISARIO) WLAN module with one that won't encrypt the data.
Via the CM11 module (with access to a X10 computer interface):
- reading all X10 events
- sending X10 events (on/off/dimming)
- timed on/off switching support
Via the CUL module using the CUL/CUN or CUR (see www.busware.de ) access to the following protocols:
- FS20 (Receive/Send, all devices)
- EM (EM1000EM/EM1000GZ/EM1000WZ)
- FHT80b (Receive/Send)
- HMS (Receive)
- S300 (KS300, S300TH, KS555, S555TH, etc)
reading WS300 data, and up to 9 attached devices
reading EM1000WZ/EM1000EM/EM1000GZ data via an attached EM1010PC
reading attached SCIVT devices
reading attached M232 devices
reading attached WS2000/WS25000 devices, also via raw network converters(xport)
extract sensor data from IPWE networked weather data receiver
logging events to files or databases, with regexp filters
notifying external programs or internal modules when receiving certain events
timed commands (e.g. switching a lamp on from sunset till midnight)
watchdog (e.g. trigger if the HMS100-FIT is inactive for HH:MM:SS)
modular architecture, easy to add your special device
different web frontends, choose your favorite

Installation

Perl modules

http://search.cpan.org/dist/Device-SerialPort/

Can't call method "opened" on an undefined
  value...

    $self->{HANDLE}->close if (defined($self->{HANDLE}) &&
    	                       $self->{HANDLE}->opened);

Server installation on Unix

Check the Makefile for the installation path, then type make install.
Create a configuration file (see the examples directory or docs/commandref.html).
Start the server with fhem.pl <configfile>

Server installation on Windows

Be sure you have perl.exe in your path (%PATH%)
Make sure that you can access the serial USB device via virtual COM-Port or via socket(e.g. COMX or xport:10001).
Create a configuration file (see the examples directory and docs/commandref.html)
Start the server with fhem.pl <configfile>

General notes for webfrontends:

You don't have to install all of them, one is probably more than enough :-)
The numbering has historical reasons: not actively maintained versions are not described here
Important: Make sure you add some protection (.htaccess, etc) else everybody will be able to set your devices

Web frontend 2 (webfrontend/pgm2)

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.
Screenshots:

overview

detail

SVG-plots

http://localhost:8083/fhem

Web frontend 3 (webfrontend/pgm3)

and screenshots

http://www.martin-haas.de/fhz

Install PHP5, the php5-Apache-Modules, gnuplot and php-gd. Every current distribution should do all the needed configuration without your input.
Create a directory in the Apache2 DocumentRoot (e.g.: /home/httpd/html/pgm3) and copy all the files from the webfrontend/pgm3 to this directory.
Make sure that this directory is writeable by the webserver (e.g. User www-data.www-data)!
Call <your-site>/pgm3/index.phpi and follow the instructions on screen
The official WIKI of pgm3 is now http://fhemwiki.de

Web frontend 5 (webfrontend/pgm5)

http://www.dhs-computertechnik.de/support.html

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).
Note: The program looks for icons in the following order:
'device-name.state', 'device-name', 'device-type.state', 'device-type'
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.
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.
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.
Call 'your-site'/cgi-bin/fhemweb.pl

License:

Rudolf Koenig (r dot koenig at koeniglich dot de)
Raoul Matthiessen (webfrontends/pgm1)
Martin Haas (webfrontends/pgm3)
Olaf Droegehorn (webfrontends/pgm5)