Modbus TCP ve RTU İstemcisi

Delphi, C++Builder ve .NET'ten PLC'lerin, enerji sayaçlarının ve sürücülerin bobinlerini ve yazmaçlarını TCP/IP üzerinden ya da bir RS-232 veya RS-485 seri hattı üzerinden okuyun ve yazın.

Yeni

TsgcModbusTCPClient ve TsgcModbusRTUClient

Aynı metotlara sahip iki istemci: biri bir Modbus TCP cihazına ya da ağ geçidine bağlanır, diğeri seri hat üzerinde bir Modbus RTU ana cihazıdır.

Bileşen sınıfları

TsgcModbusTCPClient
TsgcModbusRTUClient

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

Modbus TCP üzerinden bağlanın, okuyun ve yazın

Host ve UnitId değerlerini ayarlayın, Active değerini True yapın ve metotları çağırın. Her istek, eşleşen yanıt gelene kadar engeller ve cihaz bir hata bildirdiğinde ya da yanıt vermediğinde bir istisna oluşturur.

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

İçeriğinde neler var

Modbus'ın çerçevelemesini, zamanlamasını ve hata işlemesini bileşen yapar, bu yüzden kodunuz yalnızca adreslerle ve değerlerle ilgilenir.

İşlev kodları

01 ile 06 arası, 15, 16, 22 (maske yazma), 23 (birden çok yazmaç okuma/yazma) ve 43/14 (cihaz tanımlama, sayfalama ile). RTU istemcisi ayrıca 07 (istisna durumunu okuma) ve 08 (tanılama) ekler.

Tipli değerler

ReadInt32, ReadUInt32, ReadFloat32, ReadString ve bunların yazma karşılıkları, ayrıca giriş yazmaçlarından okumalar. WordOrder, cihaza uymak için ABCD, DCBA, BADC veya CDAB sırasını seçer.

İş parçacığı güvenli istekler

Metotları herhangi bir iş parçacığından çağırın: istekler sıraya alınır ve her yanıt işlem kimliğiyle eşleştirilir. Timeout her denemeye uygulanır ve Retries ek denemeler ekler.

Açık hatalar

Bir Modbus istisna yanıtı, istisna ve işlev kodlarıyla EsgcModbusException oluşturur, yanıt gelmemesi EsgcModbusTimeout oluşturur ve diğer her sorun EsgcModbusError oluşturur. Spesifikasyon dışındaki miktarlar hiçbir şey gönderilmeden önce reddedilir.

TLS, proxy ve yeniden bağlanma

TCP istemcisi, otomatik yeniden bağlanma için TLS, Proxy ve WatchDog özelliklerini destekler. Bağlantı koptuğunda bekleyen bir istek, zaman aşımını beklemeden hemen istisna oluşturur.

Ağ geçitleri ve birim kimlikleri

Her metodun başında bir birim kimliği olan bir aşırı yüklemesi vardır, böylece tek bir TCP bağlantısı, UnitId değiştirilmeden bir Modbus TCP - RTU ağ geçidinin arkasındaki tüm cihazlara ulaşır.

RS-232 ve RS-485 üzerinde bir RTU ana cihazı

Bir TsgcSerialPort açın, SerialPort ile bağlayın ve köle adresini UnitId içine yazın. İstemci, CRC16'lı RTU çerçevesini oluşturur ve köleyi bekler.

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

Spesifikasyonlar ve referanslar

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

Modbus istemcisi soruları

Metotlar, 0'dan başlayan protokol adresini alır. Birçok kılavuzda 40001 olarak belgelenen yazmaç, 0 numaralı tutma yazmacıdır, bu yüzden ReadHoldingRegisters(0, 1) çağırın.

İki yazmacından ilkinin adresiyle ReadFloat32 çağırın. Değer yanlış görünüyorsa cihaz baytları başka bir sırayla saklıyordur: WordOrder değerini cihazın kullandığı sıraya ayarlayın. Birçok PLC önce düşük sözcüğü saklar, bu mwoCDAB değeridir.

Her deneme Timeout milisaniye bekler. Geçerli yanıt olmadan Retries + 1 denemeden sonra istek, mesajında işlev kodu, birim kimliği ve deneme sayısıyla birlikte EsgcModbusTimeout oluşturur.

Hayır. TsgcSerialPort bileşenini kendiniz açın ve OnData olayını boş bırakın, çünkü istemci yanıtları Read ile okur. Port atanmamışsa, açık değilse ya da OnData atanmışsa istek EsgcModbusError oluşturur.

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: TsgcModbusTCPClient Modbus TCP istemcisi için tam özellik, metot ve olay referansı.
Online Help: TsgcModbusRTUClient Modbus RTU istemcisi için tam özellik, metot ve olay referansı.
Demo Projesi: Industrial\02.Modbus_TCP_Client Delphi, C++Builder ve .NET için bir Modbus TCP istemcisi. 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.