신규
Windows, Linux, macOS용 Delphi 시리얼 포트 컴포넌트
COM 포트, USB 시리얼 어댑터, RS-485 버스를 위한 비주얼이 아닌 컴포넌트 하나. 이벤트나 블로킹 읽기로 수신하고, 어느 스레드에서든 쓰고, Windows, Linux, macOS에서 같은 코드를 실행해요.
sgcWebSockets Enterprise(Delphi 및 .NET)와 All-Access, 또는 독립형 sgcIndustrial 팩에 포함.
신규
COM 포트, USB 시리얼 어댑터, RS-485 버스를 위한 비주얼이 아닌 컴포넌트 하나. 이벤트나 블로킹 읽기로 수신하고, 어느 스레드에서든 쓰고, Windows, Linux, macOS에서 같은 코드를 실행해요.
sgcWebSockets Enterprise(Delphi 및 .NET)와 All-Access, 또는 독립형 sgcIndustrial 팩에 포함.
바코드 스캐너, 저울, GPS 수신기, 모뎀, 실험실 장비, RS-485 필드 버스를 Pascal 클래스 하나로 다뤄요.
Delphi 시리얼 포트 컴포넌트는 시리얼 I/O 방식이 서로 다른 세 가지 운영체제를 다뤄야 해요. Windows는 오버랩 I/O와 DCB 설정, Linux와 macOS는 termios와 파일 디스크립터를 써요. TsgcSerialPort는 이 모든 것을 하나의 속성 집합(Port, BaudRate, DataBits, Parity, StopBits, FlowControl, RtsControl)과 하나의 호출 집합 뒤에 숨기기 때문에, VCL, FMX, 서비스, 콘솔 애플리케이션이 같은 코드로 Windows에서는 COM3을, Linux에서는 /dev/ttyUSB0을 열 수 있어요.
데이터는 백그라운드 리더 스레드로 들어와요. OnData를 지정하면 받은 데이터 조각마다 이벤트로 전달되고, 비워 두면 바이트가 64 KB 수신 버퍼에 쌓여 Read로 읽을 수 있어요. 첫 바이트 타임아웃과 메시지를 끝내는 문자 간 타임아웃을 지원해요. 쓰기는 컴포넌트가 직렬화하므로 어느 스레드에서든 보낼 수 있어요.
sgcIndustrial 유닛의 TsgcSerialPort
COM3, \\.\COM12, /dev/ttyUSB0 또는 그냥 ttyUSB0
5~8 데이터 비트, 패리티 없음/홀수/짝수/마크/스페이스, 1, 1.5 또는 2 스톱 비트, RTS/CTS, DTR/DSR 또는 XON/XOFF 흐름 제어
Delphi 7~Delphi 13 및 C++Builder, Windows 32/64비트, Linux 64비트, macOS
컴포넌트를 쓰는 세 가지 방법이에요. 모든 샘플은 Delphi 7과 Delphi 13에서 컴파일돼요.
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 = 0 then
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;
스레드, 타임아웃, 버퍼, 뽑힌 어댑터를 컴포넌트 안에서 처리해요.
OnData를 지정하면 리더 스레드가 받은 데이터 조각마다 이벤트로 전달돼요. 지정하지 않으면 Read(Data, MaxCount, Timeout, InterCharTimeout)가 첫 바이트를 기다린 뒤, MaxCount 바이트가 도착하거나 회선이 문자 간 시간 동안 조용하면 반환해요. 프레임 단위의 응답 하나를 읽는 데 자연스러운 방법이에요.
NotifyEvents는 기본적으로 OnData, OnOpen, OnClose, OnError를 메인 스레드 큐에 넣어요. 동기화할 수도 있고, 가장 낮은 지연을 위해 리더 스레드에서 직접 발생시킬 수도 있어요.
Write와 WriteString은 내부 락으로 직렬화돼요. Write는 쓴 바이트 수를 반환하고, WriteTimeout은 대기 시간을 제한하며, WriteString은 문자열의 UTF-8 바이트를 보내고 모두 쓰지 못하면 예외를 발생시켜요.
Close는 OnData 핸들러 안을 포함해 어느 스레드에서든 안전해요. 블로킹된 Read를 깨우고, 블로킹된 쓰기를 취소하고, 리더 스레드를 멈춰요. Windows에서는 오버랩 I/O 취소를, Linux와 macOS에서는 poll과 취소 플래그를 사용해요.
RtsControl := srcToggle은 포트가 전송하는 동안 RTS를 올리고 전송이 끝나면 내려요. 그래서 RS-485 트랜시버가 응답을 위해 버스를 해제해요. Windows는 드라이버의 RTS 토글 모드를, Linux는 시리얼 드라이버의 커널 RS-485 모드를 사용해요.
SetDTR, SetRTS로 출력 라인을 제어하고, ModemStatus는 활성 입력(smsCTS, smsDSR, smsRI, smsDCD)의 집합을 반환해요.
TsgcSerialPort.ListPorts는 포트 이름을 자연스러운 순서(COM2가 COM10보다 먼저)로 모든 TStrings에 추가해요. Windows에서는 레지스트리에서, Linux에서는 /dev/ttyS*, /dev/ttyUSB*, /dev/ttyACM*에서, macOS에서는 /dev/cu.*에서 가져와요.
BufferCount는 64 KB 수신 버퍼에 몇 바이트가 대기 중인지 알려 주고, Purge는 운영체제 버퍼와 함께 비워요. 버퍼가 넘치면 가장 오래된 바이트가 버려지고 OnError가 한 번 발생해요.
모든 실패는 EsgcSerialError를 발생시키고, ErrorCode에는 Windows 오류 또는 POSIX errno가 담겨요. USB 어댑터를 뽑으면 OnError가 한 번 발생하고 포트는 Close를 기다려요. Linux와 macOS에서는 포트가 배타 모드로 열려요.
플랫폼이 지원하지 않는 설정은 무시되지 않고 Open 시점에 EsgcSerialError를 발생시켜요.
| 기능 | Windows | Linux | macOS |
|---|---|---|---|
| 보레이트 | 드라이버가 받아들이는 모든 속도 | 표준 속도, 50~4,000,000 | 표준 속도, 50~230,400 |
| 마크 및 스페이스 패리티 | 예 | 예 | 아니요 |
| RTS/CTS 및 XON/XOFF 흐름 제어 | 예 | 예 | 예 |
| DTR/DSR 흐름 제어 | 예 | 아니요 | 아니요 |
| RS-485 RTS 토글 | 예, 드라이버 토글 모드 | 예, 커널 RS-485 모드(드라이버 지원 필요) | 아니요 |
| 포트 목록 | 레지스트리 | /dev/ttyS*, ttyUSB*, ttyACM* | /dev/cu.* |
이 컴포넌트는 Windows(32/64비트)의 실제 COM 포트와 Linux 64비트의 가상 터미널에서 테스트됐고, 같은 코드가 macOS용으로도 컴파일돼요. Android와 iOS는 지원하지 않아요.
TsgcSerialPort는 Delphi Modbus RTU 컴포넌트의 시리얼 회선이기도 해요. 열린 포트를 TsgcModbusRTUClient의 SerialPort 속성에 지정하면 RS-485 버스의 슬레이브를 폴링하고, TsgcModbusRTUServer에 지정하면 슬레이브로 응답해요. 3.5 문자 프레임 간격, CRC, 슬레이브 주소는 Modbus 컴포넌트가 처리하고, 포트에는 버스의 회선 설정만 필요해요. 보통 19200 보레이트, 8 데이터 비트, 짝수 패리티, 1 스톱 비트예요.
TsgcSerialPort를 만들고 Port(예: COM3), BaudRate, DataBits, Parity, StopBits를 설정한 다음 Active := True로 지정하거나 Open을 호출하세요. COM9보다 큰 포트도 일반 이름으로 동작해요. Windows에 필요한 \\.\ 접두사는 컴포넌트가 붙여 줘요.
OnData를 지정하지 않고 Read(Data, MaxCount, Timeout, InterCharTimeout)를 호출하세요. 첫 바이트를 최대 Timeout 밀리초 동안 기다린 뒤, MaxCount 바이트가 도착하거나 InterCharTimeout 밀리초 동안 바이트가 오지 않으면 반환해요. 결과는 읽은 바이트 수이고, 0은 타임아웃을 뜻해요. 한 번에 한 스레드만 Read를 호출해야 해요.
네, 운영체제가 시리얼 포트로 노출하는 어댑터라면 모두 가능해요. Windows에서는 COM 포트, Linux에서는 /dev/ttyUSB* 또는 /dev/ttyACM*, macOS에서는 /dev/cu.*예요. 포트가 열려 있는 동안 어댑터를 뽑으면 OnError가 한 번 발생해요. 어댑터를 다시 연결한 뒤 Close를 호출하고 포트를 다시 여세요.
방향을 자동으로 제어하는 컨버터는 설정이 필요 없어요. RTS로 구동되는 컨버터는 RtsControl := srcToggle로 설정하세요. 포트가 전송하는 동안 RTS가 올라가고 마지막 바이트가 나가면 내려가요. Windows에서는 시리얼 드라이버가, Linux에서는 시리얼 드라이버가 지원해야 하는 커널 RS-485 모드가 처리해요. 지원하지 않으면 Open이 명확한 EsgcSerialError를 발생시켜요.
쓰기는 어느 스레드에서든 가능하며 컴포넌트가 직렬화해요. Close는 이벤트 핸들러 안의 리더 스레드를 포함해 어느 스레드에서든 호출할 수 있어요. 읽기는 한 번에 한 호출자를 전제로 해요. 어차피 요청과 응답 프로토콜은 시리얼 회선을 그렇게 사용해요.
Delphi 7~Delphi 13 및 C++Builder, Windows 32/64비트, Linux 64비트, macOS. Android와 iOS는 지원하지 않아요.
TsgcSerialPort는 Modbus 컴포넌트와 함께 sgcWebSockets Enterprise(Delphi 및 .NET)와 All-Access, 또는 독립형 sgcIndustrial 팩에 포함돼요.
TsgcSerialPort의 모든 속성, 메서드, 이벤트예요.
sgcWebSockets의 한 섹션에서 시리얼 포트, Modbus, OPC UA를 만나 보세요.
시리얼 회선에 이 컴포넌트를 사용하는 Modbus 클라이언트와 서버예요.
.NET 에디션에도 Modbus 컴포넌트와 함께 TsgcSerialPort가 있어요.