

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Texas Instruments CC3220SF-LAUNCHXL の開始方法
<a name="getting_started_ti"></a>

**重要**  <a name="deprecation-message"></a>
このリファレンス統合は、非推奨の Amazon-FreeRTOS リポジトリでホストされています。新しいプロジェクトを作成するときは、[ここから始める](freertos-getting-started-modular.md)ことをお勧めします。現在非推奨の Amazon-FreeRTOS リポジトリをベースにした既存の FreeRTOS プロジェクトが既にある場合は、「[Amazon FreeRTOS Github リポジトリ移行ガイド](github-repo-migration.md)」を参照してください。

このチュートリアルでは、Texas Instruments CC3220SF-LAUNCHXL の使用を開始するための手順について説明します。Texas Instruments (TI) CC3220SF-LAUNCHXL 開発キットをお持ちでない場合は、 AWSPartner Device Catalog にアクセスして[当社のパートナー](https://devices.amazonaws.com/detail/a3G0L00000AANtaUAH/SimpleLink-Wi-Fi®-CC3220SF-Wireless-Microcontroller-LaunchPad-Development-Kit)から購入してください。

開始する前に、 AWS IoTと FreeRTOS ダウンロードを設定して、デバイスをAWS クラウドに接続する必要があります。手順については「[最初のステップ](freertos-prereqs.md)」を参照してください。このチュートリアルでは、FreeRTOS ダウンロードディレクトリへのパスを `freertos` とします。

## 概要:
<a name="w2aac31b9b7c25c48c11"></a>

このチュートリアルには、使用開始のための以下の手順が含まれています。

1. マイクロコントローラーボード用の組み込みアプリケーションを開発およびデバッグするためのソフトウェアをホストマシンにインストールします。

1. FreeRTOS デモアプリケーションをバイナリイメージにクロスコンパイルします。

1. アプリケーションバイナリイメージをボードにロードし、アプリケーションを実行します。

## 開発環境をセットアップする
<a name="ti-setup-env"></a>

以下のステップに従って、FreeRTOS の使用を開始するための開発環境をセットアップしてください。

FreeRTOS は、TI CC3220SF-LAUNCHXL Development Kit 用の 2 つの IDE (Code Composer Studio と IAR Embedded Workbench バージョン 8.32) をサポートしていることに注意してください。どちらの IDE でも開始することができます。

### Code Composer Studio をインストールする
<a name="install-ccs"></a>

1. [TI Code Composer Studio](http://processors.wiki.ti.com/index.php/Download_CCS) を参照します。

1. ホストマシン (Windows、macOS、または Linux 64-bit) のプラットフォーム用に、オフラインのインストーラをダウンロードします。

1. オフラインインストーラを解凍し、実行します。プロンプトに従います。

1. **[Product Families to Install]** (インストールする製品ファミリー) で、**[SimpleLink Wi-Fi CC32xx Wireless MCUs]** を選択します。

1. 次のページで、デバッグプローブのデフォルトの設定をそのまま使用し、**[Finish]** (完了) を選択します。

Code Composer Studio をインストールするときに問題が発生する場合は、[TI Development Tools サポート](http://software-dl.ti.com/ccs/esd/documents/ccs_support.html)、[Code Composer Studio FAQs](http://processors.wiki.ti.com/index.php/FAQ_-_CCS)、および [CCS トラブルシューティング](http://processors.wiki.ti.com/index.php/Troubleshooting_CCSv7)を参照してください。

### IAR Embedded Workbench をインストールする
<a name="install-iar"></a>

1. IAR Embedded Workbench for ARM の[バージョン 8.32 用 Windows インストーラ](http://netstorage.iar.com/SuppDB/Protected/PRODUPD/013570/EWARM-CD-8322-19423.exe)をダウンロードして実行します。**[Debug probe drivers]** (デバッグプローブドライバ) で、**[TI XDS]** が選択されていることを確認します。

1. インストールを終了してプログラムを起動します。**[License Wizard]** (ライセンスのウィザード) ページで、**[Register with IAR Systems to get an evaluation license]** (IAR Systems に登録して評価ライセンスを取得する)、または独自の IAR ライセンスを使用します。

### SimpleLink CC3220 SDK をインストールする
<a name="install-ti-sdk"></a>

[SimpleLink CC3220 SDK](http://www.ti.com/tool/SIMPLELINK-CC3220-SDK) をインストールします。SimpleLink Wi-Fi CC3220 SDK には、CC3220SF のプログラム可能な MCU 用のドライバー、40 以上のサンプルアプリケーション、またサンプルを使用するのに必要なドキュメントが含まれています。

### Uniflash をインストールする
<a name="install-uniflash"></a>

[Uniflash](http://www.ti.com/tool/UNIFLASH) をインストールします。CCS Uniflash は、TI MCU 上のオンチップフラッシュメモリをプログラムするために使用されるスタンドアロンのツールです。Uniflash には、GUI、コマンドライン、スクリプトインターフェイスがあります。

### 最新のサービスパックをインストールする
<a name="ti-servicepack"></a>

1. TI CC3220SF-LAUNCHXL の、ピンの中央のセット (位置 = 1) に SOP ジャンパーを配置し、ボードをリセットします。

1. Uniflash を開始します。CC3220SF LaunchPad ボードが、**[Detected Devices]** (検出されたデバイス) の下に表示されている場合は、**[Start]** (スタート) を選択します。ボードが検出されない場合は、**[New Configuration]** (新しい設定) のボードリストから **CC3220SF-LAUNCHXL** を選択して、**[Start Image Creator]** (Image Creator の開始) を選択します。

1. **[New Project]** (新しいプロジェクト) を選択します。

1. **[Start new project]** (新しいプロジェクトを開始) ページで、プロジェクトの名前を入力します。**[Device Type]** (デバイスタイプ) で **[CC3220SF]** を選択します。**[Device Mode]** (デバイスモード) で、**[Develop]** (開発)、**[Create Project]** (プロジェクトの作成) の順に選択します。

1. Uniflash アプリケーションウィンドウの右側で、**[Connect]** (接続) を選択します 。

1. 左側の列から、**[Advanced]** (アドバンスド)、**[Files]** (ファイル)、**[Service Pack]** (サービスパック) の順に選択します。

1. **[Browse]** (参照) を選択してから、CC3220SF SimpleLink SDK をインストールした場所に移動します。このサービスパックは、`ti/simplelink_cc32xx_sdk_VERSION/tools/cc32xx_tools/servicepack-cc3x20/sp_VERSION.bin` にあります。

1. **[Burn]** (焼き付け) (![\[Feather icon representing a lightweight or simplified feature or concept.\]](http://docs.aws.amazon.com/ja_jp/freertos/latest/userguide/images/flame.png)) ボタンを選択し、次に **[Program Image (Create & Program)]** (プログラムイメージ (作成およびプログラム)) を選択してサービスパックをインストールします。必ず SOP ジャンパーを 0 の位置に戻してボードをリセットしてください。

### Wi-Fi プロビジョニングを設定する
<a name="wifi-provision"></a>

ボードの Wi-Fi を設定するには、次のいずれかを実行します。
+ [FreeRTOS デモを設定する](freertos-prereqs.md#freertos-configure) の説明のとおり、FreeRTOS デモアプリケーションを設定します。
+ Texas Instruments から [SmartConfig](http://dev.ti.com/tirex/#/?link=Software%2FSimpleLink%20CC32xx%20SDK%2FSimpleLink%20Academy%2FWi-Fi%2FWi-Fi%20Provisioning) を使用します。

## FreeRTOS デモプロジェクトを構築して実行する
<a name="ti-build-and-run-examples"></a>

### TI Code Composer で FreeRTOS デモプロジェクトを構築して実行する
<a name="ti-build-and-run-ccs"></a><a name="ti-load-project"></a>

**FreeRTOS デモを TI Code Composer にインポートするには**

1. TI Code Composer を開き、**[OK]** を選択して、デフォルトの WorkSpace 名をそのまま使用します。

1. **[Getting Started]** (開始方法) ページで、**[Import Project]** (プロジェクトのインポート) を選択します。

1. **[Select search-directory]** (検索ディレクトリを選択) に、`projects/ti/cc3220_launchpad/ccs/aws_demos` と入力します。デフォルトでは、プロジェクト `aws_demos` が選択されている必要があります。プロジェクトを TI Code Composer にインポートするには、**[Finish]** (完了) を選択します。

1. **[Project Explorer]** (プロジェクトエクスプローラー) で、**[aws\$1demos]** をダブルクリックしてプロジェクトをアクティブにします。

1. **[Project]** (プロジェクト) から **[Build Project]** (ビルドプロジェクト) を選択して、プロジェクトがエラーや警告なしでコンパイラされていることを確認します。<a name="ti-run-project-css"></a>

**TI Code Composer で FreeRTOS デモを実行するには**

1. Texas Instruments CC3220SF-LAUNCHXL 上の Sense On Power (SOP) ジャンパーが 0 の位置にあることを確認してください。詳細については、[SimpleLink Wi-Fi CC3x20、CC3x3x ネットワークプロセッサユーザーガイド](http://www.ti.com/lit/swru455)を参照してください。

1. USB ケーブルを使用して Texas Instruments CC3220SF-LAUNCHXL をコンピュータに接続します。

1. プロジェクトエクスプローラーで、`CC3220SF.ccxml` がアクティブなターゲット設定として選択されていることを確認します。アクティブにするには、ファイルを右クリックして **[Set as active target configuration]** (アクティブターゲット設定として設定する) を選択します。

1. TI Code Composer で、**[Run]** (実行) から **[Debug]** (デバッグ) を選択します。

1. デバッガーが `main()` のブレークポイントで停止したら、**[Run]** (実行) メニューに移動して **[Resume]** (再開) を選択します。

### クラウドの MQTT メッセージのモニタリング
<a name="w2aac31b9b7c25c48c15b5"></a>

FreeRTOS デモプロジェクトを実行する前に、AWS IoTコンソールで MQTT クライアントを設定して、デバイスが AWSクラウドに送信するメッセージをモニタリングできます。

**MQTT クライアントで AWS IoTMQTT トピックをサブスクライブするには**

1. [AWS IoT コンソール](https://console.aws.amazon.com/iotv2/) にサインインします。

1. ナビゲーションペインで、**[テスト]** を選択し、**[MQTT テストクライアント]** を選択して MQTT クライアントを開きます。

1. **[Subscription topic]** (トピックのサブスクリプション) で ***your-thing-name*/example/topic** と入力し、**[Subscribe to topic]** (トピックへのサブスクライブ) を選択します。

デバイス上でデモプロジェクトが正常に実行されると、「Hello World\$1」が 購読しているトピックに複数回送信されたことを確認できます。

### IAR Embedded Workbench で FreeRTOS デモプロジェクトを構築して実行する
<a name="ti-build-and-run-iar"></a><a name="ti-load-project-iar"></a>

**FreeRTOS デモを IAR Embedded Workbench にインポートするには**

1. IAR Embedded Workbench を開き、**[File]** (ファイル)、**[Open Workspace]** (WorkSpace を開く) の順に選択します。

1. `projects/ti/cc3220_launchpad/iar/aws_demos` に移動して **[aws\$1demos.eww]** を選択してから、**[OK]** を選択します。

1. プロジェクト名 (`aws_demos`) を右クリックし、**[Make]** (作成) をクリックします。

**IAR Embedded Workbench で FreeRTOS デモを実行するには**

1. Texas Instruments CC3220SF-LAUNCHXL 上の Sense On Power (SOP) ジャンパーが 0 の位置にあることを確認してください。詳細については、[SimpleLink Wi-Fi CC3x20、CC3x3x ネットワークプロセッサユーザーガイド](http://www.ti.com/lit/swru455)を参照してください。

1. USB ケーブルを使用して Texas Instruments CC3220SF-LAUNCHXL をコンピュータに接続します。

1. プロジェクトを再構築します。

   プロジェクトを再構築するには、**[Project]** (プロジェクト) メニューから **[Make]** (作成) を選択します。

1. **[Project]** (プロジェクト) メニューから、**[Download and Debug]** (ダウンロードとデバッグ) を選択します。もし、「警告: EnergyTrace の初期化に失敗しました」が表示された場合は、無視してかまいません。EnergyTrace の詳細については、「[MSP EnergyTrace Technology](http://www.ti.com/tool/energytrace?jktype=recommendedresults)」を参照してください。

1. デバッガーが `main()` のブレークポイントで停止したら、**[Debug]** (デバッグ) メニューに移動して **[Go]** (実行) を選択します。

### FreeRTOS で CMake を使用する
<a name="w2aac31b9b7c25c48c15b9"></a>

FreeRTOS 開発に IDE を使用しない場合は、代わりに CMake を使用して、サードパーティのコードエディタおよびデバッグツールを使用して開発したデモアプリケーションまたはアプリケーションを構築して実行できます。

**CMake で FreeRTOS デモを構築するには**

1. 生成されたビルドファイルを格納するフォルダ (*build-folder*) を作成します。

1. 検索パス (**\$1 PATH** 環境変数) に、TI CGT コンパイラバイナリがあるフォルダ (`C:\ti\ccs910\ccs\tools\compiler\ti-cgt-arm_18.12.2.LTS\bin` など) が含まれていることを確認してください。

   TI ボードで TI ARM コンパイラを使用している場合は、次のコマンドを使用してソースコードからビルドファイルを生成します。

   ```
   cmake -DVENDOR=ti -DBOARD=cc3220_launchpad -DCOMPILER=arm-ti -S freertos -B build-folder
   ```

詳細については、「[FreeRTOS で CMake を使用する](getting-started-cmake.md)」を参照してください。

## トラブルシューティング
<a name="getting_started_ti_troubleshooting"></a>

AWS IoTコンソールの MQTT クライアントにメッセージが表示されない場合は、ボードのデバッグ設定を構成する必要がある場合があります。

**TI ボードのデバッグ設定を設定するには**

1. Code Composer の **[Project Explorer]** (プロジェクトエクスプローラー) で、**[aws\$1demos]** を選択します。

1. **[Run]** (実行) メニューから、**[Debug Configurations]** (デバッグ設定) を選択します。

1. ナビゲーションペインで **[aws\$1demos]** を選択します。

1. **[Target]** (ターゲット) タブの **[Connection Options]** (接続のオプション) で、**[Reset the target on a connect]** (接続のターゲットをリセットする) を選択します。

1. **[Apply]** (適用)、**[Close]** (終了) の順に選択します。

上記の手順が機能しない場合は、シリアルターミナルのプログラムの出力を確認します。問題の原因を示す任意のテキストが表示されます。

FreeRTOS の開始方法に関する一般的なトラブルシューティングについては、「[トラブルシューティングの開始方法](gsg-troubleshooting.md)」を参照してください。