Toshiba teli BU1207MG Instruction Manual

Toshiba teli BU1207MG Instruction Manual

Cmos camera

Advertisement

Quick Links

BU series
CMOS Camera
Instruction Manual
Model
B/W Camera
: BU1207MG
Color Camera
: BU1207MCG / BU1207MCF
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 © 2020 Toshiba Teli Corporation, All rights reserved.
D4279014C
http://www.toshiba-teli.co.jp/en/index.htm

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the BU1207MG and is the answer not in the manual?

Questions and answers

Summary of Contents for Toshiba teli BU1207MG

  • 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. D4279014C Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 2: Table Of Contents

    SequentialShutterControl ......................150 Appendix ............................155 UserSetSave and UserSetQuickSave difference ............... 155 MultiFrame and Bulk function difference ..................157 Warranty rules ............................ 160 Repair ..............................161 D4279014C 1 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 3: 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. D4279014C 2 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 4: 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. D4279014C 3 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 5 (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 D4279014C 4 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 6: 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. D4279014C 5 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 7: 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 D4279014C 6 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 8: Notes On Using This Product

    9mm or less ● Mounting to pedestal When mounting this product to a pedestal, make sure carefully that lens doesn’t touch with the pedestal. D4279014C 7 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 9 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. D4279014C 8 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 10 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. D4279014C 9 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 11 This information is applicable for People's Republic of China only. リサイクルに関する情報(包装物) 有关再利用的信息(包装物) Information on recycling of wrapping composition 内部緩衝材料・袋 内部缓冲材料·袋 箱/箱子/Box Internal buffer materials・Bag ペーパーボード 纸板 Paper board D4279014C 10 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 12: Installation

    ● Toshiba Teli Corporation Top Page http://www.toshiba-teli.co.jp/en/ ● 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. D4279014C 11 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 13: Specifications

    BU1207M series is an integrated-(one-body)-type camera that adopts a global shutter CMOS sensor. These are BU1207MG (12M type1.1). Suffix [C] are attached to the color models. For video output and camera control, the USB 3.1 Gen1 interface standard is adopted for high transfer rate, and it is easy to integrate into industrial equipment.
  • Page 14 Suffix [G] is attached to the model name of built-in Glass. ● IR-cut filter Build-in IR-cut filter models are optional for color models. Suffix [F] is attached to the model name of built-in IR-cut filter model. D4279014C 13 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 15: Configuration

    *1: Optional part. Contact your sales representative for details of option units. *2: Commercial items. D4279014C 14 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 16: Connection

    Please confirm wires’ specifications before use them. Lost packets may occur by an electrical characteristic of the transmission line of USB3.0. (USB3.0 Interface Card, USB3.0 Cable, and USB3.0 HUB). D4279014C 15 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 17: Connector Pin Assignment

    Pin assignment ↑TOP *Above figure is connector view from insert side. Pin No. Signal Function Line2 GPIO Input / Output Line1 GPIO Output Ground Line0 GPIO Input D4279014C 16 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 18: Outline Drawing

    Outline Drawing D4279014C 17 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 19: General Specifications

    Mass Lens mount C-mount Flange back 17.526mm Camera body grounding: insulation status Conductive between circuit GND and camera body *1, *2 at the all pixel readout D4279014C 18 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 20 Mass Lens mount C-mount Flange back 17.526mm Camera body grounding: insulation status Conductive between circuit GND and camera body *1, *2 at the all pixel readout D4279014C 19 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 21 Depends on your PC and USB3.0 interface card configurations, images may not be captured properly (e.g. dropping frames). In this case, change frame rate setting lower. D4279014C 20 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 22: Led Status

    Slow flash orange (ON: 400ms, OFF: 1600ms) Data being transferred Fast flash green (ON:60ms, OFF:20ms) Error during data transfer Solid Red (Time period: 500ms) Stand-by Super slow flash orange (ON:200ms, OFF: 2800ms) D4279014C 21 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 23: I/O Specification

    EXT_TRIG signal. Please confirm it before use. Notes of input level: Line0 and Line2 have different input level. Please use input level within the voltage described in this specification. D4279014C 22 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 24 - Pin 3 is conducted with camera frame. Using shield cable, terminal processing of the shield is referred as above. - Please confirm the EMC adaptability in whole of your system. D4279014C 23 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 25 *Even if LineMode is set as Output, the input signal to Line2 is valid when LineSource is set as Off. Input / Output circuit diagram Inside IOLineModeAll DC5.0V 10kΩ D4279014C 24 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 26 : High active / Low active (initial factory setting: Low active) Signal Source : Off / UserOutput / Timer0Active / AcquisitionActive FrameTriggerWait / FrameActive / FrameTransferActive ExposureActive D4279014C 25 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 27: Timing Specification

    Image Image Model Name format [ms] [ms] Mono8 31.72 32.25 BU1207MG Mono10, Mono12 43.88 61.83 1/(Frame Rate setting) Bayer8 31.72 32.25 BU1207MCG/CF Bayer10, Bayer12 43.88 61.83 D4279014C 26 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 28 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. D4279014C 27 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 29: Typical Spectral Response

    Typical Spectral Response * The lens characteristics and light source characteristics is not reflected in table. ● BU1207MG D4279014C 28 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 30 ●BU1207MCG ●BU1207MCF D4279014C 29 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 31: Operating Ambient Conditions

    However, about the upper limit of top surface temperature of camera housing and the allowed ambient temperature of each model, please refer to the "Thermal design manual" on our HP. D4279014C 30 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 32 - e-CON connector XN2A-1470 (OMRON Corporation) - Shielded wire UL1533 (AWG28) (Hitachi cable, Ltd.) Connection: Please confirm the EMC adaptability when it combines with parts other than them. D4279014C 31 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 33: Functions

    Event packet control VenderUniqueControl FrameSynchronization Frame synchronization control LEDIndicatorLuminance LED luminance control DPCControl DPCControl Defect pixel correction control SequentialShutterControl SequentialShutterControl Sequential shutter control ChunkDataControl Chunk ChunkDataControl D4279014C 32 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 34 AntiGlitch ○ ○ ○ AntiChattering ○ ○ ○ DPCControl ○ ○ ○ SequentialShutterControl ○ ○ ○ Chunk Details of each feature are described in following pages. D4279014C 33 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 35: Bootstrap Registers

    SerialNumber 0x00144 String Serial number of the device UserDefinedName 0x00184 String User defined name of the device. SBRM Address 0x001D8 Integer Start Address of the SBRM D4279014C 34 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 36 BU series doesn’t support image transfer in High-Speed connection. CurrentSpeed register could be used for showing the warning message on your application when camera is connected to USB2.0 port. D4279014C 35 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 37: Devicecontrol

    Camera executes the USB Bus reset operation by DeviceReset command. - Plug-and-play happens, camera handles used in the application become invalid. - The application is required to close and re-open the camera. D4279014C 36 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 38: Imageformatcontrol

    OffsetX BinningHorizontal OffsetY BinningVertical BinningHorizontal BinningVertical BinningHorizontal DecimationHorizontal BinningVertical DecimationVertical DecimationHorizontal DecimationVertical DecimationHorizontal ReverseX DecimationVertical ReverseY ReverseX ReverseY ReverseX PixelFormat ReverseY PixelEndian PixelFormat PixelEndian PixelFormat PixelEndian D4279014C 37 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 39 Selects an image format. List of registers to be applied by ImageFormatSelector ImageFormat 0 - 2 Width Height OffsetX OffsetY BinningHorizontal BinningVertical DecimationHorizontal DecimationVertical ReverseX ReverseY PixelFormat PixelEndian D4279014C 38 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 40 // Retrieve GenICam node. Nd_GetNode(s_hCam, "ImageFormatSelector", &hSelector); // ImageFormat = Format2 Nd_SetEnumStrValue(s_hCam, hSelector, "Format2"); Please refer to [INode functions], [IEnumeration node functions] in [TeliCamAPI Library manual] for more detail. D4279014C 39 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 41 Cam_WriteReg(s_hCam, 0x20203C, 1, &uiSelector); Please refer to [Camera functions] in [TeliCamAPI Library manual] for more detail. ● Note Changing ‘ImageFormatSelector’ register value is invalid during image stream data output. D4279014C 40 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 42: Scalable

    The window size is equal or less than maximum image size. ( X , Y )=( 4 * i , 2 * j ) A + 4 * m Scalable D4279014C 41 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 43 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. D4279014C 42 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 44 GetCamOffsetY vertical offset of image SetCamOffsetY Please refer to [Controlling camera feature functions] in [TeliCamAPI Library manual] for more detail. D4279014C 43 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 45 // 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]); D4279014C 44 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 46 Maximum unit size(*) 4096 x 3000 * initial factory setting ● Note Changing “Width”, “Height”, “OffsetX”, “OffsetY” register value is invalid during image stream data output. D4279014C 45 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 47: Binning

    This increases the sensitivity of the image. It’s alike scalable, the frame rate can be faster and USB bandwidth occupation decrease. 4096 2448 3000 2048 All pixel readout 1224 2048 1500 1024 Binning Binning operation (e.g. Binning 2x2) D4279014C 46 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 48 Digital stage Analog stage Digital stage ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ D4279014C 47 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 49 Returns the state whether the function is implemented. 0x202154 Returns the minimum value of BinningVertical Value register. 0x202158 Returns the maximum value of BinningVertical Value register. Value 0x20215C Sets the Binning Vertical. D4279014C 48 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 50 // Nd_GetNode(s_hCam, “BinningVertical”, &hBinning); // either will do // Set Binning Nd_SetIntValue(s_hCam, hBinning, Binning); Please refer to [INode functions], [IInteger node functions] in [TeliCamAPI Library manual] for more detail. D4279014C 49 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 51 Scalable is enabled when the camera is running in Binning mode. Changing “BinningHorizontal”, “BinningVertical” register value is invalid during image stream data output. Binning Horizontal / Vertical = 3 is not available. D4279014C 50 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 52: Decimation

    Decimation feature can make frame rate faster, and decrease interface bandwidth occupation. 4096 4096 2448 2048 3000 3000 All pixel readout 1224 2048 2048 1024 1500 1500 Decimation Decimation operation (e.g. Decimation 2x2) D4279014C 51 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 53 Analog stage Digital stage ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ D4279014C 52 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 54 Returns the state whether the function is implemented. 0x202184 Returns the minimum value of DecimationVertical Value register. 0x202188 Returns the maximum value of DecimationVertical Value register. Value 0x20218C Sets the Decimation Vertical. D4279014C 53 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 55 // Nd_GetNode(s_hCam, “DecimationVertical”, &hDecimation); // either will do // Set Decimation Nd_SetIntValue(s_hCam, hDecimation, Decimation); Please refer to [INode functions], [IInteger node functions] in [TeliCamAPI Library manual] for more detail. D4279014C 54 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 56 Scalable is enabled when the camera is running in Decimation mode. Changing “DecimationHorizontal”, “DecimationVertical” register value is invalid during image stream data output. Binning Horizontal / Vertical = 3 is not available. D4279014C 55 / 161 Copyright © 2020 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 D4279014C 56 / 161 Copyright © 2020 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. D4279014C 57 / 161 Copyright © 2020 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. D4279014C 58 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 60: Pixelformat

    Returns the state whether the function is implemented. ListOfElements 0x2020EC [8] : Bpp8 ~0x2020F8 [10] : Bpp10 [12] : Bpp12 Value 0x2020FC Selects a bit size of image pixel. D4279014C 59 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 61 [13] : BayerRG10 [14] : BayerGB10 [15] : BayerBG10 [16] : BayerGR12 [17] : BayerRG12 [18] : BayerGB12 [19] : BayerBG12 Value 0x20241C Selects a pixel format D4279014C 60 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 62 Bpp8 0x0108000A FALSE Bpp10 0x0110000F Bpp10 0x0110000E Bpp12 0x01100013 Bpp12 0x01100012 BayerGR BayerRG Bpp8 0x01080008 Bpp8 0x01080009 TRUE Bpp10 0x0110000C Bpp10 0x0110000D Bpp12 0x01100010 Bpp12 0x01100011 D4279014C 61 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 63 // Retrieve GenICam node. Nd_GetNode(s_hCam, "PixelCoding", &hCoding); Nd_GetNode(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"); D4279014C 62 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 64 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. D4279014C 63 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 65 Cam_WriteReg(s_hCam, 0x20241C, 1, &format); Please refer to [Camera functions] in [TeliCamAPI Library manual] for more detail. ● Note Changing ‘PixelFormat’ register value is invalid during image stream data output. D4279014C 64 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 66: Testpattern

    BU series supports test pattern data output. Camera provides following Test patterns; Black White GreyA GreyB GreyHorizontalRamp GreyVerticalRamp GreyScale ColorBar (B/W model only) (Color model only) Test pattern (e.g. BU1207MG/BU1207MC) D4279014C 65 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 67 [2] : White [3] : GrayA [4] : GrayB [5] : GreyHorizontalRamp [6] : GrayScale [7] : ColorBar [8] : GreyVerticalRamp Value 0x21F13C Selects a Test pattern. D4279014C 66 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 68 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. D4279014C 67 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 69 = 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. D4279014C 68 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 70: 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. D4279014C 69 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 71 Returns the minimum value of frame interval. 0x2030D8 Returns the maximum value of frame interval. Value 0x2030DC Sets frame interval of image stream in raw value. D4279014C 70 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 72 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. D4279014C 71 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 73 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. D4279014C 72 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 74 Depend on register setting of "Height". Absolute (Float) Value Raw Value Initial Value Absolute (Float) Value 31.0 [fps] 31.0 [fps] Fomula Absolute Value [fps] = Raw Value * 125 / 2048 D4279014C 73 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 75 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. D4279014C 74 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 76: 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. D4279014C 75 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 77  ImageBuffer 1. Select an Image Buffer mode by ‘ImageBufferMode’. Integer value and string value of Enumeration are as follows. Integer String 0(*) * initial factory setting D4279014C 76 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 78 = 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); D4279014C 77 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 79 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. D4279014C 78 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 80 The maximum number of frames storable depends on the image size. (maximum 256MByte.) 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. D4279014C 79 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 81: 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. D4279014C 80 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 82 And you can add delay time from trigger edge to exposure start by register setting. Trigger signal TriggerDelay Exposure USB Streaming Image Trigger Delay For details of Random Trigger Shutter operation, please refer to ‘Timing’ section in ‘Specification’. D4279014C 81 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 83 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. D4279014C 82 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 84 SoftwareTrigger Implemented 0x207040 [31] Returns the state whether the function is implemented. ListOfElements 0x20702C [0] : Inactive ~0x207038 [8] : Impulse Value 0x20705C Executes software trigger. D4279014C 83 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 85 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. D4279014C 84 / 161 Copyright © 2020 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 in SoftwareTrigger mode by ‘TriggerSoftware’. 9. Receive Image 10. Stop and Close image stream. D4279014C 85 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 87 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); D4279014C 86 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 88 [GrabStreamSimple] sample code in your TeliCamSDK install folder. 8. Execute software trigger. Write [8] to ‘Value’ field of ‘SoftwareTrigger’ register to execute Software trigger.. 9. Receive Image 10. Stop and Close image stream. D4279014C 87 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 89 // 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. D4279014C 88 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 90 I/O connector : 1 pin, High level 4.0 to 5.0V * initial factory setting TriggerDelay is applied to both of HardwareTrigger and SoftwareTrigger. TriggerAdditionalParameter is only effective in Bulk mode. D4279014C 89 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 91: Exposuretime

    0x204030 0x204034 Returns the minimum value of ExposureTime Value register. 0x204038 Returns the maximum value of ExposureTime Value register. Value 0x20403C Sets Time value. (Raw value) D4279014C 90 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 92 // Set ExposureTime Value Nd_SetFloatValue(s_hCam, hNode, dExposureTime); Please refer to [INode functions], [IFloat node functions] and [IEnumeration node functions] in [TeliCamAPI Library manual] for more detail. D4279014C 91 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 93 // ExposureTime = 1000us (Raw value = 60000) uint32_t uiExposureTimeRaw = 60000; // Set ExposureTime Value Cam_WriteReg(s_hCam, 0x20403C, 1, &uiExposureTimeRaw); Please refer to [Camera functions] in [TeliCamAPI Library manual] for more detail. D4279014C 92 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 94 Raw Value Absolute (Float) Value Minimum 1800 30 [us] Maximum 960000000 16000000 [us] Initial Value 96000 16000.00 [us] Formula Absolute Value [us] = Raw Value / 60 D4279014C 93 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 95: Digitaliocontrol

    ExposureActive FrameActive FrameTransfer FrameTrigger Wait *AcquisitionActive is active during AcquisitionStart state. * All signals in this figure are Active Low. Selectable signals GPIO internal circuit diagram D4279014C 94 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 96 Line1 LineStatus LineStatus[1] Line2 LineStatus[2] UserOutputValueAll UserOutputValueAll[31:0] Line0 UserOutputValue[0] Line1 UserOutputValue UserOutputValue[1] Line2 UserOutputValue[2] Line0 LineSource(Line0) Line1 LineSource LineSource LineSource(Line1) Line2 LineSource(Line2) Details of each signal D4279014C 95 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 97 [32] : UserOutput [64] : Timer0Active [99] : AcquisitionActive [106] : FrameTriggerWait [107] : FrameActive [115] : FrameTransferActive [123] : ExposureActive Value 0x2090DC Selects the source signal. D4279014C 96 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 98 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. D4279014C 97 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 99 [Line2] [Line1] [Line0] not used 2(*) [0] [1] [0] [in] [out] [in] not used [1] [1] [0] [out] [out] [in] not used * initial factory setting D4279014C 98 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 100 [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 D4279014C 99 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 101 [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] D4279014C 100 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 102 [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 D4279014C 101 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 103 Nd_SetEnumStrValue(s_hCam, hSelector, "Line2"); Nd_SetEnumStrValue(s_hCam, hSource, "FrameTransferActive"); Please refer to [INode functions], [IInteger node functions], [IBoolean node functions] and [IEnumeration node functions] in [TeliCamAPI Library manual] for more detail. D4279014C 102 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 104 - Line0 is dedicated input. - Line1 is dedicated output. - Line2 is bi-directional. The default direction is input. For [Timer0Active] signal, please refer to [TimerControl] Section for more detail. D4279014C 103 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 105: 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 Fig. AntiGlitch and AntiChattering D4279014C 104 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 106 Absolute Value [sec] = Raw * (Mult / Div) 0x21F3F0 0x21F3F4 Returns the minimum value of AntiGlitch period. 0x21F3F8 Returns the maximum value of AntiGlitch period. Value 0x21F3FC Sets the AntiGlitch period.(Raw value) D4279014C 105 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 107 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. D4279014C 106 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 108 AntiChattering Raw Value Absolute (Float) Value Minimum 1.992 [us] Maximum 249999 1999.992 [us] Initial Value 1.992 [us] Formula Absolute Value [us] = Raw Value / 125 D4279014C 107 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 109: Timercontrol

    (Frame Start Trigger) TriggerDelay Exposure Exposure Active EXPOSURE ACTIVE Timer0 Active TIMER0 ACTIVE TimerTriggerSource = Line0Active Delay Duration TimerTriggerSource = FrameTrigger TimerTriggerSource = ExposureStart ※ ActiveLow Timer0Active D4279014C 108 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 110 Returns the state whether the function is implemented. ListOfElements 0x20A08C [0] : Off [32] : Line0 [104] : FrameTrigger [124] : ExposureStart Value 0x20A09C Selects the source of Timer0Active pulse to start. D4279014C 109 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 111 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. D4279014C 110 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 112 // 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. D4279014C 111 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 113 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]. D4279014C 112 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 114: 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) D4279014C 113 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 115 // Set Gain Value Nd_SetFloatValue(s_hCam, hNode, dGain); Please refer to [INode functions], [IFloat node functions] and [IEnumeration node functions] in [TeliCamAPI Library manual] for more detail. D4279014C 114 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 116  Minimum/Maximum Value Gain Raw Value Absolute (Float) Value Minimum 0.00 [dB] Maximum 24.00 [dB] Initial Value 0.00 [dB] Formula Absolute Value [dB] = Raw Value / 10 D4279014C 115 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 117: 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. D4279014C 116 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 118  Minimum/Maximum Value Gain Raw Value Absolute (Float) Value Minimum -256 -25.00[%] Maximum +25.00[%] Initial Value 0.00[%] Formula Absolute Value [%] = Raw Value * 100 / 1024 D4279014C 117 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 119: 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. D4279014C 118 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 120 Please refer to [Camera functions] in [TeliCamAPI Library manual] for more detail.  Minimum/Maximum Value Gain Raw Value Absolute (Float) Value Minimum 0.45 Maximum 1.00 Initial Value 1.00 Formula Absolute Value = Raw Value / 100 D4279014C 119 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 121: 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. Fig. BalanceRatio D4279014C 120 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 122 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) D4279014C 121 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 123 // 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); D4279014C 122 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 124 // 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. D4279014C 123 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 125 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. D4279014C 124 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 126: 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. D4279014C 125 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 127 // 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. D4279014C 126 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 128 = 1; 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 D4279014C 127 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 129: Usersetcontrol

    (*) DPC and SequentialShutter entries are stored to a single channel. Entries are shared with all channels. This table lists all features of B/W and Color models. Please refer to [Table : supported features list] as well. D4279014C 128 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 130 Returns the state whether the function is implemented. ListOfElements 0x2080AC [0] : Default [1] : UserSet1 … [15] : UserSet15 Value 0x2080BC Selects the number of UserSet when the camera starts up. D4279014C 129 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 131 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. D4279014C 130 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 132 = 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. D4279014C 131 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 133 // 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. D4279014C 132 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 134: 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. D4279014C 133 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 135 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. D4279014C 134 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 136 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. D4279014C 135 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 137: Framesynchronization

    0x21F020 [31] Returns the state whether the function is implemented. ListOfElements 0x21F02C [0] : Off [1] : Bus Value 0x21F03C Selects the camera frame synchronization method. D4279014C 136 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 138 // Select a frame synchronization method uint32_t dat = 1; Cam_WriteReg(s_hCam, 0x21F03C, 1, &dat); // Bus Sync mode Please refer to [Camera functions] in [TeliCamAPI Library manual] for more detail. D4279014C 137 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 139: Ledindicatorluminance

    Returns the minimum value of LED indicator luminance register. 0x21F118 Returns the maximum value of LED indicator luminance register. Value 0x21F11C Sets the LED indicator luminance D4279014C 138 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 140  Minimum/Maximum Value LEDIndicatorLuminance Raw Value Absolute (Float) Value Minimum 0.00 [%] Maximum 100.00 [%] Initial Value 100.00 [%] Formula Absolute Value [%] = Raw Value / 7 D4279014C 139 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 141: 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. D4279014C 140 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 142 // 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. D4279014C 141 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 143 Cam_WriteReg(s_hCam, 0x21F29C, 1, &dat); Please refer to [Camera functions] in [TeliCamAPI Library manual] for more detail.  Minimum/Maximum Value DPCNumber DPCIndex Minimum Maximum DPCEntryX DPCEntryY Minimum Maximum WidthMax-1 HeightMax-1 D4279014C 142 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 144 DPCEntryX and Y shall be sorted in order from the top left to the top right and to the bottom left to the bottom right. (X,Y)=(0,0) (WidthMax-1,0) DPCIndex[0] DPCIndex[1] DPCIndex[2] DPCIndex[3] DPCIndex[4] (0,HeightMax-1) (WidthMax-1,HeightMax-1) Sorting of DPCIndex and DPCEntryX, Y D4279014C 143 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 145: 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 D4279014C 144 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 146 ChunkSequentialShutterNumber IInteger Returns the SequentialShutterNumbere of the frame included in the Chunk data. ChunkSequentialShutterElement IInteger Returns the SequentialShutterElement of the frame included in the Chunk data. D4279014C 145 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 147 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 D4279014C 146 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 148 Nd_GetNode(s_hCam, "ChunkExposureTime", &hExposureTime); Nd_GetNode(s_hCam, "ChunkUserAreaTable", &hUserAreaTable); // 2.Activate ChunkModeActive Nd_SetBoolValue(s_hCam, hMode, true); //3.Enable ChunkSelector Nd_SetEnumStrValue(s_hCam, hSelector, "ExposureTime"); Nd_SetBoolValue(s_hCam, hEnable, true); Nd_SetEnumStrValue(s_hCam, hSelector, " UserArea"); Nd_SetBoolValue(s_hCam, hEnable, true); D4279014C 147 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 149 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. D4279014C 148 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 150 // 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. D4279014C 149 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 151: Sequentialshuttercontrol

    Sets the UserSet number to register to the second sequence. … … … … … Value[15] 0x500078 Sets the UserSet number to register to the 16 sequence. D4279014C 150 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 152 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. D4279014C 151 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 153 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 LUT function. D4279014C 152 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 154 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 D4279014C 153 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 155 List of registers to be applied to SequentialShutter Category Register Category Register OffsetX AnalogControl Gain ImageFormatControl OffsetY BlackLevel ExposureControl ExposureTime Gamma UserOutputValueAll BalanceRatio DigitalIOControl LineSource LUTControl LUTEnable TimerDuration CounterAndTimerControl TimerDelay D4279014C 154 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 156: Appendix

    USB Bus Frame #1 Frame #2 Frame #3 Tact Time Overhead - ImageSize Save - ExposureTime UserSet1 UserSet1 - Gain UserSet - ... FPGA Serial Flash D4279014C 155 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 157 Save to Serial Flash if necessary. Quick - ImageSize Save Save - ExposureTime UserSet1 UserSet1 UserSet1 UserSet1 - Gain UserSet UserSet - ... Internal RAM FPGA Serial Flash D4279014C 156 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 158: 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 D4279014C 157 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 159 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 D4279014C 158 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 160 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 D4279014C 159 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 161: 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 D4279014C 160 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...
  • Page 162: 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. D4279014C 161 / 161 Copyright © 2020 Toshiba Teli Corporation, All rights reserved. http://www.toshiba-teli.co.jp/en/index.htm...

This manual is also suitable for:

Bu seriesBu1207mcgBu1207mcf

Table of Contents