第 4 版 2007 年 4 月 CS0001(E)1107
HEW の 設 定 目 次 HEW の 設 定 資 料 構 成 Chapter 1. はじめに 3 1-1 資 料 内 容 3 1-2 注 意 事 項 3 Chapter 2. HEWの 設 定 4 2-1 HEW3/HEW4 の 設 定 5 2-2 HEW2/HEW3 の 設 定 12 2-3 HEWの 設 定 16 Chapter 3. CSIDEへのダウンロード 19 3-1 ELF/DWARF2 ファイル 形 式 でダウンロード 19 3-2 ファイル コンバータを 使 用 してCTX 形 式 に 変 換 してダウンロード 20 3-2-1 自 動 変 換 機 能 で 変 換 21 3-2-2 コマンドプロンプトで 変 換 24 3-2-3 ビルドフェーズへのコンバータの 組 込 み 25-2 -
HEW の 設 定 はじめに Chapter 1.はじめに 1-1 資 料 内 容 CSIDE は コンパイラから 出 力 されたデバッグ 情 報 を 読 み 込 むことで 高 級 言 語 レベルのデバッグを 実 現 して いるため ロードするオブジェクト ファイルにデバッグ 情 報 が 含 まれていない 場 合 には 高 級 言 語 レベルでデ バッグを 行 なうことは 出 来 ません このためコンパイル 時 には デバッグ 情 報 が 出 力 されるよう 設 定 しておく 必 要 があります 本 資 料 では HEW/HEW2/HEW3/HEW4 を 使 用 してデバッグ 情 報 付 きオブジェクト ファイルを 作 成 するための 設 定 から CSIDE のファイルロード 設 定 までを 初 めて CSIDE をご 使 用 になる 方 や HEW のどこを 設 定 すればよい のかわからない 方 などに 向 けて 解 説 を 行 ないます 資 料 中 の HEW の 解 説 に 関 して SuperH ファミリを 元 にして 説 明 を 行 っておりますが H8 ファミリをお 使 いの 方 も この 資 料 を 元 にして 設 定 を 行 ってください また 途 中 SuperH ファミリと H8 ファミリとで 説 明 が 分 かれる 部 分 が ありますので その 部 分 はお 使 いの CPU に 合 わせて 設 定 を 行 ってください CSIDE のバージョンが Ver.4.0 以 上 ですと ビルドは HEW デバッグは CSIDE と 使 い 分 けるのではなく ビルド からデバッグまでの 全 てを CSIDE 上 で 行 なうことが 可 能 な 統 合 開 発 環 境 がございますので ご 使 用 になられる 場 合 は 別 資 料 をご 用 意 しておりますのでそちらをご 覧 ください CSIDE 付 属 のオンラインマニュアルの[ 対 応 言 語 について] 欄 にも 設 定 について 記 載 されておりますので 合 わせてご 覧 ください 1-2 注 意 事 項 本 資 料 の 対 応 コンパイラパッケージ 本 資 料 はルネサステクノロジ 社 製 コンパイラパッケージの SHC Ver.6.xx 以 降 H8C Ver.4.xx, 以 降 に 関 する 資 料 になっており SHC Ver.5.xx 以 前,H8C Ver.3.xx 以 前 のバージョンには 対 応 していませんのでご 注 意 ください また HEW3 をお 使 いの 方 はご 使 用 のコンパイラパッケージによって 資 料 の 参 照 していただく 項 目 が 違 いま すのでご 注 意 ください SuperH H8S,H8/300H HEW HEW HEW2 HEW3 HEW4 パッケージVer 5.xx 6.xx 7.xx 7.1.03 8.xx 9.xx 9.xx 対 応 パッケージVer 3.xx 4.xx 5.xx 5.0.06 6.xx 6.xx 対 応 - 3 -
HEW の 設 定 HEW の 設 定 Chapter 2.HEW の 設 定 本 章 では CSIDE で 高 級 言 語 レベルデバッグを 行 なうために 必 要 なデバッグ 情 報 付 きのオブジェクト ファイル(ELF/DWARF 形 式 )を 作 成 するための HEW の 設 定 について 解 説 していきます ご 使 用 の HEW のバージョンに 合 わせて 説 明 をご 覧 頂 き HEW の 設 定 を 行 なってください HEW3 をご 使 用 の 場 合 の 注 意 点 HEW3 にはコンパイラパッケージが SuperH では Ver.7.1.03 と Ver.8.xx 以 降 H8 では Ver.5.0.06 と Ver.6.xx のものが 存 在 します 本 資 料 をご 覧 になる 場 合 に 同 じ HEW3 であっても コンパイラパッケージのバージョンによって 参 照 していただく 項 目 が 以 下 のように 異 なります のでご 注 意 ください コンパイラパッケージバージョン SuperH Ver.7.1.03 HEW2/HEW3 の 設 定 12ページへ Ver.8.xx 以 降 HEW3/HEW4 の 設 定 5ページへ H8 Ver.5.0.06 HEW2/HEW3 の 設 定 12ページへ Ver.6.xx HEW3/HEW4 の 設 定 8ページへ - 4 -
HEW の 設 定 HEW の 設 定 2-1 HEW3/HEW4 の 設 定 SuperH Compiler Package Ver.9.xx / Ver.8.xx メニューバー[オプション] - [ SuperH RISC engine Standard Toolchain] を 開 き 以 下 の 手 順 に 従 って 設 定 を 行 ってください コンパイラ [コンパイラ]タブ カテゴリ - [オブジェクト]にて [デバッグ 情 報 出 力 ]にチェックを 入 れてください [コンパイラ]タブ カテゴリ - [ 最 適 化 ]にて [ 最 適 化 ]のチェックをはずしてください - 5 -
HEW の 設 定 HEW の 設 定 アセンブラ [アセンブラ]タブ カテゴリ - [オブジェクト]にて [デバッグ 情 報 出 力 ]に [デバッグ 情 報 出 力 あり]を 選 択 してください - 6 -
HEW の 設 定 HEW の 設 定 リンカ [ 最 適 化 リンカ]タブ カテゴリ - [ 出 力 ]にて [ 出 力 形 式 ]に[アブソリュート(ELF/DWARF)]を 選 択 してください [デバッグ 情 報 ]に[ 出 力 ( 出 力 ファイル 内 )]を 選 択 してください [ 最 適 化 リンカ]タブ カテゴリ - [ 最 適 化 ]にて [ 設 定 ]に[ 最 適 化 なし]を 選 択 してください - 7 -
HEW の 設 定 HEW の 設 定 H8 Compiler Package Ver.6.xx メニューバー [オプション] - [H8S,H8/300 Standard Toolchain] を 開 き 以 下 の 手 順 に 従 って 設 定 を 行 っ てください コンパイラ [コンパイラ]タブ カテゴリ - [オブジェクト]にて [デバッグ 情 報 出 力 ]にチェックを 入 れてください [コンパイラ]タブ カテゴリ - [ 最 適 化 ]にて [ 最 適 化 ]のチェックをはずしてください - 8 -
HEW の 設 定 HEW の 設 定 対 象 CPU が H8-300H の 場 合 [コンパイラ]タブ カテゴリ - [ 最 適 化 ]にて [ 最 適 化 方 法 ]で[スピード 優 先 最 適 化 ]を 選 択 し [スピード 優 先 最 適 化 オプション]の[レジスタ 退 避 回 復 を push,pop 展 開 ]にチェックを 入 れてください - 9 -
HEW の 設 定 HEW の 設 定 アセンブラ [アセンブラ]タブ カテゴリ - [オブジェクト]にて [デバッグ 情 報 出 力 ]に[デバッグ 情 報 出 力 ]を 選 択 してください [ 最 適 化 ]のチェックをはずしてください - 10 -
HEW の 設 定 HEW の 設 定 リンカ [ 最 適 化 リンカ]タブ カテゴリ - [ 出 力 ]にて [ 出 力 形 式 ]に[アブソリュート(ELF/DWARF)]を 選 択 してください [デバッグ 情 報 ]に[ 出 力 ( 出 力 ファイル 内 )]を 選 択 してください [ 最 適 化 リンカ]タブ カテゴリ - [ 最 適 化 ]にて [ 設 定 ]に[ 最 適 化 なし]を 選 択 してください - 11 -
HEW の 設 定 HEW の 設 定 2-2 HEW2/HEW3 の 設 定 SuperH Compiler Package Ver.7.xx / H8 Compiler Package Ver.5.xx [オプション] - [ SuperH RISC engine Standard Toolchain] (H8C の 場 合 は[H8S,H8/300 Standard Toolchain]) を 開 き 以 下 の 手 順 に 従 って 設 定 を 行 ってください Compiler [C/C++]タブ - Category - [Object]にて [Generate debug information]にチェックを 入 れてください [C/C++]タブ - Category - [Optimize]にて [Optimization]のチェックをはずしてください - 12 -
HEW の 設 定 HEW の 設 定 対 象 CPU が H8-300H の 場 合 [C/C++]タブ Category - [Optimize]にて [Speed or size]で[speed oriented optimization]を 選 択 し [Speed sub-options]の[register]にチェックを 入 れてください - 13 -
HEW の 設 定 HEW の 設 定 Assembler SuperH の 場 合 - [Assembly]タブ Category - [Object]にて [Debug information]に [With debug information]を 選 択 してください H8 の 場 合 - [Assembly]タブ Category - [Object]にて [Debug information]に[with debug information]を 選 択 してください [Optimize]のチェックをはずしてください - 14 -
HEW の 設 定 HEW の 設 定 Linker [Link/Library]タブ Category - [Output]にて [Type of output file]に[absolute(elf/dwarf)]を 選 択 してください [Debug information]に[in output load module]を 選 択 してください [Link/Library]タブ Category - [Optimize]にて [Optimize]に[None]を 選 択 してください - 15 -
HEW の 設 定 HEW の 設 定 2-3 HEW の 設 定 SuperH Compiler Package Ver.6.xx / H8 Compiler Package Ver.4.xx Compiler メニューバー[Option] - [SH C/C++ Compiler]を 開 いてください [Object]タブにて[Generate debug information]にチェックを 入 れてください [Optimize]タブにて [Optimization]のチェックをはずしてください - 16 -
HEW の 設 定 HEW の 設 定 Assembler メニューバー[Option] - [SH Assembler]を 開 いてください SuperH の 場 合 - [Assembly]タブ Category - [Object]にて [Debug information]に [With debug information]を 選 択 してください H8 の 場 合 - [Assembly]タブ Category - [Object]にて [Debug information]に[with debug information]を 選 択 してください [Optimize]のチェックをはずしてください - 17 -
HEW の 設 定 HEW の 設 定 Linker メニューバー[Option]-[OptLinker]を 開 いてください [Output]タブにて [Type of output file]に[absolute(elf/dwarf)]を 選 択 してください [Debug information]に[in output load module]を 選 択 してください [Optimize]タブにて[Optimize]に[None]を 選 択 してください - 18 -
HEW の 設 定 - CSIDE へのダウンロード Chapter 3.CSIDE へのダウンロード 続 いて 本 章 では HEW の 設 定 を 行 い 作 成 したオブジェクト ファイル(abs ファイル)を CSIDE でファイル ロードする 方 法 に 関 して 説 明 します CSIDE でオブジェクト ファイルをダウンロードする 方 法 は 以 下 の 二 通 りがあります ELF/DWARF2 ファイル 形 式 でダウンロード ファイル コンバータを 使 用 して CTX 形 式 に 変 換 してダウンロード CTX 形 式 とは ELF/DWARF 形 式 から 変 換 して 生 成 するコンピューテックス 独 自 のファ イル 形 式 です 全 ての 機 種 で 二 通 りの 方 法 が 用 意 されている 訳 ではありません お 使 いの 機 種 によっては どちらか 一 方 のロード 方 法 しか 用 意 されていない 場 合 があります 双 方 ともロード 結 果 に 違 いはありませんの で どちらの 方 法 でダウンロードを 行 なってもデバッグに 影 響 はありません 3-1 ELF/DWARF2 ファイル 形 式 でダウンロード HEW から 出 力 された abs ファイルをそのままの 形 式 でダウンロードします ダウンロードするオブジェクト ファイルの 選 択 時 に ファイルの 種 類 を ELF/DWARF2 を 選 択 する ことでダウンロードすることが 出 来 ます ファイルの 種 類 に ELF/DWARF2 の 選 択 肢 がない 場 合 には この 機 能 に 未 対 応 の 機 種 になりま す この 場 合 次 に 挙 げます CTX 形 式 へ 変 換 してダウンロードを 行 なってください - 19 -
HEW の 設 定 - CSIDE へのダウンロード 3-2 ファイル コンバータを 使 用 して CTX 形 式 に 変 換 してダウンロード ELF/DWARF2 形 式 をそのままダウンロードすることが 出 来 ない 機 種 に 関 しては ファイル コンバー タ(DW22CTX.EXE)を 使 用 して CSIDE でダウンロード 可 能 な CTX 形 式 にコンバートしてからダウン ロードを 行 ないます 変 換 方 法 は CSIDE の 自 動 変 換 機 能 コマンドプロンプトでの 変 換 HEW のビ ルドフェーズを 利 用 した 変 換 の 3 通 りがありますので 何 れかの 方 法 で 変 換 を 行 ないます ファイル コンバータは CSIDE をインストールしたディレクトリの ETC フォルダ(ディフォルト 設 定 では C:\Program Files\CSIDE\Etc\"CSIDE 名 ")にコピーされています しかし お 使 いの CSIDE のバー ジョンによっては 古 いファイル コンバータがインストールされてしまいます ご 使 用 の 際 には 最 新 版 のコンバータをお 勧 めいたしますので 弊 社 ホームページからダウンロ ードしてお 使 いください コンピューテックスホームページ [ダウンロード] [ファイル コンバータ] http://www.computex.co.jp/support/download_conv.htm ファイル コンバータに 関 しての 注 意 点 使 用 コンパイラバージョンによる 対 応 バージョンの 違 い SHC ver.7 以 降 の 場 合 は dw22ctx のバージョンは ver.1.44 以 降 をご 利 用 ください H8C ver.6 の 場 合 は dw22ctx のバージョンは ver.1.60 以 降 をご 利 用 ください 変 換 時 にエラーが 表 示 された 場 合 弊 社 ホームページから 最 新 版 のファイル コンバータをダウンロードして もう 一 度 変 換 を 行 なってみてください なお ご 使 用 中 のファイル コンバータのバージョンを 確 認 するには コマンドプロンプトにてファイル コンバータの 存 在 しているパスに 移 動 して から dw22ctx と 入 力 することで 表 示 される 情 報 で 確 認 することができます オプティマイズを 有 効 にしたオブジェクト ファイルを 変 換 してダウンロードする 場 合 本 資 料 に 従 って 設 定 を 行 なった 場 合 オプティマイズ オプションは 無 効 となります これはオプティマイズの 性 質 上 有 効 にすることでプログラム 内 の 変 数 や 処 理 が 整 頓 されデバッグに 必 要 な 情 報 が 生 成 されない 事 があり その 結 果 定 義 された 変 数 の 値 が 参 照 できない 行 情 報 が 出 現 せずブレーク ポイントを 置 くことができないなどデ バッグに 制 限 がでてくるためです しかし この 制 限 をご 理 解 いただいた 上 でオプティマイズを 有 効 にしてデバッグを 行 わ れる 場 合 には オブジェクト ファイルを 変 換 する 時 に-op オプションを 付 加 して 変 換 し ていただく 必 要 があります ただし -op オプションをオプティマイズされていないオブ ジェクトに 対 して 付 加 して 変 換 されますと 正 常 に 動 作 しませんので-op の 設 定 には ご 注 意 ください 例 ) dw22ctx -op sample. abs オンラインマニュアルの[オプティマイズについて] 欄 にオプティマイズ 時 の 制 限 等 の 詳 しい 情 報 が 記 載 されていますのでお 読 みください - 20 -
HEW の 設 定 - CSIDE へのダウンロード 3-2-1 自 動 変 換 機 能 で 変 換 使 用 されている CSIDE が Ver.4.80 以 降 のバージョンの 場 合 には CTX 形 式 への 自 動 変 換 機 能 が あります この 機 能 を 使 用 することで オブジェクト ファイルのファイルロード 時 に 自 動 的 に CTX 形 式 へ 変 換 しロードを 行 なうことができ 事 前 の 変 換 操 作 を 行 なう 必 要 が 無 くなります Ver.4.80 以 降 がリリースされてない 機 種 については 自 動 変 換 機 能 がありませんので他 の 方 法 で 変 換 を 行 ってください 1.[ファイルのダウンロード]ダイアログの[ファイルの 種 類 ]のコンボボックスから CTX 変 換 を 選 択 してくださ い - 21 -
HEW の 設 定 - CSIDE へのダウンロード 2. CTX 変 換 を 選 択 すると 自 動 的 に 変 換 の 設 定 を 行 なうウィザードが 開 きます ( 初 回 設 定 時 のみ) まず 変 換 を 行 なうオブジェクト ファイルのファイルフォーマットを 選 択 します ここは ELF(DWARF2)フォーマット を 選 択 し [ 次 へ]を 押 してください 3.コンバータ のオプションの 一 覧 が 表 示 されます 必 要 に 応 じてオプションの 指 定 を 行 い 最 後 に[ 完 了 ]ボタ ンを 押 してください なお デバッグ 時 の 推 奨 オプションには 初 期 値 でチェックが 入 っています 各 オプションに 関 してはオンラインマニュアルをご 覧 ください - 22 -
HEW の 設 定 - CSIDE へのダウンロード 4.[ファイルのダウンロード]ダイアログの 表 示 に 戻 り [ファイルの 種 類 ]が CTX 変 換 となっています この 状 態 でオブジェクト ファイルを 選 択 してロードを 行 なえば 自 動 的 に ctx 形 式 に 変 換 しロードされま す 5. 二 度 目 以 降 の 自 動 変 換 の 設 定 変 更 は [ファイルのダウンロード]ダイアログの[ 詳 細 設 定 ]ボタンを 押 して 表 示 されます 以 下 のダイアログで 行 ないます [ 入 力 サポート]もしくは[ 詳 細 ]ボタンを 押 しますと GUI 形 式 で 再 設 定 が 行 なえます また ダイアログ 中 の 内 容 を 直 接 編 集 することでの 変 更 も 可 能 です - 23 -
HEW の 設 定 - CSIDE へのダウンロード 3-2-2 コマンドプロンプトで 変 換 コマンドプロンプト(DOS プロンプト)での CTX ファイルへの 変 換 方 法 について 説 明 いたします 1.コマンドプロンプトを 開 き コンバータのあるフォルダへパスを 移 動 させてください 2.コマンドを 入 力 し 変 換 を 実 行 します 入 力 するコマンドは 以 下 の 通 りです [コンバータへのパス] > dw22ctx ([-オプション]) [オブジェクト 名 ].abs 3. 変 換 実 行 すると 同 名 で 拡 張 子 が CTX のファイルが 同 じフォルダに 作 成 されます ここで 作 成 された CTX ファイルを CSIDE からロードしてください DW22CTX の 使 用 例 を 以 下 に 示 します - 24 -
HEW の 設 定 - CSIDE へのダウンロード 3-2-3 ビルドフェーズへのコンバータの 組 込 み HEW のビルドフェーズにコンバータを 組 込 むことで ビルド 実 行 時 に abs ファイルの 生 成 後 にコンバ ータを 実 行 し 自 動 的 に ctx ファイルに 変 換 し 出 力 することが 可 能 となります ビルドフェーズへの 組 込 みは 以 下 の 手 順 に 従 って 行 なってください ビルドフェーズの 組 込 み 操 作 に 関 しては HEW2 HEW3 は 共 通 の 操 作 になります HEW2/HEW3/HEW4 の 設 定 SuperH Compiler Package Ver.9.xx / Ver.8.xx / Ver.7.xx / H8 Compiler Package Ver.6.xx / Ver.5.xx 1.メニューバーの[オプション] [ビルドフェーズ]を 選 択 してください ビルドフェーズのダイアログボックスが 表 示 されますので[ビルド 順 序 ]を 選 択 し[ 追 加 ]を 押 してください 2.[ 新 規 カスタムフェーズの 作 成 ]を 選 択 し[Next]を 押 して 次 へ 進 みます - 25 -
HEW の 設 定 - CSIDE へのダウンロード 3.[ 単 一 フェーズ]を 選 択 し[ 次 へ]を 押 して 次 へ 進 みます 4. 各 欄 に 以 下 の 内 容 を 入 力 後 [Next]を 押 して 次 へ 進 みます フェーズ 名 Dw22ctx コマンド dw22ctx.exe のパスを 指 定 ( ) デフォルトオプション $(CONFIGDIR)\$(PROJECTNAME).abs 初 期 ディレクトリ $(CONFIGDIR) dw22ctx.exe は CSIDE をインストールされたフォルダの ETC 機 種 名 フォルダ 内 に あります - 26 -
HEW の 設 定 - CSIDE へのダウンロード 5.そのまま[ 完 了 ]を 押 してください 6. 完 了 しますとビルドフェーズに 追 加 されます - 27 -
HEW の 設 定 - CSIDE へのダウンロード HEW の 設 定 SuperH Compiler Package Ver.6.xx / H8 Compiler Package Ver.4.xx 1.メニューバーの[Options] [Build Phases]を 選 択 してください Build Phases のダイアログボックスが 表 示 されますので[Build Order]を 選 択 し[Add]を 押 してください 2.[Create a new c ustom phase]を 選 択 し[ Next]を 押 して 次 へ 進 みます - 28 -
HEW の 設 定 - CSIDE へのダウンロード 3.[Single phase]を 選 択 し[Next]を 押 して 次 へ 進 みます 4. 各 欄 に 以 下 の 内 容 を 入 力 後 [Next]を 押 して 次 へ 進 みます Phase name Dw22ctx Command dw22ctx.exe のパスを 指 定 ( ) Default options $(CONFIGDIR)\$(PROJECTNAME).abs Initial directory $(CONFIGDIR) dw22ctx.exe は CSIDE をインストールされたフォルダの ETC 機 種 名 フォルダ 内 にあります - 29 -
HEW の 設 定 - CSIDE へのダウンロード 5.そのまま[Finish]を 押 していただければ 完 了 です 6. 完 了 しますと Build Phases に 追 加 されます - 30 -
本 書 の 内 容 の 一 部 または 全 部 を 無 断 で 使 用 することや 複 製 することはできません 本 製 品 の 内 容 および 仕 様 に 関 しては 将 来 予 告 なしに 変 更 することがあります 本 書 に 関 する 疑 問 点 や 誤 り 記 載 もれ ご 意 見 ご 感 想 ご 要 望 などがありましたら 当 社 までご 連 絡 ください Windows は Microsoft Corporation の 登 録 商 標 です そのほか 本 書 で 取 り 上 げるプログラム 名 CPU 名 などは 一 般 に 各 メーカの 商 標 または 登 録 商 標 です CSIDE,PALMiCE および COMPUTEX は ( 株 )コンピューテックスの 登 録 商 標 です 株 式 会 社 コンピューテックス テクニカルセンタ 605-0846 京 都 市 東 山 区 五 条 橋 東 四 丁 目 432-13 對 嵐 坊 ビル 4F TEL.075(551)0373 FAX.075(551)2585 WebSite : http://www.computex.co.jp/ E-Mail : support@computex.co.jp HEW の 設 定 2007 年 4 月 第 4 版 - 31 -