. |

### CodeScapeマニュアルfor 2.1.2 Build 110

## はじめに

#### CodeScapeとは

CodeScapeは、高速で直感的に分かりやすいWindowsベースのデバッガです。Windows 95、Windows NT 3.51/4.0で動作します。

CodeScapeのデバッグ機能を使用すると、オリジナルのソースまたは逆アセンブルしたコード中のバグを検出し、原因を突き止め、それを修正することができます。

CodeScapeにより、次の作業が可能になります。

1. プロジェクトファイルの編集。
2. プロジェクトファイルのコンパイルとリンク。
3. プロジェクトのデバッグおよびエラーのテスト。
4. さらに、次のいずれかを行います。
   - デバッグでエラーが発生した場合は、上記ステップの1から3を繰り返す。
   - デバッグが正常に終了した場合は、プロジェクトをビルドする。

#### CodeScapeと各コンポーネント

CodeScapeは、次のようなコンポーネントとともに提供されます。

- Dev.Box一式
- Dreamcast SDK（CD-ROM）。CodeScapeデバッガ本体、ヘルプ、サンプルプログラム、その他のドキュメントが収録されています

#### ご注意

このマニュアルに記載されている事項は、予告なしに変更されることがあります。このマニュアルは「現状のまま（as is）」で提供され、特定用途に対する市場性または適合性に関する暗示的な保証や条件を含み、これらに限定されることなく、明示であるか暗黙であるかに関わらず、いかなる保証も行いません。またCross Products社は、それが保証、契約、または他の法理論に基いている場合であっても、本マニュアルにおける記述の誤り、または本資料の性能や使用に関連して発生した逸失利益を含め、二次的損害あるいは間接損害に対して、一切責任を負わないものとします。

このマニュアルには、著作権で保護された所有者固有の情報が含まれています。本マニュアルのいかなる部分も、Cross Products社の事前の許可なしに、いかなる形式でも複製、データベース システムや検索システムへの格納、その他いかなる手段によっても、転送や配布、電子的機械的なコピー、録音を行うことはできません。

#### 商標

- MS、Microsoft、MS-DOS、Windows、Windows NTは、米国 Microsoft Corporation の米国およびその他の国における登録商標です。
- CodeScapeとSNASMは、英国および英国外におけるCross Products Limitedの登録商標です。
- BriefはINPRISEの登録商標です。
- CodeWrightはPremia Corporationの登録商標です。
- Multi-EditはAmerican Cybernetics， Incの登録商標です。
- その他、記載されている会社名、製品名は、各社の商標および登録です。
- 本文中には、TM、（R）マークは明記しておりません。

#### 改版履歴

CodeScapeユーザーズガイド for 2.1.2 Build 110

1998年8月31日 　初版発行

1998年11月30日　第二版発行

1999年2月3日　　第三版発行

Copyright （C） 1998 by Cross Products Limited. All rights reserved.

Copyright （C） 1998 株式会社セガ・エンタープライゼス
編集・製作　株式会社アスキー AAP書籍編集部

. |

### 本マニュアルについて

#### 対象読者

本マニュアルでは、Windows 95またはWindows NT 3.51/4.0上でプログラムを作成するプログラマを対象としています。

#### 本マニュアルの構成

「第1章 インターフェイスの設定と使用法」では、CodeScapeのデバッグ環境と使用法を説明します。メニューバー、ツールバーおよびショートカットメニューのコマンドを説明し、プロジェクトで使用するウィンドウとリージョンの設定法と使用法を説明します。

「第3章 ターゲットプロセッサ」では、ターゲットプロセッサへの接続法、初期化法とリセット法を説明します。これには、プログラムの再起動、プログラムのバイナリ部分の保存とローディングが含まれます。

「第4章 セッション」では、セッションを使用するためのコマンドの使用法を説明します。これには、新規および既存のセッションのオープンの仕方、セッションの保存方法、名前を付けて保存する方法、セッションのクローズの仕方、最近使用したファイルリストの表示法と使用法、およびCodeScapeの終了の方法が含まれます。

「第5章 プロジェクトの使用法」では、プロジェクトビルド環境およびMS-DOSやWindowsのエディタの設定法を説明します。さらに、CodeScapeでのプロジェクトのビルド法と、コンパイル後にCodeScapeからエラーが通知された場合の対処法も説明します。

「第6章 デバッグ」では、プロジェクトファイルをデバッグするいくつかの方法を説明します。これには、ソースコードのステップ実行、ウォッチとデータブレークポイントの設定、およびアセンブラコードのシミュレーションが含まれます。

「第8章 コマンドラインの使用法」では、コマンドラインによるCodeScapeの使用法を説明します。

#### マニュアルの表記法

このマニュアルでは、次の表記法を使用しています。

表記 | 説明
［スペース］キー | キーボード上のキー名に使用しています。
［Alt］＋［F4］キー | 2個以上のキーを同時に押す必要がある場合、プラス記号「＋」で示します。
［Alt］、［F］、［X］キー | 2個以上のキーを連続して押す必要がある場合、「、」で示します。
input and output | このフォントは、ユーザーによる入力とエラーメッセージを含めプログラムからの出力を示すために使用されます。
command-line | このフォントは、コマンドラインオプションに使用されます。

. |

### CodeScape付加情報（平成10年10月26日版）

#### 概要

現時点でCodeScapeにはいくつかの使用制限があります。これらは早急に解除される予定ですが、制限事項を十分理解の上、使用ください。

CodeScape Debuggerは、Dev.Box上で動作するプログラムをデバッグするためのツールです。

#### 特徴

- PC上で動作するツールである。
- Dev.Box内のデバッグアダプタとSCSIにて接続される。
- Windowsベースのインターフェイス。

#### 推奨環境

#### PC環境

- OS：Windows95 OSR 2.0/2.1
- SCSIカード：ASPIドライバが動作するカード

ASPIマネージャはバージョン4.00以降が必要です。

Windows95に標準で付属するASPIマネージャは使用できません。詳しくはSCSIカードに付属のマニュアルをご参照ください。

なお、最新版ASPIマネージャは、
http://www.adaptec.com/support/overview/ezscsi4x.html
より、ダウンロードできます。

#### 制限事項

#### パイプラインシミュレータ・プロファイラ（αバージョン）

パイプラインシミュレータとプロファイラが実装されていますが、αバージョンであるため、各種の制限事項があります。詳細はCodeScapeヘルプファイルを参照ください。

#### Cのソース関連制限

以下はデバッグ時の推奨環境です。コンパイラのOptimize方法、CodeScapeの動作不具合を理解した上で使用するのであれば、この限りではありません。

デバッグするCソースは、

- コンパイル時のオプションは、optimize＝0以外指定しない。optimize＝1とした場合、変数の表示、プログラムのステップ実行が正常に行えなくなります。
- inline 展開関数は使用しない
- inline assembler は使用しない

の制限で開発することを推奨します。

#### 不具合項目

WatchLocal Watch |
- 変数の表示内容が間違っていることがあります。
- スコープの外と内側に同じ名前の変数がある場合、表示が正確に行われません。
Watch |
- optimize＝1のとき、変数の値が正常に表示されないことがあります。
Local Watch |
- optimize＝1のとき、変数の値が正常に表示されないことがあります。
Break |
- F5での設定が効かなくなるときがあります。（この場合でもメニューからの設定は可能です。）
- Optimize＝1のとき、ブレークポイントのコンディション設定が効かなくなります。
- Watch Conditionsを指定すると 変数の値が変化しなくなることがあります。
Register window |
- FR0-15 などが指定できるにも関わらず、Change Inc/DecValue に小数点を入力できません。
Step |
- Optimize＝1のとき、ソースコードの行の順番は保証されません。
Project |
- ビルドの最中、ウインドウの表示更新がされません。
Source |
- 行番号がニーモニックのある行にのみ表示されます。
Call Stack |
- 1レベルまたは2レベルまでしかコールスタックが表示されないことがあります。
Editor |
- 日本語の入力に一部問題があります。

#### 注意事項

#### OSモードとCPUモードについて

DebugAdapterの動作モードには、OSモードとCPUモードがあります。それぞれの特徴は以下のとおりです。これらのモードの切り替えは、DACheckの終了時に表示されるダイアログで行ないます。

OSモード： DebugAdapter起動後、BootROMに処理を移行します。GD-Workshopと組み合わせた自己起動プログラムのテストなどに使用します。

CPUモード： 標準的な動作モードです。DebugAdapterの起動後、Dev.Boxは待機状態になります。

#### 関連ファイルの更新

CodeScape上でLocal変数の参照が出来ない場合、CodeScapeフォルダ内の一部ファイルが古い可能性があります。CodeScapeディレクトリ内のファイル全てを、当SDKに付属のものに更新してください。

#### 動作に不具合が生じた場合

今まで動作していたものが急に動作しなくなった場合は、以下の項目を確認してください。

#### 主な確認事項

- 特定のプログラムのみ不具合が生じますか？（プログラムの不具合）
- PC上の他のアプリケーションは正常に動作していますか？（PCの不具合）
- 他の環境では、同じプログラムが正常動作していますか？（PCまたはDev.Boxの不具合）

内容 | 対処例
プログラムの不具合 | プログラムを修正する
PCの不具合 | 電源を入れ直す
PCの不具合 | OSを再インストールする。ASPIマネージャをアップデートする。
PCの不具合 | ハードウェアの変更
CodeScapeの不具合 | CodeScapeを再起動する。
CodeScapeに設定した項目が元に戻せなくなった | Codescape.iniファイルを消去する。
CodeScapeに設定した項目が元に戻せなくなった | Session を新たに生成し、再度設定し直す
Dev.Boxに初期化が必要 | CodeScapeより、File→Reset Target→Hard resetで再度プログラムを読み込む
Dev.Boxに初期化が必要 | Dev.Boxの電源を入れ直す。
Dev.Boxの不具合 | Dev.Boxの変更。

#### codescape.iniについて

PCでウインドウズのフォルダにあるcodescape.iniファイルを消去（またはリネーム）してください（例： c：\windows\codescape.iniを消去）。

これらはすべてを一度に行う必要はありません。症状に応じて適宜組み合わせて動作確認してください。再現性がある場合はお手数ですが、テクニカルサポートセンターまでご連絡ください。

#### 変更履歴

10月19日版からの変更点

- CodeScape Build100は、Build99のBugFix版のため、制限事項変更無し。

9月21日版からの変更点

- プロファイラ制限事項改定
- その他修正

7月30日版からの変更点

- 関連ファイルについて
- Profiler制限事項追加
- その他詳細修正

7月15日版からの変更点

- DALI.CFGについて
- プロジェクト設定について

6月30日版からの変更点

- 各種制限の変更
- プロファイラ・シミュレータの追加
- OSモードとCPUモードについて

6月11日版からの変更点

- ASPIマネージャに関する記述を追加。

5月07日版からの変更点

- CodeScapeのバージョンアップに伴い、制限事項項目が変わりました。

4月24日版からの変更点

- CodeScapeのバージョンアップに伴い、制限事項項目が変わりました。

[INDEX] | [→]