Client Modbus TCP e RTU

Leggi e scrivi coil e registri di PLC, contatori di energia e azionamenti da Delphi, C++Builder e .NET, su TCP/IP o su una linea seriale RS-232 o RS-485.

Novità

TsgcModbusTCPClient e TsgcModbusRTUClient

Due client con gli stessi metodi: uno si connette a un dispositivo o gateway Modbus TCP, l'altro è un master Modbus RTU su una linea seriale.

Classi dei componenti

TsgcModbusTCPClient
TsgcModbusRTUClient

Protocollo

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

Piattaforme

TCP: tutte le piattaforme di sgcWebSockets. RTU: Windows, Linux e macOS

Edizione

Incluso in sgcWebSockets Enterprise (Delphi e .NET) e All-Access, oppure nel pacchetto standalone sgcIndustrial

Connetti, leggi e scrivi su Modbus TCP

Imposta Host e UnitId, porta Active a True e chiama i metodi. Ogni richiesta si blocca finché arriva la risposta corrispondente e solleva un'eccezione quando il dispositivo segnala un errore o non risponde.

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

Cosa c'è all'interno

Framing, temporizzazione e gestione degli errori di Modbus sono a carico del componente, così il tuo codice si occupa solo di indirizzi e valori.

Codici funzione

Da 01 a 06, 15, 16, 22 (mask write), 23 (read/write multiple registers) e 43/14 (identificazione del dispositivo, con paginazione). Il client RTU aggiunge 07 (read exception status) e 08 (diagnostica).

Valori tipizzati

ReadInt32, ReadUInt32, ReadFloat32, ReadString e i corrispondenti di scrittura, più le letture dai registri di input. WordOrder seleziona ABCD, DCBA, BADC o CDAB per adattarsi al dispositivo.

Richieste thread-safe

Chiama i metodi da qualsiasi thread: le richieste sono serializzate e ogni risposta è abbinata al suo id di transazione. Timeout si applica a ogni tentativo e Retries aggiunge altri tentativi.

Errori chiari

Una risposta di eccezione Modbus solleva EsgcModbusException con i codici di eccezione e di funzione, la mancanza di risposta solleva EsgcModbusTimeout, e ogni altro problema solleva EsgcModbusError. Le quantità fuori specifica vengono rifiutate prima di inviare qualsiasi cosa.

TLS, proxy e riconnessione

Il client TCP supporta TLS, Proxy e WatchDog per la riconnessione automatica. Una richiesta in attesa quando la connessione cade solleva subito un'eccezione, senza attendere il timeout.

Gateway e unit id

Ogni metodo ha un overload con un unit id iniziale, così una sola connessione TCP raggiunge tutti i dispositivi dietro un gateway da Modbus TCP a RTU senza modificare UnitId.

Un master RTU su RS-232 e RS-485

Apri un TsgcSerialPort, collegalo con SerialPort e imposta l'indirizzo dello slave in UnitId. Il client costruisce il frame RTU con il suo CRC16 e attende lo slave.

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

Specifiche e riferimenti

Fonti autorevoli per il protocollo implementato da questo componente.

Domande sul client Modbus

I metodi accettano l'indirizzo di protocollo, che parte da 0. Il registro che molti manuali documentano come 40001 è l'holding register 0, quindi chiama ReadHoldingRegisters(0, 1).

Chiama ReadFloat32 con l'indirizzo del primo dei suoi due registri. Se il valore sembra errato, il dispositivo memorizza i byte in un altro ordine: imposta WordOrder sull'ordine usato dal dispositivo. Molti PLC memorizzano prima la low word, cioè mwoCDAB.

Ogni tentativo attende Timeout millisecondi. Dopo Retries + 1 tentativi senza una risposta valida la richiesta solleva EsgcModbusTimeout, con il codice funzione, l'unit id e il numero di tentativi nel messaggio.

No. Apri tu stesso TsgcSerialPort e lascia vuoto il suo evento OnData, perché il client legge le risposte con Read. Una richiesta solleva EsgcModbusError quando la porta non è assegnata, non è aperta o ha OnData assegnato.

È incluso in sgcWebSockets Enterprise (Delphi e .NET) e All-Access, come parte del pacchetto sgcIndustrial. In Delphi, aggiungi sgcIndustrial alla clausola uses.

Documentazione e demo

Link diretti al riferimento del componente, apri il progetto demo e leggi il documento tecnico.

Online Help: TsgcModbusTCPClient Riferimento completo di proprietà, metodi ed eventi del client Modbus TCP.
Online Help: TsgcModbusRTUClient Riferimento completo di proprietà, metodi ed eventi del client Modbus RTU.
Progetto demo: Industrial\02.Modbus_TCP_Client Un client Modbus TCP per Delphi, C++Builder e .NET. È incluso nel pacchetto sgcWebSockets.
Documento tecnico (PDF) Funzionalità, guida rapida, esempi di codice e riferimenti a fonti primarie solo per questo componente.
Manuale utente (PDF) Manuale completo che copre ogni componente della libreria.
La scelta più conveniente: All-AccessTutti i prodotti eSeGeCe, con Supporto Premium incluso, a partire da €1,059/anno.
Vedi i prezzi All-Access

Incluso in sgcWebSockets Enterprise

Incluso in sgcWebSockets Enterprise (Delphi e .NET) e All-Access, oppure nel pacchetto standalone sgcIndustrial.