SECS/GEM 튜토리얼

이 튜토리얼은 장비 없이 PDComm SDK와 시뮬레이터만으로 SECS/GEM 통신을 익히는 과정입니다. 모든 단계는 같은 컴퓨터의 루프백(loopback) 주소 127.0.0.1에서 실행합니다. 각 페이지는 필요한 배경 지식, 실행 명령, 기대 결과, 자주 생기는 오류, 정리 방법을 함께 다룹니다.

처음이면 빠른 시작으로 첫 통신을 먼저 확인합니다. 용어가 낯설면 배경 지식을 먼저 읽습니다.

실습 순서

순서	튜토리얼	다루는 내용
1	개발 환경 준비	SDK 묶음 구성, Windows·Linux·macOS 환경 변수, C++와 C# 예제 빌드
2	첫 통신	C++·C# 호스트와 장비, 통신 수립, 온라인·오프라인, 시뮬레이터 GUI와 연결
3	데이터 수집	상태 변수, 데이터 변수, 장비 상수, 디렉터리, 보고서 조회
4	보고서와 이벤트	보고서 정의, 이벤트 연결, 이벤트 보고(S6F11)
5	알람	알람 보고(S5F1), 사용 설정, 목록 조회
6	원격 명령	기본 원격 명령(S2F41)과 확장 원격 명령(S2F49)
7	공정 프로그램	비정형·정형 공정 프로그램 전송, 조회, 검증, 실행
8	스풀링	통신이 끊긴 동안 메시지를 모아 두었다가 보내는 스풀링
9	시뮬레이터 자동화와 오류 재현	GUI 시뮬레이터, headless 시나리오, MCP 서버로 실습을 자동화하고 오류를 재현
10	실패 진단과 문의	PDCOMM_LOG 진단 로그, 최소 재현, 문의 자료 정리

1–2장은 순서대로 진행합니다. 3–8장은 필요한 기능부터 골라 진행해도 됩니다.

실습에서 쓰는 예제

예제	위치	언어
튜토리얼 예제	SDK의 examples/tutorial	C++, C#
기능별 .NET 예제	예제 묶음의 dotnet/	C#
Qt 연동 예제	예제 묶음의 qt/	C++(Qt 6)
진단 로그 예제	예제 묶음의 diagnostics/	C++, C#

예제는 SEMI 표준의 메시지 흐름을 실습하는 코드입니다. 실제 장비와 연결할 때는 장비의 메시지 명세(interface specification)에 맞춰 메시지를 구성합니다.