How to wire a DS18B20 to an ESP32-S3
To wire a DS18B20 to an ESP32-S3, connect VDD to 3V3, DQ to GPIO 4 and GND to G. The sensor and its 4.7 kilohm pull-up both go to 3.3 V, so the one data line idles at the board’s own level. The sketch below uses the DallasTemperature (DallasTemperature.h) library. It counts the sensors on the one-wire bus and prints the temperature.
- 3.3 V logic
- Library: DallasTemperature.h
- 3 wires, 1 helper parts
DS18B20 to ESP32-S3 wiring table
Every wire in the circuit above, with the part’s pin names and the board’s own labels. The wire colors are the ones the circuit uses; on a real bench any colors work.
| DS18B20 pin | ESP32-S3 pin | Wire color | Why |
|---|---|---|---|
| VDD (right leg) | 3V3 | red | The DS18B20 runs from 3.0 to 5.5 V. |
| DQ (middle leg) | GPIO 4 | amber | The one data wire, shared by every sensor on the bus. |
| GND (left leg) | G | blue | Ground, with the flat face toward you. |
| 4.7 k resistor | DQ to 3V3 | n/a | The pull-up the bus needs: the sensor only ever pulls the line low. |
Helper parts
The extra parts in the circuit above, and where their wires go:
| From | To | Wire color |
|---|---|---|
| R1 (4.7 kΩ) pin 1 | DQ | amber |
| R1 (4.7 kΩ) pin 2 | VDD | red |
Power and logic levels for DS18B20 and ESP32-S3
Logic level
The ESP32-S3’s GPIO pins are 3.3 V logic and are not 5 V tolerant. Nothing wired to a pin may go above 3.3 V.
Supply
The DS18B20 takes 3.3 V from 3V3. That pin is the ESP32-S3’s own regulated 3.3 V output.
This pair
On the ESP32-S3 the sensor and its pull-up go to 3V3, so the data line idles at 3.3 V. With a long cable, drop the pull-up to 2.2 k.
Pins to leave alone
GPIO 19 and 20 are the USB port’s data lines, GPIO 35 to 37 belong to the PSRAM on octal-PSRAM boards such as the N8R8, and GPIO 0, 3, 45 and 46 are strapping pins.
The working code for the ESP32-S3
Library: DallasTemperature (DallasTemperature.h). This is the sketch the circuit above runs.
#include <OneWire.h>
#include <DallasTemperature.h>
const int ONE_WIRE_PIN = 4; // DQ, GPIO 4, with 4.7 k to 3V3
OneWire oneWire(ONE_WIRE_PIN);
DallasTemperature sensors(&oneWire);
void setup() {
Serial.begin(115200);
sensors.begin();
Serial.print("Sensors found: ");
Serial.println(sensors.getDeviceCount());
}
void loop() {
sensors.requestTemperatures(); // start a conversion on every sensor
float celsius = sensors.getTempCByIndex(0);
if (celsius == DEVICE_DISCONNECTED_C) {
Serial.println("Sensor not found");
} else {
Serial.print("Temperature: ");
Serial.print(celsius, 2);
Serial.println(" C");
}
delay(1000);
}
What you should see
Open the serial monitor at 115200 baud. The sketch prints how many sensors it found and then the temperature in degrees C once a reading is ready; the sensor starts at 22 degrees.
A reading of -127 C, or no sensor found, means the data line has no pull-up or is on the wrong pin.
The serial monitor prints this, recorded from the circuit above left at its defaults:
Sensors found: 1
Temperature: 22.00 CCommon mistakes wiring a DS18B20 to an ESP32-S3
No pull-up resistor
Without the 4.7 k from DQ to the supply, the line never goes high, sensors.begin() finds nothing and every reading is -127. In the simulator, delete the resistor and you get exactly that.
The sensor in backwards
With the flat side facing you, the legs are GND, DQ, VDD from left to right. Reversed, a real DS18B20 gets hot fast. Waterproof probes use red for VDD, black for GND and yellow or white for DQ.
Using the USB or PSRAM pins
GPIO 19 and 20 are the USB port’s data lines and GPIO 35 to 37 belong to the PSRAM on N8R8 boards. Wire the 1-Wire bus to one of those and the USB socket or the memory stops working on a real board, even though the simulator carries on. Stay on GPIO 4 to 18.
Build your own DS18B20 project
Open this circuit in the editor, change the wiring or the code, and keep your version in a free account.