FHEM

Description

This program makes the FHZ1000/FHZ1300/WS300 and other USB devices sold by ELV, Conrad and others useable with Linux. In fact, there is nothing Linux special in it, there are reports from OS X and Windows. You should be able to use it on other platforms as long as you can access the hardware as a serial device.
The program runs as a server, you can control it via telnet, command line program or TCP/IP directly, like the supplied web frontends do.

Currently implemented features:

• 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 and RM100-2)
  • reading KS300 data
  Note:The FHZ1350 WLAN is probably not working due to a prorietary encryption.
• 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)
• modular architecture, easy to add your special device
• different web frontends, choose your favorite


See HOWTO.html, commandref.html and faq.html for more documentation.

Links:

Homepage: http://www.koeniglich.de/fhem/fhem.html
Download: http://www.koeniglich.de/fhem/fhem-=VERS=.tar.gz
FAQ: http://www.koeniglich.de/fhem/faq.html
Google-Group: http://groups.google.com/group/FHZ1000-users-on-unix
Martins Web frontend (webpgm3): http://www.martin-haas.de/fhz
Another Martins Web frontend (myHCE): http://www.fischer-net.de/projekte/haustechnik/myhce.html
CVS@berlios: http://developer.berlios.de/projects/fhem
LinViex (home automation frontend): http://sourceforge.net/projects/linviex

Device/OS Specific installation guides:

• Linux driver installation: http://www.koeniglich.de/fhem/linux.html
• Windows driver installation: http://fhz4linux.info/tiki-index.php?page=Driver%20installation
  (use "Solution B", only COM1..COM9 is supported)
• Instructions for Nas/Routers (NSLU2): http://www.martin-haas.de/fhz/nslu2fhz
• Instructions for the Fritz!Box: http://www.koeniglich.de/fhem/fritzbox.html
• Instructions for the Allnet all6250: http://wiki.dungeon.de/all6250_opennas_mit_fhem

Related projects:

http://fhz4linux.info/

Installation

Perl modules

You need perl >=5.6, on Unix with the Device::SerialPort ( http://search.cpan.org/dist/Device-SerialPort/), on Windows Win32::SerialPort (use ActiveState's ActivePerl) module. If this module reports Can't call method "opened" on an undefined value... when starting the server, then you either may ignore this message, or replace the mentioned line with:

    $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

If you are using cygwin for your perl installation you can follow the guidelines for Unix.
• 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 web server and the fhem server must be on the same host
• Important: Make sure you add some protection (.htaccess, etc) else everybody will be able to set your devices
• The list below contains the 2 actively maintained fronteds:

Web frontend 2 (webfrontend/pgm2)

This frontend is a FHEM module implementing a HTTP server. 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.

Installation: make install-pgm2 && perl fhem.pl
Connect to fhem via http://localhost:8083/fhem. See the Howto there on how to continue.

Web frontend 3 (webfrontend/pgm3)

This frontend is PHP based and was contributed by Martin Haas. Look at the webfrontends/pgm3/docs for more documentation or at this screenshot. A lot more details can be found on Martins page: http://www.martin-haas.de/fhz


• Install PHP and enable it by commenting in the "LoadModule phpX_module ..." directive in httpd.conf (perhaps it is already done by your distro). Restart/reload httpd.
• Create a directory (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!
• Edit index.php (/home/httpd/html/pgm3/index.php), and check the required settings section
• If you want to have access to the FHT temperature logs, then:
  • Make sure gnuplot is installed
  • check the showgnuplot section in index.php
  • For each FHT device copy the file docs/gnuplot/gnuplot.wz to gnuplot.fhtdevicename (to the /home/httpd/html/pgm3 directory) and replace fht.log in this file with the absolute name of the current logfile.
• Call <your-site>/pgm3/index.php

License:

Copyright:

• Rudolf Koenig (r dot koenig at koeniglich dot de)
• Raoul Matthiessen (webfrontends/pgm1)
• Martin Haas (webfrontends/pgm3)
License: GPL (v2)

Misc:

Thanks for Tosti for inspiration and numerous other people for help.