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ść
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ść
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.
TsgcSerialPort
Porty RS-232, RS-485 i adaptery USB do portu szeregowego
Windows, Linux i macOS (bez Androida i iOS)
W pakiecie sgcWebSockets Enterprise (Delphi i .NET) oraz All-Access, a także w samodzielnym pakiecie sgcIndustrial
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);
}
}
Kompletny port szeregowy dla przyrządów, modemów, czytników kodów kreskowych, wag i magistral obiektowych.
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.
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.
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.
TsgcSerialPort.ListPorts wyświetla porty w naturalnej kolejności (COM2 przed COM10). SetDTR, SetRTS i ModemStatus ustawiają i odczytują linie modemowe.
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.
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.
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");
}
}
Interfejsy systemu operacyjnego, na których zbudowany jest ten komponent.
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.
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. | Otwórz | |
| Projekt demo: Industrial\01.Serial_Port Terminal szeregowy dla Delphi, C++Builder i .NET. Jest dołączony do pakietu sgcWebSockets. | Otwórz | |
| Dokument techniczny (PDF) Funkcje, szybki start, przykłady kodu i podstawowe źródła tylko dla tego komponentu. | Otwórz | |
| Podręcznik użytkownika (PDF) Kompleksowy podręcznik obejmujący każdy komponent biblioteki. | Otwórz |