기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 시작하기 문제 해결
<a name="gsg-troubleshooting"></a>

**중요**  <a name="deprecation-message-general"></a>
이 페이지는 더 이상 사용되지 않는 Amazon-FreeRTOS 리포지토리를 참조합니다. 새 프로젝트를 생성할 때는 [여기서 시작](freertos-getting-started-modular.md)하는 것이 좋습니다. 현재 사용되지 않는 Amazon-FreeRTOS 리포지토리를 기반으로 하는 기존 FreeRTOS 프로젝트가 이미 있는 경우에는 [Amazon-FreeRTOS Github 리포지토리 마이그레이션 가이드](github-repo-migration.md) 섹션을 참조하세요.

다음 항목은 FreeRTOS를 시작하는 과정에서 발생할 수 있는 문제를 해결하는 데 도움이 될 수 있습니다.

**Topics**
+ [일반 시작하기 문제 해결 팁](#gsg-troubleshooting-general)
+ [터미널 에뮬레이터 설치](#uart-term)

보드별 문제 해결은 해당 보드의 [FreeRTOS 시작하기](freertos-getting-started.md) 설명서를 참조하십시오.

## 일반 시작하기 문제 해결 팁
<a name="gsg-troubleshooting-general"></a>

**Hello World 데모 프로젝트를 실행한 후 AWS IoT 콘솔에 메시지가 표시되지 않습니다. 어떻게 해야 합니까?**  
다음을 시도해 보세요.  

1. 터미널 창을 열고 샘플을 로깅 출력을 봅니다. 이 단계는 무엇이 잘못되었는지 확인하는 데 도움이 됩니다.

1. 자격 증명이 유효한지 확인합니다.

**데모를 실행할 때 터미널에 표시되는 로그가 잘립니다. 길이를 늘리려면 어떻게 해야 하나요?**  
실행 중인 데모의 `FreeRTOSconfig.h` 파일에서 `configLOGGING_MAX_MESSAGE_LENGTH` 값을 255로 늘리십시오.  

```
#define configLOGGING_MAX_MESSAGE_LENGTH    255
```

## 터미널 에뮬레이터 설치
<a name="uart-term"></a>

터미널 에뮬레이터는 문제를 진단하거나 디바이스 코드가 올바르게 실행되는지 확인하는 데 도움이 될 수 있습니다. Windows, macOS 및 Linux에 사용할 수 있는 다양한 터미널 에뮬레이터가 있습니다.

터미널 에뮬레이터로 보드에 직렬 연결을 설정하려고 하기 전에 보드를 컴퓨터에 연결해야 합니다.

다음 설정을 사용하여 터미널 에뮬레이터를 구성합니다.


| 터미널 설정 | 값 | 
| --- | --- | 
|  전송 속도  |  115200  | 
|  Data  |  8비트  | 
|  패리티  |  없음  | 
|  Stop  |  1비트  | 
|  흐름 제어  |  없음  | 

### 보드의 직렬 포트 찾기
<a name="serial-port-ts"></a>

보드의 직렬 포트를 모를 경우 명령줄이나 터미널에서 다음 명령 중 하나를 실행하여 호스트 컴퓨터에 연결된 모든 디바이스의 직렬 포트를 반환할 수 있습니다.

**Windows**  

```
chgport
```

**Linux**  

```
ls /dev/tty*
```

**macOS**  

```
ls /dev/cu.*
```