Technical Application Notes
Click an item to read from the list below.

Technical Application Notes


 

 

Control and Status Registers Unique to Ladybug2 and Ladybug3 cameras

Technical Application Note TAN2008014

Revised January 28, 2009

 

Subject

Technical Application Note (TAN2008014): Control and Status Registers Unique to Ladybug2 and Ladybug3 cameras

10382

Applicable Product(s)

  • Ladybug2 (firmware version 1.0.2.0 or later) and Ladybug3 (firmware version 1.2.2.1 or later) spherical vision cameras

 

Application Note Description

This technical application note explains three control and status registers (CSRs) that are unique to the firmware of the Ladybug2 and Ladybug3 cameras. Note that CSR 1E80h updates similar functionality found in CSR 1A20h. CSRs 1E84h and 1E88h update similar functionality also found in CSR 1A24h. We recommend updating your application to use CSRs 1E80h, 1E84h and 1E88h.

 

JPEG_CTRL: 1E80h

Allows the user to specify the JPEG compression rate of the camera, when the camera is operating in a JPEG mode. Increasing the JPEG quality value improves JPEG image quality.

Format:


Field

Bit

Description

Presence_Inq

[0]

Presence of this feature
0: N/A 1: Available

 

[1-5]

Reserved

ON_OFF

[6]

JPEG compression ON_OFF for format_7 mode 0,1,2,3.  If the format-7 mode is 6 or 7, this bit is ignored.
Read: Read the status
Write: Set
0: JPEG compression is OFF
1: JPEG compression is ON 
If this bit = 0, other fields will be read only

A_M_Mode

[7]

Read: Read a current mode
Write: Set the mode
0: Manual, 1: Automatic JPEG quality control

 

[8-23]

Reserved

 

 

Value

[24-31]

JPEG quality value. Valid range: 0x01(1%) to 0x64(100%).
A value of 0 is treated as 60%.
A write to this value in ‘Auto’ mode will be ignored.

.

 

JPEG_BUFFER_USAGE: 1E84h

Allows the user to specify the percentage of the image buffer on the PC that is used for JPEG compressed image data, when the camera is operating in a JPEG mode. Specifying a value less than the maximum allows for room in the image buffer to accommodate extra image data, depending on scene variations from frame to frame.

Format:


Field

Bit

Description

Presence_Inq

[0]

Presence of this feature
0: N/A 1: Available

 

[1-24]

Reserved

Value

[25-31]

Value. Valid range: 0x00 (0%) to 0x7F (100%)
A value of 0 is treated as 0x66 (80%). On Ladybug3 firmware v1.2.2.1 or later, a value of 0 is treated as 0x72 (90%).

 

IMAGE_SELECTION: 1E88h

Allows the user to specify individual images to be transmitted from the camera to the PC.

Format:


Field

Bit

Description

Presence_Inq

[0]

Presence of this feature
0: N/A 1: Available

 

[1-7]

Reserved

Image_En

[8-31]

Enables transmission of individual images. Refer to table below for a breakdown of images by bit.
Write: Transmission enabled or disabled
Read: Read a status
0: Transmission disabled, 1: Transmission enabled
The default value is 000000h, and is interpreted as a value of 888888h when the camera is operating in a mode that does not produce 4 separate Bayer-channel images from each sensor, or FFFFFFh when the camera is operating in a mode that produces 4 separate Bayer channel images from each sensor. In other words, all images are transmitted.
A mask of 888888h is applied whenever the camera is operating in a mode that does not produce separate Bayer-channel images.

Format of Transmit_Enabled field:


Field

Bit

Description

Transmit_Enabled

[8]

Camera 0, Bayer channel 0

 

[9]

Camera 0, Bayer channel 1

 

[10]

Camera 0, Bayer channel 2

 

[11]

Camera 0, Bayer channel 3

 

[12]

Camera 1, Bayer channel 0

 

[13]

Camera 1, Bayer channel 1

 

[14]

Camera 1, Bayer channel 2

 

[15]

Camera 1, Bayer channel 3

 

[16]

Camera 2, Bayer channel 0

 

[17]

Camera 2, Bayer channel 1

 

[18]

Camera 2, Bayer channel 2

 

[19]

Camera 2, Bayer channel 3

 

[20]

Camera 3, Bayer channel 0

 

[21]

Camera 3, Bayer channel 1

 

[22]

Camera 3, Bayer channel 2

 

[23]

Camera 3, Bayer channel 3

 

[24]

Camera 4, Bayer channel 0

 

[25]

Camera 4, Bayer channel 1

 

[26]

Camera 4, Bayer channel 2

 

[27]

Camera 4, Bayer channel 3

 

[28]

Camera 5, Bayer channel 0

 

[29]

Camera 5, Bayer channel 1

 

[30]

Camera 5, Bayer channel 2

 

[31]

Camera 5, Bayer channel 3