# 문제 해결
### 미니 PC 관련
Q. 미니 PC 전원을 켰는데 Q2-setup 와이파이가 보이지 않습니다.
1. 서버 전원이 완전히 켜졌는지 확인하십시오. (부팅에 1\~2분 소요)
2. 스마트폰·PC의 와이파이 목록을 새로고침 하거나 와이파이 설정을 껐다 켜십시오.
3. 5분 이상 대기해도 `Q2-setup`이 보이지 않으면 문의 바랍니다.
Q. 192.168.4.1 접속이 되지 않습니다.
1. 현재 PC·스마트폰이 `Q2-setup` 와이파이에 연결되어 있는지 확인하십시오.
2. 다른 와이파이 자동 연결을 모두 해제 후 재시도하십시오.
3. 브라우저 캐시를 삭제 후 재시도하십시오.
Q. 와이파이 설정 후 페이지가 이동되지 않습니다 (연결 실패).
1. 브라우저에 `q2-server.local/wifi` 입력 → `[Wi-Fi 리셋]` 클릭
2. 리셋 후 [`📖6.1서버 미니 PC 설치`](https://www.notion.so/UWB-Q2-Starter-Kit_-349f0a810b2e80b0af21f6df95592779?pvs=21) 부터 다시 진행하십시오.
Q. 사내 Wi-Fi 비밀번호가 변경되었는데 Wi-Fi를 다시 설정하고 싶습니다.
1. 브라우저에 `q2-server.local/wifi` 입력 → `[Wi-Fi 리셋]` 클릭
2. 리셋 후 [`📖6.1서버 미니 PC 설치`](https://www.notion.so/UWB-Q2-Starter-Kit_-349f0a810b2e80b0af21f6df95592779?pvs=21) 부터 다시 진행하십시오.
### 앵커 관련
Q. 앵커에 전원을 연결했는데 LED가 켜지지 않습니다.
1. 보조 배터리 잔량을 확인하십시오.
2. C to A 케이블을 다른 케이블로 교체해 보십시오.
3. 보조 배터리를 충전 후 재연결하십시오.
Q. 앵커에 전원을 연결했는데 LED가 켜지지 않습니다.
에러 상태입니다. 해당 앵커의 일련번호와 함께 문의 바랍니다.
Q. 앵커 LED가 노란색으로 빠르게 점멸합니다.
배터리 잔량이 10% 이하입니다. 보조 배터리를 충전 또는 교체하십시오.
Q. 제공하는 보조 배터리가 아닌 타 제품으로 대체하고 싶습니다.
1. 가능하지만, 반드시 다음 조건을 만족하는 제품이어야 합니다.
* **"저전력(Low Current) 모드 지원"** 또는 **"Low Current Mode"** 기능이 있는 제품
* 출력 **5V 이상**, 용량 **10,000mAh 이상** 권장 (동봉 제품과 동급)
* USB-A 출력 포트 보유
2. 대체 제품 구매 시 제품 사양서에서 위 기능을 반드시 확인하십시오.
3. 저전력 모드 미지원 제품을 사용하면 앵커가 수시로 꺼지는 문제가 발생합니다.
### 게이트웨이 관련
Q. 게이트웨이 LED가 빨간색으로 느리게 점멸합니다.
1. 인터넷(네트워크) 연결이 끊긴 상태입니다.
2. LAN 케이블 연결 상태 확인 → 스위치·공유기 상태 확인.
3. 와이파이 연결의 경우 `Q2 Kit` 앱으로 재설정하십시오.
Q. Q2 Kit 앱에서 게이트웨이가 목록에 뜨지 않습니다.
1. 스마트폰의 블루투스(BLE)가 켜져 있는지 확인하십시오.
2. 게이트웨이에서 3m 이내로 접근 후 재시도하십시오.
3. 게이트웨이 전원을 재부팅한 후 약 30초 뒤 다시 시도하십시오.
### 관제 프로그램 관련
Q. 로그인할 수 없습니다 (초기 계정으로).
1. 초기 계정: ID `admin` / PW `admin`
2. 대소문자를 확인하십시오.
3. 이미 비밀번호를 변경한 적이 있다면 변경한 비밀번호로 로그인하십시오.
4. 만약 변경한 비밀번호를 잊었다면 로그아웃 후 로그인 페이지에서 비밀번호 초기화를 진행하십시오.
Q. 이메일 받기로 한 로그인 계정을 받지 못했습니다.
1. 먼저 이메일의 **스팸함 / 프로모션 탭**을 확인하십시오.
2. 등록하신 이메일 주소가 정확한지 확인하십시오.
3. 위 두 가지에 해당하지 않는다면 [`📖 13. 기술 지원 및 문의`](https://www.notion.so/UWB-Q2-Starter-Kit_-349f0a810b2e80b0af21f6df95592779?pvs=21)로 **고객사명**과 **계정 수령 이메일 주소**를 함께 전달하여 재발송을 요청하십시오.
{% hint style="info" %}
이 계정은 관제 프로그램 다운로드 페이지 로그인용이며, 관제 프로그램 자체 로그인(ID: `admin` / PW: `admin`)과는 별개입니다.
{% endhint %}
Q. 칼리브레이션이 진행되지 않습니다.
칼리브레이션은 앵커 · 게이트웨이 모두가 정상 상태여야 성공합니다. 정상 상태임에도 불구하고 진행되지 않는다면 아래 세 가지 방법을 확인하세요
1. **최종 뷰 저장이 누락된 경우**
가장 자주 발생하는 원인입니다. 다음 항목을 순서대로 점검하세요.
* 기준 앵커가 지정되고 저장되었는지 확인하십시오.
* 4개 앵커 모두 **🟢** 초록색 LED 상태(정상 동작)인지 확인하십시오.
* 게이트웨이가 **🟢 초록 LED 상시 점등**(서버와 정상 통신 중) 상태인지 확인
* `[최종 뷰 저장]`을 **한 번 더 클릭**한 뒤 `[칼리브레이션 > 전체 칼리브레이션]`을 다시 실행
2. **게이트웨이 LED가 🔴 빨강 느린 점멸로 바뀌는 경우**
인터넷(네트워크) 연결이 끊긴 상태입니다.
* **주요 원인**
* 사내 LAN · Wi-Fi 장애 (스위치 · 공유기 재시작, 네트워크 점검 중 등)
* LAN 케이블이 빠지거나 느슨해짐
* 와이파이 신호 약함
* 게이트웨이 전원 불안정
* **해결 방법**
1. 게이트웨이 LED가 다시 **🟢 초록 상시 점등**으로 복귀할 때까지 네트워크 환경을 점검합니다.
* LAN 케이블 체결 상태 재확인
* 사내 네트워크 스위치 · 공유기 상태 확인
* 와이파이 연결 시 신호 세기 확인
2. 필요 시 `Q2 Kit` 앱으로 게이트웨이를 재설정합니다. (네트워크 재연결)
3. 게이트웨이가 정상(🟢 초록 점등) 상태로 복귀한 뒤, 칼리브레이션을 **다시 실행**합니다.
3. **앵커 거리 측정에 실패하는 경우**
* 특정 앵커의 **전원이 꺼져 있음** (보조 배터리 방전 · 전원 케이블 빠짐)
* 앵커 간 **시야가 확보되지 않음** (대형 금속 구조물·두꺼운 콘크리트 벽이 신호를 차단)
* 앵커가 **너무 멀리** 떨어져 있음 (50m 초과)
* 앵커 LED가 **🔴 빨강 점멸** (에러 상태)
* **해결 방법**
1. 4개 앵커의 LED 상태를 먼저 확인합니다. → **모두 🟢 초록 점멸**이어야 정상
2. 꺼진 앵커가 있으면 보조 배터리를 점검 (충전 상태 · C-Type 케이블 체결 상태)
3. 앵커 간 간격이 **5\~30m(권장)** 이내인지 재확인
4. 앵커와 앵커 사이에 **대형 금속 구조물·두꺼운 콘크리트 벽**이 있다면 앵커 위치를 조정하거나 높이를 올려 시야선(LoS)을 확보
5. 문제 해결 후 칼리브레이션을 **다시 실행**합니다.
Q. 칼리브레이션을 재시도해도 안전한가요?
1. 안전합니다. 실패한 칼리브레이션은 기존 좌표를 덮어쓰지 않으므로, 재시도로 인한 데이터 손실은 없습니다.
2. 문제 원인을 해결한 뒤 몇 번이든 다시 실행해도 됩니다.
Q. 칼리브레이션이 계속 실패합니다.
여러 번 재시도해도 실패하는 경우 문의 바랍니다.
### 태그 관련
Q. 태그 전원을 켰는데 모니터링 화면에 보이지 않습니다.
1. 태그 LED가 초록 점멸(정상 동작)인지 확인하십시오.
2. 태그가 앵커·게이트웨이의 커버리지 범위 내에 있는지 확인하십시오.
3. `[태그 관리]` 메뉴에서 해당 태그가 등록되어 있는지 확인하십시오.
4. 관제 프로그램을 재시작하십시오.
Q. 태그 위치가 실제와 다르게 표시됩니다.
1. 칼리브레이션이 정상 완료되었는지 확인하십시오.
2. 지도와 앵커 위치의 회전·반전이 올바른지 확인하십시오.
3. [`📖6.5 칼리브레이션`](https://www.notion.so/UWB-Q2-Starter-Kit_-349f0a810b2e80b0af21f6df95592779?pvs=21)의 개별 앵커 위치 조정(step 3)을 수행하십시오.
4. 앵커와 태그 사이에 대형 금속 구조물 등 차단물이 있으면 앵커 위치 조정을 검토하십시오.
Q. 태그가 지도에서 사라졌다 나타났다를 반복합니다.
1. **태그 배터리 부족**: 태그 LED가 🟡 노랑 점멸이면 배터리 부족 상태 → USB-C로 충전
2. **커버리지 경계 지점**: 태그가 앵커 4개가 이루는 사각형의 가장자리·바깥에 위치 → 작업 동선을 사각형 내부로 조정하거나 앵커 추가 설치 검토
3. **대형 장애물 차단**: 태그와 앵커 사이에 이동하는 대형 금속 구조물(지게차·철판 등)이 자주 지나가면서 신호가 간헐적으로 차단됨 → 앵커 설치 높이를 올려 시야선 확보
위 원인을 점검해도 계속된다면 `📖 기술 지원 및 문의`로 문의 바랍니다.
Q. 태그 위치가 벽을 뚫고 건너편에 표시됩니다. 정상인가요?
1. 태그 신호가 벽이나 구조물에 반사되어 앵커에 도달하는 경우, 시스템이 반사 경로를 직접 경로로 오인해 실제 위치와 다르게 계산할 수 있습니다.
* 앵커 설치 위치를 조정하여 해당 구역의 시야선(LoS) 확보 후 태그를 착용하고 정상적으로 작동하는지 확인하십시오.
2. 지속적으로 동일 위치에서 발생한다면 현장 도면과 함께 문의 바랍니다.
Q. 태그 충전 중에도 측위가 되나요?
충전 중에는 태그의 UWB와 BLE 통신이 자동으로 꺼지므로 측위가 일시 정지됩니다.
Q. 충전이 끝나면 태그가 자동으로 다시 측위를 시작하나요?
충전 전에 태그 전원을 켜둔 상태로 충전했는지 여부에 따라 동작이 다릅니다.
* 전원을 ON 시킨 상태로 충전 → 자동으로 다시 켜짐, 10\~20초 후 지도 표시
* 전원을 OFF 시킨 상태로 충전 → 태그가 꺼진 상태 그대로 유지, 전원 버튼 3초 눌러 수동 ON
{% hint style="info" %}
LED로 어느 상태인지 확인하는 방법 (초록 점멸 → 재시작 완료 / 꺼짐 → 수동 ON 필요)
{% endhint %}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://freegrow-1.gitbook.io/product-docs-kr/q2-starterkit/undefined-2.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.