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.
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
QuickStart
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 = 0then
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;
ÖZELLİKLER
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.
PLATFORMLAR
Her işletim sisteminin desteklediği özellikler
Platformun yapamadığı bir ayar, yok sayılmak yerine Open sırasında EsgcSerialError oluşturur.
Özellik
Windows
Linux
macOS
Baud hızları
Sürücünün kabul ettiği her hız
Standart hızlar, 50 ile 4.000.000 arası
Standart hızlar, 50 ile 230.400 arası
Mark ve space eşlik
Evet
Evet
Hayır
RTS/CTS ve XON/XOFF akış denetimi
Evet
Evet
Evet
DTR/DSR akış denetimi
Evet
Hayır
Hayır
RS-485 RTS geçişi
Evet, sürücü geçiş modu
Evet, çekirdek RS-485 modu (sürücü desteği gerekir)
Hayır
Port listesi
Kayı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
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.
FAQ
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.
İLGİLİ
sgcWebSockets içinde daha fazla endüstriyel bileşen