C# i .NET Nowość

Biblioteka C# Modbus TCP i RTU dla .NET

Odczytuj i zapisuj dane sterowników PLC, napędów i liczników z poziomu C# albo udostępniaj własne dane jako urządzenie podrzędne Modbus, przez Ethernet lub RS-485.

Modbus TCP i Modbus RTU
Klient i serwer
Float32, Int32 i ciągi znaków w dowolnej kolejności słów
Wywołania blokujące bezpieczne wątkowo

W pakiecie sgcWebSockets Enterprise (Delphi i .NET) oraz All-Access, a także w samodzielnym pakiecie sgcIndustrial.

Odczyt i zapis urządzenia w C# → · FAQ o Modbus →

Klient C# Modbus TCP
using esegece.sgcWebSockets;

var modbus = new TsgcModbusTCPClient();
modbus.Host = "192.168.1.50";
modbus.Port = 502;
modbus.Active = true;

ushort[] registers = modbus.ReadHoldingRegisters(0, 10);  // FC 03
float temperature = modbus.ReadFloat32(200);               // 2 registers
modbus.WriteSingleCoil(5, true);                           // FC 05

Klienty i serwery Modbus dla .NET

Cztery komponenty, jedno API dla TCP i RTU, bezpieczny wątkowo model danych za serwerami.

Biblioteka C# Modbus w sgcWebSockets .NET znajduje się w pakiecie esegece.sgcIndustrial, w przestrzeni nazw esegece.sgcWebSockets. TsgcModbusTCPClient i TsgcModbusRTUClient to urządzenia nadrzędne Modbus, które odpytują urządzenia; TsgcModbusTCPServer i TsgcModbusRTUServer to urządzenia podrzędne Modbus, które odpowiadają systemom SCADA, panelom HMI i innym urządzeniom nadrzędnym na podstawie TsgcModbusDataModel. Linią szeregową jest TsgcSerialPort z tego samego pakietu, zbudowany na System.IO.Ports.

Oba klienty współdzielą TsgcModbusClient_Base, więc metoda, która odczytuje rejestr przez Ethernet, odczyta go także przez RS-485. Każde wywołanie blokuje do nadejścia odpowiedzi lub upływu Timeout, zwraca zwykłe tablice .NET (ushort[] dla rejestrów, bool[] dla cewek) i zgłasza typowany wyjątek, gdy urządzenie raportuje błąd. Pakiet obsługuje .NET 8, .NET 9, .NET 10 i .NET Standard 2.0.

Kody funkcji

01 do 08, 15, 16, 22, 23 i 43/14, po jednej metodzie na każdy.

Wartości typowane

ReadFloat32, ReadInt32, ReadUInt32, ReadString i ich odpowiedniki zapisu, z WordOrder dla czterech układów rejestrów.

Modbus TCP

Domyślnie port 502, z opcjonalnym TLS, serwerem proxy HTTP lub SOCKS i automatycznym ponownym łączeniem.

Modbus RTU

RS-232 i RS-485 z ramkowaniem 3,5 znaku, kontrolą CRC i zapisami rozgłoszeniowymi.

Modbus w C#, krok po kroku

Dodaj odwołanie do pakietu esegece.sgcIndustrial, a następnie wybierz transport. Każdy przykład na tej stronie kompiluje się w .NET 8.

using esegece.sgcWebSockets;

var modbus = new TsgcModbusTCPClient();
modbus.Host = "192.168.1.50";
modbus.Port = 502;
modbus.UnitId = 1;
modbus.Timeout = 2000;            // ms per attempt
modbus.Retries = 2;               // extra attempts after a timeout
modbus.WatchDog.Enabled = true;   // reconnect after a network drop
modbus.OnError += (sender, error) => Console.WriteLine("#error: " + error);
modbus.Active = true;

ushort[] registers = modbus.ReadHoldingRegisters(0, 10);       // FC 03
bool[] coils = modbus.ReadCoils(0, 8);                         // FC 01
Console.WriteLine("HR0 = " + registers[0] + ", coil 0 = " + coils[0]);

modbus.WriteSingleRegister(100, 1234);                         // FC 06
modbus.WriteMultipleRegisters(110, new ushort[] { 1, 2, 3 });  // FC 16
modbus.WriteSingleCoil(5, true);                               // FC 05
modbus.WordOrder = TsgcModbusWordOrder.mwoCDAB;   // low word first
float temperature = modbus.ReadFloat32(200);       // 2 holding registers
int counter = modbus.ReadInt32(202);
string name = modbus.ReadString(300, 8);           // 8 registers, 16 characters
Console.WriteLine($"{name}: {temperature:F1} C, {counter} cycles");

modbus.WriteFloat32(210, 21.5f);
modbus.WriteUInt32(212, 3000000000);

// explicit unit id, for a gateway with several devices behind it
float flow = modbus.ReadInputFloat32(7, 0);        // unit 7, FC 04
Console.WriteLine("flow = " + flow);

try
{
    modbus.ReadHoldingRegisters(9000, 4);
}
catch (EsgcModbusException e)   // the device answered with an exception
{
    Console.WriteLine($"exception {e.ExceptionCode}, function {e.FunctionCode}");
}
catch (EsgcModbusTimeout e)     // no answer after Retries + 1 attempts
{
    Console.WriteLine(e.Message);
}
using esegece.sgcWebSockets;

var port = new TsgcSerialPort();
port.Port = "COM3";                              // "/dev/ttyUSB0" on Linux
port.BaudRate = 19200;
port.Parity = TsgcSerialParity.spEven;           // 8E1, the Modbus RTU default
port.Open();

var rtu = new TsgcModbusRTUClient();
rtu.SerialPort = port;
rtu.UnitId = 17;                                 // slave address
rtu.Timeout = 500;
rtu.Retries = 1;

ushort[] values = rtu.ReadInputRegisters(0, 4);  // FC 04
byte status = rtu.ReadExceptionStatus();         // FC 07
Console.WriteLine($"IR0 = {values[0]}, status = {status}");

rtu.WriteSingleRegister(0, 10, 500);             // unit 0: broadcast, no reply
using esegece.sgcWebSockets;

var server = new TsgcModbusTCPServer();
server.Port = 502;
server.UnitId = 0;                                  // answer every unit id
server.DataModel.HoldingRegisterCount = 1000;
server.DataModel.SetHoldingRegister(0, 42);
server.DataModel.SetCoil(0, true);
server.DataModel.VendorName = "My Company";         // FC 43/14 identification
server.DataModel.ProductCode = "GW-100";

var random = new Random();

// runs on the connection thread, before the table is read
server.OnReadRequest += (object sender, byte unitId, byte functionCode,
    ushort address, ushort count, ref byte exceptionCode) =>
{
    if (functionCode == sgcModbus_Classes.CS_MODBUS_FC_READ_INPUT_REGISTERS)
        server.DataModel.SetInputRegister(0, (ushort)random.Next(1000));
};

// registers 0..9 are read only
server.OnWriteRequest += (object sender, byte unitId, byte functionCode,
    ushort address, ushort count, ref bool[] bits, ref ushort[] registers,
    ref byte exceptionCode) =>
{
    if (registers.Length > 0 && address < 10)
        exceptionCode = sgcModbus_Classes.CS_MODBUS_EX_ILLEGAL_DATA_ADDRESS;
};

server.Active = true;
Console.ReadLine();

Wywołania są synchroniczne. W aplikacji WinForms, WPF lub ASP.NET uruchom pętlę odpytywania w wątku roboczym albo wewnątrz Task.Run; klient jest bezpieczny wątkowo, więc kilka zadań może współdzielić jedno połączenie.

Obsługiwane kody funkcji Modbus

Klient sprawdza ilości ze specyfikacją, zanim cokolwiek wyśle; serwery odpowiadają na każdy kod z tej tabeli.

FCFunkcjaMetoda C#
01Read CoilsReadCoils
02Read Discrete InputsReadDiscreteInputs
03Read Holding RegistersReadHoldingRegisters, ReadInt32, ReadUInt32, ReadFloat32, ReadString
04Read Input RegistersReadInputRegisters, ReadInputInt32, ReadInputUInt32, ReadInputFloat32
05Write Single CoilWriteSingleCoil
06Write Single RegisterWriteSingleRegister
07Read Exception Status (łącze szeregowe)ReadExceptionStatus w kliencie RTU
08Diagnostics (łącze szeregowe)Diagnostics w kliencie RTU
15Write Multiple CoilsWriteMultipleCoils
16Write Multiple RegistersWriteMultipleRegisters, WriteInt32, WriteUInt32, WriteFloat32, WriteString
22Mask Write RegisterMaskWriteRegister
23Read/Write Multiple RegistersReadWriteMultipleRegisters
43/14Read Device IdentificationReadDeviceIdentification z TsgcModbusDeviceIdCode: basic, regular, extended lub specific

Urządzenie nadrzędne Modbus zbudowane do pracy produkcyjnej

Kolejność słów

TsgcModbusWordOrder.mwoABCD to big endian, domyślny w Modbus. mwoCDAB umieszcza słowo niższe jako pierwsze, mwoBADC zamienia bajty w każdym rejestrze, a mwoDCBA to w pełni little endian. Ciągi znaków upakowują dwa znaki w jednym rejestrze.

Bezpieczny wątkowo

Na klienta wykonywana jest jedna transakcja naraz, pod blokadą obejmującą wszystkie jej ponowienia. W TCP odpowiedź jest dopasowywana przez wątek odbiorczy i przekazywana czekającemu wywołaniu, więc wywołanie z wątku interfejsu użytkownika nie może spowodować zakleszczenia.

Limity czasu i ponowienia

Timeout to czas oczekiwania na jedną próbę, a Retries to liczba dodatkowych prób. Ponowienie TCP używa nowego identyfikatora transakcji, a nieaktualne lub zduplikowane odpowiedzi są odrzucane.

Typowane wyjątki

EsgcModbusException zawiera ExceptionCode i FunctionCode, EsgcModbusTimeout zgłasza brak odpowiedzi, a EsgcModbusError obejmuje zamknięte połączenia, problemy z portem i błędy CRC w RTU.

Bramki i identyfikatory jednostek

Każda metoda ma przeciążenie z wiodącym parametrem byte aUnitId, więc jedno połączenie TCP z bramą pozwala dotrzeć do każdego urządzenia za nią.

TLS, proxy i ponowne połączenie

TLS, TLSOptions, Proxy i WatchDog są przekazywane do klienta TCP sgcWebSockets pod spodem, więc Modbus TCP dostaje ten sam stos TLS, obsługę serwera proxy i automatyczne ponowne łączenie co reszta biblioteki.

Ramkowanie RTU

Klient RTU czeka na ciszę równą 3,5 znaku przed wysłaniem, odczytuje odpowiedź według oczekiwanej długości, sprawdza sumę CRC każdej ramki i ignoruje ramki z innych adresów urządzeń podrzędnych. Identyfikator jednostki 0 wysyła zapis rozgłoszeniowy i zamiast odpowiedzi czeka TurnaroundDelay.

Kierunek RS-485

Przy RtsControl = TsgcSerialRtsControl.srcToggle port szeregowy podnosi RTS przy każdym zapisie i opuszcza go, gdy bufor wyjściowy się opróżni. W .NET jest to odmierzane programowo, więc przy ścisłych wymaganiach czasowych magistrali wybierz adapter z automatycznym sterowaniem kierunkiem.

Zdarzenia

OnConnect, OnDisconnect i OnError są wywoływane za pośrednictwem NotifyEvents, w kolejności, w jakiej wystąpiły. Nieudane połączenie nie zgłasza wyjątku: wywołuje OnError, a Active pozostaje false.

Serwery Modbus TCP i RTU w C#

Zbuduj bramę, która udostępnia wartości z bazy danych lub chmury systemowi SCADA, symulator do testowania ekranów HMI bez sprzętu albo interfejs Modbus własnego urządzenia. Każdy serwer ma własny TsgcModbusDataModel z czterema tabelami (cewki, wejścia dyskretne, rejestry holding i rejestry wejściowe, domyślnie po 10 000 wpisów, do 65 536), ciągami identyfikacyjnymi dla FC 43/14 i statusem wyjątku dla FC 07. Każdy element modelu danych jest bezpieczny wątkowo.

OnReadRequest jest wywoływane przed odczytem tabeli, więc może odświeżyć wartości lub odpowiedzieć kodem wyjątku. OnWriteRequest otrzymuje wartości przed ich zapisaniem i może je zmienić albo odrzucić zapis, pozostawiając tabele bez zmian. Oba działają w wątku serwera obsługującym żądanie (połączenie TCP lub czytnik ramek RTU), bez założonej blokady.

TsgcModbusTCPServer

Wiele równoczesnych połączeń, żądania obsługiwane w kolejności nadejścia, rozdzielone żądania składane z powrotem i błędne nagłówki zamykające połączenie przez OnError. UnitId = 0 odpowiada na dowolny identyfikator jednostki. Bindings wybierają punkty końcowe, Port = 0 wybiera wolny port, a OnClientConnect i OnClientDisconnect raportują klientów.

TsgcModbusRTUServer

Odpowiada jako urządzenie podrzędne UnitId (1 do 247) na TsgcSerialPort, ramkuje żądania według długości i ciszy równej 3,5 znaku, ignoruje błędne sumy CRC i inne adresy oraz wykonuje zapisy rozgłoszeniowe bez odpowiadania.

Przetestowane w obu kierunkach

Klient i serwer .NET przechodzą te same testy interoperacyjności z pymodbus przez TCP oraz z komponentami Modbus sgcWebSockets dla Delphi, 35 z 35 w każdym kierunku.

Część sgcWebSockets Enterprise

Komponenty Modbus i portu szeregowego Są zawarte w sgcWebSockets Enterprise (Delphi i .NET) oraz All-Access, jako pakiet esegece.sgcIndustrial obok pozostałych pakietów sgcWebSockets .NET. Porównaj edycje na stronie z cennikiem (zakładka .NET) lub w macierzy funkcji .NET.

Pytania o C# Modbus

Utwórz TsgcModbusTCPClient, ustaw Host, Port i UnitId, ustaw Active = true i wywołaj ReadHoldingRegisters(address, count). Zwraca ushort[] z jedną wartością na rejestr. Adresy liczone są od zera, tak jak przesyła się je w sieci.

Wywołaj ReadFloat32(address) dla rejestrów holding lub ReadInputFloat32(address) dla rejestrów wejściowych. Jeśli liczba wygląda źle, urządzenie przechowuje oba rejestry w innej kolejności: ustaw WordOrder na mwoCDAB, mwoBADC lub mwoDCBA.

Tak. Otwórz TsgcSerialPort na adapterze RS-485 i przypisz go do TsgcModbusRTUClient.SerialPort lub TsgcModbusRTUServer.SerialPort. Użyj adaptera z automatycznym sterowaniem kierunkiem albo ustaw RtsControl na srcToggle dla adapterów przełączanych przez RTS.

Tak. Utwórz TsgcModbusTCPServer, wypełnij DataModel za pomocą SetHoldingRegister, SetCoil i pozostałych setterów, a następnie ustaw Active = true. Obsłuż OnReadRequest i OnWriteRequest, aby wyliczać wartości na żądanie lub odrzucać zapisy kodem wyjątku Modbus.

Nie, metody klienta są synchroniczne i bezpieczne wątkowo. Wywołuj je z wątku roboczego albo opakuj w Task.Run; kilka wątków lub zadań może współdzielić jednego klienta, a każde wywołanie czeka na własną odpowiedź.

Pakiet esegece.sgcIndustrial obsługuje .NET 8, .NET 9, .NET 10 i .NET Standard 2.0. Port szeregowy używa System.IO.Ports, więc Modbus RTU wymaga platformy, na której ten pakiet może otwierać porty szeregowe.

Komponenty Modbus i portu szeregowego są zawarte w sgcWebSockets Enterprise (Delphi i .NET) oraz All-Access, a także w samodzielnym pakiecie sgcIndustrial.

Więcej o sgcWebSockets .NET

Komponenty przemysłowe

Port szeregowy, Modbus i OPC UA, z pełną dokumentacją komponentów.

Klient C# OPC UA

Odczytuj, zapisuj i subskrybuj serwery OPC UA z tej samej aplikacji .NET, obok urządzeń Modbus.

Klient MQTT dla C#

Publikuj odczyty Modbus do brokera MQTT z tej samej aplikacji.

Biblioteka WebSocket dla C#

Klient i serwer WebSocket dla pulpitów pokazujących dane urządzeń na żywo.

Także dla Delphi i C++Builder

Te same komponenty Modbus, z tymi samymi nazwami klas i metod, dla Delphi 7 do Delphi 13.

Najkorzystniejsza oferta: All-AccessWszystkie produkty eSeGeCe, ze wsparciem Premium w cenie, już od €1,059 rocznie.
Zobacz cennik All-Access

Odczytaj pierwszy rejestr Modbus z C#

W pakiecie sgcWebSockets Enterprise (Delphi i .NET) oraz All-Access, a także w samodzielnym pakiecie sgcIndustrial.