Modbus TCP en RTU-client
Lees en schrijf de coils en registers van PLC's, energiemeters en aandrijvingen vanuit Delphi, C++Builder en .NET, via TCP/IP of via een seriële RS-232- of RS-485-lijn.
Nieuw
Lees en schrijf de coils en registers van PLC's, energiemeters en aandrijvingen vanuit Delphi, C++Builder en .NET, via TCP/IP of via een seriële RS-232- of RS-485-lijn.
Nieuw
Twee clients met dezelfde methoden: de ene verbindt met een Modbus TCP-apparaat of gateway, de andere is een Modbus RTU-master op een seriële lijn.
TsgcModbusTCPClientTsgcModbusRTUClient
Modbus Application Protocol V1.1b3, Modbus TCP en Modbus RTU
TCP: elk platform van sgcWebSockets. RTU: Windows, Linux en macOS
Inbegrepen in sgcWebSockets Enterprise (Delphi en .NET) en All-Access, of in het standalone pakket sgcIndustrial
Stel Host en UnitId in, zet Active op True en roep de methoden aan. Elk verzoek blokkeert tot het bijbehorende antwoord binnenkomt en veroorzaakt een exception wanneer het apparaat een fout meldt of niet antwoordt.
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);
}
}
De framing, timing en foutafhandeling van Modbus worden door de component gedaan, zodat je code alleen met adressen en waarden werkt.
01 tot en met 06, 15, 16, 22 (mask write), 23 (read/write multiple registers) en 43/14 (apparaatidentificatie, met paginering). De RTU-client voegt 07 (read exception status) en 08 (diagnostics) toe.
ReadInt32, ReadUInt32, ReadFloat32, ReadString en hun schrijfequivalenten, plus reads van input registers. WordOrder kiest ABCD, DCBA, BADC of CDAB passend bij het apparaat.
Roep de methoden aan vanuit elke thread: de verzoeken worden geserialiseerd en elk antwoord wordt gekoppeld via zijn transactie-id. Timeout geldt voor elke poging en Retries voegt extra pogingen toe.
Een Modbus-exceptionantwoord veroorzaakt EsgcModbusException met de exception- en functiecodes, een ontbrekend antwoord veroorzaakt EsgcModbusTimeout, en elk ander probleem veroorzaakt EsgcModbusError. Hoeveelheden buiten de specificatie worden geweigerd voordat er iets wordt verzonden.
De TCP-client ondersteunt TLS, Proxy en WatchDog voor automatisch opnieuw verbinden. Een verzoek dat wacht wanneer de verbinding wegvalt, veroorzaakt meteen een fout, zonder op de timeout te wachten.
Elke methode heeft een overload met een unit-id vooraan, zodat één TCP-verbinding alle apparaten achter een Modbus TCP-naar-RTU-gateway bereikt zonder UnitId te wijzigen.
Open een TsgcSerialPort, koppel die met SerialPort en stel het slave-adres in via UnitId. De client bouwt het RTU-frame met zijn CRC16 en wacht op de 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);
}
}
TurnaroundDelay
Gezaghebbende bronnen voor het protocol dat deze component implementeert.
De methoden gebruiken het protocoladres, dat bij 0 begint. Het register dat veel handleidingen als 40001 documenteren, is holding register 0, dus roep ReadHoldingRegisters(0, 1) aan.
Roep ReadFloat32 aan met het adres van het eerste van de twee registers. Als de waarde er verkeerd uitziet, slaat het apparaat de bytes in een andere volgorde op: zet WordOrder op de volgorde die het apparaat gebruikt. Veel PLC's slaan eerst het low word op, wat mwoCDAB is.
Elke poging wacht Timeout milliseconden. Na Retries + 1 pogingen zonder geldig antwoord veroorzaakt het verzoek EsgcModbusTimeout, met de functiecode, het unit-id en het aantal pogingen in het bericht.
Nee. Open de TsgcSerialPort zelf en laat het event OnData leeg, omdat de client de antwoorden met Read leest. Een verzoek veroorzaakt EsgcModbusError wanneer de poort niet is toegewezen, niet open is of OnData toegewezen heeft.
Het is inbegrepen in sgcWebSockets Enterprise (Delphi en .NET) en All-Access, als onderdeel van het sgcIndustrial-pakket. Voeg in Delphi sgcIndustrial toe aan de uses-clausule.
Spring direct naar de componentreferentie, open het demoproject en lees het technische document.
| Online Help: TsgcModbusTCPClient Volledige referentie van eigenschappen, methoden en events voor de Modbus TCP-client. | Openen | |
| Online Help: TsgcModbusRTUClient Volledige referentie van eigenschappen, methoden en events voor de Modbus RTU-client. | Openen | |
| Demoproject: Industrial\02.Modbus_TCP_Client Een Modbus TCP-client voor Delphi, C++Builder en .NET. Wordt meegeleverd in het sgcWebSockets-pakket. | Openen | |
| Technisch document (PDF) Functies, snelstart, codevoorbeelden en primaire bronnen voor alleen deze component. | Openen | |
| Gebruikershandleiding (PDF) Uitgebreide handleiding die elke component in de bibliotheek behandelt. | Openen |