Komponent portu szeregowego

Otwieraj porty RS-232 i RS-485 z Delphi, C++Builder i .NET. Skonfiguruj łącze, wysyłaj dane i odbieraj je w zdarzeniu lub przez odczyty blokujące, w systemach Windows, Linux i macOS.

Nowość

TsgcSerialPort

Port szeregowy z wątkiem czytającym w tle, 64 KB buforem odbiorczym i tym samym API w Delphi, C++Builder i C#. Jest też transportem klienta i serwera Modbus RTU.

Klasa komponentu

TsgcSerialPort

Interfejsy

Porty RS-232, RS-485 i adaptery USB do portu szeregowego

Platformy

Windows, Linux i macOS (bez Androida i iOS)

Edycja

W pakiecie sgcWebSockets Enterprise (Delphi i .NET) oraz All-Access, a także w samodzielnym pakiecie sgcIndustrial

Otwórz port i odbieraj dane

Ustaw nazwę portu i parametry łącza, przypisz zdarzenia i wywołaj Open. OnData otrzymuje każdy blok bajtów w chwili nadejścia.

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

Co jest w środku

Kompletny port szeregowy dla przyrządów, modemów, czytników kodów kreskowych, wag i magistral obiektowych.

Parametry łącza

BaudRate, DataBits (od 5 do 8), Parity (brak, nieparzysta, parzysta, mark, space), StopBits (1, 1.5, 2) i FlowControl (RTS/CTS lub XON/XOFF). Nieprawidłowe kombinacje zgłaszają EsgcSerialError przy otwarciu portu.

Zdarzenia lub odczyty blokujące

Gdy przypisano OnData, każdy blok bajtów trafia do zdarzenia. Bez niego bajty czekają w 64 KB buforze, a Read zwraca całą odpowiedź: czeka na pierwszy bajt i kończy po ciszy o wybranej długości.

Sterowanie kierunkiem RS-485

Ustaw RtsControl na srcToggle dla adapterów, które przełączają kierunek sygnałem RTS. W systemie Windows sterownik podnosi RTS na czas nadawania, a w systemie Linux włączany jest tryb RS-485 jądra. W .NET przełączaniem czasowo steruje komponent.

Porty i linie modemowe

TsgcSerialPort.ListPorts wyświetla porty w naturalnej kolejności (COM2 przed COM10). SetDTR, SetRTS i ModemStatus ustawiają i odczytują linie modemowe.

Bezpieczny wątkowo

Write można wywołać z dowolnego wątku. Close działa z dowolnego wątku, także z procedury obsługi zdarzenia, i budzi zablokowany Read. W Delphi i C++Builder zdarzenia są domyślnie kolejkowane do wątku głównego, a NotifyEvents to zmienia.

Czytelne błędy

Każda awaria zgłasza EsgcSerialError, którego ErrorCode zawiera kod błędu systemu operacyjnego, gdy system go podał. Urządzenie odłączone przy otwartym porcie lub pełny bufor odbiorczy wywołują OnError.

Wyślij polecenie, odczytaj odpowiedź

Zostaw OnData puste, zapisz polecenie i wywołaj Read: czeka do 1000 ms na pierwszy bajt i wraca, gdy urządzenie milczy przez 50 ms.

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

Specyfikacje i źródła

Interfejsy systemu operacyjnego, na których zbudowany jest ten komponent.

Pytania o port szeregowy

W Delphi i C++Builder działa w systemie Windows (Win32 i Win64) z API komunikacji Win32 oraz w systemach Linux64 i macOS z POSIX termios. Nie jest dostępny na Androidzie i iOS. Wersja .NET jest zbudowana na System.IO.Ports.

Użyj OnData dla urządzeń, które same wysyłają dane, takich jak czytnik kodów kreskowych lub waga. Użyj Read dla protokołów żądanie i odpowiedź: wyślij polecenie, a potem czytaj, aż urządzenie przestanie nadawać. Obie metody wykluczają się: Read zgłasza EsgcSerialError, gdy przypisano OnData, a tylko jeden wątek może jednocześnie wywołać Read.

Adapter, który przełącza kierunek automatycznie, nie wymaga żadnych ustawień. Adapter, który przełącza kierunek linią RTS, wymaga ustawienia RtsControl na srcToggle. W systemie Linux komponent włącza wtedy tryb RS-485 sterownika i zgłasza EsgcSerialError, gdy sterownik go nie obsługuje. macOS nie obsługuje srcToggle.

Wchodzi w skład sgcWebSockets Enterprise (Delphi i .NET) oraz All-Access, jako część pakietu sgcIndustrial. W Delphi dodaj sgcIndustrial do klauzuli uses.

Dokumentacja i wersje demo

Przejdź do dokumentacji komponentu, otwórz projekt demo i przeczytaj dokument techniczny.

Online Help: TsgcSerialPort Pełna dokumentacja właściwości, metod i zdarzeń tego komponentu.
Projekt demo: Industrial\01.Serial_Port Terminal szeregowy dla Delphi, C++Builder i .NET. Jest dołączony do pakietu sgcWebSockets.
Dokument techniczny (PDF) Funkcje, szybki start, przykłady kodu i podstawowe źródła tylko dla tego komponentu.
Podręcznik użytkownika (PDF) Kompleksowy podręcznik obejmujący każdy komponent biblioteki.
Najkorzystniejsza oferta: All-AccessWszystkie produkty eSeGeCe, ze wsparciem Premium w cenie, już od €1,059 rocznie.
Zobacz cennik All-Access

W pakiecie sgcWebSockets Enterprise

W pakiecie sgcWebSockets Enterprise (Delphi i .NET) oraz All-Access, a także w samodzielnym pakiecie sgcIndustrial.