Klient Modbus TCP i RTU

Odczytuj i zapisuj cewki oraz rejestry sterowników PLC, liczników energii i napędów z Delphi, C++Builder i .NET, przez TCP/IP albo łącze szeregowe RS-232 lub RS-485.

Nowość

TsgcModbusTCPClient i TsgcModbusRTUClient

Dwa klienty z tymi samymi metodami: jeden łączy się z urządzeniem lub bramką Modbus TCP, drugi jest masterem Modbus RTU na łączu szeregowym.

Klasy komponentów

TsgcModbusTCPClient
TsgcModbusRTUClient

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

Połącz się, odczytuj i zapisuj przez Modbus TCP

Ustaw Host i UnitId, ustaw Active na True i wywołuj metody. Każde żądanie blokuje, aż nadejdzie odpowiedź, i zgłasza wyjątek, gdy urządzenie zgłosi błąd lub nie odpowie.

uses
  sgcIndustrial;

procedure TForm1.ConnectClient;
begin
  FClient := TsgcModbusTCPClient.Create(Self);
  FClient.Host := '192.168.1.50';
  FClient.Port := 502;
  FClient.UnitId := 1;
  FClient.Timeout := 1000;
  FClient.Retries := 2;
  FClient.OnConnect := OnModbusConnect;
  FClient.OnError := OnModbusError;
  FClient.Active := True;
end;

procedure TForm1.OnModbusConnect(Sender: TObject);
begin
  Memo1.Lines.Add('Connected');
end;

procedure TForm1.ReadValues;
var
  vRegisters: TsgcModbusRegisters;
  vTemperature: Single;
begin
  try
    vRegisters := FClient.ReadHoldingRegisters(0, 10);
    FClient.WriteSingleCoil(10, True);
    // 32-bit float stored low word first by many PLCs
    FClient.WordOrder := mwoCDAB;
    vTemperature := FClient.ReadFloat32(300);
    Memo1.Lines.Add(Format('HR0 = %d, temperature = %.1f',
      [vRegisters[0], vTemperature]));
  except
    on E: EsgcModbusException do
      Memo1.Lines.Add(Format('Device exception %d', [E.ExceptionCode]));
    on E: EsgcModbusTimeout do
      Memo1.Lines.Add('No response');
  end;
end;

procedure TForm1.OnModbusError(Sender: TObject; const aError: string);
begin
  Memo1.Lines.Add('Error: ' + aError);
end;
#include "sgcIndustrial.hpp"

void __fastcall TForm1::ConnectClient()
{
  FClient = new TsgcModbusTCPClient(this);
  FClient->Host = "192.168.1.50"; // Port is 502 by default
  FClient->UnitId = 1;
  FClient->Timeout = 1000;
  FClient->Retries = 2;
  FClient->OnConnect = OnModbusConnect;
  FClient->OnError = OnModbusError;
  FClient->Active = true;
}

void __fastcall TForm1::OnModbusConnect(TObject *Sender)
{
  Memo1->Lines->Add("Connected");
}

void __fastcall TForm1::ReadValues()
{
  try
  {
    TsgcModbusRegisters vRegisters = FClient->ReadHoldingRegisters(0, 10);
    FClient->WriteSingleCoil(10, true);
    // 32-bit float stored low word first by many PLCs
    FClient->WordOrder = mwoCDAB;
    float vTemperature = FClient->ReadFloat32(300);
    Memo1->Lines->Add("HR0 = " + IntToStr(vRegisters[0]) + ", temperature = " +
      FloatToStrF(vTemperature, ffFixed, 7, 1));
  }
  catch (EsgcModbusException &E)
  {
    Memo1->Lines->Add("Device exception " + IntToStr(E.ExceptionCode));
  }
  catch (EsgcModbusTimeout &E)
  {
    Memo1->Lines->Add("No response");
  }
}

void __fastcall TForm1::OnModbusError(TObject *Sender, const String aError)
{
  Memo1->Lines->Add("Error: " + aError);
}
using System;
using esegece.sgcWebSockets;

class PlcClient
{
    TsgcModbusTCPClient FClient = new TsgcModbusTCPClient();

    public void ConnectClient()
    {
        FClient.Host = "192.168.1.50";
        FClient.Port = 502;
        FClient.UnitId = 1;
        FClient.Timeout = 1000;
        FClient.Retries = 2;
        FClient.OnConnect += OnModbusConnect;
        FClient.OnError += OnModbusError;
        FClient.Active = true;
    }

    void OnModbusConnect(object Sender, EventArgs e)
    {
        Console.WriteLine("Connected");
    }

    public void ReadValues()
    {
        try
        {
            ushort[] vRegisters = FClient.ReadHoldingRegisters(0, 10);
            FClient.WriteSingleCoil(10, true);
            // 32-bit float stored low word first by many PLCs
            FClient.WordOrder = TsgcModbusWordOrder.mwoCDAB;
            float vTemperature = FClient.ReadFloat32(300);
            Console.WriteLine($"HR0 = {vRegisters[0]}, temperature = {vTemperature:F1}");
        }
        catch (EsgcModbusException E)
        {
            Console.WriteLine("Device exception " + E.ExceptionCode);
        }
        catch (EsgcModbusTimeout)
        {
            Console.WriteLine("No response");
        }
    }

    void OnModbusError(object Sender, string aError)
    {
        Console.WriteLine("Error: " + aError);
    }
}

Co jest w środku

Ramkowanie, taktowanie i obsługę błędów Modbus wykonuje komponent, więc Twój kod zajmuje się tylko adresami i wartościami.

Kody funkcji

Od 01 do 06, 15, 16, 22 (mask write), 23 (read/write multiple registers) oraz 43/14 (identyfikacja urządzenia, ze stronicowaniem). Klient RTU dodaje 07 (read exception status) i 08 (diagnostyka).

Wartości typowane

ReadInt32, ReadUInt32, ReadFloat32, ReadString i ich odpowiedniki zapisu, a także odczyty z rejestrów wejściowych. WordOrder wybiera ABCD, DCBA, BADC lub CDAB, aby pasowało do urządzenia.

Żądania bezpieczne wątkowo

Wywołuj metody z dowolnego wątku: żądania są szeregowane, a każda odpowiedź jest dopasowywana po identyfikatorze transakcji. Timeout dotyczy każdej próby, a Retries dodaje kolejne próby.

Czytelne błędy

Odpowiedź z wyjątkiem Modbus zgłasza EsgcModbusException z kodami wyjątku i funkcji, brak odpowiedzi zgłasza EsgcModbusTimeout, a każdy inny problem zgłasza EsgcModbusError. Ilości spoza specyfikacji są odrzucane, zanim cokolwiek zostanie wysłane.

TLS, proxy i ponowne połączenie

Klient TCP obsługuje TLS, Proxy i WatchDog do automatycznego ponownego łączenia. Żądanie oczekujące w chwili zerwania połączenia zgłasza błąd natychmiast, bez czekania na limit czasu.

Bramki i identyfikatory jednostek

Każda metoda ma przeciążenie z identyfikatorem jednostki na początku, więc jedno połączenie TCP dociera do wszystkich urządzeń za bramką Modbus TCP na RTU bez zmiany UnitId.

Master RTU na RS-232 i RS-485

Otwórz TsgcSerialPort, połącz go przez SerialPort i ustaw adres slave w UnitId. Klient buduje ramkę RTU z sumą CRC16 i czeka na urządzenie podrzędne.

procedure TForm1.ReadSlave;
var
  vRegisters: TsgcModbusRegisters;
begin
  FPort := TsgcSerialPort.Create(Self);
  FPort.Port := 'COM4';
  FPort.BaudRate := 19200;
  FPort.Parity := spEven;
  FPort.Open;

  FRTU := TsgcModbusRTUClient.Create(Self);
  FRTU.SerialPort := FPort;
  FRTU.UnitId := 17;
  FRTU.Timeout := 500;
  FRTU.Retries := 2;
  vRegisters := FRTU.ReadHoldingRegisters(107, 3);
  Memo1.Lines.Add(Format('Register 107 = %d', [vRegisters[0]]));

  // unit id 0 = broadcast: every slave executes the write, none answers
  FRTU.WriteSingleRegister(0, 1, 100);
end;
void __fastcall TForm1::ReadSlave()
{
  FPort = new TsgcSerialPort(this);
  FPort->Port = "COM4";
  FPort->BaudRate = 19200;
  FPort->Parity = spEven;
  FPort->Open();

  FRTU = new TsgcModbusRTUClient(this);
  FRTU->SerialPort = FPort;
  FRTU->UnitId = 17;
  FRTU->Timeout = 500;
  FRTU->Retries = 2;
  TsgcModbusRegisters vRegisters = FRTU->ReadHoldingRegisters(107, 3);
  Memo1->Lines->Add("Register 107 = " + IntToStr(vRegisters[0]));

  // unit id 0 = broadcast: every slave executes the write, none answers
  FRTU->WriteSingleRegister(0, 1, 100);
}
using System;
using esegece.sgcWebSockets;

class RtuMaster
{
    TsgcSerialPort FPort = new TsgcSerialPort();
    TsgcModbusRTUClient FRTU = new TsgcModbusRTUClient();

    public void ReadSlave()
    {
        FPort.Port = "COM4";
        FPort.BaudRate = 19200;
        FPort.Parity = TsgcSerialParity.spEven;
        FPort.Open();

        FRTU.SerialPort = FPort;
        FRTU.UnitId = 17;
        FRTU.Timeout = 500;
        FRTU.Retries = 2;
        ushort[] vRegisters = FRTU.ReadHoldingRegisters(107, 3);
        Console.WriteLine("Register 107 = " + vRegisters[0]);

        // unit id 0 = broadcast: every slave executes the write, none answers
        FRTU.WriteSingleRegister(0, 1, 100);
    }
}

Specyfikacje i źródła

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

Pytania o klienta Modbus

Metody przyjmują adres protokołu, który zaczyna się od 0. Rejestr, który wiele instrukcji opisuje jako 40001, to rejestr przechowujący 0, więc wywołaj ReadHoldingRegisters(0, 1).

Wywołaj ReadFloat32 z adresem pierwszego z dwóch rejestrów. Jeśli wartość wygląda źle, urządzenie przechowuje bajty w innej kolejności: ustaw WordOrder na kolejność używaną przez urządzenie. Wiele sterowników PLC przechowuje najpierw słowo młodsze, czyli mwoCDAB.

Każda próba czeka Timeout milisekund. Po Retries + 1 próbach bez prawidłowej odpowiedzi żądanie zgłasza EsgcModbusTimeout, a w komunikacie podaje kod funkcji, identyfikator jednostki i liczbę prób.

Nie. Otwórz TsgcSerialPort samodzielnie i zostaw jego zdarzenie OnData puste, ponieważ klient czyta odpowiedzi przez Read. Żądanie zgłasza EsgcModbusError, gdy port nie jest przypisany, nie jest otwarty lub ma przypisane OnData.

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: TsgcModbusTCPClient Pełna dokumentacja właściwości, metod i zdarzeń klienta Modbus TCP.
Online Help: TsgcModbusRTUClient Pełna dokumentacja właściwości, metod i zdarzeń klienta Modbus RTU.
Projekt demo: Industrial\02.Modbus_TCP_Client Klient 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.