Technologies are brands protected by law. Warranty The information provided by Allied Vision Technologies is supplied without any guarantees or warranty whatsoever, be it specific or implicit. Also excluded are all implicit warranties con- cerning the negotiability, the suitability for specific applications or the non-breaking of laws and patents.
Contents Contacting Allied Vision Technologies ........... 8 Introduction ......................9 Document history ......................9 Manual overview......................13 Conventions used in this manual..................14 Styles ........................14 Symbols ........................15 More information......................15 Before operation ......................16 MARLIN cameras ....................17 Declarations of conformity ................18...
Page 4
Control and video data signals..................52 Inputs ........................52 Triggers......................52 Input/output pin control................... 53 IO_INP_CTRL 1-2 ....................53 Trigger delay ....................... 54 Outputs ........................56 IO_OUTP_CTRL 1-2 ....................58 Output modes...................... 59 Pixel data........................61 Description of the data path ................65 Block diagrams of the cameras ..................
Page 5
Color interpolation and correction................. 104 Color interpolation (BAYER demosaicing) ..............105 Color correction ..................... 106 Why color correction ..................106 Color correction in AVT cameras ................106 Color correction: formula..................106 GretagMacbeth ColorChecker ................106 Color conversion (RGB YUV) ..................107 Hue and saturation .....................
Introduction Introduction This MARLIN Technical Manual describes in depth the technical specifica- tions, dimensions, all camera features (IIDC standard and AVT smart fea- tures) and their registers, trigger features, all video and color formats, band- width and frame rate calculation. For information on hardware installation, safety warnings, pin assignments on I/O connectors and 1394b connectors read the Hardware Installation Guide.
Page 10
Introduction Version Date Remarks continued from last page 2.2.0 26.02.2007 Minor corrections New formula for MARLIN F-131 (Formula 11: Frame rate calcu- lation MARLIN F-131 as function of AOI height and width page 165) MARLIN F-145C2: corrected resolutions, new color formats in Format_7 Mode_0 and Format_7 Mode_2 (Table 58: Video fixed formats Marlin F-145B2 / F-145C2...
Page 11
Corrected frame rate for Format_7 Mode_3 (full binning) in Table 62: Video fixed formats Marlin F-201B / F-201C on page 145ff. Restructuring of Marlin Technical Manual: • Added Contacting Allied Vision Technologies on page 8 • Added Chapter Manual overview on page 13 •...
Page 12
Introduction Version Date Remarks continued from last page 2.4.0 15.08.08 • Moved detailed description of the camera interfaces (FireWire, I/O connector), ordering numbers and operat- [continued] [continued] ing instructions to the Hardware Installation Guide. • Revised Chapter Description of the data path on page 65 •...
Table 1: Document history Manual overview This manual overview describes each chapter of this manual shortly. • Chapter Contacting Allied Vision Technologies on page 8 lists AVT contact data for both: – technical information / ordering – commercial information •...
Introduction • Chapter Camera interfaces on page 48 describes in detail the inputs/ outputs of the cameras (incl. Trigger features). For a general descrip- tion of the interfaces (FireWire and I/O connector) see Hardware Installation Guide. • Chapter Description of the data path on page 65 describes in detail IIDC conform as well as AVT-specific camera features.
Introduction Symbols Note This symbol highlights important information. Caution This symbol highlights important instructions. You have to follow these instructions to avoid malfunctions. This symbol highlights URLs for further information. The URL itself is shown in blue Color. Example: http://www.alliedvisiontec.com More information For more information on hardware and software read the following: •...
Introduction Before operation We place the highest demands for quality on our cameras. Target group This Technical Manual is the guide to detailed technical information of the camera and is written for experts. Getting started For a quick guide how to get started read Hardware Installation Guide first. Note Please read through this manual carefully before operat- ing the camera.
With Marlin cameras, entry into the world of digital image processing is sim- pler and more cost-effective than ever before. Entry-level model With the new Marlin, Allied Vision Technologies presents a whole series of attractive digital camera entry-level models of the FireWire™ type. Price-performance...
Declarations of conformity Declarations of conformity Allied Vision Technologies declares under its sole responsibility that the fol- lowing products Category Name Model Name Digital Camera (IEEE 1394) MARLIN F-033B MARLIN F-033C MARLIN F-046B MARLIN F-046C MARLIN F-080B MARLIN F-080C MARLIN F-145B2...
Filter and lenses Filter and lenses The following illustration shows the spectral transmission of the IR cut filter: Figure 1: Spectral transmission of Jenofilt 217 Camera lenses AVT offers different lenses from a variety of manufacturers. The following table lists selected image formats depending on camera type, distance and the focal length of the lens.
Page 20
Filter and lenses Focal length Marlin F-080 Distance = 0.5 m Distance = 1 m 4.8 mm 0.375 m x 0.5 m 0.75 m x 1 m 8 mm 0.22 m x 0.29 m 0.44 m x 0.58 m 12 mm 0.145 m x 0.19 m 0.29 m x 0.38 m 16 mm...
Specifications Specifications Note For information on bit/pixel and byte/pixel for each color mode see Table 78: ByteDepth on page 166. MARLIN F-033B/C Feature Specification Image device Type 1/2 (diag. 8 mm) progressive scan SONY CCD ICX-414AL/AQ with HAD microlens Chip size 7.48 mm x 6.15 mm Cell size 9.9 µm x 9.9 µm...
Page 22
Specifications Feature Specification Power requirements DC 8 V - 36 V via IEEE 1394 cable or 12-pin HIROSE Typical < 3 watt (@ 12 V DC) Power consumption Dimensions 72 mm x 44 mm x 29 mm (L x W x H); incl. connectors, without tri- pod and lens Mass <120 g (without lens)
Specifications MARLIN F-046B/C Feature Specification Image device Type 1/2 (diag. 8 mm) progressive scan SONY CCD ICX-415AL/AQ with HAD microlens Chip size 7.48 mm x 6.15 mm Cell size 8.3 µm x 8.3 µm Picture size (max.) 780 x 582 (Format_7 Mode_0) Lens mount C-Mount: 17.526 mm (in air);...
Page 24
Specifications Feature Specification On request Host adapter card, angled head, locking IEEE 1394 cable Software packages API (FirePackage, Direct FirePackage, Fire4Linux) Table 9: Specification MARLIN F-046B/C Note The design and specifications for the products described above may change without notice. MARLIN Technical Manual V2.4.0...
Specifications MARLIN F-080B/C (-30 fps*) * Variant: F-080-30 fps only This variant offers higher speed at a slight expense in image quality. Feature Specification Image device Type 1/3 (diag. 6 mm) progressive scan SONY CCD ICX-204AL/AK with HAD microlens Chip size 5.8 mm x 4.92 mm Cell size 4.65 µm x 4.65 µm...
Page 26
Specifications Feature Specification Standard accessories b/w and color: IR cut filter Optional accessories b/w: IR cut filter, IR pass filter color: protection glass On request Host adapter card, angled head, locking IEEE 1394 cable Software packages API (FirePackage, Direct FirePackage, Fire4Linux) Table 10: Specification MARLIN F-080B/C Note The design and specifications for the products described...
Specifications MARLIN F-145B2/C2 Feature Specification Image device Type 1/2 (diag. 8 mm) progressive scan SONY CCD ICX-205AL/AK with HAD microlens Chip size 7.6 mm x 6.2 mm Cell size 4.65 µm x 4.65 µm Picture size (max.) 1392 x 1040 pixels (Format_7 Mode_0) Lens mount C-Mount: 17.526 mm (in air);...
Page 28
Specifications Feature Specification Optional accessories b/w: IR cut filter, IR pass filter color: protection glass On request Host adapter card, angled head, locking IEEE 1394 cable Software packages API (FirePackage, Direct FirePackage, Fire4Linux) Table 11: Specification MARLIN F-145B2/C2 Note The design and specifications for the products described above may change without notice.
Specifications MARLIN F-146B/C Feature Specification Image device Type 1/2 (diag. 8 mm) progressive scan SONY CCD ICX-267AL/AK with HAD microlens Chip size 7.6 mm x 6.2 mm Cell size 4.65 µm x 4.65 µm Picture size (max.) 1392 x 1040 pixels (Format_7 Mode_0) Lens mount C-Mount: 17.526 mm (in air);...
Page 30
Specifications Feature Specification On request Host adapter card, angled head, locking IEEE 1394 cable Software packages API (FirePackage, Direct FirePackage, Fire4Linux) Table 12: Specification MARLIN F-146B/C Note The design and specifications for the products described above may change without notice. MARLIN Technical Manual V2.4.0...
Specifications MARLIN F-201B/C Feature Specification Image device Type 1/1.8 (diag. 9 mm) progressive scan SONY CCD ICX274AL/AQ with HAD microlens Chip size 8.5 mm x 6.8 mm Cell size 4.40 µm x 4.40 µm Picture size (max.) 1628 x 1236 (Format_7 Mode_0) Lens mount C-Mount: 17.526 mm (in air);...
Page 32
Specifications Feature Specification Optional accessories b/w: IR cut filter, IR pass filter color: protection glass On request Host adapter card, angled head, locking IEEE 1394 cable Software packages API (FirePackage, Direct FirePackage, Fire4Linux) Table 13: Specification MARLIN F-201B/C Note The design and specifications for the products described above may change without notice.
Specifications MARLIN F-131B/C (NIR) Feature Specification Image device Type 2/3 (diag. 11 mm) global shutter FillFactory CMOS sensor IBIS5B/IBIS5B NIR Chip size 8.6 mm x 6.9 mm Cell size 6.7 µm x 6.7 µm Picture size (max.) 1280 x 1024 pixels (Format_7 Mode_0) Lens mount C-Mount: 17.526 mm (in air);...
Page 34
Specifications Feature Specification Standard accessories b/w and color: IR cut filter Marlin F-131BNIR only: ASG (protection glass) Optional accessories b/w: IR cut filter, IR pass filter color: protection glass On request Host adapter card, angled head, locking IEEE 1394 cable Software packages API (FirePackage, Direct FirePackage, Fire4Linux) Table 14: Specification MARLIN F-131B/C (NIR)
Camera dimensions Camera dimensions Note For information on sensor position accuracy: (sensor shift x/y, optical back focal length z and sensor rota- tion α) see Chapter Sensor position accuracy of AVT cameras on page 237. MARLIN standard housing ☺ Body size: 72 mm x 44 mm x 29 mm (L x W x H) Mass: 120 g (without lens) Figure 16: Camera dimensions MARLIN Technical Manual V2.4.0...
Camera dimensions MARLIN W90 This version has the sensor tilted by 90 degrees clockwise, so that it views upwards. Figure 18: MARLIN W90 MARLIN Technical Manual V2.4.0...
Camera dimensions MARLIN W90 S90 This version has the sensor tilted by 90 degrees clockwise, so that it views upwards and additionally rotated by 90 degrees clockwise. Figure 19: MARLIN W90 S90 MARLIN Technical Manual V2.4.0...
Camera dimensions MARLIN W270 This version has the sensor tilted by 270 degrees clockwise, so that it views downwards. Consult your dealer, if you have inquiries for this version. Figure 20: MARLIN W270 MARLIN Technical Manual V2.4.0...
Camera dimensions MARLIN W270 S90 This version has the sensor tilted by 270 degrees clockwise, so that it views downwards. Additionally the sensor is tilted by 90 degrees clockwise. ☺ Figure 21: MARLIN W270 S90 MARLIN Technical Manual V2.4.0...
Camera interfaces Camera interfaces This chapter gives you detailed information on status LEDs, inputs and out- puts, trigger features and transmission of data packets. Note For a detailed description of the camera interfaces (FireWire, I/O connector), ordering numbers and operat- ing instructions see the Hardware Installation Guide.
Camera interfaces Camera I/O connector pin assignment Pin Signal Direction Level Description External GND GND for RS232 and External ground for RS232 ext. power and external power External Power +8 ... +36 V DC Power supply (CCD models only) Camera In 1 (high) = 2 V...U Camera Input 1 inVCC...
Camera interfaces Status LEDs Status LEDs green yellow Figure 24: Position of Status LEDs Status LED green The green LED (power) indicates that the camera is being supplied with suf- ficient voltage and is ready for operation. State Description Power/S2 LED off - power off LED on - power on Table 15: LED indication: green...
Page 51
Camera interfaces Blink codes are used to signal warnings or error states: Warning DCAM MISC FPGA Stack Class S1 1 blink 2 blinks 3 blinks 4 blinks 5 blinks Error code S2 FPGA Boot error 1-5 blinks Stack setup 1 blink Stack start 2 blinks No FLASH object...
Camera interfaces Control and video data signals The inputs and outputs of the camera can be configured by software. The dif- ferent modes are described below. Inputs Note For a general description of the inputs and warnings see the Hardware Installation Guide, Chapter MARLIN input descrip- tion.
Camera interfaces Input/output pin control All input and output signals running over the camera I/O connector are con- trolled by an advanced feature register. Register Name Field Description 0xF1000300 IO_INP_CTRL1 Presence_Inq Indicates presence of this feature (read only) [1..6] Polarity 0: low active 1: high active [8..10]...
Camera interfaces Trigger delay Since firmware version 2.03, the cameras feature various ways to delay image capture based on external trigger. With IIDC V1.31 there is a standard CSR at Register F0F00534/834h to control a delay up to FFFh x timebase value. The following table explains the inquiry register and the meaning of the various bits.
Page 55
Camera interfaces Register Name Field Description 0xF0F00834 TRIGGER_DELAY Presence_Inq Presence of this feature: 0: N/A 1:Available Abs_Control Absolute value control O: Control with value in the value field 1: Control with value in the absolute value CSR. If this bit=1 the value in the value field has to be ignored.
Camera interfaces Note • Switching trigger delay to ON also switches external Trigger_Mode_0 to ON. • This feature works with external Trigger_Mode_0 only. Outputs Note For a general description of the outputs and warnings see the Hardware Installation Guide, Chapter MARLIN output description.
Page 57
Camera interfaces Output mode selectable Polarity via software selectable via software Operation state IntEna read FVal Opto- Busy Output signal Operation state Coupler read Figure 26: Output block diagram MARLIN Technical Manual V2.4.0...
Camera interfaces IO_OUTP_CTRL 1-2 The outputs (Output mode, Polarity) are controlled via two advanced feature registers (see Table 24: Advanced register: Output control on page 58). The Polarity field determines whether the output is inverted or not. The out- put mode can be viewed in the table below. The current status of the output can be queried and set via the PinState.
Camera interfaces Output modes Mode Default 0x00 0x01 Output state follows PinState bit Using this mode, the Polarity bit has to be set to 0 (not inverted). This is necessary for an error free display of the output status. 0x02 Integration enable Output 1 0x03...
Page 60
Camera interfaces Figure 27: Output Impulse Diagram Note The signals can be inverted. Caution Firing a new trigger while IntEna is still active can result in image corruption due to double exposure occurring. MARLIN Technical Manual V2.4.0...
Camera interfaces Note • Note that trigger delay in fact delays the image cap- ture whereas the IntEna_Delay only delays the leading edge of the IntEna output signal but does not delay the image capture. • As mentioned before, it is possible to set the outputs by software.
Page 62
Camera interfaces Field Description data_length Number of bytes in the data field Tag field shall be set to zero channel Isochronous channel number, as programmed in the iso_channel field of the cam_sta_ctrl register tCode Transaction code shall be set to the isochronous data block packet tCode Synchronization value (sync bit) This is one single bit.
Page 63
Camera interfaces Figure 30: Y8 and Y16 format: Source: IIDC V1.3 MARLIN Technical Manual V2.4.0...
Page 64
Camera interfaces Figure 31: Data structure: Source: IIDC V1.3 MARLIN Technical Manual V2.4.0...
Description of the data path Description of the data path Block diagrams of the cameras The following diagrams illustrate the data flow and the bit resolution of image data after being read from the CCD or CMOS sensor chip in the camera. The individual blocks are described in more detail in the following para- graphs.
Description of the data path Color cameras 10 Bit (LUT off) 8 Bit (LUT on) HiRose I/O RS232 Auto-Data Test-Pattern Params 10 Bit Figure 33: Block diagram color camera MARLIN Technical Manual V2.4.0...
Description of the data path IBIS5A multiple slope (High Dynamic Range mode) The MARLIN F-131 sensor has a high dynamic range of about 60 dB. This can be extended to almost 100 dB by switching to a special mode. This mode is called dual (in the case of rolling shutter) or multiple slope mode (in the case of global shutter).
Description of the data path This dual slope reset pulse resets the analogue signal of the pixels below the dual slope reset level to this level. After the reset, the analogue signal starts to decrease with the same slope as before (pink P3 and yellow P4 lines). This introduces a knee-point in the exposure function.
Page 69
Description of the data path Example Adjust image so that the dark areas are well displayed. Calculate the used shutter time. Activate HDR mode. Assuming shutter time to be 40 ms = 40,000 µs: • Kneepoint_1 = 10 % * 40,000 µs = 4,000 µs = 0xFA0 •...
Description of the data path White balance Marlin color cameras have both manual and automatic white balance. White balance is applied so that non-colored image parts are displayed non-col- ored. White balance does not use the so called PxGA® (Pixel Gain Amplifier) of the analog front end (AFE) but a digital representation in the FPGA in order to modify the gain of the two channels with lower output by +9.5 dB (in 106 steps) relative to the channel with highest output.
Page 71
Description of the data path Register Name Field Description 0xF0F0080C WHITE_BALANCE Presence_Inq [0] Presence of this feature: 0: N/A 1: Available Abs_Control Absolute value control O: Control with value in the Value field 1: Control with value in the Absolute value CSR If this bit=1, the value in the Value field will be ignored.
Description of the data path Figure 37: U/V slider range One-push automatic white balance Note Configuration To configure this feature in control and status register (CSR): Table 29: White balance register on page 71. The camera automatically generates frames, based on the current settings of all registers (GAIN, OFFSET, SHUTTER, etc.).
Description of the data path Automatic white balance can also be enabled by using an external trigger. However, if there is a pause of >10 seconds between capturing individual frames this process is aborted. The following flow diagram illustrates the automatic white balance sequence. Pause image capture Capture image...
Page 74
Description of the data path Note If the adjustment fails and the work area size and/or position becomes invalid this feature is automatically switched off - make sure to read back the ON_OFF flag if this feature doesn't work as expected. Within this area, the R-G-B component values of the samples are added and used as actual values for the feedback.
Description of the data path Auto shutter In combination with auto white balance, all Marlin CCD models and CMOS models are equipped with auto shutter feature. When enabled, the auto shutter adjusts the shutter within the default shutter limits or within those set in advanced register F1000360h in order to reach the reference brightness set in auto exposure register.
Page 76
Description of the data path To configure this feature in control and status register (CSR): Register Name Field Description 0xF0F0081C SHUTTER Presence_Inq Presence of this feature: 0: N/A 1: Available Abs_Control Absolute value control O: Control with value in the Value field 1: Control with value in the Absolute value If this bit= 1 the value in the Value field will be ignored.
Page 77
Description of the data path Note • Values can only be changed within the limits of shutter CSR. • Changes in auto exposure register only have an effect when auto shutter is enabled. • Auto exposure limits are: 50..205 (SmartView Ctrl1 tab: Target grey level) When both auto shutter and auto gain are enabled, priority is given to increasing shutter when brightness decreases.
Description of the data path Auto gain In combination with auto white balance, all Marlin CCD models are equipped with auto gain feature. When enabled auto gain adjusts the gain within the default gain limits (see Table 33: Manual gain range of the various Marlin types on page 80) or within the limits set in advanced register F1000370h in order to reach the bright- ness set in auto exposure register as reference.
Page 79
Description of the data path Register Name Field Description 0xF0F00804 AUTO_EXPOSURE Presence_Inq Presence of this feature: 0: N/A 1: Available Abs_Control Absolute value control O: Control with value in the value field 1: Control with value in the absolute value CSR If this bit= 1 the value in the value field has to be ignored [2..4]...
Description of the data path Note • Values can only be changed within the limits of gain CSR. • Changes in auto exposure register only have an effect when auto gain is active. • Auto exposure limits are 50..205. (SmartView Ctrl1 tab: Target grey level) •...
Page 81
Description of the data path Note • Setting the gain does not change the offset (black value) for CCD models. • Setting the gain changes the offset (black value) for CMOS models. This is due to the lack of black clamping circuitry in sensor.
Description of the data path Look-up table (LUT) and gamma function The AVT Marlin camera provides one user-defined look-up table (LUT). The use of this LUT allows any function (in the form Output = F(Input)) to be stored in the camera's RAM and to apply it on the individual pixels of an image at run-time.
Description of the data path Note • The input value is the most significant 10-bit value from the digitizer. The gamma LUT of the CCD models outputs the most significant 8 bit as shown above. • As gamma correction for the CCD models is also imple- mented via the look-up table, it is not possible to use a different LUT when gamma correction is enabled.
Description of the data path Shading correction Shading correction is used to compensate for non-homogeneities caused by lighting or optical characteristics within specified ranges. To correct a frame, a multiplier from 1...2 is calculated for each pixel in 1/256 steps: this allows for shading to be compensated by up to 50 %. Besides generating shading data off-line and downloading it to the camera, the camera allows correction data to be generated automatically in the cam- era itself.
Description of the data path Automatic generation of correction data Requirements Shading correction compensates for non-homogeneities by giving all pixels the same gray value as the brightest pixel. This means that only the back- ground must be visible and the brightest pixel has a gray value of less than 255 when automatic generation of shading data is started.
Page 86
Description of the data path Note Configuration To configure this feature in an advanced register: See Table 108: Advanced register: Shading on page 214. Note • The maximum value of GRAB_COUNT depends on the type of camera and the number of frame buffers that exist.
Page 87
Description of the data path Figure 44: Generation of shading image MARLIN Technical Manual V2.4.0...
Page 88
Description of the data path Note • The calculation of shading data is always carried out at the current resolution setting. If the AOI is later larger than the window in which correction data was calcu- lated, none of the pixels lying outside are corrected. •...
Description of the data path Loading a shading image out of the camera GPDATA_BUFFER is used to load a shading image out of the camera. Because the size of a shading image is larger than GPDATA_BUFFER, input must be handled in several steps: It is recommended that block reads are used to read a block of n bytes with one command out of the GPDATA_BUFFER.
Description of the data path Loading a shading image into the camera GPDATA_BUFFER is used to load a shading image into the camera. Because the size of a shading image is larger than GPDATA_BUFFER, input must be handled in several steps: It is recommended that block writes are used to write a block of n bytes with one command into the GPDATA_BUFFER.
Description of the data path DSNU & blemish correction (MARLIN F-131B only) In order to further reduce the dark signal non uniformity (DSNU) of the CMOS sensor to levels similar to CCD sensors, the MARLIN F-131B is equipped with a special DSNU reduction function, extending the shading correction. The DSNU function applies an additive correction to every pixel in order to equalize the dark level of the pixels.
Page 92
Description of the data path Figure 49: Histogram with blemish correction Note • For maximum efficiency, perform a new DSNU correction every time the shutter, gain or offset settings are changed. Generate the image by closing the lens to eliminate image information. •...
Description of the data path Horizontal mirror function All Marlin cameras are equipped with an electronic mirror function, which mirrors pixels from the left side of the image to the right side and vice versa. The mirror is centered to the actual FOV center and can be combined with all image manipulation functions, like binning, shading and DSNU.
Description of the data path Binning (only Marlin CCD b/w models) 2 x binning Definition Binning is the process of combining neighboring pixels while being read out from the CCD chip. Note Only Marlin CCD equipped b/w cameras have this feature. Binning is used primarily for 3 reasons: •...
Description of the data path Vertical binning Vertical binning increases the light sensitivity of the camera by a factor of two by adding together the values of two adjoining vertical pixels output as a single pixel. At the same time this normally improves signal to noise sep- aration by about 2 dB.
Description of the data path Horizontal binning Definition In horizontal binning adjacent horizontal pixels in a line are combined in pairs. 2 x horizontal binning: 2 pixel signals from 2 horizontal neighboring pixels are combined. Light sensitivity This means that in horizontal binning the light sensitivity of the camera is also increased by a factor of two (6 dB).
Description of the data path 2 x full binning If horizontal and vertical binning are combined, every 4 pixels are consoli- dated into a single pixel. At first two horizontal pixels are put together and then combined vertically. Light sensitivity This increases light sensitivity by a total of a factor of 4 and at the same time signal to noise separation is improved by about 6 dB.
Description of the data path Sub-sampling (MARLIN F-131B/C, MARLIN F-146C and MARLIN F-201C) What is sub-sampling? Definition Sub-sampling is the process of skipping neighboring pixels (with the same color) while being read out from the CMOS or CCD chip. Which Marlin models have sub-sampling? •...
Page 99
Description of the data path 1 out of 2 Figure 54: Horizontal sub-sampling 1 out of 2 (b/w) 2 out of 4 Figure 55: Horizontal sub-sampling 2 out of 4 (color) Note The image appears horizontally compressed in this mode and no longer exhibits a true aspect ratio.
Page 100
Description of the data path Format_7 Mode_2 Only MF-131B/C: By default use Format_7 Mode_2 for • b/w cameras: 1 out of 2 vertical sub-sampling • color cameras: 2 out of 4 vertical sub-sampling 1 out of 2 Figure 56: Vertical sub-sampling (b/w) MARLIN Technical Manual V2.4.0...
Page 101
Description of the data path 2 out of 4 Figure 57: Vertical sub-sampling (color) Note The image appears vertically compressed in this mode and does no longer show true aspect ratio. Format_7 Mode_3 By default use Format_7 Mode_3 for • only Marlin F-131B: 1 out of 2 H+V sub-sampling •...
Page 102
Description of the data path 2 out of 4 H+V sub-sampling (only Marlin F-131C/146C/201C) Figure 59: 2 out of 4 H+V sub-sampling (color) Note Changing sub-sampling modes involve the generation of new shading reference images due to a change in the image size. MARLIN Technical Manual V2.4.0...
Description of the data path Parameter update timing MARLIN cameras show the following timing behavior: • Frame rate or transfer rate is always constant (precondition: shutter < transfer time) • The delay from shutter update until the change takes place: up to 3 frames.
Description of the data path Sharpness All Marlin color models are equipped with a two-step sharpness control, applying a discreet horizontal high pass in the green channel as shown in the next three line profiles. Figure 61: Sharpness: left: 0, middle: 1, right: 2 Note Configuration To configure this feature in feature control register: See...
Description of the data path RAW-mode is accessible via Color_Mode Mono8, RAW8 and via Format_7 Mode_1. Note If the PC does not perform BAYER to RGB post-processing the b/w image will be superimposed with a checkerboard pattern. Color interpolation (BAYER demosaicing) In color interpolation a red, green or blue value is determined for each pixel.
Description of the data path Color correction Why color correction The spectral response of a CCD is different of those of an output device or the human eye. This is the reason for the fact that perfect color reproduction is not possible. In each Marlin camera there is a factory setting for the color correction coefficients, see Chapter GretagMacbeth ColorChecker on page...
Description of the data path Note Configuration To configure this feature in an advanced register: See Table 119: Advanced register: Color correction on page 223. Color-correction coefficients cannot be changed. Color conversion (RGB YUV) The conversion from RGB to YUV is made using the following formulae: ×...
Description of the data path Note Configuration To configure this feature in feature control register: See Table 94: Feature control register on page 195. Serial interface With FW > 2.03, all Marlin cameras are equipped with the SIO (serial input/ output) feature as described in IIDC V1.31.
Page 109
Description of the data path To configure this feature in access control register (CSR): Offset Name Field Description 000h SERIAL_MODE_REG Baud_Rate [0..7] Baud rate setting WR: Set baud rate RD: Read baud rate 0: 300 bps 1: 600 bps 2: 1200 bps 3: 2400 bps 4: 4800 bps 5: 9600 bps...
Page 110
Description of the data path Offset Name Field Description 0004h SERIAL_CONTROL_REG RE Receive enable RD: Current status 0: Disable 1: Enable Transmit enable RD: Current status 0: disable 1: Enable [2..7] Reserved SERIAL_STATUS_REG TDRD Transmit data buffer ready Read only 0: not ready 1: ready Reserved...
Page 111
Description of the data path Offset Name Field Description 008h RECEIVE_BUFFER_ RBUF_ST [0..7] SIO receive buffer status STATUS_CONTRL RD: Number of bytes pending in receive buffer WR: Ignored RBUF_CNT [8..15] SIO receive buffer control WR: Number of bytes to be read from the receive FIFO RD: Number of bytes left for readout from the receive FIFO...
Page 112
Description of the data path To read data: 1. Query RDRD flag (buffer ready?) and write the number of bytes the host wants to read to RBUF_CNT. 2. Read the number of bytes pending in the receive buffer RBUF_ST (more data in the buffer than the host wanted to read?) and the number of bytes left for reading from the receive FIFO in RBUF_CNT (host wanted to read more data than were in the buffer?).
Controlling image capture Controlling image capture Shutter modes The cameras support the SHUTTER_MODES specified in IIDC V1.3. For all mod- els this shutter is a global shutter; meaning that all pixels are exposed to the light at the same moment and for the same time span. Continuous mode In continuous modes the shutter is opened shortly before the vertical reset happens, thus acting in a frame-synchronous way.
Page 114
Controlling image capture External Trigger input, as applied at input pin, trigger falling edge External Trigger input, after inverting opto coupler Shutter register value External Trigger input, as applied at input pin External Trigger input, after inv. Opto. Integration Time Figure 63: Trigger_mode_0 and 1 MARLIN Technical Manual V2.4.0...
Controlling image capture Bulk trigger (Trigger_Mode_15) Trigger_Mode_15 is a bulk trigger, combining one external trigger event with continuous or one-shot or multi-shot internal trigger. It is an extension to the IIDC trigger modes. One external trigger event can be used to trigger a multitude of internal image intakes. This is especially useful for: •...
Page 116
Controlling image capture The functionality is controlled via bit [6] and bitgroup [12-15] of the IIDC register: Register Name Field Description 0xF0F00830 TRIGGER_MODE Presence_Inq Presence of this feature: 0: N/A 1: Available Abs_Control Absolute value control O: Control with value in the Value field 1: Control with value in the Absolute value If this bit = 1 the value in the Value field has to be ignored.
Page 117
Controlling image capture The screenshots below illustrate the use of Trigger_Mode_15 on a register level: • Line #1switches continuous mode off, leaving viewer in listen mode. • Line #2 prepares 830h register for external trigger and Mode_15. Left = continuous Middle = one-shot Right = multi-shot Line #3 switches camera back to...
Controlling image capture Trigger delay As already mentioned earlier, since firmware version 2.03, Marlin cameras feature various ways to delay image capture based on external trigger. With IIDC V1.31 there is a standard CSR at Register F0F00534/834h to control a delay up to FFFh x timebase value. The following table explains the inquiry register and the meaning of the var- ious bits.
Controlling image capture Name Field Description 0xF0F00834 TRIGGER_DELAY Presence_Inq Presence of this feature: 0:N/A 1:Available Abs_Control Absolute value control O: Control with value in the Value field 1: Control with value in the Absolute value CSR If this bit = 1, the value in the Value field has to be ignored [2..5] Reserved...
Controlling image capture The advanced register allows to delay the start of the integration by max. µs, which is max. 2.1 s after a trigger edge was detected. Note • Switching trigger delay to ON also switches external Trigger_Mode_0 to ON. •...
Controlling image capture The minimum adjustable exposure time set by register is 20 µs. The real minimum exposure time of a Marlin F-033 is then: 20 µs + 12 µs = 32 µs Extended shutter The exposure time for long-term integration of up to 67 seconds can be extended via the advanced register: EXTENDED_SHUTTER Register Name...
Controlling image capture One-shot Marlin cameras can record an image by setting the one-shot bit in the 61Ch register. This bit is automatically cleared after the image is captured. If the camera is placed in Iso_Enable mode (see Chapter ISO_Enable / Free-Run page 125), this flag is ignored.
Controlling image capture Microcontroller-Sync is an internal signal. It is generated by the microcon- troller to initiate a trigger. This can either be a direct trigger or a release for ExSync if the camera is externally triggered. End of exposure to first packet on the bus After the exposure, the CCD or CMOS sensor is read out;...
Controlling image capture Multi-Shot Setting multi-shot and entering a quantity of images in Count_Number in the 61Ch register enables the camera to record a specified number of images. The number is indicated in bits 16 to 31. If the camera is put into Iso_Enable mode (see Chapter ISO_Enable / Free-Run on page 125), this flag is ignored...
Controlling image capture The following screenshot shows an example of broadcast commands sent with the Firedemo example of FirePackage (version 1V51 or newer): Figure 68: Broadcast one-shot • Line 1 shows the broadcast command, which stops all cameras con- nected to the same IEEE 1394 bus. It is generated by holding the Shift key down while clicking on Write.
Page 127
Controlling image capture For the CCDs the uncertainty time delay before the start of exposure depends on the state of the sensor. A distinction is made as follows: FVal is active the sensor is reading out, the camera is busy In this case the camera must not change horizontal timing so that the trigger event is synchronized with the current horizontal clock.
Controlling image capture Frame memory and deferred image transport An image is normally captured and transported in consecutive steps. The image is taken, read out from the sensor, digitized and sent over the 1394 bus. Deferred image transport As all Marlin cameras are equipped with built in image memory, this order of events can be paused or delayed by using the deferred image transport fea- ture.
Controlling image capture HoldImg mode By setting the HoldImg flag, transport of the image over the 1394 bus is stopped completely. All captured images are stored in the internal ImageFiFo. The camera reports the maximum possible number of images in the FiFoSize variable.
Sequence mode Generally all AVT Marlin cameras enable certain image settings to be modified on the fly, e.g. gain and shutter can be changed by the host computer by writing into the gain and shutter register even while the camera is running.
Controlling image capture Mode this registers can be modified... All modes Cur_V_Mode, Cur_V_Format, ISO_Channel, ISO_Speed, Brightness, White_Balance (color cameras only), Shutter, Gain, look-up table, TestImage Fixed modes only Cur_V_Frm_Rate Format_7 only Image_Position, Image_Size, Color_Coding_ID, Byte_Per_Packet Table 50: Registers to be modified within a sequence Note Sequence mode requires not only FW 3.03 but also special care if changing image size, Color_Coding_ID and frame rate...
Page 132
Controlling image capture Register Name Field Description 0xF1000224 SEQUENCE_PARAM --- [0..4] Reserved ApplyParameters Apply settings to selected image of sequence; auto-reset IncImageNo Increment ImageNo after ApplyParameters has finished [7..23] Reserved ImageNo [24..31] Number of image within a sequence Table 51: Advanced register: Sequence mode MARLIN Technical Manual V2.4.0...
Page 133
Controlling image capture The following flow diagram shows how to set up a sequence: SEQUENCE_CTRL ON_OFF flag to true (1) Set SeqLength to desired length (<=MaxLength) Set ImageNo = 0 in SEQUENCE_PARAM Assign image parameters in the corresp. registers Repeat steps until ApplyParameters sequence is = 1 (AutoReset)
Controlling image capture Points to pay attention to when working with a sequence Note • If more images are recorded than defined in SeqLength, the settings for the last image remain in effect. • If sequence mode is cancelled, the camera can use the FIFO for other tasks.
Controlling image capture Changing the parameters within a sequence To change the parameter set for one image, it is not necessary to modify the settings for the entire sequence. The image can simply be selected via the ImageNo field and it is then possible to change the corresponding IIDC V1.3 registers.
Controlling image capture Secure image signature (SIS) SIS: Definition Secure image signature (SIS) is the synonym for data, which is inserted into an image to improve or check image integrity. With the new firmware V3.03, all CCD Marlin models can insert •...
Video formats, modes and bandwidth Video formats, modes and bandwidth The different Marlin models support different video formats, modes and frame rates. These formats and modes are standardized in the IIDC (formerly DCAM) spec- ification. Resolutions smaller than the generic sensor resolution are generated from the center of the sensor and without binning.
Video formats, modes and bandwidth MARLIN F-033B/ MARLIN F-033C Format Mode Resolution Color mode 3.75 1.875 160 x 120 YUV444 320 x 240 YUV422 640 x 480 YUV411 640 x 480 YUV422 640 x 480 RGB8 640 x 480 Mono8 640 x 480 Mono16 Table 52: Video fixed formats Marlin F-033B /...
Video formats, modes and bandwidth MARLIN F-046B/ MARLIN F-046C Format Mode Resolution Color mode 3.75 1.875 160 x 120 YUV444 320 x 240 YUV422 640 x 480 YUV411 640 x 480 YUV422 640 x 480 RGB8 640 x 480 Mono8 640 x 480 Mono16 Table 54: Video formats Marlin F-046B /...
Video formats, modes and bandwidth MARLIN F-080B/ MARLIN F-080C (-30 fps) Format Mode Resolution Color mode 3.75 1.875 160 x 120 YUV444 320 x 240 YUV422 640 x 480 YUV411 640 x 480 YUV422 640 x 480 RGB8 640 x 480 Mono8 640 x 480 Mono16...
Video formats, modes and bandwidth MARLIN F-145B2/ MARLIN F-145C2 Format Mode Resolution Color mode 3.75 1.875 160 x 120 YUV444 320 x 240 YUV422 640 x 480 YUV411 640 x 480 YUV422 640 x 480 RGB8 640 x 480 Mono8 640 x 480 Mono16 800 x 600...
Page 142
Video formats, modes and bandwidth Format Mode Resolution Color mode Maximal S400 frame rates for Format_7 modes 1392 x 1040 Mono8 10 fps Mono16 10 fps 1392 x 1038 YUV411 10 fps YUV422 10 fps RGB8 7.5 fps RAW8 10 fps 696 x 1040 Mono8 10 fps...
Video formats, modes and bandwidth MARLIN F-146B / MARLIN F-146C Format Mode Resolution Color mode 3.75 1.875 160 x 120 YUV444 320 x 240 YUV422 640 x 480 YUV411 640 x 480 YUV422 640 x 480 RGB8 640 x 480 Mono8 640 x 480 Mono16...
Page 144
Video formats, modes and bandwidth Format Mode Resolution Color mode Maximal S400 frame rates for Format_7 modes 1392 x 1040 Mono8 17.43 fps Mono16 11.32 fps 1392 x 1038 YUV411 15.1 fps YUV422 11.3 fps RGB8 7.55 fps RAW8 17.47 fps 696 x 1040 Mono8 17.43 fps H-binning...
Video formats, modes and bandwidth MARLIN F-201B / MARLIN F-201C Format Mode Resolution Color mode 3.75 1.875 160 x 120 YUV444 320 x 240 YUV422 640 x 480 YUV411 640 x 480 YUV422 640 x 480 RGB8 640 x 480 Mono8 640 x 480 Mono16...
Page 146
Video formats, modes and bandwidth Format Mode Resolution Color mode Maximal S400 frame rates for Format_7 modes 1628 x 1236 Mono8 12.48 fps Mono16 8.14 fps 1628 x 1234 YUV411 10.87 fps YUV422 8.15 fps RGB8 5.43 fps RAW8 12.52 fps 812 x 1236 Mono8 12.48 fps H-binning...
Video formats, modes and bandwidth MARLIN F-131B (NIR)/ MARLIN F-131C Format Mode Resolution Color mode 3.75 1.875 160 x 120 YUV444 320 x 240 YUV422 640 x 480 YUV411 640 x 480 YUV422 640 x 480 640 x 480 Mono8 640 x 480 Mono16 800 x 600...
Page 148
Video formats, modes and bandwidth Format Mode Resolution Color mode Maximal S400 frame rates for Format_7 modes 1280 x 1024 Mono8 25 fps* 1280 x 1020 YUV411 17 fps* YUV422 12 fps* 640 x 1024 Mono8 48 fps* H-sub-sampling 640 x 1020 YUV411 33 fps* YUV422...
Video formats, modes and bandwidth Area of interest (AOI) The camera’s image sensor has a defined resolution. This indicates the max- imum number of lines and pixels per line that the recorded image may have. However, often only a certain section of the entire image is of interest. The amount of data to be transferred can be decreased by limiting the image to a section when reading it out from the camera.
Page 150
Video formats, modes and bandwidth Figure 72: Area of Interest (AOI) Note • The left position + width and the upper position + height may not exceed the maximum resolution of the sensor. • The coordinates for width and height must be divisible by 4.
Video formats, modes and bandwidth Autofunction AOI Use this feature to select the image area (work area) on which the following autofunctions work: • Auto shutter • Auto gain • Auto white balance In the following screenshot you can see an example of the autofunction AOI: Work area Figure 73: Example of autofunction AOI (Show work area is on) Note...
Video formats, modes and bandwidth Note To configure this feature in an advanced register see Table 117: Advanced register: Autofunction AOI on page 222. Frame rates An IEEE 1394 camera requires bandwidth to transport images. The IEEE 1394a bus has very large bandwidth of at least 32 Mbyte/s for trans- ferring (isochronously) image data.
Page 153
Video formats, modes and bandwidth Format Mode Resolution 3.75 160 x 120 YUV444 1/2H 1/4H 1/8H 24 bit/pixel 320 x 240 YUV422 1/2H 1/4H 1/8H 320p 160p 16 bit/pixel 160q 640 x 480 YUV411 1/2H 1/4H 1280p 640p 320p 160p 12 bit/pixel 480q 240q...
Page 154
Video formats, modes and bandwidth Format Mode Resolution 3.75 1.875 800 x 600 YUV422 5/2H 5/4H 5/8H 6/16H 2000p 1000p 500p 250p 16 bit/pixel 1000q 500q 250q 125q 800 x 600 RGB 5/4H 5/8H 1000p 500p 24 bit/pixel 750q 375q 800 x 600 Y (Mono8) 5/2H 5/4H...
Page 155
Video formats, modes and bandwidth Format Mode Resolution 3.75 1.875 1280 x 960 YUV422 1/2H 1/4H 1280p 640p 320p 16 bit/pixel 640q 320q 160q 1280 x 960 RGB 1/2H 1/4H 1280p 640p 320p 24 bit/pixel 960q 480q 240q 1280 x 960 Y (Mono8) 1/2H 1/4H 2560p...
Video formats, modes and bandwidth The frame rates in video modes 0 to 2 are specified and set fixed by IIDC V1.3. Frame rates Format_7 In video Format_7 frame rates are no longer fixed but can be varied dynam- ically by the parameters described below. Note •...
Video formats, modes and bandwidth MARLIN F-131: AOI frame rates This model uses a CMOS sensor with global shutter. As mentioned earlier for the non pipelined global shutter, the integration time must be added to the readout time to define the maximum frame rate. The next table gives an example: (it assumes full horizontal width and an integration time of 1 ms).
How does bandwidth affect the frame rate? How does bandwidth affect the frame rate? In some modes the IEEE 1394a bus limits the attainable frame rate. Accord- ing to the 1394a specification on isochronous transfer, the largest data pay- load size of 4096 bytes per 125 µs cycle is possible with bandwidth of 400 Mbit/s.
How does bandwidth affect the frame rate? Example formula for the b/w camera Mono16, 1392 x 1040, 15 fps desired × × × × > BYTE_PER_PACKET 15 1392 1040 125µs 5428 4096 4096 ⇒ ≈ ----------------------------------------------------------- - frame rate 11.32 ×...
How does bandwidth affect the frame rate? Test images Loading test images FirePackage Fire4Linux 1. Start SmartView. 1. Start cc1394 viewer. 2. Click the Edit settings button. 2. In Adjustments menu click on Picture Control. 3. Click Adv1 tab. 3. Click Main tab. 4.
How does bandwidth affect the frame rate? )MOD256 Gray value 8-bit mode Formula 15: Calculating the gray value Test images for color cameras The color cameras have the following test images: YUV422 mode Figure 82: Color test image MARLIN Technical Manual V2.4.0...
How does bandwidth affect the frame rate? Mono8 (raw data) Figure 83: Bayer-coded test image The color camera outputs Bayer-coded raw data in Mono8 instead of (as described in IIDC V1.3) a real Y signal. Note The first pixel of the image is always the red pixel from the sensor.
Configuration of the camera Configuration of the camera All camera settings are made by writing specific values into the correspond- ing registers. This applies to: • values for general operating states such as video formats and modes, exposure times, etc. •...
Configuration of the camera Every register is 32 bit (big endian) and implemented as follows (MSB = Most Significant Bit; LSB = Least Significant Bit): Far left Table 80: 32-bit register Example This requires, for example, that to enable ISO_Enabled mode (see Chapter ISO_Enable / Free-Run on page 125), (bit 0 in register 614h), the value 80000000 h must be written in the corresponding register.
Configuration of the camera Figure 84: Configuration of the camera Sample program The following sample code in C shows how the register is set for frame rate, video mode/format and trigger mode using the FireCtrl DLL from the FirePackage API. Also shown is how the camera is switched into ISO_Enabled mode: …...
Configuration of the camera Configuration ROM The information in the Configuration ROM is needed to identify the node, its capabilities and which drivers are required. The base address for the configuration ROM for all registers is FFFF F0000000h. Note If you want to use the DirectControl program to read or write to a register, enter the following value in the Address field: F0F00000h + Offset The ConfigRom is divided into...
Page 175
Configuration of the camera To compute the effective start address of the node unique ID leaf currAddr = node unique ID leaf address destAddr = address of directory entry addrOffset = value of directory entry destAddr = currAddr + (4 x addrOffset) = 420h + (4 x 000002h) = 428h Table 82: Computing effective start address...
Page 176
Configuration of the camera Offset 8-15 16-23 24-31 444h Unit dependent info 448h 44Ch 450h Table 85: Config ROM And finally, the entry with key 40 (448h in this case) provides the offset for the camera control register: FFFF F0000000h + 3C0000h x 4 = FFFF F0F00000h The base address of the camera control register is thus: FFFF F0F00000h The offset entered in the table always refers to the base address of...
Configuration of the camera Implemented registers (IIDC V1.3) The following tables show how standard registers from IIDC V1.3 are imple- mented in the camera: • Base address is F0F00000h • Differences and explanations can be found in the Description column. Camera initialize register Offset Name...
Configuration of the camera Inquiry register for video mode Offset Name Field Description 180h V_MODE_INQ Mode_0 160 x 120 YUV444 Mode _1 320 x 240 YUV422 (Format_0) Mode _2 640 x 480 YUV411 Mode _3 640 x 480 YUV422 Mode _4 640 x 480 RGB Mode _5 640 x 480 Mono8...
Configuration of the camera Offset Name Field Description 19Ch V_MODE_INQ Mode_0 Format_7 Mode_0 Mode _1 Format_7 Mode_1 (Format_7) Mode _2 Format_7 Mode_2 Mode _3 Format_7 Mode_3 Mode _4 Format_7 Mode_4 Mode _5 Format_7 Mode_5 Mode _6 Format_7 Mode_6 Mode _7 Format_7 Mode_7 [8..31] Reserved (zero)
Page 180
Configuration of the camera Offset Name Field Description 208h V_RATE_INQ FrameRate_0 1.875 fps FrameRate _1 3.75 fps (Format_0, Mode_2) FrameRate _2 7.5 fps FrameRate _3 15 fps FrameRate _4 30 fps FrameRate _5 60 fps FrameRate _6 120 fps (IIDC V1.31) FrameRate _7 240 fps (IIDC V1.31) [8..31]...
Page 181
Configuration of the camera Offset Name Field Description 214h V_RATE_INQ FrameRate_0 1.875 fps FrameRate _1 3.75 fps (Format_0, Mode_5) FrameRate _2 7.5 fps FrameRate _3 15 fps FrameRate _4 30 fps FrameRate _5 60 fps FrameRate _6 120 fps (IIDC V1.31) FrameRate _7 240 fps (IIDC V1.31) [8..31]...
Page 182
Configuration of the camera Offset Name Field Description 224h V_RATE_INQ FrameRate_0 Reserved FrameRate _1 Reserved (Format_1, Mode_1) FrameRate _2 7.5 fps FrameRate _3 15 fps FrameRate _4 30 fps FrameRate _5 60 fps FrameRate _6 120 fps (IIDC V1.31) FrameRate _7 240 fps (IIDC V1.31) [8..31] Reserved (zero)
Page 183
Configuration of the camera Offset Name Field Description 230h V_RATE_INQ FrameRate_0 1.875 fps FrameRate _1 3.75 fps (Format_1, Mode_4) FrameRate _2 7.5 fps FrameRate _3 15 fps FrameRate _4 30 fps FrameRate _5 60 fps FrameRate _6 120 fps (IIDC V1.31) FrameRate _7 240 fps (IIDC V1.31) [8..31]...
Page 184
Configuration of the camera Offset Name Field Description 23Ch V_RATE_INQ FrameRate_0 1.875 fps FrameRate _1 3.75 fps (Format_1, Mode_7) FrameRate _2 7.5 fps FrameRate _3 15 fps FrameRate _4 30 fps FrameRate _5 60 fps FrameRate _6 120 fps (IIDC V1.31) FrameRate _7 Reserved [8..31]...
Page 185
Configuration of the camera Offset Name Field Description 248h V_RATE_INQ FrameRate_0 1.875 fps FrameRate _1 3.75 fps (Format_2, Mode_2) FrameRate _2 7.5 fps FrameRate _3 15 fps FrameRate _4 30 fps FrameRate _5 60 fps FrameRate _6 120 fps (IIDC V1.31) FrameRate _7 Reserved [8..31]...
Page 186
Configuration of the camera Offset Name Field Description 254h V_RATE_INQ FrameRate_0 1.875 fps FrameRate _1 3.75 fps (Format_2, Mode_5) FrameRate _2 7.5 fps FrameRate _3 15 fps FrameRate _4 30 fps FrameRate _5 60 fps FrameRate _6 Reserved FrameRate _7 Reserved [8..31] Reserved (zero)
Page 187
Configuration of the camera Offset Name Field Description 2E0h [0..31] CSR_quadlet offset for Format_7 V-CSR_INQ_7_0 Mode_0 2E4h [0..31] CSR_quadlet offset for Format_7 V-CSR_INQ_7_1 Mode_1 2E8h [0..31] CSR_quadlet offset for Format_7 V-CSR_INQ_7_2 Mode_2 2ECh [0..31] CSR_quadlet offset for Format_7 V-CSR_INQ_7_3 Mode_3 2F0h [0..31] CSR_quadlet offset for Format_7...
Configuration of the camera Inquiry register for basic function Offset Name Field Description 400h BASIC_FUNC_INQ Advanced_Feature_Inq Inquiry for advanced fea- tures (Vendor unique Fea- tures) Vmode_Error_Status_Inq Inquiry for existence of Vmode_Error_Status regis- Feature_Control_Error_Status_Inq [2] Inquiry for existence of Feature_Control_Error_Status Opt_Func_CSR_Inq Inquiry for Opt_Func_CSR [4..7] Reserved...
Configuration of the camera Inquiry register for feature presence Offset Name Field Description 404h FEATURE_HI_INQ Brightness Brightness control Auto_Exposure Auto_Exposure control Sharpness Sharpness control White_Balance White balance control Hue control Saturation Saturation control Gamma Gamma control Shutter Shutter control Gain Gain control Iris Iris control...
Page 190
Configuration of the camera Offset Name Field Description 410h Reserved Address error on access 47Fh 480h Advanced_Feature_Inq Advanced_Feature_Quadlet_Offset [0..31] Quadlet offset of the advanced feature CSR's from the base address of initial register space (Vendor unique) This register is the offset for the Access_Control_Register and thus the base address for Advanced Features.
Configuration of the camera Inquiry register for feature elements Register Name Field Description 0xF0F00500 BRIGHTNESS_INQUIRY Presence_Inq Indicates presence of this feature (read only) Abs_Control_Inq Capability of control with absolute value Reserved One_Push_Inq One Push auto mode (con- trolled automatically by the camera once) Readout_Inq Capability of reading out the...
Page 192
Configuration of the camera Register Name Field Description 530h TRIGGER_INQ Presence_Inq Indicates presence of this feature (read only) Abs_Control_Inq Capability of control with absolute value [2..3 Reserved Readout_Inq Capability of reading out the value of this feature ON_OFF Capability of switching this feature ON and OFF Polarity_Inq Capability of changing the...
Page 193
Configuration of the camera Register Name Field Description 580h ZOOM_INQ Always 0 584h PAN_INQ Always 0 588h TILT_INQ Always 0 58Ch OPTICAL_FILTER_INQ Always 0 Reserved for other Always 0 FEATURE_LO_INQ 5BCh 5C0h CAPTURE_SIZE_INQ Always 0 5C4h CAPTURE_QUALITY_INQ Always 0 5C8h Reserved for other Always 0 FEATURE_LO_INQ...
Configuration of the camera Status and control register for feature The OnePush feature, WHITE_BALANCE, is currently implemented. If this flag is set, the feature becomes immediately active, even if no images are being input (see Chapter One-push automatic white balance on page 72).
Page 196
Configuration of the camera Offset Name Field Description 804h AUTO-EXPOSURE See above Note: Target grey level parameter in SmartView corresponds to Auto_exposure register 0xF0F00804 (IIDC). 808h SHARPNESS See above Table 94: Feature control register MARLIN Technical Manual V2.4.0...
Page 197
Configuration of the camera Offset Name Field Description 80Ch WHITE-BALANCE Presence_Inq Presence of this feature 0: N/A 1: Available Always 0 for Mono Abs_Control Absolute value control 0: Control with value in the Value field 1: Control with value in the Absolute value CSR If this bit = 1, value in the Value field is ignored.
Page 198
Configuration of the camera Offset Name Field Description 810h See above Always 0 for Mono 814h SATURATION See above Always 0 for Mono 818h GAMMA See above 81Ch SHUTTER see Advanced Feature Timebase 820h GAIN See above 824h IRIS Always 0 828h FOCUS Always 0...
Configuration of the camera Feature control error status register Offset Name Notes 640h Feature_Control_Error_Status_HI always 0 644h Feature_Control_Error_Status_LO always 0 Table 95: Feature control error register Video mode control and status registers for Format_7 Quadlet offset Format_7 Mode_0 The quadlet offset to the base address for Format_7 Mode_0, which can be read out at F0F002E0h (according to Table 89: Frame rate inquiry register page 179) gives 003C2000h.
Page 200
Configuration of the camera Offset Name Notes 040h PACKET_PARA_INQ See note 044h BYTE_PER_PACKET According to IIDC V1.3 Table 96: Format_7 control and status register Note • For all modes in Format_7, ErrorFlag_1 and ErrorFlag_2 are refreshed on each access to the Format_7 register.
Configuration of the camera Advanced features (AVT-specific) The camera has a variety of extended features going beyond the possibilities described in IIDC V1.3. The following chapter summarizes all available advanced features in ascending register order. Note This chapter is a reference guide for advanced registers and does not explain the advanced features itself.
Page 202
Configuration of the camera Register Register name Description 0XF1000260 DEFERRED_TRANS Table 109: Advanced register: Deferred image transport on page 215 0XF1000270 FRAMEINFO Table 110: Frame information register on page 0XF1000274 FRAMECOUNTER See FRMCNT_STAMP 0XF1000280 HDR_CONTROL MARLIN F-131x only 0XF1000284 KNEEPOINT_1 Table 111: High dynamic range configuration register on page 217...
Page 203
Configuration of the camera Register Register name Description 0XF1000400 TRIGGER_DELAY Table 120: Advanced register: Trigger Delay page 223 0XF1000410 MIRROR_IMAGE MARLIN/OSCAR series only Table 121: Advanced register: Mirror on page 0XF1000510 SOFT_RESET Table 122: Advanced register: Soft reset page 224 0XF1000550 USER_PROFILE Table 128: Advanced register: User profiles...
Configuration of the camera Version information inquiry The presence of each of the following features can be queried by the 0 bit of the corresponding register. Register Name Field Description F1000010 VERSION_INFO1 µC type ID [0..15] Reserved µC version [16..31] Bcd-coded vers.# F1000014 [0..31]...
Page 205
Configuration of the camera Camera type MF145C2 MF131B MF131C MF145B2-15fps MF145C2-15fps M2F033B M2F033C M2F046B M2F046C M2F080B M2F080C M2F145B2 M2F145C2 M2F145B2-15fps M2F145C2-15fps OF320C OF510C OF810C M2F080B-30fps M2F080C-30fps M2F145B2-ASM MM2F145C2-ASM M2F201B M2F201C M2F146B M2F146C Table 99: Camera type ID list Note • MARLINs with serial numbers beginning with 6xx iden- tify itself as M2F…...
Configuration of the camera Advanced feature inquiry This register indicates with a named bit if a feature is present or not. If a feature is marked as not present the associated register space might not be available and read/write errors may occur. Note Ignore unnamed bits in the following table: these bits might be set or not.
Configuration of the camera Register Name Field Description 0xF1000044 ADV_INQ_2 Input_1 Input_2 Reserved [3..7] Reserved Output_1 Output_2 [10] Reserved [11..15] Reserved IntEnaDelay [16] [17] Reserved [18..31] Reserved 0xF1000048 ADV_INQ_3 [0..31] Reserved 0xF100004C ADV_INQ_4 [0..31] Reserved Table 100: Advanced register: Advanced feature inquiry Maximum resolution This register indicates the highest resolution for the sensor and is read-only.
Configuration of the camera Time base Corresponding to IIDC, exposure time is set via a 12-bit value in the corre- sponding register (SHUTTER_INQ [51Ch] and SHUTTER [81Ch]). This means that a value in the range of 1 to 4095 can be entered. Marlin cameras use a time-base which is multiplied by the shutter register value.
Page 209
Configuration of the camera Timebase [µs] Default value 1000 Table 103: Timebase ID Note The ABSOLUTE VALUE CSR register, introduced in IIDC V1.3, is not implemented. MARLIN Technical Manual V2.4.0...
Configuration of the camera Extended shutter The exposure time for long-term integration of up to 67 sec. can be entered with µs-precision via the EXTENDED_SHUTTER register. Register Name Field Description 0xF100020C EXTD_SHUTTER Presence_Inq Indicates presence of this fea- ture (read only) [1..
Configuration of the camera Test images Bits 8-14 indicate which test images are saved. Setting bits 28-31 activates or deactivates existing test images. • auto gain • auto shutter • auto white balance Register Name Field Description 0xF1000210 TEST_IMAGE Presence_Inq Indicates presence of this feature (read only) [1..7]...
Configuration of the camera Sequence control It is possible to make certain settings for a sequence of images beforehand by using this register. Register Name Field Description 0xF1000220 SEQUENCE_CTRL Presence_Inq Indicates presence of this feature (read only) [1..4] Reserved AutoRewind ON_OFF Enable/Disable this feature [7..15]...
Configuration of the camera Look-up tables (LUT) Load the look-up tables to be used into the camera and choose the look-up table number via the LutNo field. Now you can activate the chosen LUT via the LUT_CTRL register. The LUT_INFO register indicates how many LUTs the camera can store and shows the maximum size of the individual LUTs.
Configuration of the camera Shading correction Owing to technical circumstances, the interaction of recorded objects with one another, optical effects and lighting non-homogeneities may occur in the images. Because these effects are normally not desired, they should be eliminated as far as possible in subsequent image editing.
Configuration of the camera Register Name Field Description 0xF1000258 SHDG_INFO Presence_Inq Indicates presence of this feature (read only) [1..7] Reserved MaxImageSize [8..31] Maximum shading image size (in bytes) Table 108: Advanced register: Shading Deferred image transport Using the register, the sequence of recording and the transfer of the images can be paused.
Configuration of the camera Frame information This register can be used to double-check the number of images received by the host computer against the number of images which were transmitted by the camera. The camera increments this counter with every FrameValid sig- nal.
Configuration of the camera High dynamic range mode (MARLIN F-131B/C only) The CMOS sensor of the MARLIN F-131 offers a special mode by which various nonlinearity points, the so-called knee points, can be freely adjusted. This enables the high dynamic range of the sensor to be compressed into 8 bit, preserving interesting details of the image.
Configuration of the camera DSNU control The table below shows the advanced register map, required to control this functionality. Register Name Field Description 0xF1000290 DSNU_CONTROL Presence_Inq Indicates presence of this feature (read only) ComputeError [2..3] Reserved ShowImage Show correction data as image ComputeData Compute new DSNU correc-...
Configuration of the camera Having generated the correction data it is possible to separately control the blemish pixel correction with the help of the following register: Register Name Field Description 0xF1000294 BLEMISH_CONTROL Presence_Inq Indicates presence of this feature (read only) ComputeError see DSNU_CONTROL [2..3]...
Configuration of the camera Delayed Integration Enable (IntEna) A delay time between initiating exposure on the sensor and the activation edge of the IntEna signal can be set using this register. The on/off flag acti- vates/deactivates integration delay. The time can be set in µs in DelayTime. Note •...
Configuration of the camera Auto shutter control The table below illustrates the advanced register for auto shutter control. The purpose of this register is to limit the range within which auto shutter operates. Register Name Field Description 0xF1000360 AUTOSHUTTER_CTRL Presence_Inq Indicates presence of this fea- ture (read only) [1..31]...
Configuration of the camera Autofunction AOI AUTOFNC_AOI affects the auto shutter, auto gain and auto white balance fea- tures and is independent of the Format7 AOI settings. If this feature is switched off the work area position and size follow the current active image size.
Configuration of the camera E.g. if the active image size is 640 x 480 pixel the camera accepts a maximum of 640 x 512 pixel as the auto function AOI work area (if the control area position is 0:0). Another case is for outdoor applications: the sky will be excluded from the generation of the reference levels.
Configuration of the camera Note Trigger delay works with external trigger modes only. Mirror image The table below illustrates the advanced register for Mirror image. Register Name Field Description 0xF1000410 MIRROR_IMAGE Presence_Inq Indicates presence of this feature (read only) [1..5] Reserved ON_OFF Mirror image on/off...
Configuration of the camera Note When SOFT_RESET has been defined, the camera will respond to further read or write requests but will not process them. Secure image signature (SIS) Definition Secure image signature (SIS) is the synonym for data, which is inserted into an image to improve or check image integrity.
Page 226
Configuration of the camera Register Name Field Description 0xF1000600 TIMESTAMP Presence_Inq Indicates presence of this feature (read only) [1..5] Reserved ON_OFF SIS (time stamp) on/off Reserved Format_0_Inq Presence of Format_0 0: n/a 1: available Reserved [10] Reserved [11] Reserved [12] Reserved [13..15] Write as 0.
Page 227
Configuration of the camera Note SIS outside the visible image area: For certain Format_7 modes the image frame transported may contain padding (filling) data at the end of the transported frame. Setting LinePos=HeightOfImage places the stamp in this padding data area, outside the visible area (invisible SIS).
Configuration of the camera Advanced register: frame counter The frame counter feature is controlled by the following advanced feature register: Register Name Field Description 0xF1000610 FRMCNT_STAMP Presence_Inq Indicates presence of this feature (read only) Reset Reset frame counter [2..5] Reserved ON_OFF SIS (time stamp) on/off Reserved...
Configuration of the camera Advanced register: trigger counter The trigger counter feature is controlled by the following advanced feature register: Register Name Field Description 0xF1000620 TRGCNT_STAMP Presence_Inq Indicates presence of this feature (read only) Reset Reset trigger counter [2..5] Reserved ON_OFF SIS (time stamp) on/off Reserved...
Configuration of the camera Where to find time stamp, frame counter and trigger counter in the image Time stamp Trigger counter Output line 5 6 7 10 11 12 ..of image Frame counter Bytes Figure 86: SIS in the image MARLIN Technical Manual V2.4.0...
Configuration of the camera User profiles Definition Within the IIDC specification user profiles are called memory channels. Often they are called user sets. In fact these are different expressions for the following: storing camera settings into a non-volatile memory inside the camera.
Configuration of the camera Note • The default profile is the profile that is loaded on power-up or an INITIALIZE command. • A save or load operation delays the response of the camera until the operation is completed. At a time only one operation can be performed.
Configuration of the camera Reset of error codes The ErrorCode field is set to zero on the next write access. You may also reset the ErrorCode • by writing 00000000h to the USER_PROFILE register. Note • A profile save operation automatically disables captur- ing of images.
Configuration of the camera GPDATA_BUFFER GPDATA_BUFFER is a register that regulates the exchange of data between camera and host for programming the LUT and the upload/download of the shading image. GPDATA_INFO Buffer size query GPDATA_BUFFER indicates the actual storage range Register Name Field...
Firmware update Firmware update Firmware updates can be carried out without opening the camera. You need: • Programming cable E 1000666 • Software AVTCamProg • PC or laptop with serial interface (RS 232) • Documentation for firmware update Note Please make sure that the new Marlin firmware matches with the serial numbering.
+0 / -100μm (for SN > 252138124, optical back focal length) +/- 1° (Sensor rotation) AVT Marlin, Oscar, Dolphin, Pike, Stingray Method of Positioning: Optical alignment of photo sensitive sensor area into camera front module. (lens mount front flange) Reference points: Sensor: Center of pixel area (photo sensitive cells).
Page 239
Index correction data ........85 color interpretation ......104 amplification........... 70 Binning ..........94 analog color signal........70 binning Analog Devices ........70 full........... 97 AOI..........88 horizontal ......... 96 correction data ........88 vertical ..........95 Area of Interest (AOI) ......222 black level ..........
Page 240
Index camera dimensions........42 data packets ........... 61 camera interfaces........48 data path ..........65 Camera lenses.......... 19 data payload size ........166 cameras data_length ..........62 block diagram ........65 DCAM ........16 MARLIN..........17 declaration of conformity......18 Camera_Status_Register ......171 deferred image transport....