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

# 게이트웨이 설정 및 데이터 확인(선택)

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

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

### 이 글에서는

GrowSpace UWB 게이트웨이를 사용하여 태그 및 앵커 데이터를 수집하고, MQTT 방식으로 서버 또는 클라우드와 연동하는 전체 절차를 안내합니다.\
실시간 위치 데이터의 외부 전송이 필요한 경우, 게이트웨이를 통해 시스템을 구성할 수 있습니다.

***

### 게이트웨이란?

게이트웨이는 UWB 장치(태그/앵커) 간 거리 데이터를 수집한 뒤, MQTT 프로토콜을 통해 서버로 전송하는 장치입니다.\
GrowSpace 리스너와 유사한 기능을 수행하지만, LAN 또는 Wi-Fi 기반의 전송이 가능하여 보다 넓은 공간에서도 안정적인 연동이 가능합니다.

{% hint style="info" %}
대규모 공간 / 클라우드 연동 / 모바일 앱 연결이 필요한 환경에서는 리스너 대신 게이트웨이 사용을 권장합니다.
{% endhint %}

{% embed url="<https://youtu.be/UBLq2WL9A58?si=7YP1RPmMqHI_Q436>" %}

***

### LED 상태로 확인하는 동작 정보

| LED  | 색상                                   | 기능        | 동작 상태                 |
| ---- | ------------------------------------ | --------- | --------------------- |
| LED1 | <mark style="color:green;">초록</mark> | 전원 공급 여부  | 항상 점등                 |
| LED2 | <mark style="color:green;">초록</mark> | 데이터 전송 상태 | 데이터 전송 시 점멸           |
| LED3 | <mark style="color:red;">빨강</mark>   | 오류 상태     | 설정 누락 또는 네트워크 오류 시 점멸 |

{% hint style="info" %}
LED3이 지속적으로 점멸하는 경우 → MQTT 또는 Wi-Fi 정보가 누락되었는지 확인해 주세요.
{% endhint %}

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><strong>LED 1. 초록</strong></td><td><a href="https://2885569511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYKyrLLe7cm7ZOhiSB0gg%2Fuploads%2FDH3I8crR6NgyYydLPhKT%2FKakaoTalk_20250625_164017234_07-2-1536x1536.jpg?alt=media&amp;token=6522af23-6f98-476c-bd1d-0636395b05c2">KakaoTalk_20250625_164017234_07-2-1536x1536.jpg</a></td></tr><tr><td><strong>LED 2. 초록</strong></td><td><a href="https://2885569511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYKyrLLe7cm7ZOhiSB0gg%2Fuploads%2F5PqHEeEmUStFTKIIloA6%2FKakaoTalk_20250625_164017234_03-edited.jpg?alt=media&amp;token=acd297f0-3f03-44a4-9fce-9b573e7fdf0a">KakaoTalk_20250625_164017234_03-edited.jpg</a></td></tr><tr><td><strong>LED 3. 빨강</strong></td><td><a href="https://2885569511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYKyrLLe7cm7ZOhiSB0gg%2Fuploads%2F0pOgrcxPlhjYm6IQ0m6q%2FKakaoTalk_20250625_164017234_02-1536x1536.jpg?alt=media&amp;token=b9658016-f2cc-4e62-a1b6-22f88c0289ba">KakaoTalk_20250625_164017234_02-1536x1536.jpg</a></td></tr></tbody></table>

***

### 웹 설정 도구 접속하기

게이트웨이는 별도의 프로그램 설치 없이, **웹 브라우저만으로 설정할 수 있도록 설계**되어 있습니다.\
설정은 GrowSpace에서 제공하는 전용 웹 설정 도구(Web Console)를 통해 진행됩니다.

#### 접속 방법

* **Google Chrome 브라우저**를 실행합니다.

> ⚠️ 반드시 Chrome을 사용해 주세요. 다른 브라우저(Edge, Safari, Firefox 등)에서는 시리얼 장치 인식이 제대로 되지 않을 수 있습니다.

* [**웹 설정 도구**](https://grow-space.io/software/)에 접속합니다.&#x20;
* **오른쪽의 ‘게이트웨이 설정 프로그램’**&#xC744; 클릭합니다.&#x20;

<figure><img src="https://2885569511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYKyrLLe7cm7ZOhiSB0gg%2Fuploads%2FyYERroGqQPNgZj7Zfqfl%2Fimage.png?alt=media&amp;token=da9812aa-d1ea-4f20-b443-42b9f0df67e6" alt=""><figcaption></figcaption></figure>

* 다음과 같은 설정 화면이 나타며,  **API 키를 생성하거나 기존에 발급받은 API 키를 입력**해야 합니다.
  * 처음 사용하는 경우, \[API 키생성성] 버튼을 클릭해 새로운 키를 발급받을 수 있습니다.
  * 이미 키를 보유한 경우에는 입력란에 그대로 붙여넣고 다음 단계로 진행하세요.

{% hint style="warning" %}
API 키는 장비 인증 및 설정 저장에 사용되므로, 외부에 노출되지 않도록 주의해 주세요.
{% endhint %}

<figure><img src="https://2885569511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYKyrLLe7cm7ZOhiSB0gg%2Fuploads%2FL77lUiL13wYY1P9Pg43P%2Fimage.png?alt=media&amp;token=a6ab8f8e-438c-4f09-89a8-86eb7e187020" alt=""><figcaption></figcaption></figure>

***

### API 키 생성

게이트웨이 MQTT 연동을 위해서는 API 키가 반드시 필요합니다.\
생성 방법은 다음과 같습니다:

* 상단 메뉴 또는 첫 화면에서 **\[API 키 생성]** 버튼을 클릭합니다.
* **회사명 또는 프로젝트명**을 입력합니다.\
  이 이름은 키 식별용으로 사용되며, 자유롭게 지정할 수 있습니다.

<figure><img src="https://2885569511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYKyrLLe7cm7ZOhiSB0gg%2Fuploads%2FGOwT4zg2qJIHnCHhKf0J%2Fimage.png?alt=media&amp;token=64e759aa-41b5-460f-bffd-5f323316486e" alt=""><figcaption></figcaption></figure>

* 자동으로 생성된 **API 키**가 화면에 표시됩니다.
* **이 키를 반드시 복사하여 안전한 장소에 저장하세요.**

{% hint style="danger" %}
**중요!** 보안상의 이유로, 창을 닫으면 해당 키는 다시 확인할 수 없습니다.\
복구할 수 없으므로, <mark style="color:$primary;">**메모장이나 비밀번호 관리 앱 등에 꼭 저장해 주세요.**</mark>
{% endhint %}

***

### 설정 화면 구성

API 키로 로그인 후 다음 기능을 설정할 수 있습니다:

<figure><img src="https://2885569511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYKyrLLe7cm7ZOhiSB0gg%2Fuploads%2FLBvXJb7LeMQ9vdLJiLrg%2Fimage.png?alt=media&amp;token=89cc1544-d0b1-44f5-8796-be151546dd31" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="224.39996337890625">항목</th><th>설명</th></tr></thead><tbody><tr><td><ol><li>좌측 장치 목록</li></ol></td><td>연결된 태그 및 앵커 리스트</td></tr><tr><td><ol start="2"><li>Grid 보기</li></ol></td><td>실시간 장치 위치 배치 상태 확인</td></tr><tr><td><ol start="3"><li>흔들림 보정</li></ol></td><td>태그 움직임에 대한 필터 강도 조절 <br>(Very Strong > Strong > Moderate > Soft > No filter)</td></tr><tr><td><ol start="4"><li>이미지 업로드</li></ol></td><td>공간 도면 업로드 → 태그 위치 시각화 가능</td></tr><tr><td><ol start="5"><li>게이트웨이 설정</li></ol></td><td>MQTT 서버 정보, 포트, Wi-Fi SSID/PW 입력 및 저장</td></tr></tbody></table>

***

### 게이트웨이 설정하기

API 키를 생성한 뒤에는, 게이트웨이에 MQTT 정보와 네트워크 설정을 입력해야 합니다.\
이 과정을 통해 **게이트웨이가 서버와 통신하고 위치 데이터를 전송할 수 있는 준비가 완료됩니다.**

#### 설정 절차

* 웹 설정 도구에 접속한 뒤, 상단 메뉴에서 **\[게이트웨이 설정]**&#xC744; 클릭합니다.
* 게이트웨이를 USB로 PC에 연결한 상태에서, **COM 포트 목록**에서 해당 장치를 선택하고 **\[연결]**&#xC744; 클릭합니다.
* \[게이트웨이 설정 화면 구성 안내]에 포함된 모든 항목들을 정확히 입력합니다.
* 모든 정보를 입력한 후, **\[저장]** 버튼을 클릭합니다.
* 저장이 완료되면 게이트웨이는 **자동으로 재시작**되며 설정이 적용됩니다.

#### 설정 시 유의사항

* 입력한 정보에 오류가 있으면 연결에 실패하며, **게이트웨이 LED3(빨강)** 이 계속 깜빡입니다.
* 이 경우 [**"게이트웨이 LED3(빨강)이 계속 깜빡이는 경우"**](#led3) 항목을 참고하여 로그를 확인해주세요.
* 저장 전에 모든 항목을 다시 한번 확인해 주세요.
* 설정 완료 후에는 Web Console 또는 서버 로그에서 데이터가 정상 수신되는지 확인하는 것이 좋습니다.

***

### 게이트웨이 설정 화면 구성 안내

게이트웨이 설정 화면에서는 MQTT 연동과 네트워크 접속에 필요한 정보를 입력하고,\
게이트웨이를 실시간 데이터 송신 장치로 구성할 수 있습니다.

#### 1. **API Key**

<figure><img src="https://2885569511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYKyrLLe7cm7ZOhiSB0gg%2Fuploads%2FJn01nMWyEtHWFpGKfTUQ%2F%EC%9D%B4%EB%AF%B8%EC%A7%80%20(4).png?alt=media&amp;token=c2768e28-5a41-4ebe-8996-6e861f7ff12b" alt=""><figcaption></figcaption></figure>

* 게이트웨이 장비를 식별하고 인증하는 고유 키입니다.
* GrowSpace 설정 페이지에서 발급된 API 키를 자동으로 불러오며, 수정은 불가능합니다.

{% hint style="danger" %}
**중요**:  API 키가 없으면 데이터 송신이 이뤄지지 않습니다.
{% endhint %}

#### 2. **Pan Id**

* 태그(Tag), 앵커(Anchor), 게이트웨이 간 통신을 위한 네트워크 그룹 식별자입니다.
* **모든 장치는 동일한 Pan ID를 입력해야 정상적으로 연동됩니다.**
* 4자리 16진수 형식으로 입력 (예: `0000`, `00A1` 등)

{% hint style="warning" %}
**이더넷 연결 시**: **3, 4번 항목은 비워두고 바로 5번(MQTT IP) 설정으로 이동**하세요.
{% endhint %}

#### 3. **Wifi name (SSID)**

* 게이트웨이가 연결할 Wi-Fi 이름을 입력합니다.
* <mark style="color:red;">반드시</mark> <mark style="color:red;"></mark><mark style="color:red;">**2.4GHz Wi-Fi**</mark> <mark style="color:red;"></mark><mark style="color:red;">네트워크를 사용해야 합니다. (5GHz 미지원)</mark>

#### 4. **Wifi password**

* 위에서 입력한 Wi-Fi 네트워크의 비밀번호를 입력합니다.
* 비밀번호가 틀릴 경우 Wi-Fi 연결이 실패하며, LED3(빨간불)이 계속 깜빡이게 됩니다.

#### 5. **MQTT IP**

* MQTT 서버의 IP 주소 또는 도메인 주소를 입력합니다.
* GrowSpace 기본 브로커를 사용할 경우, ‘기본 지정값 사용’을 선택하면 입력 없이 자동 설정됩니다.
* 자체 MQTT 브로커를 운영 중이라면 IP 또는 도메인을 수동으로 입력해야 합니다

#### 6. **MQTT Id**

* MQTT 브로커 로그인용 ID입니다.
* GrowSpace 브로커를 사용하는 경우 자동 설정 가능하며, 외부 브로커 사용 시 직접 생성한 사용자 ID를 입력해야 합니다.

#### 7. **MQTT password**

* MQTT 브로커 로그인용 비밀번호입니다.
* MQTT Id와 함께 입력되어야 인증이 완료되며, 입력 오류 시 연결되지 않습니다.

***

### 게이트웨이 LED3(빨강)이 계속 깜빡이는 경우

게이트웨이 설정에서 **`로그 확인`** 버튼을 누르시면 로그 확인을 통해 오류 내용을 확인할 수 있습니다.&#x20;

<div><figure><img src="https://2885569511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYKyrLLe7cm7ZOhiSB0gg%2Fuploads%2Fn9GKp91x6Qd9FlfDeAwc%2Fgateway_setting.png?alt=media&amp;token=7bbd957d-bafc-49ad-b45b-40e75774518e" alt=""><figcaption></figcaption></figure> <figure><img src="https://2885569511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYKyrLLe7cm7ZOhiSB0gg%2Fuploads%2FW596TzEwLxXV60U3kaZw%2Fgateway_setting_log.png?alt=media&amp;token=b01190b3-ab35-4235-9151-8c2b6875336a" alt=""><figcaption></figcaption></figure></div>

{% hint style="danger" %}
**로그 확인은 2025년 9월 1일 이후 구매한 게이트웨이 장비에만 해당됩니다.**
{% endhint %}

***

### 설치 시나리오 예시

게이트웨이는 다음과 같은 기준에 따라 설치하면 가장 효율적으로 운영할 수 있습니다:

<figure><img src="https://2885569511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYKyrLLe7cm7ZOhiSB0gg%2Fuploads%2Fdpz4nDJ7PeCuEIss5w98%2F%EC%88%98%EC%A0%95%20%EB%B0%B0%EC%B9%98%EB%8F%84.jpg?alt=media&amp;token=9e310d8b-65e2-4025-84a0-8bee52323a2c" alt=""><figcaption></figcaption></figure>

* **공간 규모**: 예시 – 가로 100m × 세로 60m
* **앵커 배치**: 15\~20m 간격으로 벽면에 균일하게 설치
* **게이트웨이 위치**:
  * 네트워크 장비와 가까운 위치
  * 벽면을 따라 설치해 전원 연결이 용이한 지점

***

### 기본 작동 흐름

전원을 연결한 이후 게이트웨이는 아래 순서에 따라 동작합니다.

**1. 전원 연결 → 부팅 시작**

게이트웨이를 전원에 연결하면 자동으로 부팅이 시작되며, 이때 <mark style="color:green;">LED2(초록)</mark>과 <mark style="color:red;">LED3(빨강)</mark>이 **순차적으로 깜빡이는** 모습을 통해 정상적으로 작동 중임을 확인할 수 있습니다.

{% hint style="info" %}
**LED가 켜지지 않거나 아무 반응이 없다면**, 전원 어댑터나 케이블 상태를 다시 확인해 주세요.
{% endhint %}

&#x20;

**2. 주변 장치 자동 연결**

태그와 앵커가 사전에 설정되어 있다면, 게이트웨이는 전원이 켜진 직후 자동으로 이 장치들을 인식하며, 곧바로 거리 데이터를 수집하기 시작합니다. 따라서 별도로 장치를 수동으로 연결하거나 설정할 필요는 없습니다.

**3. 네트워크 연결 시도**

게이트웨이는 먼저 **LAN(유선 인터넷)** 연결을 시도하며, LAN이 연결되지 않은 경우에는 자동으로 **Wi-Fi(무선 인터넷)** 연결로 전환됩니다.

{% hint style="danger" %}
**Wi-Fi는 2.4GHz만 지원되며, 5GHz 네트워크는 사용할 수 없습니다.**
{% endhint %}

**4. 서버(MQTT 브로커)로 데이터 전송**

사전에 MQTT 서버 정보를 입력해 두었다면, 게이트웨이는 연결된 태그와 앵커의 위치 데이터를 서버로 **실시간 전송**하기 시작합니다.\
반면, MQTT 설정이 누락되었거나 Wi-Fi 연결에 실패한 경우에는 <mark style="color:red;">LED3(빨강)</mark>이 계속 깜빡이며 **오류 상태**를 표시합니다.

{% hint style="info" %}
이럴 경우에는 웹 설정 도구에 다시 접속해 네트워크 정보와 MQTT 설정값을 확인하고 수정해 주세요.
{% endhint %}

***

### 설정 점검 체크리스트

게이트웨이 설정을 마친 후, 아래 항목들을 하나씩 확인해 주세요.\
정상적으로 데이터가 수신되고 있는지 최종 점검하는 과정입니다.

* [ ] 전원 연결 후 LED1(초록)이 정상 점등되는지 확인
* [ ] LED3(빨강)이 깜빡이는 경우, MQTT 설정 또는 Wi-Fi 연결 상태 재확인
* [ ] MQTT 서버와의 연결이 정상적으로 이루어졌는지 확인
* [ ] **태그 위치 데이터**가 서버로 정상 전송되고 있는지 확인
* [ ] 웹 설정 도구 또는 서버 로그에서 실시간 데이터가 확인되는지 점검