本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 问题排查入门
<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  | 
|  数据  |  8 位  | 
|  奇偶校验  |  none  | 
|  停止  |  1 位  | 
|  流控制  |  none  | 

### 查找主板的串行端口
<a name="serial-port-ts"></a>

如果不知道主板的串行端口，您可以从命令行或终端发布以下命令之一，返回连接到您主机的所有设备的串行端口：

**Windows**  

```
chgport
```

**Linux**  

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

**macOS**  

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