アプリケーションノート

Alpha Project Co., Ltd.

AN1609GNU コンパイラ導入ガイド
3.1 版 2023 年 10 月 02 日

1.

GNU コンパイラの導入.............................................................................. 2

1.1

はじめに .................................................................................................................... 2

1.2

必要なプログラムとダウンロード .................................................................................... 3

1.2.1

GNU ツールチェインのダウンロード .......................................................................... 3

1.2.2

e2 studio のダウンロード ......................................................................................... 5

1.3

GNU ツールチェインのインストール ................................................................................ 7

1.4

e2 studio のインストール ............................................................................................ 12

1.5

e2 studio の起動 ........................................................................................................ 17

2.

プログラムの作成とビルド .........................................................................19

2.1

プロジェクトの作成 ..................................................................................................... 19

2.2

ビルド ...................................................................................................................... 23

GNU コンパイラ導入ガイド©2023 Alpha Project Co., Ltd.

1

https://www.apnet.co.jp

アプリケーションノート

1.

Alpha Project Co., Ltd.

AN1609GNU コンパイラの導入
1.1

はじめに
本アプリケーションノートでは、GNU コンパイラの導入方法を説明します。
GNU コンパイラを導入するにあたり、CyberTHOR Studios 社の GNU ツールチェインとルネサス エレクトロニクス社の開発環境である e2 studio を使用します。
それぞれのツールのバージョンは以下に記すものを使用します。
ツール
GNUARM-NONE Toolchain
2e studio

バージョン
v16.01v5.3.0.023

上記以外のバージョンではインストール方法や操作方法が異なる場合がありますので、ご注意ください。

GNU コンパイラ導入ガイド©2023 Alpha Project Co., Ltd.

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

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

Alpha Project Co., Ltd.

AN1609必要なプログラムとダウンロード
GNU コンパイラの導入には以下のファイルが必要です。
ファイル名

説明

GNU ツールチェイン

GNU コンパイラ等を含む GNU のツールチェインをインストールするためのインストーラパッケージです。
CyberTHOR Studios 社のホームページより、exe 形式で提供されています。

2e studio

開発環境 e2 studio をインストールするためのパッケージです。

インストーラルネサスエレクトロニクス社のホームページより、exe 形式で提供されています。

1.2.1

GNU ツールチェインのダウンロード

GNU ツールチェインは CyberTHOR Studios 社の Open Source Tools for Renesas サイトから入手できます。
①

サイト（ https://llvm-gcc-renesas.com/ja/ ）にアクセスし、画面上部の「ユーザ登録」からユーザ登録を行ってください。
ユーザ登録完了後、あるいは登録済みの場合は、ログインをしてください。

GNU コンパイラ導入ガイド©2023 Alpha Project Co., Ltd.

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

Alpha Project Co., Ltd.

AN1609GNU Tools サイトのメニューから「PRODUCTS》RZ》Download Toolchains」を選択します。
※ 本項では「GNUARM-NONE Toolchain v16.01」のダウンロードを行う手順を示しています。
実際に必要となるツールチェインに従って、ユーザはそれぞれのダウンロードページを開いてください。

③

ダウンロードするツールチェインの「ダウンロード」を選択し、ダウンロードを行ってください。

GNU コンパイラ導入ガイド©2023 Alpha Project Co., Ltd.

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

アプリケーションノート

1.2.2

Alpha Project Co., Ltd.

AN1609e2 studio のダウンロード

e2 studio はルネサス エレクトロニクス社のホームページから入手できます。
①

ルネサス エレクトロニクス社のホームページ（ https://www.renesas.com/jp/ja ）にアクセスし、画面上部の「ログイン」を選択してログイン画面を開き、ユーザ登録を行ってください。
ユーザ登録完了後、あるいは、登録済みである場合は、ログインをしてください。

②

サイト内の「ドキュメント＆ダウンロード検索」を選択し、検索ページに移動してください。

③

検索ページにて、下記の条件で検索をしてください。
タイプで絞り込み：「ソフトウェア、ツール、サンプルコード》アップデート－統合開発環境」にチェック

タイトル: 「studio」と入力

GNU コンパイラ導入ガイド©2023 Alpha Project Co., Ltd.

5

https://www.apnet.co.jp

アプリケーションノート

Alpha Project Co., Ltd.

AN1609④

検索結果からダウンロードする e2 studio を選択してください。

⑤

表示の内容をご確認のうえ、「ACCEPT AND DOWNLOAD」を選択し、ダウンロードを行ってください。

YYYY-MM※「YYYY-MM」の Y には年、M には月が入ります。

GNU コンパイラ導入ガイド©2023 Alpha Project Co., Ltd.

6

https://www.apnet.co.jp

アプリケーションノート

1.3

Alpha Project Co., Ltd.

AN1609GNU ツールチェインのインストール
GNU ツールチェインのインストールを行います。
本アプリケーションノートは GNUARM-NONE-EABI Toolchain v16.01 を用いた手順を示しています。
そのため、バージョンやホスト OS が異なると表示や手順が異なる場合があります。
①［1.2.1 GNU ツールチェインのダウンロード］にてダウンロードしたファイルを実行してください。

②

セットアップが開始されるので［Default］を選択して［Next］を押してください。

③「I am a registered us」にチェックを入れて、［Next］を選択してください。

GNU コンパイラ導入ガイド©2023 Alpha Project Co., Ltd.

7

https://www.apnet.co.jp

アプリケーションノート

④

Alpha Project Co., Ltd.

AN1609GNU Tools サイトの左上から「ダッシュボード」を選択、ダッシュボード画面に記載されたユーザの E-mail とアクティベーションコードを入力してください。

※入力に必要なコードはインストールするツールチェインによって異なります。
GNUARM-NONE-EABI Toolchain v16.01 では、下段の legacy activation code を使用してください。

⑤［Next］を選択し、次へ進んでください。

GNU コンパイラ導入ガイド©2023 Alpha Project Co., Ltd.

8

https://www.apnet.co.jp

アプリケーションノート

⑥［Next］を選択し、次へ進んでください。

⑦［Next］を選択し、次へ進んでください。

⑧［Next］を選択し、次へ進んでください。

GNU コンパイラ導入ガイド©2023 Alpha Project Co., Ltd.

Alpha Project Co., Ltd.

AN16099https://www.apnet.co.jp

アプリケーションノート

Alpha Project Co., Ltd.

AN1609⑨［Next］を選択し、次へ進んでください。

⑩［Next］を選択し、インストールを開始してください。

※GNUARM-NONE Toolchain のアクティベーションコードを登録済みである場合は、上記の③～⑩のウィンドウが表示されず、「Summary Page」ウィンドウが表示されます。
このウィンドウが表示された場合は［Next］を選択し、インストールを開始してください。

GNU コンパイラ導入ガイド©2023 Alpha Project Co., Ltd.

10

https://www.apnet.co.jp

アプリケーションノート

Alpha Project Co., Ltd.

AN1609⑪

インストールが終了後、［Next］を選択してください。

⑫［Finish］を選択し、インストールを終了してください。

GNU コンパイラ導入ガイド©2023 Alpha Project Co., Ltd.

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

アプリケーションノート

1.4

Alpha Project Co., Ltd.

AN1609e2 studio のインストール
e2 studio のインストールを行い、開発環境を構築します。
本アプリケーションノートは e2 studio v5.3.0.023 と、GNUARM-NONE-EABI Toolchain v16.01 を用いた手順を示しています。
そのため、バージョンやホスト OS が異なると表示や手順が異なる場合があります。
①［1.2.2 e2 studio のダウンロード］にてダウンロードしたファイルを実行してください。

②

セットアップが開始されるので［次へ］を選択してください。

③

インストールするフォルダを決定し、［次へ］を選択してください。

GNU コンパイラ導入ガイド©2023 Alpha Project Co., Ltd.

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

アプリケーションノート

④

Alpha Project Co., Ltd.

AN1609［RZ デバイス・サポート］にチェックを入れ、［次へ］を選択してください。
※ 本項では「GNUARM-NONE Toolchain v16.01」を使用する手順を示しています。
実際に使用するツールチェインに従って、ユーザはそれぞれのデバイス・サポートを選択してください。

⑤［日本語言語パック］にチェックを入れ、［次へ］を選択してください。

GNU コンパイラ導入ガイド©2023 Alpha Project Co., Ltd.

13

https://www.apnet.co.jp

アプリケーションノート

⑥［次へ］を選択してください。

⑦［次へ］を選択してください。

GNU コンパイラ導入ガイド©2023 Alpha Project Co., Ltd.

Alpha Project Co., Ltd.

AN160914https://www.apnet.co.jp

アプリケーションノート

Alpha Project Co., Ltd.

AN1609⑧［私はソフトウェア使用許諾を承諾します］にチェックを入れ、［次へ］を選択してください。

⑨［次へ］を選択してください。

GNU コンパイラ導入ガイド©2023 Alpha Project Co., Ltd.

15

https://www.apnet.co.jp

アプリケーションノート

Alpha Project Co., Ltd.

AN1609⑩［インストール］を選択し、インストールを開始してください。

⑪

インストールが完了したら［OK］を選択してください。

GNU コンパイラ導入ガイド©2023 Alpha Project Co., Ltd.

16

https://www.apnet.co.jp

アプリケーションノート

1.5

Alpha Project Co., Ltd.

AN1609e2 studio の起動①

e2 studio のインストールが完了した後、e2 studio の起動を行います。

②

e2 studio のワークスペースを指定するウィンドウが表示されますので、e2 studio のワークスペースとして扱うフォルダを指定し、［OK］を選択してください。

③

Toolchain Integration ウィンドウが表示されるので「ツールチェーンの登録」の項目中の［KPIT GNUARM-NONE-EABI Toolchain -16.01］と、［起動時に’ツールチェーンの登録’を有効にする］にチェックを入れ、［登録］を選択してください。
※ 本アプリケーションノートは GNUARM-NONE-EABI Toolchain v16.01 を用いて作成しています。

④「選択したツールチェインは正常に e2 studio に登録されました」と表示された場合は、［OK］を選択してください。

⑤

コード生成の登録ウィンドウが表示された場合は、［OK］を選択してください。

GNU コンパイラ導入ガイド©2023 Alpha Project Co., Ltd.

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

アプリケーションノート

Alpha Project Co., Ltd.

AN1609⑥

Code Generator COM component register ウィンドウが表示された場合は、［OK］を選択してください。

⑦

e2 studio の再起動ウィンドウが表示された場合は、［OK］を選択してください。

⑧

e2 studio を起動後、ツールバーの［ヘルプ］→［Renesas ツールチェーンの追加］を選択してください。

⑨

使用するツールチェーンが追加されていることを確認してください。
本画面ではツールチェインの管理・追加ができます。

GNU コンパイラ導入ガイド©2023 Alpha Project Co., Ltd.

18

https://www.apnet.co.jp

アプリケーションノート

2.

Alpha Project Co., Ltd.

AN1609プログラムの作成とビルド［1. GNU コンパイラの導入］でインストールした開発環境を使用してプログラムを作成するための手順を、
ターゲット RZ/A1H を例として説明します。
本章の説明で用いるターゲット CPU、コンパイラ、開発環境のバージョンを以下に記します。
ターゲットRZ/A1H

R7S721000

コンパイラ

GNU コンパイラ

GNUARM-NONE-EABI Toolchain v16.01

開発環境

2.1

2

e studioe2 studio v5.3.0.023

プロジェクトの作成
e2 studio を使用してプロジェクトのテンプレートを作成します。
①

e2 studio を起動してください。

②［ようこそ］の画面が表示された場合は、タブの［閉じる］ボタンをクリックしてください。

GNU コンパイラ導入ガイド©2023 Alpha Project Co., Ltd.

19

https://www.apnet.co.jp

アプリケーションノート

Alpha Project Co., Ltd.

AN1609③

ツールバーの［新規］→［C Project］を選択してください。

④［プロジェクト名］を入力し、［プロジェクトの種類］を［Executable (Renesas) > Sample Project］に、［ツールチェイン］を［KPIT GNUARM-NONE-EABI Toolchain］にそれぞれ選択し、［次へ］を選択してください。

GNU コンパイラ導入ガイド©2023 Alpha Project Co., Ltd.

20

https://www.apnet.co.jp

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

Alpha Project Co., Ltd.

AN1609ターゲットの設定をそれぞれ次の値に設定して、[終了]を選択してください。
・［Toolchain Version］：［v16.01]
・［Debug Hardware］：［J-Link ARM］
・［Endian］：［Little-endian］
・［Select Target］：［R7S721000］※ 本章ではターゲット RZ/A1H を例として説明しています。
他の CPU を使用する場合は［Select Target］にて適切なターゲットを選択してください。

⑥[OK]を選択してください。

GNU コンパイラ導入ガイド©2023 Alpha Project Co., Ltd.

21

https://www.apnet.co.jp

アプリケーションノート

⑦

Alpha Project Co., Ltd.

AN1609ナビゲーションウィンドウに作成したプロジェクトが追加されていることを確認してください。

以上でプロジェクトのテンプレートが作成されました。
e2 studio で作成したプロジェクトは、リンカ用アドレス定義ファイル（リンカスクリプトファイル）等のファイルが含まれていません。
これらのファイルは必要に応じてユーザが作成してください。

GNU コンパイラ導入ガイド©2023 Alpha Project Co., Ltd.

22

https://www.apnet.co.jp

アプリケーションノート

2.2

Alpha Project Co., Ltd.

AN1609ビルド
e2 studio に登録したプロジェクトのビルド方法を解説します。
①

メニューバーの［ビルド］アイコンをクリックし、プロジェクトのビルドを行ってください。

②

正常にセッティングを行えている場合、コンソールにエラーが表示されずビルドに成功します。

GNU コンパイラ導入ガイド©2023 Alpha Project Co., Ltd.

23

https://www.apnet.co.jp

アプリケーションノート

Alpha Project Co., Ltd.

AN1609ご注意

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

商標について・e2 studio は、ルネサス エレクトロニクス株式会社の登録商標、商標または商品名称です。
・その他の会社名、製品名は、各社の登録商標または商標です。

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

GNU コンパイラ導入ガイド©2023 Alpha Project Co., Ltd.

24