qa-AgingTester/README.md
2025-07-01 13:28:47 +09:00

137 lines
7.0 KiB
Markdown

# **AGING 프로그램**
## 📌 프로그램 개요
| 항목 | 내용 |
| ---------- | ---------------------------------------------------------------- |
| **프로그램 명** | `AgingTester` |
| **실행 파일 명** | `DUALSONIC Asing.exe` |
| **설치 위치** | 6층 공장 라인 Aging 공정 구역 |
| **용도** | 필름 압착 기계 제어 /필름 작업 공정 중 압착기 동작 시 자동 시간 카운트 및 동작/자동 합불 판정 없음 (검사자가 육안으로 합불 판단)/ 중단 시 자동 불량 처리 |
---
## 🖥️ 프로그램 UI
| 메인 화면 | 실행 화면 |
| ------------------------ | --------------------------- |
| ![메인 화면](docs/aging_main.png) | ![실행 화면](docs/aging_start.png) |
---
## 🔢 기능 요약
| 기능 | 설명 |
| ---------------------------- | ----------------------------------------------------------------------------- |
| **라디오 버튼 선택에 따른 UI 및 설정 분기** | 포트 수(10채널/20채널), 시간 설정 모드에 따라 UI 그룹박스 표시 여부, 시리얼 포트 배열 크기, 초기값, 위치 변경 등 자동 조정 |
| **COM 포트 스캔 및 연결** | 스캔 버튼 클릭 시 PC의 COM 포트 목록 불러오기, 연결 버튼 클릭 시 선택한 포트 오픈 및 설정 저장 |
| **포트별 측정 시작/정지** | 각 채널별 상태에 따라 시작(`start`), 진행(`play`), 중지(`middleStop`, `endStop`) 처리 및 명령 전송 |
| **타이머 기반 시간 카운트다운** | 실행 중인 채널의 남은 시간을 1초씩 감소시키며 UI에 남은 시간 표시, 시간이 0이 되면 자동 정지 및 후속 처리 수행 |
| **상태 및 UI 업데이트** | 버튼 텍스트 및 색상 변경, 상태에 따른 기능 활성화/비활성화, 깜빡임 효과 등으로 진행 상황 시각적 표시 |
| **전체 실행/정지 제어** | 전체 내리기/올리기 버튼을 통해 모든 채널의 상태 일괄 전환 및 타이머 제어 |
| **초기화 및 종료 처리** | 모든 채널 시간 및 UI 초기화, 종료 시 열려 있는 포트 및 쓰레드 안전 종료 및 정리 |
---
## 🔄 검사 순서 흐름도
```
[시작 버튼 클릭]
[cmdRunButton() 실행] → [설정값 저장 및 초기화] → [펌웨어 명령어 전송: agenable chNum, 1] → [SendData() 호출]
[타이머 실행 (cmdTimer_Tick())]
[ReceiveData() 호출] → [펌웨어로부터 데이터 수신]
[메시지 해석] → [UI 업데이트] (예: [avalue], [aerror], [dsfwver])
[자동 종료 조건 체크]
├── [온도 기준 충족 시 → 테스트 자동 종료]
├── [샷 수 기준 충족 시 → 테스트 자동 종료]
└── [에러 발생 시 → 에러 메시지 출력 및 UI 반영]
[결과 저장] → [PostgreUpdateReg() 호출] → [결과 PostgreSQL에 저장]
[중지 버튼 클릭 시]
[agenable chNum, 0] → [펌웨어에 테스트 중지 명령 전송] → [테스트 종료]
```
---
## 🗃️ MES 데이터 저장 구조 (temperature_chambers: 온도 에이징 검사기)
| 필드 이름 | 값 예시 | 설명 | PostgreSQL 컬럼명 | PostgreSQL 값/코드 | Null 허용 |
| --- | --- | --- | --- | --- | --- |
| jig_num | 1 | 지그 번호 (nudJigNum.Value) | chNum | chNum | O |
| jig_ch | 0 | 채널 번호 (0~10) | chNum | chNum | O |
| test_date | 2025-05-09 | 테스트 날짜 (AG_DATE) | AG_DATE | AG_DATE(chNum) | O |
| start_time | 14:32:10 | 테스트 시작 시간 (AG_StartTime) | AG_StartTime | AG_StartTime(chNum) | O |
| run_time | 0:27:50 | 테스트 경과 시간 (txbEndTime) | txbEndTime | txbEndTime((cmdVal(1))).Text | O |
| end_time | 15:00:00 | 테스트 종료 시간 (시스템 시간) | endtime | now | O |
| div_num | DIV001 | 메인 장비 SN (AG_Device_SN) | AG_Device_SN | AG_Device_SN(chNum) | O |
| cart_num | CART001 | 카트리지 SN (AG_Cart_SN) | AG_Cart_SN | AG_Cart_SN(chNum) | O |
| test_result | PASS | 테스트 결과 (PASS / FAIL) | OkNg | OkNg | O |
| limit_div_temp | 60 | 디바이스 온도 기준 (txbDevTemp) | txbDevTemp | txbDevTemp.Text | O |
| limit_cart_temp | 50 | 카트리지 온도 기준 (txbCartTemp) | txbCartTemp | txbCartTemp.Text | O |
| limit_shot | 200 | 샷 수 기준 (txb_limit) | txb_limit | txb_limit.Text | O |
| divtemp_start | 36.5 | 디바이스 시작 온도 (txtMain...) | txtMainStartTemp | txtMainStartTemp(Val(cmdVal(1))).Text | O |
| divtemp_end | 38.1 | 디바이스 종료 온도 (txtMain...) | txtMainEndTemp | txtMainEndTemp(Val(cmdVal(1))).Text | O |
| carttemp_start | 40 | 카트리지 시작 온도 | txtCartStartTemp | txtCartStartTemp(Val(cmdVal(1))).Text | O |
| carttemp_end | 48 | 카트리지 종료 온도 | txtCartEndTemp | txtCartEndTemp(Val(cmdVal(1))).Text | O |
| run_shot | 201 | 총 샷 수 (txbShotCnt) | txbShotCnt | txbShotCnt(Val(cmdVal(1))).Text | O |
| error_code | 0 | 에러 코드 (빈 값 또는 코드, 0=정상) | AG_ERROR | AG_ERROR(chNum) | O |
| created_at | 2025-05-09 15:00:00 | 등록 시간 (NOW()) | created_at | NOW() | O |
| updated_at | 2025-05-09 15:00:00 | 수정 시간 (NOW()) | updated_at | NOW() | O |
---
## 📎 기타 참고 자료 (흐름도)
```mermaid
flowchart TD
A[프로그램 시작] --> B[설정 파일 읽기]
B --> C[설정값 UI 반영<br/>or 기본값 저장]
C --> D[시작 버튼 클릭]
D --> E[채널별 반복 실행]
E --> F[버튼 텍스트 '중지'로 변경]
F --> G[통신 플래그 및 UI 상태 초기화]
G --> H[JSON 데이터 초기화]
H --> I[장비 시작 명령 전송<br/>agenable chNum, 1]
I --> J[타이머 실행 시작]
J --> K[타이머 tick 발생]
K --> L[ReceiveData 호출<br/>펌웨어 데이터 수신]
L --> M[샷 수/온도 UI 갱신]
M --> N{자동 종료 조건 충족?}
N -->|예| O[중지 버튼 클릭 처리 시나리오로 진입]
N -->|아니오| K
O[중지 버튼 클릭 시작 텍스트로 변경] --> P[타이머 중지 및 상태 초기화]
P --> Q[테스트 중지 명령 전송<br/>agenable chNum, 0]
Q --> R[샷 수 / 온도 기준 판정]
R --> S{합격 기준 충족?}
S -->|PASS| T[결과 표시: PASS<br/>UI 초록색, 로그 저장]
S -->|FAIL| U[결과 표시: FAIL<br/>UI 빨간색, 로그 저장]
T --> V[PostgreSQL 등록]
U --> V
V --> W[SQL INSERT 실행<br/>temperature_chambers 테이블 기록]
W --> X[UI 및 로그 갱신]
X --> Y{다른 채널 남았는가?}
Y -->|예| E
Y -->|아니오| Z[프로그램 종료 or 대기 상태]
```