K-SCADA
통합 관제 및 자동화 시스템 사용자 매뉴얼
Version 1.0.3

# 개요 및 시작하기

## 프로그램 소개

K-SCADA는 산업 현장의 다양한 통신 프로토콜을 통합하여 실시간 모니터링, 데이터 수집, 그리고 현장 설비를 시각적으로 관제(작화) 할 수 있는 강력한 자동화 솔루션입니다. 직관적인 사용자 인터페이스와 드래그 앤 드롭 방식의 작화 편집기를 통해 복잡한 제어 로직을 쉽게 시각화할 수 있습니다.

- 범용 통신 지원: Modbus TCP, Modbus RTU (Serial) 및 추후 확장 가능한 프로토콜 레이어 내장
- 직관적 작화 툴: 시스템 내 자체 그래픽 편집기 제공으로 드래그 앤 드롭 화면 설계 지원
- 데이터 로깅: 수집된 센서/장비 데이터를 주기적으로 CSV 파일로 기록하고 분석 지원
- 프로젝트 관리: 사이트나 장비별로 독립된 프로젝트 설정 및 다중 관리 기능

## 설치 및 시스템 환경 설정

K-SCADA를 실행하기 위한 기본 설치 과정은 다음과 같습니다.

1. 제공받으신 설치 파일 (`K-SCADA-Setup-x.x.x.exe`)을 실행합니다.
2. 설치 마법사의 안내에 따라 설치를 진행합니다. (기본 설치 경로: `C:\K-SCADA`)
3. 설치가 완료되면 바탕화면에 생성된 K SCADA 아이콘을 더블클릭하여 프로그램을 시작합니다.

⚠️

백신 오탐지 안내: K-SCADA는 내장된 백엔드 서버 엔진을 실행하므로 윈도우 디펜더나 보안 프로그램에서 네트워크 접속 허용(방화벽 예외)을 요구할 수 있습니다. 반드시 [허용]을 선택해주세요.

# 시스템 로그인 및 프로젝트 관리

## 로그인 화면 구성

프로그램을 처음 실행하면 로그인 화면이 나타납니다. K-SCADA는 계정에 따라 관리형(edit) 모드와 조회 타임아웃 제한 등을 적용할 수 있습니다. (엔터프라이즈 라이선스의 경우 제한 없음)

### 로그인 방법

1. 아이디: 초기 부여된 관리자 아이디를 입력합니다. (기본값: `admin`)
2. 비밀번호: 초기 비밀번호를 입력합니다. (기본값 제공됨)
3. 화면 상단의 언어 변환(🇰🇷/🇺🇸) 버튼을 눌러 UI 언어를 즉시 변경할 수 있습니다.
4. 다크 모드, 라이트 모드 테마 스위치를 이용하여 현장에 맞는 테마 환경을 구성하세요.

## 다중 프로젝트 관리

K-SCADA는 사이트나 장비 세트에 따라 여러 개의 프로젝트를 생성하고 전환할 수 있습니다. 로그인 창 중앙의 프로젝트 선택 드롭다운 메뉴를 확인해주세요.

- 새 프로젝트 만들기: 드롭다운 안의 `[+ 새 프로젝트]`를 선택하여 관리할 현장 이름을 입력합니다. 해당 이름으로 데이터베이스와 설정이 격리됩니다.
- 기존 프로젝트 열기: `[폴더 열기...]`를 통해 다른 기기에서 백업받은 프로젝트 폴더를 지정하여 바로 실행할 수 있습니다.
- 프로젝트 삭제: 더 이상 사용하지 않는 프로젝트는 휴지통 아이콘을 눌러 영구 삭제할 수 있습니다.

💡

활용 팁: 테스트용 프로젝트와 실 운영 프로젝트를 분리하여 먼저 화면(작화) 및 통신 태스트를 마친 후, 실 운영 프로젝트에 적용해 보십시오.

# 통신 및 디바이스 설정

## 장치(Device) 연결 통신 설정

현장 PLC, 인버터 시스템과 통신하기 위해서는 메인 메뉴에서 [통합 설정] 창을 열거나 상단의 `통신 설정` 아이콘을 누릅니다.

### Modbus TCP 설정

이더넷 네트워크를 통해 장비와 통신하는 방식입니다.

- IP 주소: 통신할 대상 장비의 IP 노드 주소를 입력합니다. (예: `192.168.0.100`)
- 포트: Modbus TCP의 기본 포트는 `502`입니다.
- 통신 간격 (ms): 데이터 수집 주기입니다. 안정적인 통신을 위해 `1000ms ~ 2000ms`을 권장합니다.

### Modbus RTU (Serial) 설정

RS-232, RS-485 케이블 등을 통해 통신하는 방식입니다. USB to Serial 컨버터를 사용하는 경우 장치 관리자에서 할당된 COM 포트를 먼저 확인해야 합니다.

- COM 포트: 연결된 시리얼 포트를 선택합니다. (예: `COM3`, `COM5`)
- Baud Rate: 통신 속도입니다. 대상 장비와 동일하게 맞춰야 합니다. (예: `9600`, `19200`)
- 장비 국번 (Unit ID/Slave ID): 연결된 장비의 ID 주소입니다. 기본값은 보통 `1`입니다.
- 통신 간격 (ms): 시리얼 통신은 대역폭이 좁으므로 너무 빠른 주기로 폴링하면 에러가 납니다. 최소 `1500ms ~ 2000ms` 지정이 안전합니다.

## 태그 검색 (Tag Discovery) 자동 등록

K-SCADA는 사전 매핑된 규칙에 의해 일일이 어드레스를 기입할 필요 없이 장비로부터 포인트들을 검색해올 수 있습니다.

1. 메인 화면 진입 후 우측 상단의 [태그 검색] 메뉴로 이동합니다.
2. 좌측의 디바이스 트리 구조에서 검색을 원하는 `AI, AO, DI, DO` 중 하나를 선택합니다.
3. 선택 후 우측 영역의 [검색] (Discover) 버튼을 클릭하면 소프트웨어가 장비의 레지스터를 조회하여 결과를 테이블로 리스팅합니다.
4. 등록하고자 하는 태그를 체크 박스로 선택한 뒤, `[선택한 태그 추가]` 버튼을 누르면 프로젝트에 반영됩니다.

ℹ️

스케일링(Scaling): 아날로그 입력(AI) 포인트 중에서 온도, 전압, 전류 등 소수점 표현이 필요한 데이터는 내부적으로 자동으로 스케일 팩터가 곱해져 표시됩니다. (예: 0.1, 0.001)

# 그래픽 작화 화면 편집 (Graphic Editor)

## 디자인 모드 개요

현장의 시스템 흐름도(P&ID)나 UI 대시보드를 스스로 디자인할 수 있습니다. 상단 메뉴 [도구] - [편집 모드 (단축키: Ctrl+E)]로 진입하면 화면이 편집 가능한 상태가 됩니다.

### 팔레트 (Palette) 사용

편집 모드로 진입하면 왼쪽 혹은 별도 창에 팔레트 메뉴가 노출됩니다.

- 기본 컴포넌트: 텍스트 상자(Symbol Text), 버튼, 데이터 그래프, 토글형 스위치 등을 끌어다 캔버스 위에 배치합니다.
- 라이브러리 기호: 펌프, 쿨링 타워, 탱크 하우징, 배관 파이프 등의 미리 그려진 심볼 벡터 이미지가 제공됩니다.
- 사용자 지정 이미지: 회사 로고, 현장 실사 사진 등을 `[이미지 불러오기]` 버튼을 통해 업로드하고 자유롭게 작화에 사용할 수 있습니다.

### 태그 데이터 바인딩 (연결)

화면에 올려진 텍스트 상자나 이미지의 상태가 장비 실제 값에 따라 변하게 하려면 데이터를 연결(Bind)해야 합니다.

1. 캔버스에 올려진 컴포넌트 객체를 클릭하여 선택합니다.
2. 우측에 나타나는 특성 (Properties) 탭을 엽니다.
3. `값 태그 (Value Tag)` 항목에서 앞에서 [태그 검색]을 통해 등록했던 특정 태그 이름을 드롭다운에서 선택합니다.
4. `저장` 또는 작업 완료 후 편집 모드를 종료하면 즉시 해당 디바이스의 실제 값이 표시되기 시작합니다.

⚠️

통신 상태 확인: 설정한 태그 화면에 데이터가 뜨지 않거나 `Error`, `Disconnected`가 표시된다면 ①통신 케이블 연결 상태 ②통신 포트 재확인 ③태그의 실제 어드레스 유효성을 점검하세요.

# 데이터 로깅 시스템 (Data Collection)

## 데이터 수집 주기 및 저장 방식

K-SCADA는 현재 실시간으로 통신되는 주요 데이터들을 사용자가 원하는 주기마다 `.CSV` 형태의 엑셀 호환 문서로 백업/기록하는 기능이 내장되어 있습니다.

1. 상단 메뉴바 [보기] - [데이터 수집] (또는 Tools - 데이터 로거)을 클릭합니다.
2. 데이터 수집 설정 팝업창에서 로깅 주기를 지정합니다. (예: `1분, 5분, 30분, 시간 단위`)
3. 설정이 완료되면 시스템 백엔드는 지정된 저장 경로 (기본값: C:\K-SCADA\logs) 폴더 안에 날짜별로 파일명을 자동 생성하여 데이터를 쉼표 기반 시계열 포맷으로 누적 저장합니다.

## 로깅 데이터 활용

저장된 CSV 파일은 마이크로소프트 엑셀(Excel)에서 열어서 열 별로 정렬하거나, 차트를 그려 장비의 이상 유무(온도 스파이크, 에러 빈도) 등의 히스토리 데이터를 열람하는데 유용합니다.

ⓒ 2026 K-SCADA Architecture Team. All rights reserved.
고객 지원 및 라이선스 안내: scada.kr