FRDM-KL25Zのスタート・ガイド

詳細はこちら。

• SWDとJTAGによるデバッグ・サポート
• 柔軟性の高いソフトウェア
• ペリフェラル・ドライバ一式（ソース・コードあり）
• アプリケーション・サンプルとプロジェクト・ファイル

• 拡張性に優れたオープンソースのリアルタイム・オペレーティング・システム (RTOS)
• 複数のハードウェア・アーキテクチャをサポート
• リソースに制約のあるデバイス向けに最適化
• セキュリティを重視した設計

注：詳細については、Zephyr OSデベロッパ・ウェブサイトをご覧ください。

• オンライン・コンパイラ（SWDやJTAGのデバッグなし）
• シンプルで高度に抽象化されたプログラミング・インターフェース
• 制限はあるが使いやすいドライバ（ソース・コードあり）
• コミュニティに投稿されたサンプル・コード

注：詳細については、Mbedデベロッパ・ウェブサイトをご覧ください。

KDSアップデートのインストール

KSDKでKDS IDEを使用する前にツールが最新であるか確認することを推奨します。以下の手順はWindows版のKDSを使用して説明されていますが、MacユーザーとLinuxユーザーの場合も同じです。

1. ［Help（ヘルプ）］>［Check for Updates（アップデートの確認）］の順に選択します

   

2. Freescale/NXPによるすべてのアップデートをインストールします。このようなアップデートには「com.NXP.xxx」または「com.nxp.xxx」と記載されています。ツールチェーンやデバッグ・インターフェースなどもアップデートされている場合があります。このような追加アップデートは、通常、インストールしても問題ありませんが、KDSツールチェーンの一部としてリリースされてはいないため、場合によっては問題が発生することがあります。

サンプル・アプリケーションのビルド

次の手順に従ってhello_worldアプリケーションを開きます。他のサンプル・アプリケーションでは、手順がわずかに異なる場合があります。アプリケーションによってはパスのフォルダ階層が深くなるためです。

注：Linux OSやMac OSでも、Windowsの場合と同じ手順を実行します。

1. KDS IDEメニューから、［File（ファイル）］>［Import（インポート）］の順に選択します。表示されるウィンドウで、Project of Projectsフォルダを展開し、［Existing Project Sets（既存のプロジェクト・セット）］を選択します。［Next（次へ）］ボタンをクリックします

   

2. ［Import from file（次のファイルからインポート）］フィールドの横にある［Browse（参照）］ボタンをクリックします

   

3. サンプル・アプリケーション・プロジェクトを指定します。このプロジェクトは次のパスで見つけることができます。

   /boards////kds

   このガイドでは、次の特定の場所を選択します。

   /boards/frdmkl25z/demo_apps/hello_world/kds

4. 正しいディレクトリを指定すると、下の図のような［Import Working Sets and Projects（ワーキング・セットとプロジェクトをインポート）］ウィンドウが表示されます。［Finish（完了）］ボタンをクリックします

   

5. 各KSDKプロジェクトに対して、以下の2つのプロジェクト設定（ビルド・ターゲット）がサポートされます。

   • Debug（デバッグ）- コンパイラ最適化は「低」に設定され、実行ファイルのデバッグ情報が生成されます。開発時やデバッグ時には、このターゲットを選択します
   • Release（リリース）- コンパイラ最適化は「高」に設定され、デバッグ情報は生成されません。最終的なアプリケーション実装時には、このターゲットを選択します

6. 下の図に示すように、ハンマー・アイコンの横にある下向きの矢印をクリックして、［Debug（デバッグ）］または［Release（リリース）］のうち、適切なビルド・ターゲットを選択します。ここでは、［Debug（デバッグ）］ターゲットを選択します

   

7. ビルド・ターゲットを選択すると、ライブラリのビルドが開始されます。今後、ライブラリをリビルドする際は、ハンマー・アイコンをクリックします（同じビルド・ターゲットを選択する場合）

サンプル・アプリケーションの実行

FRDM-KL25Zボードには、工場出荷時にmbed/CMSIS-DAPデバッグ・インターフェースが搭載されています。ボードのデバッグOpenSDAアプリケーションを変更している場合、OpenSDAにアクセスして、ボードを更新または工場出荷時の状態に復元する方法をご確認ください。

注：Macユーザーは、KDS IDEを使用してダウンロードやボードのデバッグを行う場合、J-Link OpenSDAアプリケーションをインストールしておく必要があります。

1. 開発プラットフォームをPCに接続します。ボード上の「SDAUSB」USBポートとPCのUSBコネクタをUSBケーブルでつないでください

2. PCのターミナル・アプリケーション（PuTTY、Tera Termなど）を開き、事前に確認したデバッグCOMポートに接続します。次の設定値を用いてターミナルを設定します。

   • ボーレート115,200
   • パリティなし
   • 8データ・ビット
   • 1ストップ・ビット

   Linux OSユーザーの場合、ターミナルで次のコマンドを実行します。これにより、システムにlibudevがインストールされます。libudevは、KDS IDEでデバッガを起動する際に必要となります。

   user@ubuntu:~$ sudo apt-get install libudev-dev libudev1 

   user@ubuntu:~$ sudo ln -s /usr/lib/x86_64-linux-gnu/libudev.so /usr/lib/x86_64-linux-gnu/libudev.so.0 

3. 接続するターゲットに対して、デバッガが適切に設定されているか確認します。これは、ボードのOpenSDAインターフェースを指します

   1. 利用可能なデバッガ設定を確認するには、緑色の［Debug（デバッグ）］ボタンの横にある小さな下向きの矢印をクリックして、［Debug Configurations（デバッグ構成）］を選択します

      

   2. ［Debug Configurations（デバッグ構成）］ダイアログ・ボックスで、使用しているハードウェア・プラットフォームに対応するデバッグ構成を選択します。WindowsユーザーまたはLinuxユーザーの場合、［OpenOCD］にある［mbed/CMSIS-DAP］オプションを選択します。Macユーザーの場合、［J-Link］を選択します

   3. デバッガ・インターフェースを選択したら、［Debug（デバッグ）］ボタンをクリックしてデバッガを起動します

   

4. アプリケーションがターゲットにダウンロードされると、自動的にmain()まで実行されます。

   

5. ［Resume（再開）］ボタンをクリックして、アプリケーションを起動します。

   

6. hello_worldアプリケーションが実行され、ターミナルにバナーが表示されます。表示されない場合は、ターミナルの設定と接続を確認してください

   

サンプル・アプリケーションのビルド

次の手順に従ってhello_worldアプリケーションを開きます。他のサンプル・アプリケーションでは、手順がわずかに異なる場合があります。アプリケーションによってはパスのフォルダ階層が深くなるためです。

1. 目的のサンプル・アプリケーション・ワークスペースをまだ開いていない場合はここで開きます。ほとんどのサンプル・アプリケーション・ワークスペースのファイルは、次のパスに置かれています。

   /boards////iar

   hello_worldデモをサンプルとして使用する場合、パスは次のようになります。

   /boards/frdmkl25z/demo_apps/hello_world/iar

2. ドロップダウン・リストから、目的のビルド・ターゲットを選択します。ここでは、「hello_world - Debug」ターゲットを選択します

   

3. アプリケーションをビルドするには、下の図で赤色でハイライト表示されている［Make（作成）］ボタンをクリックします

   

4. ビルドが正常に完了します

サンプル・アプリケーションの実行

FRDM-KL25Zボードには、工場出荷時にmbed/CMSIS-DAPデバッグ・インターフェースが搭載されています。ボードのデバッグOpenSDAアプリケーションを変更している場合、OpenSDAにアクセスして、ボードを更新または工場出荷時の状態に復元する方法をご確認ください。

1. 開発プラットフォームをPCに接続します。ボード上の「SDAUSB」USBポートとPCのUSBコネクタをUSBケーブルでつないでください

2. PCのターミナル・アプリケーション（PuTTY、Tera Termなど）を開き、事前に確認したデバッグCOMポートに接続します。次の設定値を用いてターミナルを設定します。

   • ボーレート115,200
   • パリティなし
   • 8データ・ビット
   • 1ストップ・ビット

3. ［Download and Debug（ダウンロードとデバッグ）］ボタンをクリックして、アプリケーションをターゲットにダウンロードします

   

4. アプリケーションがターゲットにダウンロードされると、自動的にmain()関数まで実行されます

   

5. ［Go（実行）］ボタンをクリックすると、コードが実行され、アプリケーションが起動します

   

6. hello_worldアプリケーションが実行され、ターミナルにバナーが表示されます。表示されない場合は、ターミナルの設定と接続を確認してください

   

CMSISデバイス・パックのインストール

MDKツールをインストールした後、デバッグ目的でデバイスを完全にサポートするには、CMSIS (Cortex® Microcontroller Software Interface Standard) デバイス・パックをインストールする必要があります。このパックには、メモリ・マップ情報、レジスタ定義、フラッシュ・プログラミング・アルゴリズムなどが含まれています。下記の手順に従って、適切なCMSISパックをインストールしてください。

1. µVisionという名前のMDK IDEを開きます。IDEで、［Pack Installer（パック・インストーラ）］アイコンを選択します

   

2. ［Pack Installer（パック・インストーラ）］ウィンドウで、Kinetisパックのセクションに移動します（アルファベット順に並んでいます）。Kinetisパックの名前は、「Keil::Kinetis」で始まり、MCUのファミリ名が続きます（「Keil::Kinetis_K60_DFP」など）。ここではFRDM-KL25Zプラットフォームを使用するため、KL2xファミリのパックを選択します。パックの横にある［Install（インストール）］ボタンをクリックします。このプロセスを正常に完了するには、インターネット接続が必要となります

   

3. インストールが完了したら、［Pack Installer（パック・インストーラ）］ウィンドウを閉じて、µVision IDEに戻ります

サンプル・アプリケーションのビルド

次の手順に従ってhello_worldアプリケーションを開きます。他のサンプル・アプリケーションでは、手順がわずかに異なる場合があります。アプリケーションによってはパスのフォルダ階層が深くなるためです。

1. 目的のデモ・アプリケーション・ワークスペースをまだ開いていない場合は以下で開きます。

   /boards////mdk

   ワークスペース・ファイルの名前は、.uvmpwです。今回の例の場合、実際のパスは次のようになります。

    /boards/frdmkl25z/demo_apps/hello_world/mdk/hello_world.uvmpw

2. デモ・プロジェクトをビルドするには、赤色でハイライト表示されている［Rebuild（リビルド）］ボタンを選択します

   

3. ビルドが正常に完了します

サンプル・アプリケーションの実行

FRDM-KL25Zボードには、工場出荷時にmbed/CMSIS-DAPデバッグ・インターフェースが搭載されています。ボードのデバッグOpenSDAアプリケーションを変更している場合、OpenSDAにアクセスして、ボードを更新または工場出荷時の状態に復元する方法をご確認ください。

1. 開発プラットフォームをPCに接続します。ボード上の「SDAUSB」USBポートとPCのUSBコネクタをUSBケーブルでつないでください

2. PCのターミナル・アプリケーション（PuTTY、Tera Termなど）を開き、事前に確認したデバッグCOMポートに接続します。次の設定値を用いてターミナルを設定します。

   • ボーレート115,200
   • パリティなし
   • 8データ・ビット
   • 1ストップ・ビット

3. アプリケーションが正しくビルドされたら、［Download（ダウンロード）］ボタンをクリックして、アプリケーションをターゲットにダウンロードします

   

4. ［Download（ダウンロード）］ボタンをクリックすると、アプリケーションがターゲットにダウンロードされ、自動的に実行されます。アプリケーションをデバッグする場合、赤色でハイライト表示されている［Start/Stop Debug Session（デバッグ・セッションの開始/終了）］ボタンをクリックします

   

5. ［Run（実行）］ボタンをクリックすると、コードが実行され、アプリケーションが起動します

   

6. hello_worldアプリケーションが実行され、ターミナルにバナーが表示されます。表示されない場合は、ターミナルの設定と接続を確認してください

   

ツールチェーンのセットアップ

ここでは、Kinetis SDKでサポートされているように、Arm GCCツールチェーンを使用してKSDKデモ・アプリケーションのビルドと実行を行う際に必要となるコンポーネントをインストールする手順について説明します。Arm GCCツールの使用方法はさまざまですが、今回の例では、Windows環境に焦点を当てています。ここでは省略しますが、GCCツールは、Linux OSやMac OS Xの環境でも利用できます。

GCC Arm Embeddedツールチェーンのインストール

GNU Arm Embeddedツールチェーン からインストーラをダウンロードして、実行します。これは実際のツールチェーンです（コンパイラ、リンカなど）。Kinetis SDKリリース・ノートに記載されている、サポート対象の最新バージョンのGCCツールチェーンを使用する必要があります。

MinGWのインストール

MinGW (Minimalist GNU for Windows) 開発ツールは、サード・パーティ製のCランタイムDLL（Cygwinなど）に依存しないツール・セットを備えています。KSDKで使用されているビルド環境ではMinGWビルド・ツールを利用せず、MinGWとMSYSのベース・インストールを活用しています。MSYSは、UNIX系のインターフェースと各種ツールを備えた基本シェルを提供します。

1. MinGW - Minimalist GNU for Windowsファイルから最新のMinGW mingw-get-setupインストーラをダウンロードしてください

2. インストーラを実行します。インストール・パスとしてはC:\MinGWを推奨しますが、他のどの場所にでもインストールできます

注：インストール・パスにスペースを含めることはできません。

3. ［Basic Setup（基本セットアップ）］で、「mingw32-base」と「msys-base」が選択されていることを確認します

   

4. ［Installation（インストール）］メニューで［Apply Changes（変更を適用）］をクリックし、残りの手順に従ってインストールを完了します

   

5. Windows OSのPath環境変数に適切なアイテムを追加します。これは、［Control Panel（コントロール・パネル）］>［System and Security（システムとセキュリティ）］>［System（システム）］>［Advanced System Settings（システムの詳細設定）］の［Environment Variables（環境変数）］セクションで設定します。パスは次のとおりです。

   \bin 

   デフォルトのインストール・パスであるC:\MinGWを使用した例を以下に示します。パスが正しく設定されていないと、ツールチェーンは機能しません

   注：PATH変数にC:\MinGW\msys\x.x\binが設定されている場合（KSDK 1.0.0向けの旧仕様）、これを削除してください。削除されていないと、新しいGCCビルド・システムが正しく機能しない場合があります。

   

ARMGCC_DIR向けの新しい環境変数を追加する

1. 新しいシステム環境変数を作成して、「ARMGCC_DIR」という名前を付けます。この変数の値で、Arm GCC Embeddedツールチェーンのインストール・パスを指定します。今回の例では、次のようになります。

C:\Program Files (x86)\GNU Tools Arm Embedded\4.9 2015q3

2. インストール・フォルダの正確なパス名については、GNU Arm GCC Embeddedツールのインストール・フォルダを参照してください

CMakeのインストール

1. CMakeからCMake 3.0.xをダウンロードします

2. CMakeをインストールします。インストール時には、必ず［Add CMake to system PATH（CMakeをシステムPATHに追加）］オプションを選択します。すべてのユーザーが使用できるパスにインストールするか、現在のユーザーのみが使用できるパスにインストールするかは、ユーザーが選択します。今回の例では、すべてのユーザーに対してインストールしています

   

3. インストーラの残りの手順に従います

4. PATHの変更を適用するには、システムの再起動が必要になる場合があります

サンプル・アプリケーションのビルド

サンプル・アプリケーションをビルドする手順は次のとおりです。

1. GCC Arm Embeddedツールチェーンのコマンド・ウィンドウが開いていない場合はここで開きます。ウィンドウを開くには、Windows OSの［スタート］メニューから、［プログラム］>［GNU Tools Arm Embedded ］に移動して、［GCC Command Prompt（GCCコマンド・プロンプト）］を選択します

   

2. サンプル・アプリケーションのプロジェクト・ディレクトリに移動します。パスは次のようになります。

   /boards////armgcc

   このガイドの場合、実際のパスは次のようになります。

   /boards/frdmkl25z/demo_apps/hello_world/armgcc

3. コマンドラインで「build_debug.bat」と入力するか、Windows OSのエクスプローラで「build_debug.bat」ファイルをダブルクリックして、ビルドを実行します。次のような出力画面が表示されます。

   

サンプル・アプリケーションの実行

GCCツールを使用するには、J-Linkデバッグ・インターフェースが必要となります。ボードのOpenSDAファームウェアを最新のJ-Linkアプリケーションにアップデートするには、OpenSDAにアクセスしてください。J-Link OpenSDAアプリケーションをインストールしたら、「SEGGER Downloads」からJ-Linkドライバとソフトウェア・パッケージをダウンロードします。

1. 開発プラットフォームをPCに接続します。ボード上の「SDAUSB」USBポートとPCのUSBコネクタをUSBケーブルでつないでください

2. PCのターミナル・アプリケーション（PuTTY、Tera Termなど）を開き、事前に確認したデバッグCOMポートに接続します。次の設定値を用いてターミナルを設定します。

   • ボーレート115,200
   • パリティなし
   • 8データ・ビット
   • 1ストップ・ビット

3. J-Link GDBサーバ・アプリケーションを開きます。J-Linkソフトウェアがインストールされている場合、Windows OSの［スタート］メニューに移動し、［プログラム］>［SEGGER］>［J-Link J-Link GDB Server］を選択するとアプリケーションを起動できます

4. 次のように設定を変更します。この例で選択されているターゲット・デバイスは、「MKL25Z128xxx4」であり、SWDインターフェースを使用しています

   

5. 接続すると、画面は次の図のようになります。

   

6. GCC Arm Embeddedツールチェーンのコマンド・ウィンドウが開いていない場合はここで開きます。ウィンドウを開くには、Windows OSの［スタート］メニューから、［プログラム］>［GNU Tools Arm Embedded ］に移動して、［GCC Command Prompt（GCCコマンド・プロンプト）］を選択します

   

7. デモ・アプリケーションの出力を格納するディレクトリに変更します。出力は、選択したビルド・ターゲットに応じて、次のいずれかのパスに格納されます。

   /boards////armgcc/debug

   /boards////armgcc/release

   このガイドの場合、パスは次のようになります。

   /boards/frdmkl25z/demo_apps/hello_world/armgcc/debug

8. 次のコマンドを実行します。

   arm-none-eabi-gdb.exe .elf

   今回の例の場合、パスは次のようになります。

   arm-none-eabi-gdb.exe hello_world.elf

   

9. 次のコマンドを実行します。

   • target remote localhost:2331
   • monitor reset
   • monitor halt
   • load
   • monitor reset
10. アプリケーションがダウンロードされ、リセット・ベクタで停止します。「monitor go」コマンドを実行すると、サンプル・アプリケーションが起動します
11. hello_worldアプリケーションが実行され、ターミナル・ウィンドウにバナーが表示されます