> 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-4.md).

# 리스너 설정 및 데이터 확인(선택)

실시간 위치 데이터를 수신하고 시각화하는 리스너 설정 방법

{% hint style="danger" %}
📌 이 가이드는 워드프레스로 이전되었습니다. 최신 버전: <https://grow-space.io/docs/listener-config/>

이 문서는 **리스너(Listener) 기반 구성**을 위한 가이드입니다.\
만약 **크리에이터 확장 키트 또는 게이트웨이(Gateway) 기반 환경**을 사용하신다면,\
[게이트웨이 매뉴얼](https://freegrow-1.gitbook.io/product-docs-kr/creatorkit_q1/uwb-q1/undefined/undefined-5)을 함께 참고해 주세요.
{% endhint %}

### 이 글에서는

GrowSpace 크리에이터 키트 Q1에 포함된 리스너(Listener)를 설정하고,\
UWB 태그의 위치 데이터를 수신하여 **Web Console에서 실시간으로 확인하는 방법**을 안내합니다.\
이후 도면(지도)과 연동하여 현장 기반의 시각화 기능도 함께 설정할 수 있습니다.

***

### 리스너란?

**리스너는 태그가 송신한 위치 신호를 수신해 시스템으로 전달하는 장치**입니다.\
**태그 →&#x20;**<mark style="color:red;">**리스너**</mark>**&#x20;→ 소프트웨어** 또는 서버로 데이터가 전달되며, 실시간 위치 추적 및 시각화를 위해 핵심적인 구성 요소입니다.

***

### 리스너 연결 및 인식 확인

* **리스너를 USB 케이블로 PC의 USB 포트에 연결합니다.**

<figure><img src="https://2885569511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYKyrLLe7cm7ZOhiSB0gg%2Fuploads%2FuQJUXCuIJk8ES3jhsdw5%2Fimage.png?alt=media&amp;token=97d3294d-3142-4728-978f-e9557028f820" alt="" width="375"><figcaption></figcaption></figure>

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

{% hint style="info" %}
반드시 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%2FC460uq7PIzfsIbX6wNPl%2Fimage.png?alt=media&amp;token=52e8b1be-1787-4ea5-8d9a-f37a783f286e" alt=""><figcaption></figcaption></figure>

* **\[Connect]** 버튼을 클릭합니다.
* 연결 가능한 포트 목록(COM 포트)에서 UWB 리스너를 선택합니다

<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>

* 연결이 완료되면, 아래와 같은 항목이 화면에 표시됩니다.
  * 왼쪽 상단 영역 (장치 정보)

    * **장치 ID**: 연결된 리스너의 고유 이름이 표시됩니다.\
      예: `GR3841`
    * **장치 타입**: `LISTENER`로 표시됩니다.
    * **PAN ID**: 현재 설정된 네트워크 그룹 ID 값이 나타납니다.\
      예: `0x0000`
    * **Modify Settings** 버튼: PAN ID 등 설정값을 수정할 수 있습니다.

  * 왼쪽 하단 영역 (Realtime Data)

    **\[Tag List]**

    * 현재 연결된 태그가 있을 경우, 리스트로 표시됩니다.
    * `Tag Distances` 영역은 리스너가 수신한 태그의 거리 정보입니다.\
      → 태그가 아직 연결되지 않았다면 비워져 있을 수 있습니다.

    **\[Anchor List]**

    * 시스템에 연결된 모든 앵커들의 정보가 나열됩니다.

  * 중앙 화면 (위치 시각화 캔버스)
    * 연결된 **앵커**들이 화면상 좌표 기준으로 회색 점으로 표시됩니다.\
      → 예: `GR100C`, `GR1026`, `GR32AA` 등
    * 추후 태그가 연결되면 태그도 중심에 **붉은 점**으로 표시되고,\
      리스너가 인식한 앵커와 태그 사이의 **거리선**이 자동으로 연결됩니다.

<figure><img src="https://2885569511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYKyrLLe7cm7ZOhiSB0gg%2Fuploads%2FJzhLMzW36f1xQFlXdOOe%2Fimage.png?alt=media&amp;token=810ef1ee-3804-40b0-aa43-a8a8dd5fb9ac" alt=""><figcaption></figcaption></figure>

***

### PAN ID 설정

* \[Modify Settings] 버튼을 클릭하여 설정 화면으로 이동합니다.
* **PAN ID 입력란에 기존 앵커/태그와 동일한 값**을 입력합니다.\
  예: `0x0000`

<figure><img src="https://2885569511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYKyrLLe7cm7ZOhiSB0gg%2Fuploads%2FEnor3skvE5T550xEpYdg%2Fimage.png?alt=media&amp;token=9eddbaf3-4d6b-4aa0-ae3a-ee5c4d7ce641" alt=""><figcaption></figcaption></figure>

* \[Save]를 클릭해 저장합니다.

> GrowSpace RTLS 시스템은 **모든 장치가 동일한 PAN ID**를 사용해야 태그의 위치 데이터가 리스너로 정상 수신됩니다.

***

### 신호 필터 강도 설정 (Filter Strength)

GrowSpace Web Console에서는 리스너가 수신하는 **위치 신호의 품질**을 필터링해 안정적으로 처리할 수 있도록 필터 강도를 설정할 수 있습니다.

<figure><img src="https://2885569511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYKyrLLe7cm7ZOhiSB0gg%2Fuploads%2FdXNuGMWj4j82bNURFIyJ%2Fimage.png?alt=media&amp;token=99aaeac9-a6ca-490f-8f9d-0560de5435db" alt=""><figcaption></figcaption></figure>

#### 설정 방법

* 상단 우측의 **필터 아이콘**을 클릭합니다.
* 5단계 옵션 중 원하는 필터 강도를 선택합니다.
* \[Apply] 버튼을 클릭해 설정을 저장합니다.

| 옵션          | 설명                        | 추천 환경            |
| ----------- | ------------------------- | ---------------- |
| Very Strong | 신호 노이즈를 엄격하게 제거, 변화 거의 없음 | 의료, 안전 중심 환경     |
| Strong      | 기본 권장 옵션, 대부분의 흔들림 필터링    | 일반 실내 위치 추적 환경   |
| Moderate    | 필터와 반응성 균형                | 개발 테스트, 프로토타입 단계 |
| Soft        | 빠른 반응, 다소 오차 있음           | UX 검증, 실시간 반응 우선 |
| No Filter   | 원신호 그대로 출력                | 디버깅, 알고리즘 분석용    |

> 위치가 자주 튀거나 흔들릴 경우 `Strong` 이상을 권장합니다.\
> 반대로, 빠른 반응성이 필요한 경우 `Soft` 또는 `No Filter`를 시도할 수 있습니다.

***

### 지도(도면) 연동 기능

실내 공간의 **도면 이미지**를 업로드하면 태그의 위치를 실제 공간 위에 시각적으로 표시할 수 있습니다.\
(도면은 선택 사항이며, 좌표 기반 운영도 가능합니다.)

<figure><img src="https://2885569511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYKyrLLe7cm7ZOhiSB0gg%2Fuploads%2FxehEi7CutjZwbSpZYr4L%2Fimage.png?alt=media&amp;token=9f0db1b0-6456-4592-a04b-36d4b41c4131" alt=""><figcaption></figcaption></figure>

#### 설정 순서

* 우측 상단의 **\[Fit] 버튼**을 클릭합니다.
* **\[Manual Fit Settings]** 버튼을 눌러 수동 위치 정렬 모드로 진입합니다.
* **\[Upload Image]** 버튼을 눌러 PNG, JPG 등의 도면 이미지를 업로드합니다.

도면이 캔버스 배경에 나타나면, 실제 앵커 위치와 이미지 상 위치를 수동으로 일치시킵니다.

> 도면은 평면도, 배치도, 레이아웃 등 위치 구조를 보여주는 이미지가 적합합니다.

***

#### 도면 연동의 장점

* 태그 위치를 도면 위에서 실시간으로 확인 가능
* 작업자 동선, 공간 활용도, 비효율 구간 등을 직관적으로 분석 가능
* 시각화 기반 유지보수 및 운영 개선

### 설정 완료

이제 리스너가 태그 데이터를 정상적으로 수신하고, 위치 시각화 화면에서 태그의 실시간 위치가 표시되었다면 모든 설정이 완료된 것입니다.

***

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

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 %}

* 설치 완료 후 프로그램을 실행하면 준비 완료!

#### 리스너 연결 및 인식 확인

* 리스너를 PC에 연결하고, 설정 프로그램(uwb\_settings.exe)을 실행합니다.

<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>

* 장치 연결 후, 화면 상단의 `Device Info` 영역에서 장치가 **Type: Listener**로 표시되는지 확인합니다.
* **Low Pass Filter** 항목을 찾습니다. (`PAN ID` 설정 아래 위치)
  * 입력란에 필터 값을 입력합니다. (예: `0.8`)
    * 유효한 범위: **0.0 이상, 1.0 미만**
    * 입력 오류 시 빨간색 경고 메시지 표시됨
  * 우측의 **\[Save]** 버튼을 클릭하여 설정을 저장합니다.

<figure><img src="https://2885569511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYKyrLLe7cm7ZOhiSB0gg%2Fuploads%2FiSs0SBBPMI6QUCNm5AxS%2Fimage.png?alt=media&amp;token=b3fbbe14-dccf-4738-97d9-8073c2cbc6d2" alt=""><figcaption></figcaption></figure>

**추천값 안내**

| 필터 계수          | 설명                             |
| -------------- | ------------------------------ |
| **0.1**        | 위치 변화가 즉시 반영됨 (반응 속도 ↑, 노이즈 ↑) |
| **0.9**        | 노이즈 감소 (위치 반응 속도 ↓, 부드러운 움직임)  |
| **0.5 \~ 0.8** | 일반적인 실내 환경에 적절 (권장 범위)         |

> 너무 낮거나 높은 값을 설정할 경우 위치 정확도 또는 반응성이 저하될 수 있으니, **테스트를 통해 최적의 값을 설정**하세요.

***

이제 GrowSpace 리스너 설정을 웹 도구 또는 프로그램을 통해 완벽하게 완료하셨습니다!\
필요하시면 다음 단계로 **MQTT 연동**, **대시보드 연결**, **태그/앵커 고급 설정** 가이드도 이어서 확인해보세요.