Repository files navigation

A robust and feature-complete Arduino library for Maxim Temperature Integrated Circuits.

1. Open Arduino IDE
2. Go to Tools > Manage Libraries...
3. Search for "DallasTemperature"
4. Click Install
5. Also install the required "OneWire" library by Paul Stoffregen using the same method

1. Download the latest release fromGitHub releases
2. In Arduino IDE, go to Sketch > Include Library > Add .ZIP Library...
3. Select the downloaded ZIP file
4. Repeat steps 1-3 for the required "OneWire" library

1. Hardware Setup

   • Connect a 4k7 Ω pull-up resistor between the 1-Wire data line and 5V power. Note this applies to the Arduino platform, for ESP32 and 8266 you'll need to adjust the resistor value accordingly.
   • For DS18B20: Ground pins 1 and 3 (the centre pin is the data line)
   • For reliable readings, see pull-up requirements in theDS18B20 datasheet (page 7)

2. Code Example

   #include<OneWire.h>#include<DallasTemperature.h>// Data wire is connected to GPIO 4#defineONE_WIRE_BUS4OneWireoneWire(ONE_WIRE_BUS);DallasTemperaturesensors(&oneWire);voidsetup(void) {  Serial.begin(9600);  sensors.begin();}voidloop(void) {    sensors.requestTemperatures();delay(750);float tempC = sensors.getTempCByIndex(0);   Serial.print("Temperature:");   Serial.print(tempC);   Serial.println("°C");delay(1000);}

• Multiple sensors on the same bus
• Temperature conversion by address (getTempC(address) andgetTempF(address))
• Asynchronous mode (added in v3.7.0)
• Configurable resolution

You can slim down the code by defining the following at the top of DallasTemperature.h:

#defineREQUIRESNEW// Use if you want to minimise code size#defineREQUIRESALARMS// Use if you need alarm functionality

Visit ourWiki for detailed documentation.

If you want to contribute to the library development:

The project includes a development container configuration for VS Code that provides a consistent development environment.

1. Prerequisites

   • Visual Studio Code
   • Docker
   • VS Code Remote - Containers extension

2. Development CommandsWithin the dev container, use:

   • arduino-build - Compile the library and examples
   • arduino-test - Run the test suite
   • arduino-build-test - Complete build and test process

   Note: Currently compiling against arduino:avr:uno environment

• Original development by Miles Burtonmail@milesburton.com
• Multiple sensor support by Tim Newsomenuisance@casualhacker.net
• Address-based temperature reading by Guil Barrosgfbarros@bappos.com
• Async mode by Rob Tillaartrob.tillaart@gmail.com

MIT License | Copyright (c) 2025 Miles Burton

Full license text available inLICENSE file.