시리얼 포트 컴포넌트
Delphi, C++Builder, .NET에서 RS-232와 RS-485 포트를 열어요. 회선을 설정하고, 데이터를 쓰고, Windows, Linux, macOS에서 이벤트 또는 블로킹 읽기로 수신하세요.
신규
Delphi, C++Builder, .NET에서 RS-232와 RS-485 포트를 열어요. 회선을 설정하고, 데이터를 쓰고, Windows, Linux, macOS에서 이벤트 또는 블로킹 읽기로 수신하세요.
신규
백그라운드 읽기 스레드와 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가 전체 응답을 반환해요. 첫 바이트를 기다리고, 직접 정한 무음 시간이 지나면 끝나요.
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) 라이브러리의 모든 컴포넌트를 다루는 종합 매뉴얼이에요. | 열기 |