PHP-Webfrontend pgm3 for fhem

This is one of the webfrontends (pgm3) of the project FHEM
http://www.koeniglich.de/fhem/fhem.html
Pgm3 is a part of this project. It does not run without it. Look at the homepage above for further descriptions like installing FHEM and the licenses.

Changelog.

The current version is only included in the CVS of fhem. It is easy to export the current version:
-- Install the Package "cvs" with the package manager of your system..
-- The current fhem including pgm3 can be exported with this commands:
---- cvs -d:pserver:anonymous@cvs.fhem.berlios.de:/cvsroot/fhem login
---- login with RETURN (without password).
---- cvs -z3 -d:pserver:anonymous@cvs.fhem.berlios.de:/cvsroot/fhem export -DNOW fhem
-- now you will find pgm3 below fhem/webfrontends/

You can find more information an berlios.

Screenshots including a short description are there.

-- pgm3 (an older version) is also included in NSLU2FHZ -- FHZ on NSLU2 :-)
-- VoIP2FHEM or HOWTO control the FHEM with Asterisk

It should be very easy to install this webfrontend!


pgm3-0.7.2 needs fhz1000 v3.3 or minor, pgm3-0.8.0 or newer needs fhem 4.x

Use the package-manager from your distribution like apt/yast and install the following packages:
-- apache2
-- apache2-mod_php5 #You can use php4 instead of php5. Recommendation: php5 -- php5-gd
-- php5
-- gd #>= 2.0.1, not needed with debian
-- gnuplot


After that create a directory in the home directory of your apache. That ist normally /srv/www/htdocs or /var/www

>> mkdir /srv/www/htdocs/fhzweb

copy everything:

>> cp -pr pgm3-<version>/* /srv/www/htdocs/fhzweb/

Think at the rights. Everything should have the rights of your webserver.
That is normally wwwrun.www or www-data.www-data

>> chown -R wwwrun.www /srv/www/htdocs/fhzweb


Start your apache with e.g.
>> /etc/init.d/apache2 start
or
>> rcapache2 start

If your fhz1000.pl is at the location /usr/local/bin/fhz1000.pl
and the port is 7072 then you are ready!!!
If not then change the values in the config.php in e.g. /srv/www/htdocs/fhzweb/

Point your Browser to e.g. http://localhost/fhzweb and enjoy it :-)

After the first start you will get some pictures with error messages (only for FHT, HMS(T/TF/WD/MG) and KS300). There you can read which entry in the fhz1000.cfg is needed for the required logfiles ( see Screenshots). Restart fhz1000.pl after changing the fhz1000.cfg.
After a couple of minutes you will see the desired pictures ( see Screenshots).


Look at the other configurations in the config.php for other toys (e.g. tail).

The following devices are automatically supported: FHT, HMS100(T/TF/WD/W/MG/RM100-2), FS20, KS300, WS300

If you have other devices (which are supported from fhz1000.pl) then please send me your logfiles. After that I will create the required graphic function.

Normally there should be no problems. If something seems to be wrong then check the following:
-- Rights: Everything should have the rights of your webserver.
-- type on the console in your working directory "php5 index.php" and "cd include;php5 fs20.php". If there is a php problem or problems with graphic functions then you will get some error messages
-- be sure to have the following entry in your /etc/php.ini: extension=gd.so
-- some older systems don't find the TrueTypeFonts (no pictures on screen). In this case change in the config.php the path to them (absolut).
-- after that send me a mail.