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

TsgcSerialPort

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.

Komponentenklasse

TsgcSerialPort

Schnittstellen

RS-232, RS-485 und USB-Seriell-Adapter

Plattformen

Windows, Linux und macOS (nicht Android oder iOS)

Edition

Enthalten in sgcWebSockets Enterprise (Delphi und .NET) und All-Access oder im eigenständigen Paket sgcIndustrial

Einen Port öffnen und Daten empfangen

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);
    }
}

Was steckt drin

Ein vollständiger Serial Port für Messgeräte, Modems, Barcodeleser, Waagen und Feldbusse.

Leitungseinstellungen

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.

Ereignisse oder blockierende Lesevorgänge

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.

RS-485-Richtungssteuerung

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.

Ports und Modemleitungen

TsgcSerialPort.ListPorts listet die Ports in natürlicher Reihenfolge (COM2 vor COM10). SetDTR, SetRTS und ModemStatus steuern und lesen die Modemleitungen.

Threadsicher

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.

Klare Fehler

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.

Einen Befehl senden, die Antwort lesen

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");
    }
}

Spezifikationen & Referenzen

Die Schnittstellen des Betriebssystems, auf denen diese Komponente aufbaut.

Fragen zum Serial Port

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.

Dokumentation & Demos

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.
Demoprojekt: Industrial\01.Serial_Port Ein serielles Terminal für Delphi, C++Builder und .NET. Es wird im Paket sgcWebSockets mitgeliefert.
Technisches Dokument (PDF) Funktionen, Schnellstart, Code-Beispiele und Primärquellen nur für diese Komponente.
Benutzerhandbuch (PDF) Umfassendes Handbuch, das jede Komponente der Bibliothek abdeckt.
Bestes Preis-Leistungs-Verhältnis: All-AccessAlle eSeGeCe-Produkte, inklusive Premium-Support, ab €1,059 pro Jahr.
All-Access-Preise ansehen

Enthalten in sgcWebSockets Enterprise

Enthalten in sgcWebSockets Enterprise (Delphi und .NET) und All-Access oder im eigenständigen Paket sgcIndustrial.