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à
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à
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.
TsgcModbusTCPClientTsgcModbusRTUClient
Modbus Application Protocol V1.1b3, Modbus TCP e Modbus RTU
TCP: tutte le piattaforme di sgcWebSockets. RTU: Windows, Linux e macOS
Incluso in sgcWebSockets Enterprise (Delphi e .NET) e All-Access, oppure nel pacchetto standalone sgcIndustrial
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);
}
}
Framing, temporizzazione e gestione degli errori di Modbus sono a carico del componente, così il tuo codice si occupa solo di indirizzi e valori.
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).
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.
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.
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.
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.
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.
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);
}
}
TurnaroundDelay
Fonti autorevoli per il protocollo implementato da questo componente.
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.
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. | Apri | |
| Online Help: TsgcModbusRTUClient Riferimento completo di proprietà, metodi ed eventi del client Modbus RTU. | Apri | |
| Progetto demo: Industrial\02.Modbus_TCP_Client Un client Modbus TCP per Delphi, C++Builder e .NET. È incluso nel pacchetto sgcWebSockets. | Apri | |
| Documento tecnico (PDF) Funzionalità, guida rapida, esempi di codice e riferimenti a fonti primarie solo per questo componente. | Apri | |
| Manuale utente (PDF) Manuale completo che copre ogni componente della libreria. | Apri |