アプリケーションノート

Alpha Project Co., Ltd.

AN1637

RZ/A1H CPU BOARD
サンプルプログラム解説
第 1.1 版 2023 年 10 月 02 日
Fig1.2-1 動作モード設定
１版 ２０１１年０６月０６日

1.

JSW3

概要

Fig1.2-1 動作モード設定
１版 ２０１１年０６月０６日

1.1 概要本アプリケーションノートでは、AP-RZA-0A、AP-RZA-1A に付属するサンプルプログラムについて解説します。
解説するサンプルプログラムは下記のものになります。
以降の説明では CPU ボードを AP-RZA-0A を使用するものとして記述します。AP-RZA-1A をご使用の際は CPU ボード名を適宜読み替えてご使用ください。

サンプルプログラム
UART サンプルプログラム

動作内容
・UART 動作 エコーバック
・CMT 動作 LED の点滅

USB HOST サンプルプログラム

・USB HOST 動作 ファイル書き込み(※AP-RZA-0A のみ)

USB FUNCTION サンプルプログラム

・USB FUNCTION 動作 仮想 COM 通信

Ether サンプルプログラム

・TCP 通信 エコーバック

AN1637 RZ/A1H
サンプルプログラム解説©2023 Alpha Project Co., Ltd.

1

https://www.apnet.co.jp

アプリケーションノート

Alpha Project Co., Ltd.

AN16371.2 接続概要
1.2.1

UART サンプルプログラムの接続概要「UART サンプルプログラム」の動作を確認する上で必要な CPU ボードとホスト PC 間の接続例を以下に示します。
詳細な接続に関しては後述の「３．動作説明」を参照してください。

安定化電源など
DC+5V
AP-RZA-0A
電源ハーネス（付属）

PC-USB-04

1.2.2

A-B USB ケーブル

ホスト PCUSB HOST サンプルプログラムの接続概要「USB HOST サンプルプログラム」の動作を確認する上で必要な CPU ボードとホスト PC 間の接続例を以下に示します。
詳細な接続に関しては後述の「３．動作説明」を参照してください。

安定化電源など
DC+5V
AP-RZA-0A
電源ハーネス（付属）USB メモリ

AN1637 RZ/A1H
サンプルプログラム解説©2023 Alpha Project Co., Ltd.

2https://www.apnet.co.jp

アプリケーションノート
1.2.3

Alpha Project Co., Ltd.

AN1637

USB FUNCTION サンプルプログラムの接続概要「USB FUNCTION サンプルプログラム」の動作を確認する上で必要な CPU ボードとホスト PC 間の接続例を以下に示します。
詳細な接続に関しては後述の「３．動作説明」を参照してください。

AP-RZA-0A
電源ハーネス（付属）USB ケーブル

ホスト PC

1.2.4

Ether サンプルプログラムの接続概要「Ether サンプルプログラム」の動作を確認する上で必要な CPU ボードとホスト PC 間の接続例を以下に示します。
詳細な接続に関しては後述の「３．動作説明」を参照してください。

安定化電源など
DC+5V
AP-RZA-0A
電源ハーネス（付属）LAN クロスケーブル

ホスト PCAN1637 RZ/A1H
サンプルプログラム解説©2023 Alpha Project Co., Ltd.

3https://www.apnet.co.jp

アプリケーションノート

Alpha Project Co., Ltd.

AN1637

1.3 本サンプルプログラムについて

本サンプルプログラムは、ルネサス エレクトロニクス株式会社提供のミドルウェアおよびドライバを AP-RZA-0A に移植しています。
各ミドルウェアおよびドライバの詳細については、以下の資料を参照してください。
入手につきましては、ルネサス社ウェブサイトの下記のページにて、検索を行ってください。

ルネサス エレクトロニクス社 RZ/A1H サンプルコード
https://www.renesas.com/jp/ja/products/microcontrollers-microprocessors/rz-cortex-a-mpus/rza1h-high-endfull-featured-microprocessors-arm-cortex-a9-core-running-400mhz-and-10mb-chip-sram#documents

ルネサス エレクトロニクス社 USB ドライバサンプルコード
https://www.renesas.com/jp/ja/software-tool/usb-drivers

RZ/1A ソフトウェア開発キット(SDK for Camera)https://www.renesas.com/jp/ja/software-tool/rza1-software-development-kit-sdk-camera-cmsis-rtos-rtx●USB Driver

・資料名
RZA1H グループ

USB Host and Peripheral Interface Driver

機能名称：USB<r01an3291●Rev 1.20>

USB HMSC

・資料名
RZA1H グループ

USB Host Mass Storage Class Driver (HMSC)

機能名称：USB Host●

<r01an3292

Rev 1.10>

USB PCDC

・資料名
RZA1H グループ

USB Peripheral Communications Device Class Driver (PCDC)

機能名称：USB Peripheral●<r01an3429 Rev 1.10>

ネットワーク通信

・資料名
RZ/A1Hグループ
機能名称：Ethernet

RZ/A1 Framework V2.12< r01an3638xx0212-rza1-fwp Rev 1.20> ※Ethernet 機能を抜粋（※）資料をダウンロードする際にはルネサス エレクトロニクス株式会社の My Renesas への登録が必要となります。

AN1637 RZ/A1H
サンプルプログラム解説©2023 Alpha Project Co., Ltd.

4https://www.apnet.co.jp

アプリケーションノート

Alpha Project Co., Ltd.

AN1637

1.4 開発環境について

本サンプルプログラムは、以下の開発環境を用いて開発されています。
本サンプルプログラムに対応する開発環境、コンパイラのバージョンは次の通りです。

e2studio 開発環境
ソフトウェアバージョン

備考

e2studio

2020-07－

GCC for Renesas RZ

6.3.1.20170620－

1.5 ワークスペースについて
本サンプルプログラムのプロジェクトファイルは次のフォルダに格納されています。
ご使用のワークスペースにコピーして使用してください。

サンプルプログラム

フォルダ

UART サンプルプログラム\Sample\ap_rza_0a_uart_sample

プロジェクトフォルダ
USB HOST サンプルプログラム\Sample\ap_rza_0a_usb_hmsc_sample

プロジェクトフォルダ
USB FUNCTION サンプルプログラム\Sample\ap_rza_0a_usb_pcdc_sample

プロジェクトフォルダ
Ether サンプルプログラム\Sample\ap_rza_0a_ether_sample

プロジェクトフォルダ

AN1637 RZ/A1H
サンプルプログラム解説©2023 Alpha Project Co., Ltd.

5

https://www.apnet.co.jp

アプリケーションノート

2.

Alpha Project Co., Ltd.

AN1637

サンプルプログラムの構成

2.1 フォルダ構成
2.1.1

サンプルプログラムのフォルダ構成

UART サンプルプログラムは下記のようなフォルダ構成になっています。

\ Sample

AP-RZA-0A サンプルプログラムフォルダ\ ap_rza_0a_uart_sample\ src

環境依存ソースファイル格納フォルダ\ asm

アセンブラソースファイル格納フォルダ\ inc

環境依存部分ヘッダファイル格納フォルダ\ commonソースフォルダ\ src

ボード存部分ヘッダファイル格納フォルダ\ board_settings

ハードウェア依存ソースファイル格納フォルダ\ common_settings

共通ファイル格納フォルダ\ drivers

ドライバソースファイル格納フォルダbsc

バスステートコントローラドライバ格納フォルダ

intc

割込み制御ドライバ格納フォルダ

ostm

OS タイマドライバ格納フォルダ

scif_uart

SCIF ドライバ格納フォルダ\ samples\ inc

サンプルプログラム格納フォルダ
ヘッダファイル格納フォルダ\ linker_setting

リンカスクリプトファイル格納フォルダ\ Debug

デバッグビルド用フォルダ\ Release

リリースビルド用フォルダ

AN1637 RZ/A1H
サンプルプログラム解説©2023 Alpha Project Co., Ltd.

UART サンプルプログラムフォルダ

6

https://www.apnet.co.jp

アプリケーションノート
2.1.2

Alpha Project Co., Ltd.

AN1637

USB HOST サンプルプログラムのフォルダ構成

USB HOST サンプルプログラムは下記のようなフォルダ構成になっています。

\ Sample

AP-RZA-0A サンプルプログラムフォルダ\ ap_rza_0a_usb_hmsc\ src

環境依存ソースファイル格納フォルダ\ asm

アセンブラソースファイル格納フォルダ\ inc

環境依存部分ヘッダファイル格納フォルダ\ commonソースフォルダ\ src

ボード存部分ヘッダファイル格納フォルダ\ board_settings

ハードウェア依存ソースファイル格納フォルダ\ common_settings

共通ファイル格納フォルダ\ drivers

ドライバソースファイル格納フォルダ

bsc

バスステートコントローラドライバ格納フォルダ

intc

割込み制御ドライバ格納フォルダ

ostm

OS タイマドライバ格納フォルダ

scif_uart

SCIF ドライバ格納フォルダ

usb

USB ドライバ格納フォルダ\ samples\ inc

サンプルプログラム格納フォルダ
ヘッダファイル格納フォルダ\ linker_script_file

リンカスクリプトファイル格納フォルダ\ Debug

デバッグビルド用フォルダ\ Release

リリースビルド用フォルダ

AN1637 RZ/A1H
サンプルプログラム解説©2023 Alpha Project Co., Ltd.

USB Host MSC サンプルプログラムフォルダ

7

https://www.apnet.co.jp

アプリケーションノート
2.1.3

Alpha Project Co., Ltd.

AN1637

USB FUNCTION サンプルプログラムのフォルダ構成

USB FUNCTION サンプルプログラムは下記のようなフォルダ構成になっています。

\ Sample

AP-RZA-0A サンプルプログラムフォルダ\ ap_rza_0a_usb_pcdc_sample\ src

環境依存ソースファイル格納フォルダ\ asm

アセンブラソースファイル格納フォルダ\ inc

環境依存部分ヘッダファイル格納フォルダ\ common

ソースフォルダ\ src

ボード存部分ヘッダファイル格納フォルダ\ board_settings

ハードウェア依存ソースファイル格納フォルダ\ common_settings

共通ファイル格納フォルダ\ drivers

ドライバソースファイル格納フォルダ

bsc

バスステートコントローラドライバ格納フォルダ

intc

割込み制御ドライバ格納フォルダ

ostm

OS タイマドライバ格納フォルダ

scif_uart

SCIF ドライバ格納フォルダ

usb

USB ドライバ格納フォルダ\ samples\ inc

サンプルプログラム格納フォルダ
ヘッダファイル格納フォルダ\ linker_script_file

リンカスクリプトファイル格納フォルダ\ Debug

デバッグビルド用フォルダ\ Release

リリースビルド用フォルダ

AN1637 RZ/A1Hサンプルプログラム解説©2023 Alpha Project Co., Ltd.

USB Function CDC サンプルプログラムフォルダ

8

https://www.apnet.co.jp

アプリケーションノート

Alpha Project Co., Ltd.

AN16372.1.4 Ether サンプルプログラムのフォルダ構成

Ether サンプルプログラムは下記のようなフォルダ構成になっています。

\ Sample

AP-RZA-0A サンプルプログラムフォルダ\ ap_rza_0a_ether_sample\ App

サンプルプログラム格納フォルダ\ .setting

プロジェクト設定フォルダ\ ap_rza_0a_ether_sample

Ether サンプルプログラムプロジェクト格納フォルダ\ .setting

プロジェクト設定フォルダ\ GCC

開発環境依存ソースファイル格納フォルダ\ Debug

デバッグビルド用フォルダ\ Release

リリースビルド用フォルダ\ generate

自動生成プログラム格納フォルダ\ linker_setting

リンカファイル格納フォルダ\ port_setting

周辺デバイス設定プログラム格納フォルダ\ CMSIS_RTOS_RTX

ベースOSと、周辺IPのドライバ格納フォルダ\ .setting

プロジェクト設定フォルダ\ RTOS

RTOS ファイル格納フォルダ\ RTX\ include

RTX ソースファイル格納フォルダ

Boards周辺 IP ドライバ格納フォルダ

Doc

RTX ドキュメント

INC

ヘッダファイル格納フォルダ

LIB

ライブラリ格納フォルダ

SRC

RTX ソースファイル格納フォルダ
ヘッダファイル格納フォルダ\ MW

ミドルウェアファイル格納フォルダ\ Utilアプリケーション-ドライバ間調整ファイル格納フォルダ

AN1637 RZ/A1H
サンプルプログラム解説©2023 Alpha Project Co., Ltd.

Ether サンプルプログラムフォルダ

9

https://www.apnet.co.jp

アプリケーションノート

3.

Alpha Project Co., Ltd.

AN1637

動作説明

3.1

UART サンプルプログラムの動作
本サンプルプログラムでは、UART と CMT の動作を行います。

・UART の動作
AP-RZA-0A では SCI4、AP-RZA-1A では SCI5 を用いて、通信を行います。
起動後、プログラム開始メッセージを送信後、エコーバックを行います。
シリアルの設定は、115200bps、ビット長 8、パリティなし、ストップビット 1、フロー制御なしです。
動作確認は、ホスト PC 上のターミナルソフト（ハイパーターミナル等）を使用してください。
・CMT の動作
1msec の割り込みを使用し、1000msec 周期で LED（LD2）の点滅を行います。

3.2

USB HOST サンプルプログラムの動作
USB ホストに USB メモリを接続すると、USB メモリにテキストファイルを書き込みます。ファイル名「HMSCDEMO.TXT」というファイルに 0～9 の文字列を 512 文字分書き込みます。
なお、ポート 0(CN7A), ポート 1(CN7B)のどちらに接続した場合も、動作は共通です。
本サンプルプログラムはルネサス エレクトロニクス株式会社提供の FAT ファイルシステムドライバを移植しており、FAT16、FAT32 に対応しています。

3.3

USB FUNCTION サンプルプログラムの動作
USB ファンクションを PC に接続すると、仮想 COM ポートとしてホスト PC の OS に認識され USB シリアルポートとして動作し、エコーバックを行います。
Win10 よりも前の OS での USB ファンクションの動作確認は、あらかじめ USB 仮想シリアルドライバを PC にインストールしておく必要があります。
インストール方法につきましては、「AN178 USB 仮想シリアルドライバ インストールガイド」を参照してください。
動作の確認は、下記の手順で行います。

① USB ケーブルを使い CPU ボードの USB ファンクションポート(CN6)とホスト PC の USB ポートを接続します。
② CPU ボードに電源を投入し、サンプルプログラムを動作させます。
③ ホスト PC 上でターミナルソフト（ハイパーターミナルなど）を起動し、COM ポートの設定を行います。
COM ポートの設定は、115200bps、ビット長 8、パリティなし、ストップビット 1、フロー制御なしです。
④ ターミナルソフトから任意のデータを送信しますと送信した内容がエコーバックで受信されます。

AN1637 RZ/A1H
サンプルプログラム解説©2023 Alpha Project Co., Ltd.

10

https://www.apnet.co.jp

アプリケーションノート

3.4

Alpha Project Co., Ltd.

AN1637

Ether サンプルプログラムの動作
Ethernet 通信によるエコーバックを行います。
本 CPU ボードは、TCP Server が動作しますので、TCP Client にて、接続を行って下さい。

●ネットワーク設定

本 CPU ボードのネットワーク設定は以下の通りです。

IP アドレス

192.168.1.200

サブネットマスク255.255.255.0

ゲートウェイ192.168.1.254

ポート番号

7

MAC アドレス

AP-RZA-0A の場合：00-0C-7B-38-XX-XX
AP-RZA-1A の場合：00-0C-7B-3B-XX-XX※

XX-XX の値は製品ごとに異なります。

上記設定のうち、IP アドレス・サブネットマスク・ゲートウェイの設定は、サンプルプログラムの\ ap_rza_0a_ether_sample\ App\ ether_sample\ ether_test.c ソースファイル内で定義しています。
各設定の定義は以下の通りです。

設定
IP アドレスstatic char g_ipaddress[] = "192.168.1.200";

サブネットマスクstatic char g_subnetmask[] = "255.255.255.0";

ゲートウェイstatic char g_gateway[] = "192.168.1.254";

AN1637 RZ/A1H
サンプルプログラム解説©2023 Alpha Project Co., Ltd.

プロパティ

11

https://www.apnet.co.jp

アプリケーションノート

Alpha Project Co., Ltd.

AN1637

また、MAC アドレスは EEPROM の先頭 6Byte に格納されています。

AP-RZA-0A の場合
アドレス（CH0）

格納値

先頭アドレス ＋ 0x00

0x00

＋ 0x01

0x0C＋ 0x020x7B＋ 0x030x38＋ 0x040xXX＋ 0x050xXX※

0xXX の値は製品ごとに異なります

AP-RZA-1A の場合
アドレス（CH0）

格納値

先頭アドレス ＋ 0x00

0x00

＋ 0x01

0x0C＋ 0x020x7B＋ 0x030x3B＋ 0x040xXX＋ 0x050xXX※

0xXX の値は製品ごとに異なります

本製品の MAC アドレスは、弊社が米国電気電子学会（IEEE）より取得したアドレスとなります。
MAC アドレスを変更される際は、お客様にて IEEE より MAC アドレスを取得し、設定してください。

AN1637 RZ/A1H
サンプルプログラム解説©2023 Alpha Project Co., Ltd.

12https://www.apnet.co.jp

アプリケーションノート

Alpha Project Co., Ltd.

AN1637

3.5 サンプルプログラムのダウンロード
サンプルプログラムを CPU ボード上で実行するためには、ビルドしたサンプルプログラムの実行ファイルを CPU ボードにダウンロードする必要があります。
サンプルプログラムのビルド方法および CPU ボードにサンプルプログラムをダウンロードする方法については、以下のアプリケーションノートに詳細な手順が記されていますので、参照してください。

AN1634 RZ/A 開発環境の使用方法(e2studio)

また、ボードのシリアル FlashROM へ書き込んで実行される場合には、以下のアプリケーションノートに詳細な手順が記されていますので、参照してください。

AN1604 AP-RZA-0A Serial Flash ROM 書き込み方法

AN1608 AP-RZA-1A Serial Flash ROM 書き込み方法

AN1637 RZ/A1H
サンプルプログラム解説©2023 Alpha Project Co., Ltd.

13

https://www.apnet.co.jpアプリケーションノート

4.

Alpha Project Co., Ltd.

AN1637

開発環境使用時の各設定値
開発環境を使用する際の、AP-RZA-0A・AP-RZA-1A 固有の設定を以下に示します。
表内の「項目番号」は以下のアプリケーションノート内で示されている項目番号を示していますので、対応したそれぞれの設定値を参照してください。

AN1634 RZ/A 開発環境の使用方法(e2studio)

なお、各ファイル名、フォルダ名につきましては、AP-RZA-0A の UART サンプルプログラムのもの（ap_rza_0a_uart_sample）
で記載されておりますので、使用するサンプルプログラムに合わせて、赤文字の箇所を読み替えてください。

4.1 e2studio 用サンプルプログラム
ビルド・動作確認方法
項目名

項目番号設定値

サンプルプログラムフォルダ

2-1

sample\ap_rza_0a_uart_sample

プロジェクト2-2

ap_rza_0a_uart_sample

デバッグ時のボード設定

2-3「4.4 スイッチ設定」参照

デバッグ用出力フォルダ

2-4/ap_rza_0a_uart_sample/Debug（Ethernet サンプルの場合）/ap_rza_0a_ether_sample/App/ether_sample/Debug

デバッグ用実行ファイル

2-5

ap_rza_0a_uart_sample.elf

Debug hardware

2-6

J-Link ARM

Target Device

2-7

R7S721000

SerialFlash 書き込み用フォルダ

3-1

ap_rza_0a_uart_sample\Release（Ethernet サンプルの場合）
ap_rza_0a_ether_sample\App\ether_sample\Release

書込みファイル

AN1637 RZ/A1H
サンプルプログラム解説©2023 Alpha Project Co., Ltd.

3-2

ap_rza_0a_uart_sample.mot

14

https://www.apnet.co.jp

アプリケーションノート

Alpha Project Co., Ltd.

AN1637

4.2 スイッチ設定
4.2.1

AP-RZA-0A の設定

RZ/A1H の USB1 機能はホストとファンクション機能が排他で使用できます。
そのため、AP-RZA-0A のスイッチ設定について、USB ホストサンプルプログラムを使用する場合は Fig4.2-1 を、USB ファンクションサンプルプログラムを使用する場合は Fig4.2-2 をそれぞれ参考に設定してください。
USB ホスト・ファンクション以外のサンプルプログラムを使用する場合は、どちらの設定でも問題ありません。

・SW2

・JSW1

O
N

JSW1
OFF ON

SW2

65
4

3
2
1
・JSW2

・JSW3

ON

OFF

HOST

JSW2

FUNC
JSW3

・JSW4
<SW2 設定>

ONOFF

JSW4

ブートモード：シリアル FlashROM ブート<JSW1 設定>
ボード上の SDRAM：使用する<JSW2 設定>
USB1 の動作モード：USB ホストモード<JSW3 設定>
Ethernet：使用する<JSW4 設定>
AUDIO

：使用する（不問）Fig4.2-1 デバッグ時のボード設定（AP-RZA-0A：ap_rza_0a_usb_hmsc_sample）

AN1637 RZ/A1H
サンプルプログラム解説©2023 Alpha Project Co., Ltd.

15

https://www.apnet.co.jp

アプリケーションノート

Alpha Project Co., Ltd.

AN1637

・SW2・JSW1ON

JSW1OFF ON

SW2

65
4

3
2
1・JSW2・JSW3

ON

OFF

HOST

JSW2

FUNC
JSW3・JSW4<SW2 設定>

ONOFF

JSW4ブートモード：シリアル FlashROM ブート<JSW1 設定>
ボード上の SDRAM：使用する<JSW2 設定>
USB1 の動作モード：USB ファンクションモード

<JSW3 設定>
Ethernet：使用する<JSW4 設定>
AUDIO

：使用する（不問）Fig4.2-2 デバッグ時のボード設定（AP-RZA-0A：ap_rza_0a_usb_pcdc_sample）

4.2.2

AP-RZA-1A の設定

JSW1<JSW1 設定>
ブートモード：シリアル FlashROM ブート

Fig4.2-3 デバッグ時のボード設定（AP-RZA-1A）

AN1637 RZ/A1H
サンプルプログラム解説©2023 Alpha Project Co., Ltd.

16

https://www.apnet.co.jp

アプリケーションノート

Alpha Project Co., Ltd.

AN1637

ご注意・ 本文書の著作権は株式会社アルファプロジェクトが保有します。
・ 本文書の内容を無断で転載することは一切禁止します。
・ 本文書に記載されているサンプルプログラムの著作権は株式会社アルファプロジェクトが保有します。
・ 本サンプルプログラムで使用されているミドルウェアおよびドライバの著作権はルネサス エレクトロニクス株式会社が保有します。
・ 本文書に記載されている内容およびサンプルプログラムについてのサポートは一切受け付けておりません。
・ 本文書の内容およびサンプルプログラムに基づき、アプリケーションを運用した結果、万一損害が発生しても、弊社では一切責任を負いませんのでご了承ください。
・本文書の内容については、万全を期して作成いたしましたが、万一ご不審な点、誤りなどお気付きの点がありましたら弊社までご連絡ください。
・本文書の内容は、将来予告なしに変更されることがあります。

商標について・RZ および RZ/A1H は、ルネサス エレクトロニクス株式会社の登録商標、商標または商品名称です。
・Arm®は Arm Ltd.の登録商標です。
・e2 studio は、ルネサス エレクトロニクス株式会社の登録商標、商標または商品名称です。
・J-Link は、SEGGER Microcontroller GmbH & Co. KG の登録商標もしくは商標です。
・その他の会社名、製品名は、各社の登録商標または商標です。

株式会社アルファプロジェクト〒431-3114
静岡県浜松市中央区積志町 834
https://www.apnet.co.jp
E-Mail: query@apnet.co.jp

AN1637 RZ/A1H
サンプルプログラム解説©2023 Alpha Project Co., Ltd.

17