DIGITEMP(1) | General Commands Manual | DIGITEMP(1) |
digitemp - program to read from 1-wire temperature sensors.
digitemp [options]
DigiTemp uses the Dallas 1-wire bus to read temperatures from digital sensors attached to a serial port adapter. It handles initializing the bus, searching for attached devices, reading devices and custom log strings. It supports the following temperature devices: DS1820, DS18S20, DS18B20, DS1822
It also handles the DS2406 1-wire hub switches, and DS2422 and DS2423 counters.
DigiTemp uses either the DS9097 passive serial port adapter, or the DS2480B based DS9097U adapter. 1-wire adapters from ibuttonlink.com, such as the Link45 are also supported.
At least 1 action must be given, along with some optional arguments. Actions are one (and only on) of the -w -t -a -w options
The temperature format can be either a numeric value, or a string. The numeric values select pre-configured output formats:
1 = One line per sensor, time, C, F (default)
2 = One line per sample, elapsed time, temperature in C
3 = Same as #2, except temperature is in F
#2 and #3 have the data separated by tabs, suitable for import into a spreadsheet or other graphing software.
The format string uses strftime tokens plus 5 special ones for DigiTemp:
The case of the token is important! The default format string is: "%b %d %H:%M:%S Sensor %s C: %.2C F: %.2F" which gives you an output of: May 24 21:25:43 Sensor 0 C: 23.66 F: 74.59
The DS2438 sensor can be used for a variety of things. It includes a temperature sensor and A/D converter. DigiTemp defaults to using it as a humidity sensor. The raw voltages and currents can be displayed by passing the -A argument
When the -o2 or -o3 log options are used the attached DS2438's temperatures will be output without the humidity.
The counter format string is similar, adding these tokens:
The Humidity format string is the same as the temperature format string with the addition of this format specifier:
This manual page was written by Jesús Roncero <jesus@roncero.org>, for the Debian project (but may be used by others). Modifications by Brian C. Lane <bcl@brianlane.com>
DigiTemp updates can be found on the http://www.digitemp.com website.
August 2008 |