２００９年 ４月２４日
ＢＹ エーワン Ｒｅｖ１．１４

統合環境ＨＥＷ（Ｖｅｒ３．０１）で H-debugger 用に新ワークスペースおよび新プロジェクト名を登録する方法（Ｈ８／Ｔｉｎｙ版）
ルネサスＣ言語用統合環境“ＨＥＷ Ｖｅｒ３．０１（ｒｅｌｅａｓｅ１）”で H-debugger 用に新ワークスペース／プロジェクト名を登録する手順方法を説明します。
説明を明確にするために、名前等を仮に決めて例に沿って説明を進めます。
ワークスペース名： NewWorkSpace2
プロジェクト名 ： Project2
登録モジュール名： Vector.asm
ＡＳＭファイル
Startup.c
Ｃファイル
H83694.c
Ｃファイル
ＣＰＵタイプ： H8/3694F

割り込みベクタテーブル
スタートアップ
メインモジュール

１．新ワークスペースの登録方法“HEW”起動させます。
“新規プロジェクトワークスペース”をチェックしてのＯＫをクリックする。
もしくは、キャンセル後に、[ファイル]-[新規ワークスペース]をクリックします。

ﾜｰｸｽﾍﾟｰｽ名
ﾌﾟﾛｼﾞｪｸﾄ名ﾃﾞｨﾚｸﾄﾘ
CPU 種別ﾂｰﾙﾁｪｲﾝﾌﾟﾛｼﾞｪｸﾄ“NewWorkSpace2”“Project2”“C:\HEW3\NewWorkSpace2”“H8S,H8/300”“Hitachi H8S,H8/300 Standard”
Application

この項目を確認後、ＯＫをクリックして下さい。

CPU ｼﾘｰｽﾞを“300H”に選択する。
CPU ﾀｲﾌﾟを“3694F”に選択する。
確認後、次へ＞をクリックします。

ＣＰＵスペックを確認後、次へ＞をクリックして下さい。

この例では、ＨＥＷの用意したＲＯＭ化支援ソフトは、一切使用しませんので全てのチェックを外して下さい。
main() 関数生成を”None”に選択する。
確認後、次へ＞クリックして下さい。

Ｃ言語ライブラリの選択です。この例
では、その他ライブラリを使用しません。
このまま、次へ＞クリックして下さい。

スタックボトムの設定ですが、この情報も使用しません。
このまま、次へ＞をクリックして下さい。

ベクターテーブル設定ファイルの設定ですが、この情報も使用しませんのでチェックを外してください。
確認後、次へ＞をクリックして下さい。

シミュレータの設定ですが、この情報も使用しません。
このまま、次へ＞クリックして下さい。

ここで最終になります。
この画面での説明はセグメントを定義するためのＣソースを表示しています
が、このソースも使用しませんので、後でプロジェクトからＲｅｍｏｖｅします。
この状態で完了をクリックして下さい。

確認画面が表示されますので、ＯＫをクリックして終了です。

次にプロジェクト名”Project2”に希望モジュール（ソースファイル）を登録する前に、不用ソースファイルを削除する方法を説明します。

２．不用なソースファイルを削除する方法[プロジェクト]-[ファイルの削除]をクリックします。

”dbsct.c”をクリックして選択すると”削除”ボタンが使用できるようになります。
削除のクリックで、”dbsct.c”を削除することが出来ます。
削除したらＯＫで終了です。

次にプロジェクト名”Poject2”に希望モジュール（ソースファイル）を登録するために、ＨＥＷに拡張子を登録する方法を説明します。

３．拡張子を登録する方法[プロジェクト]-[ファイルの拡張子]をクリックします。

追加をクリックします。

ファイル拡張子に”asm”を入力する。
既存の拡張子グループ”Assembly sourcefile”を選択する。
ＯＫをクリックします。

この操作により、プロジェクトに拡張子“＊．ａｓｍ”の登録が完了しました。

次にプロジェクト名”Project2”に希望モジュール（ソースファイル）を登録します。

４．プロジェクトに希望モジュール（ソースファイル）を登録する方法
準備： 作成済みのソースファイルを”C:\Hew3\NewWorkSpace2\Project2”にコピーして下さい。
Vector.asm
Startup.c
H83694.c
Io3694.h
HewDebugH8.h”¥sample¥HewH8T2_0¥H8_3694”(左記ソースは、製品 CDの上記フォルダに入っています。)[プロジェクト]-[ファイルの追加]をクリックします。

下記３ファイルを指定して下さい。
vector.asm
Startup.ch83694.c
選択後、追加をクリックします。
この操作により、プロジェクトにモジュールの登録が完了しました。
次に、ツール関係の設定を説明します。

５．シンボルコンバータ「ＨＣｓｙｍｃｏｎｖ」を登録する。

[オプション]-[ビルドフェーズ]をクリックします。

追加をクリックします。

次へ＞をクリックします。

単一フェーズ側にチェックをします。
次へ＞をクリックします。

フェーズ：SymbolConvert
コマンド：C:¥ProgramFiles¥Aone¥DEF¥
HCsymconv.exe を選択する。
（ﾃﾞﾌｫﾙﾄ）
初期ディレクトリ：$(CONFIGDIR)
次へ＞をクリックします。

完了をクリックします。

ＯＫをクリックします。

[オプション]-[ＳｙｍｂｏｌＣｏｎｖｅｒｔ]をクリックします。

オプションに下記内容を設定する。
"$(CONFIGDIR)¥$(PROJECTNAME) " -o "$(PROJDIR)¥$(PROJECTNAME)"（入力ファイル名）（出力先名）
注意事項
１）ディレクトリ名に‘ ’スペースを使用している場合は、“ダブルクォートで囲んで下さい。
“$(CONFIGDIR)¥$(PROJECTNAME)”-o “$(PROJDIR)¥$(PROJECTNAME)”
２）$(PROJECTNAME)の先頭に「¥」記号を挿入して下さい。
（手入力）３）オプションＳＷ「－ｏ」の両端には、スペースを入れてください。
（手入力）４）Ｃソースファイルの有る場所にシンボルコンバート後のファイルを置くのが目的ですので必ず指定して下さい。
追加事項（ＨＣｓｙｍｃｏｎｖ．ｅｘｅ スイッチ説明）
１）［－ｏ］（省略可）出力ファイル名を指定
２）［－ｒ］（省略可）モジュール毎のディレクトリ情報を作成しない。ELF専用(Ｖｅｒ３．２ｘｘから）
３）［－ｓ］（省略可）ラインシンボル情報をソート（アドレス順）しない。(Ｖｅｒ３．２ｘｘから）
４）［－ｉ］（省略可）不整合なＩｎｌｉｎｅ情報を削除する。(Ｖｅｒ３．３ｘｘから）
５）［－ｇ］（省略可）スタティック変数をグローバル化する。(Ｖｅｒ３．６ｘｘから）

６．Ｃコンパイラとアセンブラの設定
Ｃソース内に「#pragma asm」のインラインアセンブラ記述がある場合・カテゴリ「オブジェクト」の出力ファイル形式を「アセンブリプログラム(*.src)」に設定する。
・この設定にしますとシンボル情報のタイプは全てラベルになります。

全てＣ言語記述の場合・カテゴリ「オブジェクト」の出力ファイル形式を「機械語プログラム(*.obj)」に設定する。
・この設定にしますと詳細なシンボル情報を得ることなります。

全てアセンブラ記述の場合・カテゴリ「オブジェクト」のデバッグ情報を「デバッグ情報出力」に設定する。

７．ツール（ライブラリ）の設定
ＨＥＷは、プロジェクトごとにＣ言語用ライブラリを作成する仕様になっています。
ここで「すべてをビルド」してライブラリを作成および設定の確認をします。

[ビルド]-[すべてをビルド]をクリックします。

ライブライの作成を始めます。
終了後プロジェクトのファイルをコンパイルしてリンクまで実行します。この時点ではまだエラーもしくはワーニングが出ますが無視してください。

[オプション][H8S,H8/300Standard Toolchain]をクリックします。

[標準ライブラリ]タグをクリックする。

カテゴリのモードが「ライブラリファイル作成（オプション変更時）」指定になっている事を確認します。
この指定によりオプション変更時のみライブラリを作成する事になります。
ＯＫをクリックする。

次に、リンカの設定を説明します。

８．ツール（リンカ）の設定[オプション][H8S,H8/300Standard Toolchain]をクリックします。

「最適化リンカ」タグをクリックする。

カテゴリの「インプット」を選択する。
オプション項目の「ﾘﾛｹｰﾀﾌﾞﾙﾌｧｲﾙ/ｵﾌﾞｼﾞｪｸﾄﾌｧｲﾙ」を選択する。
追加をクリックする。

相対パス「Configuration Directory」に選択します。
ファイルパス「vector.obj」と入力します。
入力を確認してＯＫをクリックします。
相対パス「Configuration Directory」に選択します。
ファイルパス「startup.obj」と入力します。
入力を確認してＯＫをクリックします。

ファイルがセットされたのを確認します。
この指定は、“最初にこのリスト順にモジュールをリンクしなさい”との指示になります。
（DEF の C View にてアドレス順に他モジュールを表示させたい場合は、追加設定してください。
）（重要） 特に「startup.obj」の先頭に SP を設定するコードが記述してありますので P セクションの先頭を０ｘ８００番地にする為に必要な設定です。

カテゴリの「アウトプット」を選択する。
出力形式の「S ﾀｲﾌﾟ(ELF/DWARF ｱﾌﾞｿﾘｭｰﾄ付)」を選択する。
デバッグ情報の「ﾃﾞﾊﾞｯｸﾞ情報ﾌｧｲﾙ(*.dbg)出力」を選択する。
オプション項目の「出力ﾌｧｲﾙ/ｲﾝﾌｫﾒｰｼｮﾝ抑止」の変更をクリックします。
(重要)

シンボリックデバッグを可能にするために必要な設定です。

相対パスを「Project directry」に設定します。
ＯＫをクリックする。

(重要)この指定は、ＨＥＸファイルをＣソースファイルのある同じディレクトリに置くために必要です。

オプション項目の「ROM から RAM へのマップするセクション」を選択する。
Rom/Ram の D/R を選択クリックする。
削除をクリックする。
これで、未使用セクション名が Remove されます。

カテゴリの「セクション」を選択する。
下図のようにセクション指定をする。
0x0000VECT
0x00000800 P
CD
0xF7C0B
ＯＫをクリックする。
(重要)セクション名：VECT は、「vector.asm」で宣言しています。
０ｘＦ７Ｃ０（０ｘＦ７８０）は、ソースブレークを使用する場合の例です。
ＤＥＦバージョン６．５０ｘからソースブレークを使用する場合は、モニタワーク方式をスタック方式に選択する必要があります。
［ビルド］-[すべてをビルド]をクリックします。

「0 Error 0 Warnings」になり作業終了です。

以上