Seri Port Bileşeni
Delphi, C++Builder ve .NET'ten RS-232 ve RS-485 portlarını açın. Hattı yapılandırın, veri yazın ve Windows, Linux ve macOS üzerinde bir olayda ya da engelleyen okumalarla alın.
Yeni
Delphi, C++Builder ve .NET'ten RS-232 ve RS-485 portlarını açın. Hattı yapılandırın, veri yazın ve Windows, Linux ve macOS üzerinde bir olayda ya da engelleyen okumalarla alın.
Yeni
Arka planda çalışan bir okuyucu iş parçacığına, 64 KB'lık bir alma arabelleğine ve Delphi, C++Builder ve C# içinde aynı API'ye sahip bir seri port. Aynı zamanda Modbus RTU istemcisi ve sunucusunun taşımasıdır.
TsgcSerialPort
RS-232, RS-485 ve USB seri adaptörler
Windows, Linux ve macOS (Android ve iOS değil)
sgcWebSockets Enterprise (Delphi ve .NET) ve All-Access ya da bağımsız sgcIndustrial paketi içinde yer alır
Port adını ve hat ayarlarını belirleyin, olayları atayın ve Open çağırın. OnData her bayt bloğunu geldiği anda alır.
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);
}
}
Cihazlar, modemler, barkod okuyucular, teraziler ve saha veri yolları için eksiksiz bir seri port.
BaudRate, DataBits (5 ile 8), Parity (yok, tek, çift, işaret, boşluk), StopBits (1, 1.5, 2) ve FlowControl (RTS/CTS ya da XON/XOFF). Geçersiz kombinasyonlar port açılırken EsgcSerialError oluşturur.
OnData atandığında her bayt bloğu olaya gider. Atanmadığında baytlar 64 KB'lık bir arabellekte bekler ve Read bütün bir yanıtı döndürür: ilk bayt için bekler ve sizin seçtiğiniz bir sessizlikten sonra biter.
Yönü RTS ile değiştiren adaptörler için RtsControl değerini srcToggle yapın. Windows'ta sürücü, iletim sırasında RTS'yi yükseltir; Linux'ta çekirdeğin RS-485 modu etkinleştirilir. .NET'te geçişin zamanlamasını bileşen yapar.
TsgcSerialPort.ListPorts, portları doğal sırayla listeler (COM2, COM10'dan önce). SetDTR, SetRTS ve ModemStatus modem hatlarını sürer ve okur.
Write herhangi bir iş parçacığından çağrılabilir. Close herhangi bir iş parçacığından, bir olay işleyicisinden de çalışır ve engellenmiş bir Read çağrısını uyandırır. Delphi ve C++Builder'da olaylar varsayılan olarak ana iş parçacığına kuyruğa alınır ve NotifyEvents bunu değiştirir.
Her hata, sistem bildirdiğinde işletim sistemi hata kodunu taşıyan ErrorCode değerine sahip EsgcSerialError oluşturur. Port açıkken bir cihazın çıkarılması ya da dolu bir alma arabelleği OnError olayını tetikler.
OnData olayını boş bırakın, komutu yazın ve Read çağırın: ilk bayt için en fazla 1000 ms bekler ve cihaz 50 ms sessiz kaldığında döner.
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");
}
}
Bu bileşenin üzerine kurulduğu işletim sistemi arayüzleri.
Delphi ve C++Builder'da Windows'ta (Win32 ve Win64) Win32 iletişim API'siyle, Linux64 ve macOS'ta ise POSIX termios ile çalışır. Android ve iOS'ta kullanılamaz. .NET sürümü System.IO.Ports üzerine kuruludur.
Barkod okuyucu ya da terazi gibi veriyi kendiliğinden gönderen cihazlar için OnData kullanın. İstek ve yanıt protokolleri için Read kullanın: komutu gönderin, sonra cihaz göndermeyi bırakana kadar okuyun. İkisi birbirini dışlar: OnData atanmışken Read, EsgcSerialError oluşturur ve aynı anda yalnızca bir iş parçacığı Read çağırabilir.
Yönü otomatik değiştiren bir adaptör için hiçbir ayar gerekmez. Yönü RTS hattıyla değiştiren bir adaptör için RtsControl değeri srcToggle olmalıdır. Linux'ta bileşen bu durumda sürücünün RS-485 modunu etkinleştirir ve sürücü desteklemiyorsa EsgcSerialError oluşturur. macOS, srcToggle değerini desteklemez.
sgcIndustrial paketinin bir parçası olarak sgcWebSockets Enterprise (Delphi ve .NET) ve All-Access içinde yer alır. Delphi'de sgcIndustrial birimini uses yan tümcesine ekleyin.
Bileşen başvurusuna doğrudan gidin, demo projesini açın ve teknik belgeyi okuyun.
| Online Help: TsgcSerialPort Bu bileşen için tam özellik, metot ve olay referansı. | Aç | |
| Demo Projesi: Industrial\01.Serial_Port Delphi, C++Builder ve .NET için bir seri terminal. sgcWebSockets paketinin içinde gelir. | Aç | |
| Teknik Belge (PDF) Yalnızca bu bileşene ait özellikler, hızlı başlangıç, kod örnekleri ve birincil kaynak başvuruları. | Aç | |
| Kullanıcı Kılavuzu (PDF) Kütüphanedeki her bileşeni kapsayan kapsamlı kılavuz. | Aç |