> 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/creatorkit_q1/uwb-q1/undefined/undefined-3.md).

# 태그 설정(인적, 물적, 개발자용 태그)

GrowSpace UWB 태그의 초기 설정과 위치 송출 구성 방법

### 📌 이 가이드는 워드프레스로 이전되었습니다. 최신 버전: <https://grow-space.io/docs/tag-config/>

### 이 글에서는

GrowSpace UWB 태그를 실내 위치 측위 시스템(RTLS)에 연동하기 위한 **기본 설정 절차와 주요 기능 구성 방법**을 안내합니다.

***

### 태그란?

**GrowSpace UWB 태그**는 사람 또는 사물의 **실내 위치를 실시간으로 송출**하는 장치입니다.\
GrowSpace는 사용 목적에 따라 **개발자용 태그**, **인적 태그**, **물적 태그**의 세 가지 형태를 제공합니다.

* **개발자용 태그**\
  펌웨어 디버깅과 실험적 환경 테스트에 최적화된 태그로, **시스템 개발자**나 **연구자**가 다양한 위치 인식 실험을 수행할 수 있도록 설계되었습니다.
* **인적 태그**\
  사람의 실내 위치를 추적하기 위해 사용하는 태그입니다. 착용 편의성을 고려해 설계되었으며, 기능은 개발자용 태그와 동일합니다.
* **물적 태그**\
  장비, 물품, 자산 등 사물의 위치를 추적하기 위해 사용하는 태그입니다. 내구성과 부착성을 강화한 설계를 적용했습니다.

{% hint style="info" %}
**참고**

인적 태그와 물적 태그는 기능적으로 개발자용 태그와 거의 동일하며, 기본 설정 및 연결 방법도 동일하게 적용됩니다.

다만, 가장 큰 차이는 배터리 탑재 여부입니다.

* **인적·물적 태그: 내장 배터리를 탑재하여 별도의 전원 연결 없이 사용 가능**
* **개발자용 태그: 배터리 미탑재, USB 전원 연결을 통해만 동작**
  {% endhint %}

#### **태그 종류 및 특징**

| 물적 태그                                                                                                                                                                                                                                                                                     | 인적 태그                                                                                                                                                                                                                                                                                     | 개발자용 태그                                                                                                                                                                                                                                                                                   |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 장비, 자산, 물품 등의 위치 추적용                                                                                                                                                                                                                                                                      | 사람 위치 추적 전용                                                                                                                                                                                                                                                                               | 펌웨어 디버깅 및 실험 환경 테스트용                                                                                                                                                                                                                                                                      |
| 내구성과 부착성 강화                                                                                                                                                                                                                                                                               | 착용 편의성 고려                                                                                                                                                                                                                                                                                 | USB 연결 및 고급 설정 지원                                                                                                                                                                                                                                                                         |
| 기본 저전력 모드 **비활성화**                                                                                                                                                                                                                                                                        | 기본 저전력 모드 **비활성화**                                                                                                                                                                                                                                                                        | 저전력 모드 설정 및 디버깅 기능 강화                                                                                                                                                                                                                                                                     |
| <div><figure><img src="https://2885569511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYKyrLLe7cm7ZOhiSB0gg%2Fuploads%2FoM11TcYDMK1U047GYfcP%2Fimage.png?alt=media&amp;token=0100c195-8353-4e6f-8b3c-39172a31fe08" alt=""><figcaption></figcaption></figure></div> | <div><figure><img src="https://2885569511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYKyrLLe7cm7ZOhiSB0gg%2Fuploads%2FMgtyajoAWEmNEjIfu5wF%2Fimage.png?alt=media&amp;token=ad5aedf2-09e9-4318-a421-3ce9e29fd5ca" alt=""><figcaption></figcaption></figure></div> | <div><figure><img src="https://2885569511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYKyrLLe7cm7ZOhiSB0gg%2Fuploads%2F7Z7YC9mrJecEiVXqQwk4%2Fimage.png?alt=media&amp;token=908ef8a9-a176-4ddc-89e1-418588b8b37b" alt=""><figcaption></figcaption></figure></div> |

**활용 예시**

* UWB 기반 위치 인식 기술의 연구 및 테스트
* 외부 센서 연동 시뮬레이션
* 리스너와 연동한 위치 데이터 검증

***

### 사전 준비

#### 하드웨어

<table><thead><tr><th width="273.20001220703125">항목</th><th>설명</th></tr></thead><tbody><tr><td>GrowSpace UWB 태그</td><td>SpaceTag-DT1</td></tr><tr><td>Windows PC</td><td>Windows 10 이상 권장</td></tr><tr><td>USB 케이블</td><td>USB Type-A to Type-C</td></tr></tbody></table>

#### 소프트웨어

| 항목               | 설명                                                                                 |
| ---------------- | ---------------------------------------------------------------------------------- |
| 웹 설정 도구          | <https://grow-space.io/software/>                                                  |
| USB to UART 드라이버 | [CP210x VCP 드라이버 설치 가이드](/product-docs-kr/creatorkit_q1/undefined-1/cp210x-vcp.md) |

***

### 태그 연결 및 인식 확인

* UWB 태그를USB 케이블로 PC에 연결합니다.

<figure><img src="https://2885569511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYKyrLLe7cm7ZOhiSB0gg%2Fuploads%2FZJzEM5JZR0gvcNhVgkC5%2Fimage.png?alt=media&amp;token=f6fce45a-495f-416d-9de5-44e283c6cd8d" alt="" width="563"><figcaption></figcaption></figure>

* [**웹 설정 도구**](https://grow-space.io/software/)에 접속합니다.&#x20;

{% hint style="info" %}
&#x20;Chrome 브라우저를 사용해야 합니다. 다른 브라우저에서는 장치 연결이나 시리얼 포트 인식이 제한될 수 있습니다.
{% endhint %}

* 왼쪽 사이드바에서 **“앵커, 태그, 리스너 설정 프로그램” → “웹프로그램”**&#xC744; 클릭합니다.&#x20;

{% columns %}
{% column %}

<figure><img src="https://2885569511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYKyrLLe7cm7ZOhiSB0gg%2Fuploads%2FPBaw0ay85wWXLzN38GmH%2Fimage.png?alt=media&amp;token=631aad80-11ab-4717-a09e-e2348248321c" alt=""><figcaption></figcaption></figure>

{% endcolumn %}

{% column %}

<figure><img src="https://2885569511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYKyrLLe7cm7ZOhiSB0gg%2Fuploads%2FgcVOJbc2idqKt4Sqy1rO%2Fimage.png?alt=media&amp;token=8f474cd1-6428-4e95-818d-628bb64dfb8e" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

* 다음과 같은 설정 화면이 나타납니다.

<figure><img src="https://2885569511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYKyrLLe7cm7ZOhiSB0gg%2Fuploads%2F6HKqg9ZM5yWe4zu9NwNU%2Fimage.png?alt=media&amp;token=38b604b2-49d5-4bb9-b36c-b95224c56346" alt=""><figcaption></figcaption></figure>

* &#x20;**\[Connect]** 버튼을 클릭합니다.
* 연결 가능한 포트 목록(COM 포트)에서 UWB 태그를 선택합니다
* 연결이 완료되면, 아래와 같은 항목이 화면에 표시됩니다

  <figure><img src="https://2885569511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYKyrLLe7cm7ZOhiSB0gg%2Fuploads%2FWVSur0SMvVQwI63iZHUX%2Fimage.png?alt=media&amp;token=cd06adbd-de2b-45cc-a8f5-a90669bd367b" alt=""><figcaption></figcaption></figure>

  * **왼쪽 상단 영역:**

    * 장치 이름 (예: GR550D)
    * 장치 타입 (예: `TAG`)
    * PAN ID, 송출 주기(Update Rate), 저전력 모드(Low Power Mode)  설정 정보
    * \[Modify Settings] 버튼으로 설정 변경 가능

  * **왼쪽 하단 영역 \[Realtime Data]:**
    * **TAG Position**: 현재 태그의 추정 위치 (X, Y, Z 좌표 / 단위: mm)
    * **Anchor Distances**: 주변 앵커들과의 거리 정보\
      (앵커 ID, 거리, 각 앵커의 고정 좌표 포함)

### 장치 인식 실패 시 조치

{% hint style="warning" %}
장치가 PC에 연결되지 않거나, 포트 목록에 표시되지 않는다면 다음 항목들을 차례대로 확인해 주세요.

* **USB 케이블을 다른 것으로 교체하여 다시 연결해 보세요.**\
  간혹 케이블 문제로 인해 장치가 정상적으로 인식되지 않는 경우가 있습니다.
* **다른 USB 포트에 연결해 보세요.**\
  사용하는 포트에 따라 인식이 되지 않을 수 있으니, 가능한 포트를 바꿔 시도해 주세요.
* **CP210x VCP 드라이버가 설치되어 있는지 확인해 주세요.**\
  특히 리스너(Listener) 장비는 해당 드라이버가 설치되어 있어야 포트가 정상적으로 인식됩니다.
* **아직 드라이버가 설치되지 않았다면 아래 가이드를 참고해 주세요.**\
  [→ \[CP210x VCP 드라이버 설치 가이드 보기\]](/product-docs-kr/creatorkit_q1/undefined-1/cp210x-vcp.md)
* **물적 태그·인적 태그 연결 시 전원 버튼 확인**
  * 물적 태그와 인적 태그는 **USB 연결 후 전원 버튼을 눌러야 정상적으로 인식**됩니다.
  * 전원 버튼을 눌렀을 때 **빨간불(X)** 대신 **노란불(O)**&#xC774; 점등되는지 꼭 확인하세요.
  * 노란불이 점등되지 않으면 장치가 활성화되지 않아 인식되지 않습니다.
    {% endhint %}

***

### PAN ID 설정

PAN ID(Personal Area Network ID)는 RTLS 장치 간 네트워크 그룹을 구분하는 식별자입니다.\
태그는 앵커 및 리스너와 **동일한 PAN ID**를 사용해야 통신이 가능합니다.

#### 설정 방법

1. 웹 설정 도구 내 **PAN ID** 입력란에 값을 입력합니다.\
   예: `0x0000`

<figure><img src="https://2885569511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYKyrLLe7cm7ZOhiSB0gg%2Fuploads%2FXvBYoeDxeW9uGma8gxgb%2Fpan%20id.jpg?alt=media&amp;token=4cb54123-43c1-458f-9a55-45c2e82eff7f" alt=""><figcaption></figcaption></figure>

1. **\[Save]** 버튼을 클릭하여 저장합니다.

{% hint style="info" %}
PAN ID가 다를 경우 태그는 네트워크에 연결되지 않음
{% endhint %}

***

### 송출 주기 설정 (Update Rate)

태그는 실시간으로 위치 데이터를 송출하며, **이동 중일 때**와 **정지 중일 때** 각각 송출 주기를 다르게 설정할 수 있습니다.

<figure><img src="https://2885569511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYKyrLLe7cm7ZOhiSB0gg%2Fuploads%2FBBwdMENQjS4qlAIHajig%2Fimage.png?alt=media&amp;token=7d89715c-1366-44b5-a01c-be0e21a12749" alt=""><figcaption></figcaption></figure>

| 항목                     | 설명                 | 기본값    |
| ---------------------- | ------------------ | ------ |
| **Update Rate (Norm)** | 이동 중 송출 주기 (ms 단위) | 100 ms |
| **Update Rate (Stat)** | 정지 중 송출 주기 (ms 단위) | 100 ms |

#### 설정 예시

| 설정 값    | 의미        | 추천 상황         |
| ------- | --------- | ------------- |
| 100 ms  | 0.1초마다 송출 | 고속 추적, 반응성 우선 |
| 500 ms  | 0.5초마다 송출 | 일반 위치 확인      |
| 1000 ms | 1초마다 송출   | 배터리 절약        |
| 5000 ms | 5초마다 송출   | 장시간 정지 상태 대상  |

> `Norm` 값이 짧을수록 위치 반응 속도는 빨라지며, 배터리 소모는 증가합니다.\
> `Stat` 값을 길게 설정하면 정지 중 배터리를 절약할 수 있습니다.

***

### Stationary 기능 설정

Stationary 기능은 UWB 태그가 **정지 상태와 이동 상태를 자동으로 판단**하여, 각각 다른 전송 빈도를 적용하는 기능입니다.\
이를 통해 **불필요한 전송을 줄이고 배터리 소모를 최소화**할 수 있습니다.

* 동작 감지는 **내장 가속도 센서**를 사용합니다.
* 감지된 정지 상태에서는 전송 빈도를 줄여줍니다.

<figure><img src="https://2885569511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYKyrLLe7cm7ZOhiSB0gg%2Fuploads%2FrhR2zg5BCM5a31RJKB1a%2Fsta.jpg?alt=media&amp;token=b727251d-124d-4634-8b72-78147b5556b9" alt=""><figcaption></figcaption></figure>

* Low : 작은 움직임 무시하고 큰 움직임만 감지
* Normal : 기본 감도
* High : 미세한 움직임도 감지

***

### 저전력 모드(Low Power Mode) 설정

**저전력 모드(Low Power Mode)**&#xB294; 배터리 소모를 줄이기 위해 **BLE(Bluetooth Low Energy) 신호를 차단**하여 전력 효율을 높이는 기능입니다.\
실제 위치 측위에는 영향을 주지 않으므로, 대부분의 경우 **활성화해도 문제없이 사용**할 수 있습니다.

<figure><img src="https://2885569511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYKyrLLe7cm7ZOhiSB0gg%2Fuploads%2FoFvbcHuNrC4jecw6RknP%2Flow.jpg?alt=media&amp;token=9310d1d8-e903-428e-b736-8d71a6f3312b" alt=""><figcaption></figcaption></figure>

### **사용 권장 시나리오**

<table><thead><tr><th width="212.2000732421875">상황</th><th width="128.60009765625">권장 설정</th><th>설명</th></tr></thead><tbody><tr><td><strong>일반적인 측위 사용 시</strong></td><td>활성화</td><td>현재 시스템에서는 BLE 신호를 사용하지 않으므로 저전력 모드를 켜도 측위 성능에 영향이 없습니다.</td></tr><tr><td><strong>BLE 신호 사용 필요 시</strong></td><td>비활성화</td><td>추후 BLE 신호를 활용해야 하는 경우에는 저전력 모드를 꺼야 정상 동작합니다.</td></tr><tr><td><strong>설정 변경 중</strong></td><td>비활성화</td><td>저전력 모드가 켜진 상태에서 설정을 변경하면 <strong>간혹 설정이 반영되지 않는 문제</strong>가 발생할 수 있으므로, 설정 시에는 끄는 것을 권장합니다. 설정 완료 후 다시 켜면 배터리 효율을 높일 수 있습니다.</td></tr></tbody></table>

{% hint style="danger" %}

### **중요한 주의사항**

**저전력 모드가 켜진 상태에서 설정을 진행하면 간혹 설정이 정상적으로 적용되지 않는 문제가 발생할 수 있습니다.**\
따라서 **설정을 변경할 때는 반드시 저전력 모드를 꺼 두고 진행**하시기를 강력히 권장합니다.

설정이 완료된 이후에는 필요에 따라 저전력 모드를 다시 **켜서 배터리 효율을 높일 수 있습니다**.
{% endhint %}

### **태그 기본 설정 안내**

* GrowSpace UWB 태그(SpaceTag-DT1)는 출고 시 **저전력 모드가 기본적으로 꺼져 있는 상태**입니다.
* 저전력 모드 활성화 여부는 **사용 환경과 목적에 따라 고객이 직접 설정**할 수 있습니다.

***

### 실시간 거리 확인 기능

GrowSpace 웹 설정 도구에서는 태그의 신호가 어떤 앵커까지 도달했는지, 거리(m 단위)로 실시간 시각화할 수 있습니다.

<figure><img src="https://2885569511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYKyrLLe7cm7ZOhiSB0gg%2Fuploads%2FJOebsyF38W2Qfx3vJim0%2Fimage.png?alt=media&amp;token=30f47a66-ac2a-49e7-b876-6f6b75007517" alt=""><figcaption></figcaption></figure>

* 빨간 점: 현재 연결된 태그
* 파란 점들: 수신된 앵커
* 선(Line): 태그와 앵커 간 거리

> 해당 기능은 네트워크 상태 점검, 앵커 인식 범위 확인에 유용하게 활용됩니다.

***

## 💻 설치 프로그램도 사용할 수 있어요!

GrowSpace 리스너는 웹 도구뿐만 아니라, **전용 설정 프로그램(GrowSpace 개발 프로그램)**&#xC744; 통해서도 설정할 수 있습니다. 보다 정밀한 조정이나 오프라인 환경에서 설정이 필요할 경우 설치 프로그램 사용을 권장합니다.

#### 설정 프로그램 설치 방법

* PC에서 <https://drive.google.com/file/d/1L76hj_xsFe_flzxv6n_Svr73HJntvUxe/view?pli=1> 로 접속

  * 설치 파일: `uwb_settings.exe`

  <figure><img src="https://2885569511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYKyrLLe7cm7ZOhiSB0gg%2Fuploads%2FSf6mnYnCnJDzLlDRMt1e%2Fimage.png?alt=media&amp;token=df4959b0-bc66-4e28-a2a4-1aba5dc0886d" alt=""><figcaption></figcaption></figure>
* 실행 시 보안 경고가 뜨면 **\[추가 정보 → 실행]**&#xC744; 클릭하여 설치 진행

{% columns %}
{% column %}

<figure><img src="https://2885569511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYKyrLLe7cm7ZOhiSB0gg%2Fuploads%2F9DcIjEDXbxDxP6MFQhKf%2Fimage.png?alt=media&amp;token=b567ea2c-caaa-4a56-a50e-3c19f0d9a51d" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

<figure><img src="https://2885569511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYKyrLLe7cm7ZOhiSB0gg%2Fuploads%2F5TZYge4ZIRGGVhsuHbRH%2Fimage.png?alt=media&amp;token=3f9fcd67-90a8-4043-84b9-eec7af420d70" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

* 설치 완료 후 프로그램 실행 → 리스너 연결 및 설정

#### 태그 연결 및 인식 확인

* \[Connect] 버튼 클릭 후, 연결할 태그의 COM 포트 선택

<figure><img src="https://2885569511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYKyrLLe7cm7ZOhiSB0gg%2Fuploads%2FRjpbggWMAEH0k7oyIBnO%2Fimage.png?alt=media&amp;token=2f212581-50bf-4368-8df7-0552e0faa03c" alt=""><figcaption></figcaption></figure>

* 설정 화면에서 PAN ID, Positioning Rate, Wake Rate 등 입력 후 \[Save] 클릭

<figure><img src="https://2885569511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYKyrLLe7cm7ZOhiSB0gg%2Fuploads%2FNe5yDmlX1diiP41etGWe%2Fimage.png?alt=media&amp;token=fcd2e69c-61e3-4854-8311-c7e26f9ee8c6" alt=""><figcaption></figcaption></figure>

GrowSpace 태그 설정은 **웹 도구**와 **전용 프로그램** 모두 거의 동일하게 진행됩니다.\
특히 다음 항목은 두 방식 모두에서 같은 개념으로 작동합니다:

* ✅ **PAN ID 설정**
* ✅ **절전 모드(Auto Sleep Mode) 설정**

> UI는 다를 수 있지만, 기능과 목적은 동일합니다.

***

하지만! **송출 속도 설정 방식(Positioning Rate & Wake Rate)**&#xC740; 도구별로 입력 방식이 다릅니다.

| 구분      | 웹 설정 도구              | 설정 프로그램                       |
| ------- | -------------------- | ----------------------------- |
| 이동 중 주기 | `Norm` 값 (예: 100ms)  | `Positioning Rate` (예: 100ms) |
| 정지 중 주기 | `Stat` 값 (예: 2000ms) | `Wake Rate` (예: 2000ms)       |

* 두 설정은 **같은 의미지만 명칭과 위치가 다르기 때문에** 혼동하지 않도록 주의해야 합니다.
* 예를 들어,\
  `웹 도구: Norm = 100, Stat = 2000`\
  → `설정 프로그램: Positioning Rate = 100, Wake Rate = 2000` 과 동일합니다.