README

   1 ================================================================================
   2
   3                             Arexx Data Logger Daemon
   4
   5                     (c) 2011--2020 Martin Mares <mj@ucw.cz>
   6
   7        You can use and distribute this program under the terms of GPLv2.
   8
   9 ================================================================================
  10
  11
  12 AREXX Engineering (http://www.arexx.com/) makes nice data loggers for monitoring
  13 temperature, humidity and CO2 levels. They consist of a base station (BS-500)
  14 and multiple wireless sensors. The base station can be connected to a PC over
  15 USB to download the data points and synchronize clock.
  16
  17 However, all Linux support they provide is a single statically linked binary,
  18 which can send data to a remote web server. I was not satistified with that,
  19 so I reverse-engineered the communication protocol and wrote my own software.
  20
  21 This package contains a daemon (arexxd), which watches USB and whenever the
  22 data logger is connected, it downloads all data points from its memory and
  23 continues fetching all further measurements in real time. Also, it synchronizes
  24 the clock of the logger to the system time.
  25
  26 The data points can be stored in a RRD database (see http://oss.oetiker.ch/rrdtool/)
  27 or sent to InfluxDB (this is configured rather crudely in the source code).
  28 You can easily tweak the source to process the data in any way you like.
  29
  30 This program is not supported or endorsed by AREXX in any way. Also, there is
  31 no warranty on what it does or does not. However, if you have any bug reports
  32 or suggestions, I will be glad to hear them.
  33
  34 To build the program, you need development packages for libusb-1.0 and librrd
  35 (they are probably called <something>-dev in your system). You might want
  36 to tweak init-arexxd script, which expects that an account called "arexxd"
  37 exists in /etc/passwd. Also, you can customize the correct_point() function
  38 in arexxd.c.