新しいプロジェクトを作成する

2.3.2 新しいプロジェクトを作成する

新規にプロジェクトを作成する方法について説明します。

備考	RH850のマルチコア用プロジェクトを作成する場合は，「2.3.4 マルチコア用プロジェクトを作成する【RH850】」を参照してください。

［プロジェクト］メニュー→［新しいプロジェクトを作成...］を選択すると，プロジェクト作成ダイアログがオープンします。

図 2.6

プロジェクト作成ダイアログ（初回起動時）

以下の順番で項目を設定します。

(1)	マイクロコントローラの種類を選択

［マイクロコントローラ］において，プロジェクトで使用するマイクロコントローラの種類を選択します。

以下の項目を選択することができます。

RH850

RL78

(2)	マイクロコントローラを選択

［使用するマイクロコントローラ］エリアにおいて，プロジェクトで使用するマイクロコントローラを選択します。

［使用するマイクロコントローラ］エリアに使用するマイクロコントローラがない場合は，［アップデート...］ボタンをクリックしてください。

CS+ アップデート・マネージャウインドウがオープンし，ネットワークを介してマイクロコントローラの最新情報を検索することができます。

注意	［アップデート...］ボタンは，インストーラを使用して本製品をインストールした場合のみ有効となります。パックしたものを使用する場合は無効となります。

(3)	プロジェクトの種類を選択

［プロジェクトの種類］において，作成するプロジェクトの種類を選択します。

以下の項目を選択することができます。

-	アプリケーション（CC-RH/CC-RX/CC-RL）

CS+が提供するビルド・ツールを使用して，Cソース・ファイルからロード・モジュール・ファイル，およびヘキサ・ファイルを生成する場合に選択します。

ここで生成するファイルが自動的にデバッグ対象となります。

注意	本項目は，「(2) マイクロコントローラを選択」でRH850マルチコア対応版マイクロコントローラを選択した場合は表示されません。

備考 1.

ビルド・ツールがCC-RHの場合，プロジェクト作成時に以下のスタートアップ用ソース・ファイルがプロジェクト・フォルダに生成されます。
これらのファイルは，プロジェクト・ツリーにも登録されます。

ファイル名	説明
boot.asm	リセットの発生からスタートアップ・ルーチンに分岐するまでの処理の定義と割り込みベクタ・テーブルの定義
cstart.asm	スタートアップ・ルーチンの定義
iodefine.h	I/Oレジスタの定義
main.c	空のmain関数の定義

備考 2.

ビルド・ツールがCC-RXの場合，プロジェクト作成時に以下のスタートアップ用ソース・ファイルがプロジェクト・フォルダに生成されます。
“プロジェクト・ツリー登録”欄が“○”となっているファイルは，プロジェクト・ツリーにも登録されます。“－”となっているファイルは，必要に応じてプロジェクト・ツリーに登録してください。

ファイル名	説明	プロジェクト・ツリー登録
プロジェクト名.c	main関数の定義	○
dbsct.c	標準セクションの設定	○
hwsetup.c	ハードウェア初期化用ファイル	－
intprg.c	割り込み関数の定義	○
iodefine.h	I/Oレジスタの定義	○
lowlvl.src	I/O入出力用低レベル関数の定義（アセンブラ用ソース）	－
lowsrc.c	I/O入出力用低レベル関数の定義	－
lowsrc.h	I/O入出力用低レベル関数のプロトタイプ	－
resetprg.c	C言語用初期化の定義	○
sbrk.c	ヒープ・メモリ確保用関数の定義	○
sbrk.h	ヒープ・サイズの定義	○
stacksct.h	スタック用pragmaの定義	○
typedefine.h	sbrk.cなどで使用する型のtypedefineの定義	○
vect.h	割り込みベクタ関数のプロトタイプ	○
vecttbl.c	割り込みベクタ・テーブルの定義	○

備考 3.

ビルド・ツールがCC-RLの場合，プロジェクト作成時に以下のスタートアップ用ソース・ファイルがプロジェクト・フォルダに生成されます。
これらのファイルは，プロジェクト・ツリーにも登録されます。

ファイル名	説明
cstart.asm	リセットの発生からmain関数に分岐するまでのスタートアップ・ルーチンの定義メモリ・アドレス，スタック領域などは，ご使用のマイコンに合わせて修正が必要です。
iodefine.h	I/Oレジスタの定義，および割り込み要求名の定義
main.c	空のmain関数の定義

-	C++アプリケーション（CC-RX）

CS+が提供するビルド・ツールCC-RXを使用して，C++ソース・ファイル（main関数のファイルのみ），およびCソース・ファイルからロード・モジュール・ファイル，またはヘキサ・ファイルを生成する場合に選択します。
ここで生成するファイルが自動的にデバッグ対象となります。

備考	プロジェクト作成時に以下のスタートアップ用ソース・ファイルがプロジェクト・フォルダに生成されます。 “プロジェクト・ツリー登録”欄が“○”となっているファイルは，プロジェクト・ツリーにも登録されます。“－”となっているファイルは，必要に応じてプロジェクト・ツリーに登録してください。

ファイル名	説明	プロジェクト・ツリー登録
プロジェクト名.cpp	main関数の定義	○
dbsct.c	標準セクションの設定	○
hwsetup.cpp	ハードウェア初期化用ファイル	－
intprg.c	割り込み関数の定義	○
iodefine.h	I/Oレジスタの定義	○
lowlvl.src	I/O入出力用低レベル関数の定義（アセンブラ用ソース）	－
lowsrc.c	I/O入出力用低レベル関数の定義	－
lowsrc.h	I/O入出力用低レベル関数のプロトタイプ	－
resetprg.c	C言語用初期化の定義	○
sbrk.c	ヒープ・メモリ確保用関数の定義	○
sbrk.h	ヒープ・サイズの定義	○
stacksct.h	スタック用pragmaの定義	○
typedefine.h	sbrk.cなどで使用する型のtypedefineの定義	○
vect.h	割り込みベクタ関数のプロトタイプ	○
vecttbl.c	割り込みベクタ・テーブルの定義	○

-	空のアプリケーション（CC-RH/CC-RX/CC-RL/GHS CCRH850）

CS+が提供するビルド・ツールCC-RH/CC-RX/CC-RLまたはGHS CCRH850用ビルド・ツール・プラグインを使用して，ロード・モジュール・ファイルを生成する場合に選択します。
ここで生成するファイルが自動的にデバッグ対象となります。
なお，プロジェクト作成時にサンプルのスタートアップ・プログラムは生成しません。

-	マルチコア用ブート・ローダ(CC-RH)

CS+が提供するビルド・ツールCC-RHを使用して，マルチコア用ブート・ローダ・プロジェクトを作成する場合に選択します。

ブート・ローダ・プロジェクトでは，マルチコア用プロジェクトを構成するアプリケーション・プロジェクトの設定などを行います。

注意	本項目は，「(2) マイクロコントローラを選択」でRH850マルチコア対応版マイクロコントローラを選択した場合のみ表示されます。

備考	プロジェクト作成時に以下のスタートアップ用ソース・ファイルがプロジェクト・フォルダに生成されます。これらのファイルは，プロジェクト・ツリーにも登録されます。

ファイル名	説明
bootn.asm	リセットの発生から各アプリケーション・プロジェクトに分岐するまでの処理の定義と割り込みベクタ・テーブルの定義
iodefine.h	I/Oレジスタの定義

コア用のスタートアップ・ファイル（bootn.asm）は，ファイル名にコア番号nを含むことがあります。

-	マルチコア用アプリケーション(CC-RH)

CS+が提供するビルド・ツールCC-RHを使用して，マルチコア用アプリケーション・プロジェクトを作成する場合に選択します。

注意	本項目は，「(2) マイクロコントローラを選択」でRH850マルチコア対応版マイクロコントローラを選択した場合のみ表示されます。

備考	プロジェクト作成時に以下のスタートアップ用ソース・ファイルがプロジェクト・フォルダに生成されます。これらのファイルは，プロジェクト・ツリーにも登録されます。

ファイル名	説明
cstartn.asm	各アプリケーションごとのスタートアップ・ルーチンの定義
iodefine.h	I/Oレジスタの定義
main.c	空のmain関数の定義

コア用のスタートアップ・ファイル（cstartn.asm）は，ファイル名にコア番号nを含むことがあります。

-	既存GHSプロジェクト・ファイル使用(GHS CCRH850)

GHSコンパイラでビルドしたロード・モジュールをデバッグ対象とする場合に選択します。

既存のGHSプロジェクト・ファイルを使用して簡単にビルドを行うことができます。

プロジェクトの作成方法，および使用方法については，ビルド・ツール操作編を参照してください。

-	ライブラリ（CC-RH/CC-RX/CC-RL/GHS CCRH850）

CS+が提供するビルド・ツールCC-RH/CC-RX/CC-RLまたはGHS CCRH850用ビルド・ツール・プラグインを使用して，ユーザ・ライブラリ用のライブラリ・ファイルを生成する場合に選択します。

デバッグ専用

CS+が提供するビルド・ツール以外のビルド・ツールが生成したロード・モジュール・ファイル，またはヘキサ・ファイルをデバッグ対象とする場合に選択します（デバッグ専用プロジェクト）。
デバッグ専用プロジェクトの作成方法，および使用方法についての詳細は，「E. 外部ビルド・ツールの使用」を参照してください。

(4)	プロジェクト名とプロジェクト・ファイルの作成場所を指定

［プロジェクト名］，および［作成場所］に，プロジェクト名とプロジェクト・ファイルの作成場所を指定します。

指定した作成場所の下にプロジェクト名のフォルダを作成しない場合は，［プロジェクト名のフォルダを作成する］のチェックを外してください。

注意 1.

プロジェクト・ファイルの作成場所を直接入力する場合は，絶対パスで入力してください。

注意 2.

作成場所にネットワークパス名は使用できません。ドライブ名に割り当てて使用してください。

備考	作成場所には流用元プロジェクトと同じフォルダを指定することを推奨します。流用元プロジェクトと異なるフォルダを指定した場合，パス解決に失敗し，ビルド・エラーとなる可能性があります。

(5)	既存のプロジェクトのファイル構成の流用を指定

既存のプロジェクトのファイル構成を流用してプロジェクトを作成する場合は，［既存のプロジェクトのファイル構成を流用する］をチェックし，［流用元のプロジェクト］に流用元のプロジェクト・ファイル名を指定してください。

注意 1.

e2 studio，CubeSuite，High-performance Embedded Workshop，PM+のプロジェクト・ファイルを指定することはできません。
e2 studio，CubeSuite，High-performance Embedded Workshop，PM+のプロジェクトを流用したい場合は，いったん，CS+でそのプロジェクトを開いて，CS+のプロジェクトとして保存してください（「2.4.10 e2 studioのプロジェクトをCS+のプロジェクトに変換する【RX】【RL78】」，「2.4.11 CubeSuiteのプロジェクトをCS+のプロジェクトに変換する」，「2.4.12 HEWのプロジェクトをCS+のプロジェクトに変換する」，「2.4.13 PM+のプロジェクトをCS+のプロジェクトに変換する」参照）。そのあと，保存したプロジェクト・ファイルをこのエリアに指定してください。

注意 2.

作成するプロジェクトにてデフォルトで選択されているデバッグ・ツールに対してのみ，流用した設定を反映します。
ただし，RXファミリについては，内部処理がエミュレータ，シミュレータで共通となっているため，デバッグ・ツールの選択状態にかかわらず流用した設定を反映します。

備考 1.

流用元のプロジェクトで使用しているビルド・ツールのバージョンと，作成するプロジェクトのバージョンが異なる場合は，自動的に変換します（［プロジェクトの種類］において“デバッグ専用”を指定した場合を除く）。

備考 2.

ビルド・ツールのプロパティの設定に流用元のオプションを適用後，指定されたマイクロコントローラの設定に変更します。指定したマイクロコントローラのiodefine.h およびスタートアップ用ソース・ファイルをサンプルソースとして，"<変更後デバイス名>.nnn"（nnn=000,001…）という名前のフォルダを作成し，そこにコピーします。変更内容を出力パネルに表示します。
流用元とROMサイズが異なるマイクロコントローラを選択した場合，［リンク・オプション］タブの［セクションの開始アドレス］プロパティの値にROMサイズの差異が反映されないことがあります。［セクションの開始アドレス］プロパティの値を確認してください。

項目設定後のイメージを以下に示します。

図 2.7

プロジェクト作成ダイアログ（項目設定後）

［作成］ボタンをクリックすると，(4)で指定した場所にプロジェクト・ファイルを作成し，プロジェクト・ツリーパネルに作成したプロジェクトの構成がツリー表示されます。

図 2.8

プロジェクト・ツリーパネル（新規プロジェクト作成後）

備考	プロジェクト作成後，ビルド・フェーズ，またはデバッグ・フェーズに進むためには，対象となるファイルをプロジェクトに追加する必要があります。ファイルの追加方法については，以下を参照してください。

-	［プロジェクトの種類］において“アプリケーション”または“ライブラリ”を選択した場合

→「2.6.1 プロジェクトにファイルを追加する」参照

-	［プロジェクトの種類］において“デバッグ専用”を選択した場合

→「E.3 プロジェクトにファイルを追加する」参照