IAI SW-4000TL-PMCL Installation manual

Thank you for purchasing this product.
Be sure to read this manual before use.
This manual includes important safety precautions and instructions on how
to operate the unit. Be sure to read this manual to ensure proper operation.
The contents of this manual are subject to change without notice for the
purpose of improvement.
© 2018 JAI
Command List
SW-4000TL-PMCL
High Speed CMOS Trilinear Camera
3
3

Communication Protocol for SW-4000TL-PMCL <Rev 0.3>
All configuration of the camera is done via the RS-232C port. The camera can e set up from a PC running terminal
emulator software.
Below is the description of the ASCII ased short command protocol.
１
１１
１.
..
. Model name
SW-4000TL-PMCL High Speed CMOS Trilinear Camera
２
２２
２.
..
. Communication setting
Baud Rate
9600
Data Length
8 it
Start Bit
1 it
Stop Bit
1 it
Parity
Non
Xon/Xoff Control
Non
３
３３
３.
.
.
. Protocol （
（（
（ hort A CII Command ）
））
）
３
３３
３.
..
.１
１１
１.
..
. Transmit the setting command to camera
NN is any kind of the commands.
NN=[Param.]<CR><LF>
e.g.
Send to camera: GA=0 <CR><LF>
Camera response: COMPLETE<CR><LF>
When camera receives the valid command, camera will return 'COMPLETE'.
If camera receives the command, camera will return following:
e.g.
Send to camera: GAX=0 <CR><LF>
Camera response: 01 Unknown Command!!<CR><LF>
e.g.
Send to camera: GA=1000 <CR><LF>
Camera response: 02 Bad Parameters!!<CR><LF>
３
３３
３.
..
.２
２２
２.
..
. Transmit the request command to camera
The status of camera's settings can e queried y transmitting NN?<CR><LF>, where NN is any kind of the
commands.
The camera will return the current setting data.
e.g.
Send to camera: GA? <CR><LF>
Camera response: GA=0<CR><LF>

３
３３
３.
..
.３
３３
３.
..
. witching baud rate between PC and camera
Camera always starts up with 9600 ps. This can e switched to higher aud rates after a communication has een
esta lished. When switching to other aud rate the procedure is as follows.
e.g. Change aud rate to 115200 ps
1. Confirm aud rates camera supported
Send to camera: SBDRT? <CR><LF>
Camera response: SBDRT=31(0x1F)<CR><LF>
2. Request new aud rate
Send to camera: CBDRT=16(0x10) <CR><LF>
Camera response: COMPLETE<CR><LF>
(Change aud rate to 115200 ps)
3. Rewrite new aud rate again with new aud rate (Confirmation command)
Send to camera: CBDRT=16(0x10) <CR><LF>
Camera response: COMPLETE<CR><LF>
In case the camera does not receive the confirming command with new aud rate within 250ms after
sending the acknowledge it falls ack to the original aud rate (9600 ps).

DeviceControl
Name Access Short ASCII Values MIN MAX DEFAULT Description
DeviceVendorName R/O DVN "JAI Corporation" - - -
DVN?<CR><LF>
Display the manufacture name.
DeviceModelName R/O MD "SW-4000TL-PMCL" - - -
MD?<CR><LF>
Display the model name.
DeviceVersion R/O DV Indicate device version
(e.g. “0.1.0.0” ) - - -
DV?<CR><LF>
Display the camera version.
DeviceFirmwareVersion R/O VN "*.*.*.*" - - -
VN?<CR><LF>
Display the version of firmware.
DeviceFpgaVersion R/O FPVN "*.*.*.*" - - -
FPVN?<CR><LF>
Display the version of fpga.
DeviceSerialNumber R/O ID Serial Number - - -
ID?<CR><LF>
Display the device ID.
DeviceUserID R/W UD User can save and load free text.
(64 or less characters)
UD=[Param.]<CR><LF>
UD?<CR><LF>
Set the user ID for the camera
DeviceTempoerature R/O TMP0
TMP0?<CR><LF>
Display the device temperature in degrees Celsius (C).
DeviceReset W/O CSR00 1 - - -
CRS00=1<CR><LF>
Reset the device.
TechnologySpecificBootstrapRegister
Name Access Short ASCII Values MIN MAX DEFAULT Description
SupportedBaudrates R/O SBDRT
Indicate Support/Non-support status for
each baud rate
bit0: 9600bps
bit1: 19200bps
bit2: 38400bps
bit3: 57600bps
bit4: 115200bps
0x01 0xFF 0x1F
SBDRT?<CR><LF>
This camera supports 9600bps, 19200bps, 38400bps,
57600bps, and 115200bps.
CurrentBaudrate R/W CBDRT
READ: Indicate current baud rate
WRITE: Set any bit of baud rate
bit0: 9600bps
bit1: 19200bps
bit2: 38400bps
bit3: 57600bps
bit4: 115200bps
0x01 0x80
1
(9600bps
)
CBDRT=[Param.]<CR><LF>
CBDRT?<CR><LF>
In case of WRITE execution (change baud rate), it needs to
control in the proper sequence between Host and Camera.
(Refer to the section 3.3)
ImageFormatControl
Name Access Short ASCII Values MIN MAX DEFAULT Description
Width R/W WTC Min～(Max - OffsetX) 16 4096 4096
WTC=[Param.]<CR><LF>
WTC?<CR><LF>
Set the image width.
※
BinningHorizontal=1:16~4096, Step:16Pix/Step
BinningHorizontal=2: 8~2048, Step: 8Pix/Step
(The value will be set configuration steps)
OffsetX R/W OFC Min～(Max – Width) 04080 0
OFC=[Param.]<CR><LF>
OFC?<CR><LF>
Set the horizontal offset.
※
BinningHorizontal=1:0~4080, Step:16Pix/Step
BinningHorizontal=2:0~2040, Step: 8Pix/Step
(The value will be set configuration steps)
BinningHorizontal R/W HB 1: Binning Off
2: Binning On 1 2 1
HB=[Param.]<CR><LF>
HB?<CR><LF>
Set the number of pixels in the horizontal direction for
whitch to perform binning.

BinningVertical R/W VB 1: Binning Off
2: Binning On 1 2 1
VB=[Param.]<CR><LF>
VB?<CR><LF>
Set the number of pixels in the vertical direction for which
to perform binning.
PixelFormat R/W BA 0：RGB8
1：RGB10 0 2 0
BA=[Param.]<CR><LF>
BA?<CR><LF>
Set the pixel format.
TestImageSelector R/W TPN
0：Off
1：White
2：Gray Pattern 1 （Ramp)
3：Gray Pattern 2 (Stripe)
4：Color Bar
040
TPN=[Param.]<CR><LF>
TPN?<CR><LF>
Select the test image.
AcquisitionControl
Name Access Short ASCII Values MIN MAX DEFAULT Description
AcquisitionLineRate R/W LR 1516 1515152 1515152
LR=[Param.]<CR><LF>
LR?<CR><LF>
Use this command to set the line rate of the camera by
specifying the line period. The unit value is 1/100 µs.
Example: If you need 65963 Hz = 1516 (15.16 µs line
period).
TriggerMode R/W TM 0： Off
1： On 0 1 0
TM=[Param.]<CR><LF>
TM?<CR><LF>
Display the Trigger mode.
TriggerSource R/W TI
0： Low
1： High
10： PulseGenerator 0
11： PulseGenerator 1
12： PulseGenerator 2
13： PulseGenerator 3
14： UserOutput 0
15： UserOutput 1
16： UserOutput 2
17： UserOutput 3
20： Line4： TTL In1
21： Line5： Opt In1
23： Line7： :CC1
24： Line10： TTL In2
26： NAND0Out
27： NAND1Out
28： Line13： TTL In3
29： EncoderTrigger
029 20
TI=[Param.]<CR><LF>
TI?<CR><LF>
Select the trigger signal source.
TriggerActivation R/W TA
0: RisingEdge
1: FallingEdge
2: LevelHigh
3: LevelLow
0 3 1
TA=[Param.]<CR><LF>
TA?<CR><LF>
Select the polarity of the trigger signal(i.e., location of
signal at which trigger is applied).
ExposureMode R/W TR
0： Off
1： Timed
2： TriggerWidth
0 2 1
TR=[Param.]<CR><LF>
TR?<CR><LF>
Select the exposure mode.
ExposureTime R/W PE 300～1514908[us] 300 1514908 27847
PE=[Param.]<CR><LF>
PE?<CR><LF>
Set the exposure time.
AutoReset R/W ARS 0： Off
1： On 0 1 0
ARS=[Param.]<CR><LF>
ARS?<CR><LF>
Set the AutoReset. (When auto reset mode is enabled,
LVAL, DVAL, and video are not output while the trigger
input is interrupted.
When resuming trigger input, output of LVAL, DVAL, and
video is resumed.)
AcquisitionLineRateMin R/O LRMIN - - -
LRMIN?<CR><LF>
Display the minimum value that can be set to
[AcquisitionLineRate].
ExposureTimeMin R/O PEMIN - - -
PEMIN?<CR><LF>
Display the minimum value that can be set to
[ExposureTime].

ExposureTimeMax R/O PEMAX - - -
PEMAX?<CR><LF>
Display the maximum value that can be set to
[ExposureTime].
AcquisitionLineRateOption R/W LROP 0： mode1
1： mode2 0 1 1
LROP=[Param.]<CR><LF>
LROP?<CR><LF>
Set the [AcquisitionLineRateOption]. If mode2 is selected,
the maximum line rate is limited.
AnalogControl
Name Access Short ASCII Values MIN MAX DEFAULT Description
IndividualGainMode R/W GM 0: Off
1:On 0 1 0
GM=[Param.]<CR><LF>
GM?<CR><LF>
To set Gain individually for RGB, set it to On.
IndividualGainMode = Off
Gain[DigitalAll] R/W GA 100～800 100 800
GA=[Param.]<CR><LF>
GA?<CR><LF>
Set Gain [DigitalAll], when IndividualMode is Off.
Gain[DigitalRed] R/W GAR 40～400 40 400
GAR=[Param.]<CR><LF>
GAR?<CR><LF>
Set Gain [DigitalRed], when IndividualMode is Off.
Gain[DigitalBlue] R/W GAB 40～400 40 400
GAB=[Param.]<CR><LF>
GAB?<CR><LF>
Set Gain [DigitalBlue], when IndividualMode is Off.
IndividualGainMode = Off
Gain[DigitalRed] R/W GAR 100～1600 100 1600 100
GAR=[Param.]<CR><LF>
GAR?<CR><LF>
Set Gain [DigitalRed], when IndividualMode is On.
Gain[DigitalGreen] R/W GAG 100～1600 100 1600 100
GAG=[Param.]<CR><LF>
GAG?<CR><LF>
Set Gain [DigitalGreen], when IndividualMode is On.
Gain[DigitalBlue] R/W GAB 100～1600 100 1600 100
GAB=[Param.]<CR><LF>
GAB?<CR><LF>
Set Gain [DigitalBlue], when IndividualMode is On.
BalanceWhiteAuto R/W AWB
0： Off
2： Once
5： Preset 5000K
6： Preset 6500K
7： Preset 7500K
0 7 0
AWB=[Param.]<CR><LF>
AWB?<CR><LF>
Set BalanceWhiteAuto.
When IndividualGainMode = On is set, only Off can be
selected.
AWBAreaWidth R/W AWBW
Binning Horizontal =1
Min: 16
Max: 4096
Inc: 16
Binning Horizontal =2
Min: 8
Max: 2048
Inc: 8
- - -
AWBW=[Param.]<CR><LF>
AWBW?<CR><LF>
Set the Width of the area to reference the level, when
BalanceWhiteAuto is Once.
AWBAreaOffsetX R/W AWBO
Binning Horizontal =1
Min: 0
Max: 4080
Inc: 16
Binning Horizontal =2
Min: 0
Max: 2040
Inc: 8
- - -
AWBO=[Param.]<CR><LF>
AWBO?<CR><LF>
Set the offset X of the area to reference the level, when
BalanceWhiteAuto is Once.
AWBOnceStatus R/O AWRS
1=Succeeded.
2=Error1 - G image was too bright.
3=Error2 - G image was too dark.
4=Error3 - Timeout-error occurred.
5=IDEL
1 5 -
AWRS?<CR><LF>
Displays the status at the time of execution
(BalanceWhiteAuto=Once).

BlackLevel[DigitalAll] R/W BL -133～255 -133 255 0
BL=[Param.]<CR><LF>
BL?<CR><LF>
Controls the analog black level as an absolute physical
value. This represents a DC offset applied to the video
signal.
BlackLevel[DigitalRed] R/W BLR -64～64 -64 64 0
BLR=[Param.]<CR><LF>
BLR?<CR><LF>
Controls the analog black level as an absolute physical
value. This represents a DC offset applied to the video
signal.
BlackLevel[DigitalBlue] R/W BLB -64～64 -64 64 0
BLB=[Param.]<CR><LF>
BLB?<CR><LF>
Controls the analog black level as an absolute physical
value. This represents a DC offset applied to the video
signal.
Gamma R/W GMA 40～100 45 100 45
GMA=[Param.]<CR><LF>
GMA?<CR><LF>
Controls the gamma correction of pixel intensity. This is
typically used to compensate for non-linearity of
the display system (such as CRT).
LUTMode R/W LUN
0: Off
1: Gamma
2: LUT
0 2 0
LUN=[Param.]<CR><LF>
LUN?<CR><LF>
Select the JAI LUT mode.
LUTControl
Name Access Short ASCII Values MIN MAX DEFAULT Description
LUTIndex[Red] R/W LUTIR 0～256 0256 0
LUTIR=[Param.]<CR><LF>
LUTIR?<CR><LF>
Select Index of LUT
LUTIndex[Green] R/W LUTIG 0～256 0256 0
LUTIG=[Param.]<CR><LF>
LUTIG?<CR><LF>
Select Index of LUT
LUTIndex[Blue] R/W LUTIB 0～256 0256 0
LUTIB=[Param.]<CR><LF>
LUTIB?<CR><LF>
Select Index of LUT
LUTValue[Red] R/W LUTR 0～4095 04095
LUTR=[Param.]<CR><LF>
LUTR?<CR><LF>
Set LUT value
LUTValue[Green] R/W LUTG 0～4095 04095
LUTG=[Param.]<CR><LF>
LUTG?<CR><LF>
Set LUT value
LUTValue[Blue] R/W LUTB 0～4095 04095
LUTG=[Param.]<CR><LF>
LUTG?<CR><LF>
Set LUT value
ColorTransformationControl
Name Access Short ASCII Values MIN MAX DEFAULT Description
ColorTransformationMode R/W CTM
0： RGB
1： XYZ
2： HIS
0 2 0
CTM=[Param.]<CR><LF>
CTM?<CR><LF>
Select output format
ColorTransformationRGBMode R/W CTRM
0： Off
1： sRGB
2： Adobe RGB
3： User Custom
0 3 0
CTRM=[Param.]<CR><LF>
CTRM?<CR><LF>
Select which RGB mode to use, when setting
ColorTransformationMode to RGB

ColorMatrixValue[R-R] R/W CMVRR -20000～20000 -20000 20000 -
CMVRR=[Param.]<CR><LF>
CMVRR?<CR><LF>
ColorTransformationMode = RGB,
ColorTransformationRGBMode=UserCustom
Individual adjust 9 elements of the 3x3 color matrix (R-R).
ColorMatrixValue[R-G] R/W CMVRG -20000～20000 -20000 20000 -
CMVRG=[Param.]<CR><LF>
CMVRG?<CR><LF>
ColorTransformationMode = RGB,
ColorTransformationRGBMode=UserCustom
Individual adjust 9 elements of the 3x3 color matrix (R-G).
ColorMatrixValue[R-B] R/W CMVRB -20000～20000 -20000 20000 -
CMVRB=[Param.]<CR><LF>
CMVRB?<CR><LF>
ColorTransformationMode = RGB,
ColorTransformationRGBMode=UserCustom
Individual adjust 9 elements of the 3x3 color matrix (R-B).
ColorMatrixValue[G-R] R/W CMVGR -20000～20000 -20000 20000 -
CMVGR=[Param.]<CR><LF>
CMVGR?<CR><LF>
ColorTransformationMode = RGB,
ColorTransformationRGBMode=UserCustom
Individual adjust 9 elements of the 3x3 color matrix (G-R).
ColorMatrixValue[G-G] R/W CMVGG -20000～20000 -20000 20000 -
CMVGG=[Param.]<CR><LF>
CMVGG?<CR><LF>
ColorTransformationMode = RGB,
ColorTransformationRGBMode=UserCustom
Individual adjust 9 elements of the 3x3 color matrix (G-G).
ColorMatrixValue[G-B] R/W CMVGB -20000～20000 -20000 20000 -
CMVGB=[Param.]<CR><LF>
CMVGB?<CR><LF>
ColorTransformationMode = RGB,
ColorTransformationRGBMode=UserCustom
Individual adjust 9 elements of the 3x3 color matrix (G-B).
ColorMatrixValue[B-R] R/W CMVBR -20000～20000 -20000 20000 -
CMVBR=[Param.]<CR><LF>
CMVBR?<CR><LF>
ColorTransformationMode = RGB,
ColorTransformationRGBMode=UserCustom
Individual adjust 9 elements of the 3x3 color matrix (B-R).
ColorMatrixValue[B-G] R/W CMVBG -20000～20000 -20000 20000 -
CMVBG=[Param.]<CR><LF>
CMVBG?<CR><LF>
ColorTransformationMode = RGB,
ColorTransformationRGBMode=UserCustom
Individual adjust 9 elements of the 3x3 color matrix (B-G).
ColorMatrixValue[B-B] R/W CMVBB -20000～20000 -20000 20000 -
CMVBB=[Param.]<CR><LF>
CMVBB?<CR><LF>
ColorTransformationMode = RGB,
ColorTransformationRGBMode=UserCustom
Individual adjust 9 elements of the 3x3 color matrix (B-B).
DigitalIOControl
Name Access Short ASCII Values MIN MAX DEFAULT Description
LineInverter[TTLOut1] R/W LI0 False/True 0 1 0
LI0=[Param.]<CR><LF>
LI0?<CR><LF>
Invert the polarity of the signal(TTLOut1).
LineInverter[TTLOut2] R/W LI1 False/True 0 1 0
LI1=[Param.]<CR><LF>
LI1?<CR><LF>
Invert the polarity of the signal(TTLOut2).
LineInverter[TTLOut3] R/W LI2 False/True 0 1 0
LI2=[Param.]<CR><LF>
LI2?<CR><LF>
Invert the polarity of the signal(TTLOut3).

LineInverter[TTLOut4] R/W LI3 False/True 0 1 0
LI3=[Param.]<CR><LF>
LI3?<CR><LF>
Invert the polarity of the signal(TTLOut4).
LineInverter[NANDGate0In1 ] R/W ND0INV1 False/True 0 1 0
ND0INV1=[Param.]<CR><LF>
ND0INV1?<CR><LF>
Invert the polarity of the signal(NANDGate0In1).
LineInverter[NANDGate0In2 ] R/W ND0INV2 False/True 0 1 0
ND0INV2=[Param.]<CR><LF>
ND0INV2?<CR><LF>
Invert the polarity of the signal(NANDGate0In2).
LineInverter[NANDGate1In1] R/W ND1INV1 False/True 0 1 0
ND1INV1=[Param.]<CR><LF>
ND1INV1?<CR><LF>
Invert the polarity of the signal(NANDGate1In1).
LineInverter[NANDGate1In2 ] R/W ND1INV2 False/True 0 1 0
ND1INV2=[Param.]<CR><LF>
ND1INV2?<CR><LF>
Invert the polarity of the signal(NANDGate1In2).
LineSource[TTLOut1] R/W LS0
0: Low
1: High
7: ExposureActive
9: LVAL
10: PulseGenerator0
11: PulseGenerator1
12: PulseGenerator2
13: PulseGenerator3
14: UserOutput0
15: UserOutput1
16: UserOutput2
17: UserOutput3
20: Line4： TTL In1
21: Line5： Opt In1
23: Line7 - CC1
24: Line10： TTL In2
26: NAND0 Out
27: NAND1 Out
28: Line13： TTL In3
29: EncoderTrigger
30: EncoderDirection
030 0
LS0=[Param.]<CR><LF>
LS0?<CR><LF>
Select signal to be passed to the Line selected by Line
Selector
LineSource[TTLOut2] R/W LS1 Same as LI0 030 0
LS1=[Param.]<CR><LF>
LS1?<CR><LF>
Select signal to be passed to the Line selected by Line
Selector
LineSource[TTLOut3] R/W LS2 Same as LI0 030 0
LS2=[Param.]<CR><LF>
LS2?<CR><LF>
Select signal to be passed to the Line selected by Line
Selector
LineSource[TTLOut4] R/W LS3 Same as LI0 030 0
LS3=[Param.]<CR><LF>
LS3?<CR><LF>
Select signal to be passed to the Line selected by Line
Selector
LineSource[NANDGate0In1] R/W ND0IN1 Same as LI0 030 0
ND0IN1=[Param.]<CR><LF>
ND0IN1?<CR><LF>
Select signal to be passed to the Line selected by Line
Selector
LineSource[NANDGate0In2] R/W ND0IN2 Same as LI0 030 0
ND0IN2=[Param.]<CR><LF>
ND0IN2?<CR><LF>
Select signal to be passed to the Line selected by Line
Selector
LineSource[NANDGate1In1] R/W ND1IN1 Same as LI0 030 0
ND1IN1=[Param.]<CR><LF>
ND1IN1?<CR><LF>
Select signal to be passed to the Line selected by Line
Selector

LineSource[NANDGate1In2] R/W ND1IN2 Same as LI0 030 0
ND1IN2=[Param.]<CR><LF>
ND1IN2?<CR><LF>
Select signal to be passed to the Line selected by Line
Selector
OptInFilterSelector R/W OPTFL
0： Off
1： 0.1 us
2: 1 us
3： 5 us
4： 10 us
5： 50 us
6： 100 us
0 6 0
OPTFL=[Param.]<CR><LF>
OPTFL?<CR><LF>
Set the noise elimination level of OptIO input signal of
DigitalIO
UserOutputValue[UserOutput0] R/W USC0 True/False 0 1 0
USC0=[Param.]<CR><LF>
USC0?<CR><LF>
Sets the value of the bit selected by UserOutputSelector.
UserOutputValue[UserOutput1] R/W USC1 True/False 0 1 0
USC1=[Param.]<CR><LF>
USC1?<CR><LF>
Sets the value of the bit selected by UserOutputSelector.
UserOutputValue[UserOutput2] R/W USC2 True/False 0 1 0
USC2=[Param.]<CR><LF>
USC2?<CR><LF>
Sets the value of the bit selected by UserOutputSelector.
UserOutputValue[UserOutput3] R/W USC3 True/False 0 1 0
USC3=[Param.]<CR><LF>
USC3?<CR><LF>
Sets the value of the bit selected by UserOutputSelector.
CounterandTimerControl
Name Access Short ASCII Values MIN MAX DEFAULT Description
CounterEventSource[Counter0] R/W CE0
0：Off ： stop the counter
1：LineTrigger ： count the number of
LineTrigger
0 1 0
CE0=[Param.]<CR><LF>
CE0?<CR><LF>
Select the events that will be the source to increment the
Counter.
CounterEventSource[Counter1] R/W CE1
0：Off ： stop the counter
1：LineStart ： count the number of
LineStart
0 1 0
CE1=[Param.]<CR><LF>
CE1?<CR><LF>
Select the events that will be the source to increment the
Counter.
CounterEventSource[Counter2] R/W CE2
0：Off ： stop the counter
1：ExposureStart ： count the number of
ExposureStart
0 1 0
CE2=[Param.]<CR><LF>
CE2?<CR><LF>
Select the events that will be the source to increment the
Counter.
CounterEventSource[Counter3] R/W CE3
0：Off ： stop the counter
1：LineTransferEnd ： count the number of
LineTransferEnd
0 1 0
CE3=[Param.]<CR><LF>
CE3?<CR><LF>
Select the events that will be the source to increment the
Counter.
CounterReset[Counter0] R/W CR0 - - -
CR0=[Param.]<CR><LF>
CR0?<CR><LF>
Reset counter value.
CounterReset[Counter1] R/W CR1 - - -
CR1=[Param.]<CR><LF>
CR1?<CR><LF>
Reset counter value.
CounterReset[Counter2] R/W CR2 - - -
CR2=[Param.]<CR><LF>
CR2?<CR><LF>
Reset counter value.
CounterReset[Counter3] R/W CR3 - - -
CR3=[Param.]<CR><LF>
CR3?<CR><LF>
Reset counter value.