Advanced CSRs

Information in this section is based on the IIDC 1.31 specification.  Please refer to the IIDC 1.31 specification for details on the meanings and use of CSRs.

The following table describes the Advanced Feature CSRs that are allowed under the IIDC V1.31 specification as vendor specific.  These CSRs are based at an offset found in the Advanced Feature Offset value (register 0x480).

This table is common for all IIDC compliant PixeLINK cameras and is included to promote compatibility.

 

Note

Not all the features listed in this table are available with every PixeLINK camera.  Check the presence bit of the inquiry register to determine if the feature is supported on a particular camera.

 

Offset

Name

Field

Bit

Description

000h

ACR

  

[0..63]

Advanced Feature Access Control Register (See NOTE 1)

004h

CAMERA INFO REGISTERS (READ ONLY)

008h

Serial Number Offset

Value

[0..31]

Quadlet offset of the Serial Number string from the base address of the initial register space

00Ch

Serial Number Length

Value

[0..31]

Length in bytes of the Serial Number string

010h

FPGA Version

Value

[0..31]

FPGA Version in format Byte0.Byte1.Byte2.Byte3

014h

FW Version

Value

[0..31]

Firmware Version in format Byte0.Byte1.Byte2.Byte3

018h

Camera Description Offset

Value

[0..31]

Quadlet offset of the Camera Description string from the base address of the initial register space (See NOTE 2)

01Ch

Camera Description Length

Value

[0..31]

Length in bytes of the Camera Description string

020h

..

0FCh

Reserved for future Camera Info registers.

ADVANCED FEATURE INQUIRY REGISTERS (READ ONLY)

100h

Name Inquiry

Presence_Inq

[0]

Presence of this feature

  

[1..15]

Reserved

Max_Length

[16..31]

Maximum length of Camera Name in bytes

104h

Name Offset

Value

[0..31]

Quadlet offset of the Camera Name string from the base address of the initial register space (See NOTE 2)

108h

Name Length

Value

[0..31]

Length in bytes of the Camera Name string (Read Only)

10Ch

Descriptor Inquiry

Presence_Inq

[0]

Presence of this feature

  

[1..7]

Reserved

Max_Num

[8..15]

Maximum number of Descriptors

Struct_Ver

[16..31]

Version of the Descriptor Structure.

110h

Descriptor Offset

Value

[0..31]

Quadlet offset of the Descriptor Structure from the base address of the initial register space (See NOTE 2)

114h

Pixel Addressing Inquiry

Presence_Inq

[0]

Presence of this feature

In_Desc_Inq

[1]

Can this feature have different values in different descriptors

1 = Yes, 0 = No

  

[2..3]

Reserved

Mode0_Inq

[4]

Presence of Pixel Addressing Mode 0

(e.g. decimation)

Mode1_Inq

[5]

Presence of Pixel Addressing Mode 1

(e.g. averaging)

Mode2_Inq

[6]

Presence of Pixel Addressing Mode 2

(e.g. binning)

Mode3_Inq

[7]

Presence of Pixel Addressing Mode 3

(e.g. resampling)

Base

[8..15]

Base for Pixel Addressing. Maximum Pixel Addressing is Base^Max_Value (except when Base = 1 then it is Max_Value)

Max_Value

[16..31]

The maximum value for the Pixel Addressing variable

118h

Absolute Frame Rate

Offset

[0..31]

OBSOLETE. This has been replaced with the frame_rate feature in IIDC v1.31

11Ch

Flip Inquiry

H_Pres_Inq

[0]

Presence of Horizontal Flip

In_Desc_Inq

[1]

Can Horizontal Flip have different values in different descriptors

1 = Yes, 0 = No

  

[2..15]

Reserved

V_Pres_Inq

[16]

Presence of Vertical Flip

In_Desc_Inq

[17]

Can Vertical Flip have different values in different descriptors

1 = Yes, 0 = No

  

[18..31]

Reserved

120h

Trigger with Controlled Lighting

Presence_Inq

[0]

Presence of Trigger with Controlled Lighting

In_Desc_Inq

[1]

Can Trigger with Controlled Lighting have different values in different descriptors

1 = Yes, 0 = No

  

[2..29]

Reserved

Rolling_Shutter

[30]

Does the camera have a rolling shutter? Rolling shutter is required for this feature.

1 = Yes, 0 = No

On_Off

[31]

Does the camera support Trigger with Controlled Lighting.

1 = Yes, 0 = No

124h

Trigger Delay Offset

Offset

[0..31]

OBSOLETE. This has been replaced with the trigger_delay feature in IIDC v1.31

128h

General Purpose Output Inquiry

Presence_Inq

[0]

Presence of this feature

In_Desc_Inq

[1]

Can this feature have different values in different descriptors

1 = Yes, 0 = No

  

[2..3]

Reserved

Number

[4..7]

Number of GPO lines (1-15)

Mode0_Inq

[8]

Presence of GPO Mode 0

Mode1_Inq

[9]

Presence of GPO Mode 1

Mode2_Inq

[10]

Presence of GPO Mode 2

Mode3_Inq

[11]

Presence of GPO Mode 3

Mode4_Inq

[12]

Presence of GPO Mode 4

Mode5_Inq

[13]

Presence of GPO Mode 5

Mode6_Inq

[14]

Presence of GPO Mode 6

Mode7_Inq

[15]

Presence of GPO Mode 7

Mode8_Inq

[16]

Presence of GPO Mode 8

Mode9_Inq

[17]

Presence of GPO Mode 9

Mode10_Inq

[18]

Presence of GPO Mode 10

Mode11_Inq

[19]

Presence of GPO Mode 11

Mode12_Inq

[20]

Presence of GPO Mode 12

Mode13_Inq

[21]

Presence of GPO Mode 13

Mode14_Inq

[22]

Presence of GPO Mode 14

Mode15_Inq

[23]

Presence of GPO Mode 15

  

[24..31]

Reserved

12Ch

GPO Parameter 1

Offset

[0..31]

Quadlet offset of the absolute value CSR for GPO 0 Parameter 1 (See NOTE 3)

130h

GPO Parameter 2

Offset

[0..31]

Quadlet offset of the absolute value CSR for GPO 0 Parameter 2 (See NOTE 3)

134h

GPO Parameter 3

Offset

[0..31]

Quadlet offset of the absolute value CSR for GPO 0 Parameter 3 (See NOTE 3)

138h

Extended Shutter Inquiry

Presence_Inq

[0]

Presence of this feature

In_Desc_Inq

[1]

Can this feature have different values in different descriptors

1 = Yes, 0 = No

  

[2..3]

Reserved

Number_Knees

[4..7]

Maximum Number of Knee Points (1-4)

  

[8..31]

Reserved

13Ch

Extended Shutter Knee Point 0

Offset

[0..31]

Quadlet offset of the absolute value CSR for Extended Shutter Knee Point 0 (See NOTE 4)

140h

Lookup Tables Inquiry

Presence_Inq

[0]

Presence of this feature

In_Desc_Inq

[1]

Can this feature have different values in different descriptors

1 = Yes, 0 = No

  

[2..7]

Reserved

Bit_Depth

[8..15]

Bit depth of an entry in the lookup table

Number

[16..31]

Number of entries in the lookup table

144h

Look Up Table

Offset

[0..31]

Quadlet offset of the first entry in the lookup table. Each entry occupies a whole number of bytes (e.g. a 10bit entry occupies 2 bytes). The table must be written to in order, starting from byte 0.

148h

Auto ROI Inquiry

Presence_Inq

[0]

Presence of this feature

In_Desc_Inq

[1]

Can this feature have different values in different descriptors

1 = Yes, 0 = No

  

[2..7]

Reserved

Invalid_ROI

[8]

0 = Valid ROI, 1 = Invalid ROI

This feature will be ignored until a valid ROI is set. The ROI must be within the current image region. (See NOTE 5)

  

[9..31]

Reserved

14Ch

..

150h

Reserved for future Feature Inquiry registers.

154h

Imager Clock Divisor

Presence_Inq

[0]

Presence of this feature

In_Desc_Inq

[1]

Can this feature have different values in different descriptors

1 = Yes, 0 = No

 

[2..7]

Reserved

Min_Value

[8..19]

Minimum returned value

Max_Value

[20..31]

Maximum returned value

158h

Max Pixel Size

Presence_Inq

[0]

Presence of this feature

In_Desc_Inq

[1]

Can this feature have different values in different descriptors

1 = Yes, 0 = No

 

[2..3]

Reserved

ReadOut_Inq  

[4]

Feature Can Be Read

 

[5..7]

Reserved

Min Value

[8..19]

Minimum Returned Value

Max Value

[20..31]

Maximum Returned Value

15Ch

..

1FCh

Reserved for future Feature Inquiry registers.

ADVANCED FEATURE CONTROL REGISTERS

200h

Descriptor Configuration

Current

[0..7]

Zero-based index of the descriptor currently in focus (Format 7 only)

Number

[8..15]

Number of descriptors currently in use (Format 7 only) (See NOTE 6)

Append_Desc

[16]

Append Descriptors to each frame

1 = Append, 0 = Dont Append

  

[17..31]

Reserved

204h

Pixel Addressing

Value

[0..15]

Value for Pixel Addressing. Actual reduction is Base^Value except when Base = 1 then it is Value (Format 7 only)

  

[16..23]

Reserved

Mode

[24..31]

Pixel Addressing mode

208h

Flip

H_On_Off

[0]

Horizontal Flip On/Off (See NOTE 7)

1 = On, 0 = Off

  

[1..15]

Reserved

V_On_Off

[16]

Vertical Flip On/Off (See NOTE 7)

1 = On, 0 = Off

  

[17..31]

Reserved

20Ch

Trigger with Controlled Lighting

On_Off

[0]

Trigger with Controlled Lighting On/Off

0 = On. Controlled lighting is being used.  Rolling shutter cameras will reset, expose and readout in sequence.

1 = Off. Controlled lighting is not being used.  Rolling shutter cameras will expose and readout concurrently.

 

[1..31]

Reserved.

210h

Extended Shutter

Number

[0..7]

Number of Knee Points

  

[8..31]

Reserved

214h

Look Up Table

On_Off

[0]

Lookup Table On/Off

1 = On, 0 = Off

  

[1..31]

Reserved

218h

Auto ROI

On_Off

[0]

Auto ROI On/Off

1 = On, 0 = Off

  

[1..31]

Reserved

21Ch

Auto ROI Position

Left

[0..15]

Left Position of the Auto ROI (Pixels)

Top

[16..31]

Top Position of the Auto ROI (Pixels)

220h

Auto ROI Size

Width

[0..15]

Width of the Auto ROI (Pixels)

Height

[16..31]

Height of the Auto ROI (Pixels)

224h

Imager Clock Divisor

Value

[0..31]

Speed (in terms of frame rate) reduction factor to be applied to the camera.  A value of 1 means full speed,  a value of 2 means half speed, etc.  

228h

Max Pixel Size

Value

[0..31]

The maximum number of bits the camera can use to represent a pre-formatted (or raw) pixel value.

22Ch

..

2FCh

Reserved for future Feature Control registers.

GPO CONTROL REGISTERS

300h

GPO 0 Config

On_Off

[0]

GPO 0 On/Off

1 = On, 0 = Off

Polarity

[1]

GPO 0 Polarity

1 = Active High, 0 = Active Low

  

[2..23]

Reserved

Mode

[24..31]

GPO 0 Mode

..

..

..

..

..

300h + X*4

GPO X Config

On_Off

[0]

GPO X On/Off

1 = On, 0 = Off

Polarity

[1]

GPO X Polarity

1 = Active High, 0 = Active Low

  

[2..23]

Reserved

Mode

[24..31]

GPO X Mode

..

..

..

..

..

338h

GPO 14 Config

  

On_Off

[0]

GPO 14 On/Off

1 = On, 0 = Off

Polarity

[1]

GPO 14 Polarity

1 = Active High, 0 = Active Low

  

[2..23]

Reserved

Mode

[24..31]

GPO 14 Mode

33Ch

..

7FFh

Reserved for future Advanced Feature Control Registers

 

 

Note1

The Feature_Id field of the Advanced Feature Access Control Register is a 48bit value with the following format:

0 7

8 15

16 23

24 31

32 39

40 - 47

Company_ID

(=0x000168)

Advanced_Feature_Unique_ID

(=Feature offset)

 

For example: The Feature_Id field for the FLIP_INQ CSR would be 0x000168000114

 

 

Note2

You do not have to access the Access Control Register to Read/Write to the value at the offset pointed to by the value in this register.

 

 

Note3

These are the offsets for the absolute value CSRs for the parameters of GPO 0. The absolute value CSR offsets for GPO X can be calculated as follows : quadlet offset of Parameter N GPO X = GPO_PARMN_ABS + 3 * X where GPO_PARMN_ABS is the offset for the absolute value CSR for parameter N of GPO 0.

 

 

Note4

This is the offset for the absolute value CSR for the Extended Shutter Knee Point 0. The absolute value CSR offsets for Knee Point X can be calculated as follows : quadlet offset of Knee Point X = XSHUT_KNEE_ABS + 3 * X.

 

 

Note5

In all formats the Auto ROI must be within an image region that has Top and Left coordinates of zero and Height and Width values that correspond to the current Video height and width.

 

 

Note6

Descriptors are added or removed by increasing/decreasing this value. When a descriptor is created it will have the same values as the current descriptor (Current field) or the camera settings if it is the first descriptor to be created. When the descriptor number is decreased then the descriptors with a higher index are removed first.

 

 

Note7

Changing this feature can change the orientation of the Bayer pattern. The Format 7 Color Filter ID register should be checked each time this feature is changed