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

# 為您的主機板建立 FreeRTOS 入門指南
<a name="afq-gsg"></a>

若要符合 FreeRTOS 的資格，您必須為您的主機板建立 FreeRTOS 入門指南。本指南會逐步引導使用者設定硬體和開發環境，以開發 FreeRTOS 裝置的應用程式，以及在裝置上建置、執行和刷新建立的示範應用程式。

本指南必須可從公有網站提供給客戶。本指南的 URL 是在 AWS Partner Device Catalog 中列出合格主機板的要求。

您的指南必須包含下列操作說明：
+ 設定裝置硬體。
+ 設定開發環境。
+ 建置和執行示範專案。
+ 除錯。
+ 疑難排解。

我們還建議您的指南包含：
+ MCU 規格說明的連結。
+ 印刷電路板 (PCB) 簡圖。
+ 預設映像開機主控台日誌。

**重要**  
由於指示隨作業系統而不同，您必須提供適用於 Windows、Linux 和 macOS 作業系統的指示。

在撰寫電路板的指南[入門指南範本](getting_started_template.md)時，請遵循 。您可以在 [FreeRTOS ](https://docs.aws.amazon.com/freertos/latest/userguide/freertos-getting-started.html)使用者指南中找到其他合格主機板的已發佈指南範例。入門指南的範本可在 [ APN Partner Central](https://partnercentral.awspartner.com/) 取得。

# 入門指南範本
<a name="getting_started_template"></a>

編寫概觀，以提供電路板的簡短描述。這一節應該回答下列問題：
+ 執行示範應用程式需要哪些硬體？

  提供您公司網站上的頁面連結，以提供更多詳細資訊。
+ 支援使用哪些 IDE 來開發電路板的應用程式？

  提供 IDE 使用者指南和下載頁面的連結。
+ 開發時需要哪些工具鏈和其他軟體公用程式？

  提供使用者指南和下載頁面的連結。
+ 在主機板上開始使用 FreeRTOS 是否有任何其他先決條件？

  提供購物頁面、使用者指南及下載頁面的連結。

## 設定您的硬體
<a name="template-setup-hardware"></a>

在這一節，提供設定平台硬體的指示。務必提供有關設定硬體的任何使用者指南或其他文件的連結。

這些指示包括下列各項：
+ 進行跳接器設定。
+ 下載和安裝驅動程式。

  提供所支援驅動程式版本的下載頁面和其他文件的連結。
+ 將電路板連接到電腦。
+ 設定硬體所需的任何其他步驟。

## 設定開發環境
<a name="template-setup-dev"></a>

在這一節，提供有關設定平台支援的開發環境的指示。務必提供各項目的任何下載頁面、使用者指南或其他文件的連結。

這些指示包括下列各項：
+ 建立序列連線。
+ 下載和安裝工具鏈。
+ 下載和安裝支援的 IDE。
+ 開發和除錯裝置的應用程式所需的任何其他軟體。

## 建置並執行示範應用程式
<a name="template-build-and-run-example"></a>

### 建置示範應用程式
<a name="template-freertos-import-project"></a>

在本節中，提供在支援的 IDE 中或使用支援的命令列工具建置所提供示範應用程式的指示。

### 執行示範應用程式專案
<a name="template-run-examples"></a>

在本節中，提供在電路板上刷新和執行 FreeRTOS 示範程式碼的指示。

## 除錯
<a name="template-debugging"></a>

在這一節，提供使用內建或外部除錯器的指示。

## 疑難排解
<a name="template-troubleshooting"></a>

在這一節，提供解決常見或潛在問題的故障診斷秘訣。

**入門指南**範本可從此處的 [APN 合作夥伴入口網站](https://partnercentral.awspartner.com/ContentFolderPartner?id=0690h000009VVzsAAG)下載。需要登入的登入資料。