Modbus TCP ve RTU Sunucusu

Bir Delphi, C++Builder veya .NET uygulamasını Modbus cihazına dönüştürün. SCADA sistemlerine, HMI'lara ve Modbus istemcilerine TCP/IP ya da seri hat üzerinden, iş parçacığı güvenli bir veri modelinden yanıt verin.

Yeni

TsgcModbusTCPServer ve TsgcModbusRTUServer

Aynı TsgcModbusDataModel üzerinden yanıt veren iki sunucu: biri TCP 502 portunu dinler, diğeri seri hat üzerinde bir Modbus RTU köledir.

Bileşen sınıfları

TsgcModbusTCPServer
TsgcModbusRTUServer
TsgcModbusDataModel

Protokol

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

Platformlar

TCP: sgcWebSockets'in tüm platformları. RTU: Windows, Linux ve macOS

Sürüm

sgcWebSockets Enterprise (Delphi ve .NET) ve All-Access ya da bağımsız sgcIndustrial paketi içinde yer alır

Bir Modbus TCP sunucusu başlatın

Veri modelini doldurun, olayları atayın ve Active değerini True yapın. OnReadRequest, canlı bir değeri okunmadan önce yeniler ve OnWriteRequest aralık dışındaki ayar noktalarını reddeder.

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

İçeriğinde neler var

Bir bileşen içinde bir Modbus cihazı: sunucu istekleri ayrıştırır, denetler ve veri modelinden yanıtlar.

İşlev kodları

01 ile 08 arası (08, alt işlev 0 ile), 15, 16, 22 (maske yazma, atomik olarak uygulanır), 23 (birden çok yazmaç okuma/yazma) ve 43/14 (cihaz tanımlama, More Follows ile sayfalanır).

Veri modeli

Bobinler, ayrık girişler, tutma yazmaçları ve giriş yazmaçları; varsayılan olarak her birinden 10000, en fazla 65536. Her Get ve Set metodu iş parçacığı güvenlidir ve bir tablonun ötesindeki istek 02 istisnasını alır.

Okuma ve yazma olayları

OnReadRequest, canlı değerleri yüklemek için veri okunmadan önce tetiklenir. OnWriteRequest, değerleri değiştirmek ya da isteği bir Modbus istisna koduyla reddetmek için veri yazılmadan önce tetiklenir.

Bağlantılar

Her TCP bağlantısı ayrı olarak sunulur ve tek bir pakette gelen birden çok istek sırayla yanıtlanır. Hatalı biçimli bir başlık OnError olayını tetikler ve o bağlantıyı kapatır. OnClientConnect ve OnClientDisconnect karşı tarafları bildirir.

Birim kimlikleri

Varsayılan olarak TCP sunucusu her birim kimliğine yanıt verir. Yalnızca tek bir kimliğe yanıt vermek için UnitId değerini ayarlayın: diğer kimlikler için gelen isteklere yanıt verilmez ve bağlantı açık kalır, tıpkı bir ağ geçidinin eksik bir cihazda yaptığı gibi.

Cihaz tanımlama

VendorName, ProductCode ve MajorMinorRevision temel nesnelerdir; VendorUrl, ProductName ve ModelName ise normal nesnelerdir ve 43/14 işlevine yanıt olarak gönderilir.

RS-232 ve RS-485 üzerinde bir RTU kölesi

Bir TsgcSerialPort bağlayın ve köle adresini UnitId içine yazın (1 ile 247). Sunucu başladığında portu açar ve veri modelinden yanıt verir.

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

Spesifikasyonlar ve referanslar

Bu bileşenin uyguladığı protokol için yetkili kaynaklar.

Modbus sunucusu soruları

TCP bağlantısına hizmet veren iş parçacığında ya da RTU sunucusunun çerçeve iş parçacığında. Sunucu yanıtı oluşturmak için işleyicinin cevabına ihtiyaç duyduğundan, ana iş parçacığıyla hiçbir zaman eşzamanlanmazlar. Bunlardan kullanıcı arayüzüne doğrudan erişmeyin ve TCP sunucusunun bir olay işleyicisinden Active değerini False yapmayın.

Değerleri her değiştiklerinde veri modeline yazın ya da işlev koduyla, adresle ve sayıyla her okumadan önce tetiklenen OnReadRequest içinde yükleyin. Veri modeli metotları olaydan ve başka herhangi bir iş parçacığından çağrılabilir.

OnWriteRequest içinde aExceptionCode değerini ayarlayın, örneğin CS_MODBUS_EX_ILLEGAL_DATA_VALUE (03). İstemci o Modbus istisnasını alır ve tablolara dokunulmaz. Olay, değerleri yazılmadan önce değiştirebilir de.

sgcIndustrial paketinin bir parçası olarak sgcWebSockets Enterprise (Delphi ve .NET) ve All-Access içinde yer alır. Delphi'de sgcIndustrial birimini uses yan tümcesine ekleyin.

Belgeler ve Demolar

Bileşen başvurusuna doğrudan gidin, demo projesini açın ve teknik belgeyi okuyun.

Online Help: TsgcModbusTCPServer Modbus TCP sunucusu için tam özellik, metot ve olay referansı.
Online Help: TsgcModbusRTUServer Modbus RTU sunucusu için tam özellik, metot ve olay referansı.
Online Help: TsgcModbusDataModel Veri modelinin tabloları, cihaz tanımlama nesneleri ve olayları.
Demo Projesi: Industrial\03.Modbus_TCP_Server Delphi, C++Builder ve .NET için bir Modbus TCP sunucusu. sgcWebSockets paketinin içinde gelir.
Teknik Belge (PDF) Yalnızca bu bileşene ait özellikler, hızlı başlangıç, kod örnekleri ve birincil kaynak başvuruları.
Kullanıcı Kılavuzu (PDF) Kütüphanedeki her bileşeni kapsayan kapsamlı kılavuz.
En avantajlı seçenek: All-AccessTüm eSeGeCe ürünleri, Premium Destek dahil, yılda €1,059'dan itibaren.
All-Access fiyatlarına bakın

sgcWebSockets Enterprise içinde yer alır

sgcWebSockets Enterprise (Delphi ve .NET) ve All-Access ya da bağımsız sgcIndustrial paketi içinde yer alır.