第20章  コンフィギュレータcfg600


本章では,コンフィギュレータcfg600について解説しています。

20.1 概  要

RI600V4が提供している機能を利用したシステム(ロード・モジュール)を構築する場合,RI600V4に提供するデータを保持した情報ファイルが必要となります。

基本的に情報ファイルは,規定された形式のデータ羅列であるため,各種エディタを用いて記述することは可能です。しかし,情報ファイルは,記述性/可読性の面で劣ったものとなっているため,記述に際してはかなりの時間と労力を必要とします。

そこで,RI600V4では,記述性/可読性の面で優れたシステム・コンフィギュレーション・ファイルから情報ファイルへと変換するユーティリティ・ツール(コンフィギュレータcfg600)を提供しています。

cfg600は,システム・コンフィギュレーション・ファイルを入力ファイルとして読み込んだあと,情報ファイルを出力します。

以下に,cfg600が出力する情報ファイルについて示します。

- システム情報ヘッダ・ファイル(kernel_id.h)
システム・コンフィギュレーション・ファイルに記述されたオブジェクト名(タスク名,セマフォ名など)とIDの対応付けを保持した情報ファイルです。アプリケーションからインクルードします。


- サービス・コール定義ファイル(kernel_sysint.h)
サービス・コールをINT命令を用いて呼び出すための宣言が記述されたファイルです。kernel.hからインクルードされます。


- ROM定義ファイル(kernel_rom.h),RAM定義ファイル(kernel_ram.h)
RI600V4の管理データが記述されたファイルです。これらのファイルは,ブート処理のソースでのみ,インクルードする必要があります。詳細は,「16.2.1 ブート処理関数(PowerON_Reset_PC( ))」を参照してください。


- システム定義ファイル(ri600.inc)
システム定義ファイルは,mkritblが出力するテーブル・ファイル(ritable.src)からインクルードされます。


- ベクタ・テーブル・テンプレート・ファイル(vector.tpl)
ベクタ・テーブル・テンプレート・ファイルは,mkritblへの入力ファイルとなります。


- CMTタイマ定義ファイル(ri_cmt.h)
基本クロック割り込み情報(clock)基本クロック用タイマ・チャネルの選択(timer)にCMT0,CMT,CMT2,CMT3のいずれかを指定した場合は,テンプレート・ファイル(template)で指定されたテンプレートファイルが環境変数LIB600から検索され,ri_cmt.hにリネームされて出力されます。CMTタイマ定義ファイルは,ブート処理のソースでのみ,インクルードする必要があります。詳細は,「16.2.1 ブート処理関数(PowerON_Reset_PC( ))」を参照してください。


20.2 cfg600の起動

20.2.1 コマンド・ラインからの起動

事前に,環境変数“LIB600”を,“<ri_root>\lib600”に設定する必要があります。

以下に,cfg600をコマンド・ラインから起動する際の起動方法を示します。

ただし,入力例中の“C>”はコマンド・プロンプトを,“△”はスペース・キーの入力を,“[Enter]”はエンター・キーの入力を表しています。

また,“[ ]”で囲まれたオプションは,省略可能なオプションであることを表しています。

C> cfg600.exe△[-U]△[-v]△[ -V]△file[Enter]



出力ファイルは,カレント・フォルダに生成されます。

以下に,各オプションの詳細を示します。

- -U
未定義割り込みが発生した時にはシステム・ダウンとなりますが,本オプションを指定すると,発生した割り込みのベクタ番号がシステム・ダウン・ルーチンに渡されるようになる(「第13章 システム・ダウン」を参照)ため,デバッグに役立ちます。ただし,RI600V4のコード・サイズが約1.5KB増加します。


- -v
コマンドのオプションの説明と詳細なバージョンを表示します。


- - V
cfg600が生成するファイルの作成状況を表示します。


- file
cfg600への入力ファイル名(システム・コンフィギュレーション・ファイル名)を指定します。拡張子を省略した場合は,拡張子“.cfg”を補って解釈します。

備考 <ri_root>は,RI600V4のインストール・フォルダを表しています。
デフォルトでは,“ C:\Program Files\Renesas Electronics\CubeSuite+\RI600V4”となります。


20.2.2 CubeSuite+からの起動

プロパティ パネル[システム・コンフィギュレーション・ファイル関連情報]タブで設定した内容に基づき,CubeSuite+のビルド時に起動されます。