modbuslog - 2012/01/10
--------------------

modbuslog is a program designed to read from a modbus device at predefined 
intervals and store the output to file.


Compilation:
--------------------
modbuslog requires the libconfig (>1.4.8) and libmodbus (>3.0.1) libraries, 
and will not function without these libraries installed. Neither of these 
libraries are currently available (or if they are, are not of sufficient 
version) in the current Debian Stable release codenamed "Squeeze". This 
means that these dependencies must be manually fulfilled.

libmodbus: 	It should be sufficient to backport the current version of 
		libmodbus from Debian Testing codenamed "Wheezy"
		http://packages.debian.org/wheezy/i386/libmodbus5/download
		http://packages.debian.org/wheezy/i386/libmodbus-dev/download

libconfig:	An older, incompatible version of libconfig currently exists
		in Debian Squeeze (right the way up to Sid). An updated package
		has been created and will hopefully be included in the next
		Debian Stable release. In the mean time it is available here:
		http://mentors.debian.net/package/libconfig
		When it gets accepted, it will be available here:
		http://packages.debian.org/source/testing/libconfig

modbuslog uses a Makefile to ease compilation, and as such, can be compiled
by simple navigating to the directory and running "make". This will recompile
any packages that need to be compiled.

These files can then be moved to the required directories on the target system.


Required files:
--------------------

/usr/sbin/modbuslog			executable program
/usr/bin/ftpupload			ftp upload script
/usr/bin/ftphelper			ftp upload script helper
/etc/modbuslog.cfg			configuration file
/var/modbuslog/				output directory where logs are stored
/var/modbuslog/interval/interval.txt	textfile storing unique interval
/var/www/				webserver directory for php scripts

Configuration:
--------------------

The configuration file for modbuslog is stored in /etc/modbuslog.cfg, and is 
arranged in a hierarchical structure suitable for libconfig.

The modbus section defines the standard operating parameters for the modbus 
device, These include:
	1) device	serial port in use
	2) baud		baud rate in use
	3) data_bits	number of data bits, commonly 8.
	4) parity	parity, commonly E (even) or N (None).
	5) stop_bits	stop bits, commonly 1.
	6) retry	number of retries for each failed reading.

The ftp section defines the parameters for the ftp upload function. The
required parameters are:
	1) server	address of remote ftp server
	2) username	ftp username
	3) password	ftp password
	4) directory	directory on ftp server files will be uploaded to

The reading section defines the unique reading times that the program is 
required to log at. Each entry must contain:
	1) slaveid		modbus slave id
	2) registertype		type of modbus reading
	3) startaddress		register to start reading from
	4) numregisters		number of registers to read
	5) intervalvalue	read register every x
	6) intervalunit		(m) minutes or (h) hours

The -d argument can also be passed to modbuslog to enable a verbose debugging
mode.
td><td><a href='/debian/lcd4linux.git/commit/configure.in?id=0950720d01ac43fcd6419984d348bc17209c4ca2&amp;follow=1'>make configure.in reference the now renamed ax_python_devel.m4</a></td><td>Reinhard Tartler</td><td>1</td><td><span class='deletions'>-1</span>/<span class='insertions'>+1</span></td></tr>
<tr><td><span title='2010-03-16 15:47:26 +0100'>2010-03-16</span></td><td><a href='/debian/lcd4linux.git/commit/debian/rules?id=e2c5b654a5f6c4bbdff1b15f54b31f37b9ed0fc2&amp;follow=1'>disable switch --disable-mpd, it is not recognized anyways</a></td><td>Reinhard Tartler</td><td>1</td><td><span class='deletions'>-1</span>/<span class='insertions'>+0</span></td></tr>
<tr><td><span title='2010-03-16 15:41:18 +0100'>2010-03-16</span></td><td><a href='/debian/lcd4linux.git/commit/ax_python_devel.m4?id=32d9da650ea0e177d4967bb964e89215a6554ff2&amp;follow=1'>don't include LOCALMODLIBS for linking. it was empty for python 2.5, and are ...</a></td><td>Reinhard Tartler</td><td>1</td><td><span class='deletions'>-1</span>/<span class='insertions'>+1</span></td></tr>
<tr><td><span title='2010-03-16 15:38:26 +0100'>2010-03-16</span></td><td><a href='/debian/lcd4linux.git/commit/ax_python_devel.m4?id=45c665b2326c78c6c4f8e56623acd8fb67950ee1&amp;follow=1'>update ac_python_devel.m4 from upstream, has been renamed now to ax_python_devel</a></td><td>Reinhard Tartler</td><td>1</td><td><span class='deletions'>-3</span>/<span class='insertions'>+8</span></td></tr>
<tr><td><span title='2010-02-28 23:25:25 +0100'>2010-02-28</span></td><td><a href='/debian/lcd4linux.git/commit/debian/rules?id=f36951777b61700d4fad375938111152770dd8f5&amp;follow=1'>fix typo, don't disable python support</a></td><td>Reinhard Tartler</td><td>1</td><td><span class='deletions'>-1</span>/<span class='insertions'>+1</span></td></tr>
<tr><td><span title='2010-02-28 22:11:31 +0100'>2010-02-28</span></td><td><a href='/debian/lcd4linux.git/commit/debian/init.d?id=502e79f85f60d2845544e353e5f158038aa6481a&amp;follow=1'>Allow user control over lcd4linux args, </a></td><td>Reinhard Tartler</td><td>2</td><td><span class='deletions'>-1</span>/<span class='insertions'>+6</span></td></tr>
<tr><td><span title='2010-02-28 22:01:20 +0100'>2010-02-28</span></td><td><a href='/debian/lcd4linux.git/commit/debian/copyright?id=021393ed15cfb2a4e45d8e18ec27b5e5c60ce99c&amp;follow=1'>clarify copyright notice, reported by lintian</a></td><td>Reinhard Tartler</td><td>1</td><td><span class='deletions'>-1</span>/<span class='insertions'>+1</span></td></tr>
<tr><td><span title='2010-02-28 21:57:03 +0100'>2010-02-28</span></td><td><a href='/debian/lcd4linux.git/commit/debian/control?id=cfba7691d798351b945e5104dcd9438329c8204e&amp;follow=1'>bump standards version to 3.8.4.</a></td><td>Reinhard Tartler</td><td>2</td><td><span class='deletions'>-2</span>/<span class='insertions'>+3</span></td></tr>
<tr><td><span title='2010-02-28 21:55:34 +0100'>2010-02-28</span></td><td><a href='/debian/lcd4linux.git/commit/debian/control?id=918de3ffff4c24c8f326ab94882b494b5df12efd&amp;follow=1'>bump debhelper compat level to 7</a></td><td>Reinhard Tartler</td><td>3</td><td><span class='deletions'>-3</span>/<span class='insertions'>+4</span></td></tr>
<tr><td><span title='2010-02-28 21:54:08 +0100'>2010-02-28</span></td><td><a href='/debian/lcd4linux.git/commit/debian/rules?id=ba48073925e51d0e35b4cafc234e9b90f85526e8&amp;follow=1'>disable mpd plugin. According to bugreports, it makes lcd4linux</a></td><td>Reinhard Tartler</td><td>3</td><td><span class='deletions'>-3</span>/<span class='insertions'>+6</span></td></tr>
<tr><td><span title='2010-02-28 21:49:47 +0100'>2010-02-28</span></td><td><a href='/debian/lcd4linux.git/commit/debian/control?id=daf7abfb18c188baf2af9f78965bdf694f6bec35&amp;follow=1'>prefer multiline depends</a></td><td>Reinhard Tartler</td><td>1</td><td><span class='deletions'>-1</span>/<span class='insertions'>+9</span></td></tr>
<tr><td><span title='2010-02-28 21:48:53 +0100'>2010-02-28</span></td><td><a href='/debian/lcd4linux.git/commit/debian/changelog?id=85bdb47c3256f86570c134590d7970bca4f1c66e&amp;follow=1'>update config.guess &amp;&amp; config.sub, Closes: #542077</a></td><td>Reinhard Tartler</td><td>3</td><td><span class='deletions'>-405</span>/<span class='insertions'>+624</span></td></tr>
<tr><td><span title='2010-02-28 21:45:42 +0100'>2010-02-28</span></td><td><a href='/debian/lcd4linux.git/commit/debian/changelog?id=e7ad9c5caca8d2985d94bedeef5cfb06265d329a&amp;follow=1'>update ac_python_devel.m4 from autoconf-archive package. This allows</a></td><td>Reinhard Tartler</td><td>2</td><td><span class='deletions'>-66</span>/<span class='insertions'>+199</span></td></tr>
<tr><td><span title='2010-02-28 21:44:07 +0100'>2010-02-28</span></td><td><a href='/debian/lcd4linux.git/commit/debian/init.d?id=5833839b8ecfb7c8ca13347bed65b625a29c9804&amp;follow=1'>Add $remote-fs dependencies to init script. Reported by lintian.</a></td><td>Reinhard Tartler</td><td>2</td><td><span class='deletions'>-2</span>/<span class='insertions'>+8</span></td></tr>
<tr><td><span title='2008-01-10 10:58:36 +0100'>2008-01-10</span></td><td><a href='/debian/lcd4linux.git/commit/debian/changelog?id=ea2d03d41845c4b118cc19fa8915e2b36b914846&amp;follow=1'>oops. fix version number</a></td><td>Reinhard Tartler</td><td>1</td><td><span class='deletions'>-1</span>/<span class='insertions'>+1</span></td></tr>
<tr><td><span title='2008-01-10 10:31:24 +0100'>2008-01-10</span></td><td><a href='/debian/lcd4linux.git/commit/debian/control?id=d09ff8ae38ccffbeda7bf1e00546075f491fd90e&amp;follow=1'>* add Vcs-Bzr and Homepage header.</a></td><td>Reinhard Tartler</td><td>2</td><td><span class='deletions'>-1</span>/<span class='insertions'>+4</span></td></tr>
<tr><td><span title='2008-01-10 10:29:51 +0100'>2008-01-10</span></td><td><a href='/debian/lcd4linux.git/commit/debian/control?id=f088293e085460cc1f930eee73fc2871399a7c61&amp;follow=1'>* bump to standards version 3.7.3 (no changes needed)</a></td><td>Reinhard Tartler</td><td>2</td><td><span class='deletions'>-2</span>/<span class='insertions'>+3</span></td></tr>
<tr><td><span title='2008-01-10 09:48:54 +0100'>2008-01-10</span></td><td><a href='/debian/lcd4linux.git/commit/debian/changelog?id=57063d34027113d0150d4c861b247d8c7489e932&amp;follow=1'>new upload to unstable</a></td><td>Reinhard Tartler</td><td>1</td><td><span class='deletions'>-0</span>/<span class='insertions'>+9</span></td></tr>
<tr><td><span title='2008-01-10 09:45:05 +0100'>2008-01-10</span></td><td><a href='/debian/lcd4linux.git/commit/udelay.c?id=c724649a69607b3c76ad554d0700b2e9f53d63b8&amp;follow=1'>import commit 809 from trunk to fix http://bugs.debian.org/cgi-bin/bugreport....</a></td><td>Reinhard Tartler</td><td>4</td><td><span class='deletions'>-255</span>/<span class='insertions'>+12</span></td></tr>
<tr><td><span title='2007-04-05 15:44:44 +0200'>2007-04-05</span></td><td><a href='/debian/lcd4linux.git/commit/debian/init.d?id=3e23b791eeb822bb2d7d6b9a5376675c0cf4bfe8&amp;follow=1'>missing depends in LSB init stanza</a></td><td>Reinhard Tartler</td><td>1</td><td><span class='deletions'>-0</span>/<span class='insertions'>+2</span></td></tr>
<tr><td><span title='2007-04-05 15:41:23 +0200'>2007-04-05</span></td><td><a href='/debian/lcd4linux.git/commit/debian/changelog?id=d1b9883e0fb03412669ea418158a85b678f09e43&amp;follow=1'>* new upstream tarball no longer contains a debian/ directory at all</a></td><td>Reinhard Tartler</td><td>1</td><td><span class='deletions'>-1</span>/<span class='insertions'>+3</span></td></tr>
<tr><td><span title='2007-04-30 09:35:54 +0200'>2007-04-30</span></td><td><a href='/debian/lcd4linux.git/commit/widget_timer.c?id=874ef72c5b807b61bc53dbaa0fa623b40bff1736&amp;follow=1'>new upstream version</a></td><td>Reinhard Tartler</td><td>63</td><td><span class='deletions'>-4596</span>/<span class='insertions'>+7100</span></td></tr>
<tr><td><span title='2007-04-05 15:37:52 +0200'>2007-04-05</span></td><td><a href='/debian/lcd4linux.git/commit/debian/init.d?id=cbaf3ad73900f63eae0add0e33439a1bf04b5a1e&amp;follow=1'>* add LSB keyword section</a></td><td>Reinhard Tartler</td><td>2</td><td><span class='deletions'>-1</span>/<span class='insertions'>+12</span></td></tr>
<tr><td><span title='2007-04-05 15:26:06 +0200'>2007-04-05</span></td><td><a href='/debian/lcd4linux.git/commit/debian/changelog?id=832e050d8e61a27d6226b7695fb1d50992438f2c&amp;follow=1'>mark new upload in debian/changelog</a></td><td>Reinhard Tartler</td><td>1</td><td><span class='deletions'>-0</span>/<span class='insertions'>+6</span></td></tr>
<tr><td><span title='2007-04-05 15:25:19 +0200'>2007-04-05</span></td><td><a href='/debian/lcd4linux.git/commit/widget_timer.h?id=d0c7529cb9833ede3595051df5599a11fe03be48&amp;follow=1'>import new upstream</a></td><td>Reinhard Tartler</td><td>162</td><td><span class='deletions'>-10578</span>/<span class='insertions'>+5766</span></td></tr>
<tr><td><span title='2007-04-05 15:22:26 +0200'>2007-04-05</span></td><td><a href='/debian/lcd4linux.git/commit/debian/lcd4linux.8?id=3811bca55e79006fb5c3dc8f25d8ef29ccdda758&amp;follow=1'>improvements to the manpage</a></td><td>Reinhard Tartler</td><td>1</td><td><span class='deletions'>-2</span>/<span class='insertions'>+6</span></td></tr>
<tr><td><span title='2006-08-27 17:18:38 +0200'>2006-08-27</span></td><td><a href='/debian/lcd4linux.git/commit/config.sub?id=96d96dc41dfdffc5130dacffcc1742180baabd3f&amp;follow=1'>update config.guess and .sub</a></td><td>Reinhard Tartler</td><td>2</td><td><span class='deletions'>-350</span>/<span class='insertions'>+450</span></td></tr>
<tr><td><span title='2006-08-27 17:18:28 +0200'>2006-08-27</span></td><td><a href='/debian/lcd4linux.git/commit/debian/rules?id=c94e287e334c4d09dea922940e7531dc4e7e0570&amp;follow=1'>install new manpage</a></td><td>Reinhard Tartler</td><td>2</td><td><span class='deletions'>-2</span>/<span class='insertions'>+3</span></td></tr>