User’s Manual
High-performance Embedded Workshop V.4.09
ユーザーズマニュアル

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

www.renesas.com

Rev.1.00 2011.02

High-performance Embedded Workshop V.4.09

はじめに

はじめに
High-performance Embedded Workshopは、ルネサス マイクロコントローラの組み込み用アプリケーションの開発をサポートするツールです。おもな特徴をまとめると次のようになります。
•

GUIを用いてコンパイラ、アセンブラ、リンケージエディタなどのオプション設定のカスタマイズができるプロジェクトビルドシステム•

プログラムを読みやすくするシンタックス色付け機能を持つ統合テキストエディタ•

ユーザ独自のツールを実行するための環境設定•

同一アプリケーション内でのビルドおよびデバッグを可能にする統合化デバッガ•

バージョン管理サポート

High-performance Embedded Workshopの動作環境に関する注意事項
このユーザーズマニュアル、High-performance Embedded Workshopオンラインヘルプ、およびHigh-performance
Embedded Workshop リリースノートに記載している内容は、PC および周辺機器などのすべての機器においてHigh-performance Embedded Workshop が正常に動作することを保証するものではありません。

High-performance Embedded Workshopが生成するサンプルのソースファイルに関する注意事項
ワークスペースを作成するとマイコンに対応したサンプルのソースファイルが自動生成されます。生成された
ソースファイルのコードは一例であり、これを使用して作成したすべてのプログラムの動作を保証するものではありません。該当するマイコンのハードウェアマニュアルをご参照の上、必要に応じてコードを変更しコードの適用可否をご判断ください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

はじめにHigh-performance Embedded Workshop V.4.09

このユーザーズマニュアルについて
High-performance Embedded Workshopシステムについて述べています。High-performance Embedded Workshopの基本的な使い方に関する情報、High-performance Embedded Workshop環境のカスタマイズ、High-performance
Embedded Workshopのビルド機能、および各High-performance Embedded Workshop製品で共通なデバッグ機能について説明します。なお、SuperHファミリ用のデバッガと連携して動作した際の図を使用しています。デバッ
ガの詳細については、各製品に同梱されるエミュレータまたはシミュレータのユーザーズマニュアルおよびヘ
ルプを参照してください。
C/C++言語、アセンブリ言語の書き方や、オペレーティングシステムの使い方、個々のマイコンに適したプログラムの書き方などについては説明していません。それらについては、各々のユーザーズマニュアルを参照してください。
High-performance Embedded Workshopは、インストール上、各種言語にカスタマイズされています。このユー
ザーズマニュアルでは、High-performance Embedded Workshopアプリケーションの日本語版について説明します。

このユーザーズマニュアルの記号
このユーザーズマニュアルで使われている記号の意味を説明します。
記号[メニュー -> メニューオプション]

意味'->'はメニューオプションを示します（例: [ファイル -> 名前を付けて保存] ）。

FILENAME.C

大文字の名前はファイル名を示します。

Key + Key

キー入力を示します。
例えば、Ctrl+N キーでは Ctrl キーと N キーを同時に押します。

このユーザーズマニュアルの図について
このユーザーズマニュアルの一部の図は、実物と違っていることがあります。

商標
Microsoft, MS-DOS, Visual SourceSafe, Windows, および Windows Vista は、米国 Microsoft Corporation の米国
およびその他の国における登録商標または商標です。
その他すべての会社名および製品名は、各社の登録商標または商標です。

ホームページとサポート窓口
ルネサス エレクトロニクス ツールホームページ
http://japan.renesas.com/tools
お問合せ先
http://japan.renesas.com/inquiry

R20UT0372JJ0100 Rev.1.00
2011.02.01

目次

High-performance Embedded Workshop V.4.09

目次
1.

概要................................................................................................................................................................1
1.1

ワークスペースとプロジェクト..................................................................................................................... 1

1.2

メインウィンドウ ............................................................................................................................................ 1

1.2.1

タイトルバー ........................................................................................................................................... 2

1.2.2

メニューバー ........................................................................................................................................... 2

1.2.3

ツールバー ............................................................................................................................................... 3

1.2.4

ワークスペースウィンドウ.................................................................................................................... 6

1.2.5

エディタウィンドウ ............................................................................................................................... 8

1.2.6

アウトプットウィンドウ ....................................................................................................................... 9

1.2.7

ステータスバー ..................................................................................................................................... 13

1.3

ヘルプ機能 ...................................................................................................................................................... 14

1.4

High-performance Embedded Workshopを起動する ..................................................................................... 14

1.5

新規ワークスペースを作成する................................................................................................................... 15

1.6

ワークスペースを開く .................................................................................................................................. 16

1.7

古いワークスペースを使用する................................................................................................................... 16

1.8

ワークスペースを保存する .......................................................................................................................... 17

1.9

ワークスペースを閉じる .............................................................................................................................. 18

1.10

High-performance Embedded Workshopを終了する ..................................................................................... 18

1.11

ツールシステム概要 ...................................................................................................................................... 18

1.12

High-performance Embedded Workshop管理情報ファイル.......................................................................... 18

1.13

コンフィグレーションおよびセッションの概要....................................................................................... 19

1.14

マクロ生成支援機能とテスト支援機能の概要........................................................................................... 23

1.14.1

テストシナリオの例 ............................................................................................................................. 26

1.14.2ステップ 1： マクロの記録................................................................................................................ 28

1.14.3ステップ 2： マクロを編集する（記録内容を見る）.................................................................... 30

1.14.4ステップ 3： マクロを実行する........................................................................................................ 31

1.14.5ステップ 4： テストスイートを作成する........................................................................................ 31

1.14.6ステップ 5： テストスイートを編集する........................................................................................ 31

1.14.7ステップ 6： テストイメージファイルを作成する........................................................................ 33

1.14.8ステップ 7： プログラムを変更しテストを実行する.................................................................... 35

1.14.9ステップ 8： テスト結果を確認する（不一致の場合）................................................................ 36

1.14.10ステップ 9： プログラムを元に戻しテストを実行する................................................................ 37

1.14.11ステップ 10： テスト結果を確認する（一致した場合）............................................................... 37

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page iHigh-performance Embedded Workshop V.4.09

2.

目次

ビルドの基本 ...............................................................................................................................................38
2.1

ビルド処理 ...................................................................................................................................................... 38

2.2

ワークスペースウィンドウのProjectsタブの構成...................................................................................... 38

2.3

プロジェクトファイル .................................................................................................................................. 42

2.3.1

プロジェクトにファイルを追加する.................................................................................................. 43

2.3.2

ファイルおよびフォルダをドラッグアンドドロップする .............................................................. 44

2.3.3

プロジェクトからファイルを削除する.............................................................................................. 45

2.3.4

ビルドからプロジェクトファイルを除外する.................................................................................. 46

2.3.5

除外したプロジェクトファイルをビルドに再び入れる.................................................................. 47

2.4

ワークスペースウィンドウでユーザフォルダを使う............................................................................... 47

2.5

ファイル拡張子とファイルグループ........................................................................................................... 48

2.5.1

アプリケーションとファイルグループを関連付ける...................................................................... 49

2.5.2

新規ファイルグループに新規ファイル拡張子を登録する .............................................................. 51

2.5.3

新規ファイル拡張子を作成する.......................................................................................................... 52

2.6

ビルドオプションを設定する....................................................................................................................... 53

2.7

ビルドのコンフィグレーション................................................................................................................... 54

2.7.1

ビルドコンフィグレーションを選択する.......................................................................................... 54

2.7.2

新規ビルドコンフィグレーションを追加する.................................................................................. 55

2.7.3

ビルドコンフィグレーションを削除する.......................................................................................... 55

2.8

プロジェクトをビルドする .......................................................................................................................... 55

2.8.1

パラレルビルドを使用する.................................................................................................................. 55

2.8.2

ファイルをコンパイルする.................................................................................................................. 56

2.8.3

プロジェクトをビルドする.................................................................................................................. 57

2.8.4

複数のプロジェクトをビルドする...................................................................................................... 57

2.8.5

ツールの実行を中止する ..................................................................................................................... 58

2.8.6

ビルドの中間ファイルおよび出力ファイルを削除する.................................................................. 58

2.8.7

アウトプットウィンドウの Build タブの構成................................................................................... 61

2.8.8

アウトプットウィンドウの Build タブの内容の制御 ....................................................................... 62

2.8.9

ビルド対象ファイルをワークスペースウィンドウにマーク表示する .......................................... 63

2.9

ファイル依存関係 .......................................................................................................................................... 64

2.10

表示方法を指定する ...................................................................................................................................... 66

2.11

ワークスペースにプロジェクトを追加する............................................................................................... 68

2.12

アクティブプロジェクトを設定する........................................................................................................... 69

2.13

プロジェクト間の依存関係を指定する....................................................................................................... 69

2.14

ワークスペースからプロジェクトを削除する........................................................................................... 70

2.15

ワークスペースのプロジェクト相対パス................................................................................................... 71

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page ii

High-performance Embedded Workshop V.4.09

3.

ビルドの応用 ...............................................................................................................................................72
3.1
3.1.1

ビルド実行の復習 .......................................................................................................................................... 72
ビルドとは?............................................................................................................................................ 72

3.2

カスタムビルドフェーズを作成する........................................................................................................... 73

3.3

ビルドフェーズの順序 .................................................................................................................................. 77

3.3.1

ビルド順序タブ ..................................................................................................................................... 78

3.3.2

ファイルのビルド順序タブ.................................................................................................................. 81

3.3.3

ファイルマッピングタブ ..................................................................................................................... 82

3.4

4.

目次

カスタムビルドフェーズのオプション設定............................................................................................... 83

3.4.1

オプションタブ ..................................................................................................................................... 84

3.4.2

出力ファイルタブ ................................................................................................................................. 84

3.4.3

依存ファイルタブ ................................................................................................................................. 85

3.5

ビルドを管理する .......................................................................................................................................... 86

3.6

ビルドの出力のログを取る .......................................................................................................................... 86

3.7

ツールチェインのバージョンを変更する................................................................................................... 87

3.8

Makeファイルの生成 ..................................................................................................................................... 88

3.9

Makeファイルを使ったビルド ..................................................................................................................... 90

3.10

リンク順序をカスタマイズする................................................................................................................... 92

エディタ ......................................................................................................................................................96
4.1

エディタウィンドウ ...................................................................................................................................... 96

4.2

複数のファイルを扱う .................................................................................................................................. 97

4.3

標準のファイル操作 ...................................................................................................................................... 98

4.3.1

新規ファイルを作成する ..................................................................................................................... 98

4.3.2

ファイルを編集する ............................................................................................................................. 98

4.3.3

ファイルを保存する ............................................................................................................................. 99

4.3.4

ファイルを開く ................................................................................................................................... 100

4.3.5

ファイルを閉じる ............................................................................................................................... 100

4.3.6

ウィンドウを閉じるポップアップメニュー.................................................................................... 102

4.4

検索とファイル内の移動 ............................................................................................................................ 102

4.4.1

文字列を検索する ............................................................................................................................... 102

4.4.2

複数のファイルで文字列を検索する................................................................................................ 103

4.4.3

文字列を置換する ............................................................................................................................... 105

4.4.4

指定した行にジャンプする................................................................................................................ 106

4.5

ブックマーク ................................................................................................................................................ 106

4.6

ファイルを印刷する .................................................................................................................................... 107

4.7

テキストのレイアウト ................................................................................................................................ 107

4.7.1

ページ設定 ........................................................................................................................................... 107

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page iii

High-performance Embedded Workshop V.4.09

4.7.2

タブを変更する ................................................................................................................................... 109

4.7.3

自動インデント ................................................................................................................................... 109

4.8ウィンドウを分割する ................................................................................................................................ 110

4.9

エディタのフォントを変更する................................................................................................................. 110

4.10

シンタックスを色付けする ........................................................................................................................ 111

4.10.1

テキストの色を変更する ................................................................................................................... 111

4.10.2

新規キーワードを作成する................................................................................................................ 112

4.10.3

シンタックスの色付けを有効/無効にする....................................................................................... 113

4.11

5.

6.

目次

テンプレート ................................................................................................................................................ 113

4.11.1

テンプレートを設定する ................................................................................................................... 114

4.11.2

テンプレートを削除する ................................................................................................................... 116

4.11.3

テンプレートを挿入する ................................................................................................................... 116

4.12

括弧の組み合わせ ........................................................................................................................................ 117

4.13

ファイルを読み取り専用属性にする......................................................................................................... 117

4.14

デバッグ時にファイルの編集を抑止する................................................................................................. 118

4.15

エディタカラムの管理 ................................................................................................................................ 118

4.16

カラムのヘッダの表示/非表示を切り替える............................................................................................ 119

4.17

エディタ内からファイルを開く................................................................................................................. 119

4.18

ツールチップウォッチ ................................................................................................................................ 119

4.19

式の評価 ........................................................................................................................................................ 120

ツール管理.................................................................................................................................................122
5.1

ツールの位置 ................................................................................................................................................ 123

5.2

High-performance Embedded Workshop登録ファイル ............................................................................... 123

5.3

ツールを登録する ........................................................................................................................................ 124

5.4

ツールの登録を取り消す ............................................................................................................................ 125

5.5

ツールのプロパティの参照と編集............................................................................................................. 126

5.6

テクニカルサポートについて..................................................................................................................... 127

5.7

オンデマンドのコンポーネント................................................................................................................. 129

5.8

カスタムプロジェクトタイプ..................................................................................................................... 130

環境のカスタマイズ ..................................................................................................................................131
6.1

ツールバーのカスタマイズ ........................................................................................................................ 131

6.2

ツールメニューのカスタマイズ................................................................................................................. 133

6.3

カスタムプレースホルダを使う................................................................................................................. 135

6.4

ワークスペースやプロジェクトのログ機能を使う................................................................................. 136

6.5

ヘルプシステムを構築する ........................................................................................................................ 136

6.6

キーボードショートカットをカスタマイズする..................................................................................... 137

6.7

基本設定の影響範囲 .................................................................................................................................... 139

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page iv

High-performance Embedded Workshop V.4.09

6.7.1

カスタマイズダイアログボックスの影響範囲................................................................................ 139

6.7.2

オプションダイアログボックスの影響範囲.................................................................................... 140

6.8

7.

8.

ワークスペースオプションを指定する..................................................................................................... 140

6.8.1

起動時に前回開いたワークスペースを開く.................................................................................... 140

6.8.2

ワークスペースを開いたときにファイルを表示する.................................................................... 140

6.8.3

ワークスペースを開いたときにワークスペース情報を表示する ................................................ 140

6.8.4

ツール実行前にワークスペースを保存する.................................................................................... 141

6.8.5

ワークスペース保存前に確認する.................................................................................................... 141

6.8.6

セッション保存前に確認する............................................................................................................ 142

6.8.7

自動バックアップ機能を有効にする................................................................................................ 142

6.8.8

ワークスペースを開いたときに読み込むプロジェクトを設定する ............................................ 143

6.8.9

新規ワークスペースのデフォルトディレクトリを変更する ........................................................ 143

6.9

外部エディタを使う .................................................................................................................................... 144

6.10

表示するフォントのカスタマイズ............................................................................................................. 146

6.11

バーチャルデスクトップを使う................................................................................................................. 147

バージョン管理 .........................................................................................................................................149
7.1

バージョン管理システムを選択する......................................................................................................... 151

7.2

バージョン管理設定内容のインポートとエクスポート......................................................................... 152

カスタムバージョン管理システム ............................................................................................................153
8.1

9.

目次

バージョン管理メニューオプションを定義する..................................................................................... 153

8.1.1

システム定義メニューオプション.................................................................................................... 154

8.1.2

ユーザ定義メニューオプション........................................................................................................ 155

8.2

バージョン管理コマンドを定義する......................................................................................................... 156

8.3

引数を指定する ............................................................................................................................................ 157

8.4

コメントを指定する .................................................................................................................................... 158

8.5

バージョン管理コマンドリターンコードオプション............................................................................. 158

8.6

ディレクトリをマッピングする................................................................................................................. 158

8.7

ディレクトリマッピング例 ........................................................................................................................ 160

8.8

バージョン管理環境変数を設定する......................................................................................................... 161

8.9

バージョン管理システムの実行を制御する............................................................................................. 162

8.10

ユーザ名とパスワードを変更する............................................................................................................. 162

8.11

カスタムバージョン管理システムの使用例............................................................................................. 163

8.11.1High-performance Embedded Workshop と RCS を接続して使用する ............................................ 163

8.11.2High-performance Embedded Workshop と CVS を接続して使用する ............................................ 170

Visual SourceSafe バージョン管理システム ............................................................................................177
9.1

ワークスペースにVisual SourceSafeを関連付ける ................................................................................... 177

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page v

High-performance Embedded Workshop V.4.09

9.2

目次

Visual SourceSafeコマンド........................................................................................................................... 180

9.2.1

Visual SourceSafe にファイルを追加する ......................................................................................... 180

9.2.2

Visual SourceSafe からファイルを削除する ..................................................................................... 181

9.2.3

Visual SourceSafe からファイルの読み取り専用コピーを取得する ............................................. 182

9.2.4

Visual SourceSafe からファイルの書き込み可能コピーをチェックアウトする.......................... 183

9.2.5

Visual SourceSafe にファイルの書き込み可能コピーをチェックインする ................................. 184

9.2.6

Visual SourceSafe のファイルの状態を表示する ............................................................................. 185

9.2.7

Visual SourceSafe のチェックアウトコマンドを取り消す ............................................................. 186

9.2.8

Visual SourceSafe のファイル履歴を表示する ................................................................................. 187

9.3

Visual SourceSafeコマンドのオプション ................................................................................................... 187

9.4

バージョン管理設定内容 ............................................................................................................................ 187

9.5

ディレクトリをマッピングする................................................................................................................. 188

9.6

Visual SourceSafeコマンドを追加する ....................................................................................................... 190

10. ネットワークを利用したプロジェクト共有機能.......................................................................................192
10.1

Windows® XP Service Pack 2以降を搭載したPCで本機能を使う場合の設定 ....................................... 193

10.2

ネットワークを利用したプロジェクト共有機能を使う......................................................................... 195

10.3

アドミニストレータのパスワードを設定する......................................................................................... 196

10.4

新規ユーザを追加する ................................................................................................................................ 196

10.5

パスワードを変更する ................................................................................................................................ 197

10.6

ネットワークを利用したプロジェクト共有機能を使う場合の留意事項 ............................................. 198

11. ファイルの比較 .........................................................................................................................................199
11.1

差分ウィンドウを開く ................................................................................................................................ 199

12. ナビゲーション機能 ..................................................................................................................................202
12.1

C関数と#defineナビゲーションの構成 ...................................................................................................... 204

12.2

C++ナビゲーションの構成 ......................................................................................................................... 204

12.3

エディタ内から定義へジャンプする......................................................................................................... 206

12.4

ナビゲーション項目をドラッグアンドドロップする............................................................................. 207

12.5

スマートエディタ ........................................................................................................................................ 208

13. マップ ........................................................................................................................................................210
13.1

セクション設定を管理する ........................................................................................................................ 211

13.1.1

Map Section Information ウィンドウを開く ...................................................................................... 212

13.1.2

セクション情報編集モードの開始と終了........................................................................................ 214

13.1.3

セクショングループを追加する........................................................................................................ 216

13.1.4セクションを追加する ....................................................................................................................... 216

13.1.5

オーバレイグループを追加する........................................................................................................ 217

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page vi

High-performance Embedded Workshop V.4.09

目次

13.1.6

未登録セクションを自動登録する.................................................................................................... 217

13.1.7

選択項目を編集する ........................................................................................................................... 218

13.1.8

プライマリセクションに設定する.................................................................................................... 218

13.1.9

メモリマップを設定する ................................................................................................................... 219

13.1.10

メモリリソースを自動的に確保する................................................................................................ 219

13.1.11

セクション設定ツリーを印刷する.................................................................................................... 220

13.1.12

未割り当て領域を表示する................................................................................................................ 220

13.1.13

サイズ 0 のセクションを表示する.................................................................................................... 220

13.1.14

アドレスに対応するソースコードを表示する................................................................................ 220

13.1.15

セクションリストを印刷する............................................................................................................ 221

13.2

シンボル情報を見る .................................................................................................................................... 221

13.2.1

Map Symbol Information ウィンドウを開く...................................................................................... 221

13.2.2

マップリストを印刷する ................................................................................................................... 223

13.2.3

シンボルを検索する ........................................................................................................................... 223

13.2.4

シンボル情報をフィルタ表示する.................................................................................................... 224

13.2.5

アドレスに対応するソースコードを表示する................................................................................ 225

13.2.6

シンボル情報を印刷する ................................................................................................................... 225

14. コマンドライン .........................................................................................................................................226
14.1

コマンドラインウィンドウを開く............................................................................................................. 226

14.2

バッチファイルを設定する ........................................................................................................................ 230

14.3

バッチファイルを実行する ........................................................................................................................ 231

14.4

コマンド実行を中断する ............................................................................................................................ 231

14.5

ログファイルを設定する ............................................................................................................................ 231

14.6

ログファイルへの出力を開始/停止する.................................................................................................... 232

14.7

ファイルの絶対パスを入力する................................................................................................................. 232

14.8

プレースホルダを挿入する ........................................................................................................................ 232

14.9ウィンドウの表示内容をすべて選択する................................................................................................. 232

14.10

選択部分をクリップボードにコピーする................................................................................................. 232

14.11

選択部分をクリップボードに切り取る..................................................................................................... 233

14.12

クリップボードの内容を貼り付ける......................................................................................................... 233

14.13

ウィンドウの表示内容をクリアする......................................................................................................... 233

14.14

直前の操作を元に戻す ................................................................................................................................ 233

14.15

括弧の呼応状態を確認する ........................................................................................................................ 233

14.16

バッチファイルの実行状態をリセットする............................................................................................. 234

14.17

バッチファイルを1行単位で実行する....................................................................................................... 234

14.18

バッチファイルにブレークポイントを設定する..................................................................................... 235

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page vii

High-performance Embedded Workshop V.4.09

目次

15. マクロ生成支援機能 ..................................................................................................................................237
15.1

マクロメニューとツールバー..................................................................................................................... 237

15.2

マクロの設定ダイアログボックスを使用する......................................................................................... 239

15.3

既存のマクロファイルをインポートする................................................................................................. 240

15.4

マクロを記録する ........................................................................................................................................ 241

15.5

マクロファイルにマクロを記録できる機能............................................................................................. 242

15.5.1

マクロを記録できる機能（High-performance Embedded Workshop 共通）.................................. 242

15.5.2

マクロを記録できる機能（デバッガ依存）.................................................................................... 247

15.6

マクロを実行する ........................................................................................................................................ 258

15.7

マクロを編集する ........................................................................................................................................ 258

15.8

マクロを割り当てる .................................................................................................................................... 259

15.9

アウトプットウィンドウのMacroタブの構成 .......................................................................................... 260

16. テスト支援機能 .........................................................................................................................................261
16.1

テストスイートを作成する ........................................................................................................................ 261

16.2

テストスイートを開く／閉じる................................................................................................................. 262

16.3

テストスイートを編集する ........................................................................................................................ 263

16.4

テストスイートにテストを追加する......................................................................................................... 264

16.5

テストイメージファイルを作成する......................................................................................................... 266

16.6

テストイメージファイルにテストイメージデータとして保存できる機能 ......................................... 267

16.6.1

テストイメージファイルに保存できる機能（High-performance Embedded Workshop 共通） .. 268

16.6.2

テストイメージファイルに保存できる機能（デバッガ依存） .................................................... 274

16.7

テストイメージファイルを比較する......................................................................................................... 289

16.8

テストを実行する ........................................................................................................................................ 290

16.9

テストブラウザを使用する ........................................................................................................................ 291

16.10

ワークスペースウィンドウのTestタブの構成.......................................................................................... 292

16.11

アウトプットウィンドウのTestタブの構成.............................................................................................. 293

17. デバッグ機能 .............................................................................................................................................295
17.1

デバッグの準備をする ................................................................................................................................ 295

17.1.1

デバッグの前にビルドを行う............................................................................................................ 295

17.1.2

デバッガを選択する ........................................................................................................................... 295

17.1.3

プロジェクトの構成を編集する........................................................................................................ 306

17.1.4

デバッガを設定する ........................................................................................................................... 306

17.1.5

ダウンロードモジュール ................................................................................................................... 313

17.1.6デバッグセッション ........................................................................................................................... 325

17.2
17.2.1

プログラムを表示する ................................................................................................................................ 330
エディタウィンドウを開く................................................................................................................ 331

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page viii

High-performance Embedded Workshop V.4.09

目次

17.2.2

逆アセンブリウィンドウを開く........................................................................................................ 339

17.2.3

現在の PC 位置を表示する................................................................................................................. 346

17.2.4

PC 位置の行を強調表示する.............................................................................................................. 346

17.3

メモリを操作する ........................................................................................................................................ 347

17.3.1

メモリウィンドウを開く ................................................................................................................... 347

17.3.2

任意のアドレスにデータを設定する................................................................................................ 350

17.3.3

アドレス領域を選択する ................................................................................................................... 351

17.3.4

任意のアドレス領域を一定データで充填する................................................................................ 351

17.3.5

任意のアドレス領域のデータを別領域にコピーする.................................................................... 352

17.3.6

任意の 2 つのアドレス領域を比較する............................................................................................ 353

17.3.7

任意のアドレス領域をテストする.................................................................................................... 353

17.3.8

任意のアドレス領域をテキストファイルに保存する.................................................................... 354

17.3.9

任意のアドレス領域のデータを検索する........................................................................................ 354

17.3.10

表示開始アドレスを変更する............................................................................................................ 355

17.3.11

スクロール範囲を変更する................................................................................................................ 355

17.3.12

指定したレジスタが示すアドレスから表示する............................................................................ 356

17.3.13

スタックポインタ位置を追従する.................................................................................................... 356

17.3.14

ダウンロード時に表示するラベル位置を変更する........................................................................ 356

17.3.15

ウィンドウの表示内容を手動で更新する........................................................................................ 356

17.3.16

ウィンドウの表示内容の更新を抑止する........................................................................................ 357

17.3.17

ウィンドウの表示内容を定期的に更新する.................................................................................... 357

17.3.18

更新間隔を設定する ........................................................................................................................... 357

17.3.19

表示データ長を変更する ................................................................................................................... 358

17.3.20

表示基数を変更する ........................................................................................................................... 358

17.3.21

表示コードを変更する ....................................................................................................................... 358

17.3.22

レイアウトを設定する ....................................................................................................................... 359

17.3.23

表示桁数を変更する ........................................................................................................................... 359

17.3.24

カバレッジ計測結果の表示/表示なしを切り替える....................................................................... 359

17.3.25

任意のアドレス領域を保存する........................................................................................................ 360

17.3.26

メモリにファイルをロードする........................................................................................................ 360

17.3.27

ウィンドウを分割表示する................................................................................................................ 361

17.3.28

アドレス領域を検証する ................................................................................................................... 361

17.3.29

テキストの色を変更する ................................................................................................................... 362

17.4

メモリ内容を画像形式で表示する............................................................................................................. 362

17.4.1

画像ウィンドウを開く ....................................................................................................................... 362

17.4.2ウィンドウの表示内容を定期的に更新する.................................................................................... 366

17.4.3ウィンドウの表示内容を手動で更新する........................................................................................ 367

17.4.4

更新間隔を設定する ........................................................................................................................... 367

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page ix

High-performance Embedded Workshop V.4.09

目次

17.4.5

連続フレームで画像を見る................................................................................................................ 367

17.4.6

ピクセル情報を表示する ................................................................................................................... 370

17.5

メモリ内容を波形形式で表示する............................................................................................................. 371

17.5.1

波形ウィンドウを開く ....................................................................................................................... 371

17.5.2ウィンドウの表示内容を定期的に更新する.................................................................................... 373

17.5.3ウィンドウの表示内容を手動で更新する........................................................................................ 373

17.5.4

更新間隔を設定する ........................................................................................................................... 373

17.5.5

拡大表示する ....................................................................................................................................... 373

17.5.6

縮小表示する ....................................................................................................................................... 374

17.5.7

最初のサイズに戻す ........................................................................................................................... 374

17.5.8拡大/縮小倍率を設定する .................................................................................................................. 374

17.5.9横軸のサイズを設定する ................................................................................................................... 374

17.5.10

カーソルを非表示にする ................................................................................................................... 374

17.5.11

サンプリング情報を表示する............................................................................................................ 374

17.6

I/Oレジスタを見る ....................................................................................................................................... 375

17.6.1

IO ウィンドウを開く .......................................................................................................................... 375

17.6.2

I/O レジスタ表示を展開する ............................................................................................................. 376

17.6.3

I/O レジスタの内容を設定する ......................................................................................................... 377

17.6.4ウィンドウの表示内容を手動で更新する........................................................................................ 377

17.6.5ウィンドウの表示内容の更新を抑止する........................................................................................ 377

17.6.6

表示する I/O レジスタを選択する .................................................................................................... 378

17.6.7I/O ファイルをロードする ................................................................................................................. 379

17.6.8

IO ウィンドウの表示内容を印刷する .............................................................................................. 380

17.6.9IO ウィンドウの表示内容を保存する .............................................................................................. 380

17.6.10

I/O レジスタを検索する ..................................................................................................................... 380

17.6.11

次を検索する ....................................................................................................................................... 381

17.7

レジスタ内容を見る .................................................................................................................................... 381

17.7.1

レジスタウィンドウを開く................................................................................................................ 381

17.7.2レジスタの表示基数を変更する........................................................................................................ 382

17.7.3

レジスタバンクを切り替える............................................................................................................ 382

17.7.4

レイアウトを設定する ....................................................................................................................... 383

17.7.5

表示するレジスタを選択する............................................................................................................ 384

17.7.6レジスタの内容を設定する................................................................................................................ 385

17.7.7

フラグの値を設定する ....................................................................................................................... 385

17.7.8ウィンドウの表示内容を手動で更新する........................................................................................ 386

17.7.9ウィンドウの表示内容の更新を抑止する........................................................................................ 386

17.7.10ウィンドウを分割表示する................................................................................................................ 386

17.7.11レジスタウィンドウの表示内容を保存する.................................................................................... 386

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page xHigh-performance Embedded Workshop V.4.09

目次

17.7.12レジスタの内容を使用する................................................................................................................ 386

17.7.13

テキストの色を変更する ................................................................................................................... 387

17.8基数を設定する ............................................................................................................................................ 387

17.9

ターゲットマイコンをリセットする......................................................................................................... 387

17.10

カーソル位置にPC値を設定する................................................................................................................ 388

17.11

デバッガを初期化する ................................................................................................................................ 388

17.12

デバッガを接続/接続解除する ................................................................................................................... 388

17.13

プログラムを実行する ................................................................................................................................ 388

17.13.1

実行を継続する ................................................................................................................................... 388

17.13.2

リセットから実行を開始する............................................................................................................ 389

17.13.3

ブレークポイントを無視して実行する............................................................................................ 389

17.13.4

カーソルまで実行する ....................................................................................................................... 389

17.13.5

条件を指定して実行する ................................................................................................................... 390

17.13.6

リセット時に main 関数の先頭までプログラムを実行する .......................................................... 390

17.13.7

シングルステップ ............................................................................................................................... 391

17.13.8

複数のステップ ................................................................................................................................... 392

17.14

プログラムを停止する ................................................................................................................................ 393

17.14.1

停止ツールバーボタンによる停止.................................................................................................... 393

17.14.2

標準のブレークポイント（PC ブレークポイント） ...................................................................... 393

17.15

現在の状態を表示する ................................................................................................................................ 395

17.16

関数呼び出し履歴を見る ............................................................................................................................ 395

17.16.1

スタックトレースウィンドウを開く................................................................................................ 395

17.16.2

ソースコードを表示する ................................................................................................................... 396

17.16.3

表示形式を設定する ........................................................................................................................... 396

17.16.4

エンコード形式を設定する................................................................................................................ 397

17.17

外部デバッガを使う .................................................................................................................................... 397

17.17.1

日立デバッギングインタフェースを High-performance Embedded Workshop と統合して構築する............................................................................................................................................................... 398

17.17.2

PD デバッガを High-performance Embedded Workshop と統合して構築する............................... 399

17.17.3

外部デバッガを High-performance Embedded Workshop と統合して構築する............................. 399

17.18

デバッガに依存する機能 ............................................................................................................................ 400

17.18.1

ラベルを見る ....................................................................................................................................... 400

17.18.2

Elf/Dwarf2 のサポート ........................................................................................................................ 404

17.18.3

変数を表示する ................................................................................................................................... 407

18. 同期デバッグ機能......................................................................................................................................425
18.1

同期デバッグダイアログボックス............................................................................................................. 425

18.1.1

同期デバッグ設定を管理する............................................................................................................ 426

18.1.2

同期するセッションを定義する........................................................................................................ 427

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page xi

High-performance Embedded Workshop V.4.09

目次

18.1.3

同期オプションを設定する................................................................................................................ 430

18.1.4

メモリ更新オプションを設定する.................................................................................................... 431

18.1.5

同期デバッグモード ........................................................................................................................... 431

18.1.6

同期デバッグを開始する ................................................................................................................... 432

18.1.7

同期デバッグを更新する ................................................................................................................... 432

18.1.8

同期デバッグを停止する ................................................................................................................... 432

18.2

同期デバッグ時にHigh-performance Embedded Workshopを使用する.................................................... 432

18.2.1

共通の機能 ........................................................................................................................................... 433

18.2.2

Parallel モードの機能 .......................................................................................................................... 436

18.2.3

Internal モードの機能 .......................................................................................................................... 437

18.3

同期デバッグ時にコマンドラインウィンドウを使用する..................................................................... 439

18.4

用語の解説 .................................................................................................................................................... 440

19. テクニカルサポート ..................................................................................................................................441
19.1

バージョン情報の参照 ................................................................................................................................ 441

19.2

アップデートの確認 .................................................................................................................................... 441

19.3

不具合レポートの作成 ................................................................................................................................ 442

リファレンス ....................................................................................................................................................443
1.

メインメニュー .........................................................................................................................................444
1.1

ファイルメニューオプション..................................................................................................................... 444

1.2

編集メニューオプション ............................................................................................................................ 445

1.3

表示メニューオプション ............................................................................................................................ 446

1.4

プロジェクトメニューオプション............................................................................................................. 447

1.5

ビルドメニューオプション ........................................................................................................................ 447

1.6

デバッグメニューオプション..................................................................................................................... 448

1.7

基本設定メニューオプション..................................................................................................................... 450

1.8

ツールメニューオプション ........................................................................................................................ 450

1.9

テストメニューオプション ........................................................................................................................ 451

1.10ウィンドウメニューオプション................................................................................................................. 452

1.11

ヘルプメニューオプション ........................................................................................................................ 452

2.

ウィンドウ.................................................................................................................................................453

3.

コマンド ....................................................................................................................................................454
3.1

コマンド一覧（アルファベット順）......................................................................................................... 454

3.2

コマンド一覧（機能別） ............................................................................................................................ 456

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page xii

High-performance Embedded Workshop V.4.09

目次

4.

正規表現 ....................................................................................................................................................459

5.

プレースホルダ .........................................................................................................................................460
5.1

プレースホルダとは？ ................................................................................................................................ 460

5.2

プレースホルダを挿入する ........................................................................................................................ 460

5.3

使用できるプレースホルダ ........................................................................................................................ 461

5.4

プレースホルダを使うにあたって............................................................................................................. 463

6.

I/O ファイルフォーマット.........................................................................................................................464

7.

シンボルファイルフォーマット ................................................................................................................466

8.

キーボードショートカット .......................................................................................................................467

9.

デバッガでドラッグアンドドロップする..................................................................................................470

10. ラベルを使用してコードを参照する.........................................................................................................471
11. ウィンドウのツールバー ...........................................................................................................................473
12. High-performance Embedded Workshop V.1.x 用のツールチェインでビルドする .................................475
13. HMAKE ユーザガイドライン ....................................................................................................................476
13.1

コマンドライン ............................................................................................................................................ 476

13.2

ファイルのシンタックス ............................................................................................................................ 476

13.3

記述部 ............................................................................................................................................................ 477

13.4

コメント ........................................................................................................................................................ 479

13.5

メッセージコマンド .................................................................................................................................... 479

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page xiii

High-performance Embedded Workshop V.4.09

1.

1.

概要

概要

本ユーザーズマニュアルではHigh-performance Embedded Workshopの機能について記載しています。
この章ではHigh-performance Embedded Workshopの基本概念を説明します。

1.1

ワークスペースとプロジェクト

High-performance Embedded Workshopでは、ワークスペースとプロジェクトという概念があります。
• ワークスペース
High-performance Embedded Workshopを用いてプログラムを作成する場合の、一番大きな管理単位です。ワー
クスペースには、最低1つのプロジェクトが必要で、この1つのプロジェクトは、ワークスペース作成時に自動的に作成されます。また、ワークスペースは複数のプロジェクトを持つことができます。
• プロジェクト
プログラムを作成する場合、特定機能をライブラリ化してモジュールを階層化する場合があります。このような場合、ライブラリ用のプロジェクトを作成、追加することができます。

1.2

メインウィンドウ

High-performance Embedded Workshopにはメインウィンドウが3つあります。ワークスペースウィンドウ、エディタウィンドウ、アウトプットウィンドウです。ワークスペースウィンドウには現在そのワークスペースにあるプロジェクトやファイルを表示します。エディタウィンドウではファイルを表示、編集できます。アウトプ
ットウィンドウには様々な処理結果（ビルド、バージョン管理コマンドなど）を表示します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 1 of 479

High-performance Embedded Workshop V.4.09

1.2.1

1.

概要

タイトルバー

タイトルバーには、現在開いている、プロジェクト名、ファイル名を表示します。また、"最小化"ボタン、"最大化"ボタン、"閉じる"ボタンがあります。"最小化"ボタンをクリックするとWindows®のタスクバー上にHigh-performance Embedded Workshopを最小化します。"最大化"ボタンをクリックするとHigh-performance
Embedded Workshopをフルスクリーンで表示します。"閉じる"ボタンをクリックするとHigh-performance
Embedded Workshopを閉じることができます。（これは[ファイル -> アプリケーションの終了]を選択するか"Alt+F4"キーを押すのと同じです）。

1.2.2

メニューバー

メニューバーには次の11のメニューがあります。[ファイル]、[編集]、[表示]、[プロジェクト]、[ビルド] *、[デバッグ]、[基本設定]、[ツール]、[テスト]、[ウィンドウ]、および[ヘルプ]です。メニューのオプションは、す
べてこれらメニューの下にグループ化されています。例えば、ファイルを開きたいときには[ファイル]メニュ
ーの下のオプションを選択します。ツールをセットアップしたいときには、[ツール]メニューを選択します。

注：*. High-performance Embedded Workshop V.4.01以降のバージョンで作成したデバッグ専用プロジェクト（[Debugger only - xxxxxx]）を使用している場合は、[ビルド]メニューを表示しません。High-performance
Embedded Workshop V.4.01より前のバージョンで作成したデバッグ専用プロジェクトを使用している場合には、[ビルド]メニューを表示します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 2 of 479

High-performance Embedded Workshop V.4.09

1.2.3

1.

概要

ツールバー

ツールバーにより使う頻度の高いオプションを簡単にアクセスできます。デフォルトでは[エディタ]、[検索]、[テンプレート]、[ブックマーク]、[デフォルト]、[標準]、[バージョン管理]、[マップ]、[ツール]、[マクロ]、[デバッグ]、[デバッグラン]、および[システムツール]の13のツールバーがあります（下の図を参照）。
デフォルトセッションの初期表示では、ツールバーには[バージョン管理]、および周辺機能のボタンは表示しません。
さらに、High-performance Embedded Workshop V.4.01以降のバージョンで作成したデバッグ専用プロジェクト（[Debugger only - xxxxxx]）を使用する場合、デフォルトでは[エディタ]、[検索]、[テンプレート]、[ブックマーク]、[デフォルト]、および[標準]は表示しません。
ツールバーの作成や変更は、[基本設定 -> カスタマイズ]で指定できます（詳細は、「6.1 ツールバーのカスタマイズ」を参照してください）。
エディタツールバー

検索ツールバーテンプレートツールバー

ブックマークツールバー

デフォルトツールバー

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 3 of 479

High-performance Embedded Workshop V.4.09

1.

概要

標準ツールバーバージョン管理ツールバー
現在のプロジェクトでバージョン管理ツールが選択されているときのみ使用できます。

マップツールバー

ツールツールバー

マクロツールバー
下記の標準のマクロボタンの右側に作成したマクロを割り当てたカスタムのボタンを追加できます。

デバッグツールバー
ターゲットが接続されたセッションを使用しているときのみ使用できます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 4 of 479

High-performance Embedded Workshop V.4.09

1.

概要

デバッグランツールバー
ターゲットが接続されたセッションを使用しているときのみ使用できます。

システムツールツールバー
外部ツールにメニューを割り当てると下記のシステムツールボタンの右側に外部ツールのボタンを追加できます。

[標準]ツールバーがドッキング（連結）状態のとき、下の図に示すコントロールバーを表示します。ドッキン
グ状態の[標準]ツールバーの位置を移動したいときはコントロールバーを移動先までドラッグします。（ドラッグとは、マウスの左ボタンを押したまま目的の場所まで移動してからボタンを離すことをいいます。）
下の図にドッキング状態、フローティング（浮遊）状態のツールバーを示します。

ツールバーをドッキング状態にするには以下のいずれかの操作を選択してください。
•

フローティング状態のツールバーのタイトルバーをダブルクリックする。

•

フローティング状態のツールバーのタイトルバーをドッキング状態のウィンドウ、メニューバー、ツールバー、またはHigh-performance Embedded Workshopメインウィンドウの端までドラッグする。バーの形が変わります。

ツールバーをフローティング状態にするには以下のいずれかの操作を選択してください。
•

ドッキング状態のツールバーのコントロールバーをダブルクリックする。

•

ドッキング状態のツールバーのコントロールバーをHigh-performance Embedded Workshopのメインウ
ィンドウおよびその他のドッキング状態のウィンドウ、メニューバー、またはツールバーの端から外れるようにドラッグする。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 5 of 479

High-performance Embedded Workshop V.4.09

1.2.4

1.

概要

ワークスペースウィンドウ

ワークスペースウィンドウには4つのタブ（[Projects]、[Templates]、[Navigation]、[Test]）があります。

•[Projects]タブ

現在のワークスペース、プロジェクト、ファイルを表示します。アイコンのダブルクリックによりプロジェク
トファイルや個々のファイルが開けます。[Projects]タブの詳細については「2.2 ワークスペースウィンドウのProjectsタブの構成」を参照してください。
[Projects]タブのファイル名上にマウスポインタを置くと、ツールチップにファイルの絶対パスを表示します。

•[Templates]タブテンプレートの設定を表示します。テンプレートの詳細については「4.11 テンプレート」を参照してください。
•[Navigation]タブ

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 6 of 479

High-performance Embedded Workshop V.4.09

1.

概要

プロジェクトのファイルのテキスト部分へジャンプできます。[Navigation]タブに実際に表示される内容は、現在、何がインストールされているかによって異なります。上の図に例えばANSI規格 のCマクロ名定義（CDefines）、およびC関数一覧（C Functions）を示します。ナビゲーションの詳細については「12. ナビゲーシ
ョン機能」を参照してください。
•[Test]タブ

テスト支援機能としてテストスイートを設定および表示します。テスト支援機能の詳細については、「16. テ
スト支援機能」を参照してください。
ワークスペースウィンドウやアウトプットウィンドウのドッキングビューとはウィンドウ上で右クリックしてください。ポップアップメニューを表示します。

[ドッキングビュー]にチェックマークが付いている場合はドッキングできます。チェックマークが外れている
場合はドッキングできません。[ドッキングビュー]を選択するとチェックマークが付いたり外れたりします。
[ドッキングビュー]にチェックマークが付いている場合、ウィンドウをHigh-performance Embedded Workshopメ
インウィンドウや他のドッキング状態のウィンドウの端にドッキングできます。同じく[ドッキングビュー]にチェックマークが付いている場合、ウィンドウを他のHigh-performance Embedded Workshopのウィンドウ上やHigh-performance Embedded Workshopメインウィンドウの外でフローティング状態にできます。下の図の(i)はドッキング状態のワークスペースウィンドウ、(ii)はフローティング状態のワークスペースウィンドウを示します。

ワークスペースウィンドウやアウトプットウィンドウがドッキング状態のとき、下の図に示すコントロールバ
ーを表示します。ドッキング状態のウィンドウを移動したいとき、コントロールバーを移動先までドラッグしてください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 7 of 479

High-performance Embedded Workshop V.4.09

1.

概要

ワークスペースウィンドウやアウトプットウィンドウをドッキング状態にするには1.

ポップアップメニューで[ドッキングビュー]にチェックマークが付いていることを確認してください。

2.

以下のいずれかの操作を選択してください。

•

フローティング状態のウィンドウのタイトルバーをダブルクリックする。

•

フローティング状態のウィンドウのタイトルバーを移動先のドッキング状態のウィンドウ、メニュー
バー、ツールバー、またはHigh-performance Embedded Workshopのメインウィンドウの端までドラッグする。

ワークスペースウィンドウやアウトプットウィンドウをフローティング状態にするには1.

ポップアップメニューで[ドッキングビュー]にチェックマークが付いていることを確認してください。

2.

以下のいずれかの操作を選択してください。

•

ドッキング状態のウィンドウのコントロールバーをダブルクリックする。

•

ドッキング状態のウィンドウのコントロールバーをHigh-performance Embedded Workshopのメインウ
ィンドウや他のドッキング状態のウィンドウ、メニューバー、ツールバーの端から外れるようにドラ
ッグする。

•

ドッキング状態のウィンドウのコントロールバーを"Ctrl"キーを押しながらドラッグする。

ワークスペースウィンドウやアウトプットウィンドウを隠すには以下のいずれかの操作を選択してください。
•

ウィンドウの右上端にある"閉じる"ボタンをクリックする。

•

フローティング状態のウィンドウの中で右クリックし、ポップアップメニューから[非表示]を選択する。

ワークスペースウィンドウやアウトプットウィンドウを表示するには
ワークスペースウィンドウを表示するには[表示 -> ワークスペース]、アウトプットウィンドウを表示するには[表示 -> アウトプット]を選択してください。

1.2.5

エディタウィンドウ

エディタウィンドウではプロジェクトのファイルを操作します。同時に複数のファイルを開いたり、任意の順
序にファイルを切り替えたり、並べ替えたり、編集できます。デフォルトでは、エディタウィンドウはブック形式で表示します。つまり、各ファイルにタブが付いていてファイル間の行き来を容易にできます（下の図参照）。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 8 of 479

High-performance Embedded Workshop V.4.09

1.

概要

エディタには、ウィンドウ内の左側に余白（カラム）があります。これにより、ブックマークとブレークポイ
ント* の位置を簡単に設定できます。カラムの用途やその表示する情報について知りたい場合は、そのカラム上にマウスポインタを置いてください。これを説明するツールチップとしてポップアップウィンドウを開きます。
エディタウィンドウは[表示形式]ダイアログボックスでカスタマイズできます。[表示形式]ダイアログボック
スは[基本設定 -> 表示の形式]メニューで開きます。[表示形式]ダイアログボックスでは、エディタウィンドウのフォントやテキストの色、タブ文字などが変更できます。また、High-performance Embedded Workshopでインストールした他のウィンドウの外観も変更できます。High-performance Embedded Workshopエディタ以外のエディタを使う場合は、使用するエディタを[オプション]ダイアログボックスで指定してください。[オプション]ダイアログボックスは、[基本設定 -> オプション]から開くことができます。エディタの使用方法について
は、「4. エディタ」を参照してください。
注：*. デバッガに接続している場合のみブレークポイントを設定できます。

1.2.6

アウトプットウィンドウ

デフォルトではアウトプットウィンドウに7つのタブ（[Build]、[Debug]、[Find in Files1]、[Find in Files2]、[Macro]、[Test]、[Version Control]）があります。

[Build]タブ
ビルド実行（コンパイラ、アセンブラなど）の出力を表示します。ソースファイルにエラーがある場合、アウ
トプットウィンドウの[Build]タブにアイコン、およびエラーメッセージをソースファイル名、行番号とともに出力します。
エラーメッセージの表示に関するツールバーボタンまたはポップアップメニューオプションを選択すると、エラーメッセージ出力行を強調表示し、該当ソースがある場合はエディタに該当ソース行を表示します。
エラーメッセージ出力行をダブルクリックすると、該当ソースがある場合はエディタにエラーメッセージの該
R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 9 of 479

High-performance Embedded Workshop V.4.09

1.

概要

当ソース行を表示します。
エラーメッセージの表示に関する操作を行った場合は、ステータスバーにエラーメッセージを表示します。
ウィンドウ内で右クリックすると、使用可能なオプションをポップアップメニューで表示します。
基本的なオプションをツールバーに割り付けています。
[ツールバー表示]、[ツールバーのカスタマイズ]は、ツールバー内で右クリッククしても、ポップアップメニ
ューを表示します。
ポップアップメニューオプション

ツールバーボタン機能
次のエラーの出力行を強調表示し、該当ソースがある場合は-エディタに該当ソース行を表示します。
前のエラーの出力行を強調表示し、該当ソースがある場合は-エディタに該当ソース行を表示します。
次のウォーニングの出力行を強調表示し、該当ソースがある-場合はエディタに該当ソース行を表示します。
前のウォーニングの出力行を強調表示し、該当ソースがある-場合はエディタに該当ソース行を表示します。
次エラー/ウォーニング/情報の表示

次のエラー、ウォーニング、またはインフォメーションの出力行を強調表示し、該当ソース行がある場合はエディタに該
当ソース行を表示します。

前エラー/ウォーニング/情報の表示

前のエラー、ウォーニング、またはインフォメーションの出力行を強調表示し、該当ソースがある場合はエディタに該当
ソース行を表示します。

ヘルプ

この出力行に関するヘルプを表示します。

ジャンプ

-

この出力行に関するソース行をエディタに表示します。

クリア

ウィンドウ内容をクリアします。

保存

ウィンドウ内容をテキストファイルに保存します。

コピー

ウィンドウ内容の選択部分を Windows® クリップボードにコピーします。

ツールバー表示-

ツールバー表示/表示なしを切り替えます。

ツールバーのカスタマイズ-

ツールバーボタンをカスタマイズします。

[Build]タブではビルド実行により出力されたエラーメッセージ行の左側の余白（カラム）にエラーメッセージに対応したアイコンを表示します。
アイコン名

アイコン

エラーメッセージレベル

Build Error

エラー

Build Warning

ウォーニングInformation

インフォメーション[Debug]タブ
あらゆるデバッガ処理の出力を表示します。情報を表示する必要のあるデバッグツールから、アウトプットウ
ィンドウの[Debug]タブに出力します。
ウィンドウ内で右クリックすると、使用可能なオプションをポップアップメニューで表示します。
基本的なオプションをツールバーに割り付けています。
[ツールバー表示]、[ツールバーのカスタマイズ]は、ツールバー内で右クリックしても、ポップアップメニュ
ーを表示します。
R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 10 of 479

High-performance Embedded Workshop V.4.09

ポップアップメニューオプション

1.

ツールバーボタン

概要

機能

クリア

ウィンドウ内容をクリアします。

保存

ウィンドウ内容をテキストファイルに保存します。

コピー

ウィンドウ内容の選択部分を Windows® クリップボードにコピーします。

ツールバー表示-

ツールバー表示/表示なしを切り替えます。

ツールバーのカスタマイズ-

ツールバーボタンをカスタマイズします。

[Find in Files 1]および[Find in Files 2]タブ
ファイル内から検索操作の結果を表示します。ファイル内から検索を使用するには、[編集 -> ファイルから検索]を選択するか、ツールバーの[ファイルの中から検索]ボタンをクリックしてください。ファイル内から検索の使い方の詳細については、「4.4.2 複数のファイルで文字列を検索する」を参照してください。
ウィンドウ内で右クリックすると、使用可能なオプションをポップアップメニューで表示します。
基本的なオプションをツールバーに割り付けています。
[ツールバー表示]、[ツールバーのカスタマイズ]は、ツールバー内で右クリックしても、ポップアップメニュ
ーを表示します。
ポップアップメニューオプション
ジャンプ

ツールバーボタン-機能
関連するソース行を表示します。

クリア

ウィンドウ内容をクリアします。

保存

ウィンドウ内容をテキストファイルに保存します。

コピー

ウィンドウ内容の選択部分を Windows® クリップボードにコピーします。

ツールバー表示-

ツールバー表示/表示なしを切り替えます。

ツールバーのカスタマイズ-

ツールバーボタンをカスタマイズします。

[Macro]タブ
マクロ生成支援機能として、現在のマクロの記録状況を表示します。[ツール -> マクロの記録]による記録の開始から[ツール -> マクロの停止]による記録の終了までにHigh-performance Embedded Workshopマクロファ
イルに記録したHigh-performance Embedded Workshopコマンドラインのコマンドなどの情報を表示します。マ
クロを記録しながら記録内容を確認できます。マクロ生成支援機能の詳細については、「15. マクロ生成支援機能」を参照してください。
ウィンドウ内で右クリックすると、使用可能なオプションをポップアップメニューで表示します。
基本的なオプションをツールバーに割り付けています。
[ツールバー表示]、[ツールバーのカスタマイズ]は、ツールバー内で右クリックしても、ポップアップメニュ
ーを表示します。
ポップアップメニューオプション

ツールバーボタン

機能

クリア

ウィンドウ内容をクリアします。

保存

ウィンドウ内容をテキストファイルに保存します。

コピー

ウィンドウ内容の選択部分を Windows® クリップボードにコピーします。

ツールバー表示-

ツールバー表示/表示なしを切り替えます。

ツールバーのカスタマイズ-

ツールバーボタンをカスタマイズします。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 11 of 479

High-performance Embedded Workshop V.4.09

1.

概要[Test]タブ
テスト支援機能として、現在のテスト実行の結果および進行状況を表示します。テスト実行の進行状況は、現在実行中のテストと、残りのテストの数で構成されています。エラーが発生した場合、このウィンドウに表示されます。テスト支援機能の詳細については、「16. テスト支援機能」を参照してください。
ウィンドウ内で右クリックすると、使用可能なオプションをポップアップメニューで表示します。
基本的なオプションをツールバーに割り付けています。
[ツールバー表示]、[ツールバーのカスタマイズ]は、ツールバー内で右クリックしても、ポップアップメニュ
ーを表示します。
ポップアップメニューオプション

ツールバーボタン

機能

クリア

ウィンドウ内容をクリアします。

保存

ウィンドウ内容をテキストファイルに保存します。

コピー

ウィンドウ内容の選択部分を Windows® クリップボードにコピーします。

ツールバー表示-

ツールバー表示/表示なしを切り替えます。

ツールバーのカスタマイズ-

ツールバーボタンをカスタマイズします。

[Version Control]タブ
バージョン管理操作の結果を表示します。このタブは、バージョン管理システムを使っているときだけ表示します。バージョン管理の詳細については、「7. バージョン管理」を参照してください。
ウィンドウ内で右クリックすると、使用可能なオプションをポップアップメニューで表示します。
基本的なオプションをツールバーに割り付けています。
[ツールバー表示]、[ツールバーのカスタマイズ]は、ツールバー内で右クリックしても、ポップアップメニュ
ーを表示します。
ポップアップメニューオプション

ツールバーボタン

機能

クリア

ウィンドウ内容をクリアします。

保存

ウィンドウ内容をテキストファイルに保存します。

コピー

ウィンドウ内容の選択部分を Windows® クリップボードにコピーします。

ツールバー表示-

ツールバー表示/表示なしを切り替えます。

ツールバーのカスタマイズ-

ツールバーボタンをカスタマイズします。

"Shift+ESC"キーを押すとアウトプットウィンドウを閉じます。
アウトプットウィンドウは文字列の色、背景色、およびフォントを他のウィンドウと同じようにカスタマイズできます。
さらにアウトプットウィンドウの[Build]タブでは、エラーメッセージ行の文字列を他の行の文字列と異なる色で強調表示されるようにカスタマイズが可能です。
既存の色をカスタマイズするには
1.

[基本設定 -> 表示の形式]を選択してください。[表示形式]ダイアログボックスが開きます。

2.

[Output]アイテムをダイアログボックスの左側のツリーから選択し展開します。

3.

色を変更したいカテゴリを選択します。以下の表に示すカテゴリが選択できます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 12 of 479

High-performance Embedded Workshop V.4.09

カテゴリ

1.

概要

カラータブの前面の色

カラータブの背景の色

カスタマイズ

カスタマイズ(デフォルト)(デフォルト)

されるタブ

される出力内容Text

SYSTEMSYSTEM

すべてのタブ

すべて

Build Error Text

黒

白

Build

エラー行

Build Warning Text

黒

白

Build

ウォーニング行

Information Text

黒

白

Build

インフォメーション行

4.

[カラー]タブの[前面]リストと[背景]リストの選択を変更します。

5.

[OK]ボタンをクリックします。

1.2.7

ステータスバー

現在のHigh-performance Embedded Workshopの状態に関する様々な情報を表示します。下の図にステータスバ
ーを示します。

ステータスバーのカスタマイズ機能によって、ステータスバー領域およびその内容をカスタマイズできます。
ステータスバー領域には、特定のターゲットによって必要なターゲット関連の情報も表示します。
ステータスバー領域の最下部には一般的なアプリケーション関連の情報（以前のバージョンと同様の内容）を表示します。
ターゲット関連の情報をその上に表示します。表示情報はすべてターゲットに依存するため、表示されない場
合もあります。
[表示 -> ステータスバー]の選択により、ステータスバーの表示/非表示の切り替えが可能です。
ステータスバー領域の一部でも表示している場合に選択すると、ステータスバー領域をすべて非表示にします。
ステータスバー領域を表示していない場合に選択すると、アプリケーション関連領域を表示します。
ステータスバーのポップアップメニューの選択により、ステータスバーを非表示にできます。
ポップアップメニューは、アプリケーションまたはターゲット関連領域にある個々の項目も含めたステータス
バー項目のオン/オフの切り替えが可能です。
ステータスバー領域上で右マウスボタンをクリックするとポップアップメニューを表示します。

注：*. ステータスバーのターゲット関連領域は、ターゲットによっては表示されません。
すべてのターゲット関連のステータスバー項目をオフにすると、ステータスバーのターゲット関連領域全体がR20UT0372JJ0100 Rev.1.00
2011.02.01

Page 13 of 479

High-performance Embedded Workshop V.4.09

1.

概要

非表示になります。ターゲット関連のステータスバー項目のいずれかをオンにすることにより再び表示できま
す。

1.3

ヘルプ機能

[ヘルプ]メニューは、High-performance Embedded Workshopメニューバーの右端にあります。[ヘルプ]メニューには[トピック]があります。[トピック]を選択すると、High-performance Embedded Workshopヘルプウィンドウのメイン画面を表示します。
特定のダイアログボックスに関するヘルプを参照したいときは、各ダイアログボックスの右上端にある状況依
存ヘルプボタンをクリックしてください（下の図を参照）。

状況依存ヘルプボタンをクリックすると、マウスポインタが？(クエスチョンマーク)付きのポインタに変わります。この状態で、ダイアログボックスの一部をクリックすると、その部分に関するヘルプを表示します。また、ダイアログボックスの一部を選択しF1キーを押すと、そのヘルプを表示します。

1.4

High-performance Embedded Workshopを起動する

High-performance Embedded Workshopを起動するには、Windows® の[スタート]メニューを開き、[すべてのプ
ログラム -> Renesas -> High-performance Embedded Workshop]を選択し、High-performance Embedded Workshopのショートカットを選択します。起動画面に続き[ようこそ!]ダイアログボックスが開きます。

High-performance Embedded Workshopを起動しワークスペースを使用したことがある場合は、デフォルトで[最近使用したプロジェクトワークスペースを開く]ボタンが選択されています。一度もワークスペースを使用していない場合は、[新規プロジェクトワークスペースの作成]ボタンが選択されています。
新規ワークスペースを作成するには、[新規プロジェクトワークスペースの作成]ボタンを選択し、[OK]ボタンをクリックしてください。
R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 14 of 479

High-performance Embedded Workshop V.4.09

1.

概要

最近使用したワークスペースを開くには、[最近使用したプロジェクトワークスペースを開く]ボタンを選択し、ドロップダウンリストからワークスペースを選択し、[OK]ボタンをクリックしてください。このリストには、[ファイル -> 最近使ったワークスペース]のサブメニューに表示されているものと同じ内容を表示します。
ワークスペースファイル（".HWS"ファイル）を指定してワークスペースを開くには[別のプロジェクトワーク
スペースを参照する]ボタンを選択し、[OK]ボタンをクリックしてください。
[同期デバッグ]ダイアログボックスを開くには、[マルチコアデバッグを開始する]ボタンを選択し、ドロップ
ダウンリストから同期デバッグ設定を選択し、[OK]ボタンをクリックしてください。同期デバッグ機能を使用していない場合、この項目は表示されません。
ツールを登録したり、ツールの登録を取り消したりするには、[アドミニストレーション]ボタンをクリックしてください。
ワークスペースを開かずにHigh-performance Embedded Workshopを使うには[キャンセル]ボタンをクリックしてください。
次回起動する時に[ようこそ!]ダイアログボックスを開かないようにするには、[基本設定 -> オプション]を選択し、表示される[オプション]ダイアログボックスの[確認]タブで[ようこそダイアログボックスの表示]チェックボックスをオフにしてください。
High-performance Embedded Workshopを起動する時に起動画面を表示しないようにするには、[オプション]ダイ
アログボックスの[確認]タブで[起動画面]チェックボックスをオフにしてください。

新規ワークスペースを作成する

1.5

新規にワークスペースを作成するには
1.

[ようこそ!]ダイアログボックスから[新規プロジェクトワークスペースの作成]オプションを選択し、[OK]ボタンをクリックするか、[ファイル -> 新規ワークスペース]を選択してください。[新規プロジ
ェクトワークスペース]ダイアログボックスが開きます。

2.

[ワークスペース名]に新規ワークスペース名を入力してください。新規ワークスペース名は32文字以
内で、半角英数字、半角下線のみ使用してください。特に、日本語文字、空白、または半角マイナス
記号は使用しないでください。ワークスペース名を入力すると、自動的にワークスペースのサブディ
レクトリおよび[プロジェクト名]が追加されます。これは、必要に応じて変更できます。ワークスペースとプロジェクトは別名にできます。[参照]ボタンをクリックしてワークスペースを作成するディレクトリを選択したり、[ディレクトリ]にワークスペースを作成するディレクトリを入力できます。

3.

ワークスペースの基本となる[CPU種別]および[ツールチェイン]を選択してください。

4.

新規ワークスペースを作成するとき、High-performance Embedded Workshopは自動的に[プロジェクト名]で指定したプロジェクトを作成して、新規ワークスペースに追加します。プロジェクトタイプリス
トには、使用可能なプロジェクトの種類（Application、Libraryなど）を表示します。作成するプロジ
ェクトの種類をリストから選択してください。表示するプロジェクトの種類は、現在の[CPU種別]および[ツールチェイン]の組み合わせに有効な全種類となります。ツールチェイン専用、デバッグ専用（[Debugger only - xxxxxx]）、またはHigh-performance Embedded Workshopのデバッガおよびツールチ
ェインの両方を設定するフルプロジェクトがあります。

5.

新規ワークスペースとプロジェクトを作成するには、[OK]ボタンをクリックしてください。選択した
プロジェクトの作成をガイドするウィザードが開きます。

注：
同一ディレクトリに既にワークスペースが存在する場合はワークスペースを作成できません。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 15 of 479

High-performance Embedded Workshop V.4.09

1.

概要

ワークスペースを開く

1.6

ワークスペースを開くには
1.

[ようこそ!]ダイアログボックスから[別のプロジェクトワークスペースを参照する]オプションを選んで[OK]ボタンをクリックするか、[ファイル -> ワークスペースを開く]を選択してください。[ワークスペースを開く]ダイアログボックスが開きます。

2.

開きたいワークスペースファイル（".HWS"ファイル）を選択します。

3.

[選択]ボタンをクリックしてワークスペースを開いてください。ワークスペースを開くときに情報を表示するように設定している場合、[ワークスペースプロパティ]ダイアログボックスが開きます。設
定していない場合、ワークスペースを開きます。
[ワークスペースプロパティ]ダイアログボックスを開くかどうかは[ワークスペースプロパティ]ダイ
アログボックスの[ワークスペースを開いたときにワークスペース情報の表示]チェックボックス、または、[オプション]ダイアログボックスの[ワークスペース]タブの[ワークスペースを開いたときにワー
クスペース情報の表示]チェックボックスのオンオフの有無によります。[オプション]ダイアログボッ
クスは、[基本設定->オプション]から開くことができます。[ワークスペースプロパティ]ダイアログボ
ックスで[OK]ボタンをクリックするとワークスペースを開きます。[キャンセル]ボタンをクリックするとワークスペースを開きません。

最近開いたファイルを[ファイル]メニューの[最近使ったワークスペース]サブメニューに表示します。最近使ったワークスペースを再び開きたいときに使用してください。
最近使ったワークスペースを開くには以下のいずれかの操作を選択してください。
•[ようこそ!]ダイアログボックスから[最近使用したプロジェクトワークスペースを開く]を選択し、ドロップダウンリストからワークスペース名を選択し、[OK]ボタンをクリックします。

•[ファイル -> 最近使ったワークスペース]を選択し、そのサブメニューからワークスペース名を選択します。

注：
High-performance Embedded Workshopでは、一度に1つのワークスペースしか開けません。したがって、既に開いているワークスペースがあるときに別のワークスペースを開こうとすると、既に開いているワークスペースを閉じてから新しいワークスペースを開く必要があります。

1.7

古いワークスペースを使用する

High-performance Embedded Workshopでは、以前のバージョンのHigh-performance Embedded Workshopで作成したワークスペースも開くことができます。ワークスペースを開いたときに自動的にアップグレードします。アップグレードしたファイルの現在のディレクトリに、ワークスペースまたはプロジェクトのファイルのバック
アップを保存します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 16 of 479

High-performance Embedded Workshop V.4.09

1.

概要

ワークスペースを保存する

1.8

ワークスペース（およびプロジェクト）の情報は、High-performance Embedded Workshopのバージョン毎に増えています。そのため、ワークスペースを保存する形式がHigh-performance Embedded Workshopのバージョン
毎に少しずつ異なります。
現在のバージョン形式のワークスペースとして保存するには、[ファイル -> ワークスペースの保存]を選択してください。
旧バージョン形式のワークスペースとして保存するには、[ファイル -> 旧バージョン形式でワークスペースを保存]を選択してください。前回ワークスペースを保存してからワークスペースまたはプロジェクトの情報を変更している場合は、現在のファイルとバージョンで保存するか否かを確認するメッセージを表示します。続いて[旧バージョン形式でワークスペースを保存]ダイアログボックスが開きます。

このダイアログボックスには、現在のワークスペースに関連するファイルのリスト、選択可能なバージョンをリストアップしたドロップダウンリスト（デフォルトで現在のバージョンを選択）、関連するファイル名を一括して変更するために短いプレフィックスを入力できるエディットボックスがあります。プレフィックスを変更すると、[ファイル]リストの表示を新しい名前で更新します。
例としてHigh-performance Embedded Workshop V.4.02.00で読み込み可能な形式としてワークスペースを保
存するには
1.

[フォーマット]ドロップダウンリストで「HEW 4.02.00 Format」を選択します。

2.

[プレフィックス]に「402_」を入力します。

3.

OKをクリックします。

現在のディレクトリ（ソースファイルなどそのまま使用可能）に、入力したプレフィックス付きファイル名でワークスペースを保存します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 17 of 479

High-performance Embedded Workshop V.4.09

1.

概要

例:
C:¥Workspace¥Workspace_Name¥402_Workspace_Name.hws
C:¥Workspace¥Workspace_Name¥DemoSH4¥402_Project_Name.hwp
C:¥Workspace¥Workspace_Name¥DemoSH4¥402_DefaultSession.hsf
C:¥Workspace¥Workspace_Name¥DemoSH4¥402_SimSessionSH-1.hsf
現在のディレクトリ（ソースファイルなどそのまま使用可能）に、入力したプレフィックス付きファイル名でワークスペースを保存します。

ワークスペースを閉じる

1.9

High-performance Embedded Workshopのワークスペースを閉じるには、[ファイル -> ワークスペースを閉じる]
を選択してください。ワークスペースまたはそのプロジェクトに変更があった場合は、保存するかどうかを選択してください。

1.10

High-performance Embedded Workshopを終了する

High-performance Embedded Workshopを終了するには [ファイル -> アプリケーションの終了]を選択するか、"Alt+F4"キーを押すか、システムメニューから[閉じる]オプションを選択してください。（システムメニュー
はHigh-performance Embedded Workshopタイトルバーの最も左上側にあるアイコンをクリックすると開きま
す。）

1.11

ツールシステム概要

ツールを追加することによって、High-performance Embedded Workshopの機能を拡張できます。これを行うには、[ツールアドミニストレーション]ダイアログボックスでツールを登録しておくことが必要です。これらのツールを用いて、ウィンドウ、メニュー、およびツールバーを High-performance Embedded Workshopシステムに追加できます。ツールの例としては、High-performance Embedded Workshopのデバッガおよびビルダツールがあります。デバッガツールはデバッガに関連するすべてのメニューとツールバーを追加し、ビルダツールも同じようにビルド機能に関するすべてのメニューとツールバーを追加します。システムに登録したツールによって、High-performance Embedded Workshopの使い方が変わります。そのため、このユーザーズマニュアルに記載されたメニューのうち使用できないものもあります。例えば、ビルダツールがインストールされていない場合、[ビルド]メニューにはオプション設定のメニューオプションがありません。

1.12

High-performance Embedded Workshop管理情報ファイル

High-performance Embedded Workshopは、動作するために以下のファイルに管理情報を保持します。
•

アプリケーションレベルの設定情報ファイル•

ウィンドウのデフォルトポジションファイル•

High-performance Embedded Workshopデータベースファイル•

コンポーネントデータファイル *•キーボードショートカットレイアウトファイル•

マクロ情報ファイルおよび新規登録したマクロファイル•

カスタムプロジェクトタイプウィザード

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 18 of 479

High-performance Embedded Workshop V.4.09•

シンタックスハイライトファイル•

テンプレートファイル•

同期デバッグオプション設定ファイル *1.

概要*. 機能のサポートはデバッガに依存します。
これらのファイルは、コンピュータ上のユーザアカウント別に保存します。High-performance Embedded
Workshopをマルチインストールした場合は、ユーザアカウント別にHigh-performance Embedded Workshop毎に保存します。

1.13

コンフィグレーションおよびセッションの概要[標準]ツールバーに現在のコンフィグレーションおよび現在のセッションをドロップダウンリストボックスで表示します。
この例は、プロジェクト作成時にRenesas SuperH Standard用ツールチェインを選択し、ターゲットとするデバッガにSH-4 Simulatorを選択した場合のコンフィグレーションとセッションを示しています。
ドロップダウンリストボックスを選択し現在のコンフィグレーションおよび現在のセッションから別のコン
フィグレーションおよび別のセッションへ切り替えることができます。
必要に応じてコンフィグレーションおよびセッションを追加したり削除したりできます。
•

コンフィグレーション

コンフィグレーションとはデバッグ情報の出力の有無、および最適化の有無といったビルドのオプションの設定内容に名前を付けて保持しているものです。"ビルドコンフィグレーション"ともいいます。
[標準]ツールバーの図の例では、SimDebug_SH-4コンフィグレーション、Debugコンフィグレーション、およびReleaseコンフィグレーションを表示します。
High-performance Embedded Workshopが作成するコンフィグレーション
ツールチェインを選択しプロジェクトを作成した場合、DebugコンフィグレーションおよびReleaseコンフィグ
レーションを自動的に作成します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 19 of 479

High-performance Embedded Workshop V.4.09

1.

概要

プロジェクトの作成時にターゲットとするデバッガをチェックした場合は、チェックしたデバッガ用のコンフィグレーションが作成されます。プロジェクトの作成時に[ターゲット]で"SH-4 Simulator"をチェックした場合はSimDebug_SH-4コンフィグレーションが作成されます。コンフィグレーションの名前はプロジェクトの作成時に変更できます。

また、プロジェクトディレクトリ* 下に各コンフィグレーション用のディレクトリがコンフィグレーションと同じ名前で作成されます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 20 of 479

High-performance Embedded Workshop V.4.09

1.

概要

注：
*. プロジェクトディレクトリは、新規ワークスペースプロジェクト作成時のワークスペースディレクトリ下にプロジェクト名と同じ名前で作成されます。

ビルドオプションの設定方法
コンフィグレーションに保持されるビルドのオプションを設定するには、[ビルド]メニューのビルドのオプシ
ョンを設定するダイアログボックスでドロップダウンリストボックスからコンフィグレーションを選択し、コンパイラ、アセンブラ、および最適化リンカなどの各オプションを設定します。下の図は、Renesas SuperH
Standard用ツールチェインのビルドのオプションを設定するダイアログボックスです。

コンフィグレーションの詳細は、「2.7 ビルドのコンフィグレーション」を参照してください。
•

セッション

セッションとは
おもにデバッガに接続してデバッグするときに使用するHigh-performance Embedded Workshopのデバッグオ
プションの設定*、デバッガ固有の様々なオプションの設定、およびメモリウィンドウ、またはレジスタウィ
ンドウなどのウィンドウとその位置の情報などに名前を付け保持しているものです。"デバッグセッション"ともいいます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 21 of 479

High-performance Embedded Workshop V.4.09

1.

概要[標準]ツールバーの図の例では、SimSessionSH-4セッションおよびDefaultSessionセッションを表示しています。
各セッションの情報は、High-performance Embedded Workshopプロジェクトでそれぞれ別のファイルに保存されます。
注：*. High-performance Embedded Workshopと接続するデバッガ、コア、デバッグフォーマット、ダウンロードモ
ジュールの設定、デバッガへHigh-performance Embedded Workshopが接続するタイミング、およびコマンドバ
ッチをHigh-performance Embedded Workshopが実行するタイミングなどのオプション設定があります。
High-performance Embedded Workshopが作成するセッション
ツールチェインを選択しプロジェクトを作成した場合、DefaultSessionセッションを自動的に作成します。
プロジェクトの作成時にターゲットとするデバッガをチェックした場合は、チェックしたデバッガをHigh-performance Embedded Workshopと接続するセッションを自動的に作成します。
例えば、プロジェクトの作成時に[ターゲット]で"SH-4 Simulator"をチェックした場合はSimSessionSH-4セッシ
ョンが作成されます。
High-performance Embedded Workshopのデバッグオプションの設定方法
セッションに保持されるHigh-performance Embedded Workshopのデバッグオプションを設定するには、[デバッグ]メニューの[デバッグの設定]ダイアログボックスでドロップダウンリストボックスからセッションを選択し、[ターゲット]タブおよび[オプション]タブで各オプションを設定します。

デバッグセッションの詳細は、「17.1.6 デバッグセッション」を参照してください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 22 of 479

High-performance Embedded Workshop V.4.09

1.14

1.

概要

マクロ生成支援機能とテスト支援機能の概要

プログラムのコーティングが完了したらテストを実施します。テストで問題が見つかると問題の箇所を修正して再テストを行います。プログラム開発において、テストに掛かる工数は非常に大きな割合を占めています。
High-performance Embedded Workshopでは、このテスト工程の支援のために、マクロ生成支援機能およびテス
ト支援機能を提供しています。
•

マクロ生成支援機能

マクロ生成支援機能は、High-performance Embedded Workshopシステムのアプリケーション関連（*1）、ビルド関連（*2）、およびデバッグ関連（*3）などの一部の操作をHigh-performance Embedded Workshopコマンド
ラインのコマンドとして記録、または記録したコマンドを実行する機能です。
記録されるファイル（High-performance Embedded Workshopマクロファイル）は、拡張子がhdcのコマンドバッ
チファイルであり編集可能なテキストファイルです。このファイルは、各ユーザプロファイルのアプリケーションデータフォルダにあるHigh-performance Embedded Workshop管理情報フォルダ下の"Macros"フォルダに作成されます。デフォルトのファイル名はDefault.hdcです。
High-performance Embedded Workshopコマンドラインのコマンドに対応するHigh-performance Embedded
Workshopシステムのすべての操作が記録できるわけではありません。各機能のメニューオプション一覧には"マクロの記録"欄にマクロの記録マーク( )を表示しHigh-performance Embedded Workshopマクロファイルへ記
録可能かどうかを示しています。
注：*1. プロジェクトの変更、セッションの変更、コンフィグレーションの変更など*2. コンパイル、ビルドなど*3. モジュールのダウンロード、メモリ値の変更、レジスタ値の変更、ソフトウェアブレークの設定／解除、プログラム実行など
マクロ生成支援機能は、[ツール]メニューと[マクロ]ツールバーで利用できます。

[マクロ]ツールバーが表示されていない場合は、[基本設定 -> カスタマイズ]を選択し[カスタマイズ]ダイアロ
グボックスを開きます。[カスタマイズ]ダイアログボックスの[ツールバー]タブで、[マクロ]チェックボックスをオンにしてください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 23 of 479

High-performance Embedded Workshop V.4.09[ツール]メニュー
マクロの設定1.

概要[マクロ]ツールバー

機能−[マクロの設定]ダイアログボックスを開きます。下記の機能を備えており、選択した High-performance Embedded Workshop のマクロファイル毎に記録されたマクロ名がリストに表示されています。

• マクロファイルの新規作成• マクロファイルのインポート• マクロの記録• マクロの実行• マクロの編集• マクロの割り当て• マクロの削除
マクロの記録マクロの記録を開始します。

マクロの実行[マクロの選択]ダイアログボックスが開きます。実行するマクロを選択します。

−

マクロの記録または実行を一時停止します。

マクロの停止マクロの記録または実行を停止します。

[マクロの記録]()を選択してから[マクロの停止]()を選択するまでが1つの"マクロ"で、1つのHigh-performance Embedded Workshopマクロファイルには複数のマクロ（High-performance Embedded Workshop
コマンドラインのコマンドの集まり）が記録できます。マクロには、複数のHigh-performance Embedded
Workshopコマンドラインのコマンドが含まれます。
下記はHigh-performance Embedded Workshopマクロファイルとマクロの例です。

アウトプットウィンドウの[Macro]タブには現在のマクロの記録状況を出力します。上の図の「Build」マクロは下記のように出力します。

操作手順については「1.14.1 テストシナリオの例」も参照してください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 24 of 479

High-performance Embedded Workshop V.4.09

•

1.

概要

テスト支援機能

テスト支援機能は、比較したいテスト項目（テストイメージデータ）でテストイメージファイルを作成し、マクロ生成支援機能で生成したマクロまたは従来のHigh-performance Embedded Workshopのコマンドバッチを実行して、テストイメージファイルとHigh-performance Embedded Workshopシステムを比較できる機能です。テストイメージデータはテストイメージファイル（.HIF）に保存します。
High-performance Embedded Workshopシステムのすべての機能のテストイメージデータを保存できるわけではありません。テストイメージデータを保存できる機能については、「16.6 テストイメージファイルにテストイ
メージデータとして保存できる機能」に記載していますので参照してください。
テスト支援機能の主な操作手順を下記に示します。操作手順については「1.14.1 テストシナリオの例」も参照
してください。

テスト支援機能は、[テスト]メニューとワークスペースウィンドウの[Test]タブのポップアップメニューで利用できます。
テスト支援機能の最初のステップは、テストスイート（テストの集まり）の作成です。[テスト -> テストスイートの作成]で作成できます。テストスイートの作成後は、ワークスペースウィンドウの[Test]タブでも操作可能です。
テストスイートを編集し、テスト中に実行するマクロおよびテストベースのテストイメージファイルを指定します。
次にテスト内容として、テストイメージファイルに取得するためのいくつかのテスト項目を設定します。テス
トベースとしたいHigh-performance Embedded Workshopの状態で、設定したテスト項目に基づきテストイメー
ジデータを取得しテストイメージファイルに保存します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 25 of 479

High-performance Embedded Workshop V.4.09

1.

概要

テスト（マクロの集まり）を実行し、テストが完了すると指定したテスト項目が比較されます。結果がテスト
ブラウザウィンドウに表示されます。
比較した結果、不一致があるとテスト項目の結果カラムに"FAIL"を表示します。この場合、テスト項目をダブ
ルクリックすると詳細情報が確認可能です。

テストシナリオの例

1.14.1

マクロ生成支援機能とテスト支援機能を使用した主なビルド、デバッグ操作の流れをテストシナリオの一例として紹介します。
このテストシナリオでは、SuperHファミリ用シミュレータデバッガなどで"Demonstration"タイプを指定したプ
ロジェクトやエミュレータデバッガなどでTutorialプロジェクトに含まれているようなC言語で記述された10個のランダムデータを昇順/降順にソートするプログラムを使用します。配列に格納されるデータに差異が発生したケースを確認します。
ここでは、プログラムコード内の配列"a"をローカル変数からグローバル変数に編集してから使用します。
•

テストの前にはじめにワークスペースを開きデバッガに接続します。
1.

新規にプロジェクトワークスペースを作成するか既にある場合はこれを開きます。プロジェクトワー
クスペースの作成については「17.1.2 デバッガを選択する」を参照してください。

2.

[標準]ツールバーのセッションリストからデバッガに接続するセッションを選択します。セッションの選択については「17.1.6.1 セッションを選択する」を参照してください。

操作により確認要求ダイアログボックスが表示される場合があります。例えば、プログラムをすべてビルドした場合、デフォルトでダウンロードするか否かの確認要求ダイアログボックスが開きます。プログラムをダウ
ンロードする場合は「はい」ボタンをクリックします。
確認要求ダイアログボックスのボタンのクリックはマクロに記録されないため、次回マクロを実行すると、確認要求ダイアログボックスは表示されてしまいます。マクロ実行処理を継続するためにはいずれかのボタンをクリックしなくてはいけません。テスト支援機能を使用する場合、一連の操作を繰り返しテストするので処理を継続する必要があります。そのため、確認要求ダイアログボックスが表示されないよう次のように設定してください。
確認要求ダイアログボックスの[今後表示しない]チェックボックスをオンにしてください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 26 of 479

High-performance Embedded Workshop V.4.09

1.

概要

テスト開始時のHigh-performance Embedded Workshopの環境をテスト開始前に毎回同じ環境にするため、テストに使用したいHigh-performance Embedded Workshop環境を保存してください。
1.

[ファイル -> ワークスペースの保存]を選択してください。

2.

[ファイル -> セッションの保存]を選択してください。

テスト開始時に保存したHigh-performance Embedded Workshopの環境を読み込むことで、毎回同じ環境でテストを開始できます。
•

本テストシナリオで使用するテストスクリプトの準備

このテストシナリオでは、マクロ生成支援機能を使用し、次の一連の操作をHigh-performance Embedded
Workshopコマンドラインのコマンドとしてマクロに記録します。このマクロをテストスクリプトとしてテスト実行時に使用します。
操作の分類

操作

プログラム実行前の準備

セッションの再読み込み• 各設定値の初期化• プログラムの準備（ステップ 1(2)参照）
レジスタ値の初期化 *（ステップ 1(3)参照）
デモンストレーション用プログラムのビルド *（ステップ 1(4)参照）

プログラムダウンロード

デモンストレーション用プログラムのダウンロード（ステップ 1(5)参照）

変数の登録、プログラム実行、

メモリフィル機能で配列 a のメモリの値を 0 に設定

および実行結果の確認（ステップ 1(6)参照）
CPU のリセット（ステップ 1(7)参照）
main 関数内の任意のカーソル行まで GO 実行（ステップ 1(9)参照）
ランダムデータを格納している配列をウォッチウィンドウへ登録 *（ステップ 1(10)参照）

注：*. 機能のサポートはデバッガに依存します。
•

テストシナリオの例

テスト支援機能を使用し、配列のデータ（配列のアドレスのメモリ内容）をテスト対象とします。
テストベースとなるHigh-performance Embedded Workshopの状態のテストイメージデータをテストイメージフ
ァイルに保存した後、配列にデータを格納する回数を減らすようプログラムを変更した後にテストを実行し、R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 27 of 479

High-performance Embedded Workshop V.4.09

1.

概要

配列に格納されているデータに差異が生じることをテストにより確認します。続いて格納する回数を元に戻し同じテストを実行します。最初のテストベースのテストイメージファイルと比較し配列に格納されているデー
タ値に差異が生じていないことを確認します。
ステップ 1： マクロの記録
ステップ 2： マクロを編集する（記録内容を見る）
ステップ 3： マクロを実行する
ステップ 4： テストスイートを作成する
ステップ 5： テストスイートを編集する
ステップ 6： テストイメージファイルを作成する
ステップ 7： プログラムを変更しテストを実行する
ステップ 8： テスト結果を確認する（不一致の場合）
ステップ 9： プログラムを元に戻しテストを実行する
ステップ10： テスト結果を確認する（一致した場合）

ステップ 1： マクロの記録

1.14.2

次の一連の操作でマクロ生成支援機能を使用しHigh-performance Embedded Workshopコマンドラインのコマンドを記録します。
記録したHigh-performance Embedded Workshopコマンドラインのコマンドは、アウトプットウィンドウの[Macro]タブに順次出力されます。ただし、操作によってはアウトプットウィンドウのタブが切り替わります。
1.

[マクロ]ツールバーの[マクロの記録]ボタン( )をクリックします。このときマウスポインタに[マクロの記録]アイコンが付きます()。アウトプットウィンドウの[Macro]タブに「Recording...」メッセー

ジが出力されます。
2.

[ファイル -> セッションのリフレッシュ]を選択します。
（refresh_sessionコマンドが記録されます）

3.

)をクリックしレジスタウィンドウを表示します。値を変更す[CPU]ツールバーの[レジスタ]ボタン(

るレジスタ上でダブルクリックし、[レジスタ値設定]ダイアログボックスを開きます。[値]に0を入力します。
（register_setコマンドが記録されます）
4.

[標準]ツールバーの[ビルド]ボタン()をクリックしデモンストレーション用プログラムをビルドします。
（buildコマンドが記録されます）
5.

ワークスペースウィンドウの[Projects]タブの[Download modules]フォルダ下のデモンストレーション
用プログラムをダブルクリックしダウンロードします。
（file_loadコマンドが記録されます）

6.

[CPU]ツールバーの[メモリ]ボタン()をクリックし、[表示開始アドレス]ダイアログボックスを開きます。[表示開始アドレス]に配列aのアドレスを入力しメモリウィンドウを開きます。メモリウィンド
ウ上で充填する配列aのアドレス領域をドラッグして選択してください。ウィンドウ内で右クリック
し、ポップアップメニューから[フィル]を選択します。[メモリフィル]ダイアログボックスのフィルデータに0を入力します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 28 of 479

High-performance Embedded Workshop V.4.09

1.

概要（memory_fillコマンドが記録されます）
7.

[デバッグラン]ツールバーの[CPUリセット]ボタン()をクリックしCPUをリセットします。

（resetコマンドが記録されます）
8.

main関数を含むソースファイルをエディタウィンドウに表示します。

9.

main関数の最終行上で右クリックしポップアップメニューから[カーソル位置まで実行]を選択します。
（go_tillコマンドが記録されます）

10. ランダムデータを格納している配列要素"a[6]"をウォッチウィンドウへ追加します。
（watch_addコマンドが記録されます）
11. 最後に[マクロ]ツールバーの[マクロの停止]ボタン( )をクリックします。マウスポインタは通常の矢印に戻ります。
12. マクロ名を入力する[マクロの新規追加]ダイアログボックスが開きますので、マクロ名（例："Demo"）を入力してください。アウトプットウィンドウの[Macro]タブに「Finished recording 'Demo'.」が出力されます。
アウトプットウィンドウの[Macro]タブを選択してください。記録したHigh-performance Embedded Workshopコ
マンドラインのコマンドが確認できます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 29 of 479

High-performance Embedded Workshop V.4.09

概要

ステップ 2： マクロを編集する（記録内容を見る）

1.14.3
1.

1.

[ツール -> マクロの設定]を選択し[マクロの設定]ダイアログボックスを開きます。マクロを記録した
High-performance Embedded Workshopマクロファイル"Default"が[使用中のマクロファイル]リストに表示されています。

2.

[マクロ一覧]リストから"Demo"マクロを選択し、[編集]ボタンをクリックします。エディタウィンドウに"Demo"マクロが記録されたHigh-performance Embedded Workshopのマクロファイル"Default.hdc"が表示されます。

High-performance Embedded Workshopのマクロファイルには、マクロ名を識別する情報行の間にHigh-performance Embedded Workshopコマンドラインのコマンドが記録されています。
プログラム実行などを含むマクロの場合、アウトプットウィンドウの[Debug]タブには停止要因などの情報が表示されます。そのため、テスト結果を比較する際に差異が生じる場合があります。アウトプットウィンドウの各タブの表示内容をクリアするHigh-performance Embedded Workshopのコマンドラインのclear_output_windowコマンドがあります。あらかじめ"#Macro Demo -Start"の次の行にアウトプットウィンドウの[Debug]タブの情報をクリアする以下の行を追加することも可能です。
clear_output_window debug

必要に応じて内容を編集後、[エディタ]ツールバーの[ファイルの保存]ボタン()をクリックしてください。

High-performance Embedded Workshopのマクロファイル"Default.hdc"を閉じてください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 30 of 479

High-performance Embedded Workshop V.4.09

概要

ステップ 3： マクロを実行する

1.14.41.

1.

[マクロ]ツールバーの[マクロの実行]ボタン( )をクリックします。[マクロの選択]ダイアログボックスが開きます。

2.

"Demo"マクロを選択しOKボタンをクリックすると、記録したコマンドの実行を開始します。このときマウスポインタに[マクロの実行]アイコンが付きます(

3.

マクロの実行が終了するとマウスポインタは通常の矢印に戻ります。

ステップ 4： テストスイートを作成する

1.14.5
1.

)。

[テスト -> テストスイートの作成]を選択し、[新規テストスイートの作成]ダイアログボックスを開きます。

2.

[テストスイート名]に"Test_Suite_Demo"を入力します。

3.

[ディレクトリ］はあらかじめワークスペースディレクトリが表示されています。必要に応じて編集してください。

4.

[OK]ボタンをクリックします。

5.

ワークスペースウィンドウの[Test]タブを表示してください。"Test_Suite_Demo"テストスイートアイコンが表示されています。

ステップ 5： テストスイートを編集する

1.14.6

テストを実行するために「ステップ1」で記録したマクロを選択します。
1.

"Test_Suite_Demo"テストスイートアイコン上で右クリックしポップアップメニューを表示します。

2.

[テストスイートの編集]を選択し、[テストスイートの編集]ダイアログボックスを開きます。

3.

[追加]ボタンをクリックし[テストの追加]ダイアログボックスを開きます。

4.

[テスト名]に"Test_Demo"と入力します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 31 of 479

High-performance Embedded Workshop V.4.09

1.

概要

5.

[テストの説明]に"Demonstration"と入力します。

6.

[追加]ボタンをクリックし[テストスクリプトの追加]ダイアログボックスを開きます。

7.

[テストに追加するマクロ]で"Demo"チェックボックスをオンにします。

8.

OKボタンをクリックします。

9.

[テストイメージファイル]には、あらかじめ「ステップ4」で入力したテストスイート名に'_'が付加されて表示されています。'_'に続いて[テスト名]に入力したテスト名"Test_Demo"が表示されます（"テストスイート名"+'_'+"テスト名"）。必要に応じて編集してください。

10. OKボタンをクリックします。[テストケース]リストに"Test_Demo"テストが追加されます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 32 of 479

High-performance Embedded Workshop V.4.09

1.

概要

11. OKボタンをクリックします。"Test_Suite_Demo"テストスイートアイコン下に"Test_Demo"テストアイ
コンが表示されました。

ステップ 6： テストイメージファイルを作成する

1.14.7

テスト項目として配列のアドレスのメモリ内容、およびウォッチウィンドウの内容を比較するため、それらのテストイメージデータの取得範囲を設定します。ステップ5で指定したテストイメージファイル"Test_Suite_Demo_Test_Demo.hif"にテスト項目のテストイメージデータが保存されます。
1.

"Test_Demo"テストアイコン上で右クリックしポップアップメニューを表示します。

2.

[テストイメージファイルの編集]を選択し[テストイメージファイルの編集]ダイアログボックスを開きます。ダイアログボックスのタイトルには、テスト名"Test_Demo"およびテストイメージファイル名"Test_Suite_Demo_Test_Demo.hif"が表示されます。

3.

[テスト項目]の[CPU]下の[Memory-xxxxxx]および[Symbol]下の[Watch-xxxxxx]のチェックボックスをオンにします。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 33 of 479

High-performance Embedded Workshop V.4.09

4.

1.

概要

配列のアドレスのメモリ内容をテストイメージファイルに保存します。[テストイメージファイルの編
集]ダイアログボックスで、[テスト項目]の[CPU]下の[Memory-xxxxxx]をダブルクリックし、[テスト設定-メモリ]ダイアログボックスを開きます。

5.

[追加]ボタンをクリックし、[メモリ範囲の追加]ダイアログボックスを開きます。

6.

[開始アドレス]に配列の先頭アドレス、[終了アドレス]に配列の終了アドレスを入力し、[アクセスサイ
ズ]を選択します。

7.

OKボタンをクリックします。

8.

[テスト設定-メモリ]ダイアログボックスでOKボタンをクリックします。

9.

ウォッチウィンドウのWatch1シートの配列要素"a[6]"の内容をテストイメージファイルに保存します。
[テストイメージファイルの編集]ダイアログボックスで、[テスト項目]の[Symbol]下の[Watch-xxxxxx]
をダブルクリックし、[テスト設定-ウォッチ]ダイアログボックスを開きます。

10. [シンボル]の"a[6]"のチェックボックスをオンにします。
11. OKボタンをクリックします。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 34 of 479

High-performance Embedded Workshop V.4.09

1.

概要

12. [テストイメージファイルの編集]ダイアログボックスでOKボタンをクリックします。
この時点のHigh-performance Embedded Workshopシステムの状態で、テスト項目の指定内容に基づいてテスト
イメージを取得し、ステップ5で生成したテストイメージファイルに保存されます。

1.14.8ステップ 7： プログラムを変更しテストを実行する

この例では配列のメモリ領域の値をテスト対象としています。配列にデータを格納する回数を減らすようにプ
ログラムを変更し、保存されたテストイメージと実際のメモリの値が不一致になる状態にします。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 35 of 479

High-performance Embedded Workshop V.4.09

1.

1.

概要

エディタウィンドウにmain関数を含むソースファイルを表示し配列にデータを格納する回数を減らす
ようにプログラムを変更します。
)をクリックします。

2.

[エディタ]ツールバーの[ファイルの保存]ボタン(

3.

"Test_Demo"テストアイコン上で右クリックしポップアップメニューを表示します。

4.

[テストケースの実行]を選択しテストを開始します。テストの進捗状況および結果がアウトプットウ
ィンドウの[Test]タブに表示されます。

5.

テストが完了すると、テストブラウザウィンドウを表示します。

ステップ 8： テスト結果を確認する（不一致の場合）

1.14.9

テスト結果はテストブラウザウィンドウで確認できます。

1.

下側のペインで赤いマークの付いたテスト項目をダブルクリックすると不一致データの詳細を確認で
きます。

2.

例えば、[Symbol - Watch-xxxxxx]行をダブルクリックすると、次のようなテスト結果の詳細ダイアログ
ボックスが開きます。配列要素のテストイメージファイルのテストイメージの値（Src=xxxxxxxxx）と今回のテストのテストイメージの値（Dest=xxxxxxxx）を表示します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 36 of 479

High-performance Embedded Workshop V.4.09

1.

概要

3.

[エクスポート]ボタンをクリックすると、テスト項目の結果をテキストファイルへ保存できます。

4.

OKボタンをクリックします。

1.14.10ステップ 9： プログラムを元に戻しテストを実行する

配列にデータを格納する回数を元に戻すようプログラムを変更し、テストベースとテスト実行結果のメモリが一致する状態にします。
1.

配列にデータを格納する回数を8から10にプログラムを戻します。

2.

[エディタ]ツールバーの[ファイルの保存]ボタン(

3.

"Test_Demo"テストアイコン上で右クリックしポップアップメニューを表示します。

4.

[テストケースの実行]を選択しテストを開始します。

5.

テストが完了すると、テストブラウザウィンドウを表示します。

1.14.11)をクリックします。

ステップ 10： テスト結果を確認する（一致した場合）

テスト結果はテストブラウザウィンドウで確認できます。保存されているテストイメージデータとテスト結果が一致しました。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 37 of 479

High-performance Embedded Workshop V.4.09

2.

2.

ビルドの基本

ビルドの基本

この章ではHigh-performance Embedded Workshopの一般的な機能を説明します。より高度な機能については「3.
ビルドの応用」を参照してください。

2.1

ビルド処理

ビルド処理の一般的な流れを以下の図に示します。High-performance Embedded Workshopのインストール時に提供されるツールによってビルド処理は異なるため、以下の図とも異なる場合があります（例えば、コンパイ
ラが無いなど）。ビルドの各フェーズにおいて、1セットのプロジェクトファイルについてビルド処理を行います。それが完了すると、次のフェーズに移ります。

上記の例では、第一のフェーズがコンパイラ、第二のフェーズがアセンブラ、そして最後のフェーズがリンケ
ージエディタです。コンパイラのフェーズでは、プロジェクトのC/C++ソースファイルを順次コンパイルしま
す。アセンブラのフェーズでは、アセンブリ言語のソースファイルを順次アセンブルします。リンケージエデ
ィタのフェーズでは、すべてのライブラリファイルと、コンパイラフェーズとアセンブラフェーズからの出力
ファイルをリンクして、ロードモジュールを作成します。
ビルド処理をカスタマイズする方法はいくつかあります。例えば、独自のフェーズを追加したり、あるフェーズを無効にしたり、フェーズを削除できます。これらのビルド実行の応用については、「3. ビルドの応用」を参照してください。

2.2

ワークスペースウィンドウのProjectsタブの構成

ワークスペースウィンドウの[Projects]タブには現在のワークスペース、プロジェクト、ファイルを示します。
アイコンをダブルクリックしてプロジェクトファイルや個々のファイルを開くことができます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 38 of 479

High-performance Embedded Workshop V.4.09

2.

ビルドの基本ワークスペース上で右クリックすると、使用可能なオプションをポップアップメニューで表示します。
ポップアップメニューオプション

マクロの記録機能

プロジェクトの挿入-

ワークスペースにプロジェクトを追加します。

全プロジェクトの読み込み-

すべてのプロジェクトを読み込みます。

ツリーの縮小-ワークスペースアイコン下のツリーを縮小します。

クリーン

すべてのプロジェクトでコンフィグレーションの中間ファイル

全プロジェクトおよび出力ファイルを削除します。
バージョン管理-バージョン管理システムを実行します。

表示の構成

-

ワークスペースの表示の構成を設定します。

プロパティ

-

ワークスペースのプロパティを表示します。

プロジェクト上で右クリックすると、使用可能なオプションをポップアップメニューで表示します。
ポップアップメニューオプション
ビルド

マクロの記録機能

ビルド

プロジェクトをビルドします。

すべてをビルド

プロジェクトを全ビルドします。

クリーン

現在のコンフィグレーションの中間ファイルおよび出力ファイアクティブプルを削除します。

ロジェクト
すべての依存関係を更新-

プロジェクトのファイル依存関係を更新します。
プロジェクトをアクティブにします。

アクティブプロジェクトに設定
プロジェクトの削除-

ワークスペースからプロジェクトを削除します。

プロジェクトのアンロード-

プロジェクトをアンロードします。

または

または

プロジェクトの読み込み

プロジェクトを読み込みます。

ファイルの追加

R20UT0372JJ0100 Rev.1.00
2011.02.01-

プロジェクトにファイルを追加します。

Page 39 of 479

High-performance Embedded Workshop V.4.09

ポップアップメニューオプション

2.

マクロの記録

ビルドの基本機能

ファイルの削除-

プロジェクトからファイルを削除します。

フォルダの追加-

プロジェクトにフォルダを追加します。

ツリーの展開/縮小-

プロジェクト下のツリーを展開または縮小します。

バージョン管理-バージョン管理システムを実行します。

表示の構成

-

ワークスペースの表示の構成を設定します。

プロパティ

-

プロジェクトのプロパティを表示します。

フォルダ（Download moduleフォルダ、およびDependenciesフォルダを除く）上で右クリックすると、使用可能なオプションをポップアップメニューで表示します。
ポップアップメニューオプション

マクロの記録機能

フォルダの追加-

フォルダを追加します。

フォルダ名の変更-

フォルダ名を変更します。

フォルダの削除-

フォルダを削除します。

表示の構成

-

ワークスペースの表示の構成を設定します。

プロジェクトファイル上で右クリックすると、使用可能なオプションをポップアップメニューで表示します。
ポップアップメニューオプション
開く <ファイル名>

マクロの記録機能-

High-performance Embedded Workshop エディタでファイルを開きます。

開く < ファイル名> (外部エディタ) *-外部エディタでファイルを開きます。
1 つのファイルをコンパイルします。

コンパイル <ファイル名>
ビルドオプション-ファイルのビルド方法を設定します。

ファイルの追加-

プロジェクトにファイルを追加します。

ファイルの削除-

プロジェクトからファイルを削除します。

ビルドから除外 <ファイル名>-

ビルドからプロジェクトファイルを除外します。

または

または、

ビルドから除外の解除 <ファイル名>除外したプロジェクトファイルをビルドに再び入れます。

バージョン管理-バージョン管理システムを実行します。

表示の構成

-

ワークスペースの表示の構成を設定します。

ファイルの比較-

ファイルを比較します。

プロパティ

-

ファイルのプロパティを表示します。

注：*. [基本設定 -> オプション]を選択すると表示される[オプション]ダイアログボックスの[エディタ]タブで、[外部エディタの使用]チェックボックスをオンにすると表示されます。
[Download module]フォルダ上で右クリックすると、使用可能なオプションをポップアップメニューで表示します。（デバッガ接続時に使用可能）

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 40 of 479

High-performance Embedded Workshop V.4.09

ポップアップメニューオプション

2.

マクロの記録全てダウンロード

ビルドの基本機能[デバッグの設定]ダイアログボックスの[ターゲット]タブの[ダウンロードモジュール]リストに登録されているすべてのモジュール（ワークスペースウィンドウの[Projects]タブの[Download Modules]フォルダ下に表示されているダウンロード
モジュールと同じです）をダウンロードします。
[ダウンロードモジュール]ダイアログボックスを表示し、ダウン

ダウンロードモジュールの追加

ロードモジュールを追加します。このモジュールをダウンロー
ドします。
デバッグの設定-[デバッグの設定]ダイアログボックスを表示し、デバッグ設定を編集します。

表示の構成-

ワークスペースの表示の構成を設定します。

ダウンロードモジュール上で右クリックすると、使用可能なオプションをポップアップメニューで表示します。（デバッガ接続時に使用可能）
ポップアップメニューオプション

マクロの記録機能

ダウンロードモジュールを手動でダウンロードします。

ダウンロード(debug 情報のみ)

debug 情報のみモジュールを手動でダウンロードします。

アンロードモジュールをアンロードします。

ダウンロードモジュールの追加[ダウンロードモジュール]ダイアログボックスを表示し、ダウンロードモジュールを追加します。このモジュールをダウンロー
ドします。

削除

-

選択したモジュールを削除します。

デバッグの設定-[デバッグの設定]ダイアログボックスを表示し、デバッグ設定を編集します。

表示の構成-

ワークスペースの表示の構成を設定します。

モジュールの検索 *-ダウンロードモジュールから取得したすべてのファイルを別のディレクトリで再検索するためのダイアログボックスを開きま
す。

プロパティ

-

選択したダウンロードモジュールの設定内容を[ダウンロード
モジュール]ダイアログボックスに表示します。選択したダウンロードモジュールの設定内容を編集します。ダウンロード済みの場合は、アンロードされます。

注：*. デバッグ専用プロジェクト（[Debugger only - xxxxxx]）を使用している場合のみ表示されます。
ダウンロードモジュールから取得したファイル上で右クリックすると、使用可能なオプションをポップアップ
メニューで表示します。（デバッグ専用プロジェクト（[Debugger only - xxxxxx]）の場合に使用可能）
ポップアップメニューオプション
開く <ファイル名>

マクロの記録機能-

High-performance Embedded Workshop エディタでファイルを開きます。

ファイルの追加-

プロジェクトにファイルを追加します。

表示の構成

-

ワークスペースの表示の構成を設定します。

ファイルの検索-

ダウンロードモジュールから取得した同じファイル名を別のディレクトリで選択するためのダイアログボックスを開きます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 41 of 479

High-performance Embedded Workshop V.4.09

ポップアップメニューオプション

2.

マクロの記録

プロパティ-

ビルドの基本機能
ファイルのプロパティを表示します。

[Dependencies]フォルダ上で右クリックすると、使用可能なオプションをポップアップメニューで表示します。
ポップアップメニューオプション

マクロの記録

表示の構成

-

機能
ワークスペースの表示の構成を設定します。

依存ファイル上で右クリックすると、使用可能なオプションをポップアップメニューで表示します。
ポップアップメニューオプション

マクロの記録機能

バージョン管理-バージョン管理システムを実行します。

表示の構成

-

ワークスペースの表示の構成を設定します。

ファイルの比較-

ファイルを比較します。

プロパティ

-

ファイルのプロパティを表示します。

アクティブプロジェクト、ロードプロジェクト、アンロードプロジェクトについては「2.12 アクティブプロジ
ェクトを設定する」を参照してください。

2.3

プロジェクトファイル

High-performance Embedded Workshopを使ってアプリケーションをビルドするには、まず、どのファイルをプ
ロジェクトに追加して、各ファイルをどのようにビルドすべきかを指定しなければなりません(以下の図を参照)。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 42 of 479

High-performance Embedded Workshop V.4.09

2.

ビルドの基本

プロジェクトにファイルを追加する

2.3.1

アプリケーションをビルドする前に、まず、アプリケーションを構成するファイルを指定します。
プロジェクトにファイルを追加するには1.

アクティブプロジェクトに対してのみファイルが追加できます。以下のいずれかの操作を選択し['<プロジェクト名>'プロジェクトにファイルを追加]ダイアログボックスを開きます。

•[プロジェクト -> ファイルの追加]を選択する。

•

ワークスペースウィンドウの[Projects]タブのプロジェクト上で右クリックし、ポップアップメニュー
から[ファイルの追加]を選択する。

•

ワークスペースウィンドウの[Projects]タブが選択されているときに"Insert"キーを押す。

2.

追加するファイルを選択してください。

3.

ダイアログボックスの一番下にある[相対パス]チェックボックスをオンにすると、ファイルを「相対プロジェクトファイル」にできます。これにより、プロジェクトファイルがワークスペースファイルに相対的になり、ワークスペース構造の外に置くことも可能です。ソースツリー全体を再配置すると、High-performance Embedded Workshopはファイルの相対位置をチェックしファイルを検索できます。このチェックボックスのデフォルトはオンです。

4.

ダイアログボックスの一番下にある[登録済みファイルを非表示]チェックボックスをオンにすると、現在のプロジェクトに追加されていないファイルだけを表示します。このチェックボックスのデフォ
ルトはオフです。

5.

[追加]ボタンをクリックしてください。

プロジェクトにファイルを追加するには、他にも方法があります。これを以下に説明します。
•

エディタウィンドウ内で開いたファイルを右クリックするとポップアップメニューを表示します。ファイルが既にプロジェクト内にある場合、[プロジェクトにファイルの追加]は使用できません。[プロジェクトにファイルの追加]を選択すると、現在のプロジェクトにファイルを追加できます。

•

High-performance Embedded Workshopでは、Windows® Explorerからワークスペースウィンドウの[Projects]タブにファイルおよびフォルダをドラッグアンドドロップできます。次節の「2.3.2 ファイルおよびフォルダをドラッグアンドドロップする」を参照してください。

注：•

High-performance Embedded Workshopの認識できない形式のファイルを指定しても、プロジェクトに追加します。このファイルに関して、いくつかの機能が使用できなくなります。エディタ内でファイルを開く代わりにワークスペースウィンドウ内でこのファイルをダブルクリックすると、ファイルを開く動作をWindows® operating systemに受け渡します。ファイルをWindows® Explorer内で開いたときと同じように、ファイルを開くデフォルト動作が実行されます。現在、定義されている拡張子については、[ファイル拡張子]ダイアログボックスをご覧ください。詳細は、「2.5 ファイル拡張子とファイル
グループ」を参照してください。

•[登録済みファイルを非表示]は、Windows Vista® およびWindows® 7 operating system上では使用できません。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 43 of 479

High-performance Embedded Workshop V.4.09

2.

ビルドの基本

ファイルおよびフォルダをドラッグアンドドロップする

2.3.2

ワークスペースウィンドウの[Projects]タブにWindows® Explorerからファイル（あるいは複数のファイル）およびフォルダをドラッグできます。この場合、アクティブプロジェクトのプロジェクトまたはアクティブプロジ
ェクトのユーザフォルダ上にのみドロップできます。複数のフォルダはサポートしていません。
ファイルをドラッグアンドドロップする
ファイルのドロップ先により次のようになります。
•

ファイルをアクティブプロジェクト上にドロップすると、ファイルは、そのファイルタイプのグルー
プフォルダの下に追加されます。グループフォルダが存在しない場合は作成されます。例えば、ファイル「test.c」をアクティブプロジェクト上にドロップすると、「C source file」グループフォルダに追加されます。

•

ファイルをユーザフォルダ上にドロップすると、ファイルはそのフォルダ下に直接追加されます。同
じ名前のファイルでも異なるパスのファイルは追加されます。

•

High-performance Embedded Workshopの認識できない形式のファイルをアクティブプロジェクト上にドロップすると、プロジェクト下に直接追加されます。

フォルダをドラッグアンドドロップする
Windows® Explorerのフォルダをドロップすると、[フォルダからファイルの追加]ダイアログボックスが開きます。どのファイルを追加するかを選択できます。このダイアログボックスには、ドロップしたフォルダに含まれていたすべてのファイルのファイル名を表示します。各リスト項目にはファイルのフルファイル名とファイ
ルタイプを表示します。

1.

リストのカラムヘッダをクリックすると、そのカラムによってリスト項目をソートします。ダイアロ
グボックスを表示したときは、ファイルタイプ（昇順）、ファイル名（昇順）の順にソートしています。

2.

リスト項目は複数選択できます。選択した状態のリスト項目のチェックボックスをクリックまたは

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 44 of 479

High-performance Embedded Workshop V.4.09

2.

ビルドの基本Enterキーを入力すると、選択した状態のすべての項目のオン、オフが可能です(クリックされたチェックボックスの元の状態に依存します)。
3.

[サブフォルダ内も表示]チェックボックスをオフにすると、ドロップしたフォルダのファイルだけが表示されます。
オンにすると、ドロップしたフォルダに含まれるサブフォルダのファイルも表示します。このチェックボックスのデフォルトはオンです。

4.

[ソースファイルのみ表示]チェックボックスをオンにすると、このプロジェクトのソースファイルとして登録した拡張子のファイルだけ(例えば「C source file」など)を表示します。
オフにするとファイルタイプをすべて表示します。High-performance Embedded Workshopが認識できな
い形式のファイルタイプの場合は、ダイアログボックスのファイルタイプカラムに[Unknown type]を表示します。このチェックボックスのデフォルトはオンです。

5.

[フォルダごと追加]チェックボックスをオンにすると、ドロップしたツリーの下にツリー構造でファイルを追加します。例えば、ドロップする「data」フォルダ下にファイルがあると、「data」ユーザフ
ォルダをプロジェクトに追加します。そのユーザフォルダ下にファイルを追加します。
オフにすると、ユーザフォルダ上にフォルダをドロップした場合に、そのフォルダ下にすべてのファ
イルを追加します。
アクティブプロジェクトのツリー上にフォルダをドロップすると、ファイルタイプのグループフォル
ダ下にファイルを追加します（ファイル「main.c」の場合は、アクティブプロジェクト下の「C source
file」グループフォルダに追加します）。グループフォルダがない場合は生成されます。このチェック
ボックスのデフォルトはオフです。

6.

[すべて解除]ボタンをクリックするとすべてのチェックボックスがオフになります。このとき[すべて選択]ボタンをクリックすると、すべてのチェックボックスがオンになります。

7.

[OK]ボタンをクリックすると、チェックボックスがオンの状態のファイルをすべてプロジェクトに追加します。このダイアログボックスで[OK]ボタンをクリックし、次回このダイアログボックスを開くと、チェックボックスは前回のチェック状態を保存しています。

プロジェクトからファイルを削除する

2.3.3

プロジェクトからファイルを削除できます。ファイルの削除は、1つでも、複数でも、すべてのファイルをまとめてでもできます。
ファイルをプロジェクトから削除するには1.

以下のいずれかの操作を選択し[プロジェクトファイルの削除]ダイアログボックスを開きます。

•[プロジェクト -> ファイルの削除]を選択する。

•

ワークスペースウィンドウの[Projects]タブのプロジェクト上で右クリックし、ポップアップメニュー
から[ファイルの削除]を選択する。

2.

[プロジェクトファイル]リストから削除したいファイルを選択してください。複数のファイルを選択することもできます。

3.

選択したファイルを削除するには[削除]ボタンをクリックしてください。すべてのプロジェクトファ
イルを削除するには[すべて削除]ボタンをクリックしてください。

4.

[OK]ボタンをクリックするとプロジェクトからファイルを削除します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 45 of 479

High-performance Embedded Workshop V.4.09

2.

ビルドの基本ワークスペースウィンドウの[Projects]タブで選択したファイルをプロジェクトから削除するには
1.

ワークスペースウィンドウの[Projects]タブで削除したいファイルを選択してください。複数のファイルを選択するときは"Shift"キーまたは"Ctrl"キーを押してください。

2.

"Delete"キーを押してください。

3.

ファイルをプロジェクトから削除するかを確認するダイアログボックスが開きます。ファイルをプロジェクトから削除する場合は「はい」を選択してください。

確認要求のダイアログボックスを表示しない場合、[今後表示しない]チェックボックスをオンにしてください。確認要求のダイアログボックスを再び表示するには、[基本設定 -> オプション]を選択し[オプション]ダイアログボックスを開きます。[確認]タブの[プロジェクトからファイルを削除]チェックボッ
クスをオンにしてください。このチェックボックスのデフォルトはオンです。

ビルドからプロジェクトファイルを除外する

2.3.4

プロジェクトのファイルはビルドから除外できます。
ビルドからプロジェクトのファイルを除外するには1.

ワークスペースウィンドウの[Projects]タブで、ビルドから除外したいファイルをクリックしてください。
以下のようにマウスを使用したり、またはキー入力で複数のファイルを選択することもできます。
•

複数のファイルを選択するには
Ctrlキーを押しながら対象のファイルをクリックします。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 46 of 479

High-performance Embedded Workshop V.4.09•

2.

ビルドの基本複数のファイルを範囲で選択するには範囲選択を開始するファイルをクリックし、Shiftキーを押しながら範囲選択を終了するファイルをクリックします。

2.

以下のいずれかの操作を選択してください。ファイルのアイコンに赤いバツ印が付き()、ビルドからファイルを除外します。
•

右クリックしポップアップメニューから[ビルドから除外 <ファイル名>]を選択します。複数のファイルを選択した場合は<ファイル名>は表示されません。

•[ビルド -> ビルドから除外/除外の解除]を選択します。

除外したプロジェクトファイルをビルドに再び入れる

2.3.5

除外したプロジェクトファイルは再びビルドに入れることができます。
除外したファイルをビルドに再び入れるには
1.

ワークスペースウィンドウの[Projects]タブでファイルをクリックしてください。
以下のようにマウスを使用したり、またはキー入力で複数のファイルを選択することもできます。
•

複数のファイルを選択するには
Ctrlキーを押しながら対象のファイルをクリックします。

•

複数のファイルを範囲で選択するには範囲選択を開始するファイルをクリックし、Shiftキーを押しながら範囲選択を終了するファイルをクリックします。

2.

以下のいずれかの操作を選択してください。ファイルのアイコンの赤いバツ印が外れ()、ファイルがビルド可能になります。
•

右クリックしポップアップメニューから[ビルドから除外の解除 <ファイル名>]を選択します。複数のファイルを選択した場合は<ファイル名>は表示しません。

•[ビルド -> ビルドから除外/除外の解除]を選択します。

ワークスペースウィンドウでユーザフォルダを使う

2.4

ワークスペースウィンドウの[Projects]タブにユーザのフォルダを追加できます。これにより、プロジェクト内の特定の領域にファイルを論理的なグループにできます。フォルダ名として任意の名前をダイアログボックス
で入力します。自動的に表示される[Download modules]フォルダおよび[Dependencies]フォルダに対して下記は操作できません。
ユーザフォルダを追加するには
1.

ワークスペースウィンドウの[Projects]タブでプロジェクトを選択してください。

2.

右クリックし、[フォルダの追加]を選択してください。

3.

[フォルダの追加]ダイアログボックスの[フォルダ]に名前を入力してください。

4.

[OK]ボタンをクリックしてください。

5.

ファイルをフォルダ上にドラッグアンドドロップして、フォルダの分類を変更できます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 47 of 479

High-performance Embedded Workshop V.4.09

2.

ビルドの基本フォルダにサブフォルダを追加するには
1.

ワークスペースウィンドウの[Projects]タブでフォルダを選択してください。

2.

右クリックし、[フォルダの追加]を選択してください。

3.

[フォルダの追加]ダイアログボックスの[フォルダ]に名前を入力してください。

4.

[OK]ボタンをクリックしてください。

5.

ファイルをフォルダ上にドラッグアンドドロップして、フォルダの分類を変更できます。

フォルダをドラッグアンドドロップするにはワークスペースウィンドウの[Projects]タブでアクティブプロジェクトのフォルダをドラッグしてください。
•

フォルダをアクティブプロジェクト上にドロップすると、フォルダはそのプロジェクト下にドロップ
されます。

•

フォルダをアクティブプロジェクトのユーザフォルダ上にドロップすると、フォルダはそのフォルダ
下にドロップされます。

Windows® Explorerのフォルダをワークスペースウィンドウの[Projects]タブにドラッグアンドドロップできます。詳細は「2.3.2 ファイルおよびフォルダをドラッグアンドドロップする」を参照してください。
ユーザフォルダを削除するには
1.

ワークスペースウィンドウの[Projects]タブでフォルダを選択してください。

2.

以下のいずれかの操作を選択してください。このときフォルダは空である必要があります。

•"Delete"キーを押してください。

•

右クリックし、[フォルダの削除]を選択してください。

ユーザフォルダ名を変更するには

2.5

1.

ワークスペースウィンドウの[Projects]タブでフォルダを選択してください。

2.

右クリックし、[フォルダ名の変更]を選択してください。

3.

[フォルダ名の変更]ダイアログボックスの[フォルダ]に新しい名前を入力してください。

4.

[OK]ボタンをクリックしてください。

ファイル拡張子とファイルグループ

High-performance Embedded Workshopは拡張子でファイルを識別します。拡張子は使用するツールによって定義します。例えば、コンパイラを使用すると拡張子.cが[C source file]グループに入り、コンパイラのフェーズに入力します。さらに、独自の拡張子を定義することもできます。例えば、プロジェクトでアセンブリ言語ソースファイルを使っている場合、デフォルトの拡張子が.srcだとします。.srcの代わりに違う拡張子（例: .asm）を使うとき、新しい拡張子を定義してそれを.srcファイルと同様に扱うように指定できます。
ファイルの拡張子は、[ファイル拡張子]ダイアログボックスで表示、変更できます。このダイアログボックスを開くには[プロジェクト -> ファイルの拡張子]を選択してください。このダイアログボックスには現在のワークスペースで定義しているすべての拡張子とファイルグループを表示します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 48 of 479

High-performance Embedded Workshop V.4.09

2.

ビルドの基本ファイル拡張子リストは2列に分かれています。左の列にはファイル拡張子、右の列にはファイルグループを表示します。下記の図に示すように、同じグループに多くのファイル拡張子が存在する場合があります。例えば、1つのプロジェクト内でアセンブリ言語のソースファイルにいくつかの拡張子がある場合があります(例: .src, .asm, .mar など)。

2.5.1

アプリケーションとファイルグループを関連付ける[ファイル拡張子]ダイアログボックスでは、エディタでファイルを開くための設定だけでなく、ファイルグル
ープとアプリケーションとの関連付けができます。これを行うと、ワークスペースウィンドウの[Projects]タブ
でファイルをダブルクリックすると、適切なアプリケーションでファイルを開きます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 49 of 479

High-performance Embedded Workshop V.4.09

2.

ビルドの基本

アプリケーションとファイルグループを関連付けるには
1.

[プロジェクト -> ファイルの拡張子]を選択してください。[ファイル拡張子]ダイアログボックスが開
きます。

2.

[ファイル拡張子]ダイアログボックスで関連付けるファイルグループをリストから選択してください。

3.

[変更]ボタンをクリックしてください。[ファイル拡張子の変更]ダイアログボックスが開きます。

4.

関連付けをしない場合は[None]を選択します。High-performance Embedded Workshopのエディタまたは
他のエディタでこの種類のファイルを開くには[Editor]を選択します。特定のアプリケーションでこの種類のファイルを開くには[Other]を選択します。[Other]を選択すると、既に定義されたアプリケーシ
ョンをドロップダウンリストから選択するか、または、新しいアプリケーションを定義できます。新しいアプリケーションを定義する場合は[追加]ボタンをクリックしてください。[アプリケーションの追加]ダイアログボックスが開きます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 50 of 479

High-performance Embedded Workshop V.4.09

2.

ビルドの基本[名前]にアプリケーション名を入力します。[コマンド]にアプリケーションの絶対パスを入力します(パラメータは含めません)。[パラメタ]にファイルを開くのに必要なパラメータを入力します。必ず$(FULLFILE) プレースホルダを使って入力ファイルを指定してください。 (プレースホルダの詳細と使用方法については、「リファレンス 5. プレースホルダ」を参照してください。) [初期ディレクト
リ]にアプリケーションを実行させる初期ディレクトリを入力します。[OK]ボタンをクリックするとア
プリケーションを定義します。アプリケーションを変更するには[変更]ボタンをクリックしてください。[アプリケーションの変更]ダイアログボックスが開きます。このダイアログボックスは、[名前]が変更できないことを除いて[アプリケーションの追加]ダイアログボックスと同じです。設定を変更
してから[OK]ボタンをクリックします。
5.

[OK]ボタンをクリックすると選択したファイルグループに対するアプリケーションを関連付けます。

新規ファイルグループに新規ファイル拡張子を登録する

2.5.2

新しい拡張子を作成するときは、その拡張子が既に定義されたファイルグループに属するのか、新しいファイ
ルグループを作成する必要があるか考慮してください。新しい種類のファイルを追加するときには新しいファイルグループを作成してください。作成方法を以下に説明します。
新規ファイルグループに新規ファイル拡張子を登録するには1.

[プロジェクト -> ファイルの拡張子]を選択してください。[ファイル拡張子]ダイアログボックスが開
きます。

2.

[追加]ボタンをクリックしてください。[ファイル拡張子の追加]ダイアログボックスが開きます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 51 of 479

High-performance Embedded Workshop V.4.09

3.

2.

ビルドの基本[ファイル拡張子]に定義する拡張子を入力してください。拡張子には半角英数字と半角下線のみ使用
してください。ドロップダウンリストには、現在のプロジェクトで未定義のすべての拡張子が含まれます。この拡張子のうち1つを選択すると、ファイル拡張子フィールドにテキストを自動的に表示します。

4.

[新規拡張子グループ]オプションを選んで新しいファイルグループを定義する名前を入力してください。

5.

この段階では、関連するアプリケーションの変更が可能です。[<拡張子グループ>を開くアプリケーシ
ョン]ドロップダウンリストは以下から選択できます。
•[Editor]•[None]•[Other]•[Windows default][Editor]を選択すると、ワークスペースウィンドウ内のファイルを開く機能によって、ファイルをHigh-performance Embedded Workshopエディタ内で開くことができます。[None]を選択した場合、High-performance Embedded Workshopでファイルを開くことを抑止します。[Other]を選択すると、ファイルを開くための他のツールを指定できます。詳細は、「2.5.1 アプリケーションとファイルグループ
を関連付ける」を参照してください。[Windows default]を選択すると、ワークスペースウィンドウ内のファイルを開く機能によって、開いたファイルをWindows® operating system に受け渡します。また、Windows® Explorerで定義されたとして、このファイル拡張子のデフォルト動作を選択します。
6.

[OK]ボタンをクリックするとファイル拡張子リストに拡張子を追加します。

2.5.3

新規ファイル拡張子を作成する

High-performance Embedded Workshopに登録されていない拡張子をもつプロジェクトを使っているときは、新
しい拡張子を作成し（例えば、フェーズ内のデフォルトの拡張子が.asmでビルダの認識する拡張子が.srcのとき）、新しい拡張子を既存のファイルグループに追加することが必要です。追加方法を以下に説明します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 52 of 479

High-performance Embedded Workshop V.4.09

2.

ビルドの基本

新規ファイル拡張子を既存のファイルグループに追加するには
1.

[プロジェクト -> ファイルの拡張子]を選択してください。[ファイル拡張子]ダイアログボックスが開
きます。

2.

追加]ボタンをクリックしてください。[ファイル拡張子の追加]ダイアログボックスが開きます。

3.

[ファイル拡張子]に定義する拡張子を入力してください。ドロップダウンリストには、現在のプロジ
ェクトで未定義のすべての拡張子が含まれます。この拡張子のうち1つを選択すると、ファイル拡張子
フィールドにテキストを自動的に表示します。

4.

[既存の拡張子グループ]オプションを選択してこの新しい拡張子をどのファイルグループに追加するか指定してください。

5.

[OK]ボタンをクリックするとファイル拡張子リストに拡張子を追加します。

ビルドオプションを設定する

2.6

プロジェクトに必要なファイルを追加したら、次のステップはHigh-performance Embedded Workshopに各ファ
イルのビルド方法を指示します。このためには、[ビルド]メニューからメニューオプションを選択します。このメニューの名前は使用するツールによって異なります。
ビルドフェーズにオプションを設定するには
1.

[ビルド]メニューからオプションを変更するフェーズのメニューを選択すると、オプションを指定するダイアログボックスが開きます。

2.

オプションを設定してください。

3.

[OK]ボタンをクリックしてください。

詳細は、状況依存のヘルプボタンをクリックするか、ヘルプを参照したい場所を選択しF1キーを押してください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 53 of 479

High-performance Embedded Workshop V.4.09

2.

ビルドの基本

ビルドのコンフィグレーション

2.7

High-performance Embedded Workshopでは、ビルドのコンフィグレーションの中に、すべてのビルドのオプシ
ョンを格納できます。つまり、すべてのオプションを格納してそれらに名前を付けることができます。後にそのコンフィグレーションを選択すると、各ビルドフェーズの各オプションを復帰させることができます。また、
こうしたビルドのコンフィグレーションにより、ユーザはビルドのコンフィグレーション用にデバッガの設定を行うことができます。つまり、コンフィグレーションごとに異なるエンドプラットフォームをターゲットとして使用できます。
以下の図に"Default"、"MyDebug"、"MyOptimized"の3つのビルドコンフィグレーションを示します。"Default"
ビルド構成では、各フェーズ（コンパイルとアセンブル）が標準設定されています。"MyDebug"ビルド構成では、各ファイルがデバッグ情報付きでビルドされています。"MyOptimized"ビルド構成では、各ファイルが最大限に最適化されデバッグ情報はありません。このプロジェクトの開発者は、オプションを設定するダイアロ
グボックスに戻ってこれらを設定することなく、これらのビルドコンフィグレーションのうちどれでも選択できます。

ビルドコンフィグレーションを選択する

2.7.1

ビルドコンフィグレーションを選択するには
1.

[ビルド -> ビルドの構成]を選択してください。[ビルドコンフィグレーション]ダイアログボックスが
開きます。

2.

[現在のコンフィグレーション]ドロップダウンリストから使用するビルドコンフィグレーションを選択してください。

3.

[OK]ボタンをクリックしてください。

また、[標準]ツールバーのドロップダウンリストから異なるビルドコンフィグレーションを選択することもできます。
R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 54 of 479

High-performance Embedded Workshop V.4.09

2.

ビルドの基本

新規ビルドコンフィグレーションを追加する

2.7.2

新規ビルドコンフィグレーションを追加するには
1.

[ビルド -> ビルドの構成]を選択してください。[ビルドコンフィグレーション]ダイアログボックスが
開きます。

2.

[追加]ボタンをクリックしてください。[コンフィグレーションの追加]ダイアログボックスが開きます。

3.

[コンフィグレーション名]に新しいビルドコンフィグレーション名を入力してください。入力すると、下に表示されるディレクトリがビルドコンフィグレーションに使われるディレクトリに変わります。

4.

[ベースコンフィグレーション]のドロップダウンリストにある既存コンフィグレーションの中から、コンフィグレーションの設定をコピーする元となるコンフィグレーションを選択します。

5.

両方のダイアログボックスの[OK]ボタンをクリックすると新しいビルドコンフィグレーションを作成します。

ビルドコンフィグレーションを削除する

2.7.3

ビルドコンフィグレーションを削除するには
1.

[ビルド -> ビルドの構成]を選択してください。[ビルドコンフィグレーション]ダイアログボックスが
開きます。

2.

削除するビルドコンフィグレーションを選択し[削除]ボタンをクリックしてください。

3.

[OK]ボタンをクリックすると[ビルドコンフィグレーション]ダイアログボックスを閉じます。

プロジェクトをビルドする

2.8

パラレルビルドを使用する

2.8.1

パラレルビルドは、PC上の複数のプロセッサを使用してプロジェクトをビルドできます。これにより、
High-performance Embedded Workshopにおけるビルド時間の短縮が図れます。
パラレルビルドを使用する理由
パラレルビルドによって、使用しているツールチェインの中から複数フェーズのビルド処理（アセンブラ、コンパイラ）が、PCに搭載されている論理コアの数だけ並列に実行されます。
例えば、ご使用のPCに論理コアが2つ搭載されている場合、2つのビルド処理が並列に実行されます。
以下は並列処理しません。
•

リンカのような単一フェーズ•

複数または単一のカスタムビルドフェーズ•

Makeファイルの生成

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 55 of 479

High-performance Embedded Workshop V.4.09

2.

ビルドの基本パラレルビルドのオプション
パラレルビルドをサポートしているツールチェインを使用したワークスペースを作成、または開いた場合、パラレルビルドは自動的に有効になります。
使用しているプロジェクトでこのオプションを無効にできます。オプションは、ワークスペースを保存したときにプロジェクトファイルへ保存されます。
注:•

パラレルビルドをサポートしているツールチェインを使用した以前のバージョンのHigh-performance
Embedded Workshopで作成されたワークスペースを開いた場合、自動的に有効になります。

•

パラレルビルドをサポートしている新しいバージョンへツールチェインをアップグレードした場合、自動的に有効になります。

•

複数のプロジェクトを含んだワークスペースを使用している場合、[基本設定 -> オプション]の[ビルド]タブのオプションをアクティブプロジェクトに反映します。

•

複数の依存プロジェクトをビルドしている場合、各プロジェクトの設定はそのプロジェクトで使用されます。アクティブプロジェクトではありません。

パラレルビルドをセットアップするには1.

有効なワークスペースを開いていることを確認してください。

2.

[基本設定 -> オプション]を選択します。[オプション]ダイアログボックスが開きます。

3.

[ビルド]タブを選択します。

4.

[パラレルビルドを有効にする]オプションをチェックします。

5.

OKボタンをクリックします。

•

本機能のサポートはツールチェインに依存します。

•

ワークスペースを開いてオプションが無効になっていた場合、ご使用のツールチェインはパラレルビ

注:

ルドをサポートしていません。

ファイルをコンパイルする

2.8.2

プロジェクトにある1つのファイルをコンパイルできます。
1つのファイルをコンパイルするには1.

ワークスペースウィンドウの[Projects]タブからビルドするファイルを選択してください。

2.

以下のいずれかの操作を選択してください。

•[コンパイル]ツールバーボタン(•

ポップアップメニューから[コンパイル <ファイル名>]を選択する。

•[ビルド -> コンパイル]を選択する。

•"Ctrl+F7"キーを押す。

)をクリックする。

すべての出力は、アウトプットウィンドウの[Build]タブに表示します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 56 of 479

High-performance Embedded Workshop V.4.09

2.

ビルドの基本

プロジェクトをビルドする

2.8.3[ビルド]オプションでは前回のビルド後に変更のあったファイルだけをコンパイルまたはアセンブルします。
さらに、前回のビルド以後に変更のあったファイルに依存するソースファイルを再ビルドします。例えば、"TEST.C"にファイル"HEADER.H"が含まれており"HEADER.H"が前回のビルド以後に変更された場合、ファイル"TEST.C"を再コンパイルします。
ビルドするには以下のいずれかの操作を選択してください。
•[ビルド]ツールバーボタン(•"F7"キーを押す。

•[ビルド -> ビルド]を選択する。

•

ワークスペースウィンドウの[Projects]タブのプロジェクト上で右クリックし、ポップアップメニュー)をクリックする。

から[ビルド -> ビルド]を選択する。
[すべてをビルド]オプションでは変更の有無に関わらず、すべてのソースファイルをコンパイルまたはアセン
ブルして、新しく作成されたオブジェクトファイルをすべてリンクします。
"すべてをビルド"を実行するには以下のいずれかの操作を選択してください。
•[すべてをビルド]ツールバーボタン(•[ビルド -> すべてをビルド]を選択する。

•

ワークスペースウィンドウの[Projects]タブのプロジェクト上で右クリックし、ポップアップメニュー)をクリックする。

から[ビルド -> すべてをビルド]を選択する。
ビルド、あるいは全ビルドからのすべての出力は、アウトプットウィンドウの[Build]タブに表示します。プロ
ジェクトファイルのどれかにエラーが起こると、ビルド処理も全ビルド処理も終了します。

複数のプロジェクトをビルドする

2.8.4

複数のプロジェクトやコンフィグレーションのビルド処理が行えます。
複数のプロジェクトをビルドするには1.

[ビルド -> 複数ビルド]を選択してください。[複数のビルド]ダイアログボックスが開きます。

2.

[複数のビルド]ダイアログボックスでは、どのプロジェクトまたはコンフィグレーションを処理するかを選択できます。どのプロジェクトまたはコンフィグレーションを実行するか選択するには、実行
したいプロジェクトとコンフィグレーションの組み合わせの横にあるチェックボックスをオンにします。例えば、プロジェクト"hewtest2"全体をビルド実行したい場合、"hewtest2-Debug"、"hewtest2-Release"を選択してオンにし、その他のチェックボックスをオフにしてください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 57 of 479

High-performance Embedded Workshop V.4.09

3.

2.

ビルドの基本項目を選択したら、[ビルド]ボタンをクリックしてください。選択したプロジェクトやコンフィグレーションのビルドを開始します。

4.

選択した項目に対して、全ビルド実行したい場合、[すべてをビルド]ボタンをクリックしてください。

5.

選択した項目の中間ファイルおよび出力ファイルを削除したい場合、[クリーン]ボタンをクリックしてください。このときビルドは実行されません。

6.

通常のビルドと同じように、ビルドの結果をアウトプットウィンドウの[Build]タブに表示します。

7.

再びダイアログボックスを開くと、前回のチェック状態を回復します。

ツールの実行を中止する

2.8.5

ビルド中のツールの実行を中止できます。
ツールの実行を中止するには以下のいずれかの操作を選択してください。
•[ツールの実行の中止]ツールバーボタン(•[ビルド -> ツールの中止]を選択する。

)をクリックする。

ツールの実行が中止されると、アウトプットウィンドウの[Build]タブに"Build Stopped by User"というメッセー
ジが表示されます。
注：
ビルド実行を中止したときに実行されていたツールによっては、無効なファイルを出力ファイルとして残していることがあります。ビルドを再実行する場合は、中止したツールの出力ファイルをすべて削除してください。

2.8.6

ビルドの中間ファイルおよび出力ファイルを削除する

ワークスペースに含まれるプロジェクトのコンフィグレーションにあるビルドの中間ファイルおよび出力ファイルを削除できます。
R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 58 of 479

High-performance Embedded Workshop V.4.09

2.

ビルドの基本

現在のコンフィグレーションにあるビルドの中間ファイルおよび出力ファイルを削除するには以下のいずれかの操作を選択してください。
•[ビルド -> クリーン アクティブプロジェクト]を選択する。

•

ワークスペースウィンドウの[Projects]タブのプロジェクト上で右クリックする。表示されるポップア
ップメニューから[ビルド -> クリーン アクティブプロジェクト]を選択する。

すべてのビルドの中間ファイルおよび出力ファイルを削除するかを確認するダイアログボックスが開きます。
削除するには「はい」を選択してください。削除しない場合は「いいえ」または「キャンセル」を選択してください。

確認要求ダイアログボックスを表示しない場合、[今後表示しない]チェックボックスをオンにしてください。
確認要求ダイアログボックスを再び表示するには
1.

[基本設定 -> オプション]を選択してください。[オプション]ダイアログボックスが開きます。

2.

[確認]タブを選択してください。

3.

[クリーン アクティブプロジェクト]チェックボックスをオンにしてください。このチェックボックスのデフォルトはオンです。

4.

OKをクリックしてください。

すべてのプロジェクトのコンフィグレーションにあるビルドの中間ファイルおよび出力ファイルを削除するには以下のいずれかの操作を選択してください。
•[クリーン 全プロジェクト]ツールバーボタン(•[ビルド -> クリーン 全プロジェクト]を選択する。

•

ワークスペースウィンドウの[Projects]タブのワークスペース上で右クリックする。表示されるポップ)をクリックする。

アップメニューから[クリーン 全プロジェクト]を選択する。
すべてのビルドの中間ファイルおよび出力ファイルを削除するかを確認するダイアログボックスが開きます。
削除するには「はい」を選択してください。削除しない場合は「いいえ」または「キャンセル」を選択してください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 59 of 479

High-performance Embedded Workshop V.4.09

2.

ビルドの基本

確認要求ダイアログボックスを表示しない場合、[今後表示しない]チェックボックスをオンにしてください。
確認要求ダイアログボックスを再び表示するには
1.

[基本設定 -> オプション]を選択してください。[オプション]ダイアログボックスが開きます。

2.

[確認]タブを選択してください。

3.

[クリーン 全プロジェクト]チェックボックスをオンにしてください。このチェックボックスのデフォ
ルトはオンです。

4.

OKをクリックしてください。

中間ファイルおよび出力ファイルを削除したプロジェクト名およびコンフィグレーション名をアウトプット
ウィンドウの[Build]タブに表示します。
コンフィグレーションを複数選択しビルドの中間ファイルおよび出力ファイルを削除できます。詳細は、「2.8.4 複数のプロジェクトをビルドする」を参照してください。
注：
削除する中間ファイルおよび出力ファイルは、パッケージおよびバージョンにより異なります。
•

M16Cシリーズ,R8Cファミリ用Cコンパイラパッケージ V.5.45 Release 00およびそれ以降•

M32Cシリーズ用Cコンパイラパッケージ V.5.42 Release 00およびそれ以降•

R32Cシリーズ用Cコンパイラパッケージ V.1.02 Release 00およびそれ以降
リロケータブルファイル、アブソリュートファイル、リンケージリストファイル（".MAP"）、アセン
ブリプログラム用リストファイル（".LIS"）などを削除します。
ツールチェインのサブコマンドファイルは削除されません。
アブソリュートファイルの拡張子は指定したフォーマットにより異なります。

•

M16Cシリーズ,R8Cファミリ用Cコンパイラパッケージ V.5.30 Release 0〜V.5.44 Release 00•

M32Cシリーズ用Cコンパイラパッケージ V.5.40 Release 0〜V.5.41 Release 01A•

R32Cシリーズ用Cコンパイラパッケージ V.1.01 Release 00•

SuperHファミリ用C/C++コンパイラパッケージ V.5.1〜V.9.03 Release 02•

RXファミリ用C/C++コンパイラパッケージ V.1.00 Release 00•

H8SX, H8S, H8ファミリ用C/C++コンパイラパッケージ V.3.0A〜V.7.00 Release 00•

M32Rファミリ用Cコンパイラパッケージ V.5.00 Release 00〜V.5.01 Release 01•

740ファミリ用Cコンパイラパッケージ V.1.00 Release 1〜V.1.01 Release 02•

740ファミリ用アセンブラパッケージ V.4.10 Release 02
リロケータブルファイルおよびアブソリュートファイルのみを削除します。
リンケージリストファイル（".MAP"）、アセンブリプログラム用リストファイル（".LIS"）、ツール
チェインのサブコマンドファイルなどは削除されません。
アブソリュートファイルの拡張子は指定したフォーマットにより異なります。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 60 of 479

High-performance Embedded Workshop V.4.09

2.8.7

2.

ビルドの基本アウトプットウィンドウのBuildタブの構成

ビルド実行（コンパイラ、アセンブラなど）の出力結果を表示します。ソースファイルにエラーがある場合、アウトプットウィンドウの[Build]タブにアイコン、およびエラーメッセージをソースファイル名、行番号とともに出力します。
エラーメッセージの表示に関するツールバーボタンまたはポップアップメニューオプションを選択すると、エラーメッセージ出力行を強調表示し、該当ソースがある場合はエディタに該当ソース行を表示します。
エラーメッセージ出力行をダブルクリックすると、該当ソースがある場合はエディタにエラーメッセージの該
当ソース行を表示します。
エラーメッセージの表示に関する操作を行った場合は、ステータスバーにエラーメッセージを表示します。
エラーメッセージ行の文字列を他の行の文字列と異なる色で強調表示されるようにカスタマイズが可能です。
下の図はエラー行の文字列に赤色、ウォーニング行の文字列に緑色を設定した例です。

ウィンドウ内で右クリックすると、使用可能なオプションをポップアップメニューで表示します。
基本的なオプションをツールバーに割り付けています。
[ツールバー表示]、[ツールバーのカスタマイズ]は、ツールバー内で右クリックしても、ポップアップメニュ
ーを表示します。
ポップアップメニューオプション-

ツールバーボタン機能
次のエラーの出力行を強調表示し、該当ソースがある場合はエディタに該当ソース行を表示します。

-

前のエラーの出力行を強調表示し、該当ソースがある場合はエディタに該当ソース行を表示します。

-

次のウォーニングの出力行を強調表示し、該当ソースがある場合はエディタに該当ソース行を表示します。

-

前のウォーニングの出力行を強調表示し、該当ソースがある場合はエディタに該当ソース行を表示します。

次エラー/ウォーニング/情報の表示

次のエラー、ウォーニング、またはインフォメーションの出力行を強調表示し、該当ソース行がある場合はエディタに該
当ソース行を表示します。

前エラー/ウォーニング/情報の表示

前のエラー、ウォーニング、またはインフォメーションの出力行を強調表示し、該当ソースがある場合はエディタに該当
ソース行を表示します。

ヘルプ

R20UT0372JJ0100 Rev.1.00
2011.02.01

この出力行に関するヘルプを表示します。

Page 61 of 479

High-performance Embedded Workshop V.4.09

ポップアップメニューオプション

2.

ツールバーボタンジャンプ

ビルドの基本機能
この出力行に関するソース行をエディタに表示します。

-

クリア

ウィンドウ内容をクリアします。

保存

ウィンドウ内容をテキストファイルに保存します。

コピー

ウィンドウ内容の選択部分を Windows® クリップボードにコピーします。

ツールバー表示-

ツールバー表示/表示なしを切り替えます。

ツールバーのカスタマイズ-

ツールバーボタンをカスタマイズします。

[Build]タブではビルド実行により出力されたエラーメッセージ行の左側の余白（カラム）にエラーメッセージのエラーレベルに対応したアイコンを表示します。
アイコン名

アイコン

エラーメッセージレベル

Build Error

エラー

Build Warning

ウォーニングInformation

インフォメーション

アウトプットウィンドウの[Build]タブでは、エラーメッセージ行の文字列を他の行の文字列と異なる色で強調表示されるようにカスタマイズが可能です。
既存の色をカスタマイズするには
1.

[基本設定 -> 表示の形式]を選択してください。[表示形式]ダイアログボックスが開きます。

2.

[Output]アイテムをダイアログボックスの左側のツリーから選択し展開します。

3.

色を変更したいカテゴリを選択します。以下の表に示すカテゴリが選択できます。
カテゴリ

カラータブの前面の色

カラータブの背景の色

カスタマイズ

カスタマイズ(デフォルト)(デフォルト)

されるタブ

される出力内容Text

SYSTEMSYSTEM

すべてのタブ

すべて

Build Error Text

黒

白

Build

エラー行

Build Warning Text

黒

白

Build

ウォーニング行

Information Text

黒

白

Build

インフォメーション行

4.

[カラー]タブの[前面]リストと[背景]リストの選択を変更します。

5.

[OK]ボタンをクリックします。

アウトプットウィンドウのBuildタブの内容の制御

2.8.8

ビルド中にビルド実行情報（ファイルに適用したコマンドラインオプションなど）を表示すると便利です。
High-performance Embedded Workshopでは、"ビルド"、"すべてをビルド"、"コンパイル"処理中、アウトプット
ウィンドウの[Build]タブにそのオプションを表示するかどうかを[オプション]ダイアログボックスで指定できます。
ビルド中にビルド情報の表示の有無を指定するには
1.

[基本設定 -> オプション]を選択すると[オプション]ダイアログボックスが開きます。

2.

[ビルド]タブを選択してください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 62 of 479

High-performance Embedded Workshop V.4.09

2.

ビルドの基本3.

[表示]グループのチェックボックスを以下のように設定します。

•[コマンドライン]にはツール実行時のコマンドライン表示の有無を指定します。

•[環境]にはツール実行時の環境変数の表示の有無を指定します。

•[初期ディレクトリ]にはツールが起動されるディレクトリパスの表示の有無を指定します。

2.8.9

ビルド対象ファイルをワークスペースウィンドウにマーク表示する

前回のビルドで生成されたファイルより後に更新されたファイル（ビルド対象ファイル）をワークスペースウ
ィンドウ上にマーク表示します。下記ウィンドウでは、ビルド対象ファイルは"demo.c"です。
次に[ビルド]をクリックしたとき、このファイルをビルドします。アクティブプロジェクトの依存プロジェク
トのファイルにもマーク表示します。
これらファイルのマーク表示は、ビルドに影響することが起こるたびに更新します。例えば、オプションの変
更、ファイルの追加、依存関係の変更、ファイルの修正などです。

ビルド対象ファイルをワークスペースウィンドウにマーク表示するには
1.

[基本設定 -> オプション]を選択し[オプション]ダイアログボックスを開きます。

2.

[ビルド]タブを選択してください。

3.

[ビルド対象ファイルのマーク表示]チェックボックスをオンにしてください。

4.

[OK]ボタンをクリックしてください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 63 of 479

High-performance Embedded Workshop V.4.09

2.9

2.

ビルドの基本ファイル依存関係

多くの場合プロジェクトにはファイル間の依存関係があります。例えば、1つのCファイルはいくつかのファイ
ルをインクルードします。複雑なプロジェクトでは、ソースファイルが他のインクルードファイルに依存するため、管理が難しくなります。しかし、High-performance Embedded Workshopにはファイル依存関係をスキャンする機能があり、そのプロジェクトにあるすべてのファイルの依存関係をチェックできます。スキャンが完了すると、プロジェクトのファイル依存関係を示す最新のリストをワークスペースウィンドウの[Projects]タブに表示します。
最初に、すべての依存ファイルは[Dependencies]フォルダに表示されています。

注：
インクルードファイルからさらにファイルがインクルードされている場合、依存ファイルとして表示するイン
クルードファイルのネストレベルは31までです。
プロジェクトのファイル依存関係は、以下の操作タイミングで自動更新されます。
操作タイミング
ワークスペースを開く

主な操作[ようこそ!]ダイアログボックスのオプションの選択[ファイル -> ワークスペースを開く]の選択[ファイル -> 新規ワークスペースの作成]の選択

ワークスペースにプロジェクトを挿入する[プロジェクト -> プロジェクトの挿入]の選択

アクティブプロジェクトに設定する[プロジェクト -> アクティブプロジェクトに設定]の選択

ファイルを追加する[プロジェクト -> ファイルの追加]の選択

ファイルを保存する[ファイル -> 上書き保存]の選択

ビルドする[ビルド -> ビルド]の選択

依存関係を自動更新する[依存関係の自動更新をしない]チェックボックスをオフにする

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 64 of 479

High-performance Embedded Workshop V.4.09

2.

ビルドの基本

プロジェクトのファイル依存関係を自動更新しないようにするには
1.

[基本設定 -> オプション]を選択してください。[オプション]ダイアログボックスが開きます。

2.

[ビルド]タブを選択します。

3.

[依存関係の自動更新をしない]チェックボックスをオンにしてください。このチェックボックスのデフォルトはオフです。

4.

OKをクリックしてください。
注：
この設定を行うと、プロジェクトのファイル依存関係はすべてクリアされます。プロジェクトのファ
イル依存関係を手動で更新するには、「プロジェクトのファイル依存関係を手動で更新するには」を参照してください。

また、[ビルド -> ビルド]を選択した場合、ビルド前に依存関係を更新するかを確認するダイアログボックスが開きます。
依存関係の自動更新機能を抑止しているため、ファイル依存関係の情報が古い可能性があります。
ビルド前に依存関係を更新する場合は、「はい」を選択してください。「いいえ」を選択した場合、現在の依存関係の情報でビルドを実行します。

確認要求ダイアログボックスを表示しない場合、[今後表示しない]チェックボックスをオンにしてください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 65 of 479

High-performance Embedded Workshop V.4.09

2.

ビルドの基本

確認要求ダイアログボックスを再び表示するには
1.

[基本設定 -> オプション]を選択してください。[オプション]ダイアログボックスが開きます。

2.

[確認]タブを選択してください。

3.

[ビルド前に依存関係を更新]チェックボックスをオンにしてください。このチェックボックスのデフ
ォルトはオンです。

4.

OKをクリックしてください。

プロジェクトのファイル依存関係を手動で更新するには以下のいずれかの操作を選択してください。
•[ビルド -> すべての依存関係を更新]を選択する。

•

ワークスペースウィンドウの[Projects]タブのプロジェクト上で右クリックし、ポップアップメニュー
から[ビルド -> すべての依存関係を更新]を選択する。

2.10

表示方法を指定するワークスペースウィンドウの[Projects]タブの中で右クリックすると、ポップアップメニューを表示します。その中から[表示の構成]を選択し、以下の情報の表示方法を設定してください。以下に[表示の構成]ダイアログ
ボックスの各オプションについて説明します。
各ファイルの下に依存ファイルを表示する[依存関係をファイルの下に表示]チェックボックスをオンにすると、依存ファイルがそれをインクルードする
ソースファイルの下に平坦な構造で表示され、ファイル自体がフォルダになります（図(ii)を参照）。このオプションを選択しないと[Dependencies]フォルダにすべてのファイル依存を示します（図(i)を参照）。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 66 of 479

High-performance Embedded Workshop V.4.09

2.

ビルドの基本

標準ライブラリファイルのインクルードを表示する

デフォルトでは、標準インクルードパスの依存ファイルは表示しません（図(j)を参照）。例えば、Cコードで#include <stdio.h>などのインクルード文を書くと、stdio.hは依存ファイルとして表示しません。そのようなシス
テムインクルードファイルを表示するには、[インクルードする標準ライブラリの表示]チェックボックスをオンにしてください（図(jj)を参照）。

ファイルのパスを表示する

デフォルトでは、ファイルのパスは表示されません（図(k)を参照）。[ファイルパスの表示]チェックボックスをオンにすると、[Projects]タブのすべてのファイルを絶対パス（ドライブ名からのパス）で表示します（図(kk)を参照）。

ファイルをタイムスタンプの順序でソートする[ファイルのタイムスタンプによるソート]チェックボックスをオンにすると、ワークスペース内のファイルをタイムスタンプの順序で並べることができます。最新のファイルがリストの先頭、最も古いファイルがリストの最後になります。
R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 67 of 479

High-performance Embedded Workshop V.4.09

2.

ビルドの基本このオプションを設定した後でファイルを更新した場合は、手動で表示順を更新してください。
表示順を手動で更新するにはワークスペースウィンドウの[Projects]タブのポップアップメニューから[リフレッシュ]を選択してください。

2.11

ワークスペースにプロジェクトを追加する

ワークスペースを作成したとき、最初はプロジェクトが1つしかありません。しかし、後で、新しいプロジェ
クトや既存のプロジェクトを追加できます。
ワークスペースに新しいプロジェクトを追加するには

1.

[プロジェクト -> プロジェクトの挿入]を選択してください。[プロジェクトの挿入]ダイアログボック
スが開きます。

2.

[新規プロジェクト]ラジオボタンを選択してください。

3.

[OK]ボタンをクリックしてください。[新規プロジェクトの挿入]ダイアログボックスが開きます。

4.

[プロジェクト名]にプロジェクト名を入力してください。プロジェクト名は32文字以内で、半角英数
字、半角下線のみ使用してください。特に、日本語文字、空白、または半角マイナス記号を使用しな
いでください。プロジェクト名を入力すると、High-performance Embedded Workshopは自動的にサブディレクトリを追加します。これは不要であれば削除できます。

5.

[参照]ボタンをクリックしてプロジェクトを作成するディレクトリを選択してください。または、[ディレクトリ]にディレクトリを入力できます。

6.

プロジェクトタイプリストには使用可能なプロジェクトの種類を示します（Application、Libraryなど）。
このリストから作成するプロジェクトの種類を選択してください。

7.

[OK]ボタンをクリックすると、プロジェクトを作成しワークスペースに追加します。

既存のプロジェクトをワークスペースに追加するには

1.

[プロジェクト -> プロジェクトの挿入]を選択してください。[プロジェクトの挿入]ダイアログボック
スが開きます。

2.

[既存プロジェクト]ラジオボタンを選択してください。

3.

[参照]ボタンをクリックしてプロジェクトデータベースファイル（".HWP"ファイル）を検索してください。

4.

[OK]ボタンをクリックするとそのプロジェクトをワークスペースに追加します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 68 of 479

High-performance Embedded Workshop V.4.09

2.12

2.

ビルドの基本アクティブプロジェクトを設定する

プロジェクトには3つの状態があります。アクティブプロジェクト、ロード（読み込まれた）プロジェクト、およびアンロードプロジェクトです。
ワークスペースには複数のプロジェクトを含めることができますが、アクティブなプロジェクトは1つだけです。このアクティブプロジェクトでビルド動作とデバッグ動作を実行します。そして、そのプロジェクト用のビルダやデバッガのオプションを変更できます。またアクティブプロジェクトは太字で表示します。
プロジェクトをアクティブにするには以下の操作のいずれかを選択します。
•[プロジェクト -> アクティブプロジェクトに設定]サブメニューからアクティブにしたいプロジェク
トを選択してください。

•

ワークスペースウィンドウの[Projects]タブからアクティブでないプロジェクトを選択してください。
右クリックしてポップアップメニューを表示し、[アクティブプロジェクトに設定]オプションを選択
してください。

プロジェクトが読み込まれていると、プロジェクトのディレクトリを開き、ファイルを見ることができます。
またプロジェクトのビルダおよびデバッグオプションを変更することもできます。読み込みプロジェクトに対して[ツール]メニューのツールを実行することもできます。
プロジェクトをアンロードにするには1.

ワークスペースウィンドウの[Projects]タブからアクティブでないプロジェクトを選択してください。

2.

右クリックしてポップアップメニューを表示し、[プロジェクトのアンロード]を選択してください。
一度にいくつかのプロジェクトを選択することもできます。

アンロードしたプロジェクトは、ワークスペースウィンドウの[Projects]タブのアイコンがグレー表示です。
アンロードしたプロジェクトがある場合は以下の操作によりプロジェクトを読み込むことができます。
ワークスペースのすべてのプロジェクトを読み込むには1.

ワークスペースウィンドウの[Projects]タブのワークスペースを選択してください。

2.

右クリックしポップアップメニューを表示し、[全プロジェクトの読み込み]を選択してください。

ワークスペースのプロジェクトを読み込むには1.

ワークスペースウィンドウの[Projects]タブからアンロードしたプロジェクトを選択してください。

2.

右クリックしてポップアップメニューを表示し、[プロジェクトの読み込み]を選択してください。一度にいくつかのプロジェクトを選択することもできます。

2.13

プロジェクト間の依存関係を指定する

ワークスペースのプロジェクトは、他のプロジェクトと依存関係を持たせることができます。ビルド処理をすると、依存プロジェクトを最初にビルドします。これは、ワークスペースのプロジェクトを他のプロジェクトが使用しているときなどに使用します。例えば、ワークスペースに2つのプロジェクトがあるとします。1つはアプリケーションプロジェクトに含まれたライブラリだとします。この場合2番目のアプリケーションのビル

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 69 of 479

High-performance Embedded Workshop V.4.09

2.

ビルドの基本ド前にライブラリを正確にビルドし、また最新でなくてはなりません。そのため、ライブラリをアプリケーションプロジェクトの依存プロジェクトに指定します。こうすると、最新でないライブラリを先にビルドします。
依存プロジェクトをビルドするとき、High-performance Embedded Workshopは依存プロジェクトがアクティブ
プロジェクトのビルドコンフィグレーションになるようにします。上記の例では、アクティブプロジェクトのビルドコンフィグレーションが"Debug"であるとき、High-performance Embedded Workshopは、依存プロジェク
トで"Debug"ビルドコンフィグレーションが選択されるようにします。このような一致したコンフィグレーシ
ョンが存在しない場合、High-performance Embedded Workshopは依存プロジェクトで最近使われたコンフィグ
レーションを使用します。
依存プロジェクトを指定するには
1.

[プロジェクト -> 依存関係]を選択してください。[依存プロジェクト]ダイアログボックスが開きます。

2.

依存関係を指定するプロジェクトを選択してください。[依存プロジェクト]リストに（選択したプロ
ジェクト以外の）ワークスペース内のすべてのプロジェクトを表示します。

3.

[依存プロジェクト]リストには各プロジェクトにチェックボックスがあります。選択したプロジェク
トが依存するプロジェクトのチェックボックスをオンにしてください。

4.

[OK]ボタンをクリックしてください。

アクティブプロジェクトに対し依存プロジェクトを設定している場合、ビルド時、アクティブプロジェクトより先に依存プロジェクトのビルドが必要かHigh-performance Embedded Workshopは判定します。
この依存プロジェクトの判定は、アクティブプロジェクトを親とした場合、子にあたるプロジェクトまで実施します。子にあたるプロジェクトに対して依存プロジェクトを設定していても、その依存プロジェクトは判定
しません。

2.14

ワークスペースからプロジェクトを削除する

ワークスペースからプロジェクトを削除するには
1.

ワークスペースウィンドウの[Projects]タブで削除したいプロジェクトを選択してください。

2.

右クリックしポップアップメニューを表示してください。

3.

[プロジェクトの削除]を選択してください。

注：
ワークスペースからアクティブプロジェクトを削除することはできません。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 70 of 479

High-performance Embedded Workshop V.4.09

2.15

2.

ビルドの基本ワークスペースのプロジェクト相対パス

High-performance Embedded Workshopでは、プロジェクトをワークスペースに追加する場合、相対パスを使用してワークスペースに追加することが選択できます。これにより、プロジェクトをワークスペースディレクト
リの上に置くことができ、High-performance Embedded Workshopワークスペースの再配置も正確にできます。
プロジェクトは常にワークスペースと相対的であるため、プロジェクトがワークスペースの上のディレクトリ
にある場合、再配置のあと、High-performance Embedded Workshopは同じ相対場所でプロジェクトを見つけようとします。このことは、複数のワークスペース間で共有したプロジェクトを使用するとき、特に便利です。
High-performance Embedded Workshopの古いバージョンでは、このプロジェクトは再配置されておらず、オリ
ジナルのプロジェクトパスをアクセスしようとしました。また、ワークスペースディレクトリのサブディレク
トリにあったプロジェクトを再配置することのみ可能でした。これは現在のバージョンでも、High-performance
Embedded Workshopの標準的な動作です。
プロジェクト相対パスを設定するには
1.

ワークスペースウィンドウでプロジェクトを選択してください。

2.

右クリックしてポップアップメニューを表示してください。

3.

[プロパティ]を選択してください。

4.

[.HWSファイルからプロジェクトファイルへの相対パス]チェックボックスをオンにしてください。

5.

[OK]ボタンをクリックしてください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 71 of 479

High-performance Embedded Workshop V.4.09

3.

3.

ビルドの応用ビルドの応用

この章ではより高度なビルドの概念を説明します。

3.1

ビルド実行の復習

2章「ビルドの基本」では、ビルド実行をコンパイラ、アセンブラ、リンケージエディタを用いて説明しました。High-performance Embedded Workshopではこれが一般的な実行環境です。しかし、ビルド実行を変更（フェーズの追加や削除など）するためには、ビルドの機能についてさらに知ることが必要です。

3.1.1

ビルドとは?

プロジェクトのビルドとは、複数の特定の入力ファイルに複数のツールを適用して期待する出力を得ることです。つまり、オブジェクトファイルを得るために、C/C++ソースファイルにコンパイラを適用したりアセンブ
リ言語のソースファイルにアセンブラを適用したりします。
ビルドの各ステップ、または、各「フェーズ」において、様々な入力ファイルの集まりに各種ツールを適用します。以下の図にビルド処理を示します。

High-performance Embedded Workshopではビルド処理を変更できます。[ビルド -> ビルドフェーズ]を選択し[ビルドフェーズ]ダイアログボックスを開きます。左には現在のプロジェクトで定義されたフェーズを示します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 72 of 479

High-performance Embedded Workshop V.4.09

3.

ビルドの応用

この章では[ビルドフェーズ]ダイアログボックスが提供する様々な機能について説明します。

カスタムビルドフェーズを作成する

3.2

標準のビルドの前後または途中に他のツールを実行する場合、独自のビルドフェーズ（カスタムビルドフェー
ズ）を作成します。カスタムビルドフェーズを略してカスタムフェーズといいます。
新しいカスタムフェーズを作成するには
1.

[ビルド -> ビルドフェーズ]を選択すると[ビルドフェーズ]ダイアログボックスが開きます。

2.

[追加]ボタンをクリックしてください。新しいビルドフェーズを作成するための[新規ビルドフェーズ]
ダイアログボックスを開きます。

3.

以下の4つのステップにしたがってください。ステップを進めるには[次へ>]ボタンを、戻るには[<戻る]ボタンをクリックしてください。
ステップ1[新規カスタムフェーズの作成]または[既存システムフェーズの追加]を選択します。システムビルドフ
ェーズ（略してシステムフェーズといいます）は、使用しているツールチェイン（コンパイラ、アセ
ンブラ、リンケージエディタ、ライブラリアンなど）内で定義済みのすぐに使用できるフェーズ、または、ユーティリティフェーズ（例えば、ファイルコピー、ソースコード複雑度解析ツールなど）です。システムフェーズがない場合、[既存システムフェーズの追加]ボタンが非アクティブになります。
[新規カスタムフェーズの作成]を選んでカスタムフェーズを作成してください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 73 of 479

High-performance Embedded Workshop V.4.09

3.

ビルドの応用

ステップ2
作成するフェーズの種類を選択します。2つの選択肢（[複数フェーズ]または[単一フェーズ]）があります。複数フェーズを実行すると特定のファイルグループに属するプロジェクト内の各ファイルにコマンドを適用します。[入力ファイルの選択]フィールドに[C source file]を選択すると、プロジェクト内のファイル毎にコンパイラを実行します。単一フェーズを選択するとビルド実行中に一度だけ実行します。

[入力ファイルの選択]ドロップダウンリストは、そのプロジェクト用に定義された現在のファイルグ
ループを含みます。[入力ファイルの選択]ドロップダウンリストの中の[Multiple Groups]エントリを選択すると、複数の入力ファイルグループを定義できる[グループの選択]ダイアログボックスが開きます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 74 of 479

High-performance Embedded Workshop V.4.09

3.

ビルドの応用

複数選択すると、[入力ファイルの選択]ドロップダウンリストは[Multiple Groups]と表示します。プロ
ジェクトに追加されているカスタムフェーズ用に、複数の入力ファイルグループをこのダイアログボ
ックスでを選択できます。ファイルグループを選択するには、ファイルグループ名の隣にあるチェックボックスをオンにしてください。このダイアログボックスでは、1つ以上のファイルグループが選択
できます。
ステップ3
フェーズのコマンドについての情報を入力します。[フェーズ名]にフェーズ名を入力します。[コマンド]にプログラムファイルのパスを入力します （コマンドラインオプションは含めません。オプショ
ンはHigh-performance Embedded Workshopのメニューバーの[ビルド]メニューで指定します）。[デフォルトオプション]にフェーズのデフォルトのオプションを指定します。デフォルトオプションはプロジ
ェクトに新しいファイルを追加するときに付加されるオプションです。[初期ディレクトリ] フィール
ドにはそのプログラムをどのディレクトリから実行するか（つまり、ツール実行前にどこにカレント
ディレクトリを設定するか）を入力します。
注：[フェーズ名]には日本語文字（全角英数字も含む）を使用しないでください。また、High-performance
Embedded Workshop V.1.xで作成したプロジェクトをHigh-performance Embedded Workshop V.2.X以上で使用する場合、日本語名のカスタムフェーズについては、半角英数字等（半角下線、半角マイナス、
空白は使用可能）の名称で設定し直してください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 75 of 479

High-performance Embedded Workshop V.4.09

3.

ビルドの応用ステップ4
フェーズに必要な環境変数を指定します。

新しい環境変数を追加するには、[追加]ボタンをクリックしてください。[環境変数]ダイアログボック
スが開きます。新しい環境変数を追加するには[変数]に環境変数名を入力して[値]に環境変数の値を入力して[OK]ボタンをクリックします。環境変数を変更するには、ステップ4のダイアログボックスのリストから環境変数を選んで、[変更]ボタンをクリックします。[変数]と[値]を変更して[OK]ボタンをクリックすると、リストに変更した変数を追加します。環境変数を削除するには、ステップ4のダイア
ログボックスのリストから削除する環境変数を選んで、[削除]ボタンをクリックします。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 76 of 479

High-performance Embedded Workshop V.4.09

3.

ビルドの応用

追加するツールが動作中に出力を表示できる場合、ステップ4のダイアログボックスの[実行中に標準出力を表示する]オプションを使用してください。出力が発生するごとにツールの出力を表示します。
このオプションがoffに設定されると、High-performance Embedded Workshopはツールに表示されている
全出力を保存し、ツールが動作を終了したときアウトプットウィンドウに表示します。
注：[実行中に標準出力を表示する]を用いると、特定のオペレーティングシステムで特定のツールを使用するとき問題を引き起こすことがあります。もしツールがHigh-performance Embedded Workshopの中でロックアップ、またはフリーズするといった問題がありましたら、[実行中に標準出力を表示する]オ
プションのチェックを外してください。
[完了]ボタンをクリックすると、指定した内容で新しいフェーズを作成します。デフォルトでは[ビルドフェー
ズ]ダイアログボックスの[ビルド順序]タブの[ビルドフェーズの順序]リストの最後に新しいフェーズを追加し
ます。

3.3

ビルドフェーズの順序

標準的ビルド処理（下の図）では、(1)コンパイラの前、(2)アセンブラの前、(3)リンケージエディタの前、(4)リンケージエディタの後、の4ヶ所にフェーズを追加できます。ビルドの順序の中で好きな場所にカスタムフ
ェーズを追加したりシステムフェーズを移動したりできます。ビルド処理を正しく実行させるためには、カス
タムフェーズの出力が他のフェーズに入力される場合、フェーズの順序を正しく設定することが必要です。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 77 of 479

High-performance Embedded Workshop V.4.09

3.

ビルドの応用[ビルド -> ビルドフェーズ]を選択すると[ビルドフェーズ]ダイアログボックスが開きます。[ビルドフェーズ]
ダイアログボックスでビルドフェーズの順序を変更できます。このダイアログボックスにはフェーズの順序に関するタブが2つあります。[ビルド順序]タブと[ファイルのビルド順序]タブです。変更後[OK]ボタンをクリッ
クしてください。

ビルド順序タブ3.3.1[ビルド順序]タブは、[ビルド]ボタン()または[すべてをビルド]ボタン()操作で実行されるフェーズの順序を示します。各フェーズの左にあるチェックボックスのオン/オフの有無はそのフェーズの有効/無効を示します。ビルド時はこのチェックボックスがチェックされているフェーズを実行します。

[ビルド]または[すべてをビルド]でシステムフェーズ／カスタムフェーズの順序を変更するには1.

移動するフェーズを選択してください。[上へ]または[下へ]ボタンをクリックすると上下に移動します。

2.

[OK]ボタンをクリックしてください。

システムフェーズのプロパティを参照するには
1.

プロパティを参照するシステムフェーズを選択してください。

2.

[変更]ボタンをクリックしてください。

3.

[コマンド]タブではシステムフェーズに関する情報を表示します。コピーライト、バージョンなどです。

4.

システムフェーズの環境設定を参照するには[環境]タブを選択してください。

5.

[OK]ボタンをクリックしてください。

カスタムフェーズを変更するには
1.

変更するカスタムフェーズを選択してください。

2.

[変更]ボタンをクリックしてください。Phaseの変更ダイアログボックスの[コマンド]タブを表示します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 78 of 479

High-performance Embedded Workshop V.4.09

3.

ビルドの応用3.

必要に応じてフィールドの内容を変更してください。

4.

複数フェーズの場合、フェーズを実行する入力ファイルタイプを[入力ファイル（複数フェーズのみ）]
ドロップダウンリストから選択してください。

5.

入力ファイルがなくてもフェーズの実行を中断したくない場合、[実行前に入力ファイルが存在するか否かのチェックを行わない]チェックボックスをオンにしてください。

6.

標準出力への出力をコマンド実行中に表示したい場合は、[実行中に標準出力を表示する]チェックボ
ックスをオンにしてください。

7.

[環境]タブを選択しフェーズの環境設定を行ってください。

8.

環境変数の追加は[追加]ボタン、変更は[変更]ボタン、削除は[削除]ボタンを使用してください。

9.

[出力シンタックス]タブを選択し、カスタムフェーズのエラー、ウォーニング、およびインフォメー
ションを定義してください。
本機能で解析できるメッセージは、ファイル名を含んだメッセージのみです。したがって、定義する
シンタックスにはファイル名の指定が必要です。ファイル名を指定する際には、必ずプレースホルダを使用してください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 79 of 479

High-performance Embedded Workshop V.4.09

3.

ビルドの応用

アウトプットウィンドウの[Build]タブに出力されるエラーメッセージが[出力シンタックス]の定義と一致する場合、そのエラーメッセージの左側にアイコンを表示したり、該当するソースコードをエデ
ィタで参照したりできます。
例えば、Renesas SuperH C/C++ Compilerの場合は、アウトプットウィンドウの[Build]タブに以下のようなエラーメッセージを出力します。
C:\Workspace\SH\SH\resetprg.c(70) : C2225 (E) Undeclared name "a"
このエラーを定義するには、以下のシンタックスを設定します。
$(FULLFILE)($(LINE))*(E)*エラーメッセージとシンタックスとの対応を以下に示します。
エラーメッセージ例

シンタックス例

説明

C:\Workspace\SH\SH\resetprg.c$(FULLFILE)

絶対パスファイル名のプレースホルダ(70)($(LINE))

行番号のプレースホルダ（丸括弧付き）: C2225*":"およびエラーメッセージ番号用のワイルドカード

(E)

(E)

エラーを示す(E)

Undeclared name "a"*

エラーメッセージ用のワイルドカード

この正規表現フォーマットにはいくつかの制限があります。2つの互いに曖昧な文字をすぐ隣に定義することはできません。例えば、"**"、"*$(FILEDIR)"、または"$(FULLFILE)*"のような任意の組み合わせは定義できません。
また、ファイル名、ディレクトリ名で使用される":"、"¥"、および"."は、ファイル名、ディレクトリ名のプレースホルダとそれ以外の区切りとして定義することはできません。例えば、"$(FULLFILE):$(LINE)"、または"$(FILENAME).*"のような任意の組み合わせは定義できません。
•

シンタックスタイプとして"Error"を選択し、出力メッセージがシンタックスの定義と一致する場合
ビルド実行により出力されるメッセージの左側の余白にエラーアイコン()を表示します。その行をダブルクリックすると、エラーメッセージの該当ソース行をエディタに表示します。
•

シンタックスタイプとして"Warning"を選択し、出力メッセージがシンタックスの定義と一致する場合
ビルド実行により出力されるメッセージの左側の余白にウォーニングアイコン()を表示します。その行をダブルクリックすると、エラーメッセージの該当ソース行をエディタに表示します。
•

シンタックスタイプとして"Other"を選択し、出力メッセージがシンタックスの定義と一致する場合
ビルド実行により出力されるメッセージの左側の余白にインフォメーションアイコン()を表示します。その行をダブルクリックすると、エラーメッセージの該当ソース行をエディタに表示します。
R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 80 of 479

High-performance Embedded Workshop V.4.09

3.

ビルドの応用ビルドフェーズの終了時にエラーおよびウォーニング数の合計をアウトプットウィンドウの[Build]タ
ブに表示します。
10. 出力シンタックスの追加は[追加]ボタン、変更は[変更]ボタン、削除は[削除]ボタンを使用してください。
11. 変更後[OK]ボタンをクリックしてください。
注：
システムフェーズは、[ツールアドミニストレーション]ダイアログボックスで[環境]のみ変更できます。
カスタムフェーズを削除するには1.

削除するフェーズを選択し、[削除]ボタンをクリックしてください。

2.

確認ダイアログボックスが表示された場合は、[はい]ボタンをクリックしてください。

カスタムフェーズを取り込むには
1.

[取り込み]ボタンをクリックしてください。[カスタムフェーズ導入]ダイアログボックスを表示し、カスタムフェーズを取り込むための既存のプロジェクトを見ることができます。

2.

カスタムフェーズを取り込みたいプロジェクトの位置を選択してください。選択すると、取り込み可
能なプロジェクトのカスタムフェーズを並べた[フェーズの導入]ダイアログボックスが開きます。

3.

どのフェーズを取り込むか決定したら、そのフェーズをリスト上で強調表示し、[OK]ボタンをクリッ
クしてください。そのフェーズはビルドフェーズ]ダイアログボックスの[ビルドフェーズの順序]リス
トの最後に追加されます。

3.3.2

ファイルのビルド順序タブ

ワークスペースウィンドウからCソースファイルを選んで[ビルド -> コンパイル]を選択するか、[ファイルのコンパイル]ツールバーボタン()をクリックすると、ファイルをコンパイルします。同じように、ワークス

ペースウィンドウからアセンブリ言語ソースファイルを選択し[ビルド -> コンパイル]を実行すると、ファイ
ルをアセンブルします。ファイルグループと実行するフェーズの関係は[ビルドフェーズ]ダイアログボックスの[ファイルのビルド順序]タブで管理されています。
リストには、[ファイルグループ]リストボックスのファイルグループに対してビルドファイル操作を選択した
とき実行されるすべての現在のフェーズを表示します。下の図では"C source file"ファイルグループを選択しており、"Compiler"フェーズと"MyPhase"フェーズが関連付けされています。

[ビルド順序]タブのリストに新しいエントリを追加すると、自動的に[ファイルのビルド順序]タブの[フェーズ
R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 81 of 479

High-performance Embedded Workshop V.4.09

3.

ビルドの応用の順序]リストに新しいエントリを追加します。例えば、"C source file"を入力とするフェーズを追加します。このフェーズは、"ファイルのビルド"操作を"C source file"に適用する時に実行するフェーズのリストに自動的に追加します。[ビルド -> コンパイル]を選んだときに実行したくないフェーズがある場合、[フェーズの順序]
リストのフェーズ名の左にあるチェックボックスをオフにしてください。

ファイルマッピングタブ

3.3.3

デフォルトでは、フェーズに入力できるファイルはプロジェクトに含まれるものだけです。つまり、[新規ビルドフェーズ]ダイアログボックスの[入力ファイルの選択]ドロップダウンリストに指定した種類のプロジェ
クトファイルだけです。[ビルド -> ビルドフェーズ]を選択すると[ビルドフェーズ]ダイアログボックスが開きます。もし前のフェーズから出力されたファイル（中間ファイル）をフェーズで使いたい場合は、[ビルドフェーズ]ダイアログボックスの[ファイルマッピング]タブで定義してください。

ファイルマッピングでは、あるフェーズ（出力元フェーズという）で作成したある種類の出力ファイル（中間ファイル）を、他のフェーズ（出力先フェーズという）に渡すように指定します。プロジェクトファイルに加えて中間ファイルも渡します。
ファイルのマッピングを追加するには
1.

[追加]ボタンをクリックしてください。[ファイルマッピングの設定]ダイアログボックスが開きます。

2.

[ファイルグループ]ドロップダウンリストボックスから新しいマッピングのためのファイルグループを選択してください。

3.

[出力元フェーズ]ドロップダウンリストボックスから出力元フェーズ（ファイルを作成するフェーズ）を選択してください。

4.

[出力先フェーズ]ドロップダウンリストボックスから出力先フェーズ（ファイルを渡す先のフェーズ）を選択してください。

5.

[OK]ボタンをクリックすると新しいマッピングを追加します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 82 of 479

High-performance Embedded Workshop V.4.09

3.

ビルドの応用ファイルマッピングを変更するには
1.

変更するマッピングを選択してください。

2.

[変更]ボタンをクリックしてください。[ファイルマッピングの設定]ダイアログボックスが開きます。

3.

必要に応じてオプションを変更してください。

4.

[OK]ボタンをクリックすると変更が有効になります。

ファイルマッピングを削除するには

3.4

1.

削除するマッピングを選択してください。

2.

[削除]ボタンをクリックしてください。

3.

[OK]ボタンをクリックすると変更が有効になります。

カスタムビルドフェーズのオプション設定

カスタムフェーズを定義後、フェーズ実行時に使用するコマンドラインオプションを指定します。定義されたフェーズにはそれぞれ[ビルド]メニューにオプション設定用のメニューがあります。指定するフェーズのオプションを選択してください。起動するダイアログボックスは、選択したカスタムフェーズが単一フェーズか複数フェーズかによって異なります（新規ビルドフェーズウィザードでフェーズが作成されたときのフェーズ種類の選択によります）。

選択したフェーズが複数の場合、ダイアログボックスの左側にはプロジェクトファイルのリストが表示され、ファイル上でビルドオプションを指定できます。選択したフェーズが単一の場合、プロジェクトファイルのリ
ストは表示されません。
右側には3つのオプションタブがあります。選択したファイルに適用するオプションをここで設定してください。また、ダイアログボックス左上のコンフィグレーションリストで、どのコンフィグレーションの情報を表示するか選択できます。各コンフィグレーションは[Multiple configurations]という名のエントリと一緒に並べられています。[Multiple configurations]を選択すると、ダイアログボックスが表示され、複数のコンフィグレーシ
ョンを選択できます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 83 of 479

High-performance Embedded Workshop V.4.09

3.

ビルドの応用オプションタブ3.4.1[オプション]タブではフェーズに渡されるコマンドラインオプションを定義できます。[コマンド]ではフェーズを定義したときに入力したコマンドを表示します。[オプション]にはコマンドに渡すコマンドライン引数を入力してください。プレースホルダを挿入する場合は、対応するプレースホルダを[プレースホルダ]ドロップ
ダウンリストボックスから選択し、[挿入]ボタンをクリックしてください。プレースホルダの詳細については、「リファレンス5. プレースホルダ」を参照してください。

注：
コマンドラインオプションの合計文字数が256文字を超える場合は、エラーになります。

出力ファイルタブ

3.4.2[出力ファイル]タブではフェーズで作成される出力ファイルを指定します。High-performance Embedded
Workshopでは、ファイルがこのフェーズを通過する前に、出力ファイルの日付が入力ファイルの日付より古いことをチェックしています。出力ファイル作成後入力ファイルが変更された場合、入力ファイルに対してこのフェーズを実行します。出力ファイルが最新の場合、入力ファイルに対してこのフェーズを実行しません。
注：
出力ファイルを指定しない場合フェーズを常に実行します。

出力ファイルを追加するには
1.

[追加]ボタンをクリックしてください。[出力ファイルの追加]ダイアログボックスが開きます。

2.

ファイル名を入力するか、[参照]ボタンで選択してください。

3.

[OK]ボタンをクリックすると、リストに出力ファイルを追加します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 84 of 479

High-performance Embedded Workshop V.4.09

3.

ビルドの応用

出力ファイルを変更するには
1.

変更する出力ファイルを選択してください。

2.

[変更]ボタンをクリックすると[出力ファイルの変更]ダイアログボックスが開きます。

3.

フィールドを変更してください。

4.

[OK]ボタンをクリックすると、変更した項目をリストに追加します。

出力ファイルを削除するには1.

削除する出力ファイルを選択してください。

2.

[削除]ボタンをクリックしてください。

出力ファイルのパスにはプレースホルダを使用できます。

依存ファイルタブ

3.4.3[依存ファイル]タブではフェーズに必要な依存ファイルを指定します。High-performance Embedded Workshopでは、各ファイルがこのフェーズを通過する前に、依存ファイルの日付が入力ファイルの日付より新しいか否かをチェックしています。チェック後、依存ファイルの日付が新しい場合（つまり、入力ファイル作成後に依存ファイルが変更された場合）このフェーズでファイルを実行します。依存ファイルの日付が入力ファイルの日
付より古い場合、このフェーズは実行しません。

依存ファイルを追加するには
1.

[追加]ボタンをクリックしてください。[依存ファイルの追加]ダイアログボックスが開きます。

2.

ファイル名を入力するか、[参照]ボタンで選択してください。

3.

[OK]ボタンをクリックすると、リストに出力ファイルを追加します。

依存ファイルを変更するには
1.

変更する依存ファイルを選択してください。

2.

[変更]ボタンをクリックすると[依存ファイルの変更]ダイアログボックスが開きます。

3.

フィールドを変更してください。

4.

[OK]ボタンをクリックすると、変更した項目をリストに追加します。

依存ファイルを削除するには1.

削除するファイルを選択してください。

2.

[削除] ボタンをクリックしてください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 85 of 479

High-performance Embedded Workshop V.4.09

3.

ビルドの応用依存ファイルのパスにはプレースホルダを使用できます。

ビルドを管理する

3.5

ビルドの中止条件の初期状態は「すべてのフェーズを実行し、途中で致命的なエラーが発生したときだけ中止する」です。ビルドの中止条件は[オプション]ダイアログボックスの[ビルド]タブで変更できます。
[基本設定 -> オプション]を選択し[オプション]ダイアログボックスの[ビルド]タブを表示してください。ある
一定の回数を超えるエラーが発生した後にビルドを中止したいとき、[エラーの数が超えたときにビルド中止]
チェックボックスをオンにして右のフィールドにエラー数を入力してください。指定した数を超えるウォーニ
ングが表示されたときにビルドを中止したいとき、[ウォーニングの数が超えたときにビルド中止]チェックボ
ックスをオンにして右のフィールドにウォーニング数を入力してください。

[ビルド]タブでは、エラー数やウォーニング数の制限のほかに、コマンドライン、環境、初期ディレクトリの表示の有無を設定できます。表示するには、それぞれのチェックボックスをオンにしてください。
注：•

上記設定にかかわらず、致命的エラーが発生した場合、ビルドは停止します。

•

依存関係を設定したプロジェクトのビルドでは、子プロジェクトでエラーが発生すると親プロジェクトはビルドを行いません。

•[エラーの数が超えたときにビルド中止]をチェックして数値を指定したとき、次に示す項目に注意してください。
i.

エラー数が指定した数を超えた場合、ビルドは直ちに停止します。該当フェーズの完了までビルドを続けません。

ii.

1回のツールの実行でエラー数が指定した数を超えた場合、指定したエラー数に１を加えた数のエラー
メッセージまでをアウトプットウィンドウに表示しますが、それ以上のエラーメッセージは表示しま
せん。また、エラー数が指定した数値を超えた旨のメッセージもアウトプットウィンドウに表示されませんのでご注意ください。

なお、[ウォーニングの数が超えたときにビルド中止]についても[エラーの数が超えたときにビルド中止]と同様です。また、[ウォーニングの数が超えたときにビルド中止]と[エラーの数が超えたときにビルド中止]とは相互の関係はなく、それぞれ独立した機能です。

ビルドの出力のログを取る

3.6

ファイルに各ビルドの結果を保存できます。
ログファイルを指定するには
1.

[基本設定 -> カスタマイズ]を選択してください。[カスタマイズ]ダイアログボックスが開きます。

2.

[ログ]タブを選択してください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 86 of 479

High-performance Embedded Workshop V.4.09

3.

ビルドの応用

3.

[ビルドログファイル生成]チェックボックスをオンにしてください。

4.

[ディレクトリ]フィールドにログファイルの絶対パスを入力するか、[参照]ボタンをクリックしてパスを選択するか、またはプレースホルダボタン()をクリックし表示されるポップアップメニューから

プレースホルダを選択してください。
5.

3.7[OK]ボタンをクリックしてください。

ツールチェインのバージョンを変更する

同じツールチェインの2つ以上のバージョンがHigh-performance Embedded Workshopに登録されているとき[ツールチェインのバージョンの変更]ダイアログボックスでバージョンを選択できます。このダイアログボック
スを開くには[ツール -> ツールチェインバージョンを変更]を選択してください。このダイアログボックスの[ツールチェインバージョン]ドロップダウンリストからバージョンを選択し、[OK]ボタンをクリックしてくだ
さい。

ツールチェインを構成するツールの情報を表示するには[ツールチェインのバージョンの変更]ダイアログボッ
クスの[ツールチェインビルドフェーズ]ドロップダウンリストからツールを1つ選択し、[情報]ボタンをクリッ
クしてください。ツール情報ダイアログボックスにそのツールの情報を表示します。このダイアログボックス
を閉じるには[閉じる]ボタンをクリックしてください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 87 of 479

High-performance Embedded Workshop V.4.09

3.8

3.

ビルドの応用Makeファイルの生成

High-performance Embedded Workshopでは、ワークスペースに関連したMakeファイルを生成できます。生成可能なMakeファイルのフォーマットは、HMake、NMake、およびGNUMakeです。Makeファイルを実行するMake
ツールは、DOSコマンドプロンプト上で動作するツールであり、生成したMakeファイルを使用することで、High-performance Embedded Workshopを起動しなくてもプロジェクトをビルドできます。
生成したMakeファイルは、High-performance Embedded Workshop上で実行できます。この設定は、「3.9 Make
ファイルを使ったビルド」を参照してください。
Makeファイルを生成するには
1.

Makeファイルを生成するワークスペースを開いてください。
（ワークスペースに複数のプロジェクトを登録している場合は、Makeファイルを生成するプロジェク
トをアクティブプロジェクトとしてください）

2.

Makeファイルを生成するコンフィグレーションを選択してください。

3.

[ビルド -> Makeファイルの作成]を選択してください。[Makeファイルの生成]ダイアログボックスが開
きます。

4.

[Makeファイルの生成タイプ]から生成したいMakeファイルのタイプを選択してください。

•

現在有効なプロジェクトの現在のコンフィグレーションのみ（デフォルト）•

現在有効なプロジェクトのすべてのコンフィグレーション•

ワークスペース内のすべてのプロジェクトのすべてのコンフィグレーション

5.

[Makeファイル名]エディットボックスにMakeファイルのファイル名を入力してください。プレースホ
ルダを挿入する場合は、挿入する箇所にカーソルを移動して、プレースホルダボタン()をクリック

し、ポップアップメニューからプレースホルダを選択してください。
Makeファイルのファイル名のデフォルト値は以下の通りです。
•[現在有効なプロジェクトの現在のコンフィグレーションのみ]を選択した場合$(PROJECTNAME)_$(CONFIGNAME).mak•[現在有効なプロジェクトのすべてのコンフィグレーション]を選択した場合$(PROJECTNAME).mak

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 88 of 479

High-performance Embedded Workshop V.4.09•

3.

ビルドの応用[ワークスペース内のすべてのプロジェクトのすべてのコンフィグレーション]を選択した場合$(WORKSPNAME).mak

6.

[Makeファイルのフォーマット]ドロップダウンリストから生成するMakeファイルのフォーマットを選択してください。生成可能なMakeファイルのフォーマットは、HMake、NMake、およびGNUMakeです。

7.

[相対パス]ドロップダウンリストからMakeファイル内のディレクトリ表現方法を選択してください。
デフォルト値は、"Workspace directory and below only"です。
選択可能なディレクトリ表現方法は以下の通りです。
オプション

8.

ワークスペースディレクトリ

ワークスペースディレクトリ

およびそれ以下のディレクトリ

の外のディレクトリ

None

絶対パス

絶対パス

Workspace directory and below only

相対パス

絶対パス

All

相対パス

相対パス

[サブコマンドファイルの生成]チェックボックスは、オンにするとMakeファイルが出力されるディレ
クトリ内にコマンドファイルを生成します。デフォルトはオフです。
注：
以下に示すコンパイラパッケージに含まれるツールチェインを使用している場合に[Makeファイルのフォーマット]でGNUMakeを選択すると、[サブコマンドファイルの生成]チェックボックスはオンに固定されています。
- SuperHファミリ用C/C++コンパイラパッケージ- H8SX, H8S, H8ファミリ用C/C++コンパイラパッケージ- RXファミリ用C/C++コンパイラパッケージ

9.

[Makeファイルの生成時に依存関係をスキャン]チェックボックスは、オンにするとMakeファイルを生成する前に依存関係の更新を行います。デフォルトはオンです。

10. [OK]ボタンをクリックしてください。
High-performance Embedded Workshopは、ワークスペースディレクトリ内に"make"ディレクトリを作り、その下にMakeファイルを生成します。[Makeファイルのフォーマット]でHMakeを選択して作成したMakeファイル
は、High-performance Embedded WorkshopインストールディレクトリにあるHMAKE.EXEで実行できます。
Makeファイルを編集する場合は、「リファレンス13. HMAKEユーザガイド」を参照してください。
注：
High-performance Embedded Workshopをインストールしたディレクトリに空白がある場合、Makeファイル生成
機能でMakeファイルのフォーマットに"GNU Make"を選択すると、"GNU Make"コマンドが正しく動作しないことがあります。
Makeファイル（HMake用）を実行するには
1.

DOSコマンドプロンプトウィンドウを開き、Makeファイルが生成されたディレクトリに移動してくだ
さい。

2.

HMAKEを実行してください。コマンドラインは、
HMAKE.EXE <Makeファイル名>です。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 89 of 479

High-performance Embedded Workshop V.4.09

3.

ビルドの応用注：
生成したMakeファイルが移動可能か否かは、プロジェクト自体が移動可能か否かに依存します。例えば、出力ディレクトリやインクルードファイルディレクトリへの絶対パスを含むコンパイラオプションがあると、異なるインストール環境下の別のユーザがビルドした場合、失敗する可能性があります。一般的に、できるだけ
プレースホルダを使用して、絶対パス、または特定のパスの使用はなるべく避けてください。

3.9

Makeファイルを使ったビルド

High-performance Embedded Workshopは、High-performance Embedded Workshop標準のビルドのほかに、特定のMakeツール（hmake、nmake、gmake）を使用したビルドを実行できます。
Makeファイルを使ったビルド方法について以下に説明します。
nmake、gmakeは、お客様ご自身でご用意ください。
hmakeは、High-performance Embedded Workshopインストールディレクトリにインストールされます。
Makeファイルの実行制御を設定するには
1.

High-performance Embedded Workshopのワークスペースを作成してください。

2.

High-performance Embedded Workshop生成のMakeファイルを使用したい場合、[ビルド -> Makeファイ
ルの生成]を選択し、Makeファイルを生成してください。Makeファイル生成の詳細は、前節の「3.8 Make
ファイルの生成」を参照してください。

3.

[基本設定 -> オプション]を選択してください。[オプション]ダイアログボックスが開きます。

4.

[ビルド]タブを選択してください。

5.

[コマンド（パラメタ除く）]エディットボックスにMakeファイルを実行するMakeツールを入力してください。デフォルトは、hmake （$(HEWDIR)\hmake.exe）です。

6.

[Makeファイルを使ったビルド]チェックボックスをオンにしてください。これにより標準のビルドではなくMakeファイルを使ったビルドを実行します。

7.

[Makeファイルの生成をビルド開始直前に行なう]チェックボックスは、オンにするとビルド開始直前に毎回Makeファイルを生成し直します。Makeファイルが、常に最新のHigh-performance Embedded
Workshopプロジェクトの状態に対応するようになります。

8.

[Makeファイル名]エディットボックスにMakeファイルを入力してください。デフォルトは、$(WORKSPDIR)¥make¥$(PROJECTNAME)_$(CONFIGNAME).makです。
注： コマンドラインでMakeファイルを指定する必要がない場合、このエディットボックスは空にでR20UT0372JJ0100 Rev.1.00
2011.02.01

Page 90 of 479

High-performance Embedded Workshop V.4.09

3.

ビルドの応用きます。
9.

[初期ディレクトリ]エディットボックスにMakeファイルを実行するときのカレントディレクトリを入力してください。このエディットボックスが空の場合は、$(WORKSPDIR)をデフォルトとします。

10. [Makeファイルオプション]エディットボックスにMakeファイルのビルド用のオプションを入力してください。
11. [クリーンオプション]エディットボックスにMakeファイルのクリーン用のオプションを入力してください。
12. [OK]ボタンをクリックしてください。
Makeファイルを使ったビルドの設定を行うと、[ビルド]ボタン、メニュー、およびキーボードのショートカットは、Makeファイルの実行制御に切り替わります。[クリーン 全プロジェクト]ボタン、メニュー、およびキーボードショートカットもまた、Makeファイルの実行制御に切り替わります。
標準のビルドと同様に、アウトプットウィンドウの[Build]タブに結果をすべて出力します。High-performance
Embedded Workshopがサポートしているビルドフェーズが実行された場合、エラーメッセージ出力行をダブルクリックするとソースファイルにジャンプできます。ヘルプリンクをサポートしている場合もあります。
HMAKE.exeを使用している場合に[すべてをビルド]ツールバーボタン()をクリックすると、HMAKEへすべての再ビルドを実行するコマンドを渡します。
Makeファイルのシステム環境を設定するにはデフォルトでは、High-performance Embedded Workshop内で使用されているシステム環境でMakeファイルを実行します。これを変更したい場合、下記のように環境を構成できます。
1.

[ビルド]タブで、[Makeファイルオプション]の右側の[システム]ボタンをクリックしてください。[Make
ファイルシステム環境]ダイアログボックスが開きます。

2.

[システム環境を継承する]チェックボックスは、システム環境の継承を切り替える場合に使用します。
チェックがオンの場合、Makeファイルを標準の環境で実行します（デフォルト）。
チェックがオフの場合、Makeファイルを新規の環境で実行します。
注： 「SystemRoot」変数は、Windows® 上で動作するプログラムの許可に必要なため、新規の環境に継承されます。

3.

[環境変数]などのコントロールを使用し新たな環境変数を設定できます。ここで設定された値は、現在のシステム環境の値より優先します。

4.

変更を保存するために、OKをクリックし[オプション]ダイアログボックスに戻ってください。このダイアログボックスのOKボタンがクリックされるまで値はワークスペースに渡されません。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 91 of 479

High-performance Embedded Workshop V.4.09

3.10

3.

ビルドの応用

リンク順序をカスタマイズする

High-performance Embedded Workshopでは、通常、モジュールはファイル名のアルファベット順にリンクしま
すが、リンクする順序をカスタマイズできます。
リンク順序をカスタマイズするには
1.

[ビルド -> リンク順の指定]を選択してください。[リンク順序のカスタマイズ]ダイアログボックスが
開きます。

2.

[リンク順序のカスタマイズの使用]チェックボックスをオンにします。

3.

[リンク順序]リストボックスで、モジュールをリンクする際の順序を設定します。各モジュールはその属性によって異なるアイコンを表示しています。これを下図に示します。
注：
以下に示すコンパイラパッケージに含まれるツールチェインを使用している場合に[リンク順序]リス
トボックスにオブジェクトファイルと一緒にライブラリファイルが表示されます。
- SuperHファミリ用C/C++コンパイラパッケージ- H8SX, H8S, H8ファミリ用C/C++コンパイラパッケージ- RXファミリ用C/C++コンパイラパッケージ- M16Cシリーズ,R8Cファミリ用C/C++コンパイラパッケージ V.6.00 Release 00およびそれ以降
リンク順序に関係するのはオブジェクトファイルのみです。ライブラリファイルの順序は、未定義シ
ンボルを検索する場合に使用されます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 92 of 479

High-performance Embedded Workshop V.4.09

3.

ビルドの応用

以下の方法でリンク順序を変更できます。
•

1つまたは連続した複数のモジュールを移動する[上端へ]ボタン

選択したモジュールをすべて先頭に移動します。

[上へ]ボタン

選択したモジュールと1つ上のモジュールを入れ替えます。

[下へ]ボタン

選択したモジュールと1つ下のモジュールを入れ替えます。

[下端へ]ボタン

選択したモジュールをすべて最後に移動します。

•

連続しない複数のモジュールを移動する[上端へ]ボタン

選択したモジュールをすべて先頭に移動します。

[上にグループ化]ボタン

選択したモジュールをそれらの中で先頭のモジュールの位
置にすべて移動します。

[下にグループ化]ボタン

選択したモジュールをそれらの中で最後のモジュールの位
置にすべて移動します。

[下端へ]ボタン

選択したモジュールをすべて最後に移動します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 93 of 479

High-performance Embedded Workshop V.4.09

3.

ビルドの応用上端のモジュールを選択した場合、[上端へ]ボタン、[上へ]ボタンは無効です。また、下端のモジュー
ルを選択した場合、[下端へ]ボタン、[下へ]ボタンは無効です。
現在のリンク順序の設定をテキスト形式で保存できます。保存したファイルでリンク順序を編集し、そのファイルを読み込むと、新しいリンク順序を適用できます。
リンク順序をテキストファイルから読み込むには1.

[ビルド -> リンク順の指定]を選択してください。[リンク順序のカスタマイズ]ダイアログボックスが
開きます。

2.

[リンク順序のカスタマイズの使用]チェックボックスをオンにしてください。

3.

[インポート]ボタンをクリックすると[リンク順序のインポート]ダイアログボックスが開きます。

4.

ファイルを指定し、[選択]ボタンをクリックしてください。[リンク順序のインポートレポート]ダイア
ログボックスが開きます。

5.

ファイルに保存されているリンク順序を読み込む場合は、[続行]ボタンをクリックしてください。新しいリンク順序でリストを更新します。
注：
現在のリンク順序の設定が上書きされるので注意してください。

6.

現在のリンク順序を変更しない場合は、[キャンセル]ボタンをクリックしてください。

リンク順序をテキストファイルに保存するには
1.

[ビルド -> リンク順の指定]を選択してください。[リンク順序のカスタマイズ]ダイアログボックスが
開きます。

2.

[リンク順序のカスタマイズの使用]チェックボックスをオンにしてください。

3.

[エクスポート]ボタンをクリックすると[リンク順序のエクスポート]ダイアログボックスが開きます。

4.

ディレクトリ、ファイル名を指定し、[保存]ボタンをクリックしてください。現在のリストボックスの内容を指定したファイルに保存します。
例：# Exported linkage order for project "Project_name" - configuration "Debug"
c:¥workspace¥workspace_name¥project_name¥debug¥main.obj
c:¥workspace¥workspace_name¥project_name¥debug¥resetprg.obj
c:¥workspace¥workspace_name¥project_name¥debug¥intprg.obj
c:¥workspace¥workspace_name¥project_name¥debug¥runtime_library.libc:¥workspace¥workspace_name¥project_name¥debug¥projectname.libc:¥workspace¥workspace_name¥project_name¥debug¥user_edit_options.lib
エディタなどでファイルを開き、リンク順序を編集後、テキスト形式で保存してください。
「リンク順序をテキストファイルから読み込むには」を実行すると、編集したリンク順序を読み込めます。

複数のコンフィグレーションを使用する場合、リンク順序を同じにする場合があります。
現在のリンク順序の設定を他のコンフィグレーションにコピーする方法を以下に説明します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 94 of 479

High-performance Embedded Workshop V.4.09

3.

ビルドの応用他のコンフィグレーションにリンク順序をコピーするには1.

[ビルド -> リンク順の指定]を選択してください。[リンク順序のカスタマイズ]ダイアログボックスが
開きます。

2.

[リンク順序のカスタマイズの使用]チェックボックスをオンにしてください。

3.

[現在のコンフィグレーション]ドロップダウンリストで、コピー元のコンフィグレーションを選択してください。現在のコンフィグレーションをデフォルトで表示します。

4.

[コピー先]ボタンをクリックすると[コンフィグレーションのコピー先選択]ダイアログボックスが開きます。現在のリンク順序を現在のプロジェクトのどのコンフィグレーションにコピーするかを指定
します。

5.

コンフィグレーションを選択し、[OK]ボタンをクリックしてください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 95 of 479

High-performance Embedded Workshop V.4.09

4.

4.

エディタ

エディタ

この章ではHigh-performance Embedded Workshopが提供するエディタの使い方を説明します。

4.1

エディタウィンドウ

エディタウィンドウには、表示中や編集中のファイルがあります。
アクティブウィンドウのタイトルバーは他のウィンドウとは色が異なります。（図では"dbsct.c"がアクティブウィンドウです。）文字入力やテキスト貼り付けなどのテキスト操作はアクティブウィンドウでのみ行うことができます。
アクティブウィンドウから他のソースファイルのウィンドウへ切り替えるには（他のウィンドウをアクティブウィンドウにするには）、以下の方法があります。
(a) そのウィンドウが表示されていればそれをクリックする。
(b) "Ctrl+Tab"キーまたは"Ctrl+Shift+Tab"キーを押して順次ウィンドウをアクティブにする。
(c) [ウィンドウ]メニューからウィンドウ名を選択する。
(d) エディタウィンドウの下の該当するタブを選択する。

タイトルバー

ファイルの情報（ファイル名、編集中のアスタリスク (*)、および読み取り専用属性）を表示します。
アクティブプロジェクトのディレクトリ下に含まれているファイルの場合は、エディタウ
ィンドウのタイトルバーにファイル名を表示します。アクティブプロジェクトのディレク
トリ下に含まれていないファイルの場合は、エディタウィンドウのタイトルバーに絶対パスを含むファイル名を表示します。

ツールバー

ツールバーは、デバッガに接続されている場合のみ表示します。各表示モードが有効である場合、ツールバーのボタンをクリックすると表示モードを切り替えます。
各ボタン上にマウスポインタを置くとボタン名をポップアップ表示します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 96 of 479

High-performance Embedded Workshop V.4.09

カラムヘッダ4.

エディタ

カラムヘッダ上のマウスのドラッグで各カラムの幅を調節できます。また、カラムヘッダ
上で右クリックするとポップアップメニューを表示します。カラムが利用できる場合は、エントリの横にはチェックマークがあります。エントリをクリックすると、各カラムの表
示、非表示を切り替えます。
各カラムヘッダ上にマウスポインタを置くと、カラム名をポップアップ表示します。
カラムヘッダ自体の表示、非表示を切り替えることもできます。

カラム

ソースカラムの左側にはいくつかの余白（カラム）があります。
各カラム上にマウスポインタを置くと、カラム名をポップアップ表示します。

ソースカラムシンタックスを強調表示したコードを含みます。エディタの1行の最大文字数（半角）は、
8,192文字です。
この領域内で右クリックすると、使用可能なオプションをポップアップメニューで表示します。

タブ

ファイルの情報（ファイル名、および編集中のアスタリスク (*)）を表示します。
各タブ上にマウスポインタを置くと、絶対パスを含むファイル名をポップアップ表示します。
この領域内で右クリックすると、使用可能なオプションをポップアップメニューで表示します。

複数のファイルを扱う

4.2

プロジェクトのファイルを操作するときにはエディタウィンドウを使います。エディタによって、一度に複数のファイルを開いたり、ファイル間の切り替えをしたり、異なる構成に並べ替えたり、任意の順序に編集できます。ウィンドウ上での操作はWindows®のアプリケーションの一般的な機能であり、以下の[ウィンドウ]メニ
ューから選択できます。
メニューオプション

動作[ウィンドウ -> 重ねて表示]

開いているすべてのウィンドウの左上が見えるように重ねて並べます。

[ウィンドウ -> 上下に並べて表示]

開いているすべてのウィンドウが互いに重ならずにエディタウィンドウの全体を占めるように並べます（垂直方向）。

[ウィンドウ -> 左右に並べて表示]

開いているすべてのウィンドウが互いに重ならずにエディタウィンドウの全体を占めるように並べます（水平方向）。

[ウィンドウ -> アイコンの整列]

すべての最小化したウィンドウをエディタウィンドウの下に並べます。

[ウィンドウ -> すべて閉じる]

開いているエディタウィンドウをすべて閉じます。

また、エディタのファイルはブック形式で表示できます。つまり、各ファイルにタブが付いていてファイル間の行き来を容易にできます。
ファイルをブック形式で表示するには

1.

[基本設定 -> オプション] を選択してください。[オプション]ダイアログボックスが開きます。

2.

[エディタ]タブを選択してください。

3.

[ブック形式でファイルを表示]チェックボックスをオンにしてください。

4.

[OK]ボタンをクリックしてください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 97 of 479

High-performance Embedded Workshop V.4.09

4.

エディタ

標準のファイル操作

4.3

新規ファイルを作成する

4.3.1

新しいエディタウィンドウを作成するには以下のいずれかの操作を選択してください。
•[新規ファイル]ツールバーボタン(•"Ctrl+N"キーを押す。

•[ファイル -> 新規作成]を選択する。

)をクリックする。

新しいウィンドウにはデフォルトで名前が付きます。ファイルを保存するときに名前を変更できます。

4.3.2

ファイルを編集する

High-performance Embedded Workshopエディタは標準的な編集機能をサポートします。通常の方法（メニュー、
ツールバー、キーボードのショートカット）で編集できるほか、各エディタウィンドウにあるポップアップメ
ニューでも編集できます。ポップアップメニューを表示するには、開いたウィンドウ上で右クリックしてください。
以下の表に編集の基本操作を示します。
名称
元に戻す

機能
最新の編集操作を取り消す。

操作[編集 -> 元に戻す]を選択する。
Ctrl+Z キーを押す。

やり直し

最新の取り消した編集操作をやり直す。

[編集 -> やり直し]を選択する。
Ctrl+Y キーを押す。

切り取り

選択部分を削除し Windows® クリップボードに貼 [切り取り]ツールバーボタン(
り付ける。

) をクリックする。

Ctrl+X キーを押す。
[編集 -> 切り取り]を選択する。
[切り取り] - ポップアップメニューを選択する。

コピー

選択部分をコピーし Windows® クリップボードに [コピー]ツールバーボタン(
貼り付ける。

) をクリックする。

Ctrl+C キーを押す。
[編集 -> コピー]を選択する。
[コピー] - ポップアップメニューを選択する。

貼り付け

Windows® クリップボードの内容をコピーしてア[貼り付け]ツールバーボタン(

クティブウィンドウのカーソル位置に貼り付け

Ctrl+V キーを押す。

る 。

[編集 -> 貼り付け]を選択する。

) をクリックする。

[貼り付け] - ポップアップメニューを選択する。
削除
すべて選択

選択部分を削除する（Windows® クリップボード[編集 -> 削除]を選択する。

に貼り付けない）。

Delete キーを押す。

アクティブウィンドウの内容すべてを選択する。

[編集 -> すべて選択]を選択する。
Ctrl+A キーを押す。

ファイルを編集すると、エディタウィンドウのタイトルバーにアスタリスク（*）を表示します。（例：filename.c*）
アスタリスクはファイルを保存するまで表示します。現在のウィンドウですべての編集が戻された場合には、アスタリスクの表示が消えます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 98 of 479

High-performance Embedded Workshop V.4.09

4.

エディタ

エディタでテキストを選択する
すべてのエディタと同じ方法でテキストを選択できます。ただし、列を選択するには、Altキーを押した状態
でマウスによりテキストを選択してください。

ファイルを保存する

4.3.3

エディタウィンドウの内容を保存するには
1.

内容を保存するウィンドウがアクティブであることを確認してください。

2.

以下のいずれかの操作を選択してください。

•[ファイルの保存]ツールバーボタン(•"Ctrl+S"キーを押す。

•[ファイル -> 上書き保存]を選択する。

3.

ファイルを新規に保存する場合、名前を付けて保存するダイアログボックスを開きます。ファイル名)をクリックする。

とディレクトリを指定して、[保存]ボタンをクリックしてください。
4.

既に保存したことのあるファイルの場合は、ダイアログボックスを表示せずにファイルを更新します。

エディタウィンドウの内容を新しい名前で保存するには
1.

内容を保存するウィンドウがアクティブであることを確認してください。

2.

[ファイル -> 名前を付けて保存]を選択してください。

3.

名前を付けて保存するダイアログボックスが開きます。ファイル名とディレクトリを指定して[保存]ボタンをクリックしてください。

すべての開いているエディタウィンドウの内容を保存するには
1.

以下のいずれかの操作を選択してください。

•[すべて保存]ツールバーボタン(•[ファイル -> すべて保存]を選択する。

2.

新規にファイルを保存する場合、名前を付けて保存するためのダイアログボックスを開きます。ファ)をクリックする。

イル名とディレクトリを指定してください。既に保存したことのあるファイルの場合は、ダイアログ
ボックスを表示せずにファイルを更新します。
ファイルが読み取り専用属性の場合にファイルを保存しようとすると、別名で保存するか否かを確認するダイ
アログボックスが開きます。

•「はい」ボタンをクリックするとファイルを保存するダイアログボックスが開きます。ファイル名を変更して保存してください。

•「いいえ」ボタンをクリックするとファイルを保存しません。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 99 of 479

High-performance Embedded Workshop V.4.09

•

4.

エディタ

「上書き」ボタンをクリックするとファイルを上書き保存します。ファイルは読み取り専用ではなく
なります。

•

「キャンセル」ボタンをクリックするとファイルを保存しません。

ファイルを開く

4.3.4[ファイルを開く]ダイアログボックスでファイルを開くには1.

以下のいずれかの操作を選択し[ファイルを開く]ダイアログボックスを開きます。

•[ファイルを開く]ツールバーボタン(•"Ctrl+O"キーを押す。

•[ファイル -> 開く]を選択する。

2.

右のディレクトリブラウザを使って、開きたいファイルのあるディレクトリに移動してください。[フ)をクリックする。

ァイルの種類]コンボボックスでファイルの種類を選択してください。("All Files" (*.*) を指定すると、そのディレクトリのすべてのファイルを表示します。)
3.

ファイルを選択し[開く]ボタンをクリックしてください。

High-performance Embedded Workshopのメインウィンドウ上にWindows® Explorerからファイルをドラッグアン
ドドロップして開きます。
また、ワークスペースウィンドウの[Projects]タブのソースファイルは、以下のいずれかの方法で個々のファイ
ルが開けます。
•

ファイルをダブルクリックする。

•

ファイルを選択し、右クリックしてポップアップメニューから[開く <ファイル名>]を選択する。

•

ファイルが選択されフォーカスがある場合にEnterキーを押す。

ファイルは、High-performance Embedded Workshopエディタ以外のエディタ（外部エディタと呼びます）で開くこともできます。詳細は、「6.9 外部エディタを使う」を参照してください。
最近開いたファイルを[ファイル]メニューの[最近使ったファイル]サブメニューに追加します。この機能は最近開いたファイルを再び開きたいときに便利です。
最近利用したファイルを開くには[ファイル -> 最近使ったファイル]を選択し、このサブメニューから開きたいファイルを選択してください。

ファイルを閉じる

4.3.5

個別にファイルを閉じるには以下のいずれかの操作を選択してください。
•

エディタウィンドウのシステムメニュー（[最大化]表示されていないときの各ウィンドウの左上）をダブルクリックする。

•

エディタウィンドウのシステムメニュー（[最大化]表示されていないときの各ウィンドウの左上）をクリックして[閉じる]を選択する。

•

アクティブウィンドウであることを確認後"Ctrl+F4"キーを押す。

•

アクティブウィンドウであることを確認後[ファイル -> 閉じる]を選択する。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 100 of 479

High-performance Embedded Workshop V.4.09

•

4.

エディタ

"閉じる"ボタン（[最大化]表示されていないときの各ウィンドウの右上）をクリックする。

すべてのファイルを閉じるには[ウィンドウ -> すべて閉じる]を選択してください。
ファイルを編集し保存していない場合にファイルを閉じようとすると、保存するか否かを確認するダイアログ
ボックスが開きます。

•「いいえ」ボタンをクリックするとファイルを保存せずにファイルを閉じます。

•「キャンセル」ボタンをクリックするとエディタウィンドウに戻ります。

•「はい」ボタンをクリックするとファイルを上書き保存しファイルを閉じます。ファイルが読み取り専用属性の場合に「はい」ボタンをクリックすると、別名で保存するか否かを確認するダイアログボ
ックスが開きます。

•「はい」ボタンをクリックするとファイルを保存するダイアログボックスが開きます。ファイル名を変更して保存してください。

•「いいえ」ボタンをクリックするとファイルを保存せずにファイルを閉じます。

•「上書き」ボタンをクリックするとファイルを上書き保存しファイルを閉じます。ファイルは読み取
り専用ではなくなります。

•「キャンセル」ボタンをクリックするとエディタウィンドウに戻ります。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 101 of 479

High-performance Embedded Workshop V.4.09

4.

エディタ

ウィンドウを閉じるポップアップメニュー

4.3.6

High-performance Embedded Workshopのエディタウィンドウでは、タブ上のポップアップメニューにより編集
ファイルを上書き保存したり、ウィンドウを閉じたりできます。
エディタウィンドウのタブ上で右クリックすると、使用可能なオプションをポップアップメニューで表示します。
ポップアップメニューオプション

機能

上書き保存

編集中のウィンドウの内容を保存します。

閉じる

ファイルを閉じます。

逆アセンブリウィンドウでは、タブ上のポップアップメニューによりウィンドウを閉じることが可能です。
逆アセンブリウィンドウのタブ上で右クリックすると、使用可能なオプションをポップアップメニューで表示します。
ポップアップメニューオプション

機能

閉じる

逆アセンブリウィンドウを閉じます。

4.4

検索とファイル内の移動

4.4.1

文字列を検索する

現在のファイルで文字列を検索するには
1.

内容を検索するウィンドウがアクティブウィンドウであることを確認してください。

2.

検索開始位置にカーソルを置いてください。

3.

以下のいずれかの操作を選択し[検索]ダイアログボックスを開きます。

•[検索]ツールバーボタン(•"Ctrl+F"キーを押す。

•[編集 -> 検索]を選択する。

•

エディタウィンドウのポップアップメニューから[検索]を選択する。

R20UT0372JJ0100 Rev.1.00
2011.02.01)をクリックする。

Page 102 of 479

High-performance Embedded Workshop V.4.09

4.

4.

エディタ

[検索文字列]に検索する文字列を入力するか、またはドロップダウンリストボックスから以前検索した文字列を選択してください。文字列を選択してから[検索]ダイアログボックスを開くと、その文字列を自動的に[検索文字列]に表示します。

5.

単語単位で検索する場合は、[単語単位で探す]チェックボックスをオンにしてください。このオプシ
ョンを選択しない場合は、一部でも一致する文字列を検索します。

6.

検索文字列の大文字と小文字を区別する場合は、[大文字、小文字を区別する]チェックボックスをオンにしてください。

7.

正規表現を使って文字列を検索する場合は、[正規表現]チェックボックスをオンにしてください。詳細は「リファレンス4. 正規表現」を参照してください。

8.

[検索する方向]ラジオボタンにより、検索する方向を指定できます。[下へ]を選択すると、カーソル位
置からファイルの下の方向に検索します。[上へ]を選択すると、カーソル位置から上の方向に検索します。

9.

[次を検索]ボタンをクリックすると検索を始めます。

また、複数のファイルで文字列を検索できます。

複数のファイルで文字列を検索する

4.4.2

複数のファイルで文字列を検索するには1.

以下のいずれかの操作を選択し[ファイルから検索]ダイアログボックスを開きます。

•[ファイルの中から検索]ツールバーボタン(•"F4"キーを押す。

•[編集 -> ファイルから検索]を選択する。

R20UT0372JJ0100 Rev.1.00
2011.02.01)をクリックする。

Page 103 of 479

High-performance Embedded Workshop V.4.09

2.

4.

エディタ

[検索文字列]に検索する文字列を入力するか、またはドロップダウンリストボックスから以前検索した文字列を選択してください。文字列を選択してから[ファイルから検索]ダイアログボックスを開くと、その文字列を自動的に[検索文字列]に表示します。

3.

[ファイルの種類]に検索するファイルの拡張子を指定してください。複数の拡張子を指定するときは、
セミコロンで区切ってください（例：*.c;*.h）。

4.

検索文字列の大文字と小文字を区別する場合は、[大文字、小文字を区別する]チェックボックスをオンにしてください。

5.

単語単位で検索する場合（一部でも一致する文字列ではありません）は、[単語単位で探す]チェックボックスをオンにしてください。
注： [単語単位で探す]と[正規表現]は同時にオンとするような検索機能はサポートしていません。

6.

正規表現を使って文字列を検索する場合は、[正規表現]チェックボックスをオンにしてください。詳細は「リファレンス4. 正規表現」を参照してください。

7.

アウトプットウィンドウの[Find in Files 1]タブではなく[Find in Files 2]タブに検索結果を表示する場合
は、['Find in Files 2' タブへ出力]チェックボックスをチェックしてください（アウトプットウィンドウで2つの異なった検索結果を得られます）。

8.

検索する場所の種類を選択してください。

•[ディレクトリ]
このオプションを選択すると、検索文字列を探すためにディレクトリ（ディレクトリ構成）を検索します。[サブディレクトリも探す]チェックボックスをオンにすると、指定ディレクトリのすべてのサブディレクトリを検索します。[ディレクトリ]で指定したディレクトリのみを検索する場合は、このチェックボックスがオフであることを確認してください。

•[アクティブプロジェクト]
このオプションを選択すると、ワークスペースのアクティブプロジェクトに登録されているファイル
を検索します。

•[すべての読み込み状態のプロジェクト]
このオプションを選択すると、ワークスペースのすべての読み込み状態のプロジェクトに登録されているファイルを検索します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 104 of 479

High-performance Embedded Workshop V.4.09

4.

エディタ

[アクティブプロジェクト]オプションおよび[すべての読み込み状態のプロジェクト]オプションは、プ
ロジェクト依存ファイル（インクルードファイル）を検索しないので注意してください。
9.

[検索]ボタンをクリックすると検索を始めます。検索結果はアウトプットウィンドウの[Find in Files 1]
タブまたは[Find in Files 2]タブに表示します。検索結果をダブルクリックすると、ファイルの該当文字列にジャンプします。実行中の[ファイル内から検索]操作を止めるには、[編集 -> ファイルから検索を中止]を選択します。ファイル内から検索操作が完了したらアウトプットウィンドウの文字列をダブ
ルクリックすると、ファイルの該当文字列にジャンプできます。

文字列を置換する

4.4.3

文字列の置換は前節で説明した文字列の検索に似ています。異なる点は、文字列検索後、他の文字列に置き換える点です。
ファイルの文字列を置換するには
1.

内容を置換するウィンドウがアクティブであることを確認してください。

2.

検索を始める位置にカーソルを置いてください。

3.

以下のいずれかの操作を選択し[置換]ダイアログボックスを開きます。

•"Ctrl+H"キーを押す。

•[編集 -> 置換]を選択する。

•

エディタウィンドウのポップアップメニューから[置換]を選択する。

4.

[置換文字列]に置換前の文字列を入力するか、またはドロップダウンリストボックスから以前検索した文字列を選択してください。文字列を選択してから[置換]ダイアログボックスを開くと、その文字列を自動的に[置換文字列]に表示します。

5.

[置換後の文字列]に置換後の文字列を入力するか、またはドロップダウンリストボックスから以前検索した文字列を選択してください。

6.

単語単位で検索する場合は、［単語単位で探す］チェックボックスをオンにしてください。このオプションを選択しない場合は、一部でも一致する文字列を検索します。

7.

置換文字列の大文字と小文字を区別する場合は、[大文字、小文字を区別する]チェックボックスをオンにしてください。

8.

正規表現を使って文字列を検索する場合は、[正規表現]チェックボックスをオンにしてください。詳細は「リファレンス4. 正規表現」を参照してください。

9.

[次を検索]をクリックすると、検索文字列、条件に合致したものの次を検索します。置換したい場合
は[置換]をクリックしてください。[すべてを置換]をクリックすると、該当するすべての文字列を置換

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 105 of 479

High-performance Embedded Workshop V.4.09

4.

エディタ

します。[キャンセル]をクリックすると、置換動作を停止します。なお、[置換]で[選択範囲のみ]を選択している場合は文字列の選択範囲が置換対象となり、[ファイル全体]を選択している場合はファイル全体が置換対象となります。[すべての開いているファイル]を選択している場合は、エディタで現在開いているファイルがすべて置換対象となります。

指定した行にジャンプする

4.4.4

ファイルの指定した行にジャンプするには
1.

ファイルがアクティブであることを確認してください。

2.

以下のいずれかの操作を選択し[ジャンプ]ダイアログボックスを開きます。

•"Ctrl+G"キーを押す。

•[編集 -> ジャンプ]を選択する。

•

エディタウィンドウのポップアップメニューから [ジャンプ]を選択する。

3.

指定する行番号を入力して、[OK]ボタンをクリックしてください。カーソルが指定した行の先頭に移ります。

ブックマーク

4.5

一度に多くの大容量のファイルを扱うとき、必要な行や領域を見つけるのが難しくなります。エディタでブッ
クマークをあらかじめ特定の行に設定しておくと、後でその行にジャンプできます。例えば、行数の多いC言語ファイルの各関数の定義位置にブックマークを設定すると便利です。ブックマークは、解除するまでか、設定したファイルを閉じるまで有効です。
ブックマークを設定するには
1.

ブックマークを設定する行にカーソルを置いてください。

2.

以下のいずれかの操作を選択してください。

•[ブックマークの挿入/削除]ツールバーボタン(•"Ctrl+F2"キーを押す。

•[編集 -> ブックマーク -> ブックマークの挿入/削除]を選択する。

•

ポップアップメニューから[ブックマーク -> ブックマークの挿入/削除]を選択する。

3.

その行にブックマークアイコン()をクリックする。

)を表示します。

ブックマークを解除するには
1.

ブックマークを解除する行にカーソルを置いてください。

2.

以下のいずれかの操作を選択してください。

•[ブックマークの挿入/削除]ツールバーボタン(•"Ctrl+F2"キーを押す。

R20UT0372JJ0100 Rev.1.00
2011.02.01)をクリックする。

Page 106 of 479

High-performance Embedded Workshop V.4.09

4.

•[編集 -> ブックマーク -> ブックマークの挿入/削除]を選択する。

•

ポップアップメニューから[ブックマーク -> ブックマークの挿入/削除]を選択する。

3.

その行からブックマークアイコンが削除されます。

エディタ

次のブックマークにジャンプするには1.

カーソルが検索するファイルの中にあることを確認してください。

2.

以下のいずれかの操作を選択してください。

•[次のブックマークへ]ツールバーボタン(•"F2"キーを押す。

•[編集 -> ブックマーク -> 次のブックマーク]を選択する。

•

ポップアップメニューから[ブックマーク -> 次のブックマーク]を選択する。

)をクリックする。

同じファイルの1つ前のブックマークに戻るには
1.

カーソルが検索するファイルの中にあることを確認してください。

2.

以下のいずれかの操作を選択してください。

•[前のブックマークへ]ツールバーボタン(•"Shift+F2"キーを押す。

•[編集 -> ブックマーク -> 前のブックマーク]を選択する。

•

ポップアップメニューから[ブックマーク -> 前のブックマーク]を選択する。

)をクリックする。

ファイル内のすべてのブックマークを解除するには
1.

すべてのブックマークを解除するファイルのウィンドウをアクティブにしてください。

2.

以下のいずれかの操作を選択してください。

•[すべてのブックマークの削除]ツールバーボタン(•[編集 -> ブックマーク -> すべてのブックマークの削除]を選択する。

•

ポップアップメニューから[ブックマーク -> すべてのブックマークの削除]を選択する。

)をクリックする。

ファイルを印刷する

4.6

ファイルを印刷するには1.

印刷するファイルのウィンドウをアクティブにしてください。

2.

以下のいずれかの操作を選択してください。

•[印刷]ツールバーボタン(•"Ctrl+P"キーを押す。

•[ファイル -> 印刷]を選択する。

4.7)をクリックする。

テキストのレイアウト

4.7.1

ページ設定

High-performance Embedded Workshopエディタからファイルを印刷するとき、印刷ダイアログボックスの設定
により、印刷方法が変わります（例えば、片面印刷、両面印刷など）。
また、[ページ設定]ダイアログボックスでは、印刷するテキストの余白（上下左右）を指定できます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 107 of 479

High-performance Embedded Workshop V.4.09

4.

エディタ

プリンタによっては、A4サイズの端まで印刷できない場合があるので、この指定が必要です。
また、用紙の左端にとじしろを残したい場合などにも便利です。
ページの余白を設定するには
1.

[ファイル -> ページレイアウトの設定]を選択してください。[ページ設定]ダイアログボックスが開きます。

2.

[左]、[右]、[上]、[下]フィールドに必要な余白を入力してください。

3.

[インチ]または[ミリメートル]ラジオボタンを選択してください。

4.

[OK]ボタンをクリックしてください。

ページのヘッダとフッタを設定するには
1. [ファイル -> ページレイアウトの設定]を選択してください。[ページ設定]ダイアログボックスが開きます。
2.

[ヘッダ]、[フッタ]フィールドに表示するテキストを入力してください。ページ番号、テキスト配置、
日付の各フィールドとともに通常のプレースホルダが利用できます。プレースホルダはページが印刷される前に実際の値に展開されます。

3.

[OK]ボタンをクリックしてください。

印刷の折り返しを設定するには
1.

[ファイル -> ページレイアウトの設定]を選択してください。[ページ設定]ダイアログボックスが開きます。

2.

[折り返し]チェックボックスをオンにしてください。折り返し機能が有効になり、テキストをすべて印刷します。

3.

[OK]ボタンをクリックしてください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 108 of 479

High-performance Embedded Workshop V.4.09

4.

エディタ

タブを変更する

4.7.2

タブの文字数を変更するには
1.

[基本設定 -> オプション]を選択してください。[オプション]ダイアログボックスが開きます。

2.

[エディタ]タブを選択してください。

3.

[タブ幅]に必要なタブの文字数を指定してください。

4.

[OK]ボタンをクリックしてください。

"Tab"キーを押すと、通常、タブ文字をファイルに入力します。しかし、タブ文字のかわりに空白文字列を入力したほうがよい場合があります。[オプション]ダイアログボックスの[エディタ]タブで、タブ文字を空白文字列として指定できます。
タブ文字の代わりに空白文字列を使用するには
1.

[基本設定 -> オプション]を選択してください。[オプション]ダイアログボックスが開きます。

2.

[エディタ]タブを選択してください。

3.

タブ文字の代わりに空白文字列を使用する場合は[空白をタブとして使用]チェックボックスをオンにしてください。

4.

[OK]ボタンをクリックしてください。

自動インデント

4.7.3

標準のエディタでEnterキーを押すと、カーソルは次の行の左端に移ります。自動インデントを設定すると、カーソルは、改行時、前行の最初の文字の下に移ります。したがって、自分でタブや空白を入力することなく、
C/C++言語またはアセンブリ言語のコードをより速く見やすく入力できます。
以下に2つの例を示します。(i)は自動インデントの設定をしなかったときにEnterキーを押した場合の例を示します。カーソルは次の行の左端に移ります。"int z=20"の行は、上の2行と揃っていません。(ii)は自動インデン
トを設定してEnterキーを押した場合の例を示します。カーソルは前行の"int"の"i"の下に移ります。したがって、"int z=20"行を入力すると、テキストは自動的に前の行と整列（自動インデント）します。

自動インデントを設定するには
1.

[基本設定 -> オプション]を選択してください。[オプション]ダイアログボックスが開きます。

2.

[エディタ]タブを選択してください。

3.

[自動インデント]チェックボックスをオンにしてください。このチェックボックスのデフォルトはオンです。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 109 of 479

High-performance Embedded Workshop V.4.09

4.

4.

エディタ

[OK]ボタンをクリックすると、自動インデントを設定します。

ウィンドウを分割する

4.8

High-performance Embedded Workshopでは、エディタウィンドウを2つに分割できます。以下に、エディタウィ
ンドウの右上にある"閉じる"ボタンのすぐ下にあるスプリットバーボタンを示します。

ウィンドウを分割するにはスプリットバーボタンをダブルクリックしてウィンドウを2つに分割するか、スプリットバーボタンを押したままマウスを下に移動して分割したい位置でマウスボタンを離してください。
スプリットバーの位置を調節するにはスプリットバーボタンを押したままマウスを下に移動して、分割したい位置でマウスボタンを離してください。
ウィンドウの分割を解除するにはスプリットバーボタンをダブルクリックするか、スプリットバーボタンをウィンドウの一番上か一番下に移動
してください。

エディタのフォントを変更する

4.9

High-performance Embedded Workshopではエディタのフォントを指定できます。ファイルの種類にかかわらず、
エディタウィンドウはすべて同じフォントを使用します。
エディタのフォントを変更するには
1.

[基本設定 -> 表示の形式]を選択してください。[表示形式]ダイアログボックスが開きます。

2.

ツリーの中の[Source]アイコンを選択してください。[表示形式]ダイアログボックスの右側の[フォント]タブが使用可能です。

3.

[フォント]リストからフォントの種類を選択してください。

4.

[サイズ]リストからフォントの大きさを選択してください。

5.

フォントを変更するとそのフォントがどう見えるか下にサンプルテキストを表示します。

6.

[OK]ボタンをクリックしてください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 110 of 479

High-performance Embedded Workshop V.4.09

4.10

4.

エディタ

シンタックスを色付けする

コードをより読みやすくするため、指定した文字列（キーワードなど）を異なる色で表示できます。例えば、
C ソースコードのコメントを緑色で、C 言語の型（int など）を青色で表示できます。
色付け方法は、ファイルグループ単位で指定できます。例えば、C source file、C header file、Assembly source file、
Assembly include fileでそれぞれ異なった色付け方法を定義できます。
注：
新規ファイルを作成すると、デフォルトではファイルの拡張子がないためシンタックスの色付けは行いません。（エディタが自動的に新規ファイルに付ける名前には拡張子がありません）。新規ファイルにシンタック
スの色付けをするには、上記の既存のファイルグループの拡張子を持つ名前でファイルを保存してください。
ファイル拡張子の情報については「2.5 ファイル拡張子とファイルグループ」を参照してください。

テキストの色を変更する

4.10.1

既存の色を変更するには
1.

[基本設定 -> 表示の形式]を選択してください。[表示形式]ダイアログボックスが開きます。

2.

色を変更したいアイテムを選択します。エディタの場合は、ダイアログボックスの左側のツリーにある"Source"を展開してください。

3.

シンタックスの色を編集したいファイルタイプを展開してください。

4.

対象となるキーワードグループを選択してください。ダイアログボックスの右側のタブは、選択した項目によって変わります。

5.

[カラー]タブを選択してください。

6.

[前面]リストと[背景]リストの色を選択してください。[SYSTEM]を選択するとコントロールパネルで現在設定してある文字色と背景色になります。

7.

[OK]ボタンをクリックしてください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 111 of 479

High-performance Embedded Workshop V.4.09

4.

エディタ

新規キーワードを作成する

4.10.2

新規のキーワードグループを作成するには
1.

[基本設定 -> 表示の形式]を選択してください。[表示形式]ダイアログボックスが開きます。エディタの場合は、ダイアログボックスの左側のツリーにある[Source]を展開してください。

2.

キーワードグループを追加したいファイルタイプをツリーから選択してください。

3.

ツリー下の[追加]ボタンをクリックすると[カテゴリ追加]ダイアログボックスが開きます。[カテゴリ名]にキーワードグループを入力し、[OK]ボタンをクリックすると新しいキーワードグループを追加します。キーワードグループ名を変更するには、キーワードグループを選択してツリー下の[変更]ボタ
ンをクリックしてください。[カテゴリの変更]ダイアログボックスが開きます。[カテゴリ名]にキーワ
ードグループを入力し、[OK]ボタンをクリックするとキーワードグループ名を変更します。キーワー
ドグループを削除するには、キーワードグループを選択してツリー下の[削除]ボタンをクリックしてください。

新規のキーワードを作成するには
1.

[基本設定 -> 表示の形式]を選択してください。[表示形式]ダイアログボックスが開きます。

2.

シンタックスの強調表示を変更したいアイテムを、ツリーの中のアイコンの下から選択してください。
このアイテムはファイルタイプ（例：C言語のソースファイル）および適切なキーワードグループ（例：識別子またはプリプロセッサ）となります。

3.

[キーワード]タブを選択してください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 112 of 479

High-performance Embedded Workshop V.4.09

4.

4.

エディタ

キーワードを追加するには[追加]ボタンをクリックしてください。[キーワード追加]ダイアログボック
スが開きます。[キーワード]にキーワードを指定し[OK]ボタンをクリックしてダイアログボックスを閉じてください。キーワードを削除するには、キーワードを選択して[削除]ボタンをクリックしてください。

注：[キーワード追加]ダイアログボックスの[キーワード]には半角英数字と半角下線、半角#のみ入力してください。特に、日本語文字やその他の文字を入力しないでください。

シンタックスの色付けを有効/無効にする

4.10.3

シンタックスの色付けを有効/無効にするには
1.

[基本設定 -> オプション]を選択してください。[オプション]ダイアログボックスが開きます。

2.

[エディタ]タブを選択してください。

3.

[シンタックスカラーリング]チェックボックスをオンにすると有効になり、チェックしないと無効になります。設定後、[OK]ボタンをクリックしてください。

4.11

テンプレートソフトウェア開発時、同じテキストを繰り返し入力する場合がよくあります。例えば、関数定義、ループ、関数の機能のコメント欄などです。High-performance Embedded Workshopでは、現在アクティブなエディタウィ
ンドウに、定型テキスト（テンプレート）を挿入できます。テンプレート設定後は、手作業で入力するかわりに定型テキストを簡単に挿入できるようになります。
テンプレート一覧を示します。この一覧はワークスペースウィンドウの[Templates]タブにあります。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 113 of 479

High-performance Embedded Workshop V.4.09

4.

エディタ

High-performance Embedded Workshopで追加した新しいテンプレートを[Templates]フォルダの下に表示します。
[Toolchain Templates]フォルダには、現在のツールチェインによってHigh-performance Embedded Workshopシス
テムで使用するために提供される読み取り専用のテンプレートを表示します。
この一覧にあるテンプレートはドラッグアンドドロップしてエディタファイルに挿入できます。さらに、エディタからテキスト領域を[Templates]フォルダにドラッグアンドドロップして、簡単にテンプレートを作成することも可能です。
[Templates]フォルダ上で右クリックすると、使用可能なオプションをポップアップメニューで表示します。
ポップアップメニューオプション

機能追加

新しいテンプレートを追加します。

編集

現在選択しているテンプレートを編集します。

削除

現在選択しているテンプレートを削除します。

テンプレートを設定する

4.11.1

テンプレートを設定するには
1.

以下のいずれかの操作を選択し[テンプレートの定義]ダイアログボックスを開きます。

•[テンプレートの定義]ツールバーボタン(•[編集 -> テンプレート -> テンプレートの定義]を選択する。

•

ワークスペースウィンドウの[Templates]タブの[Templates]フォルダ上で右クリックし、ポップアップメ)をクリックする。

ニューから[編集]を選択する。
•

エディタウィンドウ内で右クリックし、ポップアップメニューから[テンプレート -> テンプレートの定義]を選択する。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 114 of 479

High-performance Embedded Workshop V.4.09

2.

4.

エディタ

[追加]ボタンをクリックしてください。[テンプレートの追加]ダイアログボックスが表示され、選択したテンプレート名を尋ねます。この場合、独自のテンプレート名を選択してください。複製したテン
プレート名のメッセージが表示され、テンプレートは追加されません。

3.

既存のテンプレートを変更したいときは、[テンプレート名]ドロップダウンメニューから変更するテンプレートを選択してください。

4.

テンプレートテキストエリアにテキストを入力してください。他のエディタウィンドウからテキストをコピーし、"Ctrl+V"キーを押してこのダイアログボックスに貼り付けることができます。

5.

テンプレートを設定するとき、次のプレースホルダを使うことができます。
メニューエントリ

プレースホルダ

説明

ファイルパス+ファイル名$(FULLFILE)

ファイル名（絶対パスを含む）

ファイル名$(FILENAME)

ファイル名（パスを除き拡張子を含む）

ファイルリーフ$(FILELEAF)

ファイル名（パスと拡張子を除く）

ワークスペース名$(WORKSPNAME)

ワークスペース名

プロジェクト名$(PROJECTNAME)

プロジェクト名

行番号$(LINE)

テンプレートを挿入する最初の行番号

時間$(TIME)

テンプレートが挿入される時間

日付, テキスト$(DATE_TEXT)

現在の年月日をテキスト表示

日付, 日/月/年$(DATE_DMY)

現在の日/月/年

日付, 月/日/年$(DATE_MDY)

現在の月/日/年

日付, 年/月/日$(DATE_YMD)

現在の年/月/日

ユーザ名$(USER)

現在のユーザ

カーソル位置$(CURSOR)

挿入カーソル：テンプレートを挿入した後カーソルをこの
位置に設定

6.

'$(CURSOR)' を入力すると、テンプレートが挿入された後のカーソルはこの位置になります。
'$(CURSOR)'を設定しないと、テンプレートが挿入された後のカーソルはテンプレート最後の文字の後ろになります（通常の貼り付け操作と同じ）。

7.

テンプレート用に確保されているショートカットキーは10個あります。ショートカットキーを使用する場合、[テンプレートの編集]ダイアログボックス下部にあるドロップダウンリストで選択してください。"Ctrl+0"〜"Ctrl+9"の中から選択できます。

ユーザ入力
テンプレートを定義する際、ユーザ入力フィールドも定義できます。以下のプレースホルダを使って指定します。
$(USERINPUT<n:1-10>|"<some text>")'n'はユーザ入力識別子を表す数字です。これらのプレースホルダは手動で追加することも可能ですが、[テンプレートの定義]ダイアログボックスの[ユーザ入力]ボタンを使うとプレースホルダを自動的に追加できます。テンプレートをファイルに挿入するとダイアログボックスが表示され、ユーザは各フィールドにカスタムのテキストを入力できます。その後、このテキストをプレースホルダの替わりに挿入します。ユーザはこのようなユーザ入力フィールドを 10個定義できます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 115 of 479

High-performance Embedded Workshop V.4.09

4.

エディタ

テンプレートを削除する

4.11.2

テンプレートを削除するには1.

以下のいずれかの操作を選択し[テンプレートの定義]ダイアログボックスを開きます。

•[テンプレートの定義]ツールバーボタン(•[編集 -> テンプレート->テンプレートの定義]を選択する。

•

ワークスペースウィンドウの[Templates]タブの[Templates]フォルダ上で右クリックし、ポップアップメ)をクリックする。

ニューから[編集]を選択する。
•

エディタウィンドウ内で右クリックし、ポップアップメニューから[テンプレート -> テンプレートの定義]を選択する。

2.

[テンプレート名]ドロップダウンリストから削除したいテンプレート名を選択し、[削除]ボタンをクリックしてください。

3.

確認ダイアログボックスが表示された場合は、[はい]ボタンをクリックしてください。

4.

[OK]ボタンをクリックしてください。

テンプレートを削除するには、他にも方法があります。これを以下に説明します。
ワークスペースウィンドウの[Templates]タブで選択したテンプレートを削除するには
1.

ワークスペースウィンドウの[Projects]タブで削除したいファイルを選択してください。複数のテンプ
レートを選択するときは"Shift"キーまたは"Ctrl"キーを押してください。

2.

ワークスペースウィンドウの[Templates]タブの[Templates]フォルダ上で右クリックし、ポップアップメ
ニューから[削除]を選択する。

テンプレートを挿入する

4.11.3

テンプレートを挿入するには1.

以下のいずれかの操作を選択し[テンプレートの定義]ダイアログボックスを開きます。

•

ツールバーでテンプレートを選択し[テンプレートの挿入]ツールバーボタン(•[編集->テンプレート -> テンプレートの挿入]を選択する。

•

エディタウィンドウ内で右クリックし、ポップアップメニューから[テンプレート -> テンプレートの)をクリックする。

挿入]を選択する。
2.

[テンプレート名]ドロップダウンリストで挿入するテンプレートを選択し、OKボタンをクリックします。選択したテンプレートが現在のエディタウィンドウに追加されます。

"Alt"キーとテンプレート番号を押すことでテンプレートを挿入する方法もあります(例えばテンプレート4を挿入するには"Alt+4")。これらのショートカットは[テンプレートの定義]ダイアログボックスで定義できます。
ダイアログボックスの下部のドロップダウンリストで選択可能です。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 116 of 479

High-performance Embedded Workshop V.4.09

4.12

4.

エディタ

括弧の組み合わせ複雑なソースコードは扱いにくいことがあります。特に、C言語のブロックが互いに深いネスト構造になっている場合や、if文で複雑な論理文が表現されている場合などです。High-performance Embedded Workshopでは、
そのような場合のために、括弧の種類 { }, ( ) , [ ]ごとに括弧の間のテキストを強調表示できます。
括弧の組み合わせを見つけるには
1.

括弧の始めを強調表示するか、カーソルを括弧の前に置いてください。

2.

以下のいずれかの操作を選択してください。

•[括弧の呼応]ツールバーボタン(•"Ctrl+Shift+M"キーを押す。

•[編集 -> 括弧の呼応]を選択する。

•

ポップアップメニューから[括弧の呼応]を選択する。

)をクリックする。

ファイル全体の構造をチェックするために、カーソルをファイルの始めに置いて、括弧の組み合わせの操作を繰り返し行ってください。組み合わせがなくなるまで、括弧の組み合わせごとに次々と強調表示します。

4.13

ファイルを読み取り専用属性にする

High-performance Embedded Workshopではファイルを読み取り専用属性にできます。読み取り専用属性のファイルを保存するときは、別名で保存するかどうかを確認するダイアログボックスが開きます。
ファイルを読み取り専用属性にするには1.

以下のいずれかの操作を選択してください。

•

ワークスペースウィンドウの[Projects]タブで、ファイルを右クリックしポップアップメニューを表示
してください。複数のファイルを選択できます。

•

エディタウィンドウを右クリックしポップアップメニューを表示してください。

2.

[プロパティ]を選択すると[プロパティ]ダイアログボックスが開きます。

3.

[読み取り専用]チェックボックスをオンにしてください。複数のファイルを選択し、読み取り専用および書き込み可能なファイルが混在する場合は、チェックボックスはグレー（中間状態）です。チェックボックスのデフォルトはオフです。

4.

エディタウィンドウのタイトルバーに「読み取り専用」を表示します。（例： filename.c - 読み取り専用）

注：
エディタウィンドウでファイルを開いている状態で、Windows® Explorerからそのファイルの読み取り専用属性のオンオフを切り替えた場合、エディタウィンドウのタイトルバーの表示内容は、更新されないためファイルの属性と一致しません。編集するか、ファイルを閉じてから再度開くまでエディタウィンドウのタイトルバーの表示内容を更新しません。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 117 of 479

High-performance Embedded Workshop V.4.09

4.14

4.

エディタ

デバッグ時にファイルの編集を抑止する

デバッグ時にファイルの編集を抑止したい場合があります。
High-performance Embedded Workshopではデバッガに接続しデバッグしている時にファイルの編集を抑止する機能があります。編集を抑止するファイルはHigh-performance Embedded Workshopエディタで開いているすべてのファイルです。
デバッグ時にファイルの編集を抑止するには
1.

[基本設定->オプション]を選択し、[オプション]ダイアログボックスを開きます。

2.

[エディタ]タブを選択します。

3.

[ターゲット接続中はファイルの編集を許可しない]チェックボックスをオンにすると、デバッガに接続している時に、ファイルの編集を抑止できます。デバッガに接続していないときはファイルの編集は可能です。このチェックボックスのデフォルトはオフです。

4.

4.15

[OK]ボタンをクリックします。

エディタカラムの管理

エディタのカラムは、デバッガの機能に応じて追加されます。また、カラムの表示、非表示を選択できます。
すべてのHigh-performance Embedded Workshopエディタでカラムをオフにするには1.

以下のいずれかの操作を選択し[エディタ全体のカラム状態]ダイアログボックスを開きます。

•[編集 -> 表示カラムの設定]を選択します。

•

エディタウィンドウ内で右クリックし、ポップアップメニューから[表示カラムの設定]を選択する。

2.

チェックボックスは、そのカラムが有効か無効かを示します。チェックしている場合は有効です。チェックボックスがグレー表示の場合、一部のエディタではカラムが有効で、別のエディタでは無効であることを意味します。

3.

[OK]ボタンをクリックしてください。

1つのHigh-performance Embedded Workshopエディタでカラムをオフにするには
1.

削除したいカラムのあるエディタウィンドウを開きます。

2.

以下のいずれかの操作を選択してください。

•

High-performance Embedded Workshopエディタのヘッダ内で右クリックするとポップアップメニューが表示されます。カラムが利用できる場合は、エントリの横にはチェックマークがあります。エント
リをクリックすると、カラムの表示、非表示を切り替えます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 118 of 479

High-performance Embedded Workshop V.4.09

•

4.

エディタ

エディタウィンドウ内で右クリックし[カラム]を選択します。カスケードされたメニューオプション
を表示します。各カラムがこのポップアップメニューに表示されます。カラムが有効である場合、名前の横にチェックマークがあります。エントリをクリックすると、カラムの表示、非表示を切り替えます。

High-performance Embedded Workshopエディタのヘッダが表示されている場合は、カラムの幅をマウスのドラッグにより調節できます。

4.16

カラムのヘッダの表示/非表示を切り替える

エディタウィンドウはカラムのヘッダがあります。カラムのヘッダ自体の表示、非表示の切り替えが可能です。
カラムのヘッダの表示、非表示を切り替えるには
1.

エディタウィンドウでソースコードまたは逆アセンブリを表示している領域内を右クリックしてくだ
さい。

2.

4.17

表示されるポップアップメニューから[カラムヘッダの表示/非表示]を選択してください。

エディタ内からファイルを開く

エディタウィンドウに表示しているファイル名を元にそのファイルをエディタウィンドウで開くことができます。
エディタウィンドウに表示されているファイルを開くには
1.

エディタウィンドウの[ソース]領域で表示したいファイル名の上を右クリックしてください。

2.

ポップアップメニューから[開く 'ファイル名']を選択してください。

4.18

ツールチップウォッチ

プログラムに定義された変数の値を参照するための機能です。値を参照したい変数を含むプログラムをエディ
タウィンドウまたは逆アセンブリウィンドウ（ソースモード）に表示し、変数名の上にマウスカーソルを置くと、ツールチップとしてポップアップウィンドウにウォッチ情報を表示します。
ツールチップウォッチ機能を使用するには
1.

[基本設定 -> オプション]を選択してください。[オプション]ダイアログボックスを開きます。

2.

[エディタ]タブを選択してください。

3.

[ツールチップウォッチ]チェックボックスをオンにしてください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 119 of 479

High-performance Embedded Workshop V.4.09

4.

4.

エディタ

[OK]ボタンをクリックしてください。

エディタウィンドウまたは逆アセンブリウィンドウ（ソースモード）にツールチップウォッチを表示するには1.

参照したい変数を表示しているエディタウィンドウまたは逆アセンブリウィンドウ（ソースモード）を開きます。

2.

参照したい変数名の上にマウスカーソルを置きます。ツールチップとしてポップアップウィンドウに変数のウォッチ情報を表示します。

式の評価

4.19

[式の評価]ダイアログボックスを開きます。例えば、205*2のような数式を入力して、その結果をデバッガが現
在サポートしているすべての基数で表示します。
式評価するには1.

[編集 -> 式の評価]を選択してください。[式の評価]ダイアログボックスが開きます。

2.

式を入力後、[評価]ボタンをクリックしてください。

簡単な式、そして括弧、基数とシンボルを持つ複雑な式を評価できます。
すべての演算子は同じ優先順位を持っていますが、括弧は評価の順序を変更できます。演算子はC/C++と同じ意味を持っています。式もまた数値が要求されるコマンドで使うことができます。結果は現在サポートしているすべての基数で表示します。
有効な演算子:加算 (+)

減算 (-)

乗算 (*)

除算 (/)

論理 AND (&&) *論理 OR (||) *論理 NOT (!) *等しい (==)

ビットごとの AND (&)

ビットごとの OR (|)

ビットごとの NOT (~)

等しくない (!=)

左算術シフト (<<)

右算術シフト (>>)

より小さい (<)

より大きい (>)

剰余 (%) *ビットごとの排他的 OR (^)

以下 (<=)

以上 (>=)

注：*. 機能のサポートはデバッガに依存します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 120 of 479

High-performance Embedded Workshop V.4.09

4.

エディタ

レジスタ名:
値を入力するときにレジスタ値を使用できます。"#PC"または"%PC"のように、レジスタ名のプレフィックスに"#"記号または"%"記号を付けます。サポートするプレフィックスはデバッガに依存します。
文字定数:
文字定数として、シングルクォーテーション(')で囲まれた文字が使用できます。例えば、'A'等です。これらは、ASCIIコードに変換され、1バイトの即値として使用されます。
文字列リテラル:
文字列リテラルとして、ダブルクォーテーション(")で囲まれた文字列が使用できます。例えば、"abc"等です。
注：
機能のサポートはデバッガに依存します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 121 of 479

High-performance Embedded Workshop V.4.09

5.

5.

ツール管理

ツール管理

[ツールアドミニストレーション]ダイアログボックスで、High-performance Embedded Workshopで使うツールを管理します。
このダイアログボックスは[ツール -> アドミニストレーション]で開きます。すべてのワークスペースが閉じているときは変更可能で、ワークスペースが開いているときは参照のみ可能です。

High-performance Embedded Workshopには5種類の標準ツールがあります。
[Toolchains]

一連のビルドフェーズ（例:コンパイラ、アセンブラ、リンケージエディタ、ライブラリアン）。ビルド機能を実現します。

[System Tools][ツール]メニューからを選択することのできるアプリケーションです（.EXE）。
ツールチェインをサポートする追加のアプリケーションです（例: ライブラリアン
インタフェース）。

[Utility Phases]

特定のビルド機能をサポートする、あらかじめ用意されたビルドフェーズです（例:ソースコードの複雑度解析、ソースコードの行カウントなど）。特定のツールチ
ェインに依存しない追加のビルド機能です。

[Debugger Components]

特定のデバッグ機能をサポートするツールです（例: CPU DLL、デバッガ、オブジェクトリーダなど）。

[Extension Components]

High-performance Embedded Workshopシステムのある領域における特定のキー機
能をサポートするツールです。これらのツールはインストールすると、必ず登録します（例: RTOS Debug Interface、フラッシュサポートなど）。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 122 of 479

High-performance Embedded Workshop V.4.09

5.1

5.

ツール管理

ツールの位置High-performance Embedded Workshopでは、新しいツールがインストールされるたびにHigh-performance
Embedded Workshopとの連動に必要なツールの位置を自動的に保持します。インストール後、High-performance
Embedded Workshopはそのツールに関する情報（位置を含む）を保持します。これを登録と呼びます。初期登録は自動で行いますが、開発の途中で、プロジェクトのツールをより効率良く利用するためにツールを登録することが必要になることがあります。

5.2

High-performance Embedded Workshop登録ファイル

High-performance Embedded Workshopと互換性のあるツール（ツールチェイン、システムツール、またはユーティリティフェーズ）をインストールすると、拡張子.HRFのファイルもインストールします（以下の図を参照）。.HRFファイルにはHigh-performance Embedded Workshopへの登録に必要な情報を記述しています。

登録するには、そのツールの.HRFファイルを[ツールアドミニストレーション]ダイアログボックスにロードします（以下の図を参照）。

High-performance Embedded Workshopでツールを使うには、まず登録が必要です。[ツールアドミニストレーシ
ョン]ダイアログボックスは現在登録されているツールを表示します。このダイアログボックスを開くには、
ワークスペースがすべて閉じていることを確認して[ツール -> アドミニストレーション]を選択してください。ワークスペースを開いた状態で[ツールアドミニストレーション]ダイアログボックスをアクセスすると、ダイアログが開きますが変更はできません。High-performance Embedded Workshopがデフォルトでインストー
R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 123 of 479

High-performance Embedded Workshop V.4.09

5.

ツール管理

ルされると、新しいツールを自動的に登録します。
High-performance Embedded Workshopはツールデータベースファイルに、ツール情報を格納します。デフォル
トでは、このファイルをHigh-performance Embedded Workshopアプリケーションディレクトリに作成します。
しかし、ネットワーク環境で作業を行っている場合は、このディレクトリは他の場所に設定されることがあります。ツールディレクトリの場所は変更が可能です。
ツールの場所を変更するには
1.

[ツール -> アドミニストレーション]を選択してください。

2.

[HEWツールの場所]の[変更]ボタンをクリックしてください。

3.

新しいツールがあるディレクトリのルートディレクトリを選択し、[OK]ボタンをクリックしてください。

4.

ディレクトリが切り替わり、ツールの場所が新しいディレクトリに移ります。この場所にある新しいツールはスキャンする必要があります。スキャンには、[ディスク内検索]ボタンまたは[登録]ボタンを使用します。

ツールを登録する

5.3

High-performance Embedded Workshopは起動後、インストールしたすべてのツールを自動的に登録します。しかし、場合によってはツールを手動で登録する必要があります。
ドライブ内を検索しHigh-performance Embedded Workshopに互換性のあるツールを見つけることができます。
High-performance Embedded Workshopのツールインストール情報が削除または破壊されたときに再びツール情報を作成する場合に有用です。
ツールを検索して登録するには1.

[ツールアドミニストレーション]ダイアログボックスの[ディスク内検索]ボタンをクリックすると、[コンポーネントのディスク内検索]ダイアログボックスが開きます。

2.

[どのディレクトリを検索するか選択してください]に、検索するディレクトリを入力してください。
または、[参照]ボタンをクリックしディレクトリを選択してください。

3.

[サブフォルダを含む]チェックボックスをオンにすると、指定したディレクトリとその下のディレク
トリをすべて検索します。

4.

[開始]ボタンをクリックすると検索を始めます。検索中、[開始]ボタンは[中断]ボタンに変わります。
検索を途中で止めるには[中断]ボタンをクリックしてください。

5.

[コンポーネント]リストに検索結果を表示します。個別にツールを登録するにはそのツールを選択し[登録]ボタンをクリックしてください。すべてのツールを登録するには[すべてを登録]ボタンをクリッ
クしてください。

6.

[閉じる]ボタンをクリックしてください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 124 of 479

High-performance Embedded Workshop V.4.09

5.

ツール管理

ツールを1つ登録するには
1.

[登録]ボタンをクリックすると標準のファイルを開くダイアログボックスが開きます。フィルタが[HEW Registration Files (*.hrf)]に設定されています。

2.

登録するファイルの.HRFファイルを選択し、[選択]ボタンをクリックしてください。

3.

選択したツールに関する情報を示すダイアログボックスが開きます。ツールを登録するには[登録]ボタンをクリックしてください。登録しない場合は[閉じる]ボタンをクリックしてください。

High-performance Embedded Workshop登録ファイルはツールがインストールされたルートディレクトリにあり
ます。

5.4

ツールの登録を取り消す

新しいプロジェクト作成時に、登録された互換性のあるすべてのシステムツールがツールメニューに追加されます。ときにはユーザにとっては、これによって効率が下がり、使いにくいかもしれません。そのようなとき
は、登録を取り消すことができます。[ツールアドミニストレーション]ダイアログボックスでツールを選択し[登録解除]ボタンをクリックしてください。確認のダイアログボックスが開きます。登録を取り消す場合は[はい]をクリックしてください。
注：
ツールの登録を取り消しても、ハードディスクからツールがなくなることはありません。単に、High-performance Embedded Workshopに格納されているそのツールに関する情報を削除するだけです（High-performance Embedded Workshopから切断します）。この動作はいつでも元に戻すことができ、ツールを再登録できます（「5.3 ツールを登録する」参照）。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 125 of 479

High-performance Embedded Workshop V.4.09

5.5

5.

ツール管理

ツールのプロパティの参照と編集ツールに関する情報を参照するには、ツールを[登録済みコンポーネント]リストから選択し[プロパティ]ボタ
ンをクリックしてください。
[一般]タブでは名前、バージョン、位置を示します。

ツールについての情報を参照するには[情報]タブをクリックしてください。例えば、著作権、履歴などを表示します。

ツールの互換性に問題がある場合、この[情報]エディットフィールドで問題を報告することがあります。
ツールの環境設定を参照、編集するには[環境]タブを選択してください。このタブは、ツールチェインの環境を変更するときに最も一般的に使用します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 126 of 479

High-performance Embedded Workshop V.4.09

5.

ツール管理

新しい環境変数を追加するには
1.

[追加]ボタンをクリックしてください。[環境変数]ダイアログボックスが開きます。

2.

[変数]に変数名を入力してください。

3.

[値]に変数の値を入力してください。

4.

[OK]ボタンをクリックすると、[環境]タブに新しい変数が加わります。

環境変数を変更するには
1.

[環境]タブで変更する環境変数を選択してください。

2.

[変更]ボタンをクリックしてください。[環境変数]ダイアログボックスが開きます。

3.

[変数]と[値]を必要に応じて変更してください。

4.

[OK]ボタンをクリックすると、環境変数を変更します。

環境変数を削除するには
1.

[環境]タブから削除する環境変数を選択してください。

2.

[削除]ボタンをクリックしてください。

注：
環境変数の値を柔軟に指定できるようにするため、プレースホルダポップアップメニューがあります。プレー
スホルダの詳細は、「リファレンス 5. プレースホルダ」を参照してください。

5.6

テクニカルサポートについて[ツールアドミニストレーション]ダイアログボックスでは、システムツールに関する情報を表示できます。これらのツールはHigh-performance Embedded Workshopの一部であり、手動で登録または登録取り消しできません。[ツールアドミニストレーション]ダイアログボックスの[すべてのコンポーネントを表示]チェックボック
R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 127 of 479

High-performance Embedded Workshop V.4.09

5.

ツール管理

スをオンにすると、隠れていたコンポーネントフォルダを表示します（下の図を参照）。

テクニカルサポートを受ける際、ツールに関する詳細をお尋ねすることがあります。その場合、そのツールのフォルダを開き、ツールを選択し、[プロパティ] ボタンをクリックしてください。ここで表示されるダイアロ
グボックスはこの章の前半で説明したものと同じように動作します。ただし、[環境]タブはありません。
High-performance Embedded Workshopにはまた、登録されたツールに関する情報をファイルに出力する機能があるので、High-performance Embedded Workshopシステム全体の情報を得ることができます。もしHigh-performance Embedded Workshopで問題がありましたら、テクニカルサポート担当宛にこの情報を送付してください。
ツール情報を出力するには1.

[ツール -> アドミニストレーション]を選択してください。

2.

[ツール情報]ボタンをクリックすると、[ツール情報ファイルの保存]ダイアログボックスが開きます。

3.

ファイルの場所を選択し、[保存]ボタンをクリックしてください。

4.

High-performance Embedded Workshopに現在登録されているツールの情報をファイル出力します。

また、問題のあるコンポーネントは、[ツールアドミニストレーション]ダイアログボックスで確認できます。
1つは登録済みコンポーネントが見つからない場合で、次のアイコンを表示します。

[Component not found]アイコン
もう1つは、コンポーネントは見つかったが、古いバージョンであったり他の依存するコンポーネントが使用不可であったりして使用できない場合で、次のアイコンを表示します。

[Incompatible component found]アイコン
R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 128 of 479

High-performance Embedded Workshop V.4.09

5.

ツール管理

注：
ツールにいずれかのエラーがある場合、以下の方法でさらに情報を得ることができます。
ツールエラーのフィードバックを取得するには
1.

[ツール -> アドミニストレーション]を選択してください。

2.

問題のあるツールをリストから選択してください。

3.

[プロパティ]ボタンをクリックしてください。

4.

[情報]タブを選択し、エディットフィールドを下までスクロールしてください。この領域に問題の原因を表示します。

オンデマンドのコンポーネント

5.7

High-performance Embedded Workshopバージョン3.0以降にはオンデマンドのコンポーネントという概念があります。これらのコンポーネントはアプリケーションやデバッガコンポーネントが自動的にロードするわけではありません。プロジェクトを生成する過程でユーザがロードするものです。
オンデマンドのコンポーネントをロードまたはアンロードするには1.

[プロジェクト -> コンポーネントギャラリ]を選択してください。[コンポーネントギャラリ]ダイアロ
グボックスが開きます。

2.

ロードしたいコンポーネントを選択して[ロード]ボタンをクリックしてください。コンポーネントのイメージはロードされた状態に変わります。

3.

コンポーネントをアンロードしたい場合は、コンポーネントを選択して[アンロード]ボタンをクリッ
クしてください。コンポーネントのイメージはアンロードの状態に変わります。

4.

[OK]ボタンをクリックし、変更を確認してください。

注：
ユーザのワークスペースにある各プロジェクトには、ロード／アンロードされた異なるコンポーネントを格納できます。複数のプロジェクトがある場合は、[Multiple projects]および[All projects]を使うことで、複数のプロジェクトにわたってコンポーネントのロード状態を変更できます。コンポーネントがあるプロジェクトでロードされ、他のプロジェクトではロードされない状態をユーザが選択した場合は、[中間状態]アイコンを表示します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 129 of 479

High-performance Embedded Workshop V.4.09

5.8

5.

ツール管理

カスタムプロジェクトタイプ

High-performance Embedded Workshopの[プロジェクト -> プロジェクトタイプの作成]メニューで、現在のプロ
ジェクトの設定を利用してプロジェクトのテンプレートを作成できます。このテンプレートをカスタムプロジ
ェクトジェネレータと呼びます。新しいプロジェクトタイプの名称とプロジェクト生成ウィザードのスタイルを指定できます。作成したカスタムプロジェクトジェネレータは、[ツールアドミニストレーション]ダイアロ
グボックスで表示できます。カスタムプロジェクトジェネレータを他のユーザが使用するには、[ツールアド
ミニストレーション]ダイアログボックスで該当するカスタムプロジェクトジェネレータを選択して、[エクスポート]ボタンをクリックしてください。カスタムプロジェクトジェネレータの実行環境がインストール可能な実行ファイルにまとまります。このファイルを目的とする他のマシンで実行すると、カスタムプロジェクト
ジェネレータをインストールします。
一度カスタムプロジェクトタイプを作成すると、その後[新規プロジェクトワークスペース]ダイアログボック
スに表示します。これを使用してプロジェクトの複製を作成できます。
複製したプロジェクトをHigh-performance Embedded Workshopシステムからエクスポートし、そのプロジェクトを使用する他のユーザに渡すことができます。
注：[プロジェクト -> プロジェクトタイプの作成]により使用中のプロジェクトをもとにしたプロジェクトのテン
プレートを作成できます。このテンプレートにはツールチェインのバージョン情報も含まれます。ご使用のHigh-performance Embedded Workshopシステムでツールチェインをバージョンアップした後に、このテンプレートを使ってプロジェクトを作成した場合、作成したプロジェクトのツールチェインバージョンが使用環境と一致しているかご確認ください。アップデート可能なツールチェインが登録されている場合、[ツール -> ツー
ルチェインバージョンを変更]により表示する[ツールチェインのバージョンの変更]ダイアログボックスでツールチェインバージョンを変更できます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 130 of 479

High-performance Embedded Workshop V.4.09

6.

環境のカスタマイズ

6.1

ツールバーのカスタマイズ

6.

環境のカスタマイズ

High-performance Embedded Workshopではツールバーを標準で提供します。また、[カスタマイズ]ダイアログボ
ックスを使用して、新しいツールバーを作成できます。

新しいツールバーを作成するには
1.

[基本設定 -> カスタマイズ]を選択してください。[カスタマイズ]ダイアログボックスが開きます。

2.

[ツールバー]タブを選択してください。

3.

[新規]ボタンをクリックしてください。[新規ツールバー]ダイアログボックスが開きます。

4.

[ツールバー名]に新しいツールバー名を入力してください。

5.

[OK]ボタンをクリックすると新しいツールバーを作成します。

作成した新しいツールバーにはボタンがなく、位置を固定せずに表示します。
ツールバーにボタンを追加するには
1.

[基本設定 -> カスタマイズ]を選択してください。[カスタマイズ]ダイアログボックスが開きます。

2.

[コマンド]タブを選択してください。

3.

[カテゴリ]リストからボタンのカテゴリを選択し、使用できるボタンを参照してください。[ボタン]エリアからボタンを選択するとそのボタンの機能を表示します。

4.

ボタンをクリックしてダイアログボックスからツールバーにドラッグしてください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 131 of 479

High-performance Embedded Workshop V.4.09

6.

環境のカスタマイズ

ツールバーからボタンを削除するには
1.

[基本設定 -> カスタマイズ]を選択してください。[カスタマイズ]ダイアログボックスが開きます。

2.

[コマンド]タブを選択してください。

3.

ボタンをツールバーから[ボタン]エリアへドラッグしてください。

ユーザが定義したツールバー名を変えるには1.

[基本設定 -> カスタマイズ]を選択してください。[カスタマイズ]ダイアログボックスが開きます。

2.

[ツールバー]タブを選択してください。

3.

[ツールバー]リストでユーザが定義したツールバーで名前を変更したいものを選択してください。

4.

[ツールバー名]でツールバー名を変更してください。

5.

[OK]ボタンをクリック新しいツールバー名を保存します。

ユーザ定義のツールバーを削除するには
1.

[基本設定 -> カスタマイズ]を選択してください。[カスタマイズ]ダイアログボックスが開きます。

2.

[ツールバー]タブを選択してください。

3.

[ツールバー]リストからユーザ定義のツールバーを選択すると、[リセット]ボタンが[削除]ボタンに変化します。[削除]ボタンをクリックしてください。

標準のツールバーを初期状態に戻すには
1.

[基本設定 -> カスタマイズ]を選択してください。[カスタマイズ]ダイアログボックスが開きます。

2.

[ツールバー]タブを選択してください。

3.

[ツールバー]リストから標準のツールバーを選択し[リセット]ボタンをクリックしてください。

ツールバーの配置を初期状態に戻すには
1.

[基本設定 -> カスタマイズ]を選択してください。[カスタマイズ]ダイアログボックスが開きます。

2.

[ツールバー]タブを選択してください。

3.

[配置のリセット]ボタンをクリックしてください。

すべてのツールバーをデフォルト位置に戻します。
セッション中に設定した配置は、すべてリセットされるので注意してください。
R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 132 of 479

High-performance Embedded Workshop V.4.09

6.

環境のカスタマイズ

ツールバーのツールチップを表示/非表示するには
1.

[基本設定 -> カスタマイズ]を選択してください。[カスタマイズ]ダイアログボックスが開きます。

2.

[ツールバー]タブを選択してください。

3.

[ツールチップ表示]チェックボックスをオンにすると表示、チェックしないと非表示になります。

ツールメニューのカスタマイズ

6.2

ツールメニューをカスタマイズして新しいメニューオプションを含めることができます。
新しいメニューオプションを追加するには
1.

[基本設定 -> カスタマイズ]を選択してください。[カスタマイズ]ダイアログボックスが開きます。

2.

[メニュー]タブを選択してください。最初に、全ワークスペースに適用できるグローバルアプリケー
ションワイドツールを追加する（[アプリケーション内有効:]に追加）か、または現在のワークスペー
スのみに適用できるワークスペースワイドツールを追加する（[ワークスペース内有効:]に追加）かど
うかを決めてください。一度決定したら、ダイアログボックスの該当部分を選択するようにしてください。

3.

[追加]ボタンをクリックしてください。[ツールの追加]ダイアログボックスが開きます。

4.

[名前]にツール名を入力してください。

5.

[コマンド]にコマンドを入力してください。ただし、コマンドに渡す引数は入力しないでください。

6.

[引数]にコマンドに渡す引数を入力してください。

7.

[初期ディレクトリ]にツールを実行する初期ディレクトリを入力してください。

8.

[OK]ボタンをクリックするとメニューオプションを[ツール]メニューに追加します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 133 of 479

High-performance Embedded Workshop V.4.09

6.

環境のカスタマイズ

新しいメニューオプションをリストの最後に追加します（ツールメニューの一番下）。
メニューオプションを変更するには
1.

[基本設定 -> カスタマイズ]を選択してください。[カスタマイズ]ダイアログボックスが開きます。

2.

[メニュー]タブを選択してください。

3.

変更するメニューオプションを選択し[変更]ボタンをクリックしてください。

4.

[ツールの変更]ダイアログボックスを変更後、[OK]ボタンをクリックしてください。

メニューオプションを削除するには
1.

[基本設定 -> カスタマイズ]を選択してください。[カスタマイズ]ダイアログボックスが開きます。

2.

[メニュー]タブを選択してください。

3.

削除するメニューオプションを選択し[削除]ボタンをクリックしてください。

追加したツールは、[システムツール]ツールバーから利用できます。各ツール用にツールバーボタンがあります。ツールバーボタンをクリックすると、ツールメニューから選択したときと同様にツールを起動します。EXE
コマンドツールの場合、ボタンのイメージはEXE用のWindows® のアイコンと同じです。このイメージが利用できない場合は、デフォルトイメージ(

R20UT0372JJ0100 Rev.1.00
2011.02.01)を使用します。

Page 134 of 479

High-performance Embedded Workshop V.4.09

6.

環境のカスタマイズ

カスタムプレースホルダを使う

6.3

High-performance Embedded Workshopでは、ディレクトリを定義するときに、以前に定義したプレースホルダを指定できます。これによって、プロジェクトを再配置できます。
また、High-performance Embedded Workshopでは、カスタムプレースホルダを定義することもできます。このことは、ユーザがカスタムプレースホルダを定義し、そのディレクトリの値を決められることを意味します。
一度定義されると、このプレースホルダはHigh-performance Embedded Workshopの別の場所で有効になります。
[アプリケーション内有効プレースホルダ]に定義したプレースホルダは、High-performance Embedded Workshop
で使用するすべてのワークスペースやプロジェクトに対して有効です。それに対して、[ワークスペース内有効プレースホルダ]に定義したプレースホルダは、現在のワークスペースにおいてのみ有効です。

カスタムプレースホルダを追加するには
1.

[基本設定 -> カスタマイズ]を選択してください。[カスタマイズ]ダイアログボックスが開きます。

2.

[プレースホルダ]タブを選択してください。

3.

[アプリケーション内有効プレースホルダ]、あるいは[ワークスペース内有効ホルダ]のどちらを使いた
いか、選択してください。

4.

リスト横にある[追加]ボタンをクリックしてください。[新規カスタムプレースホルダ]ダイアログボッ
クスが開きます。

5.

このフィールドでは、プレースホルダの適切な名前、およびプレースホルダが意味する内容の説明を選択してください。

6.

次に、このプレースホルダと関連するディレクトリを選択してください。

注：
High-performance Embedded Workshop V.2.01より、カスタムプレースホルダとしてユーザ定義のディレクトリ
を設定できます。このカスタムプレースホルダはツールチェインオプションの設定に使えます。ディレクトリ
パス指定の際は、下の図のように[ディレクトリ]に絶対パスを指定してください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 135 of 479

High-performance Embedded Workshop V.4.09

6.

環境のカスタマイズ

ワークスペースやプロジェクトのログ機能を使う

6.4

High-performance Embedded Workshopでは、ワークスペースとプロジェクトのログ機能をアプリケーションの中に統合しています。この機能は、[カスタマイズ]ダイアログボックスの[ログ]タブで設定できます。この設定により、ユーザ名や変更内容についてログファイルを作成できるため、ネットワークデータベースが動作しているときなどに特に便利です。

[ワークスペースログファイル生成]をクリックすると、ワークスペースのすべての変更箇所がワークスペースと同じ名前で拡張子が.logのファイルにログします。このファイルの位置は、ワークスペースファイルと同じ
ディレクトリです。
[プロジェクトログの生成]をクリックすると、現在のワークスペースでのすべてのプロジェクトの変更箇所がプロジェクトと同じ名前で拡張子が.logのファイルにログします。このファイルの位置は、ワークスペースフ
ァイルと同じディレクトリです。
ワークスペースを保存するとログファイルを更新します。

ヘルプシステムを構築する

6.5

High-performance Embedded Workshopではエディタウィンドウで状況依存ヘルプを提供します。エディタウィ
ンドウでテキストを選択しF1キーを押すと、選択したテキストに関するヘルプを検索します。検索するヘルプ
ファイルは[カスタマイズ]ダイアログボックスの[ヘルプ]タブに表示します。
新しいヘルプファイルを追加するには
1.

[基本設定 -> カスタマイズ]を選択してください。[カスタマイズ]ダイアログボックスが開きます。

2.

[ヘルプ]タブを選択してください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 136 of 479

High-performance Embedded Workshop V.4.09

6.

環境のカスタマイズ

3.

[追加]ボタンをクリックしてください。[ヘルプファイルの追加]ダイアログボックスが開きます。

4.

[説明]にヘルプファイルの説明を入力してください。

5.

[ファイル名]にヘルプファイルへの絶対パスを入力してください（または[参照]ボタンをクリックしてファイルを選択してください）。

6.

[OK]ボタンをクリックすると新しいヘルプファイルを定義します。

デフォルトのヘルプファイルを設定する場合は[デフォルトヘルプファイル]ドロップダウンリストからヘルプ
ファイルを選択してください。F1キーを押したときに任意のヘルプファイルを参照するには[(None)]を選択してください。
ヘルプファイルを削除するには

6.6

1.

[基本設定 -> カスタマイズ]を選択してください。[カスタマイズ]ダイアログボックスが開きます。

2.

[ヘルプ]タブを選択してください。

3.

削除するファイルを選択して[削除]ボタンをクリックしてください。

4.

[OK]ボタンをクリックしてください。

キーボードショートカットをカスタマイズする

High-performance Embedded Workshopでは、キーボードショートカットを自由にカスタマイズできます。
High-performance Embedded Workshop以外のツールを以前使用していた場合、主な操作を特によく使うキーボ
ードショートカットに変えることができます。
[基本設定 -> カスタマイズ]を選択してください。[カスタマイズ]ダイアログボックスが開きます。[キーボード]タブを選択してください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 137 of 479

High-performance Embedded Workshop V.4.09

6.

環境のカスタマイズ

このダイアログボックスで、High-performance Embedded Workshopのデフォルトのキーボードショートカット、
あるいは、PDデバッガショートカットのどちらかを選択できます。キーボードのレイアウト全体を変更するには、[基本レイアウト]ドロップダウンリストから項目を1つ選んでください。デフォルトでは、High-performance Embedded Workshop設定を使用しています。
このダイアログボックスでいろいろな操作ができます。
新規キーボードショートカットを割り当てるには
1.

変更したいコマンドのメインメニューの[カテゴリ]を選択してください。メニューのあるコマンドのみ変更できます。いくつかの特殊なコマンド（カテゴリ名は"Global"）も変更できます。

2.

ショートカットを割り当てたいコマンドを[コマンド]リストから選択してください。現在のショート
カットを[現在のショートカット]に表示します。

3.

[新規ショートカット]でキー入力してください。キーをいろいろ組み合わせることができます。例えば、[Ctrl+J]、[Ctrl+Shift+O]などです。選択したショートカットを既に使用している場合、[現在の割り
当て]にコマンドを表示します。

4.

[割り当て]ボタンをクリックしてください。

5.

[OK]ボタンをクリックしてください。[OK]ボタンをクリックするまで変更は保存しません。

キーボードショートカットを削除するには
1.

変更したいコマンドのメインメニューの[カテゴリ]を選択してください。メニューのあるコマンドのみ変更できます。いくつかの特殊なコマンド（カテゴリ名は"Global"）も変更できます。

2.

ショートカットを削除したいコマンドを[コマンド]リストから選択してください。現在のショートカットを[現在のショートカット]に表示します。

3.

[削除]ボタンをクリックしてください。

4.

[OK]ボタンをクリックしてください。

キーボードショートカットをすべてリセットするには
1.

[リセット]ボタンをクリックしてください。すべてのショートカットが、現在選択しているキーボー

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 138 of 479

High-performance Embedded Workshop V.4.09

6.

環境のカスタマイズ

ドの配置のデフォルト設定に戻ります。
2.

[OK]ボタンをクリックしてください。[OK]ボタンをクリックするまで変更は保存しません。

[キーボード]タブでは、キーボードの設定を決められたファイルへインポートしたり、エクスポートしたりできます。これにより、あるマシンから別のマシンへ設定を転送できます。
キーボードショートカットをインポートするには1.

[基本レイアウト]リストから置き換えたいキーボードの配置を選択してください。

2.

[インポート]ボタンをクリックしてください。[レイアウトのインポート]ダイアログボックスが開きます。

3.

キーボードの配置をインポートするファイル名を選択してください。

4.

[OK]ボタンをクリックしてください。

キーボードショートカットをエクスポートするには1.

[エクスポート]ボタンをクリックしてください。[レイアウトのエクスポート]ダイアログボックスが開
きます。

2.

現在選択しているキーボードの配置の設定をエクスポートするファイル名を選択してください。

3.

[OK]ボタンをクリックしてください。

基本設定の影響範囲

6.7

カスタマイズダイアログボックスの影響範囲

6.7.1[基本設定 -> カスタマイズ]を選択すると[カスタマイズ]ダイアログボックスが開きます。[カスタマイズ]ダイ
アログボックスの設定内容は各タブの項目により影響範囲が異なります。下の表に各タブの項目の影響範囲を
示します。
タブ

コントロール

影響範囲

ツールバー

すべて

ワークスペース単位

コマンド

すべて

システム全体メニュー

アプリケーション内有効システム全体ワークスペース内有効

ワークスペース単位

アプリケーション内有効カスタムプレースホルダ

システム全体ワークスペース内有効カスタムプレースホルダ

ワークスペース単位

外部デバッガツール

プロジェクト単位

外部デバッガのディレクトリ

デフォルト（システム全体および各プロジェ

プレースホルダ

デバッガ

クト）
コマンドラインオプション

プロジェクト単位

セッションファイル

プロジェクト単位

ダウンロードモジュール

プロジェクト単位

ログ

すべて

ワークスペース単位

ヘルプ

すべて

ワークスペース単位

キーボード

すべて

システム全体R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 139 of 479

High-performance Embedded Workshop V.4.09

6.

環境のカスタマイズ

オプションダイアログボックスの影響範囲

6.7.2[基本設定 -> オプション]を選択すると[オプション]ダイアログボックスが開きます。[オプション]ダイアログ
ボックスの設定内容はシステム全体に影響します。

ワークスペースオプションを指定する

6.8

High-performance Embedded Workshopでは[オプション]ダイアログボックスでワークスペースの様々なオプションを設定できます。[基本設定 -> オプション]の[ワークスペース]タブを選択してください。

起動時に前回開いたワークスペースを開く

6.8.1

High-performance Embedded Workshopを終了すると最後に開いたワークスペースを保存します。次にHigh-performance Embedded Workshopを起動したとき、前回開いたワークスペースを自動的に開きます。
起動時に前回開いたワークスペースを開くには
1.

[基本設定 -> オプション]を選択してください。[オプション]ダイアログボックスが開きます。

2.

[ワークスペース]タブを選択してください。

3.

[起動時に前回開いたワークスペースを開く]チェックボックスをオンにしてください。

4.

[OK]ボタンをクリックします。

ワークスペースを開いたときにファイルを表示する

6.8.2

High-performance Embedded Workshopは、ワークスペースを閉じるとき開いていたファイルを記憶します。そして、再びワークスペースを開くとき、High-performance Embedded Workshopは同じファイルを復帰させる（つまり開く）ことができます。これにより、中断したセッションを引き続き行うことができます。このチェックボックスをオンにすると、ワークスペースを開いたときに前回開いていたファイルを開きます。
ワークスペースを開いたときにファイルを表示するには
1.

[基本設定 -> オプション]を選択してください。[オプション]ダイアログボックスが開きます。

2.

[ワークスペース]タブを選択してください。

3.

[ワークスペースを開いたときにファイルを表示]チェックボックスをオンにしてください。

4.

[OK]ボタンをクリックします。

6.8.3

ワークスペースを開いたときにワークスペース情報を表示する

多くのワークスペースを使うと、各ワークスペースの内容を覚えておくのは難しくなります。High-performance
Embedded Workshopでは各ワークスペースの説明を入力しておくことができます。ワークスペースを開くときは常にこの説明を表示します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 140 of 479

High-performance Embedded Workshop V.4.09

6.

環境のカスタマイズ

ワークスペースの説明を入力するには1.

ワークスペースウィンドウの[Projects]タブでワークスペースアイコンを選択してください。

2.

右クリックし、ポップアップメニューから[プロパティ]オプションを選択してください。[ワークスペースプロパティ]ダイアログボックスが開きます。

3.

[情報]に説明を入力してください。

4.

ワークスペースを開いたときに[ワークスペースプロパティ]ダイアログボックスを開くようにするには、[ワークスペースを開いたときにワークスペース情報の表示]チェックボックスをオンにしてください。
このチェックボックスは[オプション]ダイアログボックスの[ワークスペース]タブの[ワークスペースを開いたときにワークスペース情報の表示]チェックボックスと同じ機能です。

5.

[OK]ボタンをクリックします。

ツール実行前にワークスペースを保存する

6.8.4

このチェックボックスをオンにすると、ビルドフェーズを実行（[ビルド]、[すべてビルド]、[コンパイル]操作）
する前や、バージョン管理コマンドを実行する前に、現在のワークスペースを保存できます。
ツール実行前にワークスペースを保存するには
1.

[基本設定 -> オプション]を選択してください。[オプション]ダイアログボックスが開きます。

2.

[ワークスペース]タブを選択してください。

3.

[ツール実行前にワークスペースの保存]チェックボックスをオンにしてください。

4.

[OK]ボタンをクリックします。

ワークスペース保存前に確認する

6.8.5[ツール実行前にワークスペースを保存する]機能を使用する場合、ワークスペースを保存する前に、High-performance Embedded Workshopは確認の画面を表示します。ツール実行前のワークスペースの保存について、詳細は「6.8.4 ツール実行前にワークスペースを保存する」を参照してください。
ワークスペース保存前に確認の画面を表示するには
1.

[基本設定 -> オプション]を選択してください。[オプション]ダイアログボックスが開きます。

2.

[ワークスペース]タブを選択してください。

3.

[ワークスペース保存前に確認]チェックボックスをオンにしてください。

4.

[OK]ボタンをクリックします。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 141 of 479

High-performance Embedded Workshop V.4.09

6.

環境のカスタマイズ

セッション保存前に確認する

6.8.6

このチェックボックスをオンにすると、High-performance Embedded Workshopはセッションをディスクに保存する前にプロンプトを表示します。
セッションをディスクに保存する前にプロンプトを表示するには
1.

[基本設定 -> オプション]を選択してください。[オプション]ダイアログボックスが開きます。

2.

[ワークスペース]タブを選択してください。

3.

[セッション保存前に確認]チェックボックスをオンにしてください。

4.

[OK]ボタンをクリックします。

自動バックアップ機能を有効にする

6.8.7

このチェックボックスをオンにすると、指定した時間間隔（デフォルト 10分）で、ワークスペース、プロジ
ェクト、およびセッションファイルをバックアップします。加えた変更はすべて、テンポラリファイルに保存します。
自動バックアップ機能を有効にするには
1.

[基本設定 -> オプション]を選択してください。[オプション]ダイアログボックスが開きます。

2.

[ワークスペース]タブを選択してください。

3.

[自動バックアップ時間間隔]チェックボックスをオンにしてください。

4.

自動バックアップ機能を起動する時間（分）を選択してください（最大60分）。

5.

[OK]ボタンをクリックします。

ワークスペースを開いて以下のダイアログボックスが表示される場合、前回そのワークスペースを使用したときに問題が発生したことを意味します。

ファイルを回復するには、回復したいファイルの名前の横にあるチェックボックスをオンにし、[OK]ボタンを
R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 142 of 479

High-performance Embedded Workshop V.4.09

6.

環境のカスタマイズ

クリックしてください。[キャンセル]ボタンをクリックすると、自動バックアップファイルを削除し、元のファイルからロードを行います。

ワークスペースを開いたときに読み込むプロジェクトを設定する

6.8.8

ワークスペースを開いたときに読み込むプロジェクトを設定できます。この設定は、複数のプロジェクトを含むワークスペースに関連があり、アプリケーションシステム全体に影響します。
ワークスペースを開いたときに読み込むプロジェクトを設定するには
1.

[基本設定 -> オプション]を選択してください。[オプション]ダイアログボックスが開きます。

2.

[ワークスペース]タブを選択してください。

3.

[ワークスペースを開いたときに読み込むプロジェクト]リストからワークスペースを開くときの動作を設定します。以下のいずれかの操作を選択してください。

•[前回のアクティブプロジェクト]
前回ワークスペースを閉じたときにアクティブだったプロジェクトだけを読み込みます。

•[すべてのプロジェクト]
ワークスペースに登録されているすべてのプロジェクトを読み込みます。

•[前回の読み込み状態のプロジェクト]
前回ワークスペースを閉じたときに読み込んでいたプロジェクトを読み込みます。

4.

[OK]ボタンをクリックします。

新規ワークスペースのデフォルトディレクトリを変更する

6.8.9

新しいワークスペースを作成すると[新規プロジェクトワークスペース]ダイアログボックスが開きます。このダイアログボックスにはその新しいワークスペースが作成されるディレクトリを入力するフィールドがあります。デフォルトではWorkspaceディレクトリです。しかし、他のディレクトリにデフォルトを変更したい場
合、このフィールドにそのディレクトリを入力するか、[参照]ボタンで位置を指定してください。
新規ワークスペースのデフォルトディレクトリを変更するには
1.

[基本設定 -> オプション]を選択してください。[オプション]ダイアログボックスが開きます。

2.

[ワークスペース]タブを選択してください。

3.

新しいワークスペースを作成するディレクトリを[新規ワークスペースのデフォルトディレクトリ]に入力するか、[参照]ボタンをクリックして参照してください。

4.

[OK]ボタンをクリックします。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 143 of 479

High-performance Embedded Workshop V.4.09

6.

環境のカスタマイズ

外部エディタを使う

6.9

High-performance Embedded Workshopエディタ以外のエディタ（外部エディタ）も使うことができます。外部
エディタを指定した場合、以下を操作すると外部エディタで開きます。
•[ファイル -> 開く]メニューを選択すると表示される[ファイルを開く]ダイアログボックスでファイ
ルを選択したとき•[ファイル -> 最近使ったファイル]メニューからファイルを選択したとき•

ワークスペースウィンドウの[Projects]タブのファイルをダブルクリックしたとき•

ワークスペースウィンドウの[Navigation]タブのエントリをダブルクリックしたとき•

アウトプットウィンドウの[Build]タブのエラーまたはウォーニングをダブルクリックしたとき•

アウトプットウィンドウの[Find in Files 1]タブのエントリをダブルクリックしたとき•

アウトプットウィンドウの[Find in Files 2]タブのエントリをダブルクリックしたとき•

ワークスペースウィンドウの[Projects]タブのファイル上で右クリックしポップアップメニューから[開く <ファイル名> (外部エディタ)]を選択したとき•[編集 -> ソースブレークポイント]メニューを選択すると表示される[ブレークポイント]ダイアログ
ボックスで、[コードの編集]ボタンをクリックしたとき•

Windows® ExplorerからHigh-performance Embedded Workshopウィンドウ上にファイルをドラッグアン
ドドロップしたとき（ただしワークスペースウィンドウの[Projects]タブのアクティブプロジェクトや
ユーザフォルダ上にファイルをドラッグアンドドロップしたときは、プロジェクトにファイルを追加します。このときファイルは開きません。）

外部エディタを指定するには

1.

[基本設定 -> オプション]を選択してください。[オプション]ダイアログボックスが開きます。

2.

[エディタ]タブを選択してください。

3.

[外部エディタの使用]チェックボックスをオンにしてください。[外部エディタ]ダイアログボックスが
開きます。

4.

[コマンド]に実行可能ファイルのパス（引数をのぞいて）を入力してください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 144 of 479

High-performance Embedded Workshop V.4.09

5.

6.

環境のカスタマイズ[ファイルを開く時の引数]にファイルを開くために必要な引数を入力してください。開くファイルのパスには $(FULLFILE) プレースホルダを使ってください。

6.

[行番号を指定してファイルを開く時の引数]にファイルの特定の行を開くために必要な引数を入力してください。開くファイルのパスには $(FULLFILE) プレースホルダを使ってください。また、カーソルを最初に置く行の番号には $(LINE) プレースホルダを使ってください。

7.

[詳細>>]ボタンをクリックすると、次のファイルを開く操作の場合に外部エディタまたは内蔵（High-performance Embedded Workshop）エディタのどちらでファイルを開くかを選択できます。

•[ファイル -> 開く]メニューから[ファイルを開く]ダイアログボックスでファイルを選択したとき
デフォルトは"内蔵エディタ"が選択されています。

•

ワークスペースウィンドウ上でダブルクリック
ワークスペースウィンドウの[Projects]タブのファイルをダブルクリックしたとき
ワークスペースウィンドウの[Navigation]タブのエントリをダブルクリックしたとき
デフォルトは"外部エディタ"が選択されています。

•

アウトプットウィンドウ上でダブルクリック
アウトプットウィンドウの[Build]タブのエラーまたはウォーニングをダブルクリックしたとき
アウトプットウィンドウの[Find in Files 1]タブのエントリをダブルクリックしたとき
アウトプットウィンドウの[Find in Files 2]タブのエントリをダブルクリックしたとき
デフォルトは"外部エディタ"が選択されています。

•

HEWウィンドウにドラッグアンドドロップ
Windows® ExplorerからHigh-performance Embedded Workshopウィンドウ上にファイルをドラッグアン
ドドロップしたとき（ただしワークスペースウィンドウの[Projects]タブのアクティブプロジェクトや
ユーザフォルダ上にファイルをドラッグアンドドロップしたときは、プロジェクトにファイルを追加します。このときファイルは開きません。）
デフォルトは"内蔵エディタ"が選択されています。

8.

[OK]ボタンをクリックします。

[外部エディタの使用]チェックボックスをオンにした場合、以下を操作すると常に外部エディタで開きます。
•[編集 -> ソースブレークポイント]メニューを選択すると表示される[ブレークポイント]ダイアログ
ボックスで、[コードの編集]ボタンをクリックしたとき•[ファイル -> 最近使ったファイル]メニューからファイルを選択したときまた、ワークスペースウィンドウの[Projects]タブのファイル上で右クリックしポップアップメニューを表示すると、[開く <ファイル名>]の下に[開く <ファイル名> (外部エディタ)]が追加されます。
注：
外部エディタを使う場合、以下のことに注意してください。
•

どのように起動しても、外部エディタを起動するたびに、エディタは新規に起動します。

•

ビルド操作（[ビルド]、[すべてビルド]、[コンパイル]）を行う前にファイルを保存してください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 145 of 479

High-performance Embedded Workshop V.4.09

6.10

6.

環境のカスタマイズ

表示するフォントのカスタマイズ

High-performance Embedded Workshopのコンポーネントは違った外観で表示させることが可能です。表示するフォントやテキストの色を変更できます。
ウィンドウの外観を変更するには
1.

[基本設定 -> 表示の形式]を選択してください。[表示形式]ダイアログボックスが開きます。

2.

外観を変更したい表示を選択してください。すべての表示を変更するには、[All views]のカテゴリを選択してください。

3.

ツリーの項目を展開し、外観の変更が可能なすべての項目を表示します。

4.

項目を選択してください。本ダイアログボックスの右側にある、タブの変更に注意してください。

5.

[フォント]または[カラー]を変更してください。

6.

変更を保存するには[OK]ボタンをクリックしてしてください。

各ウィンドウに表示されているテキストの色やフォントなどが[表示形式]ダイアログボックスでカスタマイズ可能です。
項目
Sourceカテゴリ名
Selected Text

カスタマイズ対象
エディタウィンドウおよび逆アセンブリウィンドウ（ソースモード）に表示されているテキストを選択した部分

PC Line Highlight[オプション]ダイアログボックスの[エディタ]タブで、[PC カーソル行のハイライト表示]チェックボックスがオンの場合に、エディタウィンドウおよび逆
アセンブリウィンドウ（ソースモード）の PC（プログラムカウンタ）の位置
がある行

差分

その他、各々のファイル

エディタウィンドウおよび逆アセンブリウィンドウ（ソースモード）に表示

タイプのシンタックス

されているコメントまたはキーワード*1に基づいたキーワード*1. 制御文、式文、宣言文、プリプロセッサ制御文、データ文、データ群、デグループィレクディブ、値LHS Different Lines

差分ウィンドウの左側のペインに表示されている不一致テキスト行

LHS Moved Lines

差分ウィンドウの左側のペインに表示されている移動されたテキスト行

RHS Different Lines

差分ウィンドウの右側のペインに表示されている不一致テキスト行

RHS Moved lines

差分ウィンドウの右側のペインに表示されている移動されたテキスト行

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 146 of 479

High-performance Embedded Workshop V.4.09

項目

カテゴリ名

6.

環境のカスタマイズ

カスタマイズ対象

レジスタ

変更

レジスタウィンドウに表示されている値が変更された部分のテキスト

メモリ

アクセス履歴あり

メモリウィンドウに表示されているカバレッジ計測時のコード実行部分のテ
キスト

アクセス履歴なし

メモリウィンドウに表示されているカバレッジ計測時のコード未実行部分のテキスト

Outputカバレッジ計測領域外

メモリウィンドウに表示されているカバレッジ計測領域外の部分のテキスト

メモリ領域外メモリウィンドウに表示されているメモリ領域外の部分のテキスト変更

メモリウィンドウに表示されている値が変更された部分のテキスト

Build Error

アウトプットウィンドウの[Build]タブに表示されているエラーメッセージ行

Build Warning

アウトプットウィンドウの[Build]タブに表示されているウォーニングメッセ
ージ行

Information

アウトプットウィンドウの[Build]タブに表示されているインフォメーション
メッセージ行

逆アセンブリPC Line Highlight[オプション]ダイアログボックスの[エディタ]タブで、[PC カーソル行のハイライト表示]チェックボックスがオンの場合にエディタウィンドウおよび逆ア
センブリウィンドウ（混合モードおよび逆アセンブリモード）で PC（プログラムカウンタ）の位置がある行

ソース行

エディタウィンドウおよび逆アセンブリウィンドウ（混合モード）に表示されているソース行

全般

6.11

Text

各ウィンドウに表示されているテキスト

バーチャルデスクトップを使う

High-performance Embedded Workshopはバーチャルデスクトップの概念を導入しています。ウィンドウ配置をボタンのクリックで切り替えることができます。ボタンをクリックすると、ウィンドウ配置の設定によりツールバーとウィンドウが表示または非表示になります。
最大4パターンのデスクトップ構成が可能です。セッションを保存すると、各構成のウィンドウ位置がセッションファイルに保存されます。構成を切り替えるだけで他のウィンドウへアクセスできます。ツールバーとウィンドウはバーチャルデスクトップ構成に依存します。ソースファイルは、バーチャルデスクトップのシステ
ムから独立しているため表示します。
デスクトップ構成に新しい名前を付けるには
1.

[ウィンドウ -> バーチャルデスクトップ -> デスクトップマネージャ]を選択してください。[デスクトップマネージャ]ダイアログボックスが開きます。

2.

名前を変更するデスクトップ構成を選択してください。

3.

[名前の変更]ボタンをクリックしてください。

4.

新しい名前を入力し、[OK]ボタンをクリックしてください。

5.

[OK] ボタンをクリックしてください。

デスクトップ構成を切り替えるには
デスクトップ構成の切り替えには、いくつかの方法があります。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 147 of 479

High-performance Embedded Workshop V.4.09

6.

環境のカスタマイズ

もっとも簡単な方法は以下の通りです。ステータスバー上のバーチャルデスクトップボタンをクリックします。

この例では、選択されたデスクトップ番号は"1"で、"Build"という名前が付いています。ボタンの右側のボックスに"Build desktop"と表示しています。別のデスクトップボタンをクリックするとボタンの右側のボックスの表示も切り替わります。一度クリックすると、新しい構成の形式でウィンドウを読み込みます。
もう1つの方法は以下の通りです。
1.

[ウィンドウ -> バーチャルデスクトップ]を選択してください。

2.

サブメニューを選択してください。

3.

表示したいデスクトップ構成を選択してください。選択したデスクトップ構成のサブメニューにチェックマークが付きます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 148 of 479

High-performance Embedded Workshop V.4.09

7.

バージョン管理バージョン管理7.

High-performance Embedded Workshopはバージョン管理システムと接続できます。プロジェクトでバージョン
管理システムを使用する理由を以下に示します。
•

プロジェクト開発環境の統合性を維持するため•

プロジェクトのバージョンを記録･保存するため•

ソースファイルに対するバージョン管理を行い、複数のユーザが1つのプロジェクトを共同開発できるようにするためバージョン管理システムを使用するプロジェクトの一般例を示します。ここでは複数のユーザがソースコード
を相互参照するために同じ共有ネットワークドライブを使用しています。バージョン管理システムはソースフ
ァイルの参照や更新を管理するために使用します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 149 of 479

High-performance Embedded Workshop V.4.09•

バージョン管理7.

High-performance Embedded Workshopのバージョン管理の対象ファイル

High-performance Embedded Workshopのバージョン管理の対象ファイルは、標準では以下の種類があります。
ファイルの種類

拡張子グループ名

ファイルの拡張子

ワークスペースファイル

HEW Workspaces

hws

プロジェクトファイル

HEW Projects

hwp

バージョン管理用ファイル

Configuration Filehvc

ソースファイル

C source filec

C++ source file *cpp

Assembly source filea30, ms, a74, asm, mar, src *C header fileh

C++ header file *hpp

Assembly include fileinc

インクルードファイル

注：*. サポートはツールチェインに依存します。
上記以外のファイルもプロジェクトに追加すると、バージョン管理の対象にできます。
•

High-performance Embedded Workshopと接続可能なバージョン管理システム

High-performance Embedded Workshopはバージョン管理システム自体を提供していません。あらかじめバージ
ョン管理システムがマシンにインストールされている必要があります。High-performance Embedded WorkshopのGUIインタフェースを使用しバージョン管理システムと接続が可能です。
はじめにHigh-performance Embedded Workshopと接続するバージョン管理システムを選択します。
High-performance Embedded Workshopと接続可能なバージョン管理システムは下記の2種類のいずれかです。
分類
カスタマイズ設定によるバーバージョン管理システム名
Custom VCS

ジョン管理

説明
MS-DOS コマンドプロンプトからコマンドラインコマ
ンドを実行するバージョン管理システムを対象としています。（RCS、CVS、PVCS など）
バージョン管理システムのコマンドとHigh-performance Embedded Workshop の GUI インタ
フェースを関連付けし定義する必要があります。

Microsoft® Visual SourceSafe Microsoft Visual SourceSafe

Microsoft® Visual SourceSafe 5.0、6.0、または 2005 を

5.0、6.0、または 2005 による対象としています。

バージョン管理

主な機能をあらかじめ定義済みです。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 150 of 479

High-performance Embedded Workshop V.4.09

バージョン管理7.

バージョン管理システムを選択する

7.1

最初に、[ツール -> バージョン管理]の8つのメニューオプションは以下のように表示します。このとき、まだ現在のワークスペースでバージョン管理システムを選択していないため、[ツール -> バージョン管理 -> 選択]だけが使用できます。

バージョン管理システムを選択するには
1.

[ツール -> バージョン管理 -> 選択]を選択します。[バージョン管理システムの選択]ダイアログボッ
クスが開きます。このダイアログボックスにはサポートするバージョン管理システムをすべて表示し
ます。

•

2.

[バージョン管理システム]リストからバージョン管理システムを選択します。

3.

[OK]ボタンをクリックします。

バージョン管理システムに"Custom VCS"を選択した場合は、[ツール -> バージョン管理 -> 構成]が使用できるようになります。「8. カスタムバージョン管理システム」を参照してください。

•

バージョン管理システムに"Microsoft Visual SourceSafe"を選択した場合は、[ツール -> バージョン管理 ->選択]の他のメニューオプションが使用できるようになります。「9. Visual SourceSafeバージョン管理システム」を参照してください。

バージョン管理システムの選択を解除するには1.

[ツール -> バージョン管理 -> 選択]を選択します。[バージョン管理システムの選択]ダイアログボッ
クスが開きます。

2.

[バージョン管理システム]リストから"<None>"を選択します。

3.

[OK]ボタンをクリックします。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 151 of 479

High-performance Embedded Workshop V.4.09

7.

バージョン管理バージョン管理設定内容のインポートとエクスポート

7.2

ワークスペースごとに異なるバージョン管理設定を行うことができます。High-performance Embedded
Workshopではそれぞれのバージョン管理設定を保存して他のワークスペースでインポートできます。これにより、複数のワークスペースで何度も同じバージョン管理設定を行う必要がなく、時間を節約できます。
バージョン管理設定をエクスポートするには1.

[ツール -> バージョン管理 -> 構成]を選択してください。[バージョン管理設定]ダイアログボックスが開きます。

2.

[エクスポート]ボタンをクリックしてください。[現在のバージョン管理構成をエクスポート]ダイアロ
グボックスが開きます。

3.

設定内容を保存するディレクトリを選択してください。

4.

ファイル名を入力し[保存]ボタンをクリックしてください。

バージョン管理設定をインポートするには1.

[ツール -> バージョン管理 -> 構成]を選択してください。[バージョン管理設定]ダイアログボックスが開きます。

2.

[インポート]ボタンをクリックしてください。[バージョン管理構成をインポート]ダイアログボックスが開きます。

3.

インポートするファイル（*.HVC）を選択してください。

4.

[インポート]ボタンをクリックしてください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 152 of 479

High-performance Embedded Workshop V.4.09

8.

カスタムバージョン管理システム

カスタムバージョン管理システム

8.

「7.1 バージョン管理システムを選択する」でバージョン管理システムに"Custom VCS"を選択した場合、High-performance Embedded WorkshopとCustom VCSを接続するには以下を定義していただく必要があります。
•

バージョン管理メニューオプションを定義し、そのオプションに関連したカスタムバージョン管理のコマ
ンド実行ファイル（.EXE）の位置、コマンドパラメータ、およびバージョン管理ツールコマンドを実行した結果の制御方法などの定義•

バージョン管理対象ファイルの位置（ディレクトリマッピング）、および環境変数の定義•

バージョン管理コマンド実行時の制御、およびユーザ設定など一般的なオプションの定義

これらを定義すると、High-performance Embedded Workshopのメニューオプションまたはツールバーボタンを選択したときにカスタムのバージョン管理システムのコマンドが実行でき、その実行結果をHigh-performance
Embedded Workshopで見ることが可能になります。
バージョン管理システムのインストールや設定は、各バージョン管理システムのマニュアルを参照してください。
カスタムバージョン管理システムとHigh-performance Embedded Workshopとの具体的な操作方法は、「8.11 カスタムバージョン管理システムの使用例」を参照してください。

バージョン管理メニューオプションを定義する

8.1

カスタムのバージョン管理システムでは、[ツール -> バージョン管理]サブメニューからオプションを選択す
るか、バージョン管理ツールバーボタンでバージョン管理コマンド実行ファイルを起動できます。関連するコ
マンドを実行し、出力をアウトプットウィンドウの[Version Control]タブに表示します。
バージョン管理メニューオプションまたはツールバーボタンによりコマンドを実行するには
1.

ワークスペースウィンドウの[Projects]タブからバージョン管理コマンドを適用する項目（ワークスペース、プロジェクト、フォルダ、またはファイルなど）を選択してください。右クリックしてポップ
アップメニューを表示し、[バージョン管理]サブメニューから定義したメニューオプションを選択できます。メニューオプションを選択すると、ワークスペースウィンドウで選択した項目に応じたファイルに対し、メニューオプションに関連付けたコマンドが実行されます。

2.

例えば、ワークスペースアイコンを選択すると、そのワークスペースのプロジェクトのすべてのファ
イルがバージョン管理コマンドに渡ります。これには、High-performance Embedded Workshopのシステ
ムファイルも含まれます。

3.

[ツール -> バージョン管理]サブメニューからメニューオプションを選択するか、[バージョン管理]ツールバーボタンを選択してください。

カスタムバージョン管理を利用すると、バージョン管理システムの指定を任意に定義できます。[ツール -> バージョン管理 -> 構成] を選択し[バージョン管理設定]ダイアログボックスを開きます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 153 of 479

High-performance Embedded Workshop V.4.09

8.

カスタムバージョン管理システム[コマンド]タブには2つのメニューオプションのリストがあります。
•

システム定義メニューオプション([システムメニューオプションとツールバーボタン])
1つめのリスト[システムメニューオプションとツールバーボタン]は、[ツール -> バージョン管理]サブメ
ニューに常に表示されているメニューオプションです。これに対応する[バージョン管理]ツールバーがあります。このリストには最もよく使用されるバージョン管理コマンドに関連した6種類のメニューオプシ
ョンが表示されています。

•

ユーザ定義メニューオプション([ユーザメニューオプション])
2つめのリスト[ユーザメニューオプション]は、ユーザ定義の追加メニューオプションで、定義すると[ツール -> バージョン管理]サブメニューの最後に追加されます。システムメニューオプションに表示されていないメニューオプションを追加する場合はこのリストで定義してください。ユーザ定義のメニューオ
プションはバージョン管理ツールバーには表示されません。

8.1.1

システム定義メニューオプション

バージョン管理ツールバーボタンは6種類あります。これらのボタンは、最もよく使用されるバージョン管理
コマンドへのショートカットとなります。最初にワークスペースを作成すると、これらのボタンはアクティブ
ではありません。これは、バージョン管理コマンドがツールバーボタンに関連付けられていないためです。
ツールバーボタンは、[ツール -> バージョン管理]サブメニューの6つのメニューオプションと同等です。[ツール -> バージョン管理 -> ファイルの取得]はバージョン管理から[ファイルの取得]ツールバーボタンをクリックするのと同じ効果があります。ツールバーボタンの表示は固定されているので、ツールバーボタンをクリックしたときに実行するコマンドを定義してください。
ツールバーまたは[ツール -> バージョン管理]サブメニューのシステム定義オプションからコマンドを起動す
るには、まず、バージョン管理システムを起動したときに実行する関連したコマンドを定義しなければなりま
R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 154 of 479

High-performance Embedded Workshop V.4.09

8.

カスタムバージョン管理システム

せん。オプション名とその説明を下記に示します。
オプション名

説明

ファイルの追加

バージョン管理システムに選択したファイルを追加する

ファイルの削除

バージョン管理システムから選択したファイルを削除する

ファイルの取得

バージョン管理システムから選択したファイルの読み取り専用ローカルファイルを取得する

ファイルのチェックアウト

バージョン管理システムから選択したファイルの書き込み可能なローカルファイル
を取得する

ファイルのチェックイン

バージョン管理システムに選択したファイルのローカルコピーを戻し更新する

ファイルの状態

選択したファイルの状態を表示する

システムメニューオプションやツールバーボタンから実行するコマンドを定義するには
1.

[ツール -> バージョン管理 -> 構成]を選択してください。[バージョン管理設定]ダイアログボックスが開きます。

2.

[システムメニューオプションおよびツールバーボタン]リストからコマンドを定義するオプションを選択し[変更]ボタンをクリックすると、[定義コマンド]ダイアログボックスが開きます。

3.

[追加]ボタンで選択したメニューオプションにコマンドを定義してください。詳細は「8.2 バージョン
管理コマンドを定義する」を参照してください。

4.

[OK]ボタンをクリックして[定義コマンド]ダイアログボックスを閉じてください。

5.

[OK]ボタンをクリックして[バージョン管理設定]ダイアログボックスを閉じてください。

ユーザ定義メニューオプション

8.1.2

ユーザ定義のメニューオプションは複数作成できます。メニューオプション名も自由に付けられます。既にユーザ定義のメニューオプションを作成している場合、コマンドの定義の変更、削除、または、メニューオプシ
ョンの表示順序も指定できます。ユーザ定義のメニューオプションはバージョン管理ツールバーには表示されません。
新しいバージョン管理メニューオプションを作成するには
1.

[ツール -> バージョン管理 -> 構成]を選択してください。[バージョン管理設定]ダイアログボックスが開きます。

2.

[ユーザメニューオプション]リストの横にある[追加]ボタンをクリックしてください。[メニューオプシ
ョンの追加]ダイアログボックスが開きます。

3.

[オプション]にメニューオプション名を入力してください。

4.

[追加]ボタンをクリックしてください。[コマンド追加]ダイアログボックスが開きます。詳細は「8.2 バージョン管理コマンドを定義する」を参照してください。

5.

[OK]ボタンをクリックし、[コマンド追加]ダイアログボックスを閉じてください。

6.

[OK]ボタンをクリックし、[メニューオプションの追加]ダイアログボックスを閉じてください。

7.

[OK]ボタンをクリックし、[バージョン管理設定]ダイアログボックスを閉じてください。

既存のバージョン管理メニューオプションの定義コマンドを変更するには
1.

[ツール -> バージョン管理 -> 構成]を選択してください。[バージョン管理設定]ダイアログボックスが開きます。

2.

[ユーザメニューオプション]リストから変更するメニューオプションを選択し、[変更]ボタンをクリッ

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 155 of 479

High-performance Embedded Workshop V.4.09

8.

カスタムバージョン管理システム

クしてください。[定義コマンド]ダイアログボックスが開きます。
3.

[コマンド]リストから変更するメニューオプションを選択し、[変更]ボタンをクリックしてください。
[コマンド変更]ダイアログボックスが開きます。詳細は「8.2 バージョン管理コマンドを定義する」を参照してください。

4.

[OK]ボタンをクリックし、[コマンド変更]ダイアログボックスを閉じてください。

5.

[OK]ボタンをクリックし、[定義コマンド]ダイアログボックスを閉じてください。

6.

[OK]ボタンをクリックし、[バージョン管理設定]ダイアログボックスを閉じてください。

既存のバージョン管理メニューオプションを削除するには1.

[ツール -> バージョン管理 -> 構成]を選択してください。[バージョン管理設定]ダイアログボックスが開きます。

2.

[ユーザメニューオプション]リストから削除するメニューオプションを選択し、[削除]ボタンをクリッ
クしてください。

3.

[OK]ボタンをクリックし、[バージョン管理設定]ダイアログボックスを閉じてください。

バージョン管理メニューオプションの表示順序を変更するには
1.

[ツール -> バージョン管理 -> 構成]を選択してください。[バージョン管理設定]ダイアログボックスが開きます。

2.

移動するメニューオプションを選択し、上に移動する場合は[上へ移動]ボタンを、下に移動する場合
は[下へ移動]ボタンを必要に応じてクリックしてください。

3.

[OK]ボタンをクリックし、[バージョン管理設定]ダイアログボックスを閉じてください。

バージョン管理コマンドを定義する

8.2

バージョン管理コマンドは、[定義コマンド]ダイアログボックスに表示されます。コマンドを定義する数に制限はなく、実行する順番を指定できます。既存のコマンドは変更または削除できます。
バージョン管理コマンドを定義するには
1.

[定義コマンド]ダイアログボックスの[追加]ボタンをクリックしてください。[コマンド追加]ダイアロ
グボックスが開きます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 156 of 479

High-performance Embedded Workshop V.4.09

2.

8.

カスタムバージョン管理システム[バージョン管理システム]にコマンド実行ファイルの絶対パスを入力するか、[参照]ボタンをクリック
してコマンド実行ファイルの位置を指定してください。

3.

[引数]にコマンドラインパラメータを入力してください。

4.

[初期ディレクトリ]に実行ファイルを起動するディレクトリを入力するか、[参照]ボタンをクリックして起動ディレクトリを指定してください。ただし、特に起動ディレクトリを指定する必要がない場合
は、$(FILEDIR)プレースホルダを指定してファイルのディレクトリと同じディレクトリでコマンドを実行してください。

5.

[コマンドリターンコード]オプションを選択してください。オプションの設定は「8.5 バージョン管理
コマンドリターンコードオプション」を参照してください。

6.

[OK]ボタンをクリックすると新しいコマンドを定義します。

既存のバージョン管理コマンドを修正するには1.

変更するコマンドを[定義コマンド]ダイアログボックスの[コマンド]リストから選択してください。

2.

[変更]ボタンをクリックしてください。[コマンド変更]ダイアログボックスが開きます。

3.

必要に応じて修正を行い、[OK]ボタンをクリックしてください。

既存のバージョン管理コマンドを削除するには1.

削除するコマンドを[定義コマンド]ダイアログボックスの[コマンド]リストから選択してください。

2.

[削除]ボタンをクリックしてください。

バージョン管理メニューオプションの順序を変更するには
1.

移動するメニューオプションを[定義コマンド]ダイアログボックスの[コマンド]リストから選択して
ください。

2.

必要に応じて[上へ移動]または[下へ移動]ボタンをクリックしてください。

引数を指定する

8.3

引数は正しく指定しなければなりません。間違った引数を指定すると、バージョン管理システムが正しく動作しません。また、1つのバージョン管理コマンドを様々なファイルに適用する場合など、引数をフレキシブル
な方法で指定する必要があります。これを行うため[引数]にはプレースホルダボタン()があります（プレースホルダの詳細は、「リファレンス5. プレースホルダ」を参照してください）。プレースホルダボタンをクリックすると、使用できるプレースホルダをポップアップメニューで表示します。
以下の表に各プレースホルダの説明と実際の値を示します。
ポップアップメニュー

プレースホルダ

実際の値

User login name$(USERNAME)

現在のユーザログイン([一般]タブ)

User login password$(PASSWORD)

現在のユーザパスワード([一般]タブ)

Version control directory$(VCDIR)

仮想バージョン管理マップ([プロジェクト]タブ)

Comment$(COMMENT)

コマンド実行前に指定したコメント

File path + name$(FULLFILE)

操作するファイル名とその絶対パス

Filename$(FILENAME)

操作するファイル名(拡張子を含む)

File leaf$(FILELEAF)

操作するファイル名(拡張子を含まない)

File extension$(EXTENSION)

操作するファイルの拡張子

File directory$(FILEDIR)

操作するファイルのディレクトリ

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 157 of 479

High-performance Embedded Workshop V.4.09

ポップアップメニュー

8.

プレースホルダ

カスタムバージョン管理システム

実際の値

Configuration directory$(CONFIGDIR)

現在のコンフィグレーションディレクトリ

Project directory$(PROJDIR)

現在のプロジェクトのディレクトリ

Workspace directory$(WORKSPDIR)

現在のワークスペースディレクトリ

Temp directory$(TEMPDIR)

テンポラリディレクトリ

Command directory$(EXEDIR)

バージョン管理実行ディレクトリ

Windows directory$(WINDIR)

Windows® がインストールされているディレクトリ

Windows system directory$(WINSYSDIR)

Windows® のシステムファイルがあるディレクトリ

Workspace name$(WORKSPNAME)

現在のワークスペース名

Project name$(PROJECTNAME)

現在のプロジェクト名

Configuration name$(CONFIGNAME)

現在のコンフィグレーション名

コメントを指定する

8.4

バージョン管理コマンドに$(COMMENT)プレースホルダを含む場合、コマンド実行時に[コメント入力]ダイア
ログボックスが表示されるのでコメントを入力してください。
コメントはコマンドごとに指定できます。また、[全てのファイルにコメントを適用]チェックボックスをオンにし[OK]ボタンをクリックすると、すべてのファイルに同じコメントが指定できます。

バージョン管理コマンドリターンコードオプション

8.5

バージョン管理コマンドが実行されると、その出力はアウトプットウィンドウの[Version Control]タブに表示します。
コマンドの実行が完了するとリターンコードを取得します。コマンドを定義する際、このリターンコードを使用し、コマンド実行中にエラーが発生した場合に、残りのコマンドを実行しないことを示すことができます(例：abort)。[コマンドリターンコード]グループに含まれる管理機能を使用すればこの動作を指定できます。
コマンドのリターンコードでエラーを示すことができる場合、[リターンコードが次の場合、コマンドは失敗]
オプションを選択して必要に応じてドロップダウンリストおよびエディットボックスを設定してください。
[リターンコードが次の場合、コマンドは失敗]オプションが選択されている場合、High-performance Embedded
Workshopは各コマンドのリターンコードをチェックしてエラーが起こったかどうか判定します。エラーが起こった場合、コマンド実行を停止しそれに続くコマンド実行やコマンドの後に続く処理（例：ビルド）を実行しません。
[コマンドのリターンコードを処理しない]オプションが選択されている場合、High-performance Embedded
Workshopは各コマンドのリターンコードをチェックしません。したがってすべてのコマンドを実行します。

8.6

ディレクトリをマッピングする

ファイルの位置を指定する場合はプレースホルダを使用してください。使用しない場合は、コマンドは指定したファイルにしか適用されません。例えば、バージョン管理のアプリケーションに–GETコマンドを使用してファイルの読み出し専用コピーを作成する場合、[引数]は以下のように指定できます。
-GET "c:\vc\files\project\main.c"
しかし、このコマンドを実行しても、ファイルMAIN.Cしかコピーできません。この問題を解決するために、
High-performance Embedded Workshopにはプレースホルダとディレクトリのマッピングというシステムがあります。マッピングにより、どの「作業中の」ディレクトリ（つまり、作業中のソースファイルがあるディレク

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 158 of 479

High-performance Embedded Workshop V.4.09

8.

カスタムバージョン管理システム

トリ）がどの「管理」ディレクトリ（つまり、バージョン管理システムに保存されているソースファイルのディレクトリ）に対応するかを指定します。これら2つのディレクトリ間のマッピングは、[バージョン管理設定]
ダイアログボックスの[プロジェクト]タブで指定できます。
マッピングを定義すると、Version control directoryプレースホルダ $(VCDIR)を使用してプロジェクトファイルを保存するディレクトリを示すことができます。

新しいマッピングを定義するには
1.

[ツール -> バージョン管理 -> 構成]を選択してください。[バージョン管理設定]ダイアログボックスが開きます。

2.

[プロジェクト]タブを選択してください。

3.

[バージョン管理ディレクトリマッピング]リストの横にある[追加]ボタンをクリックしてください。[バージョン管理ディレクトリマッピング]ダイアログボックスが開きます。

4.

[ソースディレクトリ]にマッピングを作成したいディレクトリを設定してください。以下のいずれかの操作を選択してください。

•

ディレクトリを直接入力する。

•

プレースホルダボタンをクリックして表示されるメニューから、Project directory、またはWorkspace
directoryを選択する。

•[参照]ボタンをクリックして表示される[ソースディレクトリを参照]ダイアログボックスでディレク
トリを選択し、[選択]ボタンをクリックする。

5.

[バージョン管理ディレクトリ]にソースディレクトリへマップするバージョン管理システムのディレ
クトリを入力してください。

6.

[OK]ボタンをクリックしてください。

既存のマッピングを変更するには
1.

[ツール -> バージョン管理 -> 構成]を選択してください。[バージョン管理設定]ダイアログボックスが開きます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 159 of 479

High-performance Embedded Workshop V.4.09

8.

カスタムバージョン管理システム

2.

[プロジェクト]タブを選択してください。

3.

[バージョン管理ディレクトリマッピング]リストから変更するマッピングを選択し、[変更]ボタンをクリックしてください。[バージョン管理ディレクトリマッピング]ダイアログボックスが開きます。

4.

2つのディレクトリを変更して[OK]ボタンをクリックしてください。

既存のマッピングを削除するには1.

[ツール -> バージョン管理 -> 構成]を選択してください。[バージョン管理設定]ダイアログボックスが開きます。

2.

[プロジェクト]タブを選択してください。

3.

[バージョン管理ディレクトリマッピング]リストから削除するマッピングを選択し、[削除]ボタンをクリックしてください。

8.7

ディレクトリマッピング例

マッピングを定義すると、Version control directoryプレースホルダ$(VCDIR)を使用してプロジェクトファイルを保存するディレクトリを示すことができます。以下に例を示します。
ここではネットワークを共有したバージョン管理ドライブ(X:\)と開発が行われているローカルドライブ(C:\)
からマッピングされた3つのディレクトリがあります。

例えば、バージョン管理のアプリケーションに–GETコマンドを使用してファイルの読み出し専用コピーを作成する場合、プロジェクトのすべてのファイルを取得するには以下のコマンドを使用します。
-GET "$(VCDIR)\$(FILENAME)"'
そのプロジェクトファイルのコマンドを実行すると、$(VCDIR)をファイルマッピングの中の対応するバージ
ョン管理ディレクトリに置き換えます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 160 of 479

High-performance Embedded Workshop V.4.09

8.

カスタムバージョン管理システム

例えば、FILE1.CがC:\work\application\project1\file1.cにあるとします。FILE1.Cに-GETコマンドが適用されると、以下のようになります。
1.

$(VCDIR)がX:\vc\sw\app\project1に置き換えられます。これはC:\work\application\project1のバージョ
ン管理ディレクトリマッピングに対応しているためです。

2.

$(FILENAME)がFILE1.Cに置き換えられます。

バージョン管理環境変数を設定する

8.8

現在の設定を確認するには、[バージョン管理設定]ダイアログボックスの[プロジェクト]タブを表示してください。
新しい環境変数を追加するには
1.

[環境]リストの横にある[追加]ボタンをクリックしてください。[環境変数]ダイアログボックスが開きます。

2.

[変数]に環境変数名を入力してください。

3.

[値]に環境変数の値を入力してください。

4.

[OK]ボタンをクリックすると新しい変数を[環境]リストに追加します。

環境変数を変更するには
1.

変更する環境変数を[環境]リストから選択してください。

2.

[変更]ボタンをクリックしてください。

3.

[変数]と[値]を必要に応じて変更してください。

4.

[OK]ボタンをクリックすると変更した環境変数をリストに追加します。

環境変数を削除するには1.

削除する環境変数を[環境]リストから選択してください。

2.

[削除]ボタンをクリックしてください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 161 of 479

High-performance Embedded Workshop V.4.09

8.

カスタムバージョン管理システム

バージョン管理システムの実行を制御する

8.9[バージョン管理設定]ダイアログボックスの[一般]タブでは、使用するバージョン管理システムとHigh-performance Embedded Workshopを制御できます。また、現在のバージョン管理コンフィグレーションファイルへの絶対パスを表示します。
•[コマンド実行前に確認]チェックボックス
このチェックボックスをオンにすると、バージョン管理コマンドを実行する前にダイアログボックスが開きます。このダイアログボックスではコマンドの実行の有無を確認できます。[OK]をクリックすると選択したコマンドを実行します。[キャンセル]をクリックするとコマンドは実行しません。

•[DOSウィンドウで実行]チェックボックス
デフォルトでは、アウトプットウィンドウの[Version Control]タブにバージョン管理コマンドの結果を出力します。
このチェックボックスをオンにすると、各コマンドをDOSウィンドウで実行します。これは、バージョン
管理システムがユーザ入力を要求するメッセージに対して入力が可能になります。
実行終了後にDOSウィンドウを閉じる場合は、[コマンド終了後DOSウィンドウを閉じる]チェックボック
スをオンにしてください。

•[バージョン管理のディレクトリの区切りに'/'を使用]チェックボックス
デフォルトでは、High-performance Embedded Workshopがプレースホルダ$(VCDIR)を置き換えるときバッ
クスラッシュ文字 '¥'（日本語 Windows®では円記号）を使ってディレクトリを区切ります。しかし、使用するバージョン管理システム(例： Visual SourceSafe)で、ディレクトリを区切るときにスラッシュ文字'/'を使う場合は、[バージョン管理のディレクトリの区切りに'/'を使用]チェックボックスをオンにしてスラッシュ文字'/'でディレクトリを区切ってください。

8.10

ユーザ名とパスワードを変更する

バージョン管理ツールでは一般的にユーザ名とパスワードの入力をコマンドラインで行う必要があります。これは、ファイルを保護し、どのファイルがどのユーザによって変更されたかを記録するためです。
バージョン管理システムでは2つのプレースホルダ"User login name", $(USERNAME)と"User login password",$(PASSWORD)をサポートします。コマンドを実行すると、これらのプレースホルダは[バージョン管理設定]
ダイアログボックスの[一般]タブの現在の設定に置き換えます。
プレースホルダ$(USERNAME)と$(PASSWORD)に値を設定するには、最初にログインの指定をしておく必要があります。もしこれらのプレースホルダのうちのどちらかのプレースホルダを使用するコマンドを実行する
前にログイン指定をしていなかった場合、コマンド実行前にログインするよう要求されます。
ユーザ名とパスワードを設定するには（ログインの指定）
1.

[ツール -> バージョン管理 -> 構成]を選択してください。[バージョン管理設定]ダイアログボックスが開きます。

2.

[一般]タブを選択してください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 162 of 479

High-performance Embedded Workshop V.4.09

8.

カスタムバージョン管理システム

3.

[ログイン]ボタンをクリックしてください。[ログイン]ダイアログボックスが開きます。

4.

[ユーザ名]にユーザ名を入力してください。

5.

[パスワード]にパスワードを入力してください。

6.

[確認のためパスワード再入力]にパスワードを再入力してください。

7.

[OK]ボタンをクリックすると新しいユーザ名とパスワードを設定します。[パスワード]と[確認のため
パスワード再入力]で異なるパスワードが入力された場合はもう一度パスワードを入力するよう要求します。

カスタムバージョン管理システムの使用例

8.11

カスタムバージョン管理システムは、MS-DOSコマンドプロンプトからコマンドラインコマンドを実行するバージョン管理システムを対象としています。
ここでは、High-performance Embedded Workshopと下記のバージョン管理システムを接続して使用する例を説明します。
•

High-performance Embedded WorkshopとRCSを接続して使用する•

High-performance Embedded WorkshopとCVSを接続して使用する

8.11.1High-performance Embedded WorkshopとRCSを接続して使用する

High-performance Embedded WorkshopとRCSを接続して使用する例を紹介します。
•

RCSの環境バージョン管理システムは以下を使用します。
o

GNU RCSo

GNU diff

この手順では、上記のバージョン管理システムが"C:\RCS"にあると仮定します。
•

ワークスペース

High-performance Embedded Workshopのワークスペースは、以下のフォルダに作成してください。
C:\WorkSpace\rcs_sample
High-performance Embedded Workshopのワークスペース作成後、RCS管理用フォルダを作成してください。
C:\WorkSpace\rcs_sample\rcs_sample\RCS

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 163 of 479

High-performance Embedded Workshop V.4.09

8.

カスタムバージョン管理システム

ワークスペースの作成、バージョン管理の設定、バージョン管理機能のチェックイン、比較、チェックアウト、
ログの確認の使用手順を説明します。
ステップ 1： ワークスペースを作成する
ステップ 2： カスタムバージョン管理システムを選択する
ステップ 3： バージョン管理を設定する
ステップ 4： バージョン管理機能を使用する（チェックイン）
ステップ 5： バージョン管理機能を使用する（比較）ステップ 6： バージョン管理機能を使用する（チェックアウト）
ステップ 7： バージョン管理機能を使用する（ログの確認）

8.11.1.1
1.

ステップ 1： ワークスペースを作成する[ファイル -> 新規ワークスペース]を選択し、[新規プロジェクトワークスペース]ダイアログボックスを開きます。

2.

3.

下記を指定しワークスペースを作成してください。
•

ワークスペース名： rcs_sample•

プロジェクト名： rcs_sample•

ディレクトリ： C:\WorkSpace\rcs_sample

ワークスペース作成後、RCS管理用フォルダを作成してください。
C:\WorkSpace\rcs_sample\rcs_sample\RCS8.11.1.2
1.

ステップ 2： カスタムバージョン管理システムを選択する[ツール -> バージョン管理 -> 選択]を選択します。[バージョン管理システムの選択]ダイアログボッ
クスが開きます。

2.

[バージョン管理システム]リストから"Custom VCS"を選択します。

3.

[OK]ボタンをクリックします。

8.11.1.3

ステップ 3： バージョン管理を設定する[ツール -> バージョン管理 -> 構成]を選択し、[バージョン管理設定]ダイアログボックスを開きます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 164 of 479

High-performance Embedded Workshop V.4.09•

8.

カスタムバージョン管理システム

環境変数を設定する
1.

[プロジェクト]タブを選択します。

2.

[環境]にある[追加]ボタンをクリックします。[環境変数]ダイアログボックスが開きます。

3.

[変数]に"path"、[値]に"%path%;C:\RCS"を設定します。

4.

[OK]ボタンをクリックします。

5.

同様に[追加]ボタンをクリックし、[環境変数]ダイアログボックスで下記の環境変数も設定します。
LOGNAME=user
TZ=JST-9

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 165 of 479

High-performance Embedded Workshop V.4.09•

8.

カスタムバージョン管理システム

実行時の動作を設定する
1.

[一般]タブを選択します。

2.

[コマンド実行前に確認]チェックボックスをオフにします(コマンド実行前にファイル名を確認したい
場合は、オンのままにしてください)。

3.

[DOSウィンドウで実行]チェックボックスをオンにします(RCSのコマンドにMS-DOSコマンドプロン
プトから入力する必要があるため)。

4.

[コマンド終了後DOSウィンドウを閉じる]チェックボックスをオフにします(エラーをMS-DOSコマン
ドプロンプトで確認するため)。

•コマンドを設定する
1.

[コマンド]タブを選択します。

2.

[ユーザメニューオプション]にある[追加]ボタンをクリックします。[メニューオプションの追加]ダイ
アログボックスが開きます。

3.

[オプション]に"Check in"と入力し、[追加]ボタンをクリックします。[コマンド追加]ダイアログボック
スが開きます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 166 of 479

High-performance Embedded Workshop V.4.09

8.

カスタムバージョン管理システム

4.

[バージョン管理システム]に"C:\RCS\CI.EXE"を設定します。

5.

[引数]に"-l $(FILENAME)"を設定します。

6.

[初期ディレクトリ]に"$(PROJDIR)"を設定します。

7.

[OK]ボタンをクリックします。

8.

[メニューオプションの追加]ダイアログボックスで[OK]ボタンをクリックします。

ポイント：
バージョン管理によく使用するコマンドのみを登録し、あまり使用しないコマンドは、MS-DOSコマンドプロ
ンプトから使用することをお勧めします。
同様に以下の3つのコマンドを設定してください。
コマンド

項目

Check out

Diff

Log

入力内容

Version control executable

C:\RCS\CO.EXE

Arguments-l -f $(FILENAME)

Initial directory$(PROJDIR)

Version control executable

C:\RCS\RCSDIFF.EXE

Arguments$(FILENAME)

Initial directory$(PROJDIR)

Version control executable

C:\RCS\RLOG.EXE

Arguments$(FILENAME)

Initial directory$(PROJDIR)

これでRCSツールを使う準備ができました。

8.11.1.4
1.

ステップ 4： バージョン管理機能を使用する（チェックイン）

ファイルの変更履歴が後で分かるように"rcs_sample.c"ファイルの12行目にキーワードを入力します。
//$Id$

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 167 of 479

High-performance Embedded Workshop V.4.09

2.

8.

カスタムバージョン管理システム

ワークスペースウィンドウの[Projects]タブの"rcs_sample.c"ファイルを選択し、[ツール -> バージョン管理 -> Check in]を選択します。MS-DOSコマンドプロンプトウィンドウが開きます。

3.

プロンプト(">>")に続いてチェックイン時のコメントを入力し、Enterキーを押します。

4.

ピリオド"．"を1文字だけ入力し、Enterキーを押します。
rcs_sample.c,v <-- rcs_sample.center description, terminated with single '.' or end of file:
NOTE: This is NOT the log message!
>> .
initial revision: 1.1
done
C:\RCS>

5.

"exit"を入力しEnterキーを押します。MS-DOSコマンドプロンプトウィンドウが閉じます。

6.

表示されるHigh-performance Embedded Workshopの確認ダイアログボックスで[はい]ボタンをクリック
してください。キーワードがファイル名、リビジョン、日時、ユーザなどに変換されて表示します。

ポイント：
MS-DOSコマンドプロンプトウィンドウでコマンドの実行結果を確認しない場合、[バージョン管理設定]ダイ
アログボックスの[一般]タブの[コマンド終了後DOSウィンドウを閉じる]チェックボックスをオンにしてください。

ステップ 5： バージョン管理機能を使用する（比較）8.11.1.5
1.

チェックインしたファイルと比較するため、"rcs_sample.c"ファイルを編集し上書きします。

2.

ワークスペースウィンドウの[Projects]タブの"rcs_sample.c"ファイルを選択し、[ツール -> バージョン管理 -> Diff]を選択します。MS-DOSコマンドプロンプトウィンドウが開き、比較した結果が表示されます。

3.

"exit"を入力しEnterキーを押します。MS-DOSコマンドプロンプトウィンドウが閉じます。
RCS file: rcs_sample.c,vWorking file: rcs_sample.c
head: 1.1
branch:locks: strict
user: 1.1
access list:
symbolic names:
keyword substitution: kv
total revisions: 1; selected revisions: 1
description:---------------------------revision 1.1

locked by: user;

date: 2006/03/14 07:22:42; author: user; state: Exp;
Initial revision=============================================================================

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 168 of 479

High-performance Embedded Workshop V.4.09

8.

カスタムバージョン管理システム

ステップ 6： バージョン管理機能を使用する（チェックアウト）

8.11.1.6

ファイルで編集した内容を元に戻す場合は、チェックアウトコマンドを実行します。
1.

ワークスペースウィンドウの[Projects]タブの"rcs_sample.c"ファイルを選択し、[ツール -> バージョン管理 -> Check out]を選択します。MS-DOSコマンドプロンプトウィンドウが開き、チェックアウトした結果が表示されます。

2.

"exit"を入力しEnterキーを押します。MS-DOSコマンドプロンプトウィンドウが閉じます。

3.

表示されるHigh-performance Embedded Workshopの確認ダイアログボックスで[はい]ボタンをクリック
してください。ファイルが元に戻ります。
rcs_sample.c,v <-- rcs_sample.center description, terminated with single '.' or end of file:
NOTE: This is NOT the log message!
>> .
initial revision: 1.1
done
C:\RCS>8.11.1.7

ステップ 7： バージョン管理機能を使用する（ログの確認）編集した履歴を確認するため、ログコマンドを実行します。
1.

ワークスペースウィンドウの[Projects]タブの"rcs_sample.c"ファイルを選択し、[ツール -> バージョン管理 -> Log]を選択します。MS-DOSコマンドプロンプトウィンドウが開き、ログが表示されます。

2.

"exit"を入力しEnterキーを押します。MS-DOSコマンドプロンプトウィンドウが閉じます。
CS file: rcs_sample.c,vWorking file: rcs_sample.c
head: 1.1
branch:locks: strict
user: 1.1
access list:
symbolic names:
keyword substitution: kv
total revisions: 1; selected revisions: 1
description:---------------------------revision 1.1 locked by: user;
date: 2006/03/14 07:22:42; author: user; state: Exp;
Initial revision=============================================================================

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 169 of 479

High-performance Embedded Workshop V.4.09

8.11.28.

カスタムバージョン管理システム

High-performance Embedded WorkshopとCVSを接続して使用する

High-performance Embedded WorkshopとCVSを接続して使用する例を紹介します。
•

CVSツールの環境バージョン管理システムは下記を使用します。
o

CVS

この手順では、上記のバージョン管理システムが"C:\cvs-1-11-17"にあると仮定します。
•

ワークスペース

High-performance Embedded Workshopのワークスペースは、以下のフォルダに作成してください。
C:\WorkSpace\sampleCVS
High-performance Embedded Workshopのワークスペース作成後、CVS用ソースファイルフォルダを作成してください。
C:\src\sampleCVS
注：High-performance Embedded WorkshopとCVSを使用したバージョン管理では、管理対象ファイルをソースファ
イルのみとしています。ソースファイル以外のファイル（ワークスペースファイル、プロジェクトファイルなど）は、管理対象とすることができませんのでご注意願います。
ワークスペースの作成、バージョン管理の設定、バージョン管理機能のリポジトリの作成、モジュールの登録、
チェックアウト、ファイルの編集、ステータスの確認、比較、結果の登録、ログの確認の使用手順を説明します。
ステップ 1： ワークスペースを作成する
ステップ 2： カスタムバージョン管理システムを選択する
ステップ 3： バージョン管理を設定する
ステップ 4： バージョン管理機能を使用する（リポジトリの作成）
ステップ 5： バージョン管理機能を使用する（モジュールの登録）
ステップ 6： バージョン管理機能を使用する（チェックアウト）
ステップ 7： バージョン管理機能を使用する（ファイルの編集）
ステップ 8： バージョン管理機能を使用する（ステータスの確認）
ステップ 9： バージョン管理機能を使用する（比較）ステップ10： バージョン管理機能を使用する（結果の登録）
ステップ11： バージョン管理機能を使用する（ログの確認）

8.11.2.1
1.

ステップ 1： ワークスペースを作成する[ファイル -> 新規ワークスペース]を選択し、[新規プロジェクトワークスペース]ダイアログボックスを開きます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 170 of 479

High-performance Embedded Workshop V.4.09

2.

8.

カスタムバージョン管理システム

下記を指定しワークスペースを作成してください。
•

ワークスペース名：sampleCVS•

プロジェクト名：sampleCVS•

ディレクトリ：C:\WorkSpace\sampleCVS

3.

High-performance Embedded Workshopを終了します。

4.

CVS用ソースファイルフォルダを作成してください。
C:\src\sampleCVS

5.

バージョン管理ツールで管理するファイルを"C:\WorkSpace\sampleCVS\sampleCVS"から"C:\src\sampleCVS"へ移動します。

6.

High-performance Embedded Workshopを起動し、作成した"sampleCVS"ワークスペースを開きます。

7.

[プロジェクト -> ファイルの削除]メニューを選択し、[プロジェクトファイルの削除]ダイアログボッ
クスを開きます。

8.

バージョン管理するファイルを選択し、[削除]ボタンをクリックします。

9.

[OK]ボタンをクリックします。

10. [プロジェクト -> ファイルの追加]メニューを選択し、['sampleCVS'プロジェクトにファイルの追加]
ダイアログボックスを開きます。
11. バージョン管理するファイルを選択し、[追加]ボタンをクリックします。

8.11.2.2
1.

ステップ 2： カスタムバージョン管理システムを選択する[ツール -> バージョン管理 -> 選択]を選択します。[バージョン管理システムの選択]ダイアログボッ
クスが開きます。

2.

[バージョン管理システム]リストから"Custom VCS"を選択します。

3.

[OK]ボタンをクリックします。

8.11.2.3

ステップ 3： バージョン管理を設定する[ツール -> バージョン管理 -> 構成]を選択し、[バージョン管理設定]ダイアログボックスを開きます。
•

環境変数を設定する
1.

[プロジェクト]タブを選択します。

2.

[環境]にある[追加]ボタンをクリックします。[環境変数]ダイアログボックスが開きます。

3.

[変数]に"CVSROOT"、[値]に"C:\cvs-1-11-17\DATABASE"を設定します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 171 of 479

High-performance Embedded Workshop V.4.09

4.
•

8.

カスタムバージョン管理システム[OK]ボタンをクリックします。

コマンドを設定する
1.

[コマンド]タブを選択します。

2.

[ユーザメニューオプション]にある[追加]ボタンをクリックします。[メニューオプションの追加]ダイ
アログボックスが開きます。

3.

[オプション]に"Initialize"と入力し、[追加]ボタンをクリックします。[コマンド追加]ダイアログボック
スが開きます。

4.

[バージョン管理システム]に"C:\cvs-1-11-17\cvs.exe"を設定します。

5.

[引数]に"init"を設定します。

6.

[初期ディレクトリ]に"C:\src\sampleCVS"を設定します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 172 of 479

High-performance Embedded Workshop V.4.09

8.

カスタムバージョン管理システム

7.

[OK]ボタンをクリックします。

8.

[メニューオプションの追加]ダイアログボックスで[OK]ボタンをクリックします。

同様に以下の6つのコマンドを設定してください。
コマンド
Register

Checkout

StatusDiff

Commit

Log

項目

入力内容

Version control executable

C:\cvs-1-11-17\cvs.exe

Arguments

import -m "New Source" sampleCVS Renesas rel-20060228

Initial directory

C:\src\sampleCVS

Version control executable

C:\cvs-1-11-17\cvs.exe

Arguments

checkout sampleCVS

Initial directory

C:\srcVersion control executable

C:\cvs-1-11-17\cvs.exe

Arguments

status $(FILENAME)

Initial directory

C:\src\sampleCVS

Version control executable

C:\cvs-1-11-17\cvs.exe

Arguments

diff $(FILENAME)

Initial directory

C:\src\sampleCVS

Version control executable

C:\cvs-1-11-17\cvs.exe

Arguments

commit -m "modify" $(FILENAME)

Initial directory

C:\src\sampleCVS

Version control executable

C:\cvs-1-11-17\cvs.exe

Arguments

log $(FILENAME)

Initial directory

C:\src\sampleCVS

これでCVSツールを使う準備ができました。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 173 of 479

High-performance Embedded Workshop V.4.09

8.11.2.4

8.

カスタムバージョン管理システム

ステップ 4： バージョン管理機能を使用する（リポジトリの作成）

1.

[ツール -> バージョン管理 -> Initialize]メニューを選択します。

2.

[Initialize]ダイアログボックスでファイルを選択し[OK]ボタンをクリックします。アウトプットウィン
ドウの[Version Control]タブに下記のメッセージが表示されます。
Executing C:\cvs-1-11-17\cvs.exe init
Command(s) completed successfully.

8.11.2.5

ステップ 5： バージョン管理機能を使用する（モジュールの登録）

1.

[ツール -> バージョン管理 -> Register]メニューを選択します。

2.

[Register]ダイアログボックスでファイルを選択し[OK]ボタンをクリックします。アウトプットウィン
ドウの[Version Control]タブに下記のメッセージが表示されます。
Executing C:\cvs-1-11-17\cvs.exe import -m "New Source" sampleCVS Renesas rel-20060228
N sampleCVS/dbsct.c(省略)
No conflicts created by this import
Command(s) completed successfully.

8.11.2.6

ステップ 6： バージョン管理機能を使用する（チェックアウト）

1.

[ツール -> バージョン管理 -> Checkout]メニューを選択します。

2.

[Checkout]ダイアログボックスでファイルを選択し[OK]ボタンをクリックします。アウトプットウィン
ドウの[Version Control]タブに下記のメッセージが表示されます。
Executing C:\cvs-1-11-17\cvs.exe checkout sampleCVS
U sampleCVS/dbsct.c(省略)
cvs.exe checkout: Updating sampleCVS
Command(s) completed successfully.

8.11.2.7

ステップ 7： バージョン管理機能を使用する（ファイルの編集）

High-performance Embedded Workshopのエディタでファイルを編集し上書きします。例として"sampleCVS.c"ファイルを修正します。

8.11.2.8

ステップ 8： バージョン管理機能を使用する（ステータスの確認）

1.

"sampleCVS.c"ファイルのステータスを確認します。

2.

[ツール -> バージョン管理 -> Status]メニューを選択します。

3.

[Status]ダイアログボックスでファイルを選択し[OK]ボタンをクリックします。アウトプットウィンド
ウの[Version Control]タブに下記のメッセージが表示されます。
Executing C:\cvs-1-11-17\cvs.exe status sampleCVS.c===================================================================
File: sampleCVS.c Status: Locally Modified

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 174 of 479

High-performance Embedded Workshop V.4.09

8.

カスタムバージョン管理システム

Working revision: 1.1.1.1 Tue Feb 28 02:46:30 2006
Repository revision: 1.1.1.1 C:\cvs-1-11-17\DATABASE/sampleCVS/sampleCVS.c,v
Sticky Tag: (none)
Sticky Date: (none)
Sticky Options: (none)
Command(s) completed successfully.
"sampleCVS.c"ファイルのステータスが、"Locally Modified"(修正されている)と確認できます。

ステップ 9： バージョン管理機能を使用する（比較）8.11.2.9
1.

"sampleCVS.c"ファイルの修正内容を確認します。

2.

[ツール -> バージョン管理 -> Diff]メニューを選択します。

3.

[Diff]ダイアログボックスでファイルを選択し[OK]ボタンをクリックします。アウトプットウィンドウの[Version Control]タブに下記のメッセージが表示されます。
Executing C:\cvs-1-11-17\cvs.exe diff sampleCVS.c
Index: sampleCVS.c===================================================================
RCS file: C:\cvs-1-11-17\DATABASE/sampleCVS/sampleCVS.c,v
retrieving revision 1.1.1.1
diff -r1.1.1.1 sampleCVS.c
28c28,31< printf("### Data Input ###\n");--> //無限ループ追加> while(1)>{> printf("### Data Input ###\n"); //無限ループ開始
49a53,54> //無限ループ終了>}
Command(s) completed successfully.

"sampleCVS.c"ファイルの修正内容が、確認できます。

8.11.2.10

ステップ 10： バージョン管理機能を使用する（結果の登録）

1.

[ツール -> バージョン管理 -> Commit]メニューを選択します。

2.

[Commit]ダイアログボックスでファイルを選択し[OK]ボタンをクリックします。アウトプットウィン
ドウの[Version Control]タブに下記のメッセージが表示されます。
Executing C:\cvs-1-11-17\cvs.exe commit -m "modify" sampleCVS.c
Checking in sampleCVS.c;
C:\cvs-1-11-17\DATABASE/sampleCVS/sampleCVS.c,v <-- sampleCVS.c

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 175 of 479

High-performance Embedded Workshop V.4.09

8.

カスタムバージョン管理システム

new revision: 1.2; previous revision: 1.1
done
Command(s) completed successfully.

8.11.2.11

ステップ 11： バージョン管理機能を使用する（ログの確認）

1.

[ツール -> バージョン管理 -> Log]メニューを選択します。

2.

[Log]ダイアログボックスでファイルを選択し[OK]ボタンをクリックします。アウトプットウィンドウの[Version Control]タブに下記のメッセージが表示されます。
Executing C:\cvs-1-11-17\cvs.exe log sampleCVS.c
RCS file: C:\cvs-1-11-17\DATABASE/sampleCVS/sampleCVS.c,vWorking file: sampleCVS.c
head: 1.2
branch:locks: strict
access list:
symbolic names:
rel-20060228: 1.1.1.1
Renesas: 1.1.1
keyword substitution: kv
total revisions: 3; selected revisions: 3
description:---------------------------revision 1.2
date: 2006/02/28 03:39:22; author: user; state: Exp; lines: +6 -1
modify---------------------------revision 1.1
date: 2006/02/28 02:46:30; author: user; state: Exp;
branches: 1.1.1;
Initial revision---------------------------revision 1.1.1.1
date: 2006/02/28 02:46:30; author: user; state: Exp; lines: +0 -0
New Source======================================================================
Command(s) completed successfully.

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 176 of 479

High-performance Embedded Workshop V.4.099.

9.

Visual SourceSafe バージョン管理システム

Visual SourceSafeバージョン管理システム

High-performance Embedded WorkshopはMicrosoft® Visual SourceSafeバージョン管理システムをサポートしています。
Visual SourceSafeバージョン管理システムでは、Microsoft® Visual SourceSafeデータベースの中のプロジェクトとHigh-performance Embedded Workshopのワークスペースの中のプロジェクトを関連付けます。[ツール -> バージョン管理]サブメニューからメニューオプションを選択するか、[バージョン管理]ツールバーボタンをクリックすることにより、Microsoft® Visual SourceSafeバージョン管理システムで最もよく使用されるコマンドを容易に起動できます。
Microsoft® Visual SourceSafeのインストールおよびオプションの設定は、Microsoft® Visual SourceSafeのヘルプ
またはマニュアルを参照してください。Microsoft® Visual SourceSafeのログイン名、パスワードは設定済みとして説明します。
High-performance Embedded WorkshopとMicrosoft® Visual SourceSafeバージョン管理システムを接続した場合のバージョン管理の簡単な流れを以下に示します。他に利用できる機能について、詳しくは「9.2 Visual SourceSafe
コマンド」を参照してください。
ワークスペースとMicrosoft® Visual SourceSafeを関連付ける

1.

High-performance Embedded Workshopのワークスペースの中のプロジェクトとMicrosoft® Visual
SourceSafeデータベースの中のプロジェクトを関連付けます。
•"Microsoft Visual SourceSafe"をHigh-performance Embedded Workshopと接続するバージョン管理シス
テムとして選択する。

2.

•

Microsoft® Visual SourceSafeへログインする。

•

Microsoft® Visual SourceSafeに作成するプロジェクト名、および作成する位置を設定する。
ファイルを追加する

High-performance Embedded WorkshopのワークスペースでMicrosoft® Visual SourceSafeのプロジェクトに追加するファイルを選択します。
3.

ファイルをチェックアウトする
High-performance Embedded Workshopのワークスペースで編集するファイルを選択しチェックアウトします。

4.

ファイルをチェックインする
High-performance Embedded Workshopのワークスペースで編集したファイルを選択しチェックインします。

ワークスペースにVisual SourceSafeを関連付ける

9.1

Microsoft® Visual SourceSafeとHigh-performance Embedded Workshopの現在のワークスペースとを関連付ける方法を説明します。
まず、Microsoft® Visual SourceSafeをバージョン管理システムとして選択します。
ワークスペースにMicrosoft® Visual SourceSafeを関連付けるには1.

[ツール -> バージョン管理 -> 選択]を選択します。[バージョン管理システムの選択]ダイアログボッ
クスが開きます。

2.

[バージョン管理システム]リストから[Microsoft Visual SourceSafe]を選択します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 177 of 479

High-performance Embedded Workshop V.4.09

9.

Visual SourceSafe バージョン管理システム

3.

[OK] ボタンをクリックします。[SourceSafeログイン]ダイアログボックスが開きます。

4.

[ユーザ名]にVisual SourceSafeのログイン名を、[パスワード]にパスワードを入力してください。

5.

[データベースパス]にプロジェクトを追加するVisual SourceSafeデータベースファイル（SRCSAFE.INI）を指定します。以下のいずれかの操作を選択してください。

•[参照]ボタンをクリックしてください。[Visual SourceSafeデータベースの選択]ダイアログボックスが開きます。プロジェクトを追加するVisual SourceSafeデータベースファイルを選択し[選択]ボタンをクリックしてください。

•

プロジェクトを追加するVisual SourceSafeデータベースファイルへの絶対パスを[データベースパス]に入力してください。

6.

[SourceSafeログイン]ダイアログボックスの[ログイン]ボタンをクリックしてください。[ワークスペー
ス用SourceSafeプロジェクトの作成]ダイアログボックスが開きます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 178 of 479

High-performance Embedded Workshop V.4.09

7.

9.

Visual SourceSafe バージョン管理システム[プロジェクト名]に、あらかじめHigh-performance Embedded Workshopのワークスペース名が表示されます。データベースに作成するプロジェクト名（フォルダ名）です。プロジェクト名は変更できます。

8.

[プロジェクト名]フィールド下のツリーにはステップ5で指定したデータベース構造が表示されます。
[プロジェクト名]に指定したフォルダをどのフォルダ内に作成するかを選択してください。

9.

[ワークスペース用SourceSafeプロジェクトの作成]ダイアログボックスの[OK] ボタンをクリックしてください。[SourceSafeプロジェクト作成]ダイアログボックスが開きます。下の図の例では、High-performance Embedded Workshopのワークスペース"Workspace_Name"がプロジェクト名"Workspace_Name"としてデータベースに追加されました。[プロジェクト名]には、次に作成する
High-performance Embedded Workshopのプロジェクト"Project_Name"があらかじめ表示されています。

10. [SourceSafeプロジェクト作成]ダイアログボックスの[OK] ボタンをクリックしてください。
11. 現在のワークスペースにあるプロジェクトの数だけ、ステップ10を繰り返してください。
Visual SourceSafeのプロジェクトとサブプロジェクト、High-performance Embedded Workshopのワークスペースとプロジェクト、およびハードディスク上のワークスペースディレクトリの階層イメージを以下の図に示します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 179 of 479

High-performance Embedded Workshop V.4.09

9.

Visual SourceSafe バージョン管理システム

High-performance Embedded Workshopは、Visual SourceSafe内に必要なプロジェクトを作成し、容易にアクセスできるように、バージョン管理ツールバーやメニューを設定します。

9.2

Visual SourceSafeコマンド

バージョン管理ツールバーやメニューを使用することにより以下の8つの操作が使用可能です。
[ツール -> バージョン管理]メニュー

機能[バージョン管理]ツールバー

ファイルの追加

Visual SourceSafe にファイルを追加します。

ファイルの削除Visual SourceSafe からファイルを削除します。

ファイルの取得

Visual SourceSafe からファイルの読み取り専用
コピーを取得します。
Visual SourceSafe からファイルの書き込み可能

ファイルのチェックアウト

コピーをチェックアウトします。
ファイルのチェックイン

Visual SourceSafe にファイルの書き込み可能コ
ピーをチェックインします。

ファイルの状態

Visual SourceSafe のファイルの状態を表示します。

チェックアウトの取り消し-

Visual SourceSafe のチェックアウトコマンドを取り消します。

履歴表示-

Visual SourceSafe のファイル履歴を表示しま
す。

9.2.1

Visual SourceSafeにファイルを追加する

前節では、ハードディスク上のワークスペースディレクトリ（作業中ディレクトリ）とVisual SourceSafeのプ
ロジェクトディレクトリ（Visual SourceSafeによって管理されたディレクトリ）との間でマッピングを確立しました。ハードディスクのプロジェクトディレクトリ（サブディレクトリを含む）に複数のソースファイルがあってもマッピング先のVisual SourceSafeのプロジェクトディレクトリにはファイルがありません。
まず、Visual SourceSafeにファイルを追加します。
Visual SourceSafeにファイルを追加するには
1.

ワークスペースウィンドウの[Projects]タブで、Visual SourceSafeに追加するファイル（複数選択可）を選択してください。ファイルフォルダ、プロジェクトフォルダ、ワークスペースフォルダ、またはそれらを混在して選択することもできます。プロジェクトフォルダ、またはワークスペースフォルダを選択すると、High-performance Embedded Workshopのシステムファイルをファイルリストに追加しま

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 180 of 479

High-performance Embedded Workshop V.4.09

9.

Visual SourceSafe バージョン管理システム

す。例えば、プロジェクトフォルダを選択すると、プロジェクトファイル（.HWP）が[ファイル]リス
トへ追加されます。プロジェクトファイルがチェックアウトされ、バージョンが最後にロードしたと
きより新しい場合、そのプロジェクトを再読み込みしたいかどうかをユーザに問い合わせます。
2.

以下のいずれかの操作を選択してください。[ファイルの追加]ダイアログボックスが開きます。

•[ファイルの追加]ツールボタン(•[ツール -> バージョン管理 -> ファイルの追加]を選択する。

•

右クリックしポップアップメニューを表示します。[バージョン管理 -> ファイルの追加]を選択する。

3.

追加するファイルの左のチェックボックスをオンにし[OK]ボタンをクリックしてください。

)をクリックする。

Visual SourceSafeにファイルを追加すると、作業中フォルダのローカルファイルは読み取り専用になります。
ファイルを追加する際に[ファイルの追加]ダイアログボックスの[チェックアウトを保持]チェックボックスをオンにすると、ファイルを追加した後もファイルをチェックアウトされた状態で書き込み可能にできます。
ファイルが追加されたことの確認や、プロジェクト内のすべてのファイル状態を表示するには、以下を行って
ください。
1.

ワークスペースウィンドウの[Projects]タブで、チェックしたいファイルのプロジェクトフォルダを選択してください。

2.

以下のいずれかの操作を選択してください。ファイルの状態の表示先は、アウトプットウィンドウの[Version Control]タブまたは[ファイルの状態]ダイアログボックスです。ファイル状態の表示先の設定
は、「9.3 Visual SourceSafeコマンドのオプション」を参照してください。表示された情報により、ファイルがプロジェクトに追加されたかどうか、ファイルがチェックアウトされたかどうか、また、どのユーザによってチェックアウトされたなどの状態も確認できます。

•

ファイルの状態ツールボタン(•[ツール -> バージョン管理 -> ファイルの状態]を選択する。

•

右クリックしポップアップメニューを表示します。[バージョン管理->ファイルの状態]を選択する。

9.2.2)をクリックする。

Visual SourceSafeからファイルを削除する

Visual SourceSafeに追加したファイルをVisual SourceSafeによる管理から外す場合は、Visual SourceSafeからファイルを削除します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 181 of 479

High-performance Embedded Workshop V.4.09

9.

Visual SourceSafe バージョン管理システム

Visual SourceSafeからファイルを削除するには
1.

ワークスペースウィンドウの[Projects]タブで、Visual SourceSafeから削除するファイルを選択してください。ファイルフォルダ、プロジェクトフォルダ、ワークスペースフォルダ、またはこれらを混在させて選択することもできます。

2.

以下のいずれかの操作を選択してください。[ファイルの削除]ダイアログボックスが開きます。

•[ファイルの削除]ツールバーボタン(•[ツール -> バージョン管理 -> ファイルの削除]を選択する。

•

右クリックしポップアップメニューを表示します。[バージョン管理 -> ファイルの削除]を選択する。

3.

削除するファイルの左のチェックボックスをオンにし[OK]ボタンをクリックしてください。

9.2.3)をクリックする。

Visual SourceSafeからファイルの読み取り専用コピーを取得する

Visual SourceSafeはソースファイルを保護して、管理しているファイルの書き込み可能なコピーを一度に一人のユーザだけが取得できるようにします。しかし、どのユーザもすべてのファイルの読み取り専用コピーを取得できます。
Visual SourceSafeからファイルの読み取り専用コピーを取得するには
1.

ワークスペースウィンドウの[Projects]タブで、Visual SourceSafeから取得するファイルを選択してください。ファイルフォルダ、プロジェクトフォルダ、ワークスペースフォルダ、またはこれらを混在して選択することもできます。

2.

以下のいずれかの操作を選択してください。[ファイルの取得]ダイアログボックスが開きます。

•[ファイルの取得]ツールバーボタン(•[ツール -> バージョン管理 -> ファイルの取得]を選択する。

•

右クリックしポップアップメニューを表示します。[バージョン管理 -> ファイルの取得]を選択する。

R20UT0372JJ0100 Rev.1.00
2011.02.01)をクリックする。

Page 182 of 479

High-performance Embedded Workshop V.4.09

3.

9.

Visual SourceSafe バージョン管理システム

取得するファイルの左のチェックボックスをオンにし[OK]ボタンをクリックしてください。

9.2.4

Visual SourceSafeからファイルの書き込み可能コピーをチェックアウトする

Visual SourceSafeはソースファイルを保護して、管理しているファイルの書き込み可能コピーを一度に一人のユーザだけが取得できるようにします。チェックアウト操作をすると、Visual SourceSafeからファイルの書き込み可能コピーをローカルドライブに取得します。これは、チェックアウトしようとするファイルが既に他のユーザによりチェックアウト（ファイル名の横に青いチェックマーク）されていない場合のみ可能です。
Visual SourceSafeからファイルの書き込み可能コピーをチェックアウトするには1.

ワークスペースウィンドウの[Projects]タブで、Visual SourceSafeからチェックアウトしたいファイルを選択してください。ファイルフォルダ、プロジェクトフォルダ、ワークスペースフォルダ、またはこれらを混在して選択することもできます。

2.

以下のいずれかの操作を選択してください。[ファイルのチェックアウト]ダイアログボックスが開きます。

•[ファイルのチェックアウト]ツールバーボタン(•[ツール -> バージョン管理 -> ファイルのチェックアウト]を選択する。

•

右クリックしポップアップメニューを表示します。[バージョン管理 -> ファイルのチェックアウト])をクリックする。

を選択する。

3.

チェックアウトするファイルの左のチェックボックスをオンにし[OK]ボタンをクリックしてください。操作が完了すると、ファイル名の横に赤いチェックマークが付き、チェックアウトされたことを示します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 183 of 479

High-performance Embedded Workshop V.4.09

9.2.5

9.

Visual SourceSafe バージョン管理システム

Visual SourceSafeにファイルの書き込み可能コピーをチェックインする

Visual SourceSafeはソースファイルを保護して、管理しているファイルの書き込み可能コピーを一度に一人のユーザだけが取得できるようにします。チェックアウト操作をすると、Visual SourceSafeからファイルの書き込み可能コピーをローカルドライブに取得します。チェックアウトしたファイルを編集してチェックインすると、他のユーザが編集結果を参照できるようになります。
編集したファイルをVisual SourceSafeにチェックインするには1.

ワークスペースウィンドウの[Projects]タブで、Visual SourceSafeに再びチェックインするファイルを選択してください。複数のファイルを選択できます。ファイルフォルダ、プロジェクトフォルダ、ワークスペースフォルダ、またはこれらを混在して選択することもできます。

2.

以下のいずれかの操作を選択してください。[ファイルのチェックイン]ダイアログボックスが開きます。

•[ファイルのチェックイン]ツールバーボタン(•[ツール -> バージョン管理 -> ファイルのチェックイン]を選択する。

•

右クリックしポップアップメニューを表示します。[バージョン管理 -> ファイルのチェックイン]を選)をクリックする。

択する。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 184 of 479

High-performance Embedded Workshop V.4.09

9.

Visual SourceSafe バージョン管理システム

3.

チェックインするファイルの左のチェックボックスをオンにし[OK]ボタンをクリックしてください。

4.

ファイル名の横の赤いチェックマークが外れ、チェックインされたことを示します。ファイルをチェ
ックインする際に[ファイルのチェックイン]ダイアログボックスの[チェックアウトを保持]チェックボックスをオンにすると、ファイルをチェックインした後もファイルをチェックアウトされた状態で書き込み可能にできます。

9.2.6

Visual SourceSafeのファイルの状態を表示する

High-performance Embedded Workshopプロジェクトにファイルが表示されても（ワークスペースウィンドウの[Projects]タブ）、ファイルがVisual SourceSafeに管理されているとは限りません。Visual SourceSafeに管理されているファイルのうち、チェックインされたり、チェックアウト（編集するため）されたりするものがあります。ファイルの状態コマンドは、現在のファイルの状態を表示します。
ファイルの状態の表示先は、アウトプットウィンドウの[Version Control]タブまたは[ファイルの状態]ダイアロ
グボックスです。ファイル状態の表示先の設定は、「9.3 Visual SourceSafeコマンドのオプション」を参照してください。
Visual SourceSafeのファイルの状態を表示するには
1.

ワークスペースウィンドウの[Projects]タブで、状態を表示するファイルを選択してください。複数のファイルを選択することもできます。ファイルフォルダ、プロジェクトフォルダ、ワークスペースフ
ォルダ、またはこれらを混在して選択できます。

2.

以下のいずれかの操作を選択してください。アウトプットウィンドウの[Version Control]タブまたは[ファイルの状態]ダイアログボックスにファイルの状態を表示します。

•[ファイルの状態]ツールバーボタン(•[ツール -> バージョン管理 -> ファイルの状態]を選択する。

•

右クリックしポップアップメニューを表示します。[バージョン管理 -> ファイルの状態]を選択する。

R20UT0372JJ0100 Rev.1.00
2011.02.01)をクリックする。

Page 185 of 479

High-performance Embedded Workshop V.4.09

9.2.7

9.

Visual SourceSafe バージョン管理システム

Visual SourceSafeのチェックアウトコマンドを取り消す

Visual SourceSafeはソースファイルを保護して、管理しているファイルの書き込み可能コピーを一度に一人のユーザだけが取得できるようにします。チェックアウト操作をすると、Visual SourceSafeからファイルの書き込み可能コピーをローカルドライブに取得します。チェックアウトしたファイルを編集してチェックインすると、他のユーザが編集結果を参照できるようになります。しかし、もしチェックアウト操作を誤って行った場
合、または必要なくなった場合、チェックアウト操作を取り消すことができます。
Visual SourceSafeからのファイルのチェックアウト操作を取り消すには1.

ワークスペースウィンドウの[Projects]タブで、以前のチェックアウト操作を取り消したいファイルを選択してください。ファイルフォルダ、プロジェクトフォルダ、ワークスペースフォルダ、またはこれらを混在して選択することもできます。

2.

以下のいずれかの操作を選択してください。[チェックアウトの取り消し]ダイアログボックスが開きます。

•[ツール -> バージョン管理 -> チェックアウトの取り消し]を選択する。

•

右クリックしポップアップメニューを表示します。[バージョン管理 -> チェックアウトの取り消し]を選択する。

3.

チェックアウト操作を取り消すファイルの左のチェックボックスをオンにし[OK]ボタンをクリックしてください。

4.

ファイルが変更されていると、以下の確認メッセージボックスが表示されます。チェックアウト操作を継続する場合は、[キャンセル]ボタンをクリックしてください。バージョン管理システムから変更
前の内容を読み込むには[はい]ボタンをクリックしてください。[いいえ]ボタンをクリックした場合
は、ローカルファイルとバージョン管理システムのファイル内容が不一致になります。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 186 of 479

High-performance Embedded Workshop V.4.09

9.2.8

9.

Visual SourceSafe バージョン管理システム

Visual SourceSafeのファイル履歴を表示する

Visual SourceSafeはプロジェクトのファイルへの編集を管理します。ファイルが最初にプロジェクトに追加されたときからの編集内容のファイル履歴を表示できます。
ファイル履歴の表示先は、アウトプットウィンドウの[Version Control]タブまたは[ファイルの履歴]ダイアログ
ボックスです。ファイル履歴の表示先の設定は、「9.3 Visual SourceSafeコマンドのオプション」を参照してく
ださい。
Visual SourceSafeのファイル履歴を表示するには
1.

ワークスペースウィンドウの[Projects]タブで、ファイル履歴を表示するファイルを選択してください。
複数のファイルを選択できます。ファイルフォルダ、プロジェクトフォルダ、ワークスペースフォル
ダ、またはこれらを混在してを選択できます。

2.

以下のいずれかの操作を選択してください。アウトプットウィンドウの[Version Control]タブまたは[ファイルの履歴]ダイアログボックスにファイル履歴を表示します。

•[ツール -> バージョン管理 -> 履歴表示]を選択する。

•

右クリックしポップアップメニューを表示します。[バージョン管理 -> 履歴表示]を選択する。

9.3

Visual SourceSafeコマンドのオプション[ツール -> バージョン管理 -> 構成]を選択すると、履歴コマンドや状態コマンドの表示方法を変更できます。
1.

[ツール -> バージョン管理 -> 構成]を選択してください。[バージョン管理設定]ダイアログボックスが開きます。

2.

[一般]タブを選択してください。

3.

履歴コマンドの結果をダイアログボックスで表示するには、[履歴をダイアログボックスに表示]チェ
ックボックスをオンにしてください。履歴コマンドの結果をアウトプット ウィンドウの[Version
Control]タブに表示するには、[履歴をダイアログボックスに表示]チェックボックスをオフにしてください。

4.

状態コマンドの結果をダイアログボックスで表示するには、[ファイルの状態をダイアログボックスに表示]チェックボックスをオンにしてください。状態コマンドの結果をアウトプット ウィンドウの[Version Control]タブに表示するには、[ファイルの状態をダイアログボックスに表示]チェックボック
スをオフにしてください。

9.4

バージョン管理設定内容

High-performance Embedded WorkshopとVisual SourceSafeを接続して使用する際の一般的な表示、設定を行います。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 187 of 479

High-performance Embedded Workshop V.4.09

1.

9.

Visual SourceSafe バージョン管理システム[ツール -> バージョン管理 -> 構成]を選択してください。[バージョン管理設定]ダイアログボックスが開きます。

2.

[一般]タブを選択してください。

3.

[ユーザ詳細]グループボックスにVisual SourceSafeにログインしているユーザ名、パスワード、および
データベースを表示します。

4.

[ログイン]ボタンをクリックすると、ユーザ名、パスワード、およびデータベースを変更できます。

5.

[構成ファイル]グループボックスに現在のバージョン管理構成ファイルを表示します。バージョン管
理設定の詳細が保存されている構成ファイルです。

9.5

ディレクトリをマッピングする

プロジェクトの現在のマッピング情報を表示します。
[プロジェクトのマッピングを表示]ドロップダウンリストでマッピングを表示するプロジェクトを選択します。リストにHigh-performance Embedded Workshopのワークスペースおよびプロジェクトのディレクトリ、およびVisual SourceSafeのプロジェクトのディレクトリを表示します。プロジェクトのマッピングは、追加、変更、または削除できます。
詳細は、「8.6 ディレクトリをマッピングする」を参照してください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 188 of 479

High-performance Embedded Workshop V.4.09

9.

Visual SourceSafe バージョン管理システム

新しいマッピングを定義するには
1.

[ツール -> バージョン管理 -> 構成]を選択してください。[バージョン管理設定]ダイアログボックスが開きます。

2.

[マッピング]タブを選択してください。

3.

[追加]ボタンをクリックしてください。[バージョン管理ディレクトリマッピング]ダイアログボックスが開きます。

4.

[ソースディレクトリ]にHigh-performance Embedded Workshopのワークスペースまたはプロジェクトのディレクトリを設定します。以下のいずれかの操作を選択してください。

•

ディレクトリを直接入力する。

•

プレースホルダボタンをクリックして表示されるメニューから、Project directory、またはWorkspace
directoryを選択する。

•[参照]ボタンをクリックして表示される[ソースディレクトリを参照]ダイアログボックスでディレク
トリを選択し、[選択]ボタンをクリックする。

5.

[バージョン管理ディレクトリ]にソースディレクトリへマップするVisual SourceSafeのプロジェクトのディレクトリを入力してください。

6.

[OK]ボタンをクリックしてください。

既存のマッピングを変更するには
1.

[ツール -> バージョン管理 -> 構成]を選択してください。[バージョン管理設定]ダイアログボックスが開きます。

2.

[マッピング]タブを選択してください。

3.

マッピングを変更するリストを選択し、[変更]ボタンをクリックしてください。[バージョン管理ディレクトリマッピング]ダイアログボックスが開きます。

4.

[バージョン管理ディレクトリマッピング]ダイアログボックスで新しいマッピングを定義したときと同様の手順で設定し、マッピングを変更してください。

5.

[OK]ボタンをクリックしてください。

既存のマッピングを削除するには1.

[ツール -> バージョン管理 -> 構成]を選択してください。[バージョン管理設定]ダイアログボックスが開きます。

2.

[マッピング]タブを選択してください。

3.

マッピングを削除するリストを選択し[削除]ボタンをクリックしてください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 189 of 479

High-performance Embedded Workshop V.4.09

9.6

9.

Visual SourceSafe バージョン管理システム

Visual SourceSafeコマンドを追加する[バージョン管理設定]ダイアログボックスの[カスタムコマンド]タブでバージョン管理サブメニューにない
Visual SourceSafeのコマンドを定義したメニューを追加できます。
このメニューを選択すると定義したコマンドが起動できます。このコマンド実行した際の出力情報はアウトプ
ットウィンドウの[Version Control]タブに表示されます。
[ツール->バージョン管理->構成]を選択し、[バージョン管理設定]ダイアログボックスを開きます。
ここでは、Visual SourceSafeのPropertiesコマンドの定義を例に説明します。

•

バージョン管理コマンド実行時の制御
1.

[コマンド実行前に確認]チェックボックスをオンにします。

2.

[DOSウィンドウで実行]チェックボックスをオフにします。Visual SourceSafeはこのフォーマットを使
用します。

3.

[バージョン管理のディレクトリの区切りに'/'を使用]チェックボックスをオンにします。Visual
SourceSafeはこのフォーマットを使用します。
詳細は、「8.9 バージョン管理システムの実行を制御する」を参照してください。

•

コマンド追加1.

[追加]ボタンをクリックします。[メニューオプションの追加]ダイアログボックスが開きます。

2.

[オプション]に"Properties"と入力し、[追加]ボタンをクリックします。[コマンド追加]ダイアログボッ
クスが開きます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 190 of 479

High-performance Embedded Workshop V.4.09

3.

9.

Visual SourceSafe バージョン管理システム[バージョン管理システム]にバージョン管理システムの実行可能ファイル(SS.EXE)を入力してください。

4.

[引数]に"Properties -y$(USERNAME),$(PASSWORD) -i- $(VCDIR)/$(FILENAME)"を設定します。

5.

[初期ディレクトリ]に"$(FILEDIR)"を設定します。

6.

[OK]ボタンをクリックします。

7.

[メニューオプションの追加]ダイアログボックスで[OK]ボタンをクリックします。
詳細は、「8.2 バージョン管理コマンドを定義する」を参照してください。

•

コマンド実行
1.

[ツール -> バージョン管理 -> Properties]を選択します。

2.

[Properties]ダイアログボックスでファイルを選択し[OK]ボタンをクリックします。

3.

アウトプットウィンドウの[Version Control]タブに結果情報が出力されます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 191 of 479

High-performance Embedded Workshop V.4.09

10.

10.

ネットワークを利用したプロジェクト共有機能

ネットワークを利用したプロジェクト共有機能

High-performance Embedded Workshopは、ネットワークを介してワークスペースやプロジェクトを共有できます。この機能により、ユーザは共有したプロジェクトを同時に操作し、また、お互いの変更を見ることができます。この機能は、バージョン管理機能とともに使用できます。バージョン管理機能とこの機能の主な違いは、ユーザがワークスペースやプロジェクトを変更、更新したときに、他のユーザがプロジェクトを再読み込みする必要がないことです。
このシステムは、ネットワーク上の1つのコンピュータをサーバマシンとして使うことで実現します。他のす
べてのクライアントマシンはサーバマシンが提供するサービスを利用できます。例えば、クライアントマシンの1つが新規ファイルを追加すると、サーバマシンへファイルの追加が通知され、サーバマシンは他のすべてのクライアントマシンにファイルの追加を通知します。この構成を下図に示します。

ネットワーク機能によってユーザはファイルへのアクセス権を与えられます。これによって、プロジェクトア
ドミニストレータから書き込みを許可されたユーザのみが、プロジェクトやソースファイルを変更できるようになります。アドミニストレータは、各ユーザの書き込み権を、プロジェクトの各自のエリアに制限して、他のエリアを読み出し専用にできます。こうして、各ユーザによるプロジェクトの他の部分への競合や破壊を未然に防ぎます。これらの制限は異なるレベルに設定できます。
注：•

ネットワークを利用したプロジェクト共有機能は、Windows Vista® およびWindows® 7 operating system上
では使用できません。

•

ある操作をクライアントマシンで実行している間は、他のクライアントマシンでロックされていることがあります。例えば、あるユーザがツールチェインオプションを変更している間、他のすべてのユーザはこのオプションを変更できません。

•

ネットワーク機能を使うとHigh-performance Embedded Workshopの性能は低下します。小規模なチームで作業する場合は、この機能を使用せずにバージョン管理を使うことを推奨します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 192 of 479

High-performance Embedded Workshop V.4.09

10.

ネットワークを利用したプロジェクト共有機能

Windows® XP Service Pack 2以降を搭載したPCでのHigh-performance Embedded Workshop起動前に実施していただくこと
次節の「10.1 Windows® XP Service Pack 2以降を搭載したPCで本機能を使う場合の設定」を参照してください。
サーバマシンでのプロジェクトファイル設定手順
1.

ネットワーク用のプロジェクトファイルを作成します。

2.

[新規プロジェクトワークスペース]ダイアログボックスのディレクトリの指定には、サーバマシンとクライアントマシンから認識できるネットワークパス名を指定してください。
(例) \\WorkGroup\Sever1\ShareDirectory

ワークスペースの共有の仕組み
サーバマシンでのプロジェクトファイル設定手順の2.で指定したディレクトリは、共有設定をしてください。
High-performance Embedded Workshopのネットワーク機能は、サーバマシンにあるソース、オブジェクト、その他のファイルを共有します。これらのファイルは、サーバマシン上のみに存在し、クライアントマシンからはネットワークを介してアクセスします。
クライアントマシンからワークスペースを開く方法
クライアントマシンからネットワーク上のワークスペースを開くには、[ワークスペースを開く]ダイアログボ
ックスでネットワークパスを検索しワークスペースを選択します。

10.1

Windows® XP Service Pack 2 以降を搭載したPCで本機能を使う場合の設定

Windows® XP Service Pack 2でセキュリティ強化機能が搭載されました。
Windows® XP Service Pack 2以降を搭載したPCの場合、Windows® operating system の初期状態ではHigh-performance Embedded Workshopのネットワークを利用したプロジェクト共有機能を使用できません。
High-performance Embedded Workshopを起動する前に下記のようにPCの設定を変更し、サーバマシン、クライアントマシンがネットワークを介してHigh-performance Embedded Workshopシステムへアクセスできるようにする必要があります。サーバマシンおよびクライアントマシンがWindows® XP Service Pack 2以降を搭載している場合は両方とも設定してください。
•

サーバマシンがWindows® XP Service Pack 2以降を搭載している場合

ステップ1： Firewallの設定
1.

Windows® スタートメニューの[コントロール パネル]を選択します。

2.

[コントロール パネル]で[ネットワークとインターネット接続]をクリックします。

3.

[ネットワークとインターネット接続]で[Windows ファイアウォール]をクリックします。[Windowsファイアウォール]ダイアログボックスが開きます。

4.

[例外]タブをクリックします。

5.

[プログラムの追加]ボタンをクリックし、[プログラムの追加]ダイアログボックスを開きます。

6.

[参照]ボタンをクリックし、High-performance Embedded Workshopのインストールディレクトリにある\System\Sec\HewServer\Hew3Server.exe
を登録します。

7.

OKボタンをクリックし、[プログラムの追加]ダイアログボックスを閉じます。

8.

[ポートの追加]ボタンをクリックし、[ポートの追加]ダイアログボックスを開きます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 193 of 479

High-performance Embedded Workshop V.4.09

9.

10.

ネットワークを利用したプロジェクト共有機能

ポート名とポート番号を入力し[TCP]ラジオボタンを選択します。
名前： DCOM
ポート番号： 135
TCP： 選択

10. OKボタンをクリックし、[ポートの追加]ダイアログボックスを閉じます。
11. [Windowsファイアウォール]ダイアログボックスのOKボタンをクリックします。
12. [ネットワークとインターネット接続]を閉じます。
13. [コントロール パネル]を閉じます。
ステップ2： DCOMの設定
1.

Windows® スタートメニューの[ファイル名を指定して実行]を選択します。[ファイル名を指定して実行]ダイアログボックスが開きます。

2.

[名前]に"dcomcnfg"を入力しOKボタンをクリックします。[コンポーネントサービス]ウィンドウが開きます。

3.

ツリーを展開します。ツリーの展開時に[Windowsセキュリティの重要な警告]ダイアログボックスが表示された場合は、[ブロックする]ボタンをクリックします。
コンソールルート -> コンポーネントサービス -> コンピュータ -> マイコンピュータ

4.

マイコンピュータを右クリックし、表示されるポップアップメニューから[プロパティ]を選択します。
[マイコンピュータのプロパティ]ダイアログボックスが開きます。

5.

[COMセキュリティ]タブをクリックします。

6.

[アクセス許可]の[制限の編集]ボタンをクリックし、[アクセス許可]ダイアログボックスを開きます。

7.

[グループ名またはユーザ名]リストで"ANONYMOUS LOGON"を選択します。

8.

[ANONYMOUS LOGONのアクセス許可]リストで[リモートアクセス]の[許可]チェックボックスをオンにします。

9.

OKボタンをクリックし、[アクセス許可]ダイアログボックスを閉じます。

10. [起動とアクティブ化のアクセス許可]の[制限の編集]ボタンをクリックし、[起動許可]ダイアログボッ
クスを開きます。
11. [グループ名またはユーザ名]リストで"Everyone"を選択します。
12. [Everyoneのアクセス許可]リストで、[ローカルからの起動]および[リモートからのアクティブ化]の[許可]チェックボックスをオンにします。
13. OKボタンをクリックし、[起動許可]ダイアログボックスを閉じます。
14. [マイコンピュータのプロパティ]ダイアログボックスのOKボタンをクリックします。
15. [コンポーネントサービス]ウィンドウを閉じます。
•

クライアントマシンがWindows® XP Service Pack 2以降を搭載している場合

Firewallの設定
1.

Windows® スタートメニューの[コントロール パネル]を選択します。

2.

[コントロール パネル]で[ネットワークとインターネット接続]をクリックします。

3.

[ネットワークとインターネット接続]で[Windowsファイアウォール]をクリックします。[Windowsファ
イアウォール]ダイアログボックスが開きます。

4.

[例外]タブをクリックします。

5.

[プログラムの追加]ボタンをクリックし、[プログラムの追加]ダイアログボックスを開きます。

6.

[参照]ボタンをクリックし、High-performance Embedded Workshopインストールディレクトリにある

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 194 of 479

High-performance Embedded Workshop V.4.09

10.

ネットワークを利用したプロジェクト共有機能

HEW2.exeを登録します。
7.

OKボタンをクリックし、[プログラムの追加]ダイアログボックスを閉じます。

8.

[ポートの追加]ボタンをクリックし、[ポートの追加]ダイアログボックスを開きます。

9.

ポート名とポート番号を入力し[TCP]ラジオボタンを選択します。
名前： DCOM
ポート番号： 135
TCP： 選択

10. OKボタンをクリックし、[ポートの追加]ダイアログボックスを閉じます。
11. [Windowsファイアウォール]ダイアログボックスのOKボタンをクリックします。
12. [ネットワークとインターネット接続]を閉じます。
13. [コントロール パネル]を閉じます。

10.2

ネットワークを利用したプロジェクト共有機能を使う

ネットワークを利用したプロジェクト共有機能を使うには
1.

[基本設定 -> オプション]を選択してください。[オプション]ダイアログボックスが開きます。

2.

[ネットワーク]タブを選択してください。

3.

[ネットワークデータアクセス有効化]チェックボックスをオンにしてください。パスワードなしでアドミニストレータをシステムに追加します。アドミニストレータのみが、ユーザを追加したり、ユー
ザアクセス権を変更したりできます。

4.

[ネットワーク]ダイアログボックスで、アドミニストレータはパスワードを設定します。「10.3 アド
ミニストレータのパスワードを設定する」で説明します。

5.

[オプション]ダイアログボックスを閉じます。

6.

ダイアログボックスを閉じると、ワークスペースを保存して再び開くかどうか確認されます。これは、共有アクセスモードでワークスペースを再び開く必要があるためです。ワークスペースの変更を保存しないと、変更は無効になります。ネットワークを利用したプロジェクト共有機能を使う場合、[OK]
ボタンをクリックしてください。

7.

ワークスペースを再び開きログインすると、現在のあなたのアクセス権を示すダイアログボックスが開きます。例えば、アドミニストレータユーザの場合、レベルはアドミニストレータになります。このダイアログボックスを閉じると、High-performance Embedded Workshopサーバウィンドウが開き、ネットワークを利用したプロジェクト共有機能が使えるようになります。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 195 of 479

High-performance Embedded Workshop V.4.09

10.3

10.

ネットワークを利用したプロジェクト共有機能

アドミニストレータのパスワードを設定する

パスワードを設定するには
1.

「10.2 ネットワークを利用したプロジェクト共有機能を使う」の手順の4から続けて操作してください。

2.

[パスワード]ボタンをクリックしてください。ネットワークデータアクセスを有効にした場合、このボタンも有効になります。[パスワード変更]ダイアログボックスが開きます。

3.

[ユーザ名]は読み出し専用です。この場合、Adminになります。

4.

両方のフィールドに新規パスワードを入力して、[OK]ボタンをクリックしてください。[オプション]
ダイアログボックスの[ネットワーク]タブにユーザ名とパスワードを設定します。

10.4

新規ユーザを追加する

ネットワークデータベースの初期設定では、アドミニストレータユーザとゲストユーザをシステムに追加します。High-performance Embedded Workshopシステムでは、以下のアクセス権のレベルを設定できます。
アドミニストレータ

High-performance Embedded Workshopのすべての機能にフルアクセス
できます。プロジェクトからユーザを削除したり、アクセス権レベルを変更できます。ワークスペース、プロジェクトファイル、ソースフ
ァイルを変更できます。

フルリード/ライトアクセス

ワークスペース、プロジェクトファイル、ソースファイルを変更できます。ユーザのアクセス権レベルは変更できません。

ファイルのみリード/ライトアクセス

ソースファイルのみ変更できます。すべてのプロジェクト設定を表示
できますが、変更できません。

リードアクセス

すべてのソースファイルとプロジェクトファイルが表示できます。変
更はできません。

どのユーザも、ネットワーク上で使用できるプロジェクトを開くときにはユーザ名とパスワードを入力します。入力しない場合にはアクセス権は与えられません。入力した場合、ユーザには上記のアクセス権レベルの
うちのいずれかのレベルを与えられます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 196 of 479

High-performance Embedded Workshop V.4.09

10.

ネットワークを利用したプロジェクト共有機能

新規ユーザを追加するには
1.

アドミニストレータのアクセス権をもつユーザがログインします。この詳細は、上記を参照してくだ
さい。

2.

[基本設定 -> オプション]を選択してください。[オプション]ダイアログボックスが開きます。

3.

[ネットワーク]タブを選択してください。

4.

[アクセス権]ボタンをクリックしてください。[ユーザアクセス権]ダイアログボックスが開きます。

5.

[追加]ボタンをクリックしてください。[新規ユーザ追加]ダイアログボックスが開きます。あなたをア
ドミニストレータユーザとして新規のログイン名とパスワードを追加できます。通常、パスワードは
デフォルトのテキストか空白のままで設定します。次に、[OK]ボタンをクリックしてください。

6.

[OK]ボタンをクリックすると、ユーザをリードアクセスのアクセス権レベルで追加します。アクセス権レベルを変更するには、ユーザ名を選んで必要なラジオボタンをクリックしてください。[OK]ボタ
ンをクリックすると、アクセス権レベルの変更を保存します。

既存ユーザを削除するには
1.

アドミニストレータのアクセス権をもつユーザがログインします。この詳細は、上記を参照してくだ
さい。

2.

[基本設定 -> オプション]を選択してください。[オプション]ダイアログボックスが開きます。

3.

[ネットワーク]タブを選択してください。

4.

[アクセス権]ボタンをクリックしてください。[ユーザアクセス権]ダイアログボックスが開きます。

5.

削除するユーザ名を選択してください。

6.

[削除]ボタンをクリックしてください。

7.

[OK]ボタンをクリックするとアクセス権の変更を保存します。

10.5

パスワードを変更する

パスワードを変更するには
1.

パスワードを変更するHigh-performance Embedded Workshopネットワークデータベースにログインして、[基本設定 -> オプション]を選択してください。[オプション]ダイアログボックスが開きます。

2.

[ネットワーク]タブを選択してください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 197 of 479

High-performance Embedded Workshop V.4.09

10.

ネットワークを利用したプロジェクト共有機能

3.

[パスワード]ボタンをクリックしてください。

4.

旧パスワードを入力してください。

5.

新しいパスワードを入力して3番目のエディットボックスで同じパスワードを入力してください。

6.

[OK]ボタンをクリックしてください。

7.

次に、[OK]ボタンをクリックするとパスワードの変更を保存します。

10.6

ネットワークを利用したプロジェクト共有機能を使う場合の留意事項

最初にネットワーク上のプロジェクトを共有するとき、High-performance Embedded Workshopは自動的にサーバマシンを探して接続します。サーバマシンはマシン名で定義します。ワークスペースが、マシン名で見つからないときは、以下に示すダイアログボックスが開きます。サーバマシンの場所を入力するか参照して、[OK]
ボタンをクリックしてください。設定するマシンをサーバマシンとして使用する場合は、ラジオボタンをデフォルト設定(ローカル)のままにしてください。

ワークスペースのサーバマシンとして使用していたマシンを他のマシンに接続しようとすると、以下のメッセージを表示します。[はい]ボタンをクリックすると新しいマシンに接続します。

注：
ネットワークを利用したプロジェクト共有機能を有効にした場合、ユーザは複数のワークスペースの中から1つのワークスペースにしかアクセスできません。ただし、同一マシン（サーバマシンとクライアントマシンが同じ）の場合、複数のワークスペースにアクセスできます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 198 of 479

High-performance Embedded Workshop V.4.09

11.

ファイルの比較

ファイルの比較

11.

High-performance Embedded Workshopには差分ウィンドウがあります。ドライブの2つのローカルファイル、またはローカルファイルとMicrosoft® Visual SourceSafe システムのファイルを比較して相違点を表示できます。

差分ウィンドウを開く

11.1

ローカルドライブの2つのファイルを比較するには1.

以下のいずれかの操作を選択し[ファイルの比較]ダイアログボックスを開きます。

•

ワークスペースウィンドウの[Projects]タブで比較したいファイルを選択してください。選択したファイル上で右クリックしてポップアップメニューを表示し、[ファイルの比較]を選択してください。

•[差分]ツールバーボタン(•[表示 -> 差分]を選択してください。ウィンドウ内で右クリックしてポップアップメニューを表示し、)をクリックしてください。

[比較]を選択してください。

2.

[ドライブ上のファイルと比較]ラジオボタンが選択されていることを確認してください。

3.

比較する2つのファイルを入力してください。「1.」でワークスペースウィンドウからダイアログボッ
クスを表示した場合は、[比較元ファイル]にファイルが入力されています。ドロップダウンリストボックスから前回指定したファイルを選択するか、[参照]ボタンをクリックしファイルを参照できます。

4.

[詳細]ボタンをクリックすると、[比較ファイル-詳細オプション]ダイアログボックスが開きます。空白を考慮せずに相違点の比較ができます。[比較ファイル-詳細オプション]ダイアログボックスを終了
するには[OK]ボタンをクリックしてください。

5.

[比較]ボタンをクリックしてください。

ローカルファイルとVisual SourceSafeのファイルを比較するには
1.

Visual SourceSafeシステムとHigh-performance Embedded Workshopが接続されている必要があります。
また、比較するファイルはあらかじめVisual SourceSafeシステムに追加されている必要があります。

2.

以下のいずれかの操作を選択し[ファイルの比較]ダイアログボックスを開きます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 199 of 479

High-performance Embedded Workshop V.4.09

11.

ファイルの比較• ワークスペースウィンドウの[Projects]タブで比較したいファイルを選択してください。選択したファイル上で右クリックしてポップアップメニューを表示し、[ファイルの比較]を選択してください。
• [差分]ツールバーボタン()をクリックしてください。

• [表示 -> 差分]を選択してください。ウィンドウ内で右クリックしてポップアップメニューを表示し、[比較]を選択してください。

3.

[バージョン管理されているファイルとの比較]ラジオボタンをクリックしてください。Visual
SourceSafeシステムとHigh-performance Embedded Workshopが接続されている場合は、[バージョン管理されているファイルとの比較]ラジオボタンは選択可能になっています。

4.

[比較元ファイル]に比較するファイルを入力してください。2.でワークスペースウィンドウからダイア
ログボックスを表示した場合は、[比較元ファイル]にファイルが入力されています。ドロップダウン
リストボックスから前回指定したファイルを選択するか、[参照]ボタンをクリックしファイルを参照
できます。

5.

[詳細]ボタンをクリックすると[比較ファイル-詳細オプション]ダイアログボックスが開きます。
空白を考慮せずに相違点の比較ができます。[比較ファイル-詳細オプション]ダイアログボックスを終了するには[OK]ボタンをクリックしてください。

6.

[比較]ボタンをクリックしてください。

[ファイルの比較]ダイアログボックスが閉じ、差分ウィンドウが開きます。
ウィンドウの構成

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 200 of 479

High-performance Embedded Workshop V.4.09

11.

ファイルの比較•

差分ウィンドウの左ペインに比較元ファイルを表示し、右ペインに比較先ファイルを表示します。

•

ファイル名が各ペインのヘッダに表示されます。

•

ペインの境界上にマウスカーソルを置くと左右の矢印カーソルに変わります。クリックし希望する位置までマウスをドラッグするとペインの横幅を調節できます。

ウィンドウのオプション
ウィンドウ内で右クリックすると、使用可能なオプションをポップアップメニューで表示します。
本ウィンドウは、基本的なオプションをツールバーに割り付けています。
[ツールバー表示]、[ツールバーのカスタマイズ]は、ツールバー内で右クリックしても、ポップアップメニュ
ーを表示します。
ポップアップメニューオプション

ツールバーボタン

比較

マクロの記録機能-[ファイルの比較]ダイアログボックスを開きます。新たにファイルを比較し相違点を表示できます。

結果のファイル出力--

ダイアログボックスが開き、現在の相違点の結果をテキストフォーマットで保存できま
す。

空白の無視

-

空白文字を無視します。このメニューオプシ
ョンは[詳細オプション]ダイアログボックスの[空白の無視]オプションから選択することもできます。

検索-

標準の[検索]ダイアログボックスを開きます。
High-performance Embedded Workshop エデ
ィタと同じダイアログボックスです。

前を検索

-

検索項目に当てはまる次の前方の文字列を検
索します。

次を検索

-

検索項目に当てはまる次の後方の文字列を検
索します。

前の差分

-

次の後方の相違点に自動的にジャンプしま
す。

次の差分

-

次の前方の相違点に自動的にジャンプしま
す。

再比較

-

-

表示をリフレッシュして再び手動で相違点の比較を実行します。どちらかのファイルを比較後、変更したときに便利です。

ツールバー表示--

ツールバー表示/表示なしを切り替えます。

ツールバーのカスタマイズ--

ツールバーボタンをカスタマイズします。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 201 of 479

High-performance Embedded Workshop V.4.09

12.

12.

ナビゲーション機能

ナビゲーション機能

High-performance Embedded Workshopにはナビゲーション機能があります。サポートされているすべてのナビ
ゲーションの種類をワークスペースウィンドウの[Navigation]タブに表示します。

以下のナビゲーション機能を標準でサポートしています。
ナビゲーションの種類(カテゴリ)

機能

C Defines

C ソースファイルのすべての#define の表示

C Functions

C ソースファイルのすべての ANSI C 標準関数の表示

C++ Classes

C++ソースファイルのすべてのクラス、関数、メンバの表示

デフォルトでナビゲーション項目をカテゴリ単位で表示できます。各カテゴリの下にアクティブプロジェクトのナビゲーション項目をアルファベット順に表示します。
カテゴリ単位でナビゲーション項目を表示するには
1.

[Navigation]タブ内の任意の位置で右クリックしポップアップメニューを表示してください。

2.

[ファイルグループ]のチェックをオフにしてください。デフォルトはチェックがオフです。

ナビゲーション項目をファイル単位で表示できます。アクティブプロジェクト内の各ファイルをツリーで表示
し、その下に各ファイルのナビゲーション項目をアルファベット順に表示します。
ファイル単位でナビゲーション項目を表示するには
1.

[Navigation]タブ内の任意の位置で右クリックしポップアップメニューを表示してください。

2.

[ファイルグループ]のチェックをオンにしてください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 202 of 479

High-performance Embedded Workshop V.4.09

12.

ナビゲーション機能

特定のナビゲーションカテゴリの情報を必要としない場合はスキャンを無効にできます。
ナビゲーションカテゴリを無効にするには1.

[Navigation]タブ内の任意の位置で右クリックしポップアップメニューを表示してください。

2.

[カテゴリの選択]を選択してください。[カテゴリ選択]ダイアログボックスが開きます。

3.

定義を参照する必要のないカテゴリのチェックボックスをオフにしてください。

4.

[OK]ボタンをクリックしてください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 203 of 479

High-performance Embedded Workshop V.4.09

12.

ナビゲーション機能

ナビゲーション表示を更新するには1.

[Navigation]タブ内の任意の位置で右クリックしポップアップメニューを表示してください。

2.

[リフレッシュ]を選択してください。

注：•

ファイルのスキャン状況に応じて、ナビゲーション項目を表示します。ファイルが多数あると、ナビ
ゲーション表示の更新を終了するのに時間がかかります。

•

ファイルを保存する際に再びスキャンします。ファイルを保存するまで、新しいクラスや関数のナビ
ゲーション情報を表示しません。

•[ファイルグループ]と[アクセスグループ]は、同時にオンにできません。一方をオンにするともう一方はオフになります。

12.1

C関数と#defineナビゲーションの構成

この機能では、ナビゲーション表示に関数と#define定義を追加します。

定義へジャンプするには以下のいずれかの操作を選択してください。
•[Navigation]タブの関数または#define定義項目上でダブルクリックしてください。

•[Navigation]タブの関数または#define定義項目上で右クリックしポップアップメニューを表示してください。[定義へジャンプ]を選択してください。

12.2

C++ナビゲーションの構成

C++ナビゲーション機能はC++ソースファイルの表示で以下の構成をサポートします。情報の基本構成を下図に示します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 204 of 479

High-performance Embedded Workshop V.4.09

12.

ナビゲーション機能

C++ナビゲーション表示では、アイコンの示す関数や変数の種類を示すためにいくつかのアイコンを用います。これらを下図に示します。

デフォルトで、C++ナビゲーション項目をダブルクリックすると、関連するC++ナビゲーション項目の宣言へ
ジャンプします。このデフォルト動作は、ポップアップメニューの[ダブルクリックで定義へジャンプ]の選択で変更できます。デフォルトはチェックがオフです。チェックマークを付けるとナビゲーション項目をダブルクリックしたときに関連するナビゲーション項目の定義へジャンプします。
定義へジャンプするには以下のいずれかの操作を選択してください。
•[Navigation]タブのC++ナビゲーション項目上で右クリックしポップアップメニューを表示してください。[ダブルクリックで定義へジャンプ]のチェックマークが付いていることを確認してください。
[Navigation]タブのC++ナビゲーション項目上でダブルクリックしてください。

•[Navigation]タブのC++ナビゲーション項目上で右クリックしポップアップメニューを表示してください。[定義へジャンプ]を選択してください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 205 of 479

High-performance Embedded Workshop V.4.09

12.

ナビゲーション機能宣言へジャンプするには以下のいずれかの操作を選択してください。
•[Navigation]タブのC++ナビゲーション項目上で右クリックしポップアップメニューを表示してください。[ダブルクリックで定義へジャンプ]のチェックマークが外れていることを確認してください。
[Navigation]タブのC++ナビゲーション項目上でダブルクリックしてください。

•[Navigation]タブのC++ナビゲーション項目上で右クリックしポップアップメニューを表示してください。[宣言へジャンプ]を選択してください。

メンバ変数と関数を各々アルファベット順で表示するには
1.

[Navigation]タブのC++ナビゲーション項目上で右クリックしポップアップメニューを表示してください。

2.

[アクセスグループ]のチェックマークをオフにしてください。デフォルトはチェックがオフです。

public、private、protectedメンバ変数と関数をグループ化して表示するには
1.

[Navigation]タブのC++ナビゲーション項目上で右クリックしポップアップメニューを表示してください。

2.

[アクセスグループ]のチェックマークをオンにしてください。デフォルトはチェックがオフです。

[ファイルグループ]と[アクセスグループ]は、同時にオンにできません。一方をオンにするともう一方はオフになります。
他の機能としては、特定の範囲の基底クラス、または派生クラスを表示します。
基底クラス、派生クラスを表示するには
1.

[Navigation]タブのクラス上で右クリックしポップアップメニューを表示してください。

2.

[派生クラスの表示]を選択すると、選択した範囲の派生クラスを表示します。[基底クラスの表示]を選択すると、選択した範囲の基底クラスを表示します。

3.

選択により、拡張ツリー形式で選択されたクラス構造をダイアログボックスに表示します。

4.

[閉じる]ボタンをクリックしてください。

12.3

エディタ内から定義へジャンプする

エディタウィンドウに表示されているソースコードから#define、C関数、またはC++クラスなどのナビゲーシ
ョン項目名を選択し、それが定義されている位置をエディタウィンドウに表示できます。
定義位置を表示できるのは、ワークスペースウィンドウの[Navigation]タブで有効なカテゴリのナビゲーション
項目です。
定義へジャンプするには1.

エディタウィンドウの[ソース]領域で定義位置を表示したいナビゲーション項目名上で右クリックしてください。

2.

表示されるポップアップメニューから[定義へジャンプ 'ナビゲーション項目名']を選択してください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 206 of 479

High-performance Embedded Workshop V.4.09

3.

12.

ナビゲーション機能該当するナビゲーション項目が含まれる複数存在する場合は、[ナビゲーションアイテムの選択]ダイ
アログボックスが開きます。ファイル名および行番号がリストで表示されます。リスト項目をダブルクリックするか、リスト項目を選択して[OK]ボタンをクリックしてください。

12.4

ナビゲーション項目をドラッグアンドドロップする

ワークスペースウィンドウの[Navigation]タブに表示されている#define、C関数、またはC++クラスなどのナビ
ゲーション項目名をドラッグアンドドロップできます。カテゴリ（C Defines, C Functions, C++ Classes ）、Globals
フォルダ、ファイル項目はドラッグできません。
エディタで開いているファイルにナビゲーション項目をドラッグアンドドロップする
ファイルに関連した項目をエディタウィンドウ内にドラッグできるので、それらをタイプする必要がなくコー
ドを書くことを容易にします。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 207 of 479

High-performance Embedded Workshop V.4.09•

複数のアイテムを同時にドラッグできます（別々の行に表示されます）。

•

ナビゲーション項目名はすべてアルファベット順に挿入されます。

•

関数をドラッグする場合、関数名だけがドラッグされます。

12.5

12.

ナビゲーション機能

スマートエディタ

High-performance Embedded Workshopエディタの機能の1つにスマートエディタ機能があります。この機能はデフォルトではすべてのCおよびC++ソースファイルで有効です。C関数、#define、C++クラスやメンバ関数を使っているとき、High-performance Embedded Workshopエディタは、C関数、#define、およびC++ナビゲーション
情報にアクセスしスマートエディタリストをポップアップウィンドウで表示します。
スマートエディタ機能を使用するには
1.

[基本設定 -> オプション]を選択してください。[オプション]ダイアログボックスが開きます。

2.

[エディタ]タブを選択してください。

3.

[Smart-editor機能]チェックボックスをオンにしてください。

4.

[OK]ボタンをクリックしてください。

このオプションをオンにすると、操作しているCおよびC++ファイルでスマートエディタ機能が有効になります。
注：
ワークスペースウィンドウの[Navigation]タブで、"C Defines"、"C Functions"、または"C++ Classes" ナビゲーションカテゴリがオフのとき、High-performance Embedded Workshopのスマートエディタ機能は無効です。
R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 208 of 479

High-performance Embedded Workshop V.4.09

12.

ナビゲーション機能

High-performance Embedded Workshopエディタを編集するとき、以下のエディタ操作によりスマートエディタ
リストをポップアップウィンドウで表示します。
•

オブジェクトを使用し「.」や「->」でメンバをアクセスしているときは、ポップアップウィンドウが表示され、入力するより効率良くメンバを選択できます。入力中、ポップアップウィンドウ内は上下矢印キーでメンバを選択できます。Enterキーを押すと、選択したメンバを追加します。「::」を使っているときもこのポップアップメニューを表示します。メンバを追加するまでは、Ctrl+Spaceキーを押すとポップアップウィンドウを表示できます。

•

CおよびC++関数を使用しているときは、最初に開き括弧を入力すると、ポップアップウィンドウを表示します。このポップアップウィンドウにより、現在のオブジェクトでどの関数が使用できるかわかります。関数を選択すると自動的に残りのパラメータを入力します。閉じ括弧を入力するまでは、
Ctrl+Shift+Spaceキーを押すとポップアップウィンドウを表示できます。

•

High-performance Embedded Workshopエディタウィンドウで、C関数、#define、C++クラス、メンバ関
数などを追加したい位置にポップアップウィンドウから選択した項目を追加できます。以下のいずれかの操作を選択してください。
oHigh-performance Embedded Workshopエディタウィンドウ内で右クリックしポップアップメニュー
を表示します。[ナビゲーションリスト]を選択し、表示されるポップアップウィンドウで追加したい項目を選択しEnterキーを押す。

o

Ctrl+Spaceキーを押し、表示されるポップアップウィンドウで追加したい項目を選択しEnterキーを押す。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 209 of 479

High-performance Embedded Workshop V.4.09

13.

マップ

マップ

13.

リンケージエディタのセクション設定、およびリンケージエディタが出力するリンケージリストファイルの情報からセクション情報とシンボル情報を表示します。下記の機能を備えています。
セクション情報oアドレス−セクショングループ−セクションの順にツリービュー表示o

ドラッグアンドドロップによるセクションの配置の変更が可能

o

アドレス、セクショングループ、セクションの追加、変更、削除が可能

o

選択行のアドレスに対応したソースファイルをエディタウィンドウで表示可能o

表示内容の印刷が可能

シンボル情報o

すべてまたはセクション毎のシンボル情報のリスト表示o各シンボル情報の検索、フィルタリング、およびソートが可能o

選択行のアドレスに対応したソースファイルをエディタウィンドウで表示可能o

表示内容の印刷が可能•

対応ツールチェイン

以下に示すコンパイラパッケージに含まれるツールチェインを使用している場合、マップ機能に対応していま
す。

•

o

SuperHファミリ用C/C++コンパイラパッケージ V.7.1.03およびそれ以降o

H8SX, H8S, H8ファミリ用C/C++コンパイラパッケージ V.5.0.05およびそれ以降

o

M16Cシリーズ,R8Cファミリ用Cコンパイラパッケージ V.5.42 Release 00およびそれ以降

o

M32Cシリーズ用Cコンパイラパッケージ V.5.41 Release 00およびそれ以降

o

R32Cシリーズ用Cコンパイラパッケージ V.1.01 Release 00およびそれ以降

oRXファミリ用C/C++コンパイラパッケージ V.1.00 Release 00およびそれ以降セクション情報およびシンボル情報を表示するにはセクション情報およびシンボル情報を表示するには、あらかじめ下記を行う必要があります。
1.

[ビルド -> xxxxxx Standard Toolchain]を選択し、ツールチェインのビルドオプション設定ダイアログボ
ックスを開きます。

2.

[最適化リンカ]タブの[カテゴリ]で"リスト"を選択します。

3.

[リンケージリスト出力]チェックボックスをオンにします。これによりセクション情報が出力されます。

4.

[全て有効]ボタンをクリックします。これによりシンボル情報が出力されます。

5.

[ビルド -> ビルド]を選択します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 210 of 479

High-performance Embedded Workshop V.4.09

13.

マップ

注：
下記のようにサブコマンドファイルを指定した場合は、セクション情報ウィンドウにリンケージエディタのセ
クション設定情報は表示されません。

13.1

セクション設定を管理する

Map Section Informationウィンドウを使用すると、セクション情報の追加、編集、削除がGUI上で簡単に実行できます。
セクション編集後の確認も容易です。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 211 of 479

High-performance Embedded Workshop V.4.09

13.1.1

13.

マップ

Map Section Informationウィンドウを開く

Map Section Informationウィンドウを開くには1.

以下のいずれかの操作を選択し[マップ種別の選択]ダイアログボックスを開きます。

•[表示 -> マップ]を選択する。

•[マップ]ツールバーボタン(

2.

[マップ種別]ドロップダウンリストから"Map Section Information"を選択します。

3.

[OK]ボタンをクリックします。

)をクリックする。

ウィンドウの構成•

map情報およびリンケージエディタのセクション設定情報を左側のペインに表示します。
oリンケージエディタの[セクション]オプションの設定情報が表示されます。

o

編集モード時、サブセクショングループ、オーバレイグループ、およびセクションは、ドラッグア
ンドドロップが可能です。
操作

ドラッグ操作中のマウスポインタの状態

ドラッグした項目をドロップ対

Ctrl キーを押した状態で、サブセクショングループ（ョン(

ドロップ結果）、またはセクシ コピー可能なドロップ対象項目上では、 象項目の次にコピーします。

)を選択してドラッグ

通常の選択時のマウスポインタになり

Ctrl キーを押した状態で、オーバレイ ます。マウスポインタにドラッグ項目名 ドラッグした項目をドロップ対
象項目の最後にコピーします。
グループ（）を選択してドラッグ と'+'マークが付きます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 212 of 479

High-performance Embedded Workshop V.4.09

操作

13.

ドラッグ操作中のマウスポインタの状態

ドロップ結果ドラッグした項目をドロップ対

Shift キーを押した状態で、サブセク）、またはセク 移動可能なドロップ対象項目上では、通 象項目の前に移動します。

ショングループ（
ション(

マップ

常の選択時のマウスポインタになりま)を選択してドラッグ

す。マウスポインタにドラッグ項目名と上矢印が付きます。
サブセクショングループ（
たはセクション(）、ま)を選択してドラッグ

ドラッグした項目をドロップ対
移動可能なドロップ対象項目上では、通 象項目の次に移動します。
常の選択時のマウスポインタになりま

オーバレイグループ（てドラッグ）を選択し す。マウスポインタにドラッグ項目名が ドラッグした項目をドロップ対付きます。
象項目の最後の項目に移動します。

•

ビルド後のセクション情報を右側のペインに表示します。
oリンケージエディタが出力するリンケージリストファイル(.map)がある場合に表示されます。

oカラムヘッダ上のマウスのドラッグで各カラムの幅を調節できます。また、カラムヘッダ上で右クリックするとポップアップメニューを表示します。カラムが利用できる場合は、エントリの横にはチェックマークがあります。エントリをクリックすると、各カラムの表示、非表示を切り替えます。

o

リストのカラムヘッダをクリックすると、リスト項目はそのカラムによってソートされます。ウィンドウ開くと、[Start Address]の昇順でソートされています。

o[Overlay]カラムにはオーバレイグループのプライマリセクション名が表示されます。

ウィンドウのオプション•

map情報およびリンケージエディタのセクション設定情報（左側のペイン）

左側のペイン内で右クリックすると、使用可能なオプションをポップアップメニューで表示します。
本ウィンドウは、基本的なオプションをツールバーに割り付けています。
[ツールバー表示]、[ツールバーのカスタマイズ]は、ツールバー内で右クリックしても、ポップアップメニュ
ーを表示します。
ポップアップメニューオプション

ツールバーボタン機能

セクション情報編集モード

編集モードを切り替えます。

セクショングループの追加

セクショングループを追加します。

セクションの追加

セクションを追加します。

オーバレイグループの追加 *1

オーバレイグループを追加します。

セクションの自動登録

未登録セクションを自動登録します。

選択項目の編集

選択項目を編集します。

切り取りセクション情報を切り取ります。

コピーセクション情報をコピーします。

貼り付けセクション情報を貼り付けます。

削除セクション情報を削除します。

1 つ上へセクション情報を 1 つ上へ移動します。

1 つ下へ

セクション情報を 1 つ下へ移動します。

プライマリセクションに設定 *1

プライマリセクションに設定します。

メモリマップ設定 *2

メモリマップを設定するダイアログボックスを開きます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 213 of 479

High-performance Embedded Workshop V.4.09

ポップアップメニューオプション

13.

ツールバーボタン

マップ機能

メモリリソース自動確保 *2

メモリリソースを自動的に確保します。

印刷セクション設定ツリーを印刷します。

ツールバー表示-

ツールバー表示/表示なしを切り替えます。

ツールバーのカスタマイズ-

ツールバーボタンをカスタマイズします。

注：*1. リンケージエディタがオーバレイをサポートしていない場合は使用できません。
*2. 以下に示すデバッガがサポートしています。
- SuperHファミリ用シミュレータデバッガ- H8SX, H8S, H8ファミリ用シミュレータデバッガ- RXファミリ用シミュレータデバッガ•

ビルド後のセクション設定情報（右側のペイン）

右側のペイン内で右クリックすると、使用可能なオプションをポップアップメニューで表示します。
本ウィンドウは、基本的なオプションをツールバーに割り付けています。
[ツールバー表示]、[ツールバーのカスタマイズ]は、ツールバー内で右クリックしても、ポップアップメニュ
ーを表示します。
ポップアップメニューオプション

ツールバーボタン

機能

未割り当て領域の表示

未割り当て領域を表示します。

サイズ 0 のセクション表示

サイズ 0 のセクションを表示します。

ソースファイル表示

選択行のアドレスに対応したソースコードを表示します。

印刷

セクションリストを印刷します。

セクション情報編集モードの開始と終了

13.1.2

左側のペインに表示されるセクション情報を編集するには、編集モードに切り替える必要があります。デフォ
ルトは編集モードではありません。
編集モードに移行するには
1.

左側のペイン内で右クリックしポップアップメニューを表示します。

2.

[セクション情報編集モード]を選択します。これにより編集モードに移行し、[セクション情報編集モード]にチェックマークが付きます。

編集モードに移行すると、下記のオプションが使用可能になります。
左側のペインの各項目上で右クリックすると下記の""を記載したオプションが使用可能です。
項目

ツール
ポップアップメニュー

バー

オプション

ボタン

ルート アドレスセクション

サブセクション

オーバレイ

グループ

グループ

グループ

セクション

セクショングループの追加
セクションの追加
オーバレイグループの追加*2*1
R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 214 of 479

High-performance Embedded Workshop V.4.09

13.

マップ

項目
ツール
ポップアップメニュー

バー

オプション

ボタン

ルート アドレスセクション

サブセクション

オーバレイ

グループ

グループ

グループ

セクション

セクションの自動登録
選択項目の編集
切り取り
コピー
貼り付け
削除
1 つ上へ
1 つ下へ
プライマリセクションに設定 *1

注：*1. リンケージエディタがオーバレイをサポートしていない場合は使用できません。
*2. 以下に示すコンパイラパッケージに含まれるツールチェインを使用している場合にサポートしています。
- SuperHファミリ用C/C++コンパイラパッケージ V.9.00 Release 04およびそれ以降- H8SX, H8S, H8ファミリ用C/C++コンパイラパッケージ V.6.01 Release 02およびそれ以降- RXファミリ用C/C++コンパイラパッケージ V.1.00 Release 00およびそれ以降- M16Cシリーズ,R8Cファミリ用C/C++コンパイラパッケージ V.6.00 Release 00およびそれ以降
編集モードを終了するには
1.

左側のペイン内で右クリックしポップアップメニューを表示します。

2.

[セクション情報編集モード]を選択します。

3.

下記の確認ダイアログボックスが開きます。編集した結果をリンケージエディタのセクション設定に反映するには「はい」を選択してください。これにより編集モードが終了します。[セクション情報編
集モード]のチェックマークが外れます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 215 of 479

High-performance Embedded Workshop V.4.09

13.

マップ

セクショングループを追加する

13.1.3

編集モードでは、セクショングループの追加が可能です。
セクショングループを追加するには
1.

左側のペイン内で右クリックしポップアップメニューを表示します。

2.

[セクショングループの追加]を選択します。[セクショングループ追加]ダイアログボックスが開きます。

3.

[セクション開始アドレス]にセクション開始アドレスを入力します。

4.

[セクショングループ名]にセクショングループ名を入力します。セクショングループ名をコンマで区切って指定すると、各々がセクションとして追加されます。上の図の例を設定すると、セクション"Section1"、およびセクション"Section2"が追加されます。

左側のペインのセクション設定ツリーで、アドレス下にセクショングループが追加されます。

セクションを追加する

13.1.4

編集モードでは、セクショングループ、サブセクショングループ、またはオーバレイグループ下にセクションの追加が可能です。
セクションを追加するには
1.

左側のペイン内のセクショングループ、サブセクショングループ、またはオーバレイグループ上で右クリックしポップアップメニューを表示します。

2.

[セクションの追加]を選択します。[セクション追加]ダイアログボックスが開きます。

3.

[セクション名]にセクション名を入力します。

左側のペインのセクション設定ツリーで、セクショングループ、サブセクショングループ、またはオーバレイ
グループ下にセクションが追加されます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 216 of 479

High-performance Embedded Workshop V.4.09

13.

マップ

オーバレイグループを追加する

13.1.5

編集モードでは、セクショングループ、サブセクショングループ、またはセクション（*1）下にオーバレイ（*2）
グループの追加が可能です。
オーバレイグループを追加するには左側のペイン内のセクショングループ、サブセクショングループ、またはセクション（*1）上で右ク

1.

リックしポップアップメニューを表示します。
2.

[オーバレイグループの追加]を選択します。[オーバレイグループ追加]ダイアログボックスが開きます。

3.

[オーバレイグループ名]にオーバレイグループ名を入力します。

左側のペインのセクション設定ツリーで、セクショングループ、サブセクショングループ、またはセクション（*1）下にオーバレイグループが追加されます。
注：*1. 以下に示すコンパイラパッケージに含まれるツールチェインを使用している場合にサポートしています。
- SuperHファミリ用C/C++コンパイラパッケージ V.9.00 Release 04およびそれ以降- H8SX, H8S, H8ファミリ用C/C++コンパイラパッケージ V.6.01 Release 02およびそれ以降- RXファミリ用C/C++コンパイラパッケージ V.1.00 Release 00およびそれ以降- M16Cシリーズ,R8Cファミリ用C/C++コンパイラパッケージ V.6.00 Release 00およびそれ以降*2. リンケージエディタがオーバレイをサポートしていない場合は使用できません。

未登録セクションを自動登録する

13.1.6

編集モードでは、右側のペインに表示しているセクションリストの中で、未登録セクションを左側のペインのセクションツリーへ自動登録できます。
未登録セクションを自動登録するには
1.

左側のペイン内で右クリックしポップアップメニューを表示します。

2.

[セクションの自動登録]を選択します。

•

未登録セクションの中で一番小さいアドレスより小さいアドレスのセクショングループがセクション

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 217 of 479

High-performance Embedded Workshop V.4.09

13.

マップ

ツリーに存在する場合、そのセクショングループの最後にすべての未登録セクションをアドレス指定
なしで追加します。
•

未登録セクションの中で一番小さいアドレスより小さいアドレスのセクショングループがセクション
ツリーに存在しない場合、未登録セクションの中で一番小さなアドレスにすべての未登録セクション
をセクショングループとして追加します。

注：
未登録セクションがオーバレイセクションだった場合は、オーバレイセクションとしては登録せず、通常のセクションとして登録します。

選択項目を編集する

13.1.7

編集モードでは、アドレス値、およびセクショングループ、サブセクショングループ、オーバレイグループ、セクションの名前の編集が可能です。
選択項目を編集するには
1.

以下のいずれかの操作を選択し[選択項目の編集]ダイアログボックスを開きます。

•

左側のペイン内の項目上で右クリックしポップアップメニューを表示する。[選択項目の編集]を選択する。

•

左側のペイン内の項目をダブルクリックする。

2.

編集フィールドにデータを入力してください。

プライマリセクションに設定する

13.1.8

編集モードでは、選択したオーバレイグループをプライマリセクションに設定（*）できます。
プライマリセクションに設定するには
1.

左側のペイン内のオーバレイグループ上で右クリックしポップアップメニューを表示します。

2.

[プライマリセクションに設定]を選択します。

左側のペインのセクション設定ツリーで選択したオーバレイグループがプライマリセクションに設定されます。
注：*. リンケージエディタがオーバレイをサポートしていない場合は使用できません。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 218 of 479

High-performance Embedded Workshop V.4.09

13.

マップ

メモリマップを設定する

13.1.9デバッガと接続している場合にメモリマップを設定できます。
メモリマップを設定するには
1.

左側のペイン内で右クリックしポップアップメニューを表示します。

2.

[メモリマップ設定]を選択します。メモリマップを設定するダイアログボックスが開きます。

3.

アドレス空間の現在のマッピング状況がリストで表示されているため、必要に応じてメモリマップおよびメモリリソースを設定してください。

4.

[OK]ボタンをクリックします。

注：
以下に示すデバッガがサポートしています。
- SuperHファミリ用シミュレータデバッガ- H8SX, H8S, H8ファミリ用シミュレータデバッガ- RXファミリ用シミュレータデバッガ

13.1.10

メモリリソースを自動的に確保する

リンケージエディタが出力するリンケージリストファイル（.map）がある場合、メモリマップおよびリンケー
ジマップ情報に基づきメモリリソースを自動的に確保できます。デバッガと接続している場合に使用できます。
メモリリソースを自動的に確保するには
1.

左側のペイン内で右クリックしポップアップメニューを表示します。

2.

[メモリリソース自動確保]を選択します。下記のダイアログボックスが開きます。

3.

処理を継続する場合は[OK]をクリックしてください。

4.

処理が完了すると下記のダイアログボックスが開きます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 219 of 479

High-performance Embedded Workshop V.4.09

13.

マップ

注：
以下に示すデバッガがサポートしています。
- SuperHファミリ用シミュレータデバッガ- H8SX, H8S, H8ファミリ用シミュレータデバッガ- RXファミリ用シミュレータデバッガ

13.1.11

セクション設定ツリーを印刷する

左側のペインのセクション設定ツリーを印刷できます。
セクション設定ツリーを印刷するには
1.

左側のペイン内で右クリックしポップアップメニューを表示します。

2.

[印刷]を選択します。

3.

標準のプリントフォーマットを選択するダイアログボックスが開きます。ここで、使用するプリンタとページ設定のオプションを選択できます。[印刷]ボタンをクリックしてください。

13.1.12

未割り当て領域を表示する

セクションが割り当てられていない領域の表示が可能です。デフォルトでは表示されません。
未割り当て領域を表示するには
1.

右側のペイン内で右クリックしポップアップメニューを表示します。

2.

[未割り当て領域の表示]を選択します。[未割り当て領域の表示]にチェックマークが付きます。これにより右側のペインで、セクションが割り当てられていない領域がすべて表示されます。Nameカラムに"Unallocated Area"と表示しています。

13.1.13

サイズ 0 のセクションを表示する

サイズ0のセクションの表示が可能です。デフォルトでは表示されません。
サイズ0のセクションを表示するには
1.

右側のペイン内で右クリックしポップアップメニューを表示します。

2.

[サイズ0のセクション表示]を選択します。右側のペインで、サイズ0のセクションがすべて表示されます。このとき"End Address"カラムに終了アドレスは表示されません。

13.1.14

アドレスに対応するソースコードを表示する

選択している行の該当アドレスに対応したソースファイルをエディタウィンドウで開きます。
アドレスに対応するソースコードを表示するには
以下のいずれかの操作を選択してください。
•

右側のペイン内のソースを表示したいセクション情報行の上で右クリックし、ポップアップメニュー
を表示します。[ソースファイル表示]を選択します。

•

右側のペイン内のソースを表示したいセクション情報行をダブルクリックします。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 220 of 479

High-performance Embedded Workshop V.4.09

13.1.15

13.

マップセクションリストを印刷する

右側のペインのセクションリストを印刷できます。
セクションリストを印刷するには
1.

右側のペイン内で右クリックしポップアップメニューを表示します。

2.

[印刷]を選択します。

3.

標準のプリントフォーマットを選択するダイアログボックスが開きます。ここで、使用するプリンタとページ設定のオプションを選択できます。[印刷]ボタンをクリックしてください。

13.2

シンボル情報を見る

Map Symbol Informationウィンドウを使用すると、セクションごとにシンボルを表示できます。
シンボル数が多い場合も、検索機能、フィルタ機能で必要な情報だけを表示できます。

13.2.1

Map Symbol Informationウィンドウを開く

Map Symbol Informationウィンドウを開くには1.

以下のいずれかの操作を選択し[マップ種別の選択]ダイアログボックスを開きます。

•[表示 -> マップ]を選択する。

•[マップ]ツールバーボタン(

2.

[マップ種別]ドロップダウンリストから"Map Symbol Information"を選択します。

3.

[OK]ボタンをクリックします。

)をクリックする。

ウィンドウの構成

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 221 of 479

High-performance Embedded Workshop V.4.09

•

13.

マップ

リンケージエディタのマップリストを左側のペインに表示します。
o リンケージエディタが出力するリンケージリストファイル(.map)がある場合に表示されます。
o マップリストのルート(Linker map list)を選択すると、すべてのシンボル情報を右側のペインに表示します。
o マップリストのセクションを選択すると、選択したセクションに属するシンボル情報を右側のペインに表示します。

•

リンケージエディタのシンボル情報を右側のペインに表示します。
o リンケージエディタが出力するリンケージリストファイル(.map)にシンボルリストがある場合に表示します。
o カラムヘッダ上のマウスのドラッグで各カラムの幅を調節できます。また、カラムヘッダ上で右クリックするとポップアップメニューを表示します。カラムが利用できる場合は、エントリの横にはチェックマークがあります。エントリをクリックすると、各カラムの表示、非表示を切り替えます。
o リストのカラムヘッダをクリックすると、リスト項目はそのカラムによってソートされます。ウィンドウ開くと、[Start Address]の昇順でソートされています。
o [Attribute]カラムにはシンボル属性を表示します。
Entry：

エントリ関数

Function：

関数名

Data：

変数名

None：

未設定(ラベル、アセンブラシンボル)o [Scope]カラムにはスコープ属性を表示します。
Global：グローバルシンボル

Local：

ローカルシンボル

ウィンドウのオプション•

リンケージエディタのマップリスト（左側のペイン）

左側のペイン内で右クリックすると、使用可能なオプションをポップアップメニューで表示します。
本ウィンドウは、基本的なオプションをツールバーに割り付けています。
[ツールバー表示]、[ツールバーのカスタマイズ]は、ツールバー内で右クリックしても、ポップアップメニュ
ーを表示します。
ポップアップメニューオプション

ツールバーボタン機能
リンケージエディタのマップリストを印刷します。

印刷
ツールバー表示-

ツールバー表示/表示なしを切り替えます。

ツールバーのカスタマイズ-

ツールバーボタンをカスタマイズします。

•

リンケージエディタのシンボル情報（右側のペイン）

右側のペイン内で右クリックすると、使用可能なオプションをポップアップメニューで表示します。
本ウィンドウは、基本的なオプションをツールバーに割り付けています。
[ツールバー表示]、[ツールバーのカスタマイズ]は、ツールバー内で右クリックしても、ポップアップメニュ
ーを表示します。
ポップアップメニューオプション
検索

R20UT0372JJ0100 Rev.1.00
2011.02.01

ツールバーボタン

機能
シンボルを検索します。

Page 222 of 479

High-performance Embedded Workshop V.4.09

ポップアップメニューオプション

13.

ツールバーボタン

マップ

機能

次を検索

次のシンボルを検索します。

フィルタ

シンボル情報をフィルタ表示します。

ソースファイル表示

選択行のアドレスに対応したソースコードを表示します。

印刷

リンケージエディタのシンボル情報を印刷します。

マップリストを印刷する

13.2.2

左側のペインのリンケージエディタのマップリストを印刷できます。
マップリストを印刷するには
1.

左側のペイン内で右クリックしポップアップメニューを表示します。

2.

[印刷]を選択します。

3.

標準のプリントフォーマットを選択するダイアログボックスが開きます。ここで、使用するプリンタとページ設定のオプションを選択できます。[印刷]ボタンをクリックしてください。

シンボルを検索する

13.2.3

リンケージエディタのシンボルの検索が可能です。
シンボルを検索するには
1.

右側のペイン内で右クリックしポップアップメニューを表示します。

2.

[検索]を選択します。[シンボル名の検索]ダイアログボックスが開きます。

3.

[名前]に検索するシンボルを入力、またはドロップダウンリストボックスから以前検索したシンボルを選択してください。

4.

大文字と小文字を識別する場合は[大文字と小文字を区別]チェックボックスをオンにしてください。

5.

ワイルドカード（"?"または"*"）を使用する場合は[ワイルドカードを使用]チェックボックスをオンにしてください。

6.

?：

任意の1文字*：

任意の文字列[OK]ボタンをクリックします。

右側のペインのリンケージエディタのシンボル情報で該当行が強調表示されます。
検索文字列の次の該当箇所を検索する場合は、[次を検索]を選択してください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 223 of 479

High-performance Embedded Workshop V.4.09

13.

マップ

シンボル情報をフィルタ表示する

13.2.4

リンケージエディタのシンボル情報のフィルタ表示が可能です。
シンボル情報をフィルタ表示するには
1.

右側のペイン内で右クリックしポップアップメニューを表示します。

2.

[フィルタ]を選択します。[シンボルのフィルタ設定]ダイアログボックスが開きます。

3.

[フィルタを有効にする]チェックボックスをオンにします。チェックボックスのデフォルトはオフです。

4.

[フィルタ対象カラム]でフィルタリングするカラムを選択します。

5.

[フィルタ項目]でカラムに表示する項目を選択します。
フィルタ対象カラム

フィルタ項目機能

Function関数でフィルタリングを行う

Data

データシンボルでフィルタリングを行う

Entry

実行開始位置でフィルタリングを行う

None

上記以外(ラベル等)のシンボルでフィルタリングを行う

Globalグローバルシンボルでフィルタリングを行う

Local

ローカルシンボルでフィルタリングを行う

Section (シンボル存在セクション)

セクション名セクション名でフィルタリングを行う

File (シンボル存在ファイル名)

ファイル名

ファイル名でフィルタリングを行う

Attribute (シンボル属性)

Scope (スコープ属性)

6.

[すべて設定]ボタンをクリックするとフィルタ項目のすべてのチェックボックスがオンになります。

7.

[すべて解除]ボタンをクリックするとフィルタ項目のすべてのチェックボックスがオフになります。

8.

[OK]ボタンをクリックします。

右側のペインのリンケージエディタのシンボル情報が、選択した項目でフィルタ表示されます。
複数条件でのフィルタ表示を行う場合は、さらに別のフィルタ対象カラムを選択し、そのカラム内のフィルタ

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 224 of 479

High-performance Embedded Workshop V.4.09

13.

マップ

項目を選択してください。
フィルタを無効にするには、[シンボルのフィルタ設定]ダイアログボックスで[フィルタを有効にする]チェックボックスをオフにしてください。

アドレスに対応するソースコードを表示する

13.2.5

選択している行の該当アドレスに対応したソースファイルをエディタウィンドウで開きます。
アドレスに対応するソースコードを表示するには
以下のいずれかの操作を選択します。
•

右側のペイン内のソースを表示したいシンボル情報行の上で右クリックし、ポップアップメニューを表示します。[ソースファイル表示]を選択します。

•

右側のペイン内のソースを表示したいシンボル情報行をダブルクリックします。

シンボル情報を印刷する

13.2.6右側のペインのリンケージエディタのシンボル情報を印刷できます。
シンボル情報を印刷するには
1.

右側のペイン内で右クリックしポップアップメニューを表示します。

2.

[印刷]を選択します。

3.

標準のプリントフォーマットを選択するダイアログボックスが開きます。ここで、使用するプリンタとページ設定のオプションを選択できます。[印刷]ボタンをクリックしてください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 225 of 479

High-performance Embedded Workshop V.4.09

14.

コマンドラインコマンドライン14.

High-performance Embedded Workshopコマンドラインインタプリタにより、ウィンドウメニュー/コマンドの代わりにテキストベースのコマンドで、ターゲットプラットフォームを制御できます。これはあらかじめ決まったコマンド列をバッチファイルから呼び出して、ターゲットプラットフォームに送る場合に特に便利です。さらに出力をログファイルに記録することもできます。
注：•

コマンドラインのファイル指定
コマンドラインでファイルを指定する場合、プレースホルダを使用してください（TCLコマンドは除く）。
プレースホルダに含まれていないディレクトリを指定したいときは、絶対パスを指定してください。絶対
パスで指定すると、他のマシンやパスの内容が異なる環境に移動する場合、正しくファルを参照できなくなりますので、ファイル指定をやり直してください。
FILE_LOAD ELF/DWARF2 $(CONFIGDIR)\\demo.abs•

コマンドパラメータの区切り
TCLが有効の場合、TCLコマンドを使用できます。パラメータがTabで区切られたTCLコマンドバッチの使用も可能です。
For

{set

i

0}

{$i

puts

[memory_display 300

<

2}

{incr

i}

{

10]

}
TCLが無効の場合、TCLコマンドは使用できません。パラメータの区切りとして半角スペースのみ使用できます。そのため、Tabを使用すると以下のようなエラーになります。
>TCL
TCL Disabled>memory_display

300

10

Error: Invalid command

14.1

コマンドラインウィンドウを開く

コマンドラインウィンドウを開くには、[表示 -> コマンドライン]を選択するか、[コマンドライン]ツールバー
ボタン()をクリックします。ウィンドウタイトルとしてバッチファイル名とログファイル名をコロンで区切って表示します。
High-performance Embedded Workshopコマンドおよび TCLコマンドを実行できます。使用できるコマンドについては、「リファレンス 3. コマンド」を参照してください。
コマンドラインウィンドウには、2つのタブ（[Console]および[Debugger]）があります。
ウィンドウの構成•[Console]タブ
テキストベースのコマンドを入力し、ターゲットプラットフォームを制御できるウィンドウです。コマン
ドの実行結果は、[Debugger]タブの下側ペインの表示内容と連動しています。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 226 of 479

High-performance Embedded Workshop V.4.09

o14.

コマンドラインコマンドラインウィンドウ最終行のコマンドプロンプト(">")に続けて入力後、"Enter"キーを押すとコ
マンドを実行します。

o

最終行で"Ctrl+↑"または"Ctrl+↓"キーを押すと直前に入力したコマンド行を表示できます。

oバッチファイルからコマンドを呼び出して実行、および実行結果をファイルに出力できます。設定したバッチファイルの内容は、[Debugger]タブの上側ペインに表示します。

o•ウィンドウの表示内容をクリアできます。[Debugger]タブの下側ペインの表示内容もクリアします。

[Debugger]タブ
設定したバッチファイルの内容を1行単位で実行、またはブレークポイントを設定して実行し、ターゲッ
トプラットフォームを制御できるウィンドウです。
バッチファルを読み込んでいる場合、ペインの境界上にマウスカーソルを置くと上下の矢印カーソルに変わります。クリックし希望する位置までマウスをドラッグするとペインの幅を調節できます。

o

上側のペイン（バッチファイル内容の表示）
設定したバッチファイルの内容を表示し、バッチファイルをデバッグできます。このウィンドウ上で表示内容を編集できません。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 227 of 479

High-performance Embedded Workshop V.4.09

14.

コマンドライン

設定したバッチファイルの内容を表示します。
バッチファイルを1行単位で実行できます。
バッチファイルの先頭からバッチファイルの実行を開始できます。
コマンド行に対応するブレークポイントカラムでブレークポイント( )を設定できます。
ブレークポイントカラム上の黄色の矢印()は、バッチファイルの実行行（開始位置）を指します。
バッチファイルの先頭に実行開始位置（）を戻すことができます。

コマンド実行結果をファイルに出力できます。
下側のペイン（コマンド実行結果の表示）o

コマンドの実行結果を表示します。コマンドの実行結果は、[Console]タブの表示内容と連動しています。
このウィンドウ上でコマンドを入力できません。
ウィンドウの表示内容をクリアできます。[Console]タブの表示内容もクリアします。
ウィンドウのオプション•[Console]タブ

ウィンドウ内で右クリックすると、使用可能なオプションをポップアップメニューで表示します。
本ウィンドウは、基本的なオプションをツールバーに割り付けています。
[ツールバー表示]、[ツールバーのカスタマイズ]は、ツールバー内で右クリックしても、ポップアップメニュ
ーを表示します。
ポップアップメニューオプション

ツールバーボタン

マクロ

機能

の記録
バッチファイル指定-

バッチファイルを設定します。

バッチファイル実行-

バッチファイルの先頭からバッチファイルの実行を開始します。

バッチファイル停止-

バッチファイルの実行を停止します。

ログファイル指定-

ログファイルを設定します。

ロギング開始/停止-

ログファイルへの出力を開始/停止します。

参照-

ファイルの絶対パスを入力します。

-

プレースホルダ$(CONFIGDIR)を挿入しま

プレース

コンフィグレーション

ホルダ

ディレクトリコンフィグレーションす。
-

名
プロジェクトプレースホルダ$(CONFIGNAME)を挿入します。

-

プレースホルダ$(PROJDIR)を挿入します。

-

プレースホルダ$(PROJECTNAME)を挿入しディレクトリ
プロジェクト名ます。
ワークスペース-

ディレクトリワークスペース名

プレースホルダ$(WORKSPDIR)を挿入します。

-

プレースホルダ$(WORKSPNAME)を挿入します。

HEW インストール-

プレースホルダ$(HEWDIR)を挿入します。

-

アクティブウィンドウのすべての内容を選択

ディレクトリ
すべて選択します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 228 of 479

High-performance Embedded Workshop V.4.09

ポップアップメニューオプション

14.

ツールバーボタンマクロ

コマンドライン

機能

の記録
コピー

-

選択部分をコピーし Windows® クリップボードに貼り付けます。

カット-

選択部分を切り取り Windows® クリップボードに貼り付けます。

貼り付け

-

Windows® クリップボードの内容をコピーしてアクティブウィンドウのカーソル位置に貼り付けます。

クリア-

ウィンドウの表示内容をクリアします。

元に戻す

-

直前の入力を元に戻します。

--

開き括弧（{または[）が入力され閉じ括弧（}または]）が入力されていない場合ボタンが点灯します（ボタン選択不可）。

ツールバー表示--

ツールバー表示/表示なしを切り替えます。

ツールバーのカスタマイズ--

ツールバーボタンをカスタマイズします。

•[Debugger]タブo

上側のペイン（バッチファイル内容の表示）

ウィンドウ内で右クリックすると、使用可能なオプションをポップアップメニューで表示します。
本ウィンドウは、基本的なオプションをツールバーに割り付けています。
[ツールバー表示]、[ツールバーのカスタマイズ]は、ツールバー内で右クリックしても、ポップアップメニ
ューを表示します。
ポップアップメニューオプション

ツールバーボタン

マクロ

機能

の記録
バッチファイル指定-

バッチファイルを設定します。

バッチファイル実行-

バッチファイルの先頭からバッチファイルの実行を開始します。

バッチファイル停止
リセット

-

-

バッチファイルの実行を停止します。

-

バッチファイルの実行状態をリセットしま
す。

ステップ

-

バッチファイルを 1 行単位で実行します。

ブレークポイントの挿入/削除--

ブレークポインを挿入/削除します。

ブレークポイントの有効化/無効化--

現在設定しているブレークポイントの有効／
無効を切り替えます。

ブレークポイントをすべて削除-

すべてのブレークポイントを削除します。

ログファイル指定-

ログファイルを設定します。

ロギング開始/停止-

ログファイルへの出力を開始/停止します。

-

ツールバー表示--

ツールバー表示/表示なしを切り替えます。

ツールバーのカスタマイズ--

ツールバーボタンをカスタマイズします。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 229 of 479

High-performance Embedded Workshop V.4.09

oコマンドライン14.

下側のペイン（コマンド実行結果の表示）

ウィンドウ内で右クリックすると、使用可能なオプションをポップアップメニューで表示します。
本ウィンドウは、基本的なオプションをツールバーに割り付けています。
[ツールバー表示]、[ツールバーのカスタマイズ]は、ツールバー内で右クリックしても、ポップアップメニ
ューを表示します。
ポップアップメニューオプション

ツールバーボタン

クリア

14.2

マクロの記録-機能
ウィンドウの表示内容をクリアします。

バッチファイルを設定する

自動テストなどのあらかじめ定義した一連のコマンド行を実行する場合は、バッチファイルを利用すると便利です。
バッチファイルはテキストエディタで作成し、実行するコマンドラインを記述しておきます。バッチファイルの拡張子のデフォルトは".hdc"です。
バッチファイルを設定するには、[バッチファイルを指定]ダイアログボックスを使用します。
コマンドラインウィンドウのポップアップメニューから[バッチファイル指定]を選択すると、[バッチファイル
を指定]ダイアログボックスが開きます。バッチファイル名(*.hdc)を入力できます。
[実行]ボタンをクリックすると、設定したバッチファイルを実行します。[OK]ボタンをクリックすると、設定したバッチファイル名を、ウィンドウタイトルに表示します。[キャンセル]ボタンをクリックすると、設定を変更しないでダイアログボックスを閉じます。

バッチファイルを設定すると、コマンドラインウィンドウの[Debugger]タブの上側のタブにバッチファイルの内容を表示します。
セッションの保存時に設定したバッチファイル名も保存します。
注：•

以下のGUI機能およびコマンドを実行するとバッチファイルを閉じるため、コマンドラインウィンドウの[Debugger]タブの上側のタブの表示はクリアされます。

•

o

ワークスペースを閉じる（CLOSE_WORKSPACEコマンド）o

新規ワークスペースを作成する

oプロジェクトを挿入する

oセッションを追加する

バッチファイル設定後にバッチファイルの内容を変更すると、コマンドラインウィンドウの[Debugger]タ
ブの上側のタブに表示しているバッチファイルの内容を更新します。そのため、バッチファイルの実行状
態をリセットし、設定しているブレークポイントをすべて削除します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 230 of 479

High-performance Embedded Workshop V.4.09

14.

コマンドラインバッチファイル設定後にバッチファイルの内容を変更すると、再びバッチファイルを読み込むことを通知する
メッセージを表示します。
確認要求ダイアログボックスを表示しない場合、[今後表示しない]チェックボックスをオンにしてください。
確認要求ダイアログボックスを再び表示するには
1.

[基本設定 -> オプション]を選択してください。[オプション]ダイアログボックスが開きます。

2.

[確認]タブを選択してください。

3.

[バッチファイルの更新]チェックボックスをオンにしてください。このチェックボックスのデフォル
トはオンです。

4.

14.3

OKをクリックしてください。

バッチファイルを実行する

バッチファイルを実行するには、[バッチファイルを指定]ダイアログボックスで[実行]ボタンをクリックする
か、コマンドラインウィンドウのポップアップメニューから[バッチファイル実行]を選択します。[バッチファ
イル実行]メニューはバッチファイル実行中にグレー表示となり、バッチファイル実行が停止してユーザに制御が戻ったときに有効表示になります。
バッチファイルを実行中にコマンドラインウィンドウを閉じようとすると、下記のメッセージボックスを表示します。

バッチファイルの実行を強制終了し、コマンドラインウィンドウを閉じる場合は、[OK]ボタンをクリックしてください。
バッチファイルの実行を継続する場合は、[キャンセル]ボタンをクリックしてください。この時コマンドライ
ンウィンドウは閉じません。

14.4

コマンド実行を中断する

コマンド実行を中断する場合は、コマンドラインウィンドウのポップアップメニューから[バッチファイル停止]を選択します。
[バッチファイル停止]メニューはコマンド実行中に有効表示になります。
注：
TCLコマンドの場合、TCLコマンドが完了しないとコマンド実行が中断されないことがあります。

14.5

ログファイルを設定する

コマンド実行結果を保存するログファイルは、[ログファイルを開く]ダイアログボックスで設定します。
[ログファイルを開く]ダイアログボックスを開くには、コマンドラインウィンドウのポップアップメニューから[ログファイル指定]を選択します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 231 of 479

High-performance Embedded Workshop V.4.09

14.6

14.

コマンドライン

ログファイルへの出力を開始/停止する

ファイルへのロギング処理を実行するか、停止するかの切り替えは、コマンドラインウィンドウのポップアッ
プメニューの[ロギング開始/停止]で行います。ログファイルの内容は、ロギングが終了するか、チェックボッ
クスをクリアしてロギングを一時的に停止しなければ表示できないことにご注意ください。ロギングを再び開始すると、ログファイルに追加します。

14.7

ファイルの絶対パスを入力する

コマンドラインウィンドウのポップアップメニューで[参照]を選択すると、参照ダイアログボックスが開きます。ここでファイルを選択し[開く]をクリックすると、絶対パスファイル名をカーソル位置に貼り付けます。
カーソルが最終行にある場合のみ使用できます。

14.8

プレースホルダを挿入する

コマンドラインウィンドウのポップアップメニュー[プレースホルダ]のサブメニューで選択したプレースホル
ダをカーソル位置に貼り付けます。
カーソルが最終行にある場合のみ使用できます。
カーソル位置に貼り付けるプレースホルダ[プレースホルダ]のサブメニュー
コンフィグレーションディレクトリ

$(CONFIGDIR)

コンフィグレーション名$(CONFIGNAME)

プロジェクトディレクトリ

$(PROJDIR)

プロジェクト名$(PROJECTNAME)

ワークスペースディレクトリ

$(WORKSPDIR)

ワークスペース名$(WORKSPNAME)

HEW インストールディレクトリ$(HEWDIR)

14.9

ウィンドウの表示内容をすべて選択する

コマンドラインウィンドウのポップアップメニューから[すべて選択]を選択すると、コマンドラインウィンド
ウの出力をすべて選択します。

14.10 選択部分をクリップボードにコピーする
コマンドラインウィンドウのポップアップメニューから[コピー]を選択すると、選択したテキストブロックを
Windows® クリップボードにコピーします。テキストブロックを選択している場合にのみ使用できます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 232 of 479

High-performance Embedded Workshop V.4.09

14.

コマンドライン14.11 選択部分をクリップボードに切り取る
コマンドラインウィンドウのポップアップメニューから[切り取り]を選択すると、選択したテキストブロックを削除しWindows® クリップボードに貼り付けます。現在入力中のカーソル位置のテキストブロックを選択している場合にのみ使用できます。

14.12 クリップボードの内容を貼り付ける
コマンドラインウィンドウのポップアップメニューから[貼り付け]を選択すると、Windows® クリップボードの内容を現在入力中のカーソル位置に貼り付けます。カーソルが最終行にある場合のみ使用できます。

14.13 ウィンドウの表示内容をクリアする
コマンドラインウィンドウのポップアップメニューから[クリア]を選択すると、[Console]タブ、および[Debugger]タブの下側のペインに表示している内容をすべてクリアします。

14.14 直前の操作を元に戻す
コマンドラインウィンドウのポップアップメニューから[元に戻す]を選択すると、現在のカーソル位置で、直前の操作を元に戻します。

14.15 括弧の呼応状態を確認する
コマンドラインウィンドウで[開き括弧インジケータ]ツールバーボタン()が表示されている場合、コマンド

ラインウィンドウに入力中の式に含まれる括弧の呼応状態を確認できます。[開き括弧インジケータ]ツールバ
ーボタンの点灯状態により括弧の呼応状態を確認します。ボタンは呼応状態の表示のみで操作はできません。
括弧の開始である"["または"{"が入力されネスト部分が入力されると、括弧の終了である"]"または"}"が入力されるまでは、[開き括弧インジケータ]ツールバーボタンが点灯(
コマンドラインウィンドウへの)します。

括弧の入力状況ツールバーボタンの点灯状態

TCL 関数の入力例>set bit 1

なし

1

なし

>set value 1

なし

1

なし

>set r 1

なし

1

なし

>if {$bit & $value} {開き括弧が入力された> set r 0$r

なし>} else {閉じ括弧および開き括弧が入力された> set r 1$r

なし>}

閉じ括弧が入力された

>

なし

01

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 233 of 479

High-performance Embedded Workshop V.4.09

14.

コマンドライン14.16 バッチファイルの実行状態をリセットする
コマンドラインウィンドウの[Debugger]タブでバッチファイルの実行状態をリセットします。バッチファイルを設定していない場合は使用できません。以下をリセットします。
•

バッチファイルの先頭に実行開始位置を戻します。

•

コマンドの対話モードの場合、対話モードを終了します。

•

括弧を開いている場合、括弧を閉じます。

バッチファイルの実行状態をリセットするには
1.

コマンドラインウィンドウの[Debugger]タブを開きます。

2.

上側のペインで、右クリックしてポップアップメニューを表示します。

3.

[リセット]を選択します。

注：•

設定したバッチファイル名、バッチファイルのブレークポイントなどの情報は各セッションに保存されています。コマンドラインウィンドウの[Debugger]タブを開き、セッションを切り替える操作を行うと、そのセッションで設定したバッチファイルの表示内容に切り替わります。バッチファイルの実行状態も自動的にリセットされます。バッチファイルにこれらのコマンドが含まれている場合も同様です。

•

oアクティブプロジェクトを切り替える（CHANGE_PROJECTコマンド）o

デバッグセッションを切り替える（CHANGE_SESSIONコマンド）

コンフィグレーションを切り替えると、バッチファイルの実行状態も自動的にリセットされます。バッチ
ファイルにこのコマンドが含まれている場合も同様です。
o

ビルドのコンフィグレーションを切り替える（CHANGE_CONFIGURATIONコマンド）

14.17 バッチファイルを 1 行単位で実行する
コマンドラインウィンドウの[Debugger]タブで、バッチファイルの開始位置からバッチファイルのコマンド行
を1行単位で実行します。バッチファイルを設定していない場合は使用できません。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 234 of 479

High-performance Embedded Workshop V.4.09

コマンドライン14.

バッチファイルを1行単位で実行するには
1.

コマンドラインウィンドウの[Debugger]タブを開きます。

2.

上側のペインで、以下の操作のいずれかを選択します。

•

ウィンドウのツールバーの[ステップ]ツールバーボタン(•

ウィンドウ内で右クリックしてポップアップメニューを表示し、[ステップ]を選択する。

•

ウィンドウ内にフォーカスがある場合に、"Ctrl+F10"キーを押す。
バッチファイルの開始位置()をクリックする。

)は次のコマンド行へ移動します。コマンド実行で発生したエラーによっては、バッチファイルの開始位置は次のコマンド行へ移動しません。
注：
以下のコマンドがバッチファイルに含まれている場合、コマンドラインウィンドウの[Debugger]タブで設定したバッチファイルのデバッグを継続できません。コマンドラインウィンドウの[Console]タブでバッチファイルを実行してください。
•

CLOSE_WORKSPACEコマンド
コマンドを実行すると、バッチファイルを閉じます。

•

CHANGE_PROJECTコマンド、およびCHANGE_SESSIONコマンド
コマンドを実行すると、切り替えたセッションで設定したバッチファイルの表示内容に切り替わります。

•

CHANGE_CONFIGURATIONコマンド
コマンドを実行すると、バッチファイルの実行状態も自動的にリセットされます。

14.18 バッチファイルにブレークポイントを設定する
コマンドラインウィンドウの[Debugger]タブで、バッチファイルのコマンド行にブレークポイントを設定します。バッチファイルを設定していない場合は使用できません。
バッチファイルにブレークポイントを設定するには
1.

コマンドラインウィンドウの[Debugger]タブを開きます。

2.

上側のペインで、以下の操作のいずれかを選択します。

•

バッチファイルを停止したい行のブレークポイントカラムをダブルクリックします。

•

バッチファイルを停止したい行にカーソルを置きます。右クリックしてポップアップメニューを表示
し、[プレークポイントの挿入/削除]を選択します。
ブレークポイントカラム上にブレークポイントマーク( )を表示します。これは、ブレークポイントを設定したことを示します。

3.

設定したブレークポイントの有効、無効を切り替えるには、右クリックしてポップアップメニューを表示し、[ブレークポイントの有効化/無効化]を選択します。

4.

設定したブレークポイントを削除するには、右クリックしてポップアップメニューを表示し[プレーク
ポイントの挿入/削除]を選択するか、カラムをダブルクリックします。

5.

設定したブレークポイントをすべて削除するには、右クリックしてポップアップメニューを表示し、[プレークポイントをすべて削除]を選択します。

コマンドラインウィンドウの[Debugger]タブを開いた状態で、バッチファイルを実行します。ブレーク発生時には、ブレークポイントを設定したコマンド行を実行する直前で停止します。ブレークポイントで停止した後に、ステップまたはバッチファイル実行を選択した場合、黄色い矢印アイコン(

R20UT0372JJ0100 Rev.1.00
2011.02.01)を表示した行から実行しまPage 235 of 479

High-performance Embedded Workshop V.4.09

14.

コマンドライン

す。ブレークポイントは最大256箇所設定できます。セッション保存時に設定したブレークポイントも保存し
ます。
注：
•

コマンドラインウィンドウの[Console]タブを開いた状態で、バッチファイルを実行した場合はブレークしません。

•

バッチファイル設定後にバッチファイルの内容を変更すると、コマンドラインウィンドウの[Debugger]タ
ブの上側のペインに表示しているバッチファイルの内容を更新します。そのため、バッチファイルの実行
状態をリセットし、設定しているブレークポイントをすべて削除します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 236 of 479

High-performance Embedded Workshop V.4.09

15.

15.

マクロ生成支援機能

マクロ生成支援機能

マクロ生成支援機能は、High-performance Embedded Workshopシステムのアプリケーション関連（*1）、ビルド関連（*2）、およびデバッグ関連（*3）などの一部の操作をHigh-performance Embedded Workshopコマンド
ラインのコマンドとして記録、または記録したコマンドを実行する機能です。
記録されるファイル（High-performance Embedded Workshopマクロファイル）は、拡張子がhdcのコマンドバッ
チファイルであり編集可能なテキストファイルです。このファイルは、各ユーザプロファイルのアプリケーションデータフォルダにあるHigh-performance Embedded Workshop管理情報フォルダ下の"Macros"フォルダに作成されます。デフォルトのファイル名はDefault.hdcです。
High-performance Embedded Workshopコマンドラインのコマンドに対応するHigh-performance Embedded
Workshopシステムのすべての操作が記録できるわけではありません。各機能のメニューオプション一覧には"マクロの記録"欄にマクロの記録マーク( )を表示し、High-performance Embedded Workshopマクロファイルへ記録可能かどうかを示しています。
注：*1. プロジェクトの変更、セッションの変更、コンフィグレーションの変更など*2. コンパイル、ビルドなど*3. モジュールのダウンロード、メモリ値の変更、レジスタ値の変更、ソフトウェアブレークの設定／解除、プログラム実行など
マクロ生成支援機能は[ツール]メニューと[マクロ]ツールバーで利用できます。
[マクロの記録]を選択してから[マクロの停止]を選択するまでが1つの"マクロ"で、1つのHigh-performance
Embedded Workshopマクロファイルには複数のマクロを記録できます。マクロには、複数のHigh-performance
Embedded Workshopコマンドラインのコマンドが含まれます。

15.1

マクロメニューとツールバー

マクロ生成支援機能はメニューとツールバーで利用できます。
マクロのメニューは[ツール]メニューにあります。標準で以下のメニューオプションがあります。

[マクロの設定]から[マクロの設定]ダイアログボックスを開くことができます。ここで、使用中のマクロファ
イルやマクロを管理します。この他のメニューオプションは[マクロ]ツールバー上の項目と同じです。
マクロをメニューに割り当てることもできます。これを行うとマクロの標準のメニューオプションの下にメニューオプションが追加されます。以下にその例を示します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 237 of 479

High-performance Embedded Workshop V.4.0915.

マクロ生成支援機能

マクロをメニューおよびツールバーに割り当てた場合は、メニューオプションの横にアイコンが表示されます。
[マクロ]ツールバーの標準ボタンを以下に示します。

•[マクロの記録]ボタンでマクロの記録を開始します。このボタンをクリックすると、デバッグやHigh-performance Embedded Workshopの管理操作が記録されます。これは[ツール]メニューの[マクロの記録]メニューと同じです。

•[マクロの実行]ボタンでマクロ機能の再生を開始します。マクロを定義すると[マクロの選択]ダイアロ
グボックスが開きます。再生する特定のマクロを指定してください。

•[マクロの一時停止]ボタンはマクロを記録または実行しているときのみ有効です。このボタンは現在の操作を一時停止して後で再開できるようにします。

•[マクロの停止]ボタンはマクロを記録または実行しているときのみ有効です。このボタンは実行中のマクロ操作を停止します。

マクロのメニューへの割り当てができると同様に、マクロのツールバーへの割り当てもできます。マクロを割り当てたツールバーのアイコンには、定義したアイコンか、デフォルトのアイコンを使用できます。マクロを
ツールバーに割り当てると、割り当てたマクロが標準のマクロボタンの右側に表示されます。ボタンをクリッ
クすると、割り当てたマクロが起動します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 238 of 479

High-performance Embedded Workshop V.4.09

15.2

15.

マクロ生成支援機能

マクロの設定ダイアログボックスを使用する[マクロの設定]ダイアログボックスからHigh-performance Embedded Workshopシステムの現在使用中のマクロ
ファイルをアクセスしたり管理したりできます。[マクロの設定]ダイアログボックスを以下に示します。

[使用中のマクロファイル]ドロップダウンリストにはHigh-performance Embedded Workshopシステムで現在使用中のマクロファイルをすべて表示します。これらのファイルは、各ユーザプロファイルのアプリケーション
データフォルダにあるHigh-performance Embedded Workshop管理情報フォルダ下の"Macros"フォルダに格納しています。"Macros"フォルダにコピーしたファイルはすべて自動的に[使用中のマクロファイル]ドロップダウンリストに追加します。
[使用中のマクロファイル]ドロップダウンリストで選択したファイルに含まれるマクロは、[マクロ一覧]リストボックスに表示します。[使用中のマクロファイル]の選択を変更すると自動的にリストを更新します。[有効なマクロを全て表示]チェックボックスをオンにすると、現在定義されているすべてのマクロを表示します。
チェックしてこのオプションを指定することにより、[使用中のマクロファイル]リストボックスの値は無視されます。
[初期ディレクトリ]は相対パスを持つマクロファイルを実行するために初期ディレクトリを設定します。ディ
レクトリを変更するコマンドと同様にディレクトリを変更後、初期ディレクトリからマクロファイルを実行します。
新規のマクロファイルを作成するには
1.

[ツール -> マクロの設定]を選択し、[マクロの設定]ダイアログボックスを開きます。

2.

[新規]ボタンをクリックしてください。[マクロファイルの新規追加]ダイアログボックスが開きます。

3.

新規のマクロファイル名を入力してください。マクロファイル名は64文字以内で、半角英数字、半角下線のみ使用してください。

4.

OKをクリックすると、[使用中のマクロファイル]リストに新規マクロファイル名を追加します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 239 of 479

High-performance Embedded Workshop V.4.0915.

マクロ生成支援機能

既存のマクロファイルをインポートするには1.

[ツール -> マクロの設定]を選択し、[マクロの設定]ダイアログボックスを開きます。

2.

[インポート]ボタンをクリックしてください。[インポートファイルの選択]ダイアログボックスが開きます。

3.

既存のマクロファイルを選択してください。

4.

[選択]をクリックしてください。[使用中のマクロファイル]リストに新しくマクロファイル名を追加します。

5.

リスト内のマクロファイル名を選択すると、インポートできるマクロを表示します。

マクロファイルはテキストベースのHigh-performance Embedded Workshopコマンドバッチファイルのため編集可能です。
既存のマクロファイルを編集するには
1.

[ツール -> マクロの設定]を選択し、[マクロの設定]ダイアログボックスを開きます。

2.

[使用中のマクロファイル]にあるマクロファイルを選択してください。

3.

[マクロ一覧]から編集したいマクロを選択してください。

4.

[編集]ボタンをクリックしてください。

5.

[マクロの設定]ダイアログボックスが閉じファイルをエディタ内に表示します。

通常のテキストファイルと同様にHigh-performance Embedded Workshopウィンドウ上にドラッグアンドドロッ
プしてマクロファイル開くことも可能です。
既存のマクロファイルからマクロを削除するには1.

[ツール -> マクロの設定]を選択し、[マクロの設定]ダイアログボックスを開きます。

2.

[使用中のマクロファイル]にあるマクロファイルを選択してください。

3.

[マクロ一覧]から削除したいマクロを選択してください。

4.

[削除]ボタンをクリックしてください。

[閉じる]ボタンをクリックすると[マクロの設定]ダイアログボックスを閉じます。このダイアログボックスでの操作はやり直しできません。

15.3

既存のマクロファイルをインポートする

既に複数のマクロがある他のマシンから既存のHigh-performance Embedded Workshopマクロファイルをインポートするには、以下の操作を実行してください。
一つの方法は、[マクロの設定]ダイアログボックスを使用して、マクロファイルをインポートすることです。
以下に操作方法を示します。
既存のマクロファイルをHigh-performance Embedded Workshopにインポートするには1.

[ツール -> マクロの設定]を選択し、[マクロの設定]ダイアログボックスを開きます。

2.

[インポート]ボタンをクリックしてください。標準のファイルブラウザが開き、インポートしたい既存のマクロファイルを選択できます。

3.

ファイルを選択し[選択]ボタンをクリックするとファイルをインポートします。インポートしたマク

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 240 of 479

High-performance Embedded Workshop V.4.0915.

マクロ生成支援機能

ロは、[使用中のマクロファイル]ドロップダウンリストで選択状態になります。また、インポートしたマクロファイルは、各ユーザプロファイルのアプリケーションデータフォルダにある
High-performance Embedded Workshop管理情報フォルダ下の"Macros"フォルダにコピーされます。
4.

[マクロの設定]ダイアログボックスで[閉じる]をクリックすると、インポートしたマクロファイルが使用可能になります。

もう一つの方法は、追加するマクロファイルを各ユーザプロファイルのアプリケーションデータフォルダにあるHigh-performance Embedded Workshop管理情報フォルダ下の"Macros"フォルダにコピーすることです。
High-performance Embedded Workshopは、この"Macros"フォルダにあるマクロファイルを自動的に検出して[マクロの設定]ダイアログボックスにその情報を追加します。追加したファイルはデフォルトでは使用できません。デフォルトのマクロファイルを追加したファイルに切り替えるには、[マクロの設定]ダイアログボックスを使用してください。

マクロを記録する

15.4

マクロファイルを記録するには下記に示すいくつかの方法があります。
ツールバーまたはメニューからマクロを記録するには
1.

[マクロ]ツールバーの[マクロの記録]ボタン( )、または[ツール]メニューの[マクロの記録]を選択してください。マウスポインタにマクロの記録アイコンが付き()、記録されていることを示します。マ

クロが記録されているとき、[マクロの一時停止]ボタン( )および[マクロの停止]ボタン( )やメニュー
が有効になります。記録の一時停止中はマウスポインタに[マクロの一時停止]アイコンが付きます
(
2.

)。

マクロ機能をサポートしないデバッガを使用している場合、"WARNING: ターゲットがマクロ機能をサポートしていないため、記録内容は制限されます。続けますか？"という確認メッセージを表示します。「はい」をクリックすると記録を続けます。確認のダイアログボックスを表示しない場合、[今後表示しない]チェックボックスをオンにしてください。確認のダイアログボックスを再び表示するには、[基本設定 -> オプション]を選択し[オプション]ダイアログボックスを開きます。[確認]タブの[マクロ機能をサポートしていないターゲットでの記録]チェックボックスをオンにしてください。デフォ
ルトはチェックボックスがオンです。

3.

[マクロの停止]をクリックするまで記録を続行します。マクロファイルに記録する操作については、
次節の「15.5 マクロファイルにマクロを記録できる機能」を参照してください。

4.

[マクロの停止]をクリックすると[マクロの新規追加]ダイアログボックスが表示されるのでマクロ名を入力してください。

5.

OKをクリックするとマクロ名でマクロを保存し、現在のマクロファイルに追加します。キャンセルをクリックするとダイアログボックスを閉じマクロの記録を停止します。

[マクロの設定]ダイアログボックスでも記録できます。
[マクロの設定]ダイアログボックスからマクロを記録するには1.

[ツール -> マクロの設定]を選択し、[マクロの設定]ダイアログボックスを開きます。

2.

[記録]ボタンをクリックしてください。ダイアログボックスが閉じ記録を開始します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 241 of 479

High-performance Embedded Workshop V.4.09

15.5

15.

マクロ生成支援機能

マクロファイルにマクロを記録できる機能

High-performance Embedded Workshopシステムのすべての操作がスクリプトとしてマクロファイルに記録できるわけではありません。記録できる操作については、各機能のメニューオプション一覧にも"マクロの記録"として記録機能のサポートの有無を記載していますので参照してください。
•

マクロを記録できる機能(High-performance Embedded Workshop共通)•

マクロを記録できる機能(デバッガ依存)15.5.1

マクロを記録できる機能（High-performance Embedded Workshop共通）

連携ツールの製品パッケージにバンドルされているHigh-performance Embedded Workshopで共通の機能の中で、マクロを記録できる機能について示します。
•

メニューオプション、ショートカットキー、およびツールバーボタン

マクロの記録中、以下に示すメニューオプション、ショートカットキー、およびツールバーボタンの操作、または表示されるダイアログボックスへの設定を記録できます。
メニュー
ファイル

編集

プロジェクト

ビルド *1

デバッグ

メニューオプション

ショートカットキー

ツールバーボタンワークスペースを開く--

ワークスペースの保存--

ワークスペースを閉じる--

新規セッション

--セッションのインポート--

セッションの保存--

セッションのリフレッシュ--

ダウンロードモジュールの追加 *2--

最近使ったワークスペース--

最近ダウンロードしたモジュール--

ブレークポイントの挿入/削除

F9

ブレークポイントの有効化/無効化

Ctrl+F9

アクティブプロジェクトに設定--

プロジェクトの挿入--

構成の編集 *3

-

-

コンパイル
ビルド

F7

すべてをビルド

-

複数ビルド

-

-

クリーン アクティブプロジェクト--

クリーン 全プロジェクト--

ビルドの構成 *4-

デバッグセッション *5-

CPU のリセット-

R20UT0372JJ0100 Rev.1.00
2011.02.01

Ctrl+F7

Page 242 of 479

High-performance Embedded Workshop V.4.09

メニュー

メニューオプション
実行

ショートカットキー

マクロ生成支援機能

ツールバーボタン

F5

リセット後実行

Shift+F5

フリー実行 *3-

カーソル位置まで実行-

カーソル位置に PC 値を設定-

条件を指定して実行-

ステップイン

F11

ステップオーバ

F10

ステップアウト

Shift+F11

ステップ

基本設定

15.

-

-

-

ステップ

自動

-

-

モード

アセンブリ

-

-

ソース

-

-

プログラムの停止

-

初期化

-

接続 *3

-

接続解除 *3-

メモリの保存--メモリのベリファイ *3

-

-

ダウン

ダウンロードモジュール名

-

-

ロード

All Download Modules

-

-

アン

ダウンロードモジュール名

-

-

ロード

All Downloaded Modules

-

-

基数

16 進数

-

10 進数

-

8 進数

-

2 進数

-

-

注：
*1. High-performance Embedded Workshop V.4.01以降で作成したデバッグ専用プロジェクトを使用する場合、このメニューは表示されません。
*2. [オフセット]、[ファイルフォーマット]、[ファイル名]、[アクセスサイズ]、および[ダウンロード時のメモ
リベリファイ]オプションを記録します。[デバッグ情報のみのダウンロード]および[ターゲット接続時にダウンロード]オプションは記録しません。
*3. 機能のサポートはデバッガに依存します。
*4. [現在のコンフィグレーション]ドロップダウンリストの切り替えを記録します。
*5. [現在のセッション]ドロップダウンリストの切り替えを記録します。
•

ウィンドウ

マクロの記録中、以下に示すウィンドウへの操作を記録します。記録する操作については、各ウィンドウに関する説明を参照してください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 243 of 479

High-performance Embedded Workshop V.4.09

ウィンドウ名15.

マクロ生成支援機能

ウィンドウ表示メニュー

ワークスペースウィンドウの[Projects]タブ[表示 -> ワークスペース]エディタ

ワークスペースウィンドウの[Projects]タブ上にツリー表示されるソース
ファイルのダブルクリック

逆アセンブリ[表示 -> 逆アセンブリ]

レジスタ[表示 -> CPU -> レジスタ ]メモリ[表示 -> CPU -> メモリ]

IO

[表示 -> CPU -> IO]

15.5.1.1

ワークスペースウィンドウの Projects タブ

マクロの記録中、以下に示す操作を記録できます。
操作対象[クリーン 全プロジェクト]ポップアップメニュー

操作内容
クリック

ワークスペース オプション *1

機能すべてのプロジェクトのビルドの中間ファイルおよび出力ファイルの削除

プロジェクト[ビルド]ポップアップメニューオプション *1

ビルド[すべてをビルド]ポップアップメニューオプション

すべてをビルド*1[クリーン アクティブプロジェクト]ポップアップ

現在のコンフィグレーシ

メニューオプション *1

ョンのビルドの中間ファ
イルおよび出力ファイルの削除

プロジェクト[アクティブプロジェクトに設定]ポップアップメニ

アクティブプロジェクトューオプション

に設定[コンパイル <ファイル名>]ポップアップメニュー

ファイルのコンパイル

オプション *1

ファイル

Download[全てダウンロード]ポップアップメニューオプショ

すべてのオブジェクト(プン

ログラム)ファイルのロード

modules
フォルダ[ダウンロードモジュールの追加]ポップアップメニ

クリックにより表示

オブジェクト(プログラューオプション

されるダイアログボム)ファイルのロードックスで設定 *2
ダウンロードモジュール名-ダブルクリック[ダウンロード]ポップアップメニューオプション

クリック[ダウンロード（debug 情報のみ）]ポップアップメ
ニューオプション
オブジェクト(プログラ[アンロード]ポップアップメニューオプションム)ファイルのアンロード[ダウンロードモジュールの追加]ポップアップメニ

クリックにより表示

オブジェクト(プログラューオプション

されるダイアログボム)ファイルのロードックスで設定 *2

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 244 of 479

High-performance Embedded Workshop V.4.0915.

マクロ生成支援機能

注：*1. ツールチェインが登録されていない場合は、使用できません。
*2. [オフセット]、[ファイルフォーマット]、[ファイル名]、[アクセスサイズ]、および[ダウンロード時のメモ
リベリファイ]オプションを記録します。[デバッグ情報のみのダウンロード]および[ターゲット接続時にダウンロード]オプションは記録しません。

15.5.1.2

エディタウィンドウ

マクロの記録中、以下に示す操作を記録できます。
表示モード
ソースモード

操作対象[コンパイル '<ファイル名>']ポップアップメ

操作内容
クリック

機能
ファイルのコンパイル

ニューオプション
ブレークポイントの挿入/削除[ブレークポイントの挿入/削除]ポップアップ
メニューオプション

ブレークポイントの有効化/無効化[ブレークポイントの有効化/無効化]ポップア
ップメニューオプション

カーソル位置まで実行[カーソル位置まで実行]ポップアップメニュ
ーオプション[カーソル位置に PC 値を設定]ポップアップメ

カーソル位置に PC 値を設定

ニューオプション
S/W ブレークポイントカラム

ダブルクリック

ブレークポイントの挿入/削除

混合モード／[カーソル位置まで実行]ポップアップメニュ

クリック

カーソル位置まで実行

逆アセンブリーオプションモード[カーソル位置に PC 値を設定]ポップアップメ

カーソル位置に PC 値を設定

ニューオプション
ブレークポイントの挿入/削除[ブレークポイントの挿入/削除]ポップアップ
メニューオプション

ブレークポイントの有効化/無効化[ブレークポイントの有効化/無効化]ポップア
ップメニューオプション[S/W ブレークポイント]カラム

15.5.1.3

ダブルクリック

ブレークポイントの挿入/削除

逆アセンブリウィンドウ

マクロの記録中、以下に示す操作を記録できます。
表示モード

操作対象

ソースモード[ブレークポイントの挿入/削除]ポップアップ

操作内容
クリック

機能
ブレークポイントの挿入/削除

メニューオプション
ブレークポイントの有効化/無効化[ブレークポイントの有効化/無効化]ポップア
ップメニューオプション

カーソル位置まで実行[カーソル位置まで実行]ポップアップメニュ
ーオプション[カーソル位置に PC 値を設定]ポップアップメ

カーソル位置に PC 値を設定

ニューオプション[S/W ブレークポイント]カラム

R20UT0372JJ0100 Rev.1.00
2011.02.01

ダブルクリック

ブレークポイントの挿入/削除

Page 245 of 479

High-performance Embedded Workshop V.4.09

表示モード

操作対象

混合モード／[カーソル位置まで実行]ポップアップメニュ

逆アセンブリーオプションモード[カーソル位置に PC 値を設定]ポップアップメ

15.

操作内容
クリック

マクロ生成支援機能機能
カーソル位置まで実行
カーソル位置に PC 値を設定

ニューオプション
ブレークポイントの挿入/削除[ブレークポイントの挿入/削除]ポップアップ
メニューオプション

ブレークポイントの有効化/無効化[ブレークポイントの有効化/無効化]ポップア
ップメニューオプション[S/W ブレークポイント - ASM]カラム

15.5.1.4

ダブルクリック

ブレークポイントの挿入/削除

レジスタウィンドウ

マクロの記録中、以下に示す操作を記録できます。
操作対象

操作内容

機能

[編集]ポップアップメニューオプション

クリックにより表示されるダイアログボックスで設定 *1

レジスタ

フラグレジスタ *2

クリック

値の設定

値

インプレース編集
ダブルクリックにより表示されるダイアログボックスで設定 *1

注：*1. [値]オプションを記録します。[基数]、[データ形式]オプションは記録しません。
*2. 機能のサポートはデバッガに依存します。

15.5.1.5

メモリウィンドウ

マクロの記録中、以下に示す操作を記録できます。
操作対象

操作内容

機能

[設定]ポップアップメニューオプション／ツールバーボタン

クリックにより表示されるダイ メモリ内容の設定[フィル]ポップアップメニュー項／ツールバーボタン

アログボックスで設定

指定データによるメモ
リ内容の一括変更[コピー]ポップアップメニュー項／ツールバーボタン

メモリ内容のコピー[比較]ポップアップメニュー項／ツールバーボタン *メモリ内容の比較[保存]ポップアップメニュー項／ツールバーボタン

メモリ内容の保存[読み込み]ポップアップメニュー項／ツールバーボタン

メモリ内容の読み込み値

インプレース編集

メモリ内容の設定

ダブルクリックにより表示されるダイアログボックスで設定

注：*. 機能のサポートはデバッガに依存します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 246 of 479

High-performance Embedded Workshop V.4.09

15.5.1.615.

マクロ生成支援機能

IO ウィンドウ

マクロの記録中、以下に示す操作を記録できます。
操作対象
値

操作内容
インプレース編集

機能
I/O レジスタの値の編集

ダブルクリックにより表示されるダイアログボックスで設定

15.5.2

マクロを記録できる機能（デバッガ依存）

連携ツールの製品パッケージにバンドルされているデバッガに依存する機能の中で、マクロを記録できる機能について示します。
• E10A-USB エミュレータソフトウェア（H8SXデバイスグループ）• H8S/Tiny E8a エミュレータデバッガ• H8 Tiny/Super Low Power E8a エミュレータデバッガ• H8 Tiny/Super Low Power E8 エミュレータデバッガ
すべてのデバッグ機能についてマクロを記録できます。
• M32C/80 E8 エミュレータデバッガ• M16C/Tiny, M16C/62P E8 エミュレータデバッガ• R8C/Tiny E8 エミュレータデバッガ
マクロの記録中、以下に示すウィンドウへの操作を記録できます。記録する操作については、各ウィンド
ウに関する説明を参照してください。
ウィンドウ
エディタ

ウィンドウ表示メニュー
ワークスペースウィンドウの[Projects]タブ上にツリー表示されるソースファイルのダブルクリック

逆アセンブリ[表示 -> 逆アセンブリ]

ラベル[表示 -> シンボル -> ラベル]ウォッチ

[表示 -> シンボル -> ウォッチ]

ローカル[表示 -> シンボル -> ローカル]

イベントポイント[表示 -> コード -> イベントポイント]• E10A-USB エミュレータソフトウェア（H8SXデバイスグループを除く）• E10T-USB エミュレータソフトウェア• M32C E8a エミュレータデバッガ• M16C E8a エミュレータデバッガ• R8C E8a エミュレータデバッガ• R32C E8a エミュレータデバッガ• 740 E8a エミュレータデバッガ• E6000H エミュレータソフトウェア• E6000 エミュレータソフトウェア
マクロの記録中、以下に示すウィンドウへの操作を記録できます。記録する操作については、各ウィンド
ウに関する説明を参照してください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 247 of 479

High-performance Embedded Workshop V.4.09

ウィンドウ

15.

マクロ生成支援機能

ウィンドウ表示メニュー

エディタ

ワークスペースウィンドウの[Projects]タブ上にツリー表示されるソースファイルのダブルクリック

逆アセンブリ[表示 -> 逆アセンブリ]

ラベル[表示 -> シンボル -> ラベル]ウォッチ

[表示 -> シンボル -> ウォッチ]

ローカル[表示 -> シンボル -> ローカル]• E1/E20 エミュレータソフトウェア
マクロの記録中、以下に示すメニューオプション、ショートカットキー、およびツールバーボタンの操作を記録できます。
メニュー
デバッグ

メニューオプション
RTOS デバッグ

ショートカットキー

カーソル位置まで実行

ツールバーボタン-ステップイン

Alt+F11

ステップオーバ

Alt+F10

ステップアウト

Shift+Alt+F11

マクロの記録中、以下に示すウィンドウまたはダイアログボックスへの操作を記録できます。記録する操作については、各ウィンドウまたはダイアログボックスに関する説明を参照してください。
ウィンドウ/ダイアログボックス
エディタ

ウィンドウ/ダイアログボックス表示メニュー
ワークスペースウィンドウの[Projects]タブ上にツリー表示されるソースファイルのダブルクリック

逆アセンブリ[表示 -> 逆アセンブリ]

ラベル[表示 -> シンボル -> ラベル]ウォッチ

[表示 -> シンボル -> ウォッチ]

ローカル[表示 -> シンボル -> ローカル]

オンチップブレーク条件設定 *[表示 -> イベント -> オンチップブレーク条件設定]

トレース条件設定 *[表示 -> イベント -> トレース条件設定]

パフォーマンス条件設定 *[表示 -> イベント -> パフォーマンス条件設定]

注：*. 機能のサポートはデバッガに依存します。
• E100 エミュレータソフトウェア
マクロの記録中、以下に示すメニューオプション、ショートカットキー、およびツールバーボタンの操作を記録できます。
メニュー
デバッグ

メニューオプション
RTOS デバッグ

カーソル位置まで実行

ショートカットキー

ツールバーボタン-ステップイン

Alt+F11

ステップオーバ

Alt+F10

ステップアウト

Shift+Alt+F11

マクロの記録中、以下に示すウィンドウまたはダイアログボックスへの操作を記録できます。記録する操作については、各ウィンドウまたはダイアログボックスに関する説明を参照してください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 248 of 479

High-performance Embedded Workshop V.4.09

ウィンドウ/ダイアログボックス
エディタ

15.

マクロ生成支援機能

ウィンドウ/ダイアログボックス表示メニュー
ワークスペースウィンドウの[Projects]タブ上にツリー表示されるソースファイルのダブルクリック

逆アセンブリ[表示 -> 逆アセンブリ]

ラベル[表示 -> シンボル -> ラベル]ウォッチ

[表示 -> シンボル -> ウォッチ]

ローカル[表示 -> シンボル -> ローカル]

コードカバレッジ[表示 -> コード -> コードカバレッジ]

データカバレッジ[表示 -> コード -> データカバレッジ]

ハードウェアブレーク条件設定[表示 -> イベント -> ハードウェアブレーク条件設定]

トレース条件設定[表示 -> イベント -> トレース条件設定]

パフォーマンス条件設定[表示 -> イベント -> パフォーマンス条件設定]

トリガ出力条件設定[表示 -> イベント -> トリガ出力条件設定]

リアルタイムプロファイル[表示 -> パフォーマンス -> リアルタイムプロファイル]

コンフィグレーションプロパティ[基本設定 -> エミュレータ -> システム]

デバイスセッティング[基本設定 -> エミュレータ -> デバイスセッティング]

Start/Stop ファンクション設定 *[基本設定 -> エミュレータ -> Start/Stop ファンクション設定]

注：*. 機能のサポートはデバッガに依存します。
• E200F エミュレータソフトウェア
マクロの記録中、以下に示すウィンドウまたはダイアログボックスへの操作を記録できます。記録する操作については、各ウィンドウまたはダイアログボックスに関する説明を参照してください。
ウィンドウ/ダイアログボックス
エディタ

ウィンドウ/ダイアログボックス表示メニュー
ワークスペースウィンドウの[Projects]タブ上にツリー表示されるソースファイルのダブルクリック

逆アセンブリ[表示 -> 逆アセンブリ]

ラベル[表示 -> シンボル -> ラベル]ウォッチ

[表示 -> シンボル -> ウォッチ]

ローカル[表示 -> シンボル -> ローカル]

トレース[表示 -> コード -> トレース]

イベントポイント[表示 -> コード -> イベントポイント]

リアルタイムプロファイル[表示 -> パフォーマンス -> リアルタイムプロファイル]

コンフィグレーション[基本設定 -> エミュレータ -> システム]• M32C FoUSB/UART デバッガ
• M16C R8C FoUSB/UART デバッガ
• M32C コンパクトエミュレータデバッガ• M16C R8C コンパクトエミュレータデバッガ• 740 コンパクトエミュレータデバッガ• M32C PC7501 エミュレータデバッガ• M16C R8C PC7501 エミュレータデバッガ• M32C PC4701 エミュレータデバッガ
R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 249 of 479

High-performance Embedded Workshop V.4.0915.

マクロ生成支援機能• M16C PC4701 エミュレータデバッガ• 740 PC4701 エミュレータデバッガ
マクロの記録中、以下に示すウィンドウへの操作を記録できます。記録する操作については、各ウィンド
ウに関する説明を参照してください。
ウィンドウ

ウィンドウ表示メニュー

ASM ウォッチ

[表示 -> シンボル -> ASM ウォッチ]

C ウォッチ[表示 -> シンボル -> C ウォッチ]

S/W ブレークポイント[表示 -> ブレーク -> S/W ブレークポイント]

アドレス一致ブレークポイント[表示 -> ブレーク -> アドレス一致ブレークポイント]• H8/300H Tinyシリーズ コンパクトエミュレータデバッガ
マクロの記録中、以下に示すウィンドウへの操作を記録できます。記録する操作については、各ウィンド
ウに関する説明を参照してください。
ウィンドウ

ウィンドウ表示メニュー

ASM ウォッチ

[表示 -> シンボル -> ASM ウォッチ]

C ウォッチ[表示 -> シンボル -> C ウォッチ]• E30A エミュレータデバッガ• M32C シミュレータデバッガ• M16C R8C シミュレータデバッガ• R32C シミュレータデバッガ• 740 シミュレータデバッガ
マクロの記録中、以下に示すウィンドウへの操作を記録できます。記録する操作については、各ウィンド
ウに関する説明を参照してください。
ウィンドウ

ウィンドウ表示メニュー

ASM ウォッチ

[表示 -> シンボル -> ASM ウォッチ]

C ウォッチ[表示 -> シンボル -> C ウォッチ]

S/W ブレークポイント[表示 -> ブレーク -> S/W ブレークポイント]• SuperHファミリ用シミュレータデバッガ• RXファミリ用シミュレータデバッガ• H8SX, H8S, H8ファミリ用シミュレータデバッガ
マクロの記録中、以下に示すウィンドウへの操作を記録できます。記録する操作については、各ウィンド
ウに関する説明を参照してください。
ウィンドウ
エディタ

ウィンドウ表示メニュー
ワークスペースウィンドウの[Projects]タブ上にツリー表示されるソースファイルのダブルクリック

逆アセンブリ[表示 -> 逆アセンブリ]

ラベル[表示 -> シンボル -> ラベル]ウォッチ

[表示 -> シンボル -> ウォッチ]

ローカル[表示 -> シンボル -> ローカル]

カバレジ[表示 -> コード -> カバレジ]

トレース[表示 -> コード -> トレース]

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 250 of 479

High-performance Embedded Workshop V.4.09

15.

ウィンドウ

マクロ生成支援機能

ウィンドウ表示メニュー

イベントポイント[表示 -> コード -> イベントポイント]

I/O シミュレーション[表示 -> CPU -> I/O シミュレーション]

機能のサポートは、デバッガに依存するため、エミュレータデバッガまたはシミュレータデバッガのユーザー
ズマニュアル、ヘルプ、およびリリースノートを参照してください。

エディタウィンドウ

15.5.2.1

マクロの記録中、以下に示す操作を記録できます。
表示モード
ソースモード

•

操作対象

操作内容

機能

[インスタントウォッチ]ポップアップ

クリックにより表示されるダイアログ

メニューオプション

ボックスで設定

シンボルの登録E8 エミュレータソフトウェア
操作対象[EVENT ポイント]カラム

操作内容

機能

ダブルクリック

ハードウェアブレークポイントの挿入/削除

逆アセンブリウィンドウ

15.5.2.2

マクロの記録中、以下に示す操作を記録できます。
表示モード
ソースモード

•

操作対象

操作内容

機能

[インスタントウォッチ]ポップアップ

クリックにより表示されるダイアログ

メニューオプション

ボックスで設定

シンボルの登録E8 エミュレータソフトウェア
操作対象[EVENT ポイント]カラム

15.5.2.3

操作内容

機能

ダブルクリック

ハードウェアブレークポイントの挿入/削除

ラベルウィンドウ

マクロの記録中、以下に示す操作を記録できます。
操作対象

操作内容

[追加]ポップアップメニューオプション／

クリックにより表示されるツールバーボタン

ダイアログボックスで設定[削除]ポップアップメニューオプション／

クリック

機能
シンボルの追加
シンボルの削除

ツールバーボタン
全シンボルの削除[すべてを削除]ポップアップメニューオプ
ション／ツールバーボタン[ロード]ポップアップメニューオプション

クリックにより表示される／ツールバーボタン

ダイアログボックスで設定[BP]カラム

ダブルクリック

R20UT0372JJ0100 Rev.1.00
2011.02.01

シンボルの追加
ソフトウェアブレークポイントの挿入/削除

Page 251 of 479

High-performance Embedded Workshop V.4.09

15.5.2.415.

マクロ生成支援機能

ウォッチウィンドウ

マクロの記録中、以下に示す操作を記録できます。
操作対象[自動更新有効化]ポップアップメニューオプション／ツール

操作内容
クリック

機能
シンボルの自動更新有

バーボタン

効化

[全シンボル自動更新有効化]ポップアップメニューオプショ

全シンボルの自動更新

ン／ツールバーボタン

有効化[自動更新無効化]ポップアップメニューオプション／ツール

シンボルの自動更新無

バーボタン

効化

[全シンボル自動更新無効化]ポップアップメニューオプショ

全シンボルの動更新無ン／ツールバーボタン

効化[値更新記録->記録開始]ポップアップメニューオプション／

クリックにより表示されるダイ 値更新の記録の開始

ツールバーボタン

アログボックスで設定[値更新記録->記録終了]ポップアップメニューオプション／

クリック

値更新の記録の終了

ツールバーボタン[シンボル登録]ポップアップメニューオプション／ツールバ

クリックにより表示されるダイ シンボルの登録

ーボタン *

アログボックスで設定[シンボル名の編集]ポップアップメニューオプション／ツー

シンボルの削除およびルバーボタン

登録[値の編集]ポップアップメニューオプション／ツールバーボ

シンボルの値の編集

タン[削除]ポップアップメニューオプション／ツールバーボタン

クリック

シンボルの削除
全シンボルの削除[全シンボル削除]ポップアップメニューオプション／ツール
バーボタン[基数->16 進数表示]ポップアップメニューオプション／ツ

シンボルの 16 進数表示

ールバーボタン[基数->10 進数表示]ポップアップメニューオプション／ツ

シンボルの 10 進数表示

ールバーボタン[基数->8 進数表示]ポップアップメニューオプション／ツー

シンボルの 8 進数表示

ルバーボタン[基数->2 進数表示]ポップアップメニューオプション／ツー

シンボルの 2 進数表示

ルバーボタン
シンボルの展開／縮小'+'マークおよび'-'マーク
変数名
値

ダブルクリックにより表示され シンボルの削除およびるダイアログボックスで設定

登録

インプレース編集

シンボルの値の編集

ダブルクリックにより表示されるダイアログボックスで設定

注：*. [スコープ]は記録しません。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 252 of 479

High-performance Embedded Workshop V.4.09

15.5.2.515.

マクロ生成支援機能

ローカルウィンドウ

マクロの記録中、以下に示す操作を記録できます。
操作対象[編集]ポップアップメニューオプション／

操作内容

機能

クリックにより表示されるダイアログボックスで設定

シンボルのツールバーボタン
値

値の編集
ダブルクリックにより表示されるダイアログボックスで設定
インプレース編集

15.5.2.6

イベントポイントウィンドウ

マクロの記録中、以下に示す操作を記録できます。
操作対象

操作内容

機能

[追加]ポップアップメニューオプション／

クリックにより表示される

ブレークポイントまたはブレークコンディシ

ツールバーボタン

ダイアログボックスで設定

ョンの設定[編集]ポップアップメニューオプション／

ブレークポイントまたはブレークコンディシ

ツールバーボタン

ョンの編集[有効]ポップアップメニューオプション／

ブレークポイントまたはブレークコンディシ

クリック

ツールバーボタンョンの有効[無効]ポップアップメニューオプション／

ブレークポイントまたはブレークコンディシ

ツールバーボタン

ョンの無効[削除]ポップアップメニューオプション／

ブレークポイントまたはブレークコンディシ

ツールバーボタン

ョンの削除[全て削除]ポップアップメニューオプショ

すべてのブレークポイントまたはブレークコ

ン／ツールバーボタン

ンディションの削除

15.5.2.7

コードカバレッジウィンドウ

マクロの記録中、以下に示す操作を記録できます。
操作対象

操作内容

[ハードウェア設定]ポップアップメニュー

クリックにより表示される

オプション／ツールバーボタン

ダイアログボックスで設定

15.5.2.8

機能• コードカバレッジメモリの割当て設定• コードカバレッジメモリの割当て解除

データカバレッジウィンドウ

マクロの記録中、以下に示す操作を記録できます。
操作対象

操作内容

[ハードウェア設定]ポップアップメニュー

クリックにより表示される

オプション／ツールバーボタン

ダイアログボックスで設定

R20UT0372JJ0100 Rev.1.00
2011.02.01

機能• データカバレッジメモリの割当て設定• データカバレッジメモリの割当て解除

Page 253 of 479

High-performance Embedded Workshop V.4.09

15.5.2.915.

マクロ生成支援機能

オンチップブレーク条件設定ダイアログボックス

マクロの記録中、以下に示す操作を記録できます。
操作対象

クリック

[適用]ボタン15.5.2.10

操作内容

機能
オンチップブレーク条件の設定

ハードウェアブレーク条件設定ダイアログボックス

マクロの記録中、以下に示す操作を記録できます。
操作対象

操作内容

機能

[適用]ボタンクリック

ハードウェアブレーク条件の設定[アクセスプロテクト違反]アイテムの[詳細]ボタン

クリックにより表示され違反検出領域の設定[初期化抜け]アイテムの[詳細]ボタン

るダイアログボックスで[スタックアクセス違反]アイテムの[詳細]ボタン *設定[タスクスタックアクセス違反]アイテムの[詳細]ボタン

注：*. 機能のサポートはデバッガに依存します。

15.5.2.11

トレース条件設定ダイアログボックス

マクロの記録中、以下に示す操作を記録できます。
•

E1/E20 エミュレータソフトウェア
操作対象

クリック

[適用]ボタン

•

操作内容

機能
トレース条件の設定

E100 エミュレータソフトウェア
操作対象

操作内容

機能

[適用]ボタンクリック

トレース条件の設定[アクセスプロテクト違反]アイテムの[詳細]ボタン

クリックにより表示され違反検出領域の設定[初期化抜け]アイテムの[詳細]ボタン

るダイアログボックスで[スタックアクセス違反]アイテムの[詳細]ボタン *設定[タスクスタックアクセス違反]アイテムの[詳細]ボタン

注：*. 機能のサポートはデバッガに依存します。

15.5.2.12

パフォーマンス条件設定ダイアログボックス

マクロの記録中、以下に示す操作を記録できます。
操作対象[適用]ボタン

R20UT0372JJ0100 Rev.1.00
2011.02.01

操作内容
クリック

機能
パフォーマンス条件の設定

Page 254 of 479

High-performance Embedded Workshop V.4.09

15.5.2.1315.

マクロ生成支援機能

トリガ出力条件設定ダイアログボックス

マクロの記録中、以下に示す操作を記録できます。
操作対象

操作内容
クリック

[適用]ボタン15.5.2.14機能
トリガ出力条件の設定

リアルタイムプロファイルウィンドウ

マクロの記録中、以下に示す操作を記録できます。
•

E200F エミュレータ ソフトウェア
操作対象

操作内容

機能

クリック

測定結果をすべてクリア[ファイルに保存]ポップアップメニューオプション／

クリックにより表示される測定結果をファイルに保存

ツールバーボタン

ダイアログボックスで設定[すべてのデータをクリア]ポップアップメニューオプ
ション／ツールバーボタン•

E100 エミュレータ ソフトウェア
操作対象

操作内容

機能

[範囲の設定]ポップアップメニューオプ

クリックにより表示されション／ツールバーボタン

るダイアログボックスで• プロファイルメモリの割当て設定• プロファイルメモリの割当て解除• リアルタイムプロファイルの測定モード設定• 各タスク ID の測定有効／無効

設定

計測単位の設定[プロパティ]ポップアップメニューオプ
ション／ツールバーボタン

測定結果をファイルに保存[ファイルに保存]ポップアップメニュー
オプション／ツールバーボタン[すべてのデータをクリア]ポップアップ

クリック

測定結果をすべてクリア

メニューオプション／ツールバーボタン

15.5.2.15

コンフィグレーションプロパティダイアログボックス

マクロの記録中、以下に示す操作を記録できます。
操作対象[OK]ボタン

操作内容
クリック

機能

• 動作クロック選択• プラットフォームの設定• 排他機能の選択• エミュレーションメモリの設定 *• フラッシュメモリ上書き設定 *• 例外警告の設定• RAM モニタ状態の保持設定 *• ワーク領域設定 *注：*. 機能のサポートはデバッガに依存します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 255 of 479

High-performance Embedded Workshop V.4.0915.

マクロ生成支援機能

デバイスセッティングダイアログボックス

15.5.2.16

マクロの記録中、以下に示す操作を記録できます。
操作対象

操作内容
クリック

[OK]ボタン機能• デバイスの選択および動作モードの設定• 外部バス設定 *• エミュレーションメモリの設定 *注：*. 機能のサポートはデバッガに依存します。

Start/Stop ファンクション設定ダイアログボックス

15.5.2.17

マクロの記録中、以下に示す操作を記録できます。
操作対象

操作内容

[OK]ボタンクリック

15.5.2.18

ASM ウォッチウィンドウ機能
ワークエリアの設定/実行関数の設定

マクロの記録中、以下に示す操作を記録できます。
操作対象[値の編集]ポップアップメニュー

操作内容

機能
ウォッチポイントのクリックにより表示されるダイアログボックスで設定

オプション／ツールバーボタン
値

値の編集
ダブルクリックにより表示されるダイアログボックスで設定
インプレース編集

C ウォッチウィンドウ

15.5.2.19

マクロの記録中、以下に示す操作を記録できます。
操作対象[値の編集]ポップアップメニュー

操作内容

機能
シンボルの値の編集

クリックにより表示されるダイアログボックスで設定

オプション／ツールバーボタン
値

ダブルクリックにより表示されるダイアログボックスで設定
インプレース編集

15.5.2.20

S/W ブレークポイントウィンドウ

マクロの記録中、以下に示す操作を記録できます。
操作対象[追加]ボタン

操作方法
クリック

機能
ソフトウェアブレークポイントの設定[削除]ボタン

ソフトウェアブレークポイントの解除[全て削除]ボタン

全ソフトウェアブレークポイントの解除[有効]ボタン

ソフトウェアブレークポイントの有効化[全て有効]ボタン

全ソフトウェアブレークポイントの有効化[無効]ボタン

ソフトウェアブレークポイントの無効化

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 256 of 479

High-performance Embedded Workshop V.4.09

操作対象

15.

操作方法

機能
全ソフトウェアブレークポイントの無効化[全て無効]ボタン[S/W ブレークポイント]リストの選択項目

15.5.2.21

マクロ生成支援機能

ダブルクリック

ソフトウェアブレークポイントの有効化または無効化

アドレス一致ブレークポイントウィンドウ

マクロの記録中、以下に示す操作を記録できます。
操作対象

操作方法

機能
アドレス一致ブレークポイントの設定

クリック[追加]ボタン[削除]ボタン

アドレス一致ブレークポイントの解除[全て削除]ボタン

全アドレス一致ブレークポイントの解除[有効]ボタン

アドレス一致アブレークポイントの有効化[全て有効]ボタン

全アドレス一致ブレークポイントの有効化[無効]ボタン

アドレス一致ブレークポイントの無効化[全て無効]ボタン

全アドレス一致ブレークポイントの無効化[アドレス一致ブレークポイント]リストのダブルクリック

アドレス一致ブレークポイントの有効化または無効化

選択項目

15.5.2.22

トレースウィンドウ

マクロの記録中、以下に示す操作を記録できます。
操作対象

操作内容

[設定]ポップアップメニュー／ツールバー

クリックにより表示されるダイアログボ

ボタン

ックスで設定15.5.2.23

機能
トレース情報取得の設定

コンフィグレーションダイアログボックス

マクロの記録中、以下に示す操作を記録できます。
操作対象

操作内容
クリック

[OK]ボタン15.5.2.24

機能
プラットフォームの設定

カバレジウィンドウ

マクロの記録中、以下に示す操作を記録できます。
操作対象[すべて有効]ポップアップメニューオプション／ツールバーボ

操作内容
クリック

機能
カバレジ測定をすべて有効化

タン
カバレジ測定をすべてクリア[すべてクリア]ポップアップメニューオプション／ツールバー
ボタン

カバレジ測定範囲を追加[測定範囲追加]ポップアップメニューオプション／ツールバー

クリックにより表示

ボタン

されるダイアログボ[測定範囲編集]ポップアップメニューオプション／ツールバーックスで設定カバレジ測定範囲を編集

クリック

カバレジ測定の有効化

ボタン[有効]ポップアップメニューオプション／ツールバーボタン
R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 257 of 479

High-performance Embedded Workshop V.4.09

15.

操作対象

操作内容

マクロ生成支援機能

機能
カバレジ測定をクリア[クリア]ポップアップメニューオプション／ツールバーボタン[保存]ポップアップメニューオプション／ツールバーボタン

クリックにより表示

カバレジ情報の保存[ロード]ポップアップメニューオプション／ツールバーボタン

されるダイアログボ

カバレジ情報のロードックスで設定15.5.2.25

I/O シミュレーションウィンドウ

マクロの記録中、以下に示す操作を記録できます。
操作対象[削除]ポップアップメニューオプション／

操作内容
クリック

機能
I/O シミュレーションウィンドウの内容のクリア

ツールバーボタン

15.6

マクロを実行する

マクロファイルを実行するには下記に示すいくつかの方法があります。
ツールバーまたはメニューからマクロを実行するには
1.

[マクロの実行]ボタン( )またはマクロツールバーや[ツール]メニューの[マクロの実行]を選択してく
ださい。

2.

定義されたマクロが1つの場合は自動的にそれを実行します。現在のデフォルトのマクロファイルに複数のマクロがある場合、ダイアログボックスが表示され、実行するマクロを選択できます。実行中はマウスポインタに[マクロの実行]アイコンが付きます(3.

)。

OKをクリックするとマクロを実行します。マクロ実行中、[マクロの一時停止]ボタン( )および[マクロの停止]ボタン( )やメニューが有効になります。実行の一時停止中はマウスポインタに[マクロの一
時停止]アイコンが付きます()。

[マクロの設定]ダイアログボックスでマクロの割り当てを設定すると、マクロツールバー、メニュー、またはキーボードのショートカットから簡単にマクロを実行することもできます。割り当ての詳細は「15.8 マクロを割り当てる」を参照してください。
[マクロの設定]ダイアログボックスでマクロを実行することもできます。
[マクロの設定]ダイアログボックスからマクロを実行するには
1.

[ツール -> マクロの設定]を選択し、[マクロの設定]ダイアログボックスを開きます。

2.

実行したい機能を含むマクロファイルを選択してください。

3.

マクロ一覧から実行したマクロ機能を選択してください。

4.

[実行]ボタンをクリックしてください。

5.

[マクロの設定]ダイアログボックスが閉じマクロを実行します。

15.7

マクロを編集する

マクロファイルを編集するには下記に示すいくつかの方法があります。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 258 of 479

High-performance Embedded Workshop V.4.0915.

マクロ生成支援機能マクロを編集するには
1.

[ツール -> マクロの設定]を選択し、[マクロの設定]ダイアログボックスを開きます。

2.

編集したい機能があるマクロファイルを選択してください。

3.

編集するマクロ機能をマクロ一覧から選択してください。

4.

[編集]ボタンをクリックしてください。

5.

[マクロの設定]ダイアログボックスが閉じHigh-performance Embedded Workshopのエディタウィンドウでファイルが開きます。

マクロファイルは、各ユーザプロファイルのアプリケーションデータフォルダにあるHigh-performance
Embedded Workshop管理情報フォルダ下の"Macros"フォルダに格納されています。これらのファイルはテキス
トベースのHigh-performance Embedded Workshopコマンドラインのコマンドファイルなので、High-performance
Embedded Workshopのエディタウィンドウで手動により編集することもできます。編集結果は次回マクロを使用するときに反映されます。

15.8

マクロを割り当てる

カスタムのメニューオプション、ツールバー、またはキーボードのショートカットにマクロの割り当てが可能です。これにより、頻繁に使用するマクロにすばやくアクセスできます。[ツール]メニュー、[マクロ]ツール
バー、キーボードのショートカットすべてに同じマクロの割り当てが可能です。カスタムのメニューオプショ
ンおよびツールバーの表示順序は、アルファベット順です。
ツールバーボタンにマクロを割り当てるには1.

[ツール -> マクロの設定]を選択し、[マクロの設定]ダイアログボックスを開きます。

2.

割り当てたい機能があるマクロファイルを選択してください。

3.

割り当てるマクロ機能を[マクロ一覧]から選択してください。

4.

[割り当て]ボタンをクリックし、[割り当ての詳細]ダイアログボックスを開きます。

5.

[ツールバーの割り当て]チェックボックスをオンにしてください。

6.

[説明]でマクロの記述を変更できます。マクロをツールバーボタンに割り当てたときにツールバーでのツールチップとして使用されます。

7.

デフォルトのマクロツールバーボタン()を使用するか、既存のビットマップファイル(*.bmp)から独自のツールバーボタンの画像を指定するかを選択できます。
8.

独自の画像を使用する場合、[参照]ボタンをクリックして標準のファイルブラウザを開いてください。
これによりマシン上のファイルを手動で検索できます。

9.

OKをクリックすると[マクロ]ツールバーに追加します。

メニューにマクロを割り当てるには1.

[ツール -> マクロの設定]を選択し、[マクロの設定]ダイアログボックスを開きます。

2.

割り当てたい機能があるマクロファイルを選択してください。

3.

割り当てるマクロ機能を[マクロ一覧]から選択してください。

4.

[割り当て]ボタンをクリックし、[割り当ての詳細]ダイアログボックスを開きます。

5.

[メニュー名の割り当て]チェックボックスをオンにしてください。

6.

[説明]でマクロの記述を変更できます。これはマクロをメニューに割り当てたときにメニューのツー
ルチップとして使用されます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 259 of 479

High-performance Embedded Workshop V.4.09

15.

7.

[ツール]メニューで表示したいメニュー名を入力してください。

8.

OKをクリックすると[ツール]メニューに追加します。

マクロ生成支援機能

キーボードのショートカットにマクロを割り当てるには1.

[ツール -> マクロの設定]を選択し、[マクロの設定]ダイアログボックスを開きます。

2.

割り当てたい機能があるマクロファイルを選択してください。

3.

割り当てるマクロ機能を[マクロ一覧]から選択してください。

4.

[割り当て]ボタンをクリックし、[割り当ての詳細]ダイアログボックスを開きます。

5.

[キーボードショートカットの割り当て]チェックボックスをオンにしてください。

6.

マクロに割り当てたいキーボードのショートカットをドロップダウンリストで選択してください。

7.

OKをクリックするとショートカットが使用可能になります。

15.9

アウトプットウィンドウのMacroタブの構成

アウトプットウィンドウの[Macro]タブは、現在のマクロの記録状況を出力します。[ツール -> マクロの記録]
による記録の開始から[ツール -> マクロの停止]による記録の終了までにHigh-performance Embedded
Workshopマクロファイルに記録したHigh-performance Embedded Workshopコマンドラインのコマンドなどの情報を出力します。マクロを記録中に記録内容を確認できます。

ウィンドウ内で右クリックすると、使用可能なオプションをポップアップメニューで表示します。
基本的なオプションをツールバーに割り付けています。
[ツールバー表示]、[ツールバーのカスタマイズ]は、ツールバー内で右クリックしても、ポップアップメニュ
ーを表示します。
ポップアップメニューオプション

ツールバーボタン

機能

クリア

ウィンドウ内容をクリアします。

保存

ウィンドウ内容をテキストファイルに保存します。

コピー

ウィンドウ内容の選択部分を Windows® クリップボードにコピーします。

ツールバー表示-

ツールバー表示/表示なしを切り替えます。

ツールバーのカスタマイズ-

ツールバーボタンをカスタマイズします。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 260 of 479

High-performance Embedded Workshop V.4.09

16.

16.

テスト支援機能

テスト支援機能

High-performance Embedded Workshopにはユーザアプリケーションの回帰テストを行うためのテスト支援機能があります。回帰テストとはプログラムの修正後に前回成功したテストを再び実行し、その結果を検証するために実行されるものです。
この機能を使用することで、生成したマクロおよびバッチファイルを実行し、High-performance Embedded
Workshopシステムと元の取得データと比較し一致しているか否かを確認できます。様々なテストやスクリプトを作成し、テスト手順を自動化できます。テストが完了すると結果がテストブラウザウィンドウに表示されます。テスト手順の自動化により複数の回帰テスト実行での作業を軽減できます。
テスト支援機能は、High-performance Embedded Workshopの機能を実行する手段としてコマンドラインバッチ
ファイルを使用しています。マクロ生成支援機能を使用するか、コマンドラインバッチファイルを編集することで作成できます。テスト実行を自動化するために、テストスイートを開く／閉じる、テストデータを実行／比較するといったテスト支援機能用のコマンドをサポートしています。
最初のステップはテストスイートの作成です。これは[テスト]メニューで作成します。次にそのテストスイー
トを編集し、実際のテストを作成します。[テストを実行]を使用して作成したテストを実行できます。
High-performance Embedded Workshopシステムにあるすべての機能のテストイメージデータを保存できるわけ
ではありません。テストイメージデータを保存できる機能については、「16.6 テストイメージファイルにテス
トイメージデータとして保存できる機能」を参照してください。

16.1

テストスイートを作成する

テストスイートはテストの集まりです。テストスイートの概念はワークスペースと似ています。実行する複数のマクロを含む複数のテストをテストスイートに含めることができます。

テストスイートは、現在のHigh-performance Embedded Workshopワークスペースに依存しません。このため、テストスイートを複数のワークスペースおよびプロジェクトで動作させ、1つのテストスイートで様々な状況のテストを行うことが可能です。テストスイート機能で使用できる"open_workspace"および"change_project"コ
マンドは現在使用しているワークスペースを変更できます。
R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 261 of 479

High-performance Embedded Workshop V.4.09

16.

テスト支援機能

テストスイートを作成するには
1.

[テスト -> テストスイートの作成]を選択してください。[新規テストスイートの作成]ダイアログボッ
クスが開きます。

2.

[テストスイート名]にテストスイート名を入力してください。

3.

[ディレクトリ］はあらかじめワークスペースディレクトリを表示しています。必要に応じて編集して
ください。

4.

[OK]ボタンをクリックしてください。テストスイートが作成されます。[テスト]メニューにある他のオプションが使用可能になります。

テストスイートを作成すると、ワークスペースウィンドウの[Test]タブにテストスイートを追加します。このタブにより、テストスイートの操作およびテストへ容易にアクセスできます。
テストスイートファイルは、保存先の場所に拡張子".HTS"（High-performance Embedded Workshopテストスイート）の付いたファイルとして保存します。

16.2

テストスイートを開く／閉じる

テストスイートを作成すると、拡張子".HTS"（High-performance Embedded Workshopテストスイート）の付いたファイルとして保存します。以前に作成したテストスイートファイルを開きたい場合は、以下の操作を実行
してください。
テストスイートを開くには
1.

[テスト -> テストスイートを開く]を選択してください。[テストスイートを開く]ダイアログボックスが開きます。

2.

テストスイートファイルを選択し、[選択]ボタンをクリックしてください。テストスイートを読み込みます。[テスト]メニューにある他の項目が使用可能になり、ワークスペースウィンドウの[Test]タブに、テストスイートを表示します。

最近開いたファイルを[ファイル -> 最近使ったテストスイート]のサブメニューに表示します。最近使ったテストスイートを再び開きたいときに使用してください。
テストスイートを閉じるには[テスト -> テストスイートを閉じる]を選択してください。現在のテストスイートが閉じ、ワークスペースウ
ィンドウの[Test]タブからすべての項目を削除します。
これらの操作は、コマンドラインウィンドウからHigh-performance Embedded Workshopコマンドラインのコマンドを使用することによっても可能です。対応するコマンドは"open_test_suite"と"close_test_suite"です。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 262 of 479

High-performance Embedded Workshop V.4.09

16.

テスト支援機能ワークスペースウィンドウの[Test]タブのポップアップメニューからも、テストスイートを閉じることができ
ます。

16.3

テストスイートを編集する

テストスイートを作成したら、次のステップはテストの追加です。この操作により、[テストスイートの編集]
ダイアログボックスにアクセスし、実行したいテストを追加できます。
テストスイートを編集するには
1.

[テスト -> テストスイートの編集]を選択してください。[テストスイートの編集]ダイアログボックスが開きます。

[テストスイートの編集]ダイアログボックスは、現在定義しているテストケースを表示します。各テストケー
スには名前があり、テストの目的を説明するため、詳細な説明を付けることができます。
このダイアログボックスで[追加]ボタンをクリックすると、[テストの追加]ダイアログボックスが開きます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 263 of 479

High-performance Embedded Workshop V.4.09

16.

テスト支援機能

テストを選択し[変更]ボタンをクリックすると、選択したテストについて現在定義している詳細を変更できます。これらの詳細は、[テストの追加]で使用したダイアログボックスにも表示します。[削除]ボタンをクリッ
クすると、テストを削除します。
[テストの追加]ダイアログボックスでは、後で実行するためのテストを設定できます。詳細は「テストスイー
トにテストを追加する」で説明します。
ワークスペースウィンドウの[Test]タブのポップアップメニューからも、テストスイートを編集できます。

16.4

テストスイートにテストを追加する

テストスイートを作成したら、次のステップはテストの追加です。この操作により、[テストスイートの編集]
ダイアログボックスにアクセスし、実行したいテストを追加できます。
テストスイートにテストを追加するには
1.

[テスト -> テストスイートの編集]を選択してください。[テストスイートの編集]ダイアログボックスが開きます。

2.

[追加]ボタンをクリックしてください。[テストの追加]ダイアログボックスが開きます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 264 of 479

High-performance Embedded Workshop V.4.09

16.

テスト支援機能

新しいテストを追加するには以下のデータの設定が必要です:1.

テスト名を入力してください。名前にはスペースを含まないようにしてください。

2.

テストの説明を入力してください。後から分かりやすいように詳細な説明を入力してください。

3.

[追加]ボタンをクリックし、実行するテストを設定してください。[テストスクリプトの追加]ダイアロ
グボックス（下記参照）が開きます。

4.

[スクリプトタイプ]ドロップダウンリストで、High-performance Embedded Workshopマクロ（"HEW
Macro"）またはHigh-performance Embedded Workshopコマンドラインバッチファイル（"TCL commandline batch file"）が選択できます。

5.

[スクリプトタイプ]ドロップダウンリストで"HEW Macro"を選択すると、すべての登録済みのマクロを[テストに追加するマクロ]リストに表示します。

6.

各テストに対し、実行したいマクロファイルを複数選択できます。使用したいマクロ名の横にあるチェックボックスをオンにしてください。

7.

[スクリプトタイプ]ドロップダウンリストで"TCL command line batch file"を選択すると、[テストスクリ
プトの追加]ダイアログボックスが変更され、テスト実行時に実行するファイルを定義できます。

8.

OKをクリックすると、結果を保存し[テストの追加]ダイアログボックスに追加します。

9.

最後に、[テストイメージファイル]を指定できます。このファイルには、テスト実行後に比較するシステム用の比較データを保存します。"Test_Demo"テストアイコン上で右クリックしポップアップメニ
ューを表示します。[テストイメージファイルの編集]を選択し[テストイメージファイルの編集]ダイア
ログボックスを開きます。[テスト -> テストイメージファイルの作成]を使用することで、ファイルを作成できます。

10. OKをクリックすると[テストスイートの編集]ダイアログボックスにテストを追加します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 265 of 479

High-performance Embedded Workshop V.4.09

16.5

16.

テスト支援機能

テストイメージファイルを作成する

テストイメージデータは、テストシステムでの比較に使用します。比較できるのは、テストイメージファイルに保存した項目のみです。
例えば、デバイス全体のメモリでなく、特定の範囲のメモリにあるメモリデータのみを比較したいとします。
各テストで比較する項目数が多いほど比較処理は遅くなり複数のテストを実行すると差が生じます。
テストイメージファイルに保存するテストイメージデータを作成するには
1.

[テスト -> テストイメージファイルの作成]を選択してください。[テストイメージの作成]ダイアログ
ボックスが開きます。

2.

[すべて選択]ボタンをクリックするとすべてのチェックボックスがオンになります。[すべて解除]ボタ
ンをクリックするとすべてのチェックボックスがオフになります。

3.

[インポート]ボタンをクリックすると、[テストイメージファイルのインポート]ダイアログボックスが

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 266 of 479

High-performance Embedded Workshop V.4.09

16.

テスト支援機能開きます。インポートしたいHIFファイルをブラウズしてください。既存のテストイメージファイルの設定をインポートします。
4.

ダイアログボックスに各テスト項目を表示します。テスト項目名の横にあるチェックボックスをオンにすると、そのテスト項目のテストイメージデータを保存します。

5.

ダイアログボックスでテスト項目を選択し、[設定]ボタンをクリックしてください。選択されたテス
ト項目用の詳細設定ダイアログボックスが開きます。テストイメージファイルに保存するテストイメ
ージデータをカスタマイズできます。詳細は次節の「16.6 テストイメージファイルにテストイメージ
データとして保存できる機能」を参照してください。

6.

OKボタンをクリックします。[テストイメージファイルの保存]ダイアログボックスが開きます。

7.

[テストの追加]ダイアログボックスで指定したHigh-performance Embedded Workshopテストイメージフ
ァイルを選択し保存するか、または新規High-performance Embedded Workshopテストイメージファイルに保存してください。チェックボックスがオンのテスト項目のテストイメージデータのみをテストイ
メージファイルに保存します。

ワークスペースウィンドウの[Test]タブのポップアップメニューからも、テストイメージファイルを編集でき
ます。

16.6

テストイメージファイルにテストイメージデータとして保存できる機能

High-performance Embedded Workshopシステムにあるすべての機能のテストイメージデータをテストイメージ
ファイルに保存できるわけではありません。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 267 of 479

High-performance Embedded Workshop V.4.09

テスト支援機能16.

テストイメージデータとしてテストイメージファイルに保存できる機能については、下記を参照してください。また、テスト実行後またはテストイメージファイルの比較の際に、各テスト項目のテスト結果が不一致（FAIL）の場合のテスト結果の詳細情報についても記載しています。
•

テストイメージファイルに保存できる機能(High-performance Embedded Workshop共通)•

テストイメージファイルに保存できる機能(デバッガ依存)

テストイメージデータを保存する際にテスト項目の詳細設定が必要な場合があります。その場合は、[テスト
イメージの作成]ダイアログボックスで各テスト項目をダブルクリックすると、テスト項目の詳細設定ダイア
ログボックスが開きます。
テスト項目の詳細設定があるものは、テストイメージファイルに保存するテストイメージデータをカスタマイズできます。
テスト項目の詳細設定がないものは、テスト項目の左横のチェックボックスがオンの場合にはそのテスト項目のすべてのテストイメージデータをテストイメージファイルに保存します。
テストイメージデータをテストイメージファイルに保存できる機能については、[表示]メニュー一覧にも"テス
トイメージデータの保存"としてファイルに保存マーク(

16.6.1)を記載していますので参照してください。

テストイメージファイルに保存できる機能（High-performance Embedded
Workshop共通）

連携ツールの製品パッケージにバンドルされているHigh-performance Embedded Workshopで共通の機能については、以下のテスト項目のテストイメージファイルに保存するテストイメージデータが選択できます。
[テストイメージの作成]ダイアログボックスのテスト項目と対応するウィンドウ名を以下に示します。
テストイメージファイルに保存するテストイメージデータとその詳細設定、およびテスト結果の詳細情報については、各ウィンドウ用のテスト項目に関する説明を参照してください。
テストイメージの作成ダイアログボックス
テストグループ名
Outputウィンドウ名ウィンドウ表示メニュー

テスト項目名Build Output Window

アウトプットウィンドウの[表示 -> アウトプット][Build]タブ
Debug Output Window

アウトプットウィンドウの[Debug]タブ

CPU

Code

Register *レジスタ[表示 -> CPU -> レジスタ]

IO *

IO

[表示 -> CPU -> IO]

Status *ステイタス[表示 -> CPU -> ステイタス]

Memory *メモリ[表示 -> CPU -> メモリ]

StackTrace *スタックトレース[表示 -> コード -> スタックトレース]

注：*. ターゲットに接続していない場合はテスト項目を指定できません。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 268 of 479

High-performance Embedded Workshop V.4.09

16.6.1.1

テスト支援機能

16.

Output-Build/Debug （アウトプットウィンドウ用）

テストイメージファイルに保存するテストイメージデータの内容、およびテスト結果（不一致の場合）の詳細
情報について以下に示します。
テストグループ名

Output

テスト項目名Build Output Window

テストイメージファイルに保存す

アウトプットウィンドウの[Build]タブのすべての表示内容です。

るテストイメージデータの内容
テスト結果の詳細情報

Original

テストイメージファイルの内容

New

現在のシステムまたは比較で使用するテストイメージファイルの内容

表示例

Original:
New:
Building - New - Debug

テストグループ名

Output

テスト項目名Debug Output Window

テストイメージファイルに保存す

アウトプットウィンドウの[Debug]タブのすべての表示内容です。

るテストイメージデータの内容
テスト結果の詳細情報

Original

テストイメージファイルの内容

New

現在のシステムまたは比較で使用するテストイメージファイルの内容

表示例

Original:
Connected
New:
Step Normal End

ウィンドウに対するテスト項目の詳細設定はありません。

16.6.1.2

CPU-Register（レジスタウィンドウ用）

テストイメージファイルに保存するテストイメージデータの内容、およびテスト結果（不一致の場合）の詳細
情報について以下に示します。
テストグループ名

CPU

テスト項目名Register

テストイメージファイルに保存す

レジスタウィンドウのすべての表示内容です。

るテストイメージデータの内容
テスト結果の詳細情報

Failed at 不一致のあったレジスタ名
registerSrc

テストイメージファイルの内容

Dest

現在のシステムまたは比較で使用するテストイメージファイルの内容

表示例

Failed at register R11, Src = 0x00000000, Dest = 0x00000fff

ウィンドウに対するテスト項目の詳細設定はありません。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 269 of 479

High-performance Embedded Workshop V.4.09

16.6.1.3

16.

テスト支援機能CPU-IO（IO ウィンドウ用）

テストイメージファイルに保存するテストイメージデータの内容、およびテスト結果（不一致の場合）の詳細
情報について以下に示します。
テストグループ名

CPU

テスト項目名IO

テストイメージファイルに保存すテスト項目の詳細設定値、およびテスト項目の詳細設定値で取得した[IO]ウィンドウ

るテストイメージデータの内容の内容です。デフォルトで I/O レジスタは指定されていません。

テスト結果の詳細情報

Failed at

不一致のあった I/O レジスタ名

Src

テストイメージファイルの内容

Dest

現在のシステムまたは比較で使用するテストイメージファイルの内容

表示例

Failed at IPRC, register value is different: Src = 0000, Dest = FFFF

詳細設定するには[テストイメージの作成]ダイアログボックスでテスト項目をダブルクリックすると、ウィンドウに対するテス
ト項目の詳細設定用のダイアログボックスが開きます。

1.

テストイメージファイルに保存するI/Oレジスタを指定するには、[IOレジスタの選択]リストのI/Oレジ
スタ名のチェックボックスをオンにします。チェックボックスのデフォルトはオフです。選択したI/O
レジスタは[選択中のIOレジスタ]に表示します。

2.

選択したI/Oレジスタのアドレスを比較しない場合は、[アドレスを比較しない]チェックボックスをオンにします。チェックボックスのデフォルトはオフです。

3.

OKボタンをクリックします。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 270 of 479

High-performance Embedded Workshop V.4.09

16.6.1.4

16.

テスト支援機能

CPU-Status（ステイタスウィンドウ用）

テストイメージファイルに保存するテストイメージデータの内容、およびテスト結果（不一致の場合）の詳細
情報について以下に示します。
テストグループ名

CPU

テスト項目名Status

テストイメージファイルに保存すテスト項目の詳細設定値、およびステイタスウィンドウのすべての内容です。デフるテストイメージデータの内容

ォルトでシートは指定されていません。

テスト結果の詳細情報

Sheet

不一致のあったシート名

Line

不一致のあった行番号

Src

テストイメージファイルの内容

Dest

現在のシステムまたは比較で使用するテストイメージファイルの内容

表示例

Status differs.
Sheet = Platform
Line = 6
Src = Execute From, Pipeline Reset
Dest = Execute From, EX Stage

詳細設定するには[テストイメージの作成]ダイアログボックスでテスト項目をダブルクリックすると、ウィンドウに対するテス
ト項目の詳細設定用のダイアログボックスが開きます。

1.

テストイメージファイルで比較するシートを指定するには、[Memory]、[Platform]、または[Events]チェックボックスをオンにします。チェックボックスのデフォルトはオフです。

2.

OKボタンをクリックします。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 271 of 479

High-performance Embedded Workshop V.4.09

16.6.1.5

16.

テスト支援機能

CPU-Memory（メモリウィンドウ用）

テストイメージファイルに保存するテストイメージデータの内容、およびテスト結果（不一致の場合）の詳細
情報について以下に示します。
テストグループ名

CPU

テスト項目名

Memoryテストイメージファイルに保存すテスト項目の詳細設定値、およびテスト項目の詳細設定値で取得したメモリウィン

るテストイメージデータの内容

ドウの内容です。デフォルトでメモリ範囲は指定されていません。

テスト結果の詳細情報

Failed at

不一致のあったアドレス

address
Src

テストイメージファイルの内容

Dest

現在のシステムまたは比較で使用するテストイメージファイルの内容

表示例

Failed at address 0x70000014. Src = 0x00002f5a, Dest = 0x00002704

詳細設定するには[テストイメージの作成]ダイアログボックスでテスト項目をダブルクリックすると、ウィンドウに対するテス
ト項目の詳細設定用のダイアログボックスが開きます。

•

メモリ範囲を追加する
1.

[テスト設定-メモリ]ダイアログボックスの[追加]ボタンをクリックし、[メモリ範囲の追加]ダイアログ
ボックスを開きます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 272 of 479

High-performance Embedded Workshop V.4.09

2.

16.

テスト支援機能

テストイメージファイルに保存するメモリ範囲は、[開始アドレス]、[終了アドレス]、および[アクセスサイズ]で指定します。

3.
•

OKボタンをクリックします。

メモリ範囲を変更する
1.

[テスト設定-メモリ]ダイアログボックスの[変更]ボタンをクリックします。[メモリ範囲]リストで選択したメモリ範囲を変更できます。リストは単一選択のみ可能です。[メモリ範囲の変更]ダイアログボ
ックスが開きます。

2.

テストイメージファイルに保存するメモリ範囲は、[開始アドレス]、[終了アドレス]、および[アクセスサイズ]で指定します。

3.
•

OKボタンをクリックします。

メモリ範囲を削除する
1.

[テスト設定-メモリ]ダイアログボックスの[削除]ボタンをクリックします。[メモリ範囲]リストで選択したメモリ範囲を削除できます。リストは単一選択のみ可能です。

OKボタンをクリックします。

16.6.1.6

Code-Stack Trace（スタックトレースウィンドウ用）

テストイメージファイルに保存するテストイメージデータの内容、およびテスト結果（不一致の場合）の詳細
情報について以下に示します。
テストグループ名

Code

テスト項目名StackTrace

テストイメージファイルに保存すテスト項目の詳細設定値、およびスタックトレースウィンドウの関数コールのネス

るテストイメージデータの内容

ト数分の内容です。デフォルトで[関数のネスト]に 10 が指定されています。

テスト結果の詳細情報

Src

テストイメージファイルの内容

Dest

現在のシステムまたは比較で使用するテストイメージファイルの内容

表示例

Value differs.
Src = F, PowerON_Reset_PC(), { 0000080E }Dest = F, PowerON_Reset_PC(), { 0000081C }R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 273 of 479

High-performance Embedded Workshop V.4.09

16.

テスト支援機能

詳細設定するには[テストイメージの作成]ダイアログボックスでテスト項目をダブルクリックすると、ウィンドウに対するテス
ト項目の詳細設定用のダイアログボックスが開きます。

テストイメージファイルに保存するスタックトレース範囲は、[関数のネスト]で指定した関数コール

1.

ネスト数分の表示内容です。
パラメータまたはローカル変数を比較する場合は、[パラメータ]、[ローカル変数]チェックボックスを2.

オンにします。チェックボックスのデフォルトはオフです。
アドレスを比較しない場合は、[アドレスを比較しない]チェックボックスをオンにします。チェック3.

ボックスのデフォルトはオフです。
4.

OKボタンをクリックします。

テストイメージファイルに保存できる機能（デバッガ依存）16.6.2

連携ツールの製品パッケージにバンドルされているデバッガに依存する機能について、下記のテスト項目のテストイメージファイルに保存するテストイメージデータが選択できます。
以下に示すデバッガがサポートしている[テストイメージの作成]ダイアログボックスのテスト項目と対応するウィンドウ名を以下に示します。
テストイメージファイルに保存するテストイメージデータとその詳細設定、およびテスト結果の詳細情報については、各ウィンドウ用のテスト項目に関する説明を参照してください。
テストイメージの作成

ウィンドウ名テストグループ名

テスト項目名Symbol

Watch

ウィンドウ

対応デバッガ

表示メニュー

ダイアログボックスウォッチ[表示 -> シンボ • E1/E20 エミュレータソフトウェア
ル -> ウォッチ] • E10A-USB エミュレータソフトウェア

Localsローカル[表示 -> シンボ • E10T-USB エミュレータソフトウェア
ル -> ローカル] • E8a エミュレータソフトウェア• E8 エミュレータソフトウェア• E100 エミュレータソフトウェア• E200F エミュレータソフトウェア• E6000H エミュレータソフトウェア• E6000 エミュレータソフトウェア• SuperH ファミリ用シミュレータデバッガ• RX ファミリ用シミュレータデバッガ• H8SX, H8S, H8 ファミリ用シミュレータデバ
ッガ

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 274 of 479

High-performance Embedded Workshop V.4.09

テストイメージの作成

ウィンドウ名ウィンドウ

テスト支援機能

対応デバッガ

表示メニュー

ダイアログボックス
テストグループ名

16.

テスト項目名ASM Watch

ASM ウォッ

[表示 -> シンボ •E30A エミュレータデバッガ

チル -> ASM ウォ •M32C FoUSB/UART デバッガ
M16C R8C FoUSB/UART デバッガ

C ウォッチ•[表示 -> シンボ •ッチ]

C Watchル -> C ウォッ
チ]

M32C コンパクトエミュレータデバッ
ガ•

M16C R8C コンパクトエミュレータデ
バッガ•

H8/300H Tiny シリーズ コンパクトエ
ミュレータデバッガ•••

740 コンパクトエミュレータデバッガ
M32C PC7501 エミュレータデバッガ
M16C R8C PC7501 エミュレータデバ
ッガ•
M32C PC4701 エミュレータデバッガ•
M16C PC4701 エミュレータデバッガ•
740 PC4701 エミュレータデバッガ•
M32C シミュレータデバッガ•
M16C R8C シミュレータデバッガ•
R32C シミュレータデバッガ• 740 シミュレータデバッガ
CPU

Code

Simulated I/OCoverage

I/O シミュレ[表示 -> CPU -> • SuperH ファミリ用シミュレータデバッガ

ーション

I/O シミュレー

カバレジ

ション]

• RX ファミリ用シミュレータデバッガ• H8SX, H8S, H8 ファミリ用シミュレータデバ[表示 -> CPU ->

ッガ

カバレジ]
Trace

トレース

[表示 -> コード-> トレース]• E10A-USB エミュレータソフトウェア• E10T-USB エミュレータソフトウェア• E8a エミュレータソフトウェア• E8 エミュレータソフトウェア• E200F エミュレータソフトウェア• E6000H エミュレータソフトウェア• E6000 エミュレータソフトウェア• SuperH ファミリ用シミュレータデバッガ• RX ファミリ用シミュレータデバッガ• H8SX, H8S, H8 ファミリ用シミュレータデバ
ッガ

ターゲットに接続していない場合はテスト項目を指定できません。
機能のサポートは、デバッガに依存するため、エミュレータデバッガまたはシミュレータデバッガのユーザー
ズマニュアル、ヘルプ、およびリリースノートを参照してください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 275 of 479

High-performance Embedded Workshop V.4.09

16.6.2.1

16.

テスト支援機能

Symbol-Watch（ウォッチウィンドウ用）

テストイメージファイルに保存するテストイメージデータの内容、およびテスト結果（不一致の場合）の詳細
情報について以下に示します。
テストグループ名

Symbol

テスト項目名

Watch

テストイメージファイルに保存すテスト項目の詳細設定値、およびテスト項目の詳細設定値で取得したウォッチウィ

るテストイメージデータの内容

ンドウの内容です。デフォルトで各シンボルのチェックボックスはオフです。

テスト結果の詳細情報

Failed at 不一致のあったシンボル名
symbolSrc

テストイメージファイルの内容

Dest

現在のシステムまたは比較で使用するテストイメージファイルの内容

表示例

Failed at symbol a[6], Src = (long)H'00002704{70000018}, Dest =(long)H'00000daa{70000018}

詳細設定するには[テストイメージの作成]ダイアログボックスでテスト項目をダブルクリックすると、ウィンドウに対するテス
ト項目の詳細設定用のダイアログボックスが開きます。
テスト対象は、スコープを[Current Scope]に設定した変数です。そのため、スコープを[Current Scope]以外に設定している場合、[シンボル]リストに表示されません。

1.

[ウォッチシート]ドロップダウンリストには、[Watch1]、[Watch2]、[Watch3]、および[Watch4]を表示します。[ウォッチシート]ドロップダウンリストで選択した項目によって、[シンボル]リストに表示するシンボルが変わります。

2.

[シンボル]リストの各項目にはチェックボックスを表示します。チェックボックスはデフォルトでオフです。テストイメージファイルに保存するシンボルを指定するには、[ウォッチシート]を選択しシンボルのチェックボックスをオンにします。選択したシンボルは[選択中のシンボル]に表示します。

3.

[アドレスを比較しない]チェックボックスをオンにします。チェックボックスのデフォルトはオフです。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 276 of 479

High-performance Embedded Workshop V.4.09

4.

テスト支援機能

16.

OKボタンをクリックします。

16.6.2.2

Symbol-Locals（ローカルウィンドウ用）

テストイメージファイルに保存するテストイメージデータの内容、およびテスト結果（不一致の場合）の詳細
情報について以下に示します。
テストグループ名

Symbol

テスト項目名

Locals

テストイメージファイルに保存すテスト項目の詳細設定値、およびテスト項目の詳細設定値で取得したローカルウィ

るテストイメージデータの内容

ンドウの内容です。デフォルトで各シンボルのチェックボックスはオフです。

テスト結果の詳細情報

Failed at 不一致のあったシンボル名
symbolSrc

テストイメージファイルの内容

Dest

現在のシステムまたは比較で使用するテストイメージファイルの内容

表示例

Failed at symbol i, Src = (int)H'00000001{R14}, Dest =(int)H'00000000{R14}

詳細設定するには[テストイメージの作成]ダイアログボックスでテスト項目をダブルクリックすると、ウィンドウに対するテス
ト項目の詳細設定用のダイアログボックスが開きます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 277 of 479

High-performance Embedded Workshop V.4.09

1.

16.

テスト支援機能

テストイメージファイルに保存するシンボルを指定するには、[シンボル]のチェックボックスをオンにします。チェックボックスのデフォルトはオフです。選択したシンボルは[選択中のシンボル]に表示されます。

2.

OKボタンをクリックします。

16.6.2.3

Symbol-ASM Watch（ASM ウォッチウィンドウ用）

テストイメージファイルに保存するテストイメージデータの内容、およびテスト結果（不一致の場合）の詳細
情報について以下に示します。
テストグループ名

Symbol

テスト項目名ASM Watch

テストイメージファイルに保存すテスト項目の詳細設定値、およびテスト項目の詳細設定値で取得した ASM ウォッ

るテストイメージデータの内容

チウィンドウの内容です。デフォルトでウォッチポイントは指定されていません。

テスト結果の詳細情報

Failed at xxx , data

不一致のあったウォッチポイント

value is different:
Src

R20UT0372JJ0100 Rev.1.00
2011.02.01

テストイメージファイルの内容

Page 278 of 479

High-performance Embedded Workshop V.4.09

Dest

16.

テスト支援機能

現在のシステムまたは比較で使用するテストイメージファイ
ルの内容

表示例

Failed at 414, data value is different: Src = 0000, Dest = 0001

詳細設定するには[テストイメージの作成]ダイアログボックスでテスト項目をダブルクリックすると、ウィンドウに対するテス
ト項目の詳細設定用のダイアログボックスが開きます。

•

ウォッチポイントを追加する
1.

[テスト設定-ASMウォッチ]ダイアログボックスの[追加]ボタンをクリックします。[追加]ダイアログボ
ックスが開きます。

2.

テストイメージファイルに保存するウォッチポイントは、[アドレス]、[サイズ]、および[基数]で指定
します。

3.

OKボタンをクリックします。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 279 of 479

High-performance Embedded Workshop V.4.09•

16.

テスト支援機能

ビット形式のウォッチポイントを追加する
1.

[テスト設定-ASMウォッチ]ダイアログボックスの[ビットの追加]ボタンをクリックします。[ビットの追加]ダイアログボックスが開きます。

2.

テストイメージファイルに保存するビット形式のウォッチポイントは、[ビットシンボル]、[アドレス]、[サイズ]、および[ビット]で指定します。

3.
•

OKボタンをクリックします。

ウォッチポイントを削除する
1.

[テスト設定-ASMウォッチ]ダイアログボックスの[削除]ボタンをクリックします。[ウォッチポイントの登録]リストで選択したウォッチポイントを削除します。リストは単一選択のみ可能です。

•

ウォッチポイントのアドレスを比較しない
1.

[テスト設定-ASMウォッチ]ダイアログボックスの[アドレスを比較しない]チェックボックスをオンにします。チェックボックスのデフォルトはオフです。

OKボタンをクリックします。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 280 of 479

High-performance Embedded Workshop V.4.09

16.6.2.4

16.

テスト支援機能

Symbol-C Watch（C ウォッチウィンドウ用）

テストイメージファイルに保存するテストイメージデータの内容、およびテスト結果（不一致の場合）の詳細
情報について以下に示します。
テストグループ名

Symbol

テスト項目名C Watch

テストイメージファイルに保存すテスト項目の詳細設定値、およびテスト項目の詳細設定値で取得した C ウォッチウ

るテストイメージデータの内容

ィンドウの内容です。デフォルトで各変数のチェックボックスはオフです。

テスト結果の詳細情報

Failed at xxx , data

不一致のあった変数名

value is different:
Src

テストイメージファイルの内容

Dest

現在のシステムまたは比較で使用するテストイメージファイ
ルの内容

表示例

Failed at (a)[0] ([Global]), data value is different: Src = 1783,
Dest = 0

詳細設定するには[テストイメージの作成]ダイアログボックスでテスト項目をダブルクリックすると、ウィンドウに対するテス
ト項目の詳細設定用のダイアログボックスが開きます。

•

変数を追加する
1.

[テスト設定-C変数]ダイアログボックスの[追加]ボタンをクリックします。[C変数の追加]ダイアログボ
ックスが開きます。変数をスコープ毎に追加します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 281 of 479

High-performance Embedded Workshop V.4.09

2.

16.

テスト支援機能[スコープ]ドロップダウンリストには、[Global]、[Local]、およびファイル名の一覧を表示します。[スコープ]ドロップダウンリストで選択した項目によって、[Name]リストに表示する変数が変わります。
[スコープ]ドロップダウンリストで[Global]を選択すると、[Name]リストにグローバル変数の一覧を表示します。また、[Local]を選択すると、現在のスコープ（プログラムカウンタ位置）で参照可能なローカル変数の一覧を表示します。また、ファイル名を選択すると、そのファイルが属するコンパイル
ユニットに含まれるファイルローカル変数の一覧を表示します。

3.

[Name]リストの各項目にはチェックボックスを表示します。チェックボックスはデフォルトでオフです。[Name]リストで '+' が表示されている変数は、ダブルクリックによって展開できます。ただし、'-'が表示されている変数をダブルクリックしても折りたたむことはできません。また、[Name]リストで'+'が表示されている変数のチェックボックスをオンにしても、その要素のチェックボックスはオフで
す。

•

4.

スコープを選択し変数のチェックボックスをオンにします。

5.

OKボタンをクリックします。

変数を削除する
1.

[テスト設定-C変数]ダイアログボックスの[削除]ボタンをクリックします。[C変数の登録]リストで選択した変数を削除します。リストは単一選択のみ可能です。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 282 of 479

High-performance Embedded Workshop V.4.09

16.

テスト支援機能

OKボタンをクリックします。

16.6.2.5

CPU-Simulated I/O（I/O シミュレーションウィンドウ用）

テストイメージファイルに保存するテストイメージデータの内容、およびテスト結果（不一致の場合）の詳細
情報について以下に示します。
テストグループ名

CPU

テスト項目名Simulated I/O

テストイメージファイルに保存すテスト項目の詳細設定値、およびテスト項目の詳細設定値で取得した I/O シミュレ

るテストイメージデータの内容

ーションウィンドウの内容です。デフォルトで保存する I/O シミュレーション範囲は指定されていません。

テスト結果の詳細情報

Failed at Line

不一致のあった行番号

src

テストイメージファイルの内容

dest

現在のシステムまたは比較で使用するテストイメージファイルの内容

表示例

Failed at Line 1: src = ### Data Input ### dest = a[1]=21468

詳細設定するには[テストイメージの作成]ダイアログボックスでテスト項目をダブルクリックすると、ウィンドウに対するテス
ト項目の詳細設定用のダイアログボックスが開きます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 283 of 479

High-performance Embedded Workshop V.4.09•

16.

テスト支援機能I/Oシミュレーション範囲を追加する
1.

[テスト設定-I/Oシミュレーション]ダイアログボックスの[追加]ボタンをクリックします。[I/Oシミュレ
ーションの追加]ダイアログボックスが開きます。

•

2.

テストイメージファイルに保存するI/Oシミュレーション範囲は、[全て]または[行番号]で指定します。

3.

OKボタンをクリックします。

I/Oシミュレーション範囲を変更する
1.

[テスト設定-I/Oシミュレーション]ダイアログボックスの[変更]ボタンをクリックします。[I/Oシミュレーション]リストで選択したI/Oシミュレーション範囲を変更します。リストは単一選択のみ可能です。
[I/Oシミュレーションの変更]ダイアログボックスが開きます。

2.

テストイメージファイルに保存するI/Oシミュレーション範囲は、[全て]または[行番号]で指定します。

3.

OKボタンをクリックします。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 284 of 479

High-performance Embedded Workshop V.4.09•

16.

テスト支援機能I/Oシミュレーション範囲を削除する
1.

[テスト設定-I/Oシミュレーション]ダイアログボックスの[削除]ボタンをクリックします。[I/Oシミュレーション]リストで選択したI/Oシミュレーション範囲を削除します。リストは単一選択のみ可能です。

OKボタンをクリックします。

16.6.2.6

Code-Coverage（カバレジウィンドウ用）

テストイメージファイルに保存するテストイメージデータの内容、およびテスト結果（不一致の場合）の詳細
情報について以下に示します。
テストグループ名

Code

テスト項目名Coverage

テストイメージファイルに保存すテスト項目の詳細設定値、およびテスト項目の詳細設定値で取得したカバレジウィ

るテストイメージデータの内容

ンドウの内容です。デフォルトでテスト範囲は指定されていません。

テスト結果の詳細情報

Range

カバレジ測定範囲

Instruction 不一致のあったテストオプション
Execution
mismatch

不一致のあったアドレス

at
Image

テストイメージファイルの内容

System

現在のシステムまたは比較で使用するテストイメージファイルの内容

表示例

Range DemoSH4.c:
Instruction Execution Time mismatch at 0x20E4 -- Image: 1 System: 0

詳細設定するには[テストイメージの作成]ダイアログボックスでテスト項目をダブルクリックすると、ウィンドウに対するテス
ト項目の詳細設定用のダイアログボックスが開きます。

1.

[有効な範囲]には設定されているカバレジ測定範囲が表示されます。

2.

テストイメージファイルに保存するカバレジ測定範囲は、[>>]ボタンをクリックし[テストの範囲]に移動します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 285 of 479

High-performance Embedded Workshop V.4.09

3.

テスト支援機能16.

テストイメージファイルにカバレジ測定範囲を保存する場合、アドレスは常に保存するため、テスト
オプションの[アドレス]チェックボックスは常にオンです（チェックボックスは選択できません）。
テストオプションの[実行パス]、[実行回数]、または[分岐条件]チェックボックスをオンにします。[実行パス]チェックボックスのデフォルトはオンです。[実行回数]、または[分岐条件]チェックボックスのデフォルトはオフです。

4.

OKボタンをクリックします。

16.6.2.7

Code-Trace（トレースウィンドウ用）

テストイメージファイルに保存するテストイメージデータの内容、およびテスト結果（不一致の場合）の詳細
情報について以下に示します。
テストグループ名

Code

テスト項目名Trace

テストイメージファイルに保存すテスト項目の詳細設定値、およびテスト項目の詳細設定値で取得したトレースウィ

るテストイメージデータの内容

ンドウの内容です。デフォルトでトレース範囲は指定されていません。

テスト結果の詳細情報

Comparing PTR

比較したトレース範囲

Trace type

トレースタイプ

Trace data is not

不一致のあったトレース範囲

matching. PTR
Src

テストイメージファイルの内容

Dest

現在のシステムまたは比較で使用するテストイメージファイル
の内容

表示例

Comparing PTR -3 to -1. Trace type : トレース.
Trace data is not matching. PTR:-3 to PTR:-1
Trace data at the beginning of difference. PTR:-3
Src : 0000001879 0000107C F->DEMMW MOV.L @R15+, R1
R1<-00000010
Dest: 0000001887 00000818 FD<E JSR @R5 PC<-00001000

詳細設定するには（トレース種別が単一の場合）[テストイメージの作成]ダイアログボックスでテスト項目をダブルクリックすると、ウィンドウに対するテス
ト項目の詳細設定用のダイアログボックスが開きます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 286 of 479

High-performance Embedded Workshop V.4.09•

16.

テスト支援機能

トレース範囲を追加する
1.

[テスト設定-トレース]ダイアログボックスの[追加]ボタンをクリックします。[トレース範囲の追加]ダ
イアログボックスが開きます。

•

2.

テストイメージファイルに保存するトレース範囲は、[開始PTR]および[終了PTR]で指定します。

3.

OKボタンをクリックします。

トレース範囲を変更する
1.

[テスト設定-トレース]ダイアログボックスの[変更]ボタンをクリックします。[トレース範囲]リストで選択したトレース範囲を変更します。リストは単一選択のみ可能です。[トレース範囲の変更]ダイア
ログボックスが開きます。

2.

テストイメージファイルに保存するトレース範囲は、[開始PTR]および[終了PTR]で指定します。

3.

OKボタンをクリックします。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 287 of 479

High-performance Embedded Workshop V.4.09•

16.

テスト支援機能

トレース範囲を削除する
1.

[テスト設定-トレース]ダイアログボックスの[削除]ボタンをクリックします。[トレース範囲]リストで選択したトレース範囲を削除します。リストは単一選択のみ可能です。

OKボタンをクリックします。
詳細設定するには（トレース種別が複数の場合）[テストイメージの作成]ダイアログボックスでテスト項目をダブルクリックすると、ウィンドウに対するテス
ト項目の詳細設定用のダイアログボックスが開きます。

•

トレース範囲を追加する
1.

[テスト設定-トレース]ダイアログボックスの[追加]ボタンをクリックします。[トレース範囲の追加]ダ
イアログボックスが開きます。

2.

テストイメージファイルに保存するトレース範囲は、[トレース種別]、[開始PTR]、および[終了PTR]
で指定します。

3.
•

OKボタンをクリックします。

トレース範囲を変更する
1.

[テスト設定-トレース]ダイアログボックスの[変更]ボタンをクリックします。[トレース範囲]リストで選択したトレース範囲を変更します。リストは単一選択のみ可能です。[トレース範囲の変更]ダイア
ログボックスが開きます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 288 of 479

High-performance Embedded Workshop V.4.09

2.

16.

テスト支援機能

テストイメージファイルに保存するトレース範囲は、[トレース種別]、[開始PTR]、および[終了PTR]
で指定します。

3.
•

OKボタンをクリックします。

トレース範囲を削除する
1.

[テスト設定-トレース]ダイアログボックスの[削除]ボタンをクリックします。[トレース範囲]リストで選択したトレース範囲を削除します。リストは単一選択のみ可能です。

OKボタンをクリックします。

16.7

テストイメージファイルを比較する

テストイメージファイルを比較するには
1.

[テスト -> テストイメージファイルの比較]を選択してください。[テストイメージファイルの比較]ダ
イアログボックスが開きます。

2.

[テストイメージファイル]に、比較したいテストイメージファイルのある場所を入力してください。
このファイルは"*.HIF"ファイル(High-performance Embedded Workshopテストイメージファイル)で、中にはテストイメージデータの詳細が保存されています。

3.

次に選択したファイルと比較する対象を選択してください。現在のシステム、または以前に保存された別のテストイメージファイルを選択できます。スクリプトを手動で実行し、現在のテストイメージ
データを過去に保存したテストイメージデータと比較して確認したい場合は、[現在のシステム]オプションが便利です。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 289 of 479

High-performance Embedded Workshop V.4.09

4.

16.

テスト支援機能

OKボタンをクリックしてください。テストブラウザに結果を表示します。

テスト実行時でなくとも、テストイメージファイルの比較が可能です。実際にテストを実行した後に、現在のシステムまたは2つのテストイメージファイルを手動で比較できます。
ワークスペースウィンドウの[Test]タブのポップアップメニューからも、テストイメージファイルを比較でき
ます。

16.8

テストを実行する

テストを選択し、その実行を自動化できます。
テストを実行するには
1.

[テスト -> テストを実行]を選択してください。[テストを実行]ダイアログボックスが開きます。

2.

High-performance Embedded Workshopテストシステムで現在定義されているすべてのテストを[テストケース]リストに表示します。

3.

チェックボックスをクリックすると、今回実行するテストを選択します。

4.

テストを選択して[上へ]および[下へ]ボタンをクリックすることで、テストの実行される順序を変更することもできます。

5.

1つ以上のテストを選択していれば、[実行]ボタンが使用可能です。[実行]ボタンをクリックすると、テストの実行を開始します。テスト実行中、アウトプットウィンドウの[Test]タブに情報を表示します。
テストが完了するとテストブラウザが開き、実行したすべてのテストの結果を表示します。

[テスト実行後の動作]ドロップダウンリストには2つのオプションがあります。
•"Compare system against saved test image file"オプションは、通常の動作で、関連するテストケースに添付したテストイメージファイル(*.HIF)と現在のHigh-performance Embedded Workshopシステムを比較します。これらの結果をテストブラウザに追加し、テストの成功／失敗、失敗した要因が情報として提供されます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 290 of 479

High-performance Embedded Workshop V.4.09•

16.

テスト支援機能"Refresh test image file"オプションは、テストケースを実行後に関連するテストケースに添付したテス
トイメージファイル(*.HIF)ファイルを更新します。

[自動的にテスト結果を保存]チェックボックスをオンにすると、各テストの実行結果を自動的にテキストファ
イルに保存できます。このファイルの場所は、テストスイートと同じディレクトリになります。ファイル名は、現在のテストスイート名とテスト実行時の日付が付加さています。
[エラー発生時は実行停止]チェックボックスをオンにすると、最初にエラーが発生した時点でテストの実行を停止します。最初のテストが原因で他のテストも失敗してしまう場合、何度もテストを実行せずに済みます。
[タイムアウト]はユーザコードを実行する場合に使用します。場合によっては、バグがあるコードを実行しテスト実行中に終了しない可能性があります。テストがこのボックスに入力された秒数よりも長くかかる場合、実行を中止しテストが失敗したとみなします。
ワークスペースウィンドウの[Test]タブのポップアップメニューからも、テストを実行できます。

16.9

テストブラウザを使用する

テストブラウザは、前回実行したテストの結果を表示します。
[テスト -> テスト結果ブラウザ]を選択すると、テストブラウザが開きます。

テストブラウザ上側のペインには、前回実行されたすべてのテストを表示します。テスト名の左にある緑のア
イコンは、テストが成功したことを示します。赤のアイコンは、テストが失敗したことを示します。
上側のペインでテストを選択すると、その下側のペインにテストの詳細を表示します。テストブラウザの下側のペインには、チェックしたすべてのテスト項目を表示しています。テスト項目名の左にある緑のアイコンは、テストが成功したことを示します。赤のアイコンは、テストが失敗したことを示します。テストが失敗した場
合、このウィンドウに詳細を表示します。
テスト項目をダブルクリックすると、テストイメージファイルの比較が失敗した原因について詳細な情報を表示します。テスト項目を選択し、ツールバーの[詳細]ボタンをクリックした場合もこの情報を参照できます。
テストの結果は、ファイルにエクスポートできます。[エクスポート]と[すべてエクスポート]の2つのオプションがあります。[エクスポート]を選択すると、現在選択しているテストの結果だけを保存します。[すべてエクスポート]を選択すると、実行したすべてのテストの結果を保存します。他の解析ツールへのインポートのために、テキスト形式またはコンマ区切りのファイル形式で保存します。
ワークスペースウィンドウの[Test]タブのポップアップメニューからも、[テストブラウザ]を表示できます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 291 of 479

High-performance Embedded Workshop V.4.09•

16.

テスト支援機能テスト（上側のペイン）

上側のペイン内で右クリックすると、使用可能なオプションをポップアップメニューで表示します。
ポップアップメニューオプション

ツールバーボタン機能

エクスポート

結果をエクスポートします。

すべてエクスポート

結果をすべてエクスポートします。

クリア

•

-

比較結果表示をクリアします。

テスト項目（下側のペイン）

下側のペイン内で右クリックすると、使用可能なオプションをポップアップメニューで表示します。
ポップアップメニューオプション

ツールバーボタン

詳細機能
現在選択したテスト結果の詳細をダイアログボックスに表示します。

16.10 ワークスペースウィンドウのTestタブの構成
ワークスペースウィンドウの[Test]タブは、テストスイート内のテストに容易にアクセスできます。
テストスイートを開くと、このテストスイートはワークスペースウィンドウの[Test]タブに追加され、その下にテストスイート内のテストが追加されます。これを以下に示します。

テストスイート名またはテストを右クリックすると、テスト機能へ容易にアクセスできます。
テストスイートのアイコン()を右クリックすると、次のオプションが使用できます。

ポップアップメニューオプション
テストスイートの編集機能
現在のテストスイートを編集します。High-performance Embedded Workshop テス
トシステムへのテストの追加および削除ができます。

テストスイートを閉じる

現在開いているテストスイートを閉じます。

テストイメージファイルの比較

テストイメージファイルを、現在の High-performance Embedded Workshop システ
ム、または以前に保存した別のテストイメージファイルと比較します。結果はテスト
ブラウザに表示します。

テストを実行テストスイートで定義した複数のテストを実行し、比較した結果をテストブラウザで参照できます。テストの実行方法を指定する様々なオプションがあります。また、テストイメージファイルに小さな修正を加え更新する必要がある場合、このオプションを使用してテストイメージファイルを自動的にリフレッシュすることもできます。

テスト結果ブラウザ

前回実行したテストの結果を表示します。テストの成功／失敗と、失敗した要因の詳細を参照できます。

プロパティ[テストスイートのプロパティ]ダイアログボックスを開きます。テストスイートの名
前、説明、場所、前回修正した日付を表示します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 292 of 479

High-performance Embedded Workshop V.4.09

テストのアイコン(

16.

テスト支援機能)を右クリックすると、次のオプションが使用できます。

ポップアップメニューオプション

機能

テストケースの実行

選択したテストケースを実行します。

テストケースの編集選択したテストケースを編集します。

テストケースの削除

選択したテストケースを削除します。

テストイメージファイルの作成

選択したテストケースのテストイメージファイルを作成します。

テストイメージファイルの比較選択したテストケースに設定したテストイメージファイルを現在のシステムと比較します。

テストイメージファイルの編集選択したテストケースに設定したテストイメージファイルを編集します。

テストイメージファイルの保存

現在の High-performance Embedded Workshop システムの状態を選択したテストケースに設定したテストイメージファイルに保存します。

名前を付けて保存

現在の High-performance Embedded Workshop システムの状態を、テストイメージ
ファイル作成時のテスト項目への指定を元に、別のテストイメージファイルに保存し
ます。

プロパティ

[テストのプロパティ]ダイアログボックスを開きます。テストの名前、説明、場所、
前回修正した日付を表示します。

16.11 アウトプットウィンドウのTestタブの構成
アウトプットウィンドウの[Test]タブは、現在のテスト実行の結果および進行状況を出力します。テスト実行の進行状況は、現在実行中のテストと、残りのテストの数で構成しています。エラーが発生した場合、このウ
ィンドウに出力します。

Starting tests, test suite <テストスイート名>, <比較条件>, <保存条件>, <エラー条件>, <タイムアウト>
Running test, <テスト名>, (X of Y)
Running batch file/macro, <マクロ名>, (X of Y)
分類

項目

Starting tests,<テストスイート名>

test suite<比較条件>

テストを実行ダイアログボックス--

表示例(下図参照)'TestSuite'[テスト実行後の動作]

Compare system against saved comparing

ドロップダウンリストボ

test image file (デフォルト)

results

ックス

Refresh test image filerefreshing
results<保存条件>[自動的にテスト結果を保(デフォルト)存]チェックボックス

saving results
not saving
results<エラー条件>[エラー発生時は実行停止]

stop on failure

チェックボックス(デフォルト)continue on
failure<タイムアウト>[タイムアウト(秒)]任意 (デフォルト 10)

timeout=10-'Test_01'

エディットボックス
Running test

<テスト名>-'Test_02'

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 293 of 479

High-performance Embedded Workshop V.4.09

分類

テスト支援機能16.

項目

テストを実行ダイアログボックス(X of Y)-

表示例(下図参照)-(1 of 2)

X は現在のテスト番号(2 of 2)

Y はテストの総数
Running<マクロ名>--'Macro_01'

batchfile/macro'Macro_02'(X of Y)--

(1 of 2)

X は現在のマクロ番号(2 of 2)

Y はマクロの総数

ウィンドウ内で右クリックすると、使用可能なオプションをポップアップメニューで表示します。
基本的なオプションをツールバーに割り付けています。
[ツールバー表示]、[ツールバーのカスタマイズ]は、ツールバー内で右クリックしても、ポップアップメニュ
ーを表示します。
ポップアップメニューオプション

ツールバーボタン

機能

クリア

ウィンドウ内容をクリアします。

保存

ウィンドウ内容をテキストファイルに保存します。

コピー

ウィンドウ内容の選択部分を Windows® クリップボードにコピーします。

ツールバー表示-

ツールバー表示/表示なしを切り替えます。

ツールバーのカスタマイズ-

ツールバーボタンをカスタマイズします。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 294 of 479

High-performance Embedded Workshop V.4.09

17.

17.

デバッグ機能デバッグ機能

この章では、主に連携ツールの製品パッケージにバンドルされているHigh-performance Embedded Workshopで共通のデバッグ機能について説明します。
デバッガの使用に必要なHigh-performance Embedded Workshopの基本概念は「1.概要」を参照してください。
ご使用のデバッガで利用可能な機能の詳細説明は、エミュレータまたはシミュレータのユーザーズマニュアル
およびヘルプを参照してください。

17.1

デバッグの準備をする

この節では、プログラムのデバッグを開始するための準備作業について説明します。デバッグを行うためのデバッガの選択および設定方法、デバッグ対象ファイルのロード、およびデバッグセッションについて説明します。

デバッグの前にビルドを行う

17.1.1

プログラムをC/C++ソースレベルでデバッグするには、C/C++プログラムをビルドして、[Debug]オプションが有効な状態でリンクする必要があります。このオプションが有効の場合、コンパイラは、C/C++コードのデバッグに必要な情報をすべてアブソリュートファイルまたはマネージメントファイルに入れます。これらのファ
イルはその後「デバッグオブジェクトファイル」と呼ばれます。プロジェクトを作成すると､初期セットアップで通常のデバッグを設定します。
注：•

デバッグ用のオブジェクトファイルを生成する際はコンパイラおよびリンカの[Debug]オプションを必ず有効にしてください。

•

デバッグオブジェクトファイルにデバッグ情報(例えばSレコードフォーマットなど)がない場合でもデバッガにロードできますが､アセンブリ言語レベルでのデバッグとなります。

17.1.2

デバッガを選択する

デバッガの選択はHigh-performance Embedded Workshopのインストール方法に大きく依存します。
High-performance Embedded Workshopにツールチェインをインストールしている場合、アプリケーションプロ
ジェクトジェネレータはツールチェインおよびデバッグのターゲットを同時にセットアップできます。これによってターゲットおよびツールチェインオプションを一致させ、矛盾が起こらないようにします。ツールチェ
インをインストールしていない場合には、デバッグ専用プロジェクトのみ選択できます。High-performance
Embedded Workshopはデフォルトの設定で、[新規プロジェクトワークスペース]ダイアログボックスの中に、生成するそれぞれのCPUファミリのデバッグ専用プロジェクト生成タイプを表示します。
注：
High-performance Embedded Workshopのプロジェクトジェネレータは、マイコンに対応したサンプルのソース
ファイルを自動生成します（選択するプロジェクトタイプによっては、生成ファイルはありません）。生成されたソースファイルのコードは一例であり、これを使用して作成したすべてのプログラムの動作を保証するもR20UT0372JJ0100 Rev.1.00
2011.02.01

Page 295 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能のではありません。該当するマイコンのハードウェアマニュアルをご参照の上、必要に応じてコードを変更しコードの適用可否をご判断ください。

[新規プロジェクトワークスペース]ダイアログボックスを使用して､ターゲットCPUに合ったプロジェクト生
成タイプを選択できます。
プロジェクトタイプ[Application]

説明
C/C++言語で記述された初期ルーチンファイルを含む実行プログラムを生成するためのプロジェクト[Assembly Application]

アセンブリ言語で記述された初期ルーチンファイルを含む実行プログラムを生成するためのプロジェクト

[Demonstration]

C 言語で記述されたデモンストレーションプログラムを作成するためのプロジェクト[C source startup Application]

C 言語で記述されたスタートアッププログラムを作成するためのプロジェクト[Empty Application]

ツールチェイン環境の設定のみのプロジェクト(生成ファイルなし)[Import Makefile]

既存のメイクファイルを取り込み実行プログラムを作成するためのプロジェクト[Library]

ライブラリファイルを作成するためのプロジェクト(生成ファイルなし)[Debugger only - xxxxxx]

デバッグ専用プロジェクト(生成ファイルなし)

ここではSH-4シミュレータデバッガを例に説明します。ご使用のデバッガで利用可能な機能の説明は、デバッ
ガのユーザーズマニュアルを参照してください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 296 of 479

High-performance Embedded Workshop V.4.09

1.

17.

デバッグ機能ステップ1ではツールチェインバージョンとCPUを選択します。使用するCPUの種類([CPU タイプ])はCPUのシリーズ([CPUシリーズ])ごとに分類しています。ツールチェインバージョン、[CPU シリーズ]、および[CPU タイプ]の選択により生成するファイルが異なりますので、開発するプログラムに対応した設定を選択してください。対応するCPUがない場合は、ハードウェア仕様の近いCPUまたは[Other]を選択してください。

ウィザード下部のボタンは[新規プロジェクト]ウィザード共通です。
[次へ>]

次の画面に移ります。

[<戻る]

前の画面に戻ります。

[完了]

以降の選択はデフォルトとなり、[概要]ダイアログボックスを開きます。

[キャンセル][新規プロジェクトワークスペース]ダイアログボックスに戻ります。

ステップ1画面で[次へ>]をクリックすると、ステップ2に進みます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 297 of 479

High-performance Embedded Workshop V.4.09

2.

17.

デバッグ機能ステップ2では全プロジェクトファイルで共通のオプションを設定します。
設定できる項目はステップ1で選択したCPUに依存します。詳細はコンパイラユーザーズマニュアルで確認してください。

ステップ2画面で[次へ>]をクリックすると、ステップ3に進みます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 298 of 479

High-performance Embedded Workshop V.4.09

3.

17.

デバッグ機能ステップ3では生成するファイルを設定します。
[I/Oライブラリを使用]

チェックすると標準入出力ライブラリを活用できます。

[I/Oストリーム数]

同時に使用する入出力ストリームの本数を設定します。

[ヒープメモリを使用]

チェックするとヒープ領域管理用の関数sbrk()を使用できます。

[ヒープサイズ]管理するヒープ領域サイズ単位を指定します。

[main()関数生成]

main関数の雛型生成を選択できます。
メイン関数ファイル[(プロジェクト名).c(cpp)]を生成します。

[I/Oレジスタ定義ファイル]

チェックするとC言語で記述したI/Oレジスタ定義ファイル("iodefine.h")を生成します。

[ハードウェアセットアップ関数

I/Oレジスタ初期設定プログラムの雛型生成を選択します。

生成]

ハードウェア設定用のファイル("hwsetup.c(cpp)"または"hwsetup.src")を生成します。

注：
既に作成したmain関数を組み込む場合は、[main()関数生成]で[None]を選択し、プロジェクトを作成後にmain関数を含んだファイルをプロジェクトに追加してください。なお、組み込む関数名が異なる場合は、resetprg.cの関数呼び出し部分を修正する必要があります。また、プロジェクトジェネレータが生成するベクタテーブル
定義およびI/Oレジスタ定義等のサンプルファイル内容は、使用するCPUのハードウェアマニュアルで確認してください。
ステップ3画面で[次へ>]をクリックすると、ステップ4に進みます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 299 of 479

High-performance Embedded Workshop V.4.09

4.

17.

デバッグ機能ステップ4ではC/C++コンパイラで使用する標準ライブラリの構成を設定します。
チェックした項目で宣言されている関数とruntime関数を組み込みます。
[全て有効]

すべての標準ライブラリ関数を選択します。

[全て無効]

すべての標準ライブラリ関数を選択しません。
ただし、最低限必要なruntime、newは選択します。

ステップ4画面で[次へ>]をクリックすると、ステップ5に進みます。

5.

ステップ5ではスタック領域を設定します。スタックポインタの初期値とスタックサイズを設定します。
スタック領域の初期値はステップ1で選択したCPUに依存します。

注：
スタック領域はHigh-performance Embedded Workshopが生成する"stacksct.h"で定義しています。"stacksct.h"をエディタで編集した場合はHigh-performance Embedded Workshopの[プロジェクト->構成の編集]では変更できません。
ステップ5画面で[次へ>]をクリックすると、ステップ6に進みます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 300 of 479

High-performance Embedded Workshop V.4.09

6.

17.

デバッグ機能ステップ6ではベクタを設定します。
[ベクタテーブル定義]

チェックするとベクタ定義ファイルとベクタテーブル設定関数の定義ファイ
ルを生成します。

[ベクタハンドラ][ハンドラ]

リセットベクタのハンドラプログラム名を表示します。
ハンドラプログラムを変更したい場合は、ハンドラプログラム名
を選択してクリック後入力してください。なお、ハンドラプログ
ラムを変更すると、リセットプログラム("resetprg.c")は生成しま
せん。

[ベクタ]

ベクタの説明を表示します。

注：
生成されたリセットプログラム、割込み関数、リセットベクタハンドラ、および割込み要因レジスタ定義はサ
ンプルであるため、使用される前にCPUのハードウェアマニュアルで確認してください。
ステップ6画面で[次へ>]をクリックすると、ステップ7に進みます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 301 of 479

High-performance Embedded Workshop V.4.09

7.

17.

デバッグ機能ステップ7ではデバッガターゲットを設定します。
[ターゲット]

デバッガターゲットを設定します。デバッガターゲットを選択(チェック)してく
ださい。デバッガターゲットは未選択でも複数選択してもかまいません。

[ターゲットタイプ][ターゲット]に表示するターゲットの種類を指定します。

[ターゲットCPU][ターゲット]に表示するターゲットのCPUを指定します。

注：
ステップ2で設定したエンディアンはコンパイラの設定に反映します。
ステップ7で選択したデバッガターゲットのエンディアンとは独立しています。
ステップ7画面で[次へ>]をクリックすると、ステップ8に進みます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 302 of 479

High-performance Embedded Workshop V.4.09

8.

17.

デバッグ機能ステップ8では選択したデバッガターゲットのオプションを設定します。
[コア]ターゲットのコアを指定します。

[コンフィギュレーション名]

High-performance Embedded Workshopはデフォルトで[Release]と[Debug]の2つのコンフィグレーションを作成しますが、デバッガターゲットを選択すると選択したターゲット用のコンフィグレーションも作成します(ターゲット名を含んだ略称となります)。このコンフィグレーション名
は[コンフィギュレーション名]で変更できます。

[詳細オプション]

デバッガターゲットのオプションを設定します。変更する場合は、[Item]
を選択して[変更]をクリックしてください。なお、変更できない項目の場合、[Item]を選択しても[変更]はグレーのままです。
[Simulator I/O]

ユーザプログラムから標準入出力またはファイル
入出力を行うシステムコールは有効([Enable])または無効([Disable])[Simulator I/O addr.]

上記システムコールアドレス[Bus mode]

シミュレータデバッガでは現状未使用[初期セッション]

チェックを付けると本セッションを初期セッショ
ンとします。

ステップ8画面で[次へ>]をクリックすると、ステップ9に進みます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 303 of 479

High-performance Embedded Workshop V.4.09

9.

17.

デバッグ機能ステップ9ではこれまでの設定によりHigh-performance Embedded Workshopが生成するファイルをリスト表示します。
[ファイル名]

ファイル名。変更したい場合は、ファイル名を選択してクリック後入力してください。

[拡張子]

拡張子

[解説]

ファイルの説明ステップ9画面で[完了]をクリックすると、[概要]ダイアログボックスが開きます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 304 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能10. プロジェクトジェネレータは、生成するプロジェクトに関する情報を[概要]ダイアログボックスに表示するので、確認後[OK]ボタンをクリックしてください。[Cancel]ボタンをクリックすると[新規プロジェクト]
ウィザードに戻ります。
なお、[サマリの内容をプロジェクトディレクトリにReadme.txtという名前で保存する]をチェックすると、[概要]ダイアログボックスで表示したプロジェクトの情報を"Readme.txt"という名称のテキストファイル
でプロジェクトディレクトリに保存します。

17.1.2.1

メイクファイルから情報を取り込みプロジェクトを作成する

High-performance Embedded Workshopは、GNU makeフォーマットまたは、Hmakeフォーマット（High-performance
Embedded Workshopが出力）のメイクファイルを解析し、作成するワークスペースにファイル情報を取り込む
ことができます。[新規プロジェクトワークスペース]ダイアログボックスを開きプロジェクトタイプとして[Import Makefile]を選択します。ワークスペース名等の必要な情報を入力後、[OK]ボタンをクリックすると、[新規プロジェクト - メイクファイル]画面に進みます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 305 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能[メイクファイルのパス]でメイクファイルを選択すると[ソースファイル]にメイクファイルに登録されている
ソースファイルを表示します。メイクファイルに登録されているソースファイルを再び表示するには[開始]ボタンをクリックします。
コンパイラ等のツールオプションを取り込むには、[オプションの取り込み]チェックボックスをオンにします。
不要なファイルがある場合は、そのファイルを選択し[削除]ボタンで削除できます。また、さらに必要なファイルがある場合は、[追加]ボタンで追加できます。[ファイルのパスを表示する]チェックボックスをオンにす
るとファイルの絶対パスを表示します。

プロジェクトの構成を編集する

17.1.3

SuperHファミリ用、またはH8SX, H8S, H8ファミリ用のツールチェインを使用する場合、プロジェクトジェネ
レータを使用してシミュレータを再度設定できます。ただし、デモンストレーションプロジェクトでは無効です。
1.

[プロジェクト -> 構成の編集]を選択してください。[構成の編集]ダイアログボックスが開きます。

2.

[ターゲット]タブをクリックしてください。

3.

使用したいターゲットを選択し、[OK]をクリックしてください。

17.1.4

デバッガを設定する

デバッガにプログラムをロードする前に、アプリケーションシステムに合うようにデバッガを設定します。必
要な設定内容は､デバイスの種類､動作モード､クロックスピード､およびメモリマップなどです。その中でもプログラムをロードするためにデバッガにメモリを設定する必要があるので、特にメモリマップの設定が大切です。High-performance Embedded Workshopでは、プロジェクトの生成処理でこの作業のほとんどが完了します。
しかし、標準とは異なるボードのコンフィグレーションを使用する場合には､カスタマイズが必要になります。
R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 306 of 479

High-performance Embedded Workshop V.4.09

17.1.4.1

17.

デバッグ機能セットアップデバッガをセットアップするには、[基本設定 -> シミュレータ]または[基本設定 -> エミュレータ]を選択します。このサブメニューの下に、デバッガの設定に使用できるメニューがあります。
SuperHファミリ用のシミュレータの場合、[システム]と[メモリリソース]のメニューがあります。どちらのオプションでも、必要に応じてシミュレータをカスタマイズし、セットアップできます。[デバッグ -> デバッグの設定]ダイアログボックスから選択してデバッガ依存のセットアップダイアログボックスを表示できます。
ご使用のデバッガで利用可能な機能の詳細説明は、エミュレータまたはシミュレータのユーザーズマニュアルを参照してください。

17.1.4.2

メモリマップデバッガは、デバイスのアドレス空間がROM、RAM、オンチップレジスタ､またはメモリのない領域なのかを知る必要があります。そのため、メモリマップを設定する必要があります。
プロジェクトジェネレータでデバイスの種類およびモードを選択すると､High-performance Embedded
Workshopは自動的にそのデバイスのマップおよびそのプロセッサが動作するモードを設定します。例えば、内部ROMおよびRAMを持つデバイスにおいて、これらのメモリがデバイスメモリマップ内で位置する領域をデフォルトで設定します。
内部メモリを持たないデバイス、またはその代わりあるいはその追加として外部メモリを持つデバイスを使用する場合には、そういったメモリが存在することをデバッガに知らせる必要があります。
補足説明:
エミュレータでデバッグを行い、かつ必要なメモリがオンチップまたは外部に存在しない場合は、アプリケー
ションのアドレス空間用にエミュレータのエミュレーションメモリをマッピングできます。
詳細は新規プロジェクトで選択したデバッガに依存します。
メモリマップに関する追加情報はステイタスウィンドウの[Memory]タブにも表示します。"Target Device
Configuration"領域にはデバイスのアドレス空間内のメモリを表示します。
注：
いくつかのエミュレータではページ長の制限から、入力アドレスと設定された領域アドレスが一致しない場合があります。

17.1.4.3

デバッグの設定を変更する

High-performance Embedded Workshopデバッガの通常動作では、ユーザのターゲットおよびダウンロードモジ
ュールはプロジェクト生成過程で自動的に設定します。ただし時にはデバッグセッションを手動で設定する必要があります。古いツールチェインや、最新のHigh-performance Embedded Workshopインタフェースをサポートしていないプロジェクトジェネレータを使用している場合などが考えられます。
デバッグセッションの設定を確認するには、[デバッグの設定]ダイアログボックスを開きます。以下のいずれかの操作を選択してください。
•[デバッグ -> デバッグの設定]を選択する。

•

ワークスペースウィンドウの[Projects]タブの[Download modules]フォルダまたはダウンロードモジュール
上で右クリックする。表示されるポップアップメニューから[デバッグの設定]を選択する。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 307 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能[デバッグの設定]ダイアログボックスの[ターゲット]タブでは、[ターゲット]、[コア]、[デバッグフォーマット]、および[ダウンロードモジュール]を選択できます。ただし、[コア]は、同期デバッグ機能を使用している場合に選択できます。
ターゲットを変更するには、次の操作が必要です。
1.

ダイアログボックス左側にあるツリーから、変更したいプロジェクトを選択してください。現在のプ
ロジェクトのデフォルトとして設定します。

2.

ツリーの上にあるドロップダウンリストから、変更したいセッションを選択してください。

3.

ターゲットのリストを操作して、ターゲットを変更してください。これにより、過去に設定したター
ゲット固有の設定オプションを削除します。

さらに[デバッグの設定]ダイアログボックスの[オプション]タブでは、以下のオプションを選択できます。
•

コマンドバッチファイルを自動実行する•

デバッグ情報のみのダウンロード時にバッチファイルを実行しない•

ビルド後にダウンロードする•

ダウンロード時にブレークポイントを削除する•

ターゲット接続時のバッチファイル実行が終わるまでメモリアクセスを無視する•

逆アセンブリ表示時のメモリアクセス範囲を最小限に抑える•

自動的にターゲットを接続しない•

ダウンロード後にCPUリセットする•

ターゲット実行中のGUI操作によるメモリアクセスを無視する

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 308 of 479

High-performance Embedded Workshop V.4.09

(1)

17.

デバッグ機能コマンドバッチファイルを自動実行する

High-performance Embedded WorkshopのデバッガはTCLコマンドライン機能と統合されています。特定のタイミ
ングで自動的に実行できる、High-performance Embedded Workshopのデバッガ用のコマンドバッチファイルを記述できます。[コマンドバッチファイル実行順序]リストは、指定されたタイミングで実行するコマンドバッ
チファイルのリストです。このリストに対してコマンドバッチファイルを追加、変更、削除、上へ移動、下へ移動が可能です。
コマンドバッチファイルを自動実行するには
1.

[デバッグ -> デバッグの設定]を選択します。[デバッグの設定]ダイアログボックスが開きます。

2.

[オプション]タブを選択します。

3.

[コマンドバッチファイル実行タイミング]ドロップダウンリストでコマンドバッチファイル実行タイ
ミングを選択してください。[At target connection]、[Before download of modules]、[After download ofmodules]、および[After reset]から選択できます。

4.

[追加]ボタンをクリックします。[コマンドバッチファイル]ダイアログボックスが開きます。

5.

[ファイル名]にコマンドバッチファイルのファイル名を入力します。[ファイル名]にプレースホルダを挿入するには、プレースホルダボタン()をクリックし、ポップアップメニューからプレースホルダ

を選択します。ファイルを参照するには[参照]ボタンをクリックします。
6.

[初期ディレクトリ]にコマンドバッチファイルを実行するディレクトリを入力します。[初期ディレク
トリ]の設定により相対パスがあるコマンドバッチファイルの使用が可能になります。[初期ディレク
トリ]にプレースホルダを挿入するには、プレースホルダボタン()をクリックし、ポップアップメニ

ューからプレースホルダを選択します。ディレクトリを参照するには[参照]ボタンをクリックします。
7.

[すべてのタイミングに適用]チェックボックスをオンにすると、すべてのタイミング（[At target
connection]、[Before download of modules]、[After download of modules]、および[After reset]）にコマンド
バッチファイルを適用します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 309 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能8.

[OK]ボタンをクリックすると、コマンドバッチファイルを追加します。

9.

追加後は、[上へ]ボタンと[下へ]ボタンを使って順番を移動できます。複数のコマンドバッチファイルを追加している場合のみ有効です。

10. [OK]ボタンをクリックします。
注：•

FILE_LOADまたはFILE_LOAD_ALLコマンドでダウンロードした場合、[Before download of modules]および[After download of modules]タイミングのコマンドバッチファイルは実行されません。

•

RESETコマンドでリセットした場合、[After reset]タイミングのコマンドバッチファイルに記述された
RESETコマンドは実行されません。

デバッグ情報のみのダウンロード時にバッチファイルを実行しない(2)

このオプションの設定により、[コマンドバッチファイル実行タイミング]で"Before download of modules"または"After download of modules"を選択し、バッチファイルを登録していても、ワークスペースウィンドウ上にあるモジュールを右クリックし、[ダウンロード(debug情報のみ)]を選択した場合は、バッチファイルを実行しません。
デバッグ情報のみのダウンロード時にバッチファイルを実行しないようにするには
1.

[デバッグ -> デバッグの設定]を選択します。[デバッグの設定]ダイアログボックスが開きます。

2.

[オプション]タブを選択します。

3.

[デバッグ情報のみダウンロード時にバッチファイルを実行しない]チェックボックスをオンにします。このチェックボックスのデフォルトはオンです。

4.

(3)

[OK]ボタンをクリックします。

ビルド後にダウンロードする

このオプションの設定により、ビルド後にユーザプログラムを自動的にダウンロードします。
ビルド後にダウンロードするには
1.

[デバッグ -> デバッグの設定]を選択します。[デバッグの設定]ダイアログボックスが開きます。

2.

[オプション]タブを選択します。

3.

[ビルド後のダウンロード]チェックボックスをオンにします。このチェックボックスのデフォルトは
オンです。

4.

(4)

[OK]ボタンをクリックします。

ダウンロード時にブレークポイントを削除する

このオプションの設定により、ユーザプログラムのダウンロード時自動的にブレークポイントを解除します。
ダウンロード時にブレークポイントを削除するには
1.

[デバッグ -> デバッグの設定]を選択します。[デバッグの設定]ダイアログボックスが開きます。

2.

[オプション]タブを選択します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 310 of 479

High-performance Embedded Workshop V.4.09

3.

17.

デバッグ機能[ダウンロード時にブレークポイントを削除]チェックボックスをオンにします。このチェックボック
スのデフォルトはターゲットに依存します。

4.

[OK]ボタンをクリックします。

ターゲット接続時のバッチファイル実行が終わるまでメモリアクセスを無視する(5)

このオプションの設定により、ターゲット接続時に自動実行するコマンドバッチファイルを指定している場
合、そのコマンドバッチファイルの実行が終了するまで、ターゲットに対してメモリアクセスを行いません。
ターゲット接続時にメモリの初期設定が必要な場合に有用です。
ターゲット接続時のバッチファイル実行が終わるまでメモリアクセスを無視するには
1.

[デバッグ -> デバッグの設定]を選択します。[デバッグの設定]ダイアログボックスが開きます。

2.

[オプション]タブを選択します。

3.

[ターゲット接続時のバッチファイル実行が終わるまでメモリアクセスを無視]チェックボックスをオンにします。このチェックボックスのデフォルトはオフです。

4.

[OK]ボタンをクリックします。

逆アセンブリ表示時のメモリアクセス範囲を最小限に抑える(6)

このオプションの設定により、逆アセンブリ表示で表示範囲以外のメモリからデータのリードを無効にします。
逆アセンブリ表示時のメモリアクセス範囲を最小限に抑えるには
1.

[デバッグ -> デバッグの設定]を選択します。[デバッグの設定]ダイアログボックスが開きます。

2.

[オプション]タブを選択します。

3.

[逆アセンブリ表示時のメモリアクセス範囲を最小限に抑える]チェックボックスをオンにします。このチェックボックスのデフォルトはターゲットに依存します。

4.

(7)

[OK]ボタンをクリックします。

自動的にターゲットを接続しない

このオプションの設定により、[デバッグ -> 接続]を選択するまでターゲットに接続しません。機能のサポー
トはデバッガに依存します。
自動的にターゲットを接続しないようにするには
1.

[デバッグ -> デバッグの設定]を選択します。[デバッグの設定]ダイアログボックスが開きます。

2.

[オプション]タブを選択します。

3.

[自動的にターゲットを接続しない]チェックボックスをオンにします。選択したターゲットでこの機能をサポートしている場合、このチェックボックスは有効です。新しいターゲットを選択した場合、ターゲットのデフォルト設定でこのオプションをリセットします。このチェックボックスのデフォル
トはターゲットに依存します。

4.

[OK]ボタンをクリックします。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 311 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能ダウンロード後に CPU リセットする(8)

このオプションの設定により、ユーザプログラムのダウンロード完了後に自動的にターゲットをリセットします。機能のサポートはデバッガに依存します。
ダウンロード後にCPUリセットするには
1.

[デバッグ -> デバッグの設定]を選択します。[デバッグの設定]ダイアログボックスが開きます。

2.

[オプション]タブを選択します。

3.

[ダウンロード後にCPUリセット]チェックボックスをオンにします。選択したターゲットでこの機能をサポートしている場合、このチェックボックスは有効です。新しいターゲットを選択した場合、ター
ゲットのデフォルト設定でこのオプションをリセットします。このチェックボックスのデフォルトはターゲットに依存します。

4.

[OK]ボタンをクリックします。

ターゲット実行中の GUI 操作によるメモリアクセスを無視する(9)

このオプションの設定により、プログラム実行中にHigh-performance Embedded Workshopからのメモリアクセ
スを制限できます。これは、メモリの読み書きや実行低下によりターゲットに負荷がかかることを抑止します。
機能のサポートはデバッガに依存します。
ターゲット実行中のGUI操作によるメモリアクセスを無視するには
1.

[デバッグ -> デバッグの設定]を選択します。[デバッグの設定]ダイアログボックスが開きます。

2.

[オプション]タブを選択します。

3.

[ターゲット実行中のGUI操作によるメモリアクセスを無視]チェックボックスをオンにします。選択したターゲットでこの機能をサポートしている場合、このチェックボックスは有効です。新しいターゲットを選択した場合、ターゲットのデフォルト設定でこのオプションをリセットします。このチェックボックスのデフォルトはターゲットに依存します。

4.

[OK]ボタンをクリックします。

この機能は、メモリアクセスを完全に抑止するわけではありません。
•

メモリアクセスを抑止する機能
以下の機能では、メモリ関連の操作が無効になるか、操作してもメモリを読み書きしません。表示する値はすべてダミーの"FF"です。
oエディタウィンドウまたは逆アセンブリウィンドウ（ソースモード）のツールチップウォッチの表示oエディタウィンドウまたは逆アセンブリウィンドウ（混合モード/逆アセンブリモード）の逆アセンブ
リコード表示または編集o•

メモリウィンドウ、[IO]ウィンドウ、またはMRウィンドウのメモリ内容の表示、または編集 *メモリアクセスを抑止しない機能
以下の機能ではメモリアクセスを抑止しません。
oコマンドファイルまたはコマンドラインウィンドウのコマンド実行o

リアルタイム更新時におけるウォッチウィンドウのメモリ内容の表示、または編集 *oモニタウィンドウ、画像ウィンドウ、または波形ウィンドウのリアルタイム更新時におけるメモリ内
容の表示 *

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 312 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能CウォッチウィンドウまたはASMウォッチウィンドウのリアルタイムRAMモニタ機能を使用したメo

モリ内容の表示または編集 *RAMモニタウィンドウまたはMRウィンドウのリアルタイムRAMモニタ機能を使用したメモリ内容

o

の表示 *
o

CウォッチウィンドウまたはASMウォッチウィンドウのメモリ内容の表示、または編集 *o

GUI I/Oウィンドウ、画像ウィンドウ、または波形ウィンドウのメモリ内容の表示 *注：*. 機能のサポートはデバッガに依存します。

17.1.517.1.5.1

ダウンロードモジュール
ダウンロードモジュールを指定するプログラムをダウンロードするためのメモリがシステムに十分ある場合､デバッグするプログラムをダウンロ
ードできます。[Application]ジェネレータは、リンカからの出力のため、ダウンロードモジュールの初期選択を自動的に行います。デバッグ専用プロジェクトジェネレータは、ダウンロードモジュールを初期選択しませんが参照は可能です。概要については、「17.1.2 デバッガを選択する」を参照してください。

プロジェクトの作成後もダウンロードモジュールを手動で選択できます。これは、[デバッグの設定]ダイアロ
グボックスを使用して行うことができます。このダイアログボックスでは、ワークスペース全体のデバッグの設定を制御できます。ダイアログボックスの左側にあるツリーには、現在のプロジェクトをすべて含んでいます。このツリーでプロジェクトを選択すると、そのプロジェクトの設定の表示、およびセッションドロップダ
ウンリストには、セッションの選択を表示します。このリストボックスでは、複数のセッションの選択、またはすべてのセッションの選択もできます。複数のセッションを選択した場合には、1つまたは複数のセッショ

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 313 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能ンの設定を同時に修正できます。[デバッグの設定]ダイアログボックスは、以下のデバッグオプションを表示します。
•

現在のプロジェクトのための現在のデバッグターゲットおよびセッションの選択•

現在のプロジェクトのためのダウンロードモジュールおよびセッションの選択[デバッグフォーマット]リストでデバッグフォーマットを選択します。ここで指定したフォーマットと一致す
るモジュールのみデバッグできます。[ダウンロードモジュール]で複数のフォーマットが指定されている場合
も、このリストで選択したフォーマットを使用します。
[ダウンロードモジュール]リストは、ターゲットにダウンロードするファイルを順番に表示します。このリス
トでは、モジュールの追加、変更、削除、上へ移動、下へ移動が可能です。
新規のダウンロードモジュールを追加するには1.

以下のいずれかの操作を選択し[デバッグの設定]ダイアログボックスを開きます。

•[デバッグ -> デバッグの設定]を選択する。

•

ワークスペースウィンドウの[Projects]タブの[Download modules]フォルダまたはダウンロードモジュ
ール上で右クリックする。表示されるポップアップメニューから[デバッグの設定]を選択する。

2.

プロジェクトのツリーで、ダウンロードモジュールを追加するプロジェクトおよびセッションを選択
します。

3.

[追加]ボタンをクリックしてください。[ダウンロードモジュール]ダイアログボックスが開きます。すべてのフィールドは、ダウンロードモジュールが正確に構成されるようにセットアップしてください。

4.

[オフセット]には、モジュールがロードされるメモリアドレスのオフセットを指定してください。デフォルトは0です。モジュールの追加後、[デバッグ -> ビルド]のサブメニュー、ワークスペースウィ
ンドウの[Projects]タブの[Download modules]フォルダ内、および[ファイル -> 最近ダウンロードしたモ
ジュール]のサブメニューで、モジュール名の右横にオフセット値が表示されます。

5.

[ファイルフォーマット]には、サポートしているオブジェクトフォーマットのリストを表示します。
ここではダウンロードするモジュールのファイルフォーマットを選択します。したがって、[デバッグの設定]ダイアログボックスの[デバッグフォーマット]と必ずしも一致させる必要はありません。ただし、スタックトレースウィンドウなどは[デバッグフォーマット]で指定したフォーマットに依存して提供されます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 314 of 479

High-performance Embedded Workshop V.4.09

6.

17.

デバッグ機能[ファイル名]は、プレースホルダ、または絶対パス形式として指定できます。プレースホルダを使用することをお勧めします。

7.

[アクセスサイズ]は、メモリアクセス時のアクセスサイズを指定します。特定のアクセスサイズでメモリにアクセスする必要がある場合、このオプションを使用してアクセスサイズを指定してください。

8.

[デバッグ情報のみのダウンロード]チェックボックスは、デバッグ情報だけをダウンロードする場合に使用します。

9.

[ダウンロード時のメモリベリファイ]チェックボックスは、モジュールをダウンロードしたとき、ターゲットデバイスへ正確にダウンロードされたことを検証するために使用します。

10. [ターゲット接続時にダウンロード]チェックボックスは、ターゲットに接続したときに自動的にダウンロードを行う場合に使用します。
11. [OK]ボタンをクリックすると、[ダウンロードモジュール]リストの最後にモジュールが追加されます。
ダウンロードモジュールの追加と同時にターゲットにダウンロードするには、「17.1.5.2 モジュールをダウンロードする」を参照してください。
ダウンロードモジュールの設定を変更するには
1.

以下のいずれかの操作を選択し[ダウンロードモジュール]ダイアログボックスを開きます。

•[デバッグの設定]ダイアログボックスを表示し、[ダウンロードモジュール]リストから設定を変更した
いモジュールを選択し[変更]ボタンをクリックする。

•

ワークスペースウィンドウの[Projects]タブの[Download modules]フォルダ内のダウンロードモジュー
ル上で右クリックする。表示されるポップアップメニューから[プロパティ]を選択する。

2.

設定を変更後、[OK]ボタンをクリックします。

ダウンロードモジュールを削除するには
1.

[デバッグの設定]ダイアログボックスを開きます。

2.

[ダウンロードモジュール]リストから削除したいモジュールを選択し、[削除]ボタンをクリックします。

ワークスペースウィンドウの[Projects]タブで選択したダウンロードモジュールを削除するには
1.

ワークスペースウィンドウの[Projects]タブで削除したいダウンロードモジュールを選択してください。複数のダウンロードモジュールを選択するときは"Shift"キーまたは"Ctrl"キーを押してください。

2.

以下のいずれかの操作を選択してください。

•

右クリックしポップアップメニューから[削除]を選択する。

•"Delete"キーを押す。

3.

ダウンロードモジュールをプロジェクトから削除するかを確認するダイアログボックスが開きます。
ダウンロードモジュールをプロジェクトから削除する場合は「はい」を選択してください。削除しない場合は「いいえ」または「キャンセル」を選択してください。
確認要求のダイアログボックスを表示しない場合、[今後表示しない]チェックボックスをオンにしてください。確認要求のダイアログボックスを再び表示するには、[基本設定 -> オプション]を選択し[オプション]ダイアログボックスを開きます。[確認]タブの[プロジェクトからダウンロードモジュールを削除]チェックボックスをオンにしてください。このチェックボックスのデフォルトはオンです。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 315 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能モジュールをターゲットにダウンロードする順番を変更するには
1.

[デバッグの設定]ダイアログボックスを開きます。

2.

[ダウンロードモジュール]リストで、ダウンロードする順番を変更したいモジュールを選択し、[上へ]または[下へ]ボタンをクリックします。

[デバッグの設定]ダイアログボックスで行った変更はすべて、[OK]ボタンをクリックするまで更新しません。

17.1.5.2

モジュールをダウンロードする

デバッグするためにオブジェクトプログラムをダウンロードします。
モジュールをダウンロードするには以下のいずれかの操作を選択してください。
•[デバッグ -> ダウンロード]のサブメニューからダウンロードしたいモジュールを選択する。

•

ワークスペースウィンドウの[Projects]タブの[Download modules]フォルダ内でダウンロードしたいモ
ジュールをダブルクリックする。

•

ワークスペースウィンドウの[Projects]タブの[Download modules]フォルダ内のダウンロードしたいモ
ジュール上で右クリックする。表示されるポップアップメニューから[ダウンロード]または[ダウンロード(debug情報のみ)]を選択する。この場合モジュールは複数選択できます。

High-performance Embedded Workshopでは、最近ダウンロードしたモジュールを[ファイル -> 最近ダウンロー
ドしたモジュール]のサブメニューに表示します。最近使ったモジュールを再びダウンロードしたいときに使用してください。
すべてのモジュールをダウンロードするには以下のいずれかの操作を選択してください。
•[デバッグ -> ダウンロード -> All Download Modules]を選択してください。

•

ワークスペースウィンドウの[Projects]タブの[Download modules]フォルダ上で右クリックする。表示されるポップアップメニューから[全てダウンロード]を選択する。

[デバッグ -> デバッグの設定]を選択し、[デバッグの設定]ダイアログボックスを開きます。[ターゲット]タブの[ダウンロードモジュール]で指定した順番でターゲットにダウンロードされます。
モジュールは存在してもダウンロードモジュールリストに追加されていない場合、ダウンロードモジュールリ
ストへの追加と同時にターゲットにダウンロードできます。
ダウンロードモジュールリストへの追加と同時にターゲットにダウンロードするには1.

以下のいずれかの操作を選択し[ダウンロードモジュール]ダイアログボックスを開きます。

•[ファイル -> ダウンロードモジュールの追加]を選択する。

•

ワークスペースウィンドウの[Projects]タブの[Download modules]フォルダまたはダウンロードモジュ
ール上で右クリックする。表示されるポップアップメニューから[ダウンロードモジュールの追加]を選択する。
すべてのフィールドはダウンロードモジュールが正確に構成されるようにセットアップしてください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 316 of 479

High-performance Embedded Workshop V.4.09

2.

17.

デバッグ機能[オフセット]には、モジュールがロードされるメモリアドレスのオフセットを指定してください。デフォルトは0です。モジュールの追加後、[デバッグ -> ビルド]のサブメニュー、ワークスペースウィ
ンドウの[Projects]タブの[Download modules]フォルダ内、および[ファイル -> 最近ダウンロードしたモ
ジュール]のサブメニューで、モジュール名の右横にオフセット値が表示されます。

3.

[ファイルフォーマット]には、サポートしているオブジェクトフォーマットのリストを表示します。
ここではダウンロードするモジュールのファイルフォーマットを選択します。したがって、[デバッグの設定]ダイアログボックスの[デバッグフォーマット]と必ずしも一致させる必要はありません。ただし、スタックトレースウィンドウなどは[デバッグフォーマット]で指定したフォーマットに依存して提供されます。

4.

[ファイル名]は、プレースホルダ、または絶対パス形式として指定できます。プレースホルダを使用することをお勧めします。

5.

[アクセスサイズ]は、メモリアクセス時のアクセスサイズを指定します。特定のアクセスサイズでメモリにアクセスする必要がある場合、このオプションを使用してアクセスサイズを指定してください。

6.

[デバッグ情報のみのダウンロード]チェックボックスは、デバッグ情報のみをダウンロードする場合に使用します。

7.

[ダウンロード時のメモリベリファイ]チェックボックスは、モジュールをダウンロードしたとき、ターゲットデバイスへ正確にダウンロードされたことを検証するために使用します。

8.

[ターゲット接続時にダウンロード]チェックボックスは、ターゲットに接続したときに自動的にダウンロードを行う場合に使用します。

9.

[OK]ボタンをクリックします。

[デバッグ -> デバッグの設定]を選択し、[デバッグの設定]ダイアログボックスを開きます。[ターゲット]タブの[ダウンロードモジュール]リストの最後にモジュールが追加されています。
また、既にダウンロードしたモジュールがHigh-performance Embedded Workshopの外部で変更された場合、モジュールを再びダウンロードするかを確認するダイアログボックスが開きます。モジュールを再びダウンロードする場合は「はい」を選択してください。ダウンロードしない場合は「いいえ」または「キャンセル」を選択してください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 317 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能

確認要求ダイアログボックスを表示しない場合、[今後表示しない]チェックボックスをオンにしてください。
確認要求ダイアログボックスを再び表示するには
1.

[基本設定 -> オプション]を選択してください。[オプション]ダイアログボックスが開きます。

2.

[確認]タブを選択してください。

3.

[古いダウンロードモジュールの再ダウンロード]チェックボックスをオンにしてください。このチェックボックスのデフォルトはオンです。

4.

OKをクリックしてください。

17.1.5.3

ダウンロード前に変更したソースファイルを確認する

High-performance Embedded Workshopは、現在のプロジェクトのダウンロードモジュールをダウンロードする
前にソールファイルが変更されているかどうかを確認します。
ファイルが変更されていた場合、確認のダイアログボックスが起動され、ダウンロード実行前にコードを再度ビルドするかどうかを確認するダイアログボックスが開きます。ダウンロード実行前にコードを再度ビルドする場合は「はい」を選択してください。ダウンロード実行前にコードを再度ビルドしない場合は「いいえ」を選択してください。

確認要求ダイアログボックスを表示しない場合、[今後表示しない]チェックボックスをオンにしてください。
確認要求ダイアログボックスを再び表示するには
1.

[基本設定 -> オプション]を選択してください。[オプション]ダイアログボックスが開きます。

2.

[確認]タブを選択してください。

3.

[ダウンロードモジュールの更新]チェックボックスをオンにしてください。このチェックボックスのデフォルトはオンです。

4.

OKをクリックしてください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 318 of 479

High-performance Embedded Workshop V.4.09

17.1.5.417.

デバッグ機能ダウンロード後にソースツリーを表示する（デバッグ専用プロジェクト）

デバッグ専用プロジェクト([Debugger only - xxxxxx])を使用している場合、ダウンロードするとワークスペース
ウィンドウの[Projects]タブ内にダウンロードモジュールを構成するソースファイルをツリーで表示します。
High-performance Embedded Workshopはダウンロード時、ダウンロードモジュールを構成するソースファイルの情報を取得します。
相対パス名、またはファイル名の場合は、ダウンロードモジュールのディレクトリを基準にファイルを検索します。
この初期検索で見つからなかったファイルは[ファイルの検索]ダイアログボックス内に表示します。
ダウンロード時、[ファイルの検索]ダイアログボックスを表示しないようにできます。
ダウンロード時、[ファイルの検索]ダイアログボックスを表示しないようにするには
1.

[基本設定 -> オプション]を選択してください。[オプション]ダイアログボックスが開きます。

2.

[確認]タブを選択してください。

3.

[ディレクトリ参照ダイアログボックスをダウンロード時に表示しない]チェックボックスをオンにしてください。このチェックボックスのデフォルトはオフです。

4.

(1)

[OK]をクリックしてください。

ファイルを検索する

初期検索で見つからなかったソースファイルは、[ファイルの検索]ダイアログボックス内([検索するファイル]
リスト)に表示します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 319 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能ファイルを検索するには
1.

[前回検索したディレクトリ]は、前回ソースファイルを検索したディレクトリを表示します。

2.

[検索状況]は、見つからなかったファイル数([未検出])に対して見つかったファイル数([検出])を表示します。ダイアログボックスに表示されているファイルの数で、前回検索した時の数は含みません。

3.

[検索するファイル]リストは、見つからなかったすべてのファイルのリストを表示します。リストにはファイル名のみを表示し、このファイル名を元に検索します。

4.

[参照]は、ファイルを検索するためのディレクトリを選択します。

5.

[サブディレクトリの検索]チェックボックスをオンにすると、選択されたディレクトリのすべてのサブディレクトリでファイルを検索します。このチェックボックスのデフォルトはオフです。

6.

[ダウンロード時表示しない]チェックボックスをオンにすると、ダウンロード時に見つからなかった
ファイルがある場合もこのダイアログボックスを開きません。このチェックボックスのデフォルトはオフです。このチェックボックスは、[オプション]ダイアログボックスの[確認]タブにもあります。

7.

[検索]ボタンをクリックすると、[参照]で選択したディレクトリにあるファイルを検索し、見つかったファイルは[検索するファイル]リストから消去されます。
[参照]で検索済みのディレクトリは、フォルダと虫眼鏡のアイコン()で表示されます。

[検索]ボタンをクリックすると、検索を取り消せる[中止]ボタンに変わります。[中止]ボタンをクリッ
クすると、検索を取り消す前に見つかったファイルは、場所が特定されない状態に戻ります。
8.

[OK]をクリックすると、検索して見つかったファイルをそのディレクトリに特定します。すべてのフ
ァイルの検索が保存され、ダイアログボックスを閉じます。

9.

[キャンセル]をクリックすると、すべてのファイルの検索が取り消され、ダイアログボックスを閉じます。

ファイルを検索した後で[キャンセル]を選択すると、下記の確認要求ダイアログボックスが開きます。

「はい」を選択すると、[ファイルの検索]ダイアログボックスを閉じます。「いいえ」を選択すると、[ファイルの検索]ダイアログボックスは閉じません。
確認要求ダイアログボックスを表示しない場合、[今後表示しない]チェックボックスをオンにしてください。
[今後表示しない]を選択すると、「はい」を選択したときの動作がデフォルトです。
確認要求ダイアログボックスを再び表示するには
1.

[基本設定 -> オプション]を選択してください。[オプション]ダイアログボックスが開きます。

2.

[確認]タブを選択してください。

3.

[ディレクトリ参照ダイアログでキャンセルした時の確認]チェックボックスをオンにしてください。
このチェックボックスのデフォルトはオンです。

4.

[OK]をクリックしてください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 320 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能ディレクトリを選択した後で[検索]を選択せずに[OK]を選択すると、下記の確認要求ダイアログボックスが開きます。

「はい」を選択すると、ファイルを検索し、[ファイルの検索]ダイアログボックスは閉じません。必要に応じて検索は中止できます。
「いいえ」を選択すると、メッセージを表示し、[ファイルの検索]ダイアログボックスを閉じます。
確認要求ダイアログボックスを表示しない場合、[今後表示しない]チェックボックスをオンにしてください。
[今後表示しない]を選択すると、「いいえ」を選択したときの動作がデフォルトです。
確認要求ダイアログボックスを再び表示するには
1.

[基本設定 -> オプション]を選択してください。[オプション]ダイアログボックスが開きます。

2.

[確認]タブを選択してください。

3.

[ディレクトリ参照ダイアログでOKした時の検索の確認]チェックボックスをオンにしてください。このチェックボックスのデフォルトはオンです。

4.

(2)

[OK]をクリックしてください。

ソースツリーを表示する

ダウンロードモジュールから取得したソースファイル名は、ワークスペースウィンドウのダウンロードモジュ
ール下に表示します。
ソースファイルは、ファイルの種類でグループ分けし関連したフォルダ下に表示します。
ファイルの種類が定義されていない場合、ファイルの拡張子フォルダ下にグループ分けします。
この場合、ファイルをダブルクリックすると外部エディタでファイルを開きます。エディタウィンドウで開くには、「2.5 ファイル拡張子とファイルグループ」を参照してください。
見つかったソースファイルは、ダウンロードモジュール下に通常のファイルアイコン(

R20UT0372JJ0100 Rev.1.00
2011.02.01)で表示します。

Page 321 of 479

High-performance Embedded Workshop V.4.09

見つからなかったソースファイルは、ダウンロードモジュール下に赤いファイルアイコン(

17.

デバッグ機能)で表示します。

これらのファイルを区別するためにファイルを絶対パスで表示できます。
すべてのファイルを絶対パスで表示するには
1.

ワークスペースウィンドウの[Projects]タブ内で右クリックします。

2.

[表示の構成]を選択してください。[表示の構成]ダイアログボックスが開きます。

3.

[ファイルパスの表示]チェックボックスをオンにしてください。

4.

[OK]をクリックしてください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 322 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能ポップアップメニューからファイルを別のディレクトリで再検索することができます。

(3)

ファイルを別のディレクトリで再検索する

ダウンロードモジュール内のすべてのソースファイルを別のディレクトリで再検索するには、ダウンロードモ
ジュールのポップアップメニューから行ってください。
ダウンロードモジュール内のすべてのソースファイルを別のディレクトリで再検索するには
1.

ワークスペースウィンドウの[Projects]タブ内のダウンロードモジュール上で右クリックします。

2.

[モジュールの検索]を選択します。Windows® の標準的なディレクトリを開くダイアログボックスが開きます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 323 of 479

High-performance Embedded Workshop V.4.09

3.

17.

デバッグ機能検索するディレクトリを選択し、[開く]ボタンをクリックします。

選択したディレクトリで見つからなかったソースファイルは、[ファイルの検索]ダイアログボックスを表示し、これらのファイルを検索できます。
また、ソースファイルを別のディレクトリで再検索するには、ファイルのポップアップメニューから行ってください。
ファイルを別のディレクトリで再検索するには
1.

ワークスペースウィンドウの[Projects]タブ内のファイル上で右クリックします。

2.

[ファイルの検索]を選択します。Windows® の標準的なファイルを開くダイアログボックスが開きます。

3.

同じ名前のファイルだけを選択できます。

4.

ファイルを選択し、[開く]ボタンをクリックします。

複数のファイルを選択することもできます。その場合は、[ファイルの検索]ダイアログボックスを開きます。

17.1.5.5

ダウンロード後に main 関数を表示する

モジュールのダウンロード後にmain関数を含むソースファイルを自動的にHigh-performance Embedded
Workshopエディタのソースモードで表示する機能があります。
ダウンロード後にmain関数を表示するには
1.

[基本設定 -> オプション]を選択し、[オプション]ダイアログボックスを開きます。

2.

[デバッグ]タブを選択します。

3.

[ダウンロード後にmain関数を表示]チェックボックスをオンにします。デフォルトはオフです。

4.

OKをクリックします。

5.

モジュールをダウンロードします。ダウンロードについては、「17.1.5.2 モジュールをダウンロード
する」を参照してください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 324 of 479

High-performance Embedded Workshop V.4.09

17.1.5.617.

デバッグ機能モジュールをアンロードする

ダウンロードしたモジュールを手動でアンロードします。
モジュールをアンロードすると、そのモジュールのシンボルは、High-performance Embedded Workshopデバッ
ギングシステムからなくなりますが、ターゲットのメモリ内容は変更しません。一度アンロードしたモジュー
ルは、再度ロードするまでデバッグすることはできません。
モジュールをアンロードするには以下のいずれかの操作を選択してください。
•[デバッグ -> アンロード]のサブメニューからアンロードしたいモジュールを選択する。

•

ワークスペースウィンドウの[Projects]タブの[Download modules]フォルダ内のアンロードしたいモジ
ュールを選択し、右クリックしポップアップメニューを表示してください。ポップアップメニューから[アンロード]を選択する。この場合モジュールは複数選択できます。

すべてのモジュールをアンロードするには•[デバッグ -> アンロード -> All Download Modules]を選択する。

[デバッグ -> デバッグの設定]を選択し、[デバッグの設定]ダイアログボックスを開きます。[ターゲット]タブの[ダウンロードモジュール]リストで指定した順番でターゲットからアンロードされます。

17.1.6デバッグセッション

High-performance Embedded Workshopは、ビルダオプションをコンフィグレーションへ保存できます。同様に、
High-performance Embedded Workshopは、デバッグオプションをセッションに保存することもできます。
セッションには、デバッガ、ダウンロードするプログラム、各デバッガのオプションを保存できます。これは、各セッションが異なるデバッガをターゲットにできることを意味します。
この機能は異なるデバッグオプションを持つ多くの異なるセッションを許します。例えば、各セッションは同
じターゲットで少し違うオプション設定にできます。これはレジスタ値やクロックスピードなどのターゲット
設定を、セッションで簡単に変更したり切り替えたりできることを意味します。下図はこの典型例です。5つのセッションがターゲットを共有しています。しかしセッションでは異なるオプション定義が可能です。

セッションは、コンフィグレーションとは直接関連がありません。これは、複数のセッションが同じダウンロ
ードモジュールを共有し、プログラムの不要なリビルドを避けられることを意味します。
各セッションのデータは、別々のファイルでHigh-performance Embedded Workshopプロジェクトに保存します。
プロジェクト内でデータを共有したり、必要に応じて変更したりできます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 325 of 479

High-performance Embedded Workshop V.4.09

17.1.6.1

17.

デバッグ機能セッションを選択する

セッションを選択するには
1.

[デバッグ -> デバッグセッション]を選択してください。[デバッグセッション]ダイアログボックスが
開きます。

2.

[現在のセッション]ドロップダウンリストから使用するセッションを選択してください。

3.

[OK]ボタンをクリックしてください。

また、[標準]ツールバーのドロップダウンリストから異なるセッションを選択することもできます。

17.1.6.2

セッションを追加する

ターゲットを取り付けてセットアップし、セッションを作成できます。セッションには名前を付け、ターゲッ
トを選択できます。
ターゲットを取り付けてセットアップし、新しいセッションを作成するには
1.

[ファイル -> 新規セッション]を選択してください。[新規セッション]ダイアログボックスが開きます。

2.

[セッション]に新しいセッションの名前を入力してください。セッション名は、32文字以内で、半角英数字、半角下線のみ使用してください。特に、日本語文字、空白、または半角マイナス記号は使用しないでください。

3.

[ターゲット]で使用するターゲットを選択してください。

4.

[コア]で使用するコアを選択してください。同期デバッグ機能を使用している場合に選択できます。

5.

[使用するプロジェクトジェネレータ]でジェネレータを選択してください。デフォルトで選択されているものが適切ですが、複数のジェネレータが同じターゲットをサポートしている場合もあります。

6.

[OK]ボタンをクリックしてください。生成プロセスを開始します。このプロセスは、選択したジェネ
レータに依存します。このとき、さらにターゲット設定オプションのダイアログボックスを表示することがあります。

7.

設定を完了すると、現在のプロジェクトに新しいセッションを追加します。追加されたセッションは、

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 326 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能メインツールバーの[セッション]ドロップダウンリストボックスの中にあります。
新しいセッションを追加できます。入力したセッション名のファイルを新しく作成します。ファイルが既に存在する場合はエラーを表示します。
新しい空のセッションを追加するには
1.

[デバッグ -> デバッグセッション]を選択してください。[デバッグセッション]ダイアログボックスが
開きます。

2.

[追加]ボタンをクリックしてください。[新規セッション追加]ダイアログボックスが開きます。

3.

[新規セッションの追加]ラジオボタンをチェックしてください。

4.

セッションの名前を入力してください。

5.

[OK]ボタンをクリックしてください。

別のファイルからセッションデータをインポートして新しいセッションを作成できます。インポート元ファイ
ルのデータはそのまますべてコピーします。
既存のセッションを新しいセッションファイルにインポートするには
1.

[デバッグ -> デバッグセッション]を選択してください。[デバッグセッション]ダイアログボックスが
開きます。

2.

[追加]ボタンをクリックしてください。[新規セッション追加]ダイアログボックスが開きます。

3.

[既存セッションの使用]ラジオボタンをチェックしてください。

4.

セッションの名前を入力してください。

5.

現在のプロジェクトにインポートしたい既存のセッションファイルをブラウズしてください。

6.

[OK]ボタンをクリックしてください。

これと同じ操作が、[ファイル -> セッションのインポート]を使ってもできます。
1.

[ファイル -> セッションのインポート]を選択してください。[セッション名]ダイアログボックスが開きます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 327 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能2.

新しいセッションの名前を入力してください。

3.

新しいセッションにインポートしたいセッションファイルを選択してください。

4.

[OK]ボタンをクリックしてください。ブラウズしたファイルと同じ設定で、新しい名前の付いた新しいセッションを追加します。

17.1.6.3

リンクをセッションにインポートする

新しいセッションをHigh-performance Embedded Workshopシステムに追加するとき、セッションファイルをプ
ロジェクトディレクトリにインポートまたはコピーしたりするのではなく、その場でセッションファイルにリンクできます。この方法は、ネットワーク環境で他のユーザとデバッガ情報を共有する場合に便利です。
既存のセッションファイルにリンクをインポートするには
1.

[デバッグ -> デバッグセッション]を選択してください。[デバッグセッション]ダイアログボックスが
開きます。

2.

[追加]ボタンをクリックしてください。[新規セッション追加]ダイアログボックスが開きます。

3.

[既存セッションの使用]ラジオボタンをチェックしてください。

4.

セッションの名前を入力してください。

5.

現在のプロジェクトにインポートしたい既存のセッションファイルを参照してください。

6.

[セッションファイルへのリンク]チェックボックスをオンにしてください。プロジェクトディレクト
リに新しいセッションファイルを生成せず、High-performance Embedded Workshopは既存のセッション
ファイルにリンクします。このファイルの場所はステップ5で入力したもので、すべてのセッションデ
ータをこの場所に保存します。

7.

[OK]ボタンをクリックしてください。

リンクしたセッションファイルを読み取り専用で使用できます。デバッガ設定ファイルを共有していて、データを誤って変更してしまうのを防ぐ場合に便利です。
リンクを既存のファイルにインポートし、読み取り専用にするには
1.

[デバッグ -> デバッグセッション]を選択してください。[デバッグセッション]ダイアログボックスが
開きます。

2.

[追加]ボタンをクリックしてください。[新規セッション追加]ダイアログボックスが開きます。

3.

[既存セッションの使用]ラジオボタンをチェックしてください。

4.

セッションの名前を入力してください。

5.

現在のプロジェクトにインポートしたい既存のセッションファイルを参照してください。

6.

[セッションファイルへのリンク]チェックボックスをオンにしてください。

7.

[書き込み不可属性でのセッションファイル生成]チェックボックスをオンにしてください。
High-performance Embedded Workshopはこのセッションへの変更を保存することはできません。このセッションを開いて、データを読み取ることができます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 328 of 479

High-performance Embedded Workshop V.4.09

17.1.6.4

17.

デバッグ機能セッションを削除する

セッションを削除するには
1.

[デバッグ -> デバッグセッション]を選択してください。[デバッグセッション]ダイアログボックスが
開きます。

2.

削除したいセッションを選択してください。

3.

[削除]ボタンをクリックしてください。

4.

[OK]ボタンをクリックしください。

現在のセッションを削除することはできません。

17.1.6.5

セッションを書き込み不可にする

セッションを書き込み不可にするには

1.

[デバッグ -> デバッグセッション]を選択してください。[デバッグセッション]ダイアログボックスが
開きます。

2.

書き込み不可にしたいセッションを選択してください。

3.

[プロパティ]ボタンをクリックしてください。[セッションプロパティ]ダイアログボックスが開きます。

4.

[書き込み不可]チェックボックスをオンにしてください。リンクを読み取り専用にします。これは、デバッガ設定ファイルを共有する場合、およびデータを誤って修正したくない場合に便利です。

5.

[OK]ボタンをクリックしてください。

17.1.6.6

セッション情報を保存する

セッションを保存するには[ファイル -> セッションの保存]を選択してください。
[基本設定 -> オプション]を選択し、[オプション]ダイアログボックスの[ワークスペース]タブを表示してください。[セッション保存前に確認]チェックボックスがオンの場合、セッション保存の前に、セッションを保存するかを確認するダイアログボックスを表示させることができます。ここで、[いいえ]を選択するとセッショ

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 329 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能ンへの変更を保存しません。
セッションを別名で保存するには
1.

[デバッグ -> デバッグセッション]を選択してください。[デバッグセッション]ダイアログボックスが
開きます。

2.

保存したいセッションを選択してください。

3.

[名前を付けて保存]ボタンをクリックしてください。[セッションの保存]ダイアログボックスが開きます。

4.

新しいファイルの場所をブラウズしてください。

5.

セッションファイルを別の場所へエクスポートしたい場合は、[プロジェクトとのリンク]チェックボ
ックスをオンにしないでください。現在のセッションの場所の代わりにこの場所をHigh-performance
Embedded Workshopで使用したい場合は、[プロジェクトとのリンク]チェックボックスをオンにしてく
ださい。

6.

[保存]ボタンをクリックしてください。

これと同じ操作が、[ファイル -> 名前を付けてセッションを保存]を使っても可能です。
1.

[ファイル -> 名前を付けてセッションを保存]を選択してください。[セッション名]ダイアログボック
スが開きます。

2.

新しいセッションの名前を入力してください。

3.

[OK]ボタンをクリックしてください。

17.1.6.7

セッション情報のリフレッシュセッションを再び読み込むには[ファイル -> セッションのリフレッシュ]を選択してください。
これにより現在のセッションに加えられている変更を廃棄して、セッション情報を再び読み込みます。

17.2

プログラムを表示する

この節では、プログラムをソースコードおよびアセンブリ言語ニーモニックとして表示する方法を説明します。
ソースコードは、次の2種類のウィンドウにある[ソースモード]で表示します。主な特徴を以下に示します。
エディタウィンドウ
•エディタウィンドウで表示するソースファイルは編集可能です。

•

ソースコードをステップ実行などによりデバッグするとき、対応するソースファイル（現在のプログ

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 330 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能

ラムカウンタ(PC)のアドレスを含む）が変わると、別のウィンドウで自動的に開きます。対応するソースコード行がない場合にステップ実行すると、[ソースモード]は[逆アセンブリモード]に切り替わります。

逆アセンブリウィンドウ•

逆アセンブリウィンドウで表示するソースファイルはすべて読み取り専用で編集できません。ソース
ファイルを編集するにはポップアップメニューからエディタウィンドウを開いて行います。

•

ソースコードをステップ実行などによりデバッグするとき、逆アセンブリウィンドウは対応するソー
スファイル（現在のPCアドレスを含む）に自動的に切り替わります。逆アセンブリウィンドウが開いている間、エディタウィンドウは開かずに、必要に応じて逆アセンブリウィンドウ内にソースファイ
ルを表示します。対応するソースコード行がない場合にステップ実行すると、[ソースモード]は[逆アセンブリモード]に切り替わります。

•

デバッグ中に逆アセンブリウィンドウのソースモード表示を優先する機能があります。この機能を使用した場合の動作を次に示します。
o

逆アセンブリウィンドウを[逆アセンブリモード]で開き、ソースのアドレスでブレークすると、逆アセンブリウィンドウは[ソースモード]に切り替わります。

o

ソースのアドレスでブレークしても、逆アセンブリウィンドウが開いている場合はエディタウィン
ドウを開きません。

oプログラム実行前と後では、表示しているウィンドウの重なり順序を変更しません。

oエディタウィンドウで開いているソースファイルの表示位置を変更しません。

逆アセンブリウィンドウの[逆アセンブリモード]でステップを続ける場合は、[デバッグ->ステップモー
ド->アセンブリ]を選択してください。
注：
ブレークするとPC位置を表示します。このとき、例えばプロジェクトのパスが移動されていると、ソースファ
イルを自動的に見つけられません。その場合、ソースファイルのパスを手動で指定できるように参照ダイアロ
グボックスが開きます。デバッグしているプロジェクトの他のソースファイルのパスも更新します。

17.2.1

エディタウィンドウを開く

ワークスペースウィンドウ上のソースファイルをダブルクリックするか、ソースファイル上で右ボタンをクリックしポップアップメニューを表示して[開く]を選択すると、エディタでファイルを開きます。
ツールバー

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 331 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能High-performance Embedded Workshop V.4.00以降のエディタでは、逆アセンブリ表示を統合しています。
モードを切り替えるツールバーがあります。各モードが有効である場合、ボタンをクリックすると表示を切り替えます。
以下の3つのモードがあります。
モード
ソースモード機能
このモードは、標準的な High-performance Embedded Workshop エディタで、ソースファイルを編集できます。また、ソースファイルを参照している場合は、キーワードを強調表示します。
行番号、アドレス、ブレークポイント、ブックマーク、およびソースコードを参照できます。

混合モード

ソースファイルの混合モードは、逆アセンブリウィンドウの混合モードとは異なります。継続する逆アセンブリを示すかわりに、ソースコードの各行に関連する逆アセンブリを示します。
このモードは表示を編集できません。モジュールがダウンロードされている場合のみ有効になります。
行番号、ブレークポイント、アドレス、オブジェクトコード、ラベル、および混合（ソース・逆アセンブリ）を参照できます。

逆アセンブリモード

逆アセンブリモードは、実際に継続する逆アセンブリコードをアドレス順に示します。これは、[表示 -> 逆アセンブリ]を選択するのと同じです。ターゲットがセッションに接続している場合のみ有効になります。
ブレークポイント、アドレス、オブジェクトコード、ラベル、および逆アセンブリコードを参照
できます。

注：
以下の条件下で、[ソースモード]から[混合モード]へ切り替えることはできません。
1.

ターゲットが現在のセッションに接続していない。

2.

ダウンロードモジュールをダウンロードしていない。

3.

現在のプロジェクトに有効なデバッグ情報がない。

4.

現在表示しているファイルを編集したが、変更内容を保存していない。

[逆アセンブリモード]で、アドレスがそのソースファイルのアドレス範囲から外れ、別のソースファイルのア
ドレス範囲に変わった場合、[ソースモード]または[混合モード]へ切り替えると下記の確認ダイアログボック
スが開きます。
アドレスに対応する別のファイルを開く場合は「はい」を選択してください。切り替える前の位置で表示するには「いいえ」を選択してください。他のモードへ切り替えない場合は、「キャンセル」を選択してください。

確認要求ダイアログボックスを表示しない場合、[今後表示しない]チェックボックスをオンにしてください。
確認要求ダイアログボックスを再び表示するには
1.

[基本設定 -> オプション]を選択してください。[オプション]ダイアログボックスが開きます。

2.

[確認]タブを選択してください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 332 of 479

High-performance Embedded Workshop V.4.09

3.

17.

デバッグ機能[表示モード切り替えで別ファイルを開く時の確認]チェックボックスをオンにしてください。このチェックボックスのデフォルトはオンです。

4.

[OK]をクリックしてください。

17.2.1.1

ソースコードを表示する[ソースモードで表示]ボタンをクリックしたときにソースファイルのコードを表示します。
ウィンドウの構成•

各モードが有効である場合、ツールバーのボタンをクリックすると表示を切り替えます。混合モードの逆アセンブリを表示するには、[混合モードで表示]ボタンをクリックしてください。逆アセンブリを表示するには、[逆アセンブリモードで表示]ボタンをクリックしてください。

•[ソース]領域の左側には以下に示すカラムがあります。
カラム名

内容

行番号

ソースファイルに対応する行番号を表示します。

ソースアドレスモジュールをダウンロードすると、ソースファイルに対応するアドレスを表示します。

S/Wブレークポイント

PC位置()、PCブレークポイント位置( )、ブックマーク位置()を表示します。ダブルクリックによりPCブレークポイントを設定または解除します。
•[ソース]領域はシンタックスを強調表示したコードを含みます。

ウィンドウのオプション[ソース]領域内で右クリックすると、使用可能なオプションをポップアップメニューで表示します。
ポップアップメニューオプション

マクロの記録機能
ファイルをコンパイルします。

コンパイル '<ファイル名>'開く '<ファイル名>'-選択されたファイル名を元にファイルを開きます。

切り取り

-

選択部分を削除し Windows® クリップボードに貼り付けます。

コピー-

選択部分をコピーし Windows® クリップボードに貼り付けます。

貼り付け

-

Windows® クリップボードの内容をコピーしてアクティブウィン
ドウのカーソル位置に貼り付けます。

プロジェクトにファイルの追加

R20UT0372JJ0100 Rev.1.00
2011.02.01-

ファイルをプロジェクトに追加します。

Page 333 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能ポップアップメニューオプション

マクロの記録機能

定義へジャンプ '<ナビゲーション-#define、C 関数、または C++クラスなどのナビゲーション項目の項目名>'

定義位置を表示します。

ナビゲーションリスト

-スマートエディタ機能が有効な場合に、アルファベット順に C
Define、C Function、または C++ Classes のナビゲーションリス
トをポップアップウィンドウで表示します。項目上でダブルクリッ
クすると、カーソル位置にその文字列を貼り付けます。

検索-

現在のファイルのテキストを検索します。

置換-

テキストを置換します。

ジャンプ

-

指定した行にジャンプします。

括弧の呼応

-

括弧の組み合わせを見つけます。

ブック

ブックマークの挿入/削除-

ブックマークを設定/解除します。

マーク

次のブックマーク-

次のブックマークにジャンプします。

前のブックマーク-

同じファイルの 1 つ前のブックマークに戻ります。

すべてのブックマークの-ファイル内のすべてのブックマークを削除します。

削除
テンプ

テンプレートの定義-

テンプレートを設定します。

レート

テンプレートの挿入-

テンプレートを挿入します。
標準のブレークポイント(PC ブレークポイント)を挿入または削除

ブレークポイントの挿入/削除

します。
現在設定している PC ブレークポイントを有効または無効としまブレークポイントの有効化/無効化

す。
表示カラムの設定-

表示カラムを設定します。

カラム

カラム名

-

表示カラムを設定します。

カラムヘッダの表示/非表示-

カラムヘッダの表示/非表示を切り替えます。

インスタントウォッチ *-変数名を現在のテキストカーソル(マウスカーソルではありません)の位置から抜き出して名前とともにインスタントウォッチダイア
ログボックスを開きます。ソースのある行のみ有効になります。

ウォッチウィンドウに追加 *-選択した変数をウォッチウィンドウに登録します。
現在の PC アドレスからユーザプログラムの実行を開始します。プ

カーソル位置まで実行

ログラムは、PC がテキストカーソルの位置によって指定されたア
ドレスに達するか、別のブレーク条件が成立するまで実行します。
PC の値をテキストカーソルの位置によって指定されたアドレスにカーソル位置に PC 値を設定変更します。
PC 位置を表示-

PC 位置のソースファイルまたは逆アセンブリを表示します。

逆アセンブリ-

現在のソース行に対応したアドレスの逆アセンブリウィンドウを
開きます。

プロパティ

-

ファイルのプロパティを表示します。

注：*. 機能のサポートはデバッガに依存します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 334 of 479

High-performance Embedded Workshop V.4.09

17.2.1.217.

デバッグ機能アセンブリ言語コードを表示する[逆アセンブリモード]の表示開始アドレスは、[ソースモード]のカーソル位置に対応するアドレスとなります。
逆アセンブリコードの表示は、デバッガが接続されている場合のみ有効になります。
ウィンドウの構成•

各モードが有効である場合、ツールバーのボタンをクリックすると表示を切り替えます。混合モードの逆アセンブリを表示するには、[混合モードで表示]ボタンをクリックしてください。ソースコードを表示するには、[ソースモードで表示]ボタンをクリックしてください。

•[逆アセンブリ]領域の左側には以下に示すカラムがあります。
カラム名

内容

S/Wブレークポイント - ASM

PC位置()、PCブレークポイント位置( )を表示します。ダブルクリックによりPCブレークポイントを設定または解除します。
逆アセンブリアドレス

逆アセンブリアドレスを表示します。ダブルクリックにより[アドレス指定]ダイアログボックスが開きます。逆アセンブリの表示開始ア
ドレスを入力してください。

オブジェクトコード

オブジェクトコードを表示します。

ラベル

ラベルを表示します。モジュールをダウンロードしていない場合このカラムは使用できません。

•[逆アセンブリモード]では、[逆アセンブリ]領域のアセンブリ言語コードをダブルクリックすると、[アセンブル]ダイアログボックスが開きます。アセンブリ言語コードを入力してください。

ウィンドウのオプション[逆アセンブリ]領域内で右クリックすると、使用可能なオプションをポップアップメニューで表示します。
ポップアップメニューオプション

マクロの記録機能

リフレッシュ

-逆アセンブリの最新情報を取得し表示内容を更新します。

リフレッシュ抑止-[逆アセンブリモード]のメモリ範囲がリフレッシュされないように
ロックします。

ソースの表示-

アドレスに対応するソースの位置でエディタを表示します。

表示アドレス設定-

開始アドレスを指定します。
現在の PC アドレスからプログラムを実行します。プログラムは、

カーソル位置まで実行

PC がテキストカーソルの位置によって指定されたアドレスに達す
るか、別のブレーク条件が成立するまで実行します。
PC 位置を表示

R20UT0372JJ0100 Rev.1.00
2011.02.01-

PC 位置の逆アセンブリを表示します。

Page 335 of 479

High-performance Embedded Workshop V.4.09

ポップアップメニューオプション

17.

マクロの記録デバッグ機能機能
PC の値をテキストカーソルの位置によって指定されたアドレスにカーソル位置に PC 値を設定変更します。
編集-

任意のアドレスの命令を変更します。

範囲で検索

-

指定した範囲で文字列を検索します。

コピー-

選択部分をコピーし Windows® クリップボードに貼り付けます。

表示カラムの設定-

表示カラムを設定します。

カラムヘッダの表示/非表示-

カラムヘッダの表示、非表示を切り替えます。

テキストファイルに保存-指定した範囲をテキストで保存します。

印刷-

指定した範囲を印刷します。

ブレークポイントの挿入/削除

標準のブレークポイント(PC ブレークポイント)を挿入または削除します。

ブレークポイントの有効化/無効化

現在設定している PC ブレークポイントを有効または無効とします。

17.2.1.3

逆アセンブリ表示をリフレッシュする

外部オペレーションが逆アセンブリ表示のメモリを変更する場合、High-performance Embedded Workshopはメ
モリの変更を検知できません。例えば、表示されている範囲のメモリに対して外部フラッシュユーティリィテ
ィを使用してプログラミングしても、逆アセンブリは変更されません。
[逆アセンブリ]領域内（[逆アセンブリモード]）で右クリックし、ポップアップメニューから[リフレッシュ]を選択してください。
逆アセンブリの最新情報を取得し表示内容を更新します。

17.2.1.4

逆アセンブリ表示のリフレッシュを抑止する

逆アセンブリ表示のメモリ範囲がリフレッシュされないようにロックします。この機能を逆アセンブリのリフ
レッシュ抑止と呼びます。
[逆アセンブリ]領域内（[逆アセンブリモード]）で右クリックし、ポップアップメニューから[リフレッシュ抑止]を選択してください。[リフレッシュ抑止]ダイアログボックスが開きます。

[ロック]チェックボックスをオンにしてください。他のコントロールが有効になります。
ロックおよびキャッシュする[開始アドレス]および[終了アドレス]を指定し[OK]ボタンをクリックしてください。ロックしたメモリ範囲のみを表示します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 336 of 479

High-performance Embedded Workshop V.4.09

17.2.1.517.

デバッグ機能

特定のアドレスを見る

逆アセンブリ表示でプログラムを見ている場合、プログラム内の他の箇所を見たいときがあります。そのような場合、プログラム内のコードをスクロールせずに特定のアドレスにジャンプできます。
[逆アセンブリ]領域内（[逆アセンブリモード]）で右クリックし、ポップアップメニューから[表示アドレス設
定]を選択します。[アドレス指定]ダイアログボックスが開きます。

[アドレス]エディットボックスにアドレスを指定し、[OK]ボタンをクリックしてください。アドレスは、ラベ
ル名で入力することも可能です。
逆アセンブリ表示を更新して入力したアドレスのコードを表示します。
オーバーロード関数またはクラス名を入力した場合、[関数選択]ダイアログボックスを開くので、関数を選択してください（機能のサポートはデバッガに依存します）。

17.2.1.6

アセンブリ言語コードを編集する

逆アセンブリ表示（[逆アセンブリモード]）で編集したい命令をダブルクリックすることによって、アセンブ
リ言語コードを編集できます。[アセンブル]ダイアログボックスが開きます。

アドレス、オブジェクトコード、およびニーモニックを表示します。[ニーモニック]に新しい命令を入力（または古い命令を編集）します。"Enter"キーを押すと、メモリ内容を新しいオブジェクトコードに書き換えて、次の命令に移ります。[OK]ボタンをクリックすると、メモリ内容を新しい命令コードに書き換えて、ダイアロ
グボックスを閉じます。[キャンセル]ボタンをクリックするか"Esc"キーを押すと、メモリ内容を書き換えずに、ダイアログボックスを閉じます。
注：
アセンブリ言語コードは、現在のメモリ内容から表示しています。メモリ内容を修正すると、[アセンブル]ダ
イアログボックスおよび逆アセンブリ表示では、新しいアセンブリ言語コードを表示します。しかしソース表
示は変更しません。これはソースファイルにアセンブラを含む場合も同じです。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 337 of 479

High-performance Embedded Workshop V.4.09

17.2.1.717.

デバッグ機能逆アセンブリで範囲検索する

逆アセンブリ表示の特定のアドレス範囲でテキスト文字列を検索できます。
[逆アセンブリ]領域内（[逆アセンブリモード]）で右クリックし、ポップアップメニューから[範囲で検索]を選択してください。[範囲で検索]ダイアログボックスが開きます。

検索する文字列、開始アドレスおよび終了アドレスを指定してください。[OK]ボタンをクリックしてください。
範囲にある最初にあらわれた該当文字列を選択します。

17.2.1.8

逆アセンブリテキストを保存する

特定のアドレス範囲の逆アセンブリ表示内容をテキストに保存できます。
[逆アセンブリ]領域内（[逆アセンブリモード]）で右クリックし、ポップアップメニューから[テキストファイ
ルに保存]を選択してください。[逆アセンブリテキスト保存]ダイアログボックスが開きます。

保存する開始アドレス、終了アドレス、およびファイル名を指定してください。[OK]ボタンをクリックしてください。

17.2.1.9

逆アセンブリ表示を印刷する

逆アセンブリ表示を印刷するには、ウィンドウがアクティブな場合に[ファイル -> 印刷]または[印刷]ツールバ
ーボタン()を使用するか、または[逆アセンブリ]領域内（[逆アセンブリモード]）のポップアップメニューにある[印刷]を使用します。[印刷]を選択すると、[逆アセンブリ印刷範囲]ダイアログボックスが開きます。特定のアドレス範囲の表示内容を印刷できます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 338 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能印刷する開始アドレスと終了アドレスを指定してください。[OK]ボタンをクリックすると、標準のプリントフォーマットを選択するダイアログボックスが開きます。ここで、使用するプリンタとページ設定のオプションを選択できます。[印刷]ボタンをクリックしてください。

逆アセンブリウィンドウを開く

17.2.2

以下のいずれかの方法によりアセンブリ言語レベルでコードを表示できます。
•[表示 -> 逆アセンブリ]を選択する。

•[逆アセンブリ]ツールバーボタン(•"Ctrl+D"キーを押す。

)をクリックする。

この場合、逆アセンブリウィンドウは現在のプログラムカウンタ（PC）の位置で開きます。
ツールバー

High-performance Embedded Workshop V.4.02以降の逆アセンブリウィンドウはソース表示を使用できます。
モードを切り替えるツールバーがあります。各モードが有効である場合、ボタンをクリックすると表示を切り替えます。
以下の3つのモードがあります。
モード
ソースモード機能
現在の PC アドレスに対応するソースファイルがある場合、逆アセンブリウィンドウ内にソースファイルを開きます。
ステップ実行などによるプログラムカウンタ(PC)位置の変化に追従し、同一ウィンドウ上で PCに対応したソースファイルおよびコードを表示します。別のソースファイル領域へ移動しても、新たなウィンドウは開きません。
このモードは、ソースファイルを読み取り専用で編集できません。モジュールがダウンロードされている場合のみ有効になります。
また、ソースファイルを参照している場合は、キーワードを強調表示します。
行番号、アドレス、ブレークポイント、およびソースコードを参照できます。

混合モード

逆アセンブリウィンドウの混合モードは、ソースファイルの混合モードとは異なります。継続する逆アセンブリを示すかわりに、ソースコードの各行に関連する逆アセンブリを示します。
このモードはアセンブリ言語コードを編集できます。モジュールがダウンロードされている場合のみ有効になります。
ブレークポイント、アドレス、オブジェクトコード、ラベル、および逆アセンブリコードを参照
できます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 339 of 479

High-performance Embedded Workshop V.4.09

17.

モード

デバッグ機能機能

逆アセンブリモード

逆アセンブリモードは、実際に継続する逆アセンブリコードをアドレス順に示します。
このモードはアセンブリ言語コードを編集できます。ターゲットがセッションに接続している場
合のみ有効になります。
ブレークポイント、アドレス、オブジェクトコード、ラベル、および逆アセンブリコードを参照
できます。

17.2.2.1

ソースコードを表示する

逆アセンブリウィンドウ内から[ソースモード]に切り替えるとき、現在のPCアドレスに対応するソースファイ
ルがある場合、逆アセンブリウィンドウ内にソースファイルを開きます。
現在のPCアドレスに対応するソースファイルがない場合は、ソースファイルを開くためにダイアログボックスが開きます。ファイルを選択し[開く]ボタンをクリックしてください。逆アセンブリウィンドウのソースモードでは、テキストベースのファイルはプロジェクトのソースファイルに限らず、すべて選択できます。
このウィンドウで開くソースファイルは、すべて読み取り専用で編集できません。ソースファイルの表示とデバッグを目的とするためです。
この表示モードはモジュールがダウンロードされている場合のみ有効になります。
ウィンドウの構成•

各モードが有効である場合、ツールバーのボタンをクリックすると表示を切り替えます。混合モードの逆アセンブリを表示するには、[混合モードで表示]ボタンをクリックしてください。逆アセンブリを表示するには、[逆アセンブリモードで表示]ボタンをクリックしてください。

•[ソース]領域の左側には以下に示すカラムがあります。
カラム名

内容

行番号

ソースファイルに対応する行番号を表示します。

ソースアドレスモジュールをダウンロードすると、ソースファイルに対応するアドレスを表示します。

S/Wブレークポイント

PC位置()、PCブレークポイント位置( )を表示します。ダブルクリックによりPCブレークポイントを設定または解除します。
•[ソース]領域はシンタックスを強調表示したコードを含みます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 340 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能ウィンドウのオプション[ソース]領域内で右クリックすると、使用可能なオプションをポップアップメニューで表示します。
ポップアップメニューオプション

マクロの記録機能

編集ソースの表示-

編集するソースファイルをエディタウィンドウで開きます。

ファイルを開く-

逆アセンブリウィンドウ内に表示するファイルを選択します。

コピー-

選択部分をコピーし Windows® クリップボードに貼り付けます。

定義へジャンプ '<ナビゲーション-#define、C 関数、または C++クラスなどのナビゲーション項目の項目名>'

定義位置を表示します。

検索-

現在のファイルのテキストを検索します。

ジャンプ

-

指定した行にジャンプします。
標準のブレークポイント(PC ブレークポイント)を挿入または削除

ブレークポイントの挿入/削除

します。
現在設定している PC ブレークポイントを有効または無効としまブレークポイントの有効化/無効化

す。
カラムヘッダの表示/非表示-

カラムヘッダの表示/非表示を切り替えます。

表示カラムの設定-

表示カラムを設定します。

カラム

カラム名

-

表示カラムを設定します。

インスタントウォッチ *-変数名を現在のテキストカーソル(マウスカーソルではありません)の位置から抜き出して名前とともにインスタントウォッチダイア
ログボックスを開きます。ソースのある行のみ有効になります。

ウォッチウィンドウに追加 *-選択した変数をウォッチウィンドウに登録します。

表示アドレス設定-

開始アドレスを指定します。
現在の PC アドレスからユーザプログラムの実行を開始します。プ

カーソル位置まで実行

ログラムは、PC がテキストカーソルの位置によって指定されたア
ドレスに達するか、別のブレーク条件が成立するまで実行します。
PC の値をテキストカーソルの位置によって指定されたアドレスにカーソル位置に PC 値を設定変更します。
PC 位置を表示-

PC 位置のソースファイルまたは逆アセンブリを表示します。

プロパティ

-

ファイルのプロパティを表示します。

注：*. 機能のサポートはデバッガに依存します。

17.2.2.2

編集するソースファイルを開く

逆アセンブリウィンドウのソースモードは、ソースを参照しデバッグが可能ですが編集はできません。
逆アセンブリウィンドウのソースモードで現在開いているソースファイルを編集できます。ポップアップメニ
ューから[編集ソースの表示]を選択してください。エディタウィンドウで編集するファイルを開きます。
また、ワークスペースウィンドウ、または[ファイル -> 開く]メインメニューによって手動で編集するファイ
ルを開くこともできます。

17.2.2.3

逆アセンブリウィンドウで別のファイルを開く

逆アセンブリウィンドウ内にソースファイルを開くことができます。ポップアップメニューから[ファイルを開く]を選択してください。このメニューオプションは、逆アセンブリウィンドウにあるすべての表示モード
R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 341 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能のポップアップメニューで利用できます。
このメニューオプションを選択すると、ソースファイルを開くためにファイルを参照するダイアログボックスが開きます。テキストベースのファイルはプロジェクトのソースファイルに限らず、すべて選択できます。

17.2.2.4

デバッグ中に逆アセンブリウィンドウのソースモード表示を優先する

デバッグ中に逆アセンブリウィンドウのソースモード表示を優先できます。
デバッグ中に逆アセンブリウィンドウのソースモード表示を優先するには
1.

[基本設定 -> オプション]を選択し、[オプション]ダイアログボックスを開きます。

2.

[デバッグ]タブを選択します。

3.

[デバッグ中に逆アセンブリウィンドウのソースモード表示を優先]チェックボックスをオンにします。チェックボックスのデフォルトはオフです。

4.

[OK]をクリックします。

この機能を使用した場合の動作を次に示します。
•

逆アセンブリウィンドウを[逆アセンブリモード]で開き、ソースファイルのアドレスでブレークすると、逆アセンブリウィンドウは[ソースモード]に切り替わります。

•

ソースファイルのアドレスでブレークしても、逆アセンブリウィンドウが開いている場合はエディタ
ウィンドウを開きません。

•

プログラム実行前と後では、表示しているウィンドウの重なり順序を変更しません。

•

エディタウィンドウで開いているソースファイルの表示位置を変更しません。

逆アセンブリウィンドウの[逆アセンブリモード]でステップを続けたい場合は、[デバッグ -> ステップモード-> アセンブリ]を選択してください。

17.2.2.5

アセンブリ言語コードを表示する[逆アセンブリモード]の表示開始アドレスは現在のPCの位置で開きます。逆アセンブリコードの表示は、デバッガに接続されている場合のみ有効になります。
ウィンドウの構成•

各モードが有効である場合、ツールバーのボタンをクリックすると表示を切り替えます。混合モードの逆アセンブリを表示するには、[混合モードで表示]ボタンをクリックしてください。ソースコードを表示するには、[ソースモードで表示]ボタンをクリックしてください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 342 of 479

High-performance Embedded Workshop V.4.09•

17.

デバッグ機能[逆アセンブリ]領域の左側には以下に示すカラムがあります。
カラム名

内容

S/Wブレークポイント - ASM

PC位置()、PCブレークポイント位置( )を表示します。ダブルク

リックによりPCブレークポイントを設定または解除します。
逆アセンブリアドレス

逆アセンブリアドレスを表示します。ダブルクリックにより[アドレス指定]ダイアログボックスが開きます。逆アセンブリの表示開始アドレスを入力してください。

オブジェクトコード

オブジェクトコードを表示します。

ラベル

ラベルを表示します。モジュールをダウンロードしていない場合
このカラムは使用できません。

•[逆アセンブリモード]および[混合モード]では、[逆アセンブリ]領域のアセンブリ言語コードをダブル
クリックすると、[アセンブル]ダイアログボックスが開きます。アセンブリ言語コードを入力してください。

ウィンドウのオプション[逆アセンブリ]領域内で右クリックすると、使用可能なオプションをポップアップメニューで表示します。
ポップアップメニューオプション

マクロの記録機能

ファイルを開く-

逆アセンブリウィンドウ内に表示するファイルを選択します。

リフレッシュ

-逆アセンブリの最新情報を取得し表示内容を更新します。

リフレッシュ抑止-

逆アセンブリウィンドウのメモリ範囲がリフレッシュされないよ
うにロックします。

ソースの表示-

アドレスに対応するソースの位置でエディタウィンドウを開きます。

表示アドレス設定-

開始アドレスを指定します。
現在の PC アドレスからプログラムを実行します。プログラムは、

カーソル位置まで実行

PC がテキストカーソルの位置によって指定されたアドレスに達す
るか、別のブレーク条件が成立するまで実行します。
PC 位置を表示-

PC 位置の逆アセンブリを表示します。
PC の値をテキストカーソルの位置によって指定されたアドレスにカーソル位置に PC 値を設定変更します。
編集-

任意のアドレスの命令を変更します。

範囲で検索

-

指定した範囲で文字列を検索します。

コピー-

選択部分をコピーし Windows® クリップボードに貼り付けます。

表示カラムの設定-

表示カラムを設定します。

カラムヘッダの表示/非表示-

カラムヘッダの表示、非表示を切り替えます。

テキストファイルに保存-指定した範囲をテキストで保存します。

印刷-

指定した範囲を印刷します。

ブレークポイントの挿入/削除

標準のブレークポイント(PC ブレークポイント)を挿入または削除します。

ブレークポイントの有効化/無効化

現在設定している PC ブレークポイントを有効または無効とします。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 343 of 479

High-performance Embedded Workshop V.4.09

17.2.2.617.

デバッグ機能逆アセンブリ表示をリフレッシュする

外部オペレーションが逆アセンブリ表示のメモリを変更する場合、High-performance Embedded Workshopはメ
モリの変更を検知できません。例えば、表示されている範囲のメモリに対して外部フラッシュユーティリィテ
ィを使用してプログラミングしても、逆アセンブリは変更されません。
[逆アセンブリ]領域内（[逆アセンブリモード]または[混合モード]）で右クリックし、ポップアップメニューから[リフレッシュ]を選択してください。
逆アセンブリの最新情報を取得し表示内容を更新します。

17.2.2.7

逆アセンブリ表示のリフレッシュを抑止する

逆アセンブリ表示のメモリ範囲がリフレッシュされないようにロックします。この機能を逆アセンブリのリフ
レッシュ抑止と呼びます。
[逆アセンブリ]領域内（[逆アセンブリモード]または[混合モード]）で右クリックし、ポップアップメニューから[リフレッシュ抑止]を選択してください。[リフレッシュ抑止]ダイアログボックスが開きます。

[ロック]チェックボックスをオンにしてください。他のコントロールが有効になります。
ロックおよびキャッシュする[開始アドレス]および[終了アドレス]を指定し[OK]ボタンをクリックしてください。ロックしたメモリ範囲のみを表示します。

17.2.2.8

特定のアドレスを見る

逆アセンブリウィンドウでプログラムを見ている場合、プログラム内の他の箇所を見たいときがあります。そのような場合、プログラム内のコードをスクロールせずに特定のアドレスにジャンプできます。
[ソース]領域内（[ソースモード]）または[逆アセンブリ]領域内（[逆アセンブリモード]または[混合モード]）
で右クリックし、ポップアップメニューから[表示アドレス設定]を選択します。[アドレス指定]ダイアログボ
ックスが開きます。

[アドレス]エディットボックスにアドレスを指定し、[OK]ボタンをクリックしてください。アドレスは、ラベ
ル名で入力することも可能です。
逆アセンブリ表示を更新して入力したアドレスのコードを表示します。
オーバーロード関数またはクラス名を入力した場合、[関数選択]ダイアログボックスを開くので、関数を選択

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 344 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能してください（機能のサポートはデバッガに依存します）。
逆アセンブリウィンドウが[ソースモード]の場合に、別のソースに関連するが現在開いているソースファイルにないアドレスを入力すると、関連したソースファイルを[ソースモード]で自動的に開きます。ソースに関連しないアドレスを入力した場合、逆アセンブリウィンドウは指定されたアドレスを見るために[逆アセンブリ
モード]に切り替わります。

17.2.2.9

アセンブリ言語コードを編集する

逆アセンブリ領域内（[逆アセンブリモード]または[混合モード]）で編集したい命令をダブルクリックすることによって、アセンブリ言語コードを編集できます。[アセンブル]ダイアログボックスが開きます。

アドレス、オブジェクトコード、およびニーモニックを表示します。[ニーモニック]に新しい命令を入力（または古い命令を編集）します。"Enter"キーを押すと、メモリ内容を新しいオブジェクトコードに書き換えて、次の命令に移ります。[OK]ボタンをクリックすると、メモリ内容を新しい命令コードに書き換えて、ダイアロ
グボックスを閉じます。[キャンセル]ボタンをクリックするか"Esc"キーを押すと、メモリ内容を書き換えずに、ダイアログボックスを閉じます。
注：
アセンブリ言語コードは、現在のメモリ内容から表示しています。メモリ内容を修正すると、[アセンブル]ダ
イアログボックスおよび逆アセンブリ表示では、新しいアセンブリ言語コードを表示します。しかしソース表
示は変更しません。これはソースファイルにアセンブラを含む場合も同じです。

17.2.2.10

逆アセンブリで範囲検索する

逆アセンブリ表示の特定のアドレス範囲でテキスト文字列を検索できます。
[逆アセンブリ]領域内（[逆アセンブリモード]または[混合モード]）で右クリックし、ポップアップメニューから[範囲で検索]を選択してください。[範囲で検索]ダイアログボックスが開きます。

検索する文字列、開始アドレスおよび終了アドレスを指定してください。[OK]ボタンをクリックしてください。
範囲の中で最初にあらわれた該当文字列を選択表示します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 345 of 479

High-performance Embedded Workshop V.4.09

17.2.2.1117.

デバッグ機能逆アセンブリテキストを保存する

特定のアドレス範囲の逆アセンブリ表示内容をテキストに保存できます。
[逆アセンブリ]領域内（[逆アセンブリモード]または[混合モード]）で右クリックし、ポップアップメニューから[テキストファイルに保存]を選択してください。[逆アセンブリテキスト保存]ダイアログボックスが開きます。

保存する開始アドレス、終了アドレス、およびファイル名を指定してください。[OK]ボタンをクリックしてください。

17.2.2.12

逆アセンブリ表示を印刷する

逆アセンブリ表示を印刷するには、ウィンドウがアクティブな場合に[ファイル -> 印刷]または[印刷]ツールバ
ーボタン()を使用するか、または[逆アセンブリ]領域内（[逆アセンブリモード]または[混合モード]）のポッ

プアップメニューにある[印刷]を使用します。[印刷]を選択すると、[逆アセンブリ印刷範囲]ダイアログボック
スが開きます。特定のアドレス範囲の表示内容を印刷できます。

印刷する開始アドレスと終了アドレスを指定してください。[OK]ボタンをクリックすると、標準のプリントフォーマットを選択するダイアログボックスが開きます。ここで、使用するプリンタとページ設定のオプションを選択できます。[印刷]ボタンをクリックしてください。

17.2.3

現在のPC位置を表示する

PC位置を表示するには、[PC位置の表示]ツールバーボタン()をクリックするか、[デバッグ -> PC位置を表示]を選択してください。現在のPCの位置で、エディタウィンドウまたは逆アセンブリウィンドウを開きます。

17.2.4

PC位置の行を強調表示する

エディタウィンドウおよび逆アセンブリウィンドウでは、PCの位置は[S/Wブレークポイント]カラムにアイコンで表示されます。PC位置の行のソースコードおよびアセンブリコードカラムを強調表示する機能があります。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 346 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能PC位置の行を強調表示するには
1.

[基本設定 -> オプション]を選択し、[オプション]ダイアログボックスを開きます。

2.

[エディタ]タブを選択します。

3.

[PCカーソル行のハイライト表示]チェックボックスをオンにします。チェックボックスのデフォルトはオンです。

4.

[OK]ボタンをクリックします。

この行の色は、[表示形式]ダイアログボックスでカスタマイズできます。デフォルトの行の色は、テキスト（前面）が黒色で背景が黄色です。
PC位置の行の色を変更するには
1.

[基本設定 -> 表示の形式]を選択し、[表示形式]ダイアログボックスを開きます。

2.

PC位置の行の色を変更したいアイテムをダイアログボックスの左側のツリーから選択し展開します。

•

エディタウィンドウおよび逆アセンブリウィンドウ（[ソースモード]）の場合は[Source]を選択し拡張する。

•

エディタウィンドウおよび逆アセンブリウィンドウ（[逆アセンブリモード]または[混合モード]）の場
合は[逆アセンブリ]を選択し拡張する。

3.

[PC Line Highlight]カテゴリを選択します。

4.

[カラー]タブの[前面]リストと[背景]リストの選択を変更します。

5.

[OK]ボタンをクリックします。

17.3

メモリを操作する

メモリ内容を操作する方法を説明します。操作の種類としては、色々なフォーマットでのメモリ内容の表示、
メモリブロックのフィル／移動、およびロードモジュールファイルのロード／ベリファイなどがあります。

17.3.1

メモリウィンドウを開く

メモリウィンドウは、連続したメモリ内容をダンプ形式で表示するウィンドウです。
メモリウィンドウを開くには、[表示 -> CPU -> メモリ]を選択するか、[メモリ]ツールバーボタン()をクリックしてください。
メモリウィンドウは、開くときに[表示開始アドレス]ダイアログボックスを表示します。[表示開始アドレス]、[スクロール開始アドレス]、および[スクロール終了アドレス]を指定してください。

[OK]ボタンをクリックするか、'Enter'キーを押すとダイアログボックスは閉じてメモリウィンドウが開きます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 347 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能入力したスクロール開始アドレス、スクロール終了アドレス内でスクロールできます。
ウィンドウの構成•[Label]および[Register]カラムは、デフォルトで表示しません。

•[Label]カラムは、行頭のアドレスに割り付けられているラベル名を表示します。

•[Register]カラムは、行頭のアドレスに割り付けられているレジスタ名を表示します。

•[Data]カラムのヘッダの"+n"は、行頭のアドレスからのオフセット値です。

•[Code]カラムのヘッダにコード名を表示します。

•[Address]または[Label]カラムをダブルクリックすることにより、表示開始アドレスを変更するためのダイアログボックスが開きます。

•[Data]または[Code]カラムをダブルクリックすることにより、クリックしたアドレスのメモリ内容を変更するためのダイアログボックスが開きます。値の編集操作はマクロに記録できます。(「マクロの記録」)•[Address]、[Data]、および[Code]カラムは、インプレース編集により値を変更できます。(「マクロの記録」)

ウィンドウのオプション
ウィンドウ内で右クリックすると、使用可能なオプションをポップアップメニューで表示します。
本ウィンドウは、基本的なオプションをツールバーに割り付けています。
[ツールバー表示]、[ツールバーのカスタマイズ]は、ツールバー内で右クリックしても、ポップアップメニュ
ーを表示します。
ポップアップメニューオプション

ツールバ

マクロ

ーボタン

の記録

機能

設定

任意のアドレスにデータを設定します。

フィル

任意のアドレス領域を一定データで充填します。

コピー

任意のアドレス領域のデータを別領域にコピーします。
任意の 2 つのアドレス領域のデータを比較します。

比較 *1
テスト *1-

任意のアドレス領域をテストします。

テキストファイルに保存-

任意のアドレス領域をテキストファイルに保存しま
す。

検索 *1

-

任意のアドレス領域のデータを検索します。

次を検索 *1-

任意のアドレス領域の次のデータを検索します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 348 of 479

High-performance Embedded Workshop V.4.09

ポップアップメニューオプション

17.

ツールバ

マクロ

ーボタン

の記録

デバッグ機能機能

開始アドレス-

表示開始アドレスを指定します。

スクロール範囲-

スクロール範囲を指定します。

-

指定したレジスタが示すアドレスから表示します。

スタック追従 *1-

スタックポインタ位置を追従します。

スタートアップシンボル-

ダウンロード時に表示するラベル位置を指定します。

最新の情報に更新-

ウィンドウの表示内容を手動で更新します。

-

ウィンドウの表示内容の更新を抑止します。

-

ユーザプログラム実行中、ウィンドウの表示内容を定

レジスタ(xxxxx)

-

*1

表示固定

-

自動更新 *2

期的に更新します。
-

自動更新の間隔を設定します。

1byte

-

1 バイト単位で表示します。

2byte

-

2 バイト単位で表示します。

4byte

-

4 バイト単位で表示します。

8byte

-

8 バイト単位で表示します。

16 進数表示-

16 進数で表示します。

10 進数表示-

10 進数で表示(符号なし)します。

符号付 10 進数表示-

10 進数で表示(符号付き)します。

8 進数表示-8 進数で表示します。

2 進数表示-2 進数で表示します。

表示

ASCII

-

ASCII コードで表示します。

コード

SJIS

-

SJIS コードで表示します。

JIS-

JIS コードで表示します。

UNICODE UTF-8-

UTF-8 コードで表示します。

UTF-16-

UTF-16 コードで表示します。

-

EUC コードで表示します。

Float

-

単精度浮動小数点値で表示します。

Double-

倍精度浮動小数点値で表示します。

Float Complex-

複素数を単精度浮動小数値で表示します。

Double-複素数を倍精度浮動小数点値で表示します。

Float Imaginary-

虚数を単精度浮動小数点値で表示します。

Double-虚数を倍精度浮動小数点値で表示します。

16bit Fixed-

16 ビット固定値で表示します。

32bit Fixed-

32 ビット固定値で表示します。

更新間隔 *2
データ長

基数

EUC
Float

Complex

Complex

Imaginary
Fixed

レイアウト

24 bit Accum--

24 ビット累算値で表示します。

40 bit Accum--

40 ビット累算値で表示します。

ラベル-[Label]カラムの表示/表示なしを切り替えます。

レジスタ

-

レジスタ表示部の表示/表示なしを切り替えます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 349 of 479

High-performance Embedded Workshop V.4.09

ポップアップメニューオプション

17.

ツールバ

マクロ

ーボタン

の記録

コード
カラム
カバレッジ

有効

デバッグ機能機能-

コード表示部の表示/表示なしを切り替えます。

-

表示桁数を指定します。

-

カバレッジ計測結果の表示/表示なしを切り替えます。

*1
保存

任意のアドレス領域のメモリ内容を保存します。

読み込みメモリにファイルをロードします。

分割

-

-

ウィンドウを分割表示します。

ツールバー表示--

ツールバー表示/表示なしを切り替えます。

ツールバーのカスタマイズ--

ツールバーボタンをカスタマイズします。

注：*1. 機能のサポートはデバッガに依存します。
*2. 機能がサポートされている場合のみ表示されます。

任意のアドレスにデータを設定する

17.3.2

メモリウィンドウで任意のアドレスにデータを設定するには以下の方法があります。
•[Data]カラムでインプレース編集します。

•[Code]カラムでインプレース編集します。

•

以下のいずれかの方法で[メモリ設定]ダイアログボックスを開きます。
o[Data]カラムをダブルクリックする。

o[Code]カラムをダブルクリックする。

o変更するデータを選択し、ポップアップメニューの[設定]を選択する。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 350 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能[データ]領域に設定するデータ(値または文字)を入力してください。
[ベリファイ]チェックボックスでメモリベリファイを指定します。ベリファイ機能のサポートはデバッ
ガに依存します。
値を設定する場合[データ形式]グループの[値]ボタンをクリックしてください。[データサイズ]領域にデータ長を指定してください。
文字を設定する場合[データ形式]グループの[文字列]ボタンをクリックしてください。[コード]領域に文字コードを指定してください。

17.3.3

アドレス領域を選択する

メモリアドレス範囲がメモリウィンドウにある場合、最初のメモリユニット(メモリウィンドウディスプレイ
での選択に従い)をクリックして最後のユニットまでマウスをドラッグすることによって領域を選択できます。選択した領域は強調表示します。

17.3.4

任意のアドレス領域を一定データで充填する

メモリウィンドウ上で充填するアドレス領域をドラッグして選択してください。ポップアップメニューから[フィル]を選択して[メモリフィル]ダイアログボックスを開きます。

[フィルデータ]へ充填するデータ(値または文字)を入力してください。
R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 351 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能[ベリファイ]チェックボックスでメモリベリファイを指定します。ベリファイ機能のサポートはデバッガに依存します。
充填するアドレス領域をドラッグしていない場合は、開始アドレス、終了アドレスを入力する必要があります。
終了アドレスには先頭に'+'記号を付けることができ、この記号を入力すると開始アドレス＋入力した値が終了
アドレスになります。
値を設定する場合[データ形式]グループの[値]ボタンをクリックしてください。[データサイズ]領域でデータ長も指定してください。
文字列を設定する場合[データ形式]グループの[文字列]ボタンをクリックしてください。[コード]領域で文字コードも指定してください。
表示データ長が2バイトの場合は、2バイト分の文字が指定できます。
文字列を指定するには、[メモリ設定]ダイアログボックスを使用してください。
[メモリ設定]ダイアログボックスは、ポップアップメニューから[設定]を選択してください。

17.3.5

任意のアドレス領域のデータを別領域にコピーする

メモリウィンドウ上でコピー元アドレス領域をドラッグして選択してください。ポップアップメニューから[コピー]を選択して[メモリコピー]ダイアログボックスを開きます。

[コピー先アドレス]にコピー先の開始アドレスを入力してください。
[ベリファイ]チェックボックスでメモリベリファイを指定します。ベリファイ機能のサポートはデバッガに依存します。
コピー元のアドレス領域をドラッグしていない場合は、コピー元開始アドレス/終了アドレスを入力する必要があります。終了アドレスには先頭に'+'記号を付けることができ、この記号を入力すると開始アドレス＋入力
した値が終了アドレスになります。
ドラッグアンドドロップ
ドロップデータの種類

動作

メモリウィンドウの[Data]カラムの選択範囲

選択範囲のデータ内容を、ドロップ位置からの領域にコピーします。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 352 of 479

High-performance Embedded Workshop V.4.09

17.3.617.

デバッグ機能任意の 2 つのアドレス領域を比較する

メモリウィンドウ上で比較元アドレス領域をドラッグして選択してください。ポップアップメニューから[比較]を選択して[メモリ比較]ダイアログボックスを開きます。

[比較先アドレス]に比較先アドレス、[データサイズ]に比較フォーマットを指定してください。
比較元のアドレス領域をドラッグしていない場合は、比較元開始アドレス/終了アドレスを入力する必要があります。終了アドレスには先頭に'+'記号を付けることができ、この記号を入力すると開始アドレス＋入力した値が終了アドレスになります。
不一致個所があった場合は、そのアドレスをメッセージボックスに表示します。
比較したメモリの内容が一致した場合は、「比較成功」メッセージを表示します。
機能のサポートはデバッガに依存します。

17.3.7

任意のアドレス領域をテストする

メモリウィンドウ上でテストするアドレス領域をドラッグして選択してください。ポップアップメニューから[テスト]を選択して[メモリテスト]ダイアログボックスを開きます。

テストするアドレス領域をドラッグしていない場合は、テスト開始アドレス/終了アドレスを入力する必要があります。
終了アドレスには先頭に'+'記号を付けることができ、この記号を入力すると開始アドレス＋入力した値が終了
アドレスになります。
機能のサポートはデバッガに依存します。
注：
テストはデバッガに依存しますが、すべての場合において、現在のメモリの内容を上書きします。
作成したプログラムまたはデータは、消去されます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 353 of 479

High-performance Embedded Workshop V.4.09

17.3.817.

デバッグ機能

任意のアドレス領域をテキストファイルに保存する

メモリウィンドウ上でテキストファイルに保存するアドレス領域をドラッグして選択してください。ポップア
ップメニューから[テキストファイルに保存]を選択して[メモリ内容保存]ダイアログボックスを開きます。
[メモリ保存領域]で出力範囲、[データ長]でデータ長、[表示桁]で桁数、[基数]で基数、[文字コード]でコードを選択してください。[ラベル表示を出力する]で[Label]カラムの表示/表示なし、[レジスタ表示を出力する]で[Register]カラムを表示/表示なしを切り替えてください。
保存するアドレス領域をドラッグしていない場合は、出力範囲を入力する必要があります。

17.3.9

任意のアドレス領域のデータを検索する

メモリウィンドウ上で検索するアドレス領域をドラッグして選択してください。ポップアップメニューから[検索]を選択して[メモリ検索]ダイアログボックスを開きます。

[検索データ]で検索するデータ値を入力し、[検索データ形式]ドロップダウンリストで検索フォーマットを選択してください。
[検索データ形式]で"pattern"（パターン検索）を選択すると、最大256バイト以内のバイト列（512文字以内）が検索できます。その場合、検索データは1バイトに付き2文字単位で指定してください。
パターン検索以外では検索条件として、データ一致／不一致、検索方向を指定できます。パターン検索はデー
タ一致および順方向のみの検索となります。
検索するアドレス領域をドラッグしていない場合は、検索開始アドレス、終了アドレスを入力する必要があり
R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 354 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能ます。終了アドレスには先頭に'+'記号を付けることができ、この記号を入力すると開始アドレス＋入力した値が終了アドレスになります。
データが見つかると、見つかったデータを強調表示します。データが見つかった状態で、ポップアップメニュ
ーから[次を検索]を選択すると、次のアドレスから検索を続行します。
機能のサポートはデバッガに依存します。

17.3.10

表示開始アドレスを変更する

スクロールバー、Page Up/Page Downキー、上下矢印キーで表示位置を変更してください。
表示アドレスを直接指定するには以下の方法があります。
•[Address]カラムでインプレース編集します。

•

以下のいずれかの方法で[表示開始アドレス]ダイアログボックスを開きます。[アドレス]に表示するアド
レスを指定してください。
o[Address]カラムをダブルクリックする。

oポップアップメニューの[開始アドレス]を選択する。

ドラッグアンドドロップ
操作

動作

メモリウィンドウの Address 領域のアドレスを選択して、 ウィンドウの表示開始アドレスを、そのアドレスに変更し別のメモリウィンドウの[Address]カラムにドロップます。

変数名（テキスト文字列）を選択して、メモリウィンドウ ウィンドウの表示開始アドレスを、その変数のアドレスにの[Address]カラムにドロップ

17.3.11

変更します。

スクロール範囲を変更する

メモリウィンドウのポップアップメニューから[スクロール範囲]を選択してください。[スクロール範囲]ダイ
アログボックスが開きます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 355 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能表示するスクロール範囲を指定してください。
デフォルトのスクロール範囲は、0h〜MCUの最大アドレスです。

17.3.12

指定したレジスタが示すアドレスから表示する

メモリウィンドウのポップアップメニュー[レジスタ]以下でレジスタを選択してください。
機能のサポートはデバッガに依存します。

17.3.13

スタックポインタ位置を追従する

メモリウィンドウは、スタックポインタ位置に追従して表示アドレスを変更する機能を持っています（デフォルトは、スタックポインタ位置を追従しません）。スタックポインタ位置を追従するには、メモリウィンドウのポップアップメニューから[スタック追従]を選択してください。[追従スタックポインタ]ダイアログボック
スが開きます。

ドロップダウンリストで追従するスタックポインタを選択してください。メモリウィンドウは、そのスタック
ポインタ位置を追従して表示アドレスを自動的に変更します。[追従スタックポインタ]ダイアログボックスで[Not Following]を選択するとスタックポインタ位置の追従を終了します。
機能のサポートはデバッガに依存します。

17.3.14

ダウンロード時に表示するラベル位置を変更する

メモリウィンドウのポップアップメニューから[スタートアップシンボル]を選択してください。[スタートアッ
プシンボルの設定]ダイアログボックスが開きます。

ドロップダウンリストで開始シンボルを指定してください。

17.3.15

ウィンドウの表示内容を手動で更新する

メモリウィンドウの内容を強制的に更新できます。
メモリウィンドウのポップアップメニューから[最新の情報に更新]を選択してください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 356 of 479

High-performance Embedded Workshop V.4.09

17.3.1617.

デバッグ機能ウィンドウの表示内容の更新を抑止するプログラムの実行停止時などに、自動的にメモリウィンドウ内容を更新しないようにできます。
メモリウィンドウのポップアップメニューから[表示固定]を選択してください。表示内容の更新を抑止しているときは、メモリウィンドウの内容をグレーで表示します。
メモリウィンドウの[自動更新]機能は、この機能と同時に指定できません。

17.3.17

ウィンドウの表示内容を定期的に更新する

メモリウィンドウのポップアップメニューから[自動更新]を選択すると、ユーザプログラム実行中にメモリウ
ィンドウの表示内容を定期的に更新します。
ユーザプログラム実行中、実際の更新間隔をメモリウィンドウのヘッダの左端のカラムに表示します。
機能のサポートはデバッガに依存します。

ユーザプログラム実行中の自動更新間隔を設定するには、メモリウィンドウのポップアップメニューから[更新間隔]を選択します。機能がサポートされている場合のみ表示されます。
メモリウィンドウの[表示固定]機能は、この機能と同時に指定できません。

17.3.18

更新間隔を設定する

メモリウィンドウの表示内容をユーザプログラム実行中に自動的に更新する間隔を設定できます。
機能のサポートはデバッガに依存します。
更新間隔を設定するには
1.

ウィンドウ内で右クリックしポップアップメニューを表示します。

2.

[更新間隔]を選択します。[自動更新間隔設定]ダイアログボックスが開きます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 357 of 479

High-performance Embedded Workshop V.4.09

3.

17.

デバッグ機能

更新間隔を10ms単位で入力します。更新間隔のデフォルト値、および更新間隔の指定可能範囲は、デバッガに依存します。

4.

[OK]ボタンをクリックします。

更新間隔は、各メモリウィンドウで個別に指定できます。
メモリウィンドウの[自動更新]機能を有効にすると、ユーザプログラム実行中、実際の更新間隔をメモリウィ
ンドウのヘッダの左端のカラムに表示します。
ユーザプログラム実行時の状態によっては、実際の更新間隔が設定した値よりも大きくなることがあります。

17.3.19

表示データ長を変更する

メモリウィンドウのポップアップメニュー[データ長]以下で表示バイト長を指定してください。
以下のいずれかが選択できます。
[1byte]1バイト単位表示（デフォルト）[2byte]2バイト単位表示[4byte]4バイト単位表示[8byte]8バイト単位表示

17.3.20

表示基数を変更する

メモリウィンドウのポップアップメニュー[基数]以下で表示基数を指定してください。
以下のいずれかが選択できます。
[16進数表示]16進数で表示（デフォルト）[10進数表示]10進数で表示（符号なし）[符号付10進数表示]

10進数で表示（符号付き）[8進数表示]8進数で表示[2進数表示]2進数で表示17.3.21

表示コードを変更する

メモリウィンドウのポップアップメニュー[表示コード]以下で表示コードを指定してください。
以下のいずれかが選択できます。
[ASCII][SJIS][JIS][UNICODE][UTF-8][UTF-16][EUC][Float][Float][Double][Float Complex][Complex][Double Complex][Float Imaginary][Double Imaginary][Fixed][16 bit Fixed][32 bit Fixed]

R20UT0372JJ0100 Rev.1.00
2011.02.01

ASCIIコードで表示（デフォルト）
SJISコードで表示
JISコードで表示
UTF-8コードで表示
UTF-16コードで表示
EUCコードで表示
単精度浮動小数点値で表示
倍精度浮動小数点値で表示複素数を単精度浮動小数点値で表示
複素数を倍精度浮動小数点値で表示
虚数を単精度浮動小数点値で表示
虚数を倍精度浮動小数点値で表示
16ビット固定値で表示32ビット固定値で表示
Page 358 of 479

High-performance Embedded Workshop V.4.09[24 bit Accum][40 bit Accum]

17.3.2217.

デバッグ機能24ビット累算値で表示
40ビット累算値で表示

レイアウトを設定する

メモリウィンドウのポップアップメニュー[レイアウト]以下で表示するレイアウトを設定してください。以下を選択できます。
[ラベル][Label]カラムの表示/表示なしの切り替え[レジスタ][Register]カラムの表示/表示なしの切り替え[コード][Code]カラムの表示/表示なしの切り替え

表示している場合はオプションにチェックマークが付いています。
[Label]、[Register]、および[Code]カラムを表示しない場合:

17.3.23

表示桁数を変更する

メモリウィンドウのポップアップメニューから[カラム]を選択すると、[データ表示桁]ダイアログボックスが開きます。

表示桁数を指定してください（1〜256）。

17.3.24

カバレッジ計測結果の表示/表示なしを切り替える

メモリウィンドウは、カバレッジ計測表示がデフォルトで無効になっています。
有効にするには、メモリウィンドウのポップアップメニュー[カバレッジ]以下の[有効]を選択してください。
カバレッジ計測時、コード実行部分のデフォルトの色は、前面が黒色で背景が水色です。コード未実行部分のデフォルトの色は、前面が黒色で背景がグレーです。
カバレッジ計測時のコード実行部分および未実行部分の色は、[表示形式]ダイアログボックスでカスタマイズできます。詳細は、「17.3.29 既存の色をカスタマイズする」を参照してください。

機能のサポートはデバッガに依存します。
R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 359 of 479

High-performance Embedded Workshop V.4.09

17.3.2517.

デバッグ機能

任意のアドレス領域を保存する

メモリウィンドウ上で保存するアドレス領域をドラッグして選択してください。ポップアップメニューから[保存]を選択して[名前を付けて保存(メモリ)]ダイアログボックスを開きます（[デバッグ -> メモリの保存]を選択して表示することもできます）。

保存するアドレス領域をドラッグしていない場合は、保存開始アドレス/終了アドレスを入力する必要があります。終了アドレスには先頭に'+'記号を付けることができ、この記号を入力すると開始アドレス＋入力した値が終了アドレスになります。
[ファイルフォーマット]にファイルフォーマット、[ファイル名]にファイル名、[アクセスサイズ]にアクセスサ
イズを入力します。[ファイル名]には、メモリを保存するために使用した過去4ファイルのファイル名を表示します。また[...]ボタンをクリックすると、標準の[名前を付けて保存]ダイアログボックスが開きます。[アクセスサイズ]から、保存時のアクセスサイズを選択できます。保存するメモリがリトルエンディアンの時は、アクセスサイズによってデータの並びが異なります。
ファイルの保存が完了すると、確認のメッセージボックスを表示する場合があります。

17.3.26

メモリにファイルをロードする

デバッガのメモリにファイルをロードできます。メモリウィンドウのボップアップメニューから[読み込み]を選択して、[ダウンロードプログラム]ダイアログボックスを開きます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 360 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能[ファイルフォーマット]にファイルフォーマット、[ファイル名]にファイル名、[オフセット]にオフセット値、[アクセスサイズ]にアクセスサイズ、[ダウンロード時のメモリベリファイ]でメモリベリファイを指定します。
[オフセット]には、ロードアドレス値を変更するときはオフセット値、変更しないときは0を指定します。

17.3.27

ウィンドウを分割表示する

メモリウィンドウを上下 2分割で表示したいときは、ポップアップメニューから[分割]を選択後、分割バーを移動して分割します。ポップアップメニューから[分割]を選択すると分割表示を解除します。

17.3.28

アドレス領域を検証する

メモリとファイル内容をベリファイします。[デバッグ -> メモリのベリファイ]を選択して[メモリのベリファイ]ダイアログボックスを開きます。

[ファイルフォーマット]にファイルフォーマット、[ファイル名]にファイル名、[オフセット]にオフセット、[アクセスサイズ]にアクセスサイズを指定します。
ベリファイが成功した場合は、「File verified OK」メッセージを表示します。
ベリファイの不一致個所があった場合は、「Verify failed」メッセージを表示します。
機能のサポートはデバッガに依存します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 361 of 479

High-performance Embedded Workshop V.4.09

17.3.2917.

デバッグ機能テキストの色を変更する

メモリウィンドウはデータおよびコードを表示しているテキストの色およびフォントを他のウィンドウと同じように[表示形式]ダイアログボックスでカスタマイズできます（下表のカテゴリの"通常"）。
さらに、メモリウィンドウのデータおよびコードカラムで、メモリアクセスおよびメモリの値が変更された部分の色を、[表示形式]ダイアログボックスでカスタマイズできます。
既存の色をカスタマイズするには
1.

[基本設定 -> 表示の形式]を選択し、[表示形式]ダイアログボックスを開きます。

2.

[メモリ]アイテムをダイアログボックスの左側のツリーから選択し展開します。

3.

色を変更したいカテゴリを選択します。以下の表に示すカテゴリが選択できます。
カテゴリ

カスタマイズ対象

カラータブの前面の色 カラータブの背景の色(デフォルト)(デフォルト)

通常

テキスト

黒

白

アクセス履歴あり *カバレッジ計測：コード実行部分

黒水色

アクセス履歴なし *カバレッジ計測：コード未実行部分

黒グレー

カバレッジ計測領域外 *カバレッジ計測：領域外

黒白

メモリ領域外 *メモリ領域外

グレー

グレー

変更

値が変更された部分

赤

白

注：*. 機能のサポートはデバッガに依存します。
4.

[カラー]タブの[前面]リストと[背景]リストの選択を変更します。

5.

[OK]ボタンをクリックします。

17.4

メモリ内容を画像形式で表示する

画像ウィンドウを使用すると、メモリ内容を画像形式で表示できます。
機能のサポートはデバッガに依存します。

17.4.1

画像ウィンドウを開く[表示 -> グラフィック -> 画像]を選択するか、[画像]ツールバーボタン()をクリックすると、[画像プロパテ

ィ]ダイアログボックスが開きます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 362 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能[画像プロパティ]ダイアログボックスでは画像ウィンドウの表示方法を指定します。
[色情報]表示する画像のカラー情報を指定します。
[モード]

フォーマットを指定します。
[モノクロ] 白黒で表現します。

[ビット/ピクセル][RGB]

R(赤)、G(緑)、B(青)で表現します。

[BGR]

B(青)、G(緑)、R(赤)で表現します。

[YCbCr]Y(輝度)、Cb(青色の色差)、Cr(赤色の色差)で表現します。

選択した[モード]によって、ビット/ピクセルを指定します（RGB/BGR選択時有効）。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 363 of 479

High-performance Embedded Workshop V.4.09[サンプリング]

デバッグ機能17.

サンプリングのフォーマットを指定します（YCbCr選択時有効）。
サンプリング例を以下に示します。
サンプリング

元のデータ

比率
4:4:4

サンプリング

画像(4*4 ピクセル)

データ

のデータ量

11,12,13,14

11,12,13,14

21,22,23,24

21,22,23,24

31,32,33,34

31,32,33,34

41,42,43,44

41,42,43,44

4:2:2

11,11,13,13

16 バイト8 バイト

21,21,23,23
31,31,33,33
41,41,43,43
4:1:1

11,11,13,13

4 バイト

11,11,13,13
31,31,33,33
31,31,33,33
11,11,11,11

4:2:0

4 バイト

21,21,21,21
31,31,31,31
41,41,41,41[フォーマット]

点順次/面順次を指定します（YCbCr選択時有効）。
フォーマット

各データの順序

点順次(4:2:0選択時無効) Y,Cb,Cr,Y,Cb,Cr,Y,Cb,Cr,...,Y,Cb,Cr[バッファ情報]

面順次

Y,Y,Y,...,Y,Cb,Cb,Cb,...,Cb,Cr,Cr,Cr,...,Cr

面順次2

Y,Y,Y,...,Y,Cb,Cr,Cb,Cr,Cb,Cr,...,Cb,Cr

データの格納場所、サイズ、パレットのアドレスを指定します。
[データアドレス]表示する画像データのメモリ開始アドレスを指定します（16進数表
示）。

[パレットアドレス]

カラーパレットデータのメモリ開始アドレスを指定します（16進数表示。RGB/BGRの8ビット選択時有効）。

[幅/高さ情報(ピクセル)] 画像の幅と高さを指定します。
[幅]

画像の幅を指定します（接頭辞省略時は10進数で入力、10進数で表示）。

[高さ]

画像の高さを指定します（接頭辞省略時
は10進数で入力、10進数で表示）。

[バッファサイズ(16進)] 幅と高さから画像のバッファサイズを表示します（16進数表示）。
[連続表示の有効]連続表示が有効になります。

[イメージ情報]

連続表示するフレーム数を指定します。

R20UT0372JJ0100 Rev.1.00
2011.02.01[フレーム数]

フレーム数を指定します。

[全バッファサイズ

幅と高さとフレーム数から画像のバッフ(16進)]

ァサイズを表示します（16進数表示）。

Page 364 of 479

High-performance Embedded Workshop V.4.09[表示情報]

17.

デバッグ機能画像全体中の表示部分の位置、サイズ、データ開始位置を指定します（16進数表示。RGB/BGRの8ビット選択時有効）。
[表示モード][開始位置][座標]

画像の全体表示/部分表示を指定します。
[全面表示]

画像を全体表示します。

[部分表示]

画像を部分表示します。

データの表示開始位置を指定します。
[上部]

左上からデータを表示します。

[下部]

左下からデータを表示します。

部分表示する画像の開始位置を指定します（[部分表示]選択時有効）。
[X 座標]

開始位置のX 座標を指定します（接頭辞省略時は10進数で入力、10進数で表示）。

[Y 座標]

開始位置のY 座標を指定します（接頭辞省略時は10進数で入力、10進数で表示）。

[幅/高さ情報(ピクセル)] 部分表示する画像の幅と高さを指定します。
[幅]

表示の幅を指定します（接頭辞省略時は10進数で入力、10進数で表示）。

[高さ]

表示の高さを指定します（接頭辞省略時
は10進数で入力、10進数で表示）。

[画像プロパティ]ダイアログボックスに設定後、[OK]ボタンをクリックすると画像ウィンドウが開きます。
画像ウィンドウ表示後もポップアップメニューの[プロパティ]を選択することで本ダイアログボックスを表示
し、表示内容を変更できます。
メモリの内容を画像で表示します。

•

ウィンドウ内でダブルクリックすると、マウスポインタの位置のピクセル情報を[ピクセル情報]ダイ
アログボックスに表示します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 365 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能ウィンドウのオプション
ウィンドウ内で右クリックすると、使用可能なオプションをポップアップメニューで表示します。
本ウィンドウは、基本的なオプションをツールバーに割り付けています。
[ツールバー表示]、[ツールバーのカスタマイズ]は、ツールバー内で右クリックしても、ポップアップメニュ
ーを表示します。
ポップアップメニューオプション
自動更新

ツールバーボタン

マクロの記録

機能

更新しない

-

ウィンドウの表示内容を自動更新しません。

停止-

ユーザプログラム実行停止時にウィンドウ内容を更新します。

リアルタイム-ユーザプログラム実行中、ウィンドウの表示内
容を定期的に更新します。

更新-

ウィンドウを更新します。

更新間隔 *-

自動更新間隔を設定します。

次の画像

-

次の画像を表示します。

前の画像

-

前の画像を表示します。

先頭の画像

-

先頭の画像を表示します。

最後の画像

-

最後の画像を表示します。

連続表示の

0.5 秒

-

0.5 秒間隔で画像を連続表示します。

更新間隔

1.0 秒

-

1.0 秒間隔で画像を連続表示します。

2.0 秒

-

2.0 秒間隔で画像を連続表示します。

4.0 秒

-

4.0 秒間隔で画像を連続表示します。

画像の連続表示-

画像を連続表示します。

連続表示の停止-

連続表示を停止します。

プロパティ

-

[画像プロパティ]ダイアログボックスを開きます。

ツールバー表示--

ツールバー表示/表示なしを切り替えます。

ツールバーのカスタマイズ--

ツールバーボタンをカスタマイズします。

注：*. 機能がサポートされている場合のみ表示されます。

17.4.2ウィンドウの表示内容を定期的に更新する

ポップアップメニューから[自動更新 -> 更新しない]を選択すると、ウィンドウの表示内容を自動更新しません。
ポップアップメニューから[自動更新 -> 停止]を選択すると、ユーザプログラム実行停止時にウィンドウの表
示内容を更新します。
ポップアップメニューから[自動更新 -> リアルタイム]を選択すると、ユーザプログラム実行中にウィンドウの表示内容を定期的に更新します。
ユーザプログラム実行中の自動更新間隔を設定するには、ポップアップメニューから[更新間隔]を選択します。
機能がサポートされている場合のみ表示されます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 366 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能ウィンドウの表示内容を手動で更新する

17.4.3

画像ウィンドウのポップアップメニューから[更新]を選択すると、直ちにウィンドウの表示内容を更新します。

更新間隔を設定する

17.4.4

画像ウィンドウの表示内容をユーザプログラム実行中に自動的に更新する間隔を設定できます。
機能のサポートはデバッガに依存します。
更新間隔を設定するには
1.

ウィンドウ内で右クリックしポップアップメニューを表示します。

2.

[更新間隔]を選択します。[更新間隔]ダイアログボックスが開きます。

3.

更新間隔を10ms単位で入力します。更新間隔は10〜10000msの範囲で指定できます。デフォルト値は1000msです。

4.

[OK]ボタンをクリックします。

指定した更新間隔は、画像ウィンドウ間で共通に使用します。
プログラム実行時の状態によっては、実際の更新間隔が設定した値よりも大きくなることがあります。

連続フレームで画像を見る

17.4.5

画像ウィンドウは、フレームの操作により複数の画像の切り替え表示ができます。この機能により、複数の画像に各々アドレスを設定する必要がなく画像を参照できます。
同じサイズのフレームとして画像を連続したアドレスのメモリに読み込んでおくと、フレームを順番に切り替えることにより画像を参照できます。
連続したフレームで複数の画像を表示する機能を有効にするには1.

以下のいずれかの操作を選択し[画像プロパティ]ダイアログボックスを開きます。

•

現在画像ウィンドウを開いている場合は、ポップアップメニューから[プロパティ]を選択する。

•

新しく画像ウィンドウを開く場合は、[表示 -> グラフィック -> 画像]を選択するか、[画像]ツールバ
ーボタン()をクリックする。

2.

[画像プロパティ]ダイアログボックスで[連続表示の有効]チェックボックスをオンにします。

3.

[フレーム数]エディットボックスに画像を連続表示するフレームの数（2フレーム以上）を入力します。

4.

OKボタンをクリックします。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 367 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能この機能を有効にすると、画像のフレームを手動または定期的に切り替えて参照できます。

17.4.5.1

画像のフレームを手動で切り替える

連続したフレームで複数の画像を表示する機能が有効の場合、以下に示すウィンドウのポップアップメニュー
オプション、またはウィンドウのツールバーボタンにより、画像のフレームを手動で切り替えることができます。
ポップアップメニューオプション

ツールバーボタン機能

次の画像

次の画像を表示します。

前の画像

前の画像を表示します。

先頭の画像

先頭の画像を表示します。

最後の画像

最後の画像を表示します。

現在表示しているフレームの位置により、ウィンドウのポップアップメニューオプション、またはウィンドウのツールバーボタンのアクティブ状態は異なります。
画像のフレームを手動で切り替えるには[次の画像]をクリックすると、次の画像のフレームへ切り替えます。例えば、連続した3フレーム分の画像を参照する場合は以下のように操作します。

1.

[次の画像]ツールバーボタンをクリックすると、2フレーム目の画像を表示します。

2.

[次の画像]ツールバーボタンをクリックすると、3フレーム目の画像を表示します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 368 of 479

High-performance Embedded Workshop V.4.09

17.4.5.217.

デバッグ機能画像のフレームを定期的に切り替える

連続したフレームで複数の画像を表示する機能が有効の場合、以下に示すウィンドウのポップアップメニュー
オプション、またはウィンドウのツールバーボタンにより、画像のフレームを定期的に切り替えることができます。
ポップアップメニューオプション
連続表示の更新間隔 *ツールバーボタン

機能

0.5 秒

0.5 秒間隔で画像を連続表示します。

1.0 秒

1.0 秒間隔で画像を連続表示します。

2.0 秒

2.0 秒間隔で画像を連続表示します。

4.0 秒

4.0 秒間隔で画像を連続表示します。

画像の連続表示

画像を連続表示します。

連続表示の停止

連続表示を停止します。

注：*. 使用するデバッガまたは画像サイズにより更新間隔時間内に表示を更新できないことがあります。
現在表示しているフレームの位置により、ウィンドウのポップアップメニューオプション、またはウィンドウのツールバーボタンのアクティブ状態は異なります。
画像のフレームを定期的に切り替えるには[画像の連続表示]を使用すると、画像のフレームを定期的に切り替えます。例えば、連続した3フレーム分の画像を参照する場合は以下のように操作します。
1.

1フレーム目の画像で、[連続表示の更新間隔]ドロップダウンリストから画像の表示更新間隔を選択
し、[画像の連続表示]ツールバーボタンをクリックします。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 369 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能2.

選択した時間が経過すると、自動的に2フレーム目の画像を表示します。

3.

選択した時間が経過すると、自動的に3フレーム目の画像を表示します。画像の連続表示が終了します。

17.4.6

ピクセル情報を表示する

ウィンドウ内でダブルクリックするとマウスポインタの位置のピクセル情報を[ピクセル情報]ダイアログボッ
クスに表示します。

カーソル位置のピクセル情報を表示します。
[カラーモード]

画像のフォーマットを表示します。

[ピクセル]

カーソル位置のカラー情報を表示します（10進数表示）。

[位置]

カーソル位置をX座標、Y座標で表示します（10進数表示）。
[X]

カーソル位置のX座標を表示します。

[Y]

カーソル位置のY座標を表示します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 370 of 479

High-performance Embedded Workshop V.4.09[バッファサイズ]

デバッグ機能バッファサイズを表示します（10進数表示）。
[幅]

バッファの幅を表示します。

[高さ]バッファの高さを表示します。

表示の幅と高さを表示します（10進数表示）。

[画像サイズ]

17.5

17.

[幅]

幅を表示します。

[高さ]

高さを表示します。

メモリ内容を波形形式で表示する

波形ウィンドウを使用すると、メモリ内容を波形形式で表示します。
機能のサポートはデバッガに依存します。

17.5.1

波形ウィンドウを開く[表示 -> グラフィック -> 波形]を選択するか、[波形]ツールバーボタン()をクリックすると、[波形プロパ

ティ]ダイアログボックスが開きます。

表示する波形形式を指定します。下記項目を指定できます。
[データアドレス]

データのメモリ開始アドレスを指定します（16進数表示）。

[データサイズ]

8ビット/16ビットを指定します。

[チャンネル]

モノラル/ステレオを指定します。

[バッファサイズ(16進)]

データのバッファサイズを指定します（16進数表示）。

[波形プロパティ]ダイアログボックスに設定後、[OK]ボタンをクリックすると波形ウィンドウが開きます。
波形ウィンドウ表示後もポップアップメニューの[プロパティ]を選択することで[波形プロパティ]ダイアログ
ボックスを開き表示内容を変更できます。
メモリ内容を波形で表示します。横軸(X)にサンプリングデータ数、縦軸(Y)にサンプリング値を表示します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 371 of 479

High-performance Embedded Workshop V.4.09•

17.

デバッグ機能グラフ内でサンプリング情報を表示したい座標をダブルクリックすると、[サンプリング情報]ダイア
ログボックスが開きます。

ウィンドウのオプション
ウィンドウ内で右クリックすると、使用可能なオプションをポップアップメニューで表示します。
ポップアップメニューオプション
自動更新

マクロの記録

機能

更新しない

-

ウィンドウ内容を自動更新しません。

停止-

ユーザプログラム実行停止時にウィンドウ内容を更新します。

リアルタイム-ユーザプログラム実行中、ウィンドウの表示内容を定期的に更新し
ます。

更新

-

ウィンドウを更新します。

更新間隔 *-

自動更新間隔を設定します。

伸張-

拡大表示します。

圧縮-

縮小表示します。

元に戻す-

最初のサイズに戻します。

X2-

拡大/縮小倍率を 2 倍に設定します。

X4-

拡大/縮小倍率を 4 倍に設定します。

X8-

拡大/縮小倍率を 8 倍に設定します。

128-

横軸のサイズを 128 ピクセルに設定します。

256-

横軸のサイズを 256 ピクセルに設定します。

512-

横軸のサイズを 512 ピクセルに設定します。

カーソル削除-カーソルを非表示にします。

サンプリング情報-

サンプリング情報を表示します。

プロパティ

-

[波形プロパティ]ダイアログボックスを開きます。

圧縮・伸張倍率

スケール

注：*. 機能がサポートされている場合のみ表示されます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 372 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能ウィンドウの表示内容を定期的に更新する

17.5.2

ポップアップメニューから[自動更新 -> 更新しない]を選択すると、ウィンドウの表示内容を自動更新しません。
ポップアップメニューから[自動更新 -> 停止]を選択すると、ユーザプログラム実行停止時にウィンドウの表
示内容を更新します。
ポップアップメニューから[自動更新 -> リアルタイム]を選択すると、ユーザプログラム実行中にウィンドウの表示内容を定期的に更新します。
ユーザプログラム実行中の自動更新間隔を設定するには、ポップアップメニューから[更新間隔]を選択します。
機能がサポートされている場合のみ表示されます。

ウィンドウの表示内容を手動で更新する

17.5.3波形ウィンドウのポップアップメニューから[更新]を選択すると、直ちにウィンドウの表示内容を更新します。

更新間隔を設定する

17.5.4

波形ウィンドウの表示内容をユーザプログラム実行中に自動的に更新する間隔を設定できます。
機能のサポートはデバッガに依存します。
更新間隔を設定するには
1.

ウィンドウ内で右クリックしポップアップメニューを表示します。

2.

[更新間隔]を選択します。[更新間隔]ダイアログボックスが開きます。

3.

更新間隔を10ms単位で入力します。更新間隔は10〜10000msの範囲で指定できます。デフォルト値は1000msです。

4.

[OK]ボタンをクリックします。

指定した更新間隔は、波形ウィンドウ間で共通に使用します。
プログラム実行時の状態によっては、実際の更新間隔が設定した値よりも大きくなることがあります。

17.5.5

拡大表示する

ポップアップメニューから[伸張]を選択すると、横軸を拡大して表示します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 373 of 479

High-performance Embedded Workshop V.4.09

17.5.617.

デバッグ機能縮小表示する

ポップアップメニューから[圧縮]を選択すると、横軸を縮小して表示します。

17.5.7

最初のサイズに戻す

ポップアップメニューから[元に戻す]を選択すると、最初のサイズに戻して表示します。

17.5.8拡大/縮小倍率を設定する

ポップアップメニューの[圧縮・伸張倍率]サブメニューで拡大/縮小倍率を2、4、または8倍から選択します。

17.5.9横軸のサイズを設定する

ポップアップメニューの[スケール]サブメニューで横軸のサイズを128、256、または512ピクセルから選択します。

17.5.10

カーソルを非表示にする

ポップアップメニューの[カーソル削除]をチェックすると、カーソルを非表示にします。

17.5.11

サンプリング情報を表示する

グラフ内でクリックするとカーソル（緑色の縦線）が表示されます。カーソルは右矢印キーおよび左矢印キー
で左右に移動できます。ウィンドウ内で右クリックし、ポップアップメニューから[サンプリング情報]を選択すると、[サンプリング情報]ダイアログボックスが開きます。
また、グラフ内でサンプリング情報を表示したい座標をダブルクリックすると、[サンプリング情報]ダイアロ
グボックスが開きます。

波形ウィンドウのカーソル位置のサンプリング情報を表示します。下記情報を表示します。
[データサイズ]

8ビット/16ビットを表示します。

[チャンネル]

データのチャンネルを表示します。

[データ値][X]

カーソル位置のX座標を表示します。

[Y]

カーソル位置のY座標を表示します（ステレオ選択時は上下2つのY座標を表示します）。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 374 of 479

High-performance Embedded Workshop V.4.09

17.6

17.

デバッグ機能I/Oレジスタを見る

CPUおよびROM/RAMと同様、マイクロコントローラには内蔵周辺モジュールがあります。デバイスによって周辺モジュールの数および型は異なりますが、代表的なモジュールとしては、DMAコントローラ、シリアル
コミュニケーションインタフェース、A/Dコンバータ、インテグレーテッドタイマユニット、バスステートコ
ントローラおよびウォッチドッグタイマなどがあります。マイクロコントローラのアドレス空間にマッピング
したアクセスレジスタは、内蔵周辺モジュールを制御します。
組み込みマイクロコントローラアプリケーションでは、内蔵周辺レジスタを使用した設定が重要であるため、これらのレジスタの内容を見やすく表示しています。
メモリウィンドウは、連続したメモリアドレスのデータをバイト、ワード、ロングワード、単精度浮動小数点、倍精度浮動小数点、またはASCII値として表示できます。これに対しI/Oレジスタは、非連続なメモリアドレスに異なるサイズでレジスタが割り付いているので、High-performance Embedded Workshopはこれらのレジスタを簡単に確認したり設定したりできるように[IO]ウィンドウを提供します。

17.6.1

IOウィンドウを開く[IO]ウィンドウを開くには、[表示 -> CPU -> IO]を選択するか、[IOの表示]ツールバーボタン()をクリックします。内蔵周辺と一致するモジュールがI/Oレジスタ情報を構成します。
[IO]ウィンドウには、2つのタブ（[All Register]および[Selected Register]）があります。[IO]ウィンドウを最初に開くと、[All Register]タブにモジュール名の一覧のみを表示します。
ウィンドウの構成

タブ

説明[All Register]

すべてのI/Oレジスタを表示します。

[Selected Register]

選択したI/Oレジスタを表示します。デフォルトでは、I/Oレジスタを表示しません。

•

I/Oレジスタの表示を展開できます。

•

I/Oレジスタの値に更新があった場合、該当行のテキストを赤色で表示します。

•

I/Oレジスタまたはビット表示行をダブルクリックすると、値を設定するダイアログボックスが開きま

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 375 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能す。値の編集によりマクロを記録します。(「マクロの記録」)•[Value]カラムでは、インプレース編集によりI/Oレジスタまたはビットの値を設定できます。(「マクロの記録」)

ウィンドウのオプション
ウィンドウ内で右クリックすると、使用可能なオプションをポップアップメニューで表示します。
本ウィンドウは、基本的なオプションをツールバーに割り付けています。
[ツールバー表示]、[ツールバーのカスタマイズ]は、ツールバー内で右クリックしても、ポップアップメニュ
ーを表示します。
ポップアップメニューオプション

ツールバーボタン

マクロの記録機能

最新の情報に更新-

ウィンドウの表示内容を手動で更新します。

表示固定

-

ウィンドウの表示内容の更新を抑止します。

IO ファイルのロード-[IO]ウィンドウに表示する制御レジスタの情報
を I/O ファイルからロードします。

Selected Register タブに追加 *-選択した I/O レジスタを[Selected Register]タブに追加します。

I/O レジスタの選択-[Selected Register]タブに表示する I/O レジス
タを選択します。

印刷-

現在の表示内容を印刷します。

ファイルに保存-

現在の表示内容をテキストファイルに保存し
ます。

検索

-

I/O レジスタを検索します。

次を検索

-

検索条件に一致する次の I/O レジスタを検索します。

ツールバー表示--

ツールバー表示/表示なしを切り替えます。

ツールバーのカスタマイズ--

ツールバーボタンをカスタマイズします。

注：*. [All Register]タブを開いている場合のみ有効です。

17.6.2

I/Oレジスタ表示を展開する

I/Oレジスタの名前、アドレス、および値を表示するには、モジュール名の左側にあるプラス(+)の展開記号をクリックするか、クリックまたはカーソルを使用することによってモジュール名を選択し、'→'キーを押します。モジュールの表示が展開され、その周辺モジュールのそれぞれのレジスタおよびその名前、アドレス、および値を表示します（プラス記号がマイナス記号に変わります）。マイナス記号(-)の展開記号をクリックする（または'←'キーを押す）と、表示しているI/Oレジスタを閉じます。
ビットレベルで表示するには、同様にI/Oレジスタを展開します。
注：
エミュレータデバッガを使用している場合は、I/Oレジスタからのリードがユーザプログラムの動作に影響することがあります。例えば、データレジスタのリードで割り込みをキャンセルできる場合があります。[IO]ウィンドウでI/Oモジュールを展開するとレジスタ値を表示するためにデータをリードします。I/Oモジュールを閉じている場合は、データをリードしないためユーザプログラムの動作に影響しません。また、メモリウィン
ドウ(または、逆アセンブリウィンドウ)でI/O領域を開くと同じ影響があることに注意してください。
R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 376 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能[IO]ウィンドウの[表示固定]機能を使用すると、I/Oレジスタ表示を展開している場合もデータをリードしません。

17.6.3

I/Oレジスタの内容を設定する[IO]ウィンドウでI/Oレジスタの内容を設定します。
I/Oレジスタの内容を設定するには[IO]ウィンドウでI/Oレジスタの内容を設定するには、次の方法があります。
•[Value]カラムでインプレース編集します。

•

変更するI/Oレジスタまたはビット表示行をダブルクリックし、I/Oレジスタ値を編集するダイアログボッ
クスを開きます。[変更値]に値を入力してください。

17.6.4ウィンドウの表示内容を手動で更新する[IO]ウィンドウの表示内容を強制的に更新できます。
[IO]ウィンドウのポップアップメニューから[最新情報に更新]を選択してください。

17.6.5ウィンドウの表示内容の更新を抑止する

ユーザプログラムの実行停止時などに、自動的に[IO]ウィンドウの表示内容を更新しないようにできます。
[IO]ウィンドウのポップアップメニューから[表示固定]を選択してください。
[IO]ウィンドウの内容をグレーで表示します。ただし、値が変更されたI/Oレジスタのテキストの色は変更しま
せん。
この機能が有効な場合、[IO]ウィンドウの[All Register]および[Selected Register]タブに表示しているI/Oレジスタの展開状態は変更できません。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 377 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能表示するI/Oレジスタを選択する

17.6.6[IO]ウィンドウの[Selected Register]タブに表示するI/Oレジスタを選択します。
表示するI/Oレジスタを選択するには•[All Register]タブ
単一のI/Oレジスタを[Selected Register]タブに追加する場合
1.

ウィンドウ内でI/Oレジスタを選択して右クリックし、ポップアップメニューから[Selected Register
タブに追加]を選択します。

複数のI/Oレジスタを一括して[Selected Register]タブに追加する場合
1.

ウィンドウ内で右クリックし、ポップアップメニューから[I/Oレジスタの選択]を選択します。
[I/Oレジスタの選択]ダイアログボックスが開きます。以下の図は、SH-4シミュレータデバッガを使用している場合の[I/Oレジスタの選択]ダイアログボックスです。
[I/Oレジスタ一覧]の各項目にはチェックボックスがあります。
'+'が表示されている項目は、'+'のクリックによって展開できます。また、'-'が表示されている項目
は、'-'のクリックによって折りたたむことができます。
'+'または'-'が表示されている項目のチェックボックスをオンにすると、その項目の要素のチェック
ボックスはすべてオンになります。オフにすると、その項目の要素のチェックボックスはすべてオフになります。
[すべて選択]ボタンをクリックすると、すべてのチェックボックスがオンになります。[すべて非選択]ボタンをクリックすると、すべてのチェックボックスがオフになります。

2.

表示したいI/Oレジスタのチェックボックスをオンにします。

3.

OKをクリックすると、[I/Oレジスタの選択]ダイアログボックスを閉じます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 378 of 479

High-performance Embedded Workshop V.4.09•

17.

デバッグ機能[Selected Register]タブ
1.

ウィンドウ内で右クリックし、ポップアップメニューから[I/Oレジスタの選択]を選択します。
[I/Oレジスタの選択]ダイアログボックスが開きます。
[I/Oレジスタ一覧]の各項目にはチェックボックスがあり、デフォルトでオフです。

2.

表示したいI/Oレジスタのチェックボックスをオンにします。

3.

OKをクリックすると、[I/Oレジスタの選択]ダイアログボックスを閉じます。

選択したI/Oレジスタを[IO]ウィンドウの[Selected Register]タブに表示します。

注：
この機能はユーザプログラム実行中に使用できません。

17.6.7

I/Oファイルをロードする[IO]ウィンドウにI/Oファイルを手動でロードできます。
I/Oファイルをロードするには
1.

ウィンドウ内で右クリックしポップアップメニューを表示します。

2.

[IOファイルのロード]を選択します。[I/Oファイルを指定]ダイアログボックスが開きます。

3.

[I/Oファイル]にロードしたいI/Oファイルを指定します。[I/Oファイル]にプレースホルダを挿入するには、プレースホルダボタンをクリックしポップアップメニューからプレースホルダを選択します。ファイルを参照するには[参照]ボタンをクリックします。

4.

[I/Oファイルのパス名を保存する]チェックボックスをオフにすると、セッションを保存するときに[I/O
ファイル]のパス名を保存しません。次回このセッションを選択したとき、[IO]ウィンドウへのロード
内容はデバッガに依存します。自動的にI/Oファイルがロードされる場合は、このままこのチェックボ
ックスをオフにしてください。CPU選択に依存したI/Oファイルがデバッガにより自動的にロードされています。
[I/Oファイルのパス名を保存する]チェックボックスをオンにすると、セッションを保存するときに[I/O
ファイル]のパス名を保存します。次回このセッションを選択したときは前回ロードしたI/Oファイル
を[IO]ウィンドウにロードします。
このチェックボックスのデフォルトはオフです。

5.

[OK]ボタンをクリックします。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 379 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能

ロードしたI/Oファイルのレジスタ名と、[IO]ウィンドウの[Selected Register]タブに表示しているレジスタ名が一致しない場合、以下のようにアイコンで示します。

I/Oファイルのフォーマットは「リファレンス 6. I/Oファイルフォーマット」を参照してください。

17.6.8

IOウィンドウの表示内容を印刷する

現在選択している[IO]ウィンドウのタブに表示している内容をテキスト形式で印刷できます。[IO]ウィンドウのポップアップメニューから[印刷]を選択してください。

17.6.9

IOウィンドウの表示内容を保存する

現在選択している[IO]ウィンドウのタブに表示している内容をテキストファイルに保存できます。[IO]ウィン
ドウのポップアップメニューから[ファイルに保存]を選択してください。

17.6.10

I/Oレジスタを検索する[IO]ウィンドウに表示しているI/Oレジスタを検索できます。
I/Oレジスタを検索するには
1.

ウィンドウ内で右クリックしポップアップメニューを表示します。

2.

[検索]を選択します。[検索]ダイアログボックスが開きます。

3.

[検索カラム]からI/Oレジスタを検索するカラムを選択してください。
Address

I/Oレジスタアドレス

Name

I/Oレジスタ名

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 380 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能4.

選択したカラムで検索するテキストを[検索値]に入力してください。大文字と小文字は区別しません。

5.

[検索値]に入力したテキストと一致するI/Oレジスタを検索する場合は、[一致検索]チェックボックスをオンにしてください。このオプションをチェックしない場合は、[検索値]に入力したテキストと一部でも一致するI/Oレジスタを検索します。

6.

[OK]ボタンをクリックすると先頭行から検索を開始します。該当行が強調表示されます。

次の該当箇所を検索する場合は、[IO]ウィンドウのポップアップメニューから[次を検索]を選択してください。

17.6.11

次を検索する[IO]ウィンドウでI/Oレジスタが検索できた後、ポップアップメニューから[次を検索]を選択すると、検索条件に一致する次のI/Oレジスタを検索します。

17.7

レジスタ内容を見る

アセンブリ言語レベルでデバッグする場合に、CPUの汎用レジスタの内容を簡単に見ることができます。これは、レジスタウィンドウを使用して行います。

レジスタウィンドウを開く

17.7.1

レジスタウィンドウは、レジスタの内容やフラグの内容を表示するウィンドウです。ウィンドウからレジスタ/フラグの値を変更できます。
レジスタウィンドウを開くには、[表示 -> CPU -> レジスタ]を選択するか、[レジスタ]ツールバーボタン()

をクリックします。レジスタウィンドウが開き、レジスタおよびその値を表示します。
ウィンドウの構成
以下の図は、SH-4用デバッガのレジスタウィンドウです。

•

レジスタ表示行をダブルクリックすると、レジスタ値を設定するダイアログボックスが開きます。「( マクロの記録」)•[Value]カラムでは、インプレース編集によりレジスタ値を設定できます。(「マクロの記録」)•

フラグに対応したボタンをクリックすることにより、フラグの値を切り替えることができます。(「マクロの記録」)

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 381 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能ウィンドウのオプション
ウィンドウ内で右クリックすると、使用可能なオプションをポップアップメニューで表示します。
ポップアップメニューオプション
基数

マクロの記録機能

16 進数表示-

16 進数で表示します。

10 進数表示-

10 進数で表示します。

8 進数表示-8 進数で表示します。

2 進数表示-2 進数で表示します。

バンク 0 *-

レジスタバンク 0 のレジスタを表示します。

バンク 1 *-

レジスタバンク 1 のレジスタを表示します。

基数-

基数カラムの表示/表示なしを切り替えます。

フラグ-

フラグ表示部の表示/表示なしを切り替えます。

設定-表示するレジスタを選択します。

レイアウト

レジスタの内容を設定します。

編集
最新情報に更新-

ウィンドウの表示内容を手動で更新します。

表示固定

-

ウィンドウの表示内容の更新を抑止します。

分割-

ウィンドウを分割表示します。

ファイルに保存-レジスタウィンドウの表示内容を保存します。

注： *. 機能のサポートはデバッガに依存します。

17.7.2レジスタの表示基数を変更する

レジスタごとに表示基数が変更できます。
レジスタウィンドウのポップアップメニュー[基数]以下で表示基数を選択してください。
以下のいずれかが選択できます。
[16進数表示]16進数で表示[10進数表示]10進数で表示[8進数表示]8進数で表示[2進数表示]2進数で表示17.7.3

レジスタバンクを切り替える

レジスタウィンドウを開いた直後は、フラグの値に対応したバンクのレジスタ内容を表示します。
バンクの切り替えは、レジスタウィンドウのレジスタ表示部上で右クリックすると表示されるポップアップメ
ニュー、またはフラグのフラグ切り替えにより可能です（フラグの値を変更した場合は、その値に応じてレジスタバンクが切り替わります）。
バンク1のレジスタ内容を参照する場合は、ポップアップメニューから[バンク1]を選択してください。
バンク1固有のレジスタは、背景がグレー表示になります。
以下の図は、M16Cファミリ用デバッガのレジスタウィンドウです。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 382 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能バンク0のレジスタ内容を参照する場合は、ポップアップメニューから[バンク0]を選択してください（オプション[バンク0]、[バンク1]の操作では、フラグの値は変化しません）。
機能のサポートはデバッガに依存します。

17.7.4

レイアウトを設定する

レイアウトを設定するには、レジスタウィンドウのポップアップメニュー[レイアウト]以下で表示するレイアウトを設定してください。以下を選択できます。
[基数][Radix]カラムの表示/表示なしの切り替え[フラグ]

フラグ表示部の表示/表示なしの切り替え

表示している場合はオプションにチェックマークが付いています。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 383 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能[Radix]カラム、およびフラグ表示部を表示する場合:

17.7.5

表示するレジスタを選択する

レジスタウィンドウのポップアップメニューから[レイアウト]以下で[設定]を選択してください。
以下の図は、SH-4用デバッガの[設定]ダイアログボックスです。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 384 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能レジスタの内容を設定する

17.7.6レジスタの内容を設定するには、次の方法があります。
•[Value]カラムでインプレース編集する。

•

以下のいずれかの方法でレジスタ変更ダイアログボックスを開き、変更する値を入力する。
o

変更するレジスタ行をダブルクリックする。

o変更するレジスタを選択して、ポップアップメニューの[編集]を選択する。

[値]には数字またはC/C++の式を入力できます。
[基数]ドロップダウンリストから基数を選択できます。
[データ形式]ドロップダウンリストからオプションを選択して、レジスタの内容のすべて、マスクした領域、フローティングビットまたはフラグビットを修正できます（このリスト内容は、CPUおよび選択したレジスタによって異なります）。
新しい数字または式を入力したら、[OK]ボタンをクリックするか'Enter'キーを押します。ダイアログボ
ックスは閉じて、新しい値をレジスタに書き込みます。

17.7.7

フラグの値を設定する

フラグ表示している場合:変更するフラグのボタンをクリックしてください。クリックごとにフラグの状態（0/1）が切り替わります。
複数ビットで構成されるフラグの場合は、変更値を入力するダイアログボックスが開きます。
以下の図は、SH-4用デバッガのレジスタウィンドウです。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 385 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能フラグをレジスタ表示している場合:
フラグ行をダブルクリックしてください。ダイアログボックスが開きます。
変更する値を入力してください。
以下の図は、SH-4用デバッガのレジスタウィンドウです（フラグ行（FPSCR））。

17.7.8ウィンドウの表示内容を手動で更新する

レジスタウィンドウの表示内容を強制的に更新できます。
レジスタウィンドウのポップアップメニューから[最新情報に更新]を選択してください。

17.7.9ウィンドウの表示内容の更新を抑止する

ユーザプログラムの実行停止時などに、自動的にレジスタウィンドウの表示内容を更新しないようにできます。
レジスタウィンドウのポップアップメニューから[表示固定]を選択してください。
レジスタウィンドウの内容をグレーで表示します。
ウィンドウを2枚開き、一方のウィンドウでこの機能を使用することにより、レジスタやフラグの値を比較できます。

17.7.10ウィンドウを分割表示する

レジスタウィンドウを上下 2分割で表示したいときは、ポップアップメニューから[分割]を選択後、分割バー
を移動して分割します。
ポップアップメニューから[分割]を選択すると分割表示を解除します。

17.7.11レジスタウィンドウの表示内容を保存する

レジスタウィンドウに表示しているデータをテキスト形式でファイルへ保存するには、レジスタウィンドウのポップアップメニューから[ファイルに保存]を選択します。[名前を付けて保存]ダイアログボックスが開きます。ファイル名を指定してください。

17.7.12レジスタの内容を使用する

逆アセンブリまたはメモリウィンドウのアドレス指定など、値を入力するときにレジスタ値を使用できます。
"#PC"または"%PC"のように、レジスタ名のプレフィックスに"#"記号または"%"記号を付けます。サポートするプレフィックスはデバッガに依存します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 386 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能テキストの色を変更する

17.7.13レジスタウィンドウはレジスタおよびフラグの値を表示しているテキストの色およびフォントを他のウィンドウと同じように[表示形式]ダイアログボックスでカスタマイズできます。
レジスタウィンドウではこれに加えて、レジスタおよびフラグの値が変更された部分の色を、[表示形式]ダイ
アログボックスでカスタマイズできます。レジスタおよびフラグの値が変更された部分のデフォルトの色は、前面が赤色で背景が白色です。背景色は、[Text]カテゴリ選択時の背景色と同じ色になります。
値が変更された部分の色をカスタマイズするには
1.

[基本設定 -> 表示の形式]を選択し、[表示形式]ダイアログボックスを開きます。

2.

[レジスタ]をダイアログボックスの左側のツリーから選択し展開します。

3.

[変更]カテゴリを選択します。

4.

[カラー]タブの[前面]リストの選択を変更します。

5.

[OK]ボタンをクリックします。

17.8

基数を設定する

ダイアログボックス、ウィンドウ、またはコマンドで、値を数値で入力するときに"0x"などのプレフィックス
を付けなかった場合、入力した数値を処理する基数を設定します。
注：•

ダイアログボックスまたはウィンドウ内に基数用のフィールドがある場合は、その基数の指定に従います。

•

ダイアログボックス、ウィンドウ、またはコマンドによっては、入力した数値を処理する基数が固定されている場合があります。

基数を設定するには、以下に示す[基本設定->基数]のサブメニューを選択するか、[デバッグ]ツールバーのボタンをクリックしてください。
[基本設定 -> 基数]サブメニュー

機能[デバッグ]ツールバー

16 進数

入力した数値を処理する基数を 16 進数に設定します（デフ
ォルト）。

10 進数

入力した数値を処理する基数を 10 進数に設定します。

8 進数

入力した数値を処理する基数を 8 進数に設定します。

2 進数

入力した数値を処理する基数を 2 進数に設定します。

17.9

ターゲットマイコンをリセットする

ターゲットマイコンをリセットするには、[CPUリセット]ツールバーボタン()をクリックするか、[デバッグ]

メニューから[CPUのリセット]を選択します。
ターゲットマイコンをリセットすることにより、内蔵I/Oレジスタの初期化、およびリセットベクタに設定されたアドレスをPCに設定します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 387 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能17.10 カーソル位置にPC値を設定する
PCを現在のテキストカーソルの位置によって示されるアドレスに設定するには、[カーソル位置にPC設定]ツー
ルバーボタン()をクリックするか、[デバッグ -> カーソル位置にPC値を設定]を選択します。

17.11 デバッガを初期化する[デバッグ -> 初期化]を選択します。
現在開いているウィンドウを閉じ、デバッガとの接続を解除します。そして、デバッガの再接続をします。

17.12 デバッガを接続/接続解除する
デバッガを接続するには
1.

[接続]ツールバーボタン()をクリックするか、[デバッグ]メニューから[接続]を選択します。

デバッガを接続解除するには
1.

[接続解除]ツールバーボタン()をクリックするか、[デバッグ]メニューから[接続解除]を選択します。

機能のサポートはデバッガに依存します。

17.13 プログラムを実行する
この節では、作成したプログラムコードの実行方法について説明します。ここでは、プログラムを連続して実行させたり、シングルステップ実行を行ったり、同時に複数の命令を実行させたりします。

17.13.1

実行を継続する

作成したプログラムが停止すると、High-performance Embedded WorkshopはCPUの現在のプログラムカウンタ（PC）アドレス値に対応するエディタおよび逆アセンブリウィンドウの行の左余白に黄色の矢印（）を表示します。ステップ実行を行った場合、または実行を続けた場合、この命令を次に実行します。
現在のPCアドレスから実行を継続するには•[実行]ツールバーボタン(•[デバッグ -> 実行]を選択する。

)をクリックする。

前回停止時と異なるアドレスから実行を継続するには、下記の方法でPCを変更後に[実行]ツールバーボタン()をクリックするか、[デバッグ -> 実行]を選択します。
•

レジスタウィンドウ上で変更する。

•

エディタウィンドウまたは逆アセンブリウィンドウ上で、テキストカーソル（マウスカーソルではありません）を変更したい行に移動してポップアップメニューから[カーソル位置にPC値を設定]を選択する。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 388 of 479

High-performance Embedded Workshop V.4.09

17.13.217.

デバッグ機能リセットから実行を開始する

ターゲットマイコンをリセットしてリセットベクタアドレスからプログラムを実行させるには、[リセット後
実行]ツールバーボタン()をクリックするか、[デバッグ -> リセット後実行]を選択します。

プログラムは、ブレークポイントにヒットするまで、またはブレーク条件が成立するまで実行を続けます。プ
ログラムの実行はいつでも手動で停止できます。その方法としては、[停止]ツールバーボタン()をクリックするか、[デバッグ -> プログラムの停止]を選択します。
注：プログラムはリセットベクタ位置に格納したアドレスから実行を開始します。したがって、この位置にスター
トアップコードのアドレスを含んでいることを確認することが重要です。

17.13.3

ブレークポイントを無視して実行する

アプリケーションのデバッグ中、続けて実行を開始するとき、ブレークポイントの設定を保持したい場合があります。フリー実行機能を使用することにより、すべてのブレークポイントを無効に設定したとみなしてコードを直ちに実行できます。
現在のPCアドレスからブレークポイント（ソフトウェアとハードウェア）を無視して実行するには•[フリー実行]ツールバーボタン(•[デバッグ -> フリー実行]を選択する。

)をクリックする。

注：
機能のサポートはデバッガに依存します。

17.13.4

カーソルまで実行する

アプリケーションを実行している途中で、シングルステップ実行を複数回行うだけの比較的小さいセクション
コードのみを実行したいと考える場合があります。この場合特定のポイントまで実行できると便利です。これは、[カーソル位置まで実行]機能を使用して行うことができます。
[カーソル位置まで実行]を使用するには
1.

エディタウィンドウまたは逆アセンブリウィンドウが開いていて、プログラムを停止するアドレスを表示していることを確認します。

2.

プログラムを停止するアドレスの行にテキストカーソルを置いてください。

3.

ポップアップメニューから[カーソル位置まで実行]を選択します。

デバッガは作成したコードを現在のPC値から実行し、カーソル位置が示すアドレスまで実行します。
注：•

作成したプログラムがこのアドレスのコードを実行しない場合、プログラムは停止しません。その場
合、コードの実行を中止するには、'Escキー'を押すか、[デバッグ -> プログラムの停止]を選択するか、[停止]ツールバーボタン(

R20UT0372JJ0100 Rev.1.00
2011.02.01)をクリックします。

Page 389 of 479

High-performance Embedded Workshop V.4.09•

17.

デバッグ機能[カーソル位置まで実行]はテンポラリブレークポイント機能を利用しています。既にブレークポイン
トを最大数利用している場合はこの機能を利用できません。

17.13.5

条件を指定して実行する[条件を指定して実行]ダイアログボックスを利用すると、任意のアドレスから命令を実行できます。[条件を指定して実行]ダイアログボックスを開くには、[デバッグ -> 条件を指定して実行]を選択します。

[条件を指定して実行]ダイアログボックスでは命令実行の条件を設定します。
[プログラムカウンタ値]

実行を開始する命令アドレスを設定します。初期値は現在のPC値となります。

[テンポラリPCブレークポイント]

一時的なPCブレークポイントを設定します。ダイアログボックスによる命令実行が停止すると、このブレークポイントは解除されます。

[実行]ボタンをクリックすると、設定した内容にしたがって命令を実行します。
[リセット実行]ボタンをクリックすると、リセットベクタから命令を実行します。
[キャンセル]ボタンをクリックすると、命令を実行しないで、ダイアログボックスを閉じます。
注：[テンポラリPCブレークポイント]はテンポラリブレークポイント機能を利用しています。既にブレークポイン
トを最大数利用している場合はこの機能を利用できません。

17.13.6

リセット時にmain関数の先頭までプログラムを実行する

High-performance Embedded Workshopは、リセット時にソフトウェアブレークポイントを設定せずにmain関数の先頭までプログラムを実行する機能があります。
この機能はmain関数に一時的にソフトウェアブレークポイントを設定します。プログラムの実行停止後にソフ
トウェアブレークポイントを解除します。
リセット時にmain関数の先頭までプログラムを実行するには
1.

[基本設定 -> オプション]を選択し、[オプション]ダイアログボックスを開きます。

2.

[デバッグ]タブを選択します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 390 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能3.

[リセット時にmain関数の先頭まで実行]チェックボックスをオンにします。デフォルトはオフです。

4.

ターゲットマイコンをリセットします。以下のいずれかの操作を選択してください。

•[CPUリセット]ツールバーボタン(•[デバッグ -> CPUのリセット]を選択する。

)をクリックする。

注：[リセット時にmain関数の先頭まで実行]はテンポラリブレークポイント機能を利用しています。既にブレークポイントを最大数利用している場合はこの機能を利用できません。

17.13.7

シングルステップ

作成したコードをデバッグするために、一度に1行だけまたは1つの命令だけステップ実行して、この命令がシステムにどのように影響するかを確認したい場合、ソース表示では、ソースライン1行だけをステップ実行します。逆アセンブリ表示では、アセンブリ言語命令単位にステップ実行します。命令が他の関数またはサブル
ーチンを呼び出す場合、オプションでその関数にステップインまたはステップオーバできます。命令が呼び出しを実行しない場合は、いずれのオプションでも、その命令を実行し、次の命令で停止します。
関数にステップイン実行を選択した場合は、関数の呼び出しを実行しその関数の最初の行または命令で停止します。
関数にステップイン実行するには•[ステップイン]ツールバーボタン(•[デバッグ -> ステップイン]を選択する。

)をクリックする。

関数をステップオーバ実行を選択した場合は、呼び出しおよびその関数(およびその関数が実行するすべての関数呼び出し)を実行して、呼び出し元の関数の次の行または命令で停止します。
関数をステップオーバ実行するには•[ステップオーバ]ツールバーボタン(•[デバッグ -> ステップオーバ]を選択する。

)をクリックする。

関数内の確認したい命令の実行が終了した場合や、誤って関数にステップイン実行した場合に、ステップアウ
ト機能を使用すると関数内の残りのコードをすべてステップイン実行することなく呼び出し元の関数に戻る
ことができます。
関数からステップアウト実行するには•[ステップアウト]ツールバーボタン(•[デバッグ -> ステップアウト]を選択する。

R20UT0372JJ0100 Rev.1.00
2011.02.01)をクリックする。

Page 391 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能ステップモードを選択するには[デバッグ->ステップモード]から次のサブメニューを選択します。
サブメニュー機能[自動]（デフォルト） エディタウィンドウがアクティブの場合はソースライン 1 行だけをステップ実行します。
逆アセンブリウィンドウがアクティブの場合はアセンブリ言語命令単位にステップ実行します。
[アセンブリ]

アセンブリ言語命令単位にステップ実行します。

[ソース]

ソースライン 1 行だけをステップ実行します。

High-performance Embedded Workshopエディタのソース表示でステップインしている際、デバッグ情報がない
ライブラリ関数（printf等）はソース表示のままステップしたい場合があります。デフォルトでは逆アセンブリ
ウィンドウへジャンプし、アセンブリ言語命令単位にステップします。
High-performance Embedded Workshopエディタのソース表示でデバッグ情報がないアドレスにステップインした場合、アセンブリ言語命令単位にステップ実行しないようにできます。
デバッグ情報のないアドレスへステップインしないようにするには
1.

[基本設定 -> オプション]を選択し、[オプション]ダイアログボックスを開きます。

2.

[デバッグ]タブを選択します。

3.

[デバッグ情報のないアドレスにステップインしない]チェックボックスをオンにします。チェックボ
ックスのデフォルトはオフです。

注：
機能のサポートはデバッガに依存します。

17.13.8

複数のステップ[プログラムステップ]ダイアログボックスを使用することにより、一度に複数のステップ実行ができます。ス
テップ間の時間差を選択し、自動的にステップ実行するよう設定できます。[デバッグ -> ステップ]を選択してください。[プログラムステップ]ダイアログボックスが開きます。

[ステップ]

連続実行するステップ数を設定します。デフォルトの値は、1です。

[ディレイ(秒)]コードを自動的にステップ実行するときのステップ間の遅延を選択します。
デフォルトの値は、2.5 secondsです。
[No Refresh]（各ウィンドウの更新をしない）または0〜3秒まで、0.5秒単位で選択できます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 392 of 479

High-performance Embedded Workshop V.4.09[ステップオーバ]

17.

デバッグ機能チェックすると関数呼び出しをステップオーバします。チェックボックスのデフォ
ルトはオフです。

[ソースレベルステップ]

チェックするとソースレベルでステップします。チェックボックスのデフォルトはオンです。

[OK]ボタンをクリックするか、'Enter'キーを押してステップ実行を開始します。

17.14 プログラムを停止する
この節では、作成したプログラムの実行を停止する方法を説明します。停止手段として、[停止]ツールバーボ
タン()を使用して停止する方法、および作成したコードの特定の場所にブレークポイントを設定することによって停止する方法について説明します。

17.14.1

停止ツールバーボタンによる停止

作成したプログラムが実行中の場合、[停止]ツールバーボタン(
る場合は、[停止]ツールバーボタン()を使用できます。プログラムが停止してい)はグレー表示となり使用できません。

プログラムを停止するには•[停止]ツールバーボタン(•[デバッグ -> プログラムの停止]を選択する。

)をクリックする。

プログラムが停止すると、停止要因などの情報がアウトプットウィンドウの[Debug]タブに表示されます。

17.14.2

標準のブレークポイント（PCブレークポイント）

作成したプログラムをデバッグする場合、PCブレークポイントにより指定した行または命令でプログラムの実行を停止させることができます。標準的なPCブレークポイントを設定したり解除したりする方法を以下に示します。
エディタウィンドウ上でPCブレークポイントを設定するには
1.

PCブレークポイントを設定する位置のエディタウィンドウまたは逆アセンブリウィンドウが開いていることを確認します。

2.

プログラムを停止したい行でポップアップメニューの[ブレークポイントの挿入/削除]を選択するか、"F9"キーを押します。左余白に赤丸( )を表示します。これは、PCブレークポイントを設定したことを
示します。

3.

ポップアップメニューの[ブレークポイントの有効化/無効化]を選択すると、現在設定しているブレー
クポイントの有効／無効の切り替えができます。

4.

作成したプログラムを実行してPCブレークポイントを設定したアドレスに達すると、"PC Breakpoint"というメッセージをアウトプットウィンドウの[Debug]タブに表示し、実行を中断し、エディタウィン
ドウまたは逆アセンブリウィンドウを更新し、PC位置の行をハイライト表示します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 393 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能補足:
テンプレート関数の実体が複数存在する場合、同一ソース行に対して複数のアドレスにブレークポイントを設定できます。
template <typename T> T1 tempfunc(T t1){
g_iVal += t1; -> ここにブレークポイントを設定すると、tempfunc(c)とtempfunc(s)に対してブレークポイントを設定できます。
return g_iVal;}
void main(void)char c;short s;...
tempfunc(c);tempfunc(s);}ブレークポイントを設定するときに、すべてのアドレスにブレークポイントを設定するかどうかを確認するダ
イアログボックスが開きます。すべてのアドレスにブレークポイントを設定する場合は「はい」を選択してください。設定しない場合は「いいえ」を選択してください。
確認要求ダイアログボックスを表示しない場合、[今後表示しない]チェックボックスをオンにしてください。
確認要求ダイアログボックスを再び表示するには
1.

[基本設定 -> オプション]を選択してください。[オプション]ダイアログボックスが開きます。

2.

[確認]タブを選択してください。

3.

[複数ブレークポイントの設定]チェックボックスをオンにしてください。このチェックボックスのデフォルトはオンです。

4.

OKをクリックしてください。

注：
ブレーク発生時には、PCブレークポイントを設定した行または命令を実行する直前で停止します。そのPCブ
レークポイントで停止した後にGoまたはStepを選択した場合、矢印で表示した行から実行します。
[ブレークポイント]ダイアログボックスを使用してPCブレークポイントの設定を編集するにはPCブレークポイントの設定を編集するには、[編集 - > ソースブレークポイント]メニューを選択し、[ブレークポイント]ダイアログボックスを開きます。
•

このダイアログボックスに現在設定しているPCブレークポイントを表示します。

•[コードの編集]ボタンによりPCブレークポイントが存在するソースを見ることができます。

•[削除]、[すべて削除]ボタンにより、PCプレークポイント1つまたはすべてを削除できます。

•

各ブレークポイントのチェックボックスにより有効／無効の切り替えができます。

PCブレークポイントを切り替えるにはPCブレークポイントを設定したり、解除したりするには、PCブレークポイントを設定している行の[BP]カラムをダブルクリックするか、行にカーソルを置き、"F9"キーを使用します。その行で使用可能な標準のブレー
クポイントが有る場合、色の付いた丸印( )を左余白に表示します。
R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 394 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能17.15 現在の状態を表示する
デバッガの現在の状態を知るにはステイタスウィンドウを使用します。ステイタスウィンドウを開くには、[表示 -> CPU -> ステイタス]を選択するか、[ステイタスの表示]ツールバーボタン()をクリックします。

ステイタスウィンドウには、3つのタブがあります。
ウィンドウの構成

タブ

説明[Memory]

メモリマッピングおよび現在ロードしたオブジェクトファイルが使用するメモリエリアなど、
現在のメモリステータスに関する情報を含んでいます。

[Platform]

CPUシリーズおよび動作モードなど、デバッガのステータス情報、実行状態、および実行統計
情報を含んでいます。

[Events]

リソース情報およびブレークポイント等のイベント情報に関する情報を含んでいます。

17.16 関数呼び出し履歴を見る
関数呼び出し履歴を表示する場合は、スタックトレースウィンドウを使用します。

17.16.1

スタックトレースウィンドウを開く

スタックトレースウィンドウを開くには、[表示 -> コード -> スタックトレース]を選択するか、[スタックト
レース]ツールバーボタン(

R20UT0372JJ0100 Rev.1.00
2011.02.01)をクリックします。

Page 395 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能ウィンドウ構成

表示する項目は以下の通りです。
[Kind]

該当シンボルのシンボル種別を示します。
F： 関数
P： 関数パラメータ *L： ローカル変数 *[Name]

シンボル名を示します。

[Value]

シンボルの値、アドレス、型を示します。

注：*. 機能のサポートはデバッガに依存します。
ウィンドウのオプション
ウィンドウ内で右クリックすると、使用可能なオプションをポップアップメニューで表示します。
ポップアップメニューオプション マクロの記録機能

ソースファイル表示-

選択した関数に該当するソースコードを表示します。

表示設定

-

スタックトレースウィンドウの表示形式を設定します。

コピー-

選択部分をコピーし Windows® クリップボードに貼り付けます。

17.16.2

ソースコードを表示する

関数を選択した状態で、ポップアップメニューから[ソースファイル表示]を選択すると、エディタウィンドウ
を開いて選択した関数に該当するソースコードを表示します。

17.16.3

表示形式を設定する

ポップアップメニューから[表示設定]を選択すると、[スタックトレース表示設定]ダイアログボックスを開きます。
スタックトレースウィンドウの表示形式を設定します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 396 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能[関数のネスト]

スタックトレースウィンドウに表示する関数コールネスト数を指定します。

[表示シンボル] *関数以外に表示するシンボルを指定します。

[表示基数] *スタックトレースウィンドウの表示基数を指定します。

注：*. 機能のサポートはデバッガに依存します。

17.16.4

エンコード形式を設定する

変数値が文字、文字列の場合にUTF-8として表示するには[基本設定 -> オプション]を選択し、[オプション]
ダイアログボックスを開きます。
[デバッグ]タブを選択し、[エンコード形式]を[UTF-8]にします。
これで、スタックトレースウィンドウは変数の値をUTF-8として表示します。
[エンコード形式]を[ローカルコードページ]（デフォルト）にした場合は、ASCIIおよびシフトJISコードとして表示します。
注:
スタックトレースウィンドウではウィンドウ内に表示するフォントのデフォルトが"Courier New"となっており、UTF-8やシフトJISコードで表現される日本語文字等に対応していません。
これらの文字コードを表示する場合は[表示形式]ダイアログボックスで日本語文字に対応したフォント(MS P
ゴシックなど)に変更してご使用ください。

17.17 外部デバッガを使う
High-performance Embedded Workshopは外部デバッガツールを起動できます。他のデバッガを使用する場合は、[ツール]メニューに追加する必要があります。
[カスタマイズ]ダイアログボックスの[デバッガ]タブに外部デバッガに関連する情報を設定します。一部のターゲットが新しい環境でサポートされていない場合は、古いバージョンのデバッガを使用できます。[基本設定 -> カスタマイズ]を選択してダイアログボックスを開き、[デバッガ]タブを選択してください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 397 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能最初に、[外部デバッガの選択]ドロップダウンリストで使用する外部デバッガを選択します。
外部デバッガを使用する場合、そのデバッガ固有の情報を構築する必要があります。
[Hitachi Debugger Interface

日立デバッギングインタフェースをHigh-performance Embedded Workshopと(version 4.x or greater)]

統合して構築する[Renesas PD debugger]

PDデバッガをHigh-performance Embedded Workshopと統合して構築する[Other external debugger]

日立デバッギングインタフェースまたはPDデバッガ以外の外部デバッガをHigh-performance Embedded Workshopと統合して構築する
外部デバッガを使用しない[Non selected]

外部デバッガを起動するには、[外部デバッガの実行]ツールバーボタン()をクリックしてください。

ビルド後にダウンロードモジュールが変更された場合、High-performance Embedded Workshopから外部デバッ
ガに切り替わり、すぐデバッグできるようになります。
外部デバッガを使用しているときにエディタウィンドウのどれかをダブルクリックするとHigh-performance
Embedded Workshopに切り替わり、ダブルクリックした行のソースファイルを開いた状態になります。[Other
external debugger]を選択した場合は、この操作を行うことはできません。

17.17.1

日立デバッギングインタフェースをHigh-performance Embedded Workshopと統合して構築する

日立デバッギングインタフェースをHigh-performance Embedded Workshopと統合し、High-performance Embedded
Workshopの外部デバッガのオプションで起動できるよう設定するために必要な情報を以下に示します。

日立デバッギングインタフェースをHigh-performance Embedded Workshopと統合して構築するには
1.

日立デバッギングインタフェースの場所を指定します。日立デバッギングインタフェース 4.0以降のバージョンでない場合この動作は保証されません。

2.

セッションファイルの場所を指定します。起動時にどのセッションをロードするか日立デバッギング
インタフェースに伝えます。

3.

ダウンロードモジュールの場所を指定します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 398 of 479

High-performance Embedded Workshop V.4.09

17.17.217.

デバッグ機能PDデバッガをHigh-performance Embedded Workshopと統合して構築する

PDデバッガをHigh-performance Embedded Workshopと統合し、High-performance Embedded Workshopの外部デバ
ッガのオプションで起動できるよう設定するために必要な情報を以下に示します。

PDデバッガをHigh-performance Embedded Workshopと統合して構築するには
1.

PDデバッガの場所を指定します。

2.

PD Profileファイルの場所を指定します。起動時にどのセッションをロードするかPDデバッガに伝えます。

3.

コマンドラインオプションです。PDデバッガの動作を変更するオプションを指定できます。

4.

ダウンロードモジュールの場所を指定します。

17.17.3

外部デバッガをHigh-performance Embedded Workshopと統合して構築する

日立デバッギングインタフェースまたはPDデバッガ以外の外部デバッガをHigh-performance Embedded
Workshopと統合し、High-performance Embedded Workshopの外部デバッガのオプションで起動できるよう設定するために必要な情報を以下に示します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 399 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能外部デバッガをHigh-performance Embedded Workshopと統合して構築するには
1.

外部デバッガの場所を指定します。

2.

コマンドラインオプションです。外部デバッガの動作を変更するオプションを指定できます。

3.

ダウンロードモジュールの場所を指定します。

17.18 デバッガに依存する機能
この節に記載している機能は、連携ツールの製品パッケージにバンドルされているHigh-performance Embedded
Workshopで共通のデバッグ機能ではありません。旧バージョンのユーザーズマニュアルおよびヘルプに記載していたデバッグ機能です。
ご使用のデバッガで利用可能な機能の詳細説明は、エミュレータまたはシミュレータのユーザーズマニュアル
およびヘルプを参照してください。

17.18.1

ラベルを見る

デバッグ情報を含んだユーザプログラムをロードした時に、ラベルを同時に登録します。ラベルを追加することも可能です。
逆アセンブリウィンドウにおいては、対応するアドレスの代わりとして、また命令オペランドの一部として、ラベルの最初の8文字を表示します。
注：
オペランドとラベルの値が一致すれば、命令のオペランドはラベル名に置き換わります。同じ値を持つラベルが 2つ以上ある場合、アルファベット順で先に来るラベルを表示します。
ダイアログボックスで、アドレスまたは値を入力できる場合には、ラベルを使用することもできます。

17.18.1.1

ラベルを一覧にする

現在のデバッグセッションに定義したラベルのすべてを見るには、[表示 -> シンボル -> ラベル]を選択する
か、[ラベルの表示]ツールバーボタン()をクリックします。

ウィンドウ構成•

各カラムのヘッダをクリックするとアルファベット順（ASCIIコードによって）またはアドレス値でソートしたシンボルを表示できます。

•[BP]カラムでダブルクリックすると、関数の入り口でソフトウェアブレークポイントを設定したり解除したりできます。（「マクロの記録」）

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 400 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能ウィンドウのオプション
ウィンドウ内で右クリックすると、使用可能なオプションをポップアップメニューで表示します。
本ウィンドウは、基本的なオプションをツールバーに割り付けています。
[ツールバー表示]、[ツールバーのカスタマイズ]は、ツールバー内で右クリックしても、ポップアップメニュ
ーを表示します。
ポップアップメニューオプション ツールバーボタン マクロの記録

機能
ラベルを追加します。

追加
編集

-

ラベルを編集します。

削除

ラベルを削除します。

すべてを削除

すべてのラベルを削除します。

ロード

ラベルをファイルからロードします。

上書き保存

-

ラベルをシンボルファイルに上書き保存します。

名前を付けて保存-

ラベルをファイルに保存します。

検索-

ラベルを検索します。

次を検索

-

ラベルが検索できた後、検索条件に一致する次のラベルを検索します。

ソースを表示-ラベルに対応するソースプログラムを表示しま
す。

印刷

-

表示内容を印刷します。

ツールバー表示--

ツールバー表示/表示なしを切り替えます。

ツールバーのカスタマイズ--

ツールバーボタンをカスタマイズします。

17.18.1.2

ラベルを追加する

ラベルを追加するには、ポップアップメニューから[追加]を選択し[ラベル追加]ダイアログボックスを開きます。

新しいラベル名を[名前]に入力し、対応する値を[アドレス]に入力して[OK]ボタンを押します。[ラベル追加]
ダイアログボックスが閉じ、ラベルリストに新しいラベルを追加、更新します。多重定義関数やクラス名を入力したときは、[関数選択]ダイアログボックスが開くので、関数を選択して[アドレス]を設定します。詳細は「17.18.2.3 複数ラベルをサポートする」を参照してください。

17.18.1.3

ラベルを編集する

ラベルを編集するには、ポップアップメニューから[編集]を選択し[ラベルの編集]ダイアログボックスを開きます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 401 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能ラベル名と対応する値を編集して、[OK]ボタンを押すとラベルリストに編集を反映し、保存します。多重定義関数やクラス名を入力したときは、[関数選択]ダイアログボックスが開くので、関数を選択して[アドレス]を設定します。詳細は「17.18.2.3 複数ラベルをサポートする」を参照してください。

17.18.1.4

ラベルを削除する

削除したいラベルを選択した状態で、ポップアップメニューから[削除]を選択します。この際に確認メッセー
ジボックスを表示します。

[OK]ボタンを押すとラベルリストから削除し、ウィンドウを更新します。このメッセージボックスの表示が不要のときは、[今後表示しない]チェックボックスをオンにしてください。

17.18.1.5

すべてのラベルを削除する

ポップアップメニューから[すべてを削除]を選択すると、リストからすべてのラベルを削除します。この際、確認メッセージボックスを表示します。

[OK]ボタンを押すと、すべてのラベルを High-performance Embedded Workshopのシンボルテーブルから削除
し、リスト表示もクリアします。メッセージボックスの表示が不要のときは、 [今後表示しない]チェックボッ
クスをオンにしてください。

17.18.1.6

ラベルをファイルからロードする

シンボルファイルをロードして現在のHigh-performance Embedded Workshopのシンボルテーブルに結合できます。ポップアップメニューから[ロード]を選択すると、シンボルをロードするダイアログボックスが開きます。
R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 402 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能ダイアログボックスは、Windows® 標準のファイルを開くダイアログボックスと同様です。ファイルを選択し、[開く]ボタンを押すとロードを開始します。シンボルファイルの標準拡張子は".sym"です。

17.18.1.7

ラベルをファイルに保存する

ポップアップメニューから[名前を付けて保存]を選択すると、シンボルを保存するダイアログボックスが開きます。ダイアログボックスはWindows® 標準の[名前を付けて保存]ダイアログボックスと同様に操作できます。
[ファイル名]にファイル名を入力し[保存]ボタンを押すと、シンボルファイルにラベルリストを保存します。
標準ファイル拡張子は".sym"です。
シンボルフォーマットについては「リファレンス 7. シンボルファイルフォーマット」を参照してください。
一度[名前を付けて保存]メニューでファイルに保存すると、以後はポップアップメニューの[上書き保存]で、現在のシンボルテーブルを同一シンボルファイルに保存できます。

17.18.1.8

ラベルを検索する

ポップアップメニューから[検索]を選択すると、[ラベルの検索]ダイアログボックスが開きます。

1.

[名前]に検索するラベル名を入力するか、ドロップダウンリストボックスから以前検索したラベル名を選択してください。

2.

[アドレス]に検索するラベルのアドレスを入力するか、ドロップダウンリストボックスから以前検索したアドレスを選択してください。

3.

[名前]に入力した名前と一致するラベルを検索する場合は、[単語単位で探す]チェックボックスをオンにしてください。このオプションをチェックしない場合は、[名前]に入力した名前と一部でも一致するラベルを検索します（[アドレス]は指定できません）。

4.

ラベル名の大文字と小文字を区別する場合は、[大文字、小文字を区別する]チェックボックスをオンにしてください。

5.

[OK]ボタンをクリックすると検索を開始します。

注：
ラベルは、はじめの1024文字分しか情報を保持していません。したがって、ラベル名のはじめの1024文字分は重複しないようにしてください。

17.18.1.9

次を検索する

ラベルが検索できた後、ポップアップメニューから[次を検索]を選択すると、検索条件に一致する次のラベルを検索します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 403 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能ラベルに対応するソースコードを表示する

17.18.1.10

ラベルを選択した状態で、ポップアップメニューから[ソースを表示]を選択すると、ラベルのアドレスに対応するソースファイルを開きます。

Elf/Dwarf2 のサポート

17.18.2

High-performance Embedded Workshopは、C/C++およびアセンブリ言語で書いたアプリケーションのデバッグのためにElf/Dwarf2オブジェクトファイルフォーマットをサポートします。
主な特長：•

ソースレベルデバッグ•

C/C++演算子•

C/C99 */C++の式 (キャスト、ポインタ、参照など)•

あいまいな関数名•

オーバレイメモリロード•

ウォッチ-ローカル、およびユーザ定義•

スタックトレース

注：*. C99言語仕様をサポートしたコンパイラの使用時に指定できます。

17.18.2.1

C/C++演算子

以下のC/C++ 言語演算子を使用できます。
+, -, *, /, &, |, ^, ~, !, >>, <<, %, (, ), <, >, <=, >=, ==, !=, &&, ||Buffer_start + 0x1000#R1 | B'10001101((pointer + (2 * increment_size)) & H'FFFF0000) >> D'15!(flag ^ #ER4)

17.18.2.2

C/C99/C++の式

式の例:
式

内容

Object.value

メンバの直接参照を指定します（C/C++）。

p_Object->value

メンバの間接参照を指定します（C/C++）。

Class::value

クラスを持つメンバの参照を指定します（C/C++）。

*valueポインタを指定します（C/C++）。

&value参照を指定します（C/C++）。

array[0]配列を指定します（C/C++）。

Object.*value

ポインタを持つメンバの参照を指定します(C++)。

::g_value

グローバル変数の参照を指定します(C++)。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 404 of 479

High-performance Embedded Workshop V.4.09

式

17.

デバッグ機能内容Class::function(short)

メンバ関数を指定します(C++)。

(struct STR) *value

キャスト動作を指定します（C/C++）。

[+|-]浮動小数点定数複素数あるいは虚数を指定します。

(+|-)浮動小数点定数*I

浮動小数点定数として、10 進浮動小数点定数での指定以外に 16 進浮動小数点定数による指定ができます（C99 言語仕様をサポートしたコンパイラの使用時に指定できます）。

17.18.2.3

複数ラベルをサポートする

プログラム言語の中の、例えばC++オーバーロード関数などでは、1つのラベルが複数のアドレスを表す場合があります。各ダイアログボックスでこのようなラベル名を入力した場合、High-performance Embedded
Workshopは[関数選択]ダイアログボックスを使用してオーバーロード関数およびメンバ関数を表示します。

[関数選択]ダイアログボックスでは、オーバーロード関数またはメンバ関数を選択します。通常、一度に1つの関数を選択します。ただし、ブレークポイントを設定する場合においてのみ、複数の関数を選択できます。このダイアログボックスには3つの領域があります。

[関数名の選択][関数名の指定][カウンタ]

同じ名前をもつ関数またはメンバ関数、およびその詳細情報を表示します。
[名前]

関数名を表示します。

[アドレス]

関数アドレスを表示します。

設定する関数およびそれらの詳細情報を表示します。
[名前]

関数名を表示します。

[アドレス]

関数アドレスを表示します。

同じ名前をもつ関数またはメンバ関数の数を表示します。
[全関数]

同じ名前をもつ関数またはメンバ関数を表示します。

[選択関数][関数名の選択]リストボックスに表示する関数の数を表示します。

[指定関数][関数名の指定]リストボックスに表示する関数の数を表示します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 405 of 479

High-performance Embedded Workshop V.4.09

(1)

17.

デバッグ機能関数を選択する[関数名の選択]リストボックスから選択したい関数をクリックして、[ >]ボタンをクリックします。
選択した関数を[関数名の指定]リストボックスに表示します。[関数名の選択]リストの関数すべてを選択するには、[>>]ボタンをクリックします。

(2)

関数の選択を解除する[関数名の指定]リストボックスから選択を解除する関数をクリックして、[<]ボタンをクリックします。すべての関数の選択を解除するには、[<<]ボタンをクリックします。選択を解除した関数は、[関数名の指定]リスト
ボックスから[関数名の選択]リストボックスへ戻します。

(3)

関数を設定する[OK]ボタンをクリックして、[関数名の指定]リストボックスに表示した関数を設定します。関数を設定し、[関数選択]ダイアログボックスを閉じます。
[キャンセル]ボタンをクリックすると、関数を設定せずにダイアログボックスを閉じます。

17.18.2.4

オーバレイプログラムのデバッグ

オーバレイ機能を利用するプログラムをデバッグできます。ここではオーバレイ機能を使用するための設定について説明します。

(1)

セクショングループを表示する

オーバレイ（いくつかのセクショングループを同じアドレス範囲に割り当てる）を使用すると、アドレス範囲
およびセクショングループを[オーバレイ]ダイアログボックスに表示します。
[デバッグ -> オーバレイの構成]を選択して[オーバレイ]ダイアログボックスを開きます。
このダイアログボックスには2つの領域があります。[アドレス]リストボックスおよび[セクション名]リストボックスです。

[アドレス]リストボックスは、オーバレイプログラムが使用するアドレス範囲を表示します。アドレス範囲の1つをクリックし[アドレス]リストボックスのアドレス範囲を選択します。
[セクション名]リストボックスは、選択したアドレス範囲に割り当てたセクショングループを表示します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 406 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能セクショングループを設定する(2)

オーバレイ関数を使用するときは、最も優先度の高いセクショングループを[オーバレイ]ダイアログボックス
で選択していなければ、High-performance Embedded Workshopは正しく動作しません。
まず[アドレス]リストボックスに表示したアドレス範囲の1つをクリックします。選択したアドレス範囲に割り当てたセクショングループを[セクション名]リストボックスに表示します。
表示しているセクショングループの中から最も優先度の高いセクショングループをクリックします。

セクショングループを選択したら、[OK]ボタンをクリックし優先度の設定を保存して、ダイアログボックスを閉じます。[キャンセル]ボタンをクリックすると、優先度の設定を保存せずにダイアログボックスを閉じます。
注：
オーバレイ関数が使用するアドレス範囲内では[オーバレイ]ダイアログボックスに指定したセクションのデバッグ情報を参照します。したがって、現在ロードしているプログラムと同じセクションを[オーバレイ]ダイア
ログボックスで選択します。

17.18.3

変数を表示する

ソースプログラム上の変数の値を表示する方法について説明します。
変数を表示する際に以下に示す注意事項があります。
ELF/DWARF2フォーマットのロードモジュールをデバッグする場合、ウォッチウィンドウやローカルウィンド
ウ上で構造体を展開したときにstaticメンバ変数を通常のメンバ変数と同じように表示できます。しかし、この機能はデバッグ情報量の多さによって変数表示に時間がかかることがあります。
ウォッチ/ローカルで変数展開時にstaticメンバ変数を表示しないようにするには
1.

[基本設定 -> オプション]を選択し、[オプション]ダイアログボックスを開きます。

2.

[確認]タブを選択します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 407 of 479

High-performance Embedded Workshop V.4.09

3.

17.

デバッグ機能[ウォッチ/ローカルで変数展開時にstaticメンバを表示]チェックボックスをオンにします。デフォルトはチェックボックスがオフです。

4.

次の確認ダイアログボックスが表示されたときに[いいえ]を選択してください。

この操作により変数展開時にstaticメンバ変数を表示しなくなり、表示時間を短縮できます。（[いいえ]を選択した後もstaticメンバ変数を直接ウォッチウィンドウに追加することでstaticメンバ変数の参照は可能です）

17.18.3.1

ツールチップウォッチ

プログラムに定義された変数の値を参照するための機能です。値を参照したい変数を含むプログラムをエディ
タウィンドウまたは逆アセンブリウィンドウ（ソースモード）に表示し、変数名の上にマウスカーソルを置くと、ツールチップとしてポップアップウィンドウにウォッチ情報を表示します。
ツールチップウォッチ機能を使用するには
1.

[基本設定 -> オプション]を選択してください。[オプション]ダイアログボックスが開きます。

2.

[エディタ]タブを選択してください。

3.

[ツールチップウォッチ]チェックボックスをオンにしてください。

4.

[OK]ボタンをクリックしてください。

エディタウィンドウまたは逆アセンブリウィンドウ（ソースモード）にツールチップウォッチを表示するには1.

値を参照したい変数を表示しているエディタウィンドウまたは逆アセンブリウィンドウ（ソースモード）を開きます。

2.

値を参照したい変数名の上にマウスカーソルを置きます。ツールチップとしてポップアップウィンド
ウに変数のウォッチ情報を表示します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 408 of 479

High-performance Embedded Workshop V.4.09

17.18.3.2

17.

デバッグ機能インスタントウォッチ

値を参照したい変数を含むソースファイルをエディタウィンドウまたは逆アセンブリウィンドウ（ソースモード）に表示します。値を参照したい変数名の上にマウスのカーソルを置いてポップアップメニューから[インスタントウォッチ]を選択します。[インスタントウォッチ]ダイアログボックスが開き、カーソル上の変数を表示します。

変数名の左側の'+'記号はクリックすれば情報を展開表示できることを、'-'記号は情報を縮小表示できることを示します。[登録]ボタンをクリックすると、変数をウォッチウィンドウに登録して、ダイアログボックスを閉じます。[閉じる]ボタンをクリックすると、変数をウォッチウィンドウに登録しないで、ダイアログボックスを閉じます。

17.18.3.3

ウォッチウィンドウ

ウォッチウィンドウを開くことにより、任意の変数について値を参照できます。

(1)

ウォッチウィンドウを開く

ウォッチウィンドウを開くには、[表示 -> シンボル -> ウォッチ]を選択するか、[ウォッチ]ツールバーボタン()をクリックします。ウォッチウィンドウが開きます。

ウィンドウの構成

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 409 of 479

High-performance Embedded Workshop V.4.09•

17.

デバッグ機能ウィンドウの内容は、ロードモジュール(*.abs等)内のデバッグ情報から、C/C++ソースプログラムの情報がある場合にのみ表示します。コンパイラ等の最適化により、ソースプログラムの情報としてデバッグ情報にない場合は表示できません。また、マクロ宣言されたものについても表示できません。

•

エディタウィンドウおよび逆アセンブリウィンドウからウォッチウィンドウへのドラッグアンドドロップ機能により、変数を登録できます。また、エディタウィンドウおよび逆アセンブリウィンドウのソースモードで、[ウォッチウィンドウに追加]メニューオプションにより変数を登録できます。

•

ドラッグアンドドロップ機能により変数の表示順序を変更できます。

•

変数をメモリウィンドウの[Address]カラムへドラッグアンドドロップすると、メモリウィンドウの表
示アドレスを変数のアドレスに簡単に変更できます。

•"R"マークはその変数がリアルタイムに更新できることを示します。"R"マークが太字のとき、その変数の値をユーザプログラムの実行時にリアルタイム更新します。

•[Name]カラムをダブルクリックすると、変数名を変更する[シンボル名の編集]ダイアログボックスが開きます。変数名の編集によりマクロを記録します。（「マクロの記録」）•[Value]カラムをダブルクリックすると、変数の値を変更する[値の編集]ダイアログボックスが開きます。値の編集によりマクロを記録します。（「マクロの記録」）•[Value]カラムでは、インプレース編集により値を変更できます。（「マクロの記録」）•[Name]、または[Address]カラムのヘッダをクリックすると変数をソートします。

•

スコープ別に変数を参照できます。参照先は、[Current Scope]（現在有効な変数）、[Global](グローバ
ル変数)、スコープを設定する各ファイル（ファイルスコープ内のスタティック変数）から参照できます。

•[Scope]カラムをダブルクリックすると、スコープを設定する[スコープ設定]ダイアログボックスが開きます。

•[Scope]カラムでは、インプレース編集によりスコープを変更できます。

ウィンドウのオプション
ウィンドウ内で右クリックすると、使用可能なオプションをポップアップメニューで表示します。
本ウィンドウは、基本的なオプションをツールバーに割り付けています。
[ツールバー表示]、[ツールバーのカスタマイズ]は、ツールバー内で右クリックしても、ポップアップメニュ
ーを表示します。
ポップアップメニューオプション

ツールバーボタン

マクロの記録機能選択している変数の"R"マークが太字になり、リ自動更新有効化

アルタイム更新します。
すべての変数の"R"マークが太字になり、リアル

全シンボル自動更新有効化

タイム更新します。
選択している変数の"R"マークが中抜きになり、

自動更新無効化

リアルタイム更新を解除します。
すべての変数の"R"マークが中抜きになり、リア

全シンボル自動更新無効化

ルタイム更新を解除します。
更新間隔設定 *
値更新記録

記録開始

-

自動更新の間隔を設定します。
[記録設定]ダイアログボックスを開きます。値
更新の記録を開始します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 410 of 479

High-performance Embedded Workshop V.4.09

ポップアップメニューオプション

ツールバーボタン17.

マクロの記録デバッグ機能機能
値更新の記録を終了します。

記録終了
シンボル登録[シンボル登録]ダイアログボックスを開きます。ウォッチする変数を登録します。

シンボル名の編集[シンボル名の編集]ダイアログボックスを開きます。変数名を編集します。

値の編集[値の編集]ダイアログボックスを開きます。変数の値を変更します。

スコープ設定-選択されている変数のスコープを設定します。
テキストカーソルの位置によって示された変数削除をウォッチウィンドウから削除します。
すべての変数をウォッチウィンドウから削除し全シンボル削除ます。
基数

16 進数表示

16 進数で表示します。

10 進数表示

10 進数で表示します。

8 進数表示8 進数で表示します。

2 進数表示2 進数で表示します。

初期表示の設定
コピー-

変数の初期表示基数を設定します。

-

選択部分をコピーし Windows® クリップボー
ドに貼り付けます。

保存-

表示内容をファイルに保存します。

メモリウィンドウへ移動-

メモリウィンドウを開きます。

ツールバー表示--

ツールバー表示/表示なしを切り替えます。

ツールバーのカスタマイズ--

ツールバーボタンをカスタマイズします。

注：*. 機能がサポートされている場合のみ表示されます。

変数を登録する(2)

ウォッチウィンドウに変数を登録します。
変数を登録するには•

エディタウィンドウまたは逆アセンブリウィンドウ（[ソースモード]）oウィンドウ内の変数上で右クリックし、ポップアップメニューから[ウォッチウィンドウに追加]を選択する。

oウィンドウ内の変数上で右クリックし、ポップアップメニューから[インスタントウォッチ]を選択する。[インスタントウォッチ]ダイアログボックスで[登録]ボタンをクリックする（インスタントウォッ
チ機能）。

o

ウィンドウ内で変数を選択し、ウォッチウィンドウ上へドラッグアンドドロップする。

登録した変数に対してデフォルトのスコープが設定されます。プログラムが実行されているかどうかに応じて設定は以下のようになります。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 411 of 479

High-performance Embedded Workshop V.4.09

17.

プログラムの状態•

デバッグ機能スコープ

停止中[Current Scope]

実行中[Global]

ウォッチウィンドウ
1.

以下のいずれかの方法で[シンボル登録]ダイアログボックスを開きます。

oウィンドウを選択した状態で"Insert"キーを押す。

oウィンドウ内で右クリックし、ポップアップメニューから[シンボル登録]を選択する。

2.

[変数または式]に変数名を入力します。
[変数または式]に入力する配列の要素番号には、2進数、8進数、10進数、または16進数を使用できます。
ただし、プレフィックスについて以下の入力規則があります。
配列の要素番号の表現

3.

入力規則

2 進数

プレフィックス"0b"、または"0B"が必要です。

8 進数

プレフィックス"0"が必要です。

10 進数

プレフィックスは不要です。

16 進数

プレフィックス"0x"、または"0X"が必要です。

[スコープ]ドロップダウンリストから登録した変数を参照するスコープの種類を選択します。同名の変数がある場合も、スコープを指定してウォッチする変数を区別できます。
選択できるスコープの種類を以下に示します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 412 of 479

High-performance Embedded Workshop V.4.09

17.

スコープ
[Current Scope]

デバッグ機能説明
プログラムカウンタの指すアドレスから参照可能な範囲をスコープとします。
プログラム実行中は表示されません。
グローバル変数を対象とし、全モジュールをスコープとします。

[Global]static で宣言したグローバル変数は検索範囲対象外とします。
ファイルスコープ名：ロードモジュール名

スタティック変数を対象とし、選択しているファイルスコープをス
コープとします。
関数内で宣言したスタティック変数、および[Global]で検索対象となるグローバル変数は検索範囲対象外とします。

登録した変数のデフォルトのスコープは、プログラムが実行されているかどうかに応じて以下のようになります。
プログラムの状態

4.

スコープ

停止中

[Current Scope]

実行中[Global][詳細]ボタンをクリックすると[スコープ設定]ダイアログボックスが開きます。[シンボル登録]ダイア
ログボックスの[スコープ]ドロップダウンリストと同様、登録した変数を参照するスコープを選択できます。[スコープ設定]ダイアログボックスでファイルスコープを設定する場合、ソースファイルの絶対パスを確認したり、[フィルタ]に文字列を入力してファイルスコープ名を抽出してから設定できます。絶対パスは、使用しているツールチェインによっては表示されない場合があります。

ウォッチウィンドウで登録した変数はセッションファイルに保存されます。
注：
登録した変数がローカル変数で現在のスコープにない場合、ウォッチウィンドウに登録しますが、値は"Notavailable now."を表示します。

(3)

変数名を編集する

ウォッチウィンドウで変数名を編集します。構造体やポインタなどのように展開表示が可能な変数の場合、展開したときに表示されるサブアイテムの名前は編集できません。
変数名を編集するには以下のいずれかの方法で[シンボル名の編集]ダイアログボックスを開きます。
•[Name]カラムをダブルクリックします。

•

変数名を表示している変数行を右クリックしポップアップメニューを表示します。[シンボル名の編集]を選択します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 413 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能[変数または式]に変数名を入力して[OK]ボタンをクリックします。

ウォッチウィンドウを更新し、新しい変数名を表示します。

注：
以下の場合、変数名は編集できません。
•

ユーザプログラムを実行している。

•

複数の変数を選択している。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 414 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能変数を展開する(4)

変数がポインタ、配列、または構造体の場合、その名前の左側にプラス(+)の展開記号を表示します。変数を展開できることを意味します。変数を展開するには、プラス記号(+)をクリックします。展開した変数は、タブ1
つ分インデントを付けて、その要素(構造体または配列の場合)またはデータ値(ポインタの場合)を表示し、プラス記号がマイナス記号に変わります。変数が要素にポインタ、構造体、または配列を含む場合、その横に展開記号を表示します。
展開した変数を元に戻すには再び展開記号をクリックします。その要素は元に戻りマイナス記号はプラス記号に戻ります。
また、変数を選択した状態で数字キー（1〜9）を押すと、その数字の階層分変数を展開できます。

変数の値を編集する(5)

ウォッチウィンドウで変数の値を編集します。
変数の値を編集するにはウォッチウィンドウで変数の値を編集するには次の方法があります。
•[Value]カラムでインプレース編集します。

•

以下のいずれかの方法で[値の編集]ダイアログボックスを開きます。
o[Value]カラムをダブルクリックする。

o

値を表示している変数行で"Enter"キーを押す。

o

値を表示している変数行を右クリックしポップアップメニューを表示する。[値の編集]を選択する。

[新しい値]に値を入力して[OK]ボタンをクリックします。
ウォッチウィンドウを更新し、新しい値を表示します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 415 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能変数のスコープを設定する(6)

ウォッチウィンドウは、登録したシンボルのスコープを[Scope]カラムに表示します。
変数のサブアイテムはルートアイテムのスコープに準じており、スコープを表示しません。
[Scope]カラムでは、登録した変数を参照するスコープを指定できます。同名の変数がある場合も、スコープを指定してウォッチする変数を区別できます。
選択できるスコープの種類を以下に示します。
スコープ[Current Scope]

説明プログラムカウンタの指すアドレスから参照可能な範囲をスコープとします。
プログラム実行中は表示されません。
グローバル変数を対象とし、全モジュールをスコープとします。

[Global]static で宣言したグローバル変数は検索範囲対象外とします。
ファイルスコープ名：ロードモジュール名

スタティック変数を対象とし、選択しているファイルスコープをスコープとします。
関数内で宣言したスタティック変数、および[Global]で検索対象となるグ
ローバル変数は検索範囲対象外とします。

変数のスコープを設定するにはウォッチウィンドウで変数のスコープを設定するには次の方法があります。
•[Scope]カラムでインプレース編集します。リストボックスの右側にあるボタンをクリックし、リストを表示します。リストからスコープを選択します。

•

以下のいずれかの方法で[スコープ設定]ダイアログボックスを開きます。
o[Scope]カラムをダブルクリックする。

oスコープを表示している変数行を右クリックしポップアップメニューを表示する。[スコープ設定]を選択する。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 416 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能1.

[変数名]に表示している変数のスコープを[スコープ]から選択します。

2.

[スコープ]でロードモジュール名を選択した場合、[ファイルスコープ]からファイルスコープを選択します。[フィルタ]に文字列（大文字と小文字を区別しません）を入力し、ファイルスコ
ープ名を抽出してから選択できます。

注：
ウォッチウィンドウに設定されている変数のスコープがダウンロードモジュールと一致しない場合、その変数の[Scope]カラムがハイライト表示されます。ハイライト表示された変数のスコープを再設定してください。

(7)

変数を削除する

ウォッチウィンドウで特定の変数を削除するには、その変数を選択しポップアップメニューから[削除]を選択します。変数を削除し表示内容を更新します。
すべての変数を削除するには、ポップアップメニューから[全シンボル削除]を選択します。すべての変数を削除し表示内容を更新します。

(8)

表示基数を変更する

ウォッチウィンドウで、変数を選択してポップアップメニューから[基数]を選択すると、サブメニューで変数の表示基数を変更できます。
以下のいずれかが選択できます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 417 of 479

High-performance Embedded Workshop V.4.09[16進数表示]16進数で表示（デフォルト）[10進数表示]10進数で表示[8進数表示]8進数で表示[2進数表示]2進数で表示(9)17.

デバッグ機能初期表示基数を設定する

ウォッチウィンドウで、変数を選択してポップアップメニューから[基数 -> 初期表示の設定]を選択すると、[初期表示基数]ダイアログボックスが開きます。

リストボックスで基数を選択してください。次回登録時より、指定した基数で変数が表示されます。

(10) 表示内容をファイルに保存する
ウォッチウィンドウの表示内容をファイルに保存するには、ポップアップメニューの[保存]を選択します。
[保存]を選択すると、[名前を付けて保存]ダイアログボックスが開きます。ファイル名を指定し、ウォッチウ
ィンドウに表示している内容を保存します。[Append]チェックボックスをチェックすると追加書き込みし、チェックしないと上書きします。

(11) メモリウィンドウを表示する
選択している変数が割り付いているメモリ領域をメモリウィンドウに表示できます。ウォッチウィンドウのポップアップメニューから[メモリウィンドウに移動]を選択すると、メモリウィンドウを開きます。
ウォッチウィンドウに表示している変数をメモリウィンドウの[Address]カラムへドラッグアンドドロップす
ると、メモリウィンドウの表示アドレスを変数のアドレスに簡単に変更できます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 418 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能異なるスコープに同名の変数が定義されている場合、メモリウィンドウで参照するメモリ領域は、プログラム
カウンタの指すアドレスから参照可能な範囲になります。

(12) リアルタイム更新を設定する
ウォッチウィンドウの変数で、変数名の左に表示している"R"マークは、その変数がリアルタイムに更新できることを示します。
リアルタイム更新はウォッチウィンドウのポップアップメニューで設定します。
自動更新有効化

選択している変数の"R"マークが太字になり、リアルタイム更新します。

全シンボル自動更新有効化

すべての変数の"R"マークが太字になり、リアルタイム更新します。

自動更新無効化

選択している変数の"R"マークが中抜きになり、リアルタイム更新を解除します。

全シンボル自動更新無効化

すべての変数の"R"マークが中抜きになり、リアルタイム更新を解除します。

プログラム実行中、リアルタイム更新を有効に設定した変数の値を編集できます。

(13) 更新間隔を設定する
ウォッチウィンドウの表示内容をユーザプログラム実行中に自動的に更新する間隔を設定できます。
機能のサポートはデバッガに依存します。
更新間隔を設定するには
1.

ウィンドウ内で右クリックしポップアップメニューを表示します。

2.

[更新間隔設定]を選択します。[表示更新間隔設定]ダイアログボックスが開きます。

3.

更新間隔を10ms単位で入力します。更新間隔のデフォルト値は100msです。更新間隔の指定可能範囲
はデバッガに依存します。

4.

[OK]ボタンをクリックします。

指定した更新間隔は、ウォッチウィンドウのタブ間で共通に使用します。
プログラム実行時の状態によっては、実際の更新間隔が設定した値よりも大きくなることがあります。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 419 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能(14) 値更新を記録する
ウォッチウィンドウでリアルタイム更新を設定した変数は、値の変化をファイルに記録できます。
値更新の記録を開始するには
1.

ウィンドウ内で右クリックしポップアップメニューを表示します。

2.

[値更新記録]を選択し、サブメニューから[記録開始]を選択します。[記録設定]ダイアログボックスが
開きます。

3.

[記録設定]ダイアログボックスでは、記録方法を指定します。

4.

[記録シート]で値更新を記録するシートを選択してください。同時に記録できるシートは1枚です。
なお、[記録シート]には[記録開始]ダイアログボックス表示時に自動更新が設定された変数が存在する
シート名のみが表示されます。

5.

[ファイル名]で記録するファイル名を入力してください。[ファイル名]にプレースホルダを挿入するには、プレースホルダボタンをクリックし、ポップアップメニューからプレースホルダを選択します。
ファイルを参照するには[参照]ボタンをクリックします。

6.

[追記]チェックボックスをオンにすると、入力したファイルに追記します。デフォルトはオフです。

7.

[タイムスタンプ]チェックボックスをオンにすると、タイムスタンプ（ms単位）をファイルに記録します。デフォルトはオフです。

8.

[OK]ボタンをクリックすると、記録状態になります。
ただし、次の場合は記録状態になりません。

•[追記]チェックボックスがオンの場合、[ファイル名]に入力したファイルに既に記録されている変数と、[記録シート]領域で選択したシートの記録対象変数が一致しない。または、それらの表示基数が一致しない。

記録状態では、以下のタイミングで変数の値をファイルに記録します。
•

実行中の自動（リアルタイム）更新•

実行停止時の値更新

•

値の編集時

•

ウィンドウを操作したことによる表示の更新時

リアルタイム更新の記録を終了するには1.

ウィンドウ内で右クリックしポップアップメニューを表示します。

2.

[値更新記録]を選択し、サブメニューから[記録終了]を選択します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 420 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能

また次の場合、自動的に記録を停止します。
•

ダウンロード、およびアンロード時•

値更新記録の対象となっている変数の展開が閉じた。

•

値更新記録の対象となっている変数の表示基数を変更した。

•

値更新記録の対象となっているシートで新たにリアルタイム更新対象変数を追加した。

•

値更新記録の対象となっている変数を並び替えた。

•

値更新記録の対象となっている変数のリアルタイム更新を解除した。

(15) テキストの色を変更する
ウォッチウィンドウは、表示しているテキストの色およびフォントを[表示形式]ダイアログボックスでカスタマイズできます（下表のカテゴリの"Text"）。
さらに、ウォッチウィンドウの[Value]カラムのアクセス属性別または値の変更により、該当部分の色を[表示形式]ダイアログボックスでカスタマイズできます。
既存の色をカスタマイズするには
1.

[基本設定 -> 表示の形式]を選択し、[表示形式]ダイアログボックスを開きます。

2.

[ウォッチ]アイテムをダイアログボックスの左側のツリーから選択し展開します。

3.

色を変更したいカテゴリを選択します。以下の表に示すカテゴリから選択できます。

カテゴリ

カスタマイズ対象

カラータブの前面の色 カラータブの背景の色（デフォルト）（デフォルト）

Text

テキスト

黒

白

書き込み *

ライトアクセスされたメモリ

黒赤

読み込み *

リードアクセスされたメモリ

黒

緑

変更 *

変数の値、または割付け位置に変更があった場合の色

赤

白

注：
*. 機能のサポートはデバッガに依存します。
4.

[カラー]タブの[前面]リストと[背景]リストの選択を変更します。

5.

[OK]ボタンをクリックします。

(16) エンコード形式を設定する
変数値が文字、文字列の場合にUTF-8として表示するには[基本設定 -> オプション]を選択し、[オプション]
ダイアログボックスを開きます。
[デバッグ]タブを選択し、[エンコード形式]を[UTF-8]にします。
これで、ウォッチウィンドウは変数の値をUTF-8として表示します。
[エンコード形式]を[ローカルコードページ]（デフォルト）にした場合は、ASCIIおよびシフトJISコードとして表示します。
注:
ウォッチウィンドウではウィンドウ内に表示するフォントのデフォルトが"Courier New"となっており、UTF-8
やシフトJISコードで表現される日本語文字等に対応していません。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 421 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能これらの文字コードを表示する場合は[表示形式]ダイアログボックスで日本語文字に対応したフォント(MS P
ゴシックなど)に変更してご使用ください。

(17) 変数をソートする[Name]、または[Address]カラムのヘッダをクリックすると変数をソートします。1回目のクリックで昇順に、2回目のクリックで降順にソートします。以後、交互に繰り返します。

17.18.3.4

ローカルウィンドウ

ローカルウィンドウを開くことにより、ローカル変数の一覧とそれらの値を参照できます。

ローカルウィンドウを開く(1)

ローカルウィンドウを開くには、[表示 -> シンボル -> ローカル]を選択するか、[ローカル]ツールバーボタン()をクリックします。

ウィンドウの構成•

現在のローカル変数を表示します。プログラムをデバッグしていくに従い、実行から停止またはブレークした後、ローカルウィンドウを更新して現在のローカル変数とその値を表示します。ローカル変数を定義した時点で初期化していないと、ローカル変数に値を代入するまでローカルウィンドウの値は不定となります。

•

アブソリュートファイル(*.abs)に含まれるデバッグ情報によって、現在のPC位置から関数内にあるローカル変数に関連付けることができない場合は空白となります。

•[Value]カラムをダブルクリックすると、変数の値を変更するダイアログボックスが開きます。（「マクロの記録」）

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 422 of 479

High-performance Embedded Workshop V.4.09•

17.

デバッグ機能[Value]カラムでは、インプレース編集により変数の値を変更できます。（「マクロの記録」）

ウィンドウのオプション
ウィンドウ内で右クリックすると、使用可能なオプションをポップアップメニューで表示します。
本ウィンドウは、基本的なオプションをツールバーに割り付けています。
[ツールバー表示]、[ツールバーのカスタマイズ]は、ツールバー内で右クリックしても、ポップアップメニュ
ーを表示します。
ポップアップメニューオプション

ツールバーボタン

マクロの記録機能選択しているローカル変数の値を変更するダイ

値の編集

アログボックスを開きます。
基数

16 進数表示-

16 進数で表示します。

10 進数表示-

10 進数で表示します。

8 進数表示-8 進数で表示します。

2 進数表示-2 進数で表示します。

-

選択部分をコピーし Windows® クリップボー

コピー

ドに貼り付けます。
ツールバー表示--

ツールバー表示/表示なしを切り替えます。

ツールバーのカスタマイズ--

ツールバーボタンをカスタマイズします。

ローカル変数の値を編集する(2)

ローカルウィンドウでローカル変数の値を変更できます。
ローカル変数の値を編集するにはローカルウィンドウでローカル変数の値を編集するには次の方法があります。
•[Value]カラムでインプレース編集します。

•

以下のいずれかの方法で[値の編集]ダイアログボックスを開きます。
o[Value]カラムをダブルクリックする。

o

値を表示しているローカル変数行を右クリックしポップアップメニューを表示する。ポップアップメ
ニューから[値の編集]を選択する。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 423 of 479

High-performance Embedded Workshop V.4.09

17.

デバッグ機能[新しい値]に値を入力して[OK]ボタンをクリックします。
ローカルウィンドウを更新し、新しい値を表示します。

(3)

表示基数を変更する

ローカルウィンドウで、変数を選択してポップアップメニューから[基数]を選択すると、サブメニューで変数の表示基数を変更できます。
以下のいずれかが選択できます。
[16進数表示]16進数で表示（デフォルト）[10進数表示]10進数で表示[8進数表示]8進数で表示[2進数表示]2進数で表示(4)

エンコード形式を設定する

変数値が文字、文字列の場合にUTF-8として表示するには[基本設定 -> オプション]を選択し、[オプション]
ダイアログボックスを開きます。
[デバッグ]タブを選択し、[エンコード形式]を[UTF-8]にします。
これで、ローカルウィンドウは変数の値をUTF-8として表示します。
[エンコード形式]を[ローカルコードページ]（デフォルト）にした場合は、ASCIIおよびシフトJISコードとして表示します。
注:
ローカルウィンドウではウィンドウ内に表示するフォントのデフォルトが"Courier New"となっており、UTF-8
やシフトJISコードで表現される日本語文字等に対応していません。
これらの文字コードを表示する場合は[表示形式]ダイアログボックスで日本語文字に対応したフォント(MS P
ゴシックなど)に変更してご使用ください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 424 of 479

High-performance Embedded Workshop V.4.09

18.

18.

同期デバッグ機能

同期デバッグ機能

マルチコアマイコンのデバッグのために同期デバッグ機能をサポートします。
本機能を用いることで、マルチコアでプログラムを実行し、コア間で共通のデバッグ動作(実行、ステップ、プログラムの停止等)を同期できます。[同期デバッグ]ダイアログボックスを使用して、同期デバッグシステムの構成や起動を行うことができます。
同期デバッグに関する設定はSDOファイルに保存されます。SDOファイルは以下の"Sync"ディレクトリに置かれます。
"<Local setting directory>\Renesas\HEW\hew_001\Sync"<Local setting directory>は通常、Windows® により以下のように設定されます。
Windows® XP operating system:"C:\Documents and Settings\<ユーザ名>\Local Settings\Application Data"
Windows Vista® またはWindows® 7 operating system:"C:\Users\<ユーザ名>\AppData\Local"
注：
日本語フォルダを含むフォルダ階層にHigh-performance Embedded Workshopをインストールしている場合、同期デバッグ機能は使用できません。

18.1

同期デバッグダイアログボックス[デバッグ]メニューから[同期デバッグ]を選択し、[同期デバッグ]ダイアログボックスを開きます。
High-performance Embedded Workshopの起動時やワークスペースを開いているときにもこのダイアログを開くことができます。また、High-performance Embedded Workshopの[ようこそ!]ダイアログボックスから本ダイア
ログボックスを開くこともできます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 425 of 479

High-performance Embedded Workshop V.4.09

18.

同期デバッグ機能

同期デバッグ設定を管理する

18.1.1[現在の同期デバッグ設定]ドロップダウンリスト[同期デバッグ]ダイアログボックスの最上部にあるドロップダウンリストには、Syncディレクトリにある同期
デバッグ設定ファイルが表示されます。
ダイアログボックスの設定を別の同期デバッグ設定に変更するには、ドロップダウンリストでその同期デバッ
グ設定を選択してください。同期デバッグ設定を選択した場合、現在の設定は自動的に保存されます。
新しい同期デバッグ設定を作成するには
以下のようにして新しい同期デバッグ設定を作成できます。
1.

[新規]ボタンをクリックします。

2.

[同期デバッグ設定の追加]ダイアログボックスが開くので、同期デバッグ設定ファイルの名前を入力します。Windowsのファイル名として使用可能な文字のみを入力できます。ファイル名には100文字の制限があります。

3.

OKボタンをクリックします。

新しい同期デバッグ設定用に".SDO"ファイルが自動的に作成され、Syncディレクトリに保存されます。新しい
同期デバッグ設定は[現在の同期デバッグ設定]ドロップダウンリストに追加され、現在の同期デバッグ設定として選択されます。ダイアログボックスの他のすべてのコントロールはデフォルト状態になります。
既存の同期デバッグ設定を別のファイル名で保存するには「名前を付けて保存」動作と同じ働きをします。現在のダイアログボックスの設定を新しい同期デバッグ設定として保存するには以下のようにしてください。
1.

[名前を付けて保存]ボタンをクリックします。

2.

同期デバッグ設定ファイルの新しい名前を入力します。

3.

[保存]ボタンをクリックします。

同期デバッグ設定をSyncディレクトリに保存した場合、その同期デバッグ設定は[現在の同期デバッグ設定]ドロップダウンリストに追加され、新しい同期デバッグ設定と同様に選択されますが、ダイアログボックスのコ
ントロールはデフォルトに戻りません。また、ファイルを別の場所に保存することもできます(例えば、ネッ
トワークドライブに保存して他のHigh-performance Embedded Workshopユーザと共有することも可能です)。ただし、この場合、同期デバッグ設定はドロップダウンリストに追加されません。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 426 of 479

High-performance Embedded Workshop V.4.09

18.

同期デバッグ機能

同期デバッグ設定をインポートするにはHigh-performance Embedded Workshopに同期デバッグ設定をインポートするには、([同期デバッグ]ダイアログ
ボックスを開く前に)同期デバッグ設定のSDOファイルをSyncディレクトリにコピーするか、ダイアログボッ
クスで以下の操作を行ないます。
1.

[インポート]ボタンをクリックします。

2.

インポートしたい同期デバッグ設定ファイルをブラウズします。

3.

[インポート]ボタンをクリックします。

ファイルがSyncディレクトリにコピーされ、同期デバッグ設定はドロップダウンリストに追加されます。ドロップダウンリストでインポートした同期デバッグ設定が選択され、読み込まれます。
同期デバッグ設定を削除するには
同期デバッグ設定を削除するには、([同期デバッグ]ダイアログボックスを開く前に)Syncディレクトリから同期デバッグ設定のファイルを削除するか、以下のように操作します。
1.

ドロップダウンリストから削除したい同期デバッグ設定を選択します。

2.

[削除]ボタンをクリックします。

同期デバッグ設定はドロップダウンリストから削除され、ファイルがSyncディレクトリから削除されます。ドロップダウンリスト中の次の同期デバッグ設定(アルファベット順)が選択され、読み込まれます。

18.1.2

同期するセッションを定義する

同期するセッションリスト
ダイアログボックスの中央にあるリストボックスは同期するセッション(通常、High-performance Embedded
Workshopワークスペース内のデバッグセッションに対応します)についての情報を示します。
ダイアログボックスを初めて開いた時には、リストはローカルPC上で動作しているすべてのHigh-performance
Embedded Workshopアプリケーションで開いているすべてのセッションを表示します。同期デバッグ設定の選択を変更したり、新しい同期デバッグ設定を作成したりした時も同様の設定になります。これは、マルチコアの同期デバッグ設定のセットアップを簡単にするためです。
例えば、異なるHigh-performance Embedded Workshopアプリケーションで複数のセッションを開いた上で、ある1つのアプリケーションで[同期デバッグ]ダイアログボックスを開き、各セッションを個別にセッションリス
トに追加することなく、同期デバッグを開始することが可能です。
プラットフォーム(またはマルチコアプラットフォーム上のコア)は、High-performance Embedded Workshopのデ
バッグセッションを最初に作成しないと同期できません。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 427 of 479

High-performance Embedded Workshop V.4.09

18.

同期デバッグ機能

注:
セッションリスト中のセッションがプラットフォームと接続中だった場合、セッションリストは読出し専用になります。セッションの追加や変更、削除はできません。また、プラットフォームとすでに接続しているセッションはリストに自動的に追加されません。
リストの各エントリは以下の情報を含みます。
Debugger ID:

独自のID。デバッグセッションを特定できるものに設定してください。

Status:

下記のいずれかになります。
Not open:

セッションは現在High-performance Embedded Workshopアプリケーションで開いていません。[同期]ボタンがクリックされたときに開きます。

Not connected:

セッションは現在プラットフォームと接続していません。

Break:

セッションはプラットフォームと接続しています。ターゲットプログラムは動作していません。

Running:

セッションはプラットフォームと接続しています。ターゲットプログラムが実行中です。

Options:

同期デバッグを開始した時に、セッションがどのように使われるかを指定するプラットフォー
ム固有のオプションです。通常のデバッグ時には、"Debug"を選択してください。
セッションと関連するプラットフォームの型。下記のいずれかになります。

Type:

Single core:

通常のシングルコアプラットフォーム

Multi core:

マルチコアプラットフォーム

Workspace:

セッションを含むワークスペースファイルの絶対パスファイル名

Session:

ワークスペース内のセッション名

リストにセッションを追加するには
1.

[追加]ボタンをクリックします。

2.

有効なHigh-performance Embedded Workshopワークスペースファイルを入力するかブラウズします。

3.

ワークスペース内のプロジェクトを選択します。

4.

プロジェクト内のセッションを選択しします。

5.

OKボタンをクリックします。

ワークスペースとプロジェクトとセッションの組み合わせを指定します。これは同期デバッグダイアログボッ
クスのセッションリストに追加されます。セッションにはプラットフォーム名(通常シングルコアプラットフ
ォームの場合)やコア名(マルチコアプラットフォームの場合)に基づいたDebugger IDが与えられます。
R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 428 of 479

High-performance Embedded Workshop V.4.09

18.

同期デバッグ機能

注：
指定されたワークスペースは、最新版のHigh-performance Embedded Workshopのバージョンで保存されている必要があります。また、保存した後に新しい位置にコピーされていてはいけません。旧バージョンで保存されたファイル、あるいは保存後にコピーされたファイルをこのダイアログボックスで使用可能にするにはHigh-performance Embedded Workshop (ワークスペースファイルをアップデートするように)でそのようなワー
クスペースを開いて、閉じなければなりません。
Debugger IDを変更するには
1.

変更するセッションをリストで選択します。

2.

[変更]ボタンをクリックします。

3.

セッションの新しいユニークなIDを入力します。

4.

OKボタンをクリックします。

リスト上のDebugger IDが更新されます。
同期デバッグ中は、Debugger IDは変更できません。
セッションのオプションを変更するにはセッションのオプションを変更する方法は2つあります。
方法1：
1.

リストからセッションを選択します。

2.

[変更]ボタンをクリックします。

3.

[CPUモード]ドロップダウンリストから新しいオプションを選択します。

4.

OKボタンをクリックします。

方法2：
1.

リストからセッションを選択します。

2.

[Options]のエントリをクリックします。ドロップダウンリストが表示されます。

3.

ドロップダウンリストから新しいオプションを選択します。

同期デバッグ中は、セッションのオプションは変更できません。
R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 429 of 479

High-performance Embedded Workshop V.4.09

18.

同期デバッグ機能

セッションをリストから削除するには
1.

削除するセッションを選択します。

2.

[削除]ボタンをクリックします。

セッションはリストから削除されます。

18.1.3

同期オプションを設定する

概要
特定のデバッグ動作(例えば、[実行])が実行されたセッションから別のセッションへ、その動作を同期させる
設定が有効な場合、その動作は両方のセッションで実行されます。どのセッションでその動作を実行する必要があるかを理解するために同期設定は複数のセッションでチェックされます。同期設定には単方向と双方向が
あります。
例1:
2つのセッションがそれぞれ「CORE0」と「CORE1」というIDで同期デバッグ中であるとします。「CORE0」から「CORE1」への[実行]デバッグ動作の単方向同期設定が一つだけあります。[実行]が「CORE0」セッションで実行された場合、[実行]は両方のセッションで実行されます。[実行]が「CORE1」セッションで実行された場合、[実行]は「CORE1」でしか実行されません。
例2:
4つのセッションがそれぞれ「CORE0」、「CORE1」、「CORE2」、「CORE3」というIDで同期デバッグ中であるとします。[実行]デバッグ動作の双方向同期設定がすべてのセッション間で存在します。[実行]がどのセッションで実行されても、すべてのセッションで[実行]は発生します。

同期デバッグ方法
ダイアログボックスで3つの同期デバッグ方法を指定できます。
なし:

同期はありません。

すべてのデバッガで同期:チェックされた動作に関して、すべてのセッション間で双方向の同期を設定します。

マスタデバッガ:

チェックされた動作に関して、指定されたマスタデバッガから他のすべてのデバッガへの単方向の同期を設定します。ドロップダウンリストでマスタデバッ
ガとなるデバッガを指定します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 430 of 479

High-performance Embedded Workshop V.4.09

18.

同期デバッグ機能

同期するデバッグ機能
ここでのチェックボックスは同期するデバッグ動作を示します。[リセット]、[実行]、[ブレーク/プログラムの停止]、[ステップ]は必要に応じて同期・非同期を設定できます。[接続]、[ダウンロード]、[初期化]の同期・非
同期はデバッグするプラットフォームによって決まります。非マルチコアプラットフォームでの状態は常にオフです。
プラットフォームの設定
マルチコアプラットフォームのデバッグ時、通常はユーザが指定できる複数の同期が自動的に有効になっていることもあります。オプションのチェックボックスがチェックされてグレーになっている場合、その動作が常に同期されることがプラットフォームから指定されています。
注:• プラットフォームによる設定はSDO(同期デバッグ設定)ファイルを書き換えることで無効にはできません。
• プラットフォームによる設定は選択した同期デバッグ方法より優先します。これらの動作は、「なし」や「マスタデバッガ」が選択されていても、すべてのデバッガで常に同期化されます。

18.1.4

メモリ更新オプションを設定する

このオプションがチェックされている場合、全セッションのメモリデータ（メモリウィンドウ、ウォッチウィンドウ等）を表示するすべてのHigh-performance Embedded Workshopのウィンドウは、同期デバッグ中のセッションのいずれかのメモリが変更された時、必ず更新されます（すなわち、プラットフォームからメモリを読み出します）。
オプションが選択されていない場合、メモリが変更された時にはローカルセッションのメモリウィンドウのみが更新されます。セッション間でメモリを共有している場合、他のセッションのメモリ関連ウィンドウで正しいメモリ内容を表示するには、それらのウィンドウでマニュアルリフレッシュを実行する必要があります。
セッション間でメモリを共有するのは通常マルチコアプラットフォームをデバッグする時のみです。セッショ
ン間でメモリを共有しない場合（複数のシングルコアプラットフォームをデバッグする場合等）、あるセッシ
ョンにおける動作は他のセッションのメモリを変更しないため、本チェックボックスの状態は関係ありません。

18.1.5

同期デバッグモード

デバッグ時のモードを選択してください。
Internal:

指定されたセッションは1つのHigh-performance Embedded Workshopアプリケーションで開かれます。このモードはすべてのセッションが同じHigh-performance Embedded Workshopワークスペース中にある場合にのみ選択可能です。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 431 of 479

High-performance Embedded Workshop V.4.09

18.

同期デバッグ機能指定されたセッションは異なるHigh-performance Embedded Workshopアプリケーションで開かれParallel:

ます。
注：Internalモードは、同期するセッションのリスト中のすべてのセッションが同じワークスペースにある場合にのみ選択可能です。異なるワークスペースからのセッションが選択された場合には、Internalモードは使用できません。

同期デバッグを開始する

18.1.6

同期デバッグの設定が終了したら、[同期]ボタンをクリックしてデバッグを開始してください。
Parallelモードが選択されている場合、[同期デバッグ]ダイアログボックスを開いていたHigh-performance
Embedded Workshopから1つのセッションが開かれ、残りのセッションのために新しいHigh-performance
Embedded Workshopが起動します。
Internalモードを選択した場合、すべてのセッションに共通するワークスペースが開きます。
同期デバッグ時のHigh-performance Embedded Workshopの使用方法の詳細については、「18.2 同期デバッグ時にHigh-performance Embedded Workshopを使用する」を参照してください。

同期デバッグを更新する

18.1.7

同期デバッグ中に[同期デバッグ]ダイアログボックスを開いた時、[同期]ボタンの代わりに[更新]ボタンがあります。[同期デバッグ]ダイアログボックスの設定を変更した場合、[更新]ボタンをクリックすると、新しい設定にしたがって更新されます。Parallelモード時で追加のHigh-performance Embedded Workshopアプリケーショ
ンを開くことも含みます。
同期デバッグ時のHigh-performance Embedded Workshopの使用方法の詳細については、「18.2 同期デバッグ時にHigh-performance Embedded Workshopを使用する」を参照してください。

同期デバッグを停止する

18.1.8

同期デバッグ中に[同期デバッグ]ダイアログボックスを開いた時、[非同期]ボタンが有効になっています。同期デバッグ機能を停止するには、[非同期]ボタンをクリックしてください。同期化されていた、あらゆるHigh-performance Embedded Workshopアプリケーションはそれぞれのプラットフォームから接続を切断され、再び独立して機能します。Debuggersタブはワークスペースウィンドウから削除されます。セッションの動作は非同期になります。また、どのHigh-performance Embedded Workshopアプリケーションも終了しません。

18.2

同期デバッグ時にHigh-performance Embedded Workshopを使用する

同期デバッグモードでHigh-performance Embedded Workshopを使用する主な目的は、通常マルチコアプラット
フォームに接続された異なるHigh-performance Embedded Workshopセッションで主要なデバッグ操作を同期化することです。
High-performance Embedded Workshopの機能は、ParallelモードとInternalモードで共通する部分と相違する部分があります。本項ではそれらについて説明します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 432 of 479

High-performance Embedded Workshop V.4.09

18.2.118.

同期デバッグ機能

共通の機能

Debuggersタブ
同期デバッグを開始すると、Debuggersタブがワークスペースウィンドウに追加されます。同期するセッショ
ンごとに異なる項目があります。各項目のテキストは[同期デバッグ]ダイアログボックスで指定された
Debugger IDです。各項目のアイコンはセッションの現在の状態を示します。以下のステータスアイコンが使用可能です。
セッションはプラットフォームと接続されていません。
セッションは現在停止している（つまり、動作していない）プラットフォームと接続されています。
セッションは現在動作しているプラットフォームと接続されています。
Debugger IDのアイコンを右クリックすると、以下のメニュー項目が表示されます。
CPUのリセット実行
リセット後実行
ステップイン
ステップアウト
ステップオーバ
プログラムの停止
ドッキングビュー
非表示
プロパティ
メニュー上でデバッグ操作を選択した時、選択した（すべての）セッションでのみ実行されます。デバッグ操
作をDebuggersタブで実行した場合、すべての同期設定は無視されます。マルチコアプラットフォームのデバ
ッグ時、いくつかのデバッグ操作は無効になります。これらは、ハードウェアにより常に同期されるデバッグ操作です。つまりいくつかのデバッグ操作はプラットフォームのコアで個々に実行することができないことを意味します。
選択したセッションでその動作を実行できない場合は、メニュー項目も無効になります。例えば、動作しているセッションを右クリックした場合、[プログラムの停止]メニュー項目のみが有効になります。
[プロパティ]メニュー項目を使ってセッションの情報を取得できます。選択した場合、以下の情報を含んだダ
イアログボックスが表示されます。
：ワークスペース名、プロジェクト名、セッション名。
[アクティブセッションに設定]メニュー項目はInternalモードでのデバッグ時にのみ有効になります。選択した場合、選択したセッションは現在アクティブなセッションになります。詳細については、「18.2.3 InternalモーR20UT0372JJ0100 Rev.1.00
2011.02.01

Page 433 of 479

High-performance Embedded Workshop V.4.09

18.

同期デバッグ機能

ドの機能」を参照してください。
セッションの動作同期できる動作を下の表に示します。同期する動作は同期デバッグダイアログボックスの設定により決まります。表の各項目の意味は以下のとおりです。
動作：

動作名。

オプション： 動作を同期化するために、同期デバッグダイアログボックスでチェックしておくべきチェッ
クボックスのオプション（単数または複数）。
方法：

動作がHigh-performance Embedded Workshopでどのように実行されるかの説明。

効果：

動作を実行した効果（すべての同期するセッションにおいて）。

[初期プラットフォーム]とは、動作が開始したセッションに接続したプラットフォームを意味します。実行する動作によって、本セッションにおける効果は他のセッションでの効果と異なります。
動作
Reset

オプション
リセット

CPU

方法

効果

"デバッグ->CPU のリセット"メニュー。

すべての同期化されたプラットフォームをCPU リセットツールバーボタン。

リセットします。

"reset"コマンド。
"ダウンロード後に CPU リセット"オプションが有効な時はダウンロード後。
Go

実行"デバッグ->実行"メニュー。

すべての同期化されたプラットフォームを実行ツールバーボタン。

実行します。

"go"コマンド。
Go Until実行"デバッグ->条件を指定して実行"メニュー。 一時的なブレークポイント群を設定した状"リセット時に main 関数の先頭まで実行"オ

態で初期プラットフォームを実行します。

プションが有効な時はリセット後。

他のすべての同期化されたプラットフォー

エディターポップアップ"カーソル位置まで

ムは通常通りに実行します。

実行"メニュー。
Reset Go

リセットと実行"デバッグ->リセット後実行"メニュー。

すべての同期化されたプラットフォームをリセット後実行ツールバーボタン。

リセットした後で実行します。

"go_reset"コマンド。

（【注】ユーザのプラットフォームによっては、本動作はリセットの後に実行を個別に実行した場合と同じでない可能性もあり
ます。）

Break

ブレーク/プロ

ブレークポイントに達したとき。

グラムの停止Halt

動作しているすべての同期化されたプラットフォームを停止します。

ブレーク/プロ"デバッグ->停止"プログラムメニュー。

動作しているすべての同期化されたプラッ

グラムの停止停止ツールバーボタン。

トフォームを停止します。

"halt"コマンド。
Step In

ステップ"デバッグ->ステップイン"メニュー。

すべての同期化されたプラットフォームにステップインツールバーボタン。

対してステップインを実施します。

"step"コマンド。
Step

ステップ

Over

"デバッグ->ステップオーバ"メニュー。

すべての同期化されたプラットフォームにステップオーバツールバーボタン。

対してステップオーバを実施します。

"step_over"コマンド。
R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 434 of 479

High-performance Embedded Workshop V.4.09

動作
Step Out

オプション
ステップ

18.

方法

同期デバッグ機能効果"デバッグ->ステップアウト"メニュー。

すべての同期化されたプラットフォームに

ステップアウトツールバーボタン。

対してステップアウトを実施します。

"step_out"コマンド。
Connect

接続"デバッグ->接続"メニュー。

すべての同期するセッションのプラットフ

接続ツールバーボタン。

ォームに接続します。

"connect"コマンドやプラットフォーム固有のコマンド。
Download ダウンロード"デバッグ->ダウンロード"メニュー項目。

すべての同期化されたプラットフォームに(file load)

ワークスペースタブ"Download modules"フモジュールをダウンロードします。モジュォルダ。

ールのファイル名は各セッションにおいて"file_load"コマンド。

同じでなければなりません。

"ターゲット接続時にダウンロード"オプシ
ョンが設定されている時は接続時。
"ビルド後のダウンロード"オプションが設定されている時はビルド後。
モジュールが High-performance Embedded
Workshop の外部で変更された時。
Initialize

初期化"デバッグ->初期化"メニュー。

すべての同期化されたプラットフォームは"initialize"コマンド。

初期化されます。

ステップに関しては、同期セッションでのステップのスタイル（ソースか命令か）はプログラムカウンタ、ス
テップモード、そして（[ステップイン]ボタンをクリックしたセッションでなく）ステップを実行するセッシ
ョンでのエディタのカーソル位置で決まります。
通常のHigh-performance Embedded Workshopのステップ実行(例えば、ツールバーボタンの[ステップイン]ボタ
ンをクリックしたように)でステップ操作がローカルに実行されたかのように、それぞれの個々のDebuggerは動作します。
ダウンロードに関しては、同期処理を開始するセッションのモジュールと同じファイル名を持つモジュールを持つセッションでのみ動作が同期化されます。セッションが1つ以上のモジュールを持つ場合は、一致するファイル名を持つモジュールだけがダウンロードされます。
表に記載した以外のHigh-performance Embedded Workshopの操作は、同期デバッグ時に行うことが可能です。
しかし、それらの動作は、同期処理を開始するセッションでのみ実行され、他のセッションでは同期実行されません。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 435 of 479

High-performance Embedded Workshop V.4.09

18.

同期デバッグ機能

デバッグの設定ダイアログボックス

同期デバッグ時、[デバッグの設定]ダイアログボックスの機能が変わります。通常デバッグ時に使用可能なオプションを全部設定することはできず、セッションごとに設定するDownload modulesのみが変更できます。ダ
イアログボックスの左側で[Multiple]を使用して複数のセッションの設定を同時に変更することが可能です。これにより、同期ダウンロードの準備が整った複数のセッションに同じモジュールを容易に追加できます。
ダウンロードモジュールを選択し、[変更]ボタンをクリックすると、[ダウンロードモジュール]ダイアログボ
ックスが開きます。このダイアログで[デバッグ情報のみのダウンロード]を設定することができます。
マルチコアデバッグですべてのコアが同じメモリ領域を共有している場合、メモリイメージは1つのセッションで一度だけダウンロードし、他のセッションではデバッグ情報だけダウンロードすることを推奨します。
ダイアログボックスのボタンの機能性は通常デバッグ時と同じです。詳細については、「17.1.4.3 デバッグの設定を変更する」を参照してください。

18.2.2

Parallelモードの機能

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 436 of 479

High-performance Embedded Workshop V.4.09

18.

同期デバッグ機能

一般的な動作
Parallelモード動作時、各セッションは異なるHigh-performance Embedded Workshopアプリケーションで開かれます。いくつかのセッションの動作が同期するだけで、通常デバッグ時と同じようにこれらのセッションは独自に使用できます。
High-performance Embedded Workshopウィンドウのタイトル
High-performance Embedded Workshopウィンドウのタイトルはアプリケーション中で開いているセッションの表示IDから始まります。アプリケーションが同期実行中、タイトルは変わりません。
同期デバッグの終了
現在のセッションを変更する動作を実行すると、High-performance Embedded Workshopアプリケーションは同期デバッグシステムから削除され、他のHigh-performance Embedded Workshopアプリケーションと非同期になります。
セッションを変更する動作は以下のとおりです。
新規ワークスペースの作成
ワークスペースを開く
ワークスペースを閉じる
アクティブプロジェクトに設定
セッションの変更

18.2.3

Internalモードの機能

概要
Internalモード動作時、すべてのセッションは1つのHigh-performance Embedded Workshopアプリケーションで開かれます。別の開いたセッションをデバッグするには、セッションを（様々な方法で）切り替えます。セッシ
ョンを切り替えて、あるセッションを選んだ時、デバッグビューはそのセッションのデータを表示するために変更され、それ以降実行される動作はそのセッション(「アクティブセッション」)上で実行されます。これにより、一つのHigh-performance Embedded Workshopアプリケーションを用いて、複数のプラットフォーム、まR20UT0372JJ0100 Rev.1.00
2011.02.01

Page 437 of 479

High-performance Embedded Workshop V.4.09

18.

同期デバッグ機能

たはマルチコアプラットフォーム上の複数のコアをデバッグできます。
High-performance Embedded Workshopウィンドウのタイトル
High-performance Embedded Workshopウィンドウのタイトルは現在のセッションの表示IDから始まります。ア
クティブセッションが変わる度にタイトルは変わります。
アクティブセッションの切り替え
アクティブセッションを切り替える方法はいくつかあります。
Debuggersタブ:

タブ中のセッションを右クリックして、"アクティブセッションに設定"を選択することで、アクティブセッションに設定できます。

アプリケーションツールバー:

Internalモードでデバッグ時、アプリケーションツールバーにドロップ
ダウンリストが追加されます。このドロップダウンリストは、同期するセッションを説明するプロジェクト／セッションの組み合わせを含みます。ある特定のセッションをドロップダウンリストから選択する
ことで、アクティブセッションをそのセッションに変更できます。

ショートカットキーの組み合わせ:"Ctrl+Shift+N"キーを同時に押すことにより、アクティブセッションを
Debuggersタブ中の次のセッションに変更できます。

OutputウィンドウInternalモード使用時、Outputウィンドウは同期するセッションごとに異なる[Debug]タブを表示します。各タブには、対応するセッションが認識できるように、セッションのプロジェクト名とセッション名があります。

制限される動作Internalモードでは、以下の機能は使用できません。
アクティブプロジェクトに設定
プロジェクトの削除
プロジェクトのアンロード
セッションの変更
コンフィグレーションの変更
同期デバッグ時、[ビルド]は現在のプロジェクトとコンフィグレーションをビルドします。
非アクティブのプロジェクトとコンフィグレーションをビルドする場合は、[複数のビルド]ダイアログボック
スを使用してください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 438 of 479

High-performance Embedded Workshop V.4.09

18.3

18.

同期デバッグ機能

同期デバッグ時にコマンドラインウィンドウを使用する

概要
同期デバッグ機能を使用時、2つの新しいコマンドが使えます。これらのコマンドにより、あるセッションで実行されたコマンドファイルが別のセッションでコマンドを実行できるように、コマンドを実行しているセッションを変えることができます。
SET_COREコマンド
短縮形: SMC
説明: 現在のセッションをコマンドラインウィンドウから設定します。これ以降のすべてのコマンドは要求されたセッションに送られます。
注: GUIから呼び出された動作は影響されません。
シンタックス: smc <Debugger ID>
パラメータ

型

<Debugger ID>

文字列

説明
セッションの ID。空の場合、コントロールはローカルセッションに戻されます。

例: smc "SH-X (core 1)"
これ以降、コマンドは"SH-X (コア1)"セッションに送られます。
SHOW_ALL_COREコマンド
短縮形: SAC
説明: 使用可能なセッションのリストを表示します。このコマンドは前回のコマンドの有効な入力のリストを取得するために使われます。表示されるセッションのリストはDebuggersタブに表示されているものと同じです。
シンタックス: sac
パラメータ
なし

型
なし

説明
使用可能なセッションのリストを表示します。

例外「SET_CORE」コマンドを使用した場合でも、いくつかのコマンドは「SET_CORE」コマンドで設定したセッションで実行されず、ローカルなセッションで実行されます。以下のコマンドには、この制限があります:"ASSEMBLE""CLOSE_TEST_SUITE""COMPARE_TEST_DATA""MEMORY_EDIT""OPEN_TEST_SUITE""REFRESH_SESSION""RUN_TEST""SET_CORE""SHOW_ALL_CORE""SUBMIT"

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 439 of 479

High-performance Embedded Workshop V.4.09

18.

同期デバッグ機能

注:「SET_CORE」コマンドで設定したセッションで、コマンドパラメータにファイル名を含むコマンドを実行する場合、ファイル名は以下のように中括弧「{」、「}」で囲んで指定してください。
file_load Elf/Dwarf2 {$(CONFIGDIR)¥¥$(PROJECTNAME).abs} 0x0 p byte

18.4

用語の解説
用語

定義内容

コア

マルチコアプラットフォーム上の個別の CPU コア。

デバッガ

特定の対象をデバッグするために High-performance Embedded Workshop アプリケー
ションから開くことができます。ワークスペースファイルとプロジェクト名、セッショ
ン名の組み合わせで指定されます。同期デバッグモードで動作時、同期化されている
High-performance Embedded Workshop アプリケーション（Parallel モードの場合）またはセッション（Internal モードの場合）を指す総称です。

デバッガ ID

High-performance Embedded Workshop GUI でセッションを独自に特定するための文字列。

同期を開始するセッション

動作が実行されたセッション。

Internal モード

1 つの High-performance Embedded Workshop アプリケーションですべてのセッションを開いた状態で同期デバッグ機能を使用しているモード。

Parallel モード

別々の High-performance Embedded Workshop アプリケーションで各セッションを開いた状態で同期デバッグ機能を使用しているモード。

ローカルセッション
プラットフォーム

ユーザが現在やりとりしているセッション。
High-performance Embedded Workshop に接続されているハードウェアまたはシミュ
レータ。シングルコアプラットフォームまたはマルチコアプラットフォーム上の個別のコアを意味することもあります。

マルチコアプラットフォーム

2 つ以上の CPU コアを持つハードウェアまたはシミュレータデバイス。同期デバッグ機
能の主な目的はユーザのマルチコアプラットフォームのデバッグをサポートすることです。

SDO ファイル

同期デバッグ設定のファイル。同期デバッグセッションを起動させるのにHigh-performance Embedded Workshop が必要とするすべての情報を含みます。同期デバッグダイアログボックスで保存されます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 440 of 479

High-performance Embedded Workshop V.4.09

19.

テクニカルサポート

19.1

バージョン情報の参照

19.

テクニカルサポート

High-performance Embedded Workshopのバージョン情報を参照できます。
バージョン情報を参照するには
1.

[ヘルプ -> High-performance Embedded Workshopのバージョン情報]を選択してください。
[High-performance Embedded Workshopについて]ダイアログボックスが開きます。著作権、バージョン
番号などを表示します。

2.

さらに[詳細>>]ボタンをクリックすると、[インストール済みパッケージ情報]に使用するコンピュータ
へインストールしているHigh-performance Embedded Workshopと連携するRenesas製品パッケージの情報（バージョン番号など）を表示します。

3.

19.2

[OK]ボタンをクリックすると、ダイアログボックスを閉じます。

アップデートの確認

High-performance Embedded Workshop製品のバージョンアップやサービスパックを確認するには
1.

[ヘルプ -> テクニカルサポート -> アップデートのWeb確認]を選択してください。

2.

デフォルトのウェブブラウザが起動して、お客さまの地域のHigh-performance Embedded Workshopダウ

3.

ンロードページを表示します。
High-performance Embedded Workshopのバグの修正や新規機能の追加の更新情報を確認してください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 441 of 479

High-performance Embedded Workshop V.4.09

19.3

19.

テクニカルサポート

不具合レポートの作成

ときには、High-performance Embedded Workshopアプリケーションで予期せぬ問題が起きるかもしれません。
問題が起きてアプリケーションが破壊されると、自動的にHigh-performance Embedded Workshopバグトラッキ
ングプログラムが起動します。これにより、バグの情報を集約でき、様々な方法でテクニカルサポートに送ることができます。このバグトラッキングプログラムは手動で起動することもできます。この方法を以下に説明します。
High-performance Embedded Workshop不具合レポートを作成するには
1.

[ヘルプ -> テクニカルサポート -> 不具合レポートの作成]を選択してください。

2.

High-performance Embedded Workshopシステムから詳細情報を生成します。これには多少時間がかかる場合があります。その後、[Submit a Bug Report]ダイアログボックスが開きます。

3.

[どのような状況、操作で起こったか記入してください。]エディットボックスに起きた問題に関する情報を入力してください。入力必須項目です。

4.

[お名前]エディットボックスにお客様の名前を入力してください。

5.

[会社URLまたは使用目的（家電品等）]エディットボックスにお客さまの会社のURLまたは開発製品の使用目的を入力してください。入力必須項目です。

6.

[国/地域]エディットボックスにお住まいの国名または地域を入力してください。入力必須項目です。

7.

報告を作成したら、[どの方法でレポートを提出しますか?]ドロップダウンリストボックスで報告を提出する方法を選択してください。印刷、電子メール、ディスクに保存の3種類があります。選択必須項
目です。

8.

[提出]ボタンをクリックすると、選択した方法で報告を提出できます。電子メールでレポートを提出する場合、[提出]ボタンをクリックした後に確認メッセージを表示します。

注：「*」のある項目は入力必須項目です。これらの項目をすべて入力すると、[提出]ボタンがクリックできるようになります。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 442 of 479

リファレンス

High-performance Embedded Workshop V.4.09

リファレンス

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 443 of 479

High-performance Embedded Workshop V.4.09

1.

メインメニュー

1.1

ファイルメニューオプション

メニュー
ファイル

メニューオプション

メインメニュー

1.

ショートカ

ツールバ

マクロ

ットキー

ーボタン

の記録 *

機能

新規作成

Ctrl+N-

新規ファイルを作成します。

開く

Ctrl+O-

ファイルを開きます。

閉じる

Ctrl+F4--

ファイルを閉じます。

新規ワークスペース---

新規ワークスペースを作成します。

ワークスペースを開く--

既存のワークスペースを開きます。

ワークスペースの保存--

ワークスペースを保存します。

旧バージョン形式でワーク

-

-

-

スペースを保存

別名または旧フォーマットでワークス
ペースを保存します。

ワークスペースを閉じる--

ワークスペースを閉じます。

新規セッション

--新規セッションを作成します。

セッションのインポート--

既存のセッションをインポートします。

セッションの保存--

現在のセッションを保存します。

名前を付けてセッションを--セッションのリフレッシュ--

現在のセッションを再ロードします。

ダウンロードモジュールの--新規モジュールをダウンロードします。

-

現在のセッションを別名で保存します。

保存

追加
上書き保存
名前を付けて保存
すべて保存

Ctrl+S--

Ctrl+Shift+-

ファイルを保存します。

-

ファイルを別名で保存します。

-

開いているすべての変更のあったファイルを保存します。

S
ページレイアウトの設定
印刷

-

-

Ctrl+P

最近使ったファイル--

最近使ったワークスペース--

最近使ったテストスイート--

最近ダウンロードしたモジ

-

-

-

印刷設定を変更します。

-

ファイルを印刷します。

-

選択したファイルを開きます。
選択したワークスペースを開きます。

-

選択したモジュールをダウンロードします。

ュール
アプリケーションの終了

選択したテストスイートを開きます。

-

-

-

High-performance Embedded
Workshop を終了します。

注：*. 一部のメニューオプションに対する操作は、マクロ生成支援機能を使用し、High-performance Embedded
Workshopコマンドラインのコマンドを記録できます。このリストでは、メニューオプションの「マクロの記録」欄にマクロの記録マーク( )を表示し、マクロファイルへ記録可能かどうかを示しています。これらの詳細は「15.5.1 マクロを記録できる機能（High-performance Embedded Workshop共通）」を参照してください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 444 of 479

High-performance Embedded Workshop V.4.09

1.2

1.

メインメニュー

編集メニューオプション

メニュー
編集

メニューオプション

ショートカ

ツールバ

マクロの

ットキー

ーボタン

記録 *

機能

元に戻す

Ctrl+Z--

最新の編集操作を取り消します。

やり直し

Ctrl+Y--

最新の取り消した編集操作をやり直
します。

切り取り

-

Ctrl+X

選択部分を削除し Windows® クリッ
プボードに貼り付けます。

コピー-

Ctrl+C

選択部分をコピーし Windows® クリ
ップボードに貼り付けます。

貼り付け

-

Ctrl+V

Windows® クリップボードの内容をコピーしてアクティブウィンドウのカーソル位置に貼り付けます。

削除

Delete--

選択部分を削除します（Windows®
クリップボードに貼り付けません）。

すべて選択

Ctrl+A--

アクティブウィンドウの内容をすべて選択します。

検索

Ctrl+F-

現在のファイルで文字列を検索します。

ファイルから検索-F4

複数のファイルで文字列を検索します。

置換

Ctrl+H--

現在のファイルで文字列を置換しま
す。

ジャンプ

Ctrl+G--

ファイルの指定した行にジャンプし
ます。

括弧の呼応
ブック

ブックマークの挿入/

マーク

削除
次のブックマーク

Ctrl+Shift+M-

括弧の組み合わせを見つけます。

Ctrl+F2-

カーソル行にブックマークを設定、または解除します。

F2-

カーソル行からファイル内の次のブックマークにジャンプします。

前のブックマーク

Shift+F2-

カーソル行からファイル内の前のブックマークにジャンプします。

すべてのブックマー

-

-

クの削除

ファイル内のすべてのブックマークを削除します。

テンプ

テンプレートの定義--

テンプレートを設定します。

レート

テンプレートの挿入

Ctrl+Shift+T-

テンプレートを挿入します。

ブレークポイントの挿入/削除

アドレスを表示している行でブレー

F9

クポイントを設定または解除します。
ブレークポイントの有効化/無

現在のブレークポイントの有効また

Ctrl+F9は無効を切り替えます。

効化
表示カラムの設定
ソースブレークポイント

-

-

-

カラムの表示状態を設定します。

Ctrl+B--[ブレークポイント]ダイアログボッ
クスを開きます。

式の評価

R20UT0372JJ0100 Rev.1.00
2011.02.01

-

-

-

式を評価します。

Page 445 of 479

High-performance Embedded Workshop V.4.09

メインメニュー

1.

注：*. 一部のメニューオプションに対する操作は、マクロ生成支援機能を使用し、High-performance Embedded
Workshopコマンドラインのコマンドを記録できます。このリストでは、メニューオプションの「マクロの記録」欄にマクロの記録マーク( )を表示し、マクロファイルへ記録可能かどうかを示しています。これらの詳細は「15.5.1 マクロを記録できる機能（High-performance Embedded Workshop共通）」を参照してください。

表示メニューオプション

1.3

メニュー
表示

メニューオプション

ショートカ

ツールバ マクロのテストイメージ

ットキー

ーボタン

記録 *1

データの保存 *2

機能

差分

-

-

-

差分ウィンドウを開きます。

マップ *3---

マップウィンドウを開きます。

コマンドラインCtrl+L-

コマンドラインウィンドウを

-

開きます。
TCL ツールキット

Ctrl+Shift+K-

詳細は別冊の「TCL/TK 添付-資料」を参照してください。
ワークスペース

ワークスペースウィンドウを

-

Alt+K

開きます。
アウトプット

Alt+O

-

*4

アウトプットウィンドウを開きます。

ステータスバー

Alt+A

-

-

ステータスバーの表示または非表示を切り替えます。

逆アセンブリ-

Ctrl+D

逆アセンブリウィンドウを開
きます。

CPU

レジスタ

レジスタウィンドウを開きまCtrl+R

す。
メモリ

メモリウィンドウを開きまCtrl+M

す。
IO

Ctrl+I

ステイタ

Ctrl+U[IO]ウィンドウを開きます。
ステイタスウィンドウを開き

-

ます。

ス
グラフ

画像 *3

ィック

コード

Ctrl+Shift+--

画像ウィンドウを開きます。

-

波形ウィンドウを開きます。

G
波形 *3

Ctrl+Shift+V

-

スタック

Ctrl+K-

トレース

スタックトレースウィンドウを開きます。

注：*1. 一部のウィンドウに対する特定の操作は、マクロ生成支援機能を使用し、High-performance Embedded
Workshopコマンドラインのコマンドを記録できます。このリストでは、メニューオプションの「マクロの記録」欄にマクロの記録マーク( )を表示し、マクロファイルへ記録可能かどうかを示しています。これらの詳細は「15.5.1 マクロを記録できる機能（High-performance Embedded Workshop共通）」を参照してください。
このリストに記載していないデバッガに依存するウィンドウでもコマンドが記録できるものがあります。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 446 of 479

High-performance Embedded Workshop V.4.09

1.

メインメニュー

これらの詳細は「15.5.2 マクロを記録できる機能（デバッガ依存）」を参照してください。
*2. 一部のウィンドウのデータは、テスト支援機能を使用し、テストイメージデータとしてテストイメージフ
ァイルに保存できます。このリストでは、テストイメージファイルに保存できるウィンドウのメニューオ
プションの「テストイメージデータの保存」欄に[ファイルの保存]マーク()を記載しています。これらの詳細は「16.6.1 テストイメージファイルに保存できる機能（High-performance Embedded Workshop共通）」を参照してください。
このリストに記載していないデバッガに依存するウィンドウでもテストイメージファイルに保存できるものがあります。これらの詳細は「16.6.2 テストイメージファイルに保存できる機能（デバッガ依存）」を参照してください。
*3. 機能のサポートはデバッガに依存します。
*4. [Build]タブまたは[Debug]タブのデータが保存可能です。

プロジェクトメニューオプション

1.4

メニュー

メニューオプション

プロジェクト

ショートカ

ツールバ マクロの

ットキー

ーボタン

-

-

アクティブプロジェ

機能

記録 *1
プロジェクトをアクティブプロジェクトに設
定します。

クトに設定
プロジェクトの挿入-

ワークスペースにプロジェクトを追加しま

-

す。
依存関係

-

-

構成の編集 *2--

プロジェクトタイプ---

新規プロジェクトタイプを作成します。

ファイルの追加---

プロジェクトにファイルを追加します。

ファイルの削除---

プロジェクトからファイルを削除します。

ファイルの拡張子---

ファイルの拡張子を定義します。

コンポーネントギャ---

オンデマンドのコンポーネントをロードまた-

依存プロジェクトを設定します。
プロジェクトの構成を編集します。

の作成

ラリ

はアンロードします。

注：*1. 一部のメニューオプションに対する操作は、マクロ生成支援機能を使用し、High-performance Embedded
Workshopコマンドラインのコマンドを記録できます。このリストでは、メニューオプションの「マクロの記録」欄にマクロの記録マーク( )を表示し、マクロファイルへ記録可能かどうかを示しています。これらの詳細は「15.5.1 マクロを記録できる機能（High-performance Embedded Workshop共通）」を参照してください。
*2. 機能のサポートはデバッガに依存します。

1.5

ビルドメニューオプション

メニュー

メニューオプション

ショートカ

ツールバ

マクロの

ットキー

ーボタン

記録 *1

-

-

ビルド

Toolchain

-

*2

コンパイル

Ctrl+F7R20UT0372JJ0100 Rev.1.00
2011.02.01

機能
ビルドオプションを設定します。
選択したファイルをコンパイルします。

Page 447 of 479

High-performance Embedded Workshop V.4.09

メニュー

メニューオプション

ショートカ

ツールバ

マクロの

ットキー

ーボタン

記録 *1

ビルド

メインメニュー

1.

機能
プロジェクトの変更のあったファイルをビルド

F7

します。
すべてをビルド

変更の有無に関わらず、プロジェクトのファイ-

ルをビルドします。
複数ビルド

-

-

複数のプロジェクトをビルドします。

クリーン アクティブ--

現在のコンフィグレーションの中間ファイルおよび出力ファイルを削除します。

プロジェクトクリーン 全プロジェ

ワークスペースに登録されたすべてのプロジェ-

クトにあるすべてのコンフィグレーションの中クト

間ファイルおよび出力ファイルを削除します。
すべての依存関係を更

-

-

-

新
ツールの中止プロジェクトのファイル依存関係を更新します。

Ctrl+Break

ビルドから除外/除外

-

-

-

ビルド中のツールの実行を中止します。

-

ファイルをビルドから除外または除外を解除し

の解除

ます。

ビルドフェーズ---

ビルドフェーズを追加、削除、または変更します。
ビルドコンフィグレーションを設定します。

ビルドの構成--リンク順の指定---

リンク順序をカスタマイズします。

Make ファイルの生成

-

-

-

Make ファイルを生成します。

注：*1. 一部のメニューオプションに対する操作は、マクロ生成支援機能を使用し、High-performance Embedded
Workshopコマンドラインのコマンドを記録できます。このリストでは、メニューオプションの「マクロの記録」欄にマクロの記録マーク( )を表示し、マクロファイルへ記録可能かどうかを示しています。これらの詳細は「15.5.1 マクロを記録できる機能（High-performance Embedded Workshop共通）」を参照してく
ださい。
*2. 本メニューは、High-performance Embedded Workshop V.4.01以降で作成したデバッグ専用プロジェクトを使用する場合は表示されません。

1.6

デバッグメニューオプション

メニュー
デバッグ

メニューオプション

ショートカ

ツールバ

マクロの

ットキー

ーボタン

記録 *1

同期デバッグ *2---

デバッグセッション--

機能
同期デバッグを設定します。
[デバッグセッション]ダイアログボックスを開きます。デバッグセッションのリスト表示、追加、または削除ができます。

デバッグの設定---[デバッグの設定]ダイアログボックスを開きます。デバッグ時の条件やダウンロードモジュー
ルを設定できます。

CPU のリセット-

ターゲットマイコンをリセットします。

実行

F5

現在の PC からユーザプログラムを実行します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 448 of 479

High-performance Embedded Workshop V.4.09

メニュー

メニューオプション
リセット後実行メインメニュー

1.

ショートカ

ツールバ

マクロの

ットキー

ーボタン

記録 *1

機能
リセットベクタアドレスからユーザプログラム

Shift+F5

を実行します。
フリー実行 *2

ブレークポイントを無視してユーザプログラム-

を実行します。
カーソル位置まで実

現在の PC からユーザプログラムの実行を開始-

し、PC がテキストカーソルの位置で示されたア行

ドレスに到達するまで実行を継続します。
カーソル位置に PC

PC をテキストカーソルの位置で示されたアド-レスに変更します。

値を設定
条件を指定して実行-[条件を指定して実行]ダイアログボックスを開-きます。ユーザプログラムの実行開始前に一時的なブレークポイントを入力できます。
PC 位置を表示
ステップイン-

Ctrl+Shift+

PC 位置でエディタまたは逆アセンブリウィン

Y

ドウを開きます。

F11

ユーザプログラムの 1 ブロックを実行して停止します。

ステップオーバ

ユーザプログラムの 1 ブロックを実行して停止F10

しますが、サブルーチンを呼び出す場合は、サブルーチンには入りません。
ステップアウト

現在の関数の終わりに到達するまでユーザプロ

Shift+F11

グラムを実行します。
ステップ

-

-

[プログラムステップ]ダイアログボックスを開きます。ステップ動作の設定を変更できます。

ステップ

自動

-

-

エディタウィンドウがアクティブの場合はソース行単位にステップ実行します。逆アセンブリ

モード

ウィンドウがアクティブの場合はアセンブリ言
語命令単位にステップ実行します。
アセン

-

-

アセンブリ言語命令単位にステップ実行します。

ブリ

ソース行単位にステップ実行します。

ソース-

プログラムの停止

-

初期化

-

接続 *2

-

デバッガを接続します。

接続解除 *2-

デバッガを接続解除します。

メモリの保存--メモリ内容をファイルに保存します。

メモリのベリファイ--

メモリ内容とファイル内容をベリファイしま-

ユーザプログラムの実行を停止します。
-

デバッガを切断し、再接続します。

す。

*2
ダウンロード--オブジェクトプログラムをロードします。

アンロード

-

-

オブジェクトプログラムをアンロードします。

注：*1. 一部のメニューオプションに対する操作は、マクロ生成支援機能を使用し、High-performance Embedded
Workshopコマンドラインのコマンドを記録できます。このリストでは、メニューオプションの「マクロの記録」欄にマクロの記録マーク( )を表示し、マクロファイルへ記録可能かどうかを示しています。これ
R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 449 of 479

High-performance Embedded Workshop V.4.09

1.

メインメニュー

らの詳細は「15.5.1 マクロを記録できる機能（High-performance Embedded Workshop共通）」を参照してください。
*2. 機能のサポートはデバッガに依存します。

1.7

基本設定メニューオプション

メニュー
基本設定

メニューオプション

ショートカ

ツールバ

マクロ

ットキー

ーボタン

の記録 *

-

-

-

カスタマイズ

機能
High-performance Embedded Workshop アプリ
ケーションの設定をカスタマイズします。

オプション

-

-

-

High-performance Embedded Workshop アプリ
ケーションのオプションを設定します。

表示の形式

-

-

-

ウィンドウのフォント、表示色、キーワードなどを設定します。

16 進数

基数

入力した数値を処理する基数を 16 進数に設定

-

します。
10 進数

入力した数値を処理する基数を 10 進数に設定

-

します。
8 進数

入力した数値を処理する基数を 8 進数に設定し

-

ます。
2 進数

入力した数値を処理する基数を 2 進数に設定し

-

ます。

注：
*. 一部のメニューオプションに対する操作は、マクロ生成支援機能を使用し、High-performance Embedded
Workshopコマンドラインのコマンドを記録できます。このリストでは、メニューオプションの「マクロの記録」欄にマクロの記録マーク( )を表示し、マクロファイルへ記録可能かどうかを示しています。これらの詳細は「15.5.1 マクロを記録できる機能（High-performance Embedded Workshop共通）」を参照してください。

1.8

ツールメニューオプション

メニュ

メニューオプション

ショートカ

ツールバ

ットキー

ーボタン

アドミニストレーション--

コンポーネントを管理します。

ツールチェインバージョンを変更--

ツールチェインバージョンを変更します。

バージョン

選択

-

-

バージョン管理システムを選択します。

管理

構成

-

-

バージョン管理システムを設定します。

ファイルの追加

-

ー
ツール

機能

バージョン管理に選択したファイルを追加します。

ファイルの削除-

バージョン管理から選択したファイルを削除します。

ファイルの取得-

バージョン管理から選択したファイルの読み取り専用ローカルファイルを取得します。

ファイルのチェック
アウト

R20UT0372JJ0100 Rev.1.00
2011.02.01-

バージョン管理から選択したファイルの書き込み可能なローカルファイルを取得します。

Page 450 of 479

High-performance Embedded Workshop V.4.09

メニュ

メニューオプション

ー

1.

ショートカ

ツールバ

ットキー

ーボタン

ファイルのチェック

メインメニュー

機能
バージョン管理に選択したファイルのローカル-

コピーを戻します（更新します）。

イン
ファイルの状態

バージョン管理における選択したファイルの状-

態を表示します。
外部デバッガの起動-

マクロの設定-マクロの記録-マクロの記録を開始します。

マクロの実行-

マクロを実行します。

マクロの停止-マクロを停止します。

各種システムツール-

システムツール（[Renesas Call Walker]など）

外部デバッガを起動します。
-[マクロの設定]ダイアログボックスを開きます。

を起動します。

注：*1. [マクロの停止]とシステムツール用のメニューオプションの間には、記録したマクロをメニューに割り当てたときのメニューオプションを表示します。
*2. システムツール用のメニューオプションの下には、[ツール]メニューのカスタマイズにより追加した外部ツール用のメニューオプションを表示します。

1.9

テストメニューオプション

メニュー
テスト

メニューオプション
テストスイートの作成

ショートカ

ツールバ

ットキー

ーボタン

-

-

機能
新規に空のテストスイートを作成します。テストの追加、実行を開始できます。

テストスイートを開く--

既存のテストスイートを開きます。

テストスイートの編集--

現在のテストスイートを編集します。テストスイートへのテストの追加および削除ができます。

テストスイートを閉じる--

現在開いているテストスイートを閉じます。

テストイメージファイル--

テストイメージファイル（*.HIF）に保存するテストイメの作成
テストイメージファイル

ージデータの設定およびカスタマイズが可能です。
-

-

の比較

テストイメージファイルを、現在の High-performance
Embedded Workshop システム、またはディスクにある別のテストイメージファイルと比較します。結果はテス
トブラウザに表示されます。

テストを実行--テストスイートで定義した複数のテストを実行し、比較した結果をテストブラウザで見ることができます。テス
トの実行方法を指定する様々なオプションがあります。

テスト結果ブラウザ--

前回実行したテストの結果を表示します。テストの成功、失敗と、失敗した要因の詳細を見ることができます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 451 of 479

High-performance Embedded Workshop V.4.09

1.10

メインメニュー

1.

ウィンドウメニューオプション

メニュー
ウィンドウ

メニューオプション
重ねて表示

ショートカ

ツールバ

ットキー

ーボタン

-

-

機能
開いているすべてのウィンドウを重ねて並べます。

上下に並べて表示--

ウィンドウを上下に並べます。

左右に並べて表示--

ウィンドウを左右に並べます。

アイコンの整列--

アイコンを整列します。

すべて閉じる--

開いているすべてのウィンドウを閉じます。

--

デスクトップ構成に新しい名前を付けます。

--

デスクトップ構成を切り替えます。

ショートカ

ツールバ

ットキー

ーボタン

-

-

バーチャル

デスクトップ

デスクトップマネージャ
Default1-4

1.11

ヘルプメニューオプション

メニュー
ヘルプ

メニューオプション
トピック

機能High-performance Embedded Workshop ヘルプ
ウィンドウを開きます。

テクニカル

不具合レポートのサポート

作成
アップデートの--High-performance Embedded Workshop 不具合
レポートを作成します。

--

web 確認High-performance Embedded Workshop 製品のバージョンアップやサービスパックを確認します。

High-performance Embedded--

Workshop のバージョン情報[High-performance Embedded Workshop について]ダイアログボックスを開きます。
High-performance Embedded Workshop のバー
ジョン情報を参照できます。

デバッガヘルプ--

デバッガ接続時エミュレータまたはシミュレー
タのヘルプウィンドウを開きます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 452 of 479

High-performance Embedded Workshop V.4.09

2.

2.

ウィンドウ

ウィンドウ
ウィンドウ名ウィンドウ表示メニュー

差分[表示 -> 差分]

Map Section Information *1[表示 -> マップ]Map Symbol Information *1
コマンドライン[表示 -> コマンドライン]

Console *2[表示 -> TCL ツールキット]

Workspace[表示 -> ワークスペース]

Output[表示 -> アウトプット]

逆アセンブリ[表示 -> 逆アセンブリ]

レジスタ[表示 -> CPU -> レジスタ]

メモリ[表示 -> CPU -> メモリ]

IO

[表示 -> CPU -> IO]

ステイタス[表示 -> CPU -> ステイタス]

画像 *1[表示 -> グラフィック -> 画像]

波形 *1[表示 -> グラフィック -> 波形]

スタックトレース[表示 -> コード -> スタックトレース]

テストブラウザ[テスト -> テスト結果ブラウザ]

注：*1. 機能のサポートはデバッガに依存します。
*2. 別冊の「TCL/TK 添付資料」を参照してください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 453 of 479

High-performance Embedded Workshop V.4.09

3.

3.

コマンド

3.1

コマンド一覧（アルファベット順）
コマンド名

短縮形

コマンド

説明

!

-

コメント

ADD_FILE

AF

カレントプロジェクトへのファイル追加

ASSERT-

コンディションのチェック

AUTO_COMPLETE

AC

オートコンプリートの切り替え

BUILD *1

BU

カレントプロジェクトのビルド

BUILD_ALL *1

BL

カレントプロジェクトのすべてのビルド

BUILD_FILE *1

BF

ファイルのコンパイル

BUILD_MULTIPLE *1

BM

複数プロジェクトのビルド

CACHE *2-

メモリキャッシュの有効化/無効化

CHANGE_CONFIGURATION

CC

コンフィグレーションの設定

CHANGE_PROJECT

CP

プロジェクトの設定

CHANGE_SESSION

CS

セッションの設定

CLEAN

CL

ビルドの中間ファイルおよび出力ファイルの削除

CLEAR_OUTPUT_WINDOW

COW

アウトプットウィンドウの各タブの表示内容クリア

CLOSE_TEST_SUITE

CTS

テストスウィートを閉じる

CLOSE_WORKSPACE

CW

ワークスペースを閉じる

COMPARE_TEST_DATA

CTD

テストデータの比較

CONNECT *2

CN

デバッガの接続DEFAULT_OBJECT_FORMAT

DO

デフォルトオブジェクトフォーマットの設定

DISCONNECT *2

DN

デバッガの切断

ERASE

ER

コマンドラインウィンドウの内容クリア

EVALUATE

EV

式の計算

FILE_LOAD

FL

オブジェクト(プログラム)ファイルのロード

FILE_LOAD_ALL

LA

すべてのオブジェクト(プログラム)ファイルのロード

FILE_SAVE

FS

メモリ内容のファイルセーブ

FILE_UNLOAD

FU

オブジェクト(プログラム)ファイルのアンロード

FILE_UNLOAD_ALL

UA

すべてのオブジェクト(プログラム)ファイルのアンロード

FILE_VERIFY *2

FV

ファイル内容とメモリ内容の比較

FREE_GO *2

FG

ブレークポイントを無効にしたユーザプログラムの実行

GENERATE_MAKE_FILE *1

GM

カレントワークスペースの make ファイル作成

GO

GO

ユーザプログラムの実行

GO_RESETGR

リセットベクタからのユーザプログラムの実行

GO_TILL

GT

テンポラリブレークポイントまでのユーザプログラムの実行

HALT

HA

ユーザプログラムの停止

HELP

HE

コマンドラインヘルプ

INITIALIZEIN

デバッガの初期化

LOG

LO

ロギングファイルの操作

MEMORY_COMPARE *2

MC

メモリ内容の比較

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 454 of 479

High-performance Embedded Workshop V.4.09

コマンド名

3.

短縮形

コマンド

説明

MEMORY_DISPLAY

MD

メモリ内容の表示

MEMORY_EDIT

ME

メモリ内容の変更

MEMORY_FILL

MF

指定データによるメモリ内容の一括変更

MEMORY_FIND *2

MI

メモリ内容の検索

MEMORY_MOVE

MV

メモリブロックの移動

MEMORY_TEST *2

MT

メモリブロックのテスト

OPEN_TEST_SUITE

OTS

テストスイートを開く

OPEN_WORKSPACE

OW

ワークスペースを開く

QUIT

QU

High-performance Embedded Workshop の終了

RADIX

RA

入力した数値を処理する基数の設定

REFRESH_SESSION

RSE

セッション情報の再読み込み

REMOVE_FILE

REM

カレントプロジェクトからのファイル削除

RESET

RE

CPU のリセット

RUN_TESTRT

テストの実行

SAVE_SESSION

SE

現在のセッションの保存

SAVE_WORKSPACE

SW

ワークスペースの保存

SET_DISASSEMBLY_SOFT_BREAK

SDB

逆アセンブリレベルのソフトウェアブレークポイントの設定または解除

SET_SOURCE_SOFT_BREAK

SSB

ソースレベルのソフトウェアブレークポイントの設定または解
除

SLEEP

-

コマンド実行の遅延

STATE_DISASSEMBLY_SOFT_BREAK

TDB

逆アセンブリレベルのソフトウェアブレークポイントの有効化
または無効化STATE_SOURCE_SOFT_BREAK

TSB

ソースレベルのソフトウェアブレークポイントの有効化または
無効化

STEP

ST

ステップ実行(命令単位またはソース行単位)

STEP_MODE

SM

ステップモードの設定

STEP_OUT

SP

現在の関数を終了するまでのステップ実行

STEP_OVER

SO

ステップオーバ実行

STEP_RATE

SR

ステップ実行速度の設定、表示

SUBMIT

SU

コマンドファイルの実行

TCL-

TCL の有効化/無効化

TOOL_INFORMATION

TO

ツール情報の出力

UPDATE_ALL_DEPENDENCIES *1

UD

カレントプロジェクトのすべての依存関係更新

注：*1. ツールチェインが登録されていない場合は、使用できません。
*2. コマンドのサポートはデバッガに依存します。
各コマンドのシンタックスについてはオンラインヘルプを参照してください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 455 of 479

High-performance Embedded Workshop V.4.09

3.2

3.

コマンド

コマンド一覧（機能別）

High-performance Embedded Workshopアプリケーション制御コマンド
コマンド名

短縮形

説明

ADD_FILE

AF

カレントプロジェクトへのファイル追加

CHANGE_CONFIGURATION

CC

コンフィグレーションの設定

CHANGE_PROJECT

CP

プロジェクトの設定

CHANGE_SESSION

CS

セッションの設定

CLEAR_OUTPUT_WINDOW

COW

アウトプットウィンドウの各タブの表示内容クリア

CLOSE_WORKSPACE

CW

ワークスペースを閉じる

EVALUATE

EV

式の計算

OPEN_WORKSPACE

OW

ワークスペースを開く

QUIT

QU

High-performance Embedded Workshop の終了

RADIX

RA

入力した数値を処理する基数の設定

REFRESH_SESSION

RSE

セッション情報の再読み込み

REMOVE_FILE

REM

カレントプロジェクトからのファイル削除

SAVE_SESSION

SE

現在のセッションの保存

SAVE_WORKSPACE

SW

ワークスペースを保存する

TOOL_INFORMATION

TO

ツール情報の出力

ビルド関連（ツールチェインを登録している場合に使用可能）
コマンド名

短縮形

説明

BUILD

BU

カレントプロジェクトのビルド

BUILD_ALL

BL

カレントプロジェクトのすべてのビルド

BUILD_FILE

BF

ファイルのコンパイル

BUILD_MULTIPLE

BM

複数プロジェクトのビルド

CLEAN

CL

ビルドの中間ファイルおよび出力ファイルの削除

GENERATE_MAKE_FILE

GM

カレントワークスペースの make ファイル作成

UPDATE_ALL_DEPENDENCIES

UD

カレントプロジェクトのすべての依存関係更新

コマンドライン操作関連
コマンド名

短縮形

説明

!

-

コメント

ASSERT-

コンディションのチェック

AUTO_COMPLETE

AC

オートコンプリートの切り替え

ERASE

ER

コマンドラインウィンドウの内容クリア

HELP

HE

コマンドラインヘルプ

LOG

LO

ロギングファイルの操作

SLEEP

-

コマンド実行の遅延

SUBMIT

SU

コマンドファイルの実行

TCL-

TCL の有効化/無効化

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 456 of 479

High-performance Embedded Workshop V.4.09

3.

コマンド

テスト支援機能関連
コマンド名

短縮形

説明

CLOSE_TEST_SUITE

CTS

テストスイートを閉じる

COMPARE_TEST_DATA

CTD

テストデータの比較

OPEN_TEST_SUITE

OTS

テストスイートを開く

RUN_TESTRT

テストの実行

実行関連（デバッガ接続時に使用可能）
コマンド名

短縮形

説明

FREE_GO *FG

ブレークポイントを無効にしたユーザプログラムの実行

GOGO

ユーザプログラムの実行

GO_RESETGR

リセットベクタからのユーザプログラムの実行

GO_TILL

GT

テンポラリブレークポイントまでのユーザプログラムの実行

HALT

HA

ユーザプログラムの停止

RESET

RE

CPU のリセット

STEP

ST

ステップ実行(命令単位またはソース行単位)

STEP_MODE

SM

ステップモードの設定

STEP_OUT

SP

現在の関数を終了するまでのステップ実行

STEP_OVER

SO

ステップオーバ実行

STEP_RATE

SR

ステップ実行速度の設定、表示

注：*. コマンドのサポートはデバッガに依存します。
メモリ操作関連（デバッガ接続時に使用可能）
コマンド名

短縮形

説明

CACHE *-

メモリキャッシュの有効化/無効化

FILE_LOAD

FL

オブジェクト(プログラム)ファイルのロード

FILE_LOAD_ALL

LA

すべてのオブジェクト(プログラム)ファイルのロード

FILE_SAVE

FS

メモリ内容のファイルセーブ

FILE_UNLOAD

FU

オブジェクト(プログラム)ファイルのアンロード

FILE_UNLOAD_ALL

UA

すべてのオブジェクト(プログラム)ファイルのアンロード

FILE_VERIFY *FVファイル内容とメモリ内容の比較

MEMORY_COMPARE *MC

メモリ内容の比較

MEMORY_DISPLAY

MD

メモリ内容の表示

MEMORY_EDIT

ME

メモリ内容の変更

MEMORY_FILL

MF

指定データによるメモリ内容の一括変更

MEMORY_FIND *MI

メモリ内容の検索

MEMORY_MOVE

MV

メモリブロックの移動

MEMORY_TEST *MT

メモリブロックのテスト

注：*. コマンドのサポートはデバッガに依存します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 457 of 479

High-performance Embedded Workshop V.4.09

3.

コマンド

ソフトウェアブレーク設定関連（デバッガ接続時に使用可能）
コマンド名
SET_DISASSEMBLY_SOFT_BREAK

短縮形
SDB

説明
逆アセンブリレベルのソフトウェアブレークポイントの設定または解除

SET_SOURCE_SOFT_BREAK

SSB

ソースレベルのソフトウェアブレークポイントの設定または解除STATE_DISASSEMBLY_SOFT_BREAK

TDB

逆アセンブリレベルのソフトウェアブレークポイントの有効化
または無効化STATE_SOURCE_SOFT_BREAK

TSB

ソースレベルのソフトウェアブレークポイントの有効化または無効化

その他デバッグ関連（デバッガ接続時に使用可能）
コマンド名

短縮形

説明

CONNECT *CN

デバッガの接続DISCONNECT *DN

デバッガの切断

INITIALIZEIN

デバッガの初期化

注：*. コマンドのサポートはデバッガに依存します。
各コマンドのシンタックスについてはオンラインヘルプを参照してください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 458 of 479

High-performance Embedded Workshop V.4.09

4.

正規表現

正規表現

4.

High-performance Embedded Workshopエディタでは検索、置換、およびファイルから検索操作の際、文字列に特殊文字を指定できます。
下表に指定できる文字とその詳細を示します。
文字?

機能
改行文字以外の任意の一文字と一致します。
例えば、t?p は"top"や"tip" と一致するが"trap"とは一致しません。

*

改行文字以外の文字列（0 個以上の文字列）と一致します。2 行にまたがって一致することはありません。
* 文字は残りのパターンが一致するための最短文字列と一致します。
例えば、t*o は"too"の"to", "trowel"の"tro" , "sporty orange"の"ty o"と一致しますが、"smartorange"とは一致しません（*文字は 2 行にまたがって一致することはないため）。

¥t

タブと一致します。
例 1 ¥t8
タブの次に 8 がある場合を検索します。
例 2 init¥tinit の次にタブがある場合を検索します。

[]

括弧内の文字または文字の範囲の中の任意の一文字と一致します。括弧をネストすることはできません。
[-]は文字の範囲を示します。例[a-z]、[0-9]。範囲の始まりの文字は終わりの文字より小さい ASCII コード
でなければなりません。
[~]は[~ と]の間の文字以外の一文字と一致します。改行文字がこの括弧内になければ、改行文字とも一致します。
例 1 [AEIOU]
大文字の母音をすべて検索します。
例 2 [<>?]
記号<, > , ?を検索します。
例 3 [A-Za-z0-9_]
大文字、小文字、数字、下線を検索します。
例 4 [~0-9]
数字以外の文字を検索します。
例 5 [ ¥t¥n]
空白、タブ、改行文字を検索します。
例 6 [¥]]¥のすぐ後に]を置くと、記号] を検索します。

¥

正規表現を無視する特殊文字です。バックスラッシュの次の文字が正規表現のとき、通常の文字として扱います。バックスラッシュの次が非正規表現のとき、バックスラッシュは無視されます。
例 1 ¥*
アスタリスクをすべて検索します。
例 2 ¥¥
バックスラッシュをすべて検索します。

注：
バックスラッシュ文字'¥' は日本語Windows® では円記号として表示されます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 459 of 479

High-performance Embedded Workshop V.4.09

プレースホルダ

5.

プレースホルダ

5.

プレースホルダは、High-performance Embedded Workshopの複数のツールによって提供される機能です。ここではプレースホルダの使い方を説明します。

プレースホルダとは？

5.1

プレースホルダとは一時的にテキストに挿入される特殊文字列です。後で実際の値に置き換えます。例えば、
High-performance Embedded Workshopのプレースホルダの1つに、$(FULLFILE)があります。これは、すべてのパス付きのファイルを示します。
パラメータとしてファイルを編集できるエディタがc:\myedit\myeditor.exe であるとします。c:\filesディレクト
リのファイルFILE1.Cを開き、このエディタを起動するには、以下のように直接指定することもできます。
c:\myedit\myeditor.exe c:\files\FILE1.C
しかし、このエディタを介して任意のファイルを開きたいとき、上記コマンドはc:\files\file1.cを開くだけのものであるため、問題が起きます。指定したエディタを使うときにその時点で選択したファイルを開くことができるようにするには、特定のファイル名を一般的なプレースホルダに置き換えます。以下に例を示します。
c:\myedit\myeditor.exe $(FULLFILE)
これで、High-performance Embedded Workshopがエディタでファイルを開くとき、$(FULLFILE)を選択されたファイル名で置き換えます。

プレースホルダを挿入する

5.2

プレースホルダを挿入するには以下に示す方法があります。
例1
1.

プレースホルダを挿入したい場所にカーソルを置いてください。

2.

次に、必要なプレースホルダを編集フィールドの右のプレースホルダボタンをクリックしてください。

3.

必要なプレースホルダをポップアップメニューから選択してください。

1.

"Custom directory"以外のプレースホルダをドロップダウンリストボックスから選択し、プレースホル

例2
ダによって示されたディレクトリからの相対サブディレクトリを指定してください。
2.

"Custom directory"を選択した場合、[サブディレクトリ]に絶対ディレクトリパスを指定してください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 460 of 479

High-performance Embedded Workshop V.4.09

5.

プレースホルダ

例3
1.

プレースホルダを挿入したい場所にカーソルを置いてください。

2.

必要なプレースホルダをドロップダウンリストボックスから選択してください。

3.

[挿入]ボタンをクリックしてください。

1.

フィールドにプレースホルダを直接入力してください。大文字で入力して、"$(" で開始し") "で終了し

例4てください。
正しい$(FILEDIR)
誤り$(Filedir)$( FILEDIR )$FILEDIR

5.3

使用できるプレースホルダ

以下の表に、使用できるプレースホルダと意味、またその使用例を示します。
プレースホルダ意味

プレースホルダの展開例$(FULLFILE)

ファイル名 (絶対パスを含む)$(FILEDIR)

ファイルディレクトリ

c:¥workspace¥project$(FILENAME)

ファイル名 (パスを除き拡張子を含む)

file.src$(FILELEAF)

ファイル名（パスと拡張子を除く）

file$(EXTENSION)

ファイルの拡張子

src$(WORKSPDIR)

ワークスペースディレクトリ

c:¥workspace$(WORKSPNAME)

ワークスペース名

workspace$(PROJDIR)

プロジェクトディレクトリ

c:¥workspace¥project$(PROJECTNAME)

プロジェクト名

project$(CONFIGDIR)

コンフィグレーションディレクトリ

c:¥workspace¥project¥debug

c:¥workspace¥project¥file.src$(CONFIGNAME)

コンフィグレーション名

debug$(HEWDIR)

High-performance Embedded Workshopc:¥Program Files¥Renesas¥Hew

インストールディレクトリ

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 461 of 479

High-performance Embedded Workshop V.4.09

プレースホルダ$(TCINSTALL)

意味
ツールチェインインストールディレクト

プレースホルダ

5.

プレースホルダの展開例
c:¥Program

リ（オプション設定ダイアログボックス、 Files¥Renesas¥Hew¥Tools¥Renesas¥Sh¥9_0_1_1
および[新規ビルドフェーズ]ダイアログ
ボックス（ステップ 3））
ツールインストールディレクトリ（[ツーc:¥Program

ルアドミニストレーション]）

Files¥Renesas¥Hew¥Tools¥Renesas¥Sh¥9_0_1_1$(TEMPDIR)

テンポラリディレクトリ

c:¥temp$(WINDIR)

Windows® ディレクトリ

c:¥windows$(WINSYSDIR)

Windows® システムディレクトリ

c:¥windows¥system$(EXEDIR)

コマンドディレクトリ

v:¥vc¥win32$(USERNAME)

ユーザログイン（バージョン管理）JHARK$(PASSWORD)

ユーザパスワード（バージョン管理）

214436$(VCDIR)「仮想的」バージョン管理ディレクトリ

"c:¥project"は"x:¥vc¥project"へマッピングしている。

$(COMMENT)

コメント（バージョン管理）[コメント入力]ダイアログボックスを開く。

$(LINE)

エラー/ウォーニングの行番号

12$(TOOLDIR)

上記の表では以下のことを仮定しています。
• ファイルパスは "c:\workspace\project\file.src"。
• ワークスペース名 "workspace"の位置は "c:\workspace"。
• プロジェクト名 "project" の位置は "c:\workspace\project"。
• コンフィグレーション名 "debug" にはコンフィグレーションディレクトリがあり、位置は"c:\workspace\project\debug"。
• HEW2.EXEを"c:\Program Files\Renesas\Hew"にインストールしている。
• ツールチェイン（コンパイラ、アセンブラ、リンケージエディタ）の*.HRF ファイル の位置は "c:\Program
Files\Renesas\Hew\Tools\Renesas\Sh\9_0_1_1"
このディレクトリは[ビルド]メニューのオプション設定ダイアログボックス、および[新規ビルドフェーズ]
ダイアログボックス（ステップ3）上では$(TCINSTALL)として参照され、[ツールアドミニストレーション]
ダイアログボックス上では$(TOOLDIR)として参照される。
• Windows® operating systemをc:\Windowsにインストールしており、Windows® システムファイルを
c:\Windows\Systemにインストールしている。
• バージョン管理実行可能パスがv:\vc\win32\ss.exeである。バージョン管理システムにログインするユーザ
名はJHARKでパスワードが214436であり、バージョン管理実行可能ファイルへのコマンドラインには$(COMMENT)を指定している。c:\projectは[ツール -> バージョン管理 -> 構成]を選択すると開く[バージョン管理設定]ダイアログボックスの[Projects]タブのx:\vc\projectにマッピングしている。
• コンパイラまたはアセンブラのエラーが12行目で発生した。
注：
どのフィールドでもすべてのプレースホルダを使用できるとは限りません。例えば、プレースホルダ$(LINE)は依存ファイル位置を指定するときには意味をもちません。プレースホルダ$(USERNAME)、$(PASSWORD)、$(VCDIR)、$(COMMENT)はバージョン管理でのみ受け付けます。各編集フィールドで、使用できないプレー
スホルダを指定すると、警告メッセージを表示する場合があります。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 462 of 479

High-performance Embedded Workshop V.4.09

5.4

5.

プレースホルダ

プレースホルダを使うにあたって

プレースホルダによって、システムが使用する様々なファイルへのパスをフレキシブルに指定できます。
• パスまたはファイル名を入力する編集フィールドの右にプレースホルダボタン()がある場合、プレース

ホルダをどのように使用してパスやファイルの指定をフレキシブルにできるかご考慮ください。
• いくつかの構成を使うとき、プレースホルダ$(CONFIGDIR) を使用すると、現在の構成のディレクトリからファイルへの書き込みやそのファイルから現在の構成のディレクトリへの書き込みができます。
• できるだけプレースホルダを使用してください。プレースホルダは後で削除したり追加したりできます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 463 of 479

High-performance Embedded Workshop V.4.09

6.

6.

I/O ファイルフォーマット

I/Oファイルフォーマット

High-performance Embedded Workshopは、I/Oレジスタ定義ファイルで取得する情報に基づいて、[IO]ウィンド
ウを作成します。デバッガを選択すると、High-performance Embedded Workshopは、選択したデバイスに対応する"<device>.IO"ファイルを検索し、存在する場合にはこのファイルをロードします。これは、I/Oモジュール、およびそのレジスタのアドレスやサイズを記述するフォーマット済みテキストファイルです。テキストエディ
タでこのファイルを編集し、ユーザアプリケーションに特有のメモリマップレジスタや周辺レジスタ（例えば、マイコンのアドレス空間にマップしたASICデバイスのレジスタ）のサポートを追加できます。
ファイルフォーマット
各モジュール名を[Modules]定義セクションで定義し、モジュールの番号を、順番に付けてください。各モジュールはレジスタ定義セクションに対応しており、セクション内のエントリは、I/Oレジスタを定義します。
[BaseAddress]はデバイスのための定義であり、そのデバイスでは、CPUモードによってアドレス空間のI/Oレジ
スタの場所が移動します。この場合、[BaseAddress]値は、ある特有モードのI/Oレジスタのベースアドレスです。
また、レジスタ定義で使用するアドレスは、同じモードにおけるレジスタのアドレス位置です。I/Oレジスタ
ファイルを実際に使用する場合、定義したレジスタアドレスから[BaseAddress]値を引き、その結果のオフセットを選択したモードのベースアドレスに加算します。
各モジュールにはセクションがあり、オプションの依存性によって形成するレジスタを定義します。依存性は、モジュールが有効かどうかを確認するためにチェックします。各レジスタ名をセクションで定義し、レジスタの番号を順番に付けてください。依存性は、dep=<reg> <bit> <value>のようにセクションに入力します。
1.

<reg>は依存性のレジスタIDです。

2.

<bit>はレジスタのビット位置です。

3.

<value>は値で、ビットは、有効であるモジュールに使用してください。

[Register]定義エントリは、id=<name> <address> [<size>[<absolute>[<format>[<bitfields>]]]]のフォーマットで入
力します。
1.

<name>は表示するレジスタ名です。

2.

<address>はレジスタのアドレスです。

3.

<size>は、Bがバイトサイズ、Wがワードサイズ、Lがロングワードサイズを意味します（デフォルトはバイトです）。

4.

<absolute>は、レジスタが絶対アドレスにある場合、Aと設定します。これは、異なるモードのCPUに
よってI/O空間アドレス範囲が移動する場合のみ関連します。レジスタが絶対アドレスにあると定義す
ると、ベースアドレスオフセットは計算せず、指定したアドレスを直接使用します。

5.

<format>はレジスタを出力するためのフォーマットです。有効な値は、16進数の場合はH、10進数はD、
2進数はBです。

6.

<bitfields>セクションは、レジスタのビットを定義します。

ビットフィールドセクションは、各エントリがbit<no>=<name>タイプのレジスタ内のビットを定義します。
1.

<no>はビット番号です。

2.

<name>はビットのシンボル名です。

コメント行を入れる場合、";"で始めてください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 464 of 479

High-performance Embedded Workshop V.4.09

6.

I/O ファイルフォーマット

以下に例を示します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 465 of 479

High-performance Embedded Workshop V.4.09

7.

シンボルファイルフォーマット

シンボルファイルフォーマット

7.

シンボルファイルを正確にデコードするためには、Pentica-Bファイルのフォーマットに基づいてファイルを作成する必要があります。
1. ファイルは、簡単なASCIIテキストファイルでなければなりません。
2. ファイルは、"BEGIN"で始めなければなりません。
3. 各シンボルは、個々の行で、まず、"H"で終了する16進数の値から始まり、次にスペース、シンボルテ
キストの順でなければなりません。
4. ファイルは、"END"で終了しなければなりません。
例：BEGIN
11FAH Symbol_name_1
11FCH Symbol_name_2
11FEH Symbol_name_3
1200H Symbol_name_4
END
注：機能のサポートはデバッガに依存します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 466 of 479

High-performance Embedded Workshop V.4.09

8.

8.

キーボードショートカット

キーボードショートカット

High-performance Embedded Workshopのアプリケーションでは、主要なコマンドはすべてキーボードから操作できます。アプリケーションでのキーボードのコマンドを以下に示します。
機能キー

キー

機能

Alt

0-9

キーボードショートカットに割り当てたマクロを実行する。

Alt

A

ステータスバーの表示/非表示を切り替える。

Alt

K

ワークスペースウィンドウを開く。

AltO

アウトプットウィンドウを開く。

Alt

F4

アプリケーションを終了する。

Alt

Backspace

元に戻す。(または、エディタで Ctrl+Z)

Ctrl

0-9

テンプレートで予約されています。

Ctrl

A

エディタですべて選択する。(他のウィンドウでも有効な場合あり)

Ctrl

B

[ブレークポイント]ダイアログボックスを開く。

Ctrl

C

コピーする。

Ctrl

D

逆アセンブリウィンドウを開く。

Ctrl

F

[検索]ダイアログボックスを開く。

Ctrl

G

ジャンプする。

Ctrl

H[置換]ダイアログボックスを開く。

Ctrl

I

[IO]ウィンドウを開く。

Ctrl

K

スタックトレースウィンドウを開く。

Ctrl

L

コマンドラインウィンドウを開く。

Ctrl

M

メモリウィンドウを開く。

Ctrl

N

エディタで新しいソースファイルを開く。

Ctrl

O

[ファイルを開く]ダイアログボックスを開く。

Ctrl

P

印刷する。

Ctrl

R

レジスタウィンドウを開く。

Ctrl

S

現在のファイルを保存する。

Ctrl

U

ステイタスウィンドウを開く。

Ctrl

V

クリップボードの内容を貼り付ける。

Ctrl

X

選択範囲を切り取る。

Ctrl

Y

取り消した操作をやり直す。

Ctrl

Z

直前の操作を元に戻す。

Ctrl

F2

ブックマークを設定、解除する。

Ctrl

F3

エディタで選択されている文字列の次を検索、または[検索]ダイアログボックスを開
く。

Ctrl

F4

エディタウィンドウを閉じる。

Ctrl

F6

ウィンドウを切り替える。

Ctrl

F7

ファイルをコンパイルする。

Ctrl

F9

ブレークポイントの設定、解除する。

Ctrl

Spacebar

エディタにポップアップウィンドウとしてナビゲーションリストを表示する。

Ctrl

Backspace

単語を削除する。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 467 of 479

High-performance Embedded Workshop V.4.09

機能キー

キー

8.

キーボードショートカット

機能

Ctrl

Break

ビルドを中止する。

Ctrl

Insert

コピーする。

Ctrl

Tab

ウィンドウを切り替える。

Ctrl

Home

エディタのカーソルを現在のファイルの先頭に戻す。

Ctrl

End

エディタのカーソルを現在のファイルの最後に移動する。

Ctrl

↑

ウィンドウを上へスクロールする。(カーソル位置はエディタの同じ場所)

Ctrl

↓

ウィンドウを下へスクロールする。(カーソル位置はエディタの同じ場所)

Ctrl

←

エディタで、カーソルを 1 つ前の単語に移動する。

Ctrl

→

エディタで、カーソルを次の単語に移動する。

Ctrl+Alt

1-4

バーチャルデスクトップを切り替える。

Ctrl+Alt

PageUp

ウィンドウの次のタブに移動する。(例: アウトプットウィンドウ、ワークスペースウィンドウ)

Ctrl+Alt

PageDown

ウィンドウの 1 つ前のタブに移動する。(例: アウトプットウィンドウ、ワークスペー
スウィンドウ)

Ctrl+Shift

8

エディタで、半角スペース、タブ記号を表示する。

Ctrl+ShiftG

画像ウィンドウを開く。

Ctrl+ShiftK

TCL ツールキットを開く。

Ctrl+Shift

L

エディタで 1 行削除する。

Ctrl+ShiftM

括弧の組み合わせを見つける。

Ctrl+ShiftN

アクティブセッションを Debuggers タブ中の次のセッションに変更する。(同期デバッ
グ機能)

Ctrl+Shift

S

ワークスペースの変更されたファイルをすべて保存する。

Ctrl+Shift

T

テンプレートを挿入する。

Ctrl+Shift

U

エディタで選択された文字列をすべて大文字にする。

Ctrl+ShiftV

波形ウィンドウを開く。

Ctrl+ShiftY

PC 位置を表示する。

Ctrl+Shift

F3

エディタで選択されている文字列の前を検索、または[検索]ダイアログボックスを開く。

Ctrl+ShiftSpacebar

エディタで開き括弧を入力すると、ポップアップウィンドウとして関数名とパラメー
タを表示する。

Ctrl+Shift

Tab

ウィンドウを切り替える。

Ctrl+ShiftHome

カーソル位置からファイルの先頭までを選択する。

Ctrl+Shift

End

カーソル位置からファイルの最後までを選択する。

Ctrl+Shift←

エディタで、1 つ前の単語を選択する。

Ctrl+Shift→

エディタで、次の単語を選択する。

Shift

F1

状況依存ヘルプを表示する。

Shift

F2

前のブックマークへジャンプする。

Shift

F3

前を検索する。

Shift

F5

リセット後実行する。

Shift

F8

前のビルドエラーまたはウォーニングが発生したエディタを表示する。

Shift

F10

コンテキストメニューを表示する。(ポップアップメニューでのマウスの右クリックと同様)

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 468 of 479

High-performance Embedded Workshop V.4.09

機能キー

キー

8.

キーボードショートカット

機能

Shift

F11

関数からステップアウトする。

Shift

F12

すべてのウィンドウをリフレッシュする。

Shift

Deleteエディタで選択範囲を切り取る。(またはエディタで Ctrl+X)

Shift

ESC

アウトプットウィンドウを非表示にする。

Shift

Tab

エディタで、タブの位置を戻す。

Shift

Home

エディタで、カーソル位置から現在の行の先頭までを選択する。

Shift

End

エディタで、カーソル位置から現在の行の最後までを選択する。

Shift

↑

現在の行より上を選択する。

Shift

↓

現在の行より下を選択する。

Shift+Alt

Backspace

取り消した操作をやり直す。(または、エディタで Ctrl+Y)

なし

F1

状況依存ヘルプを表示する。

なし

F2

次のブックマークへジャンプする。

なし

F3

次の文字列を検索する。

なし

F4

複数のファイルで文字列を検索する。

なし

F5

プログラム実行する。

なし

F7

プロジェクトをビルドする。

なし

F8

次のビルドエラーまたはウォーニングが発生したエディタを表示する。

なし

F9

ブレークポイントを挿入/削除する。

なし

F10

ステップオーバ実行する。

なし

F11

ステップイン実行する。

なし

F12

ウィンドウの表示内容を更新する。

なし

Delete

クリアする。

なし

Insert挿入モードと上書きモードを切り替える。

なし

Enter

エディタでキャリッジリターンを挿入する。

なし

Tab

エディタでタブを挿入する。

なし

ESC

プログラムの実行を停止する。

なし

Home

エディタで、カーソルを現在の行の先頭に戻す。

なし

End

エディタで、カーソルを現在の行の最後に移動する。

なし

PageUp

エディタのページを上に移動する。

なし

PageDown

エディタのページを下に移動する。

なし↑

エディタで、カーソルを上に移動する。

なし↓

エディタで、カーソルを下に移動する。

なし←

エディタで、カーソルを左に移動する。

なし→

エディタで、カーソルを右に移動する。

なし

Alt + マウスで選択 エディタで列を選択する。

注：
機能のサポートはデバッガに依存します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 469 of 479

High-performance Embedded Workshop V.4.09

9.

デバッガでドラッグアンドドロップする

デバッガでドラッグアンドドロップする

9.

High-performance Embedded Workshopのデバッガを使用中、各デバッグコンポーネントを他のコンポーネントと相互作用させることができます。他の表示への対象のドラッグで実現します。
以下に例を示します。
1.

ラベル表示から他のデバッグ表示へラベルをドラッグできます。例えば、逆アセンブリウィンドウにラベルをドラッグした場合、そのラベルのあるアドレスへスクロールします。

2.

変数をエディタからウォッチウィンドウへドラッグできます。変数がウォッチウィンドウに追加されます。

3.

関数名をエディタから逆アセンブリへドラッグすると、逆アセンブリ表示はラベルの位置へジャンプ
します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 470 of 479

High-performance Embedded Workshop V.4.09

10.

10.

ラベルを使用してコードを参照する

ラベルを使用してコードを参照する

デバッグモジュール内を検索するときにラベルを使用すると便利です。アドレスを入力できるエディットフィ
ールドであれば、ラベルを使用できます。このようなフィールドにラベルを入力すると、内蔵の式処理がラベ
ルをチェックし、アドレスに変換します。"_main+100"や"_MyFunction+100"などの評価を入力できます。
ラベルを使用すると評価する対象のアドレスを固定しません。この方法は特に、コマンドラインバッチファイ
ルを使ってブレークポイントを設定するときに便利です。コマンドラインバッチファイルで常に関数にブレー
クポイントを設定する必要がある場合は、ラベルの使用により解決できます。
ラベルを使用すれば、コマンドラインバッチファイルの内容に影響を与えずにコードを変更できます。
High-performance Embedded Workshop V.3.1以降では、他にもラベルを使用する簡単な方法をサポートしています。

上記のダイアログボックスに、ラベルを選択するリストも表示します。High-performance Embedded Workshopのアプリケーション全体を通して、アドレスエディットフィールドに入力された過去20件を、このリストに保存します。同じラベルを何度も入力する場合、この最近使用した[アドレス]のドロップダウンリストを使用す
れば、より効率的に入力できます。入力を評価するアドレスエディットフィールドの場合にこの操作が可能です。
アドレスを入力できるエディットフィールドの右にラベルブラウズボタン()が付いています。

これをクリックすると、[ラベル選択]ダイアログボックスが開き、現在のラベルのリストからラベルを選択できます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 471 of 479

High-performance Embedded Workshop V.4.09

10.

ラベルを使用してコードを参照する

リストは、ラベル名の昇順でソートされ右側にはそのアドレス値を表示しています。各々のカラムヘッダをクリックすると、クリックしたカラムでソートします。
リストにある特定のラベルを検索するには、[フィルタ]エディットボックスを使用します。この内容を変更す
ると、入力した文字列（大文字と小文字を区別しません）を含むラベルだけをリストに表示します。例えば、上記のダイアログボックスで[フィルタ]に「conv6」を入力すると、リストには「__conv64i」と「__conv64u」
のみを表示します。プロジェクトに多数のラベルがある場合にこの機能は有用です。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 472 of 479

High-performance Embedded Workshop V.4.09

11.

11.

ウィンドウのツールバー

ウィンドウのツールバー

High-performance Embedded Workshop V.4.0以降のコンポーネントのウィンドウでは、クライアント領域にツールバーを表示しています。ツールバーボタンをクリックすると、ウィンドウの主な機能へアクセスできます。
この機能は、High-performance Embedded Workshopの様々なウィンドウにあります。
例として、差分ウィンドウを以下に示します。

ツールバーをカスタマイズすることも可能です。
ツールバー上で右クリックすると、以下のメニューを表示します。

[ツールバー]メニューは、ツールバーの表示/表示なしの切り替えができます。（下の図は表示なしの場合）[カスタマイズ]メニューは、[ツールバーのカスタマイズ]ダイアログボックスを開きます。これを以下に示します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 473 of 479

High-performance Embedded Workshop V.4.09

11.

ウィンドウのツールバー

このダイアログボックスでは、表示するボタンを選択したり、ボタンの表示順序を変更できます。[有効なツールバーボタン]は、ツールバーに現在表示されていないボタンをすべて表示します。[現在のツールバーボタ
ン]は、ツールバーに現在表示されているボタンをすべて表示します。
ツールバーにボタンを追加するには
1.

[有効なツールバーボタン]リストから、追加したいツールバーボタンを選択してください。

2.

[追加]ボタンをクリックしてください。

3.

[OK]ボタンをクリックしてください。

ツールバーのボタンを移動するには
1.

[現在のツールバーボタン]リストから、移動したいツールバーボタンを選択してください。

2.

移動させたい位置まで、[上へ]あるいは[下へ]ボタンをクリックしてください。

3.

[OK]ボタンをクリックしてください。

ツールバーからボタンを削除するには
1.

[現在のツールバーボタン]リストから、削除したいツールバーボタンを選択してください。

2.

[削除]ボタンをクリックしてください。

3.

[OK]ボタンをクリックしてください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 474 of 479

High-performance Embedded Workshop V.4.09

12.

12.

HEW V.1.x 用のツールチェインでビルドする

High-performance Embedded Workshop V.1.x用のツールチェインでビルドする

High-performance Embedded Workshop V.1.xで作成したプロジェクトを、High-performance Embedded Workshop
V.2.x以降に登録されている新しいツールチェインにアップグレードしないで使用する場合、該当する旧バージ
ョンのツールチェインを登録する必要があります。[ツール -> アドミニストレーション]の[登録]ボタンで旧バージョンのツールチェインの"HRF"ファイルを選択してください（下の図参照）。High-performance Embedded
Workshop V.2.x以降で、旧バージョンのツールチェインを使ったビルド実行が可能になります。
ただし、一度High-performance Embedded Workshop V.2.x以降で開いたワークスペースは、High-performance
Embedded Workshop V.1.xでは開けませんのでご注意願います。
また、High-performance Embedded Workshop V.2.x以降では、新規に旧バージョンのプロジェクトは作成できま
せん。High-performance Embedded Workshop V.1.xにある旧バージョンのプロジェクトを作成する場合には、High-performance Embedded Workshop V.1.xをご使用ください。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 475 of 479

High-performance Embedded Workshop V.4.09

13.

HMAKEユーザガイドライン

13.1

コマンドライン13.

HMAKE ユーザガイドライン

ファイルでhmakeプログラムを実行するときに使うコマンドラインを説明します。
基本構成
コマンドラインのシンタックスを以下に示します。
hmake <メイクファイル> <パラメータリスト>
拡張子なしでファイルを指定した場合、.makを付加します。パラメータリストには、次の節に示す複数のパラメータを指定できます。また、パラメータは省略できます。パラメータリストはメイクファイル名の前に指定してもかまいません。各パラメータは、1つ以上の空白文字で区切ってください。パラメータは、大文字と小文字を区別しません。パラメータとファイル名を指定しなかった場合、ヘルプ情報を表示します。
Exitコード
実行中のメイクファイルでシンタックスエラー発生時、またはメイクファイル実行中の処理で不当エラーコー
ドが返されたとき、hmakeはコード1で終了します。その他の場合、hmakeはコード0で終了します（ファイルのシンタックスやexitコード条件の指定方法は、以下を参照してください）。
パラメータ指定できるパラメータとその機能を示します。
パラメータ

機能

/A

入出力ファイル状態にかかわらず全コマンドを実行する。全ビルドと同じ/N

入出力ファイルの使用状態により、（ノーマルで）実行すべきコマンドを判断して、表示するが、実行はしないヘルプ情報の表示/?

13.2

ファイルのシンタックス

hmakeファイルでは、基本的に4種類の文（変数宣言、記述部、コメント、メッセージコメント）を使用します。
hmakeファイルの作成にあたって、これらの文はどのような順序でも使用できます。ただし、変数を記述部や他の変数宣言に使用する前に、変数宣言をしてください。nmakeファイルで使用する最初の"all"文は、hmake
ファイルでは必要ありません。メイクファイルでは、コマンドを出現する順序で実行します。"→"文字は、メ
イクファイルのシンタックスを正しくするためにタブ文字を使用すべきところを示すことに注意してください。
変数宣言
変数宣言をした後、その変数は、hmakeファイルのすべての部分で使うことができます。変数宣言のシンタックスを以下に示します。
<変数名> = <値>

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 476 of 479

High-performance Embedded Workshop V.4.09

13.

HMAKE ユーザガイドライン

変数名と'='符号の間や、値と'='符号の間に、複数の空白文字を入れることができます。値は、'¥'文字で区切って、数行にわたって書くことができます。メインテキスト内で値に'¥'文字を含む場合は文字どおり解釈されます。'¥'文字の後に新しい行が続くときのみ、値が次の行にわたっているとみなされます。
変数宣言の例をいくつか示します。
EXECUTABLE = c:¥dir¥prog.exe
OUTPUT = c:¥dir2¥file1.out
INPUT = c:¥dir2¥file1.c
DEPEND = c:¥dir2¥file2.h ¥c:¥dir2¥file3.h ¥c:¥dir2¥file4.hhmakeファイルの後半で変数を使うには、変数名の前に"$("を、後ろに")"を加えてください。"$()"文字付きの
変数名を変数の値で置き換えます。次の記述部の節にその例を示します。変数名には、半角英数文字と半角下線を使用できます。別の変数宣言の中で変数を使うことができますが、すべての変数は使う前に宣言します。

13.3

記述部

概要
記述部には、ターゲット、依存ファイル、そしてターゲットが依存ファイルより新しい場合に実行するコマンド一覧を指定します。ターゲット、依存ファイルのどちらか、またはいずれもない場合、コマンドを常に実行します。コマンドを常に実行したいときには、依存ファイルを指定する必要はありません。記述部のシンタックスを以下に示します。
<ターゲット1> <ターゲット2> … : <依存ファイル1> <依存ファイル2> …
→<コマンド1>→<コマンド2>→…
→<コマンドn>
最後のターゲットと':' 文字の間や、最初の依存ファイルと':'文字の間に、複数の空白文字を入れることができます。最初のターゲットの前に空白文字を入れないでください。各ターゲットと各依存ファイルは、少なくとも1つの空白文字で区切ってください。タブ文字はコマンドを含む行のはじめに必要です。変数宣言の後で、変数を上記シンタックスで記述部に使うことができます。
記述部の例（変数宣言の後に変数を使う例）を以下に示します。
c:¥dir1¥file1.obj : c:¥dir1¥file1.c c:¥dir1¥file1.h→gcc c:¥dir1¥file1.c$(OUTPUT) : $(INPUT) $(DEPEND)→$(EXECUTABLE) $(INPUT)
特殊なコマンド
記述ブロックで使用できる特殊なコマンドが2つあります。cdコマンドはカレントディレクトリを変更し、set
コマンドはメイクファイル実行の間に使用する環境変数を設定します。両方とも、相当するDOSコマンドと同じ方法で使用します。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 477 of 479

High-performance Embedded Workshop V.4.09

13.

HMAKE ユーザガイドライン

これらのコマンドを使用した有効な記述ブロックの例を、以下に示します。
CHANGEDIR :→ cd c:¥dir1¥dir2
SETENV:→ set VAR1=value1→ set VAR2=value2→ set VAR3=value3$(EXECUTABLE)を置き換えるCHANGEDIRとSETENVがファイル名でなくてもかまいません。これらは存在しないファイルとして扱われてコマンドを常に実行します。
サブコマンドファイル
hmakeでサブコマンドファイルを生成するには、記述部のコマンド部分を以下のように指定してください(上記の<コマンドn>を置き換えます)。
→<コマンド開始> <<→<サブコマンド1>,→<サブコマンド2>,→…
→<サブコマンドn>→<<<コマンド終了>
これで、Windows®の一時的ファイルに、<サブコマンド1>、<サブコマンド2>などの行を含むサブコマンドフ
ァイルを生成します。このコマンドファイルはメイク処理が終了すると削除します。コマンドファイル名は2つの"<<"の間のすべてのテキストで置き換えられます。サブコマンドファイル名は、自動的にhmakeにより付けられます。
例：c:¥dir1¥file1.obj : c:¥dir1¥file1.c c:¥dir1¥file1.h→gcc @"<<→-c -o c:¥dir1¥file1.obj c:¥dir1¥file1.c<<"
生成されたサブコマンドファイル名が"c:¥temp¥hmk111.cmd"の場合、hmakeは以下を実行します。
(c:¥dir1¥file1.obj が更新されるとき)：
gcc @"c:¥temp¥hmk111.cmd"
サブコマンドファイル(c:¥temp¥hmk111.cmd)には以下を含みます。
-c -o c:¥dir1¥file1.obj c:¥dir1¥file1.c
記述部に1つ以上のコマンドを含むことができ、標準とサブコマンドファイルコマンドを混在して使用できます。

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 478 of 479

High-performance Embedded Workshop V.4.09

13.4

13.

HMAKE ユーザガイドライン

コメント'#'文字はコメントを示します。この文字が行の最初にあると、（次の改行文字があるまで）その行を無視します。コメントの例を次に示します。
# My hmake file
# Variable declaration
OUTPUT= c:¥dir1¥file1.obj# Descriptor$(OUTPUT) : c:¥dir1¥file1.c c:¥dir1¥file1.h→set VAR1=value1→gcc c:¥dir1¥file1.chmakeファイルではコメントには専用の行が必要です。コメントを他の文の最後に付けることはできません。

13.5

メッセージコマンド

メッセージコマンドは、メイクファイル実行中にテキストの行を標準出力に出力します。これらのテキスト行
は、適切に実行されている実行ファイルの出力の中で、メイクファイルに出現する順序で出力します。出力テキストのバッファリングは行いません。メッセージコマンドのシンタックスを以下に示します。
!MESSAGE <出力するテキスト>
改行文字が<出力するテキスト>の最後の文字の後にあると想定します。!MESSAGEと<出力するテキスト>の間の空白文字を無視します。メッセージコマンドの例を以下に示します。
!MESSAGE Executing C Compiler

R20UT0372JJ0100 Rev.1.00
2011.02.01

Page 479 of 479

High-performance Embedded Workshop V.4.09
ユーザーズマニュアル

発行年月日

2011 年 2 月 1 日

発行

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

編集

株式会社ルネサス ソリューションズ
ツール開発第一部

Rev.1.00

http://www.renesas.com
100-0004

2-6-2(03)5201-5307

http://japan.renesas.com/inquiry© 2011 Renesas Electronics Corporation and Renesas Solutions Corp. All rights reserved.
Colophon 1.0

High-performance Embedded Workshop V.4.09
ユーザーズマニュアル

R20UT0372JJ0100