Pressure Leak Inspect System (기밀 시험 시스템 GUI)

Windows 기반 Air Leak Test 장비를 위한 제어 및 모니터링 GUI 프로그램입니다. WPF(C#)를 사용하여 제작되었으며, MVVM 패턴을 적용하여 하드웨어 통신 계층과 UI 계층이 분리된 구조를 가지고 있습니다.

📂 프로젝트 파일 구조

leak_test_project/
├── Infrastructure/            # 하드웨어 통신 및 DIO 계층 (Low-Level Communication)
│   ├── ICommunication.cs      # 통신 방식(Serial, TCP) 추상화 인터페이스
│   ├── SerialProvider.cs      # RS232 시리얼 통신 구현체 (8N1, IDisposable)
│   ├── IDioBoard.cs           # DIO 보드 추상화 인터페이스 (입출력 제어, 이벤트)
│   ├── RealDioBoard.cs        # ADLINK PCI DIO 보드 실제 구현체 (10ms 폴링)
│   └── Dask.cs                # ADLINK PCIS-DASK API P/Invoke 래퍼
├── Models/                    # 데이터 모델
│   ├── AppConfig.cs           # 앱 설정 (Left/Right/SensorPort, Zmdi/SensorBaudRate, SpecUL/LL)
│   ├── DioPoint.cs            # DIO 포인트 모델 (Name, IsInput, Value) + DioEventArgs
│   ├── InOutItem.cs           # I/O 항목 모델 (Address, Name, Description, Value)
│   ├── InspectData.cs         # 검사 결과 데이터 모델 (12개 필드)
│   ├── ParsedData.cs          # Sentinel C28 파싱 결과 모델 (MeasuredValue, SensorJudgment 등)
│   └── SensorIdData.cs        # ZMDI 센서 ID 데이터 모델 (LowID, Year/Month/Day, Serial 등)
├── Services/                  # 비즈니스 로직 및 기기 제어
│   ├── DioBoardFactory.cs     # DIO 보드 팩토리 (DioConfig.ini 기반 보드 생성)
│   ├── IoBoardService.cs      # I/O 보드 서비스 (IDioBoard 연동, 상태 갱신/출력 제어)
│   ├── SentinelC28Service.cs  # Sentinel C28 프로토콜 (자동 재연결 포함)
│   ├── TestProcessService.cs  # 자동 시험 프로세스 (DIO→센서→시험→판정→출력 사이클)
│   └── ZmdiSensorService.cs   # ZMDI 센서 시리얼 통신 (ID 읽기/파싱, 4단계 명령)
├── Utils/                     # 유틸리티
│   ├── ConfigManager.cs       # XML 기반 설정 관리 (Load/Save, ConfigChanged 이벤트)
│   ├── CsvExporter.cs         # 범용 CSV 내보내기
│   ├── DioConfigParser.cs     # INI 형식 DIO 설정 파서 (보드 타입, 포인트 매핑)
│   ├── FileLogger.cs          # 일일 CSV 로그 자동 저장 + 시스템 로그
│   ├── LogParser.cs           # CSV 로그 파싱 및 검색 필터링
│   ├── SentinelCrc8.cs        # CRC-8 체크섬 계산
│   └── SentinelParser.cs      # C28 데이터 파싱 (스트리밍/최종결과/판정)
├── ViewModels/                # MVVM ViewModel
│   ├── Core/
│   │   ├── ObservableObject.cs # INotifyPropertyChanged 베이스 클래스
│   │   └── RelayCommand.cs     # ICommand 구현
│   ├── DataViewModel.cs       # 데이터 조회/CSV 내보내기/더미 데이터 로드
│   ├── HomeViewModel.cs       # 2채널 자동 시험, ZMDI/C28 통신, SPEC 교차 검증
│   ├── InOutViewModel.cs      # I/O 모니터 페이징 로직
│   ├── MainViewModel.cs       # 화면 전환, DIO 보드 생성, 앱 생명주기 관리
│   └── ParametersViewModel.cs # 파라미터 설정 (빈 클래스, 로직은 Window에서 직접 처리)
├── Views/                     # UI 화면
│   ├── CommunicationWindow.xaml(.cs) # 통신 설정 (포트/보드레이트)
│   ├── DataView.xaml(.cs)            # 검사 이력 조회/검색/CSV 저장
│   ├── HomeView.xaml(.cs)            # 좌/우 2채널 시험 모니터링
│   ├── InOutView.xaml(.cs)           # I/O 모니터 (INPUT/OUTPUT 구분)
│   └── ParametersWindow.xaml(.cs)    # SPEC UL/LL 설정
├── Manual/                    # 사용자 매뉴얼
│   ├── Communication_Manual.md      # 통신 설정 매뉴얼
│   ├── DataView_Manual.md           # 데이터 조회 매뉴얼
│   ├── HomeView_Manual.md           # 메인 화면 매뉴얼
│   ├── IO_Monitor_Manual.md         # I/O 모니터 매뉴얼
│   └── Parameter_Manual.md          # 파라미터 설정 매뉴얼
├── PCI-Dask.dll               # ADLINK PCIS-DASK 네이티브 DLL
├── App.xaml                   # DataTemplate 매핑 + 공통 스타일
├── MainWindow.xaml            # 메인 Shell (상단바 + 하단 메뉴)
└── MainWindow.xaml.cs         # 시계, 창 관리, 종료 확인

leak_test_project.Tests/       # 단위 테스트 프로젝트 (xUnit/NUnit)

✨ 주요 기능

1. 메인 시험 화면 (Home)

• 좌(LEFT) / 우(RIGHT) 독립 2채널 기밀 시험 상태 실시간 표시
• 측정값(sccm), SPEC 범위(UL/LL), 판정(OK/NG) 실시간 확인
• 판정 결과에 따른 배경색 자동 변경 (OK=녹색, NG=빨간색)
• 좌/우 채널별 상태(Status) 및 오류(Error) 메시지 표시
• ZMDI 센서 ID 정보 (LowID, 제조일, 시리얼, 라인, 제품 구분) 실시간 표시

2. 자동 시험 프로세스 (TestProcessService)

DIO 시작 신호를 기반으로 좌/우 독립 백그라운드 스레드에서 아래 사이클을 반복합니다:

1. DIO 시작 신호 대기: LEFT_START / RIGHT_START 입력 신호 OFF→ON 감지
2. ZMDI 센서 ID 읽기: 4단계 시리얼 명령 시퀀스로 제품 ID 파싱
3. 불량 제품 필터링: 센서의 이전 검사 결과(PrevResult) 확인
4. LEAK 시험 수행: Sentinel C28 최종 결과 수신 대기 (30초 타임아웃)
5. 판정: 프로그램 SPEC(UL/LL) 기반 OK/NG 판정
6. SPEC 교차 검증: 프로그램 판정과 센서 자체 판정(A/R) 비교, 불일치 시 경고
7. 로그 기록: 일일 CSV 파일에 검사 결과 자동 저장
8. DIO 출력: 판정 결과에 따라 OK/NG 출력 신호 전송

3. DIO 보드 제어 (ADLINK PCI)

• ADLINK PCI DIO 보드 연동 (PCIS-DASK API 사용)
• INI 설정 기반 입출력 포인트 매핑 (Settings/DioConfig.ini)
• 10ms 입력 폴링: 백그라운드 Task에서 입력 상태 주기적 감시
• PC_ON 출력: 프로그램 시작 시 가동 신호 ON, 종료 시 OFF
• 지원 보드 타입: PCI_7230, PCI_7432, PCI_7433, PCI_7434, PCI_7250

4. Sentinel C28 통신 제어

• RS-232 시리얼 통신: 기본 9600 baud, 8N1
• 표준 프로토콜 준수: 헤더(XXYYZZZ H) + CRC-8 체크섬 자동 생성
• 다중 데이터 처리: 최종 결과(R), 실시간 스트리밍(S), 메시지(M) 구분 수신
• 자동 재연결: 연결 끊김 시 1초(1000ms) 간격으로 모든 통신(C28, ZMDI)의 자동 복구를 시도하여 사용자 개입 최소화
• 확장성: ICommunication 인터페이스 기반으로 TCP/IP 등 통신 방식 변경 가능

5. 입출력 모니터 (In/Out Monitor)

• INPUT / OUTPUT 신호 상태 확인 (실제 DIO 보드 연동)
• 500ms 주기 자동 갱신: 별도의 새로고침 버튼 없이 DIO 상태가 실시간 업데이트
• 페이지당 30개씩 데이터 표시 및 페이징 기능 (FIRST/PREV/NEXT/LAST)
• 화면 닫기(Close) 시 자동 갱신 타이머 정지

6. 데이터 이력 조회 (Data)

• 기간별, 판정 결과별(OK/NG/전체), 시리얼 번호별 필터링 검색
• 일일 CSV 로그 자동 저장 (검사 완료 시 Logs/yyyy-MM-dd.csv에 즉시 기록)
• 조회된 데이터를 별도 CSV 파일로 내보내기 가능
• 빈 화면에서도 엑셀 시트처럼 항상 표 격자(GridLines)가 유동적으로 유지되도록 최소 50행 표출
• 테스트용 더미 데이터 수동 로드 기능 (버튼 클릭으로 10건 샘플 데이터 생성)

7. 설정 관리

• 파라미터 설정: SPEC UL/LL (sccm) 값 설정 및 저장
• 통신 설정: 좌/우 ZMDI 장비 포트(기본 COM9/COM8, 보드레이트 공유 19200)와 센서 포트(기본 COM1, 보드레이트 9600)를 각각 독립 설정
• XML 설정 파일: config.xml에 자동 저장/로드, 설정 변경 시 ConfigChanged 이벤트를 통해 모든 통신 서비스(Sentinel C28, ZMDI 센서)와 자동 시험 프로세스가 재시작되어 즉시 반영
• DIO 설정 파일: Settings/DioConfig.ini에서 보드 타입, 입출력 포인트 이름/설명 관리

8. 일일 CSV 로그 자동 저장

• 검사 완료 시 Logs/yyyy-MM-dd.csv 파일에 자동 기록
• CSV 헤더: Date, Time, Channel, ID, Value, Judgment, Mode, LineNo, ProductType, SpecUL, SpecLL, Retest
• CSV 값 이스케이프 처리 (쉼표/따옴표/줄바꿈 안전 처리)
• 시스템 텍스트 로그는 yyyy-MM-dd_system.log로 별도 관리

9. 프로그램 안정성

• 프로그램 종료 전 확인 대화상자 표시
• 시리얼 포트, DIO 보드, 타이머 등 리소스 종료 시 안전 해제 (IDisposable 패턴)
• 모든 통신/파일 I/O 구간에 예외 처리 적용
• ZMDI 통신 명령 실패 시 최대 3회 재시도
• 포트 연결 알림: 프로그램 초기화 또는 설정 변경 시 모든 포트(C28, ZMDI Left/Right)의 연결 상태를 즉시 확인하고, 하나라도 실패 시 메인 화면 오류 영역에 즉시 표시 (상세 오류 원인 및 포트 번호 포함)
• 1초 자동 복구: 모든 통신 포트에 대해 1초 주기로 상시 자동 재연결 시도 (재진입 방지 포함)
• 통신 설정 변경 반영: 설정 저장 시 즉시 통신 포트와 자동 시험 프로세스를 재시작하여 프로그램 재시작 없이 설정 변경 내용 적용 가능

📡 기기 통신 프로토콜 및 명령어 (Command Details)

프로그램에서 사용하는 주요 하드웨어 통신 명령어 및 절차입니다.

1. ZMDI 센서 (ID 읽기 및 파싱)

ZMDI 센서와의 통신은 19200 Baud, 8N1 시리얼 통신을 사용하며, 총 4단계의 명령어 시퀀스로 구성됩니다. 모든 명령어는 \r\n을 포함하여 전송되며, 최대 3회 재시도합니다.

단계	역할	주요 명령어 리스트
1단계	초기화 및 통신 확인	V, Pr_D7, Pr_D6, Pr_D5, r
2단계	메모리 접근 준비	tso31150
3단계	데이터 수집 설정	os_10, t11005, OWT7800272D1, OR_78002, OW_780038AA55A, OW_780011A, OR_78002, OW_780038AFF00, OW_78001CF, OR_78004
4단계	ID 메모리 읽기	OW_7800140, OR_78002, OW_7800141, OR_78002, OW_7800142, OR_78002, x9c_990:x

• 읽기 종료: 모든 데이터를 읽은 후 x9c_990:x 명령으로 세션을 종료합니다.
• 데이터 파싱: OR_78002의 응답값들을 조합하여 12자리 이상의 LowID를 생성하고, 이를 디코딩 테이블에 따라 년/월/일/시리얼/라인/아이템 정보를 추출합니다.
• 불량 필터링: 파싱된 PrevResult 필드로 이전 검사 결과를 확인하여 불량 제품을 필터링합니다.

---

2. Sentinel C28 (Leak Test 장비)

Sentinel C28과의 통신은 9600 Baud, 8N1 시리얼 통신을 사용하며, 전용 바이너리/텍스트 혼합 프로토콜을 사용합니다.

• 명령어 구조: [CRC-8][Sequence][Length] [Type][Command]\r\n

  • CRC-8: 헤더와 페이로드를 포함한 8비트 체크섬 (2자리 Hex)
  • Sequence: 명령어 순차 번호 (01~FF, 2자리 Hex)
  • Length: 명령어 페이로드 길이 (3자리 Hex)
  • Type: 데이터 종류 (예: R=Result, S=Streaming, M=Message)
  • Command: 실제 제어 명령어 또는 수신된 데이터 본문

• 주요 데이터 수신:

  • R (Result): 최종 검사 완료 후 수신되는 결과 데이터 (채널#, 시리얼, 측정값, 판정 등 포함)
  • S (Streaming): 시험 진행 중 실시간으로 수신되는 압력/유량 데이터

• SPEC 교차 검증: C28 센서의 자체 판정(A=Accept, R=Reject)과 프로그램의 UL/LL 기반 판정을 비교하여 불일치 시 경고 메시지를 표시합니다.

---

3. ADLINK DIO 보드

ADLINK PCI DIO 보드와의 통신은 PCIS-DASK API(PCI-Dask.dll)를 사용합니다.

• 설정 파일: Settings/DioConfig.ini (INI 형식)

  • [DIO]: CompanyName
  • [BOARD_1]: BoardType, BoardNumber
  • [BOARD_1_IN]: 입력 포인트 매핑 (LEFT_START, RIGHT_START 등)
  • [BOARD_1_OUT]: 출력 포인트 매핑 (LEFT_OK, RIGHT_OK, LEFT_NG, RIGHT_NG, PC_ON 등)

• 기본 입출력 신호:

구분	포인트 이름	설명
INPUT	LEFT_START	좌측 시험 시작 신호
INPUT	RIGHT_START	우측 시험 시작 신호
OUTPUT	LEFT_OK	좌측 합격 출력
OUTPUT	RIGHT_OK	우측 합격 출력
OUTPUT	LEFT_NG	좌측 불합격 출력
OUTPUT	RIGHT_NG	우측 불합격 출력
OUTPUT	PC_ON	PC 가동 신호

---

🛠 유지보수 가이드

• 통신 방식 변경: Infrastructure/ 폴더에 TcpProvider 등을 추가하고 ICommunication을 구현하면 UI 수정 없이 변경 가능
• 프로토콜 수정: Sentinel C28의 명령어나 데이터 형식이 바뀌면 Services/SentinelC28Service.cs와 Utils/SentinelParser.cs 수정
• CRC 알고리즘: 제조사 사양서에 정확한 다항식이 명시되어 있다면 Utils/SentinelCrc8.cs 교체 필요
• 화면 및 스타일: Views/의 .xaml 파일과 App.xaml에서 통합 관리
• 설정 항목 추가: Models/AppConfig.cs에 프로퍼티 추가 후 해당 설정 화면 UI 수정
• DIO 포인트 변경: Settings/DioConfig.ini에서 입출력 포인트 이름/설명을 수정하면 프로그램 재시작 시 반영
• DIO 보드 타입 추가: Infrastructure/RealDioBoard.cs의 GetCardTypeFromConfig() 메서드에 새 보드 타입 매핑 추가
• 시험 프로세스 수정: Services/TestProcessService.cs의 ProcessProc() 메서드에서 시험 단계 추가/변경
• ZMDI 명령 시퀀스 수정: Services/ZmdiSensorService.cs의 _commandList1~4 배열 수정
• ID 디코딩 테이블 수정: Services/ZmdiSensorService.cs의 _yearHexList, _monthList, _dayHexList 등 업데이트
• 사용자 매뉴얼: Manual/ 폴더에서 각 화면별 사용 설명서 확인 및 수정 가능

🧪 테스트

leak_test_project.Tests 프로젝트에서 핵심 서비스의 단위 테스트를 실행할 수 있습니다.

dotnet test leak_test_project.Tests/leak_test_project.Tests.csproj

🚀 실행 방법

1. Visual Studio에서 leak_test_project.slnx 파일을 엽니다.
2. F5 키를 눌러 실행하거나 빌드 후 bin/Debug/leak_test_project.exe를 실행합니다.
3. 로그 파일은 실행 파일과 동일한 경로의 Logs/ 폴더에 자동 생성됩니다.
4. DIO 설정 파일은 Settings/DioConfig.ini에 자동 생성됩니다 (없을 경우 기본값으로 생성).