> 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/undefined-1/tera-term.md).

# Tera Term 설치 및 환경 구축

### **이 글에서는** 

GrowSpace 게이트웨이를 Tera Term으로 연결하여, 시리얼 로그를 확인하고 명령어를 입력하는 방법을 안내합니다.\
Tera Term이 어떤 프로그램인지부터 설치, 드라이버 설정, 연결 방법까지 단계별로 설명합니다.

***

### Tera Term이란?

**Tera Term**은 PC와 장치를 **시리얼(Serial) 통신 방식**으로 연결하여 로그를 확인하거나 명령어를 입력할 수 있도록 도와주는 프로그램입니다.

GrowSpace 게이트웨이는 Tera Term을 통해 다음 정보를 직접 확인할 수 있습니다:

* MQTT 브로커 연결 상태
* 네트워크 설정 및 오류 로그
* 장비 기본 설정값
* 실시간 디버깅 메시지

별도 개발 환경 없이 장비 상태를 빠르게 점검할 수 있어, 개발자와 운영자 모두에게 적합한 도구입니다.

***

### 설치 및 환경 구축

#### 프로그램 설치

* 아래 주소로 이동\
  <https://github.com/TeraTermProject/teraterm/releases>

<figure><img src="https://2885569511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYKyrLLe7cm7ZOhiSB0gg%2Fuploads%2FxcJAMEvFsitJnAbmcZ6l%2Fimage.png?alt=media&amp;token=de4cc6db-2875-404d-8177-2a0cce7206fe" alt=""><figcaption></figcaption></figure>

* 최신 버전의 `.exe` 설치 파일 다운로드\
  (예: `teraterm-5.x.x.exe`)
* 설치 마법사에 따라 기본값으로 설치 진행

***

#### 드라이버 설치 (CP210x USB to UART)

게이트웨이 장치를 USB로 연결하기 위해서는 **USB 시리얼 드라이버**가 필요합니다.

* 아래 주소 접속\
  <https://www.silabs.com/developer-tools/usb-to-uart-bridge-vcp-drivers?tab=downloads>
* 운영체제(Windows 등)에 맞는 버전 선택 후 설치
* 설치가 완료되면 **C to USB 케이블**을 이용해 게이트웨이를 PC에 연결

***

#### 포트 연결 확인

* Tera Term 실행
* 시작 화면에서 **Serial** 탭 선택
* `COM`으로 시작하는 포트가 표시되면 장치가 정상 인식된 상태
* 해당 포트를 선택하고 **OK** 클릭

<figure><img src="https://2885569511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYKyrLLe7cm7ZOhiSB0gg%2Fuploads%2F8etjzKiPtfykvOo6YN4M%2Fimage.png?alt=media&amp;token=65127859-f418-4159-a447-09bcf11b8e4c" alt=""><figcaption></figcaption></figure>

***

#### 시리얼 통신 설정

상단 메뉴에서 \[설정 → 시리얼 포트]를 클릭한 뒤 아래와 같이 입력

| 항목             | 설정값    |
| -------------- | ------ |
| 속도 (Baud rate) | 115200 |
| 데이터 비트         | 8 bit  |
| 패리티            | none   |
| 스톱 비트          | 1 bit  |
| 흐름 제어          | none   |

<figure><img src="https://2885569511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYKyrLLe7cm7ZOhiSB0gg%2Fuploads%2FwmsvkxhlWJAqDKUhXnts%2Fimage.png?alt=media&amp;token=aca3652c-02c1-4956-89bb-9bdc77757ee1" alt=""><figcaption></figcaption></figure>

***

#### 터미널 줄바꿈 설정

상단 메뉴 \[설정 → 터미널]에서 아래 항목 설정

| 항목 | 설정값 |
| -- | --- |
| 수신 | CR  |
| 송신 | CR  |

<figure><img src="https://2885569511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYKyrLLe7cm7ZOhiSB0gg%2Fuploads%2FWY8VJdhFGrpQ9vTmsPX5%2Fimage.png?alt=media&amp;token=efda8273-2f5d-4c7d-a991-8fec6a9f35b2" alt=""><figcaption></figcaption></figure>

***

#### 복사 및 붙여넣기 설정

* \[설정 → 복사 및 붙여넣기] 메뉴 클릭
* ‘**마우스 오른쪽 버튼 붙여넣기 비활성화**’ 옵션이 **체크되어 있지 않도록 설정**

→ 이 옵션이 체크되어 있으면 붙여넣기 동작이 제한됩니다.

<figure><img src="https://2885569511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYKyrLLe7cm7ZOhiSB0gg%2Fuploads%2FkO5Al5tcn5iJyaJvXtyN%2Fimage.png?alt=media&amp;token=bcbbdcda-7df2-4b70-a982-721492301ac5" alt=""><figcaption></figcaption></figure>

***

#### 명령어 입력 방법

* 명령어를 복사한 뒤 **터미널 화면에서 마우스 오른쪽 클릭 → 붙여넣기**
* Enter 키를 눌러 명령 실행
* 텍스트 입력이 보이지 않기 때문에 직접 타이핑 시에는 오타에 주의

<figure><img src="https://2885569511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYKyrLLe7cm7ZOhiSB0gg%2Fuploads%2FUNhQ7EEneOMret5r9txu%2Fimage.png?alt=media&amp;token=978d85c0-8113-4c0b-8f7a-39335749be06" alt=""><figcaption></figcaption></figure>

***

#### 설정 저장

\[설정 → 저장하기] 클릭 → `TERATERM.INI` 덮어쓰기

→ 다음 실행 시 현재 설정이 자동으로 적용됩니다.

<figure><img src="https://2885569511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYKyrLLe7cm7ZOhiSB0gg%2Fuploads%2Fkq4d7f3Aab2yX6huHkzB%2Fimage.png?alt=media&amp;token=b90d8945-42ca-4dcb-97a4-b2f2dfd05a56" alt=""><figcaption></figcaption></figure>

***

### 마무리

지금까지 Tera Term을 활용해 GrowSpace 게이트웨이와 시리얼 통신을 설정하고, 명령어 입력 및 로그 확인을 위한 환경을 구축하는 방법을 살펴보았습니다.

이 과정을 통해 사용자는 MQTT 연결 상태, 네트워크 설정, 내부 오류 등을 실시간으로 점검할 수 있으며, 초기 설치 이후 장비 상태를 지속적으로 관리할 수 있는 기반을 마련할 수 있습니다.