Nowość

Komponent portu szeregowego dla Delphi na Windows, Linux i macOS

Jeden komponent niewizualny dla portów COM, adapterów USB-szeregowych i magistral RS-485. Odbieraj dane zdarzeniem lub odczytem blokującym, zapisuj z dowolnego wątku i uruchamiaj ten sam kod na Windows, Linux i macOS.

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

Komponent portu szeregowego, który działa tak samo wszędzie

Czytniki kodów kreskowych, wagi, odbiorniki GPS, modemy, przyrządy laboratoryjne i magistrale polowe RS-485, z jednej klasy Pascala.

Komponent portu szeregowego dla Delphi musi radzić sobie z trzema systemami operacyjnymi, które obsługują port szeregowy na różne sposoby: overlapped I/O i ustawienia DCB w Windows, termios i deskryptory plików w Linux i macOS. TsgcSerialPort ukrywa to wszystko za jednym zestawem właściwości (Port, BaudRate, DataBits, Parity, StopBits, FlowControl, RtsControl) i jednym zestawem wywołań, dzięki czemu aplikacja VCL, FMX, usługa lub aplikacja konsolowa otwiera COM3 w Windows i /dev/ttyUSB0 w Linux tym samym kodem.

Dane docierają do wątku odczytu działającego w tle. Przypisz OnData, aby dostawać każdą porcję jako zdarzenie, albo zostaw je puste, a bajty trafią do 64 KB bufora odbiorczego, który czytasz przez Read, z limitem czasu na pierwszy bajt i limitem czasu między znakami, który kończy komunikat. Zapisy są serializowane przez komponent, więc wysyłać może dowolny wątek.

Klasa komponentu

TsgcSerialPort, w jednostce sgcIndustrial

Nazwy portów

COM3, \\.\COM12, /dev/ttyUSB0 lub po prostu ttyUSB0

Parametry łącza

Od 5 do 8 bitów danych; parzystość: brak, nieparzysta, parzysta, mark lub space; 1, 1,5 lub 2 bity stopu; sterowanie przepływem RTS/CTS, DTR/DSR lub XON/XOFF

Platformy

Od Delphi 7 do Delphi 13 i C++Builder; Windows 32 i 64 bity, Linux 64 bity i macOS

Otwórz port, wyślij polecenie, odczytaj odpowiedź

Trzy sposoby użycia komponentu. Każdy przykład kompiluje się w Delphi 7 i Delphi 13.

uses
  SysUtils, sgcIndustrial; // Delphi 7 to 2006: add sgcBase_Helpers (TBytes)

procedure TForm1.FormCreate(Sender: TObject);
begin
  Serial := TsgcSerialPort.Create(Self);
  Serial.Port := 'COM3';         // '/dev/ttyUSB0' on Linux, '/dev/cu.usbserial-10' on macOS
  Serial.BaudRate := 115200;
  Serial.DataBits := 8;
  Serial.Parity := spNone;
  Serial.StopBits := ssOne;
  Serial.FlowControl := sfcNone;
  Serial.OnData := SerialData;   // a reader thread receives, the event is queued
  Serial.OnError := SerialError; // to the main thread (NotifyEvents)
  Serial.Active := True;
  Serial.WriteString('AT' + #13);
end;

procedure TForm1.SerialData(Sender: TObject; const aData: TBytes);
begin
  Memo1.Lines.Add(Format('%d bytes received', [Length(aData)]));
end;

procedure TForm1.SerialError(Sender: TObject; const aError: string);
begin
  Memo1.Lines.Add('error: ' + aError);
end;
procedure TForm1.btnQueryClick(Sender: TObject);
var
  vData: TBytes;
  vCount: Integer;
begin
  Serial.OnData := nil;    // without OnData, bytes go to the 64 KB receive buffer
  Serial.Port := 'COM5';
  Serial.BaudRate := 9600;
  Serial.Active := True;
  Serial.Purge;
  Serial.WriteString('MEAS?' + #13#10);
  // wait up to 1 s for the first byte, then return after 50 ms of silence
  // or when 256 bytes have arrived
  vCount := Serial.Read(vData, 256, 1000, 50);
  if vCount = 0 then
    Memo1.Lines.Add('timeout')
  else
    Memo1.Lines.Add(Format('%d bytes', [vCount]));
  Serial.Active := False;
end;
procedure TForm1.FormCreate(Sender: TObject);
begin
  // COM1, COM3, ... on Windows; /dev/ttyUSB0, /dev/ttyACM0, ... on Linux
  TsgcSerialPort.ListPorts(ComboBox1.Items);

  Serial := TsgcSerialPort.Create(Self);
  Serial.Port := 'COM4';
  Serial.BaudRate := 38400;
  Serial.Parity := spEven;
  Serial.RtsControl := srcToggle; // RS-485 half duplex: RTS on while sending
  Serial.WriteTimeout := 500;
  Serial.Active := True;

  Serial.SetDTR(True);
  if smsCTS in Serial.ModemStatus then
    Memo1.Lines.Add('CTS is on');
end;

Szczegóły, dzięki którym kod szeregowy jest niezawodny

Wątki, limity czasu, bufory i odłączone adaptery obsługiwane wewnątrz komponentu.

Zdarzenie lub odczyt blokujący

Gdy przypisano OnData, każda porcja odebrana przez wątek odczytu jest dostarczana jako zdarzenie. Bez niego Read(Data, MaxCount, Timeout, InterCharTimeout) czeka na pierwszy bajt, a potem wraca, gdy dotrze MaxCount bajtów albo linia pozostanie cicha przez czas między znakami: naturalny sposób odczytu jednej ramki odpowiedzi.

Zdarzenia w wybranym wątku

NotifyEvents domyślnie kolejkuje OnData, OnOpen, OnClose i OnError do głównego wątku, może je synchronizować albo wywoływać bezpośrednio w wątku odczytu, co daje najmniejsze opóźnienie.

Zapis z dowolnego wątku

Write i WriteString są serializowane wewnętrzną blokadą. Write zwraca liczbę zapisanych bajtów, WriteTimeout ogranicza czas oczekiwania, a WriteString wysyła bajty UTF-8 ciągu znaków i zgłasza wyjątek, jeśli nie udało się zapisać wszystkich.

Zamykanie z dowolnego miejsca

Close jest bezpieczne z dowolnego wątku, nawet z wnętrza obsługi OnData. Budzi zablokowany Read, anuluje zablokowany zapis i zatrzymuje wątek odczytu, korzystając z anulowania overlapped I/O w Windows oraz z flagi anulowania i poll w Linux i macOS.

Sterowanie kierunkiem RS-485

RtsControl := srcToggle podnosi RTS na czas nadawania portu i opuszcza go po jego zakończeniu, dzięki czemu transceiver RS-485 zwalnia magistralę na czas odpowiedzi. Windows używa trybu przełączania RTS ze sterownika, Linux trybu RS-485 jądra sterownika szeregowego.

Linie modemowe

SetDTR i SetRTS sterują liniami wyjściowymi; ModemStatus zwraca zbiór aktywnych wejść: smsCTS, smsDSR, smsRI i smsDCD.

Wykrywanie portów

TsgcSerialPort.ListPorts dodaje nazwy portów do dowolnego TStrings w kolejności naturalnej (COM2 przed COM10): z rejestru w Windows, /dev/ttyS*, /dev/ttyUSB* i /dev/ttyACM* w Linux oraz /dev/cu.* w macOS.

Bufory pod kontrolą

BufferCount podaje, ile bajtów czeka w 64 KB buforze odbiorczym, a Purge opróżnia go razem z buforami systemu operacyjnego. Jeśli bufor się przepełni, najstarsze bajty są odrzucane i OnError wywoływane jest jednorazowo.

Błędy z kodem systemowym

Każda awaria zgłasza EsgcSerialError, którego ErrorCode zawiera błąd Windows lub errno POSIX. Po odłączeniu adaptera USB OnError wywoływane jest jednorazowo, a port czeka na Close. W Linux i macOS port jest otwierany w trybie wyłącznym.

Co obsługuje każdy system operacyjny

Ustawienie, którego platforma nie obsługuje, zgłasza EsgcSerialError przy Open, zamiast być po cichu ignorowane.

FunkcjaWindowsLinuxmacOS
Prędkości transmisjiDowolna prędkość akceptowana przez sterownikStandardowe prędkości, od 50 do 4 000 000Standardowe prędkości, od 50 do 230 400
Parzystość mark i spaceTakTakNie
Sterowanie przepływem RTS/CTS i XON/XOFFTakTakTak
Sterowanie przepływem DTR/DSRTakNieNie
Przełączanie RTS dla RS-485Tak, tryb przełączania sterownikaTak, tryb RS-485 jądra (wymagana obsługa przez sterownik)Nie
Lista portówRejestr/dev/ttyS*, ttyUSB*, ttyACM*/dev/cu.*

Komponent został przetestowany na prawdziwym porcie COM w Windows (32 i 64 bity) oraz na pseudoterminalach w Linux 64 bity; ten sam kod kompiluje się dla macOS. Android i iOS nie są obsługiwane.

Transport dla Modbus RTU

TsgcSerialPort jest także linią szeregową pod komponentami Modbus RTU dla Delphi. Przypisz otwarty port do właściwości SerialPort komponentu TsgcModbusRTUClient, aby odpytywać urządzenia podrzędne na magistrali RS-485, albo komponentu TsgcModbusRTUServer, aby odpowiadać jako urządzenie podrzędne. Komponenty Modbus zajmują się przerwą ramki równą 3,5 znaku, sumą CRC i adresem urządzenia; port potrzebuje tylko ustawień linii magistrali, zwykle 19200 baudów, 8 bitów danych, parzystość parzysta i 1 bit stopu.

Pytania o port szeregowy w Delphi

Utwórz TsgcSerialPort, ustaw Port (na przykład COM3), BaudRate, DataBits, Parity i StopBits, a następnie ustaw Active := True lub wywołaj Open. Porty powyżej COM9 działają także ze zwykłą nazwą; komponent dodaje prefiks \\.\, którego wymaga Windows.

Zostaw OnData nieprzypisane i wywołaj Read(Data, MaxCount, Timeout, InterCharTimeout). Metoda czeka do Timeout milisekund na pierwszy bajt, a potem wraca, gdy dotrze MaxCount bajtów albo przez InterCharTimeout milisekund nie przyjdzie żaden bajt. Wynikiem jest liczba odczytanych bajtów, a 0 oznacza przekroczenie limitu czasu. Tylko jeden wątek naraz powinien wywoływać Read.

Tak, z każdym adapterem, który system operacyjny udostępnia jako port szeregowy: port COM w Windows, /dev/ttyUSB* lub /dev/ttyACM* w Linux, /dev/cu.* w macOS. Jeśli adapter zostanie odłączony przy otwartym porcie, OnError wywoływane jest jednorazowo; wywołaj Close i otwórz port ponownie, gdy adapter wróci.

Konwertery z automatycznym sterowaniem kierunkiem nie wymagają żadnego ustawienia. Dla konwerterów sterowanych przez RTS ustaw RtsControl := srcToggle: RTS jest podnoszony na czas nadawania portu i opuszczany po wysłaniu ostatniego bajtu. Windows robi to w sterowniku szeregowym, a Linux w trybie RS-485 jądra, który musi być obsługiwany przez sterownik szeregowy; w przeciwnym razie Open zgłasza czytelny EsgcSerialError.

Zapisy mogą pochodzić z dowolnego wątku i są serializowane przez komponent. Close można wywołać z dowolnego wątku, także z wątku odczytu wewnątrz obsługi zdarzenia. Odczyty są przeznaczone dla jednego wywołującego naraz, tak jak i tak działa protokół żądanie-odpowiedź na linii szeregowej.

Od Delphi 7 do Delphi 13 i C++Builder, na Windows 32 i 64 bity, Linux 64 bity i macOS. Android i iOS nie są obsługiwane.

TsgcSerialPort jest zawarty w sgcWebSockets Enterprise (Delphi i .NET) oraz All-Access, a także w samodzielnym pakiecie sgcIndustrial, razem z komponentami Modbus.

Więcej komponentów przemysłowych w sgcWebSockets

Dokumentacja portu szeregowego

Każda właściwość, metoda i zdarzenie TsgcSerialPort.

Komponenty przemysłowe

Port szeregowy, Modbus i OPC UA w jednej sekcji sgcWebSockets.

Delphi Modbus TCP i RTU

Klienty i serwery Modbus, które używają tego komponentu jako linii szeregowej.

C# Modbus dla .NET

Wersja .NET również ma TsgcSerialPort, obok komponentów Modbus.

Najkorzystniejsza oferta: All-AccessWszystkie produkty eSeGeCe, ze wsparciem Premium w cenie, już od €1,059 rocznie.
Zobacz cennik All-Access

Podłącz pierwsze urządzenie szeregowe z poziomu Delphi

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