own/README

   1 usb-wde1 tools
   2 --------------
   3 Tools to collect and analyze data from the USB-WDE1 weather receiver from ELV.de
   4
   5
   6 idea
   7 ----
   8 1. pipe each received line to a command
   9 2. command splits up line into variables
  10 3. add variable data to rrdtool
  11 4. repeat
  12
  13
  14 idea: cat socat output to "read"
  15
  16
  17
  18 Test it:
  19 $ php lines-to-stdout.php | ./work-with-lines.sh
  20
  21
  22
  23
  24 RRDtool database setup
  25 ----------------------
  26 EXAMPLE
  27         rrdtool create temperature.rrd --step 300 \
  28          DS:temp:GAUGE:600:-273:5000 \
  29          RRA:AVERAGE:0.5:1:1200 \
  30          RRA:MIN:0.5:12:2400 \
  31          RRA:MAX:0.5:12:2400 \
  32          RRA:AVERAGE:0.5:12:2400
  33
  34  This sets up an RRD called temperature.rrd which accepts one temperature value every 300 seconds. If no new data is supplied for more than 600 seconds, the temperature becomes *UNKNOWN*.  The minimum acceptable value is -273 and the maximum is 5'000.
  35
  36  A few archive areas are also defined. The first stores the temperatures supplied for 100 hours (1'200 * 300 seconds = 100 hours). The second RRA stores the minimum temperature recorded over every hour (12 * 300 seconds = 1 hour), for 100 days (2'400 hours). The third and the fourth RRA's do the same for the maximum and average temperature, respectively.