시리얼 포트 컴포넌트

Delphi, C++Builder, .NET에서 RS-232와 RS-485 포트를 열어요. 회선을 설정하고, 데이터를 쓰고, Windows, Linux, macOS에서 이벤트 또는 블로킹 읽기로 수신하세요.

신규

TsgcSerialPort

백그라운드 읽기 스레드와 64 KB 수신 버퍼를 갖춘 시리얼 포트로, Delphi, C++Builder, C#에서 같은 API를 사용해요. Modbus RTU 클라이언트와 서버의 전송 계층이기도 해요.

컴포넌트 클래스

TsgcSerialPort

인터페이스

RS-232, RS-485, USB 시리얼 어댑터

플랫폼

Windows, Linux, macOS (Android와 iOS는 제외)

에디션

sgcWebSockets Enterprise(Delphi 및 .NET)와 All-Access, 또는 독립형 sgcIndustrial 팩에 포함

포트를 열고 데이터 수신하기

포트 이름과 회선 설정을 지정하고, 이벤트를 연결한 다음 Open을 호출해요. OnData는 도착하는 모든 바이트 블록을 받아요.

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

내부 구성

계측기, 모뎀, 바코드 리더, 저울, 필드버스를 위한 완전한 시리얼 포트.

회선 설정

BaudRate, DataBits(5~8), Parity(none, odd, even, mark, space), StopBits(1, 1.5, 2), FlowControl(RTS/CTS 또는 XON/XOFF). 잘못된 조합은 포트를 열 때 EsgcSerialError를 발생시켜요.

이벤트 또는 블로킹 읽기

OnData를 지정하면 모든 바이트 블록이 이벤트로 전달돼요. 지정하지 않으면 바이트는 64 KB 버퍼에서 대기하고, Read가 전체 응답을 반환해요. 첫 바이트를 기다리고, 직접 정한 무음 시간이 지나면 끝나요.

RS-485 방향 제어

RTS로 방향을 전환하는 어댑터에는 RtsControl을 srcToggle로 설정하세요. Windows에서는 드라이버가 전송 중에 RTS를 올리고, Linux에서는 커널 RS-485 모드가 활성화돼요. .NET에서는 컴포넌트가 토글 타이밍을 처리해요.

포트와 모뎀 라인

TsgcSerialPort.ListPorts는 포트를 자연 순서로 나열해요(COM2가 COM10보다 앞). SetDTR, SetRTS, ModemStatus로 모뎀 라인을 제어하고 읽어요.

스레드 안전

Write는 어떤 스레드에서도 호출할 수 있어요. Close는 이벤트 핸들러를 포함해 어떤 스레드에서도 동작하며, 블로킹 중인 Read를 깨워요. Delphi와 C++Builder에서는 이벤트가 기본적으로 메인 스레드에 큐잉되며, NotifyEvents로 이를 바꿀 수 있어요.

명확한 오류

모든 실패는 EsgcSerialError를 발생시키며, 운영 체제가 오류 코드를 보고한 경우 ErrorCode에 그 값이 담겨요. 포트가 열려 있는 동안 장치가 분리되거나 수신 버퍼가 가득 차면 OnError가 발생해요.

명령을 보내고 응답 읽기

OnData를 비워 두고 명령을 쓴 다음 Read를 호출하세요. 첫 바이트를 최대 1000 ms 기다리고, 장치가 50 ms 동안 조용하면 반환해요.

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

사양 및 참고문헌

이 컴포넌트가 기반으로 하는 운영 체제 인터페이스.

시리얼 포트 관련 질문

Delphi와 C++Builder에서는 Windows(Win32 및 Win64)에서 Win32 통신 API로, Linux64와 macOS에서 POSIX termios로 동작해요. Android와 iOS에서는 사용할 수 없어요. .NET 버전은 System.IO.Ports를 기반으로 해요.

바코드 리더나 저울처럼 장치가 스스로 데이터를 보내는 경우에는 OnData를 사용하세요. 요청과 응답 프로토콜에는 Read를 사용하세요. 명령을 보낸 뒤 장치가 전송을 멈출 때까지 읽어요. 둘은 동시에 사용할 수 없어요. OnData가 지정된 동안 Read는 EsgcSerialError를 발생시키며, 한 번에 하나의 스레드만 Read를 호출할 수 있어요.

방향을 자동으로 전환하는 어댑터는 별도 설정이 필요 없어요. RTS 라인으로 방향을 전환하는 어댑터는 RtsControl을 srcToggle로 설정해야 해요. Linux에서는 컴포넌트가 드라이버의 RS-485 모드를 활성화하며, 드라이버가 지원하지 않으면 EsgcSerialError를 발생시켜요. macOS는 srcToggle을 지원하지 않아요.

sgcIndustrial 팩의 일부로 sgcWebSockets Enterprise(Delphi 및 .NET)와 All-Access에 포함돼요. Delphi에서는 uses 절에 sgcIndustrial을 추가하세요.

문서 및 데모

컴포넌트 레퍼런스로 바로 이동하고, 데모 프로젝트를 열고, 기술 문서를 읽어 보세요.

Online Help: TsgcSerialPort 이 컴포넌트의 전체 속성, 메서드 및 이벤트 레퍼런스예요.
데모 프로젝트: Industrial\01.Serial_Port Delphi, C++Builder, .NET용 시리얼 터미널. sgcWebSockets 패키지에 포함되어 있어요.
기술 문서 (PDF) 이 컴포넌트만을 위한 기능, 빠른 시작, 코드 샘플, 1차 자료 레퍼런스.
사용자 매뉴얼 (PDF) 라이브러리의 모든 컴포넌트를 다루는 종합 매뉴얼이에요.
최고의 가성비: All-Access모든 eSeGeCe 제품과 프리미엄 지원이 포함되어 연 €1,059부터 이용할 수 있어요.
All-Access 가격 보기

sgcWebSockets Enterprise에 포함

sgcWebSockets Enterprise(Delphi 및 .NET)와 All-Access, 또는 독립형 sgcIndustrial 팩에 포함.