1
.TH DIGITEMP 1 "June 2003"
2
.\" Some roff macros, for reference:
3
.\" .nh disable hyphenation
4
.\" .hy enable hyphenation
6
.\" .ad b justify to both left and right margins
7
.\" .nf disable filling
9
.\" .br insert line break
10
.\" .sp <n> insert n+1 empty lines
11
.\" for manpage-specific macros, see man(7)
13
digitemp \- program to read from temperature sensors.
18
DigiTemp uses the Dallas 1-wire bus to read temperatures from digital
19
sensors attached to a serial port adapter. It handles initializing the bus,
20
searching for attached devices, reading devices and custom log strings. It
21
suports the following temperature devices: DS1820, DS18S20, DS18B20, DS1822
23
It also handles the DS2406 1-wire hub switches, and DS2422 and DS2423
26
DigiTemp uses either the DS9097 passive serial port adapter, or the
27
DS2480B based DS9097U adapter (recommended).
29
At least 1 action must be given, along with some optional arguments. Actions
30
are one (and only on) of the
35
Show summary of options.
41
Initialize .digitemprc file, search the bus for all supported devices.
44
Walk the full device tree and display the serial number and type of all
45
devices detected on the bus.
48
Set serial port to use. Make sure you have permission to access this port.
50
.B \-l /var/log/temperature
51
Send output to logfile, the output format is defined by the .B \-o
55
Set digitemp configuration file. The default is .digitemprc in the current
59
Read delay in ms. This sets the amount of time to wait between sending the
60
temperature conversion command and reading the result. The DS18S20 takes
61
about 750mS to do the temperature conversion. Default is 1000mS (1 sec).
64
Read sensor number #, the # depends on the order of the sensors in the
68
Quiet output, no copyright banner.
74
Delay between samples (in seconds).
77
Number of times to repeat the command.
79
.B \-O"counter format string"
80
See Counter Format below.
82
.B \-o [1..3] ["output format string"]
83
See Temperature Format below.
88
The temperature format can be either a numeric value, or a string. The
89
numeric values select pre-configured output formats:
91
1 = One line per sensor, time, C, F (default)
92
2 = One line per sample, elapsed time, temperature in C
93
3 = Same as #2, except temperature is in F
95
#2 and #3 have the data seperated by tabs, suitable for import into a
96
spreadsheet or other graphing software.
98
The format string uses strftime tokens plus 5 special ones for
111
to output the hex serial number
114
for seconds since Epoch.
116
The case of the token is important! The default format string is:
117
"%b %d %H:%M:%S Sensor %s C: %.2C F: %.2F" which gives you an
118
output of: May 24 21:25:43 Sensor 0 C: 23.66 F: 74.59
121
Counter Format String
123
The counter format string is similar, adding these tokens:
126
is the counter #, which depends on its position in the .digitemprc file
129
is the count in decimal.
132
This manual page was written by Jes�s Roncero <jesus@roncero.org>,
133
for the Debian project (but may be used by others). Modifications by Brian
136
DigiTemp updates can be found on the http://www.digitemp.com website.