User’s Manual
CubeSuite+
パートナー OS対応デバッグプラグイン
ユーザーズマニュアル
対象デバイス
RL78ファミリ
RXファミリ
本資料7ページに記載のある「動作環境」の最新情報は、以下のWebページをご参照ください。
製品の動作環境
http://japan.renesas.com/products/tools/sub/tool̲system̲requirements.jsp

本資料に記載の全ての情報は発行時点のものであり、ルネサス エレクトロニクスは、予告なしに、本資料に記載した製品または仕様を変更することがあります。
ルネサス エレクトロニクスのホームページなどにより公開される最新情報をご確認ください。

www.renesas.com

Rev.1.00

2012.10

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

(2012.4)

このマニュアルの使い方

対 象 者

このマニュアルは，RL78 ファミリ，RX ファミリの各製品の応用システムを設計，開発するユーザを対象としています。

目的

このマニュアルは，次の構成に示す CubeSuite+ パートナー OS 対応デバッグプラグインの機能をユーザに理解していただくことを目的としています。

構成

このマニュアルは，大きく分けて次の内容で構成しています。

第1章

概説

第2章

機能付録 A ウインドウリファレンス
付録 B メッセージ
付録 C 注意事項

読 み 方

このマニュアルを読むにあたっては，電気，論理回路，マイクロコンピュータ，C 言語，アセンブラの一般知識が必要となります。

RL78 ファミリ，RX ファミリのハードウエア機能を知りたいとき→

凡

各製品のユーザーズマニュアルを参照してください。

例

データ表記の重み： 左が上位桁，右が下位桁

注： 本文中につけた注の説明

注意： 気をつけて読んでいただきたい内容

備考： 本文中の補足説明

数の表記： 10 進数

...

XXXX

16 進数

...

0xXXXX

2 のべき数を示す接頭語（アドレス空間，メモリ容量）：
K（キロ） 210 = 1024
M（メガ） 220 = 10242

関連資料

関連資料は暫定版の場合がありますが，この資料では「暫定」の表示をしておりません。あらかじめご了承ください。
資料名

CubeSuite+ パートナー OS 対応デバッグプラグイン ユーザーズマニュアル

注意

資料番号和文英文

このマニュアルR20UT0946E

上記関連資料は，予告なしに内容を変更することがあります。設計などには，必ず最新の資料を使用してください。

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

Smalight は株式会社ルネサス北日本セミコンダクタの登録商標です。
NORTi は株式会社ミスポの登録商標です。
UCT μT-Kernel DevKit tuned はユーシーテクノロジ株式会社の商標です。
μC/OS-III は Micrium 社の商標です。
embOS は SEGGER Microcontroller 社の登録商標です。
μT-Kernel 仕様の著作権は T-Engine フォーラムに属しています。

目

第1章
1. 1
1. 2
1. 3

概説

概要
特長動作環境

…
…
…
…

66
7
7

第2章

機付録 Aウインドウリファレンス

A. 1

付録 B
B. 1
B. 2

付録 C
C. 1

説

能明…

…

メッセージ

810… 17

フェイタルエラー …
ワーニング … 17

注意事項
注意事項

… 19…

1917…

10次

パートナー OS 対応デバッグプラグイン

第1章

第 1章

概概説

説

CubeSuite+ は，ルネサス エレクトロニクス製マイクロコントローラ用アプリケーションシステムを開発する際の統合開発環境であり，設計／コーディング／ビルド／デバッグなどといった一連の作業を実施することができます。
本マニュアルでは，こうした一連のプログラム開発工程のうち，リアルタイム OS の機能を利用したプログラムをデバッグする際に有効なツールについて説明しています。

1. 1

概要

パートナー OS 対応デバッグプラグインは，CubeSuite+ に組み込んで使用するデバッグ拡張オプション製品です。
リアルタイム OS の機能を利用したプログラムをデバッグする際，パートナー OS 対応デバッグプラグインのリソース情報ツールを用いることにより，プログラムの実行状況に応じて動的に変化するリアルタイム OS のリソース情報（システム情報，タスク情報など）を確認することができます。

図 1―1

R20UT0946JJ0100 Rev.1.00
2012.10.1

CubeSuite+ パートナー OS 対応デバッグプラグイン

Page 6 of 23

パートナー OS 対応デバッグプラグイン

1. 2

特第 1章

概説

長

以下に，パートナー OS 対応デバッグプラグインの特長を示します。

- リソース情報の確認
デバッグツール上で実行しているプログラムのリソース情報の現在状態をリソース情報 パネルに表示します。

1. 3

動作環境
- リアルタイム OS

表 1―1 対応リアルタイム OS
リアルタイム OSバージョン

RL78

RX

ファミリ

ファミリ

○

○

V3.10

株式会社ミスポ社製 NORTi-○

Version 4 Release 4.4

ユーシーテクノロジ株式会社製-○

Version 1.01.01

Micrium 社製 μC/OS-III-○V3.02SEGGER 社製 embOS-○

Version 3.84

株式会社ルネサス北日本セミコン
ダクタ社製 Smalight OS

UCT μT-Kernel DevKit tuned for
RX62N-CubeSuite+- 統合開発環境
CubeSuite+ V1.03- デバッガシミュレータ，オンチップデバッギングエミュレータ（E1，E20）- コンパイラ
ルネサス製コンパイラ- PC
Windows 7(R) , Windows Vista(R) , Windows(R)XPその他の条件は CubeSuite+ の動作環境に準ずる。

「動作環境」の最新情報は、Webページを参照ください。
製品の動作環境
http://japan.renesas.com/products/tools/sub/tool̲system̲requirements.jsp

R20UT0946JJ0100 Rev.1.00
2012.10.1

Page 7 of 23

パートナー OS 対応デバッグプラグイン

第2章

第 2章

機機

能

能

本章では，パートナー OS 対応デバッグプラグインが提供している主な機能を操作手順とともに説明します。

（1）CubeSuite+ の起動
Windows の［スタート］メニューから CubeSuite+ を起動します。

（2）プロジェクトの読み込みデバッグ対象となるプロジェクトを読み込みます。

（3）デバッグツールの選択
プログラムをデバッグする際に使用するデバッグツールの種類を選択します。

（4）プログラムのダウンロードデバッグ対象となるプログラムをダウンロードします。

（5）リアルタイム OS の選択
プログラムをダウンロードすると，［OS 選択］ダイアログボックスが自動的に表示されますので，使用するリアルタイム OS を選択します。

図 2―1 OS 選択ダイアログボックス（6）プログラムの実行／停止
リソース情報を表示させたい箇所までプログラムを実行し、停止させます。

R20UT0946JJ0100 Rev.1.00
2012.10.1

Page 8 of 23

パートナー OS 対応デバッグプラグイン

第 2章

機能（7）リソース情報の確認［表示］メニュー→［リアルタイム OS］→［リソース情報］を選択し，リソース情報 パネルを開きます。

図 2―2 リソース情報パネル

備考

CubeSuite+ の操作についての詳細は，CubeSuite+ のユーザーズマニュアルまたはヘルプを参照してください。

R20UT0946JJ0100 Rev.1.00
2012.10.1Page 9 of 23

パートナー OS 対応デバッグプラグイン

付録 A

A. 1

説

付録 A ウインドウリファレンス

ウインドウリファレンス

明

以下に，パートナー OS 対応デバッグプラグインのパネルの一覧を示します。

表 A―1
パネル名
リソース情報 パネル

R20UT0946JJ0100 Rev.1.00
2012.10.1

パネルの一覧
機能概要

リアルタイム OS のリソース情報（システム情報，タスク情報など）を表示します。

Page 10 of 23

パートナー OS 対応デバッグプラグイン

付録 A ウインドウリファレンス

リソース情報 パネル
リアルタイム OS のリソース情報（システム情報，タスク情報など）を表示します。
必要に応じて，コンテキストメニューの [ 新規リソースを追加 ] により表示項目を追加してください。表示項目はリ
アルタイム OS によって異なります。

図 A―1 リソース情報 パネル

ここでは，次の項目について説明します。
- ［オープン方法］- ［表示内容］- ［[ ファイル ] メニュー］- ［[ 編集 ] メニュー］- ［コンテキストメニュー］［オープン方法］- ［表示］メニュー→［リアルタイム OS］→［リソース情報］を選択［表示内容］
ヘッダ名称

内容

リソース

タスクやセマフォなどのリソースタイプ

ID

リソース ID

名称

タスクやハンドラの開始アドレスシンボルまたはリソース名称

種類

状態や数などのリソース情報の種類

値

リソース情報の値

アドレス

値が格納されているアドレス

R20UT0946JJ0100 Rev.1.00
2012.10.1

Page 11 of 23

パートナー OS 対応デバッグプラグイン
ヘッダ名称
サイズ

付録 A ウインドウリファレンス
内容

値のサイズ

［[ ファイル ] メニュー］
リソース情報パネルをアクティブにした状態で CubeSuite+ の [ ファイル ] メニューを選択すると，リソース情報パネルに関連した以下のメニューを表示します。

メニュー名称
リソースデータを保存

内容
このパネルの内容を前回保存したテキストファイル（*.txt）に保存します。
なお，起動後に初めてこの項目を選択した場合は，［名前を付けてリソースデータを保存 ...］の選択と同等の動作となります。
プログラム実行中は無効となります。

名前を付けてリソースデータを保存

このパネルの内容を指定したテキストファイル（*.txt）に保存するために，...

名前を付けて保存 ダイアログをオープンします。
プログラム実行中は無効となります。

［[ 編集 ] メニュー］
リソース情報パネルをアクティブにした状態で CubeSuite+ の [ 編集 ] メニューを選択すると，リソース情報パネルに関連した以下のメニューを表示します。

メニュー名称削除

内容
選択している項目を削除します。
項目が選択されてない場合は無効となります。
プログラム実行中は無効となります。

［コンテキストメニュー］
コンテキストメニューはリソース情報パネル上でマウスを右クリックすることにより表示されます。

メニュー名称
リアルタイム表示更新設定

内容
リアルタイム表示更新機能の設定を行うため，プロパティパネルをオープンします。
プログラム実行中は無効となります。

最新の情報に更新
新規リソースを追加 ...

最新の情報に更新します。
新規リソースを登録します。

［リソース選択］ダイアログボックスを表示します。
追加したリソースは最下行に表示されます。
なお，1 つのタブに登録可能なリソース数は，最大 1000 個までです。
プログラム実行中は無効となります。

R20UT0946JJ0100 Rev.1.00
2012.10.1

Page 12 of 23

パートナー OS 対応デバッグプラグイン

付録 A ウインドウリファレンス

メニュー名称
リソースを編集 ...

内容
選択したリソースを編集します。

［リソース選択］ダイアログボックスを表示します。
項目が選択されてない場合や複数の項目が選択されている場合は無効となります。
プログラム実行中は無効となります。
削除

選択している項目を削除します。
項目が選択されてない場合は無効となります。
プログラム実行中は無効となります。

表記

表示形式を指定するため，次のカスケード・メニューを表示します。
項目が選択されてない場合は無効となります。
プログラム実行中は無効となります。

ソースへジャンプ

自動

選択している項目の表記を自動で設定します。

16 進数

選択している項目を 16 進数で表示します。

10 進数

選択している項目を 10 進数で表示します。

エディタ パネルをオープンし，タスクやハンドラのソースを表示します。
項目が選択されてない場合や複数の項目が選択されている場合は無効となります。
プログラム実行中は無効となります。

OS 選択 ...

［OS 選択］ダイアログボックスを開きます。
プログラム実行中は無効となります。

R20UT0946JJ0100 Rev.1.00
2012.10.1

Page 13 of 23

パートナー OS 対応デバッグプラグイン

付録 A ウインドウリファレンス［リソース選択］ダイアログボックス
リソース情報パネルに表示するリソース情報を選択します。ID 番号は一つまたはすべての選択が可能です。選択できるリソースの内容はリアルタイム OS によって異なります。

図 A―2 ［リソース選択］ダイアログボックス

ここでは，次の項目について説明します。
- ［オープン方法］- ［選択内容］［オープン方法］- リソース情報 パネルのコンテキストメニューの [ 新規リソースを追加 ] または [ リソースを編集 ] を選択［選択内容］
選択項目
リソース
ID 番号

内容
リソースのタイプを選択します。

すべて全ての ID 番号を指定します。

選択

一つの ID 番号を指定します。
ID 番号を入力するか，または [ 選択 ] ボタンをクリックし，［ID 選択］ダ

イアログボックスを開き，一覧の中から ID 番号を選択します。
種類

R20UT0946JJ0100 Rev.1.002012.10.1

リソース情報の種類を選択します。

Page 14 of 23

パートナー OS 対応デバッグプラグイン

付録 A ウインドウリファレンス［ID 選択］ダイアログボックス
リソース ID を一覧から選択します。

図 A―3 ［ID 選択］ダイアログボックス

ここでは，次の項目について説明します。
- ［オープン方法］［オープン方法］- ［リソース選択］ダイアログボックスの [ 選択 ] ボタンを選択

R20UT0946JJ0100 Rev.1.00
2012.10.1

Page 15 of 23

パートナー OS 対応デバッグプラグイン

付録 A ウインドウリファレンス［OS 選択］ダイアログボックス
使用するリアルタイム OS を選択します。

図 A―4 ［OS 選択］ダイアログボックス

ここでは，次の項目について説明します。
- ［オープン方法］［オープン方法］- プログラムダウンロード時に自動的にオープン- リソース情報 パネルのコンテキストメニューの [OS 選択 ] を選択

R20UT0946JJ0100 Rev.1.00
2012.10.1

Page 16 of 23

パートナー OS 対応デバッグプラグイン付録 B メッセージ

付録 B

メッセージ

本付録では，パートナー OS 対応デバッグプラグインが出力するメッセージについて説明します。メッセージは，出力パネル，またはメッセージ ダイアログなどに出力されます。

B. 1

フェイタルエラー
表 B―1

フェイタルエラー

番号E1160020

E1160021

E1160022

E1160023

B. 2

内容
メッセージ

ファイルのオープンに失敗しました。

説明

ファイルをオープンすることができません。

対処方法

ファイルがアクセスできる状態か確認してください。

メッセージ

ファイルの読み込みに失敗しました。

説明

ファイルを読み込むことができません。

対処方法

ファイルが読み込み可能な状態か確認してください。

メッセージ

ファイルの書き込みに失敗しました。

説明

ファイルを書き込むことができません。

対処方法

ファイルが書き込み可能な状態か確認してください。

メッセージ

ファイルのクローズに失敗しました。

説明

ファイルをクローズすることができません。

対処方法

ファイルがアクセスできる状態か確認してください。

ワーニング
表 B―2

ワーニング

番号W1160020

内容
メッセージ

リソース情報パネルのタブに登録可能なリソースの上限 (1000 個 ) を越えました。

説明

登録可能なリソースの上限を超えました。1 つのタブに登録可能なリソース数は，最大1000 個までです。

W1160021

対処方法

不要なリソースを削除するか，別のタブに登録してください。

メッセージ

登録可能なリソースはありません。

説明

指定されたリソースは存在しません。

対処方法

有効なリソースを指定してください。

R20UT0946JJ0100 Rev.1.00
2012.10.1

Page 17 of 23

パートナー OS 対応デバッグプラグイン
番号
W1160022

付録 B メッセージ
内容

メッセージ

指定 ID 番号は無効です。

説明

指定された ID 番号は存在しません。

対処方法

有効な ID 番号を指定してください。

R20UT0946JJ0100 Rev.1.00
2012.10.1

Page 18 of 23

パートナー OS 対応デバッグプラグイン

付録 C

付録C 注意事項

注意事項

本付録では，注意事項について説明します。

C. 1

注意事項
表 C―1
項目

全般

注意事項
内容

パートナー OS 対応デバッグプラグインを使用する際は，デバッグ情報が出力されたプログラムをダウンロードしてください。
コンパイラ，アセンブラ等のツールチェインのビルドオプションをリアルタイム
OS 提供時のビルドオプションから変更した場合，本デバッグ機能が正常に動作しない場合があります。
パネルを参照する場合は，リアルタイム OS 初期化後に参照してください。
プログラム実行中は正常に表示されない場合があります。

Smalight OS

タスク ID 255 は OS カーネルのアイドリングを意味します。

μT-Kernel

コンフィギュレーションファイル（config.h, config.inc）の最小 ID（MIN_TSKID など）、最小優先度（MIN_PRI）、デバッガサポート機能（USE_DBGSPT）およびオブジェクト名称機能（USE_OBJECT_NAME）は 1 に設定してください。

μC/OS

コンフィギュレーションファイル（os_cfg.h, cpu_cfg.h）の内容を初期値から変更した場合，本デバッグ機能が正常に動作しない場合があります。
本プラグインに表示されるタスク ID はデバッガ用内部 ID であり，μC/OS のタス
ク ID とは異なります。
リソース情報パネルで表示可能な最大タスク ID は 255 です。

embOS

XR ライブラリ使用時はタスク名称は表示されません。
本プラグインに表示されるタスク ID はデバッガ用内部 ID であり，embOS のタス
ク ID とは異なります。
リソース情報パネルで表示可能な最大タスク ID は 255 です。

R20UT0946JJ0100 Rev.1.00
2012.10.1

Page 19 of 23

改訂記録
改訂内容
Rev.

発行日
ページ

1.00

2012.10.01

−ポイント
初版発行

CubeSuite+ パートナー OS 対応デバッグプラグイン
ユーザーズマニュアル
発行年月日 2012 年 10 月 1 日 Rev.1.00
発行

ルネサス エレクトロニクス株式会社〒 211-8668 神奈川県川崎市中原区下沼部 1753

http://www.renesas.com‫ع‬༡ᬺ߅໧วߖ⓹ญ̪༡ᬺ߅໧วߖ⓹ญߩ૑ᚲ࡮㔚⹤⇟ภߪᄌᦝߦߥࠆߎߣ߇޽ࠅ߹ߔ‫ᦨޕ‬ᣂᖱႎߦߟ߈߹ߒߡߪ‫ޔ‬ᑷ␠ࡎ࡯ࡓࡍ࡯ࠫࠍߏⷩߊߛߐ޿‫ޕ‬࡞ࡀࠨࠬ ࠛ࡟ࠢ࠻ࡠ࠾ࠢࠬ⽼ᄁᩣᑼળ␠‫ޥޓ‬100-0004‫ޓ‬ජઍ↰඙ᄢᚻ↸2-6-2㧔ᣣᧄࡆ࡞㧕(03)5201-5307‫ع‬ᛛⴚ⊛ߥ߅໧วߖ߅ࠃ߮⾗ᢱߩߏ⺧᳞ߪਅ⸥߳ߤ߁ߙ‫ޕ‬‫✚ޓ‬ว߅໧วߖ⓹ญ㧦http://japan.renesas.com/contact/© 2012 Renesas Electronics Corporation. All rights reserved.
Colophon 1.1

CubeSuite+
パートナー OS対応デバッグプラグイン

R20UT0946JJ0100