4 Generate graphs for temperature and humidity by utilizing Munin.
9 0. Keep a logfile with the most recent single line
10 1. Use the munin plugin to generate munin-compatible data from the log file
15 0. Checkout the munin plugin code::
18 $ git clone git://git.cweiske.de/usb-wde1-tools.git
21 1. A process needs to watch the USB interface and log the last
22 line with temperature data into a log file.
23 You can do that manually with ::
25 $ socat /dev/ttyUSB0,b9600 STDOUT |./munin/log-single-line.sh test.log
27 The most easy way is to run ::
29 $ cd munin && nohup ./usb-wde1-log-last.sh &
31 once. It backgrounds the logging process and logs into ``/tmp/usb-wde1-last``.
32 This process needs to be started whenever the machine is rebooted.
34 You can run ``make`` to install the init script.
36 2. Link the munin plugin::
38 $ cd /etc/munin/plugins
39 $ ln -s /usr/local/src/usb-wde1-tools/munin/usb-wde1_ usb-wde1_temperature
40 $ ln -s /usr/local/src/usb-wde1-tools/munin/usb-wde1_ usb-wde1_humidity
42 3. Configure the plugins
43 Edit /etc/munin/plugin-conf.d/munin-node and add the following lines::
46 env.logfile /tmp/usb-wde1-last
49 env.sensor0 Living room
55 $ munin-run usb-wde1_temperature autoconf
60 $ munin-run usb-wde1_temperature config
62 should display the plugin configuration with all environment variables set
65 $ munin-run usb-wde1_temperature
66 $ munin-run usb-wde1_humidity
68 should display the current values from the log file
70 5. You are done - enjoy.
74 Debugging & Development
75 =======================
76 The dummy data generator is a small php script that generates log lines
77 as they would come from the usb-wde1 usb port::
79 $ ./dummy-data-generator.php |./munin/log-single-line.sh test.log
81 Local (non-installed) plugin setup::
84 $ ln -s usb-wde1_ usb-wde1_temperature
85 $ ln -s usb-wde1_ usb-wde1_humidity
89 Running the munin plugin for development purposes is also relatively easy
90 since you can pass the environment configuration variables
91 from the munin configuration on the command line::
93 $ logfile=test.log sensors="0 1 7" ./munin/usb-wde1_temperature
95 When you have problems running the munin plugin, try to
100 from file ``usb-wde1_``
107 cu: open (/dev/ttyUSB0): Permission denied
108 cu: /dev/ttyUSB0: Line in use
110 Only way that I found to fix this was change ownership of `/dev/ttyUSB0` to uucp::
112 $ chown uucp /dev/ttyUSB0
115 HTML/Plain text output
116 ======================
117 You may use ``htmlreport/gen-html.php`` to generate HTML or plain text
118 files with the temperature and humidity information.
120 Install PHP and the PHP rrd extension (``pear install pecl/rrd``) to make it
123 Run ``gen-html.php`` every 5 minutes.