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
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
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.
TsgcModbusTCPClientTsgcModbusRTUClient
Modbus Application Protocol V1.1b3, Modbus TCP ve Modbus RTU
TCP: sgcWebSockets'in tüm platformları. RTU: Windows, Linux ve macOS
sgcWebSockets Enterprise (Delphi ve .NET) ve All-Access ya da bağımsız sgcIndustrial paketi içinde yer alır
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);
}
}
Modbus'ın çerçevelemesini, zamanlamasını ve hata işlemesini bileşen yapar, bu yüzden kodunuz yalnızca adreslerle ve değerlerle ilgilenir.
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.
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.
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.
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.
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.
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.
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);
}
}
TurnaroundDelay beklemesi
Bu bileşenin uyguladığı protokol için yetkili kaynaklar.
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.
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ı. | Aç | |
| Online Help: TsgcModbusRTUClient Modbus RTU istemcisi için tam özellik, metot ve olay referansı. | Aç | |
| Demo Projesi: Industrial\02.Modbus_TCP_Client Delphi, C++Builder ve .NET için bir Modbus TCP istemcisi. sgcWebSockets paketinin içinde gelir. | Aç | |
| Teknik Belge (PDF) Yalnızca bu bileşene ait özellikler, hızlı başlangıç, kod örnekleri ve birincil kaynak başvuruları. | Aç | |
| Kullanıcı Kılavuzu (PDF) Kütüphanedeki her bileşeni kapsayan kapsamlı kılavuz. | Aç |