05 · 웹 UI 사용법

웹 UI 사용법

Master 장치의 웹 UI 인터페이스와 각 메뉴의 사용법입니다. 웹 UI는 브라우저에서 Master에 접속하여 모든 설정을 구성하고 상태를 모니터링하는 주요 인터페이스입니다.

웹 UI 개요#

웹 UI는 7개 메뉴와 Factory Reset 기능으로 구성됩니다.

접속 방법: 04 · 네트워크 연결을 참조하여 AP 모드, WiFi STA, 또는 Ethernet으로 Master에 접속합니다.

메뉴 구성:

메뉴	기능	상세 문서
Dashboard	시스템 상태 개요	이 섹션에서 상세 설명
Network	네트워크 설정	04 · 네트워크 연결
Switcher	스위처 연결 설정	06 · 스위처 연동
Broadcast	LoRa RF 설정	08 · RF 설정
Devices	리시버 디바이스 관리	이 섹션에서 상세 설명
License	라이센스 활성화	09 · 라이센스
System	시스템 설정/테스트	이 섹션에서 상세 설명

Update Speed (갱신 속도):

웹 UI는 /api/status를 폴링하여 상태를 갱신합니다. System 메뉴에서 갱신 주기를 설정할 수 있습니다.
폴링 주기는 Master - Receiver 간의 속도에 영향을 주지 않습니다.

모드	간격	특징
Fast	0.5초	실시간성 높음, 네트워크 사용량 높음
Normal	1초	권장 설정
Slow	2초	네트워크 사용량 낮춤
Eco	5초	최소 네트워크 사용

Switcher 페이지 안내

Switcher 페이지 상단에는 “설정 반영까지 최대 N초” 안내가 표시됩니다.

Dashboard#

시스템의 전체 상태를 한눈에 확인하는 메인 페이지입니다.

표시 항목:

Status (상단 3개)#

항목	설명	단위/형식
Battery	Master 배터리 잔량	% (0-100%)
Temperature	Master 내부 온도	°C
Uptime	부팅 후 경과 시간	`Dd Hh Mm` 형식

Switcher Status (왼쪽)#

스위처 연결 상태입니다.

항목	설명
S1 (Primary)	Slot 1 스위처 (IP, Type, Connected/Disconnected)
S2 (Secondary)	Slot 2 스위처 (IP, Type, Connected/Disconnected)

Open → 버튼을 클릭하면 Switcher 메뉴로 이동합니다.

Network Status (오른쪽)#

네트워크 연결 상태입니다.

항목	설명
AP	AP 모드 상태 (SSID, IP, Enabled/Disabled)
WiFi	WiFi STA 상태 (SSID, IP, Connected/Disconnected)
Ethernet	유선 상태 (IP, Connected/No Link/Disabled)

Open → 버튼을 클릭하면 Network 메뉴로 이동합니다.

System Info (하단)#

Master 장치 기본 정보입니다.

항목	설명	형식
Device ID	장치 고유 ID	4자리 16진수
Voltage	입력 전압	V (볼트)
Version	펌웨어 버전	`vX.Y.Z` 형식

Network#

네트워크 설정 메뉴입니다. 상세 설명은 04 · 네트워크 연결을 참조합니다.

요약:

AP Settings: Master AP 설정 (SSID, Password, Channel)
WiFi Settings: 공유기 연결 설정 (SSID, Password)
Ethernet Settings: 유선 설정 (DHCP, Static IP)

Switcher#

스위처 연결 설정 메뉴입니다. 상세 설명은 06 · 스위처 연동을 참조합니다.

요약:

Slot 1 (Primary): 주 스위처 설정
Slot 2 (Secondary): 보조 스위처 설정
지원 프로토콜: ATEM, OBS, vMix, OSEE

Broadcast#

LoRa RF 설정 메뉴입니다. 상세 설명은 08 · RF 설정을 참조합니다.

요약:

RF 스캔
RF 설정
동기 워드 (Sync Word) 구성

Devices#

연결된 리시버 디바이스를 관리하는 메뉴입니다.

상태 바 (상단)#

항목	설명
필터	All (전체) / Online (온라인) / Offline (오프라인)
Limit	라이센스 디바이스 제한 (예: `Limit: 16`)
Status	모든 디바이스에 상태 요청 전송
Clear	디바이스 리스트 초기화
Global Brightness	전체 디바이스 밝기 일괄 설정
LED Colors	LED 색상 프리셋

Clear 주의

Clear 로 디바이스 리스트가 삭제되더라도, Master-Receiver 는 계속 상태를 주고 받기 때문에 다시 리스트가 생성됩니다.

디바이스 카드#

각 리시버 디바이스의 카드입니다.

카드 헤더:

항목	설명
상태 인디케이터 (왼쪽 테두리)	신호 강도 (초록=강함, 노랑=보통, 빨강=약함, 회색=오프라인)
Device ID	디바이스 ID (예: `1234`)
Camera ID	할당된 카메라 ID (1-20)
Online/Offline	연결 상태
Uptime · Seen	부팅 경과 · 마지막 통신

카드 내용:

항목	설명	형식
Signal	RF 신호 강도 (RSSI / SNR)	Good / Normal / Weak / None
Battery	배터리 잔량	% 또는 `--`

온라인 디바이스 제어#

Brightness (밝기):

항목	설명	범위
슬라이더	개별 밝기 조절	0-100%
Global Brightness	전체 일괄 설정	25/50/75/100%

Camera ID (카메라 ID):

항목	설명	범위
-/+ 버튼	ID 1씩 감소/증가	1-20
입력창	직접 입력	1-20

디바이스 기능 버튼#

버튼	기능	설명
Ping	통신 테스트	디바이스에 PING 전송 (유니캐스트)
Reboot	재부팅	디바이스 재시작
Delete	삭제	디바이스 등록 삭제

Delete 주의

Delete로 개별 디바이스를 삭제한 경우 limit 할당 값이 줄어듭니다. 이때 다른 리시버 디바이스를 등록하게 되어 limit 이 가득 차면 삭제된 디바이스가 중지될 수 있습니다.

LED Color Presets (색상 프리셋)#

Global Brightness 버튼 옆 LED Colors 버튼을 클릭합니다.

프리셋	설명	색상
Black OFF	검은색 OFF (기본값)	Red / Green / Black
Blue OFF	파란색 OFF	Red / Green / Blue (#0433ff)

프리셋을 탭하면 즉시 모든 리시버에 OFF 색상이 브로드캐스트됩니다.

License#

라이센스(16자리 키)를 활성화하여 Device Limit을 Master에 주입하는 메뉴입니다. 상세 절차는 09 · 라이센스를 참조합니다.

라이센스 키 입력 → Activate: 서버에서 Device Limit을 조회해 Master에 주입
Internet Connection Test: 서버 연결 실패 시 인터넷 진단 (DNS → License Server → DB)

System#

시스템 설정과 테스트 기능입니다.

Tally Test Mode#

tally 신호 자동 순환 테스트입니다.

용어 주의

여기의 Max Channels는 “테스트에서 순환할 채널 수”를 뜻하며, 스위처 슬롯의 Max Channels와는 다른 설정입니다.

항목	설명	범위
Max Channels	순환할 채널 수	1-20
Interval	간격	100-3000ms
Start Test	테스트 시작	-
Stop Test	테스트 중지	-

동작 패턴: Max Channels = 3일 때

tally test sequence

Step 1: PGM1 PVW2
Step 2: PGM2 PVW3
Step 3: PGM3 PVW1
(이후 Step 1부터 반복)

테스트 중에는 실제 스위처 신호와 무관하게 tally가 변경됩니다.

Update Speed (갱신 속도)#

웹 대시보드가 장치 상태를 다시 가져오는 상태 폴링 간격입니다.

모드	간격	네트워크 사용량
Fast	0.5초 (500ms)	높음 (Higher network usage 경고)
Normal	1초 (1000ms)	보통
Slow	2초 (2000ms)	낮음 — 기본값
Eco	5초 (5000ms)	최소

tally 지연과 무관

이 설정은 대시보드 표시 갱신 주기일 뿐, 실제 tally 표시(리시버 LED) 반응과는 관계없습니다. tally는 LoRa로 실시간 송출됩니다. 가장 빠른 옵션은 0.5초(Fast)이며 그 이하는 선택할 수 없습니다.

노트북 등 배터리 기반 환경에서는 Normal/Slow를 권장합니다.

Notices (공지사항)#

최신 업데이트와 안내 사항입니다.

항목	설명
우선순위 표시	빨강 (중요) / 노랑 (일반) / 회색 (정보)
제목/내용	공지사항 내용
날짜	게시일
새로고침	최신 공지 확인

사이드바 하단#

Factory Reset (공장 초기화)#

장치를 공장 초기 상태로 되돌립니다.

되돌릴 수 없는 작업

기기 내부에 저장되어 있는 설정값이 초기화 됩니다. 되돌릴 수 없는 작업입니다.

절차:

1
버튼 클릭
사이드바 하단 Factory Reset 버튼을 클릭합니다
2
경고 확인
경고 메시지를 확인합니다
3
Confirm Reset
Confirm Reset 버튼을 클릭합니다
4
자동 재부팅
Master가 자동으로 재부팅됩니다

상세 설명은 03 · 펌웨어를 참조합니다.

Connection (연결 상태)#

웹 UI와 Master의 실시간 연결 상태입니다.

상태	설명
Online (초록)	WebSocket 연결 정상
Offline (빨강)	WebSocket 연결 끊김

Offline 상태이면 브라우저 새로고침(F5)을 시도합니다.

라이센스 배너#

상단 전역 배너입니다.

조건: 라이센스 미활성 시 (is_valid === false)

표시:

제목: License Required for Full Functionality
내용: TX/RX communication is limited without license activation.
버튼: Activate License→ License 메뉴로 이동

라이센스 미활성 시 TX/RX 통신이 제한됩니다. 상세는 09 · 라이센스를 참조합니다.

최종 수정 —