1DIGITEMP(1)                 General Commands Manual                DIGITEMP(1)
2
3
4

NAME

6       digitemp - program to read from 1-wire temperature sensors.
7

SYNOPSIS

9       digitemp [options]
10

DESCRIPTION

12       DigiTemp  uses  the Dallas 1-wire bus to read temperatures from digital
13       sensors attached to a serial port adapter. It handles initializing  the
14       bus,  searching  for  attached  devices, reading devices and custom log
15       strings.  It  supports  the  following  temperature  devices:   DS1820,
16       DS18S20, DS18B20, DS1822
17
18       It  also  handles the DS2406 1-wire hub switches, and DS2422 and DS2423
19       counters.
20
21       DigiTemp uses either the DS9097 passive serial  port  adapter,  or  the
22       DS2480B  based  DS9097U  adapter. 1-wire adapters from ibuttonlink.com,
23       such as the Link45 are also supported.
24

OPTIONS

26       At least 1 action must be given, along with  some  optional  arguments.
27       Actions are one (and only on) of the -w -t -a -w options
28
29       -h, -? Show summary of options.
30
31       -v     Show verbose output.
32
33       -i     Initialize  .digitemprc  file,  search the bus for all supported
34              devices.
35
36       -I     Initialize .digitemprc file, search the bus  for  all  supported
37              devices, store devices in sorted serial # order.
38
39       -w     Walk the full device tree and display the serial number and type
40              of all devices detected on the bus.
41
42       -s /dev/ttyS0
43              Set serial port to use. Make sure you have permission to  access
44              this port. For USB operation pass USB instead of /dev/ttySX
45
46       -l /var/log/temperature
47              Send  output  to logfile, the output format is defined by the .B
48              -o command
49
50       -c digitemp.conf
51              Set digitemp configuration file. The default is  .digitemprc  in
52              the current directory.
53
54       -r 1000
55              Read  delay  in ms. This sets the amount of time to wait between
56              sending the  temperature  conversion  command  and  reading  the
57              result. The DS18S20 takes about 750mS to do the temperature con‐
58              version. Default is 1000mS (1 sec).
59
60       -t #   Read sensor number #, the # depends on the order of the  sensors
61              in the .digitemprc file.
62
63       -q     Quiet output, no copyright banner.
64
65       -a     Read all sensors.
66
67       -A     Treat DS2438 as A/D converter, output raw voltages and currents.
68
69       -d 5   Delay between samples (in seconds).
70
71       -n 50  Number of times to repeat the command.
72
73       -O"counter format string"
74              See Counter Format below.
75
76       -o [1..3] ["output format string"]
77              See Temperature Format below.
78
79       -H"Humidity format string"
80              See Humidity Format below.
81

Temperature Format

83       The  temperature format can be either a numeric value, or a string. The
84       numeric values select pre-configured output formats:
85
86           1 = One line per sensor, time, C, F (default)
87           2 = One line per sample, elapsed time, temperature in C
88           3 = Same as #2, except temperature is in F
89
90       #2 and #3 have the data separated by tabs, suitable for import  into  a
91       spreadsheet or other graphing software.
92
93       The  format  string  uses  strftime tokens plus 5 special ones for Dig‐
94       iTemp:
95
96       %s     for sensor #
97
98       %C     for centigrade
99
100       %F     for fahrenheit
101
102       %R     to output the hex serial number
103
104       %N     for seconds since Epoch.
105
106       The case of the token is important! The default format string  is:  "%b
107       %d  %H:%M:%S  Sensor  %s C: %.2C F: %.2F" which gives you an output of:
108       May 24 21:25:43 Sensor 0 C: 23.66 F: 74.59
109
110       The DS2438 sensor can be used for a variety of things.  It  includes  a
111       temperature  sensor and A/D converter. DigiTemp defaults to using it as
112       a humidity sensor. The raw voltages and currents can  be  displayed  by
113       passing the -A argument
114
115       When the -o2 or -o3 log options are used the attached DS2438's tempera‐
116       tures will be output without the humidity.
117

Counter Format String

119       The counter format string is similar, adding these tokens:
120
121       %n     is the counter #, which depends on its position in the .digitem‐
122              prc file
123
124       %C     is the count in decimal.
125

Humidity Format String

127       The Humidity format string is the same as the temperature format string
128       with the addition of this format specifier:
129
130       %h     is the humidity in 0-100%
131

AUTHOR

133       This manual page was written by Jesús Roncero <jesus@roncero.org>,  for
134       the  Debian project (but may be used by others). Modifications by Brian
135       C. Lane <bcl@brianlane.com>
136

UPDATES

138       DigiTemp updates can be found on the http://www.digitemp.com website.
139
140
141
142                                  August 2008                      DIGITEMP(1)