Software Interface （ソフトウェアインターフェース）

11.3.1.1

11.3.1.2

11.3.1.3

Overview （概要）

The CoaXPress GenTL Producer shall provide all features (e.g. Device Enumeration, Port Enumeration, Setup configuration, Basic remote device access, Error handling, Function declarations, and Function Naming Convention) under the GenTL standard.

The software interface is defined in section 6 of “GenICam_GenTL_1_2.pdf”.

CoaXPress GenTL Producer は全ての機能（例:デバイス列挙，ポート列挙，セットアップ設定，基本遠隔デバイス アクセス，エラーハンドリング，関数定義，関数名前規約）を GenTL 規格に従って全て提供すること<SHALL>。

ソフトウェアインターフェースは“GenICam_GenTL_1_2.pdf”のセクション 6 に定義されている。

Installation （インストール方法）

The installation method is defined in section 6.1.1 of “GenICam_GenTL_1_2.pdf”.

インストール方法は“GenICam_GenTL_1_2.pdf”のセクション 6.1.1 に定義されている。

Requirements and Recommendations （必須および推奨要件）

This section outlines requirements and recommendations for Host vendors.

このセクションは，ホストベンダー向けの必要条件および推奨について概説する。

Environment Requirements:

 Shall provide the GenTL Producer file(‘cti’).

 Shall add the environment values GENICAM_GENTL{32/64}_PATH in the target OS.

環境要件：

 GenTL Producer ファイル(‘cti’)を提供<SHALL>

 インストール時に対象 OS に環境変数 GENICAM_GENTL{32/64}_PATH を追加<SHALL>

Implementation Requirements:

 Shall be implemented with a C language Interface.

 Shall implement and export all functions in the library’s interface.

Comment: These exported functions are defined in section 6.3 of “GenICam_GenTL_1_2.pdf”.

 Shall implement error handling through the GenTL GCGetLastError function. Additionally the Error Signaling mechanism may be implemented for asynhcronous errror reporting to the GenTL Consumer.

 Shall implement at least ‘Port of the Device module’ functionality (Read and Write Register access) for Control Channels.

Comment: GCReadPort and GCWritePort functions for access to the registers of a module are called on the module’s handle(for example on the PORT_HANDLE for the Device module). A GenApi XML description file and the GenApi Module of GenICam is used to access the virtual register map in the module using GenApi features. The URL containing the location of the corresponding GenICam XML description can be retrieved through a call to the GCGetPortURL function of the C interface.

 The Acquisition Engine of the GenTL Producer is implemented:

Shall implement access to the Port functionality (Read and Write Register access) while streaming data.

 Shall be thread safe and multi-process safe

Comment: The thread safe requirements are defined in section 6.1.4 of “GenICam_GenTL_1_2.pdf”.

実装要件:

 C 言語インターフェースで実装する<SHALL>

 ライブラリインターフェースの全ての関数をエクスポートする<SHALL>

コメント： 各エクスポート関数は“GenICam_GenTL_1_2.pdf”のセクション 6.3 に定義されている。

 GenTL の GCGetLastError 関数を通じたエラー処理を実装する<SHALL>。さらに，GenTL Consumer に非同 期エラーをレポートするためのエラー通知機構が実装される可能性がある。

 最低限，各コントロールチャネルのための‘デバイスモジュールの Port 機能’（読み出しおよび書き込みのレジ スタアクセス）を実装する<SHALL>

コメント: モジュールのレジスタへアクセスするための GCReadPort と GCWritePort 関数はモジュールハンドル（例：デバイス モジュールへの PORT_HANDLE）にて呼ばれる。GenApi XML 記述ファイルと GenICam の GenApi モジュールは 各 GenApi 機能を使用するモジュール内の仮想レジスタマップへアクセスするために用いられる。一致する GenICam XML 記述の場所を含む URL は，C 言語インターフェースの GCGetPortURL 関数呼び出しを通じて取 得できる。

 Gen TL Producer の獲得エンジンを実装した場合：

データストリーミング中の Port 機能（読み出しおよび書き込みのレジスタアクセス）を実装する<SHALL>

 スレッドセーフとマルチスレッド

コメント： スレッドセーフは“GenICam_GenTL_1_2.pdf”のセクション 6.1.4 に定義されている。

11.3.1.4 Implementation Recommendations （推奨される実装方法）

 It is recommended to implement the acquisition engine functionality.

o Acquisition engine o Data Stream Module o Buffer Module

o Event (Signaling Mechanism)

Comment: One of the features of the acquisition engine is acquiring streams (as in image data). Besides the acquisition engine has the Event (signaling mechanism for acquired data) and retrieve buffer mechanism. The Signaling is used to notify the GenTL Consumer on asynchronous events. For example, the changing event feature (signaling mechanism) communicates to a calling GenTL Consumer and generates a GenApi understandable event. A new Buffer event is signalled to GenTL Consumer. The Buffer Module acts as the destination for the Data Stream Module from the acquisition engine.

 獲得エンジン機能の実装を推奨する。

o 獲得エンジン

o データストリームモジュール o バッファモジュール

o イベント (通知機構)

コメント: 獲得エンジンの機能の一つとしてストリームを（画像データとして)獲得することがある。さらに獲得エンジンは，イベ ント(データ獲得に用いる通知機構)とバッファ取得機構を持つ。通知機構は非同期イベントにて GenTL Consumer へ通知するために用いられる。例えば，変更イベント機能(通知機構)は呼び出した GenTL Consumer と通信して，

GenApi が理解できるイベントを発行する。新規バッファイベントは GenTL Consumer に通知される。バッファモジュ ールは獲得エンジンからデータストリームモジュールへの宛先としてはたらく。