Toshiba teli BG Series Instruction Manual Download Page 97

Page: 97 / 162

96 / 160

http://www.toshiba-teli.co.jp/en/index.htm

D4259344C

GenICam function API

Control DigitalIOControl using GenICam API.



LineModeAll

LineSelector

LineMode[0]

LineMode[1]

LineMode[2]

LineMode

LineModeAll[31:0]

Line0

Line1

Line2

LineModeAll

XML node

Camera Register

XML Selector

Selects the Input / Output of each Line by ‘LineModeAll’.

Each bit of integer value corresponds to each Line (bit0=Line0(not changeable), bit1=Line1,
bit2=Line2(not changeable)).

bit value

I/O Direction

Input

Output

LineModeAll

Value

bit value

[Line2] [Line1] [Line0]

I/O Direction

[Line2] [Line1] [Line0]

not used

4 (*)

[1] [0] [0]

[out] [in] [in]

not used

[1] [1] [0]

[out] [out] [in]

not used

* initial factory setting

Summary of Contents for BG Series

Page 1: ...2LMCF BG505LMCG BG505LMCF Information contained in this document is subject to change without prior notice Standard name might be trade mark of each company Thank you for purchasing our product Before using this CMOS camera Please read through this instruction manual carefully in order to use this product correctly and safely After reading keep this instruction manual handy so that you can refer t...

Page 2: ...in Assignment 18 Outline Drawing 20 General Specifications 21 I O Specification 24 Timing Specification 29 Typical Spectral Response 32 Operating Ambient Conditions 34 Functions 35 TransportLayerControl 37 DeviceControl 40 ImageFormatControl 41 Scalable 44 Binning 48 Decimation 52 Reverse 56 PixelFormat 59 TestPattern 63 BayerProcessingMode 66 AcquisitionControl 68 ImageBuffer 73 TriggerControl 78...

Page 3: ...toshiba teli co jp en index htm D4259344C LUTControl 130 SequentialShutterControl 133 DPCControl 138 UserSetControl 141 EventControl 146 Chunk 149 Appendix 155 UserSetSave and UserSetQuickSave difference 155 MultiFrame and Bulk function difference 156 Warranty rules 159 Repair 160 ...

Page 4: ...ization or a long period of outpatient treatment of cure 2 Light to moderate injuries refers to injuries burns electric shock etc that do not require hospitalization or long term treatment 3 Property damage refers to cases of extensive damage involving damage to buildings equipment farm animals pet animals and other belongings Explanation of Safety Symbols Safety Signs Description WARNING Indicate...

Page 5: ...ic shock may result For internal repair inspection or cleaning contact your sales representative Never pull apart Do not place anything on the equipment If metallic objects liquid or other foreign matter enters the equipment fire or electric shock may result Avoid Do not install the equipment in an unstable or inclined location or locations subject to vibration or impact Otherwise the equipment ma...

Page 6: ...trouble Avoid When performing connection turn off power When connecting the power cable and the connection cable turn off the equipment power Otherwise fire or electric shock may result Instruction Do not expose its camera head to any intensive light such as direct sunlight Otherwise its inner image pickup device might get damaged Avoid Avoid short circuiting signal output Otherwise a malfunction ...

Page 7: ...ed from responsibility for such damages In the case damage or losses are caused by failure to observe the information contained in the instructions in this instruction manual and specifications In the case damage or losses are caused by use contrary to the instructions in this instruction manual and specifications In the case damage or losses are caused by malfunction or other problems resulting f...

Page 8: ...ications Such designer or personnel shall assure the performance and safety of the equipment or devices This product is not designed or manufactured to be used for control of equipment directly concerned with human life 1 or equipment relating to maintenance of public services functions involving factors of safety 2 Therefore the product shall not be used for such applications 1 Equipment directly...

Page 9: ...h phenomena are not malfunctions Check a combination with the lens Depending on the lens and lighting you use an image is reflected as a ghost in the imaging area However this is not because of a fault of the camera In addition depending on the lens you use the performance of the camera may not be brought out fully due to deterioration in resolution and brightness in the peripheral area aberration...

Page 10: ... be generated on the screen If this occurs move the camera or the cable Handling of the protective cap If the camera is not in use attach the lens cap to the camera to protect the image pickup surface If the equipment is not to be used for a long duration Turn off power to the camera for safety Maintenance Turn off power to the equipment and wipe it with a dry cloth If it becomes severely contamin...

Page 11: ... which could otherwise be caused by inappropriate waste handling of this product For more detailed information about the take back and recycling of this product please contact your supplier where you purchased the product This symbol is applicable for EU member states only This equipment has been tested and found to comply with the limits for a class A digital device pursuant to Part 15 of the FCC...

Page 12: ...e to the characteristics of CMOS image sensors over or under driving of the pixels results in temporary white or black areas as if these are noises appearing on the screen This phenomenon which is not a defect is exacerbated under higher temperatures and long exposure time Image shading The brightness of the upper part of the screen may be different from that of the lower part Note that this is a ...

Page 13: ...不同于质量功能的保证期限 The Mark and Information are applicable for People s Republic of China only 产品中有毒有害物质或元素的名称及含量部件名称有毒有害物质或元素铅 Pb 汞 Hg 镉 Cd 六价铬 Cr VI 多溴联苯 PBB 多溴二苯醚 PBDE 相机本体本表格依据SJ T 11364的规定编制表示该有毒有害物质在该部件所有均质材料中的含量均在电子信息产品中有毒有害物质的限量要求标准规定的限量要求 GB T26572 以下表示该有毒有害物质至少在该部件的某一均质材料中的含量超出电子信息产品中有毒有害物质的限量要求标准规定的限量要求 GB T26572 This information is applicable for People s Republic of China only リサイク...

Page 14: ...etting You can download the SDK for our GigE and USB3 camera products TeliCamSDK from the Service Support section of our website User registration is necessary to use downloading service Please make a user registration or contact your dealer distributor TOSHIBA TELI CORPORATION Top Page http www toshiba teli co jp en index htm Service Support https www toshiba teli co jp cgi ss en service cgi Plea...

Page 15: ...2fps Global shutter As it employs a global electronic shutter similar to a CCD image sensor clear images of even fast moving object are obtainable with less blur Gigabit Ethernet interface Power over Ethernet Video output and camera control are performed via the Gigabit Ethernet standard IEEE802 3ab interface Data transfer is up to 1Gbps Maximum that enables to output uncompressed video data at hi...

Page 16: ... data is combined by vertical and horizontal Decimation mode Camera reads all effective areas at high speed by skipping lines Color processing Color models have built in color processing The white balance function also works in Bayer output Optical Glass Build in dust proof glass Suffix of G attached to the model name indicates built in optical glass model e g BG302LMG IR cut filter Build in IR cu...

Page 17: ...tream and control are transmitted via this cable Please use a LAN cable that supports 1000BASE T Cat 5e or over This product is able to connect a LAN cable that is equipped with screw lock mechanism Please use it as needed Network Interface Card NIC 2 This is the interface card to connect to the camera Usually this card is installed to expansion slot of host equipment such as PC etc Please use 100...

Page 18: ...nfirm the power supply of the camera off when plugging in or pulling out the I O Connector It causes the breakdown If your camera is used in a system where its connectors are subjected to strong repetitive shocks its connectors are possible to break down If you use your camera in such a situation use an LAN cable with a lock screw and secure the camera cable as close as possible to the camera body...

Page 19: ...l Data C Power 6 I O BI_DB VDC Bidirectional Data B Power 7 I O BI_DD VDC Bidirectional Data D Power 8 I O BI_DD VDC Bidirectional Data D Power 2 I O Connector Connector Camera side HR10A 7R 6PB 73 HIROSE ELECTRIC CO LTD or equivalency product Plug Cable side HR10A 7P 6S 73 HIROSE ELECTRIC CO LTD or equivalency product This camera cable is not an accessory of this product Connector view from matin...

Page 20: ...Rights Reserved http www toshiba teli co jp en index htm D4259344C Notes on Power Supply This camera has two ways of power supply Supply from LAN cable PoE Supply from camera cable DC 12V 10 If both of PoE and DC 12V are connected power is supplied from PoE ...

Page 22: ...ver Ethernet IEEE802 3af compliant or DC 12V 10 ripple 100 mV p p or less Power consumption 1 PoE 3 2W max DC12V 2 7W max Interface Gigabit Ethernet IEEE802 3ab 1000BASE T conformity Transmission speed 1Gbps Maximum Protocol GigEVision Camera Interface Standard for Machine Vision Ver 1 2 Conformity cable Twist pair Category 5e or over Cable length Up to 100m at the Unshielded Twist Pair UTP cable ...

Page 23: ...t filter 3lx 2lx Power supply PoE Power over Ethernet IEEE802 3af compliant or DC 12V 10 ripple 100 mV p p or less Power consumption 1 PoE 3 6W max DC12V 2 9W max Interface Gigabit Ethernet IEEE802 3ab 1000BASE T conformity Transmission speed 1Gbps Maximum Protocol GigEVision Camera Interface Standard for Machine Vision Ver 1 2 Conformity cable Twist pair Category 5e or over Cable length Up to 100...

Page 24: ... in resolution and brightness in the peripheral area occurrence of a ghost aberration and others When you check the combination between the lens and camera be sure to use the lens you actually use In addition use a mounting screw free from defects and dirt Otherwise the camera may be unable to be removed As for the C mount lens used combining this camera the projection distance from bottom of the ...

Page 25: ... 0 to 0 5V High 3 3 to 24 0V Input current 5 to 15mA Pulse width 200μs minimum Input circuit Photo coupler input TRIG_IN Vcc GND TLP291 LINE0 I O_GND 2pin 5pin Depending on cable length cable kinds and input current of trigger input line Random Trigger Shutter operation may not satisfy timing specification or camera may not receive External trigger signal Polarity High active Low active factory se...

Page 26: ...INE1 5pin 3pin 6pin LineModeAll 3 3V 10kΩ direction Direction control LineModeAll register factory setting IN Polarity High active Low active factory setting Low active TIMER0 ACTIVE Delay 0 to 2000000μs factory setting 0s Duration 0 to 2000000μs factory setting 0s TimerTriggerSource Line0Active ExposureStart FrameTrigger Notes of external trigger signal Depending on cable length kind of cable and...

Page 27: ... GPIO0 LineModeAll 3 3V 10kΩ direction OUT GND 6pin LINE1 3pin Active Low Pulse LVTTL Active Low Pulse Your Signal GND LINE2 4pin Camera Inside Your System 3 3V 24 0V Active Low Pulse Active Low Pulse I O_GND 5pin Your Secondary GND Your Secondary GND Camera Signal GND Camera Signal GND Camera GND Pin 6 and I O_GND Pin 5 are mutually isolated It is also possible to connect them to common GND of yo...

Page 28: ...signal TRIG_IN GPIO0 3 3 24V LINE0 Open 3 3V LINE1 b Positive Trigger Signal Input Delay EXT_TRIG_WIDTH The pulse width of the external trigger input Toff The delay time of falling edge Ton The delay time of rising edge TRIG_IN_WIDTH The pulse width of the trigger signal which is received inside of the camera Negative trigger TRIG_IN_WIDTH EXT_TRIG_WIDTH Ton Toff Positive trigger TRIG_IN_WIDTH EXT...

Page 29: ...n OpenCollector LINE1 LINE2 0V 0V LVTTL Toff OpenCollector LVTTL a ActiveLow Ton LINE1 LINE2 0V 0V LVTTL Toff OpenCollector LVTTL OpenCollector b ActiveHigh GPIO Signal Output Delay Toff LINE1 LINE2 falling delay time Ton LINE1 LINE2 rising delay time Pull up amplitude Toff μs Ton μs 3 3V 3 22 12V 4 26 24V 5 26 Measured with 2 2k ohm pulled up register on LINE2 Toff and Ton are typical value These...

Page 30: ... network the value described below is not guaranteed GbE bus transfer timing at all pixels readout T1 GbE bus Expose Image Image Image T DLY1 T T1 DLY2 Image stream output Model Name T1 ms Default Frame Rate ms BG302LMG Maximum frame rate in ms of operating mode 28 5 BG302LMCG 27 8 BG505LMG 45 3 BG505LMCG 45 1 TDLY1 BlockStartDelay TDLY2 SCPD Stream Channel Packet Delay BlockStartDelay and SCPD ar...

Page 31: ...posure time ExposureTime register value 0V VCC TDLY3 TDLY3 Level mode at all pixels readout TRIG_IN GPIO0 0V VCC internal signal AntiGritch T Exposure T2 T3 0V VCC Exposure time Pulse width DLY3 TDLY3 Random Trigger Shutter operation Model Name T2 μs T3 μs BG302LMG 45 2 58 9 BG302LMCG 34 0 48 6 BG505LMG 53 2 66 9 BG505LMCG 40 0 54 6 TDLY3 Delay time is the same as AntiGlitch setting value AntiChat...

Page 32: ...rigger shutter mode In the period when FRAME_TRIGGER_WAIT GPIO signal is inactive user must not input external trigger signal to this camera When the interval of the input trigger signal is extremely short or when the trigger signal is noisy there is a possibility of causing the malfunction In this case please input a proper trigger signal ...

Page 33: ...18 TOSHIBA TELI CORPORATION All Rights Reserved http www toshiba teli co jp en index htm D4259344C Typical Spectral Response The lens characteristics and light source characteristics is not reflected in table BG302LMG BG505LMG ...

Page 35: ...ater less than 60 C Storage Assurance Temperature 20 C 60 C Humidity 90 or less no condensation EMC Conditions EMI Electro Magnetic Interference EN61000 6 4 FCC Part 15 Subpart B Class A EMS Electro Magnetic Susceptibility EN61000 6 2 Notes on Heat Radiation About the upper limit of top surface temperature of camera housing and the allowed ambient temperature of each model please refer to the Ther...

Page 36: ...ol TriggerControl Trigger control ExposureTime Exposure time control DigitalIOControl DigitalIOControl GPIO signal control VenderUniqueControl AntiGlitch AntiGlitch control AntiChattering AntiChattering control CounterAndTimerControl TimerControl Timer0Active signal control AnalogControl Gain Gain control BlackLevel Black level control Gamma Gamma correction Sharpness Sharpness control BalanceRati...

Page 37: ...ceControl ImageFormatSelector Scalable Binning Decimation Reverse PixelFormat TestPattern BayerProcessingMode AcquisitionControl ImageBuffer TriggerControl ExposureControl DigitalIOControl AntiGlitch AntiChattering TimerControl Gain BlackLevel Gamma Sharpness BalanceRatio BalanceWhiteAuto ALCControl ALCExposureMin ALCExposureMax ALCGainMin ALCGainMax ALCThrottle LUTControl SequentialShutterControl...

Page 38: ... which logical link to control GevMACAddress 0x0008 6 IInteger R MAC address of the logical link GevSupportedOptionSelector IEnumeration R W Selects the GEV option to interrogate for existing support GevSupportedOption 0x0010 0x092C 0x0930 0x0934 0x0D20 29 31 0 0 0 10 25 31 0 1 30 31 IBoolean R Returns if the selected GEV option is supported GevCurrentIPConfigurationLLA 0x0014 29 IBoolean RW Contr...

Page 39: ...Value GevTimestampControlReset 0x0944 0 ICommand W Resets the timestamp counter to 0 GevTimestampValue 0x0948 8 IInteger R Returns the latched 64 bit value of the timestamp counter GevDiscoveryAckDelay 0x0950 4 IInteger R Indicates the maximum randomized delay the device will wait to acknowledge a discovery command GevGVCPExtendedStatusCodesSelector IEnumeration R Selects the GigE Vision version t...

Page 40: ...ounter unit to insert between each packet for this stream channel GevSCDA 0x0D18 4 IInteger RW Controls the destination IP address to which a GVSP transmitter must send data stream or the destination IP address from which a GVSP receiver may receive data stream GevSCSP 0x0D1C 4 IInteger R Indicates the source port of the stream channel PayloadSize IInteger R Provides the number of bytes transferre...

Page 41: ...as DeviceVersion in Bootstrap Registers DeviceID 0x200110 String 16 R Device s serial number DeviceUserID String 16 RW User programmable device identifier DeviceTLType IEnumeration 4 R Transport Layer type of the device DeviceStreamChannelSelector IInteger 4 R Same as GevStreamChannelSelector in Transport Layer Control DeviceStreamChannelType IEnumeration 4 R Same as GevSCPDirection in Transport L...

Page 42: ...th Height OffsetX OffsetY BinningHorizontal BinningVertical DecimationHorizontal DecimationVertical ReverseX ReverseY PixelFormat PixelEndian ImageSize Width Height OffsetX OffsetY BinningHorizontal BinningVertical DecimationHorizontal DecimationVertical ReverseX ReverseY PixelFormat PixelEndian GenICam Node Name Interface Length Byte bit Access Description ImageFormatSelector IEnumeration 4 R W S...

Page 43: ...TeliCamSDK Camera feature API Control ImageFormat using dedicated API API name Description GetCamImageFormatSelector Get current ImageFormatSelector value SetCamImageFormatSelector Set new ImageFormatSelector value Please refer to Controlling camera feature functions in TeliCamAPI Library manual for more detail GenICam function API Control ImageFormat using GenICam API ImageFormat Select an image ...

Page 44: ...node functions in TeliCamAPI Library manual for more detail Register access API Control ImageFormat by accessing IIDC2 registers directly API name Description Cam_ReadReg Read register value Cam_WriteReg Write register value ImageFormat Write to Value field of ImageFormatSelector register ImageFormat Format2 uint32_t uiSelector uiSelector 2 Cam_WriteReg s_hCam 0x20203C 1 uiSelector Please refer to...

Page 45: ... If height size is set small it is possible to increase the frame rate Only single rectangle is selectable Concave or convex shape is not selectable Window size A 4 m H B 2 n V A B minimum unit size m n integer The window size is equal or less than maximum image size Start address 4 x i H x 2 x j V i j integer The window size is equal or less than maximum image size X Y 4 i 2 j A 4 m B 2 n Scalabl...

Page 46: ...rection OffsetXInc 0x202070 4 R Returns the unit starting position of the horizontal direction WidthMin 0x202074 4 R Returns the minimum size of width WidthInc 0x202078 4 R Returns the unit size of width SensorWidth 0x20207C 4 R Returns effective Width of the sensor in pixels OffsetYMin 0x202080 4 R Returns the minimum starting position of the vertical direction OffsetYInc 0x202084 4 R Returns the...

Page 47: ... maximum value GetCamOffsetX Get horizontal offset of image SetCamOffsetX Set horizontal offset of image GetCamOffsetYMinMax Get minimum and maximum value GetCamOffsetY Get vertical offset of image SetCamOffsetY Set vertical offset of image Please refer to Controlling camera feature functions in TeliCamAPI Library manual for more detail GenICam function API Control Scalable using GenICam API Scala...

Page 48: ...riteReg Write register value Scalable Write to Value field of OffsetX Width OffsetY Height register ROI OffsetX Width OffsetY Height uint32_t ROI 612 1224 512 1024 Set ROI in one by one Cam_WriteReg s_hCam 0x202094 1 ROI 0 Cam_WriteReg s_hCam 0x202098 1 ROI 1 Cam_WriteReg s_hCam 0x20209C 1 ROI 2 Cam_WriteReg s_hCam 0x2020A0 1 ROI 3 Set ROI in block Cam_WriteReg s_hCam 0x202094 4 ROI 0 In IIDC2 reg...

Page 49: ...x htm D4259344C Binning In the binning mode a pixel is added with the neighboring pixel s This increases the sensitivity of the image It s alike scalable the frame rate can be faster and USB bandwidth occupation decrease 2048 2448 All pixel readout Binning 1024 1224 Binning operation e g 5M pixel 2x2 binning ...

Page 50: ...2 4 42 42 42 4 42 42 42 BG505LMG Mono8 Horizontal Mono10 Mono12 Horizontal 1 2 4 1 2 4 Vertical 1 22 26 26 Vertical 1 11 22 26 2 26 26 26 2 22 26 26 4 26 26 26 4 26 26 26 BG302LMCG Bayer8 Mono8 Horizontal Bayer10 Bayer12 Horizontal 1 2 4 1 2 4 Vertical 1 36 56 56 Vertical 1 18 36 56 2 56 56 56 2 36 56 56 4 56 56 56 4 56 56 56 BG505LMCG Bayer8 Mono8 Horizontal Bayer10 Bayer12 Horizontal 1 2 4 1 2 4...

Page 51: ... the Binning Horizontal BinningVertical Implemented 0x202140 31 R Returns the state whether the function is implemented Min 0x202154 4 R Returns the minimum value of BinningVertical Value register Max 0x202158 4 R Returns the maximum value of BinningVertical Value register Value 0x20215C 4 R W Sets the Binning Vertical Control with TeliCamSDK Camera feature API Control Binning using dedicated API ...

Page 52: ...r access API Control Binning by accessing IIDC2 registers directly API name Description Cam_ReadReg Read register value Cam_WriteReg Write register value Binning Write to Value field of BinningHorizontal register to control BinningHorizontal Or write to Value field of BinningVertical register to control BinningVertical Binning 2x2 uint32_t Binning 2 Set Binning Cam_WriteReg s_hCam 0x20213C 1 Binni...

Page 53: ...ex htm D4259344C Decimation Decimation feature reads out all effective areas at high speed by skipping pixels and lines Decimation feature can make frame rate faster and decrease interface bandwidth occupation 2048 2448 All pixel readout Decimation 1024 1224 Decimation operation e g 5M pixel 2x2 decimation ...

Page 54: ...42 87 87 4 42 87 87 BG505LMG Mono8 Horizontal Mono10 Mono12 Horizontal 1 2 4 1 2 4 Vertical 1 22 26 26 Vertical 1 11 22 26 2 26 65 65 2 22 45 65 4 26 65 65 4 26 65 65 BG302LMCG Bayer8 Mono8 Horizontal Bayer10 Bayer12 Horizontal 1 2 4 1 2 4 Vertical 1 36 56 56 Vertical 1 18 36 56 2 56 116 116 2 36 72 116 4 56 116 116 4 56 116 116 BG505LMCG Bayer8 Mono8 Horizontal Bayer10 Bayer12 Horizontal 1 2 4 1 ...

Page 55: ...n Horizontal DecimationVertical Implemented 0x202180 31 R Returns the state whether the function is implemented Min 0x202184 4 R Returns the minimum value of DecimationVertical Value register Max 0x202188 4 R Returns the maximum value of DecimationVertical Value register Value 0x20218C 4 R W Sets the Decimation Vertical Control with TeliCamSDK Camera feature API Control Decimation using dedicated ...

Page 56: ...ccess API Control Decimation by accessing IIDC2 registers directly API name Description Cam_ReadReg Read register value Cam_WriteReg Write register value Decimation Write to Value field of DecimationHorizontal register to control DecimationHorizontal Or write to Value field of DecimationVertical register to control DecimationVertical Decimation 2x2 uint32_t Decimation 2 Set Decimation Cam_WriteReg...

Page 57: ...ss Description ReverseX IBoolean 4 R W Sets the Reverse Horizontal ReverseY IBoolean 4 R W Sets the Reverse Vertical IIDC2 Register Register Field Address Length Byte bit Access Description ReverseX Implemented 0x2021A0 31 R Returns the state whether the function is implemented Value 0x2021B0 4 R W Sets the Reverse Horizontal 0 Off 1 On ReverseY Implemented 0x2021C0 31 R Returns the state whether ...

Page 58: ...mera feature functions in TeliCamAPI Library manual for more detail GenICam function API Control Reverse using GenICam API Reverse Sets the Reverse Horizontal by ReverseX Sets the Reverse Vertical by ReverseY GenICam node handle CAM_NODE_HANDLE hReverseX NULL CAM_NODE_HANDLE hReverseY NULL Retrieve GenICam node Nd_GetNode s_hCam ReverseX hReverseX Nd_GetNode s_hCam ReverseY hReverseY Set Reverse f...

Page 59: ...ster value Cam_WriteReg Write register value Reverse Write to Value field of ReverseX register Write to Value field of ReverseY register Set Reverse flip horizontal and vertical direction uint32_t dat 1 Cam_WriteReg s_hCam 0x2021B0 1 dat Cam_WriteReg s_hCam 0x2021D0 1 dat Please refer to Camera functions in TeliCamAPI Library manual for more detail Note Changing ReverseX ReverseY register value is...

Page 60: ...Length Byte bit Access Description PixelCoding Implemented 0x2020C0 31 R Returns the state whether the function is implemented ListOfElements 0x2020CC 0x2020D8 16 R Returns the presence of the pixel coding 0 Mono 105 BayerBG Value 0x2020DC 4 R W Selects a pixel cording PixelSize Implemented 0x2020E0 31 R Returns the state whether the function is implemented ListOfElements 0x2020EC 0x2020F8 16 R 8 ...

Page 61: ...108000B 0x0110000F 0x0110000E initial factory setting Control with TeliCamSDK Camera feature API Control PixelFormat using dedicated API API name Description GetCamPixelFormat Get current PixelFormat value SetCamPixelFormat Set new PixelFormat value Please refer to Controlling camera feature functions in TeliCamAPI Library manual for more detail GenICam function API Control PixelFormat using GenIC...

Page 62: ...de s_hCam PixelSize hSize 1 Select a pixel coding Nd_SetEnumStrValue s_hCam hCoding Mono 2 Select a pixel size Nd_SetEnumStrValue s_hCam hSize Bpp10 PixelFormat 1 Select a pixel format PixelFormat Integer value and string value of Enumeration are as follows Integer String 1 Mono8 3 Mono10 5 Mono12 11 BayerBG8 15 BayerBG10 19 BayerBG12 GenICam node handle CAM_NODE_HANDLE hFormat NULL Retrieve GenIC...

Page 63: ...Write to Value field of PixelCoding register 2 Write to Value field of PixelSize register uint32_t coding 0 Mono uint32_t size 10 Bpp10 1 Select a pixel coding Cam_WriteReg s_hCam 0x2020DC 1 coding 2 Select a pixel size Cam_WriteReg s_hCam 0x2020FC 1 size PixelFormat 1 Write to Value field of PixelFormat register uint32_t format 3 Mono10 1 Select a pixel format Cam_WriteReg s_hCam 0x20241C 1 forma...

Page 64: ...hiba teli co jp en index htm D4259344C TestPattern Camera supports test pattern data output Following test patterns are available Black White GreyA GreyB GreyHorizontalRamp GreyVerticalRamp GreyScale ColorBar Mono model only Color model only Test pattern e g BG505LMG BG505LMCG BayerBG8 ...

Page 65: ...1F120 31 R Returns the state whether the function is implemented ListOfElements 0x21F12C 0x21F138 16 R 0 Off 1 Black 2 White 3 GreyA 4 GreyB 5 GreyHorizontalRamp 6 GreyScale 7 ColorBar 8 GreyVerticalRamp Value 0x21F13C 4 R W Selects a test pattern Control with TeliCamSDK Camera feature API Control TestPattern using dedicated API API name Description GetCamTestPattern Get current TestPattern value ...

Page 66: ...r Color model only 8 GreyVerticalRamp Vertical Ramp initial factory setting GenICam node handle CAM_NODE_HANDLE hNode NULL Retrieve GenICam node Nd_GetNode s_hCam TestPattern hNode 1 Select a test pattern Nd_SetEnumStrValue s_hCam hNode GreyHorizontalRamp Please refer to INode functions IEnumeration node functions in TeliCamAPI Library manual for more detail Register access API Control TestPattern...

Page 67: ...es are available Raw Only Gain feature is available Function Full Partial Raw Gain BlackLevel Gamma BalanceRatio LUTControl DPCControl initial factory setting GenICam Node Name Interface Length Byte bit Access Description BayerProcessingMode IEnumeration 4 R W Selects a Bayer Processing Mode IIDC2 Register Register Field Address Length Byte bit Access Description BayerProcessingMode Implemented 0x...

Page 68: ...m BayerProcessingMode hMode BayerProcessingMode Raw Nd_SetEnumStrValue s_hCam hMode Raw Please refer to INode functions IEnumeration node functions in TeliCamAPI Library manual for more detail Register access API This API access IIDC2 registers directly API name Description Cam_ReadReg Read register value Cam_WriteReg Write register value BayerProcessingMode Write to Value field of BayerProcessing...

Page 69: ... Node Name Interface Length Byte bit Access Description AcquisitionMode IEnumeration 4 R W Selects an acquisition mode AcquisitionStart ICommand 4 W Executes the image stream output start AcquisitionStop ICommand 4 W Executes the image stream output stop AcquisitionAbort ICommand 4 W Executes the image stream output abort AcquisitionFrameCount IInteger 4 R W Sets the number of frames to transfer i...

Page 70: ...ame ImageBuffer mode Value 0x20305C 4 R W Sets the number of frames in MultiFrame ImageBuffer mode AcquisitionFrameRate Implemented 0x2030A0 31 R Returns the state whether the function is implemented Control 0x2030A8 4 R W 0 NoSpecify 1 Manual Mult 0x2030AC 4 R Absolute Value fps Raw Mult Div Div 0x2030B0 4 R Min 0x2030B4 4 R Returns the minimum value of FrameRate Max 0x2030B8 4 R Returns the maxi...

Page 71: ...ssary to set an AcquisitionFrameCount 2 Select an AcquisitionFrameRate setting priority optional Set AcquisitionFrameRateEnable with SetCamAcquistionFrameRateEnable function AcquisitionFrameRateEnablel Function False The frame rate is determined by giving priority to ExposureTime setting value True The frame rate is determined by giving priority to AcquisitionFrameRate setting value initial factor...

Page 72: ...g value of Enumeration are as follows Integer String 0 False 1 True initial factory setting 3 Set frame rate of image stream optional Get IFloat interface handle of AcquisitionFrameRate or AcquisitionFrameInterval by Nd_GetNode Set AcquisitionFrameRate or AcquisitionFrameInterval with IFloat node functions AquisitionFrameInterval is a reciprocal of AcquisitionFrameRate e g Nd_GetFloatMin Nd_GetFlo...

Page 73: ...older Please refer to Camera functions in TeliCamAPI Library manual for more detail Minimum Maximum Value AcquisitionFrameRate BG302LMG BG302LMCG BG505LMG BG505LMCG Minimum Raw Value 4095 Absolute Value 0 0625 fps Maximum Raw Value Depends on ImageFormatControl setting Absolute Value Initial Value Raw Value 2359296 1480342 Absolute Value 36 000 fps 22 588 fps Formula Absolute Value fps Raw Value 6...

Page 74: ... Node Name Interface Length Byte bit Access Description ImageBufferMode IEnumeration 4 R W Sets an Image Buffer mode ImageBufferFrameCount IInteger 4 R W Sets the number of frames to transfer in MultiFrame ImageBuffer mode ImageBufferRead ICommand 4 W Read Image from Image Buffer IIDC2 Register Register Field Address Length Byte bit Access Description ImageBufferMode Implemented 0x203060 31 R Retu...

Page 75: ...frames in Image Buffer Read the number of frames in Image Buffer with GetCamImageBufferFrameCount function 4 Read Image from Image Buffer Start to read Image from Image Buffer with ExecuteCamImageBufferRead function 5 Receive Image from Image Buffer Please refer to Controlling camera feature functions in TeliCamAPI Library manual for more detail GenICam function API Control ImageBuffer using GenIC...

Page 76: ...nt NULL FALSE FALSE NULL Strm_OpenSimple s_hCam s_hStrm s_uiImgBufSize s_hStrmEvt s_pucImgBuf uint8_t VirtualAlloc NULL s_uiImgBufSize MEM_RESERVE MEM_COMMIT PAGE_EXECUTE_READWRITE 2 3 Stream Start Strm_Start s_hStrm 2 4 Execute Software Trigger ExecuteCamSoftwareTrigger s_hCam 3 Read the number of frames in Image Buffer by ImageBufferFrameCount int64_t count 0 while count 0 Nd_GetIntValue s_hCam ...

Page 77: ...of ImageBufferMode register to control ImageBufferMode 2 Open and Start image stream To start and stop capturing image is the same way as AcquisitionControl Please refer to AcquisitionControl section as well 3 Read the number of frames in Image Buffer Read Value field of ImageBufferFrameCount register 4 Read Image from Image Buffer Write 10 to Value field of AcquisitionCommand register to execute ...

Page 78: ...frames in Image Buffer uint32_t count 0 while count 0 Cam_ReadReg s_hCam 0x20309C 1 count 4 Read Image from Image Buffer AcquisitionCommand 10 Image Buffer Read dat 10 Cam_WriteReg s_hCam 0x20303C 1 dat 5 Receive Image from Image Buffer uint32_t uiSize s_uiImgBufSize WaitForSingleObject s_hStrmEvt 1000 Strm_ReadCurrentImage s_hStrm s_pucImgBuf uiSize NULL 6 Stop and Close image stream 6 1 Stream S...

Page 79: ...t are available 1 Trigger signal via the I O connector HardwareTrigger 2 Trigger command via software command SoftwareTrigger The following table shows the combination of operation mode of this camera series Operation Mode Trigger Mode Synchronization Exposure Control Normal Shutter mode Free run ExposureTime register control Random Trigger Shutter mode HardwareTrigger Edge mode TriggerSequence0 B...

Page 80: ...Trigger Pulse Width Image Bulk mode TriggerSequence6 Camera exposes and transfers multiple frames by a single trigger Image Exposure Trigger ExposureTime Image Image AcquisitionBurstFrameCount 3 Image Streaming on Interface Bus Operation point of HardwareTrigger is at the edge of trigger signal and active edge polarity is able to change by register setting And you can add delay time from trigger e...

Page 81: ...ther the function is implemented ListOfElements 0x20702C 0x207038 16 R 0 OFF Normal shutter 1 ON Random trigger shutter Value 0x20703C 4 R W Selects a trigger mode TriggerSequence Implemented 0x207040 31 R Returns the state whether the function is implemented ListOfElements 0x20704C 0x207058 16 R 0 TriggerSequence0 Edge mode 1 TriggerSequence1 Level mode 6 TriggerSequence6 Bulk mode Value 0x20705C...

Page 82: ...ive 8 Impulse Value 0x20705C 4 R W Executes software trigger Control with TeliCamSDK Camera feature API Control Trigger features using dedicated API API name Description GetCamTriggerMode Get current TriggerMode SetCamTriggerMode Set new TriggerMode GetCamTriggerSequence Get current TriggerSequence SetCamTriggerSequence Set new TriggerSequence GetCamTriggerSource Get current TriggerSource SetCamTr...

Page 83: ...frames to exposure in Bulk mode Set TriggerAdditionalParameter with SetCamTriggerAdditionalParameter function 6 Set a trigger delay Set TriggerDelay with SetCamTriggerDelay function 7 Capture image stream To start and stop capturing image is the same way as AcquisitionControl Please refer to AcquisitionControl section as well Please refer to Camera streaming functions in TeliCamAPI Library manual ...

Page 84: ... trigger source of random trigger shutter by TriggerSource Integer value and string value of Enumeration are as follows Integer String 0 Line0 1 Line1 64 Software initial factory setting 4 Select a trigger activation of hardware trigger by TriggerActivation 5 Set the number of frames to exposure in Bulk mode by TriggerAdditionalParameter 6 Set a trigger delay by TriggerDelay 7 Capture image stream...

Page 85: ... Nd_SetEnumStrValue s_hCam hSource Software Software 4 Select a trigger activation of hardware trigger by LineInverterAll not applicable for Software Trigger 5 Set the number of frames to exposure in Bulk mode by TriggerAdditionalParameter Nd_SetIntValue s_hCam hAdditionalParameter 3 3 frames 6 Set a trigger delay by TriggerDelay Nd_SetFloatValue s_hCam hDelay 1000 0 1ms 7 Open and Start image str...

Page 86: ...ence 3 Select a trigger source of random trigger shutter Write to Value field of TriggerSource register to control TriggerSource 4 Select a trigger activation of hardware trigger 5 Set the number of frames to exposure in Bulk mode Write to Value field of TriggerAdditionalParameter register to control TriggerAdditionalParameter 6 Set a trigger delay Write to Value field of TriggerDelay register to ...

Page 87: ...delay by TriggerDelay TriggerDelay 1000 0us Raw value 60000 dat 60000 Cam_WriteReg s_hCam 0x2070BC 1 dat 1ms 7 Open and Start image stream 7 1 Open Stream s_hStrmEvt CreateEvent NULL FALSE FALSE NULL Strm_OpenSimple s_hCam s_hStrm s_uiImgBufSize s_hStrmEvt s_pucImgBuf uint8_t VirtualAlloc NULL s_uiImgBufSize MEM_RESERVE MEM_COMMIT PAGE_EXECUTE_READWRITE 7 2 Stream Start Strm_Start s_hStrm 8 Execut...

Page 88: ...00 us Initial Value Raw Value 0 Absolute Value 0 00 us Formula Absolute Value us Raw Value 25 Note In SoftwareTrigger operation the delay time from TriggerSoftware to exposure is not guaranteed BG series have two hardware trigger source Please refer to I O Specification section as well TriggerSource Description Line0 I O connector 2 pin Photo coupler 3 3 to 24 0V Line1 I O connector 3 pin High lev...

Page 89: ...ed automatically GenICam Node Name Interface Length Byte bit Access Description ExposureTime IFloat 4 R W Sets an exposure time ExposureAuto IEnumeration 4 R W Adjusts a exposure time automatically IIDC2 Register Register Field Address Length Byte bit Access Description ExposureTime Implemented 0x204020 31 R Returns the state whether the function is implemented Control 0x204028 4 R W 0 NoSpecify 1...

Page 90: ...de ExposureTimeControl parameter Description CAM_EXPOSURE_TIME_CONTROL_NO_SPECIFY NoSpecify CAM_EXPOSURE_TIME_CONTROL_MANUAL Manual CAM_EXPOSURE_TIME_CONTROL_AUTO Auto Please refer to Controlling camera feature functions in TeliCamAPI Library manual for more detail GenICam function API Control ExposureTime using GenICam API ExposureTime 1 Sets an exposure time by ExposureTime GenICam node handle C...

Page 91: ...se refer to INode functions IFloat node functions and IEnumeration node functions in TeliCamAPI Library manual for more detail Register access API Control ExposureTime by accessing IIDC2 registers directly API name Description Cam_ReadReg Read register value Cam_WriteReg Write register value ExposureTime Write to Value field of ExposureTime register ExposureTime 1000us Raw value 60000 uint32_t uiE...

Page 92: ...MCG Minimum Raw Value 750 800 Absolute Value 30 00 us 32 00 us Maximum Manual Raw Value 400000000 Absolute Value 16000000 00 us Auto Raw Value 25000000 Absolute Value 1000000 00 us Initial Value Raw Value 675000 1125000 Absolute Value 27000 00 us 45000 00 us Formula Absolute Value us Raw Value 25 Note In ExposureAuto mode current exposure time will be reflected to ExposureTime value register ...

Page 93: ...Sensor Output Image Streaming on Interface Bus Timer0Active ExposureActive FrameActive FrameTransfer FrameTrigger Wait Delay Duration AcquisitionActive is active during AcquisitionStart state All signals in this figure are Active Low Selectable signals Timer0Active UserOutput ExposureActive FrameTransfer FrameActive FrameTriggerWait Internal Trigger TimerControl UserOutputValueAll 1 UserOutputValu...

Page 94: ...All Details of each signal GenICam Node Name Interface Length Byte bit Access Description LineMode IEnumeration 4 R W Selects the Input Output of each Line selected by LineSelector LineModeAll IInteger 4 R W Selects the Input Output of each Line LineInverter IBoolean 4 R W Selects the polarity of each Line signal selected by LineSelector LineInverterAll IInteger 4 R W Selects the polarity of each ...

Page 95: ...d output buffers LineStatusAll Implemented 0x209060 31 R Returns the state whether the function is implemented Value 0x209070 4 R Returns the current status of all I O lines UserOutputValueAll Implemented 0x209080 31 R Returns the state whether the function is implemented Value 0x209090 4 R W Selects the output value LineSelector Implemented 0x2090A0 31 R Returns the state whether the function is ...

Page 96: ...tCamLineModeAll Get current LineMode GetCamLineInverterAll Get current LineInverter SetCamLineInverterAll Set new LineInverter GetCamLineStatusAll Get current LineStatus GetCamUserOutputValueAll Get current UserOutput SetCamUserOutputValueAll Set new UserOutput GetCamLineSource Get current LineSource SetCamLineSource Set new LineSource Please refer to Controlling camera feature functions in TeliCa...

Page 97: ...eAll 31 0 Line0 Line1 Line2 LineModeAll XML node Camera Register XML Selector Selects the Input Output of each Line by LineModeAll Each bit of integer value corresponds to each Line bit0 Line0 not changeable bit1 Line1 bit2 Line2 not changeable bit value I O Direction 0 Input 1 Output LineModeAll Value bit value Line2 Line1 Line0 I O Direction Line2 Line1 Line0 0 not used 1 2 3 4 1 0 0 out in in 5...

Page 98: ...ML Selector TriggerSource TriggerActivation Selects the polarity of each Line signal by LineInverterAll Each bit of integer value corresponds to each Line bit0 Line0 bit1 Line1 bit2 Line2 bit value Inverter 0 False not inverted 1 True inverted LineInverterAll Value bit value Line2 Line1 Line0 Inverter Line2 Line1 Line0 0 0 0 0 off off off 1 0 0 1 off off on 2 0 1 0 off on off 3 0 1 1 off on on 4 1...

Page 99: ...Camera Register XML Selector Gets the status of each Line signal by LineStatusAll Each bit of integer value corresponds to each Line bit0 Line0 bit1 Line1 bit2 Line2 bit value Line Status 0 False Low 1 True High LineStatusAll Value bit value Line2 Line1 Line0 Line Status Line2 Line1 Line0 0 0 0 0 low low low 1 0 0 1 low low high 2 0 1 0 low high low 3 0 1 1 low high high 4 1 0 0 high low low 5 1 0...

Page 100: ...node Camera Register XML Selector Sets the user output value by UserOutputValueAll Each bit of integer value corresponds to each Line bit0 Line0 not used bit1 Line1 bit2 Line2 bit value Output 0 Low 1 High UserOutputValueAll Value bit value Line2 Line1 Output Line2 Line1 0 0 0 low low 1 2 0 1 low high 3 4 1 0 high low 5 6 1 1 high high 7 LineSelector Selects the I O line to output by LineSelector ...

Page 101: ...ady to accept trigger signal both hardware and software 107 FrameActive Period from exposure start to sensor read out completion 115 FrameTransferActive Period of transferring image streaming data on interface bus 123 ExposureActive Period from exposure start to exposure end GenICam node handle CAM_NODE_HANDLE hMode NULL CAM_NODE_HANDLE hSelector NULL CAM_NODE_HANDLE hSource NULL Retrieve GenICam ...

Page 102: ... to Value field of LineSelector register LineSource Write to Value field of LineSource register Line2 Line1 output Line0 input uint32_t uiMode 6 Cam_WriteReg s_hCam 0x209030 1 uiMode Set Value uint32_t uiSelector uint32_t uiSource uiSelector 1 Line1 uiSource 123 ExposureActive Cam_WriteReg s_hCam 0x2090BC 1 uiSelector Cam_WriteReg s_hCam 0x2090DC 1 uiSource uiSelector 2 Line2 uiSource 115 FrameTra...

Page 103: ...cuit sets the edge insensible time to avoid trigger malfunction It is effective to remove unstable logic state and switch chattering Low High Low Trigger Signal Skewed High Low Trigger Signal Original high slew rate noise low slew rate Digital Input High High threshold AntiGlitch Value High Low High Low Low threshold Delay AntiChattering Value Valid Signal AntiChattering Circuit Output Integration...

Page 104: ...unction is implemented Mult 0x21F3EC 4 R Absolute Value sec Raw Mult Div Div 0x21F3F0 4 R Min 0x21F3F4 4 R Returns the minimum value of AntiGlitch period Max 0x21F3F8 4 R Returns the maximum value of AntiGlitch period Value 0x21F3FC 4 R W Sets the AntiGlitch period Raw value Control with TeliCamSDK GenICam function API Control AntiGlitch AntiChattering using GenICam API AntiGlitch AntiChattering 1...

Page 105: ...ster AntiGlitch 1 0 us Raw value 100 AntiChattering 10 0 us Raw value 1250 uint32_t uiAntiGlitchRaw 100 uint32_t uiAntiChatteringRaw 1250 Set Value Cam_WriteReg s_hCam 0x21F3DC 1 uiAntiGlitchRaw Cam_WriteReg s_hCam 0x21F3FC 1 uiAntiChatteringRaw Please refer to Camera functions in TeliCamAPI Library manual for more detail Minimum Maximum Value AntiGlitch AntiChattering Minimum Raw Value 1 49 Absol...

Page 106: ...sure Timer0Active Delay Duration ActiveLow ExposureActive Internal Trigger Selected by TriggerSource TriggerDelay TimerTriggerSource Line0Active TimerTriggerSource ExposureStart TimerTriggerSource FrameTrigger Timer0Active GenICam Node Name Interface Length Byte bit Access Description TimerSelector IEnumeration 4 R Returns the selected timer name TimerDelay IFloat 4 R W Sets the delay of Timer0Act...

Page 107: ... 0x20A070 4 R Min 0x20A074 4 R Returns the minimum value of TimerDuration Value register Max 0x20A078 4 R Returns the maximum value of TimerDuration Value register Value 0x20A07C 4 R W Sets Timer0Active duration time Raw value TimerTriggerSource Implemented 0x20A080 31 R Returns the state whether the function is implemented ListOfElements 0x20A08C 4 R W 0 Off 32 Line0 104 FrameTrigger 124 Exposure...

Page 108: ...ame Start Trigger 124 ExposureStart Starts with the reception of the Exposure Start GenICam node handle CAM_NODE_HANDLE hDelay NULL CAM_NODE_HANDLE hDuration NULL CAM_NODE_HANDLE hSource NULL TimerDelay 1000 0 us TimerDuration 2000 0 us float64_t dDelay 1000 0 float64_t dDuration 2000 0 Retrieve GenICam node Nd_GetNode s_hCam TimerDelay hDelay Nd_GetNode s_hCam TimerDuration hDuration Nd_GetNode s...

Page 109: ...lue Cam_WriteReg s_hCam 0x20A05C 1 uiTimerDelayRaw Cam_WriteReg s_hCam 0x20A07C 1 uiTimerDurationRaw Cam_WriteReg s_hCam 0x21F27C 1 uiTimerTriggerSource Please refer to Camera functions in TeliCamAPI Library manual for more detail Minimum Maximum Value TimerDelay TimerDuration Minimum Raw Value 0 Absolute Value 0 00 us Maximum Raw Value 50000000 Absolute Value 2000000 00 us Initial Value Raw Value...

Page 110: ...ignal 10 Gain is in dB unit GenICam Node Name Interface Length Byte bit Access Description Gain IFloat 4 R W Sets a manual Gain GainAuto IEnumeration 4 R W Adjusts Gain automatically IIDC2 Register Register Field Address Length Byte bit Access Description Gain Implemented 0x204060 31 R Returns the state whether the function is implemented Control 0x204068 4 R W 1 Manual 2 Auto Mult 0x20406C 4 R Ab...

Page 111: ...iption CAM_GAIN_AUTO_OFF Off CAM_GAIN_AUTO_AUTO Adjust continuously Please refer to Controlling camera feature functions in TeliCamAPI Library manual for more detail GenICam function API Control Gain using GenICam API Gain Use IFloat interface to control Gain GenICam node handle CAM_NODE_HANDLE hNode NULL Gain 6 0dB float64_t dGain 6 0 Retrieve GenICam node Nd_GetNode s_hCam Gain hNode Set Gain Va...

Page 112: ... name Description Cam_ReadReg Read register value Cam_WriteReg Write register value Gain Write to Value field of Gain register Gain 6 0dB Raw value 60 uint32_t uiGainRaw 60 Set Gain Value Cam_WriteReg s_hCam 0x20407C 1 uiGainRaw GainAuto Write to Control field of Gain register GainAuto Auto uint32_t uiGainAuto 2 Set GainAuto Auto Cam_WriteReg s_hCam 0x204068 1 uiGainAuto Please refer to Camera fun...

Page 113: ...r Register Field Address Length Byte bit Access Description BlackLevel Implemented 0x204040 31 R Returns the state whether the function is implemented Mult 0x20404C 4 R Absolute Value Raw Mult Div Div 0x204050 4 R Min 0x204054 4 R Returns the minimum value of Black Level Value register Max 0x204058 4 R Returns the maximum value of Black Level Value register Value 0x20405C 4 R W Black Level value R...

Page 114: ...unctions and IFloat node functions in TeliCamAPI Library manual for more detail Register access API Control BlackLevel by accessing IIDC2 registers directly API name Description Cam_ReadReg Read register value Cam_WriteReg Write register value BlackLevel Write to Value field of BlackLevel register BlackLevel 25 Raw value 256 int32_t iBlackLevelRaw 256 signed Set BlackLevel Value Cam_WriteReg s_hCa...

Page 115: ...ription Gamma Implemented 0x204080 31 R Returns the state whether the function is implemented Mult 0x20408C 4 R Absolute Value Raw Mult Div Div 0x204090 4 R Min 0x204094 4 R Returns the minimum value of Gamma Value register Max 0x204098 4 R Returns the maximum value of Gamma Value register Value 0x20409C 4 R W Gamma value Raw value Control with TeliCamSDK Camera feature API Control Gamma using ded...

Page 116: ...Node functions and IFloat node functions in TeliCamAPI Library manual for more detail Register access API Control Gamma by accessing IIDC2 registers directly API name Description Cam_ReadReg Read register value Cam_WriteReg Write register value Gamma Write to Value field of Gamma register Gamma 0 45 Raw value 45 uint32_t uiGammaRaw 45 Set Gamma Value Cam_WriteReg s_hCam 0x20409C 1 uiGammaRaw Pleas...

Page 117: ...ue IIDC2 Register Register Field Address Length Byte bit Access Description Sharpness Implemented 0x2040A0 31 R Returns the state whether the function is implemented Min 0x2040B4 4 R Returns the minimum value of sharpness Value register Max 0x2040B8 4 R Returns the maximum value of sharpness Value register Value 0x2040BC 4 R W Sets sharpness value Raw value Control with TeliCamSDK Camera feature A...

Page 118: ...er to INode functions and IInteger node functions in TeliCamAPI Library manual for more detail Register access API Control Sharpness by accessing IIDC2 registers directly API name Description Cam_ReadReg Read register value Cam_WriteReg Write register value Sharpness Write to Value field of Sharpness register Sharpness 4 Raw value 4 uint32_t uiSharpnessRaw 4 Set Sharpness Value Cam_WriteReg s_hCam...

Page 119: ...nceRatio This section describes BalanceRatio feature BalanceRatio control adjusts the white balance gain of the image BalanceWhiteAuto control adjusts white balance gain automatically This function is available only in Color models R G B R G B BalanceRatio R BalanceRatio B Input Signal Level Output Signal Level Fig BalanceRatio ...

Page 120: ...whether the function is implemented Control 0x205068 4 R W 1 Off 3 Once Mult 0x20506C 4 R Absolute Value times Raw Mult Div Div 0x205070 4 R Min 0x205074 4 R Returns the minimum value of WhiteBalanceR Value register Max 0x205078 4 R Returns the maximum value of WhiteBalanceR Value register Value 0x20507C 4 R W White balance Red gain Raw value WhiteBalanceB Implemented 0x205080 31 R Returns the sta...

Page 121: ... Adjust once Please refer to Controlling camera feature functions in TeliCamAPI Library manual for more detail GenICam function API Control BalanceRatio and BalanceWhiteAuto using GenICam API BalanceRatio 1 Select a color component of white balance gain to control by BalanceRatioSelector Integer value and string value of Enumeration are as follows Integer String 1 Red 2 Blue 2 Set a white balance ...

Page 122: ...eWhiteAuto by accessing IIDC2 registers directly API name Description Cam_ReadReg Read register value Cam_WriteReg Write register value BalanceRatio Write to Value field of WhiteBalanceR or WhiteBalanceB register WhiteBalance R Gain x 1 Raw value 65536 WhiteBalance B Gain x 1 Raw value 65536 uint32_t uiWhiteBalanceRRaw 65536 uint32_t uiWhiteBalanceBRaw 65536 Set WhiteBalance Gain Value Cam_WriteRe...

Page 123: ...s Maximum 524287 x 8 times Initial Value model specific model specific Formula Absolute Value times Raw Value 65536 Note After executing BalanceWhiteAuto the result will be reflected to BalanceRatio Red and Blue value Notes on white balance gain setting Too high white balance gain increases noises After adjusting the white balance of the image I ask you to have final image quality checked with you...

Page 124: ...isters to adjust the various parameter of ALC operation ALCPhotometricAreaSize defines photometric area size for measuring luminance 100 H 100 x V 100 64 H 80 x V 80 16 H 40 x V 40 ALCPhotometricAreaSize e g 100 80 40 ALCExposureValue defines a correction value for a convergence value Final convergence value is determined by the following formula ALCExposureValue Final convergence value 84 Referen...

Page 125: ...eTimeMin Maximum less than ALCExposureTimeMax as same as minimum value of Manual mode initial factory setting ExposureTimeMin minimum value ExposureTimeMax 1 s ALCGainMin ALCEGainMax define the following range of AE operation Set the following value to ALCGainMin ALCGainMax register Setting value is Float type AGC mode operates at a range of a register value You shall set GainMin GainMax This func...

Page 126: ... R Returns the minimum value of ALC photometric area size Max 0x21F378 4 R Returns the maximum value of ALC photometric area size Value 0x21F37C 4 R W Sets ALC photometric area size Raw value ALCExposureValue Implemented 0x2040C0 31 R Returns the state whether the function is implemented Mult 0x2040CC 4 R AbsoluteValue Raw Mult Div Div 0x2040D0 4 R Min 0x2040D4 4 R Returns the minimum value of ALC...

Page 127: ... level Value Raw value ALCGainMax Implemented 0x2042E0 31 R Returns the state whether the function is implemented Mult 0x2042EC 4 R AbsoluteValue Raw Mult Div Div 0x2042F0 4 R Min 0x2042F4 4 R Returns the minimum value of ALC Gain level Value Max 0x2042F8 4 R Returns the maximum value of ALC Gain level Value Value 0x2042FC 4 R W Sets ALC Gain level Value Raw value ALCThrottle Implemented 0x21F640 ...

Page 128: ...x 2000000 ALCGainMin 4 00dB float64_t dGainMin 4 00 ALCGainMax 20 00dB float64_t dGainMax 20 00 ALCThrottle 50 00 float64_t dThrottle 50 00 Retrieve GenICam node Nd_GetNode s_hCam ALCPhotometricAreaSize hSize Nd_GetNode s_hCam ALCExposureValue hEV Nd_GetNode s_hCam ALCExposureTimeMin hExpMin Nd_GetNode s_hCam ALCExposureTimeMax hExpMax Nd_GetNode s_hCam ALCGainMin hGainMin Nd_GetNode s_hCam ALCGai...

Page 129: ...ue 25000 uint32_t uiExpMinRaw 25000 ALCExposureTimeMax 2000000μs Raw value 50000000 uint32_t uiExpMaxRaw 50000000 ALCGainMin 4 00dB Raw value 40 uint32_t uiGainMinRaw 40 ALCGainMax 20 00dB Raw value 200 uint32_t uiGainMaxRaw 200 ALCThrottle 50 00 Raw value 32768 uint32_t uiThrottleRaw 32768 Set ALCPhotometricAreaSize Cam_WriteReg s_hCam 0x21F37C 1 uiSizeRaw Set ALCExposureValue Cam_WriteReg s_hCam...

Page 130: ...ax BG302LMCG BG505LMCG Minimum Raw Value 750 Minimum Absolute Value 30 00 us Maximum Raw Value 400000000 Absolute Value 16 000 000 00 us Initial Value Min Raw Value Initial Value Min Absolute Value Max Raw Value Absolute Value Formula Absolute Value EV Raw Value 25 ALCGainMin Max Raw Value Absolute Float Value Minimum 0 0 00 dB Maximum 240 24 00 dB Initial Value Min 0 0 00 dB Max 240 24 00 dB Form...

Page 131: ...LUTValue IInteger 4 R W Sets the output level of LUT IIDC2 Register Register Field Address Length Byte bit Access Description LUTEnable Implemented 0x206020 31 R Returns the state whether the function is implemented Value 0x20603C 4 R W Sets the activation of LUT function 0 Off 1 On LUTValueAll Implemented 0x2FFFDC 31 R Returns the state whether the function is implemented Value 0 0x300000 4 R W S...

Page 132: ...UT to LUTIndex 2 Set the output level of LUT to LUTValue 3 Set the activation of LUT function by LUTEnable GenICam node handle CAM_NODE_HANDLE hIndex NULL CAM_NODE_HANDLE hValue NULL CAM_NODE_HANDLE hEnable NULL Retrieve GenICam node Nd_GetNode s_hCam LUTIndex hIndex Nd_GetNode s_hCam LUTValue hValue Nd_GetNode s_hCam LUTEnable hEnable for int64_t i 0 i 4096 i 1 Set the input level of LUT to LUTIn...

Page 133: ...ster to set the output level of LUT The index of Value register means the input level of LUT 2 Set the activation of LUT function Write to Value field of LUTEnable register to activate LUT function 1 Set the output level of LUT uint64_t addr 0x300000 uint32_t dat for int i 0 i 4096 i addr 0x4 dat 4095 i invert Cam_WriteReg s_hCam addr 1 dat 2 Set the activation of LUT function dat 1 Cam_WriteReg s...

Page 134: ...function SequentialShutterTerminateAt IInteger 4 R W Sets the number of Index to repeat the sequence SequentialShutterIndex IInteger 4 R W Sets the sequence number to register SequentialShutterEntry IInteger 4 R W Sets the UserSet number to register to the sequence IIDC2 Register Register Field Address Length Byte bit Access Description SequentialShutterEnable Implemented 0x21F300 31 R Returns the...

Page 135: ...ry Get current SequentialShutterEntry value SetCamSequentialShutterEntry Set new SequentialShutterEntry value GenICam function API Control SequentialShutter using GenICam API SequentialShutter 1 Set the camera parameters and save them to UserSet Repeat this as you required 2 Set the sequence number to register to SequentialShutterIndex and Sets the UserSet number to register to the sequence to Seq...

Page 136: ...erTerminateAt Nd_SetIntValue s_hCam hTerminateAt index 3 UserSet will be repeated 4 Set the activation of SequentialShutter function by SequentialShutterEnable Nd_SetEnumStrValue s_hCam hEnable On Please refer to INode functions IInteger node functions and IEnumeration node functions in TeliCamAPI Library manual for more detail Register access API Control SequentialShutter by accessing IIDC2 regis...

Page 137: ...try 1 4 2 Sequence UserSet1 UserSet4 UserSet2 uint32_t index dat for index 0 index 3 index addr 4 2 Set SequentialShutterIndex and SequentialShutterEntry Cam_WriteReg s_hCam addr 1 entry index 3 Set SequentialShutterTerminateAt Cam_WriteReg s_hCam 0x21F33C 1 index 3 UserSet will be repeated 4 Set the activation of SequentialShutter function dat 1 Cam_WriteReg s_hCam 0x21F31C 1 dat Please refer to ...

Page 138: ...alue is invalid during image stream data output The following table is the list of registers applied to SequentialShutter List of registers to be applied to SequentialShutter Category Register Category Register ImageFormatControl OffsetX AnalogControl Gain OffsetY BlackLevel ExposureControl ExposureTime Gamma DigitalIOControl UserOutputValueAll Sharpness LineSource BaLanceRatio CounterAndTimerCont...

Page 139: ... W Sets the Y coordinate of defective pixel IIDC2 Register Register Field Address Length Byte bit Access Description DPCEnable Implemented 0x21F280 31 R Returns the state whether the function is implemented ListOfElements 0x21F28C 4 R 0 Off 1 On Value 0x21F29C 4 R W Sets the activation of DPC function DPCNumber Implemented 0x21F2A0 31 R Returns the state whether the function is implemented Value 0...

Page 140: ...L Retrieve GenICam node Nd_GetNode s_hCam DPCIndex hIndex Nd_GetNode s_hCam DPCEntryX hEntryX Nd_GetNode s_hCam DPCEntryY hEntryY Nd_GetNode s_hCam DPCNumber hNumber Nd_GetNode s_hCam DPCEnable hEnable int64_t entry 2 2 100 200 150 300 x y int64_t number for number 0 number 2 number 1 Set the coordinates of defective pixels by DPCIndex DPCEntryX and DPCEntryY Nd_SetIntValue s_hCam hIndex number 0 ...

Page 141: ...pixels to correct Write to Value field of DPCNumber register 3 Sets the activation of DPC function Write 1 to Value field of DPCEnable register 1 Set the coordinates of defective pixels uint32_t entry 2 2 100 200 150 300 x y uint32_t number uint64_t addr 0x400000 for number 0 number 2 number addr 0x8 Cam_WriteReg s_hCam addr 1 entry number 0 Cam_WriteReg s_hCam addr 0x4 1 entry number 1 2 Sets the...

Page 142: ...y Binning AnalogControl Gain Decimation GainAuto Reverse BlackLevel PixelFormat Gamma TestPattern Sharpness BayerProcessingMode BalanceRatio AcquisitionControl AcquisitionFrameRateEnable ALCControl ALCExposureValue AcquisitionFrameRate ALCPhotometricAreaSize AcquisitionFrameIntervalControl ALCExpusureTimeMin AcquisitionFrameInterval ALCExpusureTimeMax TriggerControl TriggerMode ALCGainMin TriggerS...

Page 143: ...powers up IIDC2 Register Register Field Address Length Byte bit Access Description UserSetSelector Implemented 0x208060 31 R Returns the state whether the function is implemented ListOfElements 0x20806C 4 R 0 Default 1 UserSet1 15 UserSet15 Value 0x20807C 4 R W Selects the UserSet UserSetCommand Implemented 0x208080 31 R Returns the state whether the function is implemented ListOfElements 0x20808C...

Page 144: ...SetLoad UserSetSave UserSetQuickSave 1 Select a channel of user setting by UserSetSelector Integer value and string value of Enumeration are as follows Integer String Description Save Load 0 Default Initial factory setting 1 UserSet1 Memory channel 1 for user setting DPC feature is enabled 2 15 UserSet2 15 Memory channel 2 to 15 for user setting 2 Execute UserSetLoad UserSetSave or UserSetQuickSav...

Page 145: ...Done s_hCam hSave bDone if bDone true break Sleep 0 UserSetDefault Select a channel of user setting when camera powers up by UserSetDefault Integer value and string value of Enumeration are as follows Integer String Description 0 Default Initial factory setting 1 15 UserSet1 15 Memory channel 1 to 15 for user setting GenICam node handle CAM_NODE_HANDLE hSelector NULL Retrieve GenICam node Nd_GetNo...

Page 146: ...ad Write 9 to Value field of UserSetCommand register to execute UserSetSave Write 120 to Value field of UserSetCommand register to execute UserSetQuickSave After execution of UserSetSave wait until UserSetCommand is Done 0 uint32_t dat 1 Select a channel of user setting by UserSetSelector dat 1 UserSet1 Cam_WriteReg s_hCam 0x20807C 1 dat 2 Execute UserSetSave dat 9 UserSetSave Cam_WriteReg s_hCam ...

Page 147: ...ing are as following chart A B C D E A B C Overlap Trigger Reception A B C 1 6 7 6 7 6 7 1 1 4 5 4 5 4 5 3 3 3 FrameTriggerWait will be activated before approx Sensor Read Out End Exposure Time D E D E 6 7 1 4 5 4 3 2 1 6 7 This trigger is ignored Overlap Trigger Rejection Event Name FrameTriggerWait Low Active EXT_TRIG Falling edge Exposure Sensor Read Out Bus Transfer Timer0Active Low Active 8 9...

Page 148: ...ns the timestamp at the time of Event EventTimer0Start 0xA000 EventTimer0StartTimestamp 8 Returns the timestamp at the time of Event EventTimer0End 0xA100 EventTimer0EndTimestamp 8 Returns the timestamp at the time of Event IIDC2 Register Register Field Address Length Byte bit Access Description EventNotificationOfFrame Implemented 0x21F220 31 R Returns the state whether the function is implemente...

Page 149: ...ure Evt_ReleaseRequest Releases EventRequest structure Evt_EnqueueRequest Puts specified EventRequest into the EventWaitQueue Evt_DequeueRequest Retrieves an EventRequest structure from the EventCompleteQueue Evt_FlushWaitQueue Stops all CameraEvent receiving operations and moves all EventRequest structures in the EventWaitQueue to the EventCompleteQueue Common functions Evt_Close Closes event int...

Page 150: ... 0x4004003C Length 0x04 Gain ChunkID 0x4004007C Length 0x04 LineStatusAll ChunkID 0x4009007C Length 0x04 SequentialShutterNumber ChunkID 0x80002000 Length 0x04 SequentialShutterElement ChunkID 0x80002001 Length 0x04 UserArea 256 Bytes ChunkID 0x80000000 Length 0x100 Length B W Model 0x000 0x004 0x008 0x010 0x014 0x018 0x01C 0x020 0x024 0x028 0x02C 0x030 0x034 0x038 0x060 0x160 0x164 Always output ...

Page 151: ...e included in the Chunk data ChunkExposureTime IFloat 4 R Returns the ExposureTime of the frame included in the Chunk data ChunkGain IFloat 4 R Returns the Gain of the frame included in the Chunk data ChunkWhiteBalanceR IFloat 4 R Returns the WhiteBalanceR of the frame included in the Chunk data ChunkWhiteBalanceB IFloat 4 R Returns the WhiteBalanceB of the frame included in the Chunk data ChunkLi...

Page 152: ...ted 0x21D0E0 31 R Returns the state whether the function is implemented BitWritable 0x21D0EC 4 R 0 ExposureTime 2 Gain Value 0x21D0F0 4 R W Sets the activation of chunk data ChunkEnableOfCat5 Implemented 0x21D100 31 R Returns the state whether the function is implemented BitWritable 0x21D10C 4 R 2 WhiteBalaceR 3 WhiteBalaceB Value 0x21D110 4 R W Sets the activation of chunk data ChunkEnableOfCat9 ...

Page 153: ...ontrol Chunk using GenICam API Chunk 1 Close image stream 2 Sets the activation of Chunk feature by ChunkModeActive 3 Sets the activation of Chunk data by ChunkSelector and ChunkEnable Most of the Chunk data has been fixed to output 4 Sets the user string to ChunkUserAreaTable optional 5 Open image stream 6 Capture image stream TeliCamAPI provides streaming functions including command handling and...

Page 154: ...etBoolValue s_hCam hEnable true Nd_SetEnumStrValue s_hCam hSelector UserArea Nd_SetBoolValue s_hCam hEnable true 4 Set the user string Nd_SetStrValue s_hCam hUserAreaTable Test 5 6 Open and capture image Strm_ReadCurrentImage hStrm pvPayloadBuf uiPyldSize sImageInfo 7 1 Attach Buffer Chunk_AttachBuffer s_hStrm pvPayloadBuf PyldSize 7 2 Get FrameID of Chunk data int64_t fid 0 Nd_GetIntValue s_hCam ...

Page 155: ...refer to Camera streaming functions in TeliCamAPI Library manual and GrabStreamSimple sample code in your TeliCamSDK install folder 7 Extract Chunk data using GenICam API 2 Activate ChunkModeActive int32_t active 1 Cam_WriteReg s_hCam 0x21D030 1 active 3 Enable Chunk int32_t cat4 5 Cam_WriteReg s_hCam 0x21D0F0 1 cat4 5 6 Open and capture image Strm_ReadCurrentImage hStrm pvPayloadBuf uiPyldSize sI...

Page 156: ...evitable Exposure Camera Application UserSetSave 1 UserSetSave 2 UserSetSave 3 Camera Setting Software Trigger UserSet 1 700ms USB Bus Frame 1 Frame 2 Frame 3 Overhead Tact Time UserSetLoad 1 Software Trigger UserSetLoad 2 Software Trigger UserSetLoad 3 Apply 1 Apply 2 Apply 3 UserSet have to be loded after Completion of Image Reception Camera Setting Camera Setting UserSet 2 UserSet 3 Serial Flas...

Page 157: ...tionFrameCount register Bulk function sets limits to the number of frames to exposure with TriggerAdditionalParameter register MultiFrame function in Normal Shutter mode TriggerMode Off Camera transfers AcquisitionFrameCount frame s VD Exposure AcquisitionMode MultiFrame AcquisitionFrameCount 3 TriggerMode Off Acquisition Command AcquisitionFrameRate Start Frame 1 Frame 2 Frame 3 Stop Start Frame ...

Page 158: ...ops AcquisitionFrameCount This exposure is discarded Frame 1 Exposure time is determined by ExposureTime setting in TriggerSequence0 Exposure time is determined by the pulse width of the trigger signal in TriggerSequence1 Exposure overlaps sensor readout Bulk function TriggerMode On TriggerSequence 6 Camera transfers TriggerAdditionalParameter frame s by a single trigger Trigger Exposure Acquisiti...

Page 159: ...rigger Exposure AcquisitionMode MultiFrame AcquisitionFrameCount 2 TriggerMode On TriggerSequence 6 TriggerAdditionalParameter 3 Acquisition Command Start Frame 1 Frame 2 Frame 3 The trigger can be input in arbitrary timing VD AcquisitionFrameRate Stop Start Frame 1 Counter is reset USB Streaming Frame 1 Frame 1 Exposure time is determined by ExposureTime setting TriggerAdditionalParameter Acquisi...

Page 160: ...ox and the alteration 4 Using the accessories not included with the product or our non designated optional articles 5 Damages caused during the transportation or deficiency of the handling such as drop or fall of the products after the products having been transferred to customers leaving the products to corrosive environment such as sunlight fire sand soil heat moisture or an inappropriate storin...

Page 161: ...d products Please keep record before you return the product 3 As the data saved in the camera will not be kept after the repair please take out data before return 4 We are unable to accept the cancellation after the repair request by the customer s reason 5 About the repair product shipping expenses please bear the charges when you return the product to us We bear the charges to you from us only f...

Page 162: ...ns of this product Check Tried Not Tried Please confirm that specifications of this product conform to usage environment refering to following URL http www toshiba teli co jp en index htm Please check our website for the latest information 4 Failure situation Model name Serial No Your dealer Purchase date Failure condition 5 From when Unknown From the beginning After a while After environment was ...

Search results

Summary of Contents for BG Series

Reviews:

Related manuals for BG Series

Brands by name

Popular brands

Toshiba teli BG Series, Instruction Manual

Search results

Summary of Contents for BG Series

Reviews:

Related manuals for BG Series

Brands by name

Popular brands