w1retap - One wire sensor logging.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

w1retap is a system for logging data from a 1-wire weather sensors to
either a relational database or files (or combination thereof). 

w1retap spports any (reasonable) number of following sensors from AAG
Electrónica (AAG) <http://www.aagelectronica.com/>, based on Dallas
Semiconductors <http://www.dalsemi.com/> devices.

* TAI8520 (DS1820 / DS18S20) Temperature sensors;
* TAI8540B (DS2438) Humidity Sensor;
* TAI8570 Pressure Sensor;
* TAI8575 Rain Gauge;
* TAI8515 Weather Station (DS2423,DS18S20,DS2450);
* DS2409 Microlan coupler;
* DS2490 USB adaptor;
* DS2480 Serial adaptor.

A number of other sensors, typically "hobby/build your own", are
supported:

* SHT11 based humidity sensor
  <http://home.hetnet.nl/~thomas_7/1Wire/1-WireIOPort.html>
* MPX4115A based pressure sensor ('fronted' by DS2438)
  <http://home.comcast.net/~andrew.g.miller/barometer/>

w1retap is designed to run on the Linux operating system and assumes
that the interface between the computer and the 1-wire system is
either a DS2490 USB adaptor (aka DS9490R) or a DS2480 RS232 serial
adaptor (aka DS9097U-S09),

The logging is performed by one or more "plugin" modules, these
currently include:

	Mongodb
	Sqlite (version 3)
	PostgreSQL
	MySQL
	ODBC

	Text file
	CSV file
	XML file

Unless otherwise indicated, the system is released under the GNU Public
Licence.

Files:

src: Contains the w1retap software. 

src/libusblinux300: The Dallas PD 1-wire SDK

doc: Documentation on configuring and using w1retap

contrib: Various scripts and applications, including a web page
builder, a wunderground.com reporting script, RSS feeder, and a GNOME
panel applet (actually two, using different transports).

Please see the docs sub-directory for information on building,
installing and running w1retap. In particular, README.usb

Building on FreeBSD
~~~~~~~~~~~~~~~~~~~

You need a load of GNU stuff, including (possibly) the autotools.
I'm no BSD expert, and found it necessary to set:

export ACLOCAL_FLAGS="-I /usr/local/share/aclocal"
export PATH=$PATH:/usr/local/gnu-autotools/bin/
export LDFLAGS="-L/usr/local/lib"

Jonathan Hudson, Netley Marsh, England.
