C# ve .NET Yeni

.NET için C# Modbus TCP ve RTU Kitaplığı

PLC'leri, sürücüleri ve sayaçları C# ile okuyun ve yazın veya kendi verilerinizi Ethernet ya da RS-485 üzerinden Modbus slave olarak sunun.

Modbus TCP ve Modbus RTU
İstemci ve sunucu
Her sözcük sırasında Float32, Int32 ve dizeler
İş parçacığı güvenli engelleyen çağrılar

sgcWebSockets Enterprise (Delphi ve .NET) ve All-Access ya da bağımsız sgcIndustrial paketi içinde yer alır.

C# ile bir cihazı okuyun ve yazın → · Modbus SSS →

C# Modbus TCP istemcisi
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

.NET için Modbus istemcileri ve sunucuları

Dört bileşen, TCP ve RTU için tek bir API, sunucuların arkasında iş parçacığı güvenli bir veri modeli.

sgcWebSockets .NET içindeki C# Modbus kitaplığı, esegece.sgcIndustrial paketinde, esegece.sgcWebSockets ad alanında bulunur. TsgcModbusTCPClient ve TsgcModbusRTUClient cihazları sorgulayan Modbus master'larıdır; TsgcModbusTCPServer ve TsgcModbusRTUServer ise bir TsgcModbusDataModel üzerinden SCADA sistemlerine, HMI'lara ve diğer master'lara yanıt veren Modbus slave'leridir. Seri hat, aynı paketteki ve System.IO.Ports üzerine kurulu bir TsgcSerialPort bileşenidir.

Her iki istemci de TsgcModbusClient_Base sınıfını paylaşır; dolayısıyla Ethernet üzerinden bir yazmacı okuyan metot onu RS-485 üzerinden de okur. Her çağrı yanıt gelene veya Timeout dolana kadar bekler, düz .NET dizileri döndürür (yazmaçlar için ushort[], coil'ler için bool[]) ve cihaz hata bildirdiğinde türü belirli bir istisna fırlatır. Paket .NET 8, .NET 9, .NET 10 ve .NET Standard 2.0 hedefler.

İşlev kodları

01 ile 08, 15, 16, 22, 23 ve 43/14, her biri için bir metot.

Tipli değerler

ReadFloat32, ReadInt32, ReadUInt32, ReadString ve yazma karşılıkları; dört yazmaç düzeni için WordOrder ile.

Modbus TCP

Varsayılan olarak 502 portu; isteğe bağlı TLS, bir HTTP veya SOCKS proxy ve otomatik yeniden bağlanma ile.

Modbus RTU

3,5 karakter çerçeveleme, CRC denetimleri ve yayın (broadcast) yazmalarıyla RS-232 ve RS-485.

Adım adım C# ile Modbus

esegece.sgcIndustrial paketine başvurun, ardından taşımayı seçin. Bu sayfadaki her örnek .NET 8 ile derlenir.

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();

Çağrılar eşzamanlıdır. Bir WinForms, WPF veya ASP.NET uygulamasında sorgulama döngüsünü bir çalışan iş parçacığında veya Task.Run içinde çalıştırın; istemci iş parçacığı güvenlidir, bu yüzden birkaç görev tek bir bağlantıyı paylaşabilir.

Desteklenen Modbus işlev kodları

İstemci, hiçbir şey gönderilmeden önce miktarları spesifikasyona göre denetler; sunucular bu tablodaki her koda yanıt verir.

FCİşlevC# metodu
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 (seri hat)RTU istemcisinde ReadExceptionStatus
08Diagnostics (seri hat)RTU istemcisinde Diagnostics
15Write Multiple CoilsWriteMultipleCoils
16Write Multiple RegistersWriteMultipleRegisters, WriteInt32, WriteUInt32, WriteFloat32, WriteString
22Mask Write RegisterMaskWriteRegister
23Read/Write Multiple RegistersReadWriteMultipleRegisters
43/14Read Device IdentificationReadDeviceIdentification, TsgcModbusDeviceIdCode ile: basic, regular, extended veya specific

Üretim için geliştirilmiş bir Modbus master

Sözcük sırası

TsgcModbusWordOrder.mwoABCD big endian'dır, yani Modbus varsayılanıdır. mwoCDAB düşük sözcüğü başa koyar, mwoBADC her yazmaçtaki baytları değiştirir ve mwoDCBA tamamen little endian'dır. Dizeler yazmaç başına iki karakter olarak paketlenir.

İş parçacığı güvenli

İstemci başına aynı anda tek bir işlem çalışır; kilit, tüm yeniden denemelerini kapsar. TCP'de yanıt alma iş parçacığı tarafından eşleştirilir ve bekleyen çağrıya iletilir, bu yüzden bir arayüz iş parçacığından yapılan çağrı kilitlenmeye yol açmaz.

Zaman aşımları ve yeniden denemeler

Timeout deneme başına bekleme süresidir, Retries ek deneme sayısıdır. Bir TCP yeniden denemesi yeni bir işlem kimliği kullanır; eski veya yinelenen yanıtlar atılır.

Tipli istisnalar

EsgcModbusException, ExceptionCode ve FunctionCode değerlerini taşır, EsgcModbusTimeout eksik bir yanıtı bildirir ve EsgcModbusError kapalı bağlantıları, port sorunlarını ve RTU CRC hatalarını kapsar.

Ağ geçitleri ve birim kimlikleri

Her metodun başında byte aUnitId alan bir aşırı yüklemesi vardır; böylece bir ağ geçidine açılan tek TCP bağlantısı, arkasındaki her cihaza ulaşır.

TLS, proxy ve yeniden bağlanma

TLS, TLSOptions, Proxy ve WatchDog, alttaki sgcWebSockets TCP istemcisine iletilir; böylece Modbus TCP, kitaplığın geri kalanıyla aynı TLS yığınını, proxy desteğini ve otomatik yeniden bağlanmayı alır.

RTU çerçeveleme

RTU istemcisi göndermeden önce 3,5 karakterlik sessizliği bekler, yanıtı beklenen uzunluğuna göre okur, her çerçevenin CRC'sini denetler ve diğer slave adreslerinden gelen çerçeveleri yok sayar. 0 numaralı birim kimliği bir yayın yazması gönderir ve yanıt yerine TurnaroundDelay süresini bekler.

RS-485 yönü

RtsControl = TsgcSerialRtsControl.srcToggle ile seri port her yazma için RTS'yi yükseltir ve çıkış arabelleği boşaldığında düşürür. .NET'te bu yazılımla zamanlanır, bu yüzden katı veriyolu zamanlaması için otomatik yön denetimli bir adaptör tercih edin.

Olaylar

OnConnect, OnDisconnect ve OnError olayları NotifyEvents üzerinden, gerçekleştikleri sırayla tetiklenir. Başarısız bir bağlantı istisna fırlatmaz: OnError olayını tetikler ve Active false olarak kalır.

C# ile Modbus TCP ve RTU sunucuları

Bir veritabanındaki veya buluttaki değerleri bir SCADA sistemine sunan bir ağ geçidi, donanım olmadan HMI ekranlarını test etmek için bir simülatör veya kendi cihazınızın Modbus arayüzünü oluşturun. Her sunucu, dört tabloya (coil'ler, ayrık girişler, tutma yazmaçları ve giriş yazmaçları; varsayılan olarak her biri 10.000 kayıt, en fazla 65.536), FC 43/14 için tanımlama dizelerine ve FC 07 için istisna durumuna sahip bir TsgcModbusDataModel barındırır. Veri modelinin her üyesi iş parçacığı güvenlidir.

OnReadRequest bir tablo okunmadan önce çalışır, böylece değerleri yenileyebilir veya bir istisna koduyla yanıt verebilir. OnWriteRequest değerleri saklanmadan önce alır ve onları değiştirebilir veya yazmayı reddederek tabloları olduğu gibi bırakabilir. İkisi de isteği işleyen sunucu iş parçacığında (TCP bağlantısı veya RTU çerçeve okuyucusu) hiçbir kilit tutulmadan çalışır.

TsgcModbusTCPServer

Çok sayıda eşzamanlı bağlantı, geliş sırasına göre yanıtlanan istekler, yeniden birleştirilen bölünmüş istekler ve bozuk başlıklarda OnError ile kapatılan bağlantı. UnitId = 0 her birim kimliğine yanıt verir. Bindings uç noktaları seçer, Port = 0 boş bir port seçer ve OnClientConnect ile OnClientDisconnect eşleri bildirir.

TsgcModbusRTUServer

Bir TsgcSerialPort üzerinde slave UnitId (1 ile 247) olarak yanıt verir, istekleri uzunluğa ve 3,5 karakterlik sessizliğe göre çerçeveler, hatalı CRC'leri ve diğer adresleri yok sayar ve yayın yazmalarını yanıt vermeden yürütür.

İki yönde test edildi

.NET istemcisi ve sunucusu, TCP üzerinden pymodbus'a karşı ve sgcWebSockets Delphi Modbus bileşenlerine karşı aynı birlikte çalışabilirlik denetimlerini geçer; her yönde 35 denetimin 35'i.

sgcWebSockets Enterprise'ın bir parçası

Modbus ve seri port bileşenleri Diğer sgcWebSockets .NET paketlerinin yanında esegece.sgcIndustrial paketi olarak sgcWebSockets Enterprise (Delphi ve .NET) ve All-Access içinde yer alırlar. Sürümleri fiyatlandırma sayfasında (.NET sekmesi) veya .NET özellik matrisinde karşılaştırın.

C# Modbus soruları

Bir TsgcModbusTCPClient oluşturun, Host, Port ve UnitId değerlerini ayarlayın, Active = true yapın ve ReadHoldingRegisters(address, count) çağırın. Her yazmaç için bir değer içeren bir ushort[] döndürür. Adresler, kabloda iletildikleri gibi sıfırdan başlar.

Tutma yazmaçları için ReadFloat32(address), giriş yazmaçları için ReadInputFloat32(address) çağırın. Sayı yanlış görünüyorsa cihaz iki yazmacı başka bir sırada saklıyordur: WordOrder değerini mwoCDAB, mwoBADC veya mwoDCBA olarak ayarlayın.

Evet. RS-485 adaptöründe bir TsgcSerialPort açın ve onu TsgcModbusRTUClient.SerialPort veya TsgcModbusRTUServer.SerialPort özelliğine atayın. Otomatik yön denetimli bir adaptör kullanın veya RTS ile anahtarlanan adaptörler için RtsControl değerini srcToggle yapın.

Evet. Bir TsgcModbusTCPServer oluşturun, DataModel alanını SetHoldingRegister, SetCoil ve diğer ayarlayıcılarla doldurun ve Active = true yapın. Değerleri isteğe bağlı hesaplamak veya yazmaları bir Modbus istisna koduyla reddetmek için OnReadRequest ve OnWriteRequest olaylarını işleyin.

Hayır, istemci metotları eşzamanlıdır ve iş parçacığı güvenlidir. Bunları bir çalışan iş parçacığından çağırın veya Task.Run içine alın; birkaç iş parçacığı veya görev tek bir istemciyi paylaşabilir ve her çağrı kendi yanıtını bekler.

esegece.sgcIndustrial paketi .NET 8, .NET 9, .NET 10 ve .NET Standard 2.0 hedefler. Seri port System.IO.Ports kullanır, bu yüzden Modbus RTU için o paketin seri portları açabildiği bir platform gerekir.

Modbus ve seri port bileşenleri sgcWebSockets Enterprise (Delphi ve .NET) ile All-Access ya da bağımsız sgcIndustrial paketi içinde yer alır.

sgcWebSockets .NET hakkında daha fazlası

Endüstriyel bileşenler

Seri port, Modbus ve OPC UA, tam bileşen başvurusuyla birlikte.

C# OPC UA istemcisi

OPC UA sunucularını, Modbus cihazlarının yanında aynı .NET uygulamasından okuyun, yazın ve bunlara abone olun.

C# MQTT istemcisi

Modbus okumalarını aynı uygulamadan bir MQTT aracısına yayınlayın.

C# WebSocket kitaplığı

Canlı cihaz verilerini gösteren panolar için WebSocket istemcisi ve sunucusu.

Delphi ve C++Builder için de

Delphi 7 ile Delphi 13 için aynı sınıf adlarına ve metotlara sahip aynı Modbus bileşenleri.

En avantajlı seçenek: All-AccessTüm eSeGeCe ürünleri, Premium Destek dahil, yılda €1,059'dan itibaren.
All-Access fiyatlarına bakın

İlk Modbus yazmacınızı C# ile okuyun

sgcWebSockets Enterprise (Delphi ve .NET) ve All-Access ya da bağımsız sgcIndustrial paketi içinde yer alır.