Interface Multiple DS18B20s with ESP32 & Display Values Using Web Server
Have you ever wanted to have sensors scattered all around your house and garden reporting their temperature regularly to a central server? Then, this IoT project might be the solid launching point for you!
This project uses ESP32 as the control device that easily connects to existing WiFi network & creates a Web Server. When any connected device accesses this web server, ESP32 reads in temperature from multiple DS18B20 Temperature sensors & sends it to the web browser of that device with a nice interface. Excited? Let’s get started!
Multiple DS18B20s On Single Bus
One of the biggest features of DS18B20 is that multiple DS18B20s can coexist on the same 1-Wire bus. As each DS18B20 has a unique 64-bit serial code burned in at the factory, it’s easier to differentiate them from one another.
This feature can be a huge advantage when you want to control many DS18B20s distributed over a large area. In this tutorial we are going to do the same.
Wiring Multiple DS18B20 Sensors to ESP32
Connecting DS18B20 sensors to ESP32 is fairly simple.
Start by connecting all the DS18B20s in parallel i.e. common all the VDD pins, GND pins & signal pins. Then connect VDD to the 3.3V out on ESP32, GND to ground and connect signal pin to digital pin 15 on ESP32.
Next, you’ll need to add one 4.7k pull-up resistor for whole bus between the signal and power pin to keep the data transfer stable.
Preparing the Arduino IDE
There’s an add-on for the Arduino IDE that allows you to program the ESP32 using the Arduino IDE. Follow below tutorial to prepare your Arduino IDE to work with the ESP32, if you haven’t already.
Installing Library For DS18B20
The Dallas 1-Wire protocol is somewhat complex, and requires a bunch of code to parse out the communication. To hide away this unnecessary complexity we will install DallasTemperature.h library so that we can issue simple commands to get temperature readings from the sensor.
To install the library navigate to the Arduino IDE > Sketch > Include Library > Manage Libraries… Wait for Library Manager to download libraries index and update list of installed libraries.
Filter your search by typing ‘ds18b20’. There should be a couple entries. Look for DallasTemperature by Miles Burton. Click on that entry, and then select Install.
This Dallas Temperature library is a hardware-specific library which handles lower-level functions. It needs to be paired with One Wire Library to communicate with any one-wire device not just DS18B20. Install this library as well.
Finding Addresses Of DS18B20s On Bus
We know that each DS18B20 has a unique 64-bit address assigned to it to differentiate them from one another. First, we’ll find that address to label each sensor accordingly. The address can then be used to read each sensor individually.
The following sketch detects all the DS18B20s present on the bus and prints their one-wire address on the serial monitor.
You can wire just one sensor at a time to find its address (or successively add a new sensor) so that you’re able to identify each one by its address. Then, you can label each sensor.
Now, open the serial monitor. You should get something as follows.
Copy all the addresses as we need them in out next sketch.
Create ESP32 Web Server using WiFi Station (STA) mode
Now, we are going to configure our ESP32 into Station (STA) mode, and create a web server to serve up web pages to any connected client under existing network.
If you want to learn about creating a web server with ESP32 in AP/STA mode, check this tutorial out.
Before you head for uploading the sketch, you need to make some changes to make it work for you.
- You need to modify the following two variables with your network credentials, so that ESP32 can establish a connection with existing network.
- Before serving up a web page ESP32 reads the temperature from each DS18B20 by its address so, you need to change the addresses of DS18B20s with the one you’ve found in previous sketch.
Once you are done, go ahead and try the sketch out.
Accessing the Web Server
After uploading the sketch, open the Serial Monitor at a baud rate of 115200. And press the EN button on ESP32. If everything is OK, it will output the dynamic IP address obtained from your router and show HTTP server started message.
Next, load up a browser and point it to the IP address shown on the serial monitor. The ESP32 should serve up a web page showing temperatures from all the DS18B20s.
Detailed Code Explanation
The sketch starts by including following libraries.
- WiFi.h library provides ESP32 specific WiFi methods we are calling to connect to network.
- WebServer.h library has some methods available that will help us setting up a server and handle incoming HTTP requests without needing to worry about low level implementation details.
- DallasTemperature.h library is a hardware-specific library which handles lower-level functions. It needs to be paired with One Wire Library, in order to make it work.
- OneWire.h library communicates with any one-wire device not just DS18B20.
Next we create the instances needed for the temperature sensor and variables to store temperature readings. The temperature sensor is connected to GPIO15.
Next, we enter the addresses that are found previously for each temperature sensor. In our case, we have the following.
As we are configuring ESP32 in Station (STA) mode, it will join existing WiFi network. Hence, we need to provide it with your network’s SSID & Password. Next we start web server at port 80.
Inside Setup() Function
Inside Setup() Function we configure our HTTP server before actually running it. First of all, we initialize serial communication with PC and initialize DallasTemperature object using
begin()
function. It initializes the bus and detects all the DS18B20s present on it. Each sensor is then assigned with an index and set bit resolution to 12-bit.
Now, we need to join the WiFi network using
WiFi.begin()
function. The function takes SSID (Network Name) and password as a parameter.
While the ESP32 tries to connect to the network, we can check the connectivity status with WiFi.status() function.
Once the ESP32 is connected to the network, the sketch prints the IP address assigned to ESP32 by displaying
WiFi.localIP()
value on serial monitor.
In order to handle incoming HTTP requests, we need to specify which code to execute when a URL is hit. To do so, we use on method. This method takes two parameters. First one is a URL path and second one is the name of function which we want to execute when that URL is hit.
The code below indicates that when a server receives an HTTP request on the root (/) path, it will trigger the
handle_OnConnect
function. Note that the URL specified is a relative path.
We haven’t specified what the server should do if the client requests any URL other than specified with
server.on
. It should respond with an HTTP status 404 (Not Found) and a message for the user. We put this in a function as well, and use server.onNotFound
to tell it that it should execute it when it receives a request for a URL that wasn’t specified with server.on
Now, to start our server, we call the begin method on the server object.
Inside Loop() Function
To handle the actual incoming HTTP requests, we need to call the
handleClient()
method on the server object.
Next, we need to create a function we attached to root (/) URL with
server.on
Remember?
At the start of this function, we get the temperature reading from each sensor. In order to respond to the HTTP request, we use the send method. Although the method can be called with a different set of arguments, its simplest form consists of the HTTP response code, the content type and the content.
In our case, we are sending the code 200 (one of the HTTP status codes), which corresponds to the OK response. Then, we are specifying the content type as “text/html“, and finally we are calling
SendHTML()
custom function which creates a dynamic HTML page containing temperature readings.
Likewise, we need to create a function to handle 404 Error page.
Displaying the HTML Web Page
SendHTML()
function is responsible for generating a web page whenever the ESP32 web server gets a request from a web client. It merely concatenates HTML code into a big string and returns to the server.send()
function we discussed earlier. The function takes temperature readings as a parameter to dynamically generate the HTML content.
The first text you should always send is the <!DOCTYPE> declaration that indicates that we’re sending HTML code.
Next, the <meta> viewport element makes the web page responsive in any web browser, while title tag sets the title of the page.
Styling the Web Page
Next, we have some CSS to style the web page appearance. We choose the Helvetica font, define the content to be displayed as an inline-block and aligned at the center.
Following code then sets color, font and margin around the body, H1 and p tags.
Setting the Web Page Heading
Next, heading of the web page is set; you can change this text to anything that suits your application.
Displaying Temperature readings on Web Page
To dynamically display temperature readings, we put those values in paragraph tag. To display degree symbol, we use HTML entity °
Styling Web Page to Look More Professional
Programmers like us are often intimidated by design – but a little effort can make your web page look more attractive and professional. Below screenshot will give you a basic idea of what we are going to do.
Pretty amazing, Right? Without further ado, let’s apply some style to our previous HTML page. To start with, copy-paste below code to replace
SendHTML()
function from the sketch above.
If you try to compare this function with the previous one, you’ll come to know that they are similar except these changes.
- We have used Google commissioned Open Sans web font for our web page. Note that you cannot see Google font, without active internet connection on the device. Google fonts are loaded on the fly.
- The icons used to display temperature readings are actually a Scalable Vector Graphics (SVG) defined in <svg> tag. Creating SVG doesn’t require any special programming skills. You can use Google SVG Editor for creating graphics for your page. We have used these SVG icons.
Improvement to the Code – Auto Page Refresh
One of the improvements you can do with our code is refreshing the page automatically in order to update the sensor value.
With the addition of a single meta tag into your HTML document, you can instruct the browser to automatically reload the page at a provided interval.
Place this code in the the <head> tag of your document, this meta tag will instruct the browser to refresh every two seconds. Pretty nifty!
Dynamically load Sensor Data with AJAX
Refreshing a web page isn’t too practical if you have a heavy web page. A better method is to use Asynchronous Javascript And Xml (AJAX) so that we can request data from the server asynchronously (in the background) without refreshing the page.
The XMLHttpRequest object within JavaScript is commonly used to execute AJAX on webpages. It performs the silent GET request on the server and updates the element on the page. AJAX is not a new technology, or different language, just existing technologies used in new ways. Besides this, AJAX also makes it possible to
- Request data from a server after the page has loaded
- Receive data from a server after the page has loaded
- Send data to a server in the background
Here is the AJAX script that we’ll be using. Place this script just before you close </head> tag.
The script starts with <script> tag. As AJAX script is nothing but a javascript, we need to write it in <script> tag. In order for this function to be repeatedly called, we will be using the javascript
setInterval()
function. It takes two parameters – a function to be executed and time interval (in milliseconds) on how often to execute the function.
The heart of this script is a
loadDoc()
function. Inside this function, an XMLHttpRequest()
object is created. This object is used to request data from a web server.
The
xhttp.onreadystatechange()
function is called every time the readyState changes. The readyState property holds the status of the XMLHttpRequest. It has one of the following values.- 0: request not initialized
- 1: server connection established
- 2: request received
- 3: processing request
- 4: request finished and response is ready
The status property holds the status of the XMLHttpRequest object. It has one of the following values.
- 200: “OK”
- 403: “Forbidden”
- 404: “Page not found”
When readyState is 4 and status is 200, the response is ready. Now, the content of body (holding temperature readings) is updated.
The HTTP request is then initiated via the open() and send() functions.
No comments:
Post a Comment