Modbus TCP und RTU Server
Mache aus einer Delphi, C++Builder oder .NET Anwendung ein Modbus-Gerät. Beantworte Anfragen von SCADA-Systemen, HMIs und Modbus Clients über TCP/IP oder eine serielle Leitung, aus einem threadsicheren Datenmodell.
Neu
Mache aus einer Delphi, C++Builder oder .NET Anwendung ein Modbus-Gerät. Beantworte Anfragen von SCADA-Systemen, HMIs und Modbus Clients über TCP/IP oder eine serielle Leitung, aus einem threadsicheren Datenmodell.
Neu
Zwei Server, die aus demselben TsgcModbusDataModel antworten: Der eine lauscht auf TCP-Port 502, der andere ist ein Modbus RTU Slave an einer seriellen Leitung.
TsgcModbusTCPServerTsgcModbusRTUServerTsgcModbusDataModel
Modbus Application Protocol V1.1b3, Modbus TCP und Modbus RTU
TCP: alle Plattformen von sgcWebSockets. RTU: Windows, Linux und macOS
Enthalten in sgcWebSockets Enterprise (Delphi und .NET) und All-Access oder im eigenständigen Paket sgcIndustrial
Fülle das Datenmodell, weise die Ereignisse zu und setze Active auf True. OnReadRequest aktualisiert einen Live-Wert, bevor er gelesen wird, und OnWriteRequest lehnt Sollwerte außerhalb des Bereichs ab.
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;
}
}
}
Ein Modbus-Gerät in einer Komponente: Der Server parst die Anfragen, prüft sie und antwortet aus dem Datenmodell.
01 bis 08 (08 mit Subfunktion 0), 15, 16, 22 (Mask Write, atomar angewendet), 23 (Read/Write Multiple Registers) und 43/14 (Geräteidentifikation, seitenweise mit More Follows).
Coils, Discrete Inputs, Holding-Register und Input-Register, standardmäßig je 10000 und bis zu 65536. Jede Get- und Set-Methode ist threadsicher, und eine Anfrage jenseits einer Tabelle erhält die Exception 02.
OnReadRequest wird ausgelöst, bevor die Daten gelesen werden, um Live-Werte zu laden. OnWriteRequest wird ausgelöst, bevor die Daten geschrieben werden, um die Werte zu ändern oder die Anfrage mit einem Modbus-Exception-Code abzulehnen.
Jede TCP-Verbindung wird für sich bedient, und mehrere Anfragen in einem Paket werden der Reihe nach beantwortet. Ein fehlerhafter Header löst OnError aus und schließt diese Verbindung. OnClientConnect und OnClientDisconnect melden die Gegenstellen.
Standardmäßig beantwortet der TCP Server jede Unit-ID. Setze UnitId, um nur eine ID zu beantworten: Die Anfragen für andere IDs erhalten keine Antwort, und die Verbindung bleibt offen, wie es ein Gateway bei einem fehlenden Gerät tut.
VendorName, ProductCode und MajorMinorRevision sind die Basisobjekte, VendorUrl, ProductName und ModelName die regulären, beantwortet auf Funktion 43/14.
Verknüpfe einen TsgcSerialPort und setze die Slave-Adresse in UnitId (1 bis 247). Der Server öffnet den Port beim Start und antwortet aus seinem Datenmodell.
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;
}
}
Maßgebliche Quellen für das Protokoll, das diese Komponente implementiert.
Im Thread, der die TCP-Verbindung bedient, oder im Frame-Thread des RTU Servers. Sie werden nie mit dem Hauptthread synchronisiert, weil der Server die Antwort des Handlers braucht, um die Antwort zu bauen. Greife aus ihnen nicht direkt auf die Benutzeroberfläche zu und setze Active nicht aus einem Ereignis-Handler des TCP Servers auf False.
Schreibe die Werte in das Datenmodell, sobald sie sich ändern, oder lade sie in OnReadRequest, das vor jedem Lesezugriff mit Funktionscode, Adresse und Anzahl ausgelöst wird. Die Methoden des Datenmodells können aus dem Ereignis und aus jedem anderen Thread aufgerufen werden.
Setze aExceptionCode in OnWriteRequest, zum Beispiel auf CS_MODBUS_EX_ILLEGAL_DATA_VALUE (03). Der Client erhält diese Modbus-Exception, und die Tabellen bleiben unverändert. Das Ereignis kann die Werte auch ändern, bevor sie geschrieben werden.
Sie ist in sgcWebSockets Enterprise (Delphi und .NET) und All-Access enthalten, als Teil des Pakets sgcIndustrial. Füge in Delphi sgcIndustrial zur uses-Klausel hinzu.
Springe direkt zur Komponentenreferenz, öffne das Demoprojekt und lies das technische Dokument.
| Online Help: TsgcModbusTCPServer Vollständige Referenz zu Eigenschaften, Methoden und Ereignissen des Modbus TCP Servers. | Öffnen | |
| Online Help: TsgcModbusRTUServer Vollständige Referenz zu Eigenschaften, Methoden und Ereignissen des Modbus RTU Servers. | Öffnen | |
| Online Help: TsgcModbusDataModel Die Tabellen, die Objekte der Geräteidentifikation und die Ereignisse des Datenmodells. | Öffnen | |
| Demoprojekt: Industrial\03.Modbus_TCP_Server Ein Modbus TCP Server für Delphi, C++Builder und .NET. Er wird im Paket sgcWebSockets mitgeliefert. | Öffnen | |
| Technisches Dokument (PDF) Funktionen, Schnellstart, Code-Beispiele und Primärquellen nur für diese Komponente. | Öffnen | |
| Benutzerhandbuch (PDF) Umfassendes Handbuch, das jede Komponente der Bibliothek abdeckt. | Öffnen |