10 · 문제 해결
문제 해결
증상별 원인과 해결 방법을 빠르게 찾기 위한 문서입니다. 사용자가 직접 조정할 수 없는 설정(TX 전력·SF·BW·CR 등 LoRa 물리 파라미터)은 원인/해결에서 다루지 않습니다.
통신 문제#
Master ↔ Receiver 통신 안 됨#
| 증상 | 원인 | 해결 |
|---|---|---|
| Receiver가 수신하지 못함 (RSSI 정상) | 버전 불일치 — 양단 펌웨어/Wire Protocol 불일치 | 양단 동일 펌웨어로 플래시 (03 펌웨어 문서 참조) |
| Receiver 수신 없음 | Frequency 불일치 | 웹 UI Broadcast에서 양단 동일 Frequency 확인 (08 RF 설정 참조) |
| 간헐적 연결 끊김 | Sync Word 불일치 | 웹 UI Broadcast에서 양단 동일 Sync Word 확인 |
| 특정 Receiver만 수신 안 됨 | camera_id 미할당 | 웹 UI Devices에서 해당 Receiver camera_id 할당 (05 웹 UI 문서 참조) |
| 신호 약함 / 거리 문제 | 장애물·거리 | 가시선 확보, 장치 위치/높이 조정, 장애물 제거 (08 RF 설정 참조) |
사용자 조정 가능 RF 설정
Frequency와 Sync Word뿐입니다. TX 전력·SF·BW·CR 등은 사용자가 변경할 수 없습니다.
통신 거리 (참고)#
아래 수치는 참고용 예시이며, 실제 도달 거리는 현장 환경(벽 재질·두께, 금속 구조물, 전파 간섭, 안테나 높이·가시선 등)에 따라 크게 달라집니다. 실사용 환경에서 사전 테스트를 권장합니다.
| 환경(예시) | 예상 거리(예시) |
|---|---|
| 개방 공간 (가시선 확보) | 수백 m |
| 실내 (벽 1~2장) | 수십~수백 m |
| 실내 (콘크리트 벽 다수) | 수십 m |
보장 성능이 아님
위 값은 보장 성능이 아닙니다. 중요 현장에서는 여유를 두고 사전에 현장 테스트를 진행하세요.
LED 표시 문제 (Receiver)#
tally LED 위치
Tally LED는 Receiver에만 있습니다. Master는 OLED로만 상태를 표시합니다. (02 하드웨어 설치 참조)
| 증상 | 원인 | 해결 |
|---|---|---|
| LED 전혀 켜지지 않음 | camera_id 미할당 | 웹 UI Devices에서 camera_id 할당 (05 웹 UI 문서 참조) |
| LED 전혀 켜지지 않음 | LoRa 수신 없음 | 통신 문제 점검 |
| PGM이 빨강으로 안 켜짐 | 카메라 매핑 오류 | 웹 UI Switcher 매핑 확인 (06 스위처 연동 참조) |
| PVW가 초록으로 안 켜짐 | 스위처 미연결 | Switcher 설정에서 스위처 연결 상태 확인 (06 스위처 연동 참조) |
| LED 모두 꺼짐 (all-OFF) | 라이센스 무효 (STOP) 또는 배터리 부족 | STOPPED 화면 / 배터리 문제 확인 |
| LED 색이 OFF(청색)로 표시됨 | off-mode=1 | 정상 동작. off-mode=0(검정)으로 변경 가능 (05 웹 UI 문서 참조) |
| LED가 너무 밝음/어두움 | 밝기 설정 | 웹 UI Devices에서 밝기 조정 |
STOPPED 화면#
| 증상 | 원인 | 해결 |
|---|---|---|
| OLED에 STOPPED / LICENSE REQUIRED 표시, LED all-OFF, 버튼 무반응 | 라이센스 무효 | 1) Master에서 라이센스 재활성화(Device Limit 주입) 2) Receiver 물리적 재부팅 (09 라이센스 문서 참조) |
자동 해제 불가
STOP 상태는 자동 해제되지 않으며 STOP 해제 명령도 없습니다. 라이센스 재활성화 후 Receiver를 물리적으로 재부팅해야만 복구됩니다. (09 라이센스 문서 참조)
웹 UI 접속 문제#
| 증상 | 원인 | 해결 |
|---|---|---|
| 브라우저 '연결할 수 없음' | 네트워크 불일치 | PC와 Master가 같은 네트워크(WiFi/이더넷)에 있는지 확인 (04 네트워크 문서 참조) |
| IP로 접속 안 됨 | IP 미할당 | Master OLED에서 IP 확인. 없으면 AP 모드로 진입해 네트워크 재설정 (04 네트워크 문서 참조) |
| AP 모드(기본 IP)로만 접속됨 | WiFi 연결 실패 | AP 모드(192.168.4.1)에서 WiFi 설정 재구성 (04 네트워크 문서 참조) |
부팅 문제#
부팅 중 OLED 진행률이 멈춘 단계로 원인을 추정할 수 있습니다.
Master 부팅 단계 (총 11단계)#
| 단계 | 화면 메시지 | 멈춤 시 점검 |
|---|---|---|
| 1 | Common | 전원·케이블 점검 (02 하드웨어 설치 참조) |
| 2 | Role Init | 전원 안정성 확인 |
| 3~5 | Network / Ethernet / Net Done | 네트워크 케이블·WiFi·IP 점검 (04 네트워크 문서 참조) |
| 6 | HTTP | 전원 안정성 확인 |
| 7~8 | LoRa TX / LoRa RX | 장치 재시작, 지속 시 서비스 문의 |
| 9 | Display | 장치 재시작 |
| 10~11 | Ready / Starting | 정상 완료 직전이므로 잠시 대기, 지속 시 재부팅 |
Receiver 부팅 단계 (총 7단계)#
| 단계 | 화면 메시지 | 멈춤 시 점검 |
|---|---|---|
| 1 | Common | 충전 후 재시작 (02 하드웨어 설치 참조) |
| 2 | Role Init | 충전 상태 확인 |
| 3~4 | LoRa TX / LoRa RX | 장치 재시작, 지속 시 서비스 문의 |
| 5 | Display | 장치 재시작 |
| 6~7 | Ready / Starting | 정상 완료 직전, 잠시 대기 |
HW MISMATCH (잘못된 보드용 펌웨어) — 레거시#
v3.2.0부터 하드웨어 감시(t_hw_guard)가 제거되어 이 화면은 더 이상 발생하지 않습니다. PSRAM이 탑재된 ESP32-S3 모듈이면 부팅이 허용됩니다. 아래 내용은 v3.1.x 이하 펌웨어에서만 해당됩니다.
구버전에서는 부팅 중 보드 하드웨어를 검증하다가 해당 보드에 맞지 않는 펌웨어를 감지하면 시스템이 정지(halt)하고 OLED에 HW MISMATCH 오버레이를 표시했습니다. (Master↔Receiver 펌웨어 버전 불일치와는 다릅니다.)
| 증상 | 원인 | 해결 |
|---|---|---|
| 부팅 중 HW MISMATCH 표시 후 정지 (v3.1.x 이하) | 잘못된 보드용 펌웨어 플래시 | v3.2.0 이상으로 업데이트하거나 해당 보드(Master/Receiver)에 맞는 펌웨어로 다시 플래시 (03 펌웨어 문서 참조) |
재부팅 루프#
| 증상 | 원인 | 해결 |
|---|---|---|
| 부팅 후 자동 재부팅 반복 | 펌웨어 손상 | tally-node.com 웹 플래셔로 펌웨어 재플래시 (03 펌웨어 문서 참조) |
버전 불일치#
| 증상 | 원인 | 해결 |
|---|---|---|
| 웹 UI '버전 불일치' 경고 | Master ≠ Receiver 펌웨어 | 양단 동일 펌웨어로 플래시 (03 펌웨어 문서 참조) |
| LoRa 통신 안 됨 + 버전 차이 | Wire Protocol 불일치 | 양단 동일 펌웨어 필수 |
버전 확인 위치
Master 웹 UI Dashboard 및 Receiver OLED System Info 페이지에서 확인합니다.
HW MISMATCH와 구분
구버전(v3.1.x 이하) 펌웨어의 부팅 중 “HW MISMATCH” 표시는 버전 불일치가 아니라 잘못된 보드용 펌웨어 감지입니다. v3.2.0부터는 발생하지 않습니다. (위 HW MISMATCH 섹션 참조)
OBS/vMix 연결#
OBS (WebSocket)#
| 증상 | 원인 | 해결 |
|---|---|---|
| Connection refused | 비밀번호 불일치 | OBS > Settings > WebSocket 서버 비밀번호 확인 (06 스위처 연동 참조) |
| Connection timeout | 포트 불일치 | OBS WebSocket 기본 포트 4455 확인 |
| 연결되나 tally 안 바뀜 | OBS WebSocket 버전 | OBS WebSocket 5.x 사용 (06 스위처 연동 참조) |
vMix (TCP)#
| 증상 | 원인 | 해결 |
|---|---|---|
| Connection refused | 포트 불일치 / vMix TCP API 비활성 | vMix TCP API 기본 포트 8099 확인·활성화 (06 스위처 연동 참조) |
| 연결되나 tally 안 바뀜 | 인터페이스 바인딩 | Master가 vMix PC와 통신 가능한 인터페이스인지 확인 (06 스위처 연동 참조) |
배터리 문제#
| 증상 | 원인 | 해결 |
|---|---|---|
| Receiver OLED에 Battery Empty 표시 후 카운트다운 | 배터리 전압 3.2V 미만 (empty) | 즉시 충전. 카운트다운 종료 시 deep sleep 진입 (02 하드웨어 설치 참조) |
| 충전해도 곧바로 empty | 배터리 노화 | 18650 배터리 교체 (02 하드웨어 설치 참조) |
| 충전 표시 없음 | 충전기/케이블 불량 | 5V 어댑터·USB-C 케이블 교체 |
배터리 empty 임계
배터리 empty 판정은 3.2V 단일 임계이며 deep sleep 진입 전 약 10초 카운트다운이 표시됩니다.
공장 초기화#
Master 전용
공장 초기화는 Master 웹 UI에서만 가능하며 Master 설정 전체가 초기화됩니다. Receiver에는 영향 없습니다. (03 펌웨어 문서 참조)
진단 도구#
OLED System Info#
- Master: 전면 버튼을 짧게 눌러 System Info 페이지로 이동. 버전·IP·LoRa 설정·배터리 등 확인.
- Receiver: 전면 버튼을 짧게 눌러 System Info 페이지로 이동. 버전·camera_id·배터리·RSSI 등 확인.
웹 UI Dashboard#
Master 웹 UI Dashboard에서 배터리·온도·uptime·스위처 연결 상태·네트워크·버전 등을 한눈에 확인합니다. Devices에서 각 Receiver의 RSSI/SNR·배터리·camera_id를 확인합니다.
빠른 진단 흐름#
문제 발생 시 아래 순서로 점검하면 원인 분류가 빠릅니다.
- 1증상 관찰OLED 메시지·LED 상태·웹 UI 접속 여부를 기록
- 2전원·배터리 점검Master/Receiver 전원 안정성 확인 (자세한 내용은 하드웨어 설치을 참조하세요)
- 3네트워크 점검웹 UI 접속이 안 되면 동일 네트워크 여부 확인 (자세한 내용은 네트워크 연결을 참조하세요)
- 4통신·라이센스 점검LED all-OFF면 STOPPED/배터리 점검 (자세한 내용은 라이센스을 참조하세요)
- 5펌웨어·버전 점검양단 펌웨어 일치 여부 확인 (자세한 내용은 펌웨어을 참조하세요)
최종 수정 —