> For the complete documentation index, see [llms.txt](https://freegrow-1.gitbook.io/product-docs-en/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-en/en-creator-kit-q1/learn-more/tera-term-installation-and-setup.md).

# Tera Term Installation and Setup

### **In This Guide** 

you'll learn how to connect to a **GrowSpace Gateway** using **Tera Term** to check serial logs and send commands.\
We’ll walk through each step—from what Tera Term is, to how to install it, set up the necessary drivers, and establish the connection.

***

### What Is Tera Term?

**Tera Term** is a terminal emulator that allows your PC to connect to devices via **serial communication**, making it easy to check logs and send commands.

With **Tera Term**, you can directly access key information from the **GrowSpace Gateway**, such as:

* MQTT broker connection status
* Network settings and error logs
* Device configuration values
* Real-time debug messages

It's a simple and powerful tool for both developers and system operators, allowing quick status checks without the need for a full development environment.

***

### Installation and Setup

#### Install the Program

* Go to the official download page\
  <https://github.com/TeraTermProject/teraterm/releases>

<figure><img src="https://3958108398-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvMRdsyzmLItN6oczCyF%2Fuploads%2FvgVfvjKFRQf8d2gkSxgn%2Fimage.png?alt=media&amp;token=b38be969-bfed-4fdd-8a9e-104fdbdd7f4f" alt=""><figcaption></figcaption></figure>

* Download the latest `.exe` installer\
  (Example: `teraterm-5.x.x.exe`)
* Run the installer and proceed with the default installation settings

***

#### Install the USB Serial Driver (CP210x USB to UART)

To connect the gateway device via USB, a **USB-to-Serial driver** must be installed.

* Visit the driver download page\
  <https://www.silabs.com/developer-tools/usb-to-uart-bridge-vcp-drivers?tab=downloads>
* Select and install the version that matches your operating system (e.g. Windows)
* After installation is complete, connect the gateway to your PC using a **USB-C to USB cable**

***

#### Port Connection Check

* Launch **Tera Term**
* In the startup window, select the **Serial** tab
* If a port starting with **COM** is listed, the device is recognized successfully
* Select the correct port and click **OK**

<figure><img src="https://3958108398-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvMRdsyzmLItN6oczCyF%2Fuploads%2FiOaYD2WtQ27HT8XCYI8h%2Fimage.png?alt=media&amp;token=e14004cc-0646-4fc1-876d-e3e06b05c465" alt=""><figcaption></figcaption></figure>

***

#### Serial Communication Settings

Go to **\[Setup → Serial Port]** in the top menu and enter the following values

| Item         | Setting |
| ------------ | ------- |
| Baud rate    | 115200  |
| Data bits    | 8 bit   |
| Parity       | none    |
| Stop bits    | 1 bit   |
| Flow control | none    |

<figure><img src="https://3958108398-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvMRdsyzmLItN6oczCyF%2Fuploads%2FtAFSnrzTGqLvfSxbZkI0%2Fimage.png?alt=media&amp;token=4573c71b-caa0-44a9-ab47-40389adc9985" alt=""><figcaption></figcaption></figure>

***

#### Terminal Line Ending Settings

Go to **\[Setup → Terminal]** and configure the following settings

| Item     | Setting |
| -------- | ------- |
| Receive  | CR      |
| Transmit | CR      |

<figure><img src="https://3958108398-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvMRdsyzmLItN6oczCyF%2Fuploads%2FHZpFcaT6YniPDwlLgzxQ%2Fimage.png?alt=media&amp;token=876f0f5d-63d2-43ee-985f-901908525c64" alt=""><figcaption></figcaption></figure>

***

#### Copy and Paste Settings

* Go to **\[Setup → Copy and Paste]**
* Make sure the option **“Disable paste with right-click”** is **unchecked**\
  → If this option is enabled, right-click paste will not work in the terminal.

<figure><img src="https://3958108398-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvMRdsyzmLItN6oczCyF%2Fuploads%2FKGSYx3o1IEdESyvVmnt1%2Fimage.png?alt=media&amp;token=f0a08b98-2e34-48eb-997c-0faac14e8bea" alt=""><figcaption></figcaption></figure>

***

#### How to Enter Commands

* Copy the command, then **right-click** in the terminal window to paste it
* Press **Enter** to run the command
* Note: You won’t see the text as you type, so be careful of typos when entering manually.

<figure><img src="https://3958108398-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvMRdsyzmLItN6oczCyF%2Fuploads%2FK5eY7WIpEWkpZXmfj72k%2Fimage.png?alt=media&amp;token=0369b60a-ab52-46ba-b48a-628ab2397991" alt=""><figcaption></figcaption></figure>

***

#### Save Settings

* Go to **\[Setup → Save setup]**
* Overwrite `TERATERM.INI` to save the current settings\
  → These settings will be automatically applied the next time you start Tera Term.

<figure><img src="https://3958108398-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvMRdsyzmLItN6oczCyF%2Fuploads%2FbVEEbJG7qmKADRlqkADS%2Fimage.png?alt=media&amp;token=0742058d-7c29-41f6-bb99-e55a83b7fec1" alt=""><figcaption></figcaption></figure>

***

### Conclusion

In this guide, we walked through how to set up serial communication with the **GrowSpace Gateway** using **Tera Term**, including how to send commands and view system logs.

With this setup, you can monitor the **MQTT connection status**, **network settings**, and **internal errors** in real time.\
It also provides a reliable way to continuously manage the device status after initial installation.