> 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/gateway/command.md). # 전용 명령어(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` 명령어를 통해 장치를 재시작하여 변경 사항을 적용하세요.