Server Modbus TCP e RTU
Trasforma un'applicazione Delphi, C++Builder o .NET in un dispositivo Modbus. Rispondi a sistemi SCADA, HMI e client Modbus su TCP/IP o su una linea seriale, da un modello dati thread-safe.
Novità
Trasforma un'applicazione Delphi, C++Builder o .NET in un dispositivo Modbus. Rispondi a sistemi SCADA, HMI e client Modbus su TCP/IP o su una linea seriale, da un modello dati thread-safe.
Novità
Due server che rispondono dallo stesso TsgcModbusDataModel: uno resta in ascolto sulla porta TCP 502, l'altro è uno slave Modbus RTU su una linea seriale.
TsgcModbusTCPServerTsgcModbusRTUServerTsgcModbusDataModel
Modbus Application Protocol V1.1b3, Modbus TCP e Modbus RTU
TCP: tutte le piattaforme di sgcWebSockets. RTU: Windows, Linux e macOS
Incluso in sgcWebSockets Enterprise (Delphi e .NET) e All-Access, oppure nel pacchetto standalone sgcIndustrial
Riempi il modello dati, assegna gli eventi e porta Active a True. OnReadRequest aggiorna un valore in tempo reale prima che venga letto, e OnWriteRequest rifiuta i setpoint fuori intervallo.
uses
sgcIndustrial;
procedure TForm1.StartServer;
begin
FServer := TsgcModbusTCPServer.Create(Self);
FServer.Port := 502;
FServer.DataModel.HoldingRegisterCount := 1000;
FServer.DataModel.SetHoldingRegister(0, 1234);
FServer.DataModel.SetCoil(5, True);
FServer.DataModel.VendorName := 'eSeGeCe';
FServer.DataModel.ProductCode := 'PLC-1';
FServer.DataModel.MajorMinorRevision := '1.0';
FServer.OnReadRequest := OnModbusReadRequest;
FServer.OnWriteRequest := OnModbusWriteRequest;
FServer.Active := True;
end;
procedure TForm1.OnModbusReadRequest(Sender: TObject; aUnitId,
aFunctionCode: Byte; aAddress, aCount: Word; var aExceptionCode: Byte);
begin
// live value: refresh input register 0 before the client reads it
if aFunctionCode = CS_MODBUS_FC_READ_INPUT_REGISTERS then
FServer.DataModel.SetInputRegister(0, FTemperature);
end;
procedure TForm1.OnModbusWriteRequest(Sender: TObject; aUnitId,
aFunctionCode: Byte; aAddress, aCount: Word; var aBits: TsgcModbusBits;
var aRegisters: TsgcModbusRegisters; var aExceptionCode: Byte);
var
i: Integer;
begin
// connection thread: setpoints accept 0..1000 only
if (aFunctionCode = CS_MODBUS_FC_WRITE_SINGLE_REGISTER) or
(aFunctionCode = CS_MODBUS_FC_WRITE_MULTIPLE_REGISTERS) then
for i := 0 to Length(aRegisters) - 1 do
if aRegisters[i] > 1000 then
begin
aExceptionCode := CS_MODBUS_EX_ILLEGAL_DATA_VALUE;
Exit;
end;
end;
#include "sgcIndustrial.hpp"
void __fastcall TForm1::StartServer()
{
FServer = new TsgcModbusTCPServer(this);
FServer->Port = 502;
FServer->DataModel->HoldingRegisterCount = 1000;
FServer->DataModel->SetHoldingRegister(0, 1234);
FServer->DataModel->SetCoil(5, true);
FServer->DataModel->VendorName = "eSeGeCe";
FServer->DataModel->ProductCode = "PLC-1";
FServer->DataModel->MajorMinorRevision = "1.0";
FServer->OnReadRequest = OnModbusReadRequest;
FServer->OnWriteRequest = OnModbusWriteRequest;
FServer->Active = true;
}
void __fastcall TForm1::OnModbusReadRequest(TObject *Sender, Byte aUnitId,
Byte aFunctionCode, Word aAddress, Word aCount, Byte &aExceptionCode)
{
// live value: refresh input register 0 before the client reads it
if (aFunctionCode == CS_MODBUS_FC_READ_INPUT_REGISTERS)
FServer->DataModel->SetInputRegister(0, FTemperature);
}
void __fastcall TForm1::OnModbusWriteRequest(TObject *Sender, Byte aUnitId,
Byte aFunctionCode, Word aAddress, Word aCount, TsgcModbusBits &aBits,
TsgcModbusRegisters &aRegisters, Byte &aExceptionCode)
{
// connection thread: setpoints accept 0..1000 only
if ((aFunctionCode == CS_MODBUS_FC_WRITE_SINGLE_REGISTER) ||
(aFunctionCode == CS_MODBUS_FC_WRITE_MULTIPLE_REGISTERS))
for (int i = 0; i < aRegisters.Length; i++)
if (aRegisters[i] > 1000)
{
aExceptionCode = CS_MODBUS_EX_ILLEGAL_DATA_VALUE;
return;
}
}
using System;
using esegece.sgcWebSockets;
class PlcServer
{
TsgcModbusTCPServer FServer = new TsgcModbusTCPServer();
ushort FTemperature = 215;
public void StartServer()
{
FServer.Port = 502;
FServer.DataModel.HoldingRegisterCount = 1000;
FServer.DataModel.SetHoldingRegister(0, 1234);
FServer.DataModel.SetCoil(5, true);
FServer.DataModel.VendorName = "eSeGeCe";
FServer.DataModel.ProductCode = "PLC-1";
FServer.DataModel.MajorMinorRevision = "1.0";
FServer.OnReadRequest += OnModbusReadRequest;
FServer.OnWriteRequest += OnModbusWriteRequest;
FServer.Active = true;
}
void OnModbusReadRequest(object Sender, byte aUnitId, byte aFunctionCode,
ushort aAddress, ushort aCount, ref byte aExceptionCode)
{
// live value: refresh input register 0 before the client reads it
if (aFunctionCode == sgcModbus_Classes.CS_MODBUS_FC_READ_INPUT_REGISTERS)
FServer.DataModel.SetInputRegister(0, FTemperature);
}
void OnModbusWriteRequest(object Sender, byte aUnitId, byte aFunctionCode,
ushort aAddress, ushort aCount, ref bool[] aBits, ref ushort[] aRegisters,
ref byte aExceptionCode)
{
// connection thread: setpoints accept 0..1000 only
if (aFunctionCode == sgcModbus_Classes.CS_MODBUS_FC_WRITE_SINGLE_REGISTER ||
aFunctionCode == sgcModbus_Classes.CS_MODBUS_FC_WRITE_MULTIPLE_REGISTERS)
foreach (ushort vValue in aRegisters)
if (vValue > 1000)
{
aExceptionCode = sgcModbus_Classes.CS_MODBUS_EX_ILLEGAL_DATA_VALUE;
return;
}
}
}
Un dispositivo Modbus in un componente: il server analizza le richieste, le controlla e risponde dal modello dati.
Da 01 a 08 (08 con sottofunzione 0), 15, 16, 22 (mask write, applicato in modo atomico), 23 (read/write multiple registers) e 43/14 (identificazione del dispositivo, paginata con More Follows).
Coil, discrete input, holding register e input register, 10000 per ciascuno per impostazione predefinita e fino a 65536. Ogni metodo Get e Set è thread-safe, e una richiesta oltre i limiti di una tabella riceve l'eccezione 02.
OnReadRequest scatta prima della lettura dei dati, per caricare valori in tempo reale. OnWriteRequest scatta prima della scrittura dei dati, per modificare i valori o rifiutare la richiesta con un codice di eccezione Modbus.
Ogni connessione TCP è servita separatamente, e più richieste in un unico pacchetto ricevono risposta in ordine. Un header malformato fa scattare OnError e chiude quella connessione. OnClientConnect e OnClientDisconnect segnalano i peer.
Per impostazione predefinita il server TCP risponde a ogni unit id. Imposta UnitId per rispondere a un solo id: le richieste per altri id non ricevono risposta e la connessione resta aperta, come fa un gateway con un dispositivo mancante.
VendorName, ProductCode e MajorMinorRevision sono gli oggetti di base, e VendorUrl, ProductName e ModelName quelli regolari, restituiti alla funzione 43/14.
Collega un TsgcSerialPort e imposta l'indirizzo dello slave in UnitId (da 1 a 247). Il server apre la porta all'avvio e risponde dal suo modello dati.
procedure TForm1.StartRTUServer;
begin
FPort := TsgcSerialPort.Create(Self);
FPort.Port := 'COM5';
FPort.BaudRate := 19200;
FPort.Parity := spEven;
FRTUServer := TsgcModbusRTUServer.Create(Self);
FRTUServer.SerialPort := FPort;
FRTUServer.UnitId := 17;
FRTUServer.DataModel.SetInputRegister(0, 215);
// the server opens the port when it is closed
FRTUServer.Active := True;
end;
void __fastcall TForm1::StartRTUServer()
{
FPort = new TsgcSerialPort(this);
FPort->Port = "COM5";
FPort->BaudRate = 19200;
FPort->Parity = spEven;
FRTUServer = new TsgcModbusRTUServer(this);
FRTUServer->SerialPort = FPort;
FRTUServer->UnitId = 17;
FRTUServer->DataModel->SetInputRegister(0, 215);
// the server opens the port when it is closed
FRTUServer->Active = true;
}
using System;
using esegece.sgcWebSockets;
class RtuSlave
{
TsgcSerialPort FPort = new TsgcSerialPort();
TsgcModbusRTUServer FRTUServer = new TsgcModbusRTUServer();
public void StartRTUServer()
{
FPort.Port = "COM5";
FPort.BaudRate = 19200;
FPort.Parity = TsgcSerialParity.spEven;
FRTUServer.SerialPort = FPort;
FRTUServer.UnitId = 17;
FRTUServer.DataModel.SetInputRegister(0, 215);
// the server opens the port when it is closed
FRTUServer.Active = true;
}
}
Fonti autorevoli per il protocollo implementato da questo componente.
Nel thread che serve la connessione TCP, o nel thread dei frame del server RTU. Non sono mai sincronizzati con il thread principale, perché il server ha bisogno della risposta del gestore per costruire la risposta. Non accedere direttamente all'interfaccia utente da questi eventi e non impostare Active a False da un gestore di eventi del server TCP.
Scrivi i valori nel modello dati ogni volta che cambiano, oppure caricali in OnReadRequest, che scatta prima di ogni lettura con il codice funzione, l'indirizzo e il conteggio. I metodi del modello dati possono essere chiamati dall'evento e da qualsiasi altro thread.
Imposta aExceptionCode in OnWriteRequest, ad esempio su CS_MODBUS_EX_ILLEGAL_DATA_VALUE (03). Il client riceve quell'eccezione Modbus e le tabelle restano intatte. L'evento può anche modificare i valori prima che vengano scritti.
È incluso in sgcWebSockets Enterprise (Delphi e .NET) e All-Access, come parte del pacchetto sgcIndustrial. In Delphi, aggiungi sgcIndustrial alla clausola uses.
Link diretti al riferimento del componente, apri il progetto demo e leggi il documento tecnico.
| Online Help: TsgcModbusTCPServer Riferimento completo di proprietà, metodi ed eventi del server Modbus TCP. | Apri | |
| Online Help: TsgcModbusRTUServer Riferimento completo di proprietà, metodi ed eventi del server Modbus RTU. | Apri | |
| Online Help: TsgcModbusDataModel Le tabelle, gli oggetti di identificazione del dispositivo e gli eventi del modello dati. | Apri | |
| Progetto demo: Industrial\03.Modbus_TCP_Server Un server Modbus TCP per Delphi, C++Builder e .NET. È incluso nel pacchetto sgcWebSockets. | Apri | |
| Documento tecnico (PDF) Funzionalità, guida rapida, esempi di codice e riferimenti a fonti primarie solo per questo componente. | Apri | |
| Manuale utente (PDF) Manuale completo che copre ogni componente della libreria. | Apri |