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

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

ホストPC要件

● カメラは静止画像パターンを生成できなければなりません。
● Coaxlinkドライバのバージョン12.4以上がホストPCにインストールされている必要があります。

カメラ要件

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

インストール

DRTはgentl.exeに含まれています。これは、Coaxlinkに提供されるコマンドラインツールです。追加のインストールは不要です。

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

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

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

- バイトカウント = 各バッファーのBUFFER_INFO_SIZE_FILLEDの合計

- t1 = 最後のバッファーのBUFFER_INFO_CUSTOM_EVENT_TIMESTAMP

- 所要時間 = t1 - t0

- データ転送速度 = バイトカウント/所要時間

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プログラムが結果を平均化します。