Interleaved Area-scan Acquisition Channel Setup

PxxRG_IA CAM File Template

;*********************************************************************************************
; Camera Manufacturer: Templates
; Camera Model: MyCameraLink
; Camera Configuration: Interleaved Area-Scan Acquisition, Asynchronous Reset, Grabber-Controlled Exposure
; Board: Grablink
;*********************************************************************************************
; This CAM file template is suitable for the following camera configuration:
;   - Progressive area-scan camera
;   - Asynchronous Reset
;   - Pulse-Width grabber-controlled exposure
; This CAM file template is suitable for the following system configuration:
;   - SNAPSHOT and HFR Acquisition Modes
;   - Interleaved Acquisition
;
; ********************************************************************************
; ** CAUTION:                                                                   **
; ** This file is a template, it can be further customized!                     **
; ** The lines that can be edited are marked with an arrow followed by the most **
; ** popular alternate values for that parameter.                               **
; ** For a complete list of possible values; refer to MultiCam Studio and/or to **
; ** the MultiCam Reference documentation.                                      **
; ********************************************************************************
;
;*********************************************************************************************
; ==Begin of "Camera properties Section"==
;
; -Camera Specification category-
    Camera =            MyCameraLink;
    CamConfig =         PxxRG;
    Imaging =           AREA;
    Spectrum =          BW;                 <== BW COLOR ...
;
; -Camera Features category-
    TapConfiguration =  BASE_1T8;           <== BASE_1T8 BASE_1T10 BASE_1T24 ...
    TapGeometry =       1X_1Y;              <== 1X_1Y 1X2_1Y 2X_1Y ...
    Expose =            WIDTH;
    Readout =           INTCTL;
    ColorMethod =       NONE;               <== NONE PRISM BAYER RGB
    ColorRegistration = BG;                 <== GB BG RG GR (when ColorMethod=BAYER)
    ExposeOverlap =     FORBID;             <== FORBID ALLOW
;
; --Downstream signals--
    FvalMode =          FA;
    LvalMode =          LA;
    DvalMode =          DN;                 <== DN DG
;
; --Upstream signals--
    ResetCtl =          DIFF;
    ResetEdge =         GOHIGH;             <== GOHIGH GOLOW
    CC1Usage =          RESET;              <== LOW HIGH RESET SOFT
    CC2Usage =          LOW;                <== LOW HIGH RESET SOFT
    CC3Usage =          LOW;                <== LOW HIGH RESET SOFT
    CC4Usage =          LOW;                <== LOW HIGH RESET SOFT
;
; -Camera Timing category-
    Hactive_Px =        640;                <==
    Vactive_Ln =        480;                <==
    HSyncAft_Tk =       0;                  <==
    VSyncAft_Ln =       0;                  <==
    FrameRate_mHz =     30000;              <==
    ExposeRecovery_us = 10;                 <==
    ReadoutRecovery_us = 10;                <==
    ExposeMin_us =      10;                 <==
    ExposeMax_us =      1000000;            <==
;
; ==End of "Camera properties Section"==
;*********************************************************************************************
; ==Begin of "System properties Section"==
;
; -Acquisition Control category-
    AcquisitionMode =   SNAPSHOT;           <== SNAPSHOT HFR
    TrigMode =          IMMEDIATE;          <== IMMEDIATE HARD SOFT COMBINED
    NextTrigMode =      SAME;               <== SAME HARD SOFT COMBINED REPEAT
    ActivityLength =    1;                  <== 1
    SeqLength_Fr =      2;                  <== -1 1..65534
    PhaseLength_Fr =    1;                  <== 1 (when AcquisitionMode = SNAPSHOT)
;                                           <== 1..255 (when AcquisitionMode = HFR)
;
; -Trigger Control category-
;       The following 5 parameters are relevant only when EndTrigMode = HARD:
    TrigCtl =           ISO;                <== ISO DIFF
    TrigEdge =          GOHIGH;             <== GOHIGH GOLOW
    TrigFilter =        MEDIUM;             <== OFF ON MEDIUM STRONG
    TrigDelay_us =      0;                  <==
    TrigLine =          NOM;                <== NOM ...
;       The following 2 parameters are controlling the Trigger Decimation circuit.
;       Remove the leading semi-column on both parameters if the function is required!
;   TrigDelay_Pls =     0;                  <== 0..65536
;   NextTrigDelay_Pls = 0;                  <== 0..65536
;
; -Interleaved Acquisition category-
    InterleavedAcquisition =    ON;         <== Enable interleaved acquisition
;       Define the exposure time for P1 and P2 (= RESET signal pulse width)
    ExposureTime_P1_us =        7000.0;     <== Float (0.16 up to 5000000)
    ExposureTime_P2_us =        35000.0;    <== Float (0.16 up to 5000000)
;       Define the strobe duration for P1 and P2 (= STROBE1 and STROBE2 signals pulse width)
    StrobeDuration_P1_us =      7000.0;     <== Float (0.16 up to 5000000)
    StrobeDuration_P2_us =      10000.0;    <== Float (0.16 up to 5000000)
;       Define the strobe delay for P1 and P2 (relative time offset from RESET going ON to STROBEx going ON) 
;       The time offset can be positive, null or negative 
    StrobeDelay_P1_us =         0.0;        <== Float (-10000 up to 5000000)
    StrobeDelay_P2_us =         0.0;        <== Float (-10000 up to 5000000)
;       Select the Exposure delay control method
    ExposureDelayControl =      MANUAL;     <== MANUAL SAME_END_EXPOSURE SAME_START_EXPOSURE
;       When ExposureDelayControl is MANUAL, select the minimum delay from the trigger
;       to the start of exposure (RESET signal going on)
    ExposureDelay_MAN_P1_us =   0;          <== Float (0 up to 5000000)
    ExposureDelay_MAN_P2_us =   0;          <== Float (0 up to 5000000)
    StrobeLine_P1 =             IOUT1;      <== IOUT1 IOUT2 NONE
    StrobeLine_P2 =             IOUT2;      <== IOUT1 IOUT2 NONE
    StrobeOutput_P1 =           ENABLE;     <== ENABLE DISABLE
    StrobeOutput_P2 =           ENABLE;     <== ENABLE DISABLE
;
; ==End of "System properties Section"==
;*********************************************************************************************
; ==Begin of "Grabber properties Section"==
;
; -Grabber Configuration, Timing & Conditioning categories-
    GrabWindow =        NOBLACK;            <== NOBLACK MAN ...
;       The following 4 parameters are relevant only when GrabWindow = MAN:
    WindowX_Px =        640;                <==
    WindowY_Ln =        480;                <==
    OffsetX_Px =        0;                  <==
    OffsetY_Ln =        0;                  <==
;       The following parameter configures the Bayer CFA Decoder.
;       If the default value is not adequate for your application, it is then necessary
;       to edit the value and to remove the leading semi-column of the following line:
;   CFD_Mode =          ADVANCED;           <== ADVANCED, LEGACY
;
; -Look-Up Tables category-
;   LUT configuration parameters can be inserted here if required by the application
;
; -Cluster category-
    ColorFormat =       Y8;                 <== Y8 Y10 RGB24 RGB24PL ...
    ImageFlipX =        OFF;                <== OFF ON
    ImageFlipY =        OFF;                <== OFF ON
;
; End of "Grabber properties Section"
;*********************************************************************************************
; End of File
;=============

Customizing Camera Parameters

The following camera parameters must be set according to the selected camera model:

Spectrum, TapConfiguration, TapGeometry, ColorMethod, DvalMode, ResetEdge, CC1Usage, CC2Usage, CC3Usage, CC4Usage, Hactive_Px, Vactive_Ln , HSyncAft_Tk and, VSyncAft_Ln.

For correct operation of the camera trigger overrun protection mechanism it is mandatory to carefully set the following parameters: FrameRate_mHz, ExposeMin_us, ExposeMax_us and, ExposeRecovery_us.

Customizing Acquisition Control Parameters

AcquisitionMode can optionally be set to HFR.

In that case PhaseLength_Fr can be set to any value in 1 … 255 range.

The other parameters are not customizable.

Customizing Trigger Control Parameters

The following trigger parameters must be set according to the application needs: TrigCtl, TrigEdge, TrigFilter, TrigLine.

The trigger decimation circuit can optionnally be activated using TrigDelay_Pls and NextTrigDelay_Pls.

Customizing Interleaved Acquisition parameters

Enable Interleaved Acquisition by assigning the value ON to InterleavedAcquisition.

Customizing Interleaved Acquisition – Exposure and Strobe Timing Parameters

When Interleaved Acquisition is enabled, the following exposure and strobe parameters are irrelevant:

Expose_us, ExposeTrim, StrobeMode, StrobeDur and, PreStrobe_us.

Instead, the exposure and strobe timings must be defined for P1 and P2 using the following parameter set:

ExposureTime_P1_us, ExposureTime_P2_us, StrobeDuration_P1_us, StrobeDuration_P2_us, StrobeDelay_P1_us and, StrobeDelay_P2_us.

Customizing Interleaved Acquisition – Exposure Delay Parameters

By default, MultiCam configures P1 and P2 with the smallest possible Exposure Delay value. This setting is satisfactory for the use cases where the exposure time is shorter than the readout time.

Optionally, keeping ExposureDelayControl set to MANUAL, you may manually change the minimum exposure delay value of P1 and/or P2 using the ExposureDelay_MAN_P1_us and ExposureDelay_MAN_P2_us parameters.

Alternatively, you may also change ExposureDelayControl to one of the automatic control methods: SAME_START_EXPOSURE or SAME_END_EXPOSURE.

With SAME_START_EXPOSURE, the start of exposure is delayed by the same amount of time for both programs: both exposure delay values are equal.

With SAME_END_EXPOSURE the end of exposure is delayed by the same amount of time for both programs.

Note: In case of asymmetric exposure times, when at least one exposure time is greater than the readout time, the minimal line trigger period can be achieved when:
  • Assigning the longest exposure time to P2
  • Inserting an exposure delay prior to the lowest one

Customizing Interleaved Acquisition – Strobe Control Parameters

The StrobeLine_P1 and StrobeLine_P2 parameters designate the I/O lines used as strobe outputs for P1 and P2 respectively. The default values are IOUT1 for P1 and IOUT2 for P2.

Setting StrobeLine_P2 to IOUT1 or NONE disconnects the IOUT2 output from the P2 Strobe and makes it available for another usage (Software controlled I/O).

Setting StrobeLine_P1 and StrobeLine_P2to the same output IOUT1 merges the two strobe pulses .

The StrobeOutput_P1 and StrobeOutput_P2 parameters control the delivery of the strobe pulse for P1 and P2 respectively. The delivery is enabled by default. Assigning the DISABLE value, inhibits the delivery of the strobe pulse.

Customizing Grabber Timing Parameters

As for any are-scan application, the following grabber configuration, timing and conditioning parameters must be set according to the application needs: GrabWindow, WindowX_Px, WindowY_Ln, OffsetX_Px and OffsetY_Ln.

Customizing Cluster Parameters

As for any area-scan application, the following cluster parameters must be set according to the application needs: ColorFormat, ImageFlipX and, ImageFlipY.