Page 1
Marlin Technical Manual For CCD models with serial numbers: xx/yy-6zzzzzzz and all CMOS models V2.7.0 09 April 2015 Allied Vision Technologies GmbH Taschenweg 2a D-07646 Stadtroda / Germany...
These products are not designed for use in life support appliances, devices, or systems where mal- function of these products can reasonably be expected to result in personal injury. Allied Vision Technologies customers using or selling these products for use in such applications do so at their own risk and agree to fully indemnify Allied for any damages resulting from such improper use or sale.
Page 6
Video mode control and status registers for Format_7............. 193 Quadlet offset Format_7 Mode_0 ................193 Quadlet offset Format_7 Mode_1 ................193 Format_7 control and status register (CSR) .............. 193 Advanced features (Allied Vision-specific) ................ 194 Advanced registers summary ..................194 Version information inquiry..................197 Marlin Technical Manual V.2.7.0...
Page 7
Error codes ......................222 Reset of error codes..................... 223 Stored settings....................224 GPDATA_BUFFER ..................... 225 Little endian vs. big endian byte order ..............225 Firmware update ....................226 Appendix ....................... 227 Sensor position accuracy of Marlin cameras............... 227 Marlin Technical Manual V.2.7.0...
Introduction Introduction This Marlin Technical Manual describes in depth the technical specifications, dimensions, all camera features (IIDC standard and Allied Vision smart features) and their registers, trigger features, all video and color formats, bandwidth and frame rate calculation. For information on hardware installation, safety warnings, pin assignments on I/O connectors and 1394b connectors read the 1394 Installation Manual.
Page 10
26.02.2007 Minor corrections New formula for Marlin F-131 (Formula 11: Frame rate calcula- tion Marlin F-131 as function of AOI height and width on page 136) Marlin F-145C2: corrected resolutions, new color formats in For- mat_7 Mode_0 and Format_7 Mode_2...
Page 11
Manual overview • Restructured Chapter Marlin types and highlights to Chapter Marlin cameras – Infos from Marlin camera types table moved to Chapter Specifications – Safety instructions moved to Hardware Installation Guide, Chapter Safety instructions and Allied Vision camera cleaning instructions –...
Page 12
Loading a shading image out of the camera – Chapter Loading a shading image into the camera Corrected: b/w and color Marlin cameras have IR cut filter (except Marlin F-131BNIR: ASG) in Chapter Specifications to be continued on next page Table 1: Document history Marlin Technical Manual V.2.7.0...
Page 13
Table 44: Video fixed formats Marlin F-146B / F-146C on page 114. Revised Chapter Conformity Corrected: Marlin F-131B/C and Marlin F-131B NIR: power only via 1394 cable (not via 12-pin HIROSE): Table 9: Specification Marlin F-131B (b/w also: NIR) on page 29 Corrected: Misc.
Page 14
09.08.2010 Some smaller corrections: • Corrected availability of some video fixed formats, see Table 40: Video fixed formats Marlin F-080B / F-080C (-30 fps) page 111 • Corrected trigger diagram (starting of Busy signal), see Figure 25: Output Impulse Diagram...
Spectral sensitiv- on page 30. Layout changes due to a changed Corporate identity: • Replaced the previous Allied Vision logo by the current one • Reworded all appropriate contents from AVT and Allied Vision Technologies to Allied Vision Table 1: Document history Manual overview This manual overview describes each chapter of this manual shortly.
FPGA/μC. • Chapter Appendix lists the sensor position accuracy of Allied Vision cam- eras. • Chapter Index gives you quick access to all relevant data in this manual.
For more information on hardware and software read the following: • 1394 Installation Manual describes the hardware installation procedures for all 1394 Allied Vision cameras (Dolphin, Oscar, Marlin, Guppy, Pike, Stingray). Additionally you get safety instructions and information about camera interfaces (IEEE1394a/b copper and GOF, I/O connectors, input and output).
For information on Allied Vision accessories and software read 1394 Installation Manual. Caution Before operating any Allied Vision camera read safety instruc- tions and ESD warnings in 1394 Installation Manual. Note To demonstrate the properties of the camera, all examples in this manual are based on the FirePackage OHCI API software ...
Page 19
Introduction For downloads see: Software (Vimba and all other software): http://www.alliedvision.com/en/support/software-down- loads Firmware: http://www.alliedvision.com/en/support/firm- ware Technical documentation (overview page): http://www.alliedvision.com/en/support/technical-docu- mentation Technical papers (appnotes, white papers) and knowledge base: http://www.alliedvision.com/en/support/technical-papers- knowledge-base Marlin Technical Manual V.2.7.0...
Entry-level model With the Marlin, Allied Vision presents a whole series of attractive digital camera entry-level models of the FireWire™ type. Image applications Allied Vision can provide users with a range of products that meet almost all the requirements of a very wide range of image applications.
Conformity Conformity Allied Vision Technologies declares under its sole responsibility that all stan- dard cameras of the Marlin family to which this declaration relates are in confor- mity with the following standard(s) or other normative document(s): • CE, following the provisions of 2004/108/EG directive •...
Specifications Specifications Note For information on bit/pixel and byte/pixel for each color mode see Table 77: ByteDepth on page 160. Maximum protrusion means the distance from lens flange to the glass filter in the camera. Marlin Technical Manual V.2.7.0...
All measurements were done without protection glass / without filter. The uncertainty in measurement of the QE values is 10%. This is mainly due to: • Manufacturing tolerance of the sensor • Uncertainties in the measuring apparatus itself Marlin Technical Manual V.2.7.0...
Page 31
Specifications 1000 Wavelength [nm] Figure 1: Spectral sensitivity of Marlin F-033B without cut filter and optics Green Blue Wavelength [nm] Figure 2: Spectral sensitivity of Marlin F-033C without cut filter and optics Marlin Technical Manual V.2.7.0...
Page 32
Specifications 1000 Wavelength [nm] Figure 3: Spectral sensitivity of Marlin F-046B without cut filter and optics Green Blue Wavelength [nm] Figure 4: Spectral sensitivity of Marlin F-046C without cut filter and optics Marlin Technical Manual V.2.7.0...
Page 33
Specifications 1000 Wavelength [nm] Figure 5: Spectral sensitivity of Marlin F-080B without cut filter and optics Green Blue Wavelength [nm] Figure 6: Spectral sensitivity of Marlin F-080C without cut filter and optics Marlin Technical Manual V.2.7.0...
Page 34
Specifications 1000 Wavelength [nm] Figure 7: Spectral sensitivity of Marlin F-145B2 without cut filter and optics Green Blue Wavelength [nm] Figure 8: Spectral sensitivity of Marlin F-145C2 without cut filter and optics Marlin Technical Manual V.2.7.0...
Page 35
Specifications 1000 Wavelength [nm] Figure 9: Spectral sensitivity of Marlin F-146B without cut filter and optics Green Blue Wavelength [nm] Figure 10: Spectral sensitivity of Marlin F-146C without cut filter and optics Marlin Technical Manual V.2.7.0...
Page 36
Specifications 1000 Wavelength [nm] Figure 11: Spectral sensitivity of Marlin F-201B without cut filter and optics Green Blue Wavelength [nm] Figure 12: Spectral sensitivity of Marlin F-201C without cut filter and optics Marlin Technical Manual V.2.7.0...
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 Marlin cameras on page 227. Marlin standard housing Body size: 72 mm x 44 mm x 29 mm (L x W x H)
Camera dimensions Marlin W90 This version has the sensor tilted by 90 degrees clockwise, so that it views upwards. Figure 15: Marlin W90 Marlin Technical Manual V.2.7.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 16: Marlin W90 S90 Marlin Technical Manual V.2.7.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 17: Marlin W270 Marlin Technical Manual V.2.7.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 18: Marlin W270 S90 Marlin Technical Manual V.2.7.0...
The following illustration shows the spectral transmission of the IR cut filter: Figure 19: Spectral transmission of Jenofilt 217 Camera lenses Allied Vision offers different lenses from a variety of manufacturers. The follow- ing table lists selected image formats depending on camera type, distance and the focal length of the lens.
Page 44
9.6 cm x 12.8 cm 50 mm 3.3 cm x 4.4 cm 6.6 cm x 8.8 cm Table 11: Focal length vs. field of view (Marlin F-080) Focal length Marlin F-131 Distance = 0.5 m Distance = 1 m 4.8 mm 0.7 m x 0.93 m...
4.5 m or up to 17.5 m. For more information on cables and on ordering cables online (by clicking the article and sending an inquiry) go to: http://www.alliedvision.com/en/contact Marlin Technical Manual V.2.7.0...
For a detailed description of the I/O connector and its operat- ing instructions see the 1394 Installation Manual, Chapter Marlin input description. Read all Notes and Cautions in the 1394 Installation Manual, before using the I/O connector. Marlin Technical Manual V.2.7.0...
Table 14: LED indication: green Status LED yellow The following states are displayed via the yellow LED: State Description Com/S1 Asynchronous and isochronous data transmission active (indicated asynchronously to transmission over the 1394 bus) Table 15: LED indication: yellow Marlin Technical Manual V.2.7.0...
Page 48
The longer OFF-time of 3.5 sec. signals the beginning of a new class period. The error codes follow after a shorter OFF-time of 1.5 sec. Example 3.5 sec. one blink 1.5 sec. 2 blinks indicates a warning: Format_7_Error_1 Marlin Technical Manual V.2.7.0...
Inputs Note For a general description of the inputs and warnings see the 1394 Installation Manual, Chapter Marlin input description. The optical coupler inverts all input signals. Polarity is controlled via the IO_IN- P_CTRL1..2 register.
Auto_Inq Auto Mode (controlled auto- matically by the camera) Manual_Inq Manual mode (controlled by user) Min_Value [8..19] Minimum value for this fea- ture Max_Value [20..31] Maximum value for this fea- ture Table 19: Trigger delay inquiry register Marlin Technical Manual V.2.7.0...
Page 52
The advanced register allows the start of the integration to be delayed by max. μs, which is max. 2.1 s after a trigger edge was detected. Note • Switching trigger delay to ON also switches external Trig- ger_Mode_0 to ON. • This feature works with external Trigger_Mode_0 only. Marlin Technical Manual V.2.7.0...
Camera interfaces Outputs Note For a general description of the outputs and warnings see the 1394 Installation Manual, Chapter Marlin output description. Output features are configured by software. Any signal can be placed on any out- put. The main features of output signals are described below:...
Output mode [11..15] Mode Table 24: Output routing on page 55 [16..30] Reserved PinState [31] RD: Current state of pin WR: New state of pin 0xF1000324 IO_OUTP_CTRL2 Same as IO_OUT- P_CTRL1 Table 23: Advanced register: Output control Marlin Technical Manual V.2.7.0...
The Polarity setting refers to the input side of the optical coupler output, Pin- State 0 switches off the output transistor and produces a low level over the resis- tor connected from the output to ground. The following diagram illustrates the dependencies of the various output sig- nals. Marlin Technical Manual V.2.7.0...
Page 56
Delay set by register IntEna_Delay IntEna delayed Frame_Valid (Fval) Busy Figure 25: Output Impulse Diagram Note The signals can be inverted. Caution Firing a new trigger while IntEna is still active can result in missing image. Marlin Technical Manual V.2.7.0...
1394 interface described in IIDC V1.3. The first packet of a frame is identified by the 1 in the sync bit (sy) of the packet header. sync bit 8-15 16-23 24-31 data_length channel tCode header_CRC Video data payload data_CRC Figure 26: Isochronous data block packet format: Source: IIDC V1.3 Marlin Technical Manual V.2.7.0...
Page 58
The digital value 0 is black and 255 or 1023 is white. In 16-bit mode the data output is MSB aligned. The following table provides a description of the video data format for the differ- ent modes. (Source: IIDC V1.3 specification) Figure 27: YUV422 and YUV411 format: Source: IIDC V1.3 Marlin Technical Manual V.2.7.0...
Page 59
Camera interfaces Figure 28: Y8 and Y16 format: Source: IIDC V1.3 Figure 29: Data structure: Source: IIDC V1.3 Marlin Technical Manual V.2.7.0...
Camera Control Horizontal IEEE-1394 Frame- Graphics Horizontal 8/16 8/10 Masking & 10 bit 10 bit Interface Memory Overlay Mirror bit* bit* Binning * Is 10/16 bit when Mono16 mode is active. Figure 30: Block diagram b/w camera Marlin Technical Manual V.2.7.0...
10 Bit 10 Bit 8 Bit Memory Overlay Mirror Masking Bit* 8 Bit Sharpness Multiple Color RAW-Mode IEEE-1394 Operations 8 Bit 8 Bit 1394a 10 Bit Interface (RGB->YUV, Hue, Saturation) Camera Control Figure 31: Block diagram color camera Marlin Technical Manual V.2.7.0...
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).
It is important to notice that pixel signals above the dual slope reset level will be left unaffected (green P1 and green P2). Marlin F-131 with three knee-points The Marlin F-131 offers up to three knee-points when in global shutter mode. This functionality is controlled via the following registers. Register...
Page 64
For further tuning, readjust KNEEPOINT_X but maintain ratio KNEEPOINT_1 > KNEEPOINT_2 > KNEEPOINT_3. The figure below, taken from the sensor's data sheet, illustrates the nonlinear behavior of the photo response curve in dual slope mode. Figure 33: IBIS5A nonlinear photo response curve with two slopes Marlin Technical Manual V.2.7.0...
• auto white balance (AWB): continuously optimizes the color characteris- tics of the image Marlin color cameras have both one-push white balance and auto white bal- ance. White balance is applied so that non-colored image parts are displayed non-col- ored.
Page 66
V/R_Value [20..31] V/R value This field is ignored when writing the value in Auto or OFF mode. If readout capability is not available, read- ing this field has no meaning. Table 28: White balance register Marlin Technical Manual V.2.7.0...
If the image capture is active (e.g. IsoEnable set in register 614h), the frames used by the camera for white balance are also output on the 1394 bus. Any pre- viously active image capture is restarted after the completion of white balance. Marlin Technical Manual V.2.7.0...
• There are no stringent or special requirements on the image content, it requires only the presence of equally weighted RGB pixels in the image. • Auto white balance can be started both during active image capture and when the camera is in idle state. Marlin Technical Manual V.2.7.0...
Page 69
Within this area, the R-G-B component values of the samples are added and used as actual values for the feedback. The following drawing illustrates the AUTOFNC_AOI settings in greater detail. AOI: X-size AF_AREA_POSITION: Left,Top Sampling grid for Auto-Function AF_AREA_SIZE: Width: n x 128 Figure 37: AUTOFNC_AOI positioning Marlin Technical Manual V.2.7.0...
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 71
If readout capability is not available, reading this field has no meaning. Table 29: CSR: Shutter Note Configuration To configure this feature in an advanced register: See Table 114: Advanced register: Auto shutter control on page 213. Marlin Technical Manual V.2.7.0...
Page 72
When both auto shutter and auto gain are enabled, priority is given to increasing shutter when brightness decreases. This is done to achieve the best image qual- ity with lowest noise. For increasing brightness, priority is given to lowering gain first for the same purpose. Marlin Technical Manual V.2.7.0...
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 32: Manual gain range of the various Marlin types...
Page 74
If readout capability is not available read- ing this field has no meaning Table 31: CSR: Auto Exposure Note Configuration To configure this feature in an advanced register: See Table 115: Advanced register: Auto gain control on page 213. Marlin Technical Manual V.2.7.0...
Manual gain Marlin cameras are equipped with a gain setting, allowing the gain to be manu- ally adjusted on the fly by means of a simple command register write. The following ranges can be used when manually setting the gain for the analog...
Page 76
1: AUTO [8..19] Reserved Value [20..31] Read/Write Value; this field is ignored when writing the value in Auto or OFF mode; if readout capability is not avail- able reading this field has no meaning. Table 33: CSR: Brightness Marlin Technical Manual V.2.7.0...
Description of the data path Look-up table (LUT) and gamma function The 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 cam- era's RAM and to apply it on the individual pixels of an image at run-time.
Figure 39: Loading an LUT Note Configuration • To configure this feature in an advanced register: See Table 106: Advanced register: LUT on page 205. • For information on GPDATA_BUFFER: See Chapter GPDATA_BUFFER on page 225. Marlin Technical Manual V.2.7.0...
• The graph on the right clearly shows the brightness level falling off to the right. By defocusing the lens, high-frequency image data are removed from the source image, therefore its not included in the shading image. Marlin Technical Manual V.2.7.0...
How to proceed: Set GrabCount to # of desired frames Set BuildImage Flag to true Poll SHGD_Control Register until Busy and BuildImage Flag are resetted Figure 41: Automatic generation of a shading image Marlin Technical Manual V.2.7.0...
Page 81
The correction sequence controlled via Directcontrol uses the average of 16 frames (10H) to calculate the correction frame. The top picture shows the input image (with lens out of focus). The bottom pic- ture shows the shading corrected output image (unfocused lens). Marlin Technical Manual V.2.7.0...
Page 82
Description of the data path Figure 42: Generation of shading image Marlin Technical Manual V.2.7.0...
Page 83
After the lens has been focused again the image below will be seen, but now with a considerably more uniform gradient. This is also made apparent in the graph on the right. Figure 43: Example of shaded image Marlin Technical Manual V.2.7.0...
Figure 44: Uploading shading image to host Note Configuration • To configure this feature in an advanced register: See Table 107: Advanced register: Shading on page 207. • For information on GPDATA_BUFFER: See Chapter GPDATA_BUFFER on page 225. Marlin Technical Manual V.2.7.0...
Figure 45: Loading the shading reference image Note Configuration • To configure this feature in an advanced register: See Table 107: Advanced register: Shading on page 207. • For information on GPDATA_BUFFER: See Chapter GPDATA_BUFFER on page 225. Marlin Technical Manual V.2.7.0...
(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 spe- cial DSNU reduction function, extending the shading correction.
Page 87
Generate the image by closing the lens to elim- inate image information. • The FPN correction in former releases of the Marlin F-131 worked different and is replaced by the DSNU correction. • The use of DSNU correction should be accompanied with shading correction for both low level as well as high level corrected pixels.
Description of the data path Horizontal mirror function All Marlin cameras are equipped with an electronic mirror function, which mir- rors 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.
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: • A reduction in the number of pixels; thus, the amount of data while retain- ing the original image area angle •...
Note If vertical binning is activated the image may appear to be over-exposed and may require correction. Note The image appears vertically compressed in this mode and no longer exhibits a true aspect ratio. Marlin Technical Manual V.2.7.0...
Figure 50: 2 x horizontal binning Note The image appears horizontally compressed in this mode and does no longer show true aspect ratio. If horizontal binning is activated the image may appear to be over-exposed and must eventually be corrected. Marlin Technical Manual V.2.7.0...
6 dB. Resolution is reduced, depending on the model. Resolution Resolution is reduced, depending on the model. Format_7 Mode_3 By default use Format_7 Mode_3 for 2 x full binning. 2 x full binning Figure 51: 2 x full binning Marlin Technical Manual V.2.7.0...
CMOS or CCD chip. Which Marlin models have sub-sampling? • All CMOS equipped Marlin models, both color and b/w have this feature (FW > 2.03). • The CCD models Marlin F-146C and Marlin F-201C are also equipped with this mode, acting as a preview mode.
Page 94
Figure 52: Horizontal sub-sampling 1 out of 2 (b/w) 2 out of 4 Figure 53: 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. Marlin Technical Manual V.2.7.0...
Page 95
Format_7 Mode_2 Only MF-131B: 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 54: Vertical sub-sampling (b/w) Marlin Technical Manual V.2.7.0...
Page 96
Marlin F-131B: 1 out of 2 H+V sub-sampling • only Marlin F-146C/201C): 2 out of 4 H+V sub-sampling 1 out of 2 H+V sub-sampling (only Marlin F-131B) Figure 56: 1 out of 2 H+V sub-sampling (b/w) Marlin Technical Manual V.2.7.0...
Page 97
Description of the data path 2 out of 4 H+V sub-sampling (only Marlin F-146C/201C) Figure 57: 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.
200 Figure 58: Marlin update timing Principally a Marlin camera is not able to recognize how many parameter the user will change. Due to the fact that communication between host and camera is asynchronous, it may happen that one part of parameter changes is done in image n+1 and the other part is done in image n+2.
B) filters placed over the individual pixels in a BAYER mosaic layout. An effec- tive Bayer RGB color interpolation already takes place in all Marlin color ver- sion cameras. Before converting to the YUV format, color correction is done after BAYER demosaicing.
On the color camera, a wrongly colored border of one or two pixel wide forms on the left and right image borders. This is also a consequence of BAYER demosaicing as the image width displayed on the color camera is not scaled down. Marlin Technical Manual V.2.7.0...
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 101.
Hue and saturation Marlin CCD color models are equipped with hue and saturation registers. The hue register at offset 810h allows to change the color of objects without changing the white balance by +/- 40 steps (+/- 10°) from the nominal percep- tion.
189. Serial interface With FW > 2.03, all Marlin cameras are equipped with the SIO (serial input/out- put) feature as described in IIDC V1.31. This means that the Marlin’s serial inter- face which is used for firmware upgrades can further be used as a general RS232 interface.
Page 104
Buffer_Size_Inq [24..31] Buffer Size (RD only) This field indicates the maximum size of receive/transmit data buffer If this value=1, Buffer_Status_Control and SIO_Data_Register Char 1-3 should be ignored. Table 35: Serial input/output control and status register (SIO CSR) Marlin Technical Manual V.2.7.0...
Page 105
0: no error (to clear status) 1: Ignored [14] Receive data parity error Read: current status WR: 0: no error (to clear status) 1: Ignored [15..31] Reserved Table 35: Serial input/output control and status register (SIO CSR) Marlin Technical Manual V.2.7.0...
Page 106
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?). Marlin Technical Manual V.2.7.0...
Page 107
• Contact your local dealer if you require further informa- tion or additional test programs or software. • Allied Vision recommends the use of Hyperterminal™ or other communication programs to test the functionality of this feature. Alternatively use SmartView to try out this feature.
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) specifi- cation. Resolutions smaller than the generic sensor resolution are generated from the center of the sensor and without binning.
1600 x 1200 RGB8 1600 x 1200 Mono8 1280 x 960 Mono16 1600 x 1200 Mono16 Table 42: Video fixed formats Marlin F-145B2 / F-145C2 *: Color camera outputs RAW image, which needs to be converted outside of camera. Marlin Technical Manual V.2.7.0...
Page 113
696 x 520 Mono8 17 fps H+V binning Table 43: Video Format_7 default modes Marlin F-145B / F-145C Owing to color interpolation, the maximum height is 1036 pixels in YUV modes and the first and last pixel columns contain no image information.
1600 x 1200 RGB8 1600 x 1200 Mono8 1280 x 960 Mono16 1600 x 1200 Mono16 Table 44: Video fixed formats Marlin F-146B / F-146C *: Color camera outputs RAW image, which needs to be converted outside of camera. Marlin Technical Manual V.2.7.0...
Page 115
28.57 fps H+V binning Mono16 28.57 fps H+V binning Table 45: Video Format_7 default modes Marlin F-146B / F-146C Owing to color interpolation, the maximum height is 1038 pixels in YUV modes and the first and last one or two pixel columns contain incorrect color informa- tion.
1600 x 1200 RGB8 1600 x 1200 Mono8 1280 x 960 Mono16 1600 x 1200 Mono16 Table 46: Video fixed formats Marlin F-201B / F-201C *: Color camera outputs RAW image, which needs to be converted outside of camera. Marlin Technical Manual V.2.7.0...
1280 x 960 YUV422 1280 x 960 1280 x 960 Mono8 1600 x 1200 YUV422 1600 x 1200 RGB 1600 x 1200 Mono8 1280 x 960 Mono16 1600 x 1200 Mono16 Table 48: Video fixed formats Marlin F-131B (NIR) Marlin Technical Manual V.2.7.0...
Page 119
640 x 512 Mono8 94 fps* H+V sub-sampling Table 49: Video Format_7 default modes Marlin F-131B (NIR) *: With minimum shutter; increasing shutter will decrease max. frame frequency proportionally due to global shutter principle. **: With shutter 23 ms only ***: With shutter 18ms only.
IMAGE_POSITION and IMAGE_SIZE contain in the respective bits values for the column and line of the upper left corner and values for the width and height. Note For more information see Table 95: Format_7 control and sta- tus register on page 193. Marlin Technical Manual V.2.7.0...
Page 121
• The time for reading the image from the sensor and transporting it into the FRAME_BUFFER • The time for transferring the image over the FireWire™ bus • The length of the exposure time. Marlin Technical Manual V.2.7.0...
2. Uncheck Enable check box (SmartView Ctrl2 tab). Switch off Auto modi (e.g. Shutter and/or Gain) (SmartView Ctrl2 tab). As a reference it uses a grid of at least 300 sample points equally spread over the AOI. Marlin Technical Manual V.2.7.0...
UXGA 1600 x 1200 Table 50: Overview fixed formats They enable you to calculate the required bandwidth and to ascertain the num- ber of cameras that can be operated independently on a bus and in which mode. Marlin Technical Manual V.2.7.0...
Page 124
(120 x 125 μs = 15 ms) to transmit one frame, which arrives every 16.6 ms from the camera. Again no data need to be stored temporarily. Thus around 64 % of the available bandwidth is used. Marlin Technical Manual V.2.7.0...
Page 126
• If the cameras are operated with an external trigger the maximum trigger frequency may not exceed the highest continuous frame rate, so preventing frames from being dropped or corrupted. • IEEE 1394 adapter cards with PCILynx™ chipsets have a limit of 4000 bytes per cycle. Marlin Technical Manual V.2.7.0...
Max. frame rate of CCD (theoretical formula) • Diagram of frame rates as function of AOI by constant width • Table with max. frame rates as function of AOI by constant width Note Different parameters apply for different models. Marlin Technical Manual V.2.7.0...
Format_7, global shutter 1 ms integration time Table 61: Frame rates Marlin F-131 as function of AOI height (full horizontal width) In order to calculate the maximum achievable frame rate (with certain exposure time) the following equation can be used:...
For this reason the Marlin F-131 features a non pipelined global shutter only. A side effect of this type of global shutter is that the integration or shutter time is added to the readout time, thus affecting the frame rates to be achieved.
Page 138
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 70: Trigger_mode_0 and 1 Marlin Technical Manual V.2.7.0...
• Grabbing an unlimited amount of images after one external trigger (sur- veillance) The next image details this mode. External Trigger input, after inverting optocoupler N x image; N: continuous, one_shot, multi_shot Figure 71: Trigger_Mode_15 Marlin Technical Manual V.2.7.0...
Page 140
Set trigger source ID from trigger source ID_Inq. Trigger_Value [11] Trigger input raw signal value read only 0: Low 1: High Trigger_Mode [12..15] Trigger_Mode (Trigger_Mode_0..15) [16..19] Reserved Parameter [20..31] Parameter for trigger function, if required (optional) Table 63: Trigger_Mode_15 (Bulk trigger) Marlin Technical Manual V.2.7.0...
Page 141
To repeat rewrite line three. To repeat rewrite line three. To repeat rewrite line three. Table 64: Description: using Trigger_Mode_15: continuous, one-shot, multi-shot Figure 72: Using Trigger_Mode_15: Continuous, one-shot, multi-shot Note Shutter for the images is controlled by shutter register. Marlin Technical Manual V.2.7.0...
Controlling image capture Trigger delay As already mentioned earlier, since firmware version 2.03, Marlin cameras fea- ture 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.
[11..31] Delay time in μs Table 67: Advanced CSR: trigger delay The advanced register allows to delay the start of the integration by max. 2 μs, which is max. 2.1 s after a trigger edge was detected. Marlin Technical Manual V.2.7.0...
The shutter register value is multiplied by the time base register value (see Table 102: Timebase ID on page 202). The default value here is set to 20 μs. A camera-specific offset is also added to this value. It is different for the camera models: Marlin Technical Manual V.2.7.0...
Register value Timebase Marlin F-033 20 μs Table 70: Register value and Timebase for Marlin F-033 register value x time base + offset = exposure time 100 x 20 μs + 12 μs = 2012 μs exposure time Marlin Technical Manual V.2.7.0...
Controlling image capture The minimum adjustable exposure time set by register is 20 μs. The real min- imum 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...
Controlling image capture One-shot Marlin cameras can record an image by setting the one-shot bit in the 61Ch reg- ister. This bit is automatically cleared after the image is captured. If the camera is placed in Iso_Enable mode (see Chapter...
- e.g. by broadcasting a one-shot. All cameras receive the one_shot command in the same IEEE 1394 bus cycle. This creates uncertainty for all cam- eras in the range of 125 μs. Inter-camera latency is described in Chapter Jitter at start of exposure on page 150. Marlin Technical Manual V.2.7.0...
CMOS This is different to the way the CMOS sensor of the Marlin F-131 works: the image sensitive area is also the storage area, which means that it cannot be used for the integration of the new frame until it has been read out.
Marlin cameras are equipped with 8 MB of RAM. The table below shows how many frames can be stored by each model. The memory operates according to the FIFO (first in, first out) principle.
ImageFIFO are deleted. No images are sent. • The last image in the FIFO will be corrupted, when simul- taneously used as input buffer while being read out. Read out one image less than max. buffer size in this case. Marlin Technical Manual V.2.7.0...
This mode is ideal for applications where a burst of images need to be recorded at the highest sensor speed but the output can be at a lower frame frequency to save bandwidth. Marlin Technical Manual V.2.7.0...
Controlling image capture Sequence mode Generally all 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. An uncertainty of one or two images remains because normally the host does not know (espe- cially with external trigger) when the next image will arrive.
SEQUENCE_PARAM --- [0..4] Reserved ApplyParameters [5] 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 76: Advanced register: Sequence mode Marlin Technical Manual V.2.7.0...
Page 156
Set flag IncImageNo = 1 Start sequence in MultiShot or ISOEnable mode Figure 77: Sequence mode flow diagram During sequencing, the camera obtains the required parameters, image by image, from the corresponding FIFOs (e.g. information for exposure time). Marlin Technical Manual V.2.7.0...
It uses the Firetool program as graphical representation. Please note the changes in the shutter time; that creates descending image brightness, and the change in the image position; which creates a panning effect. Figure 78: Example of sequence mode settings with Firetool Marlin Technical Manual V.2.7.0...
PC (e.g. FirePackage). Caution • Incorrect handling may lead to image corruption or loss of subsequent images. • Please ask for detailed support if you want to use this feature. Marlin Technical Manual V.2.7.0...
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 • Time stamp (1394 bus cycle time at the beginning of integration) •...
Image 1 or another test image. Table 78: Loading test images in different viewers Test images b/w cameras Marlin b/w cameras have two test images that look the same. Both images show a gray bar running diagonally (mirrored at the middle axis). •...
Page 162
How does bandwidth affect the frame rate? Figure 79: Gray bar test image Marlin Technical Manual V.2.7.0...
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 80: Color test image Marlin Technical Manual V.2.7.0...
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 sen- sor. (Mirror must be switched off.) Marlin Technical Manual V.2.7.0...
If a CSR F0F00600h is mentioned below this means in full: Bus_Id, Node_Id, FFFF F0F00600h Writing and reading to and from the register can be done with programs such as FireView or by other programs developed using an API library (e.g. FirePackage). Marlin Technical Manual V.2.7.0...
Table 79: 32-bit register Example This requires, for example, that to enable ISO_Enabled mode (see Chapter ISO_Enable / Free-Run on page 149), (bit 0 in register 614h), the value 80000000 h must be written in the corresponding register. Marlin Technical Manual V.2.7.0...
Table 80: Configuration ROM The entry with key 8D in the root directory (420h in this case) provides the offset for the Node unique ID leaf. To compute the effective start address of the node unique ID leaf: Marlin Technical Manual V.2.7.0...
Page 169
434h Unit directory 438h 43Ch 440h Table 83: Config ROM The entry with key D4 in the unit directory (440h in this case) provides the offset for unit dependent info: 440h + 000001 * 4 = 444h Marlin Technical Manual V.2.7.0...
Page 170
The offset entered in the table always refers to the base address of F0F00000h. 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 Marlin Technical Manual V.2.7.0...
Name Field Description 100h V_FORMAT_INQ Format_0 Up to VGA (non compressed) Format_1 SVGA to XGA Format_2 SXGA to UXGA Format_3 [3..5] Reserved Format_6 Still Image Format Format_7 Partial Image Format [8..31] Reserved Table 86: Format inquiry register Marlin Technical Manual V.2.7.0...
Camera process power ON/ OFF capability [17..18] Reserved One_Shot_Inq [19] One-shot transmission capability Multi_Shot_Inq [20] Multi-shot transmission capability [21..27] Reserved Memory_Channel [28..31] Maximum memory channel number (N) If 0000, no user memory available Table 89: Basic function inquiry register Marlin Technical Manual V.2.7.0...
Optical filter control [4..15] Reserved Capture_Size [16] Capture_Size for Format_6 Capture_Quality [17] Capture_Quality for Format_6 [16..31] Reserved 40Ch OPT_FUNCTION_INQ Reserved Parallel Input/Output control Serial Input/Output control Strobe_out [4..31] Strobe signal output Table 90: Feature presence inquiry register Marlin Technical Manual V.2.7.0...
Page 184
CSR's from the base address of initial register space (Vendor unique) 48Ch Strobe_Output_CSR_Inq Strobe_Output_Quadlet_Offset [0..31] Quadlet offset of the Strobe_Output signal CSR's from the base address of ini- tial register space (Vendor unique) Table 90: Feature presence inquiry register Marlin Technical Manual V.2.7.0...
GAMMA_INQ Same definition as Brightness_inq. 51Ch SHUTTER_INQ Same definition as Brightness_inq. 520h GAIN_INQ Same definition as Brightness_inq. 524h IRIS_INQ always 0 528h FOCUS_INQ always 0 52Ch TEMPERATURE_INQ Same definition as Brightness_inq. Table 91: Feature elements inquiry register Marlin Technical Manual V.2.7.0...
Page 186
Manual_Inq Manual Mode (controlled by user) Min_Value [8..19] Minimum value for this fea- ture Max_Value [20..31] Maximum value for this fea- ture 538 .. 57Ch Reserved for other FEATURE_HI_INQ Table 91: Feature elements inquiry register Marlin Technical Manual V.2.7.0...
Page 187
147 Count Number See Chapter Multi-Shot on page 149 620h Mem_Save_Ch Always 0 Cur_Mem_Ch Always 0 628h Vmode_Error_Status Error in combination of Format/Mode/ISO Speed: Bit(0): No error; Bit(0)=1: error Table 91: Feature elements inquiry register Marlin Technical Manual V.2.7.0...
Read: read a current mode 0: Manual 1: Auto [8-19] Reserved Value [20-31] Value. Write the value in Auto mode, this field is ignored. If ReadOut capability is not available, read value has no meaning. Table 93: Feature control register Marlin Technical Manual V.2.7.0...
Page 190
Configuration of the camera Offset Name Field Description 804h AUTO-EXPOSURE See above Note: Target grey level parameter in SmartView corresponds to Auto_ex- posure register 0xF0F00804 (IIDC). 808h SHARPNESS See above Table 93: Feature control register Marlin Technical Manual V.2.7.0...
Page 191
V_Value / [20-31] V value / R value R_Value Write the value in AUTO mode, this field is ignored. If ReadOut capability is not available, read value has no meaning. Table 93: Feature control register Marlin Technical Manual V.2.7.0...
Page 192
888h TILT Always 0 88Ch OPTICAL_FILTER Always 0 Reserved for other Always 0 FEATURE_LO 8BCh 8C0h CAPTURE-SIZE Always 0 8C4h CAPTURE-QUALITY Always 0 8C8h .. Reserved for other Always 0 8FCh FEATURE_LO Table 93: Feature control register Marlin Technical Manual V.2.7.0...
According to IIDC V1.3 010h COLOR_CODING_ID See note 014h COLOR_CODING_INQ According to IIDC V1.3 034h PIXEL_NUMER_INQ According to IIDC V1.3 038h TOTAL_BYTES_HI_INQ According to IIDC V1.3 03Ch TOTAL_BYTES_LO_INQ According to IIDC V1.3 Table 95: Format_7 control and status register Marlin Technical Manual V.2.7.0...
• Contrary to IIDC V1.3, the UnitBytePerPacket field is already filled in with a fixed value in the PACK- ET_PARA_INQ register. Advanced features (Allied Vision-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.
Page 195
Table 110: High dynamic range configuration register on page 209 0xF1000288 KNEEPOINT_2 0xF100028C KNEEPOINT_3 0xF1000290 DSNU_CONTROL Marlin F-131B only; Firmware 2.02 Table 111: Advanced register: DSNU on page 0xF1000294 BLEMISH_CONTROL Marlin F-131B only; Firmware 2.02 Table 112: Advanced register: Blemish on page 0xF1000300...
Page 196
AUTOFNC_AOI Marlin/Oscar series only Table 116: Advanced register: Autofunction AOI on page 214 0xF10003A0 COLOR_CORR Marlin/Oscar CCD type color cameras only Table 118: Advanced register: Color correction on page 215 0xF1000400 TRIGGER_DELAY Table 119: Advanced register: Trigger Delay page 215...
This makes it easier to operate the camera using Directcontrol. • Allied Vision reserves the right to require activation in future versions of the software. Version information inquiry The presence of each of the following features can be queried by the 0 bit of the corresponding register.
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. Marlin Technical Manual V.2.7.0...
Page 200
TimeBase ExtdShutter TestImage FrameInfo Sequences VersionInfo Reserved Look-up tables Shading DeferredTrans [10] HDR mode [11] Marlin F-131B only DSNU [12] Marlin F-131B only Blemish correction [13] Marlin F-131B only TriggerDelay [14] Misc. features [15] Soft Reset [16] High SNR [17]...
This is the value given in the specifications tables under Picture size (max.) in Chapter Specifications on page 22. Register Name Field Description 0xF1000200 MAX_RESOLUTION MaxHeight [0..15] Sensor height (read only) MaxWidth [16..31] Sensor width (read only) Table 100: Advanced register: Maximum resolution inquiry Marlin Technical Manual V.2.7.0...
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. This multiplier is configured as the time base via the TIMEBASE register.
• Extended shutter setting will thus be overwritten by the normal timebase/shutter setting after Stop/Start of Fire- View or FireDemo. Test images Bits 8-14 indicate which test images are saved. Setting bits 28-31 activates or deactivates existing test images. • auto gain Marlin Technical Manual V.2.7.0...
[28..31] 0: No test image active 1: Image 1 active 2: Image 2 active … Table 104: Advanced register: Test image Sequence control It is possible to make certain settings for a sequence of images beforehand by using this register. Marlin Technical Manual V.2.7.0...
NumOfLuts of the LUT_INFO register. Register Name Field Description 0xF1000240 LUT_CTRL Presence_Inq Indicates presence of this fea- ture (read only) [1..5] Reserved ON_OFF Enable/Disable this feature [7..25] Reserved LutNo [26..31] Use look-up table with LutNo number Table 106: Advanced register: LUT Marlin Technical Manual V.2.7.0...
Always make sure that the shading image is saved at the high- est resolution of the camera. If a lower resolution is chosen and ShowImage is set to true, the image will not be displayed cor- rectly. Marlin Technical Manual V.2.7.0...
Setting HoldImg prevents transfer of the image. The images are stored in ImageFIFO. The images indicated by NumOfImages are sent by setting the SendImage bit. When FastCapture is set (in Format_7 only), images are recorded at the highest possible frame rate. Marlin Technical Manual V.2.7.0...
Table 109: Frame information register The FrameCounter is incremented when an image is read out of the sensor. The FrameCounter does not indicate whether an image was sent over the IEEE 1394 bus or not. Marlin Technical Manual V.2.7.0...
Page 209
High dynamic range mode (Marlin F-131B only) The CMOS sensor of the Marlin F-131 offers a special mode by which various non- linearity 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.
Default: OFF Busy Computation in progress SaveData Save DSNU correction data to flash LoadData Load DSNU correction data from flash ZeroData [10] Zero DSNU correction data [11..23] Reserved GrabCount [24..31] Number of images Table 111: Advanced register: DSNU Marlin Technical Manual V.2.7.0...
Input/output pin control Note • See Chapter Input/output pin control on page 50 • See Chapter IO_INP_CTRL 1-2 on page 50 • See Chapter IO_OUTP_CTRL 1-2 on page 54 • See Chapter Output modes on page 55 Marlin Technical Manual V.2.7.0...
Due to the fact that the active image size might not be dividable by 128 without a remainder, the auto function AOI work-area size might be greater. This allows for the positioning of the work-area to be at the bottom of the active image. Marlin Technical Manual V.2.7.0...
Page 215
Delay time in μs Table 119: Advanced register: Trigger Delay The advanced register allows start of the integration to be delayed via DelayTime by max. 2 μs, which is max. 2.1 s after a trigger edge was detected. Marlin Technical Manual V.2.7.0...
1 or more bus resets will occur • the FPGA will be rebooted The reset can be delayed by setting the Delay to a value unequal to 0 - the delay is defined in 10 ms steps. Marlin Technical Manual V.2.7.0...
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 • Time stamp (1394 bus cycle time at the beginning of integration) •...
Note The 4 bytes of the frame counter value will be inserted as the 5th to 8th byte of a line. Additionally there is a register for direct read out of the frame counter value. Marlin Technical Manual V.2.7.0...
Note The 4 bytes of the trigger counter value will be inserted as the 9th to 12th byte of a line. Additionally there is a register for direct read out of the trigger counter value. Marlin Technical Manual V.2.7.0...
In fact these are different expressions for the follow- ing: storing camera settings into a non-volatile memory inside the camera. With firmware 3.03 (Marlin CCD) and firmware 3.45 (Marlin CMOS) cameras, can store up to three user profiles (plus the factory default) nonvolatile in the cam- era.
Profile data corrupted 0x02 Camera not idle during restore operation 0x03 Feature not available (feature not present) 0x04 Profile doesn’t exist 0x05 ProfileID out of range 0x06 Restoring the default profile failed Table 128: User profile: Error codes Marlin Technical Manual V.2.7.0...
• If a restore operation fails or the specified profile does not exist, all registers will be overwritten with the hard- coded factory defaults (profile #0). • Data written to this register is not reflected in the stan- dard memory channel registers. Marlin Technical Manual V.2.7.0...
This can be especially helpful if third party soft- ware is used which may not give easy access to certain advanced features or may not provide efficient commands for quick writing of data blocks into the camera. Marlin Technical Manual V.2.7.0...
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. This means Marlins with serial numbers xx/yy-6zzzzzzz need different firmware than Marlins with other serial numbers.
+0/-50 μm (optical back focal length) α +/-0.5° (center rotation as the deviation from the parallel to the camera bottom) Table 132: Criteria of Allied Vision sensor position accuracy Note x/y tolerances between C-Mount hole and pixel area may be higher.
Page 228
Analog Devices ........65 Abs_Control (Field)....66 AOI..........83 Abs_Control_Inq (Field) ......51 correction data........83 Access_Control_Register......184 Area of Interest (AOI).......214 accuracy area of interest (AOI) ......83 sensor position........227 Asynchronous broadcast ......149 ActivVision Tools ........79 auto exposure Marlin Technical Manual V.2.7.0...
Page 229
........45 binning Camera lenses.......... 43 full........... 92 cameras horizontal ......... 91 block diagram ........60 vertical ..........90 Marlin..........20 black level ..........75 Camera_Status_Register ......165 black value......... 75 CDS............66 blemish correction CE ............21 Marlin Technical Manual V.2.7.0...
Need help?
Do you have a question about the MARLIN and is the answer not in the manual?
Questions and answers