C# e .NET Novità

Libreria Modbus C# TCP e RTU per .NET

Leggi e scrivi PLC, azionamenti e contatori da C#, oppure esponi i tuoi dati come slave Modbus, via Ethernet o RS-485.

Modbus TCP e Modbus RTU
Client e server
Float32, Int32 e stringhe con qualsiasi ordine delle word
Chiamate bloccanti thread-safe

Incluso in sgcWebSockets Enterprise (Delphi e .NET) e All-Access, oppure nel pacchetto standalone sgcIndustrial.

Leggi e scrivi un dispositivo in C# → · FAQ su Modbus →

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

Client e server Modbus per .NET

Quattro componenti, un'unica API per TCP e RTU, un modello dati thread safe dietro i server.

La libreria Modbus C# di sgcWebSockets .NET si trova nel pacchetto esegece.sgcIndustrial, namespace esegece.sgcWebSockets. TsgcModbusTCPClient e TsgcModbusRTUClient sono master Modbus che interrogano i dispositivi; TsgcModbusTCPServer e TsgcModbusRTUServer sono slave Modbus che rispondono a sistemi SCADA, HMI e altri master a partire da un TsgcModbusDataModel. La linea seriale è un TsgcSerialPort dello stesso pacchetto, basato su System.IO.Ports.

Entrambi i client condividono TsgcModbusClient_Base, quindi un metodo che legge un registro via Ethernet lo legge anche via RS-485. Ogni chiamata si blocca finché non arriva la risposta o scade Timeout, restituisce normali array .NET (ushort[] per i registri, bool[] per i coil) e solleva un'eccezione tipizzata quando il dispositivo segnala un errore. Il pacchetto ha come target .NET 8, .NET 9, .NET 10 e .NET Standard 2.0.

Codici funzione

01 a 08, 15, 16, 22, 23 e 43/14, un metodo ciascuno.

Valori tipizzati

ReadFloat32, ReadInt32, ReadUInt32, ReadString e i corrispondenti metodi di scrittura, con WordOrder per i quattro layout dei registri.

Modbus TCP

Porta 502 per impostazione predefinita, con TLS opzionale, proxy HTTP o SOCKS e riconnessione automatica.

Modbus RTU

RS-232 e RS-485 con frame da 3,5 caratteri, controlli CRC e scritture broadcast.

Modbus in C#, passo dopo passo

Fai riferimento al pacchetto esegece.sgcIndustrial, poi scegli il trasporto. Ogni esempio di questa pagina si compila con .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();

Le chiamate sono sincrone. In un'applicazione WinForms, WPF o ASP.NET, esegui il ciclo di polling su un thread di lavoro o dentro Task.Run; il client è thread safe, quindi più task possono condividere una sola connessione.

Codici funzione Modbus supportati

Il client controlla le quantità rispetto alla specifica prima di inviare qualsiasi cosa; i server rispondono a ogni codice di questa tabella.

FCFunzioneMetodo 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 (linea seriale)ReadExceptionStatus sul client RTU
08Diagnostics (linea seriale)Diagnostics sul client RTU
15Write Multiple CoilsWriteMultipleCoils
16Write Multiple RegistersWriteMultipleRegisters, WriteInt32, WriteUInt32, WriteFloat32, WriteString
22Mask Write RegisterMaskWriteRegister
23Read/Write Multiple RegistersReadWriteMultipleRegisters
43/14Read Device IdentificationReadDeviceIdentification con TsgcModbusDeviceIdCode basic, regular, extended o specific

Un master Modbus pensato per la produzione

Ordine delle word

TsgcModbusWordOrder.mwoABCD è big endian, l'impostazione predefinita di Modbus. mwoCDAB mette per prima la word bassa, mwoBADC scambia i byte in ogni registro e mwoDCBA è completamente little endian. Le stringhe contengono due caratteri per registro.

Thread safe

Per ogni client viene eseguita una sola transazione alla volta, sotto un lock che copre tutti i suoi tentativi. Su TCP la risposta viene abbinata dal thread di ricezione e passata alla chiamata in attesa, quindi una chiamata da un thread della UI non può causare un deadlock.

Timeout e tentativi

Timeout è l'attesa per ogni tentativo, Retries i tentativi aggiuntivi. Un nuovo tentativo TCP usa un nuovo id di transazione, e le risposte obsolete o duplicate vengono scartate.

Eccezioni tipizzate

EsgcModbusException contiene ExceptionCode e FunctionCode, EsgcModbusTimeout segnala una risposta mancante ed EsgcModbusError copre connessioni chiuse, problemi della porta ed errori CRC in RTU.

Gateway e unit id

Ogni metodo ha un overload con un byte aUnitId iniziale, così una sola connessione TCP a un gateway raggiunge tutti i dispositivi collegati dietro di esso.

TLS, proxy e riconnessione

TLS, TLSOptions, Proxy e WatchDog vengono passati al client TCP di sgcWebSockets sottostante, quindi Modbus TCP ottiene lo stesso stack TLS, lo stesso supporto proxy e la stessa riconnessione automatica del resto della libreria.

Framing RTU

Il client RTU attende il silenzio di 3,5 caratteri prima di inviare, legge la risposta in base alla lunghezza attesa, controlla il CRC di ogni frame e ignora i frame di altri indirizzi slave. L'unit id 0 invia una scrittura broadcast e attende TurnaroundDelay invece di una risposta.

Direzione RS-485

Con RtsControl = TsgcSerialRtsControl.srcToggle la porta seriale alza RTS a ogni scrittura e lo abbassa quando il buffer di uscita si è svuotato. In .NET la temporizzazione è gestita via software, quindi per tempi di bus rigorosi è preferibile un adattatore con controllo automatico della direzione.

Eventi

OnConnect, OnDisconnect e OnError vengono generati tramite NotifyEvents, nell'ordine in cui sono avvenuti. Una connessione fallita non solleva eccezioni: genera OnError e Active resta false.

Server Modbus TCP e RTU in C#

Realizza un gateway che espone valori di database o cloud a un sistema SCADA, un simulatore per testare le schermate HMI senza hardware, oppure l'interfaccia Modbus del tuo dispositivo. Ogni server possiede un TsgcModbusDataModel con le quattro tabelle (coil, discrete input, holding register e input register, 10.000 voci ciascuna per impostazione predefinita e fino a 65.536), le stringhe di identificazione per FC 43/14 e lo stato di eccezione per FC 07. Ogni membro del modello dati è thread safe.

OnReadRequest viene eseguito prima della lettura di una tabella, quindi può aggiornare i valori o rispondere con un codice di eccezione. OnWriteRequest riceve i valori prima che vengano memorizzati e può modificarli o rifiutare la scrittura, lasciando le tabelle intatte. Entrambi vengono eseguiti nel thread del server che gestisce la richiesta (la connessione TCP o il lettore di frame RTU) senza alcun lock mantenuto.

TsgcModbusTCPServer

Molte connessioni simultanee, richieste evase in ordine di arrivo, richieste frammentate riassemblate e intestazioni malformate che chiudono la connessione con OnError. UnitId = 0 risponde a qualsiasi unit id. Bindings seleziona gli endpoint, Port = 0 sceglie una porta libera, e OnClientConnect e OnClientDisconnect segnalano i peer.

TsgcModbusRTUServer

Risponde come slave UnitId (da 1 a 247) su un TsgcSerialPort, delimita le richieste in base alla lunghezza e al silenzio di 3,5 caratteri, ignora i CRC errati e gli altri indirizzi, ed esegue le scritture broadcast senza rispondere.

Testato in entrambe le direzioni

Il client e il server .NET superano gli stessi controlli di interoperabilità con pymodbus su TCP e con i componenti Modbus Delphi di sgcWebSockets, 35 su 35 in ciascuna direzione.

Incluso in sgcWebSockets Enterprise

I componenti Modbus e porta seriale sono inclusi in sgcWebSockets Enterprise (Delphi e .NET) e All-Access, come pacchetto esegece.sgcIndustrial accanto agli altri pacchetti sgcWebSockets .NET. Confronta le edizioni nella pagina dei prezzi (scheda .NET) o nella matrice delle funzionalità .NET.

Domande su Modbus in C#

Crea un TsgcModbusTCPClient, imposta Host, Port e UnitId, imposta Active = true e chiama ReadHoldingRegisters(address, count). Restituisce un ushort[] con un valore per registro. Gli indirizzi partono da zero, come viaggiano sul cavo.

Chiama ReadFloat32(address) per gli holding register o ReadInputFloat32(address) per gli input register. Se il numero sembra sbagliato, il dispositivo memorizza i due registri in un altro ordine: imposta WordOrder su mwoCDAB, mwoBADC o mwoDCBA.

Sì. Apri un TsgcSerialPort sull'adattatore RS-485 e assegnalo a TsgcModbusRTUClient.SerialPort o TsgcModbusRTUServer.SerialPort. Usa un adattatore con controllo automatico della direzione, oppure imposta RtsControl su srcToggle per gli adattatori commutati da RTS.

Sì. Crea un TsgcModbusTCPServer, riempi DataModel con SetHoldingRegister, SetCoil e gli altri setter, e imposta Active = true. Gestisci OnReadRequest e OnWriteRequest per calcolare i valori su richiesta o rifiutare le scritture con un codice di eccezione Modbus.

No, i metodi del client sono sincroni e thread safe. Chiamali da un thread di lavoro oppure racchiudili in Task.Run; più thread o task possono condividere un solo client, e ogni chiamata attende la propria risposta.

Il pacchetto esegece.sgcIndustrial ha come target .NET 8, .NET 9, .NET 10 e .NET Standard 2.0. La porta seriale usa System.IO.Ports, quindi Modbus RTU richiede una piattaforma in cui quel pacchetto possa aprire porte seriali.

I componenti Modbus e porta seriale sono inclusi in sgcWebSockets Enterprise (Delphi e .NET) e All-Access, oppure nel pacchetto standalone sgcIndustrial.

Altro su sgcWebSockets .NET

Componenti industriali

Porta seriale, Modbus e OPC UA, con il riferimento completo dei componenti.

Client OPC UA in C#

Leggi, scrivi e sottoscrivi i server OPC UA dalla stessa applicazione .NET, accanto ai dispositivi Modbus.

Client MQTT C#

Pubblica le letture Modbus su un broker MQTT dalla stessa applicazione.

Libreria WebSocket C#

Client e server WebSocket per dashboard che mostrano i dati dei dispositivi in tempo reale.

Anche per Delphi e C++Builder

Gli stessi componenti Modbus, con gli stessi nomi di classi e metodi, per Delphi 7 fino a Delphi 13.

La scelta più conveniente: All-AccessTutti i prodotti eSeGeCe, con Supporto Premium incluso, a partire da €1,059/anno.
Vedi i prezzi All-Access

Leggi il tuo primo registro Modbus da C#

Incluso in sgcWebSockets Enterprise (Delphi e .NET) e All-Access, oppure nel pacchetto standalone sgcIndustrial.