Toshiba teli BU040M Instruction Manual

Cmos camera

Advertisement

Quick Links

BU series
CMOS Camera
Instruction Manual
Model
B/W Camera
: BU040M / BU040MG / BU160M / BU160MG
Color Camera
: BU040MCG / BU040MCF / BU160MCG / BU160MCF
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 © 2018 - 2020 Toshiba Teli Corporation, All rights reserved.
DAA00195C
https://www.toshiba-teli.co.jp/en/

Advertisement

Table of Contents
loading

Summary of Contents for Toshiba teli BU040M

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

    SequentialShutterControl ......................166 Appendix ............................171 UserSetSave and UserSetQuickSave difference ............... 171 MultiFrame and Bulk function difference ..................173 Warranty rules ............................ 176 Repair ..............................177 1 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 3: Safety Precautions

    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. 2 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 4  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. 3 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • 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 4 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 6 ● 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. 5 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 7 - Traffic control systems for air transportation, railways, roads, or marine transportation - Equipment for nuclear power generation - Equipment related to the above 6 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 8 When mounting this product to a pedestal, make sure carefully that lens doesn’t touch with the pedestal. ● Do not expose the camera's image-pickup-plane to sunlight or other intense light directly Its inner CMOS sensor might be damaged. 7 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • 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. 8 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • 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. 9 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • 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 10 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 12: Installation

    ● TOSHIBA TELI CORPORATION Top Page https://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. 11 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 13: Specifications

    BU040M/BU160M series is an integrated-(one-body)-type camera that adopts a global shutter CMOS sensor. These are BU040M (0.4M type1/2.9) and BU160M (1.6M type1/2.9). For video output and camera control, the USB3.1 Gen1 (USB3.0) interface standard is adopted for high transfer rate, and it is easy to integrate into industrial equipment.
  • Page 14 Firmware Ver.4.1.0 or later models have ShortExpousreMode. By setting the ShortExposureMode to enable, high-speed exposure time setting from 1.08 to 13.31 μs μs possible. 13 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 15: Configuration

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

    Lost packets may occur by an electrical characteristic of the transmission line of USB3.1 Gen1. (USB3.1 Gen1 Interface Card, USB3.1 Gen1 Cable, and USB3.1 Gen1 HUB). 15 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 17: Connector Pin Assignment

    *Above figure is connector view from insert side. Pin No. Signal Function Line2 GPIO Input / Output Line1 GPIO Output Ground Line0 GPIO Input 16 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 18: Outline Drawing

    Outline Drawing <BU040M/BU160M> 17 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 19 <BU040MG/BU040MCG/BU040MCF/BU160MG/BU160MCG/BU160MCF> 18 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 20: General Specifications

    *1 Ver.4.0.8 or earlier: F1.4, Gain +24dB, Video Level 50% Ver.4.1.0 or later: F1.4, Gain +36dB, Video Level 50% *2 at the all pixel readout 19 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 21 Camera body grounding: insulation status Conductive between circuit GND and camera body *1 F1.4, Gain +36dB, Video Level 50% *2 at the all pixel readout 20 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 22 - As for the C-mount lens used combining this camera, the projection distance from bottom of the screw should use dimensions (A) or less. 21 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 23: Led Status

    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) 22 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 24: 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. 23 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 25 - 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. 24 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 26 *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Ω 25 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 27 : High active / Low active (initial factory setting: Low active) Signal Source (LineSource) : Off / UserOutput / Timer0Active / AcquisitionActive FrameTriggerWait / FrameActive / FrameTransferActive ExposureActive 26 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 28: Timing Specification

    YUV 4:2:2 Bayer10, Bayer12 RGB, BGR 1/(Frame Rate setting) Mono8 BU160M Mono10, Mono12 Bayer8, Mono8 YUV 4:1:1 BU160MCG YUV 4:2:2 Bayer10, Bayer12 RGB, BGR 12.3 27 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 29 RGB, BGR * The value of T2 is the same as the value of normal shutter mode. * T4 and T5 are typical value. 28 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 30 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. 29 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 31: Typical Spectral Response

    Typical Spectral Response * The lens characteristics and light source characteristics is not reflected in table. ● BU040M/BU160M 30 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 32 ● BU040MCG ● BU040MCF 31 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 33 ● BU160MCG ● BU160MCF 32 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 34: 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. 33 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 35 (Hitachi cable, Ltd.) Connection: e-CON GPIO(Line2) GPIO(Line2) GPIO(Line1) GPIO(Line1) TRIG IN(Line0) TRIG IN(Line0) Please confirm the EMC adaptability when it combines with parts other than them. 34 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 36: Functions

    Functions This section introduces standard functions. BU040M / BU160M series provides following functions. Category Function USB3 Vision Bootstrap Registers USB3 Vision standard registers DeviceControl DeviceControl Device information ImageFormatControl ImageFormatSelector Image format selection Scalable Scalable control Binning Binning control Decimation Decimation control...
  • Page 37 DPCControl ✓ ✓ ✓ ✓ SequentialShutterControl ✓ ✓ ✓ ✓ Chunk ✓ ✓ ✓ ✓ Details of each feature are described in following pages. 36 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 38: Bootstrap Registers

    String Serial number of the device UserDefinedName 0x00184 String User defined name of the device. SBRM Address 0x001D8 Integer Start Address of the SBRM 37 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 39 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. 38 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 40: 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. 39 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 41: Imageformatcontrol

    Registers of this category are related to image format control. Camera has three different banks of image format. You can select image format by ImageFormatSelector. 40 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 42 List of registers to be applied by ImageFormatSelector ImageFormat 0 - 2 Width Height OffsetX OffsetY BinningHorizontal BinningVertical DecimationHorizontal DecimationVertical ReverseX ReverseY PixelFormat PixelEndian 41 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 43 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. 42 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • 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 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • 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 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 46 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 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 47 GetCamOffsetY SetCamOffsetY vertical offset of image Please refer to [Controlling camera feature functions] in [TeliCamAPI Library manual] for more detail. 46 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 48 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]); 47 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 49 720 x 540 1440 x 1080 * initial factory setting ● Note Changing “Width”, “Height”, “OffsetX”, “OffsetY” register value is invalid during image stream data output. 48 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 50: Binning

    This increases the sensitivity of the image. It’s alike scalable, the frame rate can be faster and USB bandwidth occupation decrease. 1440 1080 All pixel readout Binning Horizontal Binning Binning Vertical Horizontal / Vertical Binning operation (e.g. BU160M) 49 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 51 Mono12 垂直 - BU040MCG Bayer8/ Bayer10/ YUV411 Bayer12 Mono8 YUV422 RGB/BGR 水平 垂直 - BU160MCG Bayer8/ Bayer10/ YUV411 Mono8 Bayer12 YUV422 RGB/BGR 水平 垂直 50 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 52 GetCamBinningVertical Get current BinningVertical value SetCamBinningVertical Set new BinningVertical value Please refer to [Controlling camera feature functions] in [TeliCamAPI Library manual] for more detail. 51 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 53 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. 52 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 54: Decimation

    Decimation feature can make frame rate faster, and decrease interface bandwidth occupation. 1440 1080 All pixel readout Decimation Horizontal Decimation Decimation Vertical Horizontal / Vertical Decimation operation (e.g. BU160M) 53 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 55 Mono10/ Mono12 - BU040MCG Bayer8/ Bayer10/ YUV411 Bayer12 Mono8 YUV422 RGB/BGR 水平 垂直 - BU160MCG Bayer8/ Bayer10/ YUV411 Mono8 Bayer12 YUV422 RGB/BGR 水平 垂直 54 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 56 GetCamDecimationVertical Get current DecimationVertical value SetCamDecimationVertical Set new DecimationVertical value Please refer to [Controlling camera feature functions] in [TeliCamAPI Library manual] for more detail. 55 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 57 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. 56 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 58: Reverse

    ReverseY Implemented 0x2021C0 [31] Returns the state whether the function is implemented. Value 0x2021D0 Sets the Reverse Vertical. [0] : Off [1] : On 57 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 59 // 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. 58 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 60 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. 59 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 61: Pixelformat

    [8] : Bpp8 ~0x2020F8 [10] : Bpp10 [12] : Bpp12 [16] : Bpp16 [24] : Bpp24 Value 0x2020FC Selects a bit size of image pixel. 60 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 62 [18] : BayerGB12 [19] : BayerBG12 [20] : RGB [21] : BGR [30] : YUV411Packed [31] : YUV422Packed Value 0x20241C Selects a pixel format 61 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 63 FALSE Bpp10 0x0110000F Bpp10 0x0110000E Bpp12 0x01100013 Bpp12 0x01100012 BayerGR BayerRG Bpp8 0x01080008 Bpp8 0x01080009 TRUE Bpp10 0x0110000C Bpp10 0x0110000D Bpp12 0x01100010 Bpp12 0x01100011 62 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 64 2. Select a bit size of image pixel (‘PixelSize’). Integer value and string value of Enumeration are as follows. Integer String Bpp8 Bpp10 Bpp12 Bpp16 Bpp24 63 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 65 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. 64 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 66 Please refer to [Camera functions] in [TeliCamAPI Library manual] for more detail. ● Note Changing ‘PixelFormat’ register value is invalid during image stream data output. 65 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 67: Bayerprocessingmode

    ✓ ✓ ✓ BlackLevel ✓ ✓ Gamma ✓ ✓ BalanceRatio ✓ ✓ ColorCorrectionMatrix ✓ LUTControl ✓ ✓ DPCControl ✓ ✓ * initial factory setting 66 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 68 Returns the presence of the pixel endian. ~0x21F438 [0] : Raw [8] : Partial [16] : Full Value 0x21F43C Selects a Bayer Processing Mode. 67 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 69 Please refer to [Camera functions] in [TeliCamAPI Library manual] for more detail. ● Note Changing ‘BayerProcessingMode’ register value is invalid during image stream data output. 68 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 70: 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. BU040M/BU040MCG) 69 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 71 [3] : GrayA [4] : GrayB [5] : GreyHorizontalRamp [6] : GrayScale [7] : ColorBar [8] : GreyVerticalRamp Value 0x21F13C Selects a Test pattern. 70 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 72 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. 71 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 73 = 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. 72 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 74: 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. 73 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 75 Returns the state whether the function is implemented. ListOfElements 0x21F66C [0] : Off [1] : On Value 0x21F67C Only firmware Ver.4.1.0 or later. Sets the activation of HighFramerateMode. 74 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 76 Or, set ‘AcquisitionFrameInterval’ with ‘SetCamAcquistionFrameInterval’ function. ‘AquisitionFrameInterval’ is a reciprocal of ‘AcquisitionFrameRate’. Please refer to [Controlling camera feature functions] in [TeliCamAPI Library manual] for more detail. 75 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 77 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. 76 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 78 1332 Initial Value Absolute (Float) Value 436.7 [fps] 227.2 [fps] 320.6 [fps] 81.2[fps] Fomula Absolute Value [fps] = Raw Value * 125 / 2048 77 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 79 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. 78 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 80: 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. 79 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 81 1. Select an Image Buffer mode by ‘ImageBufferMode’. Integer value and string value of Enumeration are as follows. Integer String 0(*) * initial factory setting 80 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 82 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); 81 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 83 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. 82 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 84 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. 83 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 85: 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. 84 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 86 This feature is not supported when the ShortExposureMode is enable (ON). - Bulk mode (FrameBurstTrigger) : TriggerSequence6 Camera exposes and transfers multiple frames by a single trigger. ExposureTime TriggerAdditionalParameter = 3 Image Image Image 85 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 87 And you can add delay time from trigger edge to exposure start by register setting. Trigger Delay For details of Random Trigger Shutter operation, please refer to ‘Timing’ section in ‘Specification’. 86 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 88 Returns the maximum value of the number of images in Bulk mode. Value 0x20709C Sets the number of frames to exposure in Bulk mode. 87 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 89 0x207040 [31] Returns the state whether the function is implemented. ListOfElements 0x20702C [0] : Inactive ~0x207038 [8] : Impulse Value 0x20705C Executes software trigger. 88 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 90 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. 89 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 91 [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. 90 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 92 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); 91 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 93 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. 92 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 94 // 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. 93 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 95 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. 94 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 96: Exposuretime

    Returns the state whether the function is implemented. ListOfElements 0x20438C [0] : Off [1] : On Value 0x20439C Only firmware Ver.4.1.0 or later. Sets the activation of ShortExposureMode. 95 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 97 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); 96 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 98 Write to ‘Control’ field of ‘ExposureTime’ register to control ExposureAuto. // ExposureAuto = "Continuous " uint32_t uiExposureAuto = 2; // Set ExposureAuto = "Continuous " Cam_WriteReg(s_hCam, 0x204028, 1, &uiExposureAuto); 97 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 99 Auto Not supported Absolute Value Raw Value Initial Value Absolute Value 13.31 [us] Formula Absolute Value [s] = Raw Value * 53 / 983850009 98 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 100 - In ExposureAuto mode, current exposure time will be reflected to ExposureTime value register. - Changing ‘ShortExposureMode’ register value is invalid during image stream data output. 99 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 101: Digitaliocontrol

    LineSource Timer0Active TimerControl UserOutput Line2 (GPIO_Input/Output) ExposureActive FrameTransfer FrameActive LineModeAll[1] FrameTriggerWait UserOutputValueAll[1] UserOutput UserOutputValueAll[2] Line1 (GPIO_Output) LineStatusAll[2] LineStatusAll[1] LineStatusAll[0] LineModeAll GPIO internal circuit diagram 100 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 102 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 101 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 103 [64] : Timer0Active [99] : AcquisitionActive [106] : FrameTriggerWait [107] : FrameActive [115] : FrameTransferActive [123] : ExposureActive Value 0x2090DC Selects the source signal. 102 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 104 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. 103 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 105 [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 104 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 106 [on] [off] [off] [1] [0] [1] [out [off] [on] [1] [1] [0] [on] [on] [off] [1] [1] [1] [on] [on] [on] * initial factory setting 105 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 107 [1] [0] [0] [high] [low] [low] [1] [0] [1] [high] [low] [high] [1] [1] [0] [high] [high] [low] [1] [1] [1] [high] [high] [high] 106 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 108  LineSelector Selects the I/O line to output by ‘LineSelector’. Integer value and string value of Enumeration are as follows. Integer String Line1 Line2 107 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 109 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. 108 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 110 - Line1 is dedicated output. - Line2 is bi-directional. The default direction is input. For [Timer0Active] signal, please refer to [TimerControl] Section for more detail. 109 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 111: Antiglitch / Antichattering

    Edge Edge Edge Output Invalid Edge AntiChattering Insensible Insensible Value Time Time High AntiChattering Circuit Valid Valid Output Signal Signal Fig. AntiGlitch and AntiChattering 110 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 112 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) 111 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 113 // 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. 112 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 114 Raw Value Absolute (Float) Value Minimum 0.000001992 [s] Maximum 249999 0.001999992 [s] Initial Value 0.000001992 [s] Formula Absolute Value [us] = Raw Value / 125000000 113 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 115: Timercontrol

    Trigger (Frame Start Trigger) TriggerDelay Exposure EXPOSURE ACTIVE TIMER0 ACTIVE TimerTriggerSource = Line0Active Delay Duration TimerTriggerSource = FrameTrigger TimerTriggerSource = ExposureStart ※ ActiveLow Timer0Active 114 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 116 ListOfElements 0x20A08C [0] : Off [32] : Line0 [104] : FrameTrigger [124] : ExposureStart Value 0x20A09C Selects the source of Timer0Active pulse to start. 115 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 117 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. 116 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 118 // 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. 117 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 119 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]. 118 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 120: Gain

    0x204074 Returns the minimum value of Gain Value register. 0x204078 Returns the maximum value of Gain Value register. Value 0x20407C Gain value. (Raw value) 119 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 121 // GenICam node handle CAM_NODE_HANDLE hNode = NULL; // Retrieve GenICam node. Nd_GetNode(s_hCam, “GainAuto”, &hNode); // Set GainAuto = “ ” Continuous Nd_SetEnumStrValue(s_hCam, hNode, “ ”); Continuous 120 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 122 - In GainAuto mode, current Gain will be reflected to Gain value register. - Range of gain setting at GainAuto mode is 0 to +24dB. 121 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 123: Blacklevel

    GetCamBlackLevel Get current BlackLevel value SetCamBlackLevel Set new BlackLevel value Please refer to [Controlling camera feature functions] in [TeliCamAPI Library manual] for more detail. 122 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 124 Raw Value Absolute (Float) Value Minimum -256 -25.00[%] Maximum +25.00[%] Initial Value 0.00[%] Formula Absolute Value [%] = Raw Value * 100 / 1024 123 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 125: Gamma

    GetCamGamma Get current Gamma value SetCamGamma Set new Gamma value Please refer to [Controlling camera feature functions] in [TeliCamAPI Library manual] for more detail. 124 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 126  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 125 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 127: Sharpness

    GetCamSharpness Get current Sharpness value SetCamSharpness Set new Sharpness value Please refer to [Controlling camera feature functions] in [TeliCamAPI Library manual] for more detail. 126 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 128 Please refer to [Camera functions] in [TeliCamAPI Library manual] for more detail.  Minimum/Maximum Value Gain Raw Value Absolute (Float) Value Minimum Maximum Initial Value Formula Absolute Value = Raw Value / 100 127 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 129: 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 128 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 130 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) 129 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 131 // 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); 130 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 132 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. 131 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 133 Too high white balance gain increases noises. After adjusting the white balance of the image, we ask you to have final image quality checked with your environment. 132 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 134: Colorcorrectionmatrix

            mask mask mask mask         mask mask mask mask 133 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 135 GetCamColorCorrectionMatrix Get current ColorCorrectionMatrix value SetCamColorCorrectionMatrix Set new ColorCorrectionMatrix value Please refer to [Controlling camera feature functions] in [TeliCamAPI Library manual] for more detail. 134 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 136 // 1.Select a color correction matrix element Nd_SetEnumIntValue(s_hCam, hSelectorI, i); Nd_SetEnumIntValue(s_hCam, hSelectorJ, j); // 2.Set a coefficient of color correction matrix. Nd_SetFloatValue(s_hCam, hNode, dCoefficient); 135 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 137 SelectorJ 0.00 0.00 SelectorI 0.00 0.00 0.00 0.00 ● Note ColorCorrectionMatrix control is available in following PixelFormat. Bayer8/10/12(BayerProcessingMode = Full), RGB8, BGR8, YUV411, YUV422 136 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 138: Alccontrol

    - ALCExposureValue defines a correction value for a convergence value. Final convergence value is determined by the following formula. Final convergence value = Reference Luminance x 2 ALCExposureValue 137 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 139 Returns the minimum value of ALC Exposure Value. 0x2040D8 Returns the maximum value of ALC Exposure Value. Value 0x2040DC Sets ALC Exposure Value. (Raw value) 138 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 140 // Set ALCPhotometricAreaSize Cam_WriteReg(s_hCam, 0x21F37C, 1, &uiSizeRaw); // Set ALCExposureValue Cam_WriteReg(s_hCam, 0x2040DC, 1, &iEVRaw); Please refer to [Camera functions] in [TeliCamAPI Library manual] for more detail. 139 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 141 0.0[EV] Formula Absolute Value [EV] = Raw Value / 10 ● Note *The camera operation is not supported when the Random Trigger Shutter mode. 140 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 142: 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. 141 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 143 // 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. 142 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 144 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 143 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 145: 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. 144 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 146 ListOfElements 0x2080AC [0] : Default [1] : UserSet1 … [15] : UserSet15 Value 0x2080BC Selects the number of UserSet when the camera starts up. 145 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 147 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. 146 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 148 = 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. 147 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 149 // 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. 148 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 150: Eventcontrol

    : Start of Exposure. (6) ExposureStart : End of Exposure. (7) ExposureEnd : Start of Timer0. (8) Timer0Start : End of Timer0. (9) Timer0End 149 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 151 Sets the activation of event notification of exposure. ListOfElements 0x21F3AC [0] : Timer0End Value 0x21F3B0 Sets the activation of event notification of timer end. 150 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 152 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. 151 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 153: Framesynchronization

    Returns the state whether the function is implemented. ListOfElements 0x21F02C [0] : Off [1] : Bus Value 0x21F03C Selects the camera frame synchronization method. 152 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 154 = 1; Cam_WriteReg(s_hCam, 0x21F03C, 1, &dat); // Bus Sync mode Please refer to [Camera functions] in [TeliCamAPI Library manual] for more detail. 153 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 155: 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 154 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 156 Raw Value Absolute (Float) Value Minimum 0.00 [%] Maximum 100.00 [%] Initial Value 100.00 [%] Formula Absolute Value [%] = Raw Value / 7 155 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 157: Dpccontrol

    … … … … Value[255][0] 0x4007F8 Sets the 255th X coordinate of defective pixel. Value[255][1] 0x4007FC Sets the 255th Y coordinate of defective pixel. 156 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 158 // 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. 157 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 159 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 158 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 160: Chunk

    +0x070 Length = 0x04 +0x05C +0x074 +0x060 +0x078 UserArea (256 Bytes) ChunkID = 0x80000000 +0x160 +0x178 Length = 0x100 +0x164 +0x17C Chunk Data Structure 159 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 161 Returns the SequentialShutterNumbere of the frame included in the Chunk data. ChunkSequentialShutterElement IInteger Returns the SequentialShutterElement of the frame included in the Chunk data. 160 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 162 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 161 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 163 [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. 162 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 164 Nd_GetStrValue(s_hCam, hUserAreaTable, &userarea, &uiSize); Please refer to [INode functions], [IInteger node functions], [IBoolean node functions] and [IEnumeration node functions] in [TeliCamAPI Library manual] for more detail. 163 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 165 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. 164 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 166 // 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. 165 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 167: Sequentialshuttercontrol

    Sets the UserSet number to register to the second sequence. … … … … … Value[15] 0x500078 Sets the UserSet number to register to the 16 sequence. 166 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 168 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. 167 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 169 Write to ‘Value’ field of ’SequentialShutterTerminateAt’. 4. Set the activation of SequentialShutter function. Write to ‘Value’ field of ’SequentialShutterEnable’ register to activate LUT function. 168 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 170 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 169 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 171 Category Register Category Register ImageFormatControl OffsetX AnalogControl Gain OffsetY BlackLevel ExposureControl ExposureTime Gamma DigitalIOControl UserOutputValueAll Sharpness LineSource BalanceRatio CounterAndTimerControl TimerDuration ColorCorrectionMatrix TimerDelay LUTControl LUTEnable 170 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 172: Appendix

    UserSet #3 USB Bus Frame #1 Frame #2 Frame #3 Tact Time Overhead - ImageSize Save - ExposureTime UserSet1 UserSet1 - Gain UserSet - ... 171 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 173 By UserSetQuickSave, UserSet is stored to internal RAM. It takes less than 100us in execution. It can reduce the overhead time of UserSetSave greatly. You can also save UserSets to Serial Flash if necessary by UserSetSave. 172 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 174: Multiframe And Bulk Function Difference

    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 173 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 175 TriggerAdditionalParameter *Exposure overlaps sensor readout. *Exposure time is determined by ExposureTime setting. Stream USB Streaming stops Frame 1 Frame 2 Frame 3 Frame 1 174 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 176 TriggerAdditionalParameter *Exposure overlaps sensor readout. *Exposure time is determined by ExposureTime setting. Stream USB Streaming stops Frame 1 Frame 2 Frame 1 AcquisitionFrameCount 175 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 177: 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 176 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...
  • Page 178: 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. 177 / 177 DAA00195C Copyright © 2018 - 2020 Toshiba Teli Corporation, All rights reserved. https://www.toshiba-teli.co.jp/en/...

Table of Contents