f1c11931fe
Point Builder, SteamAdvisor, Feedforward 제어, MCP RAG/NL2SQL, multi-controller 지원 등 28커밋 분량 기능 통합. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
HC900 Crawler
Honeywell HC900 공정 컨트롤러를 Modbus TCP로 직접 폴링하여 PostgreSQL에 적재하고, 웹 UI · RAG · NL2SQL · 피드포워드 제어 권고를 제공하는 산업용 모니터링 플랫폼.
기존 Experion R530의 OPC UA 데이터 경로를 HC900 직접 통신으로 대체한 프로젝트로, 물리 플랜트·공정·계기·로직은 동일하고 통신 계층만 교체되었다.
변경 전: HC900 ──Modbus TCP──▶ Experion R530 ──OPC UA──▶ ExperionCrawler ──▶ PostgreSQL
변경 후: HC900 ──Modbus TCP──▶ C++ Gateway ──gRPC──▶ HC900Crawler ──▶ PostgreSQL
저장소
git clone https://git.hanmocnn.co.kr/windpacer/HC900-Crawler.git
사내 git 서버. HTTPS 자격증명(사번 계정)으로 접근한다.
아키텍처
┌──────────┐ Modbus TCP ┌──────────────┐ gRPC ┌──────────────┐ EF Core ┌────────────┐
│ HC900 │ ◀───────────▶ │ C++ Gateway │ ◀───────▶ │ C# Crawler │ ◀─────────▶ │ PostgreSQL │
│ C70 PLC │ :502 │ hc900_gateway│ :50051 │ ASP.NET 8 │ │ (hc900) │
└──────────┘ └──────────────┘ │ + Web UI │ │ TimescaleDB│
└──────┬───────┘ └────────────┘
│ HTTP :5001
┌──────▼───────┐
│ Python MCP │ RAG / NL2SQL / P&ID
│ FastMCP │
└──────────────┘
구성 요소
| 디렉토리 | 설명 |
|---|---|
industrial-comm/cpp/ |
C++ 게이트웨이 — Modbus TCP 폴러 + gRPC 서버 (hc900_gateway 바이너리) |
src/Hc900Crawler/ |
C# .NET 8 ASP.NET Core — gRPC 클라이언트 + 웹 UI + KB/P&ID/FF (포트 5000) |
src/Core/, src/Infrastructure/ |
도메인 엔티티 · DB · 서비스 (3-Layer 아키텍처) |
mcp-server/ |
Python FastMCP 서버 (포트 5001) — RAG, NL2SQL, P&ID 처리 |
scripts/, test/ |
레지스터 맵 생성 · 테스트 유틸 |
prompts/, knowledge/ |
LLM 시스템 컨텍스트 · RAG 기본 문서 |
다중 컨트롤러(N-Controller) 지원: config/gateway-config.json의 controllers[]에
컨트롤러를 추가하면 게이트웨이 인스턴스가 컨트롤러별 gRPC 포트로 개별 기동된다.
빠른 시작
1. C++ 게이트웨이 빌드
gRPC · abseil은 /tmp/grpc_local, /tmp/absl_local(aarch64)에 사전 설치되어 있다.
cd industrial-comm/cpp
mkdir -p build && cd build
cmake .. && make -j$(nproc)
# 산출물: build/hc900_gateway, build/libcomm_core.so
직접 실행:
./build/hc900_gateway [host] [register-map] [poll_ms] [grpc_port] [modbus_port]
# 기본값: 192.168.0.240 docs/register-map.json 1000 50051 502
# 로그: /tmp/hc900_gateway.log, gRPC: 0.0.0.0:50051
2. C# 크롤러 빌드 · 실행
cd src/Hc900Crawler
dotnet build
dotnet run # 웹 UI: http://0.0.0.0:5000
크롤러는 부팅 시
config/gateway-config.json을 읽어 게이트웨이 프로세스를 직접 기동·감시한다. 게이트웨이를 따로 실행할 필요 없이 크롤러만 띄우면 된다.
설정: src/Hc900Crawler/appsettings.json
ConnectionStrings.DefaultConnection— PostgreSQL (Search Path=hc900)Hc900.PollIntervalMs,Kb.*,DocBrowser.*등
3. MCP 서버 (RAG / NL2SQL)
cd mcp-server
uv sync # 의존성 (최초 1회)
uv run python server.py --http # 포트 5001
4. 레지스터 맵 생성
HC Designer CSV 내보내기 → docs/register-map.json (게이트웨이가 기동 시 로드):
python3 scripts/build_register_map.py \
--loop-csv docs/SummaryFucntionBlockReport.csv \
--signal-csv docs/SignalTags.csv \
--variable-csv docs/Variables.csv \
-o docs/register-map.json
웹 UI 탭
| 탭 | 기능 |
|---|---|
| Setup | 게이트웨이 프로세스 제어 · 다중 컨트롤러 설정 · 로그 |
| 태그 관리 | HC900 등록 태그 조회 · 폴링 활성화 관리 |
| 이력 조회 | history_table 시계열 조회 (TimescaleDB 하이퍼테이블) |
| Text-to-SQL | 자연어 → SQL (MCP) |
| fastRecord | 고속 샘플링 세션 수집 · CSV 내보내기 |
| P&ID 추출 | 도면 파싱 · 계기 추론 |
| 이벤트 히스토리 | 디지털 포인트 상태 변경 (TRIP/ALARM/RUN) |
| 로컬 LLM 채팅 | Ollama/vLLM 기반 플랜트 지식 채팅 |
| RAG 관리 | 지식 문서 업로드 · Qdrant 색인 |
| 태그 쓰기 | gRPC WriteTag (SP/OP/MODE) |
| 문서 탐색기 | 리포지토리 문서 브라우징 |
| 트렌드 | 실시간/이력 차트 + 이벤트 오버레이 |
| 유량 권장(FF) | 측류추출 피드포워드 제어 권고 |
데이터베이스 (PostgreSQL, 스키마 hc900)
Hc900DbContext.InitializeAsync()가 모든 테이블·뷰·하이퍼테이블을 자동 생성한다.
| 테이블 | 용도 |
|---|---|
hc900_map_master |
OPC UA tagname ↔ HC900 레지스터 매핑 (Modbus addr 포함) |
realtime_table |
실시간 값 (controller_id, tagname UNIQUE) |
history_table |
60초 이력 스냅샷 (TimescaleDB 하이퍼테이블) |
event_history_table |
디지털 태그 상태 변경 이벤트 |
tag_metadata |
태그 메타 (description, area, state 레이블) |
pid_*, kb_*, ff_* |
P&ID · Knowledge Base · 피드포워드 |
HC900 하드웨어
- 컨트롤러: HC900-C70, Modbus TCP 포트 502, 최대 동시 연결 10
- Float 포맷은 컨트롤러에서 FP B (IEEE 754 big-endian, 워드 순서 4·3·2·1)로 설정 필요
- 레지스터 주소: Loop N base =
0x40 + (N-1)*0x100(1–24),0x7840 + (N-25)*0x100(25–32)
라이선스
Proprietary — 내부 사용.