arm ds-5 デバッガの使用infocenter.arm.com/help/topic/com.arm.doc.dui0446ij/dui...目次 arm...

ARM® DS-5™

バージョン 5.9

デバッガの使用

Copyright © 2010-2012 ARM. All rights reserved.ARM DUI 0446IJ (ID ０５１５１２ )

ARM DS-5デバッガの使用

Copyright © 2010-2012 ARM. All rights reserved.

リリース情報

本書には以下の変更が加えられています。

著作権

® または ™ のマークが付いた言葉およびロゴは、この著作権情報で別段に規定されている場合を除き、

ARM の EU またはその他の国における登録商標および商標です。本書に記載されている他の製品名は、各

社の所有する商標です。

本書に記載されている情報の全部または一部、ならびに本書で紹介する製品は、著作権所有者の文書によ

る事前の許可を得ない限り、転用・複製ることを禁じます。

本書に記載されている製品は、今後も継続的に開発・改良の対象となります。本書に含まれる製品および

その利用方法についての情報は、 ARM が用者の利益のために提供するものです。したがって当社では、製

品の市販性または利用の適切性を含め、暗示的・明示的に関係なく一切の責任負いません。

本書は、本製品の利用者をサポートすることだけを目的としています。本書に記載されている情報の使用、

情報の誤りまたは省略、あるいは本製品の誤使用によって発生したいかなる損失・損傷についても、 ARM は一切責任を負いません。

ARM という用語が使用されている場合、 "ARM または必要に応じてその子会社 " を指します。

機密保持ステータス

本書は非機密扱いであり、本書を使用、複製、および開示する権利は、 ARM および ARM が本書を提供し

た当事者との間で締結した契約の条項に基づいたライセンスの制限により異なります。

製品ステータス

本書の情報は終版であり、開発済み製品に対応しています。

Web アドレス

http://www.arm.com

変更履歴

日付発行機密保持ステータス変更点

2010 年 6 月 A 非機密扱い DS-5 初版

2010 年 9 月 B 非機密扱い DS-5 バージョン 5.2 改訂版

2010 年 11 月 C 非機密扱い DS-5 バージョン 5.3 改訂版

2011 年 1 月 D 非機密扱い DS-5 バージョン 5.4 改訂版

2011 年 5 月 E 非機密扱い DS-5 バージョン 5.5 改訂版

2011 年 7 月 F 非機密扱い DS-5 バージョン 5.6 改訂版

2011 年 9 月 G 非機密扱い DS-5 バージョン 5.7 改訂版

2011 年 11 月 H 非機密扱い DS-5 バージョン 5.8 改訂版

2012 年 2 月 I 非機密扱い DS-5 バージョン 5.9 改訂版

ARM DUI 0446IJ Copyright © 2010-2012 ARM. All rights reserved. iiID ０５１５１２ Non-Confidential

目次ARM DS-5 デバッガの使用

第 1 章表記規則とフィードバック

第 2 章デバッガの使い方2.1 デバッガについて .................................................................................................... 2-22.2 デバッガの概念 ....................................................................................................... 2-42.3 Eclipse からのデバッガの起動 ................................................................................ 2-62.4 コマンドラインコンソールからのデバッガの起動 ................................................. 2-72.5 DS-5 デバッグパースペクティブのキーボードショートカット ........................... 2-112.6 DS-5 デバッガコマンドラインコンソールのキーボードショートカット ............. 2-13

第 3 章ターゲットの設定と接続3.1 ターゲット接続の種類 ............................................................................................. 3-33.2 RTSM モデルへの接続の設定 ................................................................................. 3-43.3 gdbserver を使用した Linux ターゲットへの接続の設定 ........................................ 3-63.4 Linux カーネルへの接続の設定 ............................................................................... 3-93.5 ベアメタルターゲットへの接続の設定 ................................................................. 3-123.6 ベアメタルターゲットへのイベントビューアの接続の設定 ................................. 3-143.7 コンフィギュレーションデータベースインポートユーティリティについて ........ 3-173.8 コンフィギュレーションデータベースインポートユーティリティの起動 ........... 3-203.9 モデルからの DS-5 の新しいプラットフォームコンフィギュレーションの作成 . 3-213.10 RVC ファイルからの DS-5 の新しいプラットフォームコンフィギュレーションの作成

3-223.11 既存の起動コンフィギュレーションのエクスポート ............................................ 3-243.12 既存の起動コンフィギュレーションのインポート ............................................... 3-263.13 ターゲットからの切断 ........................................................................................... 3-28

第 4 章実行制御4.1 ターゲットへのイメージのロードについて ............................................................ 4-2

ARM DUI 0446IJ Copyright © 2010-2012 ARM. All rights reserved. iiiID ０５１５１２ Non-Confidential

目次

4.2 デバッガへのデバッグ情報のロードについて ......................................................... 4-44.3 イメージの実行 ....................................................................................................... 4-64.4 ブレークポイントとウォッチポイントについて ..................................................... 4-74.5 実行ブレークポイントの設定 ................................................................................ 4-104.6 データウォッチポイントの設定 ............................................................................ 4-134.7 トレースポイントの設定 ....................................................................................... 4-154.8 条件ブレークポイントの設定 ................................................................................ 4-164.9 特定のスレッドへのブレークポイントの設定 ....................................................... 4-204.10 ブレークポイントとウォッチポイントの保留 ....................................................... 4-224.11 ファイルへの DS-5 ブレークポイント設定のエクスポート .................................. 4-244.12 ファイルからの DS-5 ブレークポイント設定のインポート .................................. 4-264.13 アプリケーションのステップ実行 ......................................................................... 4-284.14 Unix シグナルの処理 ............................................................................................. 4-304.15 プロセッサ例外処理 .............................................................................................. 4-324.16 デバッガパスの代入規則の設定 ............................................................................ 4-34

第 5 章ターゲットの検査5.1 ターゲット実行環境の検査 ..................................................................................... 5-25.2 コールスタックの検査 ............................................................................................. 5-55.3 トレースサポートについて ..................................................................................... 5-7

第 6 章組み込みシステムのデバッグ6.1 エンディアンについて ............................................................................................. 6-26.2 AHB バスと APB バスへのアクセスについて ......................................................... 6-36.3 仮想メモリと物理メモリについて ........................................................................... 6-46.4 ハイパーバイザのデバッグについて ....................................................................... 6-56.5 ベアメタル対称型マルチプロセスシステムのデバッグについて ............................ 6-76.6 マルチスレッドアプリケーションのデバッグについて ........................................ 6-106.7 共有ライブラリのデバッグについて ..................................................................... 6-126.8 Linux カーネルのデバッグについて ...................................................................... 6-156.9 Linux カーネルモジュールのデバッグについて .................................................... 6-176.10 TrustZone 対応ターゲットのデバッグについて .................................................... 6-19

第 7 章スクリプトを使用したデバッグ7.1 デバッグセッションで生成された DS-5 デバッガコマンドのエクスポート .......... 7-27.2 DS-5 デバッガスクリプトの作成 ............................................................................ 7-37.3 Jython スクリプトの作成 ........................................................................................ 7-47.4 CMM スタイルのスクリプトの作成 ........................................................................ 7-77.5 スクリプトの実行 .................................................................................................... 7-97.6 Eclipse での Jython プロジェクトの設定 .............................................................. 7-11

第 8 章実行時メッセージの制御8.1 セミホスティングと top of memory について ......................................................... 8-28.2 セミホスティングの使用 ......................................................................................... 8-48.3 デバッガでの自動セミホスティングサポートの有効化 .......................................... 8-58.4 コマンドラインコンソールを使用したセミホスティングメッセージの制御 .......... 8-68.5 ログメッセージの出力の制御 .................................................................................. 8-78.6 log4j コンフィギュレーションファイルについて .................................................... 8-88.7 デバッガからのログメッセージの出力のカスタマイズ .......................................... 8-9

第 9 章スナップショットビューアの使用9.1 スナップショットビューアの初期化ファイルの作成 .............................................. 9-29.2 スナップショットビューアについて ....................................................................... 9-59.3 スナップショットビューアへの接続 ....................................................................... 9-89.4 スナップショットビューアのデバッガスクリプト作成時の注意事項 ..................... 9-9

第 10 章 DS-5 デバッグパースペクティブおよびビュー10.1 ［App Console］ビュー .......................................................................................... 10-310.2 ［ARM Asm Info］ビュー ....................................................................................... 10-5

ARM DUI 0446IJ Copyright © 2010-2012 ARM. All rights reserved. ivID ０５１５１２ Non-Confidential

目次

10.3 ARM アセンブラエディタ ..................................................................................... 10-610.4 ［Breakpoints］ビュー ............................................................................................ 10-910.5 C/C++ エディタ ................................................................................................... 10-1410.6 イベントビューアのチャネルエディタ ............................................................... 10-1810.7 ［Commands］ビュー .......................................................................................... 10-2010.8 ［Debug Control］ビュー ..................................................................................... 10-2310.9 ［Disassembly］ビュー ........................................................................................ 10-2810.10 ［Expressions］ビュー ......................................................................................... 10-3210.11 関数ビュー ........................................................................................................... 10-3510.12 ［History］ビュー ................................................................................................. 10-3810.13 ［Memory］ビュー ................................................................................................ 10-4010.14 ［Modules］ビュー ............................................................................................... 10-4410.15 ［Registers］ビュー ............................................................................................. 10-4710.16 ［Screen］ビュー ................................................................................................. 10-5010.17 ［Scripts］ビュー .................................................................................................. 10-5310.18 ［Target］ビュー .................................................................................................. 10-5510.19 ［Trace］ビュー ................................................................................................... 10-5710.20 ［Variables］ビュー .............................................................................................. 10-6110.21 ［Export memory］ダイアログボックス ............................................................... 10-6410.22 ［Import memory］ダイアログボックス ............................................................... 10-6610.23 ［Export trace report］ダイアログボックス ......................................................... 10-6810.24 ［Breakpoint properties］ダイアログボックス ..................................................... 10-7010.25 ［Watchpoint properties］ダイアログボックス .................................................... 10-7510.26 ［トレースポイントのプロパティ］ダイアログボックス .................................... 10-7610.27 ［Manage Signals］ダイアログボックス ............................................................. 10-7710.28 ［Functions Filter］ダイアログボックス .............................................................. 10-7910.29 ［Debug Configurations］ - ［Connection］タブ ................................................... 10-8010.30 ［Debug Configurations］ - ［Files］タブ ............................................................. 10-8510.31 ［Debug Configurations］ - ［Debugger］タブ ..................................................... 10-9010.32 ［Debug Configurations］ - ［Arguments］タブ ................................................... 10-9510.33 ［Debug Configurations］ - ［Environment］タブ ................................................. 10-9810.34 ［Debug Configurations］ - ［Event Viewer］タブ .............................................. 10-10110.35 DS-5 デバッガメニューとツールバーアイコン ................................................. 10-104

第 11 章トラブルシューティング11.1 ARM Linux の問題と解決法 ................................................................................... 11-211.2 デバッガからの内部ログの有効化 ......................................................................... 11-311.3 ターゲット接続の問題と解決法 ............................................................................ 11-4

ARM DUI 0446IJ Copyright © 2010-2012 ARM. All rights reserved. vID ０５１５１２ Non-Confidential

第 1 章表記規則とフィードバック

以下では、表記規則とフィードバックの方法について説明します。

表記規則

以下の表記規則を使用しています。

monospace コマンド、ファイル名、プログラム名、ソースコードなど、キー

ボードから入力可能なテキストを示しています。

monospace コマンドまたはオプションに使用可能な略語を示します。コマン

ド名またはオプション名をすべて入力する代わりに、下線部分の文字だけを入力することができます。

monospace italic コマンドまたは関数の引数で、特定の値に置き換えることが可能なものを示しています。

monospace bold サンプルコード以外に使用される言語キーワードを示しています。

italic 重要事項、重要用語、相互参照、引用箇所を斜体で記載していま

す。

bold メニュー名などのユーザインタフェース要素を太字で記載してい

ます。また、適宜記述リスト内の重要箇所と ARM® プロセッサの

信号名にも太字を用いています。

ARM DUI 0446IJ Copyright © 2010-2012 ARM. All rights reserved. 1-1ID ０５１５１２ Non-Confidential

表記規則とフィードバック

本製品に関するフィードバック

本製品についてのご意見やご提案がございましたら、以下の情報を添えて購入元までお寄せ下さい。

• お名前と会社名

• 製品のシリアル番号

• 製品のリリース情報

• ご使用のプラットフォームの詳細（ハードウェアプラットフォーム、オペレーティングシステムの種類とバージョンなど）

• 問題を再現するサイズの小さな独立したサンプルコード

• 操作の目的と実際の動作に関する詳しい説明

• 使用したコマンド（コマンドラインオプションを含む）

• 問題を例示するサンプル出力

• ツールのバージョン情報（バージョン番号、ビルド番号を含む）

内容に関するフィードバック

内容に関するご意見につきましては、電子メールを [email protected] まで

送信して下さい。その際には、以下の内容を記載して下さい。

• タイトル

• 文書番号（ARM DUI 0446IJ）

• オンラインでご覧の場合は、該当するトピック名

• PDF 版の文書をご覧の場合は、問題のあるページ番号

• 問題点の簡潔な説明

また、補足すべき点や改善すべき点についての全般的なご提案もお待ちしております。

ARM では、技術情報記事や FAQ の拡充と共に、ドキュメントに対する更新と訂正を ARM Information Center にて定期的に行っております。

その他の情報

• ARM Infocenter, http://infocenter.arm.com/help/index.jsp

• ARM Technical Support Knowledge Articles, http://infocenter.arm.com/help/topic/com.arm.doc.faqs

• サポートおよびメンテナンス , http://www.arm.com/support/services/support-maintenance.php

• ARM 用語集 , http://infocenter.arm.com/help/topic/com.arm.doc.aeg0014-/index.html


第 2 章デバッガの使い方

以下の各トピックでは、デバッガの概要を紹介し、デバッガの起動方法について説明します。

タスク • Eclipse からのデバッガの起動（2-6 ページ）

• コマンドラインコンソールからのデバッガの起動（2-7 ページ） .

概念

• デバッガについて（2-2 ページ）

• デバッガの概念（2-4 ページ） .

参照 • DS-5 デバッグパースペクティブのキーボードショートカット（2-11 ページ）

• DS-5 デバッガコマンドラインコンソールのキーボードショートカット（2-13 ペー

ジ） .


デバッガの使い方

2.1 デバッガについて

ARM® DS-5™ デバッガには、 ARM アーキテクチャベースのプロセッサを使用した

ハードウェアターゲットとモデルの両方でアプリケーションをデバッグするたの強力なツールが用意されています。実行フローを完全に制御することによって、エラー

をすばやく検出して修正できます。

以下の機能が用意されています。

• イメージとシンボルのロード

• イメージの実行

• ブレークポイントとウォッチポイント

• ソースおよび命令レベルのステップ実行

• 変数およびレジスタ値へのアクセス

• コールスタックのナビゲーション

• 例外および Linux signal 処理のサポート

• マルチスレッド Linux アプリケーションのデバッグ

• Linux カーネルモジュール、ブートコード、およびカーネル移植のデバッグ

• ベアメタル対称型マルチプロセス（SMP）システムのデバッグ

デバッガは、 Eclipse 統合開発環境（IDE）で実行できる包括的な DS-5 デバッガコマ

ンドのセット、スクリプトファイル、またはコマンドラインコンソールをサポートしています。さらに、ターゲットの初期化スクリプトを実行するのに十分な CMM 形式のコマンドが多少用意されています。 CMM は一部のサードパーティ製デバッガに

よってサポートされているスクリプト言語です。 CMM 形式のコマンドを実行するに

は、 CMM 形式のコマンドを含むデバッガスクリプトファイルを成して、 DS-5 デバッガの source コマンドを使用してスクリプトを実行する必要があります。

使用を開始する上で役立つチュートリアルがいくつかあり、 DS-5 ツールを使用して

アプリケーションを実行およびデバッグする方法について説明しています。

2.1.1 関連項目

タスク • ARM® DS-5™ 『DS-5 スタートガイド』の DS-5 チュートリアル :

— Eclipse へのサンプルプロジェクトのインポート（3-5 ページ）

— Eclipse からの Gnometris プロジェクトの作成（3-7 ページ）

— Gnometris アプリケーションのリアルタイムシステムモデルへのロード

（3-9 ページ）

— Gnometris アプリケーションの ARM Linux ターゲットへのロード

（3-10 ページ）

— RSE 接続を使用した ARM Linux ターゲットの操作（3-11 ページ）

— ARM Linux ターゲット上で既に実行されている Gnometris アプリケーショ

ンへの接続（3-17 ページ）

— Gnometris のデバッグ（3-21 ページ）

— ロード可能なカーネルモジュールのデバッグ（3-23 ページ）

— ARM Linux 上で動作するスレッドアプリケーションのパフォーマンス解析

（3-28 ページ）

— Android ターゲットへの hello-neon アプリケーションのロード（3-32 ペー

ジ） .



• Eclipse からのデバッガの起動（2-6 ページ）

• コマンドラインコンソールからのデバッガの起動（2-7 ページ）

• 『ARM® DS-5™ ： Eclipse の使用』：

— カスタム Eclipse 環境への DS-5 のインストール（3-3 ページ） .

概念 • デバッガの概念（2-4 ページ）

• ターゲット接続の種類（3-3 ページ） .

参照 • 『ARM® DS-5™ ：デバッガコマンドリファレンス』：

— 第 2 章 DS-5 デバッガコマンド

— 第 3 章デバッガによってサポートされている CMM 形式のコマンド .• 『ARM® DS-5™ ： Eclipse の使用』：

— 第 2 章 Eclipse スタートガイド .



2.2 デバッガの概念

以下の概念がアプリケーションのデバッグ時に関係します。

デバッガデバッガはホストコンピュータで実行されるソフトウェアであり、これ

によってデバッグエージェントを使用してデバッグターゲット上で実行されるソフトウェアの検証および制御ができます。

デバッグセッション

デバッグセッションは、ターゲット上で実行されているソフトウェアをデバッグするために、デバッガをターゲットまたはモデルに接続したとき開始し、ターゲットからホストソフトウェアを切断したときに終了します。

デバッグターゲット

製品開発の初期段階は、ハードウェアがない場合があるので、ハードウェアの予想される動作をソフトウェアでシミュレートします。デバッ

ガのマニュアルでは、これをモデルと呼びます。モデルをデバッガと同

じコンピュータで実行する可能性があっても、ターゲットを別個のハードウェアとして考えることが重要です。

あるいは、アプリケーションを実行またはデバッグする 1 つ以上のプロ

セッサを含むプリント基板にプロトタイプ製品を構築できます。デバッ

ガマニュアルでは、これをハードウェアターゲットと呼びます。

デバッグエージェントデバッグエージェントは、ターゲット上のデバッガによって

要求されるアクションを実行します。以下に例を示します。

• ブレークポイントの設定

• メモリからの読み出し

• メモリへの書き込み

デバッグエージェントはデバッグされるアプリケーションではなく、デバッガ自体でもありません。

以下はその例です。

• デバッグハードウェアエージェント：

— ARM DSTREAM™ ユニット

— ARM RVI™ ユニット

• デバッグソフトウェアエージェント：

— リアルタイムシステムモデル（RTSM）

— gdbserver

コンテキストターゲットの各プロセッサは現在実行中のプロセスを持つことができ

ます。各プロセスは、変数、レジスタ、および他のメモリ位置に格納さ

れる値を使用します。プロセスの実行中にこれらの値を変更できます。

プロセスのコンテキストでは、現在のすべてのアクティブコールを列挙するコールスタックで主に定義されているように、現在の状態を記述します。コンテキストは以下の場合に変更されます。

• 関数が呼び出された。

• 関数から戻った。

• 割り込みまたは例外が発生した。



変数はクラス、ローカル、またはグローバル有効範囲を持つことができるので、現在アクセス可能な変数はコンテキストによって決定されます。すべてのプロセスは独自のコンテキストを持っています。プロセス

の実行を停止すると、現在のコンテキスト内の値の検証と変更を行うことができます。

有効範囲変数の有効範囲は、定義されているアプリケーション内のポイントに

よって決定されます。変数は、以下の範囲内の関連する値を持つことが

できます。

• 特定のクラスのみ（クラス）

• 特定の関数のみ（ローカル）

• 特定のファイルのみ（スタティックグローバル）

• アプリケーション全体（グローバル）

2.2.1 関連項目

タスク

• RTSM モデルへの接続の設定（3-4 ページ）

• gdbserver を使用した Linux ターゲットへの接続の設定（3-6 ページ）

• Linux カーネルへの接続の設定（3-9 ページ） .

• ベアメタルターゲットへの接続の設定（3-12 ページ） .

概念


参照

• ARM® DS-5™ ARM® DSTREAM™ ハードウェアの設定 , http://infocenter.arm.com/help/topic/com.arm.doc.dui0481-/index.html

• ARM® DS-5™ ARM® の RVI™ と RVT™ ハードウェアの設定 , http://infocenter.arm.com/help/topic/dui0515-/index.html.



2.3 Eclipse からのデバッガの起動

デバッガを起動するには

1. Eclipse を起動します。

• Windows 環境では、［スタート］ → ［すべてのプログラム］ → ［ARM DS-5］ → ［Eclipse for DS-5］を選択します。

• Linux の場合：

— インストール時にショートカットをインストールした場合は、［アプリケーション］メニューで［Eclipse for DS-5］を選択します。

— インストール時にショートカットをインストールしていない場合：

1. install_directory/bin ディレクトリを PATH 環境変数に追加しま

す。既に設定されている場合は、この手順を省略します。

2. Unix bash シェルを開きます。

3. プロンプトで「eclipse」と入力します。

2. メインメニューから［ウィンドウ］ → ［パースペクティブを開く］ → ［DS-5 Debug］を選択します。

3. 前にデバッグセッションを実行していなかった場合は、タスクのデバッグを開始する前に、デバッガとターゲットの間の接続を設定する必要があります。

4. 前にデバッグセッションを実行していた場合は、［Debug Control］ビューでター

ゲット接続を選択し、［Connect to Target］ツールバーアイコンをクリックしま

す。

2.3.1 関連項目

タスク • RTSM モデルへの接続の設定（3-4 ページ）


• Linux カーネルへの接続の設定（3-9 ページ）


概念 • ターゲット接続の種類（3-3 ページ） .

参照 • ［Debug Control］ビュー（10-23 ページ）

• ［Commands］ビュー（10-20 ページ）

• ［Breakpoints］ビュー（10-9 ページ）

• ［Disassembly］ビュー（10-28 ページ）

• ［Variables］ビュー（10-61 ページ）

• ［Registers］ビュー（10-47 ページ）

• ［Memory］ビュー（10-40 ページ）

• ［Debug Configurations］ - ［Connection］タブ（10-80 ページ） .• 『ARM® DS-5™ ： Eclipse の使用』：

— パースペクティブとビュー（2-22 ページ） .



2.4 コマンドラインコンソールからのデバッガの起動

デバッガを起動するには

1. コマンドラインコンソールを起動します。

Windows の場合、［スタート］ → ［プログラム］ → ［ARM DS-5］ → ［DS-5 Command Prompt］を選択します。

Linux の場合：

a. install_directory/bin ディレクトリを PATH 環境変数に追加します。既に設

定されている場合は、この手順を省略します。

b. Unix bash シェルを開きます。

2. 以下のコマンドライン構文を使用してデバッガを起動します。

debugger --target [--target_device] [option]…

各パラメータには以下の意味があります。

--target=host:port|filename

デバッガと gdbserver 間の接続用の host:port、またはターゲットコン

フィギュレーションファイル（XML ファイルや RVC ファイルなど）

のいずれかを指定します。

シリアル接続には以下の例のような XML ファイルが必要です。

例 2-1 mySerialConfig.xml

<?xml version="1.0"?><RVConfigUtility>

<rddi type="rddi-debug-gdb"/><rddigdb>

<connection><serial>

<port>COM1</port><speed>115200</speed>

</serial></connection>

</rddigdb></RVConfigUtility>

--target_device=number|name

デバイスの番号または名前を指定します。複数のデバイスがあるター

ゲットへの接続を設定するときは、 --target_device コマンドラインオ

プションを使用してデバッガを起動する必要があります。 --target_device を指定しないと、デバッガは使用可能なすべてのデバ

イスを列挙して終了します。

さらに、 option は以下のいずれかになります。

--continue_on_error=true|false

エラーが発生したときにデバッガでターゲットを停止して現在のスクリプトを終了するかどうかを指定します。デフォルトは --continue_on_error=false です。

--disable_semihosting

セミホスティング操作を無効にします。



--disable_semihosting_console

デバッガコンソールに対するすべてのセミホスティング操作を無効にします。

--enable_semihosting

セミホスティング操作を有効にします。

--help 主なコマンドラインオプションの一覧を表示します。

- - image=filenameデバッガがターゲットに接続したときにロードするイメージファイルを指定します。

- - interactiveWindows コマンドプロンプトや Unix bash シェルなどの現在のコマン

ドラインコンソールからデバッガに標準入出力を転送するインタラクティブモードを指定します。スクリプトファイルが指定されていない

場合は、これがデフォルトになります。

--log_config=option

デバッガから実行時メッセージを出力するログコンフィギュレーションのタイプを指定します。


option 定義済みのログコンフィギュレーションまたはユーザ定義

のログコンフィギュレーションファイルを指定します。

info 定義済みの INFO レベル設定を使用する出力メッ

セージ。このレベルではデバッグメッセージを出

力しません。これがデフォルトです。

debug 定義済みの DEBUG レベル設定を使用する出力

メッセージ。このオプションは INFO レベルと DEBUG レベルの両方のメッセージを出力します。

filename メッセージの出力をカスタマイズするユーザ定義

のログコンフィギュレーションファイルを指定します。デバッガは log4j コンフィギュレーショファ

イルをサポートします。

--log_file=filename

デバッガから実行時メッセージを受け取る出力ファイルを指定します。このオプションを使用しないと、出力メッセージはコンソールに

転送されます。

--script=filename

ターゲットの制御とデバッグを行うデバッガコマンドを含むスクリプトファイルを指定します。複数のスクリプトファイルがある場合は、

このオプションを繰り返し指定できます。スクリプトは指定した順序

で実行されます。

--semihosting_error=filename

セミホスティング操作で stderr を書き込むファイルを指定します。

--semihosting_input=filename

セミホスティング操作で stdin を読み出すファイルを指定します。

--semihosting_output=filename

セミホスティング操作で stdout を書き込むファイルを指定します。



--stop_on_connect=true|false

ターゲットデバイスに接続したときにデバッガでターゲットを停止するかどうかを指定します。接続時にターゲットを変更しない場合は、

false を指定する必要があります。デフォルトは --stop_on_connect=true です。

--target_os

ターゲットのオペレーティングシステム（OS）の名前

（--target_os=linux など）を指定します。これにより、共有ライブラリ

サポートなど、デバッガ内での OS サポートが有効になります。使用

できるオプションは以下のとおりです。

linux Linux アプリケーションのデバッグを OS がサポート

linux-kernel

Linux カーネルのデバッグを OS がサポート

--top_mem=address

top of memory とも呼ばれるスタックベースを指定します。 top of memory はセミホスティング操作にのみ使用されます。

注セミホスティングは、アプリケーションコードからデバッガを実行するホスト

ワークステーションへの入出力要求の通信に使用します。

例 2-2 ベアメタルコマンドライン接続の例

debugger --target=beagleboard.rvc --target_device=Cortex-A8

接続したら、 DS-5 デバッガコマンドを使用してターゲットにアクセスし、デ

バッグを開始します。たとえば info registers は、すべてのアプリケーションレ

ベルのレジスタを表示します。

2.4.1 関連項目

タスク • デバッグセッションで生成された DS-5 デバッガコマンドのエクスポート

（7-2 ページ）

• ログメッセージの出力の制御（8-7 ページ） .

概念 • ターゲット接続の種類（3-3 ページ）

• セミホスティングと top of memory について（8-2 ページ） .

参照

• DS-5 デバッガコマンドラインコンソールのキーボードショートカット

（2-13 ページ）

• 『ARM® DS-5™ ：デバッガコマンドリファレンス』：


— 第 3 章デバッガによってサポートされている CMM 形式のコマンド .



その他の情報

• Apache ログサービスの Log4j, http://logging.apache.org.



2.5 DS-5 デバッグパースペクティブのキーボードショートカット

DS-5 デバッグパースペクティブを使用する場合は、キーボードショートカットを使

用できます。

どのビューまたはどのダイアログボックスでも、以下のキーを使用してダイナミックヘルプにアクセスできます。

• Windows の場合、 F1 キー

• 例えば Linux の場合、 Shift+F1 キー

ターゲットに接続している場合のみ、以下のキーボードショートカットを使用できます。

［Commands］ビュー

以下のキーボードショートカットを使用できます。

Ctrl+Space コマンドの自動補完コンテンツアシストにアクセス

します。

Enter 隣接するフィールドに入力されるコマンドを実行し

ます。

下矢印キーコマンド履歴を下方向に移動します。

上矢印キーコマンド履歴を上方向に移動します。

［Debug Control］ビュー

以下のキーボードショートカットを使用できます。

F5 デバッグ情報があるすべての関数呼び出しへのス

テップ実行など、ソースレベルまたは命令レベルでステップ実行します。また、 ALT+F5 を使用して逆の

モードでステップ実行することもできます。例えば、

ソースレベルのステップ実行モードの場合は、ALT+F5 を使用すると、命令レベルのステップが実

行されます。

F6 ソースレベルまたは命令レベルでステップ実行しま

すが、すべての関数呼び出しをステップオーバーします。

F7 選択したスタックフレームが終了した後、以下の命

令の実行を継続します。

F8 現在の位置からアプリケーションイメージの実行を

開始します。

ブレークポイントに達したか、またはターゲットが中断された後に、アプリケーションの実行を継続します。

注［Connect only］接続は、実行する前に、 PC レジスタ

をイメージの開始位置に設定する必要があります。

F9 ターゲットを中断し、実行中であれば現在のアプリ

ケーションを停止します。



2.5.1 関連項目

参照







2.6 DS-5 デバッガコマンドラインコンソールのキーボードショートカット

DS-5 デバッガコマンドラインコンソールを使用している場合、コマンド履歴やいく

つかの一般的なキーボードショートカットなど、多数の便利なイン編集機能が用意されています。

入力する各コマンドは、コマンド履歴に格納されます。上および下矢印キーを使用し

てコマンド履歴内を移動して、前のコマンドを検索したり再発行したりすることができます。

コマンドの編集やコマンド履歴の移動を簡単にするために、多数の特殊なキーボードショートカットを使用できます。

以下にも一般的なキーボードショートカットを示します。

Ctrl+A カーソルを行の先頭に移動します。

Ctrl+D デバッガコンソールを終了します。

Ctrl+E カーソルを行末に移動します。

Ctrl+N 入力したテキストについてコマンド履歴を順方向に検索します。

Ctrl+P 入力したテキストについてコマンド履歴を逆方向に検索します。

Ctrl+W 後の語を削除します。

下矢印キーコマンド履歴を下方向に移動します。

上矢印キーコマンド履歴を上方向に移動します。

2.6.1 関連項目

参照

• コマンドラインコンソールからのデバッガの起動（2-7 ページ）





第 3 章ターゲットの設定と接続

以下の各トピックでは、 Eclipse 統合開発環境（IDE）の ARM® DS-5™ デバッガを使用し

て、デバッグターゲットを設定し、デバッグターゲットに接続する方法について説明します。




• ベアメタルターゲットへの接続の設定（3-12 ページ）

• ベアメタルターゲットへのイベントビューアの接続の設定（3-14 ページ）

• コンフィギュレーションデータベースインポートユーティリティについて（3-17 ページ）

• コンフィギュレーションデータベースインポートユーティリティの起動（3-20 ページ）

• モデルからの DS-5 の新しいプラットフォームコンフィギュレーションの作成

（3-21 ページ）

• RVC ファイルからの DS-5 の新しいプラットフォームコンフィギュレーションの作

成（3-22 ページ）

• 既存の起動コンフィギュレーションのエクスポート（3-24 ページ）

• 既存の起動コンフィギュレーションのインポート（3-26 ページ）

• ターゲットからの切断（3-28 ページ） .


ターゲットの設定と接続

概念

• コンフィギュレーションデータベースインポートユーティリティについて（3-17 ページ）




3.1 ターゲット接続の種類

アプリケーションをデバッグする前に、デバッガを実行するホストワークステーションとターゲット間の接続を設定する必要があります。

デバッガによってサポートされる接続には以下の種類があります。

Linux アプリケーション

Linux アプリケーションをデバッグするには、以下への TCP 接続または

シリアル接続を使用できます。

• ARM 組み込み Linux をブートするよう事前設定されているモデル

で実行されている gdbserver

• ハードウェアターゲットで実行されている gdbserver

このタイプの開発には gdbserver をインストールしてターゲット上で実

行する必要があります。 gdbserver がターゲットにインストールされてい

ない場合は、 Linux ディストリビューションのマニュアルを参照するか、

またはプロバイダにお問い合わせ下さい。あるいは、

install_directory/arm にある DS-5 インストールから gdbserver を使用する

こともできます。

ベアメタルと Linux カーネル

ベアメタルターゲット、 Linux カーネル、またはカーネルデバイスドラ

イバ上で実行されているアプリケーションをデバッグするには、ホストワーステーションおよびターゲットに接続されているデバッグハードウェアエージェントを使用できます。

スナップショットビューア

スナップショットビューアを使用すると、前にキャプチャした状態を使用して、アプリケーションの読み出し専用表示でデバッグできるようになます。

注現在、 DS-5 では、コマンドラインコンソールを使用した DS-5 デバッガ

のスナップショットビューアへの接続のみサポートしています。

3.1.1 関連項目






• 既存の起動コンフィギュレーションのインポート（3-26 ページ） .


• スナップショットビューアについて（9-5 ページ） .



3.2 RTSM モデルへの接続の設定

DS-5 は、 Windows と Linux プラットフォームの両方で、リアルタイムシステムモデ

ル（RTSM）とホストマシンの間のシリアル接続をサポートしています。

RTSM に接続するには


2. ［Run］メニューから［Debug Configurations...］を選択します。

3. コンフィギュレーションツリーから［DS-5 Debugger］を選択し、［New］をク

リックして新しいコンフィギュレーションを作成します。

4. ［Name］フィールドに、新しいコンフィギュレーションの適切な名前を入力し

ます。

5. ［Connection］タブをクリックして、 DS-5 デバッガターゲット接続を設定しま

す。

a. 必要な RTSM プラットフォームを選択します。

b. ［Linux Application Debug］プロジェクトタイプを選択します。

c. 必要なデバッグ操作を選択します。例えば、仮想ファイルシステム（VFS）を使用する場合は、［Debug target resident application］を選択します。

d. ［Connections］パネルで、シリアル接続が自動的に設定されます。

e. VFS を使用する場合は、［Enable virtual file system support］を選択しま

す。デフォルトの VFS マウントポイントは、Eclipse ワークスペースルート

ディレクトリを、モデルの /writeable ディレクトリにマップします。デフォルトのままにするか、必要に応じて変更して下さい。

注 VFS はモデルの初期化時にのみ設定されます。 VFS ディレクトリ構造を変

更すると、モデルを再起動しなければならない場合があります。

6. ［Files］タブをクリックしてターゲット環境を定義し、デバッガを使用するホ

スト上のアプリケーションファイルおよびライブラリのデバッグバージョン選択します。

a. ［Target Configuration］パネルで、ターゲット上のアプリケーションの場所

を指定します。また、必要に応じて、ターゲット作業ディレクトリを指定

ることもできます。

b. ［Files］パネルで、デバッガを使用してデバッグ情報をロードするホスト

上のファイルを選択します。

注［Files］タブのオプションは、選択するデバッグ操作のタイプに依存します。

7. ［Debugger］タブをクリックして、デバッガ設定を構成します。

a. ターゲットに接続した後にデバッガで行うアクションを指定します。

b. ホスト作業ディレクトリを設定するか、またはデフォルトを使用します。

c. デバッガがソースコードを表示するときに使用するホスト上の検索パスを設定します。



8. 必要に応じて、［Arguments］タブをクリックして、デバッグセッションの開始

時にアプリケーションに渡される引数を入力します。

9. 必要に応じて、［Environment］タブをクリックして、デバッグセッションの開

始時にアプリケーションに渡されるターゲット環境変数を作成して設定します。

10. ［Apply］をクリックしてコンフィギュレーション設定を保存します。

11. ターゲットに接続し、すぐにデバッグを開始する場合は、［Debug］をクリック

します。

または、［Close］をクリックして、［Debug Configurations］ダイアログボックス

を閉じます。デバッグ制御ビューを使用して、このデバッグコンフィギュレー

ションに連付けられているデバッグターゲットに接続します。

12. デバッグには、 DS-5 デバッグパースペクティブが必要です。［Confirm Perspective Switch］ダイアログボックスが表示された場合は、［Yes］をクリッ

クしてパースペクティブを切り替えます。

接続時に DS-5 デバッグパースペクティブが開いている場合は、関連するすべての

ビューとエディタが表示されます。

これらのオプションの詳細については、ダイナミックヘルプを使用して下さい。

3.2.1 関連項目

タスク





— ダイナミックヘルプの表示（2-39 ページ） .

概念


参照 • ［Debug Configurations］ - ［Connection］タブ（10-80 ページ）

• ［Debug Configurations］ - ［Files］タブ（10-85 ページ）

• ［Debug Configurations］ - ［Debugger］タブ（10-90 ページ）

• ［Debug Configurations］ - ［Arguments］タブ（10-95 ページ）

• ［Debug Configurations］ - ［Environment］タブ（10-98 ページ）

• 『ARM® DS-5™ ： DS-5 スタートガイド』：

— リアルタイムシステムモデルについて（2-5 ページ） .



3.3 gdbserver を使用した Linux ターゲットへの接続の設定

gdbserver を使用しているターゲット上で既に実行されているアプリケーションに接

続できます。

3.3.1 前提条件

接続前に以下の手順を行う必要があります。

1. インストールされブートされているオペレーティングシステム（OS）でター

ゲットを設定します。詳細については、ターゲットに付属のマニュアルを参照

して下さい。

2. ターゲット接続を設定します。

• TCP 接続の場合は、ターゲットの IP アドレスまたは名前を取得します。

• シリアル接続の場合は、ターゲットのシリアルポートおよびボーレートを設定します。 :stty -F /dev/ttyS2 115200 -brkint -icrnl -imaxbel -opost -onlcr -isig -icanon -iexten -echo -echoe -echok -echoctl -echoke

3. 必要に応じて、ターゲットへのリモートシステムエクスプローラ（RSE）接続

を設定します。

既に実行されている gdbserver に接続している場合は、以下のことを確認する必要が

あります。

1. gdbserver がインストールされており、ターゲット上で実行されていること。

ターゲット上で gdbserver およびアプリケーションを実行する場合、以下のコマ

ンドを使用します。

gdbserver port path/myApplication


• port は gdbserver とアプリケーション間の接続ポートです :5000.

• path/myApplication は、デバッグするアプリケーションです。

2. アプリケーションイメージがロードされており、ターゲット上で実行されていること。

3.3.2 手順

ターゲットに接続するには






ます。


す。

a. 必要なプラットフォームを選択します。



b. ［Linux Application Debug］プロジェクトタイプを選択します。

c. 必要なデバッグ操作を選択します。

d. デバッガと gdbserver の間の接続を設定します。



a. ［Target Configuration］パネルで、ターゲットにダウンロードするホスト上

のアプリケーションを選択し、選択したファイルをダウンロードするターゲット上の場所を指定します。

b. ［Files］パネルで、デバッガを使用してデバッグ情報をロードするホスト

上のファイルを選択します。必要に応じて、ターゲットにダウンロードす

るホスト上の他のファイルを指定することもできます。

注［Files］タブのオプションは、選択するデバッグ操作のタイプに依存します。


a. ［Run］コントロールパネルで、ターゲットに接続した後にデバッガで行

うアクションを指定します。


c. ［Paths］パネルで、デバッガがソースコードを表示するときに使用する、

ホスト上のソースまたはライブラリの検索ディレクトリを指定します。


時にアプリケーションに渡される引数を入力します。

9. 必要に応じて、［Environment］タブをクリックして、デバッグセッションの開

始時にアプリケーションに渡されるターゲット環境変数を作成して設定します。


11. ［Debug］をクリックしてターゲットに接続します。






3.3.3 関連項目

タスク







— RSE 接続を使用した ARM Linux ターゲットの操作（3-11 ページ） .



概念






• ［Debug Configurations］ - ［Environment］タブ（10-98 ページ） .• 『ARM® DS-5™ ： Eclipse の使用』：

— 第 5 章リモートシステムエクスプローラの使用 .



3.4 Linux カーネルへの接続の設定

デバッグハードウェアエージェントを使用して実行中のターゲットに接続できます。

注デフォルトでは、このタイプの接続の場合、すべてのプロセッサ例外はターゲット

上の Linux によって処理されます。ブレークポイントビューメニューの［Manage Signals］ダイアログボックスを使用して、デフォルトのハンドラ設定を変更できま

す。

3.4.1 前提条件

接続する前に、デバッガとデバッグハードウェアエージェントの間の接続のターゲット IP アドレスまたは名前があることを確認します。

3.4.2 手順







ます。


す。


b. ［Linux Kernel and/or Device Driver Debug］プロジェクトタイプを選択し

ます。


d. デバッガとデバッグハードウェアエージェントの間の接続を設定します。

6. ［Files］タブをクリックし、以下のコンパイルされたデバッグバージョンを選

択します。

a. ターゲットとまったく同じカーネルバージョンに対してコンパイルされたオペレーティングシステムのカーネルイメージ（vmlinux）

b. 必要に応じて、ターゲットとまったく同じカーネルバージョンに対してコンパイルされたモジュールイメージ

あるいは、接続後に、デバッグ制御ビューから［Load...］メニューオプション

を使用して、手動でデバッグ情報をデバッガにロードすることもできます。


a. 必要に応じて、［Run］コントロールパネルで、［Connect only］を選択し、

初期化スクリプトを設定します。



注オペレーティングシステム（OS）サポートは、 Linux カーネルイメージが

DS-5 デバッガ起動コンフィギュレーションからデバッガにロードされる

と、自動的に有効になりますただし、 set os コマンドを使用して手動でこ

れを制御することもできます。

例えば、カーネルがブートされ、 Memory Management Unit （MMU）が初

期化されるまで OS サポートのアクティブ化を遅延する場合、ターゲット

初期化スクリプトを使用して OS サポートを無効にする接続を定できま

す。カーネルをデバッグするには、 OS サポートをデバッガで有効にする

必要があります。


c. ［Paths］パネルで、デバッガがソースコードを表示するときに使用するホ

スト上のソースの検索ディレクトリを指定します。








3.4.3 関連項目

タスク







— ロード可能なカーネルモジュールのデバッグ（3-23 ページ） .

概念

• ターゲット接続の種類（3-3 ページ）

• Linux カーネルのデバッグについて（6-15 ページ）

• Linux カーネルモジュールのデバッグについて（6-17 ページ）

• ARM Linux の問題と解決法（11-2 ページ）

• ターゲット接続の問題と解決法（11-4 ページ） .

参照 • set os （2-162 ページ）

• ［Debug Configurations］ - ［Connection］タブ（10-80 ページ）




• ［Debug Configurations］ - ［Debugger］タブ（10-90 ページ） .



3.5 ベアメタルターゲットへの接続の設定

デバッグハードウェアエージェントを使用してターゲット上にダウンロードし、実行しているアプリケーションに接続できます。

3.5.1 前提条件

接続する前に、デバッガとデバッグハードウェアエージェントの間の接続のターゲット IP アドレスまたは名前があることを確認します。

3.5.2 手順







ます。


す。


b. ［Bare Metal Debug］プロジェクトタイプを選択します。






のアプリケーションを選択します。








時にセミホスティングを使用してアプリケーションに渡される引数を入力します。










3.5.3 関連項目

タスク






概念






• ［Debug Configurations］ - ［Environment］タブ（10-98 ページ） .



3.6 ベアメタルターゲットへのイベントビューアの接続の設定

イベントビューアを使用して、ベアメタルアプリケーションからテキスト形式のログ情報をキャプチャし、表示できます。ログは、注釈を使用してアプリケーションか

らキャプチャされるので、注釈をソースコードに追加する必要があります。

注［Debug Configurations］ダイアログボックスの［Event Viewer］タブは、インストル

メンテーショントレースマクロセル（ITM）のキャプチャがサポートされているター

ゲットのみに対して有効になります。

3.6.1 前提条件

接続前に以下のことをしておく必要があります。

• デバッガとデバッグハードウェアエージェント間の接続に使用する、ターゲット IP アドレスまたは名前を確認する

• ログポイントを使用して、アプリケーションソースコードに注釈を付け、再コンパイルする詳細については、DS-5 に付属の Versatile Express A9x4 用の ITM とイベントビューアの例を参照して下さい。

3.6.2 手順







ます。


す。

a. 必要なプラットフォームを選択します。たとえば、［ARM-Versatile Express A9x4］を選択します。

b. ［Bare Metal Debug］プロジェクトタイプを選択します。

c. 必要なデバッグ操作を選択します。たとえば、［Debug and Trace Cortex-A9x4 SMP via DSTREAM］を選択します。





のアプリケーションを選択します。










時にセミホスティングを使用してアプリケーションに渡される引数を入力します。

9. ［Event Viewer］タブをクリックして、 ITM キャプチャの設定を指定します。

a. ［Enable ITM capture］を選択します。

b. トレースバッファの大サイズを入力します。たとえば、 DSTREAM 接続

には 100MB を入力できます。バッファを大きくするとより多くのトレー

スデタを収集しますが、処理に時間がかかるためパフォーマンスに悪影響があることに注意してください。

c. トレースを受け取る ITM チャネルごとに設定を追加します。これは、 ITM がプログラムでどのように設定され使用されるかによって異なります。





接続時に DS-5 デバッグパースペクティブが開いている場合は、イベントビューアの

関連するチャネルエディタがすべて表示されます。


3.6.3 関連項目

タスク






概念


参照 • イベントビューアのチャネルエディタ（10-18 ページ）








• ［Debug Configurations］ - ［Event Viewer］タブ（10-101 ページ） .



3.7 コンフィギュレーションデータベースインポートユーティリティについて

インポートユーティリティ cdbimporter は、プラットフォーム情報を DS-5 にインポー

トする簡単な方法を提供することを目的にしています。このため、 RVI/DSTREAM 接続またはモデル接続を介したプラットフォームのデバッグとトレースについては限定されたサポートのみ行います。

ターゲットデータベースには DS-5 用のプラットフォーム情報が保持されています。インポートユーティリティは、以下からの情報を使用してターゲットデータベースに新しいプラットフォームエントリを作成します。

• デバッグハードウェアコンフィギュレーションユーティリティ、 dbghwconfig または rviconfig を使用して作成され保存されたコンフィギュレーションファイ

ル。

• CADI サーバで実行するモデル。このモデルは、すでに実行中のものでも、コマ

ンドラインオプションで起動パスとファイル名を指定したものでもいません。

ARM® は新しいディレクトリに新しいプラットフォームエントリを構築して、新し

いターゲットデータベースを生成することをお勧めします。この理は、 DS-5 ター

ゲットデータベースは、 DS-5 の更新時に読み出し専用の場所にインストールされ、

DS-5 ターゲットデータベースへのすべての変更が失われる可能性があるためです。［Preferences］ダイアログを使用して、 DS-5 で複数のターゲットデータベースを指定

できます。これによって、新しいデータベース内のプラットフォームが既存プロセッ

サ定義とレジスタ定義を使用するようにできます。

注 DS-5 には、 Eclipse 内から RVI/DSTREAM コンフィギュレーションファイルを作成す

る機能はまだありません。デバッグハードウェア設定ユーティリティ、現時点でこれを行う唯一の方法です。

インポートユーティリティは、以下のデバッグ操作を作成します。

• ハードウェアとモデル用のシングルプロセッサベアメタルおよび Linux カーネ

ルデバッグ。

• 複数個の同一プロセッサを持つターゲット用の、対称型マルチプロセス（SMP）ベアメタルおよび Linux カーネルデバッグ操作。

• ETB/TPIU デバイスを含むハードウェアターゲット用の、オンチップの Embedded Trace Buffer （ETB）のトレース設定、およびオフチップのトレース

ポートインタフェースユニット（TPIU）のトレース設定。クロストリガインタ

フェース（CTI）が存在する場合は、インポートユーティリティはトレースト

リガをキャリーするように設定します。

注 ETMv1.x はサポートされていません。

• Linux アプリケーションのハードウェアとモデル用のデバッグ設定。 ARM7TDMI® プロセッサまたは Cortex™-M シリーズプロセッサはサポートされ

ていません。

インポートユーティリティは以下を作成しません。

• 非命令トレースマクロセルを設定するデバッグ操作。



• big.LITTLE コンフィギュレーション。

SMP では、 CTI デバイスを使用する同期と使用しない同期用に、デバッグ操作が重

複して生成されます。 CTI を使用すると、サイクル数の順に非常に低いレイテンシと

の強力な同期を生成しますが、 CTI は完全に実装され、 ARM リファレンス設計に合

わせて接続される必要があります。それ以外の的に使用してはいけません。 CTI を使

用しない同期の場合はレイテンシが高くなりますが、実装や使用に関する前提はありません。

多重化ピン用のオフチップ TPIU トレースを手動で設定し、そして信号のタイミング

問題に対応するため較正を行う必要があります。

問題がある場合、またはその他の設定を生成する必要がある場合は、サポート担当者にお問い合わせください。

3.7.1 前提

インポートユーティリティは、デバッグ操作の作成時には、以下を前提にします。

• トレースマクロセルと CoreSight™ トレースファネルポート間に線形マッピング

が存在する。

• 組み込みトレースマクロセル（ETM） / プログラムトレースマクロセル（PTM）

のバージョンがプロセッサの種類ごとに固定されている。

• CTI デバイスはその他の操作には使用されません。

• 複数の CoreSight ETB、 TPIU またはトレースファネルを含むターゲットでは、

インポートユーティリティは、小値のベースアドレスを持つトレースファネル、 ETB、および TPIU のそれぞれの初の例についてコンフィギュレーショ

ンを生成します。

表 3-1 プロセッサの種類ごとの ETM/PTM バージョン

プロセッサの種類 ETM/PTM

Cortex-A15 PTM

Cortex-A7 ETMv3.5

Cortex-A8 ETMv3.3

Cortex-A9 PTM

Cortex-R4 ETMv3.3

Cortex-R5 ETMv3.3

Cortex-R7 ETMv3.3

Cortex-M3 ETMv3.4

Cortex-M4 ETMv3.4

ARM9 シリーズ ETMv1.x はサポートされていませ

ん。

ARM11 シリーズ ETMv3.1



3.7.2 制限

デバッグハードウェアコンフィギュレーションユーティリティで、またはモデルから、自動設定可能なプラットフォームのみインポートできます

DS-5 は特定のプロセッサのみサポートしています。サポートされているプロセッサ

の詳しいリストを参照するには、 --list-cores オプション（-l）を使用してインポー

トユーティリティを実行して下さい。

インポートユーティリティは適切なプロセッサと CP15 レジスタセットとの基本設定

を生成しますが、この設定は常に完全というわけではありません。たとえば、すべて

の Cortex-A9 プロセッサ上で TrustZone® レジスタが表示されることは必ずしも適切で

はなく、 NEON レジスタはインポートプラットフォームとして表示されません。

3.7.3 関連項目

タスク


（3-21 ページ）

• RVC ファイルからの DS-5 の新しいプラットフォームコンフィギュレーション

の作成（3-22 ページ） .

参照

• コンフィギュレーションデータベースインポートユーティリティの起動（3-20 ページ） .



3.8 コンフィギュレーションデータベースインポートユーティリティの起動

以下のコマンドライン構文を使用してインポートユーティリティを起動します。

cdbimporter -cdb config_db -target-cdb destination_db {file.rvc|-model model_exec}

各項目には以下の意味があります。

-c=path,--cdb=path

プロセッサ定義とレジスタ定義を含むメインデータベースへのパスを指定します。

-t=path,--target-cdb=path

デスティネーションデータベースが置かれている、生成されるプラットフォームを受け取るディレクトリ。

-m=path,--model=path

CADI サーバを提供するモデルからインポートします。

• モデルの実行可能ファイルへのパスを入力すると、ユーティリティはモデルを起動して調べます。

• モデルの実行可能ファイルへのパスを入力しない場合は、以下のいずれかを行います。

— path 値を省略する。この場合は、ユーティリティは実行モデ

ルを検索して調べます。

— モデルとの接続のデータを手動で入力する。たとえば、プロ

セッサ名、 ID およびプロセッサ定義を入力します。

RVC_file=path

デバッグハードウェアコンフィギュレーションユーティリティ、rviconfig で生成される設定ファイル（.rvc）からインポートします。

-l,--list-cores

--cdb オプションを付けて入力されたデータベースで定義されたプロ

セッサをすべてリストします。

-?,--help

主なコマンドラインオプションの一覧を表示します。

3.8.1 関連項目

タスク


（3-21 ページ）



概念

• コンフィギュレーションデータベースインポートユーティリティについて（3-17 ページ） .



3.9 モデルからの DS-5 の新しいプラットフォームコンフィギュレーションの作成

CADI サーバを提供するモデルからインポートするには、以下の操作を行います。


• Windows の場合、［スタート］ → ［すべてのプログラム］ → ［DS-5 Command Prompt］を選択します。


1. install_directory/bin ディレクトリを PATH 環境変数に追加します。既に設定されている場合は、この手順を省略します。


2. モデルが実行中であることを確認するか、または実行中でない場合はそのモデルの場所を特定します。

3. コマンドラインに必要なオプションを付けて、コンフィギュレーションデータベースインポートユーティリティ、 cdbimporter を起動します。

4. 正常に終了するまで、コマンドプロンプトに従います。


a. ［Window］メニューから［Preferences］を選択します。

b. ［DS-5］設定グループを展開します。

c. ［Target Database］を選択します。

d. ［追加…］をクリックして、新しいターゲットデータベースの場所を特定します。

e. ディレクトリ全体を選択します。

f. ［OK］をクリックしてダイアログボックスを閉じます。

g. コンフィギュレーションデータベースパネルの [ 設定 ] で、新しいター

ゲットデータベースを選択します。

h. リストの終わりの方まで続けてクリックしていき、新しいデータベースに移動します。

i. [ データベースの再ビルド…] をクリックします。

j. ［OK］をクリックしてダイアログボックスを閉じ、設定を保存します。

3.9.1 関連項目

タスク



概念


参照




3.10 RVC ファイルからの DS-5 の新しいプラットフォームコンフィギュレーションの作

成

デバッグハードウェアコンフィギュレーションユーティリティを使用して、ターゲットに接続し、コンフィギュレーションファイル（.rvc）に情報を保存できます。その結果のコンフィギュレーションファイルは、 DS-5 コンフィギュレーションデー

タベースへの移植に使用できるプラトフォームのデバッグとトレースサポートについては、機能が限定されます。

RVC ファイルからインポートするには、以下の操作を行います。


• Windows の場合、［スタート］ → ［すべてのプログラム］ → ［DS-5 Command Prompt］を選択します。


1. install_directory/bin ディレクトリを PATH 環境変数に追加します。既に設定されている場合は、この手順を省略します。


2. ターゲット接続用のコンフィギュレーションファイルを作成します。

3. コマンドラインに必要なオプションを付けて、コンフィギュレーションデータベースインポートユーティリティ、 cdbimporter を起動します。

4. 正常に終了するまで、コマンドプロンプトに従います。


a. ［Window］メニューから［Preferences］を選択します。

b. ［DS-5］設定グループを展開します。

c. ［Target Database］を選択します。

d. ［追加…］をクリックして、新しいターゲットデータベースの場所を特定します。

e. ディレクトリ全体を選択します。

f. ［OK］をクリックしてダイアログボックスを閉じます。

g. コンフィギュレーションデータベースパネルの [ 設定 ] で、新しいター

ゲットデータベースを選択します。

h. リストの終わりの方まで続けてクリックしていき、新しいデータベースに移動します。

i. [ データベースの再ビルド…] をクリックします。

j. ［OK］をクリックしてダイアログボックスを閉じ、設定を保存します。

3.10.1 関連項目

タスク


（3-21 ページ） .

概念




参照




3.11 既存の起動コンフィギュレーションのエクスポート

既存の起動コンフィギュレーションをエクスポートするには

1. ［File］メニューから［Export...］を選択します。

2. ［Export］ダイアログボックスで、［Run/Debug］グループを展開し、［Launch Configurations］を選択します。

図 3-1 ［Export launch configuration］ダイアログボックス

3. ［Next］をクリックします。

4. ［Export Launch Configurations］ダイアログボックスで以下の手順を行います。

a. ［DS-5 Debugger］グループを展開し、 1 つまたは複数の起動コンフィギュ

レーションを選択します。

b. ［Browse...］をクリックして、ローカルファイルシステム内の必要な場所

を選択します。

c. フォルダを選択して［OK］をクリックします。



図 3-2 起動コンフィギュレーションの選択パネル

5. 必要に応じて、［Overwrite existing file(s) without warning］を選択します。

6. ［Finish］をクリックします。

3.11.1 関連項目

タスク

• 既存の起動コンフィギュレーションのインポート（3-26 ページ） .

概念









3.12 既存の起動コンフィギュレーションのインポート

既存の起動コンフィギュレーションを Eclipse にエクスポートするには

1. ［File］メニューから［Import...］を選択します。

2. ［Import］ダイアログボックスで、［Run/Debug］グループを展開し、［Launch Configurations］を選択します。

図 3-3 ［Import launch configuration］ダイアログボックス

3. ［Next］をクリックします。

4. ［Browse...］をクリックして、ローカルファイルシステム内の必要な場所を選択

します。

5. 起動ファイルが存在するフォルダを選択し、［OK］をクリックします。

6. 必要なフォルダと起動ファイルのチェックボックスを選択します。



図 3-4 起動コンフィギュレーションファイルの選択パネル

7. 既存のコンフィギュレーションを同じ名前で置き換える場合は、［Overwrite existing launch configurations without warning］を選択します。

8. ［Finish］をクリックします。

3.12.1 関連項目

タスク

• 既存の起動コンフィギュレーションのエクスポート（3-24 ページ） .

概念









3.13 ターゲットからの切断

デバッグ制御ビューで、［Disconnect from Target］ツールバーアイコンをクリックし

ます。または、コマンドビューのコマンドフィールドに「quit」と入力し、［Submit］をクリックします。

3.13.1 関連項目

タスク







• DS-5 デバッガメニューとツールバーアイコン（10-104 ページ） .• 『ARM® DS-5™ ：デバッガコマンドリファレンス』：

— quit, exit （2-141 ページ） .


第 4 章実行制御

以下の各トピックでは、特定のイベントが発生したときと特定の条件が満たされたときにターゲットの実行を停止する方法について説明します。

タスク • イメージの実行（4-6 ページ）

• 実行ブレークポイントの設定（4-10 ページ）

• データウォッチポイントの設定（4-13 ページ）

• トレースポイントの設定（4-15 ページ）

• 条件ブレークポイントの設定（4-16 ページ）

• 特定のスレッドへのブレークポイントの設定（4-20 ページ）

• ブレークポイントとウォッチポイントの保留（4-22 ページ）

• ファイルへの DS-5 ブレークポイント設定のエクスポート（4-24 ページ）

• ファイルからの DS-5 ブレークポイント設定のインポート（4-26 ページ）

• アプリケーションのステップ実行（4-28 ページ）

• Unix シグナルの処理（4-30 ページ）

• プロセッサ例外処理（4-32 ページ）

• デバッガパスの代入規則の設定（4-34 ページ） .

概念

• ターゲットへのイメージのロードについて（4-2 ページ）

• デバッガへのデバッグ情報のロードについて（4-4 ページ）

• ブレークポイントとウォッチポイントについて（4-7 ページ） .


実行制御

4.1 ターゲットへのイメージのロードについて

アプリケーションイメージのデバッグを開始するには、まずファイルをターゲットにロードしておく必要があります。ターゲット上のファイルは、ローカルホストワー

クステーション上のファイルと同じでなければなりません。コードレイアウトは同じ

でなければなりませんが、ターゲット上のファイルにはデバッグ情報が必要です。

手動でファイルをターゲットにロードすることも、接続が確立された後でこれを自動的に行うよう、デバッガ接続を構成することもできます。一部のターゲット接続で

は、ロード操作がサポートされていないため、ロード操作に関連するメニューオプションはディセーブルされています。

ターゲットに接続した後は、［Debug Control］ビューのメニューエントリである

［Load...］を使用してファイルをロードすることもできます。イメージをロードする

ために使用できるオプションは以下のとおりです。

［Load Image Only］アプリケーションイメージをターゲットにロードします。

［Load Image and Debug Info］

アプリケーションイメージをターゲットにロードし、これと同じイメージからのデバッグ情報をデバッガにロードします。

［Load Offset］イメージ内のすべてのアドレスに追加する 10 進数または 16 進数

のオフセットを指定します。 16 進数のオフセットには、接頭辞 0x を付ける必要があります。

［Enable on-demand loading］

デバッガによるデバッグ情報のロード方法を指定します。このオ

プションを有効にすると、ロード時間が短縮され、メモリの使用量も小さくなりますが、デバッグの速度が低下することがあります。

図 4-1 ［Load File］ダイアログボックス

4.1.1 関連項目

タスク




• ターゲットからの切断（3-28 ページ）


実行制御

• イメージの実行（4-6 ページ） .

概念

• デバッガへのデバッグ情報のロードについて（4-4 ページ） .



• ［Debug Configurations］ - ［Connection］タブ（10-80 ページ） .• 『ARM® DS-5™ ：デバッガコマンドリファレンス』：

— load （2-119 ページ）

— loadfile （2-120 ページ） .


実行制御

4.2 デバッガへのデバッグ情報のロードについて

実行可能イメージには、アプリケーションコードとデータに加え、関数名や変数名などのシンボリック参照も含まれています。通常、これらのシンボリック参照はデ

バッグ情報と呼ばれます。デバッグ情報がないと、デバッガはソースレベルでデバッ

グすることができません。

ソースレベルでアプリケーションをデバッグするには、デバッグ情報を使用し、適度なレベルの適化を行って、イメージファイルと共有オブジクトファイルをコンパイルする必要があります。例えば、 ARM® コンパイラまたは GNU コンパイラのい

ずれかを使用してコンパイルする場合は、以下の各オプションを使用できます。

-g -O0

デバッグ情報のロードとファイルのロードは別の操作となるため、ファイルのロード時にデバッグ情報はロードされません。典型的なロードの順序は以下のとおりで

す。

1. メインのアプリケーションイメージをロードします。

2. 共有オブジェクトがある場合は、それをロードします。

3. メインのアプリケーションイメージのシンボルをロードします。

4. 共有オブジェクトのシンボルをオンデマンドでロードします。

イメージと共有オブジェクトはターゲットにあらかじめロードされている場合があります。ROM デバイスや OS 認識ターゲットのイメージはその例す。対応するイメー

ジファイルと共有オブジェクトファイル（ある場合）には、デバッグ情報を含め、ローカルホストワークステーションからクセスできることが必要です。これにより、

これらのイメージファイルと共有オブジェクトファイルからのデバッグ情報のみをロードするようターゲット接続を構成できるようになります。ターゲット環境に必要

な場合は、デバッグコンフィギュレーションファイルの［Files］タブにある［Load symbols from file］オプションを使用します。

ターゲットに接続した後は、［Debug Control］ビューのメニューエントリである

［Load...］を使用してファイルをロードすることもできます。デバッグ情報をロード

するために使用できるオプションは以下のとおりです。

［Add Symbols File］デバッガに追加のデバッグ情報をロードします。

［Load Debug Info］デバッガにデバッグ情報をロードします。

［Load Image and Debug Info］

アプリケーションイメージをターゲットにロードし、これと同じイメージからのデバッグ情報をデバッガにロードします。

［Load Offset］イメージ内のすべてのアドレスに追加する 10 進数または 16 進数

のオフセットを指定します。 16 進数のオフセットには、接頭辞 0x を付ける必要があります。

［Enable on-demand loading］

デバッガによるデバッグ情報のロード方法を指定します。このオ

プションを有効にすると、ロード時間が短縮され、メモリの使用量も小さくなりますが、デバッグの速度が低下することがあります。


実行制御

図 4-2 ［Load additional debug information］ダイアログボックス

イメージまたは共有オブジェクト内のデバッグ情報には、デバッグ情報を構築するために使用されたソースのパスも含まれています。イメージまたは共有オブジェクト

内のアドレスで実行が停止すると、デバッガは対応するソースファイルを開こうとします。このパスが存在しないか、必要なソースファイルが見つからない場合は、

ソースファイルの場所をデバッガで指定する必要があります。これを行うには、代入

規則を設定して、イメージから取得したパスを、ローカルホストワークステーションからアクセスできる、必要なソースファイルのパスと関連付けられるようにします。

4.2.1 関連項目

タスク





• イメージの実行（4-6 ページ）

• デバッガパスの代入規則の設定（4-34 ページ） .

概念

• ターゲットへのイメージのロードについて（4-2 ページ） .





— add-symbol-file （2-32 ページ）

— discard-symbol-file （2-65 ページ）

— file, symbol-file （2-75 ページ）

— set substitute-path （2-172 ページ） .


実行制御

4.3 イメージの実行

アプリケーションイメージのターゲット上での実行状況を監視するには、アプリケーションイメージを実行している必要があります。

イメージを実行するには、まずイメージをターゲットにロードしておかなければなりません。イメージはターゲットにあらかじめロードするか、デバッグセッションの

一部としてターゲットにロードできます。

注ターゲット上に保存されているファイルには、デバッグ情報を含める必要がありま

せん。ただし、これらのファイルをデバッグするには、ローカホストワークステーション上の対応するファイルにデバッグ情報が含まれていることが必要です。

接続を設定し、接続の確立後にデバッガに行わせる実行制御を定義するには、［Debug Configurations］ダイアログボックスを使用してください。これ行うには、

［Run］メニューから［Debug Configurations...］を選択します。

接続が確立されたら、［Debug Control］ビューのツールバーアイコンを使用して、デ

バッグセッションを制御できます。

4.3.1 関連項目

タスク

• 第 5 章ターゲットの検査 .







— continue （2-54 ページ）

— run （2-147 ページ）

— start （2-204 ページ） .


実行制御

4.4 ブレークポイントとウォッチポイントについて

ブレークポイントとウォッチポイントを使用すると、特定のイベントが発生したときと特定の条件が満たされたときにターゲットを停止できます実行が停止したら、

メモリ、レジスタ、または変数の内容を検証するか、実行を再開する前に行うよう指定しておいた他の操作を行うことができます。

デバッガには以下のタイプが用意されています。

ブレークポイントブレークポイントを使用すると、実行が特定のアドレスに達した

ときにアプリケーションを中断できます。ブレークポイントは、

常に特定のメモリアドレスと関連しています。そのメモリアドレスに何が格納されているかは問いません。実行がブレークポイン

トに達すると、通常の実行は、そのブレークポイントに格納されている命令が実行される前に停止します。

以下を設定できます。

• 指定したアドレスで特定の命令が実行されたときにトリガされるソフトウェアブレークポイント

• 特定のメモリアドレスからフェッチされる命令をプロセッサが実行しようとしたときにトリガされるハードウェアブレークポイント

• 式の評価結果が true の場合、または無視する回数に達したと

きにトリガされる条件ブレークポイント

• ヒットされた後で削除される一時的なソフトウェアブレークポイントまたはハードウェアブレークポイント

設定できるブレークポイントのタイプは、以下の要因によって決まります。

• メモリ領域とそれに関連したアクセス属性

• ターゲットプロセッサによって提供されるハードウェアサポート

• ターゲット接続の管理に使用されるデバッグインタフェース

• 実行状態（OS 認識アプリケーションをデバッグしている場

合）

ウォッチポイントウォッチポイントはブレークポイントと似ていますが、特定のア

ドレスから実行されている命令ではなく、監視するデータアクセスのアドレスまは値であるという点が異なります。どの場所に格

納されている内容をテストするかは、レジスタまたはメモリアドレスで指定します。ウォッチポイントは、データ依存であること

を示す、データブレークポイントという名前で呼ばれることもあります。監視対象のアドレスがアプリケーションによってアクセ

スされると、アプリケーションの実行は停止します。

以下を設定できます。

• 特定のメモリ位置を特定の方法でアクセスしたときにトリガされるウォッチポイント

• 式の評価結果が true の場合、または無視する回数に達したと

きにトリガされる条件付きウォッチポイント


実行制御

4.4.1 ブレークポイントとウォッチポイントを設定する際の注意事項

ブレークポイントとウォッチポイントを設定するときは、以下の点に注意してください。

• 使用可能なハードウェアブレークポイントの数はターゲットによって異なります。

• 高レベルの適化を行ってイメージをコンパイルしている場合、または C++ テンプレートがイメージに含まれている場合、ソースコード内にブレークポイントを設定することによる効果は、ブレークポイントをどこに設定するかによって決まります。例えば、インライン関数または C++ テンプレートにブレークポ

イントを設定すると、その関数またはテンプレートのインスタンスごとにブレークポイントが 1 つ作成されます。そのため、ターゲットのブレークポイン

トリソースが不足する可能性があります。

• メモリ管理ユニット（MMU）をイネーブルすると、メモリ領域が読み出し専

用に設定される場合があります。そのメモリ領域にソフトウェアブレークポイ

ントが含まれている場合、このソフトウェアブレークポイントを削除することはできません。そのため、 MMU をイネーブルする前に、ソフトウェアブレーク

ポイントをクリアしておくことが重要です。

• ウォッチポイントは、常に有効範囲にあるため、グローバル / 静的データシン

ボルでしかサポートされていません。関数からステップアウトするときはロー

カル変数を使用できません。

• ターゲットによっては、ウォッチポイントがサポートされていないこともあります。現在、ウォッチポイントコマンドは、デバッグハードウェアエージェン

トを使用するハードウェアターゲットでのみ使用できます。

• ウォッチポイントをトリガする命令のアドレスが、 PC のレジスタに表示される

アドレスと異なる可能性があります。これはプロセッサのパイプライン効果が

原因です。

• 共有オブジェクトを使用するアプリケーションをデバッグする場合、共有オブジェクト内に設定されているブレークポイントは、その共有オブジクトがアンロードされると再評価されます。これらのブレークポイントとウォッチポイン

トのうち、解決可能なアドレスを持つものは設定されそれ以外は保留中のままとなります。

• ブレークポイントが関数名によって設定されている場合は、既にオンデマンドロードされているインラインインスタンスのみが見つかります。関数のすべて

のインラインインスタンスを見つけるには、オンデマンドロードをディセーブルする必要があります。

4.4.2 関連項目

タスク • 実行ブレークポイントの設定（4-10 ページ）






• ファイルからの DS-5 ブレークポイント設定のインポート（4-26 ページ） .


実行制御

概念


参照


— advance （2-34 ページ）

— awatch （2-36 ページ）

— break （2-39 ページ）

— break-stop-on-threads、 break-stop-on-cores （2-44 ページ）

— break-stop-on-vmid （2-46 ページ）

— clear （2-49 ページ）

— condition （2-52 ページ）

— delete breakpoints （2-57 ページ）

— disable breakpoints （2-61 ページ）

— enable breakpoints （2-70 ページ）

— hbreak （2-80 ページ）

— ignore （2-84 ページ）

— info breakpoints, info watchpoints （2-87 ページ）

— resolve （2-145 ページ）

— rwatch （2-148 ページ）

— set breakpoint （2-156 ページ）

— tbreak （2-211 ページ）

— thbreak （2-213 ページ）

— watch （2-222 ページ） .


実行制御

4.5 実行ブレークポイントの設定

デバッガを使用すると、ターゲットメモリのタイプに応じて、ソフトウェアブレークポイントまたはハードウェアブレークポイントを設定できます。ソフトウェアブ

レークポイントは、デバッガによって実装され、ブレークポイントアドレスにある命令を特殊な命令オペコードで置き換えます。デバッガにはアプリケーションメモリ

への書き込みアクセス権が必要なため、ソフトウェアブレークポイントは RAM でし

か設定できません。ハードウェアブレークポイントは、プロセッサのアドレスバス

とデータバスを監視する、 EmbeddedICE® ロジックによって実装されます。シミュ

レートされたターゲットの場合、ハードウェアブレークポイントはシミュレータソフトウェアによって実装されます。

実行ブレークポイントを設定するには、 C/C++ エディタの左側のマーカバーをダブ

ルクリックするか、逆アセンブリビュー内のブレークポイントを定する位置でダブルクリックします。ブレークポイントを削除するには、ブレークポイントマーカをダ

ブルクリックします。

以下の図に、 C/C++ エディタおよび逆アセンブリビューにおけるブレークポイント

の例を示します。これらのブレークポイントは、［Breakpoints］ビューにも表示され

ます。


実行制御

図 4-3 実行ブレークポイントの設定

4.5.1 関連項目

タスク • 条件ブレークポイントの設定（4-16 ページ）





概念 • ブレークポイントとウォッチポイントについて（4-7 ページ） .

参照

• ARM アセンブラエディタ（10-6 ページ）



実行制御

• C/C++ エディタ（10-14 ページ）


• ［Debug Control］ビュー（10-23 ページ）




• ［Variables］ビュー（10-61 ページ） .

















— thbreak （2-213 ページ） .


実行制御

4.6 データウォッチポイントの設定

アプリケーションを実行するときに、ソースコード内の特定の変数または式の値を監視する必要が生じる場合があります。これを行うには、ウォッチポイントを設定し

ます。

［Variables］ビューでデータシンボルを右クリックし、［Toggle Watchpoint］を選択し

て必要なアクセスタイプを選択し、［OK］をクリックします。ウォッチポイントが

［Variables］ビューと［Breakpoint］ビューに表示されます。

図 4-4 データウォッチポイントの設定

注ウォッチポイントは、スカラ値でのみサポートされます

ターゲットによっては、ウォッチポイントがサポートされていないこともあります。現在、ウォッチポイントは、デバッグハードウェアエージェントを使用するハードウェアターゲットにのみ設定できます。

ウォッチポイントをトリガする命令のアドレスが、 PC のレジスタに表示されるアド

レスの命令と対応していない可能性があります。これはパイプライン効果が原因で

す。

4.6.1 関連項目

タスク • ブレークポイントとウォッチポイントの保留（4-22 ページ）





参照



• C/C++ エディタ（10-14 ページ）




• ［Expressions］ビュー（10-32 ページ）



実行制御





— clearwatch （2-51 ページ）









— watch （2-222 ページ） .


実行制御

4.7 トレースポイントの設定

トレースポイントは、アプリケーションの実行中にトレースキャプチャデバイスの動作をトリガするときに使用されるメモリ位置です。トレースポイントは、指定した

アドレスでプロセッサが命令を実行したときに達するポイントです。タイプに基づい

て、トレースキャプチャが有効または無効にされます。

トレースポイントは以下のいずれかのビューから設定できます。

• ARM アセンブラエディタ

• C/C++ エディタ

• ［Disassembly］ビュー

• 関数ビュー

• ［Memory］ビュー

• トレースビューの逆アセンブリパネル

トレースポイントを設定するには、トレースポイントを設定する位置で左側のマーカバーを右クリックし、コンテキストメニューから［トレースの起点の切り替え］、［トレースの終点の切り替え］、または［トレースのトリガポイントの切り替え］のいずれかを選択します。トレースポイントを削除するには、同じトレースポイントで

この手順を繰り返すか、［ブレークポイント］ビューからトレースポイントを削除します。

トレースポイントは、接続するたびに格納されます。アクティブな接続が切断された

場合、トレースポイントはソースエディタからのみ作成できます。

すべてのトレースポイントは、［ブレークポイント］ビューに表示されます。

4.7.1 関連項目

タスク • ブレークポイントとウォッチポイントの保留（4-22 ページ） .



参照



• C/C++ エディタ（10-14 ページ）



• 関数ビュー（10-35 ページ）

• ［Trace］ビュー（10-57 ページ）


• ［トレースポイントのプロパティ］ダイアログボックス（10-76 ページ） .


実行制御

4.8 条件ブレークポイントの設定

条件ブレークポイントには、そのブレークポイントをトリガするために満たす必要のある条件をテストするプロパティが割り当てられています。例えば、以下がありま

す。

• 指定された値の変数をテストする

• 関数を設定された回数実行する

• 特定のスレッドまたはプロセッサでのみブレークポイントをトリガする

条件ブレークポイントは、ヒットする頻度が高いと非常に侵入的となり、パフォーマンス低下の原因になる可能性があります。これは、ブレークポイントがトリガされ

るたびにデバッガがターゲットを停止するためです。指定された条件がチェックさ

れ、評価結果として true が返された場合は、ターゲットが停止状態のままになり、

それ以外の場合は実行が再開されます。

注サブブレークポイントを持つブレークポイントには、スクリプトを割り当てないで

ください。スクリプトを割り当てると、デバッガがそれぞれのサブブレークポイント

でスクリプトの実行を試みます。この場合、エラーメッセージが表示されます。

［ブレークポイントのプロパティ］ダイアログボックスで既存のブレークポイントに条件を割り当てるには、以下の手順に従います。

1. ブレークポイントビューで、変更するブレークポイントを右クリックしてコンテキストメニューを表示します。

2. ［Properties...］を選択して［Breakpoint Properties］ダイアログボックスを表示し

ます。

3. 特定のブレークポイントに関する条件式を設定するには、［Stop Condition］フィールドに C 形式の式を入力します。例えば、アプリケーションに変数 x がある場合は、以下のように指定できます。

x == 10

4. 特定のパスカウントに達するまでブレークポイントのヒットを遅らせるようデバッガに指定するには、［Ignore Count］フィールドにパスカウントを入力しま

す。例えば、ループの繰り返し回数が 100 回の場合に、パスカウントが 50 に達

した後でそのループのブレークポイントをヒットするようにするには、 50 と入

力します。

5. 選択したブレークポイントがトリガされたときにスクリプトを実行するには、［On break, run script］フィールドで以下のいずれかの方法でスクリプトファイ

ルを指定します。

• 表示されるフィールドに場所およびファイル名を入力します。

• ［File System...］をクリックして、ワークスペースの外部にあるディレク

トリのファイルを選択します。

• ［Workspace...］をクリックして、ワークスペース内のプロジェクトディレ

クトリまたはサブディレクトリのファイルを選択します。


実行制御

注ブレークポイントが関連付けられているスクリプトファイルのコマンドには注

意が必要です。例えば、スクリプトファイルに quit コマンドが含まれている場

合は、ブレークポイントがヒットされるとデバッガがターゲットから切断されます。

6. ブレークポイントアクションがすべて完了したときにアプリケーションの実行を自動的に継続する機能をデバッガでイネーブルするには、［Continue Execution］チェックボックスを選択します。

または、ブレークポイントに関連付けられているスクリプトファイルの後のコマンドとして、 continue コマンドを入力することもできます。

7. ブレークポイントを 1 つ以上のスレッドまたはプロセッサで設定する場合は、

以下の手順を実行します。

a. 選択パネルを有効にするには、［選択したスレッドまたはコアでブレーク］を選択します。

b. ブレークポイントを割り当てる各スレッドまたはプロセッサのチェックボックスを選択します。

8. ［OK］をクリックして変更を保存します。

図 4-5 条件ブレークポイントの設定


実行制御

複数のステートメントを使用してソースコードの単一行に設定されたブレークポイントは、サブブレークポイントとして親ブレークポイントに割当てられます。各サブ

ブレークポイントのイネーブル、ディセーブル、および表示は、単一のステートメントから成るブレークポイントと同じ方法で行うことができます。条件は上位のブ

レークポイントにのみ割り当てられるため、親ブレークポイントとサブブレークポイントの両方に影響します。

4.8.1 複数の条件を単一のブレークポイントに設定する際の注意事項

複数の条件を単一のブレークポイントに設定するときは、以下の点に注意してください。

• 停止条件と無視する回数を設定した場合、停止条件が満たされない限り、無視する回数はデクリメントされません。例えば、変数 c によって制御され、繰り

返し回数が 10 回に設定されているループにブレークポイントがあるとします。

停止条件 c==5 を設定し、無視する回数を 3 に設定した場合、 4 回目に c==5 でヒットするまで、このブレークポイントはアクティブにならない可能性があります。その後は、 c==5 でヒットするたびにアクティブになります。

• 選択したスレッドまたはプロセッサでブレークするよう指定した場合、停止条件と無視する回数は選択したスレッドまたはプロセッサに対してのチェックされます。

• 条件は、以下の順序で評価されます。

1. スレッドまたはプロセッサ

2. condition3. ignore count

4.8.2 関連項目







参照



• C/C++ エディタ（10-14 ページ）

• ［Breakpoint properties］ダイアログボックス（10-70 ページ）







実行制御

















— silence （2-202 ページ）


— thbreak （2-213 ページ） .


実行制御

4.9 特定のスレッドへのブレークポイントの設定

ブレークポイントはデフォルトですべてのスレッドに適用されますが、ブレークポイントのプロパティを編集して、ブレークポイントが特定のスッドにしか適用されないようにすることができます。

1. ブレークポイントビューで、変更するブレークポイントを右クリックしてコンテキストメニューを表示します。

2. ［Properties...］を選択して［Breakpoint Properties］ダイアログボックスを表示し

ます。

3. 必要に応じてブレークポイント条件を割り当てます。

4. ［Break on Selected Threads］チェックボックスを選択してスレッドの選択をイ

ネーブルします。

5. ブレークポイントを割り当てる各スレッドのチェックボックスを選択します。

6. ［OK］をクリックして変更を保存します。

注特定のスレッドに設定されたブレークポイントの条件は、そのスレッドに対しての

みチェックされます。

図 4-6 特定のスレッドへのブレークポイントの設定


実行制御

4.9.1 関連項目






参照



• C/C++ エディタ（10-14 ページ）











— info threads （2-112 ページ）

— thread, core （2-215 ページ） .


実行制御

4.10 ブレークポイントとウォッチポイントの保留

ブレークポイントとウォッチポイントは、デバッグ情報が使用可能な場合に設定できます。ただし、保留中のブレークポイントとウォッチポイントを使用すると、関連

するデバッグ情報が使用可能になる前に、ブレークポイントとウォッチポイントを設定することが可能になります。

デバッガは、デバッグ情報が変更されると、保留中のブレークポイントとウォッチポイントをすべて自動的に再評価します。これらのブレークポイントとウォッチポイ

ントのうち、解決可能なアドレスを持つものは設定され、それ以外は保留中のままとなります。

ブレークポイントビューでは、保留中のブレークポイントまたはウォッチポイントの解決を強制的に実行できます。この機能は、共有ライブラリの検索パスを手動で変

更した場合などに便利です。そのためには、以下の手順を実行します。

1. 解決する保留中のブレークポイントまたはウォッチポイントを右クリックします。

2. ［Resolve］をクリックします。これにより、アドレスの検索とブレークポイン

トまたはウォッチポイントの設定が試みられます。

保留可能なブレークポイントまたはウォッチポイントを手動で設定するには、advance、 awatch、 break、 hbreak、 rwatch、 tbreak、 thbreak、 watch のいずれかのコマンド

で -p オプションを使用します。デバッガコマンドは［Commands］ビューで入力でき

ます。

以下に例を示します。

break -p lib.c:20 # 保留中のブレークポイントを lib.c の行 20 で設定

awatch -p *0x80D4 # 保留中の読み出し /書き込みウォッチポイントをアドレス 0x80D4 に設定

4.10.1 関連項目








参照



• C/C++ エディタ（10-14 ページ）





実行制御























— watch （2-222 ページ） .


実行制御

4.11 ファイルへの DS-5 ブレークポイント設定のエクスポート

DS-5 ブレークポイント設定をファイルにエクスポートするには

1. DS-5 デバッグパースペクティブで作業していることを確認します。

2. ［Breakpoints］ビューのメニューから［Export Breakpoints］を選択します。

3. ローカルファイルシステム内の必要な場所を選択して、ファイル名を入力します。

4. ［Save］をクリックします。

注 DS-5 ブレークポイントビューに表示されているブレークポイントとウォッチポイン

トがすべて保存されます。

4.11.1 関連項目








参照



















実行制御










— watch （2-222 ページ） .


実行制御

4.12 ファイルからの DS-5 ブレークポイント設定のインポート

DS-5 ブレークポイント設定をファイルからインポートするには


2. ［Breakpoints］ビューのメニューから［Import Breakpoints］を選択します。

3. ブレークポイント設定が含まれているファイルをローカルファイルシステムから選択します。

4. ［Open］をクリックします。

注現在の接続に関する既存の設定が削除され、選択したファイルに含まれている DS-5 ブレークポイント設定とウォッチポイント設定で置き換えられます。

4.12.1 関連項目






• ファイルへの DS-5 ブレークポイント設定のエクスポート（4-24 ページ） .


参照



















実行制御










— watch （2-222 ページ） .


実行制御

4.13 アプリケーションのステップ実行

デバッガでは、ソースレベルまたは命令レベルでアプリケーションを順番にステップ実行することにより、イメージの実行を細かく制御することができます。

注ソースレベルのステップ実行のためのコマンドを使用するには、デバッグ情報を使

用してコードをコンパイルする必要があります。デフォルトで、デバッグ情報を持た

ない関数に対するソースレベルの呼び出しはステップオーバーされます。このデフォ

ルト設定を変更するには、 set step-mode コマンドを使用します。

アプリケーションをステップ実行する方法はいくつかあります。選択できるステップ

実行は以下のとおりです。

• すべての関数呼び出しをステップ実行またはステップオーバーする

• ソースレベルまたは命令レベルでステップ実行する

• ソースコードの単一行に含まれている複数のステートメントをステップ実行する（for ループの場合など）

ソースレベルでステップ実行する場合は、デバッガが一時的なブレークポイントを使用して特定の場所で実行を停止することに注意する必要があります。これらの一時

的なブレークポイントには、ハードウェアブレークポイントを使用することが必要となる場合があります。このことは、 ROM またはフラッシュに格納されたコードを

ステップ実行する場合は特に当てはまります。使用可能なハードウェアブレークポイ

ントリソースが不足している場合は、デバッガによってエラーメッセージが表示されます。

［Debug Control］ビューのステップ実行ツールバーを使用すると、ソース行単位また

は命令単位でアプリケーションをステップ実行できます。

図 4-7 ［Debug Control］ビュー

指定した回数ステップ実行するには、コマンドビューを使用して、回数を表す数値を指定して、ステップ実行コマンドのいずれかを手動で実行する必要があります。以下に例を示します。

steps 5 # 5 つのソースステートメントを実行

stepi 5 # 5 つの命令を実行


実行制御

4.13.1 関連項目

タスク • ターゲット実行環境の検査（5-2 ページ）

• コールスタックの検査（5-5 ページ）

• マルチスレッドアプリケーションのデバッグについて（6-10 ページ）

• 共有ライブラリのデバッグについて（6-12 ページ）


• プロセッサ例外処理（4-32 ページ） .

概念


参照









— next （2-132 ページ）

— nexti （2-133 ページ）

— nexts （2-134 ページ）

— finish （2-77 ページ）

— set step-mode （2-170 ページ）

— show step-mode （2-196 ページ）

— step （2-206 ページ）

— stepi （2-207 ページ）

— steps （2-208 ページ） .


実行制御

4.14 Unix シグナルの処理

ARM プロセッサには、 Unix 信号をトラップするための Linux アプリケーション向け

機能が用意されています。これらは、［Breakpoints］ビューのメニューから［Manage Signals］を選択するか、 handle コマンドを使用して、デバッガで管理できます。また、 info signals コマンドを使用して、ハンドラの現在の設定を表示することもでき

ます。

デフォルトのハンドラ設定は、デバッグアクティビティのタイプによって異なります。デフォルトでは、例えば Linux カーネルの接続の場合、すてのシグナルがター

ゲット上の Linux によって処理されます。

図 4-8 シグナルハンドラ設定の管理

注 Unix シグナルである SIGINT と SIGTRAP は、それぞれプロセスとブレークポイントを非

同期停止するためにデバッガによって内部で使用されるため、他のシグナルと同じ方法でデバッグできません。

4.14.1 例

シグナルを無視するが、シグナルがトリガされたときにイベントをログするようアプリケーションで指定するには、シグナルに基づく停止をイネブルする必要があります。以下の例では、 SIGHUP 信号が発生すると、デバッガが停止し、メッセージが出

力されます。この設定を使用すると、シグナルハンドラは呼び出されず、デバッグ対

象アプリケーションはシグナルを無視して、実行を継続します。

例 4-1 SIGHUP シグナルの無視

handle SIGHUP stop print # SIGHUP シグナルに基づく停止と出力をイネーブル


実行制御

以下の例は、シグナルハンドラのデバッグ方法を示しています。これを行うには、シ

グナルに基づく停止をディセーブルして、シグナルハンドラでブレークポイントを設定する必要があります。これが必要となるのは、シグナルに基づく停止がディセー

ブルされている場合、そのシグナルの処理は、登録されたハンドラにシグナルを渡すプロセスによって実行されるためです。ハンドラが登録されていない場合は、デ

フォルトのハンドラが実行され、通常、アプリケーションは終了します。

例 4-2 SIGHUP シグナルのデバッグ

handle SIGHUP nostop noprint # SIGHUP シグナルに基づく停止と出力をディセーブル

4.14.2 関連項目

タスク


• ターゲット実行環境の検査（5-2 ページ）





概念


参照



• ［Manage Signals］ダイアログボックス（10-77 ページ） .


— handle （2-79 ページ）

— info signals, info handle （2-107 ページ） .


実行制御

4.15 プロセッサ例外処理

ARM プロセッサには、プロセッサ例外をトラップするためのベアメタル向け機能が

用意されています。この機能がイネーブルされているときの効は、選択したベクタ

テーブルエントリにブレークポイントを設定した場合と同様になります。ただし、ベクタキャッチはプロセッサの専用ハードウェアを使用し、貴重なブレークポイントリソースを使い切ることはありません。これをベクタキャッチと呼びます。ベクタ

キャッチは、［Breakpoints］表示メニューから［Manage Signals］を選択するか、

handle コマンドを使用して、デバッガで管理できます。また、 info signals コマンドを

使用して、ハンドラの現在の設定を表示することもできます。

使用可能なベクタキャッチイベントは、接続しているプロセッサによって異なります。

図 4-9 例外ハンドラ設定の管理

4.15.1 例

例外が発生したときに例外をキャッチして、イベントを記録し、アプリケーションを停止するようデバッガで指定するには、例外に基づく停止をネーブルする必要があります。以下の例では、 NON-SECURE_FIQ 例外が発生すると、デバッガが停止し

てメッセージが出力されます。その後で、ハンドラがある場合は、それをステップ実

行または実行できます。

例 4-3 例外ハンドラのデバッグ

handle NON-SECURE_FIQ stop # NON-SECURE_FIQ 例外時の停止と出力を有効にする

例外が発生したときに停止を伴わずにハンドラを呼び出すには、例外に基づく停止をディセーブルする必要があります。

例 4-4 例外の無視

handle NON-SECURE_FIQ nostop # NON-SECURE_FIQ 例外時の停止を無効にする


実行制御

4.15.2 関連項目

タスク




• マルチスレッドアプリケーションのデバッグについて（6-10 ページ） .


• Unix シグナルの処理（4-30 ページ） .

概念


参照



• ［Manage Signals］ダイアログボックス（10-77 ページ） .


— handle （2-79 ページ）

— info signals, info handle （2-107 ページ） .


実行制御

4.16 デバッガパスの代入規則の設定

以下の理由でデバッグ情報がロードされていると、デバッガはソースファイルを見つけられない場合があります。

• デバッグ情報で指定されたパスがワークステーションに存在しないか、必要なソースファイルを含んでいない。

• ソースファイルのワークステーション上の場所が、デバッグ情報を含んでいるイメージと同じでない。デバッガはデフォルトで、このイメージと同じパスを

使用しようとします。

そのため、ソースコードを検索して表示するコマンドがデバッガによって実行される場合は、デバッガによって使用される検索パスを編集する必要があります。

検索パスを編集するには

1. ［Path Substitution］ダイアログボックスを開きます。

• ソースファイルが見つからない場合は、警告が C/C++ エディタに表示さ

れます。［Set Path Substitution］をクリックします。

• ［Debug Control］ビューで、ビューメニューから［Path Substitution］を選

択します。

図 4-10 ［Path Substitution］ダイアログボックス

2. 代入規則を追加、編集、または複製するには、［Path Substitution］ダイアログ

ボックスのツールバーアイコンをクリックします。

a. ［Image Path］にソースファイルの元のパスを入力するか、［Select...］をク

リックしてコンパイルパスを選択します。

b. ［Host Path］フィールドにソースファイルの現在の場所を入力するか、以

下のいずれかをクリックします。

• ［File System...］（外部フォルダに含まれているソースファイルを検索

する場合）

• ［Workspace...］（ワークスペースプロジェクトに含まれているソース

ファイルを検索する場合）

c. ［OK］をクリックします。


実行制御

図 4-11 ［Edit Substitute Path］ダイアログボックス

3. 必要な場合は、［Path Substitution］ダイアログボックスのツールバーアイコンを

使用して、代替規則の順序を変更したり、不要になった規則を削除たりすることもできます。

4. ［OK］をクリックします。これによって、代替規則がデバッガに渡され、ダイ

アログボックスが閉じます。

4.16.1 関連項目

タスク

• デバッガへのデバッグ情報のロードについて（4-4 ページ）



参照

• C/C++ エディタ（10-14 ページ）



— set substitute-path （2-172 ページ） .


第 5 章ターゲットの検査

以下の各トピックでは、レジスタ、変数、メモリ、およびコールスタックを検査する方法について説明します。

タスク • ターゲット実行環境の検査（5-2 ページ）

• コールスタックの検査（5-5 ページ） .

概念 • トレースサポートについて（5-7 ページ） .


ターゲットの検査

5.1 ターゲット実行環境の検査

デバッグセッション時に、レジスタまたは変数の値、シンボルのアドレス、変数のデータ型、メモリの内容の表示が必要になる場合があります。

DS-5 デバッグパースペクティブには、現在の値を示す基本的なデバッガビューが用

意されています。すべてのビューはアクティブな接続に関連付られており、アプリ

ケーションをステップ実行すると更新されます。ビューをパースペクティブ内のさま

ざまな位置に移動するには、タブをクックし、別の位置にドラッグします。また、タ

ブをダブルクリックして、ビューを大化またはリセットすることで、ビューの内容をより詳細分析することができます。

図 5-1 ターゲット実行の検査

デバッガコマンドを使用して、必要な情報を表示することもできます。コマンド

ビューで、個々のコマンドを実行したり、スクリプトファイルを使用して一連のコマンドを実行したりすることができます。



5.1.1 関連項目










概念 • ベアメタル対称型マルチプロセスシステムのデバッグについて（6-7 ページ）




• Linux カーネルモジュールのデバッグについて（6-17 ページ） .

参照

• ［App Console］ビュー（10-3 ページ）

• ［ARM Asm Info］ビュー（10-5 ページ）



• C/C++ エディタ（10-14 ページ）






• ［History］ビュー（10-38 ページ）



• ［Screen］ビュー（10-50 ページ）

• ［Scripts］ビュー（10-53 ページ）

• ［Target］ビュー（10-55 ページ）




— disassemble （2-64 ページ）

— info address （2-85 ページ）

— info functions （2-94 ページ）



— info locals （2-97 ページ）

— info registers （2-104 ページ）

— info symbol （2-110 ページ）

— info variables （2-113 ページ）

— print, inspect （2-138 ページ）

— whatis （2-224 ページ）

— x （2-227 ページ） .



5.2 コールスタックの検査

コールスタック、つまりランタイムスタックは、関数の復帰情報とローカル変数を保存するのに使用されるメモリの領域です。各関数が呼び出されると、レコードが

コールスタック上に作成されます。このレコードは一般にスタックフレームと呼ばれ

ます。

デバッガは実行パスに存在する関数の呼び出しシーケンスを表示できます。これは、その呼び出しアドレスが引き続きコールスタックに存在してるためです。ただし、以

下のような例外もあります。

• 関数が実行を完了すると、関連付けられているスタックフレームはコールスタックから削除され、情報はデバッガで使用できなくなります。

• デバッグ情報がない関数がコールスタックに含まれていると、デバッガでスタックフレームの呼び出しのバックアップをトレースできない場合があります。したがって、すべてのコードをデバッグ情報とともにコンパイルして、完

全なコールスタックを正しく表示する必要があります。

マルチスレッドアプリケーションをデバッグする場合、別個のコールスタックはスレッドごとに維持されます。

DS-5 デバッグパースペクティブのすべてのビューが現在のスタックフレームに関連

付けられ、別のフレームを選択すると更新されます。現在のスックフレームは太字で

示されます。


5.2.1 関連項目












概念 • ベアメタル対称型マルチプロセスシステムのデバッグについて（6-7 ページ）




• Linux カーネルモジュールのデバッグについて（6-17 ページ） .

参照





• C/C++ エディタ（10-14 ページ）















— down （2-66 ページ）

— down-silently （2-67 ページ）

— frame （2-78 ページ）

— info frame （2-93 ページ）

— info registers （2-104 ページ）

— info stack, backtrace, where （2-109 ページ）

— select-frame （2-150 ページ）

— set backtrace （2-154 ページ）

— up （2-219 ページ）

— up-silently （2-220 ページ） .



5.3 トレースサポートについて

ARM® DS-5™ を使用すると、アプリケーションまたはシステムでトレースを実行でき

ます。トレースは、命令の以前の非侵襲型デバッグをリアルタイムにキプチャする機

能です。これは、システムがフルスピードで実行されている間に問題を調査できる強

力なツールです。これらの問題は断続的であ可能性があり、プロセッサの開始と停止

を要する従来のデバッグ手法では特定が困難です。トレースは、潜在的なボトルネッ

クを特定する場合、アプリケーションのパフォーマンス重視の部分を向上させる場合でも役立ちます。

デバッガでアプリケーションでの関数の実行をトレースする前に、以下のことを確認する必要があります。

• デバッグハードウェアエージェントがあること（トレースストリームへの接続がある ARM DSTREAM™ ユニットなど）

• デバッガがデバッグハードウェアエージェントに接続されていること

5.3.1 トレースハードウェア

トレースは通常、プロセッサに接続されている外部ハードウェアブロックによって提供されます。これは、 Embedded Trace Macrocell™ （ETM™）または Program Trace Macrocell （PTM）と呼ばれ、 ARM アーキテクチャベースシステムのオプションの部

分です。 System-on-chip Designer は、このブロックをシリコンから省いてコスト削減

することがあります。これらのブロックは、プロセッサの動作を監視するので（ただ

し動作には影響は与えない）、命令の実行とデータアセスを監視できます。

トレースのキャプチャには 2 つの重要な問題があります。 1 つ目は、プロセッサク

ロック速度が非常に高く、ほんの数秒の操作でも数十億サイクが実行されることです。この情報量を参照することは明らかに困難です。 2 つ目の関連する問題は、新

のプロセッサでは、サイクルあたり 1 または複数の 64 ビットのキャッシュアクセス

が実行される可能性があることと、データアドレスとデータ値の両方を記録する場合に大きな帯域が必要になる可能性があることです。その問題が現れることはよくあ

るので、数本のピンがチップ上に用意されており、プロセッサをクロッキグ可能なレートより大幅に低いレートでこれらの出力を切り替えることができることがあります。トレースポートの容量は簡単に超えてしまいます。この後半の問題を解決する

には、トレースマクロセルで情報を圧縮し、必要な帯域幅を減らします。ただし、こ

れらの問題に対処する主な方法は、選択したトレース情報のみを収集するようトレースブロックを制御する方法です。例えば、データ値を記録しないで実行のみをト

レースしたり、特定のペリフェラルに対して、または特定の関数の実行時に、データアクセスのみをトレースしたりできます。

さらに、トレース情報をオンチップメモリバッファである Embedded Trace Buffer™

（ETB™）に格納することは一般的です。これは、情報を高速かつオフチップで取得す

る問題を軽減しますが、シリコンの面積の点で追加のコストがかかり、さらにキャプチャできるトレースの量が制限されます。

ETB は圧縮したトレース情報を循環形式で保存し、停止するまで継続してトレース

情報をキャプチャします。 ETB のサイズはチップの実装によってなりますが、通常

は、数千行のプログラムトレースの保持には 8KB または 16KB のバッファで十分で

す。

プログラムが失敗した場合、トレースバッファが有効であると、プログラム履歴の一部を表示できます。このプログラム履歴を表示することで、プログラムを逆戻りし

て、障害発生時点の前に何が発生したかを簡単に確認できます。これは、プロセッサ



の開始と停止を要する従来のデバッグ手法では特定が困難である断続的な障害やリアルタイムな障害の調査に特に役立ちます。トレースは実行されたものを正確に示す

ため、ハードウェアトレースを使用するとこれらの障害の特定に要する時間が大幅に短縮されます。

5.3.2 トレース範囲

トレース範囲により、メモリのリニア範囲にトレースのキャプチャを制限できます。トレース範囲には、仮想メモリに開始アドレスと終了アドレスがあり、このアドレス範囲内の実行がキャプチャされます。トレースの始点と終点とは異なり、トレース

範囲内で行われた関数呼び出しは、関数呼び出しのターゲットも指定したアドレス範囲内にある場合にのみ、キャプチャされます。有効にできるトレース範囲の数は、

プロセッサのデバッグハードウェアによって決まります。

トレース範囲が設定されていない場合は、トレースキャプチャはデフォルトで有効になっています。トレース範囲が設定されている場合、トレースキャプチャはデフォ

ルトで無効になっており、定義された範囲内でのみ有効になります。

トレースビューの［範囲］タブを使用してトレース範囲を設定できます。各範囲の開

始アドレスと終了アドレスには、絶対アドレスまたは式（関数の名前など）のいずれかを指定できます。コンパイラを適化すると、メモリ内のコードが、関連する

ソースコードから再配置または小化されることに注意してください。これによっ

て、コードが予期していないようにインクルードされたり、トレースキャプチャから除外されたりすることがあります。

5.3.3 トレースポイント

トレースポイントでは、プログラムでトレースがキャプチャされる位置を厳密に制御できます。トレースポイントは、非侵入型であり、システムで処理を停止させる必

要がありません。設定できるトレースポイントの大数は、プロセッサのデバッグ

ハードウェアによって決まります。以の種類のトレースポイントが使用できます。

トレースの起点実行が選択したアドレスに達したときにトレースキャプチャを有

効にします。

トレースの終点実行が選択したアドレスに達したときにトレースキャプチャを無

効にします。

トレースのトリガポイント

トレースビューで簡単に検索できるように、トレースでこのポイントをマークします。

ソースビューにトレースポイントを設定するには、余白を右クリックし、［DS-5 ブレークポイント］コンテキストメニューから選択します。逆アセンブリビューにト

レースポイントを設定するには、命令を右クリックし、コンテキストメニューから選択します。トレースポイントはブレークポイントビューに一覧表示されます。

トレースの始点はトレースのキャプチャを有効にし、トレースの終点はトレースのキャプチャを無効にします。トレースポイントはネストを考慮しません。たとえば、

行で 2 つのトレースの起点に達した後に、 2 つのトレースの終点に達した場合、初

のトレースの終点（2 番目ではない）達するとすぐにトレースは無効になります。トレースの起点が設定されていない場合、トレースはデフォルトで常に有効になります。トレース起点が設定されている場合、トレースはデフォルトで無効になり、初

のトレースの起点に達したときにだけ有効になります。



トレースのトリガポイントを使用すると、トレースの関心のある位置をマークできるため、後でトレースビューで簡単に検索できます。ビューメニューの［トリガパ

ケットの検出］オプションを選択してトレースのトリガポイントを特定します。トレースのトリガポイントに達したときにデバッガが停止するように設定するには、トレースビューの［プロパティ］タブの［トリガ時に停止］チェックボックスを使用します。これを設定すると、［ポストトリガキャプチャのサイズ］フィールドを使

用してトレースのトリガポイントの前後でキャプチャされるトレースの量を設定できます。

注ターゲットプラットフォームによっては、トレースキャプチャデバイス

（ETB/DSTREAM）によるトレーストリガポイントの検出をサポートしていないのも

あります。

5.3.4 関連項目

参照


• ［Export trace report］ダイアログボックス（10-68 ページ）

• ARM® DS-5™ ARM® DSTREAM™ ハードウェアの設定 :— DSTREAM ユニットの接続 ,

http://infocenter.arm.com/help/topic/com.arm.doc.dui0481-/I1004916.html.

概念 • ベアメタル対称型マルチプロセスシステムのデバッグについて（6-7 ページ） .


第 6 章組み込みシステムのデバッグ

以下の各トピックでは、組み込みシステムのデバッグについて紹介します。

概念 • エンディアンについて（6-2 ページ）

• AHB バスと APB バスへのアクセスについて（6-3 ページ）

• 仮想メモリと物理メモリについて（6-4 ページ）

• ハイパーバイザのデバッグについて（6-5 ページ）

• ベアメタル対称型マルチプロセスシステムのデバッグについて（6-7 ページ）




• Linux カーネルモジュールのデバッグについて（6-17 ページ）

• TrustZone 対応ターゲットのデバッグについて（6-19 ページ） .


組み込みシステムのデバッグ

6.1 エンディアンについて

エンディアンという用語は、個々にアドレス指定可能な量の順序を説明するために使用されます。具体的には ARM アーキテクチャでのバイトとハフワードのことで

す。エンディアンの代わりに、バイト順序という用語を使用することもあります。

接続されているターゲットに画像がロードされる場合、デバッガは自動的にその画像のエンディアンを選択します。それ以外の場合はターゲット現在のエンディアンを選択します。デバッガが競合を検出した場合は、警告メッセージを生成します。

デフォルトのデバッガ設定を変更するには、 set endian コマンドを使用します。

6.1.1 関連項目

参照


— set endian （2-159 ページ）

— show endian （2-187 ページ） .



6.2 AHB バスと APB バスへのアクセスについて

ARM ベースのシステムでは、バスを使用してプロセッサ、メモリおよびペリフェラ

ルを接続します。標準的なバスタイプの例には、 AMBA ハイパフォーマンスバス

（AHB）とアドバンストペリフェラルバス（APB）が含まれます。

システムにより、デバッグインタフェースからこれらのバスにアクセスできる場合があります。この場合、 DS-5 デバッガはベアメタルまたはカールデバッグを実行す

る際にこれらのバスへのアクセスを提供します。デバッガ内では、バスは追加のアド

レス空間として公開されます。これらのバスへのアクセスは、プロセッサが実行中に

使用できます。

DS-5 デバッガのデバッグセッションで、 info memory コマンドを使用してどのバスが

使用できるのかを知ることができます。このコマンドの出力のアドレス列と説明列

に、各アドレス空間の意味とバッガのアクセス方法の説明があります。

これらのバスに対しては、 AHB: と APB: のアドレス接頭辞を使用して、デバッガのど

の場所でもアドレスと式を通常に入力することができます。たとえば、デバッガが APB アドレス空間を提供すると仮定し、次のコマンドを使用してアドレスゼロの内

容を出力できます。

x/1 APB:0x0

バスの正確なトポロジとデバッグインタフェースへの接続はシステムに依存します。詳細については、ハードウェアの CoreSight 仕様を参照して下い。通常、これらのバ

スへのデバッグアクセスはプロセッサをバイパスするため、プロセッサ自身でのメモリマッピングやキャッシュは考慮しせん。システム内の L2 キャッシュまたは L3 キャッシュなどのその他のキャッシュの前にバスにアクセスするか、または後にアクセスするかなの実装に依存します。デバッガは、これらのバスにアクセスすると

き、システムのキャッシュ間のコヒーレンシを確保しようとはしません。しがって、このことを考慮して、必要に応じて削除またはフラッシュ操作を手動で行うのはユーザの責任です。

たとえば、プロセッサレベル 1 のキャッシュを有効にした画像をデバッグするとき

にキャッシュコヒーレンシを確保するには、アプリケーションードまたはデータを AHB アドレス空間を使用して変更する前に、 L1 キャッシュ部分を削除して無効にす

る必要があります。これによって、キャシュ内で行われた変更が、そのアドレス空間

に書き込まれる前にメモリに書き出され、プロセッサは、実行の再開時に変更内容を正しく読み取るようになります。

割り当てられていないアドレスへのアクセスが未定義でシステムに依存する場合、バスをロックアップする可能性があります。システム内で定義ずみの特定のアドレス

にのみアクセスすることをお勧めします。 memory コマンドを使用してデバッガ内のメ

モリ領域を再定義し、アクセス権を変更してアドレスを制御することができます。 x コマンドに count オプションを付けて使用し、読み出されるメモリ量を制限すること

ができます。



6.3 仮想メモリと物理メモリについて

メモリ管理ユニット（MMU）を含むプロセッサは、メモリを 2 つの方法（仮想メモ

リと物理メモリ）で表示できます。仮想アドレスは MMU 内のアドレス変換前のアド

レで、物理アドレスは変換後のアドレスです。通常デバッガがメモリにアクセスする

場合は仮想アドレスを使用します。しかし MMU が無効になっいる場合は、マッピン

グは一様で、仮想アドレスと物理アドレスは同じものになります。デバッガに物理ア

ドレスを使用させるには、アドレス接頭辞 P: を付けます。以下に例を示します。

P:0x8000P:0+main は main のアドレスオフセットの付いた物理アドレスを作成します。

プロセッサが TrustZone テクノロジも追加で含む場合、セキュアワールドと通常環境

にアクセスできます。それぞれに独自で別々の仮想および物理ドレスマッピングが行われます。この場合、アドレス接頭辞 P: は使用できません。その代わり、通常環

境の物理アドレスには NP: を、セキュアワールドの物理アドレスには SP: を使用する

必要があります。

注物理アドレスへのアクセスはすべての操作で有効になっているわけではありません。たとえば、 ARM ハードウェアは物理アドレス経由でのブレーポイントの設定はサ

ポートしていません。

物理アドレス経由でメモリにアクセスする場合は、キャッシュはフラッシュできません。このため、メモリを物理アドレスで表示するか仮想アドレスで表示するかに

よって、結果が異なる場合があります（同じメモリアドレスを処理すると仮定して）。



6.4 ハイパーバイザのデバッグについて

仮想化拡張機能をサポートしている ARM プロセッサには、ハイパーバイザの下で複

数のゲストオペレーティングシステムを実行する機能があります。ハイパーバイザ

は、ゲストオペレーティングシステム間を調停し、ハードウェアへのアクセスを制御するソフトウェアです。

DS-5 デバッガには、ベアメタルハイパーバイザのデバッグのベーシックサポートが

用意されています。仮想化拡張機能をサポートしているプロセッサと接続すると、デ

バッガによって、ハイパーバイザとゲストメモリを区別し、ハイパーバイザモード時や特定のゲストオペレーティングシステム内でのみ適用されるブレークポイントを設定できます。

一般的にハイパーバイザは、ハイパーバイザ自体の個別のアドレス空間だけでなく、各ゲストオペレーティングシステムのアドレス空間も提供します。特に情報が与えら

れない限り、デバッガによるすべてのメモリアクセスは現在のコンテキスト内で発生します。ハイパーバイザモードで停止すると、メモリアクセスではハイパーバイザ

のメモリ空間が使用され、ゲストオペレーティングシステムで停止すると、ゲストオペレーティンシステムのアドレス空間が使用されます。特定のアドレス空間へのア

クセスを強制するには、ハイパーバイザについては、接頭辞 H: を、ゲストオペレー

ティングシステムについては接頭辞 N: をアドレスの前に付ける必要があります。ゲストオペレーティングシステムのアドレス空間にアクセスできるのは、そのゲストオペレーティンシステムが現時点でハイパーバイザ内で実行するようにスケジュールされている場合だけです。別のゲストオペレーティングシステムを指定すことはで

きません。

同様に、ハードウェアブレークポイントとソフトウェアブレークポイントは、同じアドレス接頭辞を使用してハイパーバイザまたはゲストオペレティングシステムで一致するように設定できます。アドレス接頭辞を使用しない場合、ブレークポイント

は、初に設定されたときに新となているアドレス空間に適用されます。ソフト

ウェアブレークポイントが、ハイパーバイザとゲストオペレーティングシステム間で共有されていメモリ内で設定されている場合、ブレークポイントは誤ったモードからヒットする可能性があります。その場合、デバッガは停止理由としてブレークポイントを認識できない場合があります。

ハードウェアブレークポイントについてのみ（ソフトウェアブレークポイントではない）、特定のゲストオペレーティングシステム内で一致するようにブレークポイントを追加設定できます。この機能では、特定のゲストオペレーティングシステムが実

行されているときに見分けるための、アーキテクチャ上で定義されている仮想マシン ID （VMID）レジスタが使用されます。ハイパーバイザは、一意の VMID を各ゲス

トオペレーティングシステムに割り当て、そのゲストオぺレーティンシステムの実行時に VMID レジスタ内でこれを設定する役割を担います。この機能を使用する場合

は、ユーザがデバッグする各ゲストオペレーテングシステムにどの VMID が関連付

けられているかを把握して下さい。 VMID を知っていると、［Breakpoints］ビュー内

で、または break-stop-on-vmid コマンドを使用してこの VMID にブレークポイントを

適用できます。

複数のゲストオペレーティングシステムが実行されているシステムをデバッグする場合は、 set print current-vmid 設定を有効にして、デバッガが停止し、現在の VMID が変更されたときにコンソールで通知を受け取ることもできます。また、 $vmid デバッガ変数を使用して DS-5 スクリプト内で VMID を取得できます。



6.4.1 関連項目

参照


— 式の使用（2-4 ページ）


— set print （2-164 ページ）

— show print （2-191 ページ） .



6.5 ベアメタル対称型マルチプロセスシステムのデバッグについて

DS-5 デバッガでは、ベアメタル対称型マルチプロセス（SMP）システムのデバッグ

をサポートしています。デバッガでは、 SMP システムが以下の要件を満たしている

ことを想定しています。

• すべてのプロセッサ上で動作する同じ ELF イメージ。

• すべてのプロセッサに同じデバッグハードウェアがある必要があります。例え

ば、ハードウェアブレークポイントとウォッチポイントリソースの数は同じでなければなりません。

• ブレークポイントとウォッチポイントは、すべてのプロセッサが、物理メモリと仮想メモリの両方でメモリマップが同じである領域のみで設定する必要があります。 ARM マルチコアプロセッサのプライベートペリフェラルの場合、同じ

アドレスでマッピングされる同じペリフェラルの別のインスタンスを持つプロセッサは、この要件を満たしていると見なされます。

6.5.1 設定と接続

デバッガで SMP サポートを有効にするには、初に［Debug Configurations］ダイア

ログボックスでデバッグセッションを設定する必要があります。 SMP バッグをサ

ポートするターゲットは、 SMP を［Debug operation］ドロップダウンリストで指定す

ることによって識別されます。

デバッガで SMP サポートを有効にするために必要なことは、単一の SMP 接続の設定

だけです。接続時にシステム内のすべての SMP プロセッサをデバッグするには、デ

バッグ制御ビューで選択します。

6.5.2 イメージとシンボルのロード

SMP システムのデバッグ時は、イメージとシンボルのロード操作がすべての SMP プロセッサに適用されます。イメージのロードの場合、これは、いずれかのプロセッサ

を介してイメージのコードとデータがメモリに 1 回書き込まれ、同じアドレスの他

のプロセッサを介してアクセス可能である見なされることを意味します。これは同じメモリを共有するためです。シンボルのロードの場合、これは、デバッグ情報は 1 回ロードされ、いれかのプロセッサのデバッグ時に使用可能であることを意味します。

6.5.3 実行、停止、およびステップ実行

SMP システムのデバッグ時は、 1 つのプロセッサを実行しようとすると、システム

内の他のすべてのプロセッサが自動的に実行されます。同様に、プロセッサが停止す

ると（停止を要求したか、またはブレークポイントに到達するなどのイベントによって）、システム内のすべてのプロセッサ停止します。

命令レベルのシングルステップ実行（stepi および nexti コマンド）の場合、現在選

択されているプロセッサは 1 つの命令をステップ実行します。例外は、nexti 操作が関

数呼び出しをステップオーバーする必要がある場合です。この場合、デバッガはブレークポイントを設定してから、すべてのプロセッサを実行します。他のすべてのス

テップ実行コマンドは、すべてのプロセッサに影響を及ぼします。



システムによっては、実行中または停止中のプロセッサと、実行中または停止中の別のプロセッサの間に遅延がある可能性があります。デバッガでは手動ですべてのプ

ロセッサを個別に実行または停止する必要があるので、この遅延は非常に大きくなる可能性があります。

めったにありませんが、 1 つのプロセッサが停止し、そのために他のプロセッサが停

止できなくなることがあります。例えば、これは、セキュアードでコードを実行して

いるプロセッサが一時的にデバッグ機能を無効にしたときに発生することがあります。これが発生すると、デバッグ制ビューに各プロセッサの個々の状態（実行中また

は停止）が表示されるので、停止できなかったプロセッサを確認できます。すべての

プロセッが停止するまで、後続の実行およびステップ実行操作を正常に動作できない場合があります。

6.5.4 ブレークポイント、ウォッチポイント、およびシグナル

デフォルトでは、 SMP システムのデバッグ時は、ブレークポイント、ウォッチポイ

ント、およびシグナル（ベクタキャッチ）操作がすべてのプロセッサに適用されます。これは、条件を満たすコードをいずれかのプロセッサが実行するときに 1 つのブ

レークポイントをトリガするよう設定できることを意味します。デバッガがブレーク

ポイント、ウォッチポイント、またはシグナルのために停止したときは、イベントを発生させたプロセッサがコマンドビューに表示されます。

関連する［Properties］ダイアログボックスで必要なプロセッサを選択することに

よって、 1 つまたは複数のプロセッサについてブレークポイントまはウォッチポイン

トを設定できます。あるいは、 break-stop-on-cores コマンドを使用することもできま

す。ここの機能はシグナルには使用できません。

6.5.5 ターゲットの状態の検査

レジスタ、コールスタック、メモリ、逆アセンブリ、式、変数などターゲット状態のビューには、プロセッサ固有の内容が含まれています。

ブレークポイント、信号、コマンドなどのビューは、 SMP システム内のすべてのプ

ロセッサで共有され、プロセッサが現在選択されているかどうかに関係なく、同じ内容を表示します。

6.5.6 トレース

トレースのサポートを有効にする接続を使用している場合は、システム内の各プロセッサのトレースを表示できます。デフォルトでは、トレースビューには、デバッグ

制御ビューで現在選択されているプロセッサのトレースが表示されます。あるいは、

トレースビューの［Linked: context］ツールバーオプションを使用することで、その

トレースビューを特定のプロセッサにリンクすることを選択できます。特定のプロ

セッサにリンクされる複数のトレースビューを作成すると、複数のプロセッサからトレースを同時に表示できるようになります。トレースビューのインデックスは、別

のプロセッサと同時に同じポイントを表しているとは限りません。

6.5.7 関連項目













概念 • ブレークポイントとウォッチポイントについて（4-7 ページ）

• トレースサポートについて（5-7 ページ）

• マルチスレッドアプリケーションのデバッグについて（6-10 ページ） .

参照






• ［Modules］ビュー（10-44 ページ）






— info cores （2-91 ページ）





6.6 マルチスレッドアプリケーションのデバッグについて

デバッガはデバッガ変数 $thread を使用して現在のスレッドを追跡します。 print コマ

ンドまたは式でこの変数を使用できます。スレッドは、デバッガによって使用される

固有の ID とオペレーティングシステム（OS）の固有の ID とともにデバッグ制御

ビューに表示されます。 :

Thread 1086 #1 stopped (PID 1086)

ここで、 #1 はデバッガによって使用される固有の ID で、 PID 1086 は OS の ID です。

別個のコールスタックはスレッドごとに維持され、選択されたスタックフレームは太字で示されます。 DS-5 デバッグパースペクティブのすべてのューは選択されたス

タックフレームに関連付けられ、別のフレームを選択すると更新されます。

図 6-1 デバッグ制御ビューのコールスタックのスレッド

6.6.1 関連項目

タスク • 特定のスレッドへのブレークポイントの設定（4-20 ページ）










概念 • ベアメタル対称型マルチプロセスシステムのデバッグについて（6-7 ページ） .

参照






6.7 共有ライブラリのデバッグについて

共有ライブラリを使用すると、アプリケーションの一部を実行時に動的にロードできるようになります。ターゲット上の共有ライブラリがホスト上の共有ライブラリと

同じであることを確認して下さい。コードレイアウトは同一でなければなりません

が、ターゲット上の共有ライブラリはデバッグ情報を必要としません。

共有ライブラリに標準の実行ブレークポイントを設定できますが、設定できるのは、アプリケーションによってロードされ、デバッグ情報がデバッガにロードされた後です。ただし、ブレークポイントを保留にすれば、アプリケーションによってロード

する前に、共有ライブラリに実行ブレークポイントを設定できます。

新しい共有ライブラリをロードすると、デバッガはすべての保留ブレークポイントを再評価し、解決可能なアドレスを持つ保留ブレークポイント標準実行ブレークポイントとして設定されます。未解決のアドレスは保留ブレークポイントのまま残りま

す。

ライブラリがアプリケーションによってアンロードされると、デバッガは共有ライブラリ内のブレークポイントを自動的に保留ブレークポイントに変更します。

［Debug Configurations］ダイアログボックスの共有ライブラリをロードできます。ライブラリファイルが 1 つの場合、［Files］タブの［Load symbols from file］オプショ

ンを使用できます。

図 6-2 個別共有ライブラリファイルの追加



あるいは、複数のライブラリファイルがある場合は、共有ライブラリを検索するときに、デバッガにより使用される検索パスを変更するとより効が良くなる場合があります。これを行うには、［Debugger］タブの［Paths］パネルの［Shared library search directory］オプションを使用します。

図 6-3 共有ライブラリの検索パスの変更

［Debug Configurations］ダイアログボックスのオプションの詳細については、ダイナ

ミックヘルプを使用して下さい。

6.7.1 関連項目

タスク













— Gnometris のデバッグ（3-21 ページ） .




参照










• ［Debug Configurations］ - ［Debugger］タブ（10-90 ページ） .



— info sharedlibrary （2-106 ページ）

— nosharedlibrary （2-135 ページ）

— set auto-solib-add （2-153 ページ）

— set solib-search-path （2-169 ページ）

— set stop-on-solib-events （2-171 ページ）

— set sysroot, set solib-absolute-prefix （2-173 ページ）

— sharedlibrary （2-176 ページ） .



6.8 Linux カーネルのデバッグについて

DS-5 は、 Linux カーネルのソースレベルのデバッグをサポートしています。 Linux カーネル（および関連するデバイスドライバ）は標準の ELF 形式の行可能ファイル

と同じ方法でデバッグできます。例えば、ブレークポイントをカーネルコードに設定

し、ソースをステップ実行し、コールスタクを確認して、変数を観察できます。

注現在マップされていないユーザ空間パラメータ（__user とマークされている）をデ

バッガが読み出すことはできません。

カーネルをデバッグするには

1. 以下のオプションを使用して、カーネルソースをコンパイルします。

• CONFIG_DEBUG_KERNEL=y

• CONFIG_DEBUG_INFO=y

• 実行するデバッグのタイプによっては、他のオプションが必要になることがあります。

カーネルソースをコンパイルすると、デバッグ情報を含む Linux カーネルイ

メージとシンボルファイルが生成されます。

注 Linux カーネルは常に完全な適化でコンパイルされ、インライン化が有効に

なっているので、以下のことに注意して下さい。

• コードをステップ実行すると、一部の命令が並べ替えられている可能性があるため、予想どおりに動作しないことがあります。

• 一部の変数がコンパイラによって適化されて取り除かれる場合があるので、デバッガで使用できません。

2. Linux カーネルをターゲットにロードします。

3. カーネルのデバッグ情報をデバッガにロードします。

4. 必要に応じて、カーネルをデバッグします。

6.8.1 関連項目

タスク • Linux カーネルへの接続の設定（3-9 ページ）















概念 • Linux カーネルモジュールのデバッグについて（6-17 ページ）



参照
















6.9 Linux カーネルモジュールのデバッグについて

Linux カーネルモジュールには、カーネルの機能を拡張する方法が用意されており、

通常はデバイスやファイルシステムドライバなどに使用されます。モジュールはカー

ネル内に組み込むか、またはロード可能なモジュールとしてコンパイルすることができます。その後は、カーネルを頻繁にコンパイルしなくても、開発時に実行中のカーネルからダイナミックに挿入および削除できます。ただし、モジュールによって

はカーネルに組込む必要があり、ダイナミックなロードに適さないものがあります。組み込みモジュールの例としては、カーネルのブート時に必要であり、ルトファイルシステムを取り付ける前に使用可能でなければならないものがあります。

デバッグ情報がデバッガにロードされていれば、ソースレベルのブレークポイントをモジュールに設定できます。カーネルにモジュールを挿入する前にモジュールにブ

レークポイントを設定しようとすると、ブレークポイントが保留されます。

モジュールをデバッグするときは、ターゲット上のモジュールとホスト上のモジュールが同じであることを確認する必要があります。コードレイアウトは同じでな

ければなりませんが、ターゲット上のモジュールにはデバッグ情報は不要です。

6.9.1 組み込みモジュール

カーネルに組み込まれているモジュールをデバッグする場合の手順は、カーネル自体をデバッグする場合の手順と同じです。

1. カーネルをモジュールとともにコンパイルします。

2. カーネルイメージをターゲットにロードします。

3. 関連するカーネルイメージとデバッグ情報をデバッガにロードします。

4. 他のカーネルコードと同じようにモジュールをデバッグします。

組み込み（静的リンク）モジュールは残りのカーネルコードと区別できません。そのため、 info os-modules コマンドによって表示されず、モジュールビューにも表示さ

れません。

6.9.2 ロード可能なモジュール

ロード可能なカーネルモジュールをデバッグする手順はより複雑です。 Linux ターミ

ナルシェルから insmod および rmmod コマンドを使用して、モジュールの挿入および削

除を行うことができます。カーネルとロード可能なモジュールの両方のデバッグ情報

をデバッにロードする必要があります。モジュールを挿入および削除すると、デバッ

ガはデバッグ情報と既存のブレークポイントのメモリ位置を自動的解決します。これ

を行う場合、デバッガはカーネル内の呼び出しをインターセプトして、モジュールを挿入または削除します。これにより、アションのたびにわずかな遅延が発生し、そ

の間デバッガはカーネルを停止してさまざまなデータ構造を調べます。ロード可能な

カーネルモジュルのデバッグの詳細については、『DS-5 スタートガイド』のチュート

リアルを参照して下さい。

注ロード可能なモジュールを検出するには、デバッガ内で接続が確立しており、オペ

レーティングシステム（OS）サポートが有効になっている必要があります。 Linux カーネルイメージがデバッガにロードされると、 OS サポートは自動的に有効になり

ますただし、 set os コマンドを使用して手動でこれを制御することもできます。



6.9.3 関連項目

タスク




概念 • Linux カーネルのデバッグについて（6-15 ページ） .

参照












— info os-log （2-100 ページ）

— info os-modules （2-101 ページ）

— info os-version （2-102 ページ）

— info processes （2-103 ページ）

— set os （2-162 ページ）

— show os （2-190 ページ） .



6.10 TrustZone 対応ターゲットのデバッグについて

ARM TrustZone® は、複数の ARM プロセッサに組み込まれているセキュリティ技術で

す。例えば、 Cortex™-A クラスプロセッサが該当します。メモリや周辺機器などの実

行とリソースをセキュアワールドと通常環境に分割します。

TrustZone をサポートするターゲットに接続するときに、セキュアワールドへのアク

セスが許可されている場合、デバッガはセキュアワールドと通常環境の両方へのアクセスを提供します。この場合、すべてのアドレスおよびアドレスに関連する操作

は、 1 つの世界に固有のものです。つまり、ドレスまたは式が必要なコマンドを使用

する場合は、適用先の環境も指定する必要があります。 : S:0x1000


N: 通常環境メモリのアドレスの場合

S: セキュアワールドメモリのアドレスの場合

現在の環境でアドレスを指定する場合は、接頭辞を省略できます。

イメージおよびデバッグ情報をロードする場合、これらを適切な環境にロードすることが重要です。デバッグランチャパネルでは、画像およびデバッグ情報のアドレス

環境を直接指定することはできません。そのため、これを行うには代わりにスクリプトコマンドを使用する必要があります。デバッガランチャパネルの［Debugger］タブには、デバッグ初期化スクリプト、または接続時に任意のデバッガコマンドのセットを実行するオプションが用意されています。コマンド例には以下のものがあり

ます。

• イメージのみを通常環境にロードする（イメージ内のアドレスにゼロオフセットを適用）

load myimage.axf N:0

• デバッグ情報のみをセキュアワールドにロードする（デバッグ情報内のアドレスにゼロオフセットを適用）

file myimage.axf S:0

• イメージおよびデバッグ情報をセキュアワールドにロードする（アドレスにゼロオフセットを適用）

loadfile myimage.axf S:0

デバッグシンボルのロードやブレークポイントの設定といった操作を通常環境およびセキュアワールドの両方に適用する必要がある場合は、通常境に 1 回、セキュア

ワールドに 1 回、合計 2 回の操作を実行する必要があります。

$PC などのレジスタに環境はありません。現在の環境にはないレジスタ内のアドレス

からメモリの内容にアクセスするには、 N:0+$PC という式を使用できます。一般に、デ

バッグ情報を含む式はロードされるときに環境に関連付けられるため、これらの式に必要ありません。

6.10.1 関連項目

参照 • ［Breakpoints］ビュー（10-9 ページ）






— load （2-119 ページ）

— loadfile （2-120 ページ） .• TrustZone テクノロジを使用してセキュアシステムを構築する ARM セキュリ

ティ技術 , http://infocenter.arm.com/help/topic/com.arm.doc.prd29-genc-009492c/index.html

• テクニカルリファレンスマニュアル , http://infocenter.arm.com/help/topic/com.arm.doc.set.cortexa/

• 『アーキテクチャリファレンスマニュアル』 , http://infocenter.arm.com/help/topic/com.arm.doc.set.architecture/


第 7 章スクリプトを使用したデバッグ

以下の各トピックでは、デバッガコマンドを含むスクリプトを使用して、デバッグ操作を自動化できるようにする方法について説明します。

タスク • デバッグセッションで生成された DS-5 デバッガコマンドのエクスポート

（7-2 ページ）

• DS-5 デバッガスクリプトの作成（7-3 ページ）

• Jython スクリプトの作成（7-4 ページ）

• CMM スタイルのスクリプトの作成（7-7 ページ）

• スクリプトの実行（7-9 ページ）

• Eclipse での Jython プロジェクトの設定（7-11 ページ） .


スクリプトを使用したデバッグ

7.1 デバッグセッションで生成された DS-5 デバッガコマンドのエクスポート

必要に応じてすべてのツールバーアイコンおよびメニューオプションを使用して、デバッグセッションを実行できます。現在のデバッグセッション時に生成されるすべ

ての DS-5 デバッガコマンドの一覧は［History］ビューに記録されます。 Eclipse を閉

じる前に、スクリプトファイルに必要なコマンドを選択し、［Export the selected lines as a script file］をクリックして、ファイルに保存できます。

図 7-1 デバッグセッションで生成されたコマンド

7.1.1 関連項目

タスク


• スクリプトの実行（7-9 ページ） .

参照









7.2 DS-5 デバッガスクリプトの作成

スクリプトファイルには、 1 行につき 1 つのコマンドのみを含める必要があります。必要に応じて、各コマンドをコメントで識別することもできます。スクリプトの種類

を区別するため、 .ds ファイル拡張子を使用する必要があります。

例 7-1 DS-5 デバッガスクリプト

# ファイル名： myScript.ds

# 初期化コマンド

load "struct_array.axf" # イメージのロード

file "struct_array.axf" # シンボルのロード

break main # main() にブレークポイントを設定

break *0x814C # アドレス 0x814C にブレークポイントを設定

# ブレークポイントまで実行し必要な値を出力

run # 実行中のデバイスを開始

wait 0.5s # 待機するか 0.5 秒後にタイムアウト

info stack # コールスタックを表示

info registers # すべてのレジスタの情報を表示

# 次のブレークポイントまで続行し、必要な値を出力

continue # 実行中のデバイスを続行

wait 0.5s # 待機するか 0.5 秒後にタイムアウト

info functions # すべての関数の情報を表示

info registers # すべてのレジスタの情報を表示

x/3wx 0x8000 # 0x8000 （hex）から 3 ワード分のメモリを表示

...

# シャットダウンコマンド

delete 1 # 番号 1 に割り当てられたブレークポイントを削除

delete 2 # 番号 2 に割り当てられたブレークポイントを削除

7.2.1 関連項目

タスク



参照



— 第 2 章 DS-5 デバッガコマンド .



7.3 Jython スクリプトの作成

Jython は、 Java で実装された Python スクリプト言語です。これによって、コードの

データ型、条件付き実行、ループ、および、関数、クラス、モジールへの構成が包括的にサポートされるだけでなく、標準的な Jython ライブラリへのアクセスも可能

になります。 Jython は、より大きなスクリプや複雑なスクリプトを実行する場合に

適な言語です。

これらは、デバッガの Jython スクリプトを作成するために必要な重要な概念です。

インポートデバッガモジュールには、レジスタやメモリなどにアクセスするため

の、サービスと呼ばれるクラスと共に、 DS-5 デバッガへの初期アクセ

スのたのデバッガクラスが用意されています。以下の例は、一般に Jython スクリプトの上位に置かれるモジュールインポートの完全なセッ

トを示しています。

from arm_ds.debugger_v1 import Debuggerfrom arm_ds.debugger_v1 import DebugException

実行コンテキスト

DS-5 デバッガの Jython インタフェースで実行するほとんどの操作には、

例外コンテキストが必要です。実行コンテキストは、ターゲットシステ

ム状態を表します。デバッガでアクセス可能なプロセス、スレッド、プ

ロセッサごとに個別の実行コンテキストが存在します。例えば、デバッ

ガラスのインスタンスから実行コンテキストを取得できます。

# 最初の実行コンテキストを取得debugger = Debugger()ec = debugger.getExecutionContext(0)

レジスタデバッガの Jython インタフェースを使用して、プロセッサレジスタ、コ

プロセッサレジスタ、および周辺レジスタにアクセスできます。レジス

タアクセスするには、その名前に関する情報が必要です。名前は、グラ

フィカルデバッガの［レジスタ］ビューから取得できます。 RegisterService 使用すると、特定の実行コンテキストでレジスタ値の読

み取りと書き込みを行うことができます。以下に例を示します。

# 実行コンテキスト ec からプログラムカウンタ（PC）を出力value = ec.getRegisterService().getValue('PC')print 'The PC is %s' %value

メモリデバッガの Jython インタフェースを使用してメモリにアクセスできま

す。アクセスするアドレスとバイト数を指定する必要があります。アド

レスとサイズは、指定された実行コンテキスト内で評価される式を含んでいる絶対値または文字列にすることができます。以下に例を示しま

す。

# 実行コンテキスト ec からアドレス 0x0 で 16 バイトを出力print ec.getMemoryService().read(0x0, 16)

DS コマンド

デバッガの Jython インタフェースを使用して、任意の DS-5 コマンドを

実行できます。これは、必要な機能が Jython インタフェースでは直接提

供さていない場合に役立ちます。実行コンテキストと、実行するコマン

ドおよび引数を指定する必要があります。戻り値には、戻り値には、コ

マンからのテキスト出力およびエラー（ある場合）が含まれます。以下

に例を示します。



# DS-5 コマンド 'print $ENTRYPOINT' を実行し、結果を出力print ec.executeDSCommand('print $ENTRYPOINT')

エラー処理

デバッガの Jython インタフェースのメソッドでは、エラーが発生する

と、 DebugException がスローされます。詳細を出力するために、例外を

キャッチてエラーを処理できます。以下に例を示します。

# DebugException をキャッチし、エラーメッセージを出力try:ec.getRegisterService().getValue('ThisRegisterDoesNotExist')

except DebugException, de:print "Caught DebugException: %s" % (de.getMessage())

スクリプトの種類を区別するため、 .py ファイル拡張子を使用する必要があります。

例 7-2 Jython スクリプト

# ファイル名： myScript.py

import sys

from arm_ds.debugger_v1 import Debuggerfrom arm_ds.debugger_v1 import DebugException

# デバッガにアクセスするためのデバッガオブジェクトdebugger = Debugger()

# 初期化コマンドec = debugger.getExecutionContext(0)ec.getExecutionService().stop()ec.getExecutionService().waitForStop()# 実行コンテキストリファレンスが古い場合ec = debugger.getExecutionContext(0)# スクリプト引数で指定されている場合にイメージをロードif len(sys.argv) == 2:

image = sys.argv[1]ec.getImageService().loadImage(image)ec.getExecutionService().setExecutionAddressToEntryPoint()ec.getImageService().loadSymbols(image)

# 使用可能なすべての DS コマンドが使用できるprint "Entry point: ",print ec.executeDSCommand("print $ENTRYPOINT")# 出力例：

# エントリポイント： $8 = 32768else:

pass # イメージとシンボルがロードされることを前提とする

# メインにテンポラリブレークポイントを設定して再開

ec.getExecutionService().resumeTo("main") # この方法はノンブロックtry:

ec.getExecutionService().waitForStop(500) # 500ms 待機

except DebugException, e:if e.getErrorCode() == "JYI31": # "Wait for stop timed out" メッセージのコード

print "Waiting timed out!"sys.exit()

else:



raise # 別のエラーの場合は例外を発生させるec = debugger.getExecutionContext(0)

def getRegisterValue(executionContext, name):""" レジスタ値を取得し、符号なし 16 進数および符合付き整数と共に文字列を返します。

レジスタの読み取りで問題が発生した場合は、文字列 "error" を返す可能性が

あります。"""try:

value = executionContext.getRegisterService().getValue(name)# 戻り値は数値型のように動作し、

# バイトの配列のようにアクセス可能（例： 'print value[:]'）return "%s (%d)" % (str(value), int(value))

except DebugException, e:return "error"

# すべての実行コンテキストでコアレジスタを出力for i in range(debugger.getExecutionContextCount()):

ec = debugger.getExecutionContext(i)# "Core::" で始まるレジスタ名をフィルタcoreRegisterNames = filter(lambda name: name.startswith("Core::"),

ec.getRegisterService().getRegisterNames())# Jython 包括リストを使用して、これらのすべてのレジスタの値を取得registerInfo = ["%s = %s" % (name, getRegisterValue(ec, name))

for name in coreRegisterNames]

registers = ", ".join(registerInfo[:3]) # 最初の 3 つのみprint "Identifier: %s, Registers: %s" % (ec.getIdentifier(), registers)

# 出力：

# 識別子： 1、レジスタ： Core::R0 = 0x00000010 (16), Core::R1 = 0x00000000 (0), Core::R2 = 0x0000A4A4 (42148)# ...

7.3.1 関連項目

タスク




参照






7.4 CMM スタイルのスクリプトの作成

スクリプトファイルには、 1 行につき 1 つのコマンドのみを含める必要があります。必要に応じて、各コマンドをコメントで識別することもできます。スクリプトの種類

を区別するため、 .cmm または .t32 ファイル拡張子を使用する必要があります。

例 7-3 CMM 形式のスクリプト

// ファイル名： myScript.cmm

system.up ; ターゲットおよびデバイスに接続

data.load.elf "hello.axf" ; イメージおよびシンボルをロード

// ブレークポイントおよびレジスタの設定

break.set main /disable ; ブレークポイントを設定し、すぐに無効

break.set 0x8048 ; 指定のアドレスでブレークポイントを設定

break.set 0x8060 ; 指定のアドレスでブレークポイントを設定

register.set R0 15 ; レジスタ R0 を設定

register.set PC main ; PC レジスタをシンボルアドレスに設定

...

break.enable main ; 指定のシンボルでブレークポイントを有効化

// ブレークポイントまで実行し、必要な値を表示

go ; デバイスを実行開始

var.print "Value is: " myVar ; 文字列および変数値を表示

print %h r(R0) ; レジスタ R0 を 16 進数で表示

// ブレークポイントまで実行しスタックを出力

go ; 次のブレークポイントまで実行

var.frame /locals /caller ; すべての変数と関数の呼び出し元を表示

...

// シャットダウンコマンド

break.delete main ; main() のアドレスにあるブレークポイントを削除

break.delete 0x8048 ; アドレスのブレークポイントを削除

break.delete 0x8060 ; 指定のアドレスのブレークポイントを削除

system.down ; ターゲットから切断

7.4.1 関連項目

タスク



参照



（2-13 ページ）



7.5 スクリプトの実行

Eclipse からスクリプトを実行するには


2. ターゲットへの接続を設定します。 DS-5 デバッガコンフィギュレーションに

は、デバッガがターゲットに接続したらすぐにスクリプトファイルを行するオプションを含めることができます。これを行うには、［DS-5 Debug configuration］ダイアログボックスの［Debugger］タブでスクリプトファイを選択します。

3. ターゲットに接続します。

4. デバッグセッションが進行している間にスクリプトファイルを実行するには

a. ［Scripts］ビューをクリックします。

b. 1 つまたは複数のスクリプトファイルを実行する順序でインポートしま

す。

c. 実行するスクリプトを選択します。

d. ［Execute Selected Scripts］ツールバーアイコンをクリックします。

図 7-2 ［Scripts］ビュー

あるいは、 DS-5 デバッガの source コマンドを使用することもできます。

7.5.1 関連項目

タスク


• デバッグセッションで生成された DS-5 デバッガコマンドのエクスポート

（7-2 ページ）


• DS-5 デバッガスクリプトの作成（7-3 ページ）

• CMM スタイルのスクリプトの作成（7-7 ページ）


参照


• 第 3 章ターゲットの設定と接続





— source （2-203 ページ） .



7.6 Eclipse での Jython プロジェクトの設定

Eclipse を使用して Jython スクリプトを作成または編集できます。 Eclipse for DS-5 は、

Jython に対してオートコンプリート機能と組み込みのドキュメンを提供します。

Jython プロジェクトを設定するには、以下の手順を実行します。

1. 新規プロジェクトを作成します。

a. メインメニューから［ファイル］ → ［新規］ → ［プロジェクト ...］を選択

します。

b. ［PyDev］グループを展開します。

c. ［PyDev プロジェクト］を選択します。

d. ［Next］をクリックします。

図 7-3 PyDev プロジェクトウィザード

e. プロジェクトに適切な名前を入力します。

f. プロジェクトのタイプとして［Jython］を選択します。

g. インタープリタとして［DS-5 Jython］を選択します。

h. ［終了］をクリックしてプロジェクトを作成します。



図 7-4 PyDev プロジェクト設定

i. 初めて PyDev プロジェクトを作成すると、 Python インタープリタが設定

されていないことを通知するダイアログボックスが表示されます。しか

し、 Jython は設定されているのでこのメッセージは無視して構いません。［次回から通知しない］をクリックして続行します。

図 7-5 Python インタープリタの警告ダイアログボックス

2. または、 Jython の既存のプロジェクトを設定できます。

a. ［プロジェクトエクスプローラ］ビュー内のプロジェクトを右クリックして、コンテキストメニューから［PyDev］ → ［PyDev プロジェクトとして

設定］を選択します。

b. Python が設定されていないことを通知するダイアログボックスが表示され

たら、［次回から通知しない］をクリックします。

c. ［Project］メニューから、［Properties］を選択します。

d. ［プロパティ］ダイアログボックスで［PyDev - インタープリタ / グラ

マー］を選択します。

e. プロジェクトのタイプとして［Jython］を選択します。

f. インタープリタとして［DS-5 Jython］を選択します。

g. ［OK］をクリックしてこれらの設定を適用し、ダイアログボックスを閉

じます。



3. プロジェクトに Python ソースファイルを追加します。スクリプトの種類を区別

するため、 .py ファイル拡張子を使用する必要があります。

7.6.1 関連項目

タスク





— 新しい C プロジェクトまたは C++ プロジェクトの作成（3-4 ページ）

— 既存の Eclipse プロジェクトのインポート（3-8 ページ）

— プロジェクトへの新しいソースファイルの追加（3-17 ページ） .

参照





第 8 章実行時メッセージの制御

以下の各トピックでは、セミホスティングと実行時メッセージの制御方法について説明します。

タスク

• セミホスティングの使用（8-4 ページ）

• デバッガでの自動セミホスティングサポートの有効化（8-5 ページ）

• コマンドラインコンソールを使用したセミホスティングメッセージの制御（8-6 ページ）

• ログメッセージの出力の制御（8-7 ページ）

• デバッガからのログメッセージの出力のカスタマイズ（8-9 ページ） .

概念 • セミホスティングと top of memory について（8-2 ページ）

• log4j コンフィギュレーションファイルについて（8-8 ページ） .


実行時メッセージの制御

8.1 セミホスティングと top of memory について

通常、セミホスティングが使用されるのは、 C ライブラリを使用しながら、オペ

レーティングシステムなしで実行されているアプリケーションのバッグ時です。これ

により、 printf() や scanf() などの C ライブラリの関数で、ターゲットシステム上の

画面やキーボードではなく、ホストワークステーション上の画面やキーボードが使用できようになります。

セミホスティングでは、スタックベースとヒープベースアドレスを使用して、スタックおよびヒープの場所とサイズを決定します。

スタックベース（top of memory とも呼ばれます）は、デフォルトでヒープベースの

終点から 64K のアドレスです。

ヒープベースはデフォルトで連続するアプリケーションコードです。

以下の図は、 ARM® ターゲットの標準的なレイアウトを示しています。

図 8-1 メモリ、スタック、ヒープ間の標準的なレイアウト

8.1.1 関連項目

タスク • セミホスティングの使用（8-4 ページ）


• コマンドラインコンソールを使用したセミホスティングメッセージの制御（8-6 ページ） .

参照



ZI

RW

RO+RW

0xFFFFFFFF

0x00000000




— set semihosting （2-166 ページ）

— show semihosting （2-192 ページ） .



8.2 セミホスティングの使用

セミホスティングは、コマンドラインコンソールと Eclipse の両方のデバッガでサ

ポートされています。

コマンドラインコンソール

デフォルトでは、すべてのセミホスティングメッセージ（stdout および stderr）がコンソールに出力されます。このコンソールをインタラク

ティブにデバッガコマンドと使用する場合は、 stdin コマンドを使用し

て、入力メッセージ（stdin）をアプリケーションに送信する必要があり

ます。

あるいは、コンソールのセミホスティングを無効にし、別の Telnet セッ

ションを使用してアプリケーションと直接やりとりします。起動時に、

デバッガはセミホスティングサーバソケットを作成し、 Telnet セッショ

ン時に使用するポート番号を表示します。

Eclipse DS-5 デバッグパースペクティブ内のアプリケーションコンソール

ビューは、アプリケーションコードとデバッガの間のすべてのセミホスティング出力要求（stdin、 stdout、および stderr）を制御します。

8.2.1 関連項目

タスク • デバッガでの自動セミホスティングサポートの有効化（8-5 ページ）


概念 • セミホスティングと top of memory について（8-2 ページ） .

参照 • ［App Console］ビュー（10-3 ページ）






8.3 デバッガでの自動セミホスティングサポートの有効化

デフォルトでは、セミホスティングサポートはデバッガで有効になっていません。ただし、別関数に対するエイリアスを持つ C コードで、特殊なセミホスティング関数

である __auto_semihosting(void) を作成できます。これにより、デバッグ情報に必須シ

ンボルが配置されますが、メインのアプリケーションイメージに必須シンボルは配置されせん。デバッガがそのシンボルを検出すると、ターゲットでサポートされてい

れば、セミホスティング操作が自動的に有効化されます。

注 ARM コンパイラ 5.0 以降を使用してアプリケーションイメージを作成する場合は、

特殊なセミホスティング関数を作成する必要はありません。必要に応じて、リンカに

よってセミホスティングシンボルが自動的に追加されます。

例 8-1 別の関数へのエイリアスを使用した特殊なセミホスティング関数の作成

#include <stdio.h>void __auto_semihosting(void) __attribute__((alias("main")));

//main() のエイリアスとしてマークして宣言 // デバッグ情報のみのセミホスティングシンボル

int main(void){

printf("Hello world\n");return 0;

}

8.3.1 関連項目

タスク • セミホスティングの使用（8-4 ページ）









8.4 コマンドラインコンソールを使用したセミホスティングメッセージの制御

アプリケーションコードからデバッガを実行するホストワークステーションへの入出力要求を制御できます。これらは「セミホスティングメッセージ」と呼ばれます。

デフォルトでは、すべてのメッセージがコマンドラインコンソールに出力されますが、以下のコマンドを使用することでデバッガを起動するとき、それらのメッセージを転送するよう選択できます。

--disable_semihosting

すべてのセミホスティング操作を無効にします。

--disable_semihosting_console

デバッガコンソールに対するすべてのセミホスティング操作を無効にします。

--semihosting_error=filename

セミホスティング操作で stderr を書き込むファイルを指定します。

--semihosting_input=filename

セミホスティング操作で stdin を読み出すファイルを指定します。

--semihosting_output=filename

セミホスティング操作で stdout を書き込むファイルを指定します。

8.4.1 関連項目

タスク • セミホスティングの使用（8-4 ページ） .


参照 • コマンドラインコンソールからのデバッガの起動（2-7 ページ） .



8.5 ログメッセージの出力の制御

デバッガからのログメッセージを制御できます。デフォルトでは、すべてのメッセー

ジがコンソールビューに出力されますが、以下の log config および log file デバッガ

コマンドを使用することで、ログメッセージの出力および転送を制御できます。

log config=option

デバッガから実行時メッセージを出力するログコンフィギュレーションのタイプを指定します。


option 定義済みのログコンフィギュレーションまたはユーザ定義の

ログコンフィギュレーションファイルを指定します。

info 定義済みの INFO レベル設定を使用する出力メッ

セージ。これがデフォルトです。

debug 定義済みの DEBUG レベル設定を使用する出力メッ

セージ。

filename メッセージの出力をカスタマイズするユーザ定義の

ログコンフィギュレーションファイルを指定します。デバッガは log4j コンフィギュレーショファイルをサ

ポートします。

log file=filename

コンソールだけでなく、ファイルへメッセージを出力します。

8.5.1 関連項目

タスク • デバッガからのログメッセージの出力のカスタマイズ（8-9 ページ） .

参照 • ［Commands］ビュー（10-20 ページ）


— log config （2-122 ページ）

— log file （2-123 ページ） .

その他の情報 • Apache Web サイトの log4j ログサービス , http://logging.apache.org



8.6 log4j コンフィギュレーションファイルについて

ほとんどのデバッグタスクは通常、デバッガによって提供された定義済みのログコンフィギュレーションで十分です。ただし、より厳密に制御する場合は、 log4j コン

フィギュレーションファイルを作成することで、カスタマイズされた独自のログコンフィギュレーションを指定できます。 log4j は Java プラットフォームのオープン

ソースログシステムであり、デバッガは現在、バージョン 1.2 を使用しています。

log4j はログレベルの階層を使用してレベルごとにメッセージを制御し、下のレベル

をすべて継承します。以下のログレベルは現在、デバッガによってサポートされてい

ます。

• DEBUG• INFO• WARN• ERROR• FATAL

メッセージは特定のログレベルに割り当てられ、 1 つまたは複数の以下の log4j コン

ポーネントを使用してさまざまな出力場所に転送できます。

8.6.1 関連項目

タスク • ログメッセージの出力の制御（8-7 ページ）

• デバッガからのログメッセージの出力のカスタマイズ（8-9 ページ） .


表 8-1 log4j コンポーネント

コンポーネント説明

Logger ログのレベルを定義します。

Appender 出力先を定義します。

Layout メッセージの形式を定義します。



8.7 デバッガからのログメッセージの出力のカスタマイズ

カスタマイズされた log4j コンフィギュレーションファイルを作成するには

1. 必須ログタイプの Appender インスタンスを作成します。以下のタイプがサポー

トされています。

• ConsoleAppender

• RollingFileAppender.

2. 必要に応じて、 Threshold ログレベルを抑制します。

3. Appender インスタンスをファイルに出力する場合は、 Appender インスタンスのレ

イアウトを定義します。以下のレイアウトがサポートされています。

PatternLayout テキスト形式

HTMLLayout HTML 形式

4. Appender インスタンスをファイルに出力する場合は、ファイルコンポーネント

を定義します。以下のコンポーネントがサポートされています。

File ファイル名

MaxFileSize long 整数または文字列（10KB）。

MaxBackupIndex 使用するログファイルの大数。デフォルトは 1 です。

5. レイアウト PatternLayout を使用する場合、追加の ConversionPattern コンポーネ

ントを使用してメッセージの形式を拡張できます。以下のパターンがサポート

されています。

%c ログカテゴリ

%C クラス名

%d 日付

%F ファイル名

%l 呼び出し元の場所

%L 行番号

%m ログメッセージ

%M メソッド名

%n 行末文字

%p ログレベル。アライメントの場合、文字数を指定することもできます（%-5p など）。

%r 経過時間（ミリ秒）

%t スレッド名

6. 必要に応じて、 Appender インスタンスの name コンポーネントを定義します。

7. rootLogger のログレベルを定義し、必須の Appender インスタンスに割り当てま

す。

8. log4j コンフィギュレーションファイルをデバッガに渡す場合は、以下のコマン

ドを使用できます。

• コマンドラインコンソールからデバッガを起動する場合は、--log_config=filename コマンドラインオプション

• デバッガが既に実行されている場合は、log config filename デバッガコマン

ド



8.7.1 コンソールへのメッセージのログ方法を示す例

以下の例は、コンソールへのメッセージのログ方法を示します。この例では、デフォ

ルトのログレベルを DEBUG に設定します。この例のすべてのグはコンソールに出力

されます。ただし、エラーおよび警告のメッセージの出力はエラーストリームに送信

され、デバッグおよび情報メッセーは出力ストリームに送信されます。

例 8-2 コンソールへのメッセージのログ

# logConsole を ConsoleAppender に設定log4j.appender.logConsole=org.apache.log4j.ConsoleAppenderlog4j.appender.logConsole.layout=org.apache.log4j.PatternLayoutlog4j.appender.logConsole.layout.ConversionPattern=%m%nlog4j.appender.logConsole.name=Console

# すべての DEBUG レベルのログをコンソールに送信log4j.rootLogger=DEBUG, console

8.7.2 ファイルへのメッセージのログ方法を示す例

以下の例は、ファイルへのメッセージのログ方法を示します。この例では、デフォル

トのログレベルを DEBUG に設定します。ただし、一部のパッージは INFO レベルで

のみログを書き込みます。この例のすべてのログはファイルに出力されます。ファイ

ルが 10MB に達すると、.1 ファイル拡張子を追加して名前が変更され、元の名前で新

しいファイルにログが引き続き書き込まれます。これは何度も発生しますが、保存さ

れるバックアップファイルは 10 個だけです。

例 8-3 ファイルのメッセージのログ

# logFile を RollingFileAppender に設定log4j.appender.logFile=org.apache.log4j.RollingFileAppenderlog4j.appender.logFile.File=output.loglog4j.appender.logFile.MaxFileSize=10MBlog4j.appender.logFile.MaxBackupIndex=10log4j.appender.logFile.layout=org.apache.log4j.PatternLayoutlog4j.appender.logFile.layout.ConversionPattern=%d %-5p %t %c - %m%n

# すべての DEBUG レベルのログをファイルに送信 : logFilelog4j.rootLogger=DEBUG, logFile

# デバッグパッケージ内のすべての INFO レベルのログをファイルに送信 : logFilelog4j.logger.com.arm.debug.logging=INFO, logFile

8.7.3 コンソールおよびファイルへのメッセージのログを組み合わせる方法を示す例

以下の例は、前の例の組み合わせを示しています。この例では、デフォルトのログレ

ベルを INFO に設定します。この例のすべての INFO レベルのグはコンソールに出力

されます。ただし、メッセージの選択も出力を 2 つのファイルに送信します。



例 8-4 ログメッセージの組み合わせ

# logConsole を ConsoleAppender に設定log4j.appender.logConsole=org.apache.log4j.ConsoleAppender# しきい値より低いコンソールへのすべてのログを抑制log4j.appender.logConsole.Threshold=INFOlog4j.appender.logConsole.layout=org.apache.log4j.PatternLayoutlog4j.appender.logConsole.layout.ConversionPattern=%m%nlog4j.appender.logConsole.name=Console

# logConnFile を RollingFileAppender に設定log4j.appender.logConnFile=org.apache.log4j.RollingFileAppender# しきい値より低いファイルへのすべてのログを抑制log4j.appender.logConnFile.Threshold.DEBUGlog4j.appender.logConnFile.File=connection.loglog4j.appender.logConnFile.MaxFileSize=10MBlog4j.appender.logConnFile.MaxBackupIndex=10log4j.appender.logConnFile.layout=org.apache.log4j.PatternLayoutlog4j.appender.logConnFile.layout.ConversionPattern=%d %-5p %t %c - %m%n

# logTAccessFile を RollingFileAppender に設定log4j.appender.logTAccessFile=org.apache.log4j.RollingFileAppender# しきい値より低いファイルへのすべてのログを抑制log4j.appender.logTAccessFile.Threshold.DEBUGlog4j.appender.logTAccessFile.File=target_acccess.loglog4j.appender.logTAccessFile.MaxFileSize=10MBlog4j.appender.logTAccessFile.MaxBackupIndex=10log4j.appender.logTAccessFile.layout=org.apache.log4j.PatternLayoutlog4j.appender.logTAccessFile.layout.ConversionPattern=%d %-5p %t %c - %m%n

# すべての INFO ログをコンソールに送信log4j.rootLogger=INFO, logConsole

# 接続パッケージ内のすべての DEBUG ログをファイルに送信 : logConnFilelog4j.logger.com.arm.debug.core.engine.connection=DEBUG, logConnFile

# ターゲットアクセスパッケージ内のすべての DEBUG ログをファイルに送信 : logTAccessFilelog4j.logger.com.arm.debug.core.targetaccess.rvi=DEBUG, logTAccessFile

8.7.4 関連項目

タスク • ログメッセージの出力の制御（8-7 ページ） .

概念 • log4j コンフィギュレーションファイルについて（8-8 ページ） .







第 9 章スナップショットビューアの使用

以下の各トピックでは、スナップショットビューアの使用方法について説明します。

タスク • スナップショットビューアの初期化ファイルの作成（9-2 ページ）

• スナップショットビューアへの接続（9-8 ページ） .

概念

• スナップショットビューアについて（9-5 ページ）

• スナップショットビューアのデバッガスクリプト作成時の注意事項（9-9 ページ）


スナップショットビューアの使用

9.1 スナップショットビューアの初期化ファイルの作成

スナップショットビューアの初期化ファイルは、元のシステムの状態をエミュレートする 1 つまたは複数のセクションから構成される単純なテキトファイルです。各セ

クションは、 option=value 構造を使用します。

注ファイル拡張子として .ini を使用する必要があります。

9.1.1 前提条件

スナップショットビューアの初期化ファイルを作成する前に、以下のものが揃っていることを確認する必要があります。

• 解析するアプリケーションのスナップショットを含む 1 つまたは複数のバイナ

リファイル

注以下の制限に従ってバイナリファイルを正しくフォーマットする必要がありま

す。

• プロセッサの種類の詳細

• メモリ領域アドレスおよびオフセット値の詳細

• 新の既知のレジスタ値の詳細

9.1.2 手順

スナップショットビューアの初期化ファイルを作成するには、必要に応じて以下のリストからグループ化したセクションを追加する必要があります。

[global] グローバル設定のセクション。以下のオプションを使用できます。

core 選択したプロセッサ（core=Cortex-M3 など）。

[dump] バイナリファイルに格納された連続するメモリ領域の 1 つまたは

複数のセクション。以下のオプションを使用できます。

file バイナリファイルの場所。

address 指定された領域のメモリ開始アドレス。

length 領域の長さ。何も指定しない場合、デフォルトはオフ

セット値から残りのファイルです。

offset ファイルの先頭から指定された領域のオフセット。指定

しない場合、デフォルトはゼロです。

[regs] 標準の ARM® レジスタ名および値のセクション（R0=0x0 など）。

バンクレジスタは、『ARM アーキテクチャリファレンスマニュア

ル』に記載されている名前（R13_fiq など）を使用して明示的に指

定できます。さらに、現在のモードはプログラムステータスレジ

スタ（PSR）から決定され、モード接尾文字なしのレジスタ名だ

けで適切なバンクレジスタとして認識されます。

PSR および PC レジスタの値は常に指定する必要があります。その

他のレジスタについては、デバッガから読み出す場合のみ、それらの値が必要にります。

例えば、以下のような場合です。



[regs]CPSR=0x600000D2 ; IRQSP=0x8000R14_irq=0x1234

SP、 R13、または R13_irq という名前のレジスタを読み出すと、

すべてが値 0x8000 を返します。

LR、 R14、または R14_irq という名前のレジスタを読み出すと、

すべてが値 0x1234 を返します。

注すべてのレジスタは 32 ビットです。

9.1.3 制限

以下の使用制限があります。

• グローバルセクションが必要な場合は、グローバルセクションをファイル内の先頭に置く必要があります。

• メモリの連続したバイトは、 1 つまたは複数のダンプファイル内にも連続した

バイトとして現れる必要があります。

• メモリ領域を表すアドレス範囲は重複してはなりません。

9.1.4 例

例 9-1 スナップショットビューアの初期化ファイル

; すべてのセクションはオプションです

[global]core=Cortex-M3 ; 選択されたプロセッサ

; ダンプファイルに格納された連続するメモリ領域の場所[dump]file="path/dumpfile1.bin" ; ファイルの場所（フルパスを指定する必要があります）

address=0x8000 ; 特定の領域のメモリ開始アドレス

length=0x0090 ; 領域の長さ

; （オプション、デフォルトはオフセットからの残りのファイル）

; ダンプファイルに格納された連続するメモリ領域の場所[dump]file="path/dumpfile2.bin" ; ファイルの場所

address=0x8090 ; 特定の領域のメモリ開始アドレス

offset=0x0024 ; ファイルの先頭からの領域のオフセット

; （オプション、デフォルトは 0 です）

; ARM レジスタ[regs]R0=0x000080C8R1=0x0007C000R2=0x0007C000R3=0x0007C000R4=0x00000363R5=0x00008EEC



R6=0x00000000R7=0x00000000R8=0x00000000R9=0xB3532737R10=0x00008DE8R11=0x00000000R12=0x00000000SP=0x0007FFF8LR=0x0000808DPC=0x000080B8

9.1.5 関連項目

タスク


• スナップショットビューアへの接続（9-8 ページ）

• スナップショットビューアのデバッガスクリプト作成時の注意事項（9-9 ペー

ジ） .

概念


参照 • コマンドラインコンソールからのデバッガの起動（2-7 ページ）


（2-13 ページ）

• 『ARM アーキテクチャリファレンスマニュアル』 , http://infocenter.arm.com/help/topic/com.arm.doc.set.architecture



9.2 スナップショットビューアについて

スナップショットビューアを使用すると、インタラクティブデバッグが使用できないシナリオにおけるアプリケーション状態のスナップショット解析できます。スナッ

プショットビューアを使用したアプリケーションのデバッグを有効にするには、以下のデータが必要です。

• レジスタ値

• メモリ値

• デバッグシンボル

このすべてのデータを用意できないと、使用可能なデバッグのレベルが低下します。このデータのキャプチャはアプリケーション固有であり、このためのツールは用意されていません。例外ハンドラまたは信号ハンドラをインストールして、アプリケー

ションのエラー状況を見つけ、必要なデータをダンプする必要がある場合があります。

また、ダンプしたデータをデバイスからデバッガがアクセス可能なワークステーション上に取得する方法についても考慮する必要があります。この方法についてのい

くつかの提案を以下に示します。

• セミホスティングを使用してデータをホストワークステーション上のファイルに書き込みます。

• UART を介して端末にデータを送信します。

• TCP/IP を使用してソケットを介してデータを送信します。

9.2.1 レジスタ値

レジスタ値は、ある時間の特定ポイントでのシステムの状態をエミュレートするために使用されます。も重要なレジスタは現在のプロセッサモードのレジスタです。例えば、 ARMv4 アーキテクチャプロセッサでは、これらのレジスタは R0-R15 と以

下のプログラムステータスレジスタ（PSR）です。

• カレントプログラムステータスレジスタ（CPSR）• アプリケーションプログラムステータスレジスタ（APSR）• セーブドプログラムステータスレジスタ（SPSR）

多くの ARM® プロセッサでは、例外（データアボート）が発生すると、別のプロ

セッサモードに切り替わることに注意して下さい。この場合、使用するレジスタ値

は、例外ハンドラ内のレジスタ値ではなく、例外を起こした正しいモードを反映することを確認する必要があります。

また、アプリケーションで浮動小数点データが使用されており、デバイスにベクタ浮動小数点ハードウェアがある場合は、スナップショットビュアにベクタ浮動小数点レジスタの内容を指定する必要があります。キャプチャする重要なレジスタを以下

に示します。

• 浮動小数点ステータスおよび制御レジスタ（FPSCR）• 浮動小数点例外レジスタ（FPEXC）• 単精度レジスタ（Sn）• 倍精度レジスタ（Dn）• 4 倍精度レジスタ（Qn）



9.2.2 メモリ値

大半のアプリケーション状態は通常、グローバル変数、ヒープ、およびスタックの形式でメモリに格納されます。サイズの制約のために、スナップショットビューアに

メモリ内容全体をコピーするのが難しいことがあります。このような場合、特に重要

なメモリ領域を慎重に検討する必要があります。

クラッシュをデバッグする場合に、クラッシュの要因を見つけ出すのに有用な情報はコールスタックであることが多いです。コールスタックは、応するすべての関数パラメータの値や例外以前の各関数の呼び出しシーケンスを示すためです。コールス

タックを表示するには、デバッガが現のスタックポインタを認識しており、スタックを含むメモリの内容にアクセスできる必要があります。デフォルトでは、 ARM プロセッサではスタックが下方に展開されるので、現在のスタックポインタから開始し、スタックの開始位置に達するまでメモリ内を上方に向かって展開するメモリ用意する必要があります。スタックの内容全体を指定できない場合でも、近の関数呼

び出しが分かるため、現在のスタックポインタから始ま一部分でも有効です。

アプリケーションでグローバル（extern またはファイル static）データを使用してい

る場合は、対応するメモリ値を指定するとデバッガ内の変数を表示できます。

ヒープデータを指すローカルまたはグローバル変数がある場合は、デバッガの関連ポインタに従ってデータを検証することが必要になる場合があります。これを行うに

は、スナップショットビューアにヒープの内容を指定しておく必要があります。ヒー

プはメモリの広い範囲を占有してしまうことがあり、ヒープ全体をキャプチャできないことがあるので注意して下さい。メモリ内のヒープのレイアウトとヒープ割り当

てを制御するデータ構造は、アプリケーションまたは C ライブラリ固有である場合

があるので、詳細については、関連のマニュアルを参照して下さい。

逆アセンブリレベルでデバッグするには、アプリケーションコードが配置されているメモリ値にデバッガからアクセスできる必要があります。通常はコードを含むメモ

リの内容をキャプチャする必要はありません。これは、多くの場合、 fromelf などの

処理ツールを使用して同じデータをイメージから直接抽出できるからです。ただし、

以下のような複雑な状況に注意して下さい。）

• イメージおよびメモリ内の値が変わる可能性がある自己変更型コード

• 実行時のイメージ内でのメモリアドレスのダイナミックな再配置

9.2.3 デバッグシンボル

デバッガには、以下のようなアプリケーションに関する高レベルの情報を表示するために、デバッグ情報が必要です。

• ソースコード

• 変数の値と型

• 構造体

• コールスタック

この情報はコンパイラおよびリンカによってアプリケーションイメージ内に格納されるので、デバイス上で実行されている同じイメージのローカデバッグコピーがあることを確認する必要があります。イメージに格納されるデバッグ情報の量、そして

デバッグセッションの結果として生じ品質は、コンパイラおよびリンカに渡されるデバッグおよび適化の設定による影響を受ける可能性があります。

組み込みデバイスでイメージを実行するときは通常、できる限り多くのデバッグ情報を取り除きます。このような場合、デバッグ時はデバッグ情報を取り除く前のイ

メージを使用して下さい。



9.2.4 関連項目

タスク


• スナップショットビューアの初期化ファイルの作成（9-2 ページ）


ジ） .



9.3 スナップショットビューアへの接続

スナップショットビューアには、デバッガを使用して既知のシステム状態のスナップショットの解析のために使用する仮想ターゲットが用意されいます。

9.3.1 前提条件

接続する前に、ある時間の特定時点でのターゲットに関する静的情報が記載されたスナップショットビューアの初期化ファイルが準備されているとを確認してください。例えば、レジスタの内容、メモリ、プロセッサ状態などです。

9.3.2 手順

--target コマンドラインオプションを使用してコマンドラインコンソールでデバッガ

を起動し、スナップショットビューアの初期化ファイルをデバッガに渡します。 :

debugger --target=int.ini --script=int.cmm

9.3.3 関連項目

タスク


• スナップショットビューアの初期化ファイルの作成（9-2 ページ）


ジ） .

概念




（2-13 ページ） .



9.4 スナップショットビューアのデバッガスクリプト作成時の注意事項

スナップショットビューアは、元のシステムの状態をエミュレートする初期化ファイルを使用します。シンボルは、/nocode /noreg 引数を指定した data.load.elf コマンド

を使用してイメージからロードされます。

スナップショットデータおよびレジスタは読み出し専用なので、使用できるコマンドは限定されます。

以下の例は、 CMM 形式のコマンドを使用して、 types_m3.axf イメージの内容を解析

するスクリプトを示しています。

例 9-2 CMM 形式のスクリプトファイル

var.print "Connect and load symbols:"system.updata.load.elf "types_m3.axf" /nocode /noreg

;配列と配列のポインタvar.print ""var.print "Arrays and pointers to arrays:"var.print "Value of i_array[9999] is " i_array[9999]var.print "Value of *(i_array+9999) is " *(i_array+9999)var.print "Value of d_array[1][5] is " d_array[1][5]var.print "Values of *((*d_array)+9) is " *((*d_array)+9)var.print "Values of *((*d_array)) is " *((*d_array))var.print "Value of &d_array[5][5] is " &d_array[5][5]

; レジスタ PC 内のアドレスから 0x100 バイトを表示var.print ""var.print "Display 0x100 bytes from address in register PC:"data.dump r(PC)++0x100

;構造とビットフィールドvar.print ""var.print "Structures and bit-fields:"var.print "Value of values2.no is " values2.novar.print "Value of ptr_values->no is " ptr_values->novar.print "Value of values2.name is " values2.namevar.print "Value of ptr_values->name is " ptr_values->namevar.print "Value of values2.name[0] is " values2.name[0]var.print "Value of (*ptr_values).name is " (*ptr_values).namevar.print "Value of values2.f1 is " values2.f1var.print "Value of values2.f2 is " values2.f2var.print "Value of ptr_values->f1 is " ptr_values->f1

var.print ""var.print "Disconnect:"system.down

9.4.1 関連項目

タスク



• スナップショットビューアの初期化ファイルの作成（9-2 ページ） .



概念




（2-13 ページ） .


第 10 章 DS-5 デバッグパースペクティブおよびビュー

以下の各トピックでは、 Eclipse 総合開発環境（IDE）の DS-5 デバッグパースペクティ

ブおよび関連ビューについて説明します。





• C/C++ エディタ（10-14 ページ）

• イベントビューアのチャネルエディタ（10-18 ページ）














DS-5 デバッグパースペクティブおよびビュー



• ［Export memory］ダイアログボックス（10-64 ページ）

• ［Import memory］ダイアログボックス（10-66 ページ）



• ［Watchpoint properties］ダイアログボックス（10-75 ページ）

• ［トレースポイントのプロパティ］ダイアログボックス（10-76 ページ）

• ［Manage Signals］ダイアログボックス（10-77 ページ）






• ［Debug Configurations］ - ［Event Viewer］タブ（10-101 ページ）

• DS-5 デバッガメニューとツールバーアイコン（10-104 ページ）


— ［Remote Systems］ビュー（5-3 ページ）

— ［Remote System Details］ビュー（5-5 ページ）

— ［Remote Scratchpad］ビュー（5-7 ページ）

— ［Terminals］ビュー（5-8 ページ） .



10.1 ［App Console］ビュー

このビューでは、 ARM® C ライブラリでのセミホスティングの実装によって提供され

るコンソール I/O 機能を使用できます。この機能を使用するには、セミホスティング

ポートをデバッガで有効にする必要があります。

図 10-1 ［App Console］ビュー

注このビューのデフォルト設定は、［Preferences］ダイアログボックスの DS-5 デバッガ

設定によって制御されます。例えば、特定ファイルのデフォルの場所または表示する

大行数などがあります。これらの設定にアクセスするには、［Window］メニューの

［Preferences...］を選択します。

10.1.1 ツールバーとコンテキストメニューのオプション

ツールバーまたはコンテキストメニューには、以下のオプションが用意されています。

［Linked ： context］

このビューを［Debug Control］ビューで選択した接続にリンクします。これがデフォルトです。または、ビューを特定の接続にリンクすること

もできます。リンクする接続がドロップダウンリストに表示されていな

い場合は、まず［Debug Control］ビューで接続を選択する必要がありま

す。

［Save Console Buffer］

［Semihosting Console］ビューの内容をテキストファイルに保存します。

［Clear Console］

［Semihosting Console］ビューの内容をクリアします。

［Scroll Lock］［Semihosting Console］ビューのメッセージの自動スクロールを有効ま

たは無効にできます。



［View Menu］このメニューは以下のオプションから構成されています。

［New App ConsoleView］［App Console］ビューの新しいインスタンスを表示します。

［Bring to Front for Write］有効にすると、セミホスティングアプリケーションが入力を確認したときに、デバッガはフォーカスを自動的にこのビューに変更します。

［Copy］選択したテキストをコピーします。

［Paste］以前にコピーしたテキストを貼り付けます。アプリケーションがセミホ

スティングプロンプトを表示時にのみ、テキストを貼り付けることができます。

［Select All］すべてのテキストを選択します。

10.1.2 関連項目

タスク

• セミホスティングの使用（8-4 ページ）


• 『ARM DS-5 ： Eclipse の使用』：


概念


参照 • ［Target］ビュー（10-55 ページ）






10.2 ［ARM Asm Info］ビュー

このビューでは、 ARM® または Thumb® の命令やディレクティブの詳細情報を表示で

きます。

ARM アセンブラエディタを使ってアセンブリ言語ソースファイル（.s）を編集して

いる場合は、以下の操作を実行して詳細情報にアクセスできます。

1. 命令またはディレクティブを選択します。

2. F3 を押します。

関連ドキュメントが［ARM Asm Info］ビューに表示されます。 F3 を押すと、［ARM Asm Info］ビューが自動的に表示されます。

図 10-2 ［ARM Asm Info］ビュー

このビューを手動で追加するには、以下の手順に従います。


2. ［Window］ → ［Show View］ → ［Other...］を選択して［Show View］ダイアログ

ボックスを開きます。

3. ［DS-5 デバッガ］グループから［ARM Asm Info］ビューを選択します。

10.2.1 関連項目

タスク



参照 • ARM アセンブラエディタ（10-6 ページ）






10.3 ARM アセンブラエディタ

ARM® アセンブラエディタには、構文の強調表示、コード書式、 ARM アセンブリ言

語ソースファイルのラベルに対するコンテンツアシスタンス機能などあります。この

エディタを使用すると、以下を実行できます。

• ソースコードを編集します。

• 構文ハイライトを表示します。 • 命令またはディレクティブを選択して F3 を押し、関連 ARM アセンブラリファ

レンス情報を表示します。

• 自動補完コンテンツアシストを使用します。

• ブレークポイントを作成、削除、イネーブルまたはディセーブルします。

図 10-3 ARM アセンブラエディタ

各エディタタブの左余白には、ソースコード内の特定の行に関連付けられたビューのマーカを表示するマーカバーがあります。

ブレークポイントを設定するには、ブレークポイントを設定する位置のマーカバーをダブルクリックします。ブレークポイントを削除するには、ブレークポイントマー

カをダブルクリックします。



10.3.1 アクションコンテキストメニューのオプション

マーカーバーか、表示されている場合は行番号の列を右クリックして、 ARM アセン

ブラエディタのアクションコンテキストメニューを表示します。使用可能なオプショ

ンには、以下のものがあります。

［DS-5 Breakpoints］メニュー

以下のブレークポイントオプションが用意されています。

［Toggle Breakpoint］新しいブレークポイントを追加するか、選択したブレークポイントを削除します。

［Disable Breakpoin］、［Enable Breakpoint］選択したブレークポイントを無効または有効にします。

［Breakpoint Properties...］選択したブレークポイントの［Breakpoint Properties］ダイアロ

グボックスを表示します。これを使用すると、ブレークポイン

トのアクティブ化を制御できます。

［Toggle Trace Start Point］選択したアドレスのトレースの起点を設定または削除します。

［Toggle Trace Stop Point］選択したアドレスのトレースの終点を設定または削除します。

［Toggle Trace Trigger Point］選択したアドレスのトレースのトリガポイントを開始します。

［Default Breakpoint Type］


［C/C++ Breakpoints］ C/C++ パースペクティブブレークポイント方式を使用する場

合に選択します。

［DS-5 C/C++ Breakpoint］ DS-5 デバッグパースペクティブブレークポイント方式を使用

する場合に選択します。 DS-5 デバッグパースペクティブの場

合はこれがデフォルトで。

青色の C/C++ パースペクティブブレークポイントマーカと区

別するために、 DS-5 ブレークポイントマーカは赤色です。

注［Default Breakpoint Type］を選択すると、このコンテキストメニューの

上位の［Toggle Breakpoint］メニューが表示されるので、左辺ルーラ

をダブルクリックして、 CDT ブレークポイントまたは DS-5 ブレークポ

イントのいずれかに切り替えます。このメニューは、 C/C++、 Debug、お

よび DS-5 デバッグパースペクティブの上部にあるメインメニューバー

の［Run］メニューから利用することもできます。

［DS-5 Breakpoints］のメニューオプションは、この設定を実行しないで DS-5 ブレークポイントを必ず参照します。



［Show Line Numbers］

行番号を表示したり非表示にしたりします。

ここに記載されていない他のオプションについては、ダイナミックヘルプを参照してください。

10.3.2 関連項目

タスク




— ソースコードの編集（2-28 ページ）


参照 • ［ARM Asm Info］ビュー（10-5 ページ）






10.4 ［Breakpoints］ビュー

このビューを使用すると、以下を実行できます。

• ブレークポイントおよびウォッチポイントをディセーブル、イネーブル、または削除します。

• ブレークポイントおよびウォッチポイントの一覧をインポートまたはエクスポートします。

• 選択したブレークポイントが設定されたコード行を含むソースファイルを表示します。

• 選択したブレークポイントが設定された位置の逆アセンブリを表示します。

• 選択したウォッチポイントが設定されているメモリを表示します。

• ブレークポイントのプロパティを設定してブレークポイントのアクティブ化を遅らせます。

• すべての Unix シグナルおよびプロセッサ例外ハンドラのメッセージの処理と

メッセージの出力を制御します。

• 選択したウォッチポイントのアクセスタイプを変更します。

図 10-4 ［Breakpoints］ビュー

10.4.1 ブレークポイントエントリの構文

ブレークポイントエントリには以下の構文があります。

source_file:linenum @ function+offset address [#ID instruction_type, ignore = num/count, nHits hits, (condition)]


source_file:linenum

ソースファイルが利用できる場合は、ブレークポイントが設定されているファイルのファイル名および行番号（threads.c:115）。

function+offset

ブレークポイントが設定されている関数の名前および関数の開始位置からのバイト数。例えば、 accumulate()+52 は、ブレークポイントが accumulate() 関数の開始位置から 52 バイト離れていることを示します。

address ブレークポイントが設定されたアドレス。



ID ブレークポイントの ID 番号（#N）。場合によっては、 for ループ内など、

ブレークポイントが多数のサブブレークポイントで構成されている可能性があります。これらは N.n として識別されます。 N は親の数です。この

ダイアログボックスのサブブレークポイントの説明は、以下のように表示されます。

main()+132sub-breakpoint ofmain()+132 @ threads.c:56 [#14 ARM] (threads)

instruction_type

ブレークポイントのアドレスの命令タイプ（ARM または Thumb）。

ignore = num/count

設定されている場合はブレークポイントの ignore 回数。各項目には以下

の意味があります。

num は初に count で初期化され、ゼロになるまで、達するたびにデク

リメントします。

count で、ブレークポイントの ignore 回数を指定します。

nHits hits ブレークポイントに達するたびにインクリメントするカウンタ。これ

は、初めてブレークポイントに達すると表示されます。 ignore 回数を設

定した場合、 hits 回数は ignore 回数がゼロに達するまでインクリメント

を開始しません。

condition 指定した停止条件（(i==3)）。

10.4.2 ウォッチポイントエントリの構文

ウォッチポイントエントリには以下の構文があります。

name type[#ID]


name ウォッチポイントが設定された変数の名前。

type ウォッチポイントのアクセスタイプ。

ID ウォッチポイントの ID 番号。

10.4.3 トレースポイントエントリの構文

トレースポイントエントリには以下の構文があります。

source_file:linenum address


address トレースポイントが設定されたアドレス。

source_file:linenum

ソースファイルが利用できる場合は、トレースポイントが設定されているファイルのファイル名および行番号（Fireworks.c:529 0x80000A72）。









す。

［Remove］選択したブレークポイントおよびウォッチポイントを削除します。

［Remove All］すべてのブレークポイントおよびウォッチポイントを削除します。

［Go to File］選択したブレークポイントが設定されているコード行を含むソースファ

イルを表示します。ウォッチポイントではこのオプションは無効です。

［Go to Disassembly］

選択したブレークポイントが設定された位置の逆アセンブリを表示します。ウォッチポイントではこのオプションは無効です。

［Go to Memory］

選択したウォッチポイントが設定されているメモリを表示します。ブレークポイントではこのオプションは無効です。

［Skip All Breakpoints］

現在設定しているすべてのブレークポイントまたはウォッチポイントを非アクティブにします。デバッガはブレークポイントまたはウォッチポ

イントごとの有効 / 無効状態を記憶し、これらを指定したときにその状

態を復元します。

［Enable Breakpoints］

選択したブレークポイントおよびウォッチポイントを有効にします。

［Disable Breakpoints］

選択したブレークポイントおよびウォッチポイントを無効にします。

［Resolve］選択したブレークポイントまたはウォッチポイントのアドレスを再評価

します。アドレスを解決できる場合はブレークポイントまたはウォッチ

ポイントが設定され、解決できない場合は保留のまま残ります。

［Properties...］

選択したブレークポイント、ウォッチポイント、またはトレースポイントの［プロパティ］ダイアログボックスを表示します。これを使用する

と、選択したウォッチポイントのアクティブ化の制御やアクセスタイプの変更を行うことができます。

［Copy］選択したブレークポイントおよびウォッチポイントをコピーします。これを実行するには、標準キーボードショートカットも使用できます。



［Paste］コピーしたブレークポイントおよびウォッチポイントを貼り付けます。デフォルトでは、ブレークポイントまたはウォッチポイントは有効です。これを実行するには、標準キーボードショートカットも使用できま

す。

［Select all］すべてのブレークポイントまたはウォッチポイントを選択します。これ

を実行するには、標準キーボードショートカットも使用できます。

［View Menu］以下の［View Menu］オプションが用意されています。

［New Breakpoints］ビュー［Breakpoints］ビューの新しいインスタンスを表示します。

［Export Breakpoints］ブレークポイントおよびウォッチポイントの現在のリストをファイルにエクスポートします。

［Import Breakpoints］ブレークポイントおよびウォッチポイントのリストをファイルからインポートします。

［Alphanumeric Sort］ビューに表示される文字列に基づいてリストをアルファベット順にソートします。

［Ordered Sort］リストを設定した順にソートします。

［Manage Signals］［Manage Signal］ダイアログボックスを表示します。

10.4.5 関連項目

タスク













• C/C++ エディタ（10-14 ページ）






• ［Watchpoint properties］ダイアログボックス（10-75 ページ）


• ［Manage Signals］ダイアログボックス（10-77 ページ）












— set substitute-path （2-172 ページ）

— watch （2-222 ページ） .• 『ARM® DS-5™ ： Eclipse の使用』：




10.5 C/C++ エディタ

このエディタを使用すると、以下を実行できます。

• ソースコードを編集します。

• 構文ハイライトを表示します。

• C ライブラリ関数の上にマウスポインタを置いたときに対話式ヘルプを表示し

ます（例： printf()）。

• オートコンプリート機能のコンテンツアシスト（Ctrl+Space）を使用します。

• ブレークポイントを作成、削除、イネーブルまたはディセーブルします。

図 10-5 C/C++ エディタ

各エディタタブの左余白には、ソースコード内の特定の行に関連付けられたビューのマーカを表示するマーカバーがあります。



注親ブレークポイントに対するサブブレークポイントがある場合、マーカをダブルク

リックすると、関連したサブブレークポイントも削除できます



10.5.1 アクションコンテキストメニューのオプション

マーカバーか、表示されている場合は行番号の列を右クリックして、 C/C++ エディ

タのアクションコンテキストメニューを表示します。使用可能なオプションには、以

下のものがあります。

［DS-5 Breakpoints］メニュー


［Toggle Breakpoint］選択したアドレスのブレークポイントを設定または

削除します。

［Toggle Hardware Breakpoint］選択したアドレスのハードウェアブレークポイントを設定または削除します。

［Resolve Breakpoint］選択したアドレスの保留ブレークポイントを解決

します。

［Enable Breakpoint］選択したアドレスのブレークポイントを有効にし

ます。

［Disable Breakpoint］選択したアドレスのブレークポイントを無効にし

ます。

［Breakpoint Properties...］選択したブレークポイントの［Breakpoint Properties］ダイアログボックスを表示します。これを使用する

と、ブレークポイントのアクティブ化を制御できます。




［Default Breakpoint Type］

このデフォルトタイプオプションを使用すると、トップレベルのコンテキストメニューエントリである［Toggle Breakpoint］が表示され、マー

カバーをダブルクリックして、 CDT ブレークポイントまたは DS-5 ブレークポイントのいずれかに切り替えます。 DS-5 デバッガを使用する場

合は、［DS-5 C/C++ Breakpoint］を選択する必要があります。青色の CDT ブレークポイントマーカと区別するために、 DS-5 ブレークポイン

トマーカは赤色です。

［Show Line Numbers］

行番号を表示または非表示にします。




10.5.2 エディタのコンテキストメニュー

ソースのいずれかの行で右クリックして、 C/C++ エディタのコンテキストメニュー

を表示します。ターゲットに接続した場合、以下のオプションが有効になります。

［Set PC to Selection］

PC に、選択したソース行のアドレスを設定します。

［Run to Selection］

選択したソース行まで実行します。

［Show in Disassembly］

このオプションを使用すると、以下のようになります。

1. ［Disassembly］ビューの新しいインスタンスを開きます。

2. 選択したソース行に関連付けられたアドレスおよび命令を強調表示します。垂直バーおよび影付きのハイライトは、関連する逆アセ

ンブリを示しています。

図 10-6 選択したソース行の逆アセンブリの表示


10.5.3 関連項目

タスク




• デバッガパスの代入規則の設定（4-34 ページ）




— ソースコードの編集（2-28 ページ）




概念


— C/C++ エディタの概要（4-2 ページ） .

参照 • ［Disassembly］ビュー（10-28 ページ）



— set substitute-path （2-172 ページ） .• 『ARM® DS-5™ ： Eclipse の使用』：




10.6 イベントビューアのチャネルエディタ

このエディタを使用して、イベントビューアで生成された出力を表示できます。

注このエディタは、インストルメンテーショントレースマクロセル（ITM）のキャプ

チャがサポートされているターゲットのみに対して有効になります。

イベントビューアが有効になった状態でデバッグセッションを開始すると、有効になっている ITM チャネルごとにチャネルエディタのタブが開きす。イベントビュー

アでは、テキストログがアプリケーションから作成順に表示されます（新しいエントリがビューの下の方に追加されます）タイムスタンプが使用できる場合、各ログエ

ントリの横にある追加の列に表示されます。

データは、実行された場合にのみ、アプリケーションからキャプチャされます。ただ

し、アプリケーションを停止するまでデータはビューに表示されません。ターゲット

を停止するには、デバッグ制御ビューで［Interrupt］アイコンをクリックするか、

コマンドビューで stop コマンドを入力します。アプリケーションが停止すると、キャ

プチャされたログ情報が、開いているビューに自動的に追加されます。

ログ情報のキャプチャを停止するには、チャネルエディタのタブを閉じます。デバッグを終了した場合は、デバッグ制御ビューで［ターゲットから切断］アイコンをクリックして、ターゲットから切断します。



図 10-7 イベントビューアのチャネルエディタ

10.6.1 関連項目

タスク



参照 • ベアメタルターゲットへのイベントビューアの接続の設定（3-14 ページ）







10.7 ［Commands］ビュー


• デバッガコマンドを入力します。

• コマンドスクリプトを実行します。

• デバッガによって出力されるメッセージを表示します。

• 内容をテキストファイルに保存します。

図 10-8 ［Commands］ビュー

表示されるフィールドにコマンドを入力して DS-5 デバッガコマンドを実行し、

［Submit］をクリックします。ターゲットに接続するまで、この機能は使用できませ

ん。

コマンドフィールドでコンテンツアシストのキーボードの組み合わせ（Ctrl+Space キー）を使用して、 DS-5 デバッガコマンドの一覧を表示することができます。部分

コマンドを入力してフィルタ処理を行うこともできます。例ば、キーボードの組み合

わせの Ctrl+Space キーの後に「pr」と入力して、 print コマンドを検索します。

サブコマンドを表示するには、トップレベルのコマンドでフィルタを行う必要があります。例えば、キーボードの組み合わせの Ctrl+Space キーの後に「info」と入力し

て、すべての info サブコマンドを表示します。


設定によって制御されます。例えば、特定ファイルのデフォルの場所または表示する

大行数などがあります。これらの設定にアクセスするには、［Window］メニューの

［Preferences...］を選択します。









す。

［Save Console Buffer］

［Commands］ビューの内容をテキストファイルに保存します。

［Clear Console］

［Commands］ビューの内容をクリアします。

［Scroll Lock］［Commands］ビュー内のメッセージの自動スクロール機能を有効また

は無効にします。

［Script menu］

コマンドスクリプトを管理して実行できるオプションのメニューは、以下のとおりです。

< ［Recent scripts list］ > 近実行したスクリプトの一覧。

< ［Recent favorites list］ > 近お気に入りリストに追加したスクリプトの一覧。

［Run Script File...］［Open］ダイアログボックスを表示し、スクリプトファイルを

選択して実行します。

［Organize Favorites...］スクリプトを整理できる［Scripts］ビューを表示します。

［Show Command History View］

［History］ビューを表示します。

［Copy］選択したコマンドをコピーします。これを実行するには、標準キーボー

ドショートカットも使用できます。

［Paste］以前にコピーしたコマンドをコマンドフィールドに貼り付けます。これ

を実行するには、標準キーボードショートカットも使用できます。

［Select all］［Commands］ビュー内のすべての出力を選択します。これを実行するに

は、標準キーボードショートカットも使用できます。

［Save the selected lines as a script...］

［Save As］ダイアログボックスを表示して、選択したコマンドをスクリ

プトファイルに保存します。



［Save As］ダイアログボックスの［Save］をクリックすると、スクリプ

トファイルをお気に入りリストに追加するオプションを使用できます。［OK］をクリックして、スクリプトをお気に入りリストに追加します。お気に入りは［Scripts］ビューに表示されます。

［Execute selected lines］

選択したコマンドを実行します。

［New Commands］ビュー

［Commands］ビューの新しいインスタンスを表示します。

10.7.2 関連項目

タスク



参照 • ［History］ビュー（10-38 ページ）




— DS-5 デバッガのコマンドの一覧（アルファベット順）（2-28 ページ）

— DS-5 デバッガコマンドの一般的な構文と使用方法（2-2 ページ） .• 『ARM® DS-5™ ： Eclipse の使用』：




10.8 ［Debug Control］ビュー


• 実行中のスレッドおよびユーザ空間プロセスを表示します。

• スレッドまたはプロセスごとのスタック要素を示すコールスタックを表示します。

• ターゲットの接続と切断を行います。

• アプリケーションイメージをターゲットにロードして、デバッガで必要な場合はデバッグ情報をロードします。

• アプリケーションを起動して特定のアドレスで停止します。

• 開始位置からアプリケーションを実行します。

• アプリケーションを停止します。

• ターゲットをリセットします。

• ブレークポイントに達したか、またはターゲットが中断された後に、アプリケーション実行を継続します。

• ソースレベルまたは命令レベルでアプリケーションをステップ実行して、イメージの実行を制御します。

• 現在の作業ディレクトリを設定します。

図 10-9 現在の作業ディレクトリを設定します。

• ソースコードを検索して表示するすべてのコマンドを実行するときにデバッガで使用される検索パスを変更します。

［Debug Control］ビューには、実行中のスレッド、ユーザ空間プロセス、および関連

するコールスタックの階層的レイアウトを使用したターゲット接続が表示されます。 DS-5 デバッグパースペクティブの一部のビューは、現在のスタックフレームに関連

付けられています。他のビューは、エディタまたはターゲット接続に関連付けられま

す。それぞれの関連付けられているビューは同期します。

接続の状態は、異なるアイコンや背景のハイライトで識別され、ビューステータスバーにも表示されます。以下の例は、接続された状態の接続と切断された状態の接続

を示しています。別の設定をビューに追加する場合は、［Debug Control］ビューのメ

ニューを使用できます。






［Collapse All］

展開されたすべてのスタックトレース設定を折りたたみます。

［Connect to Target］

以前の接続と同じ起動コンフィギュレーションの設定を使用して、選択したターゲットに接続します。

［Disconnect from Target］

選択したターゲットから切断します。

［Remove Connection］

選択したターゲット接続を［Debug Control］ビューから削除します。

［Debug from menu］

このメニューでは、接続が確立されたときに実行できるアクションの一覧が表示されます。

［Reset menu］

このメニューでは、ターゲット上で使用できるリセットの一覧が表示されます。

［Run/Continue］

現在の位置からアプリケーションイメージの実行を開始します。

ブレークポイントに達したか、またはターゲットが中断された後に、アプリケーションの実行を継続します。

注［Connect only］接続は、実行する前に、 PC レジスタをイメージの開始

位置に設定する必要があります。

［Interrupt］ターゲットを中断して現在のアプリケーションを停止します。



［Step Source Line］ , ［Step Instruction］

このオプションは、以下のように選択したステップ実行モードによって異なります。

• ソース行モードを選択した場合は、デバッグ情報があるすべての関数呼び出しへのステップ実行など、ソースレベルでステップ実行します。

• 命令モードを選択した場合は、すべての関数呼出しへのステップ実行など、命令レベルでステップ実行します。

［Step Over Source Line］ , ［Step Over Instruction］

このオプションは、以下のように選択したステップ実行モードによって異なります。

• ソース行モードを選択した場合は、ソースレベルでステップ実行しますが、すべての関数呼び出しをステップオーバーします。

• 命令モードを選択した場合は、命令レベルでステップ実行しますが、すべての呼び出し関数をステップオーバーします。

［Step Out］選択したスタックフレームが終了した後、次の命令の実行を継続しま

す。

［Stepping by Source Line (press to step by instruction)］ , ［Stepping by Instruction (press to step by source line)］

ソース行と命令間のステップ実行モードを切り替えます。

［Disassembly］ビューおよび［Source］ビューは、命令モードでステッ

プ実行したときに自動的に表示されます。

［Source］ビューは、ソース行モードでステップ実行したときに自動的

に表示されます。ターゲットが共有ライブラリなどのコードで停止した

り、対応するソースが使用できない場合、［Source］ビューは表示され

ません。

［Debug Configurations...］

選択した接続のコンフィギュレーションが表示されると、［Debug Configurations］ダイアログボックスが表示されます。

［Step Out to This Frame］

選択したスタックフレームの実行を継続します。

［Change Connection Color］

接続アイコンの色を変更できます。

［View Menu］以下のオプションが用意されています。

［Add Configuration (without connecting)...］［Add Launch Configuration］ダイアログボックスを表示します。このダイアログボックスには、まだ［Debug Control］ビューに

記載されていないコンフィュレーションの一覧が表示されます。

複数のコンフィギュレーションを選択して、［OK］をクリッ

クします。選択したコンフィギュレーションは［Debug Control］ビューに追加されますが、接続されていません。



［Load...］イメージ、デバッグ情報、イメージとデバッグ情報、または

追加のデバッグ情報をロードするかどうか選択できるダイアログボックスを表示します。このオプションは、この機能がサ

ポートされていないターゲットでは無効の場合があります。

［Set Working Directory...］［Current Working Directory］ダイアログボックスを表示します。現在の作業ディレクトリの新しい場所を入力して、［OK］を

クリックします。

［Path Substitution...］［Path Substitution］および［Edit Substitute Path］ダイアログ

ボックスを表示します。

［Edit Substitute Path］ダイアログボックスを使用して、イメー

ジパスをホスト上のソースファイルパスに関連付けます。［OK］をクリックします。イメージとホストパスが［Path Substitution］ダイアログボックスに追加されます。操作が完了

したら、［OK］をクリックします。

［Reset DS-5 Views to ‘Linked’］ DS-5 のビューを［Debug Control］ビューで選択した接続にリ

セットします。

［Threads Presentation］スレッドをスタックトレースにフラットまたは階層表示のいずれかで表示します。

［Auto Expand Stack］展開されたスタックを接続の選択時に自動的に表示するかどうかを制御します。

10.8.2 関連項目

タスク





• イメージの実行（4-6 ページ）


• デバッガパスの代入規則の設定（4-34 ページ）




概念

• ターゲット接続の種類（3-3 ページ）

• ターゲットへのイメージのロードについて（4-2 ページ）

• デバッガへのデバッグ情報のロードについて（4-4 ページ） .



参照 • C/C++ エディタ（10-14 ページ）




— continue （2-54 ページ）


— interrupt, stop （2-116 ページ）

— load （2-119 ページ）

— loadfile （2-120 ページ）

— next （2-132 ページ）

— nexti （2-133 ページ）

— nexts （2-134 ページ）

— reset （2-143 ページ）

— run （2-147 ページ）

— set debug-from （2-157 ページ）

— start （2-204 ページ）

— step （2-206 ページ）

— stepi （2-207 ページ）

— steps （2-208 ページ）

— quit, exit （2-141 ページ） .• 『ARM® DS-5™ ： Eclipse の使用』：




10.9 ［Disassembly］ビュー


• ターゲットメモリの［Disassembly］ビューを表示します。

• ［Disassembly］ビューの開始アドレスを指定します。 $r3 のような式をこの

フィールドに使用するか、レジスタを［レジスタ］ビューから［逆アセンブリ］ビューにドラッグアンドドロップして、そのレジスタのアドレスに逆アセンブリを表示できます。

• ［Disassembly］ビューの命令セットを選択します。

• メモリ位置のブレークポイントまたはウォッチポイントを作成、削除、イネーブルまたはディセーブルします。

• 選択したビューをフリーズして実行中のターゲットによる値の更新を抑制します。

図 10-11 ［Disassembly］ビュー

［Disassembly］ビューの影付は、各関数の開始位置を示しています。

［Disassembly］ビューの影付けされているソリッドは、現 PC に対応するソース行の

命令であることを示します。

［Disassembly］ビューの左余白に、逆アセンブリコードの特定の位置に関連付けられ

ているビューマーカを表示するマーカバーを検索できます（マカバーがあります）。



注親ブレークポイントに対するサブブレークポイントがある場合、マーカをダブルク

リックすると、関連したサブブレークポイントも削除できます






このビューを［Debug Control］ビューで選択した接続にリンクし

ます。これがデフォルトです。または、ビューを特定の接続にリ

ンクすることもできます。リンクする接続がドロップダウンリス

トに表示されていない場合は、まず［Debug Control］ビューで接

続を選択する必要があります。

［Back］、［Forward］

履歴一覧内を移動します。

< ［Next Instruction］ > ［Debug Control］ビューで選択したスタックフレームに移動し

ます。

［$LR］ LR レジスタに移動します。

［expression］式で指定されたアドレスに移動します（$PC+256）。

address 指定したアドレスに移動します。

［History］［Address］フィールドで指定したアドレスおよび式がドロップダ

ウンボックスに追加され、履歴一覧をクリアするか Eclipse を終了

するまで保存されます。今後の使用に備えて式を保持する場合は、

式を［Expressions］ビューに追加してください。

［Address］フィールド逆アセンブリを表示するアドレスを入力します。

コンテキストメニューのオプションは、このフィールドの編集に使用できます。

［Size］フィールドプログラムカウンタによってポイントされている場所の前後に表

示する命令の数。


［Search］デバッグ情報内でシンボルを検索します。


［New Disassembly View］［Disassembly］ビューの新しいインスタンスを表示しま

す。

［Instruction Set］デフォルトでビューに表示する命令セット。以下

のいずれかを選択します。

［AUTO］命令セットをイメージから自動検出します。

ARM ARM® 命令セット。

［Thumb］ Thumb® 命令セット。

［Clear History］［History］ドロップダウンボックス内のアドレスおよび

式の一覧をクリアします。

［Refresh］ビューを更新します。



［Freeze Data］現在のビュー内のデータのフリーズを切り替えます。これを使用すると、［Size］および［Type］フィールドや

［Refresh］オプションを無効または有効にすることもで

きます。

［Action context menu］

左余白で右クリックすると、対応するアドレスおよび命令が選択され、このコンテキストメニューが表示されます。使用できるオ

プションは以下のとおりです。

［Copy］選択したアドレスをコピーします。

［Paste］後にコピーしたアドレスを［Address］フィールドに貼り付けます。

［Select All］［Size］フィールドで指定された範囲のすべて

の逆アセンブリを選択します。

逆アセンブリの選択した行をコピーする場合、このメニューで［Copy］オプションを使用で

きません。代わりに、ホストのコピーのキー

ボードショートカット（Windows の場合は Ctrl+C キー）を使用してください。

［Run to Selection］選択したアドレスまで実行します。

［Set PC to Selection］ PC レジスタを選択したアドレスに設定しま

す。

［Show in source］ソースコードを使用できる場合は、以下の手

順に従います。

1. 必要に応じて、 C/C++ エディタビューで

対応するソースファイルを開きます。

2. 選択したアドレスに関連付けられているソース行を強調表示します。

［Show in registers］メモリアドレスがレジスタに対応している場合は、選択された関連レジスタとともに［Registers］ビューが表示されます。

［Show in functions］メモリアドレスが関数に対応している場合は、選択された関連の関数とともに［関数］ビューが表示されます。

［Toggle Breakpoint］選択したアドレスのブレークポイントを設定

または削除します。

［Toggle Hardware Breakpoint］選択したアドレスのハードウェアブレークポイントを設定または削除します。

［Resolve Breakpoint］選択したアドレスの保留ブレークポイント

を解決します。

［Enable Breakpoint］選択したアドレスのブレークポイントを有効

にします。



［Disable Breakpoint］選択したアドレスのブレークポイントを無

効にします。




コンテキストメニューの編集オプション

編集するために［Address］フィールドまたは［Size］フィールド

を選択した場合、以下のオプションがコンテキストメニューで利用できます。

［Cut］選択したテキストをコピーして削除します。

［Copy］選択したテキストをコピーします。

［Paste］以前に切り取った、またはコピーしたテキス

トを貼り付けます。

［Delete］選択したテキストを削除します。

［Undo］後の変更を元に戻します。

［Select All］すべてのテキストを選択します。

10.9.2 関連項目

タスク















10.10 ［Expressions］ビュー


• よく使用する式またはさらに詳しく検証する式を追加します。

• 式を編集および削除します。


図 10-12 ［Expressions］ビュー

注式を評価するときに式に副作用がある場合、予測不能な結果が生じます。式を評価す

るときに、式に対する複数の入力の状態が変更した場合に、副作用が発生します。

このような場合は、 x++ または x+=1 の代わりに x+1 を使用する必要があります。

列ヘッダを右クリックして表示する列を選択します。以下の列があります。

［Name］ main+1024 などのアドレスを解決する式。

［Value］式の値。白い背景の値を変更できます。黄色の背景は、値が変更された

ことを示します。

ビューをフリーズすると、値を変更できません。

［Type］式によって識別されるアドレスの値に関連付けられている型。

［Count］配列またはポインタ要素の数。ポインタ要素の数を編集できます。

［Size］式のサイズ（ビット単位）。

［Location］式によって識別される 16 進数のアドレス、または式に 1 つのレジスタ

名しかない場合はレジスタの名前。

［Access］式のアクセスタイプ。

デフォルトでは、すべての列が表示されます。









す。

［Add New Expression］

新しい式を式リストに追加します。

［Remove Selected Expression］

選択した式をリストから削除します。

［Remove All Expressions］

すべての式をリストから削除します。

［Search］現在のビュー内で式のデータを検索します。

［Cut］選択した式をコピーして削除します。

［Copy］選択した式をコピーします。

［Disassembly］ビューまたは［Memory］ビューで使用するための式をコ

ピーするには、まず［Name］フィールドの式を選択します。

［Paste］以前に切り取った、またはコピーした式を貼り付けます。

［Delete］選択した式を削除します。

［Select All］すべての式を選択します。

［Show in memory view］

このオプションを有効にすると、以下のいずれかに対して設定されたアドレスとともに［Memory］ビューが表示されます。

• 式が配列のアドレス、 &name のアドレスに変換された場合は、選択

した式の値。

• 配列の名前、 name の式の場所。

sizeof キーワードを使用して、メモリサイズを変数のサイズに設定しま

す。

［Show in register view］

式がレジスタに対応する場合は、選択されたレジスタとともに［Registers］ビューが表示されます。これは、以下である可能性がありま

す。

• 単一レジスタのみで構成されている式（$pc）

• 現在レジスタに保持されている変数（例えば、変数 t はレジスタ R5 に保持されることがあります）。



［Send to Selection］

このオプションを使用すると、レジスタフィルタを［Expressions］ビューに追加できます。特定の［Expressions］ビューに追加できるサブ

メニューを示します。

［format list］式の値に使用できる形式のリスト。


［New Expression View］［Expressions］ビューの新しいインスタンスを表示します。


［Freeze Data］現在のビュー内のデータのフリーズを切り替えます。これを使

用すると、［Refresh］オプションを無効または有効にできま

す。

10.10.2 関連項目

タスク





参照 • 関数ビュー（10-35 ページ）









10.11 関数ビュー


• ロードされたすべてのイメージについて、関数シンボルと関連付けられている ELF データを表示します。

• 選択したビューをフリーズして実行中のターゲットによる情報の更新を抑制します。

図 10-13 関数ビュー


［Name］関数の名前。

［Mangled Name］

関数の C++ の変換された名前

［Base Address］

関数エントリポイント

［Start Address］

関数の開始アドレス。

［End Address］

関数の終了アドレス。

［Size］関数のサイズ ( バイト単位 )。

［Compilation Unit］

関数を含んでいるコンパイル単位の場所。

［Image］関数を含んでいる ELF イメージの場所。

デフォルトでは、［Name］、［Start Address］、［End Address］、［Compilation Unit］、および

［Image］の列が表示されます。









す。

［Search］現在のビュー内で関数のデータを検索します。

［Copy］選択した関数をコピーします。

［Select All］ビュー内のすべての関数を選択します。

［Run to Selection］

選択したアドレスまで実行します。

［Set PC to Selection］

PC レジスタを選択した関数の開始アドレスに設定します。

［Show in Source］

ソースコードを使用できる場合は、以下の手順に従います。

1. 必要に応じて、 C/C++ エディタビューで対応するソースファイル

を開きます。

2. 選択したアドレスに関連付けられているソース行を強調表示します。

［Show in Memory］

選択した関数のアドレスで始まる［Memory］ビューを表示します。


選択した関数のアドレスで始まる［Disassembly］ビューを表示します。

［Toggle Breakpoint］選択したアドレスのブレークポイントを設定または削除します。

［Resolve Breakpoint］選択したアドレスの保留ブレークポイントを解決します。

［Enable Breakpoint］選択したアドレスのブレークポイントを有効にします。

［Disable Breakpoint］選択したアドレスのブレークポイントを無効にします。

［Toggle Trace Start Point］

選択したアドレスのトレースの起点を設定または削除します。

［Toggle Trace Stop Point］

選択したアドレスのトレースの終点を設定または削除します。

［Toggle Trace Trigger Point］

選択したアドレスのトレースのトリガポイントを開始します。




［New Function View］［Functions］ビューの新しいインスタンスを表示します。



用すると、［Refresh］オプションを無効または有効にすること

もできます。

［Filter...］［Filter］ダイアログボックスを表示します。

10.11.2 関連項目

タスク





参照 • ［Functions Filter］ダイアログボックス（10-79 ページ）








10.12 ［History］ビュー


• 現在のデバッグセッションで生成されたコマンドがすべて記載された一覧を表示します。

• ビューの内容をクリアします。

• 選択したコマンドをスクリプトファイルに保存します。［Save］をクリックす

ると、スクリプトファイルをお気に入りリストに追加することもできます。お気に入りは［Scripts］ビューに表示されます。

• ［History］ビューのメッセージの自動スクロール機能を有効または無効にしま

す。

図 10-14 ［History］ビュー


設定によって制御されます（特定ファイルのデフォルトの場所ど）。これらの設定に

アクセスするには、［Window］メニューの［Preferences...］を選択します。







す。



［Exports the selected lines as a script］





［Clear Console］

［History］ビューの内容をクリアします。

［Toggles Scroll Lock］

［History］ビューのメッセージの自動スクロール機能を有効または無効

にします。

［Copy］選択したコマンドをコピーします。

［Select All］すべてのコマンドを選択します。

［Save the selected lines as a script...］





［Execute selected lines］

選択したコマンドを実行します。

［New History View］

［History］ビューの新しいインスタンスを表示します。

10.12.2 関連項目

タスク





• ［Functions Filter］ダイアログボックス（10-79 ページ）



— DS-5 デバッガのコマンドの一覧（アルファベット順）（2-28 ページ） .• 『ARM® DS-5™ ： Eclipse の使用』：




10.13 ［Memory］ビュー


• メモリの内容を変更します。

• 絶対アドレスまたは式、 $pc のいずれかで［メモリ］ビューの開始アドレスを指

定します。以前のエントリがドロップダウンリストに一覧表示されます。 Eclipse を終了する、このリストはクリアされます。

• 開始アドレスのオフセット値、または［Registers］ビューから［Memory］ビューにドラッグアンドドロップしてレジスタに保持されているアドレスのずれかで、［Memory］ビューの画面サイズをバイト単位で指定します。

• メモリセルの値の形式を指定します。デフォルトは 16 進数です。

• ［Memory］ビューのメモリセルの幅を設定します。デフォルトは 4 バイトです。

• メモリ値に相当する ASCII 文字を表示します。

• 選択したビューをフリーズして、実行中のターゲットによるビューの更新を抑制します。

図 10-15 ［Memory］ビュー

［Memory］ビューには、このビューでのメモリの表示方法を変更するための機能の

みが用意されています。バイト、ハーフワード、ワード、またはダブルの読み出し /書き込み命令の使用を指定して、［Memory］ビューのメモリにアクセスすることは

できません。メモリアクセスの幅を制御するは、以下のコマンドを使用できます。

• メモリ領域のアクセス幅を設定する memory コマンドに続けて、これらのアクセ

ス幅に従ってメモリを読み出して内容を表示する x コマンド

• 明示的なアクセス幅を使ってメモリに書き込む memory set コマンド









す。

［Back］、［Forward］

履歴一覧内を移動します。

［History］［Address］フィールドで指定したアドレスおよび式がドロップダウン

ボックスに追加され、履歴一覧をクリアするか Eclipse を終了するまで

保存されます。今後の使用に備えて式を保持する場合は、式を

［Expressions］ビューに追加してください。

［Display Width］

クリックして、［Memory］ビューのメモリセルの幅を順に切り替えて表

示するか、ドロップダウンメニューから幅を選択します。デフォルトは 4 バイトです。

［Format］クリックして、メモリセルのフォーマットを順に切り替えて表示する

か、ドロップダウンメニューからフォーマットを選択します。デフォル

トは 16 進数です。

［Showing characters - click to hide the character display］ , ［Not showing characters - click to show the character display］

メモリ値に相当する ASCII 文字の表示が切り替わります。

［Address］フィールド

ターゲットメモリの表示を開始するアドレスを入力します。または、ア

ドレスを評価する式を入力することもできます（$PC+256）。

指定したアドレスおよび式はドロップダウンリストに追加され、 Eclipse を終了するまで保存されます。今後の使用に備えて式を保持する場合

は、を［Expressions］ビューに追加してください。


［Size］フィールド表示するバイト数。


［Search］デバッグ情報内でシンボルを検索します。


［New Memory View］［Memory］ビューの新しいインスタンスを表示します。



［Show Tooltips］メモリセル値のヒントの表示が切り替わります。

［Byte Order］メモリのバイト順序を選択します。デフォルトは［Auto(LE)］です。

［Clear History］［History］ドロップダウンボックス内のアドレスおよび式の一

覧をクリアします。

［Import Memory］ファイルからデータを読み出し、メモリに書き込みます。

［Export Memory］メモリからデータを読み出して、ファイルに書き込みます。


［Freeze Data］現在のビュー内のデータのフリーズを切り替えます。また、こ

れを使用すると、［Address］フィールドと［Size］フィールド

および［Refresh］オプションを無効または有効にできます。


編集するためにメモリセル値、［Address］フィールド、または［Size］フィールドを選択した場合、以下のオプションがコンテキストメニューで利できます。

［Cut］選択した値をコピーして削除します。

［Copy］選択した値をコピーします。

［Paste］以前に切り取ったまたはコピーした値を、選択したメモリセ

ルまたはフィールドに貼り付けます。

［Delete］選択した値を削除します。

［Undo］選択したメモリセルまたはフィールドに対して行った後の

変更を元に戻します。［Address］フィールドではこのオプ

ションは無効です。

［Select All］すべてのアドレスを選択します。

［Toggle Breakpoint］選択したアドレスのブレークポイントを設定または

削除します。

［Resolve Breakpoint］選択したアドレスの保留ブレークポイントを解決

します。

［Enable Breakpoint］選択したアドレスのブレークポイントを有効にし

ます。

［Disable Breakpoint］選択したアドレスのブレークポイントを無効にし

ます。






10.13.2 関連項目

タスク





参照 • ［Export memory］ダイアログボックス（10-64 ページ）

• ［Import memory］ダイアログボックス（10-66 ページ）



— パースペクティブとビュー（2-22 ページ） .• 『ARM® DS-5™ ：デバッガコマンドリファレンス』：

— dump （2-68 ページ）

— memory set （2-129 ページ）

— restore （2-146 ページ）

— x （2-227 ページ） .



10.14 ［Modules］ビュー

このビューは、 Linux ターゲットに接続した場合にのみ表示されます。このビューを

使用すると、以下を実行できます。

• アプリケーションによって使用される共有ライブラリの表ビューを表示します。

• 動的にロードされたオペレーティングシステム（OS）モジュールの表ビューを

表示します。

• 特定のモジュールまたは共有ライブラリのデバッグ情報をロードおよびアンロードします。

図 10-16 共有ライブラリを表示している［Modules］ビュー

図 10-17 オペレーティングシステムモジュールを表示している［Modules］ビュー

注ロード可能なモジュールを検出するには、デバッガ内で接続が確立しており、 OS サポートが有効になっている必要があります。 Linux カーネルイメージがデバッガに

ロードされると、 OS サポートは自動的に有効になります。ただし、 set os コマンドを

使用して手動でこれを制御することもできます。


［Name］ターゲットのコンポーネントの名前および場所を表示します。

［Symbols］シンボルが各オブジェクトに対して現在ロードされているかどうかを表

示します。



［Address］オブジェクトのロードアドレスを表示します。

［Size］オブジェクトのサイズを表示します。

［Kind］コンポーネントの種類を表示します（共有ライブラリまたは OS モジュールなど）。

［Host File］ホストワークステーション上のコンポーネントの名前と場所を表示しま

す。

デフォルトでは、［Name］、［Symbols］、［Address］、［Kind］、および［Host File］の列が表示

されます。







す。

［Refresh］

ビューを更新します。

［Copy］選択したデータをコピーします。

［Select All］表示されているすべてのデータを選択します。

［Load Symbols］

デバッグ情報をホストファイル列に表示されたソースファイルからデバッガにロードします。ホストファイルが不明な場合（ファイルがロー

ドされる前）、このオプションは無効です。

［Add Symbol File...］

デバッガに必要なデバッグ情報を含むファイルをホストワークステーションから選択できるダイアログボックスを開きます。

［Discard Symbols］

選択したファイルに関するデバッグ情報を破棄します。


選択したオブジェクトのロードアドレスで始まる［Memory］ビューを

表示します。


選択したオブジェクトのロードアドレスで始まる［Disassembly］ビュー

を表示します。



10.14.2 関連項目

タスク





参照 • DS-5 デバッガメニューとツールバーアイコン（10-104 ページ）


— パースペクティブとビュー（2-22 ページ） .• 『ARM® DS-5™ ：デバッガコマンドリファレンス』：


— discard-symbol-file （2-65 ページ）

— file, symbol-file （2-75 ページ） .



10.15 ［Registers］ビュー


• ターゲットレジスタの内容を表示します。

• 書き込み可能なレジスタの値を変更します。レジスタ値を変更すると、レジス

タ値の背景が黄色に変わります。

• レジスタ値の表示形式を変更します。プログラムステータスレジスタ（PSR）では、各ビットを使って形式を設定できます。


• R3 などのレジスタに保持されているアドレスを、［Registers］ビューから

［Memory］ビューまたは［Disassembly］ビューのいずれかにドラッグアンドド

ロプして、そのアドレスのメモリを表示したりそのアドレスから逆アセンブルします。

図 10-18 ［Registers］ビュー


［Name］レジスタの名前。

$register_name を使用してレジスタを参照します。 PSR などのビット

フィールドがあるレジスタを参照するには、 $register_name.bitfield_name を指定します。例えば、 $CPSR の M ビットフィールドの値を出力するに

は、［Commands］ビューに以下のコマンドを入力してください。

print $CPSR.M$1 = USR

［Value］レジスタの値。影付きの背景は、値が変更されたことを示します。

ビューをフリーズさせると、レジスタ値を変更できません。

［Type］レジスタ値の型。

［Count］配列またはポインタ要素の数。

［Size］レジスタのサイズ（ビット単位）。



［Location］ PSR のビットフィールドのレジスタまたはビットマップの名前。例えば、

CSPR のビットフィールド M は、 $CPSR[0..4] と表示されます。

デフォルトでは、［Name］、［Value］、および［Size］の列が表示されます。







す。

［Search］現在のビュー内でレジスタのデータを検索します。

［Copy］選択したレジスタをコピーします。 PSR のビットフィールドをコピーす

るには、まず PSR を拡張する必要があります。

これは、選択したレジスタをテキストエディタにコピーして、別の場所で実行が停止したときに値を比較する場合に便利です。

［Select All］ビューで現在拡張されているすべてのレジスタを選択します。

［Show Memory Pointed to By register_name］

このオプションを有効にすると、レジスタに保持されているアドレスで始まる［Memory］ビューが表示されます。

［Show Disassembly Pointed to By register_name］

このオプションを有効にすると、レジスタに保持されているアドレスで始まる［Disassembly］ビューが表示されます。


このオプションを使用すると、レジスタフィルタを［Expressions］ビューに追加できます。特定の［Expressions］ビューに追加できるサブ

メニューを示します。

［format list］レジスタ値に使用できる形式のリスト。デフォルトは［Hexadecimal］です。


［New Register View］［Registers］ビューの新しいインスタンスを作成します。



用すると、［Refresh］オプションを無効または有効にすること

もできます。




編集するためにレジスタ値を選択した場合、以下のオプションがコンテキストメニューで利用できます。



［Paste］以前に切り取ったまたはコピーした値を、選択したレジスタ

値に貼り付けます。


［Undo］選択した値に対して行った後の変更を元に戻します。

10.15.2 関連項目

タスク





概念

• TrustZone 対応ターゲットのデバッグについて（6-19 ページ） .






10.16 ［Screen］ビュー


• ターゲット上の画面バッファの内容を表示します。このビューは、ターゲット

が停止したときにのみ更新されます。

• ターゲットに適した画面バッファパラメータを設定します。 :

図 10-19 BeagleBoard で動作する Fireworks の例の画面バッファパラメータ

• 選択したビューをフリーズして、次に停止したときに実行中のターゲットによる画面表示の更新を抑制します。

図 10-20 ［Screen］ビュー



10.16.1 ツールバーオプション

以下のツールバーオプションが用意されています。





す。

［Refresh］


［Set Screen Buffer Parameters］

［Screen Buffer Parameters］ダイアログボックスを表示します。ダイアロ

グボックスには以下のパラメータがあります。

Base Address 画面バッファのベースアドレスを設定します。

Screen Width 画面の幅をピクセル単位で設定します。

Screen Height 画面の高さをピクセル単位で設定します。

Scan Line Alignment 各スキャンラインに必要なバイトアラインメントを設定します。

Pixel Type ピクセルのタイプを選択します。

Pixel Byte Order データ内のピクセルのバイト順序を選択します。

［Apply］をクリックして設定を保存し、ダイアログボックスを閉じま

す。

［Cancel］をクリックして、保存せずにダイアログボックスを閉じます。

［Freeze Data］

現在のビュー内のデータのフリーズを切り替えます。これを使用する

と、［Refresh］オプションを無効または有効にすることもできます。

［New Screen Buffer View］

［Screen］ビューの新しいインスタンスを作成します。

［Screen］ビューはデフォルトでは表示されません。このビューを追加するには、以

下の手順に従います。


2. ［Window］ → ［Show View］を選択して［Show View］ダイアログボックスを開

きます。

3. ［Screen］ビューを選択します。



10.16.2 関連項目

タスク








10.17 ［Scripts］ビュー

このビューには、お気に入りスクリプトが含まれています。複数のお気に入りスクリ

プトを実行、編集、または削除できます。［History］ビューコマンドを保存した場合

は、スクリプトをこのビューに追加できます。

複数の選択がビューに一覧表示された順に実行されます。順序を変更するには、スク

リプトをビューから削除して、希望する順序でインポートします。

図 10-21 ［Scripts］ビュー


設定によって制御されます（スクリプトファイルのデフォルト場所など）。これらの

設定にアクセスするには、［Window］メニューの［Preferences...］を選択します。



［Creates a new script］

新しい空のスクリプトを作成します。作成した後にスクリプトの内容を

指定するには、スクリプトを選択して［Edit Selected Script］をクリッ

クします。

［Execute Selected Scripts］

選択したスクリプトを実行します。複数のスクリプトを選択した場合、

デバッガは［Scripts］ビューに一覧表示されている順にスクリプトを実

行ます。

［Edit Selected Scripts］

選択したスクリプトを編集できます。スクリプトは C/C++ エディタで開

かれます。

［Delete Selected Scripts］

選択したスクリプトをお気に入りリストから削除します。また、スクリ

プトをファイルシステムから削除しようとします。

［Import Script...］

スクリプトファイルをインポートしてお気に入りリストに追加します。



［Cut］選択したスクリプトファイル名をコピーして削除します。また、スクリ


［Copy］選択したスクリプトをコピーします。

［Paste］以前に切り取ったまたはコピーしたスクリプトファイル名を貼り付けま

す。

ファイルを切り取り操作の一部としてファイルシステムから削除した場合、ファイルの内容は復元されません。ファイルを編集して新しいコマ

ンドを追加する必要があります。

ファイルを切り取り操作の一部として削除しなかった場合、デバッガはファイル名をファイルシステムのファイルにリンクします。

［Delete］選択したスクリプトをお気に入りリストから削除します。また、スクリ


［Select All］すべてのスクリプトファイルを選択します。

10.17.2 関連項目

タスク











10.18 ［Target］ビュー

このビューでは、以下のようなターゲットでサポートされるデバッグ機能を検証できます。

• サポートされているブレークポイントタイプ

• サポートされているリセットタイプ

• サポートされているメモリアクセスタイプ

すべての機能は読み出し専用です。

図 10-22 ［Target］ビュー


［Name］ターゲット機能の名前。

［Value］ターゲット機能の値。

［Key］ターゲット機能の名前。これは、［Commands］ビューのいくつかのコマ

ンドで使用されます。

［Description］ターゲット機能の説明。

デフォルトでは、［Name］、［Value］、および［Description］の列が表示されます。

［Target］ビューはデフォルトでは表示されません。このビューを追加するには、以下

の手順に従います。



きます。

3. ［Target］ビューを選択します。









す。

［Refresh the Target Capabilities］


［Copy］選択した機能をコピーします。メモリ機能などのグループの機能をコピー

するには、まずそのグループを拡張する必要があります。

このオプションは、選択した機能をテキストエディタにコピーして、将来の参照に備えてその機能を保存する場合に便利です。

［Select All］ビューで現在拡張されているすべての機能を選択します。

10.18.2 関連項目

タスク













10.19 ［Trace］ビュー

トレースがキャプチャされた場合、デバッガは情報をトレースストリームから抽出して伸張し、実行されたコードの完全な逆アセンブリをシンボとともに提供します。

このビューには、ナビゲーションタイムラインを使用した関数の実行を表示するグラフィカルナビゲーションのグラフが表示されます。さらに、逆アセンブリトレース

には、アドレスおよび選択されている場合は命令に関連付けられている関数呼び出しが表示されます。グラフの特定の時間をクリックすると、［Disassembly］ビューを

同期化します。

グラフの左列には、合計トレースの各関数に対して割合が表示されます。例えば、合

計 1000 個の命令が実行され、これらの命令の 300 個が myFunction() に関連付けられて

いる場合、この関数は 30% と表示されます。

ナビゲーションタイムラインで、色分けは、実行される命令および各関数がタイムラインごとに実行する命令の量を示す " ヒート " マップです。い赤色は命令が多いこ

とを示し、明るい黄色は命令が少ないことを示しています。ただし、 1:1 のスケール

での配色は、濃い赤色がメモリアクセの命令、オレンジ色が分岐命令、明るい緑色が他のすべての命令を表示するように変更されます。

図 10-23 スケールが 1:1 のトレースビュー

［Trace］ビューはデフォルトでは表示されない場合があります。このビューを追加す

るには





きます。

3. ［Trace］ビューを選択します。

トレースビューには複数のタブが含まれています。

• グラフィカルタイムラインと逆アセンブリを示すトレースタブ







す。

［Show Next Match］

ナビゲーショングラフおよび逆アセンブリトレースのフォーカスを、選択した関数または命令が次に一致する箇所に移動します。

［Show Previous Match］

ナビゲーショングラフおよび逆アセンブリトレースのフォーカスを、選択した関数または命令が直前に一致する箇所に移動します。

［Don’ t mark other occurrences - click to start marking］、［Mark other occurrences - click to stop marking］

関数トレースが選択されている場合は、影付きで強調表示されている選択した関数のすべての出現箇所をマークします。命令トレースが選択さ

れている場合、このオプションは無効です。

［Clear Trace］トレースバッファとトレースビューに現在含まれている未加工トレー

スデータをクリアします。

［Showing instruction trace - click to switch to functions］、［Showing function trace - click to switch to instructions］

逆アセンブリトレース、命令トレース、関数トレース、を切り替えます。

［Export Trace Report］

［Export Trace Report］ダイアログボックスを表示して、トレースデータ

をファイルに保存します。

Home キー有効にすると、トレースビューがトレースバッファの先頭に移動しま

す。トレースバッファが小さすぎる場合は、変化が見えない可能性があ

ります。

［Page Back］このオプションを有効にすると、［Trace］ビューを 1 ページ前に戻しま

す。［Set Maximum Instruction Depth］設定を変更して、ページサイズ

を変更できます。



［Page Forward］

このオプションを有効にすると、［Trace］ビューを 1 ページ先に移動さ

せます。［Set Maximum Instruction Depth］設定を変更して、ページサ

イズを変更できます。

End キー

有効にすると、トレースビューがトレースバッファの末尾に移動します。トレースバッファが小さすぎる場合は、変化が見えない可能性があ

ります。

［Switch between navigation resolutions］

ナビゲーショングラフのタイムラインの解像度を変更します。

［Switch between alternate views］

ビューにナビゲーショングラフ、逆アセンブリトレースまたはその両方が表示されるように変更します。

［Focus Here］リストの上部には、選択した時間帯で実行されている関数が表示され

ます。残りの関数は、時間内に選択したポイントの後で実行した順序で

一覧表示されます。時間内のポイントの後に表示されない関数は末尾に

配置され、合計時間の順に配置されます。

［Order By Total Time］

関数を関数内でかかった合計時間順に表示します。これがデフォルトの

順序です。


［New Trace View］［Trace］ビューの新しいインスタンスを表示します。

［Copy］選択した命令トレースをコピーします。

［Set Maximum Instruction Depth］逆アセンブリトレースに表示できる大命令数を入力するダイアログボックスを表示します。命令数は、 1000 から 100 万個

の命令の範囲内に収め必要があります。

［Index From Start］バッファの先頭からの、デコードされた命令数

［Index From Middle］バッファの中央からの、デコードされた命令数

［Index From End］バッファの末尾からの、デコードされた命令数

［Find Trigger Packet] トレースキャプチャバッファでトリガパケットを検索できます。

［Show in Disassembly］選択した命令のアドレスで始まる［Disassembly］ビューを表

示します。




［Freeze Data］現在のビュー内のデータのフリーズを切り替えます。

10.19.2 関連項目

タスク






概念 • トレースサポートについて（5-7 ページ）



• C/C++ エディタ（10-14 ページ）











10.20 ［Variables］ビュー


• 現在有効範囲にある変数の内容を表示します。

• 現在有効範囲にある変数の値を変更します。


図 10-24 ［Variables］ビュー


［Name］変数の名前。

［Value］変数の値。

読み出し専用の値は、灰色の背景で表示されます。他の色は、その値が

編集可能であることを示します。

編集できる値は、初は白い背景で表示されます。値が変更された場

合、ステップ実行などのデバッグアクションを実行するか、値を直接編集して値が変更された場合、背景は黄色に変わります。

ビューをフリーズすると、値を変更できません。

［Type］変数の型。

［Count］配列またはポインタ要素の数。

［Size］変数のサイズ（ビット単位）。

［Location］変数のアドレス。

デフォルトでは、すべての列が表示されます。









す。

［Search］現在のビュー内で変数のデータを検索します。

［Copy］選択した変数をコピーします。構造体または配列などの項目の内容をコ

ピーするには、まずその項目を拡張する必要があります。

このオプションは、選択した変数をテキストエディタにコピーして、別の場所で実行が停止したときに値を比較する場合に便利です。

［Select All］ビューで現在拡張されているすべての機能を選択します。


このオプションを有効にすると、以下のいずれかに対して設定されたアドレスとともに［Memory］ビューが表示されます。

• 変数が配列のアドレス、 &name のアドレスに変換されている場合は、

選択した変数の値

• 配列の名前、 name の変数の場所

sizeof キーワードを使用して、メモリサイズを変数のサイズに設定しま

す。

［Show in Registers］

選択した変数がレジスタに現在保持されている場合は、選択したそのレジスタとともに［Registers］ビューが表示されます。例えば、変数 t はレジスタ R5 に保持される可能性があります。

[Show Dereference in Memory]

選択した変数がポインタである場合は、メモリ内で変数が指しているアドレスとともに［Memory］ビューが表示されます。


変数フィルタを［Expressions］ビューに追加できます。特定の

［Expressions］ビューに追加できるサブメニューを表示します。

［format list］変数値に使用できる形式のリスト。デフォルトは［Unsigned Decimal］です。


［New Variable View］［Variables］ビューの新しいインスタンスを表示します。





用すると、［Refresh Variable View］オプションを無効または

有効にできます。データがフリーズされている場合は、変数の

値を変更することもできます。

配列などの項目を拡張する前に初めてデータをフリーズした場合、ビューは項目を［Pending...］と表示する可能性がありま

す。項目を表示するには、データをアンフリーズします。


編集するために変数の値を選択した場合、以下のオプションがコンテキストメニューで利用できます。



［Paste］以前に切り取ったまたはコピーした値を、選択した変数の値

に貼り付けます。


［Undo］選択した値に対して行った後の変更を元に戻します。

［Right to left reading order］選択した変数の値の読み出し順序を左ぞろえまたは右ぞろえに設定します。

［Show unicode control characters］選択した変数値の Unicode 制御文字を表示します。

［Insert unicode control character］ Unicode 制御文字を選択して、選択した変数の値に挿入しま

す。

10.20.2 関連項目

タスク





参照 • ［Expressions］ビュー（10-32 ページ）









10.21 ［Export memory］ダイアログボックス

このダイアログボックスでは、特定のメモリ領域からのデータを含んでいるテキストファイルを生成できます。

［Memory Bounds］

メモリ領域を指定します。

開始アドレスメモリの開始アドレスを指定します。

終了アドレスメモリの終了アドレス（指定したアドレスを含む）を指定します。

バイト単位の長さバイト数を指定します。

［Output Format］

出力形式を以下の中から指定します。

• バイナリ。これがデフォルトです。）

• Intel Hex 32 ビット形式。

• Motorola 32 ビット形式（S レコード）。

• バイト指向 16 進形式（Verilog メモリモデル）

［Export Filename］

所定のフィールドに出力ファイルの現在の場所を入力するか、以下のいずれかをクリックします。

• ［File System...］（外部フォルダに含まれている出力ファイルを検索

する場合）

• ［Workspace...］（ワークスペースプロジェクトに含まれている出力


図 10-25 ［Memory Exporter］ダイアログボックス

10.21.1 関連項目

タスク







参照 • ［Import memory］ダイアログボックス（10-66 ページ）







10.22 ［Import memory］ダイアログボックス

このダイアログボックスでは、特定のメモリ領域からのデータを含んでいるテキストファイルを生成できます。

［Offset to Embedded Address］

メモリに書き込む前にイメージ内のすべてのアドレスに加算するオフセットを指定します。一部のイメージ形式には書き込むアドレスが含ま

れておらず、その場合、オフセットはイメージが書き込まれる絶対アドレスです。

［Memory Limit］

インポートする特定のメモリ領域を定義できます。

［Limit to memory range］アドレス範囲を指定するときに選択します。

［Start］書き込み可能な小アドレスを指定します。このアドレスより

前のデータは書き込まれません。アドレスを指定しない場合、

デフォルトはアドス 0 です。

End キー書き込み可能な大アドレスを指定します。このアドレスより

後のデータは書き込まれません。アドレスを指定しない場合、

デフォルトはアドス空間の末尾です。

［Import Filename］

ファイル形式がバイナリファイルの場合は、［Import file as binary image］を選択します。

所定のフィールドに出力ファイルの現在の場所を入力するか、以下のいずれかをクリックします。

• ［File System...］（外部フォルダに含まれている出力ファイルを検索

する場合）

• ［Workspace...］（ワークスペースプロジェクトに含まれている出力


図 10-26 ［Memory Importer］ダイアログボックス



10.22.1 関連項目

タスク





参照 • ［Export memory］ダイアログボックス（10-64 ページ）







10.23 ［Export trace report］ダイアログボックス

このダイアログボックスでは、トレースレポートを作成できます。

［Select source for trace report］

以下の必要なトレースデータを選択します。

［Use trace view as report source］［Trace］ビューに現在表示されている命令。

［Use trace buffer as report source］トレースバッファに現在含まれている未加工トレースデータ。

注範囲を指定するときは、範囲が十分に広いことを確認します。

確認しないと、トレース出力を生成できない可能性があります。これは、バッファ内の未加工のトレースはパック形式だか

らです。

［Report Format］

レポートは以下のもので構成されています。

［Output Format］出力形式を選択します。

［Include column headers］レポートの 1 行目に列ヘッダを追加できます。

［Select columns to export］レポートのトレースデータをフィルタできます。

［Save as］レポートの場所およびファイル名を入力します。

［Browse］ファイルシステムのレポートの場所を選択します。



図 10-27 ［Export trace report］ダイアログボックス

10.23.1 関連項目

タスク





概念 • トレースサポートについて（5-7 ページ）

参照 • ［Trace］ビュー（10-57 ページ）






10.24 ［Breakpoint properties］ダイアログボックス

このダイアログボックスを使用すると、以下を実行できます。

• 選択したブレークポイントのプロパティを表示します。

• 特定のブレークポイントに対して条件式を設定します。

• 特定のブレークポイントに対して無視する回数を設定します。

• 選択したブレークポイントに達したときに実行するスクリプトファイルを指定します。

• すべてのブレークポイントのアクションの完了時に自動的に実行を継続します。

• ブレークポイントのアクションを特定のスレッドまたはプロセッサに割り当てます（可能な場合）。

図 10-28 ［Breakpoint properties］ダイアログボックス



10.24.1 ブレークポイント情報

ブレークポイント情報には、ブレークポイントの基本的なプロパティが表示されます。以下のプロパティがあります。

［Descrption］［Breakpoints］ビューに表示されるブレークポイントの説明。以下のも

ので構成されます。

• ブレークポイントが設定されている関数の名前および関数の開始位置からのバイト数。例えば、 accumulate()+52 は、ブレークポイン

トが accumulate() 関数の開始位置から 52 バイト離れていることを

示します。

• ソースファイルが利用できる場合は、ブレークポイントが設定されているファイルのファイル名および行番号（threads.c:115）。

• ブレークポイントの ID 番号（#N）。場合によっては、 for ループ内

など、ブレークポイントが多数のサブブレークポイントで構成されている可能性があります。これらは N.n として識別されます。 N は親の数です。このダイアログボックスのサブブレークポイントの

説明は、以下のように表示されます。

main()+132sub-breakpoint ofmain()+132 @ threads.c:56 [#14 ARM] (threads)

• ブレークポイントのアドレスの命令タイプ（ARM または Thumb）。

• 設定されている場合は、 ignore の回数。表示形式は以下のとおりで

す。

ignore = num/count

初は num は count に等しく、ゼロに達するまで各パスに対してデ

クリメントします。

count は、 ignore 回数に対して指定した値です。

• ブレークポイントに達するたびにインクリメントする hits 回数。これは、初めてブレークポイントに達すると表示されます。 ignore 回数を設定した場合、hits 回数は ignore 回数がゼロに達するまでイ

ンクリメントを開始しません。

• 指定した停止条件（(i==3)）。

• イメージの名前。

:accumulate()+52 @ threads.c:115 [#1 ARM, ignore = 3/3, 3 hits, (i==3)] (threads)

［Location］ブレークポイントが設定されているアドレスを含むソースファイルの場

所。以下に例を示します。

C:/Myprojects/Eclipse/workspace_ds5/threads/threads.c:115.0

ソースファイルが使用できない場合は、［Unknown］が表示されます。

［Type］これは、以下のことを示します。

• ブレークポイントアドレスのコードにソースファイルが使用できるかどうかを示します。使用できる場合は［Source Level］、使用で

きない場合は［Address Level］が表示されます。

• ブレークポイントが共有オブジェクトのコードにある場合、［Auto］

は、その共有オブジェクトがロードされたときにブレークポイントが自動的に設定されることを示します。



• ブレークポイントが［Active］の場合、［Software Breakpoint］または

［Hardware Breakpoint］のいずれかのブレークポイントのタイプ。

• ブレークポイントのアドレスの命令タイプ（ARM または Thumb）。:

Source Level Software Breakpoint [ARM]

［State］以下のいずれかを示します。

［Active］ブレークポイントのアドレスを含むイメージまたは共有オブ

ジェクトがロードされ、ブレークポイントが設定されます。

［No Connection］ブレークポイントは、接続されていないターゲット上のアプリケーション内にあります。

［Pending］ブレークポイントのアドレスを含むイメージまたは共有オブ

ジェクトは、まだロードされていません。イメージまたは共有

オブジェクトがロードされると、ブレークポイントはアクティブになります。

［Address］アドレスを有効または無効にできるチェックボックスとともに、複数の

ブレークポイントまたはサブブレークポイントのアドレスを表示するダイログボックス。

［Temporary］これがテンポラリブレークポイントである場合は［true］が表示されま

す。テンポラリブレークポイントでない場合は［false］が表示されます。

10.24.2 ブレークポイントのオプション

以下のオプションを設定できます。

［Stop Condition］

選択したブレークポイントの C 形式の条件式を指定します。例えば、 x の値が 10 のときにブレークポイントをアクティブにするには、 x==10 を指定します。

［Ignore Count］

選択したブレークポイントをアクティブにする前に、無視する回数を指定します。

ゼロに達するまで、デバッガは各パスのカウンタをデクリメントします。以下に例を示します。

main()+140 @ threads.c:51 [#1 ARM, ignore = 2/3] (threads)

値がゼロに達したとき、ブレークポイントはアクティブになります。その後の各パスにより、ブレークポイントはアクティブになります。

コンテキストメニューの［Reset Ignore Count］オプションを選択して、

カウンタを設定した値にリセットし、アクティブ化を再度遅延します。

［On break, run script］

選択したブレークポイントがアクティブになったときに実行するスクリプトファイルを指定します。



注スクリプトで使用されるコマンドが、ブレークポイントで実行されるこ

とに注意してください。例えば、スクリプト内で quit コマンドを使用す

ると、ブレークポイントに達したときにデバッガがターゲットから切断されます。

［Continue Execution］

ブレークポイントがアクティブになった後にターゲットの実行を継続する場合は、このオプションを選択します。

［Silent］

選択したブレークポイントの停止メッセージの出力を制御します。

［Break on Selected Threads or Cores］

このオプションは、特定のスレッドまたはプロセッサに対するブレークポイントを設定するときに選択します。スレッドまたはプロセッサが使

用できない場合、このオプションは無効です。

ブレークポイントがアクティブになったとき、デバッガは以下の処理を行います。

• ［Commands］ビューにメッセージを表示します。以下に例を示します。

Execution stopped at breakpoint 1: 0x00008850In thread 1 (OS thread id 1078)0x00008850 51,0 thread_app_data[t].thread = t;

• ブレークポイントのヒット回数をインクリメントします。以下に例を示します。

main()+140 @ threads.c:51 [#1 ARM, ignore = 0/3, 2 hits] (threads)

10.24.3 関連項目

タスク



















— silence （2-202 ページ） .



10.25 ［Watchpoint properties］ダイアログボックス

このダイアログボックスを使用すると、以下を実行できます。

• 選択したウォッチポイントのプロパティを表示します。

• ウォッチポイントのタイプを変更します。

図 10-29 ［Watchpoint properties］ダイアログボックス

以下のタイプが用意されています。

READ メモリが読み出されたときに、デバッガがターゲットを停止します。

WRITE メモリが書き込まれたときに、デバッガがターゲットを停止します。

ACCESS メモリの読み出しまたは書き込みが行われたときに、デバッガがター

ゲットを停止します。

10.25.1 関連項目

タスク















— watch （2-222 ページ） .



10.26 ［トレースポイントのプロパティ］ダイアログボックス

このダイアログボックスでは、選択したトレースポイントのプロパティを表示できます。

図 10-30 ［トレースポイントのプロパティ］ダイアログボックス

以下のタイプが用意されています。

トレースの起点トレースの起点に達すると、トレースのキャプチャを有効にしま

す。

トレースの終点トレースの終点に達すると、トレースのキャプチャを無効にしま

す。

トレースのトリガポイント

トレースのトリガポイントに達すると、トレースのキャプチャを開始します。

注選択したターゲットに応じて、トレースポイントの動作は異なる場合があります。

10.26.1 関連項目

タスク








• C/C++ エディタ（10-14 ページ）





• DS-5 デバッガメニューとツールバーアイコン（10-104 ページ） .



10.27 ［Manage Signals］ダイアログボックス

このダイアログボックスでは、 1 つ以上のシグナルまたはプロセッサ例外に関するハ

ンドラ（ベクタキャッチ）設定を制御できます。信号（外部込み）またはプロセッサ

例外が発生した場合、実行の停止、メッセージの出力、またはその両方を行うように選択できます。デフォルトでは、べての信号に対して［停止］と［出力］が選択さ

れます。

注デバッガは、 gdbserver を使用してリモートターゲット上で動作するアプリケーショ

ンに接続されている場合は Unix シグナルを処理しますが、オペーティングシステム

がないベアメタルターゲット上ではプロセッサ例外を処理します。

図 10-31 シグナルハンドラ設定の管理

図 10-32 例外ハンドラ設定の管理

10.27.1 関連項目

タスク







参照 • ［Target］ビュー（10-55 ページ）




10.28 ［Functions Filter］ダイアログボックス

このダイアログボックスでは、関数ビューに表示されるシンボルのリストをフィルタできます。

図 10-33 ［Functions Filter］ダイアログボックス

10.28.1 関連項目

タスク



参照 • 関数ビュー（10-35 ページ）



10.29 ［Debug Configurations］ - ［Connection］タブ

［Debug Configurations］ダイアログボックスの［Connection］タブでは、 DS-5 デバッ

ガのターゲット接続を設定できます。作成した各コンフィギュレーションは、単一の

ターゲットプロセッサに関連付けられます。

開発プラットフォームに複数のプロセッサがある場合は、各プロセッサに対して別のコンフィギュレーションを作成する必要があります。複数のターゲットに接続して

いるときは、同期操作またはクロストリガ操作を実行できないことに注意してください。

注［Connection］タブのオプションは、選択するプラットフォームのタイプに依存しま

す。

［Select target］

以下のオプションを使用して、ターゲットを選択できます。

［Platform］ターゲットプラットフォームを選択します。

注ターゲットが表示されない場合は、サポート担当者にお問い

合わせください。

［Project type］以下のプロジェクトのタイプを選択します。

［Linux Application Debug］ Linux アプリケーションをデバッグする場合に選択し

ます。

［Linux Kernel and/or Device Driver Debug］ Linux カーネルまたはデバイスドライバをデバッグす

る場合に選択します。

［Bare Metal Debug］ベアメタルターゲットで実行されているアプリケーションをデバッグする場合に選択します。

APK ネイティブライブラリデバッグ Android ターゲットで実行されているアプリケーショ

ンをデバッグする場合に選択します。

［Debug operation］以下のオプションを使用して、ターゲット環境を指定できます。使用できるオプションは、選択したプラットフォームおよ

びプロジェクトタイプによって異なります。

アプリケーションをダウンロードしてデバッグします , Android アプリケーションをダウンロードしてデバッグします

アプリケーションイメージおよびライブラリがターゲット上に存在しない場合は、このオプションを選択します。ターゲットに接続すると、デバッガはア

プリケーションをターゲットにロードし、新しい gdbserver セッションを開始します。



［Start gdbserver and debug target resident application］アプリケーションが既にターゲット上に存在する場合は、このオプションを選択します。

［Connect to already running gdbserver］アプリケーションが既にターゲット上に存在する場合、および gdbserver が既に実行されている場合は、

このオプションを選択します。

［Debug and ETB Trace via DSTREAM/RVI］ Embedded Trace Buffer （ETB）サポートを使ってベア

メタルターゲットで実行されているアプリケーションをデバッグしてトレースする場合に選択します。

［Debug and Trace via DSTREAM］トレースポートインタフェースユニット（TPIU）サ

ポートを使ってベアメタルターゲットで実行されているアプリケーションをデバッグしてトレースする場合に選択します。

［Debug and Kernel-only ETB Trace via DSTREAM/RVI］ ETB サポートを使用したベアメタルターゲットで実

行されているカーネルをデバッグしてトレースする場合に選択します。

［Debug via DSTREAM/RVI］ベアメタルターゲットで実行されているアプリケーションをデバッグする場合に選択します。

［Connections］

以下のオプションを使用すると、デバッガとターゲットの間の接続を設定できます。

[RSE connection] 以前に設定したリモートシステムエクスプローラ（RSE）コン

フィギュレーションのリスト。このデバッグコンフィギュレー

ションに使用する必須の RSE コンフィギュレーションを選択

します。

[Android devices] 以前に設定した Android デバイスのリスト。このデバッグコン

フィギュレーションに使用する必須のデバイスを選択します。

[Connect as root] gdbserver を開始するときに、［root］へのアクセスを選択しま

す。このオプションは選択したデバッグ操作によって変わり、

使用できない場合があります。

［gdbserver (TCP)］デバッガと gdbserver の間の接続に使用する、ターゲットの IP アドレスまたは名前とそれに対応するポート番号を指定します。



選択したデバッグ操作によっては、以下のオプションが用意されている場合があります。

• デバッグ対象のアプリケーションを再起動する場合は、［Use Extended Mode］チェックボックスを選択します。このオプションは、すべてのターゲットの gdbserver で完

全に実装されていない場合があります。

• ［Terminate gdbserver on disconnect］チェックボックスを

選択して、ターゲットから切断するときに gdbserver を終

了します。

• ［Use RSE Host］チェックボックスを選択して、 RSE 設定

ホストを使用して gdbserver に接続します。

［gdbserver (serial)］デバッガと gdbserver の間のシリアル接続に対して、ローカル

シリアルポートおよび接続速度を指定します。 RTSM 接続の場合は、 gdbserver の詳細情報をターゲットから自

動的に取得します。

デバッグ対象のアプリケーションを再起動する場合は、［Use Extended Mode］チェックボックスを選択します。このオプ

ションは、すべてのターゲットの gdbserver で完全に実装され

ていない場合があります。

［Bare Metal Debug］ターゲットの IP アドレスまたはデバッグハードウェアエー

ジェントの名前を指定します。［Browse...］をクリックして、

ローカルサブネットまたは USB 接続で使用できるすべてのデ

バッグハードウェアエージェントを表示することもできます。

［Model parameters］

以下のオプションは、 RTSM プラットフォームでのみ有効になります。

ローカルホスト上のディレクトリからアプリケーションおよび関連する共有ライブラリファイルをモデルで実行できる仮想ファイルシステム（VFS）を設定できます。または、 VFS を無効にして、ファイルをモデル

のディレクトリに手動で転送することもできます。

［Enable Virtual File System support］ VFS の使用を有効または無効にします。

［Host mount point］ローカルホスト上のファイルシステムの場所を以下のいずれかの方法で指定します。

• 表示されるフィールドに場所を入力します。

• ［File System...］をクリックして、ワークスペースの外部

の場所のディレクトリを検索します。

• ［Workspace...］をクリックして、ワークスペース内の

ディレクトリを検索します。

ワークスペースルートディレクトリを選択できます。

［Remote target mount point］モデルのファイルシステムのデフォルトの場所を表示します。デフォルトは /writeable ディレクトリです。



［Apply］現在のコンフィギュレーションを保存します。これはターゲットに接続

されません。

［Revert］変更を元に戻して、後に保存したコンフィギュレーションに戻しま

す。

［Debug］ターゲットに接続して、［Debug Configurations］ダイアログボックスを

閉じます。

［Close］［Debug Configurations］ダイアログボックスを閉じます。

図 10-34 VFS を使用したモデルの接続コンフィギュレーション

10.29.1 関連項目

タスク












（3-9 ページ）


（3-10 ページ）

— RSE 接続を使用した ARM Linux ターゲットの操作（3-11 ページ） .


— ダイナミックヘルプの表示（2-39 ページ）

— 第 5 章リモートシステムエクスプローラの使用 .

参照







• ARM® DS-5 ™ARM® DSTREAM™ ハードウェアの設定 , http://infocenter.arm.com/help/topic/com.arm.doc.dui0481-/index.html

• ARM® DS-5™ ARM® の RVI™ と RVT™ ハードウェアの設定 , http://infocenter.arm.com/help/topic/dui0515-/index.html.



10.30 ［Debug Configurations］ - ［Files］タブ

［Debug Configurations］ダイアログボックスの［Files］タブでは、デバッガを使用す

るホスト上のアプリケーションファイルおよびライブラリのデバッグバージョンを選択できます。必要に応じて、ファイルを転送できるターゲットファイルシステムの

フォルダを指定することもできます。

注［Files］タブのオプションは、選択するプラットフォームおよびデバッグ操作のタイ

プに依存します。

［Files］以下のオプションを使用すると、ターゲットファイルシステムを設定

し、ターゲットにダウンロードするかデバッガで使用するホスト上のファイを選択できます。各デバッグ操作に使用できる［Files］タブのオ

プションは、以下のとおりです。


されません。


す。


閉じます。


表 10-1 各デバッグ操作に使用できる［Files］タブのオプション

ダウンロードおよび

デバッグアプリケーション

デバッグターゲット

上のアプリケーション

既に実行している

gdbserver への接続

DSTREAM/RVI を介したデバッグ

DSTREAM/RVI を介したデバッグおよび ETB トレース

Application on host to download 可 - - 可可

Application on target - 可 - - -

Target download directory 可 - - - -

Target working directory 可可 - - -

Load symbols from file 可可可可可

Other file on host to download 可 - - - -

Path to target system root directory

可可可 - -



図 10-35 モデルのアプリケーションに対するファイルシステムの設定

10.30.1 ［Files］オプションの概要

使用できる［Files］オプションは、［Connection］タブで選択したデバッグ操作に

よって異なります。使用できる［Files］オプションは以下のとおりです。

［Application on host to download］

ターゲットにダウンロードするホスト上のアプリケーションのイメージファイルを、以下のいずれかの方法で指定します。

• 表示されるフィールドにホストの場所およびファイル名を入力します。

• ［File System...］をクリックして、 Eclipse ワークスペースの外部に

あるディレクトリのファイルを選択します。

• ［Workspace...］をクリックして、 Eclipse ワークスペース内のプロ

ジェクトディレクトリまたはサブディレクトリのファイルを選択します。

例えば、除外された（デバッグはありません） Gnometris アプリ

ケーションイメージをダウンロードするには、gnometris/stripped/gnometris ファイルを選択します。

［Load symbols］を選択して、指定したイメージのデバッグシンボルを

ロードします。



［Enable on-demand loading］を選択して、デバッガでデバッグ情報を

ロードする方法を指定します。このオプションを有効にすると、ロード

時間が短縮され、メモリの使用量も小さくなりますが、デバッグの速度が低下することがあります。

プロジェクトディレクトリ

ホストで Android プロジェクトディレクトリを指定します。

• 表示されるフィールドにホストの場所を入力します。

• ［ファイルシステム ...］をクリックして、 Eclipse ワークスペースの

外部にある場所のプロジェクトディレクトリを選択します。

• ［ワークスペース ...］をクリックして、 Eclipse ワークスペース内の

プロジェクトディレクトリを選択します。

APK ファイル

ターゲットにダウンロードするホスト上の Android APK ファイルを指定

します。


• ［File System...］をクリックして、 Eclipse ワークスペースの外部に

あるディレクトリのファイルを選択します。

• ［ワークスペース ...］をクリックして、 Eclipse ワークスペース内の

プロジェクトディレクトリまたはサブディレクトリのファイルを選択します。

プロセスこのフィールドは、 AndroidManifest.xml ファイルから自動的に入力され

ます。

アクティビティこのフィールドは、 AndroidManifest.xml ファイルから自動的に入力さ

れます。

［Application on target］

ターゲット上のアプリケーションの場所を指定します。 gdbserver でこれ

を使用してアプリケーションを起動します。

例えば、モデルを使用するときや、 VFS がホストワークスペースをター

ゲット上の /writeable としてマウントするように設定されているとき

に、除外された（デバッグはありません） Gnometris アプリケーション

イメージを使用するには、表されるフィールドで以下のように指定します。

/writeable/gnometris/stripped/gnometris.

［Target download directory］

ターゲットにプリロードされたイメージがある場合は、ホスト上の対応するイメージの場所を指定する必要があります。

デバッガは、ターゲット上のアプリケーションイメージの場所をデフォルトの現在の作業ディレクトリとして使用します。デバッグするアプリ

ケーションのデフォルト設定を変更するには、表示されるフィールドに場所を入力します。現在の作業ディレクトリは、アプリケーションが相

対パスを使ってファイルを参照するたびに使用されます。



［Load symbols from file］

ロードするデバッグ情報を含むアプリケーションイメージを以下いずれかの方法で指定します。


• ［File System...］をクリックして、ワークスペースの外部にある

ディレクトリのファイルを選択します。

• ［ワークスペース ...］をクリックして、ワークスペース内のプロ

ジェクトディレクトリまたはサブディレクトリのファイルを選択します。

例えば、 Gnometris のデバッグバージョンをロードするには、 gnometris プロジェクトルートディレクトリで使用できる gnometris アプリケー

ションイメージを選択する必要があります。

［Enable on-demand loading］を選択して、デバッガでデバッグ情報を

ロードする方法を指定します。このオプションを有効にすると、ロード

時間が短縮され、メモリの使用量も小さくなりますが、デバッグの速度が低下することがあります。

ここで共有ライブラリファイルを指定できますが、通常は、［Debugger］タブの［Shared library search directory］オプションを使用して共有ラ

イブラリへのパスを指定します。

［Other file on host to download］

ターゲットにダウンロードする他のファイルを以下いずれかの方法で指定します。


• ［File System...］をクリックして、ワークスペースの外部にある

ディレクトリのファイルを選択します。

• ［Workspace...］をクリックして、ワークスペース内のプロジェク

トディレクトリまたはサブディレクトリのファイルを選択します。

例えば、除外された（デバッグはありません） Gnometris 共有ライブラ

リをターゲットにダウンロードするには、gnometris/stripped/libgames-support.so ファイルを選択してください。

ターゲットシステムのルートディレクトリのパス

共有ライブラリのシンボルを検索するためのシステムルートディレクトリを指定します。

デバッガはこのディレクトリを使用して、ターゲット共有ライブラリのデバッグバージョンのコピーを検索します。ホストワークステーション

のシステムルートに、ターゲットルートファイルシステムにあるライブラリの正確な表現が含まれている必要があります。

［Target working directory］

このフィールドが指定されていない場合、デバッガは、ターゲット上のアプリケーションイメージの場所をデフォルトの現在の作業ディレクトリして使用します。デバッグするアプリケーションのデフォルト設定を

変更するには、表示されるフィールドに場所を入力します。現在の作業

ディレクトリは、アプリケーションが相対パスを使用してファイルを参照するたびに使用されます。



［Remove this resource from the list］

リソースをコンフィギュレーション設定から削除するには、削除するリソースの横にあるこのボタンをクリックします。

［Add a new resource to the list］

新しいリソースをファイル設定に追加するには、このボタンをクリックした上で、必要に応じてオプションを設定します。

10.30.2 関連項目

タスク










（3-9 ページ）


（3-10 ページ） .



参照









10.31 ［Debug Configurations］ - ［Debugger］タブ

［Debug Configurations］ダイアログボックスの［Debugger］タブでは、ターゲット

に接続した後にデバッガで行うアクションを指定することができます。

［Run Control］

以下のオプションを使用すると、接続するときにターゲットの実行状態を定義できます。

［Connect only］ターゲットに接続しますが、アプリケーションは実行されません。

注 PC レジスタは設定されていません。接続が確立されると、保

留中のブレークポイントまたはウォッチポイントは後で無効になります。

［Debug from entry point］接続が確立されたときにアプリケーションを実行して、イメージのエントリポイントで停止します。

［Debug from symbol］接続が確立されたときにアプリケーションを実行して、指定したシンボルのアドレスで停止します。デバッガはシンボルを

解決する必要があります。 C または C++ 関数名を指定する場合

は、接尾文字 () を使用しないでください。

シンボルが解決できた場合、シンボルのアドレスで実行を停止します。

シンボルを解決できないと、シンボルが見つからないことを警告するメッセージが［Commands］ビューに表示されます。次に、デバッガはイメージエントリポイントで停止しようとします。

［Run target initialization debugger script (.ds)］このオプションを選択すると、デバッガのコマンドが含まれているターゲット初期化スクリプトファイルを接続直後に実行できます。ファイルを選択するには、以下のいずれかを行います。



にあるディレクトリのファイルを選択します。

• ［ワークスペース ...］をクリックして、ワークスペース内

のプロジェクトディレクトリまたはサブディレクトリのファイルを選択します。



［Run debug initialization debugger script (.ds)］このオプションを選択すると、デバッガコマンドが含まれているデバッグ初期化ファイルを、ターゲット初期化スクリプトファイルの実行後、ま選択した場合はイメージエントリポイントまたはシンボルまで実行した後で実行できます。ファイルを選択するには、以下のいずれかを行います。




• ［Workspace...］をクリックして、ワークスペース内のプ

ロジェクトディレクトリまたはサブディレクトリのファイルを選択します。

注 run または continue コマンドの前に wait コマンドを挿入し

て、デバッガを接続し、アプリケーションを指定した関数まで実行できるようにする必要があります。

［Execute debugger commands］初期化スクリプトの完了時に実行される特定のデバッガコマンドを自動的に実行する場合は、表示されるフィールドにデバッガコマンドを入力します。 1 行につき、 1 つのデバッガコ

マンドのみを指定する必要があります。

［Host working directory］デバッガは、 Eclipse ワークスペースをホスト上のデフォルト

の作業ディレクトリとして使用します。デバッグするアプリ

ケーションのデフォルト定を変更するには、［Use default］チェックボックスの選択を解除して、以下の操作を行います。


• ［File System...］をクリックして、外部ディレクトリを検

索します。

• ［Workspace...］をクリックして、プロジェクトディレク

トリを検索します。

［Paths］デバッガがソースコードを表示するときに使用するホスト上の検索パス

を変更できます。

［Source search directory］ソースファイルを検索するディレクトリを以下のいずれかの方法で指定します。








共有ライブラリ検索ディレクトリ共有ライブラリで検索するディレクトリを以下のいずれかの方法で指定します。






［Remove this resource from the list］

コンフィギュレーション設定から検索パスを削除するには、削除するリソースの横にあるこのボタンをクリックします。

［Add a new resource to the list］

新しい検索パスをコンフィギュレーション設定に追加するには、このボタンをクリックした上で、必要に応じてオプションを設定します。


されません。


す。

デバッグターゲットに接続して、［Debug Configurations］ダイアログボックスを

閉じます。




図 10-36 アプリケーションの開始位置および検索パスを設定するデバッガコンフィギュレーション

10.31.1 関連項目

タスク










（3-9 ページ）


（3-10 ページ） .





参照









10.32 ［Debug Configurations］ - ［Arguments］タブ

アプリケーションで main() コマンドライン引数を受け取る場合は、実行を開始した

ときにアプリケーションに渡される値を指定できます。

［Debug Configurations］ダイアログボックスの［Arguments］タブでは、アプリケー

ションに渡される引数を入力できます。

注このタブの設定は、［Connect to already running gdbserver］デバッグ操作を使用する

接続には使用されません。

［Arguments］タブには、以下の要素があります。

［Program Arguments］

このパネルでは引数を入力できます。テキストが、関連した値を使って Eclipse によって置き換えられる形式 ${var_name} の Eclipse 引数変数であ

る場合を除いて、引数は変更されずにターゲットアプリケーションに渡されます。

Linux ターゲットの場合は、バックスラッシュ（\）文字を使用して一部

の文字をエスケープする必要があります。例えば、 @、 (、 )、 "、および # 文字をエスケープする必要があります。

［Variables...］このボタンを使用すると、デバッグセッションを開始したときにアプ

リケーションに渡される変数を選択できる［Select Variable］ダイアログ

ボックが開きます。


されません。


す。

デバッグターゲットに接続して、［Debug Configurations］ダイアログボックスを

閉じます。




図 10-37 アプリケーションの引数の設定

10.32.1 関連項目

タスク










（3-9 ページ）


（3-10 ページ） .





参照









10.33 ［Debug Configurations］ - ［Environment］タブ

［Debug Configurations］ダイアログボックスの［Environment］タブでは、デバッグ

セッションの開始時にアプリケーションに渡されるターゲット環境引数を作成して設定できます。

注このタブの設定は、［Connect to already running gdbserver］デバッグ操作を使用する

接続には使用されません。

［Environment］タブには以下の要素があります。

［Target environment variables to set］

このパネルには、デバッガで使用する現在のターゲット環境変数が表示されます。

［New...］このボタンを使用すると、新しいターゲット環境変数を作成できる

［New Environment Variable］ダイアログボックスが開きます。

例えば、モデルの Gnometris アプリケーションをデバッグするには、

DISPLAY 設定に対してターゲット環境変数を作成する必要があります。

図 10-38 ターゲット環境変数の設定

［Edit...］このボタンを使用すると、選択したターゲット環境変数のプロパティを

編集できる［Edit Environment Variable］ダイアログボックスが開きます。

削除このボタンを使用すると、選択したターゲット環境変数をリストから削

除できます。


されません。


す。


閉じます。




図 10-39 モデルの環境設定

10.33.1 関連項目

タスク










（3-9 ページ）


（3-10 ページ） .





参照









10.34 ［Debug Configurations］ - ［Event Viewer］タブ

［Debug Configurations］ダイアログボックスの［Event Viewer］タブでは、イベント

データのキャプチャ時にデバッガで使用するインストルメンテーショントレースマクロセル（ITM）チャネルを設定できます。

注このタブの設定は、 ITM キャプチャがサポートされているターゲットのみに対して

有効になります。

［Event Viewer］タブには以下の要素があります。

［Enable ITM capture］

ITM キャプチャを有効または無効にします。

［Max analysis trace depth］

トレースバッファのサイズを指定します。大値は 4GB ですが、データ

転送と処理時間を小限に抑えるためにバッファの一部のみを使用するよ選択できます。バッファに保存されるデータは ITM パケットとしてエ

ンコードされ、他のトレースデータとインターリーブされる可能性があります。したがって、バッファから復元できる固有のデータの実際の量

は、設定されているバッファサイズよりも少ない可能性があります。

［ITM Channel Configuration］

アプリケーションソースコードで使用される注釈と一致するように、ITM チャネルを設定します。

［ITM Channel］チャネル番号を指定します。

［Encoding］選択したチャネルのエンコーディングを選択します。

［RAW TEXT］生のテキストの場合に選択します。

［ENCODED］生のテキストに加えてタイムスタンプを生成できる形式でデータをエンコードする場合に選択します。

［File Output］イベントデータの送信先を指定します。

［None］ファイルではなくチャネルエディタでデータを表示

する場合に選択します。

［Append］チャネルエディタでデータを表示し、テキストファ

イルの既存のデータに追加する場合に選択します。

［Overwrite］チャネルエディタでデータを表示し、テキストファイルに書き込む場合に選択します。テキストファイ

ルの既存のデータは破棄されます。



［Output File］イベントデータの保存時に使用する出力ファイルを指定します。




• ［ワークスペース ...］をクリックして、ワークスペース内

のプロジェクトディレクトリまたはサブディレクトリのファイルを選択します。


されません。


す。


閉じます。


図 10-40 イベントビューアの設定



10.34.1 関連項目

タスク










（3-9 ページ）


（3-10 ページ） .



参照

• イベントビューアのチャネルエディタ（10-18 ページ）








10.35 DS-5 デバッガメニューとツールバーアイコン

以下の表では、 DS-5 デバッガでもよく使用されるメニューとツールバーアイコン

を説明します。以下の表に記載されていないアイコン、マークボタンなどについて

は、ヘルプの目次から標準の「Workbench User Guide」または「C/C++ Development User Guide」を参照してください。

ツールバーのアイコン上にマウスのポインタを置いてそのまま数秒クリックしないでいると、そのアイコンの用途の説明がヒントとして表示されます。



10.35.1 DS-5 デバッガのアイコン

表 10-2 DS-5 デバッガのアイコン

アイコン

説明アイコン

説明

ターゲットに接続します。ターゲットに接続した状態です。

ターゲットから切断します。接続を削除します。

アプリケーションを起動してメインまで実行します。

アプリケーションを起動してエントリポイントまで実行します。

エントリポイントからアプリケーションを実行します。

アプリケーションを再起動します。

アプリケーションの実行を継続します。

アプリケーションを停止します。

ステップ実行します。ステップオーバーします。

ステップアウトします。ステップ実行モードを切り替えます。

スタックトレースの設定をすべて折りたたみます。

コールスタック

スレッドプロセス

カーネルモジュール新しい RSE 接続を定義します。

RSE リソースツリーを更新します。ビューの内容をファイルに保存します。

ビューの内容をクリアします。［History］ビューに切り替えます。

ビューの内容を同期化します。スクロールロックを切り替えます。

スクリプトファイルからコマンドを実行します。

コマンドをスクリプトファイルにエクスポートします。

選択したブレークポイント、ウォッチポイント、または式（ビュー依存）を削除します。

すべてのブレークポイント、ウォッチポイント、または式（ビュー依存）を削除します。

ソースファイル内のブレークポイントの位置を表示します。

すべてのブレークポイントおよびウォッチポイントを非アクティブ化します。

ファイルからインポートします。ファイルにエクスポートします。

新しいスクリプトファイルを作成するか、新しい式（ビュー依存）を追加します。

選択したスクリプトファイルを実行します。

選択したファイルを開いて編集します。

選択したファイルを削除します。



表示幅を設定します。表示形式を設定します。

ASCII 文字の表示を切り替えます。フリーズモードを切り替えます。

［Screen］ビューパラメータを編集し

ます。

新しい［Screen］ビューを追加します。

新しい［Disassembly］ビューを追加

します。

新しい［Variables］ビューを追加します。

新しい［Registers］ビューを追加しま

す。

新しい［Memory］ビューを追加します。

新しい［Expressions］ビューを追加

します。

新しい［Trace］ビューを追加します。

関数ビューを追加します。進行中のビューのアップデート

トレースのマークを切り替えます。次の一致を表示します。

前の一致を表示します。命令トレースを表示します。

関数トレースを表示します。ナビゲーションの解像度を切り替えます。

ビューを切り替えます。

表 10-2 DS-5 デバッガのアイコン（続き）

アイコン

説明アイコン

説明



10.35.2 パースペクティブアイコン

10.35.3 ビューアイコン

10.35.4 ビューのマーク

表 10-3 パースペクティブアイコン

アイコン説明アイコン

説明

新しいパースペクティブを開きます。 C/C++

DS-5 デバッグファーストビューバー

表 10-4 ビューアイコン

ボタン説明ボタン説明

ドロップダウンメニューを表示します。ビューの内容を同期化します。

ビューを小化します。ビューを大化します。

ビューを元のサイズに戻します。ビューを閉じます。

表 10-5 ビューのマーク


説明

イネーブルされたソフトウェアブレークポイント

イネーブルされたハードウェアブレークポイント

イネーブルされたアクセスウォッチポイント

イネーブルされた読み出しウォッチポイント

イネーブルされた書き込みウォッチポイント

ディセーブルされたソフトウェアブレークポイント

ディセーブルされたハードウェアブレークポイント

ディセーブルされたアクセスウォッチポイント

ディセーブルされた読み出しウォッチポイント

ディセーブルされた書き込みウォッチポイント

保留中のソフトウェアブレークポイント保留中のハードウェアブレークポイント

保留中のアクセスウォッチポイント保留中の読み出しウォッチポイント

保留中の書き込みウォッチポイント接続されていないソフトウェアブレークポイント

接続されていないハードウェアブレークポイント

接続されていないアクセスウォッチポイント



10.35.5 その他のアイコン

接続されていない読み出しウォッチポイント

接続されていない書き込みウォッチポイント

イネーブルされた複数のステートメントのソフトウェアブレークポイント

ディセーブルされた複数のステートメントのソフトウェアブレークポイント

エラー現在の位置

警告ブックマーク

情報タスク

検索結果

表 10-6 その他のアイコン


説明

新しいリソースを作成するためのウィザードを開きます。

新しいプロジェクトを作成するためのウィザードを開きます。

新しいフォルダを作成するためのウィザードを開きます。

新しいファイルを作成するためのウィザードを開きます。

検索のためのダイアログボックスを開きます。

コンテキストヘルプを表示します。

インポートするためのウィザードを開きます。

エクスポートするためのウィザードを開きます。

表 10-5 ビューのマーク（続き）


説明


第 11 章トラブルシューティング

以下の各トピックでは、 DS-5 デバッガを使用してアプリケーションをデバッグすると

きに問題を診断する方法について説明します。

概念


• デバッガからの内部ログの有効化（11-3 ページ）


その他の情報

• ARM Technical Support Knowledge Articles, http://infocenter.arm.com/help/topic/com.arm.doc.faqs/index.html


トラブルシューティング

11.1 ARM Linux の問題と解決法

Linux アプリケーションのデバッグ時に以下の問題が発生する可能性があります。

11.1.1 ARM Linux パーミッションの問題

ターゲットでアプリケーションを開始したときにパーミッションが拒否されたというエラーメッセージを受けとった場合は、アプリケーションの実行パーミッションの変更が必要になることがあります。 :

chmod +x myImage

11.1.2 ブレークポイントに達していません

ターゲット上のアプリケーションおよび共有ライブラリがホスト上のものと同じであることを確認して下さい。コードレイアウトは同じでなければなりませんが、ター

ゲット上のアプリケーションおよび共有ライブラリにはデバッグ情報は不要です。

11.1.3 オペレーティングシステムのサポートは有効ではありません

オペレーティングシステム（OS）サポートが必要な場合、可能であればデバッガに

より自動的にアクティブ化されます。 OS サポートが必要であるがアクティブ化でき

ない場合、デバッガでエラーが生成されます。 :

ERROR(CMD16-LKN36):! Failed to load image "gator.ko"! Unable to parse module because the operating system support is not active

以下の場合は OS サポートをアクティブ化できません。

• vmlinux ファイルのデバッグ情報がターゲット上で実行するカーネル内のデータ

構造と正確に一致しない場合

• set os enabled off コマンドを使用して手動で無効にした場合

カーネルバージョンの一致を調べるには

• vmlinux イメージをロードした後にターゲットを停止します。

• print init_nsproxy.uts_ns->name コマンドを入力します。

• $1 出力が正しいことを確認します。 :$1 = {sysname = "Linux", nodename = "AEL", release = "2.6.35-ds5", version = "#1 Thu Nov 25 11:34:07 GMT 2010", machine = "armv7l", domainname = "(none)"}

11.1.4 関連項目

タスク • 共有ライブラリのデバッグについて（6-12 ページ） .



11.2 デバッガからの内部ログの有効化

まれに、内部エラーが起こり、お住まいの地域のサポート担当者に報告するよう勧めるエラーメッセージがデバッガで生成されることがありますスタックトレースを

取得してデバッガ内のエラーの発生箇所を示す内部ログとともにフィードバックすることで、デバッガを向上させることがきます。 DS-5 の現在のバージョンを取得す

るには、 Eclipse の［Help］メニューから［About ARM DS-5］を選択するか、または

製品のリリースノートを開きます。

11.2.1 手順

Eclipse 内の内部ログを有効にするには、 DS-5 デバッグパースペクティブのコマンド

ビューに以下を入力します。

1. 定義済みの DEBUG レベル設定を使用してデバッガからのログメッセージの出

力を有効にするには、以下を入力します。

log config debug

2. すべてのログメッセージをデバッガからファイルに転送するには、以下を入力します。

log file debug.log

注内部ログを有効にすると、大きなファイルが生成され、デバッガの速度が大幅に低

下する可能性があります。問題が発生したときにのみ内部ログを有効にして下さい。

11.2.2 関連項目

タスク • 第 1 章表記規則とフィードバック .

参照

• ［Commands］ビュー（10-20 ページ） .








11.3 ターゲット接続の問題と解決法

ターゲットへの接続時に以下の問題が発生する可能性があります。

11.3.1 接続の失敗

以下の理由で、選択されたデバッグターゲットにデバッガが接続できない可能性があります。

• デバッグターゲットを使用するための有効なライセンスを持っていない。

• デバッグターゲットがインストールされていないか接続が無効になっている。

• ターゲットハードウェアが別のユーザによって使用されている。

• 誤って終了したソフトウェアにより接続が開いたままになっている。

• ターゲットが設定されていないか、コンフィギュレーションファイルが見つからない。

• ターゲットハードウェアの電源が入っておらず使用できる状態になっていない。

• ターゲットが他のものによって使用が要求されているスキャンチェイン上にある。

• ターゲットハードウェアが接続されていない。

• gdbserver を介して接続する場合にターゲットで gdbserver が実行されていない。

• ホストからターゲットへのイーサネット接続がない。

• ホストおよびターゲットによって使用されているポート番号が間違っている。

ターゲット接続とパワーアップ状態を確認したら、ターゲットを接続し直して下さい。

11.3.2 デバッガ接続設定

以下の理由で、ベアメタルターゲットのデバッグ時にデバッガを接続できない可能性があります。

• ヒープベースアドレスが間違っている。

• スタックベース（メモリの先頭）アドレスが間違っている。

• ヒープリミットアドレスが間違っている。

• ベクタキャッチ設定が間違っている。

選択したターゲットについてメモリマップ設定が正しいことを確認します。設定が間

違っていると、スタックの破損、またはアプリケーションがそのコードを上書きするために、アプリケーションがクラッシュする可能性があります。

11.3.3 関連項目






その他の情報 • マニュアルはボードに付属しています。


arm ds-5 デバッガの使用infocenter.arm.com/help/topic/com.arm.doc.dui0446ij/dui...目次 arm...

Documents