> For the complete documentation index, see [llms.txt](https://freegrow-1.gitbook.io/product-docs-kr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://freegrow-1.gitbook.io/product-docs-kr/welcome-to-the-growspace-studio/undefined/q2-starter-kit.md).

# Q2 Starter kit

### 🖥️ 미니 PC 관련

<details>

<summary>Q. 미니 PC 전원을 켰는데 Q2-setup 와이파이가 보이지 않습니다.</summary>

1. 서버 전원이 완전히 켜졌는지 확인하십시오. (부팅에 1\~2분 소요)
2. 스마트폰·PC의 와이파이 목록을 새로고침 하거나 와이파이 설정을 껐다 켜십시오.
3. 5분 이상 대기해도 `Q2-setup`이 보이지 않으면 문의 바랍니다.

</details>

<details>

<summary>Q. 192.168.4.1 접속이 되지 않습니다.</summary>

1. 현재 PC·스마트폰이 `Q2-setup` 와이파이에 연결되어 있는지 확인하십시오.
2. 다른 와이파이 자동 연결을 모두 해제 후 재시도하십시오.
3. 브라우저 캐시를 삭제 후 재시도하십시오.

</details>

<details>

<summary>Q. 와이파이 설정 후 페이지가 이동되지 않습니다 (연결 실패).</summary>

1. 브라우저에 `q2-server.local/wifi` 입력 → `[Wi-Fi 리셋]` 클릭
2. 리셋 후 [`📖6.1서버 미니 PC 설치`](https://www.notion.so/UWB-Q2-Starter-Kit_-349f0a810b2e80b0af21f6df95592779?pvs=21) 부터 다시 진행하십시오.

</details>

<details>

<summary>Q. 사내 Wi-Fi 비밀번호가 변경되었는데 Wi-Fi를 다시 설정하고 싶습니다.</summary>

1. 브라우저에 `q2-server.local/wifi` 입력 → `[Wi-Fi 리셋]` 클릭
2. 리셋 후 [`📖6.1서버 미니 PC 설치`](https://www.notion.so/UWB-Q2-Starter-Kit_-349f0a810b2e80b0af21f6df95592779?pvs=21) 부터 다시 진행하십시오.

</details>

### 📡 앵커 관련

<details>

<summary>Q. 앵커에 전원을 연결했는데 LED가 켜지지 않습니다.</summary>

1. 보조 배터리 잔량을 확인하십시오.
2. C to A 케이블을 다른 케이블로 교체해 보십시오.
3. 보조 배터리를 충전 후 재연결하십시오.

</details>

<details>

<summary>Q. 앵커에 전원을 연결했는데 LED가 켜지지 않습니다.</summary>

에러 상태입니다. 해당 앵커의 일련번호와 함께 문의 바랍니다.

</details>

<details>

<summary>Q. 앵커 LED가 노란색으로 빠르게 점멸합니다.</summary>

배터리 잔량이 10% 이하입니다. 보조 배터리를 충전 또는 교체하십시오.

</details>

<details>

<summary>Q. 제공하는 보조 배터리가 아닌 타 제품으로 대체하고 싶습니다.</summary>

1. 가능하지만, 반드시 다음 조건을 만족하는 제품이어야 합니다.
   * **"저전력(Low Current) 모드 지원"** 또는 **"Low Current Mode"** 기능이 있는 제품
   * 출력 **5V 이상**, 용량 **10,000mAh 이상** 권장 (동봉 제품과 동급)
   * USB-A 출력 포트 보유
2. 대체 제품 구매 시 제품 사양서에서 위 기능을 반드시 확인하십시오.
3. 저전력 모드 미지원 제품을 사용하면 앵커가 수시로 꺼지는 문제가 발생합니다.

</details>

### 🗃️ 게이트웨이 관련

<details>

<summary>Q. 게이트웨이 LED가 빨간색으로 느리게 점멸합니다.</summary>

1. 인터넷(네트워크) 연결이 끊긴 상태입니다.
2. LAN 케이블 연결 상태 확인 → 스위치·공유기 상태 확인.
3. 와이파이 연결의 경우 `Q2 Kit` 앱으로 재설정하십시오.

</details>

<details>

<summary>Q. Q2 Kit 앱에서 게이트웨이가 목록에 뜨지 않습니다.</summary>

1. 스마트폰의 블루투스(BLE)가 켜져 있는지 확인하십시오.
2. 게이트웨이에서 3m 이내로 접근 후 재시도하십시오.
3. 게이트웨이 전원을 재부팅한 후 약 30초 뒤 다시 시도하십시오.

</details>

### 🔎 관제 프로그램 관련

<details>

<summary>Q. 로그인할 수 없습니다 (초기 계정으로).</summary>

1. 초기 계정: ID `admin` / PW `admin`
2. 대소문자를 확인하십시오.
3. 이미 비밀번호를 변경한 적이 있다면 변경한 비밀번호로 로그인하십시오.
4. 만약 변경한 비밀번호를 잊었다면 로그아웃 후 로그인 페이지에서 비밀번호 초기화를 진행하십시오.

</details>

<details>

<summary>Q. 이메일 받기로 한 로그인 계정을 받지 못했습니다.</summary>

1. 먼저 이메일의 **스팸함 / 프로모션 탭**을 확인하십시오.
2. 등록하신 이메일 주소가 정확한지 확인하십시오.
3. 위 두 가지에 해당하지 않는다면 [`📖 13. 기술 지원 및 문의`](https://www.notion.so/UWB-Q2-Starter-Kit_-349f0a810b2e80b0af21f6df95592779?pvs=21)로 **고객사명**과 **계정 수령 이메일 주소**를 함께 전달하여 재발송을 요청하십시오.

{% hint style="info" %}
이 계정은 관제 프로그램 다운로드 페이지 로그인용이며, 관제 프로그램 자체 로그인(ID: `admin` / PW: `admin`)과는 별개입니다.
{% endhint %}

</details>

<details>

<summary>Q. 칼리브레이션이 진행되지 않습니다.</summary>

칼리브레이션은 앵커 · 게이트웨이 모두가 정상 상태여야 성공합니다. 정상 상태임에도 불구하고 진행되지 않는다면 아래 세 가지 방법을 확인하세요

1. **최종 뷰 저장이 누락된 경우**

   가장 자주 발생하는 원인입니다. 다음 항목을 순서대로 점검하세요.

   * 기준 앵커가 지정되고 저장되었는지 확인하십시오.
   * 4개 앵커 모두 **🟢** 초록색 LED 상태(정상 동작)인지 확인하십시오.
   * 게이트웨이가 **🟢 초록 LED 상시 점등**(서버와 정상 통신 중) 상태인지 확인
   * `[최종 뷰 저장]`을 **한 번 더 클릭**한 뒤 `[칼리브레이션 > 전체 칼리브레이션]`을 다시 실행<br>
2. **게이트웨이 LED가 🔴 빨강 느린 점멸로 바뀌는 경우**

   인터넷(네트워크) 연결이 끊긴 상태입니다.

   * **주요 원인**
     * 사내 LAN · Wi-Fi 장애 (스위치 · 공유기 재시작, 네트워크 점검 중 등)
     * LAN 케이블이 빠지거나 느슨해짐
     * 와이파이 신호 약함
     * 게이트웨이 전원 불안정
   * **해결 방법**
     1. 게이트웨이 LED가 다시 **🟢 초록 상시 점등**으로 복귀할 때까지 네트워크 환경을 점검합니다.
        * LAN 케이블 체결 상태 재확인
        * 사내 네트워크 스위치 · 공유기 상태 확인
        * 와이파이 연결 시 신호 세기 확인
     2. 필요 시 `Q2 Kit` 앱으로 게이트웨이를 재설정합니다. (네트워크 재연결)
     3. 게이트웨이가 정상(🟢 초록 점등) 상태로 복귀한 뒤, 칼리브레이션을 **다시 실행**합니다.<br>
3. **앵커 거리 측정에 실패하는 경우**
   * 특정 앵커의 **전원이 꺼져 있음** (보조 배터리 방전 · 전원 케이블 빠짐)
   * 앵커 간 **시야가 확보되지 않음** (대형 금속 구조물·두꺼운 콘크리트 벽이 신호를 차단)
   * 앵커가 **너무 멀리** 떨어져 있음 (50m 초과)
   * 앵커 LED가 **🔴 빨강 점멸** (에러 상태)
   * **해결 방법**
     1. 4개 앵커의 LED 상태를 먼저 확인합니다. → **모두 🟢 초록 점멸**이어야 정상
     2. 꺼진 앵커가 있으면 보조 배터리를 점검 (충전 상태 · C-Type 케이블 체결 상태)
     3. 앵커 간 간격이 **5\~30m(권장)** 이내인지 재확인
     4. 앵커와 앵커 사이에 **대형 금속 구조물·두꺼운 콘크리트 벽**이 있다면 앵커 위치를 조정하거나 높이를 올려 시야선(LoS)을 확보
     5. 문제 해결 후 칼리브레이션을 **다시 실행**합니다.

</details>

<details>

<summary>Q. 칼리브레이션을 재시도해도 안전한가요?</summary>

1. 안전합니다. 실패한 칼리브레이션은 기존 좌표를 덮어쓰지 않으므로, 재시도로 인한 데이터 손실은 없습니다.
2. 문제 원인을 해결한 뒤 몇 번이든 다시 실행해도 됩니다.

</details>

<details>

<summary>Q. 칼리브레이션이 계속 실패합니다.</summary>

여러 번 재시도해도 실패하는 경우 문의 바랍니다.

</details>

### 🚶‍♂️‍➡️ 태그 관련

<details>

<summary>Q. 태그 전원을 켰는데 모니터링 화면에 보이지 않습니다.</summary>

1. 태그 LED가 초록 점멸(정상 동작)인지 확인하십시오.
2. 태그가 앵커·게이트웨이의 커버리지 범위 내에 있는지 확인하십시오.
3. `[태그 관리]` 메뉴에서 해당 태그가 등록되어 있는지 확인하십시오.
4. 관제 프로그램을 재시작하십시오.

</details>

<details>

<summary>Q. 태그 위치가 실제와 다르게 표시됩니다.</summary>

1. 칼리브레이션이 정상 완료되었는지 확인하십시오.
2. 지도와 앵커 위치의 회전·반전이 올바른지 확인하십시오.
3. [`📖6.5 칼리브레이션`](https://www.notion.so/UWB-Q2-Starter-Kit_-349f0a810b2e80b0af21f6df95592779?pvs=21)의 개별 앵커 위치 조정(step 3)을 수행하십시오.
4. 앵커와 태그 사이에 대형 금속 구조물 등 차단물이 있으면 앵커 위치 조정을 검토하십시오.

</details>

<details>

<summary>Q. 태그가 지도에서 사라졌다 나타났다를 반복합니다.</summary>

1. **태그 배터리 부족**: 태그 LED가 🟡 노랑 점멸이면 배터리 부족 상태 → USB-C로 충전
2. **커버리지 경계 지점**: 태그가 앵커 4개가 이루는 사각형의 가장자리·바깥에 위치 → 작업 동선을 사각형 내부로 조정하거나 앵커 추가 설치 검토
3. **대형 장애물 차단**: 태그와 앵커 사이에 이동하는 대형 금속 구조물(지게차·철판 등)이 자주 지나가면서 신호가 간헐적으로 차단됨 → 앵커 설치 높이를 올려 시야선 확보

위 원인을 점검해도 계속된다면 `📖 기술 지원 및 문의`로 문의 바랍니다.

</details>

<details>

<summary>Q. 태그 위치가 벽을 뚫고 건너편에 표시됩니다. 정상인가요?</summary>

1. 태그 신호가 벽이나 구조물에 반사되어 앵커에 도달하는 경우, 시스템이 반사 경로를 직접 경로로 오인해 실제 위치와 다르게 계산할 수 있습니다.
   * 앵커 설치 위치를 조정하여 해당 구역의 시야선(LoS) 확보 후 태그를 착용하고 정상적으로 작동하는지 확인하십시오.
2. 지속적으로 동일 위치에서 발생한다면 현장 도면과 함께 문의 바랍니다.

</details>

<details>

<summary>Q. 태그 충전 중에도 측위가 되나요?</summary>

충전 중에는 태그의 UWB와 BLE 통신이 자동으로 꺼지므로 측위가 일시 정지됩니다.

</details>

<details>

<summary>Q. 충전이 끝나면 태그가 자동으로 다시 측위를 시작하나요?</summary>

충전 전에 태그 전원을 켜둔 상태로 충전했는지 여부에 따라 동작이 다릅니다.

* 전원을 ON 시킨 상태로 충전 → 자동으로 다시 켜짐, 10\~20초 후 지도 표시
* 전원을 OFF 시킨 상태로 충전 → 태그가 꺼진 상태 그대로 유지, 전원 버튼 3초 눌러 수동 ON

{% hint style="info" %}
LED로 어느 상태인지 확인하는 방법 (초록 점멸 → 재시작 완료 / 꺼짐 → 수동 ON 필요)
{% endhint %}

</details>