In a previous tutorial, we covered how to connect and read from DS18B20 sensors with your Beaglebone. I’d now like to cover the process of displaying live-updating DS18B20 temperatures in your browser using a Beaglebone Black. We’ll be using Socket.IO, a simple library that can be used to quickly communicate between a web browser and the server using the web sockets protocol. This tutorial will display all connected DS18B20 sensors in a nicely formatted table. This is geared towards developing a basic understanding how to use nodeJS with Socket.IO and the DS18B20 sensor. It can be used as a groundwork to use temperature readings in graphs and other formats. I use very similar code to turn on or off my connected SSR and pump relays.

DS18B20 Temperatures In Your Browser

Prerequisites

I will assume you already have the following installed:

The Beaglebone and Raspberry Pi nodeJS development community is quite active. This means there are a lot of libraries available that make it simple to do tasks on your Beaglebone. For example, we will be using a package specifically for reading DS18B20 temperatures.

Install NodeJS Packages

In a SSH session, move the current directory to your webserver’s document root (i.e .e /var/www) and install the necessary Node packages.

The necessary packages should now be installed into the directory ./node_modules/

Create app.js

Using your favorite text editor or IDE, let’s create the app.js file. This file is the node script that will be performing most of the work. It is responsible for the periodic reading of sensor values and sending them to connected web browsers.

Copy and paste the following into the file app.js:

Save and close as app.js.

index.html

Next you will need to create the file index.html. This file is loaded by your web browser and contains code to handle variables emitted from socket.IO.

Save and close as index.html.

Wrapping it up

You’re ready to test out your node script! Start the script using node app.js. You’ll need to leave open your current terminal window as the process is linked to your login when you run it like this.

Open up index.html in your web browser. In a few seconds, you should see live updating temperature readings from each connected DS18B20 sensors.


SSR

A solid state relay (SSR) is an electronic (as opposed to mechanical) switch that is able to control a large amount of current with a small amount of input. Compared to a mechanical relay, SSR’s are capable of switching on and off on the order of milliseconds and hypothetically have a lifespan of switching in the millions of times. From a speed perspective, a mechanical relay would likely be fine, but it’s lifespan would be less than a few dozen brew sessions. (more…)


Giving sudo to PHP is one of the several ways to execute a shell command from a web interface. It is probably not one of the most secure methods, so I recommend not doing this on a server which has outside (WAN) internet access because of the possibility of malicious code being executed. A person with ill intent could then access your entire network, including any shared files, network attached storage, etc. You need to be careful with this.

First, I’ll cover alternative methods and then I’ll jump into how to do it with PHP.

Alternative Methods

  1. Use a text file to serve as the current command for the GPIO pin. Use a cron job to execute a python script every minute that reads the text file and parses the instructions for each relay.
    • Cons
    • Slow. Cron jobs can only be executed as frequently as every minute. That’s how the system was designed. There are work arounds to this by using a while loop in python code, though.
    • Requires more coding
  2. Granting super user to www-data
    • Cons
    • Easily the least secure method of doing this. By granting superuser to www-data, you are giving superuser to every file that is executed by apache. This is a huge security risk that probably will result in compromise of your server. Don’t do it.
  3. A variant of #1 is storing the desired state of the system in a MySQL database and reading it from python. This may be the simplest method because interacting with MySQL in python is very easy to do.
  4. Running NodeJS and using socket.io to execute commands. This involves running a webserver in Node and interacting with the Node script with socket.io. I may cover how to do this in a future write-up.

Editing Your sudoers

Now, on to how to give permission to PHP. You are modifying /etc/sudoers to allow a specific PHP file to have sudo rights. I’ll mention security again. If you have an unsecure script, say you are using HTTP GET to send the command to the script, users with access will have free power to execute any command they wish.

  1. Edit the sudoers file to include your script. Note that you really should use visudo instead of editing the file directly as this is a safer method. You obviously need root do this.
  2. You will see your sudoers file in a text editor. Here is a screenshot of mine:
    sudo to PHP
  3. Now we are going to add the permission for www-data (Apache user) to our sudoers file. We don’t want to prompt for a password, so we add NOPASSWD. Add the following text under the #User privilege specification section:
  4. Your sudoers should now look something like this:
    sudo2
  5. You can get very specific in your sudoers permissions by only allowing specific commands to be executed. This is a very secure method of ensuring nothing malicious gets executed:

    Note that this is not file-specific, so any file executable by www-data will be able to run this command. This would be useful if you are controlling your GPIO pins in multiple scripts, but you could do this easier using a function() to call this command.
  6. Close and save the file. How to do this will depend on the editor. I am running debian, so nano was the editor used. Press ctrl+x followed by “y” to save the file. If you are using vi, hit esc and then type “:x”.

We’ll cover how to do the actual control in a later post.



OLDER POSTS