Create a Modbus TCP/IP Server with NodeMCU ESP8266

If you're looking to integrate Modbus communication into your IoT project, you're in the right place. In this tutorial, we'll walk through the process of setting up a Modbus server using a NodeMCU ESP8266 microcontroller. Modbus is a widely used communication protocol in industrial automation and offers a straightforward way to exchange data between devices. By the end of this guide, you'll have a fully functional Modbus server running on your NodeMCU ESP8266, ready to communicate with Modbus clients.

Prerequisites

Before we begin, make sure you have the following:

• NodeMCU ESP8266 board

• Arduino IDE installed on your computer

• Basic knowledge of C++ programming

• Access to a Wi-Fi network for connecting the NodeMCU

Setting Up Your Environment

First, let's set up our development environment by installing the necessary libraries and configuring the Arduino IDE.

• Open the Arduino IDE and navigate to Sketch > Include Library > Manage Libraries.

Search for and install the following libraries:

• ESP8266WiFi (for Wi-Fi connectivity)

• ModbusIP_ESP8266 (for Modbus server implementation)

• Once the libraries are installed, we're ready to move on to the coding part.

Writing the Code

Copy and paste the following code into your Arduino IDE:

#include <ESP8266WiFi.h>
#include <ModbusIP_ESP8266.h>

const char* ssid = "YourWiFiSSID";      // Replace with your Wi-Fi SSID
const char* password = "YourWiFiPassword";  // Replace with your Wi-Fi password

ModbusIP mb;

void setup() {
  Serial.begin(115200);

  // Set fixed IP address, subnet mask, and gateway
  IPAddress ip(192, 168, 1, 4);
  IPAddress subnet(255, 255, 255, 0);
  IPAddress gateway(192, 168, 1, 1);

  // Connect to WiFi with fixed IP configuration
  WiFi.config(ip, gateway, subnet);
  WiFi.begin(ssid, password);
  
  while (WiFi.status() != WL_CONNECTED) {
    delay(1000);
    Serial.println("Connecting to WiFi...");
  }
  
  // Print assigned IP address
  Serial.println("Connected to WiFi");
  Serial.print("IP Address: ");
  Serial.println(WiFi.localIP());

  // Initialize Modbus server
  mb.server(4444);
  
  // Add 20 holding registers
  for (int i = 0; i < 20; i++) {
    mb.addHreg(i, 0); // Initialize all holding registers to zero
  }
}

void loop() {
  // Handle Modbus communication
  mb.task();
  delay(100); // Adjust delay as needed depending on your application requirements
}

Understanding the Code

Let's break down what each part of the code does:

• We include the necessary libraries for Wi-Fi connectivity and Modbus server implementation.
• Replace "``YourWiFiSSID``" and "``YourWiFiPassword``" with your Wi-Fi credentials.
• In the setup() function, we configure the Wi-Fi connection and set a fixed IP address for the NodeMCU.
• The Modbus server is initialized on port 4444, and 20 holding registers are added, initialized to zero.
• In the loop() function, we handle Modbus communication by calling the mb.task() function.

Uploading the Code

Connect your NodeMCU ESP8266 board to your computer via USB and select the correct board and port in the Arduino IDE. Then, click the upload button to compile and upload the code to your board.

Testing

Once the code is uploaded successfully, open the serial monitor in the Arduino IDE. You should see messages indicating the NodeMCU connecting to your Wi-Fi network and displaying the assigned IP address.

Now, your Modbus server is up and running, ready to communicate with Modbus clients.

Conclusion

In this tutorial, we've covered the process of creating a Modbus server using a NodeMCU ESP8266 board. You can now integrate this server into your IoT projects to exchange data with Modbus clients efficiently. Experiment with different configurations and functionalities to suit your specific requirements. Happy coding!

Code

sketch

#include <ESP8266WiFi.h>
#include <ModbusIP_ESP8266.h>

const char* ssid = "YourWiFiSSID";      // Replace with your Wi-Fi SSID
const char* password = "YourWiFiPassword";  // Replace with your Wi-Fi password

ModbusIP mb;

void setup() {
  Serial.begin(115200);

  // Set fixed IP address, subnet mask, and gateway
  IPAddress ip(192, 168, 1, 4);
  IPAddress subnet(255, 255, 255, 0);
  IPAddress gateway(192, 168, 1, 1);

  // Connect to WiFi with fixed IP configuration
  WiFi.config(ip, gateway, subnet);
  WiFi.begin(ssid, password);
  
  while (WiFi.status() != WL_CONNECTED) {
    delay(1000);
    Serial.println("Connecting to WiFi...");
  }
  
  // Print assigned IP address
  Serial.println("Connected to WiFi");
  Serial.print("IP Address: ");
  Serial.println(WiFi.localIP());

  // Initialize Modbus server
  mb.server(4444);
  
  // Add 20 holding registers
  for (int i = 0; i < 20; i++) {
    mb.addHreg(i, 0); // Initialize all holding registers to zero
  }
}

void loop() {
  // Handle Modbus communication
  mb.task();
  delay(100); // Adjust delay as needed depending on your application requirements
}