8.2 コマンドラインデバッガのオプション

以下のオプションを使用すると、コマンドラインからグラフィカルユーザインタフェースを使用しないで DS-5デバッガを実行できます。

Windows を使用している場合は、DS-5 Command Prompt]を使用します。Linux の場合は、必要な環境変数を設定し、UNIX シェルを使用します。

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

debugger [--optionarg] ...

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

debugger
DS-5 コマンドラインデバッガを呼び出します。
--option arg
デバッガオプションとその引数。コマンドラインデバッガの設定を行うかまたはターゲットに接続するためのオプションとその引数を使用できます。
...
必要に応じて追加のオプションを指定します。

注:

ターゲットに接続したら、 DS-5デバッガコマンドのいずれかを使用してターゲットにアクセスし、デバッグを開始します。

例えば、 info registers はすべてのアプリケーションレベルのレジスタを表示します。

オプション

--browse
使用可能な接続を参照して、コンフィギュレーションデータベースエントリで指定された接続の型に一致するターゲットを一覧表示します。

注:

--cdb-entry arg パラメータを --browse
に指定する必要があります。
--cdb-entry arg

デバッガが接続できるコンフィギュレーションデータベースからのターゲットを指定します。

arg を使用して、ターゲットコンフィギュレーションを指定します。arg は各レベルのコンフィギュレーションデータベースでのエントリを使用して連結された文字列です。arg の構文は以下のとおりです。

"Manufacturer::Platform::Project type::Execution environment::Activity::Connection type"

--cdb-list を使用して、デバッガが接続できるコンフィギュレーションデータベースのエントリを判断します。"ARM Development Boards""ARM Development Boards::Versatile Express A9x4" など、エントリを入力して Enter キーを押すと、次の可能性のあるエントリが表示されます。

たとえば、DSTREAM と USB 接続を使用して ARM Versatile Express A9x4 ターゲットに接続するには、最初に --cdb-list を使用して、ARM 開発ボード 内のコンフィギュレーション データベースのエントリを特定します。次に、以下を使用します。

debugger --cdb-entry "ARM Development Boards::Versatile Express A9x4::Bare Metal Debug::Bare Metal SMP Debug of all cores::Debug Cortex-A9x4 SMP::DSTREAM" --cdb-entry-param "Connection=USB:000271"
--cdb-entry-param arg
デバッガの接続パラメータを指定します。
arg を使用して、パラメータとその値を指定します。arg の構文は、パラメータと値のペア("param1=value1" など)をコンマで区切ったものです。--cdb-list を使用して、デバッガが必要とするパラメータを特定します。デバッガが必要とする可能性があるパラメータは、次のとおりです。
Connection
接続先デバッグアダプタの TCP アドレスまたは USB ポート番号を指定します。
Address
gdbserver 接続のアドレスを指定します。
Port
gdbserver 接続のポートを指定します。
dtsl_options_file
DTSL オプションを記載したファイルを指定します。
Model parameters
モデル接続用のパラメータを指定します。モデルパラメータは、デバッガの接続先である特定のモデルに依存します。パラメータおよびそれらの設定方法については、モデルのドキュメントを参照して下さい。デバッガでは、モデルパラメータ値が指定されない場合、デフォルト値が使用されます。

各パラメータに --cdb-entry-param を使用します。

例えば、--cdb-entry-param "Connection=TestTarget" --cdb-entry-param "dtsl_options_file=my_dtsl_settings.dtslprops"

です。
--cdb-list filter

コンフィギュレーションデータベースのエントリを一覧表示します。このオプションでは、どのターゲットにも接続しません。

コンフィギュレーションデータベースには、どのエントリにも内部にエントリが複数あるツリーデータ構造があります。--cdb-list により、各レベルのデータベースのエントリが特定されます。レベルは次のとおりです。

  1. 製造元
  2. プラットフォーム
  3. [Project type]
  4. 実行環境
  5. アクティビティ
  6. 接続の型

filter を使用して、各レベルでのエントリを指定し、ターゲットと接続方法を特定します。filter はコンフィギュレーションデータベースの連続レベルのエントリを使用して連結された文字列です。filter の完全な構文は、"Manufacturer::Platform::Project type::Execution environment::Activity::Connection type" です。

filter の指定が不完全な場合、--cdb-list により、次のレベルのコンフィギュレーションデータベースのエントリが表示されます。そのため、filter を指定しない場合、--cdb-list により、最初のレベルのコンフィギュレーションデータベースからの Manufacturer エントリが表示されます。第 1 と第 2 レベルのコンフィギュレーションデータベースからのエントリを使用して、filter を指定する場合、--cdb-list により、指定された Platform 内の Project type エントリが表示されます。完全な filter を指定した場合、--cdb-list により、--cdb-list-param を使用して指定される必要があるパラメータが一覧表示されます。

注:

  • コンフィギュレーションデータベースのエントリでは、大文字と小文字が区別されます。
  • 接続の型は、DSTREAM または RVI を参照するため、モデルに接続するときには接続の型はありません。

コンフィギュレーションデータベースの最初のレベルのエントリを一覧表示するには、次を使用します。

debugger --cdb-list

例えば、製造元 Altera のコンフィギュレーションデータベースエントリをすべて一覧表示するには、次を使用します。

debugger --cdb-list="Altera"

--cdb-root arg
デバッガのデフォルトのコンフィギュレーションデータベースに加えて、追加のコンフィギュレーションデータベースの場所を指定します。

注:

  • 複数のコンフィギュレーション データベースを指定するには、ディレクトリ パスを、Linux システムではコロン (:)、Windows システムではセミコロン (;) で区切ります。
  • コンフィギュレーションデータベースルートの指定順序は、複数の異なるデータベースで同じ情報を使用できる場合に重要となります。つまり、最後に入力された場所(コマンドライン全体の末尾に最も近い場所)のデータは、それより前の場所のデータをオーバーライドします。
  • デフォルトのコンフィギュレーションデータベースのデータが不要な場合は、別のコマンドラインオプションの --cdb-root-ignore-default を使用して、デフォルトのコンフィギュレーションデータベースを使用しないようにデバッガに指示します。
--cdb-root-ignore-default
デフォルトのコンフィギュレーションデータベースを無視します。
--continue_on_error= true | false

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

デフォルトは --continue_on_error= false です。

--disable-semihosting
セミホスティング操作を無効にします。
--disable_semihosting_console
デバッガコンソールに対するすべてのセミホスティング操作を無効にします。
--enable-semihosting
セミホスティング操作を有効にします。
-h または --help
主なコマンドラインオプションの一覧を表示します。
-b= filename または --image= filename
デバッガがターゲットに接続したときにロードするイメージファイルを指定します。
--interactive
Windows コマンドプロンプトや Unix シェルなどの現在のコマンドラインコンソールからデバッガに標準入出力を転送するインタラクティブモードを指定します。

注:

スクリプトファイルが指定されていない場合は、これがデフォルトになります。
--log_config= arg
デバッガから実行時メッセージを出力するログコンフィギュレーションのタイプを指定します。
arg は、以下のように操作できます。
info - 定義済みの INFO レベル設定を使用する出力メッセージ。このレベルではデバッグメッセージを出力しません。これがデフォルトです。
debug - 定義済みの DEBUG レベル設定を使用する出力メッセージ。このオプションは INFO レベルと DEBUG レベルの両方のメッセージを出力します。
filename - メッセージの出力をカスタマイズするユーザ定義のログコンフィギュレーションファイルを指定します。デバッガは log4j コンフィギュレーションファイルをサポートします。
--log_file= filename
デバッガから実行時メッセージを受け取る出力ファイルを指定します。このオプションを使用しないと、出力メッセージはコンソールに転送されます。
--script= filename
ターゲットの制御とデバッグを行うデバッガコマンドを含むスクリプトファイルを指定します。複数のスクリプトファイルがある場合は、このオプションを繰り返し指定できます。スクリプトは指定された順序で実行され、最後のスクリプトが終了するとデバッガは終了します。最後のスクリプト終了後もデバッガをインタラクティブモードにしておきたい場合は、--interactive オプションをコマンドラインに追加します。
-e arg または --semihosting-error arg
セミホスティング stderr を書き込むファイルを指定します。
-i arg または --semihosting-input arg
セミホスティング stdin を読み出すファイルを指定します。
-o arg または --semihosting-output arg
セミホスティング stdout を書き込むファイルを指定します。
--stop_on_connect= true | false

ターゲットデバイスに接続したときにデバッガでターゲットを停止するかどうかを指定します。接続時にターゲットを変更しない場合は、false を指定する必要があります。デフォルトは --stop_on_connect= true です。

--top_mem= address
top of memory とも呼ばれるスタックベースを指定します。top of memory はセミホスティング操作にのみ使用されます。
--target-os= name
ターゲット上のオペレーティングシステムを指定します。ターゲット上のオペレーティングシステムをデバッグする場合は、このオプションを使用します。
--target-os-list

DS-5デバッガによってデバッグできるオペレーティングシステムを一覧にします。

注:

モデルへの接続を確立するには、--cdb-entry オプションを指定するだけで十分です。ただし、その他すべての場合に接続を確立する(Linux アプリケーションのデバッグを行ったり、DSTREAM を使用したりするなど)には、--cdb-entry オプションと --cdb-entry-param オプションの両方を指定しなければなりません。

その他すべてのオプションを有効にするには、デバッガを呼び出すときに通常は --cdb-entry を指定する必要があります。これの例外は、次のとおりです。

  • --cdb-list および --help では、--cdb-entry は不要です。
  • --cdb-root--cdb-list または --cdb-entry のいずれかを付けて指定することができます。

例 8-1 例

ARM FVP Cortex-A9x4 モデルに接続し、ロードするイメージを指定するには、以下を使用します。

debugger --cdb-entry "ARM FVP::VE_Cortex_A9x4::Bare Metal Debug::Bare Metal Debug::Debug Cortex-A9x4 SMP" --image "C:\DS-5_Workspace\fireworks_A9x4-FVP\fireworks-Cortex-A9x4-FVP.axf"

Beagleboard ターゲットの Linux アプリケーションに接続してデバッグするには、以下を使用します。

debugger --cdb-entry "beagleboard.org::OMAP 3530::Linux Application Debug::gdbserver (TCP)::Connect to already running gdbserver" --cdb-entry-param "Address=TCP:10.5.196.50" --cdb-entry-param "Port=5350"

Beagleboard ターゲットの Linux カーネルに接続してデバッグするには、以下を使用します。

debugger --cdb-entry "beagleboard.org::OMAP 3530::Linux Kernel and/or Device Driver Debug::Linux Kernel Debug::Debug Cortex-A8::DSTREAM" --cdb-entry-param "Connection=TCP:10.5.196.50"

DSTREAM と TCP/IP 接続を使用して Versatile Express Cortex-A15x2+A7x3 ターゲットの単一の Cortex A15 コアに接続するには、以下を使用します。

debugger --cdb-entry "ARM Development Boards::Versatile_Express_V2P-CA15_A7::Bare Metal Debug::Bare Metal Debug::Debug Cortex-A15_0::DSTREAM" --cdb-entry-param "Connection=TCP:10.8.197.59"

DSTREAM と TCP/IP 接続を使用して Juno ARM Development Platform (r0) big.LITTLE ターゲットに接続するには、以下を使用します。

debugger --cdb-entry "ARM Development Boards::Juno ARM Development Platform (r0)::Bare Metal Debug::Bare Metal Debug::Debug Cortex-A57/Cortex-A53 big.LITTLE::DSTREAM" --cdb-entry-param "Connection=TCP:10.2.194.40"

ヒント:

デバッガ接続が確立されたら、接続を終了するときに 「quit」 と入力します。
非機密扱いPDF file icon PDF 版ARM DUI0446ZJ
Copyright © 2010–2016 ARM.All rights reserved.