> 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/uwb-mobile-kit-n1.md).

# UWB Mobile Kit N1

### 📦 키트 구성 및 준비 단계

<details>

<summary>모바일 키트는 어떤 구조로 작동하나요?</summary>

모바일 키트는 스마트폰과 3개 이상의 앵커 장치를 연결해, 정밀한 위치 정보를 측정하는 시스템입니다.

* 스마트폰에서 BLE로 앵커를 찾고 연결해요
* 연결이 되면, 스마트폰의 UWB 기능으로 거리와 방향 정보를 실시간으로 받아올 수 있어요
* Android / iOS SDK를 통해 앱에서도 직접 데이터를 처리할 수 있어요

스마트폰이 중심이 되어 작동하는 구조라, 설치가 간단하고 바로 실험에 쓸 수 있어요.

</details>

<details>

<summary>모바일 키트는 어떤 상황에서 사용할 수 있나요?</summary>

설치 부담 없이 빠르게 RTLS를 테스트하거나, 실내 위치 기반 실험이 필요할 때 유용해요.

**주요 활용 예:**

* 교육/워크숍 실습용
* 실험실 위치 데이터 수집
* 앱 개발용 테스트 프로토타입
* 실내 자산 이동 경로 분석

특히 단기 테스트나 PoC에 적합합니다.

</details>

<details>

<summary>모바일 키트는 어떤 환경에서 잘 작동하나요?</summary>

실내 전원 환경에서 안정적으로 작동합니다.

**추천 환경:**

* 전기가 공급되는 사무실, 강의실, 연구실 등
* 전파 간섭이 적은 개방형 공간

※ 앵커는 **유선 전원 연결이 필수**입니다

</details>

<details>

<summary>위치 측정 정확도는 어느 정도인가요?</summary>

실내 기준으로 **±30cm 이내**의 정확도를 기대할 수 있어요.\
환경이나 설치 방식에 따라 차이가 날 수 있지만, 일반적인 실습과 테스트 목적에는 충분한 정밀도입니다.

</details>

<details>

<summary>모바일 키트는 어떤 구성품이 포함되어 있나요?</summary>

박스를 열면 아래 구성품이 들어 있어요:

* 모바일 앵커 4개
* C-type 전원 케이블 4개
* SDK(개발 키트) 문서
* Z 브래킷 4개

별도 구매 없이 소규모 실내 환경에서 RTLS 테스트를 바로 시작할 수 있는 기본 구성입니다.

※ 실험 목적에 따라 앵커를 추가로 구성하거나, SDK 예제 코드를 확장해 사용하는 것도 가능합니다.

</details>

### 🔧 연동 및 개발

<details>

<summary>SDK를 사용해 앱이나 서비스와 연동할 수 있나요?</summary>

네, 모바일 키트는 **GrowSpace SDK**를 통해 자체 앱이나 서비스와 쉽게 연동할 수 있습니다.\
특히 **GrowSpace Android SDK**는 BLE 및 UWB 기반의 실내 위치 기술을 통합한 형태로, 하드웨어 제어부터 위치 추정까지 하나의 클래스(`SpaceUwb`)로 간편하게 구성되어 있습니다.

**Android SDK 주요 기능:**

* BLE + UWB 거리 측정 (Ranging)
* RTLS 기반 위치 추정 (x, y, z 좌표 계산)
* 실시간 장치 연결 / 해제 이벤트 감지

[Android SDK 문서 바로가기](https://freegrow-1.gitbook.io/product-docs-kr/mobilekit_n1/uwb-n1-sdk/sdk/android)

[iOS SDK 문서 바로가기](https://freegrow-1.gitbook.io/product-docs-kr/mobilekit_n1/uwb-n1-sdk/sdk/ios)

</details>

<details>

<summary>어떤 플랫폼(Android, iOS 등)을 지원하나요?</summary>

모바일 키트는 다양한 운영체제 환경에서 연동이 가능하도록 **멀티 플랫폼 지원**을 제공합니다.

* **Android**\
  → 공식 SDK(GrowSpace Android SDK)를 제공하며,\
  BLE + UWB 기반 거리 측정 및 위치 추정 기능을 하나의 클래스(`SpaceUwb`)로 통합 제어할 수 있습니다.
* **iOS**\
  → Swift 기반 BLE 통신을 활용한 연동이 가능하며,\
  위치 데이터 수신 및 실시간 모니터링 예제를 제공합니다.

</details>

<details>

<summary>어떤 스마트폰 모델이 모바일 키트와 호환되나요?</summary>

UWB 기능이 탑재된 스마트폰만 사용 가능합니다.\
기종에 따라 **방향(각도: azimuth, elevation)** 측정 가능 여부가 다를 수 있어요.

***

**✅ Android 기기**

Galaxy 시리즈는 대부분 **+ 또는 Ultra 모델**만 각도 측정을 지원합니다.홈페이지 영문 홈페이지 수정\
Google Pixel 시리즈 일부 모델도 포함됩니다.

**대표 지원 모델:**

* Galaxy Note20 Ultra
* Galaxy S21+ / S21 Ultra
* Galaxy S22+ / S22 Ultra
* Galaxy S23+ / S23 Ultra
* Galaxy S24+ / S24 Ultra
* Galaxy S25+ / S25 Ultra
* Galaxy Z Fold2 \~ Z Fold5
* 일부 Pixel UWB 모델

{% hint style="info" %}
Galaxy S24+는 각도 측정이 제한되는 사례가 있어, **사전 테스트**를 권장합니다.\
앱 내 **\[Check azimuth, elevation] 메뉴**를 통해 측정 가능 여부를 직접 확인할 수 있어요.
{% endhint %}

***

**✅ iOS 기기**

**iPhone 11 이상** 모델은 대부분 자동으로 UWB 방향 정보가 수집됩니다.

**대표 지원 모델:**

* iPhone 11 / 11 Pro / 11 Pro Max
* iPhone 12 \~ 14 시리즈 (Pro 포함)

**UWB 지원 여부는 기기 제조사 사양 또는** [**RTLS 앱 메뉴**](https://freegrow-1.gitbook.io/product-docs-kr/mobilekit_n1/uwb-n1/undefined/undefined-1)**에서 확인**해 주세요.

{% hint style="warning" %}
iPhone 14 이후(UWB U2 모델)에서는 **고도각(Elevation)** 기능을 지원하지 않을 수 있습니다.
{% endhint %}

</details>

<details>

<summary>앵커 1대에 몇 대의 스마트폰을 동시에 연결할 수 있나요?</summary>

앵커 1대는 **최대 5\~6대의 스마트폰**과 동시에 연동될 수 있습니다.\
즉, 하나의 앵커로 여러 스마트폰의 위치를 동시에 측정할 수 있어요.

</details>

### 🔌 전원 및 사용 시간 관련

<details>

<summary>앵커는 충전해서 얼마나 사용할 수 있나요?</summary>

모바일 키트(N1)의 앵커는 **배터리 충전식이 아닌, 유선 전원 방식**입니다.\
즉, 전원 케이블을 연결한 상태에서만 정상 작동합니다.

* 충전해서 사용하는 형태는 아니며, 별도 배터리 내장도 되어 있지 않습니다.
* 사용 시에는 **전기가 공급되는 실내 환경**이 필요합니다.

</details>

<details>

<summary>전원 공급 방식은 어떤가요? 배터리인가요, 케이블인가요?</summary>

모바일 키트(N1)의 앵커는 **케이블을 통한 유선 전원 방식**입니다.\
배터리를 내장하고 있지 않아, 반드시 **전기가 공급되는 장소**에서 사용해야 합니다.

* 앵커 1개당 C-type 케이블 1개가 포함되어 있으며, USB 전원 어댑터(5V/1A 이상)나 멀티포트 충전기 등에 연결해 사용합니다.
* 스마트폰은 자체 배터리로 작동하므로 별도 전원이 필요하지 않습니다.

모바일 키트(N1)는설치가 간단하고 장시간 연속 사용이 가능하지만, **배터리로 작동하거나 이동하며 쓰는 용도에는 적합하지 않습니다.**

※ 전원 연결이 어려운 야외 환경에서는 사용이 제한됩니다.

</details>

<details>

<summary>펌웨어 업데이트 후 UWB 거리 측정값이 갑자기 튀는 이유가 무엇인가요?</summary>

**UWB(Ultra Wideband)** 기술의 특성상 발생할 수 있는 정상적인 현상입니다.

#### **✅** 원인

* **신호 흡수** : 인체는 수분 함량이 높아 UWB 신호를 약화시킵니다.
* **신호 반사** : 철제 구조물 같은 금속은 UWB 신호를 강하게 반사해 거리 측정값에 큰 오차를 유발할 수 있습니다.
* **안테나 지향성** : 대부분의 휴대폰 UWB 안테나는 **기기 후면부**에 위치해 있으며 지향성을 갖고 \
  있어, 안테나가 신호 방향을 등지고 있으면 수신이 어려워집니다.

***

#### **✅**&#xD574;결 방법

1. **직접적인 장애물 제거**

   : 장비와 휴대폰 사이에 철제 구조물, 인체, 벽 등 장애물이 없도록 배치하세요.
2. **신체와의 거리 확보**\
   : 장비를 신체에서 **일정 거리 이상 이격**하여 사용하는 것이 좋습니다.
3. **안테나 방향 조정**

   : 휴대폰을 회전시켜 UWB 안테나가 장비를 향하도록 하면 신호 안정성을 높일 수 있습니다.

{% hint style="warning" %}
참고 사항

* UWB 신호는 **고주파 특성** 때문에 장애물의 영향을 크게 받습니다.
* 인체나 금속뿐만 아니라 **벽, 가구, 전자기기** 등도 신호 품질에 영향을 줄 수 있습니다.
* 펌웨어 업데이트와는 무관하게, UWB의 근본적인 물리적 특성에 따른 동작이므로 하드웨어 배치와\
  사용 환경을 최적화하는 것이 중요합니다.
  {% endhint %}

</details>

<details>

<summary>모바일 키트 N1 앵커도 배터리로 사용이 가능한가요?</summary>

모바일 키트 N1의 UWB 앵커는 유선 전원(전원 어댑터 연결) 장비로 설계되어 있으며,
\
배터리 충전식으로 야외를 이동하면서 사용하는 형태는 정식 지원하지 않습니다.

설치 위치를 바꿔가며 실내 테스트를 하는 것은 가능하지만,
\
상시 안정적인 운용을 위해서는 고정 설치 및 상시 전원 공급을 권장합니다.

저전력 설계가 된 보조배터리를 활용해 야외 환경에서도 사용이 가능합니다.

</details>

<details>

<summary>보조 배터리 사용 시 일부 UWB 보드가 꺼지는 이유가 무엇인가요?</summary>

이러한 현상은 보조 배터리의 **저전력 차단 기능**으로 인해 발생하는 경우가 많습니다.

\
**✅** 원인

1. **보조 배터리 저전력 차단 기능**
   * 일부 보조  배터리는 연결된 기기의 **소비 전력이 일정 수준 이하일 경우**, 기기가 연결되지 \
     않았다고 판단해 자동으로 출력을 차단합니다.
   * UWB 장비는 부팅 시 순간적으로 전류를 많이 소모하지만, **평상시 소비 전력은 매우 낮아** \
     보조 배터리에서 출력을 차단하는 현상이 발생할 수 있습니다.
2. **보드별 소비 전력 특성 차이**
   * 동일한 보조 배터리를 사용해도, **UWB 보드별 전력 소모량이 다를 수 있어** 일부 보드는 \
     유지가 되고 일부 보드는 꺼질 수 있습니다.

***

**✅ 해결 방법**

1. **스마트폰 동시 연결**
   * 보조 배터리에 UWB 장비와 **스마트폰을 동시에 연결**하면 일정 전력이 꾸준히 소모되어 전원 유지 안정성이 높아집니다.
2. **일반 전원 사용 테스트**
   * USB 어댑터나 PC USB 포트 등 **일반 전원에 연결**했을 때 동일한 문제가 발생하는지 확인해 보세요.
   * 일반 전원에서는 문제가 없다면 보조 배터리의 저전력 차단 기능에 의한 현상일 가능성이 높습니다.

{% hint style="warning" %}
참고 사항

* 보조  배터리마다 저전력 차단 기능의 **감도와 해제 방법**이 다르므로, 필요 시 제조사 매뉴얼을 확인하는 것이 좋습니다.&#x20;
  {% endhint %}

</details>

<details>

<summary>SDK에 Low-pass Filter 기능이 포함되어 있나요?</summary>

현재 SDK 자체에는 **Low-pass Filter 방식이 구현되어 있지 않으며**, 해당 기능을 사용하려면 **직접**&#x20;

**구현해야** 합니다.

</details>