仮想JTAG(altera_virtual_jtag)IP コアのユーザーガイド

ID 683705
日付 10/31/2016
Public
ドキュメント目次

1.3.6. ランタイム通信

仮想JTAG IP コア用のTcl API は、各仮想JTAG インスタンスのVIR とVDR にアクセスするための一連のコマンドで構成されています。

これらのコマンドには、アルテラのプログラミング・ケーブルにアクセスし、各VIR およびVDR へのシフト・トランザクションを発行するための基礎となるドライバーが含まれています。以下の表は、仮想JTAG IP コアで使用できるquartus_stp 実行可能ファイル内のTcl コマンドを示しています。これらのコマンドは、カスタム・コントローラーを使用してJTAG チェーンを駆動するデザインを対象としています。

仮想JTAG IP コアの各インスタンス化には、インスタンス・インデックスが含まれています。すべてのインスタンスには順番に番号が付けられ、Quartus II ソフトウェアによって自動的に提供されます。インスタンス・インデックスは、インスタンス・インデックス0 から始まります。以下の表に記載されているVIR およびVDR シフトコマンドは、インスタンス・インデックスをデコードし、IP コア・インスタンスごとにSLD ハブにアドレスを提供します。IP コアのコンフィグレーション中にQuartus II ソフトウェアが提供するデフォルトのインデックスを上書きすることができます。

以下の表は、仮想JTAG IP コアで使用できるquartus_stp 実行可能ファイル内のTcl コマンドを示しています。これらのコマンドは、カスタム・コントローラーを使用してJTAG チェーンを駆動するデザインを対象としています。

表 7.  仮想JTAG IP コアのTcl コマンド

コマンド

引数

概要

Device virtual ir shift

-instance_index <instance_index>

-ir_value <numeric_ir_value>

-no_captured_ir_value 1

-show_equivalent_device_ir_dr_shift 1

instance_index で指定された仮想JTAG インスタンスに対してIR シフト操作を実行します。ir_value は数値引数を取ることに注意してください。

Device virtual dr shift

-instance_index <instance_index>

-dr_value <dr_value>

-length <data_register_length>

-no_captured_dr_value 1

-show_equivalent_device_ir_dr_shift

-value_in_hex 1

仮想JTAG インスタンスに対してDR シフト操作を実行します。

Get hardware names

なし

使用可能なすべてのプログラミング・ケーブルを問い合わせます。

Open device

-device_name <device_name>

-hardware_name <hardware_name>

JTAG チェーン上のアクティブデバイスを選択します。

Close device

なし

アクティブなJTAG デバイスとの通信を終了します。

Device lock

-timeout <timeout>

JTAG チェーンとの排他的な通信を取得します。

Device unlock

なし

device_lock を解放します。

Device ir shift

-ir_value <ir_value>

-no_captured_ir_value

IR シフト操作を実行します。

Device dr shift

-dr_value <dr_value>

-length <data register length>

-no_captured_dr_value

-value_in_hex

DR シフト操作を実行します。

仮想JTAG IP コアの中心は、device_virtual_ir_shift コマンドとdevice_virtual_dr_shift コマンドです。これらのコマンドは、各VIR/VDR へのシフト操作を実行し、アドレスをアクティブなJTAG データパスのSLD ハブに提供します。

device_virtual_ir_shift コマンドは、JTAG 命令レジスターにUSER1 命令を発行し、続いて正しいSLD ノード・インスタンスをターゲットにするためにアドレスビットによって先頭に付けられたir_value 引数によって提供されるVIR 値を含むDR シフトを発行します。

注:

現在のVIR 値の内容をシフトアウトすることに気にしない場合は、-no_captured_ir_value 引数を使用します。この引数を有効にすると、基本トランザクション内でコマンドサイクルを削除することで、VIR シフト・トランザクションの速度が向上します。

同様に、各device_virtual_dr_shift コマンドはUSER0 命令をJTAG 命令レジスターに発行し、その後にdr_value 引数によって提供されるVDR 値を含むDR シフトを発行します。これらのコマンドは、show_equivalent_device_ir_dr_shift オプションが設定された、基になるJTAG トランザクションを返します。

注:

device_virtual_ir_shift は、ir_value 引数を数値として受け取ります。device_virtual_dr_shift は、dr_value 引数を2 進列または16 進数文字列のいずれかで受け取ります。device_virtual_dr_shift に数値を使用しないでください。

1 この引数はオプショナルです。