Serwer Modbus TCP i RTU
Zamień aplikację Delphi, C++Builder lub .NET w urządzenie Modbus. Odpowiadaj systemom SCADA, panelom HMI i klientom Modbus przez TCP/IP lub łącze szeregowe, na podstawie bezpiecznego wątkowo modelu danych.
Nowość
Zamień aplikację Delphi, C++Builder lub .NET w urządzenie Modbus. Odpowiadaj systemom SCADA, panelom HMI i klientom Modbus przez TCP/IP lub łącze szeregowe, na podstawie bezpiecznego wątkowo modelu danych.
Nowość
Dwa serwery odpowiadające z tego samego TsgcModbusDataModel: jeden nasłuchuje na porcie TCP 502, drugi jest urządzeniem podrzędnym Modbus RTU na łączu szeregowym.
TsgcModbusTCPServerTsgcModbusRTUServerTsgcModbusDataModel
Modbus Application Protocol V1.1b3, Modbus TCP i Modbus RTU
TCP: każda platforma sgcWebSockets. RTU: Windows, Linux i macOS
W pakiecie sgcWebSockets Enterprise (Delphi i .NET) oraz All-Access, a także w samodzielnym pakiecie sgcIndustrial
Wypełnij model danych, przypisz zdarzenia i ustaw Active na True. OnReadRequest odświeża bieżącą wartość przed jej odczytem, a OnWriteRequest odrzuca wartości zadane spoza zakresu.
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;
}
}
}
Urządzenie Modbus w komponencie: serwer analizuje żądania, sprawdza je i odpowiada na podstawie modelu danych.
Od 01 do 08 (08 z podfunkcją 0), 15, 16, 22 (mask write, stosowany atomowo), 23 (read/write multiple registers) oraz 43/14 (identyfikacja urządzenia, stronicowana przez More Follows).
Cewki, wejścia dyskretne, rejestry przechowujące i rejestry wejściowe, domyślnie po 10000 każdego rodzaju, do 65536. Każda metoda Get i Set jest bezpieczna wątkowo, a żądanie wykraczające poza tabelę otrzymuje wyjątek 02.
OnReadRequest jest wywoływane przed odczytem danych, aby załadować bieżące wartości. OnWriteRequest jest wywoływane przed zapisem danych, aby zmienić wartości lub odrzucić żądanie kodem wyjątku Modbus.
Każde połączenie TCP jest obsługiwane osobno, a kilka żądań w jednym pakiecie otrzymuje odpowiedzi po kolei. Nieprawidłowy nagłówek wywołuje OnError i zamyka to połączenie. OnClientConnect i OnClientDisconnect informują o klientach.
Domyślnie serwer TCP odpowiada na każdy identyfikator jednostki. Ustaw UnitId, aby odpowiadać tylko na jeden: żądania do innych identyfikatorów nie dostają odpowiedzi, a połączenie pozostaje otwarte, tak jak robi bramka przy brakującym urządzeniu.
VendorName, ProductCode i MajorMinorRevision to obiekty podstawowe, a VendorUrl, ProductName i ModelName to obiekty zwykłe, zwracane na funkcję 43/14.
Połącz TsgcSerialPort i ustaw adres urządzenia podrzędnego w UnitId (od 1 do 247). Serwer otwiera port przy starcie i odpowiada na podstawie swojego modelu danych.
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;
}
}
Autorytatywne źródła dla protokołu implementowanego przez ten komponent.
W wątku obsługującym połączenie TCP albo w wątku ramek serwera RTU. Nigdy nie są synchronizowane z wątkiem głównym, ponieważ serwer potrzebuje odpowiedzi procedury obsługi, aby zbudować odpowiedź. Nie odwołuj się z nich bezpośrednio do interfejsu użytkownika i nie ustawiaj Active na False z procedury obsługi zdarzenia serwera TCP.
Zapisuj wartości w modelu danych za każdym razem, gdy się zmieniają, albo ładuj je w OnReadRequest, które jest wywoływane przed każdym odczytem z kodem funkcji, adresem i liczbą. Metody modelu danych można wywoływać ze zdarzenia i z dowolnego innego wątku.
Ustaw aExceptionCode w OnWriteRequest, na przykład na CS_MODBUS_EX_ILLEGAL_DATA_VALUE (03). Klient otrzymuje ten wyjątek Modbus, a tabele pozostają nietknięte. Zdarzenie może też zmienić wartości przed ich zapisem.
Wchodzi w skład sgcWebSockets Enterprise (Delphi i .NET) oraz All-Access, jako część pakietu sgcIndustrial. W Delphi dodaj sgcIndustrial do klauzuli uses.
Przejdź do dokumentacji komponentu, otwórz projekt demo i przeczytaj dokument techniczny.
| Online Help: TsgcModbusTCPServer Pełna dokumentacja właściwości, metod i zdarzeń serwera Modbus TCP. | Otwórz | |
| Online Help: TsgcModbusRTUServer Pełna dokumentacja właściwości, metod i zdarzeń serwera Modbus RTU. | Otwórz | |
| Online Help: TsgcModbusDataModel Tabele, obiekty identyfikacji urządzenia i zdarzenia modelu danych. | Otwórz | |
| Projekt demo: Industrial\03.Modbus_TCP_Server Serwer Modbus TCP dla Delphi, C++Builder i .NET. Jest dołączony do pakietu sgcWebSockets. | Otwórz | |
| Dokument techniczny (PDF) Funkcje, szybki start, przykłady kodu i podstawowe źródła tylko dla tego komponentu. | Otwórz | |
| Podręcznik użytkownika (PDF) Kompleksowy podręcznik obejmujący każdy komponent biblioteki. | Otwórz |