6. サンプルコードの説明
6.1 サンプルコードの使用手順
R01AN1978JJ0081 Rev.0.81 Page 36 of 46 2016.09.16
6.1.1 GENMAI
ボードの設定ダウンローダを実行させる前にGENMAIボードの設定が必要です。表6.1に GENMAIボードのジャンパ設
定を、表6.2にGENMAIボードのディップスイッチ設定を示します。
表6.1 GENMAIボードのジャンパ設定
ジャンパ 設定 内容
JP5 1-2 P7_0をMD_BOOT2端子として使用
表6.2 GENMAIボードのディップスイッチ設定
ディップスイッチ 設定 内容
SW1-1 OFF MD_BOOT0=Hレベル
SW1-2 OFF MD_BOOT1=Hレベル
SW1-3 OFF MD_BOOT2=Hレベル
SW1-4 ON MD_CLK=Lレベル
SW1-5 ON MD_CLKS=Lレベル
6.1.2 DS-5
スクリプトのコピーDS-5ワークスペース直下（例：C:¥DS-5_Workspace）に[script]フォルダを作成した後、DS-5スクリプトで あるinit_RZ_A1H.ds、init_RZ_A1H2.ds、RZ_A1H_emmc_boot_init_armcc.ds、
RZ_A1H_emmc_boot_sample_armcc.dsを作成した[script]フォルダにコピーしてください。
表6.3に使用するDS-5スクリプトファイル一覧を示します。
表6.3 使用するDS-5スクリプトファイル一覧
DS-5スクリプトファイル名 説明
init_RZ_A1H.ds GENMAIボード初期化スクリプトです。
ULINK2とGENMAIボードを接続した際に、RZ/A1H大容量内蔵
RAMの書き込みを許可する等の処理を実行するDS-5スクリプ トです。
init_RZ_A1H2.ds ダウンロードスクリプトから実行されるGENMAIボード初期
化スクリプトです。DS-5メモリ領域設定を行わない以外は、
init_RZ-A1H.dsと同じです。
RZ_A1H_emmc_boot_loader_armcc.ds ローダプログラムを書き込む時にダウンローダを起動するため
に使用するDS-5スクリプトです。
RZ_A1H_emmc_boot_sample_armcc.ds アプリケーションプログラムを書き込む時にダウンローダを起
動するために使用するDS-5スクリプトです。
R01AN1978JJ0081 Rev.0.81 Page 38 of 46 2016.09.16
6.1.3
プロジェクトのインポートおよびビルド表6.4にプロジェクト一覧を示します。各プロジェクトのデータをDS-5ワークスペース直下（例：
C:¥DS-5_Workspace）にコピーした後、DS-5に各プロジェクトをインポートしてください。インポート後、
各プロジェクトのビルドし、実行形式ファイルを生成してください。
表6.4 プロジェクト一覧
プロジェクト名 説明 生成される実行可能ファイル
(*.axf)
RZ_A1H_fmtool_emmc このプロジェクトでダウンローダをビ
ルドします。このプロジェクトをダウ ンローダプロジェクトと呼びます。
RZ_A1H_fmtool_emmc.axf
RZ_A1H_emmc_boot_loader_
armcc
このプロジェクトでローダプログラム をビルドします。このプロジェクトを ローダプログラムプロジェクトと呼び ます。
RZ_A1H_emmc_boot_loader_ar mcc.axf
RZ_A1H_emmc_boot_sample _armcc
このプロジェクトでアプリケーション プログラムをビルドします。このプロ ジェクトをアプリケーションプロジェ クトと呼びます。
RZ_A1H_emmc_boot_sample_a rmcc.axf
6.1.4
実行可能ファイルからバイナリファイルへのデータ変換本アプリケーションノートで説明するダウンローダは、バイナリファイルのプログラム書き込みのみをサ ポートしています。実行可能ファイル(*.axf)のプログラム書き込みはサポートしていないため、ビルドにより 生成されたローダプログラムとアプリケーションプログラムの実行可能ファイル(*.axf)をバイナリファイル に変換する必要があります。DS-5に付属しているユーティリティであるfromelfを使用して、このファイル 変換を行います。サンプルコードのプロジェクト（RZ_A1H_emmc_boot_loader_armcc、
RZ_A1H_emmc_boot_sample_armcc）では、ビルド後に図6.2の内容のバッチファイルが実行され、自動的に 実行可能ファイルからバイナリファイルが生成されるように設定しています。
fromelf --bin -- output=%1.bin %1.axf
入力ファイル名 出力ファイル名
・ "%1"はプロジェクト名を意味します。
図6.2 ビルド後に実行されるバッチファイル（after_build.bat）の内容
表6.5にfromelfにより生成されたバイナリファイルを示します。
表6.5 fromelfにより生成されたバイナリファイル
実行形式ファイル バイナリファイル
RZ_A1H_emmc_boot_loader_armcc.axf
（ローダプログラムの実行可能ファイル）
RZ_A1H_emmc_boot_loader_armcc.bin RZ_A1H_emmc_boot_sample.axf
（アプリケーションプログラムの実行可能ファイル）
CONST_DL_TABLE VECTOR_TABLE
VECTOR_MIRROR_TABLE RESET_HANDLER
6.1.5
ダウンローダ実行形式ファイルのコピーDS-5ワークスペース直下（例：C:¥DS-5_Workspace）に[fmtool]フォルダを作成し、ダウンローダの実行形 式ファイル（RZ_A1H_fmtool_emmc.axf）をコピーしてください。
6.1.6 DS-5
デバッグ構成の設定以下の手順にて、DS-5の「デバッグ構成」を設定してください。DS-5デバッグ構成の設定にて、ULINK2 とGENMAIボードを接続した際にGENMAIボード初期化スクリプト（init_RZ-A1H.ds）が実行されるように 設定します。なお、GENMAIボード初期化スクリプト（init_RZ-A1H.ds）の処理内容については、「6.2 GENMAI ボード初期化スクリプト」を参照してください。
【手順】
1. DS-5の［デバッグコンフィギュレーション］メニューより、［デバッグ構成］画面を表示します。
2. DS-5の［デバッグ構成］画面の［接続］タブにて、ターゲットを選択します。ターゲットは、［Renesas］
/［RZ/A1H R7S721001］/［Bare Metal Debug］/［Debug Cortex-A9］を選択し、任意の接続名称を［名前（N）］
に設定します。
3. DS-5の［デバッグ構成］画面の［デバッガ］タブにて、実行制御の［接続のみ］にチェックを入れます。
4. DS-5の［デバッグ構成］画面の［デバッガ］タブにて、実行制御の［ターゲット初期化デバッガスクリ
プト（.ds / .py）を実行します］にチェックを入れ、GENMAIボード初期化スクリプト（init_RZ-A1H.ds）
のPATHを設定します。
6.1.7 ARM
社製エミュレータULINK2
とGENMAIボードとの接続以下の手順にて、ARM社製エミュレータULINK2とGENMAIボードとの接続を行います。
【手順】
1. DS-5の［Debug Control］タブより、「6.1.6 DS-5 デバッグ構成の設定」の手順2.で設定した名称の接続 を選択し、右クリックより［Connect to Target］を選択します。
2. 1.より、「6.1.6 DS-5 デバッグ構成の設定」の手順4.で登録したGENMAIボード初期化スクリプト
（init_RZ-A1H.ds）が実行された後、GENMAIボードとのエミュレータ接続が確立され、ダウンローダが 実行可能な状態となります。
R01AN1978JJ0081 Rev.0.81 Page 40 of 46 2016.09.16
6.1.8
ダウンロードスクリプトの実行以下の手順にて、ダウンロードスクリプト（RZ_A1H_emmc_boot_loader_armcc.ds、または、
RZ_A1H_emmc_boot_sample_armcc.ds）を実行することにより、eMMCダウンローダが起動して、eMMCデバ イスに対してプログラム書き込み処理が実行されます。
【手順】
1. DS-5の［スクリプト］タブにダウンロードスクリプト（RZ_A1H_emmc_boot_loader_armcc.ds、
RZ_A1H_emmc_boot_sample_armcc.ds）を登録します。
2. 1.で登録したダウンロードスクリプト（RZ_A1H_emmc_boot_loader_armcc.ds、または、
RZ_A1H_emmc_boot_sample_armcc.ds）をダブルクリックし、ダウンロードスクリプトを実行します。
3. ダウンロードスクリプトを実行すると、ダウンローダが実行され、DS-5の［アプリケーションコンソー ル］上に図6.3に示すメッセージが表示され、eMMCデバイスへの書き込みを開始します。
図6.3 ダウンローダ実行時にDS-5 アプリケーションコンソールに表示されるメッセージ