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ść

TsgcModbusTCPServer i TsgcModbusRTUServer

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.

Klasy komponentów

TsgcModbusTCPServer
TsgcModbusRTUServer
TsgcModbusDataModel

Protokół

Modbus Application Protocol V1.1b3, Modbus TCP i Modbus RTU

Platformy

TCP: każda platforma sgcWebSockets. RTU: Windows, Linux i macOS

Edycja

W pakiecie sgcWebSockets Enterprise (Delphi i .NET) oraz All-Access, a także w samodzielnym pakiecie sgcIndustrial

Uruchom serwer Modbus TCP

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;
                }
    }
}

Co jest w środku

Urządzenie Modbus w komponencie: serwer analizuje żądania, sprawdza je i odpowiada na podstawie modelu danych.

Kody funkcji

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).

Model danych

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.

Zdarzenia odczytu i zapisu

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.

Połączenia

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.

Identyfikatory jednostek

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.

Identyfikacja urządzenia

VendorName, ProductCode i MajorMinorRevision to obiekty podstawowe, a VendorUrl, ProductName i ModelName to obiekty zwykłe, zwracane na funkcję 43/14.

Urządzenie podrzędne RTU na RS-232 i RS-485

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;
    }
}

Specyfikacje i źródła

Autorytatywne źródła dla protokołu implementowanego przez ten komponent.

Pytania o serwer Modbus

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.

Dokumentacja i wersje demo

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.
Online Help: TsgcModbusRTUServer Pełna dokumentacja właściwości, metod i zdarzeń serwera Modbus RTU.
Online Help: TsgcModbusDataModel Tabele, obiekty identyfikacji urządzenia i zdarzenia modelu danych.
Projekt demo: Industrial\03.Modbus_TCP_Server Serwer Modbus TCP dla Delphi, C++Builder i .NET. Jest dołączony do pakietu sgcWebSockets.
Dokument techniczny (PDF) Funkcje, szybki start, przykłady kodu i podstawowe źródła tylko dla tego komponentu.
Podręcznik użytkownika (PDF) Kompleksowy podręcznik obejmujący każdy komponent biblioteki.
Najkorzystniejsza oferta: All-AccessWszystkie produkty eSeGeCe, ze wsparciem Premium w cenie, już od €1,059 rocznie.
Zobacz cennik All-Access

W pakiecie sgcWebSockets Enterprise

W pakiecie sgcWebSockets Enterprise (Delphi i .NET) oraz All-Access, a także w samodzielnym pakiecie sgcIndustrial.