Page 1
China Daheng Group, Inc. Beijing Image Vision Technology Branch MARS GigE Cameras User Manual Version: V1.1.0 Date: 2022-06-28...
Page 2
All rights reserved. No parts of this manual may be used or reproduced, in any forms or by any means, without prior written permission of China Daheng Group, Inc. Beijing Image Vision Technology Branch. The right is also reserved to modify or change any parts of this manual in the future without prior notification. All other trademarks are the properties of their respective owners.
Page 3
The MARS family cameras are especially suitable for machine vision applications such as industrial inspection, medical, scientific research, education, security and so on. This manual describes in detail on how to install and use the MARS GigE digital cameras.
Page 8
9.3.2.2. Acquisition of Darkfield Images ................119 9.3.2.3. Acquisition of Brightfield Images ................121 9.3.2.4. Execute FFC ......................122 9.3.2.5. Read FFC Data from Device / Write FFC Data to Device ........122 9.3.2.6. Load FFC Data from File / Save FFC Data to File ........... 122 9.3.3.
1.2. Naming Rules Details of the MARS GigE series (MARS-G-P) camera are given in the general specifications below. Each camera model name is determined by its sensor's maximum resolution, maximum frame rate at maximum resolution, the color/monochrome type of the sensor, etc.
1.4. Document, CAD/Technical Drawing and Software Downloads Product related document, CAD/Technical drawing and software can be downloaded from the Downloads of DAHENG IMAGING website. The relevant contents are as follows: Document MARS GigE Cameras User Manual CAD/Technical Drawing DAHENG IMAGING MARS-G-P CAD/Technical Drawing Galaxy Windows SDK—USB3.0, GigE, MERCURY USB2.0 Cameras...
3.1. Host Preparation 3.1.1. Software Package The Software package of DAHENG IMAGING's MARS series is used to control the MARS series camera to provide stable, real-time image transmission, and provides a free SDK and abundant development sample source code. The package is composed of the following modules: Driver Package (Driver): This package provides the MARS series camera driver program, such as: the GigE Vision cameras' Filter Driver Program.
3.Installation Guidelines In addition, users can use some third-party software that supports Gen< i >Cam standard to control the camera, such as HALCON. GigE Vision interface The MARS series GigE Vision camera is compatible with the GigE Vision protocol, which allows the user to control the camera directly through the GigE Vision protocol.
3.Installation Guidelines Via the Hirose I/O port Camera can get power from the 12-pin Hirose I/O port via a standard I/O cable. Nominal operating voltage is +12V (± 10%) ~ +24VDC (± 10%). When you supply power to the camera both via the camera’s RJ-45 jack and via the 12-pin Hirose I/O port, the camera will get power via the Hirose I/O port.
3.Installation Guidelines 3.4. Camera IP Configuration The IP Configurator provided by GalaxySDK eliminates the need for users to configure IP for hosts and devices. Implement one-click configuration IP. You only need to follow the steps below to configure the camera IP. For details on how to use the tool, please refer to section 9.1. Connect the GigE camera to the network port of the current host.
4.General Specifications 4. General Specifications 4.1. Explanation of Important Parameters 4.1.1. About Spectral Response QE: Which is the ratio of the average number of photoelectrons produced per unit time to the number of incident photons at a given wavelength. Sensitivity: The change of the sensor output signal relative to the incident light energy. The commonly used sensitivity units are V/((W/m2) •s), V/lux •s, e-/((W/m2) •s) or DN/ ((W/m2) •s).
Page 19
4.General Specifications Synchronization Hardware trigger, software trigger 1 input and 1 output with opto-isolated, 2 programmable GPIOs Operating Temp. 0° C ~ 45° C Storage Temp. -20° C ~ 70° C Operating 10% ~ 80% Humidity Camera Power PoE (Power over Ethernet, IEEE802.3af compliant) or 12VDC-10%~24VDC+10%, Requirements supplied via the camera's 12-pin Hirose connector Power...
4.General Specifications Operating System Windows XP/Win7/Win8/Win10 32bit, 64bit OS Data Interface Fast Ethernet(100Mbit/s) or Gigabit Ethernet(1000Mbit/s) Programmable Image size, gain, exposure time, trigger polarity, flash polarity Control Conformity CE, RoHS, GigE Vision, GenICam Note: MARS-2622-4GM-P ETR uses Grade2 Sensor and MARS-2621-4GM-P ETR uses Grade1 Sensor. The difference defined by the sensor manufacturer between the two cameras only exists in the sensor chips’...
4.General Specifications Operating System Windows XP/Win7/Win8/Win10 32bit, 64bit OS Data Interface Fast Ethernet(100Mbit/s) or Gigabit Ethernet(1000Mbit/s) Programmable Image size, gain, exposure time, trigger polarity, flash polarity Control Conformity CE, RoHS, GigE Vision, GenICam Note: MARS-2622-4GM-P ETR uses Grade2 Sensor and MARS-2621-4GM-P ETR uses Grade1 Sensor. The difference defined by the sensor manufacturer between the two cameras only exists in the sensor chips’...
5.Dimensions Figure 5-3 MARS-3140-3GM/C-P-M02 mechanical dimensions 5.2. Optical Interface MARS-G-P cameras (except MARS-3140-3GM/C-P) are equipped with C-mount lens adapters. The back- flange distance is 17.526 mm (in the air). The maximum allowed thread length of lens should be less than 11.1mm, as shown in Figure 5-4.
Page 34
5.Dimensions It is recommended that you select the screw specifications and the tripod adapter step thickness from the table below: Screw Tripod adapter step Spring washer Screwing length of camera specification thickness (mm) thickness (mm) screw thread (mm) M4*8 screw M4*10 screw If the screw specification and the thickness of the tripod adapter do not conform to the requirement above, it may cause the camera thread hole through or thread stripping.
6.Filters and Lenses 6. Filters and Lenses 6.1. Filters The MARS color models are equipped with IR filters. The thickness of the filter is 0.7± 0.05mm, and the cut-off frequency is 700nm, which reduces the influence of invisible light on the image. The monochrome models are equipped with transparent glasses.
6.Filters and Lenses 6.2. Lens Selection Reference DAHENG IMAGING is a professional supplier for images and machine vision devices in China. In addition to industrial cameras, it also provides high-resolution, high-optical machine vision lenses for a wide range of industrial cameras on the market.
6.Filters and Lenses f = sensor size (horizontal or vertical) * Working distance / Field of View (corresponding to the horizontal or vertical direction of the sensor size) The corresponding lens is selected by the calculated focal length. 6.2.1. HN-2M Series The HN-2M series lenses are 2 megapixels lenses for industrial, suitable for sensors with max.
6.Filters and Lenses Easy to install, there are 3 fixing holes on the lens barrel for fixing the iris and focusing. The best fixing hole can be selected according to the installation environment Models: HN-0619-5M-C2/3X HN-0816-5M-C2/3X HN-1216-5M-C2/3X ...
6.Filters and Lenses 6.2.4. HN-20M Series The HN-20M series lenses are 20 megapixels lenses for industrial, suitable for sensors with max.image circle of 1". This series of lenses has the following features: 20 megapixels resolution, 8~75mm focal length available ...
6.Filters and Lenses HN-P-2528-6M-C2/3 HN-P-3528-6M-C2/3 HN-P-5028-6M-C2/3 6.2.6. HN-P-10M Series The HN-P-10M series lenses are 10 megapixels lenses for industrial, suitable for sensors with max.image circle of 2/3". This series of lenses has the following features: 10 megapixels resolution, 8~50mm focal length available ...
7.Electrical Interface 7. Electrical Interface 7.1. LED Light An LED light is set on the back cover of camera which indicates camera's status, as shown in Table 7-1. LED light can display 3 colors: red, yellow and green. LED status Camera status No power Solid red...
7.Electrical Interface Diagram Definition Core Color Description Line0+ Green Opto-isolated input + Blue PWR GND & GPIO GND Line0- Grey Opto-isolated input - Camera external power, POWER_IN Purple +12V DC~+24V DC Line2 Orange GPIO input/output Line3 Pink GPIO input/output Line1- White Green Opto-isolated output - Line1+...
Page 44
7.Electrical Interface Logic 0 input voltage: 0V ~ +2.5V (Line0+ voltage) Logic 1 input voltage: +5V ~ +24V (Line0+ voltage) Minimum input current: 7mA The status is unstable when input voltage is between 2.5V and 5V, which should be avoided ...
Page 45
7.Electrical Interface External circuit Power + Camera internal circuit Current limiting 3.3V Line0 resistor Signal output FPGA INPUT0 Line0- PWR GND Figure 7-3 PNP photosensor connected to opto-isolated input circuit Rising edge delay: < 50μs (0°C ~ 45° C), parameter description as shown in Figure 7-4 ...
7.Electrical Interface OUTPUT1 LINE1+ Figure 7-6 Parameter of opto-isolated output circuit Delay time (td): the response time from OUTPUT1 rises to 50% of amplitude to LINE1+ decreases to 90% of amplitude Falling time (tf): the response time for LINE1+ to decrease from 90% of the amplitude to 10% ...
7.Electrical Interface 7.3.3.1. Line2/3 is Configured as Input When Line2/3 is configured as input, the internal equivalent circuit of camera is shown in Figure 7-8, taking Line2 as an example: 3.3V External circuit Line2 INPUT2 Input+ Input- Figure 7-8 Internal equivalent circuit of camera when Line2 is configured as input To avoid the damage of GPIO pins, please connect GND pin before supplying power to Line2/3.
7.Electrical Interface External circuit 3.3V Camera internal circuit Power+ Signal FPGA INPUT2 output Line2 Pull-down resistor Figure 7-10 PNP photoelectric sensor connected to Line2 input circuit When Line2/3 is configured as input, if the corresponding output device is common-anode connected, pull- down resistor over 1K should not be used, otherwise the input voltage of Line2/3 will be over 0.6V and logic 0 cannot be recognized stably.
Page 50
7.Electrical Interface Parameter Test Conditions Value (μs) Storage time (ts) 0.17 0.18 Delay time (td) 0.08 0.09 Rising time (tr) 0.11 0.16 External power is 5V, pull-up resistor is 1kΩ Falling time (tf) 1.82 1.94 Rising time delay = tr+td 0.19 0.26 Falling time delay = tf+ts...
8.Features 8. Features 8.1. I/O Control 8.1.1. Input Mode Operation Configuring Line as input The MARS-G-P series camera has three input signals: Line0, Line2, and Line3. In which the Line0 is uni- directional opto-isolated input, Line2 and Line3 are bi-directional lines which can be configured as input or output.
8.Features Input Signal Delay Time 1000ms Trigger Delay Valid Signal Figure 8-2 Trigger delay schematic diagram Input Inverter The signal level of input lines is configurable for the MARS-G-P series camera. The user can select whether the input level is reverse or not by setting "LineInverter". For the MARS-G-P series camera, the default input line level is false when the camera is powered on, indicating that the input line level is not reversed.
Page 53
8.Features Strobe In this mode the camera sends a trigger signal to activate the strobe. The strobe signal is active low. After receiving the trigger signal, the strobe signal level is pulled low, and the pull-low time is the sum of the exposure delay time and the exposure time.
Page 54
8.Features Trigger Signal Exposure line by line Readout after exposure Exposure Time ExposureActive Figure 8-6 Electronic rolling shutter "ExposureActive" signal schematic diagram This signal is also useful when the camera or target object is moving. For example, suppose the camera is mounted on a robotic arm that can move the camera to different position.
Page 55
8.Features When the trigger mode is "FrameBurstStart", each time the camera receives a trigger signal, it will acquire multiple frames of image (the number of frames can be obtained by the function "AcquisitionFrameCount"). After receiving the trigger signal, the "AcquisitionTriggerWait" signal is pulled low and the camera starts the exposure transmission.
8.Features 8.1.3. Read the LineStatus Read the level of single line The MARS-G-P series camera can get the line's signal status. When the device is powered on, the default status of Line0 and Line1 is false, and the default status of Line2 and Line3 is true. Read all the lines level The MARS-G-P series camera can get the current status of all lines.
8.Features Trigger Acquisition Start Status … … Trigger … … Exposure … … Reading out Figure 8-11 Trigger acquisition process In trigger mode, sending AcquisitionStart command is not enough, a trigger signal is also needed. Each time a frame trigger is applied (including software trigger and hardware trigger), the camera will acquire and transmit a frame of image.
8.Features Acquisition stop during blanking Stop command Stop time Complete stop Exposure Ignored Reading out Figure 8-13 Acquisition stop during blanking After the camera transferred a whole frame, the camera goes into wait state. When user sends an AcquisitionStop command in wait state, the camera will return to stop-finished state. The camera will not send any frames even if it is just going to start the next exposing.
8.Features 1) When the trigger mode is set to On, the trigger type is FrameStart After executing the AcquisitionStart command, the camera waits for a trigger signal, which may be a software trigger or a hardware trigger of the camera. Each time the camera receives a trigger signal, it can acquire a frame of image until the AcquisitionStop command is executed.
8.Features For example, if the "Acquisition burst frame count" parameter is set to 3, the camera automatically acquires 3 images. Then, the camera waits for the next FrameBurstStart trigger signal. After receiving the next trigger signal, the camera will take another 3 images, and so on. Trigger Signal Image...
Page 61
8.Features Switch trigger mode during frame reading out Mode Continuous mode Trigger mode Continuous mode Trigger … … Acquisition frame2 frame3 frame4 frame5 frame6 frame7 … frame1 Camera Continuous Frame Trigger Frame Continuous Frame output Figure 8-17 Switch trigger mode during frame reading out As shown in Figure 8-17, the camera starts with trigger mode OFF after receiving acquisition start command.
8.Features 8.2.5. Continuous Mode and Configuration Continuous mode configuration The default value of Trigger Mode is OFF in default user set. If the camera is opened with default user set, the camera works in continuous mode directly. Otherwise, user can set Trigger Mode OFF to use continuous mode.
8.Features 8.2.7. Hardware Trigger Acquisition and Configuration Hardware trigger acquisition configuration The camera supports hardware trigger acquisition mode. Three steps followed should be ensured: Set the Trigger Mode to ON. Set the Trigger Source to Line0, Line2 or Line3. Connect hardware trigger signal to Line0.
Page 64
8.Features T4: The sensor timing sequence delay, the internal exposure of the sensor is aligned with the row timing sequence, so T4 has a maximum row cycle jitter. The value of each sensor is different. Some products with large delay time (several hundred μs or more) have additional configuration time counted in T4. Line0/2/3 Exposure start Image readout...
8.Features 8.2.8. Set Exposure Global Shutter The implementation process of global shutter is as shown in Figure 8-20, all the lines of the sensor are exposed at the same time, and then the sensor will read out the image date one by one. The advantage of the global shutter is that all the lines are exposed at the same time, and the images do not appear offset and distortion when capturing moving objects.
Page 66
8.Features The implementation process of electronic rolling shutter is as shown in Figure 8-21, different from the global shutter, electronic rolling shutter exposures from the first line, and starts the second line exposure after a row period. And so on, after N-1 line, the N line starts exposing. When the first line exposure ends, it begins to read out the data, and it need a row period time to read out one line (including the line blanking time).
8.Features quality. You can set the exposure time that is synchronized with the external light source by using the demo or interface function. The MARS-G-P series camera supports Auto Exposure feature. If the Auto Exposure feature is enabled, the camera can adjust the exposure time automatically according to the environment brightness. See section 8.3.4 for more details.
Page 68
8.Features Trigger Trigger Trigger Frame N Frame N+1 Frame N+2 Sensor Exposure Frame N Frame N+1 Sensor Readout Time Figure 8-23 The trigger acquisition exposure sequence diagram in non-overlaping exposure mode Overlaping exposure In overlaping exposure mode, the current frame image exposure process is overlaping with the readout of the previous frame.
8.Features Trigger Trigger Trigger Frame N Frame N+1 Frame N+2 Sensor Exposure Frame N Frame N+1 Sensor Readout Time Figure 8-25 The trigger acquisition exposure sequence diagram in overlaping exposure mode Compared with non-overlaping exposure mode, in overlaping exposure mode, the camera can obtain higher frame rate.
8.Features Note that increasing the analog gain or digital gain will amplify the image noise. Figure 8-26 The cameras response curve 8.3.2. Pixel Format By setting the pixel format, the user can select the format of output image. The available pixel formats depend on the camera model and whether the camera is monochrome or color.
Page 71
8.Features Mono8 When the pixel format is set to Mono8, the brightness value of each pixel is 8bits. The format in the memory is as follows: …… …… …… Among them Y00, Y01, Y02 … are the gray value of each pixel that starts from the first row of the image. Then the gray value of the second row pixels of the images is Y10, Y11, and Y12…...
Page 72
8.Features BayerRG8 When the pixel format is set to BayerRG8, the value of each pixel in the output image of the camera is 8 bits. According to the location difference, the three components of red, green and blue are respectively represented.
8.Features BayerGR8 When the pixel format is set to BayerGR8, the value of each pixel in the output image of the camera is 8 bits. According to the location difference, the three components of red, green and blue are respectively represented.
8.Features the image data from the sensor's designated region to the memory, and transfer it to the host, and the other regions' image of the sensor will be discarded. By default, the image ROI of the camera is the full resolution region of the sensor. By changing the OffsetX, OffsetY, width and height, the location and size of the image ROI can be changed.
8.Features the Width and Height are parameters for users captured image, then the AAROI setting need to meet the condition 1: AAROIWidth + AAROIOffsetX ≤ Width AAROIHeight + AAROIOffsetY ≤ Height If condition 1 is not met, the user cannot set the ROI. The default value of ROI is the entire image, you can set the ROI according to your need.
8.Features The expected gray value is set by the user, and it is related to the data bit depth. For 8bit pixel data, the expected gray value range is 0-255, for 10bit pixel data, the expected gray value range is 0-1023, and for 12bit pixel data, the expected gray value range is 0-4095.
8.Features AWBROIWidth + AWBROIOffsetX ≤ Width AWBROIHeight + AWBROIOffsetY ≤ Height If condition 2 is not met, the user cannot set the ROI. The default value of ROI is the entire image, you can set the "white dot" area (ROI) according to your need. Where the minimum value of AWBROIWidth can be set is 16, the maximum value is equal to the current image width.
8.Features The auto white balance feature is only available on color sensors. 8.3.6. Test Pattern The MARS-G-P series camera supports three test images: gray gradient test image, static diagonal gray gradient test image, and moving diagonal gray gradient test image. When the camera captures in RAW12 mode, the gray value of test image is: the pixel gray value in RAW8 mode multiplies by 16, as the output of pixel gray value in RAW12 mode.
8.Features Image rolling direction Figure 8-30 Moving diagonal gray gradient test image SlantLine In the static diagonal gray gradient test image, the first pixel gray value is 0, the first pixel gray value of adjacent row increases by 1, until the last row. When the pixel gray value increases to 255, the next pixel gray value returns to 0.
Page 80
8.Features Three operations can be performed on the configuration parameters, including save parameters (UserSetSave), load parameters (UserSetLoad), and set the startup parameter set (UserSetDefault). The UserSetSave is to save the effective configuration parameters to the user configuration parameter set which is set by the user. The UserSetLoad is to load the vendor default configuration parameters (Default) or the user configuration parameters (UserSet) to the current effective configuration parameters.
8.Features 8.3.8. Device User ID The MARS-G-P series camera provides programmable device user ID function, the user can set a unique identification for the camera, and can open and control the camera by the unique identification. The user-defined name is a string which maximum length is 16 bytes, the user can set it by the following ways: Set by the IP Configurator, for details please see section 9.1.2.5: Figure 8-32 IP Configurator...
8.Features 8.3.10. Binning The feature of Binning is to combine multiple pixels adjacent to each other in the sensor into a single value, and process the average value of multiple pixels or sum the multiple pixel values, which may increase the signal-to-noise ratio or the camera's response to light.
Page 84
8.Features Binning Factors Two types of Binning are available: horizontal Binning and vertical Binning. You can set the Binning factor in one or two directions. Horizontal Binning is the processing of pixels in adjacent rows. Vertical Binning is the processing of pixels in adjacent columns. Binning factor 1: Disable Binning.
8.Features 4) Mutually exclusive with Decimation Binning and Decimation cannot be used simultaneously in the same direction. When the horizontal Binning value is set to a value other than 1, the horizontal Decimation feature cannot be used. When the vertical Binning value is set to a value other than 1, the vertical Decimation feature cannot be used.
Page 86
8.Features Figure 8-40 Color camera horizontal Decimation Figure 8-39 Mono camera horizontal Decimation As a result, the image width is reduced. For example, enabling horizontal Decimation by 2 halves the image width. The camera automatically adjusts the image ROI settings. Horizontal Decimation does not (or only to a very small extent) increase the camera's frame rate.
8.Features 4) Mutually exclusive with Binning Decimation and Binning cannot be used simultaneously in the same direction. When the horizontal Decimation value is set to a value other than 1, the horizontal Binning feature cannot be used. When the vertical Decimation value is set to a value other than 1, the vertical Binning feature cannot be used. 8.3.12.
Page 88
8.Features Figure 8-45 The original image Figure 8-46 Reverse X and Y enabled Using Image ROI with Reverse X or Reverse Y If you have specified an image ROI while using Reverse X or Reverse Y, you must bear in mind that the position of the ROI relative to the sensor remains the same.
8.Features 8.3.13. Digital Shift The Digital Shift can multiply the pixel values by 2 of the images. This increases the brightness of the image. If your camera doesn't support the digital shift feature, you can use the Gain feature to achieve a similar effect. ...
8.Features Raw pi xel value(8bit): 45 Raw pi xel value(12bit): 726 Shift pi xel value(8bit): 181 Example 3: Digital Shift by 1, 12-bit Image Data, High Value Assume that your camera is using a 12-bit pixel format. Also assume that one of your original pixel values is 2839.
0~1023 MARS-2622-4GM-P NIR ETR 0~1023 Table 8-6 MARS GigE series camera black level adjustment range 8.3.16. Remove Parameter Limits The range of camera parameters is usually limited, and these factory limits are designed to ensure the best camera performance and high image quality. However, for certain use cases, you may want to specify parameter values outside of the factory limits.
Page 92
8.Features Auto Exposure 14~1000000 14~15000000 Gain 0~16 0~24 Auto Gain 0~16 0~24 Black Level 0~1023 0~1023 Sharpness 0~63 White Balance 0~15.998 0~31.998 component factor Auto White Balance 1~15.998 1~31.998 Exposure 14~1000000 14~15000000 Auto Exposure 14~1000000 14~15000000 Gain 0~16 0~24 Auto Gain 0~16 0~24 MARS-2622-4GM-P ETR...
8.Features Auto Gain 0~16 0~24 Black Level 0~1023 0~1023 Sharpness 0~63 Table 8-7 Parameter range of features supported before and after Remove Parameter Limits 8.3.17. User Data Area The user data area is a FLASH data area reserved for the user, and the user can use the area to save algorithm factors, parameter configurations, etc.
8.Features ExpsoureEnd ExpsoureEnd TimerTrigger Source TimerDelay TimerDelay Timer1 Timer1Active After the acquisition is stopped, the timer is immediately cleared and the Timer1Active signal goes low immediately. 8.3.19. Counter The camera only supports one counter (Counter1), which can count the number of FrameTrigger, AcquisitionTrigger and FrameStart signals received by the camera.
Page 95
8.Features vendor can use the software or hardware to convert the RGB value that is read to the standard RGB value. Because the color space is continuous, all the other RGB values that are read can be converted to the standard RGB values by using the mapping table created by the 24 colors.
8.Features Effect images Figure 8-52 Before color transformation Figure 8-53 After color transformation 8.4.2. Gamma The Gamma can optimize the brightness of acquired images for display on a monitor. 1) Prerequisites If the GammaEnable parameter is available, it must be set to true. 2) How it works The camera applies a Gamma correction value (γ) to the brightness value of each pixel according to the following formula (red pixel value (R) of a color camera shown as an example):...
8.Features The maximum pixel value (R ) equals, e.g., 255 for 8-bit pixel formats, 1023 for 10-bit pixel formats or 4095 for 12-bit pixel formats. 3) Enabling Gamma correction To enable Gamma correction, use the GammaValue parameter. The GammaValue parameter's range is 0 to 4.00.
8.Features Figure 8-54 Before sharpness adjustment Figure 8-55 After sharpness adjustment Sharpness adjustment Adjust the sharpness value to adjust the camera's sharpness to the image. The adjustment range is 0-3.0. The larger the value, the higher the sharpness. 8.4.4. Lookup Table When the analog signal that is read out by the sensor has been converted via ADC, generally, the raw data bit depth is larger than 8 bits, there are 12 bits, 10 bits, etc.
8.Features a) On cameras with a maximum pixel bit depth of 12 bits The LUTIndex selectable item is 0-4095, each LUTIndex corresponds to a LUTValue, and the LUTValue range is [0,4095]. b) On cameras with a maximum pixel bit depth of 10 bits The LUTIndex selectable item is 0-1023, each LUTIndex corresponds to a LUTValue, and the LUTValue range is [0,1023].
Page 100
8.Features Figure 8-56 Before FFC Figure 8-57 After FFC The Flat Field Correction Plugin can be used to obtain, save and preview the Flat Field Correction factor. The plugin interface is shown in Figure 8-58: Figure 8-58 Flat Field Correction Plugin interface There are three ways to obtain the Flat Field Correction factor: ...
8.Features In addition to the plugin, Flat Field Correction can be set to on/off in the camera feature. When set to on, Flat Field Correction factors stored in the camera can be used to correct the image. The following will describe: FFC factor calculation and preview, FFC factor reading and saving, file loading and saving.
8.Features 3. Acquisition of brightfield images: perform this function to complete the brightfield image acquisition. Figure 8-60 Acquisition of brightfield images It is recommended to align the white paper or the flat fluorescent lamp (to ensure the same amount of light in different areas of the sensor), and adjust the distance between the camera and the white paper/ flat fluorescent lamp to fill the entire field of view ...
8.Features 8.4.5.3. Load/Save File Load from file: Load the saved FFC factor file (format: .ffc) from the file Save to file: Save the current factor to the FFC factor file (format: .ffc) 8.4.6. Remove Template Noise Due to some defects in the sensor itself, the output image may have some regular horizontal stripes or vertical stripes.
8.Features 8.5. Image Transmission 8.5.1. Maximum Allowable Frame Rate The maximum allowable frame rate of the network The maximum allowable frame rate of the network is the camera's maximum transmission frame rate that the current network supports. The maximum frame rate that the MARS-G-P series camera network supports is determined by the camera's resolution, pixel format (Pixel Size), and the valid network bandwidth.
8.Features 8.5.3. Stream Channel Packet Delay The stream channel packet delay (SCPD) is used to control the bandwidth of the image streaming data of the camera. The packet delay is the number of the idle clocks that inserted between adjacent network packets transmitted in the stream channel.
8.Features The time of packet delay is: ⁄ = 2000 125,000,000 = 16 The effective network bandwidth is: Band = (8156 × 8 × (1 − 0.2))/(66 + 16) = 637 8.5.4. Bandwidth Reserve The Bandwidth Reserve is used to reserve a part of bandwidth for packet retransmission and control data transfer between the camera and the host, and can be used for multiple cameras transmission, to limit the bandwidth allocation of each camera.
Page 108
8.Features The trigger signal wait (FrameStartWait), (only for MARS-3140-3GM/C-P) The burst trigger signal wait (FrameBurstStartWait), (only for MARS-3140-3GM/C-P) Every event has a corresponding enable status, and in default all the events' enable status are disable. When using the event feature, you need to enable the corresponding event firstly and set the port of the event channel, the timeout of the event retransmission, and the number of times the event retransmission to the camera.
8.Features Among them: the timestamp is the time when the event occurs, and the timer starts when the camera is powered on or reset. The bit width of the timestamp is 64bits, and the unit is 20ns (MARS-3140-3GM/C-P is 8ns). 8.6.1.
8.Features Note that the camera will send the corresponding number of FrameBurstStartOvertrigger events if it receives multiple AcquisitionTrigger signals during the acquisition period of one frame of image. 8.6.7. FrameStartWait Event When the camera is in FrameTrigger mode, the camera starts acquiring images, and if it does not receive the FrameTrigger signal, the camera will send a FrameStartWait event to the host.
9. Software Tools 9.1. GigE IP Configurator GxGigeIPConfig.exe is a matching tool of DAHENG IMAGING's MARS-G-P digital camera series software. Users can use this tool to implement the following functions. This tool can enumerate all GigE Vision cameras attached to your network.
9.Software Tools [Refresh Devices] Update the network adapters list and the cameras list. [Auto Config] Configurate the IP address of the current network card and all the devices under it. When no network card is selected, all device IPs under the network card are configured. [Static IP] If this item is selected, it will use this static IP address.
9.Software Tools 9.1.2.2. Auto Config You can configurate the device's IP address manually or automatically. In manual mode, the user is required to understand the basic network knowledge and to set the device one by one manually. In auto mode, the program will be executed automatically without the operator intervening. If a user needs a batch of GigE cameras with no IP conflict between them, the user needs to connect all the cameras to the network and to make sure that all the cameras can be enumerated by IP configurator, then performs the IP config function automatically.
9.Software Tools When the user configures the GigE cameras' IP in batches using the [Auto Config] function under the same environment (First, connect a batch of cameras to perform this function, then replace another batch after completion), in the two sets of cameras, the IP address may conflict 9.1.2.3.
9.Software Tools Figure 9-3 Configure IP address 9.1.2.5. IP Configuration Mode You should select the camera feature which is to be modified in the camera list, select the Static IP, DHCP, or LLA, then select Save, the details are as follows: To set a camera to a static IP address See section 9.1.2.4 for details.
9.Software Tools In the right pane of the tool, select Auto IP (LLA). Select Save. When the tool has finished saving, the information in the top pane and the lower left area will have been updated automatically. Operation results: Change the camera IP configuration mode as "LLA". If operating successfully, the current IP address is allocated with the LLA mode.
9.Software Tools Figure 9-4 Check IP address format 9.1.3.2. Length Limitation of User-defined Name The maximum allowable length of the user-defined name is 16 bytes. 9.1.3.3. Tips The cameras' IP address are the same If the cameras' IP address are the same, a red exclamation mark will be displayed in the right of the camera list, as shown in the Figure 9-5.
9.2. LUT Create Tool 9.2.1. GUI LUT Create Tool, which supports all series of DAHENG IMAGING cameras. This plugin is integrated into GalaxyView.exe. After opening the device that you want to operate through this software, you can open LUT Create Tool from the menu bar plugin list. With the plugin you can achieve the following functions: Adjust the image Gamma, brightness, and contrast.
9.Software Tools After opening the device and LUT Create Tool through GalaxyView.exe, the initial GUI is shown in Figure 9-6. The layout and function description of widgets are as follows: [GroupBox] Select Lut from standard Lut, read from device, Lut file, CSV file and default. Among them, standard Lut is eight groups of factory standard Luts.
Page 120
9.Software Tools Figure 9-7 Standard Lut Read From Device When you select read from device, the tool will automatically load UserSet0, and then load the Lut saved by the device. If the device supports LUTEnable, it will automatically set LUTEnable to true to display the image effect in real time.
Page 121
9.Software Tools Figure 9-8 Do not support "Read From Device" After reading, the GUI parameters are updated according to different series of cameras. MERCURY USB3.0, USB2.0 devices cannot be read from the device, because the device does not support it. When the MERCURY GigE, MARS-1230-9GM/C-P, MARS-880-13GM/C-P and MARS-880-13GM/C- P ETR cameras select "Read from Device", the polyline graph and image effects are updated to the lookup table in the device.
Page 122
9.Software Tools Figure 9-9 Select "Read from Device " Lut file After selecting the Lut file, a dialog box for selecting the file will pop up. You can select the file in the format of .lut, and update the polyline diagram and image acquisition effect of the device. If you select standard Lut or default Lut, and auto create Lut, the widget interface will update the parameters stored when saving Lut (the updated parameter values include Lut range, Gamma, brightness, contrast, and the values selected by the standard Lut drop-down box).
9.Software Tools Figure 9-10 Select CSV file CSV file can be manually modified by users. Currently, csv storage format saves decimal number of every four bytes to the first cell of each line in the file, and the maximum value of the number in each cell is 4095, a total of 4096 lines.
9.Software Tools After selecting the GroupBox, when the above parameters are modified, the generated Lut will be written to the device Flash in real time. At this time, the "Write To Device" is not selected. After the device is powered off and restarted, the modified parameters will be lost. The generated Lut cannot be restored by "Read From Device".
9.3. Flat Field Correction Plugin ShadingCorrectionTool.plx is the companion software for DAHENG IMAGING digital camera. The plugin is integrated into GalaxyView.exe. After opening the device that you want to operate, open the flat field correction plugin from the menu bar plugin list.
9.Software Tools 9.3.1. GUI Figure 9-12 Flat field plugin GUI After the device is opened by GalaxyView.exe and the flat field correction plugin is opened, the initial state of the GUI is shown in Figure 9-12. The layout and function description of the widgets are as follows: Widget Function The number of images acquired for the acquisition of brightfield...
9.Software Tools Load the flat field correction coefficient from the file and Load File Immediate Save the calculated flat field correction coefficient to a file. Save File When the coefficient is used later, it can be loaded directly from the file Prompt the execution status and error message when the user Prompt Information is executing flat field correction...
Page 128
9.Software Tools Figure 9-13 The darkfield image is too bright When acquiring the darkfield image, if the black level is not the default value, the prompt information given in the prompt box is as shown in Figure 9-14. That is, when the flat field correction is executed, the darkfield image is not used, and the effect of flat field correction is not affected.
9.Software Tools If the acquired darkfield image meets the expectations, when the flat field correction is executed, the darkfield image is used and a prompt information is given in the prompt box, as shown in Figure 9-15. The number of darkfield images acquired is independent of the Acquisition Frame Count, and only one darkfield image is acquired.
9.Software Tools If the brightness of the acquired brightfield image is greater than 250, the prompt box will prompt that the acquired brightfield image will affect the effect of flat field correction, as shown in Figure 9-17. In this case, it is recommended that you adjust the image brightness to 20 ~ 250, and then re-acquiring the brightfield image.
Page 132
9.Software Tools The frame rate calculation tool is currently provided in the form of Excel. When using it, firstly select the camera model in the table, and then achieve the expected frame rate by modifying the parameter of the camera. There are four major types of influencing factors, including image readout time (image width, image height, pixel format), exposure time, acquisition frame rate setting value, and image transmission bandwidth influence (packet size, packet delay, reserved bandwidth, link speed, pixel format, image width, image height, pixel format).
"GevSCPD" is set to 1100, the calculated result "FPS" is 8.00 fps. 9.5. Static Defect Correction Plugin Static Defect Correction plugin which integrated in GalaxyView.exe can support all DAHENG IMAGING cameras. Open GalaxyView and connect to the camera then click the "Plugin" option in the menu bar. The...
Page 134
9.Software Tools Open GalaxyView.exe and start Static Defect Correction Plugin, the initial state of the GUI is shown as Figure 9-20, see the function descriptions as follows: No. Widget Function Acquire an image to analyze the location of the defect pixels Catch and noise points Threshold...
9.Software Tools 9.5.2. User Guide 9.5.2.1. Steps of Static Defect Correction Click "Catch" button to get an image, see details in 9.5.2.2. Set "Threshold" to decide the range of defect pixel. Check "Defect" or "Noise" to select the type of the defect. After checking "Count", the plugin will analyze the location of the current image and mark it in red, and then display the defect pixel number/noise pixel number/merged pixel number in the status bar.
The suffix of the defect data file is ".dp", and the default save path is under the installation package directory: *\Daheng Imaging\GalaxySDK\Demo\Win64\resource\gxplugins\DefectPixelCorrection. When users needs SDK to realize the Static Defect Correction function by their own, read the file of the saved defects data, and call the function: DxStaticDefectPixelCorrection.
10.FAQ 10. FAQ General Question Answer The LED of the power is not on when the Confirm whether the power of the PoE network MARS-G-P series camera is powered via card is connected. PoE network card. Confirm that the camera packet size is greater than 1500, generally the packet size is set to be the maximum.
Page 138
10.FAQ General Question Answer Method 1: Modify the parameter of the stream layer MaxNumQueueBuffer (the maximum buffer number of acquisition queue). Method 2: modify the size of the transmitted data block StreamTransferSize (the size of the data block divided by the acquisition queue Buffer). By default, Buffer needs a data block with a full image size, but when the system is used for a period of time, the continuity of memory is greatly affected...
11.Revision History 11. Revision History Version Changes Date V1.0.0 Initial release 2018-05-16 V1.0.1 Delete FCC Description 2018-06-19 V1.0.2 Modify I/O interface diagram 2018-07-23 V1.0.3 Add the description of new sections 2019-09-06 Modify MARS-GX-P to MARS-G-P V1.0.4 2019-12-26 Modify figures of section 7 Electrical Interface Modify the lens mount of MARS-3140-3GM/C-P V1.0.5 2020-06-16...
If you need to order products or inquire product information, please contact our sales: Tel: +86 10 8282 8878 Email: isupport@daheng-imaging.com 12.2. Contact Support If you have any questions in using DAHENG IMAGING products, please contact the experts on our support team: Tel: +86 10 8282 8878 Email: isupport@daheng-imaging.com...