Toshiba teli BG Series Instruction Manual

Cmos camera
Hide thumbs Also See for BG Series:

Advertisement

Quick Links

BG Series
CMOS Camera
Instruction Manual
Model
Mono Camera
Color Camera
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 to,
whenever you need it.
Information contained in this document is subject to change without prior notice.
Standard name might be trade mark of each company.
Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved.
: BG302LMG / BG505LMG
: BG302LMCG / BG302LMCF / BG505LMCG / BG505LMCF
http://www.toshiba-teli.co.jp/en/index.htm
D4259344C

Advertisement

Table of Contents
loading

Summary of Contents for Toshiba teli BG Series

  • Page 1 After reading, keep this instruction manual handy so that you can refer to, whenever you need it. Information contained in this document is subject to change without prior notice. Standard name might be trade mark of each company. D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 2: Table Of Contents

    DigitalIOControl ........................92 AntiGlitch / AntiChattering ...................... 102 TimerControl ........................... 105 Gain ............................109 BlackLevel..........................112 Gamma ........................... 114 Sharpness ..........................116 BalanceRatio .......................... 118 ALCControl ..........................123 1 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 3 Chunk ............................149 Appendix ............................155 UserSetSave and UserSetQuickSave difference ..............155 MultiFrame and Bulk function difference ................156 Warranty rules ..........................159 Repair ............................. 160 2 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 4: Safety Precautions

    The content of prohibition is shown by a picture or words beside the symbol. This sign indicates MANDATORY ACTION (You are required to do). MANDATORY The content of action is shown by a picture or words beside the symbol. 3 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 5: General Handing

     Do not be handled roughly, damaged, fabricated, bent forcefully, pulled, twisted, bundled, placed under heavy objects or heated the power cable and the connection cable. Avoid Otherwise, fire or electric shock may result. 4 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 6 (every approx five years). Accumulation of dust inside the equipment may result in fire or electric shock. For inspection and cleaning costs, contact your sales representative. Instruction 5 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 7: Cases For Indemnity (Limited Warranty)

    ● The item that is not described in specifications of this product is out of the guarantee. ● The case of damages or losses which are caused by incorrect connection of the cable is out of the guarantee. 6 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 8: Restriction For Use

    (*2): Equipment relating to maintenance of public services/functions involving factors of safety refers to. - Traffic control systems for air transportation, railways, roads, or marine transportation - Equipment for nuclear power generation - Equipment related to the above 7 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 9: Notes On Using This Product

    C-mount lens 10mm or less ● Mounting to pedestal When mounting this product to a pedestal, make sure carefully that lens doesn’t touch with the pedestal. 8 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 10 Never use alcohol, benzene, thinner, or other chemicals because such chemicals may damage or discolor the paint and indications. If the image pickup surface becomes dusty, contaminated, or scratched, consult your sales representative. 9 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 11 Operation of this equipment in a residential area is likely to cause harmful interference in which case the user will be require to correct the interference at his own expense. 10 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 12 The brightness of the upper part of the screen may be different from that of the lower part. Note that this is a characteristic of a CMOS image sensor and is not a fault. 11 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 13 This information is applicable for People's Republic of China only. リサイクルに関する情報(包装物) 有关再利用的信息(包装物) Information on recycling of wrapping composition 内部緩衝材料・袋 内部缓冲材料·袋 箱/箱子/Box Internal buffer materials・Bag ペーパーボード 纸板 Paper board 12 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 14: Installation

    / 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 Please refer to the TeliCamSDK startup guide, about Operation environment, Installation, and Setup. 13 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 15: Specifications

    Specifications Overview This BG series is an integrated-(one-body)-type camera that adopts a global shutter CMOS sensor. BG302LM (3M 1/1.8 type, monochrome), BG505LM (5M 2/3 type, monochrome). Suffix [G] is attached to the monochrome models, suffix [CG] or [CF] are attached to the color models.
  • Page 16 * Suffix [F] is not shown in the common part of specifications. ● Compact and lightweight This camera is compact and lightweight; it is easy to integrate into industrial equipment. ● EU RoHS & Chinese ROHS 15 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 17: Configuration

    PoE. Please use 1000BASE-T equipments, supporting Jumbo Frame is recommended. *1: Optional part. Contact your dealer / distributor for details of option units. *2: Commercial items. 16 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 18: Connection

    Please confirm it before use. Lost packets may occur by an electrical characteristic of the transmission line of using Ethernet devices (LAN cable, Network Interface Card, Switching HUB). 17 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 19: Connector Pin Assignment

    Pin No. Signal Function +12V Power Line 0 External Trigger Input GPIO_0 Output / External Trigger Input Line 1 Line 2 GPIO_1 Output I/O GND I/O_Ground Ground 18 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 20 - 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. 19 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 21: Outline Drawing

    Outline Drawing 20 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 22: General Specifications

    Approximately 60g Lens mount C mount Flange back 17.526mm Camera body grounding insulation status Non-conductive between circuit GND and camera body (*1) at all pixels readout 21 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 23 Approximately 60g Lens mount C mount Flange back 17.526mm Camera body grounding insulation status Non-conductive between circuit GND and camera body (*1) at all pixels readout 22 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 24 - As for the C-mount lens used combining this camera, the projection distance from bottom of the screw should use 10mm or less. Bottom of C-mount lens the screw 10mm or less 23 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 25: I/O Specification

    Random Trigger Shutter operation may not satisfy timing specification or camera may not receive External trigger signal. Polarity High active / Low active (factory setting: Low active) 24 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 26 - Line0 and Line1 have a different input level. Please use input level within the voltage described in this specification. may not receive EXT_TRIG signal. Please confirm it before use. 25 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 27 In using shield cable, the shield wire shall be connected to your frame ground or Camera GND (Pin 6). - Please confirm the EMC adaptability in whole of your system. 26 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 28 <0.02 <0.02 * Measured with 2.2k ohm pulled up register on LINE0. * Toff and Ton are typical value. These values vary depending on operating environment. 27 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 29 +12V +24V * Measured with 2.2k ohm pulled up register on LINE2. * Toff and Ton are typical value. These values are changed in operating environment. 28 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 30: Timing Specification

    * Depending on Frame Rate and PacketSize setting, T might be inserted automatically despite DLY2 SCPD=0. * Timing chart is at the time of 1000BASE-T connection. 29 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 31 40.0 54.6 : Delay time is the same as AntiGlitch setting value. DLY3 AntiChattering does not effect delay time. * T2 and T3 are typical value. 30 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 32 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. 31 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 33: Typical Spectral Response

    Typical Spectral Response * The lens characteristics and light source characteristics is not reflected in table. < BG302LMG / BG505LMG > 32 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 34 < BG302MCG / BG505MCG > < BG302MCF / BG505MCF > 33 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 35: Operating Ambient Conditions

    << DC operation>> - DC Cable CPCBG-03 - LAN Cable LD-TWST/BM30 (ELECOM CO., LTD) Please confirm the EMC adaptability when it combines with parts other than them. 34 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 36: Functions

    Event packet control ChunkDataControl ChunkDataControl Chunk data control * BG302LM and BG505LM series have different register map from other BG series. Please refer to [BG Series Register Map]. 35 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved.
  • Page 37 ○ SequentialShutterControl ○ ○ ○ ○ DPCControl ○ ○ ○ ○ UserSetControl ○ ○ ○ ○ EventControl ○ ○ ○ ○ Chunk ○ ○ ○ ○ 36 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 38: Transportlayercontrol

    Reports the default gateway IP address to be used on the given logical link. GevFirstURL 0x0200 IString Indicates the first URL to the GenICam XML device description file. 37 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 39 Selects the stream channel to control. GevSCPDirection 0x0D00 IEnumeration Reports the direction of the stream channel. GevSCPInterfaceIndex 0x0D00 [12:15] IInteger Index of the logical link to use. 38 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 40 Reports the current IP configuration status. ● Note CurrentSpeed register could be used for showing the warning message on your application when camera is connected to 100Base-T. 39 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 41: Devicecontrol

    Resets the device. ● Note DeviceReset Camera initiates link negotiation and IP re-configuration by DeviceReset command. - The application is required to close and re-open the camera. 40 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 42: Imageformatcontrol

    [31] Returns the state whether the function is implemented. ListOfElements 0x20202C [0] : Format0 [1] : Format1 [2] : Format2 Value 0x20203C Selects an image format. 41 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 43 Select an image format by ‘ImageFormatSelector’. Integer value and string value of Enumeration are as follows. Integer String 0 (*) Format0 Format1 Format2 * initial factory setting 42 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 44 Please refer to [Camera functions] in [TeliCamAPI Library manual] for more detail. ● Note - Changing ‘ImageFormatSelector’ register value is invalid during image stream data output. 43 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 45: Scalable

    The window size is equal or less than maximum image size. ( X , Y )=( 4 * i , 2 * j ) ⇒ A + 4 * m Scalable 44 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 46 Sets width (in pixels) of the image data. OffsetY 0x20209C Sets vertical offset (in pixels) from the origin to the region of interest Height 0x2020A0 Sets Height (in pixels) of the image data. 45 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 47 Nd_GetNode(s_hCam, “Width”, &hWidth); Nd_GetNode(s_hCam, “Height”, &hHeight); Nd_GetNode(s_hCam, “OffsetX”, &hOffsetX); Nd_GetNode(s_hCam, “OffsetY”, &hOffsetY); // Set ROI Nd_SetIntValue(s_hCam, hWidth, ROI[1]); Nd_SetIntValue(s_hCam, hOffsetX, ROI[0]); Nd_SetIntValue(s_hCam, hHeight, ROI[3]); Nd_SetIntValue(s_hCam, hOffsetY, ROI[2]); 46 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 48 Height/OffsetY unit size Minimum unit size 64 x 64 64 x 64 Maximum unit size (*) 2048 x 1536 2448 x 2048 * initial factory setting 47 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 49: Binning

    This increases the sensitivity of the image. It’s alike scalable, the frame rate can be faster and USB bandwidth occupation decrease. 2448 2048 All pixel readout 1224 1024 Binning Binning operation (e.g. 5M pixel, 2x2 binning) 48 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 50 Horizontal Mono12 Vertical Vertical ・BG302LMCG Bayer8 / Horizontal Bayer10 / Horizontal Mono8 Bayer12 Vertical Vertical ・BG505LMCG Bayer8 / Horizontal Bayer10 / Horizontal Mono8 Bayer12 Vertical Vertical 49 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 51 Get minimum and maximum value GetCamBinningVertical Get current BinningVertical value SetCamBinningVertical Set new BinningVertical value Please refer to [Controlling camera feature functions] in [TeliCamAPI Library manual] for more detail. 50 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 52 - Binning is disabled when the camera is running in Decimation mode. - Changing ‘BinningHorizontal’, ‘BinningVertical’ register value is invalid during image stream data output. - Binning Horizontal / Vertical = 3 is not available. 51 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 53: Decimation

    Decimation feature can make frame rate faster, and decrease interface bandwidth occupation. 2448 2048 All pixel readout 1224 1024 Decimation Decimation operation (e.g. 5M pixel, 2x2 decimation) 52 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 54 Horizontal Mono12 Vertical Vertical ・BG302LMCG Bayer8 / Horizontal Bayer10 / Horizontal Mono8 Bayer12 Vertical Vertical ・BG505LMCG Bayer8 / Horizontal Bayer10 / Horizontal Mono8 Bayer12 Vertical Vertical 53 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 55 Get minimum and maximum value GetCamDecimationVertical Get current DecimationVertical value SetCamDecimationVertical Set new DecimationVertical value Please refer to [Controlling camera feature functions] in [TeliCamAPI Library manual] for more detail. 54 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 56 - Decimation is disabled when the camera is running in Binning mode. - Changing ‘DecimationHorizontal’, ‘DecimationVertical’ register value is invalid during image stream data output. - Decimation Horizontal / Vertical = 3 is not available. 55 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 57: Reverse

    [1] : On ReverseY Implemented 0x2021C0 [31] Returns the state whether the function is implemented. Value 0x2021D0 Sets the Reverse Vertical. [0] : Off [1] : On 56 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 58 // Set Reverse (flip horizontal and vertical direction) Nd_SetBoolValue(s_hCam, hReverseX, true); Nd_SetBoolValue(s_hCam, hReverseY, true); Please refer to [INode functions], [IBoolean node functions] in [TeliCamAPI Library manual] for more detail. 57 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 59 Please refer to [Camera functions] in [TeliCamAPI Library manual] for more detail. ● Note - Changing ‘ReverseX’, ‘ReverseY’ register value is invalid during image stream data output. 58 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 60: Pixelformat

    0x20240C [1] : Mono8 ~0x202418 [3] : Mono10 [5] : Mono12 [11] : BayerBG8 [15] : BayerBG10 [19] : BayerBG12 Value 0x20241C Selects a pixel format 59 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 61 To determine PixelFormat combination of ‘PixelCoding‘ and ‘PixelSize‘ register. 1. Select a pixel coding. (‘PixelCoding’). Integer value and string value of Enumeration are as follows. Integer String Mono BayerBG 60 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 62 Nd_GetNode(s_hCam, "PixelFormat", &hFormat); // 1.Select a pixel format. Nd_SetEnumStrValue(s_hCam, hFormat, "Mono10"); Please refer to [INode functions], [IEnumeration node functions] in [TeliCamAPI Library manual] for more detail. 61 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 63 Please refer to [Camera functions] in [TeliCamAPI Library manual] for more detail. ● Note - Changing ‘PixelCoding’, ‘PixelSize’ and ‘PixelFormat’ register value is invalid during image stream data output. 62 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 64: 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) 63 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 65 API name Description GetCamTestPattern Get current TestPattern value SetCamTestPattern Set new TestPattern value Please refer to [Controlling camera feature functions] in [TeliCamAPI Library manual] for more detail. 64 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 66 = 5; // Horizontal Ramp // 1.Select a test pattern. Cam_WriteReg(s_hCam, 0x21F13C, 1, &dat); Please refer to [Camera functions] in [TeliCamAPI Library manual] for more detail. 65 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 67: Bayerprocessingmode

    ListOfElements 0x21F42C Returns the presence of the pixel endian. ~0x21F438 [0] : Raw [8] : Partial [16] : Full Value 0x21F43C Selects a Bayer Processing Mode. 66 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 68 Cam_WriteReg(s_hCam, 0x21F43C, 1, &uiMode); Please refer to [Camera functions] in [TeliCamAPI Library manual] for more detail. ● Note Changing ‘BayerProcessingMode’ register value is invalid during image stream data output. 67 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 69: Acquisitioncontrol

    Selects an AcquisitionFrameRate setting priority. AcquisitionFrameRate IFloat Sets frame rate of image stream. AcquisitionFrameIntervalControl IEnumeration Selects an AcquisitionFrameInterval setting priority. AcquisitionFrameInterval IFloat Sets frame interval of image stream. 68 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 70 0x2030D0 0x2030D4 Returns the minimum value of FrameInterval. 0x2030D8 Returns the maximum value of FrameInterval. Value 0x2030DC Sets frame interval of image stream in raw value. 69 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 71 TeliCamAPI provides streaming functions including command handling and buffer handling to capture image stream simply. Please refer to [Camera streaming functions] in [TeliCamAPI Library manual] and [GrabStreamSimple] sample code in your TeliCamSDK install folder. 70 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 72 Cam_WriteReg Write register value 1. Set the number of frames to transfer in MultiFrame/ImageBuffer mode. (optional) Write to ‘Value’ field of ‘AcquisitionFrameCount’ register to control AcquisitionFrameCount. 71 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 73 Depends on your PC or interface card configurations, images may not be captured normally (e.g. frame drops may occur). In this case, change to frame rate setting lower. 72 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 74: Imagebuffer

    Returns the minimum number of frames in Image Buffer mode. 0x203098 Returns the maximum number of frames in Image Buffer mode. Value 0x20309C Returns the number of frames in Image Buffer mode. 73 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 75 3. Read the number of frames in Image Buffer by ‘ImageBufferFrameCount’. 4. Read Image from Image Buffer by ‘ImageBufferRead’. 5. Receive Image from Image Buffer. 6. Stop and Close image stream. 74 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 76 = s_uiImgBufSize; WaitForSingleObject(s_hStrmEvt, 1000); Strm_ReadCurrentImage(s_hStrm, s_pucImgBuf, &uiSize, NULL); // 6.Stop and Close image stream. // 6.1.Stream Stop Strm_Stop(s_hStrm); // 6.2.Close Stream Strm_Close(s_hStrm); CloseHandle(s_hStrmEvt); VirtualFree(s_pucImgBuf, 0, MEM_RELEASE); 75 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 77 Write [10] to ‘Value’ field of ‘AcquisitionCommand’ register to execute ImageBufferRead. Please refer to AcquisitionCommand in AcquisitionControl section as well. 5. Receive Image from Image Buffer. 6. Stop and Close image stream. 76 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 78 - The number of frames to be transferred by ‘ImageBufferRead’ command is determined by ‘AcquisitionFrameCount’. - Changing ‘ImageBufferMode’ register value is invalid during image stream data output. 77 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 79: Triggercontrol

    Random Trigger Shutter mode Trigger pulse width control -Edge mode:TriggerSequence0 SoftwareTrigger -Bulk mode:TriggerSequence6 ‘ExposureTime’ register control * The camera operation not mentioned above is not supported. 78 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 80 And you can add delay time from trigger edge to exposure start by register setting. Trigger TriggerDelay Exposure Image Streaming Image on Interface Bus Trigger Delay For details of Random Trigger Shutter operation, please refer to ‘Timing’ section in ‘Specification’. 79 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 81 Returns the minimum value of the number of images in Bulk mode. 0x207098 Returns the maximum value of the number of images in Bulk mode. Value 0x20709C Sets the number of frames to exposure in Bulk mode. 80 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 82 Get current TriggerAdditionalParameter value SetCamTriggerAdditionalParameter Set new TriggerAdditionalParameter value GetCamTriggerDelayMinMax Get minimum and maximum value GetCamTriggerDelay Get current TriggerDelay value SetCamTriggerDelay Set new TriggerDelay value ExecuteCamSoftwareTrigger Execute Software Trigger 81 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 83 8. Execute software trigger. Execute Software Trigger in SoftwareTrigger mode with ‘ExecuteCamSoftwareTrigger’ function. Please refer to [Controlling camera feature functions] in [TeliCamAPI Library manual] for more detail. 82 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 84 [GrabStreamSimple] sample code in your TeliCamSDK install folder. 8. Execute software trigger in SoftwareTrigger mode by ‘TriggerSoftware’. 9. Receive Image 10. Stop and Close image stream. 83 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 85 WaitForSingleObject(s_hStrmEvt, 1000); Strm_ReadCurrentImage(s_hStrm, s_pucImgBuf, &uiSize, &sImageInfo); // 10.Stop and Close image stream. // 10.1.Stream Stop Strm_Stop(s_hStrm); // 10.2.Close Stream Strm_Close(s_hStrm); CloseHandle(s_hStrmEvt); VirtualFree(s_pucImgBuf, 0, MEM_RELEASE); 84 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 86 [GrabStreamSimple] sample code in your TeliCamSDK install folder. 8. Execute software trigger. Write [8] to ‘Value’ field of ‘SoftwareTrigger’ register to control SoftwareTrigger. 9. Receive Image 10. Stop and Close image stream. 85 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 87 // 10.Stop and Close image stream. // 10.1.Stream Stop Strm_Stop(s_hStrm); // 10.2.Close Stream Strm_Close(s_hStrm); CloseHandle(s_hStrmEvt); VirtualFree(s_pucImgBuf, 0, MEM_RELEASE); Please refer to [Camera functions] in [TeliCamAPI Library manual] for more detail. 86 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 88 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...
  • Page 89: Exposuretime

    0x204030 0x204034 Returns the minimum value of ExposureTime Value register. 0x204038 Returns the maximum value of ExposureTime Value register. Value 0x20403C Sets ExposureTime value. (Raw value) 88 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 90 CAM_NODE_HANDLE hNode = NULL; // ExposureTime = 1000us float64_t dExposureTime = 1000.0; // Retrieve GenICam node. Nd_GetNode(s_hCam, "ExposureTime", &hNode); // Set ExposureTime Value Nd_SetFloatValue(s_hCam, hNode, dExposureTime); 89 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 91 = 2; // Set ExposureAuto = "Continuous " Cam_WriteReg(s_hCam, 0x204028, 1, &uiExposureAuto); Please refer to [Camera functions] in [TeliCamAPI Library manual] for more detail. 90 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 92 45000.00 [us] Formula Absolute Value [us] = Raw Value / 25 ● Note - In ExposureAuto mode, current exposure time will be reflected to ExposureTime value register. 91 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 93: Digitaliocontrol

    Internal Trigger LineSource Timer0Active TimerControl UserOutput Line1 (GPIO_Input/Output) ExposureActive FrameTransfer FrameActive LineModeAll[1] FrameTriggerWait UserOutputValueAll[1] UserOutput UserOutputValueAll[2] Line2 (GPIO_Output) LineStatusAll[2] LineStatusAll[1] LineStatusAll[0] LineModeAll GPIO internal circuit diagram 92 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 94 IInteger Sets the user output value of each Line. LineSelector IEnumeration Selects the Line of I/O connector. LineSource IEnumeration Selects the source of the output signal. 93 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 95 [32] : UserOutput [64] : Timer0Active [99] : AcquisitionActive [106] : FrameTriggerWait [107] : FrameActive [115] : FrameTransferActive [123] : ExposureActive Value 0x2090DC Selects the source signal. 94 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 96 SetCamUserOutputValueAll Set new UserOutput GetCamLineSource Get current LineSource SetCamLineSource Set new LineSource Please refer to [Controlling camera feature functions] in [TeliCamAPI Library manual] for more detail. 95 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 97 [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 96 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 98 [1] [0] [0] [on] [off] [off] [1] [0] [1] [out [off] [on] [1] [1] [0] [on] [on] [off] [1] [1] [1] [on] [on] [on] * initial factory setting 97 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 99 [low] [high] [high] [1] [0] [0] [high] [low] [low] [1] [0] [1] [high] [low] [high] [1] [1] [0] [high] [high] [low] [1] [1] [1] [high] [high] [high] 98 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 100 [high] [high]  LineSelector Selects the I/O line to output by ‘LineSelector’. Integer value and string value of Enumeration are as follows. Integer String Line1 Line2 99 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 101 // Line2 = FrameTransferActive Nd_SetEnumStrValue(s_hCam, hSelector, "Line2"); Nd_SetEnumStrValue(s_hCam, hSource, "FrameTransferActive"); Please refer to [INode functions], [IInteger node functions] and [IEnumeration node functions] in [TeliCamAPI Library manual] for more detail. 100 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 102 - Line1 is bi-directional. The default direction is input. - Line2 is dedicated output. - For [Timer0Active] signal, please refer to [TimerControl] Section for more detail. 101 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 103: Antiglitch / Antichattering

    AntiGlitch Circuit Edge Edge Edge Edge Output Invalid Edge AntiChattering Insensible Insensible Value Time Time High AntiChattering Circuit Valid Valid Output Signal Signal AntiGlitch and AntiChattering 102 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 104 Nd_GetNode(s_hCam, “AntiChattering”, &hChattering); // Set Value Nd_SetFloatValue(s_hCam, hGlitch, dGlitch); Nd_SetFloatValue(s_hCam, hChattering, dChattering); Please refer to [INode functions], [IFloat node functions] in [TeliCamAPI Library manual] for more detail. 103 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 105 Initial Value Raw Value Absolute Value 0.05 [us] 1.96 [us] Formula Absolute Value [us] = Raw Value / 20 Absolute Value [us] = Raw Value / 25 104 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 106: Timercontrol

    TimerDelay IFloat Sets the delay of Timer0Active signal. TimerDuration IFloat Sets the duration of Timer0Active signal. TimerTriggerSource IEnumeration Selects the source of Timer0Active pulse to start. 105 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 107 Set new TimerDuration value GetCamTimerTriggerSource Get current TimerTriggerSource SetCamTimerTriggerSource Set new TimerTriggerSource Please refer to [Controlling camera feature functions] in [TeliCamAPI Library manual] for more detail. 106 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 108 // 3.Selects the source of Timer0Active pulse to start. Nd_SetEnumStrValue(s_hCam, hSource, "ExposureStart"); Please refer to [INode functions], [IFloat node functions] and [IEnumeration node functions] in [TeliCamAPI Library manual] for more detail. 107 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 109 - FrameTrigger is available in both Hardware Trigger and Software Trigger mode, and not to be responded to FrameTriggerError. - ExposureStart is available in both Hardware Trigger and Software Trigger mode, and not to be responded to FrameTriggerError. Timer0Active pulse delays TiggerDelay+TimerDelay[us]. 108 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 110: Gain

    Absolute Value [dB] = Raw * (Mult / Div) 0x204070 0x204074 Returns the minimum value of Gain Value register. 0x204078 Returns the maximum value of Gain Value register. Value 0x20407C Gain value. (Raw value) 109 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 111 Use ‘IEnumertion’ interface to control GainAuto. Integer value and string value of Enumeration are as follows. Integer String Description Operates Manual mode. Auto Operates Auto mode. 110 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 112 0.00 [dB] Formula Absolute Value [dB] = Raw Value / 10 ● Note - In GainAuto mode, current Gain will be reflected to Gain value register. 111 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 113: Blacklevel

    Get minimum and maximum value GetCamBlackLevel Get current BlackLevel value SetCamBlackLevel Set new BlackLevel value Please refer to [Controlling camera feature functions] in [TeliCamAPI Library manual] for more detail. 112 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 114  Minimum / Maximum Value BlackLevel Raw Value Absolute (Float) Value Minimum -256 -25.00[%] Maximum +25.00[%] Initial Value 0.00[%] Formula Absolute Value [%] = Raw Value * 100 / 1024 113 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 115: Gamma

    Get minimum and maximum value GetCamGamma Get current Gamma value SetCamGamma Set new Gamma value Please refer to [Controlling camera feature functions] in [TeliCamAPI Library manual] for more detail. 114 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 116  Minimum / Maximum Value Gamma Raw Value Absolute (Float) Value Minimum 0.45 Maximum 1.00 Initial Value 1.00 Formula Absolute Value = Raw Value / 100 115 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 117: Sharpness

    Get minimum and maximum value GetCamSharpness Get current Sharpness value SetCamSharpness Set new Sharpness value Please refer to [Controlling camera feature functions] in [TeliCamAPI Library manual] for more detail. 116 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 118 Please refer to [Camera functions] in [TeliCamAPI Library manual] for more detail.  Minimum / Maximum Value Sharpness Raw Value Absolute (Integer) Value Minimum Maximum Initial Value Formula Absolute Value = Raw Value 117 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 119: Balanceratio

    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. BalanceRatio BalanceRatio Input Signal Level Output Signal Level Fig. BalanceRatio 118 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 120 0x205094 Returns the minimum value of WhiteBalanceB Value register. 0x205098 Returns the maximum value of WhiteBalanceB Value register. Value 0x20509C White balance Blue gain (Raw value) 119 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 121 // white balance R gain = x 1.0 float64_t dBalanceRatioR = 1.0; // Retrieve GenICam node. Nd_GetNode(s_hCam, “BalanceRatio”, &hNode); // Set Gain Value Nd_SetFloatValue(s_hCam, hNode, dBalanceRatioR); 120 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 122 // Set BalanceWhiteAuto = “Once” Cam_WriteReg(s_hCam, 0x205068, 1, &uiBalanceWhiteAuto); // Cam_WriteReg(s_hCam, 0x205088, 1, &uiBalanceWhiteAuto); // either will do Please refer to [Camera functions] in [TeliCamAPI Library manual] for more detail. 121 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 123 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 your environment. 122 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 124: Alccontrol

    ALCExposureValue defines a correction value for a convergence value. Final convergence value is determined by the following formula. ALCExposureValue Final convergence value = 84( Reference Luminance) × 2 123 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 125 This function is available only in Color models. ALCThrottle setting value Minimum 1.00 [%] Maximum 100.00 [%] * initial factory setting = 79.99 [%] 124 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 126 Returns the minimum value of ALC Exposure Time Value. 0x2042B8 Returns the maximum value of ALC Exposure Time Value. Value 0x2042BC Sets ALC Exposure Time Value. (Raw value) 125 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 127 0x21F654 Returns the minimum value of ALC Throttle Value. 0x21F658 Returns the maximum value of ALC Throttle Value. Value 0x21F65C Sets ALC Throttle Value. (Raw value) 126 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 128 // Set ALCGainMax Nd_SetFloatValue(s_hCam, hGainMax, dGainMax); // Set ALCThrottle Nd_SetFloatValue(s_hCam, hThrottle, dThrottle); Please refer to [INode functions] and [IFloat node functions] in [TeliCamAPI Library manual] for more detail. 127 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 129 // Set ALCGainMax Cam_WriteReg(s_hCam, 0x2042FC, 1, &uiGainMaxRaw); // Set ALCThrottle Cam_WriteReg(s_hCam, 0x21F65C, 1, &uiThrottleRaw); Please refer to [Camera functions] in [TeliCamAPI Library manual] for more detail. 128 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 130 79.99 [%] Formula Absolute Value [EV] = Raw Value / 10 ● Note - The camera operation is not supported when the Random Trigger Shutter mode. 129 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 131: Lutcontrol

    Sets the output level of LUT. Value[2] 0x300008 Sets the output level of LUT. … … … … … Value[4095] 0x303FFC Sets the output level of LUT. 130 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 132 // 3.Set the activation of LUT function by 'LUTEnable' Nd_SetBoolValue(s_hCam, hEnable, true); Please refer to [INode functions], [IInteger node functions] and [IBoolean node functions] in [TeliCamAPI Library manual] for more detail. 131 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 133 Cam_WriteReg(s_hCam, 0x20603C, 1, &dat); Please refer to [Camera functions] in [TeliCamAPI Library manual] for more detail.  Minimum / Maximum Value LUTIndex/LUTValue Value Minimum Maximum 4095 132 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 134: Sequentialshuttercontrol

    Sets the UserSet number to register to the second sequence. … … … … … Value[15] 0x500078 Sets the UserSet number to register to the 16 sequence. 133 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 135 To start and stop capturing image is the same way as AcquisitionControl. Please refer to [Camera streaming functions] in [TeliCamAPI Library manual] and [GrabStreamSimple] sample code in your TeliCamSDK install folder. 134 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 136 3. Set the number of Index to repeat the sequence. Write to ‘Value’ field of ’SequentialShutterTerminateAt’. 4. Set the activation of SequentialShutter function. Write to ‘Value’ field of ’SequentialShutterEnable’ register to activate SequentialShutter function. 135 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 137 Please refer to [Camera functions] in [TeliCamAPI Library manual] for more detail.  Minimum / Maximum Value SequentialShutterIndex setting value Minimum (*) Maximum * initial factory setting SequentialShutterEntry setting value Minimum (*) Maximum * initial factory setting 136 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 138 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 CounterAndTimerControl TimerDuration LUTControl LUTEnable TimerDelay 137 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 139: Dpccontrol

    Sets the second Y coordinate of defective pixel. … … … … … Value[255][0] 0x4007F8 Sets the 255th X coordinate of defective pixel. Value[255][1] 0x4007FC Sets the 255th Y coordinate of defective pixel. 138 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 140 // 3.Sets the activation of DPC function by 'DPCEnable'. 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. 139 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 141 Cam_WriteReg(s_hCam, 0x21F29C, 1, &dat); Please refer to [Camera functions] in [TeliCamAPI Library manual] for more detail.  Minimum / Maximum Value DPCNumber DPCIndex DPCEntryX DPCEntryY Minimum Maximum WidthMax-1 HeightMax-1 140 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 142: Usersetcontrol

    LineInverterAll DPCNumber(*) UserOutputValueAll DPCEntryX(*) LineSelector DPCEntryY(*) LineSource EventControl EventNotification (*) DPC and SequentialShutter entries are stored to a single channel. Entries are shared with all channels. 141 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 143 Returns the state whether the function is implemented. ListOfElements 0x21F2EC [0] : Default [1] : UserSet1 … [15] : UserSet15 Value 0x21F2FC Selects the number of UserSet when the camera starts up. 142 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 144 When execute ‘UserSetSave’ or ‘UserSetQuickSave’, the camera saves user setting to the channel selected in ‘UserSetSelector’ register. After execution of 'UserSetSave', wait until 'UserSetSave' completion by Nd_GetCmdIsDone. 143 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 145 = 1; // UserSet1 Nd_SetEnumIntValue(s_hCam, hSelector, dat); Please refer to [INode functions], [IEnumeration node functions] and [ICommand node functions] in [TeliCamAPI Library manual] for more detail. 144 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 146 // 1.Select a channel of user setting when camera powers up uint32_t dat = 1; // UserSet1 Cam_WriteReg(s_hCam, 0x2080BC, 1, &dat); Please refer to [Camera functions] in [TeliCamAPI Library manual] for more detail. 145 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 147: Eventcontrol

    : End of transferring streaming data. (6) ExposureStart : Start of Exposure. (7) ExposureEnd : End of Exposure. (8) Timer0Start : Start of Timer0. (9) Timer0End : End of Timer0. 146 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 148 0x21F3A0 [31] Sets the activation of event notification of exposure. ListOfElements 0x21F3AC [0] : Timer0End Value 0x21F3B0 Sets the activation of event notification of timer end. 147 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 149 TeliCamSDK install folder. GenICam function API Please use dedicated API to control Event features. Register access API Please use dedicated API to control Event features. 148 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 150: Chunk

    ChunkID = 0x80002001 +0x058 +0x070 Length = 0x04 +0x05C +0x074 +0x060 +0x078 UserArea (256 Bytes) ChunkID = 0x80000000 +0x160 +0x178 Length = 0x100 +0x164 +0x17C Chunk Data Structure 149 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 151 ChunkSequentialShutterNumber IInteger Returns the SequentialShutterNumber of the frame included in the Chunk data. ChunkSequentialShutterElement IInteger Returns the SequentialShutterElement of the frame included in the Chunk data. 150 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 152 Returns the length (in bytes) of ChunkUserArea Value. Value[0] 0x21D800 length Sets the ASCII string of ChunkUserArea. … … … Value[last] 0x21D800 Sets the ASCII string of ChunkUserArea. +NumberOf Elements 151 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 153 [GrabStreamSimple] sample code in your TeliCamSDK install folder. 7. Extract Chunk data using GenICam API. 7-1. Allocate memory by ‘Chunk_AttachedBuffer’ . 7-2. Read Chunk data. 152 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 154 [TeliCamAPI Library manual] for more detail. Register access API Control Chunk by accessing IIDC2 registers directly. API name Description Cam_ReadReg Read register value Cam_WriteReg Write register value 153 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 155 // 7-2.Get User Area data of Chunk data. char userarea[256]; uint32_t uiSize = 256; Nd_GetStrValue(s_hCam, hUserAreaTable, &userarea, &uiSize); Please refer to [Camera functions] in [TeliCamAPI Library manual] for more detail. 154 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 156: Appendix

    Save to Serial Flash if necessary. Quick - ImageSize Save Save - ExposureTime UserSet1 UserSet1 UserSet1 UserSet1 - Gain UserSet UserSet - ... Internal RAM FPGA Serial Flash 155 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 157: Multiframe And Bulk Function Difference

    Frame 3 Frame 4 Frame 1 This exposure is *Exposure overlaps sensor readout. discarded. Stream USB Streaming stops Frame 1 Frame 2 Frame 3 Frame 1 AcquisitionFrameCount 156 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 158 Frame 1 TriggerAdditionalParameter *Exposure overlaps sensor readout. *Exposure time is determined by ExposureTime setting. Stream USB Streaming stops Frame 1 Frame 2 Frame 3 Frame 1 157 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 159 This exposure is discarded. TriggerAdditionalParameter *Exposure overlaps sensor readout. *Exposure time is determined by ExposureTime setting. Stream USB Streaming stops Frame 1 Frame 2 Frame 1 AcquisitionFrameCount 158 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 160: Warranty Rules

    9. Forgery product, products which does not have proper serial number, products of which serial number is forged, damaged or deleted 10. All defects that happened after the expiration for a warranty term 159 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 161: Repair

    10. The immunity from responsibility of the product is applied in the repair completion products. * Please refer for the inquiry about the software to our homepage or sales personnel. 160 / 160 D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All Rights Reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 162 □ It certainly occurs. □ It sometimes occurs. □ It occurs, after time passes. ( □ Others ) <For dealer use> Reception date : Receipt No. : JOB No. : Check : D4259344C Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...

This manual is also suitable for:

Bg302lmgBg505lmgBg302lmcgBg302lmcfBg505lmcgBg505lmcf

Table of Contents