In this Project we will establish a Websocket connection between multiple ESP8266 and a local Node.JS server. The Node.JS server will be running on a PC, laptop or a on Raspberry Pi, while we use C/C++ code on the Arduino IDE for the ESP8266. Multiple clients (browser, ESP8266) can connect to this Node.Js Websocket server at the same time.

Each ESP8266 will read random ADC values and send these every 300 ms to the Node.Js server that will print them on the console and broadcast them to all other connected clients (similar to a group chat). The sender ESP8266 from which the particular ADC reading originates, will receive an edited message, which can be printed in a serial monitor.

About Websockets

The WebSocket protocol is an extension to the HTTP protocol, and allows to create real-time connections between web servers and a clients. Here, a client can be a web browser, smartphone app or, like in this project, an ESP8266.

While the HTTP protocol allows servers to send data only upon a client request, Websockets allow bi-directional communication between server and client. It enables web applications to efficiently exchange data in real-time without the overhead of conventional HTTP connections. Node.js is perfectly suited for writing WebSocket applications, and this tutorial explains how it all works.


The Overall Architecure

The websocket server is running on a laptop or a Raspberry Pi which is connected to a local network via a Wifi router. Also, the ESP8266 is connected to the same network via the Wifi router. It continously receives sensor data through its GPIO and sends it as a data stream to the Websocket server. By connecting to the Websocket server's IP address via browser, we are able to see a live stream of incoming sensor data sent from the ESP8266.

Similar to a chat server, our Websocket server will be a central server that will receive all massages, process them and send them to the other clients. In this example we have one single Websocket server, which the ESP8266 and our smartphone web browser is connected to.

The communication is bi-directional. So, the client not only receives messages. But rather we can also send a message from the client to the ESP8266, telling it to stop or start sending data, for example.

websocket architecture

Image: Architecture for Websocket communication between ESP8266, NodeJs Server and a web browser running on a PC or smartphone

In a more advanced project there can be two Websockets servers (channels)- one for the front end communication between multiple clients (web browser, smartphone app) and server. And another Websocket server for the back end communication between multiple ESP8266's and the server.
By doing so, we could achieve a clean separation between, the micro-controller side and the web browser (client) side.

This could be useful when having many clients and sensors connected to the same server. With two separate channels, the Node.JS server application decides which commands are forwarded from the client channel to the ESP8266 channel and vice versa.


Materials Needed

For the sake of simplicity, this project is demonstrated in its most basic form in such that features and materials are kept at a minimum.  Following materials are needed for this project:

  1. Raspberry Pi with Node.Js installed and Wifi capability
  2. NodeMCU ESP8266
  3. Wifi router
  4. Smartphone or PC with Web Browser and Wifi capability


Server-Side Code (Node.Js)

On the server-side (Raspberry Pi) install the latest version of Node of Node.Js (as of now: 10.8.0) with following command in the console.

$ curl -sL | sudo -E bash - 

sudo apt install -y nodejs

Continue with installing required components such as the Websocket package by following NPM commands.

npm install express
npm install body-parser
npm install --save ws

After that, copy and paste the code below into a text editor and save it as "websocket_example.js".


var bodyParser = require("body-parser");
const express = require('express'); //express framework to have a higher level of methods
const app = express(); //assign app variable the express class/method
var http = require('http');
var path = require("path");
app.use(bodyParser.urlencoded({ extended: false }));
const server = http.createServer(app);//create a server

//***************this snippet gets the local ip of the node.js server. copy this ip to the client side code and add ':3000' *****
//****************exmpl.> var sock =new WebSocket("ws://");*************************************
require('dns').lookup(require('os').hostname(), function (err, add, fam) {
  console.log('addr: '+add);

/**********************websocket setup**************************************************************************************/
//var expressWs = require('express-ws')(app,server);
const WebSocket = require('ws');
const s = new WebSocket.Server({ server });

//when browser sends get request, send html file to browser
// viewed at http://localhost:30000
app.get('/', function(req, res) {
res.sendFile(path.join(__dirname + '/index.html'));

//***************************ws chat server********************************************************************************

//'/echo', function(ws, req) {

/******* when server receives messsage from client trigger function with argument message *****/
console.log("Received: "+message);
s.clients.forEach(function(client){ //broadcast incoming message to all clients (s.clients)
if(client!=ws && client.readyState ){ //except to the same client (ws) that sent this message
client.send("broadcast: " +message);
// ws.send("From Server only to sender: "+ message); //send to client where message is from
ws.on('close', function(){
console.log("lost one client");
//ws.send("new client connected");
console.log("new client connected");



ESP8266 Code

Include the Websocket library for the ESP8266 from here in your Arduino IDE. To do so, follow the link, click on "clone or download" -> download .ZIP-file. Then include the library in your Arduino IDE under: Sketch->Include Library->Add .ZIP library.

Now upload the code below to your ESP8266 device. Edit the "ssid" and "password" variable values according to your own router settings. Furthermore edit the "host" variable according to the ip address of your raspberry Pi in your wifi network.

Once the code is running, the Esp8266 will connect to your wifi router and try to establish a websocket connection to your Node.js server running on your Raspberry Pi. If connection can be established, the ESP8266 will send random ADC readings to the Websocket server in 300ms intervals. You can change the interval by changing the value for this variable in the code.



#include <ESP8266WiFi.h>
#include <WebSocketClient.h>

boolean handshakeFailed=0;
String data= "";

char path[] = "/";   //identifier of this device

const char* ssid     = "enter your wifi ssid here";
const char* password = "enter your wifi password here";
char* host = "";  //replace this ip address with the ip address of your Node.Js server
const int espport= 3000;
WebSocketClient webSocketClient;
unsigned long previousMillis = 0;
unsigned long currentMillis;
unsigned long interval=300; //interval for sending data to the websocket server in ms

// Use WiFiClient class to create TCP connections
WiFiClient client;

void setup() {
    pinMode(readPin, INPUT);     // Initialize the LED_BUILTIN pin as an output


  // We start by connecting to a WiFi network

  Serial.print("Connecting to ");
  WiFi.begin(ssid, password);
  while (WiFi.status() != WL_CONNECTED) {

  Serial.println("WiFi connected");  
  Serial.println("IP address: ");

//  wifi_set_sleep_type(LIGHT_SLEEP_T);

void loop() {

  if (client.connected()) {
    if (data.length() > 0) {

    //*************send log data to server in certain interval************************************
 if (abs(currentMillis - previousMillis) >= interval) {
previousMillis = currentMillis;
data= (String) analogRead(A0); //read adc values, this will give random value, since no sensor is connected. 
//For this project we are pretending that these random values are sensor values

webSocketClient.sendData(data);//send sensor data to websocket server


//***************function definitions**********************************************************************************
void wsconnect(){
  // Connect to the websocket server
  if (client.connect(host, espport)) {
  } else {
    Serial.println("Connection failed.");

  // Handshake with the server
  webSocketClient.path = path; = host;
  if (webSocketClient.handshake(client)) {
    Serial.println("Handshake successful");
  } else {
    Serial.println("Handshake failed.");


Client-Side Code for Web Browser (HTML,CSS,Javascript)

Open your text editor and copy&paste the code below into your editor. Save the file as "index.html" and move it to the same folder that contains your Node.Js application on your Raspberry Pi. As soon as you run your node.js server code, it will output it's network ip in the console. Copy this ip and replace the websocket server address below.

Example: If IP address is, change the relevant line below to: var sock =new WebSocket("ws://");


<html lang="en">
  <meta charset="utf-8"/>



<input style="width: 800px;height: 200px" type="text" placeholder="enter text here to send to server" id="eingabe" onkeypress="myFunction(event)"/>

<button onclick="clearlog()">Clear Logs</button>

<div style="overflow:scroll; width: 800px; height: 550px; border: solid; border-radius: 9px" id="display"></div>

  //var sock =new WebSocket("ws://localhost:5001");
  var sock =new WebSocket("ws://");  //replace this address with the one the node.js server prints out. keep port 3000
  var display=document.getElementById("display")
  //alert("Socket connected succesfully!!!")
  setTimeout(function(){sock.send('connection succeeded');},1000);
  display.innerHTML+="connection succeeded <br />";

  console.log(event);//show received from server data in console of browser"<br />"; //add incoming message from server to the log screen previous string + new string(message)

function myFunction(event) {
if(event.keyCode==13){	   //when enter is pressed...
  var text=document.getElementById('eingabe').value;    //assign value of the entered string to te text variable
  if(text!=""){     //if text is not an empty string
  //display.innerHTML+="From Client: "+text+"<br />"; //show the message from client in div
sock.send(text);    //send string to server
display.innerHTML+="<strong>Me: </strong>" + text+"<br />";       //display input text in div (client side)
document.getElementById('eingabe').value="";     //and clear the input field
console.log("empty string not sent")

function clearlog(){


Test the Setup

Now that the code for the ESP8266 is uploaded and the server-side code is ready, we can run the Node.Js server by navigating the console to the folder that contains the node.js application "websocket_example.js". We start it by entering following command in the console.

 node websocket_example.js

You will see several status logs in the console. As soon as the ESP8266 is connected to a power source, it will try to establish a websocket connection with the node.js server and send its sensor data feed.

Now we can use our smartphone or PC browser and enter the ip address of the raspberry pi followed by the port number 3000 (e.g. The browser will load the .html file that we edited earlier. If everything is set up correctly, you will be able to see the sensor data feed from the ESP8266.


In this project we learned how to create a Websocket server that receives sensor data from an ESP8266 in real-time and forwards it to a Web browser (multiple connected Web browsers are also possible).

We used C-Code for the ESP8266, Javascript on the Node.js server-side code and HTML,CSS & Javascript for the client frontent. This is a very basic example to demonstrate the fundamentals of IOT. Further improvements and additional features of this project can be:


  • Running the server on a public server or forwarding the local nodejs server to the world wide web, so that it can be accessed from outside
  • SSL encryption
  • Authentication with login name and password
  • logging sensor data in a database and display data in charts to the front end user
  • a dashboard from where user can send commands to the ESP8266 ( e.g. "Turn off lights")
  • multiple Websocket channels to seperate client (front end) side from ESP8266 device side
  • Webcam stream to the front end
  • sleep modes of the ESP8266 to reduce power consumption
  • multiple ESP8266 that can be addressed seperately

This list can be continued arbitrarily. However, adding functionalities will add complexity of the whole system, such that a well structured architecture and plan becomes necessary.