Before operation We place the highest demands for quality on our cameras. This technical manual is the guide to the installation and setting up of the camera for operation. This version 1.3 of the technical manual applies to Marlins, having serial numbers starting with 6 after the –...
It is not permitted to copy or modify them for trade use or transfer, nor may they be used on web sites. Trademarks Unless stated otherwise, all trademarks appearing in this document of Allied Vision Technologies are brands protected by law. Warranty The information supplied by Allied Vision Technologies is supplied without any guarantees or warranty whatsoever, be it specific or implicit.
Page 5
Safety instructions Auto gain ......................62 Setting the brightness (black level or offset) .............65 Auto shutter ......................65 Lookup table (LUT) and Gamma function..............67 8.8.1 Loading a LUT into the camera ..............68 Shading correction....................70 8.9.1 Automatic generation of correction data ............70 8.9.2 Loading a shading image into the camera ............75 8.9.3 Loading a shading image out of the camera ...........76...
Page 6
Safety instructions 10.7 Frame rates ......................116 10.7.1 MF-033 ....................120 10.7.2 MF-046 ....................121 10.7.3 MF-080 ....................122 10.7.4 MF-080-30 fps..................123 10.7.5 MF-145 ....................124 10.7.6 MF-131 ....................125 How does bandwidth affect the frame rate? ..........126 11.1 Test images......................127 Configuration of the camera..............129 12.1 Camera_Status_Register ..................129 12.2...
Safety instructions Conventions used in this manual To give this manual an easily understood layout and to emphasize important information, the following typographical styles and symbols are used: Styles Style Function Example Courier Programs, inputs, “Input” etc. upper case Register REGISTER Mode italics...
Safety instructions Safety instructions There are no switches or parts inside the camera that require adjustment. The guarantee becomes void upon opening the camera casing. If the product is disassembled, reworked or repaired by other than a recommended service person, AVT or its suppliers will take no responsibility for the subsequent performance or quality of the camera.
Safety instructions Environmental conditions Ambient temperature: when camera in use: + 5° C ... + 45° C when being stored : - 10° C ... + 60° C Relative humidity: 20 % … 80 % no condensed water Protection: IP 30 MARLIN Technical Manual Page 10...
With Marlin cameras, entry into the world of digital image processing is simpler and more cost- effective than ever before. With the new MARLIN, Allied Vision Technologies presents a whole series of attractive digital camera entry-level models of the FireWire ™type.
System components System components The following system components are included with each camera:: AVT Marlin 4.5m 1394 standard cable Jenofilt 217 IR cut filter (built in) ptional: Tripod Adapter 4.5m latching cable Driver and documentation e following illustration shows the spectral sensitivity of the IR cut filter Figure 1: Spectral sensitivity of Jenofilt 217 MARLIN Technical Manual Page 12...
Page 13
To demonstrate the properties of the camera, all examples in this manual are based on the “FirePackage” OHCI API software and the “SmartView” application. These utilities can be obtained from Allied Vision Technologies. A free version of “SmartView” is available for download at www.alliedvisiontec.com.
Specifications Specifications MF-033B Specification Image device 1/2 " (diag. 8 mm) type progressive scan SONY IT CCD Effective Picture Elements 656 (H) x 494 (V) C-mount: 17.526 mm (in air); ∅ 25.4 mm (32 T.P.I.) Lens Mount Mechanical Flange Back to filter distance: 8.2 mm Picture Sizes 640 x 480 pixels (Format_0) 656 x 494 pixels (Format_7 Mode_0)
Specifications MF-033C Specification Image device 1/2 " (diag. 8 mm) type progressive scan SONY IT CCD Effective Picture Elements 656 (H) x 494 (V)@Raw8 (492 @YUV) C-mount: 17.526 mm (in air); ∅ 25.4 mm (32 T.P.I.) Lens Mount Mechanical Flange Back to filter distance: 8.2 mm Picture Sizes 640 x 480 pixels (Format_0) 656 x 492 pixels (Format_7 Mode_0)
Specifications MF-046B Specification Image device 1/2 " (diag. 8 mm) type progressive scan SONY IT CCD Effective Picture Elements 780 (H) x 582 (V) C-mount: 17.526 mm (in air); ∅ 25.4 mm (32 T.P.I.) Lens Mount Mechanical Flange Back to filter distance: 8.2 mm Picture Sizes 640 x 480 pixels (Format_0);...
Specifications MF-046C Specification Image device 1/2 " (diag. 8 mm) Type progressive scan SONY IT CCD Effective Picture 780 (H) x 582 (V)@Raw8; 780 (H) x 580 (V)@YUV Elements C-mount: 17.526 mm (in air); ∅ 25.4 mm (32 T.P.I.) Lens Mount Mechanical Flange Back to filter distance: 8.2 mm Picture Sizes 640 x 480 pixels (Format_0);...
Specifications MF-080B (-30 fps*) Specification Image device 1/3 " (diag. 6 mm) type progressive scan SONY IT CCD Effective Picture Elements 1032 (H) x 778 (V) C-mount: 17.526 mm (in air); ∅ 25.4 mm (32 T.P.I.) Lens Mount Mechanical Flange Back to filter distance: 8.2 mm, CS-mount on demand Picture Sizes 1024 x 768 pixels (Format_1) supporting all smaller fixed formats;...
Specifications 4.6 MF-080C (-30 fps*) Specification Image device 1/3 " (diag. 6 mm) type progressive scan SONY IT CCD Effective Picture Elements 1032 (H) x 778 (V)@Raw8; 1032 (H) x 776 (V)@YUV C-mount: 17.526 mm (in air); ∅ 25.4 mm (32 T.P.I.) Lens Mount Mechanical Flange Back to filter distance: 8.2 mm, CS-mount on demand...
Specifications MF-145B2 Specification Image device 1/2 " (diag. 8 mm) type progressive scan SONY IT CCD Effective Picture Elements 1392 (H) x 1040 (V) C-mount: 17.526 mm (in air); ∅ 25.4 mm (32 T.P.I.) Lens Mount Mechanical Flange Back to filter distance: 8.2 mm Picture Sizes Up to 1280 x 960 pixels (Format_2), supporting all smaller fixed formats;...
Specifications MF-145C2 Specification Image device 1/2 " (diag. 8 mm) Type progressive scan SONY IT CCD Effective Picture Elements 1392 (H) x 1040 (V)@Raw8; 1392 (H) x 1036 (V)@YUV C-mount: 17.526 mm (in air); ∅ 25.4 mm (32 T.P.I.) Lens Mount Mechanical Flange Back to filter distance: 8.2 mm Picture Sizes Up to 1280 x 960 pixels (Format_2 ) supporting all smaller fixed...
Specifications F-131B Specification Image device 2/3 " (diag. 11 mm) Type global shutter CMOS sensor Effective Picture Elements 1280 (H) x 1024 (V) C-mount: 17.526 mm (in air); ∅ 25.4 mm (32 T.P.I.) Lens Mount Mechanical Flange Back to filter distance: 8.2 mm Picture Sizes Up to 1280 x 960 pixels (Format_2), supporting all smaller fixed formats;...
Specifications 4.10 F-131C Specification Image device 2/3 " (diag. 11 mm) Type global shutter CMOS sensor Effective Picture 1280 (H) x 1024 (V) Elements C-mount: 17.526 mm (in air); ∅ 25.4 mm (32 T.P.I.) Lens Mount Mechanical Flange Back to filter distance: 8.2 mm...
Specifications 4.11 Spectral sensitivity Figure 2: Spectral sensitivity of MF-033B without cut filter and optics. Figure 3: Spectral sensitivity of MF-033C without cut filter and optics MARLIN Technical Manual Page 24...
Page 25
Specifications Figure 4: Spectral sensitivity of MF-046B without cut filter and optics. Figure 5: Spectral sensitivity of MF-046C without cut filter and optics. MARLIN Technical Manual Page 25...
Page 26
Specifications Figure 6: Spectral sensitivity of MF-080B without cut filter and optics Figure 7: Spectral sensitivity of MF-080C without cut filter and optics. MARLIN Technical Manual Page 26...
Page 27
Specifications Figure 8: Spectral sensitivity of MF-145B2 without cut filter and optics Figure 9: Spectral sensitivity of MF-145C2 without cut filter and optics MARLIN Technical Manual Page 27...
Page 28
Specifications Figure 10: Spectral sensitivity of MF-131B without cut filter and optics Figure 11: Spectral sensitivity of MF-131C without cut filter and optics MARLIN Technical Manual Page 28...
Quick start Quick start To attach an IEEE-1394 camera to a PC or laptop, the target machine must be equipped with an EE-1394 port and have the appropriate driver and software installed. This IEEE-1394 port is lready present in many modern PCs and laptops. Should this not be the case, you can upgrade y installing one or more IEEE-1394 ports in the form of a card for the PCI slot, or as a PC card CMCIA) for the PC card slot.
Camera dimensions Camera dimensions Marlin standard housing ☺ Body size: 58 mm x 44 mm x 29 mm (l x w x h) Weight: 120 g (without lens) Figure 13: Camera dimensions MARLIN Technical Manual Page 30...
Camera dimensions Marlin W90 This version has the sensor tilted by 90 degrees clockwise, so that it views upwards. Figure 14: Marlin W90 MARLIN Technical Manual Page 31...
Camera dimensions Marlin W90 S90 This version has the sensor tilted by 90 deg es clockwise, so that it views upwards and additionally rotated by 90 degrees clockwise. Figure 15: Marlin W90 S90 MARLIN Technical Manual Page 32...
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 16: Marlin W270 MARLIN Technical Manual Page 33...
Camera dimensions Marlin W270 S90 is version has the sensor tilted by 270 degrees clockwise, so that it views downwards. Additionally the sensor is tilted by 90 degrees clockwise. ☺ Figure 17: Marlin W270 S90 MARLIN Technical Manual Page 34...
Camera interfaces Camera interfaces In addition to the two status LEDs, there are two jacks located at the rear of the camera. The 12-pin HiRose plug provides different control inputs and output lines. The IEEE-1394 connector with lock mechanism provides access to the IEEE-1394 bus and thus makes it p ossible to control the camera and output frames.
Camera interfaces HiRose jack pin assignment The HiRose plug is also designed for industrial use an d in addition to providing access to the puts and outputs on the camera, it also provides a serial interface for e.g. the firmware update. The fo llowing diagram shows the...
Camera interfaces Status LEDs On LED The green power LED indicates that the camera is being supplied with sufficient voltage and is ready for operation. Status LED (yellow) The following st ates are displayed via the LED: asynchronous and isochronous data transmission active (indicated asynchronously to transmission over the 1394 bus) LED off –...
Camera interfaces Operating the camera: for the camera is supplied either via the FireWire™ bus or the HiRose conector’s pin 2 CCD models only). The input voltage must be within the following range: Vcc min.: +8 V cc max.: +36 V An input voltage of 12 V is recommended to make most efficient use of the camera.
Page 40
Camera interfaces The inputs can be connected directly to +5 V. If a higher voltage is used, an external resistor se @+12 V a 820 Ω and @+24 V a 2.2 kΩ resistor. must be placed in series. U Voltages above +45 V may damage the optical coupler The optical coupler inverts all input signals.
Page 41
Camera interfaces 7.5.1.1 Triggers All inputs configured as triggers are linked by AND. If several inputs are being used as triggers, a high signal must be present on all inputs in order to generate a trigger signal. The polarity for each signal can be set separately via the inverting inputs.
Page 42
Camera interfaces 7.5.1.2 Trigger delay Since firmware version 2.03, the cameras feature various ways to delay image capture based on external trigger. With 1V31 of IIDC spec. there is a standard C SR at Register F 0053 4/834 h to control a del ay up to FFFh * timebase value.
Page 43
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 If this bit= 1 the value in the value field has to be ignored...
Camera interfaces 7.5.2 Outputs The camera has 2 no n-inverting outputs with open emitters. These are shown in the following diagram: Max. emitter current 500 mA Max. collector emitter v oltage 45 V Voltage above +45 V may damage the optical coupler. The output connection is dif ferent to the AVT Dolphin series to achieve higher output swing.
Page 45
Camera interfaces Output Output function polarity IntEna FVal Opto- Busy Output signal coupler Outp state Figure 25: Output block d iagram IO_OUTP_CTRL 1-2 e outputs are controlled via two advanced feature registers. The Polarity flag determines whether the output is active low (0) or active high (1). The output ode can be viewed in the table below.
Page 47
Camera interfaces The following diagram illustrates the dependencies of the various output signals. Figure 26: Output Impulse Diagram Note that the polarity of the signals can be changed. Firing a new trigger while IntEna is still active can result in image corruption due to double exposure occurring.
Camera interfaces 7.6 Pixel data Pixel data are transmitted as isochronous data packets in accordance with the 1394 interface described in IIDC v. 1.3. The first packet of a frame is identified by the “1” in the sync bit (sy) of the packet header.
Page 49
Camera interfaces Table 26: Y8 and Y16 format: Source: IIDC v. 1.3 specification Table 27: Da ta structure: Source: IIDC v. 1.3 spe cification MARLIN Technical Manual Page 49...
Description of the data path Description of the data path lock 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.
Description of the data path Sensor The Marlin family is equipped with various sensor types and resolutions. Both CCD and CMOS types are available in color and monochrome. The following table provides an overview: Model Techn. Manu- Sensor Sensor Microlens Chip Size Pixel Size Eff.
Description of the data path 8.2.1 IBIS5A multiple slope (High Dynamic Range mode) The MF-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).
Page 55
Description of the data path It is important to notice that pixel signals above the dual slope reset level will be left unaffected (green P1 and green P2). The Marlin F131 offers up to three knee-points when in global shutter mode. This functionality is controlled via the following registers.
Page 56
Description of the data path The figure below, taken from the sensor’s data sheet, illustrates the nonlinear behavior of the photo response curve in dual slope mode. Figure 30: IBIS5A nonlinear photo response curve with two slopes MARLIN Technical Manual Page 56...
Description of the data path White balance color cameras have both manual and automatic white balance. White balance is applied so at non-colored image parts are displayed non-colored. White balance does not use the so called PxGA® (P ixel Gain Amplifier) of the analog front (AFE) but a digital representation in the FPGA in order to modify the gain of the two channels with lower output by +9.5dB (in 106 steps) relative to the channel with highest output.
Page 58
Description of the data path Register Name Field Description 0xF0F0080C WHITE_BALANCE 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...
Description of the data path 8.3.1 One Push automatic white balance is activated by setting the “One Push” bit in the WHITE_BALANCE register (see WHITE- BALANCE). The camera automatically generates frames, based on the current settings of all registers (GAIN, OFFSET, SHUTTER, etc.). For white balance, in total six frames are processed and a grid of at least 300 samples is equa read over the work area.
Description of the data path Finally, the calculated correction values can be read from the WHITE_BALA NCE register 80Ch. 8.3.2 Automatic white balance There is also an Auto white balance feature reali , which continu sly optimiz es the color characteristics of the image.
Page 61
Description of the data path If the adjustment fails and the work area siz e and/or posit ion b ecome s invalid this feature ON_OFF automatically switched off – make sure to read back the flag if this feature doesn’t work as expected.
Description of the data path Manual gain As shown in figure 29, all cameras are equipped with a gain setting, allowing the gain to be “m anually” 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 vid eo signal: Type Range...
Page 63
Description of the data path value in the value field has to be ignored [2..4] Reserved One_Push Write: Set Bit h igh to start Read: Status of feature: Bit high: WIP, Bit low: Ready ON_OFF Write ON or OFF t feature, ON=1 Read: Sta tus of the...
Page 64
Description of the data path ON_OFF Write ON or OFF this feature, ON=1 Read: Status of the feature; OFF=0 A_M_MODE Set bit high for Auto feature Read for Mode; 0= MANUAL; 1= AUTO [8..19] reserved Value [20..31] Read/Write Value; this field is ignored when writing the value in Aut o or OFF...
Description of the data path Setting the brightness (black level or offset) It is ossible to set the black level in the camera within the following ranges: odels: 0...+16 gray value s (@ 8 bit). Increments are in 1/16 LSB (@ 8 bit). MOS-model: 0 …...
Page 66
Description of the data path Read: Status of the feature: Bit high: WIP, Bit low: Ready ON_OFF Write ON or OFF this feature, ON=1 Read: Status of th featur e; OFF=0 A_M_MODE Set bit high for Auto feature Read fo r Mode;...
Description of the data path Lookup table (LUT) and Gamma function The AVT Marlin camera provides one user-defined lookup table (LUT). The use of this LUT allows any function (in the form Output = F(Input)T to be stored in the camera’s RAM and to apply it on e individual pixels of an image at run-time.
Description of the data path With all CCD models, the user LUT will be overridden when Gamma is enabled. CMOS models have the gamma function built in the sensor, so that it wont be overridden. LUT content is volatile. 8.8.1 Loading a LUT into the camera ading the LUT is carried out through the data exchange buffer called GPDATA_BUFFER.
Page 69
Description of the data path The table below describes the registers required. Register Name Field Description 0xF1000240 UT_CTRL Pres ence_Inq Indicates presence of this f eature (read only) [1..5] ON_OFF Enable/Disable this feature. [7..2 LutNo [26..31] Use Lookup table with number LutNo.
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 each pixel in 1/256 steps – this allows for shading to be compensated by up to 50 %. Besides generating shading data off-line and dow nloading it to the camera, the camera allows correction data to be generated au...
Page 71
Description of the data path After this, a search is made for the brightest pixel in the mean value frame. A factor is then calculated for each pixel to be multiplied by, giving it the gray va lue of the brightest pixel. ll of these multipliers are saved in a “shading reference image“.
Page 72
Description of the data path The table below describes the registers required. Register Name Field Description 0xF1000250 SHDG_CTRL Presence_Inq Indicates presence of this feature (read only). BuildError [2..3] ShowImage Show shading data as image. BuildImage Build a new ShadingImage. ON_OFF Shading On/Off.
Page 73
Description of the data path The following pictures illustrate the sequence of commands for generating the shading image. 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 picture shows the ading corrected output image (unfocused lens).
Page 74
Description of the data path Shading correction can be combined with the Image mirror, binning and gamma functionality (CCD m odels on ly). Us ing shading corre ction i n combination with the gamma feature on the CMOS mo dels m ay lead to improper resu lts.
Description of the data path 8.9.2 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: Figure 41: Loading the shading reference image MARLIN Technical Manual Page 75...
Description of the data path 8.9.3 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: Figure 42: Uploding shading image to host MARLIN Technical Manual Page 76...
Description of the data path 8.10 DSNU & blemish correction (MF-131B only) In order to further reduce the dark signal non uniformity (DSNU) of the CMOS sensor to level similar to CCD sensors, the MARLIN F-131B is equipped with a special DSNU reduction function, xtending the shading correction.
Page 78
Description of the data path progress LoadData load factory DSNU correction data ZeroData [10] zero DSNU correction data [11..23] GrabCount [24..31] Number of images Table 40: Register for controlling DSNU correction Having generated the correction data it is possible to separately control the blemish pixel rrection with the help of the following register: Register Name...
Page 79
Description of the data path The effect of the additional blemish correction can be demonstrated with the next screenshot. ot only is the spread now smaller, there are also no pixels above a considerably lower grey level at. app. 96 in this case). Figure 44: Histogram with blemish correction For maximum efficiency, perform a new DSNU correction every time the shutter, gain or offset settings are changed.
Description of the data path 8.11 Horizontal mirror function All Marlin cameras are equipped with an electronic mirror functio , 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 8.12 Binning (CCD b/w models) Binning is the process of combining neighboring pixels while being read out from the CCD chip. All CCD equipped b/w Marlin models have this feature. Binning is used primarily for 3 reasons: A reduction in the number of pixels and thus the amount of data while retaining the original image area angle, an increase in the frame rate (vertical binning only),...
Description of the data path This reduces vertical resolution, depending on the model. If vertical binning is activated the image may appear to be over-exposed and must be corrected. Use Format_7 Mode _2 to activate vertical binning. The image appears vertically compressed in this mode and does no longer show true aspect ratio.
Description of the data path 8.13 Sub-sampling (CMOS) Sub-sampling is the process of skipping neighboring pixels (with the same color) while being read out from the CMOS chip. All CMOS equipped Marlin models, both color and b/w have this feature (FW > 2.03). Sub-sampling is used primarily for 2 reasons: A reduction in the number of pixels and thus the amount of data while retaining the original image area angle,...
Description of the data path Use Format_7 Mode_3 to activate h+v sub-sampling. The different sub-sampling patterns are shown below. Figure 51: H+V subsampling B/W; right: Color Changing sub-sampling modes involve the generation of new shading reference images due to a change in the image size. 8.14 Sharpness All color models are equipped with a two step shar...
Description of the data path 8.15 Color interpolation and correction The color sensors capture the color information via so called primary color (R-G-B) filters placed over the individual pixels in a ”BAYER mosaic” layout. An effective Bayer -> RGB color interpolation already takes place in all Marlin color version cameras.
Description of the data path 8.15.2 Color correction Color correction is performed on all color CCD models before YUV conversion and mapped via a matrix as follows. ⋅ ⋅ ⋅ green blue ⋅ ⋅ ⋅ green green blue ⋅ ⋅ ⋅...
Description of the data path 8.16 Serial interface With FW > 2.03, all Marlin cameras are equipped with the SIO (serial input/output) feature as described in IIDC 1v31. This means that the Marlin’s serial interface which is used for firmware upgrades can further be used as a general RS232 interface.
Page 88
Description of the data path RD: Get stop bit setting 0: 1; 1: 1.5; 2: 2 [20..23] Reserved Buffer_Size_Inq [24..31] Buffer Size (RD only) This field indicates the maximum size of receive/transmit data buffer If this field is 1, Buffer_Status_Control and SIO_Da ta_Reg.
Page 89
Description of the data path Read: current status 0: no error WR: 0 to clear status (1: Ignored) [15..31] Reserved 008h RECEIVE_BUFFER_STATUS_CONTRL RBUF_ST [0..7] SIO receive buffer status 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...
Page 90
Description of the data path Reading data requires the following series of actions: • Query RDRD f g (buffer ready?) and writ e the number o byte s the host wants to read to RBUF_CNT. • 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 (more data the host want ed to read tha...
Controlling image capture Controlling image capture The cameras support the SHUTTER_MODES specified in IIDC V1.3. For all models 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.
Page 92
Controlling image capture Trigger_Mode_15 is a bulk trigger, combining one external trigger event with continuous or neshot or multishot 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.
Page 93
Controlling image capture Trigger_Polarity If Polarity_Inq = 1: W: 0 for low active input; 1 for high active input If Polarity_Inq = 0: Read only Trigger_Source [8..10] Select trigger source ID from trigger source ID_Inq. Trigger_Value [11] Trigger input raw signal value (read only) Trigger_Mod...
Controlling image capture 9.1.1 Trigger delay As already mentioned earlier, since firmware version 2.03, the ca meras feature various ways to elay image capture based on external trigger. With 1V31 of IIDC spec. there is a standard CSR at Register F0F00534/834h to control a delay up to FFFh * timebase value.
Page 95
Controlling image capture 1: Control with value in the absolute value If this bit= 1 the value in the value field has to be ignored [2..5] Reserved ON_OFF Write ON or OFF this feature, ON=1 Read: Status of the feature; OFF=0 [7..19] Reserved Value...
Controlling image capture Exposure time The exposure (shutter) time for continuous mode and Trigger_Mode_0 is based on the following formula: Shutter register value x timebase + offset The register value is the value set in the corresponding IIDC register (SHUTTER [81Ch]). This number is in the range between 1 and 4095.
Controlling image capture One-Shot The camera can record an image by setting the “OneShot 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 ISO_Enable / Free-Run), this flag is ignored. If OneShot mode is combined with the external trigger, the “OneShot”...
Controlling image capture 9.3.2 End of exposure to first packet on the bus After the exposure, the CCD or CMOS- sensor is read out; some data is written into the FRAME_BUFFER before being transm itted to the bus. The time from the end of exposure to the start of transport on the bus is: 500µs ±...
Controlling image capture Multi-Shot can also be combined with the external trigger in order to grab a certain number of images based on an external trigger. This is especially helpful in combination with the so called Deferred_Mode to limit the amount of grabbed images to the FIFO size. ISO_Enable / Free-Run Setting the MSB (bit 0) in the 614h register (ISO_ENA) puts the camera into ISO_Enable mode or Continuous_Shot.
Controlling image capture Jitter at start of exposure e following chapter discusses the latency time which exists for all CCD-models when either a hardware or software trigger is generated, until the actual image exposure starts. Owing to the well-known fact that an Interline Transfer CCD-sensor has both a light sensitive area and a separate storage area, it is common to interleave image exposure of a new frame and output that of the previous one.
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. As all Marlin cameras are equipped with built in image memory, this order of events can be aused or delayed by using the deferred image transport feature.
Controlling image capture 9.8.1 HoldImg mode By setting the HoldImg flag, transport of the image over the 1394 bus is stopped completely. All ptured images are stored in the internal ImageFiFo. The camera reports the maximum possible number of images in the FiFoSize variable. Pay attention to the maximum number of images that can be stored in FiFo.
Controlling image capture The following screenshot displays the sequence of commands n eeded to work with deferred mode. ……………………….Stop continuous mode of camera ……………………. Check pres. of deferred mode and Fi Fo size (Dh= 13 fr.) ……………………. Switch deferred mode on …………………….
Controlling image capture Sequence mode Gen ally 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 regist er even while the camera is running.
Page 105
Controlling image capture How is sequence mode implemented? There is a FIFO (first in first out) memory for each of the IIDC v. 1.3 registers listed above. The depth of each FIFO is fixed to 32(dez) complete sets. Functionality is controlled by th e following advanced registers.
Page 106
Controlling image capture The following flow diagram shows how to set up a sequence. Figure 61: 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 Page 106...
Controlling image capture Points to pay attention to when working with a sequence: If more images are recorded than defined in SeqLen h ,the ttings r the st image ain in ect. If sequence m ode is cancelled, the camera can use the FIFO for other tasks. For this reason, ence m ust be loaded back in to the amer after sequence mode has been cancelled.
Page 108
Controlling image capture P oints to pay attention to when changing the parameters: If the Apply Parameters flag is used n se ng the arameters, all not-configured values t to d efault values. As chan ging seq ence normally affects only the value of a specific register, and all other registers should not be changed, the Apply ameter s flag...
Video formats, modes and bandwidth 10 Video formats, modes and bandwidth The different Marlin models support different video mats, odes an frame tes. These formats and modes are standardized in the IIDC (formerly DCAM) specification. Resolutions smalle r than the generic se nsor esolution are generated from the center of the nsor an ithou...
Video formats, modes and bandwidth 10.2 MF-046B/ MF-046C For- Mode Resolution 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 780 x 580 MONO8 @53 fps...
Video formats, modes and bandwidth 10.3 MF-080B/ MF-080C (-30 fps) For- Mode Resolution 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 YUV422...
Video formats, modes and bandwidth 10.4 MF-145B/ MF-145C For- Mode Resolution 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 MONO 8 640 x 480 MONO 16 800 x 600 YUV422...
Video formats, modes and bandwidth 10.5 MF-131B/ MF-131C For- Mode Resolution 3.75 1.875 160 x 120 YUV444 320 x 240 YUV422 640 x 480 YUV411 640 x 480 YUV422 64 0 x 480 640 x 480 MONO 8 640 x 480 MONO 16 800 x 600 YUV422...
Video formats, modes and bandwidth 10.6 Area of interest (AOI) The image se nsor on the camera h as a define d reso tion. T his indica tes th maxim m numb er 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.
Page 115
Video formats, modes and bandwidth 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. In addition to the Area of Interest, some other parameters have an effect on the maximum frame rate: the time for reading the image from the sensor and transporting it into the FRAME_BUFFER...
Video formats, modes and bandwidth 10.7 Frame rates An IEEE-1394 camera requires bandwidth to transport images. e IEEE-1394a bus has very large bandwidth of at least 32 MB/s for transferring (isochronously) image data. Per cycle up to 4096 bytes (or around 1000 quadlets = 4 bytes) can thus be transmitted.
Page 118
Video formats, modes and bandwidth For- Mode Resolution 3.75 1.875 1/2H 1/4H 1280 x 960 YUV 1280p 640p 320p (4:2:2) 640q 320q 160q 16 bit/pixel 1/2H 1/4H 1280 x 960 RGB 1280p 640p 320p 24 bit/pixel 960q 480q 240q 1/2H 1/4H 1280 x 960 Y (MONO8) 2560p...
Page 119
Video formats, modes and bandwidth In video Format_7 frame rates are no longer fixed but can be varied dynamically by the parameters described below. The following formula is used to calculate for the CCD models the highest frame rate in Format_7: Ch arg eTrans Dump...
Page 120
Video formats, modes and bandwidth 10.7.1 MF-033 Different parameters apply for the different models. eTrans Dummy Dump Scan − ⋅ ⋅ µs µs HEIGHT µ HEIGHT µs Formula 2: Frame rate calculation MF-033 600,00 AOI_ HEIGHT Tf/ms 74,15 13,49 500,00 76,02 13,15 400,00...
Page 125
Video formats, modes and bandwidth 10.7.6 MF-131 This model uses a CMOS sensor with global shutter. As mentioned earlier for the 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? 11 How does bandwidth affect the frame rate? In some modes the IEEE-1394a bus limits the attainable frame rate. According to the 1394a specification on isochronous transfer, the largest data payload size of 4096 bytes per 125 µs cycle is possible with bandwidth of 400 Mb/s.
How does bandwidth affect the frame rate? 11.1 Test images The b/w cameras have two test images that look the same. Both images show a gray bar running iagonally. One test image is static, the other moves upwards by 1 pixel/frame. Figure 64: Gray bar test image Formula for calculating the gray value: Gray value = (x+y) MOD256 (8-bit mode)
Page 128
How does bandwidth affect the frame rate? Mono8 (raw data): Figure 66: Bayer-coded test image e color camera outputs Bayer-coded raw data in Mono8 instead of – as described in IIDC v. 1.3 – a real Y signal. The first pixel of the image is always the red pixel from the sensor. MARLIN Technical Manual Page 128...
Configuration of the camera 12 Configuration of the camera All camera settings are made by writing specific values into the corresponding registers. This applies to both values for general operating states such as video formats and modes, exposure times, etc. and to all extended features of the camera that are turned on and off and controlled via corresponding registers.
Page 130
Configuration of the camera Figure 68: Configuration of the camera Sample p rogram: he fol lowing sample code in C shows how the regis ter is for fra me 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 12.2 Configuration ROM information in the Configuration ROM is neede d to iden tify th e node, its capabilit ies and which drivers are required. The bas e address f or the “configu ration ROM ” for all regis ters i s FFFF...
Page 132
Configuration of the camera The entry with key 8D in the root directory (420h in this case) provides the offset for the unique leaf node as follows: 420h + 000002 * 4 = 428h Offset 0-7 8-15 16-23 24-31 428h Node unique ID 42Ch leaf...
Page 133
Configuration of the camera 448h Unit dependent info 44Ch 450h Table 69: ConfigRom cont. And fin ally, the en try with key 4 0 (448h in this case) vide s the offset for the camera control register: FF F0000000h + 3C0000h * 4 = FFFF F0 F00000h The base address of the camera control register is thus FFFF F0F00000h.
Configuration of the camera 12.3 Implemented registers he follo g tables show how stan dard registers from IIDC v. 1.3 are implemented in the amera . Base ress is F0F00 h. D ifferences and explanation s can be f ound in the third column.
Page 135
Configuration of the camera Mode _5 1024 x 768 M ONO8 Mode _6 800 x 6 00 MONO16 Mode _7 1024 x 768 MONO16 [8..3 Reserve d (zero) 188h V_MOD _INQ Mode_0 1280 x 960 YUV 4 :2:2 (Format_2) Mode _1 1280 x 960 RGB Mode _2 1280 x 960 MONO8...
Configuration of the camera 12.3.4 Inquiry register for video fr e rate and ba e address Offset Name Field Description 200h V_RATE_INQ FrameRate_0 Reserved (Format_0, Mode_0) FrameRate _1 Reserved FrameRate _2 7.5 fps FrameRate _3 15 fps FrameRate _4 30 fps FrameRate _5 60 fps FrameRate _6...
Page 137
Configuration of the camera Offset Name Field Description 210h V_RATE_INQ FrameRate_0 1.875 fp (Format_0, Mode_4) FrameRate _1 3.75 fps FrameRate _2 7.5 fps FrameRate _3 15 fps FrameRate _4 30 fps Fram eRate _5 60 fps FrameRate _6 120 fps (v1.31) FrameRate _7 240 fps (v1.31) [8..31]...
Page 138
Configuration of the camera Offset Name Field Description 224h V_RA TE_INQ FrameRate_0 Reserved (Format_1, Mode_1) FrameRate _1 Reserved FrameRate _2 7.5 fps FrameRate _3 15 fps FrameRate _4 30 fps FrameRate _5 60 fps FrameRate _6 120 fps (v1.31) FrameRate _7 240 fps (v1.31) [8..31] Reserved (z...
Page 139
Configuration of the camera Offset Name Field Description FrameRate _3 FrameRate _4 30 fps FrameRate _5 60 fps FrameRate _6 120 fps (v1.31) FrameRate _7 240 fps (v1.31) [8..31 Reserved (zero) 238h V_RATE_INQ Frame te_0 1.875 fps (Format_1, Mode_6) FrameRate _1 3.75 fps FrameRate _2 FrameRate _3...
Page 140
Configuration of the camera FrameRate _7 Reserved [8..31 Reserv d (zero) Offset Name Field Description 248h V_RATE_INQ FrameRate_0 1.875 fps (Format_2, Mode_2) FrameRate _1 3.75 fps FrameRate _2 7.5 fps FrameRate _3 15 fps FrameRate _4 30 fps FrameRate _5 60 fps FrameRate _6 120 fps (v1.31)
Page 141
Configuration of the camera FrameRate _2 7.5 fps FrameRate _3 15 fps FrameRate _4 30 fps FrameRate _5 60 fps FrameRate _6 Reserved FrameRate _7 Reserved [8..3 Reserved (zero) Offset Name Field Description 25Ch _RATE_INQ FrameRate_ 1.875 (Format_2, Mode_7) FrameRate _1 3.75 fps FrameRate _2 7.5 fps...
Configuration of the camera 12.3.5 Inquiry register for basic function Offset Name Field Description Inquiry for advanced features 400h BASIC_FUNC_INQ Advanced_Feature_Inq (Vendor unique Features) Inquiry for exis tence of Vmode_Error_Status_Inq mode _Error_S tatus register Inquiry for exis tence of Feature_Control_Error_Status_Inq [2] Feature_Control_Error_Status Opt_Func_CSR_Inq Inquiry for Opt_Func_CSR...
Page 143
Configuration of the camera White_Shading [14] White_Shading Control Frame_Rate [15] Frame_Rate Control 31] Reserved 408h FEATURE_LO_INQ Zoom Zoom Control Pan Control Tilt Tilt Control Optical_Filter Optical_Filter Control [4..15] Reserved Capture_Size [16] Capture_Size for Format_6 Capture_Quality [17] Capture_Quality Format_6 [16..31] Reserved 40Ch OPT_FUNCTION_INQ Reserved...
Page 144
Configuration of the camera 484h PIO_C ontrol_CSR_Inq PIO_C ontrol_Q uadlet_Offset [0..31] Quadle t offset of e PIO_Control CSR’s from the base address of initial gister space (Vendor unique) 488h SIO_C ontrol_CSR_Inq SIO_Control_Q uadlet_Offset [0..31] Quadlet offset the SIO_Con trol CSR’s from the base address of initial register space (Vend...
Configuration of the camera 12.3.7 Inquiry register for feature elements Register Name Field Description 0xF0F00500 BRIGHTNESS_INQUIRY Presence_Inq Indicates presence of this feature (read only) Abs_Control_Inq [1] Capability of control with absolute value served One_Push_Inq e Push auto mode (Controlle automatically by the camera on Readout_Inq pability of reading...
Page 146
Configuration of the camera Offset 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...
Page 147
Configuration of the camera value Reserved One_Push_Inq One Push auto mode Controlled automatically by the camera once) Readout_Inq Capability of reading out the value of this feature ON_OFF Capability of switching this feature ON and OFF Auto_Inq Auto Mode (Controlled automatically by the camera)
Configuration of the camera 610h era_Power always 0 614h ISO_EN/Continuous_Shot Bit 0: 1 for Cont. Shot; 0 for stop 618h Memory_Save always 0 61Ch One_Shot, Multi_Shot, Count See text mber 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;...
Configuration of the camera 12.3.9 Status and control register for feature The OnePush feature, WHITE_BALANCE, is curre ntly implemented. If this flag is set, the feature becomes immediately active, even if no images are being input (see One Push automatic white balance).
Configuration of the camera 12.3.10 Feature control error statu s register Offset Name Notes 640h Feat ure_Control_ Erro r_Status_HI always 644h Feature_Control_Error_Status_LO always 0 Table 79: Feature control error register 12.3.11 Video mode control and status registers for Format_7 The offset to the base address is in V-C SR_INQ_7_x.
Configuration of the camera 12.4 Advanced featu The camera has a variety of extended features goi ng beyond the possibilities described in IIDC v. 3. The following chapter ummarizes all ava ilable advan ced fe atures in ascending register order. e following table gives an overview of all available registers: Register Register name...
Page 152
Configuration of the camera 0XF1000400 TRIGGER_DELAY 0XF1000410 MIRROR_IMAGE Marlin/Oscar series only 0XF1000414 0XF1000510 SOFT_RESET 0XF1000FFC GPDATA_INFO 0XF1001000 PDATA_B UFFER Table 81: Advanced Registers Summary Advanced features should always be activated before accessing them. Currently all registers can be written without being activ ated.
Configuration of the camera 12.4.1 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..3 Bcd-coded ve rs.#...
Configuration of the camera Register Name Field Description 0xF10002 0 MAX_RESOLU TION MaxHeight [0..15] Sensor height only) MaxWidth [16..31] Sensor width (rd only) Table 85: M ax. resolut ion inquiry registe Timebase Corresponding to IIDC, exposure time is set via a 12-bit value in the corresponding register (SHUTTER_INQ [51Ch] and SHUTTER [81Ch]).
Configuration of the camera 12.4.5 Extended shutter The exposure time for long-term integration of up to 67 sec can be entered with µs- precision via e EXTENDED_SHUTTER register. Register Name Field Description 0xF100020C EXTD_SHUTTER Presence_Inq Indicates presence of this feature (read only) [1..
Configuration of the camera 12.4.6 Test images Bits 8-14 ind icate which test images are saved. Setting bits “ 28-3 1” activa tes or dea ctivates existing test images. Register Name Field Description 0xF1000210 TEST_IMAGE Presence _Inq dicates p resen ce of this featu re (re...
Configuration of the camera 12.4.7 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] AutoRewind ON_OFF Enable/Disable this feature...
Configuration of the camera 12.4.8 Lookup tables (LUT) The LUT_CTRL register activates this feature and enables certain LUTs. The LUT_INFO register indicates how many LUTs the camera can store and the maximum size of the individual LUTs. Register Name Field Description 0xF1000240 LUT_C...
Configuration of the camera 12.4.9 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.
Page 161
Configuration of the camera Register Name Field Description 0xF1000250 SHDG_CTRL Presence_Inq Indicates presence of this feature (r only) BuildError [2..3] ShowImage Show shading data as image BuildImage ld a new ShadingImage ON_OFF ding On/Off Busy Build in progress [8..23] GrabCount [24..31] Number of images 0xF1000254...
Configuration of the camera 12.4.10 Deferred image transport Using the register, the sequence of recording and the transfer of the images can be paused. Setting “HoldImg” prevents transfer of the image. The images are stored in ImageFIFO. e images indicated by NumOfImages are sent by setting the “SendImage” bit. When “FastCapture”...
Configuration of the camera 12.4.12 High dynamic range mode (MF-131B/C only) The CMOS sensor of the MF-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.
Page 164
Configuration of the camera LoadData load factory DSNU correction data ZeroDa [10] zero D correction data [11..23] abCount [24 .31 Number of images Table 96: R egister fo r controlling DS NU correction aving generated the correction data it is possible to separately control the blemish pixel correction with the help of the following register: Register Name...
Configuration of the camera 12.4.14 Input/output pin control All input and output signals running over the HiRose plug are controlled by this register. Register Name Field Description 0xF1000300 IO_INP_CTRL1 Pres ence_Inq dicates presence of this feature (read only) [1..6] Polarity 0: low active, 1: high active [8..10]...
Configuration of the camera IO_OUTP_CTRL 1-2 The Polarity flag determines whether the output is low active (0) or high active (1). The output mode can be seen in the following table. The current status of the outp ut and be queried and set a the PinState flag.
Configuration of the camera Please note that only one edge is delayed. If IntEna_Out is used to control an exposure, it is possible to have a variation in brightness or to precisely time a flash. Figure 69: Delayed integration timing Register Name Field...
Configuration of the camera 12.4.1 Auto gain The table below illustrates the advanced auto gain control register. Register Name Field Description 0xF1000370 AUTOGAIN_CTRL Presence_Inq Indicates presence of this feature (read only) [1..3] MAXVALUE Max Value [4..15] Max value [16..19] - MAXVALUE Min value [20..31] Min value...
Configuration of the camera 12.4.19 Color correction Color correction can also be switched off in YUV mode with the help of the following register. Register Name Field Description Marlin C-type CCD cameras only: Write: 02000000h to switch Color correction OFF Write: 00000000h to switch Color correction ON 0xF10003A0 COLOR_CORR...
Configuration of the camera 12.4.22 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 13 Firmware update Firmware updates are possible without opening the camera. You need: • Programming cable E 1000666 • Software “AVTCamProg” • PC or laptop with serial Interface (RS 232) • Documentation for firmware update 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...
Index 15 Index Advanced Feature Inquiry 153, 154 Advanced features 143, 149, 151 Area of Interest 104, 114, 115 Asynchronous broadcast 99 Bandwidth 109, 116, 118, 126 BAYER demosaicing 85 Binning 81, 82 Black value 62, 65 Brightness 65 Bus_Id 129 Busy Signal 44 Color correction 85, 86 Color information 85...
Need help?
Do you have a question about the F-131C and is the answer not in the manual?
Questions and answers