전용 명령어(command)

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

이 글에서는

GrowSpace Gateway Q1 장치의 주요 설정값을 직접 확인하거나 수정하고, 네트워크 오류를 진단하며, MQTT 서버 연동 상태를 점검할 수 있는 시리얼 명령어들을 소개합니다. 터미널(Tera Term 등)을 통해 장치와 연결해 아래 명령어를 입력하면, 현장 상황에 맞춰 유연한 디버깅이 가능합니다.

사용 환경

항목

설명

연결 방식

USB 시리얼 (COM 포트)

사용 프로그램

Tera Term 또는 유사 터미널 도구

Baudrate

115200

입력 방식

부팅 완료 후 명령어 입력 대기 상태

기본 명령어

명령어

설명

restart

시스템 리부팅

basicSetting=

MQTT ID, PW, IP, Wi-Fi ID/PW, UWB PanID를 한 번에 설정

basicSetting?

위에 입력된 정보들을 한 번에 확인

restart

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, PanID를 한 번에 설정하는 명령어입니다. JSON 형식으로 입력합니다.

입력 예시

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 재시작
(이후 restart 명령과 동일한 재부팅 로그 출력)

주의사항

2.4GHz Wi-Fi만 지원 (5GHz 미지원)
입력 즉시 저장 및 자동 재부팅

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 이름 설정 / 확인

wifiPW= / wifiPW?

Wi-Fi 비밀번호 설정 / 확인

IP?

현재 게이트웨이의 IP 주소를 확인합니다.

IP?

출력 예시:

📡 IP: 192.168.51.28

networkConnected?

네트워크 연결 여부를 확인합니다.

networkConnected?

출력 예시:

✅ 네트워크 연결됨

wifiID= / wifiID?

Wi-Fi SSID를 설정하거나 확인합니다.

wifiID=testWID

출력 예시:

✅ WiFi ID 저장 완료
📡 WiFi ID: testWID

입력 후 자동 재시작되며, 재부팅 로그가 함께 출력됩니다.

wifiPW= / wifiPW?

Wi-Fi 비밀번호를 설정하거나 확인합니다.

wifiPW=testWPW

출력 예시:

✅ WiFi PW 저장 완료
🔐 WiFi PW: testWPW

입력 후 장치는 자동 재시작되며, ESP 부팅 로그가 함께 출력됩니다.

UWB 설정 및 확인

명령어

설명

gatewayUwbID?

게이트웨이 고유 UWB ID 확인

uwbPanID= / uwbPanID?

Pan ID 설정 / 확인

gatewayUwbID?

입력 예시

gatewayUwbID?

출력 예시

🌐 gatewayUwbID: GR209E

uwbPanID=

입력 예시

uwbPanID=1234

출력 예시

✅ UWB Pan ID 저장 완료: 1234

uwbPanID?

입력 예시

uwbPanID?

출력 예시

🌐 uwbPanID: 1234

MQTT 설정 명령어

명령어

설명

mqttIP= / mqttIP?

MQTT 서버 IP 설정 / 확인

mqttIpFG!

프리그로우 전용 MQTT IP 자동 설정

mqttID= / mqttID?

MQTT 접속 ID 설정 / 확인

mqttPW= / mqttPW?

MQTT 접속 PW 설정 / 확인

project= / project?

MQTT Topic의 project ID 설정 / 확인

mqttIP= / mqttIP?

MQTT 브로커 주소 설정 / 확인

입력 예시

mqttIP=192.168.0.123

출력 예시

✅ MQTT IP 저장 완료: 192.168.0.123
🌐 MQTT IP: 192.168.0.123

mqttIpFG!

프리그로우 전용 서버 IP로 자동 설정합니다.

입력 예시

mqttIpFG!

출력 예시

✅ MQTT IP 저장 완료: Freegrow Server

mqttID= / mqttID?

MQTT 접속 ID 설정 / 확인

입력 예시

mqttID=testID

출력 예시

✅ MQTT ID 저장 완료
🧩 MQTT ID: testID

mqttPW= / mqttPW?

MQTT 비밀번호 설정 / 확인

입력 예시

mqttPW=testPW

출력 예시

✅ MQTT PW 저장 완료
🔐 MQTT PW: testPW

project= / project?

MQTT Topic 경로의 Project ID를 설정 / 확인합니다.

입력 예시

project=topicTest

출력 예시

✅ Project ID 저장 완료
📦 Project ID: topicTest

위 명령어들을 활용하면 GrowSpace Gateway Q1 장치의 설정을 손쉽게 점검하고, 현장 상황에 맞춰 빠르게 디버깅할 수 있습니다.

설정 변경 후에는 항상 restart 명령어를 통해 장치를 재시작하여 변경 사항을 적용하세요.

PreviousGateway 심화 가이드 Next직접 서버 구축하기

Last updated 4 days ago