DIGITEMP(1)

📦 version 3.7.2, in debian bookworm, debian trixie, epel 9, fedora 43, fedora 44, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 DIGITEMP 💖

okay bestie, listen up — this is the manual page for digitemp, a little general commands manual situation, and honestly? it's iconic. she reads temperatures off 1-wire sensors and she does NOT miss. let's get into it. 🦋

✨ NAME ✨

digitemp — the program that reads from 1-wire temperature sensors. that's it, that's the girl. 👑

🌸 SYNOPSIS 🌸

digitemp [options]

no subcommands, no drama, just options. slay.

🎀 DESCRIPTION 🎀

so DigiTemp uses the Dallas 1-wire bus to read temperatures from digital sensors attached to a serial port adapter. it literally handles everything: initializing the bus, searching for attached devices, reading devices, and custom log strings. a whole multitasker. 💅

the temperature devices she supports:

  • DS1820
  • DS18S20
  • DS18B20
  • DS1822

she ALSO handles the DS2406 1-wire hub switches, and the DS2422 and DS2423 counters. not just a one-trick pony fr fr. 🔥

and for hardware? 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. so many options bestie, we love a flexible queen. 🌈

💅 OPTIONS 💅

okay so the rules: 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. yes, that's how it's written, i don't make the rules. 🙈

  • -h, -? — show a summary of options. the lil help me bestie move.
  • -v — show verbose output. she's chatty, we love that.
  • -i — initialize .digitemprc file, search the bus for all supported devices. manifesting your config into existence ✨
  • -I — initialize .digitemprc file, search the bus for all supported devices, store devices in sorted serial # order. same energy, but organized. main character with a planner.
  • -w — walk the full device tree and display the serial number and type of all devices detected on the bus. going for a lil stroll 🚶‍♀️
  • -s /dev/ttyS0 — set serial port to use. make sure you have permission to access this port, bestie, don't get caught lackin. for USB operation pass USB instead of /dev/ttySX.
  • -l /var/log/temperature — send output to logfile. the output format is defined by the .B -o command.
  • -c digitemp.conf — set digitemp configuration file. the default is .digitemprc in the current directory.
  • -r 1000 — read delay in ms. this sets the amount of time to wait between sending the temperature conversion command and reading the result. the DS18S20 takes about 750mS to do the temperature conversion. default is 1000mS (1 sec). patience is a virtue ig 🕐
  • -t # — read sensor number #. the # depends on the order of the sensors in the .digitemprc file.
  • -q — quiet output, no copyright banner. shy era.
  • -a — read all sensors. all of them. every single one. 🫶
  • -A — treat DS2438 as A/D converter, output raw voltages and currents.
  • -d 5 — delay between samples (in seconds).
  • -n 50 — number of times to repeat the command.
  • -O"counter format string" — see Counter Format below. 👀
  • -o [1..3] ["output format string"] — see Temperature Format below. 👀
  • -H"Humidity format string" — see Humidity Format below. 👀

🌡️ Temperature Format 🌡️

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. spreadsheet girlies rise up 📊

the format string uses strftime tokens plus 5 special ones for DigiTemp:

  • %s — for sensor #
  • %C — for centigrade
  • %F — for fahrenheit
  • %R — to output the hex serial number
  • %N — for seconds since Epoch.
⚠️ the case of the token is important! do not play with her like that. case matters!!

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

look at her. gorgeous. 🌸

the DS2438 sensor can be used for a variety of things. it includes a temperature sensor and an 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. noted, no cap.

🔢 Counter Format String 🔢

the counter format string is similar, adding these tokens:

  • %n — is the counter #, which depends on its position in the .digitemprc file
  • %C — is the count in decimal.

💧 Humidity Format String 💧

the humidity format string is the same as the temperature format string with the addition of this format specifier:

  • %h — is the humidity in 0-100%

👑 AUTHOR 👑

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>. legends, both of them. 💖

🔥 UPDATES 🔥

DigiTemp updates can be found on the http://www.digitemp.com website. go check her out.

and that's the whole page bestie, no crumbs left. this version is from August 2008, it's the DIGITEMP(1) manual, and she ate. periodt. 💅✨🎀🦋

📦 where this page comes from