本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 故障診斷入門
<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 

下列主題可協助您針對開始使用 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 的終端機模擬器。

您必須將電路板連接到電腦，然後再嘗試建立電路板與終端機模擬器的序列連線。

請使用以下設定來設定終端機模擬器：


| 終端機設定 | Value | 
| --- | --- | 
| 傳輸速率 | 115200 | 
| 資料 | 8 位元 | 
| 同位 | 無 | 
| 停止 | 1 位元 | 
| 流量控制 | 無 | 

### 尋找您的開發板的序列埠
<a name="serial-port-ts"></a>

如果您不知道電路板的序列連接埠，則可以從命令列或終端機發出以下其中一個命令，來傳回所有連接至主機電腦之裝置的序列連接埠：

**Windows**  

```
chgport
```

**Linux**  

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

**macOS**  

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