tfa-climate-reader Code
Status: Beta
Brought to you by:
valharis
Menu
▾
▴
Tree [6d6940] default tip / History
| File | Date | Author | Commit |
|---|---|---|---|
| src | 2010-12-03 |
Peter Larsson
|
[00e720] patch to read 5 sensors and sensors with only ... |
| .hgtags | 2011-01-03 |
Martin Bickel
|
[6d6940] Added tag v0.2.0 for changeset 24af04db52f1 |
| CMakeLists.txt | 2011-01-03 |
Martin Bickel
|
[24af04] Changed version to 0.2 |
| COPYING | 2010-02-07 |
Martin Bickel
|
[872f52] initial file revisions |
| readme.html | 2011-01-03 |
Martin Bickel
|
[8740fd] Updated readme: HTML fixes, add reference to t... |
Read Me
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<HTML>
<HEAD>
<meta http-equiv="content-type" content="text/html; charset=ISO-8859-1">
<LINK REL="stylesheet" TYPE="text/css" HREF="mb.css">
<TITLE>TFA Climate Reader</TITLE>
<style type="text/css">
tt { background-color:#daecef; color:black; font-family:monospace; margin:1em; }
</style>
</HEAD>
<BODY>
<H1>TFA Climate Reader</H1>
<H2>Purpose</H2>
<p>Reading data from climate logger TFA 30.3015 and outputting it in CSV format.</p>
<p>Design goals of tfa-reader:</p>
<ul>
<LI>robust, easy to use program</LI>
<li>output data in a generic format that can easily be piped into other tools for conversion to different formats</li>
</ul>
<p>License: <A HREF="http://www.gnu.org/licenses/gpl-2.0.html#TOC1">GNU GPL v2</a> </p>
<H2>History</H2>
<dl>
<dt>v0.2</dt>
<dd>Fixed parsing of data values (thanks, Peter)</dd>
<dt>v0.1</dt>
<dd>Initial release</dd>
</dl>
<H2>Getting the program</H2>
<H3>Source Tarball</H3>
<p><A href="https://sourceforge.net/projects/tfa-reader/files/">Download from Sourceforge</A></p>
<H3>Source repository</H3>
<p>Use <A HREf="http://mercurial.selenic.com/">Mercurial</A> to pull from Sourceforge: </p>
<p><TT>hg clone http://tfa-reader.hg.sourceforge.net:8000/hgroot/tfa-reader/tfa-reader</TT></p>
<H2>Compiling</H2>
<p>TFA Climate Reader uses <A HREF="http://www.cmake.org/">cmake</A> to manage the builds. You also need to have libpopt.</p>
<p>
<tt>cd tfa-reader</tt><br>
<TT>cmake .</TT><br>
<TT>make</TT><br>
</p>
<H2>Running</H2>
<p>Example usage is:</p>
<p><tt>./tfa-climate-reader /dev/ttyS0 > mydata.csv </tt></p>
<p>For testing and debugging purposes, you can write the data that is read from the logger into a file:</p>
<p><tt>./tfa-climate-reader /dev/ttyS0 --savebinary=myDumpFile </tt></p>
<p>You can then use that file as input, to avoid reading the climate logger for every test:</p>
<p><tt>./tfa-climate-reader myDumpFile --binary </tt></p>
<H2>Using the output</H2>
<H3>Plotting with TimeDataPlotter</H3>
<p><A HREF="http://timedataplotter.sourceforge.net/">TimeDataPlotter</A> was specifically written to plot data like the one produced by tfa-reader!</p>
<p><tt>tfa-climate-reader /dev/ttyS0 | timedataplotter </tt></p>
<p>For a setup with one external sensor, showing just the temperature (columns 1 and 3):</p>
<p><tt>tfa-climate-reader /dev/ttyS0 | timedataplotter --leftAxis=1,3</tt></p>
<H3>Plotting with GnuPlot</H3>
<p>A program <i>tfa-gnuplot-adapter</i> is included that converts the csv values into a datafile and GnuPlot commands</p>
<p>Typcial usage:</p>
<p><tt>tfa-climate-reader /dev/ttyS0 | tfa-gnuplot-adapter --pause=30 | gnuplot </tt></p>
<p>This will plot the graph and show it for 30 seconds. After 30 seconds, gnuplot will close.</p>
<p>To avoid the closing, you can pipe the commands into a file and then invoke gnuplot for that file:</p>
<p><tt>tfa-climate-reader /dev/ttyS0 | tfa-gnuplot-adapter > gnuplot.commands && gnuplot gnuplot.commands - </tt></p>
<p>This will write the commands into <i>gnuplot.commands</i> and invoke gnuplot with it. After the commands are executed, gnuplot will wait for further commands on stdin.</p>
<H3>Converting to SQL</H3>
<p>A program <i>tfa-sql-adapter</i> is included that converts the csv values into SQL statements. This can be piped into a database.</p>
<p>Typcial usage:</p>
<p><tt>tfa-climate-reader /dev/ttyS0 | tfa-sql-adapter --table=MyTableName | mysql --user=myUserName --password=mySqlPassword --database=climate</tt></p>
<p>Creating a suitable table:</p>
<p><tt>tfa-sql-adapter --create --table=MyTableName | mysql --user=myUserName --password=mySqlPassword --database=climate</tt></p>
<H2>Disussions</H2>
<p>Can be held at <A HREF="http://sourceforge.net/projects/tfa-reader/forums/forum/1087820">the forum at SourceForge</A>.</p>
</BODY>
</HTML>
