Installation and Setup
Installation
The CLVT is installed by the MultiCam installer together with the MultiCam driver.
The MultiCam installer installs a CLVT executable file, CameraLinkValidationTool.exe (Windows) or CameraLinkValidationTool (Linux), and a CLVT initialization template file, CameraLinkValidationTool.ini, into the following folders:
| ● | <InstallDir>\Bin\x86_64 for Windows 64-bit operating systems |
| ● | <InstallDir>\Bin\x86 for 32-bit operating systems |
| ● | /opt/euresys/multicam/bin/x86_64 for Linux x86-64 (64-bit) operating systems |
| ● | /opt/euresys/multicam/bin/x86 for Linux x86 (32-bit) operating systems |
The MultiCam installer also creates a CLVT user folder:
| ● | %USERPROFILE%\Documents\Euresys\CLVT on Windows |
| ● | ~/.euresys/clvt on Linux |
Finally, on Windows only, the MultiCam installer creates two shortcuts in the Euresys MultiCam program group of the Start Menu:
| 1. | Camera Link Validation Tool |
| 2. | Camera Link Validation Tool (64-bit) |
Initial Setup Procedure
| 1. | Run the Camera Link Validation Tool |
| □ | On Windows by clicking on the Camera Link Validation Tool or the Camera Link Validation Tool (64-bit) shortcut |
| □ | On Linux by executing CameraLinkValidationTool from any location |
If there is no .ini file in the CLVT user folder, this action copies the CLVT initialization template file CameraLinkValidationTool.ini to the CLVT user folder.
| 2. | Edit the CameraLinkValidationTool.ini file in the CLVT user folder |
| □ | Assign a value to each CLVT parameter |
CLVT Parameters
[Board ] parameters
The parameters of this section are used by the CLVT to configure the targeted Grablink board. Their name and value mimic the corresponding MultiCam parameter. For their value refer to the Grablink Parameters Reference documentation.
| Parameter Name | Description | Sample value |
|---|---|---|
| BoardIdentifier | The identifier of the target board in MultiCam. | GRABLINK_FULL_XR_000016 |
| BoardTopology | The topology of the target board in MultiCam. | MONO |
| Connector | The designation of the connector of the target board where the target camera is attached. | M |
| CamFile | Filename of the CamFile used to configure the MultiCam Channel. | MyCamera_P30RG.cam |
The CamFile of the application can be used as is provided that it doesn't activate any of the pixel processing feature of the Grablink board.
For a Bayer CFA camera, it is mandatory to disable the Bayer CFA decoder by
assigning the value BAYER* to the parameter
ColorFormat.
[Camera] parameters
The parameters of this section are used by the CLVT to customize the test report. Their value can be freely defined by the user to describe the measurement conditions.
| Parameter Name | Description | Sample value |
|---|---|---|
Manufacturer
|
The name of the camera manufacturer. | ACME Corporation
|
Model
|
The name of the camera model. | My Camera
|
Frequency
|
The frequency of the Camera Link® clock. | 30 MHz
|
TestPattern
|
The name of the test pattern. | Color Pattern 2
|
[Cable] parameters
The parameters of this section are used by the CLVT to customize the test report. Their value can be freely defined by the user to describe the measurement conditions.
| Parameter Name | Description | Sample value |
|---|---|---|
Manufacturer
|
The name of the camera cable manufacturer. | ACME Corporation
|
Model
|
The name of the camera cable model. | SDR26 to MDR26
|
Length
|
The length of the camera cable. | 5 meters
|
[Setup] parameters
| Parameter Name | Description | Sample value |
|---|---|---|
Description
|
A short description of the measurement. | BER confidence level for Grablink Full
XR
|
Mode
|
The operation mode of the CVLT. | AUTO
|
Mode parameter description
| Value Name | Description |
|---|---|
Auto
|
The CLVT automatically creates a reference image then starts the measurement. |
Prepare
|
The CLVT acquires one image then saves it into the <CLVT user folder>/CameralinkValidationTool.ref binary file for later use. |
Measure
|
The CLVT loads the <CLVT user folder>/CameralinkValidationTool.ref binary file then starts the measurement. |
Sample ini file
[Board]
BoardIdentifier=GRABLINK_FULL_XR_000016
BoardTopology=MONO
Connector=M
CamFile=MyCamera_P30RG.cam
[Camera]
Manufacturer=ACME Corporation
Model=My Camera
Frequency=30 MHz
TestPatternName=Color Pattern 2
[Cable]
Manufacturer=ACME Corporation
Model=SDR26 to MDR26
Length=5 meters
[Setup]
Description=BER confidence level for Grablink Full XR
Mode=Measure