기브온 IBL 현장 컨트롤러 셋업 가이드

1

제어 시스템 개요

Phase 1·2 전체 구성 및 흐름

Phase 1 Phase 2

Phase 1 — 즉시 사용 가능

StreamDeck+ 단독 구성

🎛️ 장비: Kwang 소유 StreamDeck+ (LCD 버튼 8개 + 터치스크린 놉 4개)
💾 소프트웨어: Bitfocus Companion — 무료. 현재 미설치 → 도입 필요
🔗 제어 경로: StreamDeck+ → Companion HTTP 액션 → Helios REST API PATCH
✅ 적합 파라미터: Blackout 토글, Freeze, Preset 불러오기, 테스트 패턴, 그룹 선택
⚠️ 한계: 놉 회전은 증분 제어 (절대값 페이더 아님) — 정밀 연속 제어는 Phase 2 권장

Phase 2 — 권장 구성

전동 MIDI 페이더 추가 (X-Touch Compact)

🎚️ 장비: Behringer X-Touch Compact — 9채널 전동 모터 페이더 + 놉 포함
🔄 자동 싱크: Companion 타이머가 1초 주기로 Helios 현재값 조회 → 페이더 모터 위치 업데이트
🎯 결과: 웹 UI로 값 변경해도 X-Touch 페이더가 해당 위치로 자동 이동 → 항상 현재 상태 반영
💵 비용: ~$399 USD / ₩57만원대

ℹ️

Helios REST API 엔드포인트 PATCH http://192.168.1.108/api/v1/public 모든 Companion 액션은 이 엔드포인트로 JSON body를 전송한다.

2

Bitfocus Companion 설치 및 기본 설정

다운로드 → 모듈 추가 → IP 설정

Phase 1+2

설치

1

다운로드: https://bitfocus.io/companion — 무료, macOS/Windows 지원
2

설치 후 실행 → 브라우저에서 http://localhost:8888 접속
3

Connections 탭 → "Add Connection" 클릭

Megapixel Helios 모듈 추가

1

검색창에 "Megapixel Helios" 입력 → 모듈 선택 → Add
2

설정 패널에서 IP 주소 입력: 192.168.1.108 (현장 Helios IP)
3

연결 상태가 초록색 점으로 변하면 연결 성공

Generic MIDI 모듈 추가 (Phase 2)

1

X-Touch Compact USB 연결 → macOS에서 MIDI 장치로 인식되는지 확인 (Audio MIDI Setup)
2

Companion → "Generic MIDI" 모듈 추가
3

MIDI Input/Output 장치를 "X-Touch Compact" 로 선택
4

X-Touch Compact를 MC 모드 OFF, Raw MIDI CC 모드로 설정 (뒷면 DIP 스위치 또는 패널 설정)

⚠️

X-Touch Compact 모드 주의 기본 MC (Mackie Control) 모드에서는 Raw MIDI CC 값이 다르게 동작한다. 반드시 "Standard MIDI" 또는 Raw CC 모드로 변경 후 사용.

3

Helios Companion 모듈 — 주요 액션 목록

버튼/놉에 할당 가능한 전체 액션

Phase 1+2

액션	파라미터 범위	Helios API 키	사용 예
Set Brightness	`0–100%`	`display.brightness`	놉 회전 ±5%
Set CCT	`1667–10000K`	`display.cct`	화이트밸런스 조절
Set Duv / Tint	`-0.01 ~ +0.01`	`display.cctDuv`	그린–마젠타 틴트
Set Gamma	`0–4`	`display.gamma`	감마 곡선 조절
Blackout	`on / off`	`display.blackout`	즉각 블랙아웃 토글
Freeze	`on / off`	`display.freeze`	현재 프레임 정지
Set Group Blackout	그룹번호 + `on/off`	`groups.N.blackout`	개별 그룹 블랙아웃
Set Group Gains	그룹번호 + I/R/G/B `0–2`	`groups.N.gains.{i,r,g,b}`	그룹별 색 게인
Set Test Pattern	`0–15` (16종)	`display.testPattern`	컬러바·그레이스케일 등
Load Preset	preset 번호	`presets.load`	저장된 프리셋 불러오기
Set Input	입력 소스명	`display.input`	HDMI/DP 입력 전환

API 요청 예시

# Brightness 75%
PATCH http://192.168.1.108/api/v1/public
{"dev":{"display":{"brightness":75}}}

# CCT 5600K
{"dev":{"display":{"cct":5600}}}

# Duv Tint -0.005
{"dev":{"display":{"cctDuv":-0.005}}}

# Group 0 Intensity Gain 0.8
{"dev":{"groups":{"0":{"gains":{"i":0.8,"r":1.0,"g":1.0,"b":1.0}}}}}

4

StreamDeck+ 놉 & 버튼 매핑 가이드

4 터치스크린 놉 + 8 LCD 버튼 할당

Phase 1

놉 특성

입력 방식	동작
Rotate CW / CCW	파라미터 증가 / 감소 (증분 방식)
Press	리셋 (기본값) 또는 토글
Touch (터치스크린)	LCD에 현재 파라미터명 + 값 표시

4개 놉 권장 매핑

○

Knob 1
Brightness

CW: +5%
CCW: −5%
Press: 100% 리셋

○

Knob 2
CCT

CW: +100K
CCW: −100K
Press: 5600K (중성)

○

Knob 3
Tint/Duv

CW: +0.001
CCW: −0.001
Press: 0 리셋

○

Knob 4
Group Gain I

CW: +0.1
CCW: −0.1
Press: 1.0 리셋

놉	기능	CW	CCW	Press
Knob 1	Brightness	+5%	−5%	100% 리셋
Knob 2	CCT	+100K	−100K	5600K 중성
Knob 3	Tint / Duv	+0.001	−0.001	0 리셋
Knob 4	Group Gain (I)	+0.1	−0.1	1.0 리셋

8개 버튼 레이아웃

01

BLACKOUT

토글

02

FREEZE

토글

03

GROUP 1

선택

04

GROUP 2

선택

05

GROUP 3

선택

06

GROUP 4

선택

07

TEST PAT.

컬러바

08

PRESET

불러오기

💡

LCD 표시 활용 Companion에서 각 버튼/놉 LCD에 현재값을 텍스트로 표시하도록 피드백을 설정할 수 있다. Helios 모듈의 피드백 기능 + "Draw text" 스타일 조합으로 구성.

5

Phase 2 — 전동 MIDI 페이더 연동 (X-Touch Compact)

하드웨어 연결 · 페이더 할당 · 범위 변환 수식 · 자동 싱크

Phase 2

권장 하드웨어

🎚️

Behringer X-Touch Compact

~$399 USD / ₩57만원대

• 9채널 전동 모터 페이더 (100mm 풀스트로크)
• Raw MIDI CC 모드 지원 — Companion Generic MIDI 직결
• 모터 페이더: Helios 현재 상태에 자동 싱크 가능
• 추가 놉 + 버튼 배열 (보조 할당 여유 충분)

대안: Behringer X-Touch Mini (페이더 없음·놉만), Icon Platform M+ (더 비쌈)

하드웨어 연결 구성

MacBook / PC └── USB → Behringer X-Touch Compact └── MIDI CC (USB) → Companion (Generic MIDI 모듈) └── HTTP PATCH → Megapixel Helios └── Ethernet → MIMIK 120 × N units

9채널 페이더 할당

페이더	파라미터	MIDI CC	범위 변환
Ch 1	Brightness	`CC 0`	0–127 → 0–100%
Ch 2	CCT	`CC 1`	0–127 → 1667–10000K
Ch 3	Tint / Duv	`CC 2`	0–127 → −0.01 ~ +0.01 (64 = 0)
Ch 4	Group 1 Intensity	`CC 3`	0–127 → 0–2.0
Ch 5	Group 2 Intensity	`CC 4`	0–127 → 0–2.0
Ch 6	Group 3 Intensity	`CC 5`	0–127 → 0–2.0
Ch 7	Group 4 Intensity	`CC 6`	0–127 → 0–2.0
Ch 8	Master Red Gain	`CC 7`	0–127 → 0–2.0
Ch 9	(예비)	—	추후 할당

범위 변환 수식 (Companion Expression)

# Brightness: MIDI 0-127 → 0-100%
round($(midi:cc0) / 127 * 100)

# CCT: MIDI 0-127 → 1667-10000K
round($(midi:cc1) / 127 * (10000 - 1667) + 1667)

# Duv/Tint: MIDI 0-127 → -0.01 ~ +0.01 (중앙=64)
round(($(midi:cc2) - 64) / 64 * 0.01 * 1000) / 1000

# Intensity Gain: MIDI 0-127 → 0-2.0
round($(midi:cc3) / 127 * 200) / 100

페이더 자동 싱크 (모터 위치 업데이트)

🔄

싱크 동작 원리 Companion 내부 타이머 (1초 주기) → Helios GET /api/v1/public?dev.display 호출 → 응답 JSON에서 brightness, cct 값 파싱 → Generic MIDI 모듈을 통해 X-Touch 해당 채널에 MIDI CC OUT 전송 → 페이더 모터가 해당 위치로 자동 이동.

결과: 웹 UI로 값을 바꿔도 X-Touch 페이더가 현재 Helios 값으로 즉시 이동.

1

Companion → Triggers 탭 → "Add Trigger" → Interval (1000ms) 설정
2

액션: Helios 모듈 "Get Current State" → 변수에 brightness/cct 저장
3

계산: round(brightness / 100 * 127) → MIDI CC 값으로 변환
4

Generic MIDI 모듈 "Send CC" 액션 → Ch 1, CC 0, 변환된 값 전송

6

통합 제어 흐름 다이어그램

기브온 IBL 현장 전체 신호 흐름

Phase 1+2

span class="c-green">현장 제어 시스템 — 기브온 IBL [ 기브온 커스텀 웹 UI ] [ X-Touch Compact ] [ StreamDeck+ ] (http://localhost:8080) (전동 페이더 9ch) (버튼 8 + 놉 4) │ │ │ └────────────────────┬───────────┘ │ ▼ │ [ Bitfocus Companion ]◄────────────────────────────┘ (http://localhost:8888) │ │ HTTP PATCH /api/v1/public ▼ [ Megapixel Helios ] (192.168.1.108) │ │ Ethernet / Fiber ▼ [ KINO FLO MIMIK 120 × N units ] (LED 패널 어레이)

각 경로별 신호 타입

구간	프로토콜	지연
StreamDeck+ → Companion	USB HID	<5ms
X-Touch Compact → Companion	USB MIDI	<5ms
웹 UI → Helios (직접)	HTTP REST	<20ms (LAN)
Companion → Helios	HTTP PATCH	<30ms (LAN)
Helios → MIMIK 120	Ethernet 독점 프로토콜	<1 frame

7

현장 셋업 체크리스트

촬영 전 확인 — 클릭해서 체크

0 / 8

0 / 8 완료

Companion 실행 확인 http://localhost:8888 접속 → 메인 대시보드 로드 확인
Helios 모듈 연결 상태 확인 Connections 탭 → Megapixel Helios 옆 초록 점 확인
X-Touch Compact USB 연결 (Phase 2) USB 꽂은 후 Companion Generic MIDI 모듈 초록 상태 확인
StreamDeck+ 연결 확인 Companion Surfaces 탭에서 StreamDeck+ 인식 확인
웹 UI 실행 터미널: ./start.sh 192.168.1.108 → http://localhost:8080 접속
웹 UI Helios 연결 상태 확인 우측 상단 초록 점 + "Connected" 표시 확인
Blackout 토글 테스트 StreamDeck+ 버튼 1 → MIMIK 블랙아웃 → 웹 UI에서도 상태 동기화 확인
페이더 싱크 확인 (Phase 2) 웹 UI에서 Brightness 변경 → 1초 내 X-Touch Ch 1 페이더 자동 이동 확인

⚠️

네트워크 주의 Helios와 제어 PC는 반드시 동일 서브넷 (192.168.1.x)에 있어야 한다. 현장 공유 Wi-Fi 사용 시 Helios IP가 다를 수 있음 — Companion Helios 모듈 IP 설정 재확인 필수.

물리 하드웨어 실시간 제어
셋업 가이드

지금 당장 쓸 수 있는 구성

전동 페이더 실시간 싱크

설치

Megapixel Helios 모듈 추가

Generic MIDI 모듈 추가 (Phase 2)

API 요청 예시

놉 특성

4개 놉 권장 매핑

8개 버튼 레이아웃

권장 하드웨어

하드웨어 연결 구성

9채널 페이더 할당

범위 변환 수식 (Companion Expression)

페이더 자동 싱크 (모터 위치 업데이트)

각 경로별 신호 타입

물리 하드웨어 실시간 제어셋업 가이드

지금 당장 쓸 수 있는 구성

전동 페이더 실시간 싱크

설치

Megapixel Helios 모듈 추가

Generic MIDI 모듈 추가 (Phase 2)

API 요청 예시

놉 특성

4개 놉 권장 매핑

8개 버튼 레이아웃

권장 하드웨어

하드웨어 연결 구성

9채널 페이더 할당

범위 변환 수식 (Companion Expression)

페이더 자동 싱크 (모터 위치 업데이트)

각 경로별 신호 타입

물리 하드웨어 실시간 제어
셋업 가이드