データ転送速度テストプログラム

データ転送速度テストプログラム（DTR）を使うと、実際の条件下で、有効なPCI Expressデータ転送速度を測定することができます。

ホストPCの要件

● ホストPCに、少なくとも1枚のCoaxlinkカードが挿入されている必要があります。
● ホストPCに、バージョン12.4以降のドライバーがインストールされている必要があります。

カメラの要件

● カメラは、画像データを連続的に配信するように設定されている必要があります。

インストール

DTRは、eGrabberドライバーに同梱されているgentl.exeコマンドラインツールに含まれているため、別途インストールする必要はありません。

DTRは、内部フレームストアを完全に埋めてからホストコンピューターに画像を転送することでデータ転送速度を測定しています。

1. すべてのバッファーがキューから削除されます（データストリームはこれらのバッファーを使用できません）。
2. データストリームおよびリモートデバイスが開始します。
3. フレームストアが一杯になると、リモートデバイスが停止します。
4. 現在のタイムスタンプが取得されます（t0）。
5. すべてのバッファーがデータストリームのキューに入れられ、転送が開始します。
6. バッファーがデータストリームから削除されます。
7. フレームストアが空になり、すべてのバッファーが取得されると、データストリームが停止します。

DTRプログラムは、data transfer rateを以下のように計算します。

- byte count = sum of each buffer's BUFFER_INFO_SIZE_FILLED

- t1 = last buffer's BUFFER_INFO_CUSTOM_EVENT_TIMESTAMP

- duration = t1 - t0

- data transfer rate = byte count / duration

GenTL Explorer

gentl [COMMAND] ... [OPTIONS]

Commands:
	info    Show detailed information about the transport layer system
	report  Generate a GenTL report archive (for Euresys tech support)
	xml     Download GenApi files (XML register descriptions)
	play    Open a data stream and acquire images (no display)
	view    Open a data stream and display images
	grab    Grab N images
	genapi  Enter the GenApi command-line interface or perform a GenApi operation
	read    Read data from a GenTL port
	write   Write data to a GenTL port
	event   Wait for events and display information about them
	script  Execute script
	run     Run an action
	dtr     Measure PCIe data transfer rate
	ber     Measure bit error rate confidence level (a.k.a. link validation tool)

Common flags:
		--cti=LIBPATH  		Path to GenTL producer library. 
					Default: use EURESYS_COAXLINK_GENTL64_CTI and
					GENICAM_GENTL64_PATH environment variables to 
					locate the library.
	-j=N				Limit the number of CPU cores to use to N (default: 2)
  	-h	--help         		Display help message
	-V	--version     		Print version information
		--numeric-version  	Print just the version number
	-v 	--verbose          	Loud verbosity
	-q 	--quiet            	Quiet verbosity
GenTL Explorer

gentl dtr [OPTIONS]

Flags:
       --if=ID                          Interface ID
       --dev=ID                         Device ID
       --ds=ID                          Data stream ID
       --device-access=ACCESS           Access flags used to open the device (GenTL standard access flags:
                                        DEVICE_ACCESS_READONLY, DEVICE_ACCESS_CONTROL, DEVICE_ACCESS_EXCLUSIVE;
                                        Coaxlink custom access flags:
                                        DEVICE_ACCESS_CUSTOM_READONLY_DEVICE_READONLY_STREAM) (default:
                                        DEVICE_ACCESS_CONTROL)
       --ro                             Open the device as read-only (shorthand for
                                        --device-access=DEVICE_ACCESS_READONLY)
       --buffers=INT                    Buffer count (default: 4)
       --buffersize=INT                 Buffer size
       --width=WIDTH                    Buffer width
       --height=HEIGHT                  Buffer height
       --pixelformat=ITEM               PFNC Pixel format
       --bayer=BAYERDECODINGMETHOD      Bayer method (Legacy, Advanced) (default: Advanced)
       --set=SETTINGS                   GenApi settings, such as Module.Feature=INT
       --setup=FILE                     Path to script to execute before starting stream
       --run=FILE                       Path to script to execute concurrently
       --timeout=INT                    Acquisition timeout, in milliseconds (default: infinite)
       --zero                           Zero memory when queuing buffers (default: memory is only zeroed when buffers
                                        are allocated)
       --remotexml=FILE                 Use FILE as register description (default: register description is read from
                                        remote device)
  -n   --repeat[=N]                     Measure data transfer rate N times (default: 1)
Common flags:
       --cti=LIBPATH                    Path to GenTL producer library. Default: use EURESYS_COAXLINK_GENTL64_CTI and
                                        GENICAM_GENTL64_PATH environment variables to locate the library.
  -j=N                                  Limit the number of CPU cores to use to N (default: 2)
  -h   --help                           Display help message
  -V   --version                        Print version information
       --numeric-version                Print just the version number
  -v   --verbose                        Loud verbosity
  -q   --quiet                          Quiet verbosity
ヒント測定精度を高めるには、gentl ber -nオプションを使用して複数の測定を繰り返し実行します。DTRプログラムは結果を平均化します。