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

TsgcSerialPort

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.

Bileşen sınıfı

TsgcSerialPort

Arayüzler

RS-232, RS-485 ve USB seri adaptörler

Platformlar

Windows, Linux ve macOS (Android ve iOS değil)

Sürüm

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

Bir port açın ve veri alın

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);
    }
}

İçeriğinde neler var

Cihazlar, modemler, barkod okuyucular, teraziler ve saha veri yolları için eksiksiz bir seri port.

Hat ayarları

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.

Olaylar ya da engelleyen okumalar

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.

RS-485 yön denetimi

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.

Portlar ve modem hatları

TsgcSerialPort.ListPorts, portları doğal sırayla listeler (COM2, COM10'dan önce). SetDTR, SetRTS ve ModemStatus modem hatlarını sürer ve okur.

İş parçacığı güvenli

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.

Açık hatalar

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.

Bir komut gönderin, yanıtı okuyun

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");
    }
}

Spesifikasyonlar ve referanslar

Bu bileşenin üzerine kurulduğu işletim sistemi arayüzleri.

Seri port soruları

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.

Belgeler ve Demolar

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ı.
Demo Projesi: Industrial\01.Serial_Port Delphi, C++Builder ve .NET için bir seri terminal. sgcWebSockets paketinin içinde gelir.
Teknik Belge (PDF) Yalnızca bu bileşene ait özellikler, hızlı başlangıç, kod örnekleri ve birincil kaynak başvuruları.
Kullanıcı Kılavuzu (PDF) Kütüphanedeki her bileşeni kapsayan kapsamlı kılavuz.
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

sgcWebSockets Enterprise içinde yer alır

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