Toshiba teli DDU Series Instruction Manual

Cmos camera
Hide thumbs Also See for DDU Series:

Advertisement

Quick Links

DDU Series
CMOS Camera
Instruction Manual
Model
B/W Camera
Color Camera
Thank you for purchasing our product.
Before using this CMOS camera, please read through this instruction manual
carefully in order to use this product correctly and safely.
After reading, keep this instruction manual handy so that you can refer to,
whenever you need it.
Information contained in this document is subject to change without prior notice.
Standard name might be trade mark of each company.
Copyright © 2019 Toshiba Teli Corpotration, All rights reserved.
: DDU1207MG
: DDU1207MCG / DDU1207MCF
D4289451A
http://www.toshiba-teli.co.jp/en/

Advertisement

Table of Contents
loading
Need help?

Need help?

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

Questions and answers

Summary of Contents for Toshiba teli DDU Series

  • Page 1 After reading, keep this instruction manual handy so that you can refer to, whenever you need it. Information contained in this document is subject to change without prior notice. Standard name might be trade mark of each company. D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 2: Table Of Contents

    ExposureTime ..........................95 DigitalIOControl ..........................99 AntiGlitch / AntiChattering......................109 TimerControl ..........................113 Gain ............................118 BlackLevel ..........................121 Gamma ............................123 Sharpness ........................... 125 BalanceRatio ..........................127 1 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 3 SequentialShutterControl ......................161 Appendix ............................166 UserSetSave and UserSetQuickSave difference ............... 166 MultiFrame and Bulk function difference ..................168 Warranty rules ............................ 171 Repair ..............................172 2 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 4: Safety Precautions

    The content of prohibition is shown by a picture or words beside the symbol. This sign indicates MANDATORY ACTION (You are required to do). MANDATORY The content of action is shown by a picture or words beside the symbol. 3 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 5: General Handing

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

    ● The item that is not described in specifications of this product is out of the guarantee. ● The case of damages or losses which are caused by incorrect connection of the cable is out of the guarantee. 6 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 8: Restriction For Use

    (*2): Equipment relating to maintenance of public services/functions involving factors of safety refers to. - Traffic control systems for air transportation, railways, roads, or marine transportation - Equipment for nuclear power generation - Equipment related to the above 7 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 9: Notes On Using This Product

    8mm or less ● Mounting to pedestal When mounting this product to a pedestal, make sure carefully that lens doesn’t touch with the pedestal. 8 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 10 Never use alcohol, benzene, thinner, or other chemicals because such chemicals may damage or discolor the paint and indications. If the image pickup surface becomes dusty, contaminated, or scratched, consult your sales representative. 9 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 11 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. 10 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 12 This information is applicable for People's Republic of China only. リサイクルに関する情報(包装物) 有关再利用的信息(包装物) Information on recycling of wrapping composition 内部緩衝材料・袋 内部缓冲材料·袋 箱/箱子/Box Internal buffer materials・Bag ペーパーボード 纸板 Paper board 11 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 13: 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. 12 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 14: Specifications

    This product is based on GenICam Generic Interface for Cameras Ver 2.3 and Ver.3.0. ● IIDC2 Digital Camera Control Specification Ver.1.1.0 This product is based on IIDC2 Digital Camera Control Specification Ver.1.1.0. 13 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 15 Suffix [F] is attached to the model name of built-in IR-cut filter model. ● Compact and lightweight This camera is compact and lightweight; it is easy to integrate into industrial equipment. ● EU RoHS & Chinese ROHS 14 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 16: Configuration

    *1: Optional part. Contact your sales representative for details of option units. *2: Commercial items. 15 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 17: Connection

    - When connecting two USB 3.0 cables and using it in dual mode, please use the same item (manufacturer, model name, cable length). 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). 16 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 18: 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 17 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 19 Camera side Cable side Pin No. Signal Function Line4 GPIO Input Line3 GPIO Input Line5 GPIO Output Line6 GPIO Output I/O GND GPIO Ground Not Connected 18 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 20: Outline Drawing

    Outline Drawing 修正 19 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 21: General Specifications

    Lens mount C-mount Flange back 17.526mm Camera body grounding: insulation status Conductive between circuit GND and camera body *1 at the all pixel readout and Dual mode 20 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 22 Lens mount C-mount Flange back 17.526mm Camera body grounding: insulation status Conductive between circuit GND and camera body *1 at the all pixel readout and Dual mode 21 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 23 - As for the C-mount lens used combining this camera, the projection distance from bottom of the screw should use 8mm or less. Bottom of the screw C-mount lens 8mm or less 10mm or less 22 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 24: Led Status

    Flash orange (ON: 200ms, OFF: 800ms) 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) 23 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 25: I/O Specification

    Depending on cable length, cable kinds and input current of trigger input line, Random Trigger Shutter operation may not satisfy timing specification or camera may not receive EXT_TRIG signal. Please confirm it before use. 24 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 26 - Pin 3 of e-CON connector 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. 25 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 27 Depending on cable length, cable kinds and input current of trigger input line, Random Trigger Shutter operation may not satisfy timing specification or camera may not receive EXT_TRIG signal. Please confirm it before use. 26 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 28 * Even if LineMode is set as Output, the input signal to Line2 is valid when LineSource is set as Off. Input / Output circuit diagram 27 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 29 : High active / Low active (initial factory setting: Low active) Output signal : Off / UserOutput / Timer0Active / AcquisitionActive / FrameTriggerWait FrameActive / FrameTransferActive / ExposureActive (LineSource) 28 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 30 *Camera GND (e-CON connector Pin 3) and I/O_GND (Round connector Pin 5) are mutually isolated. It is also possible to connect them to common GND of your system. 29 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 31: Timing Specification

    [ms] Mono8 16.1 15.8 Bayer8 Dual mode Mono10/12 23.5 30.2 Bayer10/12 DDU1207 1/(Frame Rate setting) MG/MCG/MCF Mono8 16.1 30.1 Bayer8 Single mode Mono10/12 23.5 60.1 Bayer10/12 30 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 32 When the interval of the input trigger signal is extremely short, or when the trigger signal is noisy, there is a possibility of causing the malfunction. In this case, please input a proper trigger signal. 31 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 33 Toff [μs] Ton [μs] * Measured pulled up with 10k ohm register. * Toff and Ton are typical value. These values are changed in operating environment. 32 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 34: Typical Spectral Response

    Typical Spectral Response * The lens characteristics and light source characteristics is not reflected in table. ● DDU1207MG 33 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 35 ●DDU1207MCG ●DDU1207MCF 34 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 36: Operating Ambient Conditions

    90% or less (no condensation) Notes on Heat Radiation: The temperature of camera housing must be kept less than 60 °C. Please provide sufficient heat radiation depending on your installation. 35 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 37 TRIG IN(Line4) TRIG IN(Line4) TRIG IN(Line3) TRIG IN(Line3) GPIO(Line5) GPIO(Line5) GPIO(Line6) GPIO(Line6) I/O GND *Please confirm the EMC adaptability when it combines with parts other than them. 36 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 38: Functions

    Frame synchronization control LEDIndicatorLuminance LED luminance control AntiGlitch AntiGlitch control AntiChattering AntiChattering control DPCControl DPCControl Defect pixel correction control SequentialShutterControl SequentialShutterControl Sequential shutter control ChunkDataControl Chunk ChunkDataControl 37 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 39 AntiGlitch ○ ○ ○ AntiChattering ○ ○ ○ DPCControl ○ ○ ○ SequentialShutterControl ○ ○ ○ Chunk Details of each feature are described in following pages. 38 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 40: 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 39 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 41 0: Disable data transfer of the event 1: Enable data transfer of the event ● Note DDU 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.
  • Page 42: 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. D4289451A 41 / 172 Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 43: 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 42 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 44 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 D4289451A 43 / 172 Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 45 // 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. 44 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 46 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. 45 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 47: Scalable

    The window size is equal or less than maximum image size. ( X , Y )=( 4 * i , 2 * j ) A + 4 * m Scalable 46 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 48 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. D4289451A 47 / 172 Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 49 GetCamOffsetY vertical offset of image SetCamOffsetY Please refer to [Controlling camera feature functions] in [TeliCamAPI Library manual] for more detail. 48 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 50 // 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]); 49 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 51 Maximum unit size(*) 4096 x 3000 * initial factory setting ● Note Changing “Width”, “Height”, “OffsetX”, “OffsetY” register value is invalid during image stream data output. 50 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 52: 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) 51 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 53 Digital stage Analog stage Digital stage ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ 52 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 54 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. D4289451A 53 / 172 Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 55 // 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. 54 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 56 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. 55 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 57: 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) 56 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 58 Analog stage Digital stage ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ 57 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 59 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. D4289451A 58 / 172 Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 60 // 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. 59 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 61 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. 60 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 62: 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 D4289451A 61 / 172 Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 63 // 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. 62 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 64 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. 63 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 65: 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. D4289451A 64 / 172 Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 66 [13] : BayerRG10 [14] : BayerGB10 [15] : BayerBG10 [16] : BayerGR12 [17] : BayerRG12 [18] : BayerGB12 [19] : BayerBG12 Value 0x20241C Selects a pixel format D4289451A 65 / 172 Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 67 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 66 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 68 // 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"); 67 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 69 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. 68 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 70 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. 69 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 71: Testpattern

    TestPattern DDU 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) 70 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved.
  • Page 72 [2] : White [3] : GrayA [4] : GrayB [5] : GreyHorizontalRamp [6] : GrayScale [7] : ColorBar [8] : GreyVerticalRamp Value 0x21F13C Selects a Test pattern. D4289451A 71 / 172 Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 73 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. 72 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 74 = 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. 73 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 75: 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. D4289451A 74 / 172 Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 76 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. D4289451A 75 / 172 Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://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 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 78 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. 77 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 79 Absolute (Float) Value Raw Value 1012 1012 Initial Value Absolute (Float) Value 61.8 [fps] 61.8 [fps] Fomula Absolute Value [fps] = Raw Value * 125 / 2048 78 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 80 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. 79 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 81: 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. D4289451A 80 / 172 Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 82  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 81 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 83 = 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); 82 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 84 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. 83 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 85 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. 84 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 86: 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. 85 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 87 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’. 86 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 88 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. 87 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 89 SoftwareTrigger Implemented 0x207040 [31] Returns the state whether the function is implemented. ListOfElements 0x20702C [0] : Inactive ~0x207038 [8] : Impulse Value 0x20705C Executes software trigger. D4289451A 88 / 172 Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://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 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://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 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://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 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 93 [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. 92 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 94 // 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. 93 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 95 Round connector : 2 pin, Isoration input, High level 3.3 to 24.0V * initial factory setting TriggerDelay is applied to both of HardwareTrigger and SoftwareTrigger. TriggerAdditionalParameter is only effective in Bulk mode. 94 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 96: 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) D4289451A 95 / 172 Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://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 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 98 // ExposureAuto = "Auto" uint32_t uiExposureAuto = 2; // Set ExposureAuto = "Auto" Cam_WriteReg(s_hCam, 0x204028, 1, &uiExposureAuto); Please refer to [Camera functions] in [TeliCamAPI Library manual] for more detail. 97 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 99 16000.00 [us] Formula Absolute Value [us] = Raw Value / 60 ● Note In ExposureAuto mode, current exposure time will be reflected to ExposureTime value register. 98 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 100: Digitaliocontrol

    LineSource Timer0Active TimerControl UserOutput Line2 (GPIO_Input/Output) ExposureActive FrameTransfer FrameActive LineModeAll[1] FrameTriggerWait UserOutputValueAll[1] UserOutputValueAll[2] UserOutput UserOutputValueAll[5] Line1, 5, 6 UserOutputValueAll[6] (GPIO_Output) LineStatusAll[0]~[6] LineModeAll GPIO internal circuit diagram 99 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 101 UserOutputValue[0] ・ ・ ・ UserOutputValue ・ ・ ・ Line6 UserOutputValue[6] Line0 LineSource(Line0) ・ ・ ・ LineSource LineSource ・ ・ ・ Line6 LineSource(Line6) Details of each signal 100 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 102 [32] : UserOutput [64] : Timer0Active [99] : AcquisitionActive [106] : FrameTriggerWait [107] : FrameActive [115] : FrameTransferActive [123] : ExposureActive Value 0x2090DC Selects the source signal. D4289451A 101 / 172 Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 103 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. 102 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 104 [out] [out] [in] [in] [in] [out] [in] 66(※) [1] [1] [0] [0] [1] [1] [0] [out] [out] [in] [in] [out] [out] [in] * initial factory setting 103 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 105 [1] [1] [1] [1] [1] [1] [0] [on] [on] [on] [on] [on] [on] [off] [1] [1] [1] [1] [1] [1] [1] [on] [on] [on] [on] [on] [on] [on] * initial factory setting 104 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 106 [1] [1] [1] [1] [1] [1] [0] [high] [high] [high] [high] [high] [high] [low] [1] [1] [1] [1] [1] [1] [1] [high] [high] [high] [high] [high] [high] [high] 105 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 107  LineSelector Selects the I/O line to output by ‘LineSelector’. Integer value and string value of Enumeration are as follows. Integer String Line1 Line2 Line5 Line6 106 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 108 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. 107 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 109 - Line1, 5, 6 is dedicated output. - Line2 is bi-directional. The default direction is output. For [Timer0Active] signal, please refer to [TimerControl] Section for more detail. 108 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 110: 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 109 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 111 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) D4289451A 110 / 172 Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 112 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. 111 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 113 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 112 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 114: Timercontrol

    TRIG_IN (Line0) Trigger (Frame Start Trigger) TriggerDelay Exposure EXPOSURE ACTIVE TIMER0 ACTIVE TimerTriggerSource = Line0Active Delay Duration TimerTriggerSource = FrameTrigger TimerTriggerSource = ExposureStart ※ ActiveLow Timer0Active 113 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 115 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. D4289451A 114 / 172 Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 116 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. 115 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 117 // 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. 116 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 118 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]. 117 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 119: 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) D4289451A 118 / 172 Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 120 Operates Auto mode. // GenICam node handle CAM_NODE_HANDLE hNode = NULL; // Retrieve GenICam node. Nd_GetNode(s_hCam, “GainAuto”, &hNode); // Set GainAuto = “Auto” Nd_SetEnumStrValue(s_hCam, hNode, “Auto”); 119 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 121 Initial Value 0.00 [dB] Formula Absolute Value [dB] = Raw Value / 10 ● Note In GainAuto mode, current Gain will be reflected to Gain value register. 120 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 122: 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. D4289451A 121 / 172 Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 123  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 122 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 124: 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. D4289451A 123 / 172 Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 125 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 124 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 126: Sharpness

    Get minimum and maximum value GetCamSharpness Get current Sharpness value SetCamSharpness Set new Sharpness value Please refer to [Controlling camera feature functions] in [TeliCamAPI Library manual] for more detail. D4289451A 125 / 172 Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 127 Please refer to [Camera functions] in [TeliCamAPI Library manual] for more detail.  Minimum/Maximum Value Gain Raw Value Absolute (Integer) Value Minimum Maximum Initial Value Formula Absolute Value = Raw Value 126 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 128: 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 127 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 129 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) D4289451A 128 / 172 Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 130 // 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); 129 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 131 // 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. 130 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 132 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. 131 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 133: 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 132 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 134 0x2040D4 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) D4289451A 133 / 172 Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 135 // 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. 134 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 136 Initial Value 0.0[EV] Formula Absolute Value [EV] = Raw Value / 10 ● Note *The camera operation is not supported when the Random Trigger Shutter mode. 135 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 137: 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. D4289451A 136 / 172 Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 138 // 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. 137 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 139 = 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 138 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 140: 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. 139 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 141 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. D4289451A 140 / 172 Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 142 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. 141 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 143 = 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. 142 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 144 // 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. 143 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 145: 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. 144 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 146 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. D4289451A 145 / 172 Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 147 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. 146 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 148: 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. D4289451A 147 / 172 Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 149 // 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. 148 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 150: 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 D4289451A 149 / 172 Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 151  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 150 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 152: 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. D4289451A 151 / 172 Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 153 // 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. 152 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 154 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 153 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 155 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 154 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 156: 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 155 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 157 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. D4289451A 156 / 172 Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 158 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 D4289451A 157 / 172 Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 159 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); 158 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 160 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. 159 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 161 // 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. 160 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 162: Sequentialshuttercontrol

    Sets the UserSet number to register to the second sequence. … … … … … Value[15] 0x500078 Sets the UserSet number to register to the 16 sequence. 161 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 163 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. 162 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 164 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. 163 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 165 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 164 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 166 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 Sharpness TimerDuration LUTControl LUTEnable CounterAndTimerControl TimerDelay 165 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 167: Appendix

    USB Bus Frame #1 Frame #2 Frame #3 Tact Time Overhead - ImageSize Save - ExposureTime UserSet1 UserSet1 - Gain UserSet - ... FPGA Serial Flash 166 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 168 Save to Serial Flash if necessary. Quick - ImageSize Save Save - ExposureTime UserSet1 UserSet1 UserSet1 UserSet1 - Gain UserSet UserSet - ... Internal RAM FPGA Serial Flash 167 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 169: 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 168 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 170 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 169 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 171 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 170 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 172: 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 171 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...
  • Page 173: 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 website or sales personnel. 172 / 172 D4289451A Copyright © 2019 Toshiba Teli Corpotration, All rights reserved. http://www.toshiba-teli.co.jp/en/...

This manual is also suitable for:

Ddu1207m seriesDdu1207mgDdu1207mcgDdu1207mcf

Table of Contents