|INTRODUCTION · PROGRAMS · NEWS · HARDWARE · DOCUMENTS · DOWNLOAD · MISCELLANEOUS · LINKS|
Data collected by Oww may be made available to clients using my owwl protocol. I have made available a C library for clients (or servers). There is full Doxygen documentation available.
I have written one such client program for logging readout data in csv format. This is owwlog. The source code is available from the Oww CVS repository on sourceforge.
Oww Log is a command line (or daemon) program for recording data read from Oww servers thorugh the owwl protocol. It was developed from Owwl as a part of the QUaD project at Cardiff University, Astronomy Instrumentation Group. Owwlog now supports full weather data streams from Oww.
You may download the source from
Build and install in the usual way, and enter "
owwlog -?" for usage information.
Since starting owwl I have found it useful as a protocol for serving data from the QUaD radio telescope (part of my day job at Cardiff University). So owwlog has in part been developed in my role as a researcher, on the University's time. A couple of features are therefore rather specific (to cryogenic thermometry), and are indicated like this.
To get the list of possible commands for your version of owwlog you should type:
You should then see something like this:
sjm@quest2:~> owwlog --help Usage: owwlog [OPTION...] -B, --Broadcaster Run as a re-broadcasting server -b, --broadcast=port number Port number to run a re-broadcasting server -C, --Calibration=directory path Use files in this directory for calibration -D, --Directory=directory path Log to files in this directory -d, --daemon Run in daemon mode -e, --execute=file Execute file after log updates -I, --ISO Print ISO 8601 time values -i, --Ignore=stream list Ignore data streams -L, --Live=file Log live updates to this file -l, --Log=log path Log to this file -p, --port=port number Port number to connect on -q, --quiet Don't print messages after startup -r, --rrdfile=file Update this RRD database -S, --Snap Snap log times -s, --server=server Server to contact -t, --time=time in seconds Log interval -u, --unix Print Unix time values -v, --version Print version information Help options: -?, --help Show this help message --usage Display brief usage message
There follows a more verbose explanation of each of these options:
2004-06-03 17:50:32. This saves confusion between U.K. / U.S. / Continental formats.
"Diode 5,Diode 1#,Grt 4*"This will turn off Diode 5, Diodes 10, 11, &c, and all three Grt 4 channels (V, Vq and I).
Usage: owwlog [-dISu?] [-D|--Directory directory path] [-d|--daemon] [-e|--execute file] [-I|--ISO] [-i|--Ignore stream list] [-L|--Live file] [-l|--Log log path] [-p|--port port number] [-S|--Snap] [-s|--server server] [-t|--time time in seconds] [-u|--unix] [-?|--help] [--usage]
owwlog may be down-loaded from the project
download page on Sourceforge.
For Linux fetch the
.rpm file, and for Windows fetch the
On Linux Owwlog conforms to use usual autotools practices,
and so should be familiar to anyone used to installing Linux
applications from source.
So, having obtained a source distribution run the
./configure make su -c "make install"
CVS users may have to regernerate the
configure script first,
by running the
Owwlog depends on the popt and gsl libraries - you'll have to get these if you haven't got them already. If installing from RPMs, make sure you have the "development" versions, necessary for compiling programs against the libraries.
For my "port" to MS Windows I have built owwlog using MinGW (a build of the gcc C compiler suite with libraries to tie-in with Windows), using MinGW Developer Studio. The project file for this is on CVS.
I have now made a Windows installer for owwlog, available from the download area. To install owwlog, simply run the installer!
You'll need to install Popt and GSL first, with the GnuWin32 popt and GSL installers.
This will create an owwlog program group, and a desktop icon –
This is set up with some (hopefully) suitable command line arguments.
It will connect to
host and log every 5 seconds to logdir in your "My Documents" folder.
Of course you can change the arguments (e.g. replace
with the real host name) from the shortcut properties.
You will need to add some command line arguments to do anything at all with owwlog. Refer to the section above for argument descriptions. You could of course run owwlog by hand, from a command shell, adding the necessary arguments each time. But it is more sensible to enter them into a script file.
On my work machine I have a script at
If you have taken a look at that -
This script is way over-complicated, because it's an init script.
This is the system Linux uses to get everything going in the right sequence
at start up.
I suggest you use a script consisting of just one line - the line you'd use
in your shell (but you might need to add a line to change directory).
However, my init script will serve as an example of the owwlog arguments I use.
If you're trying to use owwlog on Windows, perhaps the easiest way to make a "script"
is to create a shortcut to
Then the right-button-click -> properties dialogue will permit the addition
of command line arguments after the target name.
Windows users can now use the Desktop icon created by the installer. Change its parameters with the Properties dialogue if necessary.
As noted above, owwlog may update a round-robin database,
named with the
-r, --rrdfile=file option.
With this option set, after each update owwlog will generate a
command line calling
rrdtool, which it then executes.
This command is as follows:
rrdtool update filename rrd_template unixtime:
rrd_template is generated from the data stream names
(as listed in the header line of any log file), replacing all
non-alpha-numeric characters with underscore ('_').
For example, "
Wind 1 Bearing" becomes "
Therefore you must also use these names when generating the database
|SUMMARY · PROJECTS · SIMON · MELHUISH.INFO|