アプリケーションノート

RL78 ソフトウェア置き換えガイド
CS+から e2 studio への移行編(CC-RL)

R01AN3101JJ0100
Rev.1.00
2016.01.15

要旨
本アプリケーションノートでは、開発統合環境 CS+用 C コンパイラ CC-RL で作成されたプロジェクトを開発統合環境 e2 studio に対応したプロジェクトに置き換える方法について説明します。
開発統合環境の対象バージョンは以下の通りです。
・CS+ V3.01.00
・e2 studio V4.0.0.26

対象デバイス
RL78 ファミリ

本アプリケーションノートを他のマイコンへ適用する場合、そのマイコンの仕様にあわせて変更し、十分評価してください。

R01AN3101JJ0100 Rev.1.00
2016.01.15

Page 1 of 23

RL78 ソフトウェア置き換えガイド

CS+から e2 studio への移行編(CC-RL)

目次
1.

CS+プロジェクトのインポート ............................................................................................................. 32.

デバッガへの接続 ................................................................................................................................... 63.

デバッグ構成ファイルの修正 ............................................................................................................... 22

4.

サンプルコード ..................................................................................................................................... 235.

参考ドキュメント ................................................................................................................................. 23

R01AN3101JJ0100 Rev.1.00
2016.01.15

Page 2 of 23

RL78 ソフトウェア置き換えガイド
1.

CS+から e2 studio への移行編(CC-RL)

CS+プロジェクトのインポート(1)

開発統合環境 e2 studio を立ち上げ、[ファイル]メニューから[インポート]をクリックしてください。

図 1.1 [ファイル]メニュー

R01AN3101JJ0100 Rev.1.00
2016.01.15

Page 3 of 23

RL78 ソフトウェア置き換えガイド(2)

CS+から e2 studio への移行編(CC-RL)

一般→”Renesas 共通プロジェクト・ファイル”を選んで、[次へ(N)＞]ボタンをクリックしてください。

図 1.2 プロジェクのトインポートウィザード(1/2)

R01AN3101JJ0100 Rev.1.00
2016.01.15

Page 4 of 23

RL78 ソフトウェア置き換えガイド(3)

CS+から e2 studio への移行編(CC-RL)

開発統合環境 CS+で作成された Renesas 共通プロジェクト・ファイル（.rcpe）を選択して、デバッグ・ハードウェアを「E1/E20(RL78)」に変更し、[終了(F)]ボタンをクリックしてプロジェクトをインポートします。(「ターゲットの選択」には自動的に開発統合環境 CS+で設定したデバイス名が入ります。)

図 1.3 プロジェクトのインポートウィザード(2/2)

R01AN3101JJ0100 Rev.1.00
2016.01.15

Page 5 of 23

RL78 ソフトウェア置き換えガイド

CS+から e2 studio への移行編(CC-RL)

デバッガへの接続

2.
(1)

プロジェクト・エクスプローラー上のインポートしたプロジェクト名の上で右クリックしメニューを表示し、[プロパティ(R)]を選択してください。

図 2-1 プロジェクトメニュー

R01AN3101JJ0100 Rev.1.00
2016.01.15

Page 6 of 23

RL78 ソフトウェア置き換えガイド(2)

CS+から e2 studio への移行編(CC-RL)「C/C++ビルド」メニューから[設定]を選択し、[ツール設定]タブの[Converter]→[出力]設定の”分割出力ファイル”を削除し分割出力ファイルを出力しない様に設定します。

1.設定を選択
4.削除をクリック
3.分割出力ファイルを選択

2.出力を選択

図 2.2 プロジェクトのプロパティ(1/6)

R01AN3101JJ0100 Rev.1.00
2016.01.15

Page 7 of 23

RL78 ソフトウェア置き換えガイド(3)

CS+から e2 studio への移行編(CC-RL)[Compiler]の[ソース]を選択して、インクルード・ファイル・ディレクトリーを修正してください。
(ディレクトリ名の前に../を追加する)※(3)の手順はライブラリをインクルードしているプロジェクトのみ必要な工程です。

2.変更するインクルード・ファイル・ディレ
クトリーを選択

3.変更ボタンをクリック

1.Compiler のソースを選択
4.ディレクトリー・パス名を編集する

図 2.3 プロジェクトのプロパティ(2/6)

R01AN3101JJ0100 Rev.1.00
2016.01.15

Page 8 of 23

RL78 ソフトウェア置き換えガイド(4)CS+から e2 studio への移行編(CC-RL)[Assembler]の[ソース]を選択して、インクルード・ファイル・ディレクトリーを修正してください。
(ディレクトリ名の前に../を追加する)※(4)の手順はライブラリをインクルードしているプロジェクトのみ必要な工程です。

2.変更するインクルード・ファイル・ディレ
クトリーを選択

3.変更ボタンをクリック

1.Assembler のソースを選択
4.ディレクトリー・
パス名を編集する

図 2-4 プロジェクトのプロパティ(3/6)

R01AN3101JJ0100 Rev.1.00
2016.01.15

Page 9 of 23

RL78 ソフトウェア置き換えガイド(5)CS+から e2 studio への移行編(CC-RL)[Linker]の[入力]を選択して、インクルードするライブラリファイル名を入力してください。(ライブラリのフォルダから指定)※(5)の手順はライブラリをインクルードしているプロジェクトのみ必要な工程です。

2.追加ボタンをクリック

3.ライブラリのファイ
ル名を入力

1.Linker の入力を選択

図 2-5 プロジェクトのプロパティ(4/6)

R01AN3101JJ0100 Rev.1.00
2016.01.15

Page 10 of 23

RL78 ソフトウェア置き換えガイド(6)

CS+から e2 studio への移行編(CC-RL)[Linker]のデバイスを選択して、”オンチップ・デバッグの許可/禁止をリンク・オプションで設定する”と”ユーザ・オプション・バイトを設定する”の項目が開発統合環境 CS+での設定と同じになっているか確認してください。(開発統合環境 CS+で有効にしていてもインポートすると無効化される事があります)

2.”オンチップ・デバッ
グの許可/禁止～”の項
目が CS+と同じ設定になっているか確認
3.”ユーザ・オプショ
ン・バイトを設定する”の項目が CS+と同じ設定になっているか確認

1.Linker のデバイスを選択

図 2-6 プロジェクトのプロパティ(5/5)

図 2-6 プロジェクトのプロパティ(5/6)

R01AN3101JJ0100 Rev.1.00
2016.01.15

Page 11 of 23

RL78 ソフトウェア置き換えガイド(7)

CS+から e2 studio への移行編(CC-RL)[Linker]のセクションを選択して、エントリー・ポイントのシンボルを設定します。

2.エントリー・ポイントのシンボルを設定

1.Linker のセクションを選択

図 2-7 プロジェクトのプロパティ(6/6)※(7)の手順は開発統合環境 CS+側で予め図 2-8 の様に設定する事で省略する事が可能です。

①CC-RL のリンク・オプションタブを選択②出力コードの項目の実行開始アドレスを指定するを[はい(-ENTry)]にする③実行開始アドレスを[_start]に設定する

R01AN3101JJ0100 Rev.1.00
2016.01.15

Page 12 of 23

RL78 ソフトウェア置き換えガイド

CS+から e2 studio への移行編(CC-RL)

図 2-8 CS+のリンク・オプション

R01AN3101JJ0100 Rev.1.00
2016.01.15

Page 13 of 23

RL78 ソフトウェア置き換えガイド(8)CS+から e2 studio への移行編(CC-RL)

プロジェクト・エクスプローラー上のインポートしたプロジェクト名の上で右クリックしメニューを表示し、[プロジェクトのビルド(B)]を選択してください。

図 2-9 プロジェクトのビルド

R01AN3101JJ0100 Rev.1.00
2016.01.15

Page 14 of 23

RL78 ソフトウェア置き換えガイド(9)CS+から e2 studio への移行編(CC-RL)[実行]メニューから[デバッグの構成(B)]をクリックしてください。

図 2-10 実行メニュー

R01AN3101JJ0100 Rev.1.00
2016.01.15

Page 15 of 23

RL78 ソフトウェア置き換えガイド(10)CS+から e2 studio への移行編(CC-RL)「Renesas GDB Hardware Debugging」を選択して、新規の構成アイコン成を作成します。

をクリックして新規の構

図 2-11 デバッグ構成メニュー(1/5)

R01AN3101JJ0100 Rev.1.00
2016.01.15

Page 16 of 23

RL78 ソフトウェア置き換えガイド(11)CS+から e2 studio への移行編(CC-RL)

デバッグ構成の[メイン]タブに切り替え、C/C++アプリケーションの[プロジェクトの検索(H)]をクリックし、プロジェクトビルドフォルダ内にある「ロードモジュールファイル(.x)」（※(8)の手順で出力されたファイル）を追加します。

1.メインタブに切り替える

2.プロジェクトの検索ボタンをクリック

3.ロードモジュール
ファイルを選択する

図 2-12 デバッグの構成(2/5)

R01AN3101JJ0100 Rev.1.00
2016.01.15

Page 17 of 23

RL78 ソフトウェア置き換えガイド(12)CS+から e2 studio への移行編(CC-RL)[Debugger]タブへ切り替え、Debug hardware を”E1/E20(RL78)”、Target Device を使用しているデバイスに設定してください。

図 2-13 デバッグ構成メニュー(3/5)

R01AN3101JJ0100 Rev.1.00
2016.01.15

Page 18 of 23

RL78 ソフトウェア置き換えガイド(13)CS+から e2 studio への移行編(CC-RL)[Connection Setting]タブへ切り替え、供給電圧を開発統合環境 CS+と同じ設定にしてください。

1.Connection Settingに切り替える

2.供給電圧を CS+と同じ設定にする

図 2-14 デバッグ構成メニュー(4/5)

R01AN3101JJ0100 Rev.1.00
2016.01.15

Page 19 of 23

RL78 ソフトウェア置き換えガイド(14)CS+から e2 studio への移行編(CC-RL)[共通]タブへ切り替え、保管項目のラジオボタンを “共用ファイル”に変更し、[参照(B)]ボタンをクリックして起動構成のロケーションを選択してください。これでデバッグ構成がファイル(.launch)に保存されます。
1.共通タブに切り替え

2.参照ボタンをクリック

3.起動構成のロケーションを選択する

図 2-15 デバッグ構成メニュー(5/5)

R01AN3101JJ0100 Rev.1.00
2016.01.15

Page 20 of 23

RL78 ソフトウェア置き換えガイド(15)CS+から e2 studio への移行編(CC-RL)[デバッグ]ボタンをクリックする事でデバッガへの接続が可能です。

図 2-16 デバッグ構成メインメニュー

R01AN3101JJ0100 Rev.1.00
2016.01.15

Page 21 of 23

RL78 ソフトウェア置き換えガイド

CS+から e2 studio への移行編(CC-RL)

デバッグ構成ファイルの修正

3.
(1)

プロジェクト内に保存されるデバッグ構成ファイル(.launch)に 2 箇所ローカルディレクトリ名が保存されているので、その箇所が”DefaultBuild¥○○.x”になるように修正し保存してください。

図 3.1 デバッグ構成ファイル

R01AN3101JJ0100 Rev.1.00
2016.01.15

Page 22 of 23

RL78 ソフトウェア置き換えガイド
4.

CS+から e2 studio への移行編(CC-RL)

サンプルコード

サンプルコードは、ルネサス エレクトロニクスホームページから入手してください。

5.

参考ドキュメント

RL78 ファミリ ユーザーズマニュアル ソフトウェア編（R01US0015J）
RL78 コンパイラ CC-RL ユーザーズマニュアル(R20UT3123J)（最新版をルネサス エレクトロニクスホームページから入手してください。)

ホームページとサポート窓口
ルネサス エレクトロニクスホームページ
http://japan.renesas.com/
お問合せ先
http://japan.renesas.com/inquiry

R01AN3101JJ0100 Rev.1.00
2016.01.15

Page 23 of 23

RL78 ソフトウェア置き換えガイド
CS+から e2 studio への移行編(CC-RL)

改訂記録

Rev.

発行日

1.00

2016.01.15

改訂内容
ポイント

ページ
—

初版発行

すべての商標および登録商標は、それぞれの所有者に帰属します。

A-1

ご注意書き1. 本資料に記載された回路、ソフトウェアおよびこれらに関連する情報は、半導体製品の動作例、応用例を説明するものです。お客様の機器・システムの設計において、回路、ソフトウェアおよびこれらに関連する情報を使用する場合には、お客様の責任において行ってください。これらの使用に起因して、お客様または第三者に生じた損害に関し、当社は、一切その責任を負いません。
2. 本資料に記載されている情報は、正確を期すため慎重に作成したものですが、誤りがないことを保証するものではありません。万一、本資料に記載されている情報の誤りに起因する損害がお客様に生じた場合においても、当社は、一切その責任を負いません。
3. 本資料に記載された製品デ−タ、図、表、プログラム、アルゴリズム、応用回路例等の情報の使用に起因して発生した第三者の特許権、著作権その他の知的財産権に対する侵害に関し、当社は、何らの責任を負うものではありません。当社は、本資料に基づき当社または第三者の特許権、著作権その他の知的財産権を何ら許諾するものではありません。
4. 当社製品を改造、改変、複製等しないでください。かかる改造、改変、複製等により生じた損害に関し、当社は、一切その責任を負いません。
5. 当社は、当社製品の品質水準を「標準水準」および「高品質水準」に分類しており、各品質水準は、以下に示す用途に製品が使用されることを意図しております。
標準水準：

コンピュータ、OA機器、通信機器、計測機器、AV機器、家電、工作機械、パーソナル機器、産業用ロボット等

高品質水準：輸送機器（自動車、電車、船舶等）、交通用信号機器、
防災・防犯装置、各種安全装置等
当社製品は、直接生命・身体に危害を及ぼす可能性のある機器・システム（生命維持装置、人体に埋め込み使用するもの等） 、もしくは多大な物的損害を発生させるおそれのある機器・システム（原子力制御システム、軍事機器等）に使用されることを意図しておらず、使用することはできません。 たとえ、意図しない用途に当社製品を使用したことによりお客様または第三者に損害が生じても、当社は一切その責任を負いません。 なお、ご不明点がある場合は、当社営業にお問い合わせください。
6. 当社製品をご使用の際は、当社が指定する最大定格、動作電源電圧範囲、放熱特性、実装条件その他の保証範囲内でご使用ください。当社保証範囲を超えて当社製品をご使用された場合の故障および事故につきましては、当社は、一切その責任を負いません。
7. 当社は、当社製品の品質および信頼性の向上に努めていますが、半導体製品はある確率で故障が発生したり、使用条件によっては誤動作したりする場合があります。また、当社製品は耐放射線設計については行っておりません。当社製品の故障または誤動作が生じた場合も、人身事故、火災事故、社会的損害等を生じさせないよう、お客様の責任において、冗長設計、延焼対策設計、誤動作防止設計等の安全設計およびエージング処理等、お客様の機器・システムとしての出荷保証を行ってください。特に、マイコンソフトウェアは、単独での検証は困難なため、お客様の機器・システムとしての安全検証をお客様の責任で行ってください。
8. 当社製品の環境適合性等の詳細につきましては、製品個別に必ず当社営業窓口までお問合せください。ご使用に際しては、特定の物質の含有・使用を規制するRoHS指令等、適用される環境関連法令を十分調査のうえ、かかる法令に適合するようご使用ください。お客様がかかる法令を遵守しないことにより生じた損害に関して、当社は、一切その責任を負いません。
9. 本資料に記載されている当社製品および技術を国内外の法令および規則により製造・使用・販売を禁止されている機器・システムに使用することはできません。また、当社製品および技術を大量破壊兵器の開発等の目的、軍事利用の目的その他軍事用途に使用しないでください。当社製品または技術を輸出する場合は、「外国為替及び外国貿易法」その他輸出関連法令を遵守し、かかる法令の定めるところにより必要な手続を行ってください。
10. お客様の転売等により、本ご注意書き記載の諸条件に抵触して当社製品が使用され、その使用から損害が生じた場合、当社は何らの責任も負わず、お客様にてご負担して頂きますのでご了承ください。
11. 本資料の全部または一部を当社の文書による事前の承諾を得ることなく転載または複製することを禁じます。
注1. 本資料において使用されている「当社」とは、ルネサス エレクトロニクス株式会社およびルネサス エレクトロニクス株式会社がその総株主の議決権の過半数を直接または間接に保有する会社をいいます。
注2. 本資料において使用されている「当社製品」とは、注１において定義された当社の開発、製造製品をいいます。

http://www.renesas.com■営業お問合せ窓口※営業お問合せ窓口の住所は変更になることがあります。最新情報につきましては、弊社ホームページをご覧ください。

ルネサス エレクトロニクス株式会社〒135-0061 東京都江東区豊洲3-2-24（豊洲フォレシア）■技術的なお問合せおよび資料のご請求は下記へどうぞ。
総合お問合せ窓口：http://japan.renesas.com/contact/© 2015 Renesas Electronics Corporation. All rights reserved.
Colophon 4.0

ご注意書き1. 本資料に記載された回路、ソフトウェアおよびこれらに関連する情報は、半導体製品の動作例、応用例を説明するものです。お客様の機器・システムの設計において、回路、ソフトウェアおよびこれらに関連する情報を使用する場合には、お客様の責任において行ってください。これらの使用に起因して、お客様または第三者に生じた損害に関し、当社は、一切その責任を負いません。
2. 本資料に記載されている情報は、正確を期すため慎重に作成したものですが、誤りがないことを保証するものではありません。万一、本資料に記載されている情報の誤りに起因する損害がお客様に生じた場合においても、当社は、一切その責任を負いません。
3. 本資料に記載された製品デ−タ、図、表、プログラム、アルゴリズム、応用回路例等の情報の使用に起因して発生した第三者の特許権、著作権その他の知的財産権に対する侵害に関し、当社は、何らの責任を負うものではありません。当社は、本資料に基づき当社または第三者の特許権、著作権その他の知的財産権を何ら許諾するものではありません。
4. 当社製品を改造、改変、複製等しないでください。かかる改造、改変、複製等により生じた損害に関し、当社は、一切その責任を負いません。
5. 当社は、当社製品の品質水準を「標準水準」および「高品質水準」に分類しており、各品質水準は、以下に示す用途に製品が使用されることを意図しております。
標準水準：コンピュータ、OA機器、通信機器、計測機器、AV機器、家電、工作機械、パーソナル機器、産業用ロボット等

高品質水準：輸送機器（自動車、電車、船舶等）、交通用信号機器、防災・防犯装置、各種安全装置等
当社製品は、直接生命・身体に危害を及ぼす可能性のある機器・システム（生命維持装置、人体に埋め込み使用するもの等） 、もしくは多大な物的損害を発生させるおそれのある機器・システム（原子力制御システム、軍事機器等）に使用されることを意図しておらず、使用することはできません。 たとえ、意図しない用途に当社製品を使用したことによりお客様または第三者に損害が生じても、当社は一切その責任を負いません。 なお、ご不明点がある場合は、当社営業にお問い合わせください。
6. 当社製品をご使用の際は、当社が指定する最大定格、動作電源電圧範囲、放熱特性、実装条件その他の保証範囲内でご使用ください。当社保証範囲を超えて当社製品をご使用された場合の故障および事故につきましては、当社は、一切その責任を負いません。
7. 当社は、当社製品の品質および信頼性の向上に努めていますが、半導体製品はある確率で故障が発生したり、使用条件によっては誤動作したりする場合があります。また、当社製品は耐放射線設計については行っておりません。当社製品の故障または誤動作が生じた場合も、人身事故、火災事故、社会的損害等を生じさせないよう、お客様の責任において、冗長設計、延焼対策設計、誤動作防止設計等の安全設計およびエージング処理等、お客様の機器・システムとしての出荷保証を行ってください。特に、マイコンソフトウェアは、単独での検証は困難なため、お客様の機器・システムとしての安全検証をお客様の責任で行ってください。
8. 当社製品の環境適合性等の詳細につきましては、製品個別に必ず当社営業窓口までお問合せください。ご使用に際しては、特定の物質の含有・使用を規制するRoHS指令等、適用される環境関連法令を十分調査のうえ、かかる法令に適合するようご使用ください。お客様がかかる法令を遵守しないことにより生じた損害に関して、当社は、一切その責任を負いません。
9. 本資料に記載されている当社製品および技術を国内外の法令および規則により製造・使用・販売を禁止されている機器・システムに使用することはできません。また、当社製品および技術を大量破壊兵器の開発等の目的、軍事利用の目的その他軍事用途に使用しないでください。当社製品または技術を輸出する場合は、「外国為替及び外国貿易法」その他輸出関連法令を遵守し、かかる法令の定めるところにより必要な手続を行ってください。
10. お客様の転売等により、本ご注意書き記載の諸条件に抵触して当社製品が使用され、その使用から損害が生じた場合、当社は何らの責任も負わず、お客様にてご負担して頂きますのでご了承ください。
11. 本資料の全部または一部を当社の文書による事前の承諾を得ることなく転載または複製することを禁じます。
注1. 本資料において使用されている「当社」とは、ルネサス エレクトロニクス株式会社およびルネサス エレクトロニクス株式会社がその総株主の議決権の過半数を直接または間接に保有する会社をいいます。
注2. 本資料において使用されている「当社製品」とは、注１において定義された当社の開発、製造製品をいいます。

http://www.renesas.com■営業お問合せ窓口※営業お問合せ窓口の住所は変更になることがあります。最新情報につきましては、弊社ホームページをご覧ください。

ルネサス エレクトロニクス株式会社 〒135-0061 東京都江東区豊洲3-2-24（豊洲フォレシア）■技術的なお問合せおよび資料のご請求は下記へどうぞ。
総合お問合せ窓口：http://japan.renesas.com/contact/© 2016 Renesas Electronics Corporation. All rights reserved.
Colophon 4.0