CMSIS-RTOS RTX BSP V1.01 リリースノート

Transcription

1 RZ/A1LU グループ CMSIS-RTOS RTX BSP V1.01 R01AN3161JJ0101 Rev.1.01 要旨 本書は RZ/A1LU CMSIS-RTOS RTX BSP( 以降 BSP) のパッケージについて記載します 動作確認ボード RZ/A1LU AVB ボード RTK772103FC00000BR ( 本書では以下 RZ/A1LU AVB ボード と略す ) 変更履歴 Ver. No. 種別 内容 備考 V 全体 ソフトウェア環境のツールのバージョンを更新 2 更新したドキュメントの版数を変更 3 サンプルプログラム e2studio のプロジェクトで設定するデバイスの型番を変更 4 EWARM のシリフラブートを I-jet を使用した書き込み方法に修正 v 新規作成 R01AN3161JJ0101 Rev.1.01 Page 1 of 37

2 目次 1. パッケージ内容 フォルダ構成 BSP について KPIT GCC optlib ライブラリ用追加ヘッダファイルについて USB シリアル変換 IC 用ドライバについて 制限事項 注意事項 R01AN3161JJ0101 Rev.1.01 Page 2 of 37

3 1. パッケージ内容 本パッケージには次のものが含まれています 1.1 ソフトウェア ソースコード No. 名称 フォルダ名 1 BSP ソース一式 CMSIS_RTOS_RTX_A1LU_GCC CMSIS_RTOS_RTX_A1LU_ARMCC CMSIS_RTOS_RTX_A1LU_ICCARM KPIT GCC optlib ライブラリ用追加ヘッダファイル No. 名称 ファイル / フォルダ名 1 KPIT GCC optlib ライブラリ用 Software KPIT optlibinc *.h 追加ヘッダファイル 1.2 ドキュメント マニュアル No. 文書名 版数 ファイル名 1 RZ/A1LU CMSIS-RTOS RTX BSP V1.01 Rev.1.01 r01an3161jj0101-rza1lu.pdf( 本書 ) 2 RZ/A1LU CMSIS-RTOS RTX BSP Rev.1.01 r01us0196jj0101-rza1lu.pdf BSP(Kernel_HW 依存部 ) ユーザーズマニュアル 3 RZ/A1LU CMSIS-RTOS RTX BSP Rev.1.01 r01us0189jj0101-rza1lu.pdf DMA ドライバユーザーズマニュアル 4 RZ/A1LU CMSIS-RTOS RTX BSP Rev.1.01 r01us0190jj0101-rza1lu.pdf RIIC ドライバユーザーズマニュアル 5 RZ/A1LU CMSIS-RTOS RTX BSP Rev.1.01 r01us0191jj0101-rza1lu.pdf RSPI ドライバユーザーズマニュアル 6 RZ/A1LU CMSIS-RTOS RTX BSP Rev.1.01 r01us0192jj0101-rza1lu.pdf SCIF ドライバユーザーズマニュアル 7 RZ/A1LU CMSIS-RTOS RTX BSP Rev.1.01 r01us0194jj0101-rza1lu.pdf SSIF ドライバユーザーズマニュアル 8 RZ/A1LU CMSIS-RTOS RTX BSP Rev.1.01 r01us0188jj0101-rza1lu.pdf ADC ドライバユーザーズマニュアル 9 RZ/A1LU CMSIS-RTOS RTX BSP Rev.1.01 r01us0193jj0101-rza1lu.pdf SCUX ドライバユーザーズマニュアル 10 RZ/A1 グループ Rev.1.00 r01an3162jj0100-rza1lu.pdf CMSIS-RTOS RTX 拡張ガイド 11 RZ/A1LU CMSIS-RTOS RTX BSP Rev.1.00 r01an3163jj0100-rza1lu.pdf IOIF サンプルプログラムアプリケーションノート 12 RZ/A1LU CMSIS-RTOS RTX BSP SOUND ドライバユーザーズマニュアル Rev.1.01 r01us0198jj0101-rza1lu.pdf R01AN3161JJ0101 Rev.1.01 Page 3 of 37

4 サンプル動作手順 No. サンプル名ファイル名 保存先 1 ex1 readme_j.txt, readme_sfwrite_j.txt RTOS RTX Boards Renesas RZ_A1LU_EV RenesasBSP_example ex1 2 ADC サンプル 1 readme_j.txt, readme_sfwrite_j.txt RTOS RTX Boards Renesas RZ_A1LU_EV RenesasBSP_example ADC sample1 3 ADC サンプル 2 readme_j.txt, readme_sfwrite_j.txt RTOS RTX Boards Renesas RZ_A1LU_EV RenesasBSP_example ADC sample2 4 MIC readme_j.txt, readme_sfwrite_j.txt RTOS RTX Boards Renesas RZ_A1LU_EV RenesasBSP_example MIC sample1 5 SCUX readme_j.txt, readme_sfwrite_j.txt RTOS RTX Boards Renesas RZ_A1LU_EV RenesasBSP_example SCUX sample1 R01AN3161JJ0101 Rev.1.01 Page 4 of 37

5 2. フォルダ構成 本パッケージのフォルダ構成と内容物の詳細を以下に示します 2.1 KPIT GCC 版 Top Documentation ReleaseNote : Specification : ドキュメント ( 第 1.2 章参照 ) Software BSP CMSIS_RTOS_RTX_A1LU_GCC :BSP ソースフォルダ.project Include RTOS RTX Boards Renesas RZ_A1LU_EV INC : 共通ヘッダ iodefines : チップ依存ヘッダ RenesasBSP :BSP 用ドライバ version.txt :BSP バージョン情報 drv_inc : ドライバヘッダ drv_lib : ドライバライブラリ drv_src adc :ADC ドライバ dma :DMA ドライバ ioif :IOIF プログラム riic :RIIC ドライバ rspi :RSPI ドライバ scif :SCIF ドライバ scux :SCUX ドライバ sound :SOUND ドライバ ssif :SSIF ドライバ RenesasBSP_example :BSP サンプル TOP ADC sample1 : スイッチ (SW7) サンプルプログラム 1 本体 sample2 : スイッチ (SW7) サンプルプログラム 2 本体 ex1 :ex1 サンプルプログラム本体 inc : サンプル共通ヘッダ lib : サンプル共通ライブラリ MIC sample1 : マイク動作サンプルプログラム本体 SCUX sample1 :SCUX ドライバ動作サンプルプログラム本体 Doc :CMSIS-RTOS RTX ドキュメント INC :CMSIS-RTOS RTX ヘッダファイル LIB :CMSIS-RTOS RTX ライブラリ SRC :CMSIS-RTOS RTX ソースファイル License.txt :CMSIS-RTOS RTX ライセンス情報 KPIT optlibinc :KPIT GCC optlib ライブラリ用追加ファイル LU_USB_DRV :USB シリアル変換 IC 用ドライバ R01AN3161JJ0101 Rev.1.01 Page 5 of 37

6 2.2 DS-5 版 Top Documentation ReleaseNote : Specification : ドキュメント ( 第 1.2 章参照 ) Software BSP CMSIS_RTOS_RTX_A1LU_ARM :BSP ソースフォルダ.project Include RTOS RTX Boards Renesas RZ_A1LU_EV INC : 共通ヘッダ iodefines : チップ依存ヘッダ RenesasBSP :BSP 用ドライバ version.txt :BSP バージョン情報 drv_inc : ドライバヘッダ drv_lib : ドライバライブラリ drv_src adc :ADC ドライバ dma :DMA ドライバ ioif :IOIF プログラム riic :RIIC ドライバ rspi :RSPI ドライバ scif :SCIF ドライバ scux :SCUX ドライバ sound :SOUND ドライバ ssif :SSIF ドライバ RenesasBSP_example :BSP サンプル TOP ADC sample1 : スイッチ (SW7) サンプルプログラム 1 本体 sample2 : スイッチ (SW7) サンプルプログラム 2 本体 ex1 :ex1 サンプルプログラム本体 inc : サンプル共通ヘッダ lib : サンプル共通ライブラリ MIC sample1 : マイク動作サンプルプログラム本体 SCUX sample1 :SCUX ドライバ動作サンプルプログラム本体 Doc :CMSIS-RTOS RTX ドキュメント INC :CMSIS-RTOS RTX ヘッダファイル LIB :CMSIS-RTOS RTX ライブラリ SRC :CMSIS-RTOS RTX ソースファイル License.txt :CMSIS-RTOS RTX ライセンス情報 PARTNER_CFG :PARTNER コンフィグファイル LU_USB_DRV :USB シリアル変換 IC 用ドライバ R01AN3161JJ0101 Rev.1.01 Page 6 of 37

7 2.3 EWARM 版 Top Documentation ReleaseNote : Specification : ドキュメント ( 第 1.2 章参照 ) Software BSP CMSIS_RTOS_RTX_A1LU_ICCARM :BSP ソースフォルダ CMSIS_RTOS_RTX_BSP.eww :IAR 用プロジェクトファイル Include RTOS RTX Boards Renesas RZ_A1LU_EV INC : 共通ヘッダ iodefines : チップ依存ヘッダ RenesasBSP :BSP 用ドライバ version.txt :BSP バージョン情報 drv_inc : ドライバヘッダ drv_lib : ドライバライブラリ drv_src adc :ADC ドライバ dma :DMA ドライバ ioif :IOIF プログラム riic :RIIC ドライバ rspi :RSPI ドライバ scif :SCIF ドライバ scux :SCUX ドライバ sound :SOUND ドライバ ssif :SSIF ドライバ RenesasBSP_example :BSP サンプル TOP ADC sample1 : スイッチ (SW7) サンプルプログラム 1 本体 sample2 : スイッチ (SW7) サンプルプログラム 2 本体 ex1 :ex1 サンプルプログラム本体 inc : サンプル共通ヘッダ lib : サンプル共通ライブラリ MIC sample1 : マイク動作サンプルプログラム本体 SCUX sample1 :SCUX ドライバ動作サンプルプログラム本体 Doc :CMSIS-RTOS RTX ドキュメント INC :CMSIS-RTOS RTX ヘッダファイル LIB :CMSIS-RTOS RTX ライブラリ SRC :CMSIS-RTOS RTX ソースファイル License.txt :CMSIS-RTOS RTX ライセンス情報 IAR RenesasBSP : ドライバ用設定ファイル RenesasBSP_example : サンプル用設定ファイル RTOS : ライブラリ用設定ファイル PARTNER_CFG :PARTNER コンフィグファイル LU_USB_DRV :USB シリアル変換 IC 用ドライバ R01AN3161JJ0101 Rev.1.01 Page 7 of 37

8 3. BSP について BSP ソース一式を使用するために必要な情報を記載します 3.1 ソフトウェア情報 ベース OS RTX for Cortex-A9 (24th February 2015) ドライバ DMA, SCIF, SSIF, RSPI, RIIC, RSPI, ADC, SCUX, SOUND アプリケーション IOIF サンプル ex1, ADC (sample1, sample2), MIC, SCUX 3.2 ツール情報 ビルド環境 統合開発環境 e2studio (Version: ) DS-5(Version: ) IAR Embedded Workbench for ARM 開発ツール KPIT 社製 GNU Tools GNUARM-NONE v16.01 ARM 社製 ARM Compiler v5 IAR Systems 社製 IAR C/C++ Compiler for ARM 1.09 実行環境 SEGGER J-Link KEIL ULINK2 IAR Systems I-jet 京都マイクロコンピュータ PARTNER-Jet2 R01AN3161JJ0101 Rev.1.01 Page 8 of 37

9 3.3 ハードウェア情報 デバイス RZ/A1LU ターゲットボード ボード名 RZ/A1LU AVB ボード 動作モード Clockin = 13.33MHz, CKIO = 66.67MHz I Clock = MHz B Clock = MHz P1 Clock = 66.67MHz P0 Clock = 33.33MHz セットアップ方法 表 1 コネクタ接続 部品番号 J8 J5 J3 J14 J17 J20 接続機材 スピーカー ( ヘッドフォン ) WM8978 用 スピーカー ( ヘッドフォン ) AK4353 用 マイク USB シリアルケーブル JTAG ケーブル AC アダプタ WM8978:RZ/A1LU AVB ボード搭載オーディオコーデック WM8978 AK4353 :RZ/A1LU AVB ボード搭載 D/A 変換器 AK4353 表 2 デバッグシリアルポート設定 ボーレート キャラクタ長 8bit パリティ なし ストップビット 1bit フロー制御 なし 改行コード CR R01AN3161JJ0101 Rev.1.01 Page 9 of 37

10 ジャンパ 各 SW の設定は 下記の写真を参照してください 図 3-1 ジャンパ SW 設定 R01AN3161JJ0101 Rev.1.01 Page 10 of 37

11 3.4 ex1 サンプル動作確認 手順 (e2studio) ex1 サンプルのビルドを実施する前に 4. KPIT GCC optlib ライブラリ用追加ヘッダファイルについて をお読み下さい ビルド方法 本章は 内蔵 RAM ブートとシリアルフラッシュブート共通の内容です 1. e2studio のワークスペースを新規作成 ( 1) 1 任意の場所 ( 2) に作業フォルダを作成 ( フォルダ名は任意 ) 2 手順 1で作成したフォルダ下に展開したソースファイル (BSP ソースフォルダ下のすべてのファイル群 ) をコピー 例 ) 作業フォルダを C: Workspace とした場合のフォルダ構成 C: Workspace CMSIS_RTOS_RTX_A1LU_GCC.project Include BSP ソースフォルダ下のファイル群 RTOS 3 e2studio を起動 4 [ ファイル ] メニュー [ ワークスペースの切り替え ] [ その他 ] を選択 5 ワークスペース ランチャー ダイアログの 参照 をクリック 6 手順 1 で作成した場所を選択し OK をクリック 7 自動で e2studio が再起動し ようこそ 画面が表示される 8 ようこそ 画面を閉じる 1: 既存のワークスペースがある場合 既存のワークスペースを流用せず 必ず新規に作成すること 2:Windows のパス名の文字数制限 (260 文字 ) を超えないようにドライブのルートに近い場所に作業フォルダを作成すること 2. [ ウィンドウ ] メニュー [ ビューの表示 ] [ プロジェクト エクスプローラー ] を選択 3. [ プロジェクト エクスプローラー ] を右クリック [ インポート ] を選択 4. インポート ダイアログの インポート ソースの選択 で 一般 既存プロジェクトをワークスペースへ を選択し 次へ ボタンをクリック 5. インポート ダイアログの ルート ディレクトリの選択 をチェックし 参照 をクリック 6. フォルダの参照 ダイアログで ソースファイルのコピー先のトップ ( 手順 1-1 で作成したフォルダ名 ) を選択し OK をクリック 7. インポート ダイアログの ネストしたプロジェクトを検索 のチェックをつける 8. インポート ダイアログの 選択をすべて解除 をクリック R01AN3161JJ0101 Rev.1.01 Page 11 of 37

12 9. プロジェクト 一覧から次の項目のみにチェックを追加 CMSIS_RTOS_RTX_A1LU_GCC DMA_drv ex1 IOIF RIIC_drv RSPI_drv RTX_CA9_L SOUND_drv SSIF_drv 10. インポート ダイアログの プロジェクトをワークスペースにコピー のチェックを外す 11. インポート ダイアログの 終了 をクリック 12. プロジェクト エクスプローラー の ex1 プロジェクトを選択し 右クリック [ プロパティ ] を選択 13. プロパティ ダイアログの C/C++ ビルド の settings を選択 14. tool settings タブの Linker その他 を選択 15. ファイル 欄に下記の通り設定 適用 を押下 OK を押下 ( プロパティウィンドウが閉じる ) 内蔵 RAM ブートの場合 : ${ProjDirPath}/${ProjName}.ld シリアルフラッシュブートの場合 : ${ProjDirPath}/${ProjName}_sflashboot.ld 16. プロジェクト エクスプローラー の ex1 プロジェクトを選択し 右クリック [ プロジェクトをクリーンにする ] を選択 17. プロジェクト エクスプローラー の ex1 プロジェクトを選択し 右クリック [ プロジェクトのビルド ] を選択 次のファイルが生成される RTOS RTX Boards Renesas RZ_A1LU_EV RenesasBSP_example ex1 HardwareDebug ex1.x R01AN3161JJ0101 Rev.1.01 Page 12 of 37

13 実行準備 本章は 内蔵 RAM ブートとシリアルフラッシュブート共通の内容です ビルド方法で作成した <ex1.x> ファイルを書き込む前に必要な手順を下記に記します この手順を実行する前に ビルド方法 で ex1 サンプルプログラムの <ex1.x> ファイルを作成してください 手順 8~11 はシリアルフラッシュブート専用の手順となります 1. e2studio を起動 2. プロジェクト エクスプローラーから ex1 [HardwareDebug] を選択 3. メニューの [ 実行 (R)] [ デバッグの構成 (B)...] を選択 図 3-2 デバッグの構成 選択画面 R01AN3161JJ0101 Rev.1.01 Page 13 of 37

14 4. デバッグ構成 ダイアログの Renesas GDB Hardware Debugging をダブルクリック 手順 2. で選択した プロジェクト (ex1 HardwareDebug[local]) が出現 選択 5. Debugger タブの Debug hardware のプルダウンメニューから J-Link ARM を選択 6. Debugger タブの Target Device から RZ RZ/A1 R7S を選択 図 3-3 Debugger タブ 7. Debugger タブの デバッグ ツール設定 タブで Use CFI-Flash を いいえ に設定 内蔵 RAM ブートの場合 : 手順 8~11 は不要 R01AN3161JJ0101 Rev.1.01 Page 14 of 37

15 図 3-4 Debugger タブの デバッグ ツール設定 画面 R01AN3161JJ0101 Rev.1.01 Page 15 of 37

16 8. シリアルフラッシュブートの場合 ブートローダの実行プログラム設定が必要です Startup タブの イメージとシンボルをロード の右にある 追加... ボタンをクリック 図 3-5 Startup タブ 9. ダウンロード モジュールの追加 ダイアログで ワークスペース... をクリック 図 3-6 ダウンロード モジュールの追加 ダイアログ R01AN3161JJ0101 Rev.1.01 Page 16 of 37

17 10. ブートローダの実行ファイル ( 画像では ex1 の FlashImage フォルダ以下の RZ_A1LU_sflash_boot_init_kpitgcc.x ) を選択 図 3-7 ブートローダの実行ファイル選択画面 R01AN3161JJ0101 Rev.1.01 Page 17 of 37

18 11. 登録した実行ファイルのロードタイプを イメージのみ 接続時を No に設定 図 3-8 実行ファイル設定画面 12. 適用 をクリック 13. 閉じる をクリック R01AN3161JJ0101 Rev.1.01 Page 18 of 37

19 ダウンロードと実行 ( 内蔵 RAM ブート ) この手順を実行する前に下記を準備して下さい ターゲットボードのジャンパおよびスイッチ設定は 図 3-1 ジャンパ SW 設定 を参照 3.3 章表 1 コネクタ接続を参考に周辺機器を接続 ( 但し ex1 はマイク不要 ) 5 章を参考に USB シリアルドライバをインストール PC 上で ターミナルソフト (3.3 章表 2デバッグシリアルポート設定の設定にすること ) を起動 ターゲットボードの電源を入れる 1. e2studio を起動 2. [ 実行 ] [ デバッグの構成 ] を選択 3. デバッグの構成 ダイアログの Renesas GDB Hardware Debugging リストから 章実行準備で設定したプロジェクト ex1 Hardware Debug [local] を選択 4. [ メイン ] タブ内の プロジェクトの検索 をクリック ビルド方法で作成した <ex1.x> ファイル ( 手順 15: 内蔵 RAM ブートの場合 ) を選択 OK を押下 6. デバッグ をクリック( ターゲットボードと J-Link が接続され バイナリのダウンロードが始まる ウィンドウ右下に表示される ex1 Hardware Debug 起動 : が(100%) になって表示が消えるまで待つ ) 図 3-9 プロジェクト選択画面 R01AN3161JJ0101 Rev.1.01 Page 19 of 37

20 7. パースペクティブ切り替えの確認 ダイアログが出現した場合 はい (Y) を押下 パースペクティブがデバッグになっていなければ ( 画面左上の e2 アイコンの隣が [C-] と表記 ) 下記の操作を行う ウィンドウ (W) パースペクティブを開く (O) デバッグ を選択 8. 実行 (R) メニュー 再開 (M) を選択 ( プログラムカウンタがアプリケーションプログラムの先頭アドレスに移動 ) 9. 再度 実行 (R) メニュー 再開 (M) を選択すると <ex1.x> サンプルが実行 R01AN3161JJ0101 Rev.1.01 Page 20 of 37

21 書き込みと実行 ( シリアルフラッシュブート ) この手順を実行する前に下記を準備して下さい ターゲットボードのジャンパおよびスイッチ設定は 図 3-1 ジャンパ SW 設定 を参照 3.3 章表 1 コネクタ接続を参考に周辺機器を接続 ( 但し ex1 はマイク不要 ) 5 章を参考に USB シリアルドライバをインストール PC 上で ターミナルソフト (3.3 章表 2 デバッグシリアルポート設定の設定にすること ) を起動 ターゲットボードの電源を入れる 1. e2studio を起動 2. [ 実行 ] [ デバッグの構成 ] を選択 3. デバッグの構成 ダイアログの Renesas GDB Hardware Debugging リストから 章実行準備で設定したプロジェクト ex1 Hardware Debug [local] を選択 4. [ メイン ] タブ内の プロジェクトの検索 をクリック ビルド方法で作成した <ex1.x> ファイル ( 手順 15: シリアルフラッシュブートの場合 ) を選択 OK を押下 6. デバッグ をクリック( ターゲットボードと J-Link が接続され バイナリのダウンロードが始まる ウィンドウ右下に表示される ex1 Hardware Debug 起動 : が(100%) になって表示が消えるまで待つ ) 図 3-10 プロジェクト選択画面 R01AN3161JJ0101 Rev.1.01 Page 21 of 37

22 7. パースペクティブがデバッグになっていなければ ( 画面左上の e2 アイコンの隣が [C-] と表記 ) 下記の操作を行う ウィンドウ (W) パースペクティブを開く (O) デバッグ を選択 8. デバッグ ビューの ダウンロード ボタン ( 紫色の枠線内 ) のプルダウンからブートローダの実行ファイル ( 画像では RZ_A1LU_sflash_boot_init_kpitgcc.x ) を選択 ( 実行ファイルのダウンロードが開始される ) 図 3-11 デバッグ ビューのブートローダ選択画面 9. メニューから 実行 (R) 切断 を選択 ( ターゲットと J-Link が切断される ) 10. ターゲットボードの電源を切る 11. ターゲットボードから J-Link のプローブを外して 電源を入れると <ex1.x> サンプルが実行される サンプル実行結果 本章は 内蔵 RAM ブートとシリアルフラッシュブート共通の内容です サンプルが実行開始されると PC のターミナル上に実行結果が出力され J5 に接続したスピーカーから音声 ( 右側から 右 左側から 左 ) が聞こえます (3 回繰り返し ) R01AN3161JJ0101 Rev.1.01 Page 22 of 37

23 3.4.2 手順 (DS-5) ビルド方法 本章は 内蔵 RAM ブートとシリアルフラッシュブート共通の内容です 1 DS-5 のワークスペースを新規作成 ( 1) 1 任意の場所 ( 2) に作業フォルダを作成 ( フォルダ名は任意 ) 2 手順 1 で作成したフォルダ下に展開したソースファイル (BSP ソースフォルダ下のすべてのファイル群 ) をコピー 例 ) 作業フォルダを C: Workspace とした場合のフォルダ構成 C: Workspace CMSIS_RTOS_RTX_A1LU_ARM.project Include BSP ソースフォルダ下のファイル群 RTOS 3 DS-5 を起動 4 [ ファイル ] メニュー [ ワークスペースの切り替え ] [ その他 ] を選択 5 ワークスペース ランチャー ダイアログの 参照 をクリック 6 手順 1 で作成した場所を選択し OK をクリック 7 自動で DS-5 が再起動し ようこそ 画面が表示される 8 ようこそ 画面を閉じる 1: 既存のワークスペースがある場合 既存のワークスペースを流用せず 必ず新規に作成すること 2:Windows のパス名の文字数制限 (260 文字 ) を超えないようにドライブのルートに近い場所に作業フォルダを作成すること 2 [ ウィンドウ ] メニュー [ ビューの表示 ] [ プロジェクト エクスプローラー ] を選択 3 [ プロジェクト エクスプローラー ] を右クリック [ インポート ] を選択 4 インポート ダイアログの インポート ソースの選択 で 一般 既存プロジェクトをワークスペースへ を選択し 次へ ボタンをクリック 5 インポート ダイアログの ルート ディレクトリの選択 をチェックし 参照 をクリック 6 フォルダの参照 ダイアログで ソースファイルのコピー先のトップ ( 手順 1-1 で作成したフォルダ名 ) を選択し OK をクリック 7 インポート ダイアログの ネストしたプロジェクトを検索 のチェックをつける 8 インポート ダイアログの 選択をすべて解除 をクリック 9 プロジェクト 一覧から次の項目のみにチェックを追加 CMSIS_RTOS_RTX_A1LU_ARM DMA_drv ex1 IOIF RIIC_drv R01AN3161JJ0101 Rev.1.01 Page 23 of 37

24 RSPI_drv RTX_CA9_L SOUND_drv SSIF_drv 10 インポート ダイアログの プロジェクトをワークスペースにコピー のチェックを外す 11 インポート ダイアログの 終了 をクリック 12 プロジェクト エクスプローラー の ex1 プロジェクトを選択し 右クリック [ プロパティ ] を選択 13 プロパティ ダイアログの C/C++ Build の Settings を選択 14 Tool Settings タブの ARM リンカ 5 イメージレイアウト を選択 15 スキャッタファイル (--scatter) 欄に下記の通り設定 適用 を押下 OK を押下 ( プロパティウィンドウが閉じる ) 内蔵 RAM ブートの場合 :../scatter.scat シリアルフラッシュブートの場合 :../scatter_sflashboot.scat 16 プロジェクト エクスプローラー の ex1 プロジェクトを選択し 右クリック [Clean Project] を選択 17 プロジェクト エクスプローラー の ex1 プロジェクトを選択し 右クリック [ プロジェクトのビルド ] を選択 次のファイルが生成される RTOS RTX Boards Renesas RZ_A1LU_EV RenesasBSP_example ex1 Debug ex1.axf 実行準備 本章は 内蔵 RAM ブートとシリアルフラッシュブート共通の内容です ビルド方法で作成した <ex1.axf> ファイルを書き込む前に必要な手順を下記に記します この手順を実行する前に ビルド方法 で ex1 サンプルプログラムの < ex1.axf > ファイルを作成してください 1. ULINK2 をターゲットボードおよび PC に接続する 2. DS-5 を起動する 3. [ 実行 ] [ デバッグの構成 (B)...] を選択 図 3-12 デバッグの構成 選択画面 R01AN3161JJ0101 Rev.1.01 Page 24 of 37

25 4. デバッグ構成 ダイアログの DS-5 デバッガ のリストにある ex1-rz_a1lu を選択 5. Connection タブの Select target から Renesas RZ/A1L R7S72100 Bare Metal Debug Debug Cortex-A9 を選択 6. Connection タブの Target Connection から ULINK2 を選択し Connection タブの画面右下 Browse をクリック 7. 接続ブラウザ ダイアログで表示された候補候補 ( 接続台数 1 台の場合 候補は 1 つ ) の中から 該当する接続先を選択し 選択 をクリック 図 3-13 Connection タブ 8. 適用(Y) をクリック 9. 閉じる をクリック R01AN3161JJ0101 Rev.1.01 Page 25 of 37

26 ダウンロードと実行 ( 内蔵 RAM ブート ) この手順を実行する前に下記を準備して下さい ターゲットボードのジャンパおよびスイッチ設定は 図 3-1 ジャンパ SW 設定 を参照 3.3 章表 1 を参考に周辺機器を接続 ( 但し ex1 はマイク不要 ) 5 章を参考に USB シリアルドライバをインストール PC 上で ターミナルソフト (3.3 章表 2の設定にすること ) を起動 ターゲットボードの電源を入れる 1. ターゲットボードにスピーカーを接続し USB/ シリアルケーブルで PC に接続する 2. DS-5 を起動する 3. [ 実行 ] [ デバッグの構成 (B)...] を選択 4. デバッグ構成 ダイアログの DS-5 デバッガ のリストにある ex1-rz_a1lu を選択し 画面下の デバッグ (D) をクリック ( ターゲットと ULINK2 が接続され 実行ファイルのダウンロードが始まります ) 図 3-14 プロジェクト選択画面 5. パースペクティブ切り替えの確認 ダイアログが出現した場合 はい(Y) を押下 6. 続行 ボタン( 緑色の再生マーク ) をクリックし サンプルを実行開始する R01AN3161JJ0101 Rev.1.01 Page 26 of 37

27 書き込みと実行 ( シリアルフラッシュブート ) この手順を実行する前に下記を準備して下さい ターゲットボードのジャンパおよびスイッチ設定は 図 3-1 ジャンパ SW 設定 を参照 3.3 章表 1 を参考に周辺機器を接続 ( 但し ex1 はマイク不要 ) 5 章を参考に USB シリアルドライバをインストール PC 上で ターミナルソフト (3.3 章表 2 の設定にすること ) を起動 PARTNER をセットアップし プロジェクトを作成する (PARTNER のセットアップ後 新しいプロジェクトを作成する際 ( 本パッケージの Top) Software PARTNER_CFG ディレクトリ以下のファイルを使用してください ex1 サンプルの実行ファイルを作成 ( ビルド方法 参照 ) しておくこと 1 PARTNER の JTAG プローブをターゲットボードの J17 に接続し PC と PARTNER を USB ケーブルで接続し ターゲットボードの電源を投入 その後 PARTNER の電源を投入する 2 PC 上で あらかじめ作成した PARTNER のプロジェクトを起動 3 以下の手順でシリアルフラッシュブートローダの実行ファイルをダウンロードする [ ファイル ] メニュー [ ロード (L)] を選択する ( ファイルを開く ウィンドウが表示される ) CMSIS_RTOS_RTX_A1LU_ARM RTOS RTX Boards Renesas RZ_A1LU_EV RenesasBSP_example ex1 FlashImage フォルダ内の RZ_A1LU_sflash_boot_init_armcc.axf を選択し 開く を押下 ( ターゲットボードと PARTNER が接続され バイナリのダウンロードが始まる ) [ 実行 ] メニュー [CPU リセット (R)] を押下 [ ファイル ] メニュー [ ロード (L)] を選択する ビルド方法 で作成した ex1.axf を選択し 開く を押下 4 ファイル メニュー 終了 ( ターゲットボードと PARTNER が切断される ) 5 ターゲットボードと PARTNER の電源を切り ターゲットボードの J17 から JTAG プローブを外す 6 ターゲットボードの J5 にスピーカーを接続し J14 を USB シリアルケーブルで PC に接続 7 ターゲットボードの電源を入れる ( 項目 3 でダウンロードしたプログラムが動作開始します ) サンプル実行結果 本章は 内蔵 RAM ブートとシリアルフラッシュブート共通の内容です サンプルが実行開始されると PC のターミナル上に実行結果が出力され J5 に接続したスピーカーから音声 ( 右側から 右 左側から 左 ) が聞こえます (3 回繰り返し ) R01AN3161JJ0101 Rev.1.01 Page 27 of 37

28 3.4.3 手順 (EWARM) ビルド方法 本章は 内蔵 RAM ブートとシリアルフラッシュブート共通の内容です 1 IAR のワークスペースを新規作成 ( 1) 1 任意の場所 ( 2) に作業フォルダを作成 ( フォルダ名は任意 ) 2 手順 1 で作成したフォルダ下に展開したソースファイル (BSP ソースフォルダ下のすべてのファイル群 ) をコピー 例 ) 作業フォルダを C: Workspace とした場合のフォルダ構成 C: Workspace CMSIS_RTOS_RTX _A1LU_ICCARM CMSIS_RTOS_RTX_BSP.eww IAR Include BSP ソースフォルダ下のファイル群 RTOS 3 CMSIS_RTOS_RTX_BSP.eww を開く 1: 既存のワークスペースがある場合 既存のワークスペースを流用せず 必ず新規に作成すること 2:Windows のパス名の文字数制限 (260 文字 ) を超えないようにドライブのルートに近い場所に作業フォルダを作成すること 2 各プロジェクトをそれぞれ右クリック オプション 一般オプション ターゲット プロセッサ選択 でデバイスにチェックを入れ デバイス選択ボタンを押し Renesas RZ/A1 Renesas R7S を選択 図 3-15 デバイス選択画面 R01AN3161JJ0101 Rev.1.01 Page 28 of 37

29 3 次のプロジェクトをそれぞれ右クリック すべてを再ビルド (B) を選択 DMA IOIF RIIC RSPI RTX_CA9_Library SOUND SSIF 4 ex1 サンプルプロジェクトをビルドする 内蔵 RAM ブートの場合 : ex1_ram を右クリック すべてを再ビルド (B) を選択 シリアルフラッシュブートの場合 : ex1_sflash を右クリック すべてを再ビルド (B) を選択 5 次のファイルが生成される 内蔵 RAM ブートの場合 : CMSIS_RTOS_RTX_A1LU_ICCARM IAR RenesasBSP_example ex1_ram Debug Exe ex1_ram.out シリアルフラッシュブートの場合 : CMSIS_RTOS_RTX_A1LU_ICCARM IAR RenesasBSP_example ex1_sflash Debug Exe ex1_sflash.out R01AN3161JJ0101 Rev.1.01 Page 29 of 37

30 ダウンロードと実行 ( 内蔵 RAM ブート ) この手順を実行する前に下記を準備して下さい ターゲットボードのジャンパおよびスイッチ設定は 図 3-1 ジャンパ SW 設定 を参照 3.3 章表 1 を参考に周辺機器を接続 ( 但し ex1 はマイク不要 ) ex1 サンプルの実行ファイルを作成 ( ビルド方法 参照) しておくこと 5 章を参考に USB シリアルドライバをインストール PC 上で ターミナルソフト (3.3 章表 2の設定にすること ) を起動 ターゲットボードの電源を入れる 1. I-jet をターゲットボードおよび PC に接続する 2. ターゲットボードの J5 にスピーカーを接続し J14 を USB シリアルケーブルで PC に接続 の手順で Embedded Workbench のワークスペースを開く 4. ワークスペースウィンドウの下部にある ex1_ram ボタンを選択 図 3-16 ワークスペース画面 5. [ プロジェクト ] メニューの [ ダウンロードしてデバッグ ] を選択 ( ターゲットボードと I-jet が接続され 実行ファイルのダウンロードが始まる ) 6. [ デバッグ ] メニューの [ 実行 ] を選択 R01AN3161JJ0101 Rev.1.01 Page 30 of 37

31 書き込みと実行 ( シリアルフラッシュブート ) この手順を実行する前に下記を準備して下さい ターゲットボードのジャンパおよびスイッチ設定は 図 3-1 ジャンパ SW 設定 を参照 3.3 章表 1 を参考に周辺機器を接続 ( 但し ex1 はマイク不要 ) ex1 サンプルの実行ファイルを作成 ( ビルド方法 参照) しておくこと 5 章を参考に USB シリアルドライバをインストール PC 上で ターミナルソフト (3.3 章表 2の設定にすること ) を起動 1. I-jet をターゲットボードおよび PC に接続する 2. ターゲットボードの J5 にスピーカーを接続し J14 を USB シリアルケーブルで PC に接続 の手順で Embedded Workbench のワークスペースを開く 4. ワークスペースウィンドウの下部にある ex1_sflash ボタンを選択 5. ワークスペースの [ex1_sflash-debug] 上で右クリック [ オプション ] を選択 図 3-17 ワークスペース画面 R01AN3161JJ0101 Rev.1.01 Page 31 of 37

32 6. カテゴリ デバッガ を選択 設定 タブ セットアップマクロ マクロファイルの使用にチェックを入れ 1 つ下の欄に下記の内容を追記 $TOOLKIT_DIR$ config flashloader Renesas FlashRZA1Jasmine_SPI.mac 図 3-18 デバッガ -> 設定画面 7. [ ダウンロード ] タブを選択 フラッシュローダを使用する にチェック デフォルトの board ファイルのオーバーライド にチェック 1 つ下の欄に下記の内容を追記し OK ボタン押す $TOOLKIT_DIR$ config flashloader Renesas FlashRZA1Jasmine_SPI.board 図 3-19 デバッガ -> ダウンロード画面 R01AN3161JJ0101 Rev.1.01 Page 32 of 37

33 8. シリアルフラッシュブートローダの実行ファイルをダウンロードする EWARM のメニューから プロジェクト (P) ダウンロード (W ファイルのダウンロード...(o) を選択し フォルダ [~ RenesasBSP_example FlashImage] を参照し シリアルフラッシュブートローダの実行ファイル RZ_A1LU_sflash_boot_init.out をダウンロードする 図 3-20 プロジェクトプルダウンメニュー画面 図 3-21 ファイルのダウンロード画面 9. サンプルプログラムの実行ファイルをダウンロードする EWARM のメニューから プロジェクト (P) ダウンロード (W アクティブなアプリケーションのダウンロード (D) を選択すると 章の手順 5 で作成した ex1_sflash.out のダウンロードが始まる サンプル実行結果 本章は 内蔵 RAM ブートとシリアルフラッシュブート共通の内容です サンプルが実行開始されると PC のターミナル上に実行結果が出力され J5 に接続したスピーカーから音声 ( 右側から 右 左側から 左 ) が聞こえます (3 回繰り返し ) R01AN3161JJ0101 Rev.1.01 Page 33 of 37

34 4. KPIT GCC optlib ライブラリ用追加ヘッダファイルについて 本 BSP のビルドには KPIT 社製 GNU Tools GNUARM-NONE の optlib ライブラリを使用します BSP のビルドを実施する前に GNUARM-NONE の optlibinc ディレクトリ以下に追加ヘッダファイルをコピーする必要があります ここでは KPIT GNU Tools GNUARM-NONE v16.01 を C: Program Files KPIT GNUARM-NONEv16.01-EABI にインストールしていることを前提とします 異なるディレクトリにインストールしている場合は 適宜読み替えて下さい コピー元フォルダ : ( 本パッケージの Top) Software KPIT optlibinc 以下の全てのファイル コピー先フォルダ : C: Program Files KPIT GNUARM-NONEv16.01-EABI arm-none-eabi arm-none-eabi arm-none-eabi optlibinc 5. USB シリアル変換 IC 用ドライバについて ターゲットボードの J14 と PC を USB シリアルケーブルで接続しターゲットボードの電源を投入後 ドライバのインストールが行われます その際 ( 本パッケージの Top) Software LU_USB_DRV ディレクトリ以下のファイルを使用してください その後 表 2 デバッグシリアルポート設定 ) の設定でターミナルを立ち上げて下さい R01AN3161JJ0101 Rev.1.01 Page 34 of 37

35 6. 制限事項 No. 種別 1 標準 C ライブラリ 内容 KPIT GNU Tools GNUARM-NONE の標準 C ライブラリはマルチスレッドに非対応です ライブラリ関数を複数スレッドから同時に実行した場合 処理結果は不定です malloc や calloc や realloc などのヒープを操作するライブラリ関数を使用する場合は スレッド切替えを防止するために割り込み禁止の状態で実行してください R01AN3161JJ0101 Rev.1.01 Page 35 of 37

36 7. 注意事項 No. 種別 1 Kernel_HW 依存部 内容 デバッグシリアルポート (printf の出力先 ) と SCIF ドライバのチャネル 0 が同じポートを使用しています チャネル 0 をオープンすると競合が発生するのでご注意ください 2 SCUX,SSIF SCUX ドライバで出力先として設定した SSIF のチャネルを SSIF ドライバでオープ ンすると競合が発生するので 排他使用してください R01AN3161JJ0101 Rev.1.01 Page 36 of 37

37 ホームページとサポート窓口 ルネサスエレクトロニクスホームページ お問合せ先 すべての商標および登録商標は, それぞれの所有者に帰属します R01AN3161JJ0101 Rev.1.01 Page 37 of 37

38 改訂記録 Rev. 発行日 ページ 新規作成 改訂内容 ポイント 1.2 章ドキュメント更新したドキュメントの版数を変更 3.2 章ツール情報統合開発環境等のバージョンを修正図 3 3 Debugger タブデバイスの型番を変更 章 EWARM での書き込み方法に修正

39 製品ご使用上の注意事項 ここでは マイコン製品全体に適用する 使用上の注意事項 について説明します 個別の使用上の注意 事項については 本ドキュメントおよびテクニカルアップデートを参照してください 1. 未使用端子の処理 注意 未使用端子は 本文の 未使用端子の処理 に従って処理してください CMOS 製品の入力端子のインピーダンスは 一般に ハイインピーダンスとなっています 未使用端子を開放状態で動作させると 誘導現象により LSI 周辺のノイズが印加され LSI 内部で貫通電流が流れたり 入力信号と認識されて誤動作を起こす恐れがあります 未使用端子は 本文 未使用端子の処理 で説明する指示に従い処理してください 2. 電源投入時の処置 注意 電源投入時は, 製品の状態は不定です 電源投入時には LSI の内部回路の状態は不確定であり レジスタの設定や各端子の状態は不定です 外部リセット端子でリセットする製品の場合 電源投入からリセットが有効になるまでの期間 端子の状態は保証できません 同様に 内蔵パワーオンリセット機能を使用してリセットする製品の場合 電源投入からリセットのかかる一定電圧に達するまでの期間 端子の状態は保証できません 3. リザーブアドレス ( 予約領域 ) のアクセス禁止 注意 リザーブアドレス( 予約領域 ) のアクセスを禁止します アドレス領域には 将来の機能拡張用に割り付けられているリザーブアドレス ( 予約領域 ) があります これらのアドレスをアクセスしたときの動作については 保証できませんので アクセスしないようにしてください 4. クロックについて 注意 リセット時は クロックが安定した後 リセットを解除してください プログラム実行中のクロック切り替え時は 切り替え先クロックが安定した後に切り替えてください リセット時 外部発振子 ( または外部発振回路 ) を用いたクロックで動作を開始するシステムでは クロックが十分安定した後 リセットを解除してください また プログラムの途中で外部発振子 ( または外部発振回路 ) を用いたクロックに切り替える場合は 切り替え先のクロックが十分安定してから切り替えてください 5. 製品間の相違について 注意 型名の異なる製品に変更する場合は 製品型名ごとにシステム評価試験を実施してください 同じグループのマイコンでも型名が違うと 内部 ROM レイアウトパターンの相違などにより 電気的特性の範囲で 特性値 動作マージン ノイズ耐量 ノイズ輻射量などが異なる場合があります 型名が違う製品に変更する場合は 個々の製品ごとにシステム評価試験を実施してください

40 ご注意書き 1. 本資料に記載された回路 ソフトウェアおよびこれらに関連する情報は 半導体製品の動作例 応用例を説明するものです お客様の機器 システムの設計において 回路 ソフトウェアおよびこれらに関連する情報を使用する場合には お客様の責任において行ってください これらの使用に起因して お客様または第三者に生じた損害に関し 当社は 一切その責任を負いません 2. 本資料に記載されている情報は 正確を期すため慎重に作成したものですが 誤りがないことを保証するものではありません 万一 本資料に記載されている情報の誤りに起因する損害がお客様に生じた場合においても 当社は 一切その責任を負いません 3. 本資料に記載された製品デ-タ 図 表 プログラム アルゴリズム 応用回路例等の情報の使用に起因して発生した第三者の特許権 著作権その他の知的財産権に対する侵害に関し 当社は 何らの責任を負うものではありません 当社は 本資料に基づき当社または第三者の特許権 著作権その他の知的財産権を何ら許諾するものではありません 4. 当社製品を改造 改変 複製等しないでください かかる改造 改変 複製等により生じた損害に関し 当社は 一切その責任を負いません 5. 当社は 当社製品の品質水準を 標準水準 および 高品質水準 に分類しており 各品質水準は 以下に示す用途に製品が使用されることを意図しております 標準水準 : コンピュータ OA 機器 通信機器 計測機器 AV 機器 家電 工作機械 パーソナル機器 産業用ロボット等高品質水準 : 輸送機器 ( 自動車 電車 船舶等 ) 交通用信号機器 防災 防犯装置 各種安全装置等当社製品は 直接生命 身体に危害を及ぼす可能性のある機器 システム ( 生命維持装置 人体に埋め込み使用するもの等 ) もしくは多大な物的損害を発生させるおそれのある機器 システム ( 原子力制御システム 軍事機器等 ) に使用されることを意図しておらず 使用することはできません たとえ 意図しない用途に当社製品を使用したことによりお客様または第三者に損害が生じても 当社は一切その責任を負いません なお ご不明点がある場合は 当社営業にお問い合わせください 6. 当社製品をご使用の際は 当社が指定する最大定格 動作電源電圧範囲 放熱特性 実装条件その他の保証範囲内でご使用ください 当社保証範囲を超えて当社製品をご使用された場合の故障および事故につきましては 当社は 一切その責任を負いません 7. 当社は 当社製品の品質および信頼性の向上に努めていますが 半導体製品はある確率で故障が発生したり 使用条件によっては誤動作したりする場合があります また 当社製品は耐放射線設計については行っておりません 当社製品の故障または誤動作が生じた場合も 人身事故 火災事故 社会的損害等を生じさせないよう お客様の責任において 冗長設計 延焼対策設計 誤動作防止設計等の安全設計およびエージング処理等 お客様の機器 システムとしての出荷保証を行ってください 特に マイコンソフトウェアは 単独での検証は困難なため お客様の機器 システムとしての安全検証をお客様の責任で行ってください 8. 当社製品の環境適合性等の詳細につきましては 製品個別に必ず当社営業窓口までお問合せください ご使用に際しては 特定の物質の含有 使用を規制する RoHS 指令等 適用される環境関連法令を十分調査のうえ かかる法令に適合するようご使用ください お客様がかかる法令を遵守しないことにより生じた損害に関して 当社は 一切その責任を負いません 9. 本資料に記載されている当社製品および技術を国内外の法令および規則により製造 使用 販売を禁止されている機器 システムに使用することはできません また 当社製品および技術を大量破壊兵器の開発等の目的 軍事利用の目的その他軍事用途に使用しないでください 当社製品または技術を輸出する場合は 外国為替及び外国貿易法 その他輸出関連法令を遵守し かかる法令の定めるところにより必要な手続を行ってください 10. お客様の転売等により 本ご注意書き記載の諸条件に抵触して当社製品が使用され その使用から損害が生じた場合 当社は何らの責任も負わず お客様にてご負担して頂きますのでご了承ください 11. 本資料の全部または一部を当社の文書による事前の承諾を得ることなく転載または複製することを禁じます 注 1. 本資料において使用されている 当社 とは ルネサスエレクトロニクス株式会社およびルネサスエレクトロニクス株式会社がその総株主の議決権の過半数を直接または間接に保有する会社をいいます 注 2. 本資料において使用されている 当社製品 とは 注 1において定義された当社の開発 製造製品をいいます 営業お問合せ窓口 営業お問合せ窓口の住所は変更になることがあります 最新情報につきましては 弊社ホームページをご覧ください ルネサスエレクトロニクス株式会社 東京都江東区豊洲 ( 豊洲フォレシア ) 技術的なお問合せおよび資料のご請求は下記へどうぞ 総合お問合せ窓口 : Renesas Electronics Corporation. All rights reserved. Colophon 4.0