Seriële poort-component
Open RS-232- en RS-485-poorten vanuit Delphi, C++Builder en .NET. Configureer de lijn, schrijf gegevens en ontvang ze in een event of met blokkerende reads, op Windows, Linux en macOS.
Nieuw
Open RS-232- en RS-485-poorten vanuit Delphi, C++Builder en .NET. Configureer de lijn, schrijf gegevens en ontvang ze in een event of met blokkerende reads, op Windows, Linux en macOS.
Nieuw
Een seriële poort met een lezende achtergrondthread, een ontvangstbuffer van 64 KB en dezelfde API in Delphi, C++Builder en C#. Het is ook het transport van de Modbus RTU-client en -server.
TsgcSerialPort
RS-232, RS-485 en USB-seriële adapters
Windows, Linux en macOS (niet Android of iOS)
Inbegrepen in sgcWebSockets Enterprise (Delphi en .NET) en All-Access, of in het standalone pakket sgcIndustrial
Stel de poortnaam en de lijninstellingen in, wijs de events toe en roep Open aan. OnData ontvangt elk blok bytes zodra het binnenkomt.
uses
sgcIndustrial;
procedure TForm1.OpenPort;
begin
FPort := TsgcSerialPort.Create(Self);
FPort.Port := 'COM3';
FPort.BaudRate := 19200;
FPort.DataBits := 8;
FPort.Parity := spEven;
FPort.StopBits := ssOne;
FPort.OnData := OnSerialData;
FPort.OnError := OnSerialError;
FPort.Open;
FPort.WriteString('AT' + #13);
end;
procedure TForm1.OnSerialData(Sender: TObject; const aData: TBytes);
begin
// queued to the main thread by default (NotifyEvents = neAsynchronous)
Memo1.Lines.Add(IntToStr(Length(aData)) + ' bytes received');
end;
procedure TForm1.OnSerialError(Sender: TObject; const aError: string);
begin
Memo1.Lines.Add('Error: ' + aError);
end;
#include "sgcIndustrial.hpp"
void __fastcall TForm1::OpenPort()
{
FPort = new TsgcSerialPort(this);
FPort->Port = "COM3";
FPort->BaudRate = 19200;
FPort->DataBits = 8;
FPort->Parity = spEven;
FPort->StopBits = ssOne;
FPort->OnData = OnSerialData;
FPort->OnError = OnSerialError;
FPort->Open();
FPort->WriteString("AT\r");
}
void __fastcall TForm1::OnSerialData(TObject *Sender, const TBytes aData)
{
// queued to the main thread by default (NotifyEvents = neAsynchronous)
Memo1->Lines->Add(IntToStr(aData.Length) + " bytes received");
}
void __fastcall TForm1::OnSerialError(TObject *Sender, const String aError)
{
Memo1->Lines->Add("Error: " + aError);
}
using System;
using esegece.sgcWebSockets;
class SerialTerminal
{
TsgcSerialPort FPort = new TsgcSerialPort();
public void OpenPort()
{
FPort.Port = "COM3";
FPort.BaudRate = 19200;
FPort.DataBits = 8;
FPort.Parity = TsgcSerialParity.spEven;
FPort.StopBits = TsgcSerialStopBits.ssOne;
FPort.OnData += OnSerialData;
FPort.OnError += OnSerialError;
FPort.Open();
FPort.WriteString("AT\r");
}
void OnSerialData(object Sender, byte[] aData)
{
Console.WriteLine(aData.Length + " bytes received");
}
void OnSerialError(object Sender, string aError)
{
Console.WriteLine("Error: " + aError);
}
}
Een complete seriële poort voor instrumenten, modems, barcodelezers, weegschalen en veldbussen.
BaudRate, DataBits (5 tot 8), Parity (none, odd, even, mark, space), StopBits (1, 1.5, 2) en FlowControl (RTS/CTS of XON/XOFF). Ongeldige combinaties veroorzaken EsgcSerialError zodra de poort opent.
Met OnData toegewezen gaat elk blok bytes naar het event. Zonder OnData wachten de bytes in een buffer van 64 KB en geeft Read een volledig antwoord terug: het wacht op de eerste byte en eindigt na een stilte die je zelf kiest.
Stel RtsControl in op srcToggle voor adapters die de richting met RTS omschakelen. Op Windows zet de driver RTS hoog tijdens het verzenden en op Linux wordt de RS-485-modus van de kernel ingeschakeld. In .NET wordt de toggle door de component getimed.
TsgcSerialPort.ListPorts toont de poorten in natuurlijke volgorde (COM2 voor COM10). SetDTR, SetRTS en ModemStatus sturen de modemlijnen aan en lezen ze uit.
Write kan vanuit elke thread worden aangeroepen. Close werkt vanuit elke thread, ook vanuit een eventhandler, en maakt een blokkerende Read wakker. In Delphi en C++Builder worden de events standaard in de wachtrij van de hoofdthread geplaatst, en NotifyEvents verandert dat.
Elke fout veroorzaakt EsgcSerialError, waarvan ErrorCode de foutcode van het besturingssysteem bevat wanneer het systeem er een meldde. Een apparaat dat wordt losgekoppeld terwijl de poort open is, of een volle ontvangstbuffer, activeert OnError.
Laat OnData leeg, schrijf de opdracht en roep Read aan: het wacht maximaal 1000 ms op de eerste byte en geeft het resultaat terug zodra het apparaat 50 ms stil is geweest.
procedure TForm1.QueryDevice;
var
vData: TBytes;
vCount: Integer;
begin
// OnData is not assigned: the bytes wait in the receive buffer for Read
FPort.Purge;
FPort.WriteString('*IDN?' + #10);
// wait up to 1000 ms for the first byte, the reply ends after 50 ms of silence
vCount := FPort.Read(vData, 256, 1000, 50);
if vCount = 0 then
Memo1.Lines.Add('No reply')
else
Memo1.Lines.Add(IntToStr(vCount) + ' bytes read');
end;
void __fastcall TForm1::QueryDevice()
{
// OnData is not assigned: the bytes wait in the receive buffer for Read
FPort->Purge();
FPort->WriteString("*IDN?\n");
// wait up to 1000 ms for the first byte, the reply ends after 50 ms of silence
TBytes vData;
int vCount = FPort->Read(vData, 256, 1000, 50);
if (vCount == 0)
Memo1->Lines->Add("No reply");
else
Memo1->Lines->Add(IntToStr(vCount) + " bytes read");
}
using System;
using esegece.sgcWebSockets;
class SerialQuery
{
TsgcSerialPort FPort = new TsgcSerialPort();
public void QueryDevice()
{
// OnData is not assigned: the bytes wait in the receive buffer for Read
FPort.Port = "COM3";
FPort.Open();
FPort.Purge();
FPort.WriteString("*IDN?\n");
// wait up to 1000 ms for the first byte, the reply ends after 50 ms of silence
byte[] vData = FPort.Read(256, 1000, 50);
if (vData.Length == 0)
Console.WriteLine("No reply");
else
Console.WriteLine(vData.Length + " bytes read");
}
}
De interfaces van het besturingssysteem waarop deze component is gebouwd.
In Delphi en C++Builder werkt hij op Windows (Win32 en Win64) met de Win32-communicatie-API, en op Linux64 en macOS met POSIX termios. Hij is niet beschikbaar op Android en iOS. De .NET-versie is gebouwd op System.IO.Ports.
Gebruik OnData voor apparaten die zelf gegevens sturen, zoals een barcodelezer of een weegschaal. Gebruik Read voor verzoek-en-antwoordprotocollen: stuur de opdracht en lees tot het apparaat stopt met verzenden. De twee sluiten elkaar uit: Read veroorzaakt EsgcSerialError zolang OnData is toegewezen, en slechts één thread mag tegelijk Read aanroepen.
Een adapter die de richting automatisch omschakelt, heeft geen instelling nodig. Een adapter die de richting met de RTS-lijn omschakelt, heeft RtsControl op srcToggle nodig. Op Linux schakelt de component dan de RS-485-modus van de driver in en veroorzaakt EsgcSerialError wanneer de driver dit niet ondersteunt. macOS ondersteunt srcToggle niet.
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: TsgcSerialPort Volledige referentie van eigenschappen, methoden en events voor deze component. | Openen | |
| Demoproject: Industrial\01.Serial_Port Een seriële terminal 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 |