Arduino Temperature Control Library

This example demonstrates how to use the Arduino Temperature Control Library on an ESP8266 or ESP32 to read temperature data from Maxim (Dallas) DS18B20 sensors and serve it via Wi-Fi. It provides both a human-friendly web dashboard (using Chart.js and Tailwind CSS) and machine-readable REST endpoints.

Prerequisites

1. Arduino Temperature Control Library installed.
2. ESP8266 or ESP32 core installed in your Arduino IDE.
3. DS18B20 sensor(s) connected to the ESP using OneWire with a pull-up resistor.

Setup Steps

1. Clone or download the repository and open the .ino file in the Arduino IDE.
2. Configure your Wi-Fi credentials in the sketch.
3. Adjust the polling interval and history length to suit your needs.
4. Upload the sketch to your device.
5. Open the Serial Monitor to find the device's IP address.
6. Navigate to the IP address in a web browser to view the dashboard.

// Set Wi-Fi credentials
const char* ssid = "YourNetwork";
const char* password = "YourPassword";

// Configuration
const unsigned long READ_INTERVAL = 10000; // e.g. 10 seconds
const int HISTORY_LENGTH = 360; // 1 hour at 10-second intervals

This example demonstrates how to initialize a single sensor on a 1-Wire bus and read its temperature in Celsius.

1. Include OneWire.h and DallasTemperature.h.
2. Initialize the OneWire object with your data pin.
3. Initialize the DallasTemperature object with the OneWire instance.
4. Call sensors.begin() in setup().
5. Call sensors.requestTemperatures() in loop() before reading values.
6. Use sensors.getTempCByIndex(index) to retrieve the temperature.

#include <OneWire.h>
#include <DallasTemperature.h>

// Data wire is connected to GPIO 4
#define ONE_WIRE_BUS 4

OneWire oneWire(ONE_WIRE_BUS);
DallasTemperature sensors(&oneWire);

void setup(void) {
  Serial.begin(9600);
  sensors.begin();
}

void loop(void) { 
  sensors.requestTemperatures(); 
  
  delay(750); 
  
  float tempC = sensors.getTempCByIndex(0);
  Serial.print("Temperature: ");
  Serial.print(tempC);
  Serial.println("°C");
  delay(1000);
}