DEV Community

Ferhat ACAR
Ferhat ACAR

Posted on

Connecting Factory Machines to Your Code: A Simple Guide to S7-1500 and C# with S7.NET

#csharp #dotnet #plc #s7net

Introduction: Why Developers Need Factory Data

The world is changing! Factory machines (like PLCs) and computer programs (like C# apps) need to talk to each other. We call this connecting the OT (Operational Technology, the machines) World to the IT (Information Technology, the computers) World.

If you are a programmer and you want to get real-time numbers or status updates from a Siemens S7-1500 machine, this guide is for you. We will use a helpful tool called the S7.NET library to easily make this connection.

Let’s start building this bridge, step by step!

1. Things You Need (Prerequisites)

Before starting, make sure you have these tools ready:

1.1. On the Machine (PLC) Side
● Siemens S7-1500 PLC: The actual physical machine or a simulation program.
● TIA Portal: The software Siemens uses to program and configure the PLC.
● Network Cable: Your computer and the PLC must be connected on the same network (like a local office network).

1.2. On the Computer (Software) Side
● Visual Studio: The program we use to write C# code.
● A C# Project: A new project like a simple Console Application.
● S7.NET Library: This is the key tool.

How to Install S7.NET: In Visual Studio, open the "NuGet Package Manager." Search for S7.NET and add it to your project. It's like adding a new feature to your C# toolbox!

2. Step 1: Making the PLC Ready (The Most Important Part!)

Because the S7-1500 is very secure, it won't talk to our C# program until we give it permission in the TIA Portal.

2.1. Granting Access (PUT/GET)

  1. Open your project in TIA Portal and click on your PLC's settings ("Device Configuration").
  2. Look for the "Protection & Security" settings section.
  3. Under "Connection mechanisms," you must check this important box:☑ Permit access with PUT/GET communication from remote partner (This allows our C# code to "get" data from the PLC).
  4. Save your changes and load the settings onto your PLC.

2.2. Setting Up the Test Data (DB)
We need a place in the PLC memory to read from. We will use a "Data Block" (DB).

  1. Create a simple Data Block (DB1) in TIA Portal.
  2. Inside DB1, create a variable called TestValue and set its type to "Int" (Integer, a whole number). This is at address DB1.DBW0.
  3. Final Check: Right-click the DB and ensure "Optimized block access" is UNCHECKED. If it's checked, the C# library won't work easily!

3. Step 2: Writing the C# Code to Connect and Read

The PLC is ready, and our C# project has the S7.NET library. Let’s connect!

3.1. What the PLC Object Needs
We create a Plc object. It needs to know three things about your machine:

Setting Standard Value (S7-1500)    What to Change
CpuType CpuType.S71500  Stays the same for S7-1500.
IP Address  "192.168.0.1"   IMPORTANT: Change this to your PLC's real IP address!
Rack / Slot 0 / 1   Usually stays 0 and 1 for the S7-1500.
Enter fullscreen mode Exit fullscreen mode

3.2. The Connection and Reading Code
This C# code tries to connect, reads the TestValue from DB1.DBW0, and closes the connection safely.

using S7.Net;
using System;


public class PlcConnector
{
    public static void ReadFactoryData()
    {
        // 1. Set up the connection details (change IP address!)
        Plc plc = new Plc(CpuType.S71500, "192.168.0.1", 0, 1);

        try
        {
            // 2. Try to connect
            Console.WriteLine("Trying to talk to the PLC...");
            plc.Open();

            if (plc.IsConnected)
            {
                Console.ForegroundColor = ConsoleColor.Green;
                Console.WriteLine("SUCCESS! We are connected.");
                Console.ResetColor();

                // 3. Read the Integer value from address DB1.DBW0
                // DBW stands for Data Block Word (which is an INT/short in C#)
                var readResult = plc.Read("DB1.DBW0");

                if (readResult != null)
                {
                    // Convert the result into a simple number (Int16)
                    Int16 value = Convert.ToInt16(readResult); 
                    Console.WriteLine($"\n--- Data Read Complete ---");
                    Console.WriteLine($"Address in PLC: DB1.DBW0");
                    Console.WriteLine($"Value: {value}");
                    Console.WriteLine("--------------------------");
                }
                else
                {
                    Console.WriteLine("\nERROR: Could not read the data. Is the address 'DB1.DBW0' correct?");
                }
            }
            else
            {
                Console.ForegroundColor = ConsoleColor.Red;
                Console.WriteLine($"\nFAILED! Check your IP address or PLC settings.");
                Console.WriteLine("REMINDER: Did you check the 'PUT/GET' box in TIA Portal?");
                Console.ResetColor();
            }
        }
        catch (Exception ex)
        {
            Console.WriteLine($"\nBIG PROBLEM: Something went wrong: {ex.Message}");
        }
        finally
        {
            // 4. Always disconnect when finished!
            if (plc.IsConnected)
            {
                plc.Close();
                Console.WriteLine("\nDisconnected from PLC.");
            }
        }
    }
}
Enter fullscreen mode Exit fullscreen mode

3.3. Key Points to Remember

● Open and Close: You must call plc.Open() to start talking and plc.Close() to stop.
● Addressing: The address string ("DB1.DBW0") tells the library exactly where to look in the PLC's memory.
● Troubleshooting: If you see an error, the first thing to check is the PUT/GET setting in TIA Portal!

Conclusion: What’s Our Next Step?
You have successfully connected C# to a physical machine! This is a huge achievement.

However, reading just one piece of data is often not enough. What if you need to read 100 different values (motor speed, temperature, pressure)? Reading them one by one is very slow.

Top comments (0)