Persistent Settings in GenICam Driver

<< Click to Display Table of Contents >>

Navigation:  CVB with GenICam > Configuration >

Persistent Settings in GenICam Driver

 

Driver Specific Configuration Files

 

The driver specific configuration file is the GeniCam.ini-file (refer %CVBDATA%Drivers directory).

To set up and store the communication and data handling parameters for GenICam, this ini-file is required.

 

This file is updated automatically when changing parameters in the Device Options for configured devices in GenICam Browser.

So normally there is no need to manually edit the ini-file.

 

DeviceOptions

 

Options stored in GenICam.ini (example for GigE device)

 

 [SYSTEM]

 

 

Settings which apply to all devices of that kind in the system

 

 
 NumCameras=1

 

 

 Number of cameras

 CreateAutoIni=0

 internally used for the Device Configurator

 AutoSwitchEnable=0

 If set to 1 the driver loads the first configured device which is available. e.g. if the first device is not available  
 AutoSwitchEnable=0 would cause an Error Loading Image file. If set to 1 it would show the second device with no 

 error.

 DeviceUpdateTimeout=-1

 

 AutoConfigExecuted=1

 

 internally used for the Device Configurator

 [CHANNNEL_0]

 Settings which apply only to the first device [DEV0]. Please add additional sections for [DEV1] ... according to  
 your system setup

 TL=GEVTL.cti

 Link to used transport layer

 Interface=FD::Mac->00:E0:81:74:BC:B4

 FD:: FilterDriver is used | SD:: SocketDriver is used | Mac->Interface MAC-Address

 Device=Mac->00:01:0D:11:02:1F::169.254.18.178

 or

 Device=::UserName->MyCamera1 

 Device Identification : MAC and or IP Address or Username 

 

 UserName offers the possibility of being independent from hardware IDs.

 NumBuffer =3

 Number of buffers allocated at vin startup

Acquiring images and using image processing functions with high CPU workload simultaneously can still lead to lost frames. Use the G2GetGrabStatus CVB-function to show the lost frames. To avoid lost images it is possible to increase the image buffer. In times of high workloads the images will be buffered. CVB takes the oldest image for processing. This principle just works for tasks where the high workload of the CPU is not steady so that CVB is capable of emptying the buffers from time to time.

As a rule of thumb use as many buffers as the frames you acquire per second. Then the driver buffers one second.

 

 PacketSize=-1

 Size of a data packet. For optimized performance adapt to NIC Jumbo Frame (Jumbo Packet) size.

 -1 = Default  (1500 is used as packet size default value). 

  0 = Auto

 >1 = Set to value

 Can be used to reduce cpu usage.

 Attention: The network interface must also be configured to accept jumbo frames.

            Used switches in the network have to support jumbo frames also.

 

 InterPacketDelay=-1

 

 Sets the delay between data packets. Adapt to NIC optimized Inter Packet delay.
 An increase in this delay can reduce the peak bandwidth of a device.

     -1 Use Default

     >= 0 Set to specified Value

 

 PixelFormat=5

 Pixel format of the CVB Image

0 = Raw image what ever the device delivers

1 = Mono 8Bit

2 = RGB 8Bit

3 = Mono 16Bit

4 = RGB 16Bit

5 = Auto Detect (default) eg converts high bit to 8 bit see chapter Colour Formats and Pixeldepth

option 2: For a bayer color camera the driver would do an 2x2 RGB conversion

 

RotateImage=0

 The image can be logically rotated in multiples of 90°:

   ; 0 = None

   ; 1 = 90deg

   ; 2 = 180deg

   ; 3 = 270deg

 

 AccessMode =4

 Access Mode

  2 - Read Only : used when the device is slave in a Multicast setup (not controllable by application)

  3 - Control : used when the device is the Multicast Master (controlled by application)

  4 - Exclusive : peer to peer connection. This is the normal mode

 

 PacketResend=1

 Activate or deactivate the packet resend mechanism for the specific device. Since CVB 12.00.000 the packet  
 resend is activated by default. 

 

 HeartbeatTimeout =-1

 This timeout controls how long the device waits for a signal from the application until it cancels that 
 connection to that application.

   -1 Use Default

   >= 500 Set to specified Value

 

 MCMasterMode =0

 1 = Device is Multicast Master

 

 MCSession =239.192.0.1

 The IP Address of the Multicast session

 

 Use Turbo Drive

 Enable or Disable Turbo Drive (for Dalsa cameras supporting this feature only).