w1retap(1)

w1retap1

Data logger for 1-wire weather sensors

Usage

w1retap [OPTIONS]

Overview

The w1retap package reads weather sensors on a 1-Wire bus and data logs the retrieved data to the configured databases or files. It supports a number of different 1-Wire host bus adapters and 1-Wire sensors designed by Dallas Semiconductor Corp (now Maxim Integrated) and compatible sensors including those from AAG Electrónica and other hobby sensors.

Options

-h, --help

Show help options

-w, --wait

At startup, wait until next interval

-1, --once-only

Read once and exit

-R, --release-interface

Release the 1Wire interface between reads

-d, --daemonise

Daemonise (background) application

-T, --no-tmp-log

Disables /var/lib/w1retap/.w1retap.dat logging

-l, --tmp-log-name=FILE

Names logging file (/var/lib/w1retap/.w1retap.dat)

-i, --interface=DEVICE

Interface device, the DEVICE can be serial DS2480 adaptor or a USB DS2490-1 adaptor. Use the serial device node (eg /dev/ttyS0 or /dev/ttyUSB0) for serial or use DS2490-1 to use libusb for a USB adaptor.

-t, --cycle-time=SECS

Time (secs) between device readings

-N, --dont-read

Don’t read sensors (for debugging)

-v, --verbose

Verbose messages

-o, --vane-offset=VAL

Value for N for weather vane (0-15)

-V, --version

Display version number (and exit)

-s, --simulate

Simulate readings (for testing, not yet implemented)

-u, --use-utc

Store dates as UTC (vice localtime)

-r, --report-log=FILE

Report log file

Examples

• $ w1retap -l -i /dev/ttyUSBS0 -v

Signals

The w1retap daemon accepts three signals. SIGUSR1 causes it to read all the sensors immediately. SIGUSR2 causes it to print the current configuration. SIGHUP causes it to re-read the configuration.

Exit status

0

Returns 0 on success or failure

Resources

• /usr/share/doc/w1retap-doc/w1retap.odt

• http://www.zen35309.zen.co.uk/wx/tech.html

Releases

5 releases since Debian 9 (Stretch); the text changed 4 times.

  1. 9
  2. 10
  3. 11
  4. 12
  5. 13

Author

This manual page was written by Thomas Stewart <[email protected]> for the Debian GNU/Linux system (but may be used by others). Permission is granted to modify and distribute this manpage under the terms of GNU General Public Licence version 2 or (at your opinion) any later version.

From w1retap 1.5.5-2 in Debian 13 (Trixie). Parsed by carta from the page's man source.