------------------------------------------- WEB Thermometer v0.98 by Claudio Lanconelli ------------------------------------------- This is a simple CGI program to provide a powerful WEB remote thermometer. ----------- QUICK START ----------- Server Side =========== To run the thermometer you need a PC with a simple hardware connected to the COM port (ttyS?), a http server (i.e. "Microsoft Personal Web Server" or "Apache") running, and the following files in the cgi-bin directory: --Windows-- cgitherm.exe -- the executable skeleton.html -- the HTML template for the results page (optional) --Linux-- therm.cgi -- the executable skeleton.html -- the HTML template for the results page (optional) You can edit the result HTML page (look at CUSTOMIZATION above). To try the thermometer add the therm-test-linux.hml or therm-test-win.html to your pages in the html directory. You can run the cgitherm by a FORM or directly by a link. Client side =========== To run the thermometer on the client you need only a HTML browser (Netscape, InternetExplorer, Opera, Konqueror, ...). If your browser don't understand the 'REFRESH' META TAG try with the skeleton_js.html that use JavaScript to update the page. ----------------------- HOW TO GET THE SOFTWARE ----------------------- You will find the last version of WEBThermometer/NetThermometer at: http://www.LancOS.com The program is copyrighted by Claudio Lanconelli and is distributed under the GPL license (read the COPYING file). ----------------------- HOW TO GET THE HARDWARE ----------------------- You can build it yourself because it's very simple (look at the schematic file schematic.png), but if you prefer the hardware ready to use try to send me an e-mail at lancos@libero.it Alternatively the SI-Prog multipurpose programmer is able to work with WEB Thermometer. If you are interested look at http://www.LancOS.com/prog.html You can attach up to 8 temperature sensors (Dallas DS1621), but probably with all sensors you need an external power supply (+5V). ------------- CUSTOMIZATION ------------- You can create your own result page in HTML. You should add the Refresh meta line and a line with the tag 'RESULTS' in the body. The 'RESULTS' and 'RELOAD_TIME' tags will be replaced by the thermometer results and the reload time selected. I suggest to start editing the default skeleton.html file. Note that skeleton.html file must be in the same directory of cgitherm.exe file (usually cgi-bin directory). If no skeleton.html is found, the default template embedded in the executable will be used instead. If you like webtherm add a link in the result page to point to my URL http://www.LancOS.com, please. --------------- COMMON PROBLEMS --------------- The result is "Err-11". Check that the hardware is connected, the proper COM port selected, and a good cable with all pins connected is used. The result is "Err-13". The temperature sensor is not responding. Solution: connect the DS1621 sensor and select the proper address (1-8). The result is always "Err-14". The therm.cgi process need to access the /dev/ttyS? device. On RedHat Linux distributions the /dev/ttyS? has grant rw access only to some users. Solution: if you use Apache add the wwwrun or nobody user (look at the httpd.conf file to know the user used by Apache) to the uucp group (file /etc/groups) Alternatively change the rights: chmod 666 /dev/ttyS? chmod 777 /var/lock ---------- THE AUTHOR ---------- You can contact Claudio Lanconelli at lancos@libero.it or look at http://www.LancOS.com I will appreciate any suggestions, so feel free to send me a mail.
fred1144