Interleaved Line-scan Acquisition Channel Setup
LxxxxRG_IA CAM File Template
;*********************************************************************************************
; Camera Manufacturer: Templates
; Camera Model: MyCameraLink
; Camera Configuration: Interleaved Line-Scan Acquisition, Grabber-Controlled Rate and Exposure
; Board: Grablink
;*********************************************************************************************
; This CAM file template is suitable for the following camera configuration:
; - Line-scan camera
; - Grabber-controlled rate
; - Pulse-Width grabber-controlled exposure
; This CAM file template is suitable for the following system configuration:
; - WEB, PAGE, or LONGPAGE Acquisition Modes
; - Take all lines
; - 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 = LxxxxRG;
Imaging = LINE;
Spectrum = BW; <== BW COLOR ...
;
; -Camera Features category-
TapConfiguration = BASE_1T8; <== BASE_1T8 BASE_1T10 BASE_1T24 ...
TapGeometry = 1X; <== 1X 1X2 2X ...
; Expose is WIDTH;
; Readout is INTCTL;
ColorMethod = NONE; <== NONE PRISM TRILINEAR RGB
;
; --Downstream signals--
FvalMode = FN;
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 = 4096; <==
HSyncAft_Tk = 0; <==
LineRate_Hz = 5000; <== Max. line rate (= reciprocal of readout duration)
ExposeMin_us = 1; <== Min. exposure time (= RESET signal pulse width)
ExposeMax_us = 10000; <== Max. exposure time (= RESET signal pulse width)
ResetDur = 3000; <== Min. time interval, in ns, between consecutive RESET pulses
;
; ==End of "Camera properties Section"==
;*********************************************************************************************
; ==Begin of "System properties Section"==
;
; -Acquisition Control category-
AcquisitionMode = WEB; <== WEB PAGE LONGPAGE
TrigMode = IMMEDIATE; <== IMMEDIATE HARD SOFT COMBINED
NextTrigMode = REPEAT; <== REPEAT (when AcquisitionMode = WEB or LONGPAGE)
; <== SAME REPEAT HARD SOFT COMBINED (when AcquisitionMode = PAGE)
EndTrigMode = AUTO; <== AUTO HARD (when AcquisitionMode = LONGPAGE)
; <== AUTO (when AcquisitionMode = WEB or PAGE)
BreakEffect = FINISH; <== FINISH ABORT
SeqLength_Pg = -1; <== -1 1 .. 65534 (when AcquisitionMode = PAGE)
SeqLength_Ln = -1; <== -1 1 .. 65534 (when AcquisitionMode = WEB or LONGPAGE)
PageLength_Ln = 500; <== 1 .. 65535
;
; -Trigger Control category-
TrigCtl = ISO; <== ISO DIFF
TrigEdge = GOHIGH; <== GOHIGH GOLOW
TrigFilter = MEDIUM; <== OFF ON MEDIUM STRONG
TrigLine = NOM; <== NOM ...
;
; The following 4 parameters are relevant only when EndTrigMode = HARD!
EndTrigCtl = ISO; <== ISO DIFF
EndTrigEdge = GOLOW; <== GOHIGH GOLOW
EndTrigFilter = MEDIUM; <== OFF ON MEDIUM STRONG
EndTrigLine = NOM; <== NOM ...
;
; -Interleaved Acquisition category-
InterleavedAcquisition = ON; <== Enable interleaved acquisition
; Define the exposure time for P1 and P2 (= RESET signal pulse width)
ExposureTime_P1_us = 64.0; <== Float (0.16 up to 5000000)
ExposureTime_P2_us = 64.0; <== Float (0.16 up to 5000000)
; Define the strobe duration for P1 and P2 (= STROBE1 and STROBE2 signals pulse width)
StrobeDuration_P1_us = 32.0; <== Float (0.16 up to 5000000)
StrobeDuration_P2_us = 32.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 = 16.0; <== Float (-10000 up to 5000000)
StrobeDelay_P2_us = 16.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
;
; -Encoder Control category-
LineCaptureMode = ALL;
LineRateMode = PERIOD; <== PERIOD PULSE CONVERT
; The following 2 parameters are relevant only when LineRateMode = PERIOD:
Period_us = 1000; <==
PeriodTrim = 0; <==
; The following 5 parameters are relevant only when LineRateMode = CONVERT:
LinePitch = 100; <==
EncoderPitch = 100; <==
ConverterTrim = 0; <==
OnMinSpeed = IDLING; <== IDLING MUTING
; The following 4 parameters are relevant only when LineRateMode = PULSE or CONVERT:
; LineTrigCtl = DIFF_PAIRED; <== ISO DIFF ISO_PAIRED DIFF_PAIRED
; 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
; LineTrigEdge = GOHIGH; <== GOHIGH GOLOW RISING_A FALLING_A ALL_A (when LineTrigCtl = ISO or DIFF)
; <== ALL_A_B (when LineTrigCtl = ISO_PAIRED or DIFF_PAIRED)
; <== GOHIGH GOLOW (when LineTrigCtl = TTL ITTL I12V or LVDS)
LineTrigFilter = MEDIUM; <== OFF ON MEDIUM STRONG
LineTrigLine = NOM; <== NOM ...
; The following parameter controls the Rate divider circuit that is available
; exclusively when LineRateMode = PULSE.
; Remove the leading semi-column if the function is required!
; RateDivisionFactor = 1; <== 1..512
; The following 2 parameters are controlling the Backward Motion Cancellation circuit that is available
; exclusively when LineTrigCtl = ISO_PAIRED or DIFF_PAIRED.
; Remove the leading semi-column on both parameters if the function is required!
; ForwardDirection = A_LEADS_B; <== A_LEADS_B B_LEADS_A
; BackwardMotionCancellationMode = OFF; <== OFF FILTERED COMPENSATE
;
; ==End of "System properties Section"==
;*********************************************************************************************
; ==Begin of "Grabber properties Section"==
;
; -Grabber Configuration, Timing & Conditioning categories-
GrabWindow = NOBLACK; <== NOBLACK MAN ...
; The following 2 parameters are relevant only when GrabWindow = MAN:
WindowX_Px = 2048; <==
OffsetX_Px = 0; <==
;
; -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
;
; End of "Grabber properties Section"
;*********************************************************************************************
; End of File
;=============
Customizing Camera Parameters
As for any line-scan camera, 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
and, HSyncAft_Tk
.
For correct operation of the camera trigger overrun protection mechanism it is essential to carefully set the following parameters:
LineRate_Hz
, ExposeMin_us
, ExposeMax_us
and, ResetDur
.
Customizing Acquisition Control Parameters
As for any line-scan application, the following acquisition control parameters must be set according to the application needs:
AcquisitionMode
, TrigMode
, NextTrigMode
, EndTrigMode
,
BreakEffect
, SeqLength_Pg
, SeqLength_Ln
and, PageLength_Ln
.
Customizing Trigger Control Parameters
As for any line-scan application, the following trigger and end trigger control parameters must be set according to the application needs:
TrigCtl
, TrigEdge
, TrigFilter
, TrigLine
, EndTrigCtl
,
EndTrigEdge
, EndTrigFilter
and, EndTrigLine
.
Customizing Interleaved Acquisition parameters
Enable Interleaved Line-scan Acquisition by assigning the value ON
to InterleavedAcquisition
.
Customizing Interleaved Acquisition – Exposure and Strobe Timing Parameters
When Interleaved Line-scan 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.
- Assigning the longest exposure time to P2
- Inserting an exposure delay prior to the lowest one
Customizing Encoder Control Parameters
As for any line-scan application, the following encoder control parameters must be set according to the application needs:
LineCaptureMode
, LineRateMode
, Period_us
, PeriodTrim
,
LinePitch
, EncoderPitch
, ConverterTrim
, OnMinSpeed
,
LineTrigCtl
, LineTrigEdge
, LineTrigFilter
, LineTrigLine
,
RateDivisionFactor
, ForwardDirection
and, BackwardMotionCancellationMode
.
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 NONE
disconnects the IOUT2 output from the P2 Strobe and makes it available for
another usage (Software controlled I/O).
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 line-scan application, the following grabber configuration, timing and conditioning parameters must be set according to the
application needs: GrabWindow
, WindowX_Px
and, OffsetX_Px
.
Customizing Cluster Parameters
As for any line-scan application, the following cluster parameters must be set according to the application needs:
ColorFormat
and, ImageFlipX
.