문의하기
설치 가이드​
1. GrowSpace 2.0 Web 접속하기
2. 게이트웨이 Web 접속하기

전용 커맨드

본 문서는 GrowSpace 게이트웨이 Q1 장치를 현장에서 디버깅하거나
네트워크/MQTT 설정을 직접 수정해야 할 때 사용할 수 있는 전용 시리얼 명령어(Command Line Interface) 목록을 제공합니다.

개요

GrowSpace 게이트웨이 Q1 장치는 실내 위치 추적 데이터를 수집하고 서버로 전송하는 핵심 장치입니다.
현장 설치 이후에도 다음과 같은 이유로 직접 명령어를 통한 디버깅이 필요할 수 있습니다:

  • 설정값 확인 또는 수정
  • Wi-Fi 및 MQTT 네트워크 오류 점검
  • 장치 초기화 또는 재부팅
  • 시스템 진단 및 상태 모니터링

이를 위해 프리그로우는 Tera Term 기반 시리얼 명령어 체계를 제공하며,
아래는 실무에서 자주 사용하는 명령어의 정리입니다.

사용 환경

항목설명
연결 방식USB 시리얼 연결 (COM 포트)
프로그램Tera Term 또는 유사 터미널
Baudrate115200
장치 부팅 후커맨드 입력 가능 (기본 리스닝 상태)

명령어 분류 및 사용법

기본 명령어

명령어설명
restart시스템 리부팅
basicSetting=MQTT ID, PW, IP, Wi-Fi ID/PW, UWB PanID를 한 번에 설정
basicSetting?위에 입력된 정보들을 한 번에 확인

restart

게이트웨이를 즉시 재시작합니다. 설정을 저장한 뒤 적용할 때 사용합니다.

  • 입력 예시
restart
  • 출력 예시:
rst:0xc (SW_CPU_RESET),boot:0x13 (SPI_FAST_FLASH_BOOT)
configsip: 0, SPIWP:0xee
clk_drv:0x00,q_drv:0x00,d_drv:0x00,cs0_drv:0x00,hd_drv:0x00,wp_drv:0x00
mode:DIO, clock div:2
load:0x3fff0030,len:1184
load:0x40078000,len:13232
load:0x40080400,len:3028
entry 0x400805e4

basicSetting=

MQTT, Wi-Fi, UWB PanID 등을 한 번에 설정할 수 있는 명령어입니다.

JSON 형식으로 입력하며, 필요한 값만 넣으면, 나머지 설정은 유지됩니다.

입력 후 저장되며, 장치가 자동 리부팅됩니다.

❗ 주의사항
Wi-Fi 설정 시에는 2.4GHz 대역만 지원되므로, 5GHz 대역 Wi-Fi는 연결되지 않습니다.
공장 또는 테스트 환경에서 공유기를 설정할 때에는 반드시 2.4GHz SSID로 연결해 주세요.

  • 입력 예시
basicSetting={"mqttID": "testID", "mqttPW": "testPW", "mqttIP": "192.168.0.123", "wifiID": "testWID", "wifiPW": "testWPW", "panID": "0001"}
  • 출력 예시:
✅ mqttID 저장됨
✅ mqttPW 저장됨
✅ mqttIP 저장됨: 192.168.0.123
✅ wifiID 저장됨
✅ wifiPW 저장됨
✅ panID 저장됨: 0001
🔁 설정 변경 후 ESP 재시작
ets Jul 29 2019 12:21:46

rst:0xc (SW_CPU_RESET),boot:0x13 (SPI_FAST_FLASH_BOOT)
configsip: 0, SPIWP:0xee
clk_drv:0x00,q_drv:0x00,d_drv:0x00,cs0_drv:0x00,hd_drv:0x00,wp_drv:0x00
mode:DIO, clock div:2
load:0x3fff0030,len:1184
load:0x40078000,len:13232
load:0x40080400,len:3028
entry 0x400805e4

basicSetting?

현재 저장된 MQTT, Wi-Fi, PanID 정보를 한 번에 확인합니다.

  • 입력 예시
basicSetting?
  • 출력 예시:
{
  "mqttID": "testID",
  "mqttPW": "testPW",
  "mqttIP": "192.168.0.123",
  "wifiID": "testWID",
  "wifiPW": "testWPW",
  "panID": "0001"
}

네트워크 설정 및 확인

명령어설명
IP?현재 연결된 IP 확인
networkConnected?네트워크 연결 상태 확인
wifiID= / wifiID?Wi-Fi ID 설정 / 확인
wifiPW= / wifiPW?Wi-Fi 비밀번호 설정 / 확인

IP?

게이트웨이를 즉시 재시작합니다. 설정을 저장한 뒤 적용할 때 사용합니다.

  • 입력 예시
IP?
  • 출력 예시:
📡 IP: 192.168.51.28

networkConnected?

네트워크에 연결되어있는가 확인합니다.

  • 입력 예시
networkConnected?
  • 출력 예시:
✅ 네트워크 연결됨

wifiID=

WIFI ID를 설정합니다. 저장이 완료된 후 장치가 리부팅됩니다.

  • 입력 예시
wifiID=testWID
  • 출력 예시:
✅ WiFi ID 저장 완료
ets Jul 29 2019 12:21:46

rst:0xc (SW_CPU_RESET),boot:0x13 (SPI_FAST_FLASH_BOOT)
configsip: 0, SPIWP:0xee
clk_drv:0x00,q_drv:0x00,d_drv:0x00,cs0_drv:0x00,hd_drv:0x00,wp_drv:0x00
mode:DIO, clock div:2
load:0x3fff0030,len:1184
load:0x40078000,len:13232
load:0x40080400,len:3028
entry 0x400805e4

wifiID?

저장되어 있는 WIFI ID를 확인합니다.

  • 입력 예시
wifiID?
  • 출력 예시:
📡 WiFi ID: testWID

wifiPW=

WIFI Password를 설정합니다. 저장이 완료된 후 장치가 리부팅됩니다.

  • 입력 예시
wifiPW=
  • 출력 예시:
✅ WiFi PW 저장 완료
ets Jul 29 2019 12:21:46

rst:0xc (SW_CPU_RESET),boot:0x13 (SPI_FAST_FLASH_BOOT)
configsip: 0, SPIWP:0xee
clk_drv:0x00,q_drv:0x00,d_drv:0x00,cs0_drv:0x00,hd_drv:0x00,wp_drv:0x00
mode:DIO, clock div:2
load:0x3fff0030,len:1184
load:0x40078000,len:13232
load:0x40080400,len:3028
entry 0x400805e4

wifiPW?

저장되어 있는 WIFI Password를 확인합니다.

  • 입력 예시
wifiPW?
  • 출력 예시:
🔐 WiFi PW: testWPW

UWB 설정 및 확인

명령어설명
gatewayUwbID?게이트웨이의 고유 UWB ID 확인
uwbPanID= / uwbPanID?PanID 설정 / 확인

gatewayUwbID?

저장되어 있는 게이트웨이의 UWB ID를 확인합니다.

  • 입력 예시
gatewayUwbID?
  • 출력 예시:
🌐 gatewayUwbID: GR209E

uwbPanID=

게이트웨이의 UWB PanID 설정합니다.

  • 입력 예시
uwbPanID=
  • 출력 예시:
✅ UWB Pan ID 저장 완료: 1234

uwbPanID?

저장되어 있는 게이트웨이의 UWB PanID를 확인합니다.

  • 입력 예시
uwbPanID?
  • 출력 예시:
🌐 uwbPanID: 1234

MQTT 설정 및 확인

명령어설명
mqttIP= / mqttIP?MQTT 서버 IP 설정 / 확인
mqttIpFG!프리그로우 MQTT 서버 IP로 자동 설정
mqttID= / mqttID?MQTT 접속 ID 설정 / 확인
mqttPW= / mqttPW?MQTT 비밀번호 설정 / 확인
project= / project?Topic의 하위 경로(Project ID) 설정 / 확인

mqttIP=

사설 MQTT 서버에 연결할 때 사용하는 명령어로, IP를 설정하면 저장과 동시에 장치가 자동으로 리부팅됩니다.

  • 입력 예시
mqttIP=192.168.0.123
  • 출력 예시:
✅ MQTT IP 저장 완료: 192.168.0.123
.ets Jul 29 2019 12:21:46

rst:0xc (SW_CPU_RESET),boot:0x13 (SPI_FAST_FLASH_BOOT)
configsip: 0, SPIWP:0xee
clk_drv:0x00,q_drv:0x00,d_drv:0x00,cs0_drv:0x00,hd_drv:0x00,wp_drv:0x00
mode:DIO, clock div:2
load:0x3fff0030,len:1184
load:0x40078000,len:13232
load:0x40080400,len:3028
entry 0x400805e4

mqttIP?

저장되어 있는 MQTT IP를 확인합니다.

  • 입력 예시
mqttIP?
  • 출력 예시:
🌐 MQTT IP: 192.168.0.123

mqttIpFG!

MQTT 서버 IP를 프리그로우 전용 서버로 설정하며, 저장 후 장치는 자동으로 리부팅됩니다.

  • 입력 예시
mqttIpFG!
  • 출력 예시:
✅ MQTT IP 저장 완료: Feegrow Server
.ets Jul 29 2019 12:21:46

rst:0xc (SW_CPU_RESET),boot:0x13 (SPI_FAST_FLASH_BOOT)
configsip: 0, SPIWP:0xee
clk_drv:0x00,q_drv:0x00,d_drv:0x00,cs0_drv:0x00,hd_drv:0x00,wp_drv:0x00
mode:DIO, clock div:2
load:0x3fff0030,len:1184
load:0x40078000,len:13232
load:0x40080400,len:3028
entry 0x400805e4

mqttID=

MQTT 서버에 접속할 때 사용하는 ID를 설정하며, 저장 후 장치는 자동으로 리부팅됩니다.

  • 입력 예시
mqttID=testID
  • 출력 예시:
✅ MQTT ID 저장 완료
.ets Jul 29 2019 12:21:46

rst:0xc (SW_CPU_RESET),boot:0x13 (SPI_FAST_FLASH_BOOT)
configsip: 0, SPIWP:0xee
clk_drv:0x00,q_drv:0x00,d_drv:0x00,cs0_drv:0x00,hd_drv:0x00,wp_drv:0x00
mode:DIO, clock div:2
load:0x3fff0030,len:1184
load:0x40078000,len:13232
load:0x40080400,len:3028
entry 0x400805e4

mqttID?

저장되어 있는 MQTT 접속 ID를 확인합니다.

  • 입력 예시
mqttID?
  • 출력 예시:
🧩 MQTT ID: testID

mqttPW=

MQTT서버에 접속할 때 사용하는 Password를 설정하며, 저장 후 장치는 자동으로 리부팅됩니다.

  • 입력 예시
mqttPW=testPW
  • 출력 예시:
✅ MQTT PW 저장 완료
ets Jul 29 2019 12:21:46

rst:0xc (SW_CPU_RESET),boot:0x13 (SPI_FAST_FLASH_BOOT)
configsip: 0, SPIWP:0xee
clk_drv:0x00,q_drv:0x00,d_drv:0x00,cs0_drv:0x00,hd_drv:0x00,wp_drv:0x00
mode:DIO, clock div:2
load:0x3fff0030,len:1184
load:0x40078000,len:13232
load:0x40080400,len:3028
entry 0x400805e4

mqttPW?

저장되어 있는 MQTT 접속 Password를 확인합니다.

  • 입력 예시
mqttPW?
  • 출력 예시:
🔐 MQTT PW: testPW

project=

  • TOPIC의 일부분을 설정합니다.
  • TOPIC은 장치, 게이트웨이 세가지로 나뉘어 있습니다.
    • 게이트웨이 TOPIC uwb/gateway/config/{projectId}/{deviceId}
    • 태그, 앵커 TOPIC uwb/gateway/devices/{projectId}/{deviceId}
    • 게이트웨이 장치 시작 uwb/gateway/start/{projectId}/{deviceId}
  • 이 명령어는 TOPIC에서 {projectId} 부분을 설정합니다. {deviceId}는 게이트웨이의 UWB ID가 자동으로 설정됩니다.
  • 입력 예시
project=topicTest
  • 출력 예시:
✅ Project ID 저장 완료

project?

  • 저장되어 있는 TOPIC의 일부분을 확인합니다.
  • TOPIC은 장치, 게이트웨이 두가지로 나뉘어 있습니다.
  • 게이트웨이 TOPIC uwb/gateway/config/{projectId}/{deviceId}
  • 태그, 앵커 TOPIC uwb/gateway/devices/{projectId}/{deviceId}
  • 이 명령어는 TOPIC에서 {projectId} 부분을 확인합니다.
  • 입력 예시
project?
  • 출력 예시:
📦 Project ID: topicTest

마무리

이번 글에서는 게이트웨이 Q1 장치에서 사용할 수 있는 시리얼 명령어의 종류와 사용법을 정리해드렸습니다.
초기 설정, 네트워크 연결 점검, MQTT 연결 오류 확인 등 다양한 상황에서 유용하게 활용할 수 있으니 참고해 주세요.

목차

주식회사 프리그로우

대표자 김영식
사업자등록번호 162-86-01204
주소 부산광역시 동구 중앙대로 288, 7층
이메일 freegrow@freegrow.io
개인정보처리방침