1DIGITEMP(1) General Commands Manual DIGITEMP(1)
2
3
4
6 digitemp - program to read from temperature sensors.
7
9 digitemp [options]
10
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 suports the following temperature devices: DS1820, DS18S20,
16 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 (recommended).
23
25 At least 1 action must be given, along with some optional arguments.
26 Actions are one (and only on) of the -w -t -a -w options
27
28 -h, -? Show summary of options.
29
30 -v Show verbose output.
31
32 -i Initialize .digitemprc file, search the bus for all supported
33 devices.
34
35 -w Walk the full device tree and display the serial number and type
36 of all devices detected on the bus.
37
38 -s /dev/ttyS0
39 Set serial port to use. Make sure you have permission to access
40 this port.
41
42 -l /var/log/temperature
43 Send output to logfile, the output format is defined by the .B
44 -o command
45
46 -c digitemp.conf
47 Set digitemp configuration file. The default is .digitemprc in
48 the current directory.
49
50 -r 1000
51 Read delay in ms. This sets the amount of time to wait between
52 sending the temperature conversion command and reading the
53 result. The DS18S20 takes about 750mS to do the temperature con‐
54 version. Default is 1000mS (1 sec).
55
56 -t # Read sensor number #, the # depends on the order of the sensors
57 in the
58
59 -q Quiet output, no copyright banner.
60
61 -a Read all sensors.
62
63 -A Treat DS2438 as A/D converter, output raw voltages
64
65 -d 5 Delay between samples (in seconds).
66
67 -n 50 Number of times to repeat the command.
68
69 -O"counter format string"
70 See Counter Format below.
71
72 -o [1..3] ["output format string"]
73 See Temperature Format below.
74
75 -H"Humidity format string"
76 See Humidity Format below.
77
79 The temperature format can be either a numeric value, or a string. The
80 numeric values select pre-configured output formats:
81
82 1 = One line per sensor, time, C, F (default)
83 2 = One line per sample, elapsed time, temperature in C
84 3 = Same as #2, except temperature is in F
85
86 #2 and #3 have the data seperated by tabs, suitable for import into a
87 spreadsheet or other graphing software.
88
89 The format string uses strftime tokens plus 5 special ones for Dig‐
90 iTemp:
91
92 %s for sensor #
93
94 %C for centigrade
95
96 %F for fahrenheit
97
98 %R to output the hex serial number
99
100 %N for seconds since Epoch.
101
102 The case of the token is important! The default format string is: "%b
103 %d %H:%M:%S Sensor %s C: %.2C F: %.2F" which gives you an output of:
104 May 24 21:25:43 Sensor 0 C: 23.66 F: 74.59
105
106 The DS2438 sensor can be used for a variety of things. It includes a
107 temperature sensor and A/D converter. DigiTemp defaults to using it as
108 a humidity sensor. The raw voltages can be displayed by passing the -A
109 argument
110
111 When the -o2 or -o3 log options are used the attached DS2438's tempera‐
112 tures will be output without the humidity.
113
115 The counter format string is similar, adding these tokens:
116
117 %n is the counter #, which depends on its position in the .digitem‐
118 prc file
119
120 %C is the count in decimal.
121
123 The Humidity format string is the same as the temperature format string
124 with the addition of this format specifier:
125
126 %h is the humidity in 0-100%
127
129 This manual page was written by Jesús Roncero <jesus@roncero.org>, for
130 the Debian project (but may be used by others). Modifications by Brian
131 C. Lane <bcl@brianlane.com>
132
134 DigiTemp updates can be found on the http://www.digitemp.com website.
135
136
137
138
139 June 2005 DIGITEMP(1)