marking_gui/marking_gui/Manual/02_초기_설정.md

# 2. 초기 설정 가이드

[← 메뉴얼 목차로 돌아가기](사용자_메뉴얼.md)

---

## 2.1 프로그램 설정 구성 개요

본 프로그램은 정상적인 계측기 통신 및 데이터베이스 연동을 위해 몇 가지 설정 파일을 사용합니다. 이 설정 파일들은 프로그램 설치 및 라인 도입 시 최초 1회 셋업을 원칙으로 하며, 일반 운영자가 직접 설정 파일을 열어 수정할 필요는 없습니다.

*참고: 대부분의 검사 기준 및 통신 정보는 프로그램 내의 **'통신 설정'** 및 **'시험 설정'** 화면을 통해 수정할 수 있습니다.*

### 2.1.1 주요 설정 정보 구분

1. **장비 및 계측 설정**
   - 계측기들과의 네트워크 연결 주소와 대기 시간 등을 정의합니다.
   - 제품 합격 여부를 판정하는 전압, 전류, 저항의 기본 합격 규격 범위가 이 파일에 저장되며, 화면 내의 **'시험 설정'** 창에서 수정한 사항이 이 파일에 동적으로 반영됩니다.
   - 프로그램은 전압/저항 측정 장치와 전원/전류 공급 장치를 제어하여 계측을 진행합니다.
   
2. **생산 데이터베이스 연동 설정**
   - 공장 생산 관리 시스템 데이터베이스와의 통신 경로가 기록되어 있습니다.
   - 전산망이나 DB 서버 점검 등으로 인해 통신이 어려울 경우, 설정 파일을 통해 **'오프라인 모드'**로 전환하여 단독으로 장비 작동 테스트를 해볼 수 있습니다.
     - **오프라인 로그인 지원**: 데이터베이스 확인 단계 없이 로그인하여 프로그램을 기동합니다.
     - **오프라인 검사 지원**: 제품 이력 조회 및 검사 결과 저장을 건너뛰고 단독으로 계측 및 마킹을 실행합니다.
   
3. **센서 판독기 설정**
   - 제품 일련번호를 로드하기 위한 통신 채널 및 연결 포트 주소가 정의됩니다.
   - 화면 내의 **'통신 설정'** 창에서 수정한 사항이 이 파일에 자동으로 저장됩니다.

### 2.1.2 설치 경로(`C:\marking\`) 내 파일 배치 구조

프로그램 설치 완료 후 `C:\marking\` 경로에는 다음과 같이 구동 파일, 설정 파일, 드라이버 라이브러리 및 런타임 자동 생성 디렉터리가 배치됩니다.

* **`C:\marking\marking_gui.exe`**: GUI 제어 메인 실행 파일
* **`C:\marking\Setting.ini`**: 장비 통신 IP, 마킹 태그, 규격 임계치(`[Limits]`) 종합 설정 파일
* **`C:\marking\Database.ini`**: MS-SQL DB 접속 정보 및 오프라인 모드 설정 파일
* **`C:\marking\Sensor.ini`**: 4251 센서 통신 보드 포트/속도/채널 설정 파일
* **`C:\marking\libs\`**: C++ LMC 레이저 각인 드라이버 라이브러리 격리 폴더 (`MarkEzdWrapper.dll` 등)
* **`C:\marking\logs\`**: 런타임 가동 중 자동 생성되는 일별 이력 로그 폴더 (`yyyy-MM-dd.log`)
* **`C:\marking\publish_backup\`**: 업데이트/배포 시 이전 버전 바이너리 및 설정 자동 백업 폴더

### 2.1.3 기본적인 설정 파일 편집 방법

> [!IMPORTANT]
> **[권장 조치 안내]**
> 현장 라인 검사자 및 일반 작업자는 프로그램 UI의 **[통신 설정]** 및 **[시험 설정]** 메뉴를 통해 안전하게 파라미터를 변경하십시오.
> 아래의 `.ini` 파일 직접 수정은 라인 엔지니어 또는 설비 관리자 전용 권한 작업이며, 잘못된 파일 수정 시 장비 통신 오류가 발생할 수 있습니다.

설비 이동이나 네트워크 환경 변경 시, 프로그램 폴더 내의 각 `.ini` 파일을 텍스트 편집기(메모장 등)로 열어 아래의 전체 설정 레이아웃 항목을 참조하여 수정할 수 있습니다.

#### 1) Setting.ini (주요 변경 가능 설정)
현장 네트워크 IP, 도안 파일 경로 및 검사 규격(임계치) 변경 시 수정하는 주요 설정 항목입니다.
```ini
[Settings]
EzdFolderPath=c:\EzCad\EasyCfg    ; EZD 도안 파일 기본 탐색/저장 폴더 경로
test=false                       ; 테스트 마킹 버튼 및 개발 모드 노출 여부 (true/false)

[Equipment]
Timeout=5000                     ; 계측기 통신 타임아웃 (ms)
SettleMilliseconds=2000          ; 테스트 전원 인가 후 측정 안정화 대기 시간 (ms)

[DMM]
VoltageHost=192.168.10.100        ; 전압(Voltage) 측정용 계측기 IP 주소(예시)

[ResistanceDMM]
ResistanceDMMHost=192.168.10.101  ; 저항(Resistance) 측정용 계측기 IP 주소(예시)

[PowerSupply]
CurrentHost=192.168.10.102        ; 전원 공급기(Power Supply) 및 전류 측정 장치 IP 주소(예시)

[Limits]
MinVoltage=1.00                  ; 전압 하한 판정 기준값 (V)
MaxVoltage=6.00                  ; 전압 상한 판정 기준값 (V)
MinCurrent=5.00                  ; 전류 하한 판정 기준값 (mA)
MaxCurrent=10.00                 ; 전류 상한 판정 기준값 (mA)
MinResistance=8.000              ; 저항 하한 판정 기준값 (kΩ)
MaxResistance=13.000             ; 저항 상한 판정 기준값 (kΩ)
```

#### 2) Database.ini (주요 변경 가능 설정)
DB 서버 접속 주소 및 점검용 오프라인 모드 변경 시 수정하는 항목입니다.
```ini
[Database]
Db_Server=192.168.10.10, 1433    ; MSSQL 데이터베이스 서버 IP 주소 및 포트
Db_Name=NE1aW_PT_Sensor          ; 연결할 데이터베이스 이름
Db_User=su                       ; DB 접속 사용자 계정
Db_Password=amotech821           ; DB 접속 비밀번호

[Login]
Procedure=dbo.CheckOperator      ; 작업자 로그인 검증용 저장 프로시저명
ProcessName=Marking              ; 공정 구분 코드
OfflinePreview=false             ; DB 연결 우회 오프라인 모드 (true: DB 생략, false: 실제 DB 검증)
```

#### 3) Sensor.ini (주요 변경 가능 설정)
바코드 스캐너 시리얼 포트 및 채널 설정 항목입니다.
```ini
[Sensor]
Port=COM3                        ; 바코드 스캐너 시리얼 포트 (장치 관리자 COM 포트 번호)
BaudRate=115200                  ; 시리얼 통신 속도 (기본값: 115200)
Channel=1                        ; 통신 채널 번호 (1 또는 2)
```

---

## 2.2 최초 실행 및 장비 점검 순서

라인 가동 전 최초 실행할 때는 아래 단계를 순서대로 이행하여 정상 작동 여부를 점검하십시오.

1. **프로그램 단일 설치 (MarkingSetup.exe)**
   - 배포받은 단일 설치 마법사 `MarkingSetup.exe`를 실행하여 1-Click으로 `C:\marking\` 설치 및 바탕화면 바로가기를 자동 생성합니다.
2. **데이터베이스 연결 상태 확인**
   - 데이터베이스가 점검 중인 경우 설정 파일을 통해 오프라인 모드로 설정하면 로그인 창을 통과하여 단독 테스트를 진행할 수 있습니다.
3. **장비 네트워크 통신 점검**
   - 제어 PC와 계측 장비들(전압/저항 측정 장비, 전원 공급 장치) 간의 LAN 케이블 연결을 확인합니다.
   - 제어 PC의 네트워크 IP 환경이 장비들의 대역과 동일한지 확인하고, 통신 신호가 정상적으로 송수신되는지 점검합니다.
4. **상시전원 자동 인가 확인**
   - 프로그램 실행 후 작업자 계정으로 로그인을 시도합니다.
   - 로그인이 완료되면 전원 공급 장치의 상시전원 채널 전원 램프가 자동으로 켜지는지 확인합니다.