Yeni

Windows, Linux ve macOS için Delphi Seri Port Bileşeni

COM portları, USB seri adaptörler ve RS-485 hatları için görsel olmayan tek bir bileşen. Bir olayla veya engelleyen bir okumayla veri alın, herhangi bir iş parçacığından yazın ve aynı kodu Windows, Linux ve macOS üzerinde çalıştırın.

sgcWebSockets Enterprise (Delphi ve .NET) ve All-Access ya da bağımsız sgcIndustrial paketi içinde yer alır.

Her yerde aynı davranan bir seri port bileşeni

Barkod okuyucular, teraziler, GPS alıcıları, modemler, laboratuvar cihazları ve RS-485 saha veriyolları, tek bir Pascal sınıfından.

Bir Delphi seri port bileşeni, seri G/Ç'yi birbirinden farklı yapan üç işletim sistemiyle uğraşmak zorundadır: Windows'ta overlapped G/Ç ve DCB ayarları, Linux ve macOS'ta termios ve dosya tanımlayıcıları. TsgcSerialPort bunların hepsini tek bir özellik kümesinin (Port, BaudRate, DataBits, Parity, StopBits, FlowControl, RtsControl) ve tek bir çağrı kümesinin arkasına gizler. Böylece bir VCL, FMX, servis veya konsol uygulaması aynı kodla Windows'ta COM3, Linux'ta /dev/ttyUSB0 portunu açar.

Veri, arka plandaki bir okuyucu iş parçacığına gelir. Her parçayı olay olarak almak için OnData atayın; boş bırakırsanız baytlar 64 KB'lık bir alma arabelleğine gider ve bunu Read ile okursunuz. İlk bayt için bir zaman aşımı ve mesajı bitiren bir karakterler arası zaman aşımı kullanılır. Yazma işlemleri bileşen tarafından sıraya alınır, bu yüzden her iş parçacığı veri gönderebilir.

Bileşen sınıfı

TsgcSerialPort, sgcIndustrial biriminde

Port adları

COM3, \\.\COM12, /dev/ttyUSB0 ya da yalnızca ttyUSB0

Hat ayarları

5 ile 8 veri biti; yok, tek, çift, mark veya space eşlik; 1, 1,5 veya 2 durdurma biti; RTS/CTS, DTR/DSR veya XON/XOFF akış denetimi

Platformlar

Delphi 7 ile Delphi 13 ve C++Builder; Windows 32 ve 64 bit, Linux 64 bit ve macOS

Bir port açın, komut gönderin, yanıtı okuyun

Bileşeni kullanmanın üç yolu. Her örnek Delphi 7 ve Delphi 13 ile derlenir.

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;

Seri port kodunu güvenilir kılan ayrıntılar

İş parçacıkları, zaman aşımları, arabellekler ve çıkarılan adaptörler bileşenin içinde ele alınır.

Olay veya engelleyen okuma

OnData atandığında, okuyucu iş parçacığının aldığı her parça bir olay olarak iletilir. Atanmadığında Read(Data, MaxCount, Timeout, InterCharTimeout) ilk baytı bekler, ardından MaxCount bayt geldiğinde veya hat karakterler arası süre boyunca sessiz kaldığında döner: çerçevelenmiş tek bir yanıtı okumanın doğal yolu.

Seçtiğiniz iş parçacığında olaylar

NotifyEvents, OnData, OnOpen, OnClose ve OnError olaylarını varsayılan olarak ana iş parçacığına kuyruklar, senkronize edebilir veya en düşük gecikme için doğrudan okuyucu iş parçacığında tetikleyebilir.

Herhangi bir iş parçacığından yazın

Write ve WriteString dahili bir kilitle sıraya alınır. Write yazılan bayt sayısını döndürür, WriteTimeout ne kadar bekleyeceğini sınırlar ve WriteString bir dizenin UTF-8 baytlarını gönderir, hepsi yazılamazsa hata oluşturur.

Her yerden kapatın

Close her iş parçacığından, hatta bir OnData işleyicisinin içinden bile güvenle çağrılabilir. Engellenmiş bir Read çağrısını uyandırır, engellenmiş bir yazmayı iptal eder ve okuyucu iş parçacığını durdurur. Windows'ta overlapped G/Ç iptalini, Linux ve macOS'ta poll ile bir iptal bayrağını kullanır.

RS-485 yön denetimi

RtsControl := srcToggle, port veri gönderirken RTS'yi yükseltir ve sonrasında düşürür, böylece bir RS-485 alıcı-verici yanıt için veriyolunu serbest bırakır. Windows sürücünün RTS geçiş modunu, Linux ise seri sürücünün çekirdek RS-485 modunu kullanır.

Modem hatları

SetDTR ve SetRTS çıkış hatlarını sürer; ModemStatus etkin girişlerin kümesini döndürür: smsCTS, smsDSR, smsRI ve smsDCD.

Port keşfi

TsgcSerialPort.ListPorts port adlarını doğal sırayla (COM2, COM10'dan önce) herhangi bir TStrings nesnesine ekler: Windows'ta kayıt defterinden, Linux'ta /dev/ttyS*, /dev/ttyUSB* ve /dev/ttyACM* üzerinden, macOS'ta /dev/cu.* üzerinden.

Denetim altındaki arabellekler

BufferCount, 64 KB'lık alma arabelleğinde kaç baytın beklediğini söyler; Purge onu işletim sistemi arabellekleriyle birlikte boşaltır. Arabellek taşarsa en eski baytlar atılır ve OnError bir kez tetiklenir.

İşletim sistemi koduyla hatalar

Her hata, ErrorCode alanında Windows hatasını veya POSIX errno değerini taşıyan EsgcSerialError oluşturur. Bir USB adaptör çıkarıldığında OnError bir kez tetiklenir ve port Close çağrısını bekler. Linux ve macOS'ta port özel (exclusive) modda açılır.

Her işletim sisteminin desteklediği özellikler

Platformun yapamadığı bir ayar, yok sayılmak yerine Open sırasında EsgcSerialError oluşturur.

ÖzellikWindowsLinuxmacOS
Baud hızlarıSürücünün kabul ettiği her hızStandart hızlar, 50 ile 4.000.000 arasıStandart hızlar, 50 ile 230.400 arası
Mark ve space eşlikEvetEvetHayır
RTS/CTS ve XON/XOFF akış denetimiEvetEvetEvet
DTR/DSR akış denetimiEvetHayırHayır
RS-485 RTS geçişiEvet, sürücü geçiş moduEvet, çekirdek RS-485 modu (sürücü desteği gerekir)Hayır
Port listesiKayıt defteri/dev/ttyS*, ttyUSB*, ttyACM*/dev/cu.*

Bileşen, Windows'ta (32 ve 64 bit) gerçek bir COM portunda ve Linux 64 bit üzerinde sahte terminallerde test edilmiştir; aynı kod macOS için de derlenir. Android ve iOS desteklenmez.

Modbus RTU için taşıma katmanı

TsgcSerialPort aynı zamanda Delphi Modbus RTU bileşenlerinin altındaki seri hattır. Bir RS-485 veriyolundaki slave cihazları sorgulamak için açık bir portu TsgcModbusRTUClient bileşeninin, slave olarak yanıt vermek için TsgcModbusRTUServer bileşeninin SerialPort özelliğine atayın. Modbus bileşenleri 3,5 karakterlik çerçeve aralığını, CRC'yi ve slave adresini üstlenir; port için yalnızca veriyolunun hat ayarları gerekir, genellikle 19200 baud, 8 veri biti, çift eşlik ve 1 durdurma biti.

Delphi seri port soruları

Bir TsgcSerialPort oluşturun, Port (örneğin COM3), BaudRate, DataBits, Parity ve StopBits değerlerini ayarlayın, ardından Active := True yapın veya Open çağırın. COM9 üzerindeki portlar da düz adla çalışır; bileşen Windows'un gerektirdiği \\.\ önekini ekler.

OnData olayını atamadan bırakın ve Read(Data, MaxCount, Timeout, InterCharTimeout) çağırın. İlk bayt için en fazla Timeout milisaniye bekler, ardından MaxCount bayt geldiğinde veya InterCharTimeout milisaniye boyunca bayt gelmediğinde döner. Sonuç okunan bayt sayısıdır, 0 ise zaman aşımı demektir. Aynı anda yalnızca bir iş parçacığı Read çağırmalıdır.

Evet, işletim sisteminin seri port olarak gösterdiği her adaptörle çalışır: Windows'ta bir COM portu, Linux'ta /dev/ttyUSB* veya /dev/ttyACM*, macOS'ta /dev/cu.*. Port açıkken adaptör çıkarılırsa OnError bir kez tetiklenir; Close çağırın ve adaptör geri geldiğinde portu yeniden açın.

Otomatik yön denetimli dönüştürücüler için ayar gerekmez. RTS ile sürülen dönüştürücüler için RtsControl := srcToggle ayarlayın: port veri gönderirken RTS yükseltilir ve son bayt çıktığında düşürülür. Windows bunu seri sürücüde, Linux çekirdeğin RS-485 modunda yapar; bu mod için seri sürücünün desteği gerekir, aksi halde Open anlaşılır bir EsgcSerialError oluşturur.

Yazma işlemleri her iş parçacığından gelebilir ve bileşen tarafından sıraya alınır. Close, bir olay işleyicisinin içindeki okuyucu iş parçacığı dahil, her iş parçacığından çağrılabilir. Okumalar aynı anda tek bir çağıran için tasarlanmıştır; zaten istek ve yanıt protokolü bir seri hattı bu şekilde kullanır.

Delphi 7 ile Delphi 13 ve C++Builder; Windows 32 ve 64 bit, Linux 64 bit ve macOS üzerinde. Android ve iOS desteklenmez.

TsgcSerialPort, Modbus bileşenleriyle birlikte sgcWebSockets Enterprise (Delphi ve .NET) ve All-Access ya da bağımsız sgcIndustrial paketi içinde yer alır.

sgcWebSockets içinde daha fazla endüstriyel bileşen

Seri port başvurusu

TsgcSerialPort bileşeninin tüm özellikleri, metotları ve olayları.

Endüstriyel bileşenler

Seri port, Modbus ve OPC UA, sgcWebSockets'in tek bir bölümünde.

Delphi Modbus TCP ve RTU

Seri hat için bu bileşeni kullanan Modbus istemcileri ve sunucuları.

.NET için C# Modbus

.NET sürümünde de Modbus bileşenlerinin yanında bir TsgcSerialPort bulunur.

En avantajlı seçenek: All-AccessTüm eSeGeCe ürünleri, Premium Destek dahil, yılda €1,059'dan itibaren.
All-Access fiyatlarına bakın

İlk seri cihazınızı Delphi'den bağlayın

sgcWebSockets Enterprise (Delphi ve .NET) ve All-Access ya da bağımsız sgcIndustrial paketi içinde yer alır.