Technical information

AVT GigE camera attributes

AVT GigE Camera and Driver Attributes V1.3.1

This document is a master document for all AVT GigE camera models and is NOT camera specific

GvspLookbackWindow – Uint32 – R/W

Units: packets

Size of the look back window when determining if a stream packet is missing.

When a stream packet arrives out of order, the driver skips back GvspLookback-

Window packets to see if the packets previous to this point have all arrived. If

not, a resend is issued. A lower value allows the driver less time to assemble

out-of-order packets; a larger value allows the driver more time. If the value is

set too low, the driver will issue unnecessary resends. If the value is set too high

and a packet truly is missing, the driver will issue a resend but the camera may

no longer have the required packet in its resend buffer and the packet will be

dropped. The ideal value is system dependent.

GvspResendPercent – Float32 – R/W

Maximum percentage of missing stream packets in a frame to still generate a

driver resend request. Frames with percentage of missing stream packets

beyond GvspResendPercent are marked as dropped.

GvspRetries – Uint32 – R/W

Maximum number of resend requests that the host driver will attempt before

marking a packet dropped.

GvspSocketBuffersCount – Enum – R/W

Number of buffers to be used by the network socket. Only applicable when not

using the Filter Driver.

GvspTimeout – Uint32 – R/W

Stream packet timeout. If no stream packet received before GvspTimeout, host

requests resend, up to GvspRetries times. If still no packet received from cam-

era, packet is marked as dropped.

HeartbeatInterval – Uint32 – R/W

The driver sends a heartbeat request packet to the camera every HeatbeatInter-

val milliseconds. If the camera fails to respond to the heartbeat request (200ms

timeout), a retry is sent 200 ms later. After GvcpRetries (5 for PvAPI v1.26)

times with no response, a camera unplugged event is returned by the driver.

Range: [1.000 – 100.000] Default: 1% Units: percent

Range: [1 – 100] Default: 3

Possible values: 256, 512, 1024, 2048, 4096, 8192 Default: 512

Range: [10 – 2500] Default: 50 Units: ms

Range: [250 – 3,600,000] Default: 2500 Units: ms

Note



• HeatbeatInterval may be modified, but is overwritten to

HeartbeatTimeout - 2500 on PvCameraOpen / SampleV-

iewer open. This ensures driver sends unplugged event,

and camera closes stream and control channel at same

time.

• PvAPI users: see PvLinkCallbackRegister to register a call-

back function on unplug event.