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ść
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ść
Dwa klienty z tymi samymi metodami: jeden łączy się z urządzeniem lub bramką Modbus TCP, drugi jest masterem Modbus RTU na łączu szeregowym.
TsgcModbusTCPClientTsgcModbusRTUClient
Modbus Application Protocol V1.1b3, Modbus TCP i Modbus RTU
TCP: każda platforma sgcWebSockets. RTU: Windows, Linux i macOS
W pakiecie sgcWebSockets Enterprise (Delphi i .NET) oraz All-Access, a także w samodzielnym pakiecie sgcIndustrial
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);
}
}
Ramkowanie, taktowanie i obsługę błędów Modbus wykonuje komponent, więc Twój kod zajmuje się tylko adresami i wartościami.
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).
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.
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.
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.
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.
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.
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);
}
}
TurnaroundDelay
Autorytatywne źródła dla protokołu implementowanego przez ten komponent.
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.
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. | Otwórz | |
| Online Help: TsgcModbusRTUClient Pełna dokumentacja właściwości, metod i zdarzeń klienta Modbus RTU. | Otwórz | |
| Projekt demo: Industrial\02.Modbus_TCP_Client Klient Modbus TCP dla Delphi, C++Builder i .NET. Jest dołączony do pakietu sgcWebSockets. | Otwórz | |
| Dokument techniczny (PDF) Funkcje, szybki start, przykłady kodu i podstawowe źródła tylko dla tego komponentu. | Otwórz | |
| Podręcznik użytkownika (PDF) Kompleksowy podręcznik obejmujący każdy komponent biblioteki. | Otwórz |