---
description: >-
  This document provides a list of dedicated serial commands (Command Line
  Interface) that can be used for debugging the GrowSpace Gateway Q1 device
  on-site or for directly modifying network/MQTT se
---

# Dedicated Commands

### In This Guide&#x20;

we introduce the serial commands that allow you to directly check or modify key settings of the **GrowSpace Gateway Q1** device, diagnose network issues, and check the MQTT server integration status.

By connecting to the device through a terminal (such as Tera Term), you can enter the commands below to perform flexible debugging based on the on-site situation.

***

### Operating Environment

| Item            | Description                                     |
| --------------- | ----------------------------------------------- |
| Connection Type | USB Serial (COM port)                           |
| Software        | Tera Term or similar terminal tools             |
| Baudrate        | 115200                                          |
| Input Method    | Command waiting state after booting is complete |

***

### Basic Commands

| Commands      | Description                                                               |
| ------------- | ------------------------------------------------------------------------- |
| restart       | System Reboot                                                             |
| basicSetting= | Set MQTT ID, password, IP, Wi-Fi SSID/password, and UWB PanID all at once |
| basicSetting? | View all the information entered above at once                            |

#### **restart**

**`restart`**

The gateway will restart immediately. This command is used to apply settings after making changes.

Input Example

```
restart
```

Output Example

```
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=`**

It allows you to set **MQTT**, **Wi-Fi**, and **PanID** all at once, and the input should be in **JSON format**.

Input Example

```
basicSetting={"mqttID":"testID", "mqttPW":"testPW", "mqttIP":"192.168.0.123", "wifiID":"testWID", "wifiPW":"testWPW", "panID":"0001"}
```

Output Example

```
✅ mqttID Saved
✅ mqttPW Saved
✅ mqttIP Saved: 192.168.0.123
✅ wifiID Saved
✅ wifiPW Saved
✅ panID Saved: 0001
🔁 After setting changes, ESP restarts
(The reboot log will be the same as the one from the restart command)
```

Notes

* Only **2.4GHz Wi-Fi** is supported (5GHz is not supported)
* Changes are **saved immediately** and the device will **automatically reboot**

***

**`basicSetting?`**

This command allows you to **check the currently saved MQTT, Wi-Fi, and PanID settings**.

**Input Example**

```
basicSetting?
```

**Output Example**

```
{
  "mqttID": "testID",
  "mqttPW": "testPW",
  "mqttIP": "192.168.0.123",
  "wifiID": "testWID",
  "wifiPW": "testWPW",
  "panID": "0001"
}
```

***

### Network Configuration Commands

| Commands              | Description                          |
| --------------------- | ------------------------------------ |
| `IP?`                 | Check the **current connected IP**   |
| `networkConnected?`   | Verify **network connection status** |
| `wifiID=` / `wifiID?` | Set and check the **Wi-Fi SSID**     |
| `wifiPW=` / `wifiPW?` | Set and check the **Wi-Fi password** |

**`IP?`**

Check the **current IP address** of the gateway.

```
IP?
```

Output Example :&#x20;

```
📡 IP: 192.168.51.28
```

***

**`networkConnected?`**

Verify the **network connection status**.

```
networkConnected?
```

Output Example :

```
✅ Network Connected.
```

***

**`wifiID=` / `wifiID?`**

Set or verify the **Wi-Fi SSID**.

```
wifiID=testWID
```

Output Example :&#x20;

```
✅ WiFi ID Saved
📡 WiFi ID: testWID
```

After entering, the device will **automatically restart**, and the reboot log will be displayed.

***

**`wifiPW=` / `wifiPW?`**

Set or verify the **Wi-Fi password**.

```
wifiPW=testWPW
```

Output Example :&#x20;

```
✅ WiFi PW Saved
🔐 WiFi PW: testWPW
```

After entering, the device will **automatically restart**, and the ESP boot log will be displayed.

***

### UWB Configuration and Verification

| Commands                  | Description                                 |
| ------------------------- | ------------------------------------------- |
| `gatewayUwbID?`           | Check the **unique UWB ID** of the gateway. |
| `uwbPanID=` / `uwbPanID?` | Set and verify the **Pan ID**.              |

**`gatewayUwbID?`**

Input Example

```
gatewayUwbID?
```

**Out**put Example

```
🌐 gatewayUwbID: GR209E
```

**`uwbPanID=`**

**In**put Example

```
uwbPanID=1234
```

**Out**put Example

```
✅ UWB Pan ID Saved: 1234
```

**`uwbPanID?`**

**In**put Example

```
uwbPanID?
```

**Out**put Example

```
🌐 uwbPanID: 1234
```



***

### MMQTT Configuration Commands

| Commands                | Description                                        |
| ----------------------- | -------------------------------------------------- |
| `mqttIP=` / `mqttIP?`   | Set and verify the **MQTT server IP**              |
| `mqttIpFG!`             | Automatically set the **Frigrow-specific MQTT IP** |
| `mqttID=` / `mqttID?`   | Set and verify the **MQTT connection ID**          |
| `mqttPW=` / `mqttPW?`   | Set and verify the **MQTT connection password**    |
| `project=` / `project?` | Set and verify the **project ID for MQTT Topic**   |



**`mqttIP=` / `mqttIP?`**

Set and verify the **MQTT broker address**

Input Example

```
mqttIP=192.168.0.123
```

**Out**put Example

```
✅ MQTT IP Saved: 192.168.0.123
🌐 MQTT IP: 192.168.0.123
```

**`mqttIpFG!`**

Automatically set to the **Frigrow-specific server IP**

**In**put Example

```
mqttIpFG!
```

**Out**put Example

```
✅ MQTT IP Saved: Freegrow Server
```

**`mqttID=` / `mqttID?`**

Set and verify the **MQTT connection ID**

**In**put Example

```
mqttID=testID
```

Output Example

```
✅ MQTT ID Saved
🧩 MQTT ID: testID
```

**`mqttPW=` / `mqttPW?`**

Set and verify the **MQTT password**

**In**put Example

```
mqttPW=testPW
```

Output Example

```
✅ MQTT PW Saved
🔐 MQTT PW: testPW
```

**`project=` / `project?`**

Set and verify the **Project ID in the MQTT Topic path**

**In**put Example

```
project=topicTest
```

**Out**put Example

```
✅ Project ID Saved
📦 Project ID: topicTest
```

***



By using the above commands, you can easily check the settings of the **GrowSpace Gateway Q1** device and quickly debug based on the on-site situation.

After making configuration changes, always restart the device using the **restart** command to apply the changes.
