Serial-Port-Komponente
Öffne RS-232- und RS-485-Ports aus Delphi, C++Builder und .NET. Konfiguriere die Leitung, schreibe Daten und empfange sie in einem Ereignis oder mit blockierenden Lesevorgängen, unter Windows, Linux und macOS.
Neu
Öffne RS-232- und RS-485-Ports aus Delphi, C++Builder und .NET. Konfiguriere die Leitung, schreibe Daten und empfange sie in einem Ereignis oder mit blockierenden Lesevorgängen, unter Windows, Linux und macOS.
Neu
Ein Serial Port mit Hintergrund-Lesethread, einem 64-KB-Empfangspuffer und derselben API in Delphi, C++Builder und C#. Er ist auch der Transport des Modbus RTU Clients und Servers.
TsgcSerialPort
RS-232, RS-485 und USB-Seriell-Adapter
Windows, Linux und macOS (nicht Android oder iOS)
Enthalten in sgcWebSockets Enterprise (Delphi und .NET) und All-Access oder im eigenständigen Paket sgcIndustrial
Setze den Portnamen und die Leitungseinstellungen, weise die Ereignisse zu und rufe Open auf. OnData empfängt jeden Byte-Block, sobald er ankommt.
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);
}
}
Ein vollständiger Serial Port für Messgeräte, Modems, Barcodeleser, Waagen und Feldbusse.
BaudRate, DataBits (5 bis 8), Parity (none, odd, even, mark, space), StopBits (1, 1.5, 2) und FlowControl (RTS/CTS oder XON/XOFF). Ungültige Kombinationen lösen beim Öffnen des Ports EsgcSerialError aus.
Ist OnData zugewiesen, geht jeder Byte-Block an das Ereignis. Ohne Ereignis warten die Bytes in einem 64-KB-Puffer, und Read liefert eine ganze Antwort: Es wartet auf das erste Byte und endet nach einer Stille, die du festlegst.
Setze RtsControl auf srcToggle für Adapter, die die Richtung über RTS umschalten. Unter Windows setzt der Treiber RTS während der Übertragung, und unter Linux wird der RS-485-Modus des Kernels aktiviert. In .NET wird das Umschalten von der Komponente zeitlich gesteuert.
TsgcSerialPort.ListPorts listet die Ports in natürlicher Reihenfolge (COM2 vor COM10). SetDTR, SetRTS und ModemStatus steuern und lesen die Modemleitungen.
Write kann aus jedem Thread aufgerufen werden. Close funktioniert aus jedem Thread, auch aus einem Ereignis-Handler, und weckt ein blockiertes Read. In Delphi und C++Builder werden die Ereignisse standardmäßig in den Hauptthread eingereiht, und NotifyEvents ändert das.
Jeder Fehler löst EsgcSerialError aus, dessen ErrorCode den Fehlercode des Betriebssystems enthält, wenn das System einen gemeldet hat. Ein Gerät, das bei geöffnetem Port abgesteckt wird, oder ein voller Empfangspuffer löst OnError aus.
Lass OnData leer, schreibe den Befehl und rufe Read auf: Es wartet bis zu 1000 ms auf das erste Byte und kehrt zurück, wenn das Gerät 50 ms lang still war.
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");
}
}
Die Schnittstellen des Betriebssystems, auf denen diese Komponente aufbaut.
In Delphi und C++Builder funktioniert sie unter Windows (Win32 und Win64) mit der Win32-Kommunikations-API sowie unter Linux64 und macOS mit POSIX termios. Unter Android und iOS ist sie nicht verfügbar. Die .NET Version basiert auf System.IO.Ports.
Verwende OnData für Geräte, die von selbst Daten senden, etwa Barcodeleser oder Waagen. Verwende Read für Anfrage-Antwort-Protokolle: Sende den Befehl und lies, bis das Gerät nicht mehr sendet. Beide schließen sich aus: Read löst EsgcSerialError aus, solange OnData zugewiesen ist, und nur ein Thread darf gleichzeitig Read aufrufen.
Ein Adapter, der die Richtung automatisch umschaltet, braucht keine Einstellung. Ein Adapter, der die Richtung über die RTS-Leitung umschaltet, braucht RtsControl mit dem Wert srcToggle. Unter Linux aktiviert die Komponente dann den RS-485-Modus des Treibers und löst EsgcSerialError aus, wenn der Treiber ihn nicht unterstützt. macOS unterstützt srcToggle nicht.
Sie ist in sgcWebSockets Enterprise (Delphi und .NET) und All-Access enthalten, als Teil des Pakets sgcIndustrial. Füge in Delphi sgcIndustrial zur uses-Klausel hinzu.
Springe direkt zur Komponentenreferenz, öffne das Demoprojekt und lies das technische Dokument.
| Online Help: TsgcSerialPort Vollständige Referenz zu Eigenschaften, Methoden und Ereignissen dieser Komponente. | Öffnen | |
| Demoprojekt: Industrial\01.Serial_Port Ein serielles Terminal für Delphi, C++Builder und .NET. Es wird im Paket sgcWebSockets mitgeliefert. | Öffnen | |
| Technisches Dokument (PDF) Funktionen, Schnellstart, Code-Beispiele und Primärquellen nur für diese Komponente. | Öffnen | |
| Benutzerhandbuch (PDF) Umfassendes Handbuch, das jede Komponente der Bibliothek abdeckt. | Öffnen |