AVT Goldeye Technical Manual SWIR Cameras with GigE interface (P) SWIR Cameras with Camera Link interface (CL) V2.4.
Legal notice Life support applications These products are not designed for use in life support appliances, devices, or systems where malfunction of these products can reasonably be expected to result in personal injury. Allied Vision Technologies customers using or selling these products for use in such applications do so at their own risk and agree to fully indemnify Allied Vision Technologies for any damages resulting from such improper use or sale.
Contents Contacting Allied Vision Technologies ................................................... 6 Introduction ............................................................................................................ 7 Document history............................................................................................................ 7 Manual overview .............................................................................................................
Serial interface (pin 7, 8) ........................................................................................... 38 Mode input (pin 9) .................................................................................................... 38 Trigger input (pin 10, 11) ........................................................................................... 39 Exposure output (pin 12, 13) ......................................................................................
Appendix ..................................................................................................................76 Command reference ....................................................................................................... 76 GigE Vision feature mapping to serial commands ................................................................. 88 GigE Vision feature reference for AVT Goldeye cameras .......................................................... 89 DeviceInformation ...........
Contacting Allied Vision Technologies Info • Technical information: http://www.alliedvisiontec.com • Support: support@alliedvisiontec.com Allied Vision Technologies GmbH (Headquarters) Taschenweg 2a 07646 Stadtroda, Germany Tel: +49 36428-677-0 Fax: +49 36428-677-28 e-mail: info@alliedvisiontec.com Allied Vision Technologies Canada Inc. 101-3750 North Fraser Way Burnaby, BC, V5J 5E9, Canada Tel: +1 604-875-8855 Fax: +1 604-875-8856 e-mail: info@alliedvisiontec.com Allied Vision Technologies Inc.
Introduction This AVT Goldeye Technical Manual describes in depth the technical specifications, dimensions, all pixel formats, image processing, basic and advanced parameters and related subjects. Note Please read through this manual carefully. We assume that you have read already the How to install a GigE camera (Bigeye/Pearleye/Goldeye) and that you have installed the hardware and software on your PC or laptop (GigE interface card, cables etc.). For Goldeye CL-...
Version Date Description continued from previous page V2.1.0 23.01.12 [continued] [continued] [continued] • • • • V2.2.0 30.04.12 • • • • • V2.3.0 01.11.
Manual overview This manual overview outlines the contents of each chapter of this manual. • Chapter Contacting Allied Vision Technologies on page 6 lists AVT contact data (phone numbers and URLs) for both: – Technical information / ordering – Commercial information • Chapter Introduction on page 7 (this chapter) gives you the document history, a manual overview (short description of each chapter) and conventions used in this manual (styles and symbols).
Conventions used in this manual To give this manual an easily understood layout and to emphasize important information, the following typographical styles and symbols are used: Styles Style Function Example Bold Programs, inputs or highlighting bold important things Courier Code listings, camera output etc.
Note Please read through this manual carefully before operating the camera. Safety warnings Caution Electrostatic discharge The camera contains sensitive electronic components that can be destroyed by electrostatic discharge. Use sufficient grounding to minimize the risk of damage. Models with Camera Link interface (Goldeye CL-...): First connect CL camera and frame grabber with Camera Link data cable, then supply power to the CL camera.
Note Warm-up period Depending on the prevailing environmental conditions, some time might pass after the camera start, until the image quality reaches its optimum. A warm up period of 20 minutes is recommended.
Conformity Conformity Allied Vision Technologies declares under its sole responsibility that all standard cameras of the AVT Goldeye family that this declaration relates to, are in conformity with the following standard(s) or other normative document(s): • CE, following the provisions of 2004/108/EG directive • RoHS (2011/65/EU) CE We declare, under our sole responsibility, that the previously described AVT Goldeye cameras conform to the directives of the CE. Goldeye Technical Manual V2.4.
Specifications Specifications Note Timing changes in this chapter are valid: • • • starting SN 00102 (P-032) SN 00308 (P-008) For older versions: contact AVT Technical Support. Goldeye P-008 SWIR / Goldeye P-008 SWIR Cool Caution Surge To avoid damage caused by surge, connect the camera to an AC/DC power supply. Use a certified industrial power supply that complies with common industrial standards. Make sure the polarization of the power supply is correct.
Specifications Feature Specification Cooling Goldeye P-008 SWIR Cool only: Peltier cooled +0 °C stabilized ADC 14 bit Digital interface Gigabit Ethernet, IEEE 802.
Specifications Goldeye CL-008 SWIR/ Goldeye CL-008 SWIR Cool Note The warranty becomes void because of unauthorized tampering or any modifications not approved by the manufacturer. Timing changes (frame rates and exposure time) in this chapter are valid starting SN 00102 (Goldeye P-032) or SN 00308 (Goldeye P-008). Caution Surge To avoid damage caused by surge, connect the camera to an AC/DC power supply. Use a certified industrial power supply that complies with common industrial standards.
Specifications Feature Specification Digital output 12 bit Digital interface Camera Link Base Smart features Switchable gain (factor 10 at short exposure times), built-in correction data sets, gain/offset correction (NUC/non-uniformity) for each pixel, bad pixel correction, background (FPN) correction, continuous mode (image acquisition with maximum frame rate), image on demand mode (triggered image acquisition) With AVT‘s AcquireControl software: pseudo color LUT with several color profiles, auto c
Specifications Goldeye P-032 SWIR Cool / Goldeye P-032 SWIR F-Mount Cool Note The warranty becomes void because of unauthorized tampering or any modifications not approved by the manufacturer. Timing changes (frame rates and exposure time) in this chapter are valid starting SN 00102 (Goldeye P-032) or SN 00308 (Goldeye P-008). Caution Surge To avoid damage caused by surge, connect the camera to an AC/DC power supply.
Specifications Feature Specification Frame rate up to 30 fps Exposure time 5 μs to 1 s Cooling Peltier cooled - 5 °C stabilized ADC 14 bit Digital interface Gigabit Ethernet, IEEE 802.
Specifications Goldeye CL-032 SWIR Cool / Goldeye CL-032 SWIR F-Mount Cool Note The warranty becomes void because of unauthorized tampering or any modifications not approved by the manufacturer. Timing changes (frame rates and exposure time) in this chapter are valid starting SN 00102 (Goldeye P-032) or SN 00308 (Goldeye P-008). Caution Surge To avoid damage caused by surge, connect the camera to an AC/DC power supply.
Specifications Feature Specification Digital interface Camera Link Base Smart features Switchable gain (factor 20 at short exposure times), built-in correction data sets, gain/offset correction (NUC/non-uniformity) for each pixel, bad pixel correction, background (FPN) correction, continuous mode (image acquisition with maximum frame rate), image on demand mode (triggered image acquisition) With AVT‘s AcquireControl software: pseudo color LUT with several color profiles, auto contrast, auto brightness
Specifications Spectral sensitivity Figure 1: Spectral sensitivity of Goldeye P-008 SWIR / Goldeye P-008 SWIR Cool / Goldeye CL-008 SWIR / Goldeye CL-008 SWIR Cool Figure 2: Spectral sensitivity of Goldeye P-032 SWIR Cool / Goldeye P-032 SWIR F-Mount Cool / Goldeye CL-032 SWIR Cool / Goldeye CL-032 SWIR F-Mount Cool Goldeye Technical Manual V2.4.
Camera dimensions Camera dimensions Goldeye P-008 SWIR Goldeye CL-008 SWIR Figure 3: Camera dimensions: Goldeye P-008 SWIR Goldeye CL-008 SWIR (front/side GigE/side CL) Goldeye Technical Manual V2.4.
Camera dimensions Figure 4: Camera dimensions: Goldeye P-008 SWIR Goldeye CL-008 SWIR (back GigE/back CL) LED Color Description L2 Red Camera is operational L3 Red Continuous mode: on: continuous off: image on demand Power Green Power indicator L4 Red Trigger input activity L5 Red Frame output activity Table 7: Description of LEDs: Goldeye P-008 SWIR LED Color Description L1 Green Power indicator L2 Red Camera is operational L3 Red Continuous mode: on: continuous off: image o
Camera dimensions Goldeye P-008 SWIR Cool Goldeye CL-008 SWIR Cool Figure 5: Camera dimensions: Goldeye P-008 SWIR Cool Goldeye CL-008 SWIR Cool (front/side GigE/side CL/back GigE/back CL) Goldeye Technical Manual V2.4.
Camera dimensions Figure 6: Camera dimensions: Goldeye P-008 SWIR Cool Goldeye CL-008 SWIR Cool (back GigE/back CL) LED Color Description L2 Red Camera is operational L3 Red Peltier cooling state off: sensor temperature is OK Power Green Power indicator L4 Red Trigger input activity L5 Red Frame output activity Table 9: Description of LEDs: Goldeye P-008 SWIR Cool LED Color Description L1 Green Power indicator L2 Red Camera is operational L3 Red Peltier cooling state off: sen
Camera dimensions Goldeye P-032 SWIR Cool Goldeye CL-032 SWIR Cool Figure 7: Camera dimensions: Goldeye P-032 SWIR Cool / Goldeye CL-032 SWIR Cool (front/side C-Mount GigE/side C-Mount CL/back GigE/back CL) Goldeye Technical Manual V2.4.
Camera dimensions LED Color Description L2 Red Camera is operational L3 Red Peltier cooling state off: sensor temperature is OK Power Green Power indicator L4 Red Trigger input activity L5 Red Frame output activity Table 11: Description of LEDs: Goldeye P-032 SWIR Cool LED Color Description L1 Green Power indicator L2 Red Camera is operational L3 Red Peltier cooling state off: sensor temperature is OK Table 12: Description of LEDs: Goldeye CL-032 SWIR Cool Goldeye Technical
Camera dimensions Goldeye P-032 SWIR F-Mount Cool Goldeye CL-032 SWIR F-Mount Cool Figure 8: Camera dimensions: Goldeye P-032 SWIR F-Mount Cool / Goldeye CL-032 SWIR F-Mount Cool (front/side F-Mount GigE/side F-Mount CL/back GigE/back CL) Goldeye Technical Manual V2.4.
Camera dimensions LED Color Description L2 Red Camera is operational L3 Red Peltier cooling state off: sensor temperature is OK Power Green Power indicator L4 Red Trigger input activity L5 Red Frame output activity Table 13: Description of LEDs: Goldeye P-032 SWIR F-Mount Cool LED Color Description L1 Green Power indicator L2 Red Camera is operational L3 Red Peltier cooling state off: sensor temperature is OK Table 14: Description of LEDs: Goldeye CL-032 SWIR F-Mount Cool Go
Start-up Start-up Depending on the camera interface a Camera Link frame grabber or a a Gigabit Ethernet port (1000Base-T) on the host computer is necessary. 1. Connect the camera with the appropriate data cable to the computer. 2. Plug the 15-pin connector of the power supply to the camera. 3. Switch on the power supply.
Start-up Goldeye xy-008...
Start-up Camera control commands To configure the internal image processing, a serial command interface is provided. By default this command interface is internally routed to the Camera Link port, but the RS232 signals at the 15 pin D-sub connector may also be used. Camera Link To access it, a serial terminal program employing the serial port of the Camera Link frame grabber or a PC’s RS-232 COM port is required.
Start-up Sign Description B Command or parameter letter (upper and lower case letter have different meaning) = Equals sign (0x3D) wxyz 1-4 digits long value in hexadecimal number representation (capital letters) [CR] Carriage Return (0x0D) [LF] Line Feed (0x0A) Table 17: Scheme of serial commands Example (activate correction data set number 0): 1. The user sends the four characters S=0[CR] 2. The camera answers with seven characters S=0[CR][CR][LF]> 3.
Start-up Adjust the image processing Subsequently, the important commands for quick starting the image correction of the Goldeye xy-... are mentioned. All further parameters and a description of the correction modules can be found in Chapter Image processing on page 54. The camera is configured ex factory with parameter settings that ensure a basic image correction. Usually the Goldeye xy-... is equipped with multiple correction data sets for different operation conditions.
Start-up (...) # S=13 19 Highgain, 100ms # +==================================================+ >S=E > Note For more information see Chapter Image processing on page 54. Goldeye Technical Manual V2.4.
Camera interfaces Camera interfaces This chapter gives you information on the control junction, inputs and outputs and trigger features. Note Timing specifications in this chapter are valid: • • • starting SN 00102 (P-032) SN 00308 (P-008) For older versions: contact AVT Technical Support. www For accessories such as cables see: http://www.alliedvisiontec.com/emea/products/ accessories/gige-accessories.
Camera interfaces Pin Signal 9 Direction Mode Input 10 Trigger (Reset) 11 Input Level Description optocoupler input + 12 Exposure Output - optocoupler input optocoupler output 13 + 14 Line Sync Out Active low 15 Frame Sync Output Out Active low Table 18: Camera I/O connector pin assignment (Goldeye xy-...) This connector is intended for the power supply as well as for controlling the camera by the user. Furthermore some output signals are available, showing the camera state.
Camera interfaces Figure 9: Mode input diagram The current (1) that flows through the optocoupler and the integrated dropping resistor should be > 5 mA and should not exceed 20 mA. Input pin 9: open/GND means continuous operation 5 V ... 20 V means image on demand Trigger input (pin 10, 11) This input allows control of the electronic shutter by an externally applied signal. It is necessary to switch the camera into image-on-demand mode to enable direct exposure control.
Camera interfaces Exposure output (pin 12, 13) Figure 11: Exposure output diagram Caution The current that flows through the optocoupler should not exceed 20 mA (at 12 V, Rv 600 ). The exposure output indicates the active exposure time of the sensor in the image-on-demand operation. After end of exposure the 256 (Goldeye xy-008) or 508 (Goldeye xy-032) lines of the sensor are read out to the digital output. Line-sync output (pin 14) 2.5 μs 2.
Camera interfaces Frame-sync output (pin 15) The frame-sync output is only active in continuous operation.. 1 line = 32 μs 1 line = 63.8 μs 8.45 ms / 264 lines 5.38 ms / 168 lines Goldeye xy-008 5 Vss (no-load operation) 5 Vss (no-load operation) 33.0 ms / 517 lines Goldeye xy-032 Figure 13: Frame-sync output diagram The frame-sync output (active low) supplies approx. 900 mV at a termination with 75 . Goldeye Technical Manual V2.4.
Data interface Data interface The Goldeye xy-008/032 camera models are available in two different data interface versions, Camera Link Base and Gigabit Ethernet. In the following paragraphs first the Camera Link interface is described. To better understand the Gigabit Ethernet version it is important to know that this camera internally uses Camera Link compatible signals. The adaptation to Gigabit Ethernet is done by a third-party Camera Link frame grabber inside the camera.
Data interface Camera Cable Frame grabber Figure 14: Camera Link signals in base configuration (Goldeye CL-...) Goldeye Technical Manual V2.4.
Data interface Pin assignment of Camera Link connector (base configuration) Pin Signal Pin Signal 1 GND 14 GND 2 X0- 15 X0+ 3 X1- 16 X1+ 4 X2- 17 X2+ 5 XCLK- 18 XCLK+ 6 X3- 19 X3+ 7 SerTC+ P* 20 SerTC- P* 8 SerTFG- P* 21 SerTFG+ P* 9 CC1- 22 CC1+ 10 CC2+ 23 CC2- 11 CC3- 24 CC3+ 12 CC4+ 25 CC4- 13 GND 26 GND Table 19: Pin assignment: Camera Link connector (base) *: Instead of the serial interface over the Camera Link connection (SerTC, SerTFG) the seri
Data interface The camera can be single triggered or periodically triggered with a fixed frame rate (tp) up to the maximum frame rate of 118 fps (Goldeye xy-008) or 30 fps (Goldeye xy-032). Figure 15: Trigger input diagram Goldeye xy-008 Goldeye xy-032 tP: Trigger period tP: Trigger period tEXP: Exposure time tEXP: Exposure time tR: Readout time tR: Readout time tR = 8.2 ms (320 x 256) tR = 32.4 ms tR = 5.
Data interface In the Goldeye P-variants the CC1 signal is directly controlled using GigE Vision features located in the AcquisitionControl branch of the feature tree. Feature Description AcquisitionMode This feature controls the acquisition mode of the software. This feature works independently (!) of the chosen camera mode (Continuous, IOD hardware trigger, IOD hardware timer). It describes how many frames should be acquired. AcquisitionStart Starts the image acquisition of the camera.
Data interface For more information about the DVAL signal and pixel multiplication background: see Chapter Timing (FVAL, LVAL, DVAL, PCLK) on page 48. GigE feature name (CameraSpecialFeatures) Feature visibility Description HighSpeedMode Beginner Turn on or off the high-speed mode with reduced resolution (320x256 @118 fps / 320x160 @186 fps) Table 23: Camera special feature: High-speed mode Gain (CC3) With the camera control signal CC3 the camera gain can be switched.
Data interface GigE feature name (AcquisitionControl) Feature visibility Description TriggerMode Beginner Modifies the trigger mode of the camera. When the trigger mode is Off, the camera will generate frames independently. When the trigger mode is On, the camera is switched to the image-on-demand (IOD) mode. In this mode the camera waits for an external trigger signal or a timer pulse. To control the exposure and the dark time trigger, mode must be switched to On.
Data interface The following diagrams illustrate these facts: Blanking 8 lines (256 μs) 264 lines (8.45 ms) Figure 16: Timing diagram: Goldeye xy-008 (320x256) Goldeye Technical Manual V2.4.
Data interface Figure 17: Timing diagram: Goldeye xy-008 (320x160) Goldeye Technical Manual V2.4.
Data interface Blanking 34 pixels (3.24 μs) 670 pixels (63.81 μs) 508 lines (32.414 ms) Blanking 9 lines (574 μs) 517 lines (33.0 ms) Figure 18: Timing diagram: Goldeye xy-032 Goldeye Technical Manual V2.4.
Data interface Camera Link output data specification The image pixel data is output as 12-bit values. A bit assignment for 12-bit grey values according to the Camera Link specification is used. Camera Link Port (1 x 12 Bit) A0 D0 (LSB) A1 D1 A2 D2 A3 D3 A4 D4 A5 D5 A6 D6 A7 D7 B0 D8 B1 D9 B2 D10 B3 D11 (MSB) B4 B5 B6 B7 C0 C1 C2 C3 C4 C5 C6 C7 Table 26: Output data specification Goldeye Technical Manual V2.4.
Data interface GigE interface The Goldeye P-008/032 cameras are equipped with a 1000Base-T Ethernet interface (RJ45 (8P8C) connector). The data connection between the camera and PC can be established via a standard patch cable of category 5e or better. Note For more information see the Pleora iPORT PT1000-VB Documentation.
Image processing Image processing This chapter explains the function of the Goldeye xy-... firmware. It is related to the individual modules of image processing and shows how the user can control these modules via the serial interface. Image processing chain The Goldeye xy-... firmware has various correction modules that are combined in a chain. A module receives the source image data at the input, processes them and supplies at the output the modified data further to the next module.
Image processing Note Each module can have various parameters that control the operation mode. In the Figure 20: Data processing: Goldeye xy-... on page 54 and within the text of this manual, these parameters are always marked by Courier bold font in order to highlighting them to be parameters (or commands) adjustable via the serial interface. For fast access, all available correction data (e.g.
Image processing Correction data Ex factory camera specific correction data for each correction module are determined and stored in the camera so that an optimum image quality is available at the Camera Link or Gigabit Ethernet interface. A PC with a Camera Link frame grabber or Gigabit Ethernet interface can transmit the image data directly to the main memory or rather to the display.
Image processing Short introduction: Two-point correction (A, B, E, J, K, N) The two-point correction is the most elaborate correction module of the Goldeye xy-... camera models. For this reason initially a general survey of the two-point correction functioning shall be given. Note For more information see Chapter Basic parameters and commands on page 59.
Image processing The reference images are stored in several files within the flash and are directly transferred into the correction memory following the camera start-up. The parameter A indicates the file number of the correction image at low reference light level TA. The parameter B serves the same purpose for the reference image at light level TB.
Basic parameters and commands This chapter illustrates the basic configuration options and general commands available for the user, being important for the operation of an ex factory preconfigured camera. Most probably the information stated here will be sufficient for most of the users. Note For more information see Chapter Advanced parameters and commands on page 63.
>k=0[CR] S=0A > Goldeye xy-008 If k is not set to 0 the automatic search starts at approx. each k * 256 images. At a frame rate of e.g. 50 images per second the chronological resolution of the k value is approx. 5.1 seconds. Goldeye xy-032 If k is not set to 0 the automatic search starts at approx. each k * 256 images. At a frame rate of e.g. 30 images per second the chronological resolution of the k value is approx. 8.53 seconds.
The memory pages are filled with data starting at the address 0. The highest valid address depends on the number of correction data sets stored in the camera, however it can not exceed 31 (0x1F). If e.g. 27 correction data sets are available this results in a maximum valid page address of 0x1A. Both parameters, A and B together, affect the choice and the number of data sets to be loaded.
Software version and correction data information (V) The command V=1 shows information of the correction data installed in the non-volatile memory. The current firmware version and also the serial number of the camera are output. Note This function is not available as GigE Vision feature. Current parameter settings (Y) The command Y=1 shows the actual set parameter values. Note This function is not available as GigE Vision feature.
Advanced parameters and commands This chapter illustrates the advanced configuration of the Goldeye xy-... models. Note In most cases, the use of basic commands is sufficient. In some cases you might need the following advanced parameters and commands.
Value Description 4 One-point correction: Simple subtraction of the correction data A from the input data. In addition, the set value J is added as offset to each pixel value. 5 One-point correction: Simple subtraction of the correction data B from the input data. In addition, the set value K is added as offset to each pixel value. Table 32: Parameter E: values Note (*) Test modes 2 and 3 are for test purposes. If you activate mode 2 or 3, the module does not transmit any incoming image data.
The parameters A and B define both files out of which the reference images for the two-point correction data are loaded. If various correction data sets are available, each of the reference images in the file system is stored in a closed sequence of file numbers. The loading process following the camera start begins at the first cold (low) reference image A. Then the loading process continues with the accompanying warm (high) reference image B.
Bit position Value (12-bit) 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 211 210 29 28 27 26 25 24 23 22 21 20 - - - - x 0 Table 33: J and K: bit usage Example The digital set value for the dark reference image is x = 410 = 0x19A. >J=19A0[CR] GigE Feature Name Feature Visibility Description TPC_OperationMode Expert Operation mode of the two-point correction.
a special value to parameter A, the recording of a low (dark) reference image can be started now, or when assigning to parameter B the recording of a high (light) reference image. Example New recording of a low reference image of the two-point correction within actual correction memory page S. >A=FF[CR] In this case, the special parameter value FF is not a file number, but starts an integration of 64 single images and transfers the result into the correction storage.
The bits of the parameter value are divided into three different sized bit groups a, b and c. Each bit group has a special function, being independent of the other ones: • a: Controls the output of background correction module. Besides the normal background correction mode, the actual memory content (H/U) of the integrator can also be output. In this case the correction module becomes an image source itself. It provides a simple image storage function.
Integration of 32 images simultaneously to the output of the actual integration image (a=2, b=6) => abbba = 11100 [binary] = 0x1A. After that, reactivate the background correction. Command sequence >U=1A[CR] ...wait for at least 34 image cycles (32 + 2 frames jitter buffer, 0.85 seconds at 40 images / second) or poll the state of bit group c with Y=1... >U=1[CR] The parameter M defines the offset value that is added to each pixel if the background correction is activated.
The bad pixel correction applies up to six non-false neighbor pixels, in order to determine an interpolated value from the neighbors. At the position of the bad pixel an interpolated value in exchange of the bad pixel value is output. The parameter F controls the operation mode of the bad pixel correction. The following value assignment is applied: Value Description 0 Bad pixel correction deactivated; output of the uncorrected data. 1 Bad pixel correction is applied.
Integrator and image store (H) The integrator / image store module is internally applied for the automatic selection of the correction set (k=) and the recording of new temporary reference image data (A=FF, B=FF). Furthermore this module may also be controlled manually. The data are stored in the volatile SDRAM memory. They are lost after the camera is switched off. The bits of the parameter value are divided into four different sized bit groups a, b, c and d.
H 0 Operation Mode Integrator/Image Store Bit group a b E D C B A 9 8 7 6 5 4 3 2 1 0 - - - - - - - - d - c c b b b a ro Value (hex) rw rw rw rw rw rw Description 0 Output: deactivated. Data are passed through transparently. 1 Output: activated. Output of actual image storage content. 0 Integration: deactivated. The image storage content is not changed. 1 Integration: 1 image. The following image is copied into the image storage. 4 Integration: 8 images.
GigE Feature Name Feature Visibility Description IIS_OperationMode Expert Operation mode of the integrator and image store. (H= command) While reading this feature the MSB shows the state of the integration process (0=Idle, 1=Busy) Table 42: GigE feature: Integrator and image store (IIS) Baud rate (s) Caution Do not change the baud rate, if you control the camera via GigE Vision features.
• • • s 2A a: Controls the configuration of the serial port. e: Controls the echo mode. x: Controls the baud rate of the serial port.
Save parameters into flash (X) Command X=1 stores all parameter values into a system file within the flash memory. After a restart of the camera they are automatically restored. However, neither newly recorded correction images, nor modified set values (J and K for all valid S) are stored and will therefore be lost after the camera is switched off.
Appendix Appendix Command reference This chapter describes the general command reference of the Goldeye xy-... firmware. It can be output to the camera’s serial interface by sending the command ?=1. Note The displayed command reference is for both: AVT Goldeye and AVT Pearleye camera families. See this command reference to verify, if a command is valid for your camera model.
Appendix At the beginning of a command sequence it is good practice to check the serial communication by sending just a [CR] to the camera and verify that the command prompt ">" is returned. There is an input buffer holding a few characters but no hardware handshake. Thus a sequence of commands should not be send to the camera without awaiting the intermediate input prompts. Otherwise the camera’s serial input buffer may overflow.
Appendix h= : Internal mode and control register. (*) <**kk_jjih_gfed_cbaa> \| \||| |||| ||\| | ||| |||| || +-a: Camera Link output mode. | ||| |||| || 00 -> 12 data bits per pixel. | ||| |||| || 01 -> 14 data bits per pixel. | ||| |||| || 10 -> 16 data bits per pixel. | ||| |||| || 11 -> 10 data bits per pixel. | ||| |||| |+---b: Destination of external trigger | ||| |||| | signal (GE interface only). See | ||| |||| | W= for details. | ||| |||| +----c: Current shutter state.
Appendix 10 -> 12 bits fast (e.g. NIR-300F, NIR-600; Goldeye CL-008, P-008 or P-032). 11 -> 14 bits multiplex (e.g. IRC-600, Pearleye P-030). i= : Fast AOI mode offset for Two Point Correction. This offset controls the starting point of correction data from memory, if NIR-300F/NIR-600 and Goldeye CL-008/P-008/P-032 mode is activated (see h=) and the CC2 signal from the grabber is low. This parameter is specified in number of pixels divided by 8.
Appendix | | | +-------f: | | +-----------g: method. Operation mode during image integration. See bit field "b" of parameter U= for description. Offset calculation method for the background correction (M=). 0 -> Set M= to the mean value of the newly captured background correction image. 1 -> (IRC-320/600, Pearleye P-007/030 only:) Set M= to a linear interpolated value depending om the current camera temperature. See parameter q= for correction data file.
Appendix represented in 16 bits fixed point two's complement notation. See parameter m= for more details about drift compensation. Changing this parameter may void ex factory calibration. p= : (IRC-320/600, Pearleye P-007/030 only:) User specified parameter for the temperature drift compensation. This is a value represented in 16 bits fixed point two's complement notation. The value is an additional offset value to fine adjust the camera.
Appendix | GigE interface only). | 11 -> Reserved. +-----------e: Echo suppression. 0 -> Each character received from the host is echoed back to it. 1 -> No echo. v= : View file. Dumps all bytes of the specified file to the serial interface. Raw data is output. If the file contains binary data it may disturb a connected terminal program. Please consider the available baud rate: large files may take several minutes to transfer. x=1 : Dump the complete processor RAM contents in hexadecimal format.
Appendix correction. Changing this parameter or the contents of the specified files may void ex factory calibration. 0 : No loading of any correction image. The memory content remains uninitialized at startup. 01..EF : The correction data is loaded from the indicated file. If the following number also exists within the flash, it is loaded into a second page of the correction memory. The actually data page for correction is selected depending on the grabber's CC2 signal state.
Appendix shares its memory with the background correction (U=). This means that a new captured image with the command H= overwrites the current image of the background correction. The difference between H= and U= is the position in the image processing chain: H integrates and outputs data always at the beginning of the chain, which is uncorrected camera raw data. U operates behind the two point correction and thus integrates the data output of the two point correction (see E=).
Appendix All set values are loaded together from the flash file N=. Changing this parameter may void ex factory calibration. K= : Define the set value for the warm (high) reference image of the two point correction. It is a 16 bits value of which the 12 (or 14) most significant bits currently are used. For each correction data set S= an own set value is stored. All set values are loaded together from the flash file N=. Changing this parameter may void ex factory calibration.
Appendix T=1 : Show sensor temperature warning state. <***b_***a> | | | +--a : Sensor temperature warning state (this bit | is only valid for cameras with peltier | temperature stabilization like e.g. IRC-300, | IRC-320, IRC-600, NIR-300P, NIR-600P; | Pearleye P-007/030, Goldeye (CL/P)-008 SWIR | Cool, Goldeye (CL/P)-032 SWIR Cool). | 0 -> The sensor temperature is OK. | 1 -> The sensor temperature is outside the | optimum range. This can result in a | negative influence on the image | quality.
Appendix U= : Operation mode of the background correction module. May automaticly be set to 1 by the command k, depending on the setting of parameter j. | | \_|| | +---~+--a : Output mode of the background correction | | module. Attention: split bit field! | | 00 -> Pass image data through unchanged. | | 01 -> Background correction activated. The | | current background correction image is | | subtracted from the input image and | | the offset (M=) is added.
Appendix GigE Vision feature mapping to serial commands The following table shows the assignment of the available GigE Vision features to the corresponding serial commands.
Appendix GigE Vision feature reference for AVT Goldeye cameras DeviceInformation Feature Description DeviceModeName Name of the attached camera model. DeviceID Unique 32-bit device ID of the AVT camera model. DeviceUserID User ID field. This field can be accessed (R/W) by the user to store an additional device identifier. DeviceScanType This feature specifies the scan type of the sensor (Areascan or Linescan).
Appendix AcquisitionControl Feature Description AcquisitionMode This feature controls the acquisition mode of the software. This feature works independently (!) of the chosen camera mode (Continuous, IOD hardware trigger, IOD hardware timer). It describes how many frames should be acquired. AcquisitionStart Starts the image acquisition of the camera. AcquisitionStop Stops the image acquisition of the camera. TriggerMode Modifies the trigger mode of the camera.
Appendix CameraSpecialFeatures Feature Description AutoCalibrateOnce Start the automatic calibration once. (k=0 command) The processing of this command can take several seconds, depending on the current image rate and the number of correction data sets available. AutoCalibrationMode Configure mode of the automatic calibration function. (j= command) AutoCalibrationInterval Setup the automatic calibration interval. 0 = Calibrate one-time, 1..65535 = Calibrate every k*256 frames.
Appendix CameraSpecialFeatures\TwoPointCorrection Feature Description TPC_OperationMode Operation mode of the two-point correction. (E= command) TPC_CorrectionData_FileNumber File number of the flash file containing the set values for the two-point correction. (N= command) TPC_SetValue_LowRef Define the set value for the low reference image of the two-point correction.
Appendix CameraSpecialFeatures\IntegratorAndImageStore Feature Description IIS_OperationMode Operation mode of the integrator and image store. (H= command) While reading this feature the MSB shows the state of the integration process. (0=Idle, 1=Busy) Table 55: Camera special feature: IntegratorAndImageStore CameraSpecialFeatures\BadPixelCorrection Feature Description BPC_OperationMode Operation mode of the bad pixel correction.
Index Index Numbers F 15-pin D-sub connector ............................. 37 file system .............................................. 56 Frame Sync Output.................................... 38 Frame-sync output.................................... 41 A automatic data set selection (k) ................................................... 59 B background correction............................... 55 (U, M)............................................... 67 bad pixel correction ..........................
Index optocoupler input..................................... 38 optocoupler output................................... 38 Goldeye P-008, Goldeye CL-008 ............. 22 Goldeye P-032, Goldeye CL-032 ............. 22 start-up.................................................. 31 styles ..................................................... 10 Support .................................................... 6 symbols.................................................. 10 P T parameter E values....................
