---
name: "w1retap"
section: "1"
platform: "linux"
package: "w1retap"
version: "1.5.5-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/w1retap"
---

# w1retap(1)

Data logger for 1-Wire weather sensors

## NAME

w1retap - Data logger for 1-Wire weather sensors

## SYNOPSIS

**w1retap** \[*OPTIONS*\]

## DESCRIPTION

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

## EXAMPLE

• $ 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

## SEE ALSO

[w1find(1)](/w1find/1.md), [w1sensors(1)](/w1sensors/1.md)

## RESOURCES

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

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

## AUTHOR

This manual page was written by Thomas Stewart \<thomas@stewarts.org.uk\> 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.