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

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

📂 프로젝트 파일 구조

leak_test_project/
├── Infrastructure/            # 하드웨어 통신 계층 (Low-Level Communication)
│   ├── ICommunication.cs      # 통신 방식(Serial, TCP) 추상화 인터페이스
│   └── SerialProvider.cs      # RS232 시리얼 통신 구현체 (8N1, IDisposable)
├── Models/                    # 데이터 모델
│   ├── AppConfig.cs           # 앱 설정 (Port, BaudRate, Spec UL/LL)
│   ├── InOutItem.cs           # I/O 항목 모델 (Address, Name, Description)
│   ├── InspectData.cs         # 검사 결과 데이터 모델
│   └── ParsedData.cs          # Sentinel C28 파싱 결과 모델
├── Services/                  # 비즈니스 로직 및 기기 제어
│   ├── IoBoardService.cs      # I/O 보드 서비스 (더미 데이터, LEFT/RIGHT 구분)
│   └── SentinelC28Service.cs  # Sentinel C28 프로토콜 (자동 재연결 포함)
├── Utils/                     # 유틸리티
│   ├── ConfigManager.cs       # XML 기반 설정 관리 (Load/Save)
│   ├── CsvExporter.cs         # 범용 CSV 내보내기
│   ├── 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채널 통신, 측정, 판정, 로그 기록
│   ├── InOutViewModel.cs      # I/O 모니터 페이징 로직
│   ├── MainViewModel.cs       # 화면 전환 및 앱 생명주기 관리
│   └── ParametersViewModel.cs # 파라미터 설정 (예비)
├── Views/                     # UI 화면
│   ├── CommunicationWindow.xaml(.cs) # 통신 설정 (포트/보드레이트)
│   ├── DataView.xaml(.cs)            # 검사 이력 조회/검색/CSV 저장
│   ├── HomeView.xaml(.cs)            # 좌/우 2채널 시험 모니터링
│   ├── InOutView.xaml(.cs)           # I/O 모니터 (LEFT/RIGHT 구분)
│   └── ParametersWindow.xaml(.cs)    # SPEC UL/LL 설정
├── App.xaml                   # DataTemplate 매핑 + 공통 스타일
├── MainWindow.xaml            # 메인 Shell (상단바 + 하단 메뉴)
└── MainWindow.xaml.cs         # 시계, 창 관리, 종료 확인

✨ 주요 기능

1. 메인 시험 화면 (Home)

• 좌(LEFT) / 우(RIGHT) 독립 2채널 기밀 시험 상태 실시간 표시
• 측정값(sccm), SPEC 범위(UL/LL), 판정(OK/NG) 실시간 확인
• 판정 결과에 따른 배경색 자동 변경 (OK=녹색, NG=빨간색)
• 하단 제품/센서 통신 로그 출력 (최대 500줄 유지, 자동 스크롤)

2. Sentinel C28 통신 제어

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

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

• INPUT / OUTPUT 신호 상태 확인 (LEFT/RIGHT 구분)
• 페이지당 30개씩 데이터 표시 및 페이징 기능 (FIRST/PREV/NEXT/LAST)

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

• 기간별, 판정 결과별(OK/NG/전체), 시리얼 번호별 필터링 검색
• 일일 CSV 로그 자동 저장 (검사 완료 시 Logs/yyyy-MM-dd.csv에 즉시 기록)
• 조회된 데이터를 별도 CSV 파일로 내보내기 가능
• 빈 화면에서도 엑셀 시트처럼 항상 표 격자(GridLines)가 유동적으로 유지되도록 표출 전용 패딩 적용
• 로그 파일이 없는 경우 더미 데이터 자동 생성

5. 설정 관리

• 파라미터 설정: SPEC UL/LL (sccm) 값 설정 및 저장
• 통신 설정: 좌/우 메인(ZMDI) 장비 포트와 센서(Leak Sensor) 포트의 통신 속도를 각각 독립적으로 분리 설정 (ZMDI 기본 19200, 센서 기본 9600)
• XML 설정 파일: config.xml에 자동 저장/로드, 설정 변경 시 실시간 반영

6. 일일 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로 별도 관리

7. 프로그램 안정성

• 프로그램 종료 전 확인 대화상자 표시
• 시리얼 포트, 타이머 등 리소스 종료 시 안전 해제
• 모든 통신/파일 I/O 구간에 예외 처리 적용
• UI 로그 메모리 누수 방지 (최대 500줄 제한)

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

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

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

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

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

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

---

2. Sentinel C28 (Leak Test 장비)

Sentinel C28과의 통신은 115200 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): 시험 진행 중 실시간으로 수신되는 압력/유량 데이터

---

🛠 유지보수 가이드

• 통신 방식 변경: Infrastructure/ 폴더에 TcpProvider 등을 추가하고 ICommunication을 구현하면 UI 수정 없이 변경 가능
• 프로토콜 수정: Sentinel C28의 명령어나 데이터 형식이 바뀌면 Services/SentinelC28Service.cs와 Utils/SentinelParser.cs 수정
• CRC 알고리즘: 제조사 사양서에 정확한 다항식이 명시되어 있다면 Utils/SentinelCrc8.cs 교체 필요
• 화면 및 스타일: Views/의 .xaml 파일과 App.xaml에서 통합 관리
• 설정 항목 추가: Models/AppConfig.cs에 프로퍼티 추가 후 해당 설정 화면 UI 수정

🚀 실행 방법

1. Visual Studio에서 leak_test_project.slnx 파일을 엽니다.
2. F5 키를 눌러 실행하거나 빌드 후 bin/Debug/leak_test_project.exe를 실행합니다.
3. 로그 파일은 실행 파일과 동일한 경로의 Logs/ 폴더에 자동 생성됩니다.