1. Manuals
  2. Brands
  3. Basler Manuals
  4. Digital Camera
  5. Pioneer
  6. User manual

Basler Pioneer User Manual

Gige vision cameras
Hide thumbs
Table of Contents

Advertisement

Quick Links

Download this manual
Basler pioneer
USER'S MANUAL FOR GigE VISION CAMERAS
Document Number: AW000151
Version: 06
Language: 000 (English)
Release Date: 20 September 2007

Advertisement

Table of Contents
loading

Related Manuals for Basler Pioneer

Summary of Contents for Basler Pioneer

  • Page 1 Basler pioneer USER’S MANUAL FOR GigE VISION CAMERAS Document Number: AW000151 Version: 06 Language: 000 (English) Release Date: 20 September 2007...
  • Page 2 Basler customers using or selling these products for use in such applications do so at their own risk and agree to fully indemnify Basler for any damages resulting from such improper use or sale. Warranty Note Do not open the housing of the camera.
  • Page 3 Contacting Basler Support Worldwide Europe: Basler AG An der Strusbek 60 - 62 22926 Ahrensburg Germany Tel.: +49-4102-463-500 Fax.: +49-4102-463-599 vc.support.europe@baslerweb.com Americas: Basler, Inc. 855 Springdale Drive, Suite 160 Exton, PA 19341 U.S.A. Tel.: +1-877-934-8472 Fax.: +1-877-934-7608 vc.support.usa@baslerweb.com Asia: Basler Asia Pte. Ltd...

  • Page 5: Table Of Contents

    2.2.1.1 What Happens When Installing a Basler GigE Vision Network Driver ......... 22 2.2.2...
  • Page 6 Changing a Camera’s IP Configuration ........69 6 Basler Network Drivers and Parameters......73 The Basler Filter Driver.
  • Page 7 11.2.5 YUV 4:2:2 (YUYV) Packed Format ....... . 148 Basler pioneer...
  • Page 8 13.11.3 Selecting the Default Startup Set........204 Basler pioneer...
  • Page 9 15.1 Technical Support Resources......... . . 217 15.2 Before Contacting Basler Technical Support ....... 218 Revision History .
  • Page 10 Table of Contents Basler pioneer...

  • Page 11: Specifications, Requirements, And Precautions

    We strongly recommend that you read and follow the precautions. 1.1 Models The current Basler pioneer GigE Vision camera models are listed in the top row of the specification table on the next page of this manual. The camera models are differentiated by their sensor size, their maximum frame rate at full resolution, and whether the camera’s sensor is mono or color.

  • Page 12: General Specifications

    86.7 mm x 44mm x 29 mm (without lens adapter or connectors) (L x W x H) 98.5 mm x 44 mm x 29 mm (with lens adapter and connectors) Weight ~ 220 g (typical) Conformity CE, FCC, GenICam, GigE Vision; IP30 Table 1: General Specifications Basler pioneer...
  • Page 13 86.7 mm x 44mm x 29 mm (without lens adapter or connectors) (L x W x H) 98.5 mm x 44 mm x 29 mm (with lens adapter and connectors) Weight ~ 220 g (typical) Conformity CE, FCC, GenICam, GigE Vision, IP30 Table 2: General Specifications Basler pioneer...
  • Page 14 86.7 mm x 44mm x 29 mm (without lens adapter or connectors) (L x W x H) 98.5 mm x 44 mm x 29 mm (with lens adapter and connectors) Weight ~ 220 g (typical) Conformity CE, FCC, GenICam, GigE Vision, IP30 Table 3: General Specifications Basler pioneer...

  • Page 15: Spectral Response For Mono Cameras

    1.3 Spectral Response for Mono Cameras The following graphs show the spectral response for each available monochrome camera model. Note The spectral response curves exclude lens characteristics and light source characteristics. Wave Length (nm) Fig. 1: piA640-210gm Spectral Response Basler pioneer...
  • Page 16 Specifications, Requirements, and Precautions Wave Length (nm) Fig. 2: piA1000-48gm Spectral Response Wave Length (nm) Fig. 3: piA1600-35gm Spectral Response Basler pioneer...
  • Page 17 Specifications, Requirements, and Precautions Wave Length (nm) Fig. 4: piA1900-32gm Spectral Response 1000 Wave Length (nm) Wave Length (nm) Fig. 5: piA2400-12gm Spectral Response Basler pioneer...

  • Page 18: Spectral Response For Color Cameras

    A suitable IR cut filter is included in the standard C-mount lens adapter on color models of the camera. (An IR cut filter is not included in the optional CS- mount adapter.) Blue Green Wave Length (nm) Fig. 6: piA640-210gc Spectral Response Basler pioneer...
  • Page 19 Specifications, Requirements, and Precautions Blue Green Wave Length (nm) Fig. 7: piA1000-48gc Spectral Response Blue Green Wave Length (nm) Fig. 8: piA1600-35gc Spectral Response Basler pioneer...
  • Page 20 Specifications, Requirements, and Precautions Blue Green Wave Length (nm) Fig. 9: piA1900-32gc Spectral Response Blue Green Wave Length (nm) Wave Length (nm) Fig. 10: piA2400-12gc Spectral Response Basler pioneer...

  • Page 21: Mechanical Specifications

    The camera’s dimensions in millimeters are as shown in the drawings below. Camera housings are equipped with four mounting holes on the top and four mounting holes on the bottom as shown in the drawings. Basler pioneer...
  • Page 22 Bottom Side 80.2 2 x M3; 4 deep 6.45 85.4 ca.13.5 86.7 98.5 17.526 2 x M3; 3.5 deep Photosensitive surface of the sensor Top Side 2 x M3; 4.5 deep 80.2 Fig. 11: Mechanical Dimensions (in mm) Basler pioneer...

  • Page 23: Sensor Positioning Accuracy

    Maximum Sensor Tilt Angle (Degrees) Camera Tilt X Tilt Y Camera Tilt X Tilt Y piA640-210gm/gc 0.48 0.63 piA1900-32gm/gc 0.16 0.29 piA1000-48gm/gc 0.31 0.31 piA2400-12gm/gc 0.27 0.32 piA1600-35gm/gc 0.19 0.26 Fig. 12: Sensor Positioning Accuracy (in mm Unless Otherwise Noted) Basler pioneer...

  • Page 24: Maximum Thread Length On Color Cameras

    C-mount color cameras that do not include an internal IR cut filter are available on request. Monochrome cameras are not normally equipped with an internal IR cut filter, however, they can be equipped with an internal filter on request. Basler pioneer...

  • Page 25: Environmental Requirements

    You must provide sufficient heat dissipation to maintain the temperature of the camera housing at 50 °C or less. Since each installation is unique, Basler does not supply a strictly required technique for proper heat dissipation. Instead, we provide the following general guidelines: In all cases, you should monitor the temperature of the camera housing and make sure that the temperature does not exceed 50 °C.

  • Page 26: Precautions

    The plug on the cable that you attach to the camera’s 12-pin connector must have 12 pins. Use of a smaller plug, such as one with 10 pins or 8 pins, can damage the pins in the camera’s 12-pin connector. CAUTION Basler pioneer...
  • Page 27 Do not use solvents or thinners to clean the housing; they can damage the surface finish. Read the manual Read the manual carefully before using the camera! Basler pioneer...
  • Page 28 Specifications, Requirements, and Precautions Basler pioneer...

  • Page 29: Software And Hardware Installation

    If not, we suggest that you use a zoom lens for your initial installation and setup. Contact Basler technical support if you need assistance in determining the best lens for your application. The support contact numbers appear in the title pages of this manual.

  • Page 30: Software Installation

    Basler pylon Software Development Kit (SDK) except the Basler pylon API and the sample programs. The SDK includes these software components: The Basler pylon API - the API header files and libraries that you will need to create your own application programs. A programmer’s guide and API reference.
  • Page 31 The Basler pylon 1394 driver - a camera driver for IEEE 1394 cameras. The Basler pylon Direct Show driver - a driver for use in combination with applications that display images using the Windows Direct Show module.

  • Page 32: What Happens When Installing A Basler Gige Vision Network Driver

    Fig. 14: Network Adapter for the Camera(s) Two drivers are available for use with your GigE cameras: The Basler filter driver - is a basic GigE Vision network driver that is compatible with all network adapters. The advantage of the filter driver is its extensive compatibility.
  • Page 33 If you are using a compatible GigE network adapter, the installation of the Basler pylon Software Development Kit or the Basler pylon Viewer will remove the driver that is currently installed for the adapter and will install the Basler performance driver.

  • Page 34: Removing Older Pylon Software

    Removing Older Pylon Software If you have version 0.9 or below of the Basler filter driver installed on your system, it is critical that you remove the older version of the filter driver. If you attempt to install a newer version of the filter driver with version 0.9 or below in place, the installation will fail without any type of service...

  • Page 35: Installing The Pylon Sdk

    When the Run window opens, click the Browse button. c. Navigate to your CD-ROM drive and find the file called Basler pylon SDK x.x.x.xxx.exe. d. Click on the Basler pylon SDK x.x.x.xxx.exe file, click the Open button, and click the OK button.
  • Page 36 11. Note that the installation program has added shortcuts to the desktop for the Pylon Viewer and the Pylon IP Configuration Tool. 12. Click Start, click All Programs, click Basler Vision Technologies, and click Pylon 1.0. Note that shortcuts are available for the Pylon IP Configuration Tool, the Pylon Viewer, and the Speed-O- Meter tool.

  • Page 37: Installing The Pylon Viewer

    When the Run window opens, click the Browse button. c. Navigate to your CD-ROM drive and find the file called Basler pylon Viewer x.x.x.xxx.exe. d. Click on the Basler pylon Viewer x.x.x.xxx.exe file, click the Open button, and click the OK button.
  • Page 38 11. Note that the installation program has added shortcuts to the desktop for the Pylon Viewer and the Pylon IP Configuration Tool. 12. Click Start, click All Programs, click Basler Vision Technologies, and click Pylon 1.0. Note that shortcuts are available for the Pylon IP Configuration Tool, the Pylon Viewer, and the Speed-O- Meter tool.

  • Page 39: Adjusting The Installation

    2.2.5 Adjusting the Installation This section provides information on adjustments that must be made after the installation of the Basler pylon Software Development Kit or the Basler pylon Viewer and on additional adjustments that may be required. Necessary adjustments: Configuring the Fast Ethernet or non-compatible GigE network adapters that you may use with...

  • Page 40: Configuring A Non-Compatible Gige Or A Fast Ethernet Network Adapter Used With Your Cameras

    The following procedures assume that the Basler filter driver was installed on your PC during Installation of the Basler pylon SDK, during installation of the Basler pylon Viewer, or as an individual software component. After the installation, the settings of each Fast Ethernet or non- compatible network adapter used with your camera must be checked and adjusted, if necessary: 1.
  • Page 41 Select the Obtain an IP address automatically radio button. Click the OK button. A Local Area Connection Properties window will open. On the LAN Connection Properties window, make sure that Internet Protocol (TCP/IP) item is highlighted and click the Properties button. Basler pioneer...
  • Page 42 If you have more than one Fast Ethernet or non-compatible network adapter in the PC, return to step 1, select one of the other adapters, and perform steps 2 through 9 for each adapter. Basler pioneer...

  • Page 43: Changing The Driver Association For A Compatible Gige Network Adapter

    Changing the Driver Association for a Compatible GigE Network Adapter During installation of the Basler pylon SDK or the Basler pylon Viewer, the current network adapter- driver associations are changed for all network drivers installed in your PC with Basler drivers replacing the current drivers.

  • Page 44: Unbinding The Basler Filter Driver From A Non-Compatible Gige Or A Fast Ethernet Network Adapter

    PC with Basler drivers replacing the current drivers. Your application may require that no Basler network driver is bound to an adapter that is not used for a camera.

  • Page 45: Installing A Software Component

    Basler pylon software on your PC. You will have to install a Basler pylon software component in, for example, one of these situations: You initially only installed the Basler pylon Viewer and now want to use the SDK.
  • Page 46 If the Installer Information window does not open, there is no need to restart the computer. The installation of the software component is complete. Note If you installed the Basler filter driver and if you are using a Fast Ethernet or non-compliant GigE network adapter: Make sure to configure the Fast Ethernet or non-compatible GigE network adapter to be used with your cameras as described in the "Configuring a Non-compatible GigE or a Fast Ethernet Network Adapter...

  • Page 47: If You Are Using Multiple Network Adapters In A Single Pc

    Automatic Private IP Addressing (APIPA) to assign itself an IP address. If you are using only one network adapter in you host PC, these adapter settings will work correctly with Basler GigE cameras that are set to default (e.g., new cameras coming out of the box).

  • Page 48: Software Licensing Information

    PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. Basler pioneer...

  • Page 49: Hardware Installation

    You may also see a message about limited connectivity as shown below. The message about limited connectivity is normal and this situation will have no effect on the camera. You can ignore this message. Basler pioneer...

  • Page 50: Acquiring Your First Images

    If you want to use strobe light in your application, it is better to try this after the initial setup. If you need assistance in determining the optimum illumination for your application, contact Basler technical support using the numbers that appear in the title pages of this manual.
  • Page 51 Viewer to make adjustments to the camera’s black level, gain, and exposure time settings. You will also use the viewer to capture images and to see what they look like. 6. Open the lens aperture "halfway" by choosing an intermediate f-number. Basler pioneer...
  • Page 52 You can set the Gain by using the slider that appears next to the value box, by using the up / down arrows that appear next to the value box, or by typing a new value into the box. Basler pioneer...
  • Page 53 8. Change the Shutter setting to its lowest allowed value: a. Click the + Sign beside the Acquisition Controls category. The controls for setting the Exposure Time will appear as shown below. b. Use the slider to set the Exposure Time to its lowest allowed value. Basler pioneer...
  • Page 54 14. Make fine adjustments to the Black Level to ensure that detail is still visible in the darkest parts of the acquired images. (The next section contains more information about brightness.) Basler pioneer...
  • Page 55 Now that you have made the basic adjustments to your image quality, go on to the next section of the Installation procedure. The next section provides more detailed information about making adjustments to achieve the best image quality. Basler pioneer...

  • Page 56: Adjusting Image Quality

    You can change the depth of focus by turning the aperture ring on the lens. Closing the lens aperture (turning the aperture ring to higher f-numbers) increases the depth of focus and vice versa. Note that closing the aperture decreases the amount of light reaching the camera’s sensor and therefore results in a darker image. Basler pioneer...
  • Page 57 Increasing the gain will also increase image brightness. Note that unless your application requires extreme contrast, you should make sure that detail remains visible in the brightest portions of the image when increasing gain. Note also that noise is increased by increasing gain. Basler pioneer...
  • Page 58 If you must use insufficient illumination resulting in dark images, you may notice the blurring influence of noise. If you operate the camera near the high end of its specified temperature range, the effects may be particularly noticeable. You can increase contrast by lowering the operating temperature of the camera. Basler pioneer...
  • Page 59 Changing the black level setting will change the white balance. We therefore recommend that you check the white balance after setting the black level. Make sure the image is neither underexposed nor overexposed when checking the white balance. Basler pioneer...

  • Page 60: Next Steps

    GenICam based API. We recommend controlling the camera via the API when taking the next steps. Contact Basler technical support if you need further assistance. The contact numbers appear on the title page of this manual.

  • Page 61: Tools For Changing Camera Parameters

    The Basler IP Configuration Tool is a standalone application that lets you change the IP configuration of the camera via a GUI. The tool will detect all Basler GigE cameras attached to your network and let you make changes to a selected camera The IP Configuration Tool is included in the pylon Software Development Kit and is also included in the freely available pylon run-time software package.

  • Page 62: The Pylon Api

    API Reference contains an introduction to the API and includes information about all of the methods and objects included in the API. The Basler pylon Software Development Kit (SDK) includes a set of sample programs that illustrate how to use the pylon API to parameterize and operate the camera. These samples include ®...

  • Page 63: Network Recommendations

    If the adapter you are using is not a PRO series adapter and does not have one of the Intel chipsets used in a PRO series adapter, you must install the Basler Filter Driver. Your camera will use the filter driver to communicate via the adapter.

  • Page 64: Recommended Network Architectures

    This means that you can operate each camera at its full acquisition rate and not worry about sharing available network bandwidth between cameras. The disadvantage of the peer-to-peer configuration is that it limits the number of cameras that can be connected to a single PC. Basler pioneer...

  • Page 65: Connecting Via Network Switches

    PC. The four cameras must share the bandwidth available on the single path between the switch and the adapter. The bandwidth available on this single GigE path is about 125 MByte/s. Basler pioneer...
  • Page 66 1.5 kB. With newer "jumbo frame capable" devices, the maximum packet size can be up to 16 kB. Basler GigE cameras and the recommended Intel Pro 1000 adapters can both handle jumbo frames. For maximum network efficiency, your camera should be set to used the largest packet size that your network can handle.

  • Page 67: Pc Data Bus Issues

    PCI bus is lower and the bus bandwidth is shared by the network adapter and many other devices installed in the PC. To ensure adequate bandwidth on the PC’s data bus, use of a PC with a PCI express data bus is recommended. Basler pioneer...
  • Page 68 Network Recommendations Basler pioneer...

  • Page 69: Camera And Network Adapter Ip Configuration

    The following website provides comprehensive information about TCP/IP as it applies to Windows operating systems: http://www.microsoft.com/technet/network/evaluate/technol/tcpipfund/ tcpipfund.mspx This section also assumes that you are familiar with using basic Windows operating system tools such as the Network Connections window to access your network adapter. Basler pioneer...

  • Page 70: Network Adapter Ip Behavior

    Note There is another adapter IP configuration available called "DHCP / Alternate Configuration = Fixed Address", but this configuration is seldom used. For more information about the Automatic Private IP Address routine, see Section 5.3 on page Basler pioneer...

  • Page 71: Changing A Network Adapter's Ip Configuration

    Find the connection for the adapter you want to configure. Right click on the name of the connection and select Properties from the drop down menu as shown below. 2. A Local Area Connection Properties window will open as shown below. Make sure that Internet Protocol (TCP/IP) is highlighted and click the Properties button. Basler pioneer...
  • Page 72 Click the Close button on the Local Area Connection Properties window. e. Your system will wait for several seconds while the new settings take effect. Once the new settings are in place, the Local Area Connection Properties window will close. Basler pioneer...
  • Page 73 This can save you some time if you are connecting and disconnecting cameras or switching the system on and off as you would during design-in. Basler pioneer...

  • Page 74: Setting An Adapter To Use Dhcp / Alternate Configuration = Apipa

    Properties from the drop down menu as shown below. 2. A LAN Connection Properties window will open as shown below. Make sure that Internet Protocol (TCP/IP) is highlighted and click the Properties button. Basler pioneer...
  • Page 75 If APIPA is enabled on more than one adapter, the network will not operate properly. Note that if your PC is equipped with a multiport network adapter board, each port is considered to be the equivalent of a separate adapter. APIPA should be enabled on only one port. Basler pioneer...

  • Page 76: Checking A Network Adapter's Ip Address

    Double click on the name of the connection. A LAN Connection Status window will open as shown below. 3. Click on the Support Tab. The IP address information for the adapter will be displayed as shown below. Basler pioneer...

  • Page 77: Camera Ip Behavior

    As part of the routine, the network adapter and the devices attached to the adapter negotiate to make sure that there are no duplicate address assignments and that the adapter and the devices are all on the same subnet. For more detailed information about APIPA, you can visit: http://www.duxcw.com/faq/network/autiop.htm Basler pioneer...
  • Page 78 DHCP addressing and install a DHCP server on your network. The next sections in this chapter of the manual describe how to change the IP configuration on the cameras. See the earlier sections in this chapter for information about changing the IP configuration of network adapters. Basler pioneer...

  • Page 79: Changing A Camera's Ip Configuration

    To start the IP Configuration Tool: Double click the pylon IP Configuration Tool icon on your desktop Or click Start, click All Programs, click Basler Vision Technologies, click Pylon x.x, click Pylon IP Configuration Tool. The tool will start and an IP Configurator window will open as shown below.
  • Page 80 IP address.) b. Click the OK button. c. The selected camera’s current IP address will immediately be changed and the IP Configurator window will be updated to reflect the changes. Basler pioneer...
  • Page 81 If you want the camera to use DHCP address assignment (i.e., to obtain an IP address from a DHCP server attached to the same network as the camera), make sure that the Use DHCP check box is checked and that the Use Persistent IP check box is not checked. Basler pioneer...
  • Page 82 The recommended range for fixed IP addresses is from 172.16.0.1 to 172.32.255.254 and from 192.168.0.1 to 192.168.255.254. These address ranges have been reserved for private use according to IP standards. If your PC has multiple network adapters, each adapter must be in a different subnet. Basler pioneer...

  • Page 83: Basler Network Drivers And Parameters

    Two network drivers are available for the network adapter used with your GigE cameras: The Basler filter driver is a basic GigE Vision network driver that is compatible with all network adapters. The advantage of this driver is its extensive compatibility.

  • Page 84: The Basler Filter Driver

    Basler Network Drivers and Parameters 6.1 The Basler Filter Driver The Basler filter driver is a basic driver GigE Vision network driver. It is designed to be compatible with most network adapter cards. The functionality of the filter driver is relatively simple. For each frame, the driver checks the order of the incoming packets.
  • Page 85 Basler Network Drivers and Parameters For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon Viewer, see Section 2.2 on page 20 and Section 2.4 on...

  • Page 86: The Basler Performance Driver

    The Basler performance driver uses a "receive window" to check the status of packets. The check for missing packets is made as packets enter the receive window. If a packet arrives from higher in the sequence of packets than expected, the preceding skipped packet or packets are detected as missing.
  • Page 87 Basler Network Drivers and Parameters General Parameters Enable Resend - Enables the packet resend mechanisms. If the Enable Resend parameter is set to false, the resend mechanisms are disabled. The performance driver will not check for missing packets and will not send resend requests to the camera.
  • Page 88 Basler Network Drivers and Parameters Resend Request Threshold - This parameter determines the location of the resend request threshold within the receive window as shown in Figure 18. The parameter value is in per cent of the width of the receive window. In Figure 18 the resend request threshold is set at 33.33% of the width of the receive window.
  • Page 89 Basler Network Drivers and Parameters Timeout Resend Mechanism Parameters The timeout resend mechanism is illustrated in Figure 19 where the following assumptions are made: The frame includes 3000 packets. Packet 1002 is missing within the stream of packets and has not been recovered.
  • Page 90 Basler Network Drivers and Parameters Maximum Number Resend Requests - The Maximum Number Resend Requests parameter sets the maximum number of resend requests the performance driver will send to the camera for each missing packet. Resend Timeout - The Resend Timeout parameter defines how long (in milliseconds) the performance driver will wait after detecting that a packet is missing before sending a resend request to the camera.
  • Page 91 Basler Network Drivers and Parameters Threshold and Timeout Resend Mechanisms Combined Figure 20 illustrates the combined action of the threshold and the timeout resend mechanisms where the following assumptions are made: All parameters set to default. The frame includes 3000 packets.
  • Page 92 For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters. (Note that the performance driver parameters will only appear in the viewer if the performance driver is installed on the adapter to which your camera is connected.)
  • Page 93 Adapter Properties When the Basler Performance driver is installed, it adds a set of "advanced" properties to the network adapter. These properties include: Max Packet Latency - A value in microseconds that defines how long the adapter will wait after it receives a packet before it generates a packet received interrupt.

  • Page 94: Transport Layer Parameters

    Camera_t::TlParams_t &TlParams = dynamic_cast<Camera_t::TlParams_t&>(*Camera.GetTLNodeMap()); TlParams.ReadTimeout.SetValue(500); // 500 milliseconds TlParams.WriteTimeout.SetValue(500); // 500 milliseconds // Heartbeat Timeout Camera_t::TlParams_t &TlParams = dynamic_cast<Camera_t::TlParams_t&>( *Camera.GetTLNodeMap() ); TlParams.HeartbeatTimeout.SetValue(5000); // 5 seconds You can also use the Basler pylon Viewer application to easily set the parameters. Basler pioneer...

  • Page 95: Network Related Camera Parameters And Managing Bandwidth

    The packet size parameter sets the size of the packets that the camera will use when it sends the data payload via the selected stream channel. The value is in bytes. The value does not affect the leader and trailer size and the last data packet may be a smaller size. Basler pioneer...
  • Page 96 IPD = Inter-packet Delay setting in ticks (with a tick set to the 8 ns standard) When considering this formula, you should know that on a Gigabit network it takes one tick to transmit one byte. Also, be aware that the formula has been simplified for easier understanding. Basler pioneer...
  • Page 97 The example also assumes that the camera is operating in a poor environment, so many packets are lost and many resends are required. The numbered text is keyed to the time periods in the chart. Basler pioneer...
  • Page 98 15 resends would be required from the accumulator pool, but the pool only has 9 resends. So the 9 resends in the pool are used and 6 resend requests are answered with a "packet unavailable" error code. The accumulator pool is reduced to 0. Basler pioneer...
  • Page 99 If software or hardware triggering is being used to control the camera’s frame rate, the maximum frame rate allowed with the current camera settings will be used to calculate the device max throughput. Basler pioneer...
  • Page 100 // Payload Size int64_t payloadSize = Camera.PayloadSize.GetValue(); // GevStreamChannelSelector Camera.GevStreamChannelSelector.SetValue ( GevStreamChannelSelector_StreamChannel0 ); // PacketSize Camera.GevSCPSPacketSize.SetValue( 1500 ); // Inter-packet Delay Camera.GevSCPD.SetValue( 1000 ); // Frame-transmission Delay Camera.GevSCFTD.SetValue( 1000 ); // Bandwidth Reserve Camera.GevSCBWR.SetValue( 10 ); Basler pioneer...
  • Page 101 = Camera.GevSCDCT.GetValue(); // Resulting Framerate double resultingFps = Camera.ResultingFrameRateAbs.GetValue(); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.

  • Page 102: Managing Bandwidth When Multiple Cameras Share A Single Network Path

    The higher the inter-packet delay parameter is set, the greater the delay between the transmission of each packet will be and the lower the data Basler pioneer...

  • Page 103: A Procedure For Managing Bandwidth

    8 kB packets, then the maximum for the network is 8 kB packets. Once you have determined the maximum packet size for your network, set the value of the Packet Size parameter on each camera to this value. Basler pioneer...
  • Page 104 Packet Size parameter for each camera. You will also need to know the frame rate (in frames/s) at which each camera will operate. Payload Size × Bytes/Frame Packet Overhead Payload Size Leader Size Trailer Size ---------------------------------- - Packet Size Data Bandwidth Needed = Bytes/Frame x Frames/s Basler pioneer...
  • Page 105 2. Recalculate the data bandwidth assigned to the camera. 3. Compare the new data bandwidth assigned to the data bandwidth needed. 4. Repeat 1, 2, and 3 until the data bandwidth assigned is equal to or just greater than the data bandwidth needed. Basler pioneer...
  • Page 106 AOI settings on the cameras, you should repeat steps 2 through 6. For more information about the camera’s maximum allowed frame transmission rate, see Section 10.9 on page 137. For more information about the AOI, see Section 13.5 on page 185. Basler pioneer...

  • Page 107: Camera Functional Description

    Exposure start, exposure time, and charge readout can be controlled by parameters transmitted to the camera via the Basler pylon API and the GigE interface. There are also parameters available to set the camera for single frame acquisition or continuous frame acquisition.
  • Page 108 Shift Shift Shift Pixels Pixels Pixels Pixels Pixels Pixels Pixels Pixels Reg. Reg. Reg. Reg. Reg. Reg. Reg. Reg. Line Line Line Line Line Line Left Horizontal Shift Register Right Horizontal Shift Register Fig. 22: CCD Sensor Architecture Basler pioneer...
  • Page 109 ExTrig 24 MB Image ExpActive Buffer TrigRdy Image Image Data Data Ethernet Ethernet FPGA Sensor Controller Network Image Image Data Data Control Data Control Micro- Controller Control Control: Data AOI, Gain, Black Level Fig. 23: Camera Block Diagram Basler pioneer...
  • Page 110 Camera Functional Description Basler pioneer...

  • Page 111: Physical Interface

    A 12-pin receptacle used to provide access to the camera’s I/O lines and to provide input power to the camera. The drawing below shows the location of the two connectors and the LEDs. 12-pin Receptacle 8-pin RJ-45 Jack Green LED Yellow LED Fig. 24: Camera Connectors and LED Basler pioneer...

  • Page 112: Connector Pin Assignments And Numbering

    VCC through separate wires between your power supply and pins 8 and 9 on the camera. We also recommend that you supply input power ground through separate wires between your power supply and pins 1 and 2 on the camera. Basler pioneer...

  • Page 113: Jack Pin Assignments

    Physical Interface 9.2.2 RJ-45 Jack Pin Assignments The 8-pin RJ-45 jack provides Ethernet access to the camera. Pin assignments adhere to the Ethernet standard. 9.2.3 Pin Numbering Fig. 25: Pin Numbering for the 12-pin Receptacle Basler pioneer...

  • Page 114: Connector Types

    9.3.2 12-Pin Connector The 12-pin connector on the camera is a Hirose micro receptacle (part number HR10A-10R-12P) or the equivalent. The recommended mating connector is the Hirose micro plug (part number HR10A-10P-12S) or the equivalent. Basler pioneer...

  • Page 115: Cabling Requirements

    Close proximity to strong magnetic fields should be avoided. The required 12-pin Hirose plug is available from Basler. Basler also offers a cable assembly that is terminated with a 12-pin Hirose plug on one end and unterminated on the other. Contact your Basler sales representative to order connectors or cables.
  • Page 116 VCC through two separate wires between the power supply and the camera as shown in the figure above. We also recommend that you supply input power ground through two separate wires between the power supply and the camera as shown in the figure. Basler pioneer...

  • Page 117: Input Power

    For more information about the 12-pin connector and the I/O cable see Section 9.2 on page 102 and Section 9.3 on page 104. 9.6 Ethernet GigE Device Information The camera uses a standard Ethernet GigE transceiver. The transceiver is fully 100/1000 Base-T 802.3 compliant. Basler pioneer...

  • Page 118: Input And Output Lines

    For more information about input line pin assignments and pin numbering, see Section 9.2 on page 102. For more information about how to use an ExTrig signal to control acquisition start, see Section 10.3 page 120. For more information about configuring the input lines, see Section 12.1 on page 165. Basler pioneer...

  • Page 119: Output Lines

    A conducting transistor means a logical one and a non-conducting transistor means a logical zero. Figure 28 shows a typical circuit you can use to monitor an output line with a voltage signal. The circuit in Figure 28 is monitoring output line 1. Fig. 28: Typical Voltage Output Circuit Basler pioneer...
  • Page 120 For more information about the exposure active signal, see Section Section 10.7 on page 134. For more information about the trigger ready signal, see Section Section 10.6 on page 132. For more information about assigning camera output signals to physical output lines, see Section 12.2.1 on page 167. Basler pioneer...

  • Page 121: Output Line Response Time

    Note The response times for the output lines on your camera will fall into the ranges specified above. The exact response time for your specific application will depend on the external resistor and the applied voltage you use. Basler pioneer...
  • Page 122 Physical Interface Fig. 31: I/O Line Schematic Basler pioneer...

  • Page 123: Image Acquisition Control

    Camera.TriggerSelector.SetValue( TriggerSelector_AcquisitionStart ); Camera.TriggerMode.SetValue( TriggerMode_Off ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.

  • Page 124: Acquiring One Image At A Time

    Camera.AcquisitionMode.SetValue( AcquisitionMode_SingleFrame ); You can also execute the Acquisition Start command by using the API. For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
  • Page 125 = Camera.ResultingFrameRateAbs.GetValue(); You can also execute the Acquisition Start and Stop commands by using the API. For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.

  • Page 126: Controlling Image Acquisition With A Software Trigger

    The following code snippet illustrates using the API to set the parameter values: Camera.TriggerSelector.SetValue(TriggerSelector_AcquisitionStart); Camera.TriggerMode.SetValue( TriggerMode_On ); Camera.TriggerSource.SetValue( TriggerSource_Software ); Camera.ExposureMode.SetValue( ExposureMode_Timed ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. Basler pioneer...

  • Page 127: Acquiring A Single Image By Applying One Software Trigger

    Camera.AcquisitionStart.Execute( ); Camera.TriggerSoftware.Execute( ); // retrieve the captured image For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.

  • Page 128: Acquiring Images By Applying A Series Of Software Triggers

    Camera.AcquisitionMode.SetValue( AcquisitionMode_Continuous ); // prepare for image acquisition here Camera.AcquisitionStart.Execute( ); while ( ! finished ) Camera.TriggerSoftware.Execute( ); // retrieve acquired image here Camera.AcquisitionStop.Execute( ); // how to set and test the Acquisition Frame Rate Camera.AcquisitionFrameRateAbs.SetValue( 60.0 ); Basler pioneer...
  • Page 129 // how to disable the FrameRateAbs parameter Camera.AcquisitionFrameRateEnable.SetValue( false ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.

  • Page 130: Controlling Image Acquisition With A Hardware Trigger

    When timed mode is selected, the exposure time for each image is determined by the value of the camera’s exposure time parameter. If the camera is set for rising edge triggering, the exposure time starts when the ExTrig signal rises. If the camera is set for falling edge triggering, the exposure time Basler pioneer...
  • Page 131 This situation is illustrated Figure 33 for rising edge operation. On the first cycle of the ExTrig signal shown in the figure, the signal rises and falls while readout is taking place. Normally you would Basler pioneer...
  • Page 132 // set for the width exposure mode, set minimum exposure time to 3000 µs Camera.ExposureMode.SetValue( ExposureMode_TriggerWidth ); Camera.ExposureTimeAbs.SetValue( 3000 ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.

  • Page 133: Setting The Camera For Hardware Triggering

    Camera.TriggerMode.SetValue( TriggerMode_On ); Camera.TriggerSource.SetValue ( TriggerSource_Line1 ); Camera.TriggerActivation.SetValue( TriggerActivation_RisingEdge ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.

  • Page 134: Acquiring A Single Image By Applying One Hardware Trigger Transition

    Camera.TriggerActivation.SetValue( TriggerActivation_RisingEdge ); Camera.AcquisitionMode.SetValue( AcquisitionMode_SingleFrame ); Camera.AcquisitionStart.Execute( ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.

  • Page 135: Acquiring Images By Applying A Series Of Hardware Trigger Transitions

    If you are acquiring images using a series of hardware trigger transitions, you must avoid acquiring images at a rate that exceeds the maximum allowed with the current camera settings. You can avoid triggering image acquistion at too high a rate by using the trigger ready signal as described above. Basler pioneer...
  • Page 136 Camera.AcquisitionMode.SetValue( AcquisitionMode_Continuous ); Camera.AcquisitionStart.Execute( ); Camera.AcquisitionStop.Execute( ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon Viewer, see Section 2.2 on page 20 and Section 2.4 on...

  • Page 137: Exposure Time Parameters

    Exposure Time Raw parameter. The Exposure Time Raw parameter value can range from 1 to 4095. So if the value is set to 100, for example, the exposure time will be 100 x 20 µs or 2000 µs. Basler pioneer...

  • Page 138: Setting The Exposure Time Using "Absolute" Settings

    Camera.ExposureMode.SetValue( ExposureMode_Timed ); Camera.ExposureTimeRaw.SetValue( 100 ); Camera.ExposureTimeBaseAbs.SetValue( 200 ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
  • Page 139 Camera.ExposureTimeAbs.SetValue( 124 ); double resultingExpTime = Camera.ExposureTimeAbs.GetValue( ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.

  • Page 140: Overlapping Exposure And Sensor Readout

    As you can see, running the camera with readout and exposure overlapped can allow higher acquisition frame rates because the camera is performing two processes at once. Image Acquisition N Exposure Readout Image Acquisition N+1 Exposure Readout Image Acquisition N+2 Exposure Readout Image Acquisition N+3 Exposure Readout Time Fig. 37: Overlapped Exposure Basler pioneer...

  • Page 141: Guidelines For Overlapped Operation

    The camera supplies a “trigger ready” signal that is specifically designed to let you trigger overlapped exposure safely and efficiently. For more information about using the Trigger Ready signal, see Section 10.6 on page 132. Basler pioneer...

  • Page 142: Trigger Ready Signal

    N+1 N+1 begins acquisition N+2 N+2 begins TrigRdy Signal Image Acquisition N Exposure Readout Image Acquisition N+1 Exposure Readout Image Acquisition N+2 Exposure Readout Time Fig. 38: Trigger Ready Signal Basler pioneer...
  • Page 143 For more information about changing the assignment of camera output signals to physical output lines, see Section 12.2.1 on page 167. For more information about the electrical characteristics of the camera’s output lines, see Section 9.7.2 on page 109. Basler pioneer...

  • Page 144: Exposure Active Signal

    For more information about changing the assignment of camera output signals to physical output lines, see Section 12.2.1 on page 167. For more information about the electrical characteristics of the camera’s output lines, see Section 9.7.2 on page 109. Basler pioneer...

  • Page 145: Acquisition Timing Chart

    The exposure start delay varies from camera model to camera model. The table below shows the exposure start delay for each camera model: Camera Model Exposure Start Delay piA640-210gm/gc 12.44 µs piA1000-48gm/g 48.96 µs piA1600-35gm/gc 35.59 µs piA1900-32gm/gc 66.45 µs piA2400-12gm/gc 77.20 µs Table 6: Exposure Start Delays Basler pioneer...
  • Page 146 Due to the nature of the Ethernet network, the transmission start delay can vary from frame to frame. The start delay, however, is of very low significance when compared to the transmission time. For more information about the Payload Size and Device Current Throughput parameters, see Section 7.1 on page Basler pioneer...

  • Page 147: Maximum Allowed Acquisition Frame Rate

    PC via a network switch, you could also use a multiport network adapter in the PC instead of a switch. This would allow you to increase the Ethernet bandwidth assigned to the camera and thus decrease the transmission time. Basler pioneer...
  • Page 148 Max. Frames/s ----------------------------------------------------------------- - Exposure time in µs Where: The constant C depends on the camera model as shown in the table below: piA640-210gm/gc 46.99 µs piA1000-48gm/gc 95.57 µs piA1600-35gm/gc 79.64 µs piA1900-32gm/gc 139.38 µs piA2400-12gm/gc 76.80 µs Basler pioneer...
  • Page 149 ----------------------------- - 240000 Max Frames/s = 458.3 frames/s Formula one returns the lowest value. So in this case, the limiting factor is the sensor readout time and the maximum allowed acquisition frame rate would be 248.4 frames per second. Basler pioneer...
  • Page 150 Image Acquisition Control Basler pioneer...

  • Page 151: Pixel Data Formats

    Table 8: Pixel Formats Available on Color Cameras ( = format available) Details of the monochrome formats are described in Section 11.2 on page 143 and details of the color formats are described in Section 11.3 on page 149. Basler pioneer...
  • Page 152 Camera.PixelFormat.SetValue( PixelFormat_YUV422_YUYV_Packed ); Camera.PixelFormat.SetValue( PixelFormat_BayerGB8 ); Camera.PixelFormat.SetValue( PixelFormat_BayerGB16 ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.

  • Page 153: Pixel Data Formats For Mono Cameras

    With the camera set for Mono8, the pixel data output is 8 bit data of the “unsigned char” type. The available range of data values and the corresponding indicated signal levels are as shown in the table below. This Data Value Indicates This Signal Level (Hexadecimal) (Decimal) 0xFF 0xFE • • • • • • 0x01 0x00 Basler pioneer...

  • Page 154: Mono 16 Format (Equivalent To Dcam Mono 16)

    Low byte of brightness value for P High byte of brightness value for P Low byte of brightness value for P High byte of brightness value for P Low byte of brightness value for P High byte of brightness value for P Basler pioneer...
  • Page 155 0x0FFE 4094 • • • • • • 0x0001 0x0000 Note When a camera that is set for Mono 16 has only 12 bits effective, the leader of transmitted frames will indicate Mono 12 as the pixel format. Basler pioneer...

  • Page 156: Mono 12 Packed Format

    • • • • • • bits 11 ... 4 bits 3 ... 0 bits 3 ... 0 bits 11 ... 4 bits 11 ... 4 bits 3 ... 0 bits 3 ... 0 bits 11 ... 4 Basler pioneer...
  • Page 157 “unsigned” type. The available range of data values and the corresponding indicated signal levels are as shown in the table below. This Data Value Indicates This Signal Level (Hexadecimal) (Decimal) 0x0FFF 4095 0x0FFE 4094 • • • • • • 0x0001 0x0000 Basler pioneer...

  • Page 158: Yuv 4:2:2 Packed Format (Equivalent To Dcam Yuv 4:2:2)

    The order of the pixel data for a received frame in the image buffer in your PC is similar to the order of YUV 4:2:2 (YUYV) Packed output from a color camera. For more information about the YUV 4:2:2 (YUYV) Packed format on color cameras, see Section 11.3.6 on page 160. Basler pioneer...

  • Page 159: Pixel Data Output Formats For Color Cameras

    "BG" filter alignment). As the figure illustrates, within each square of four pixels, one pixel sees only red light, one sees only blue light, and two pixels see only green light. (This combination mimics the human eye’s sensitivity to color.) Sensor Pixels Fig. 41: Bayer Filter Pattern Basler pioneer...

  • Page 160: Color Filter Alignment

    You can tell how the current AOI is aligned to the Bayer filter by reading the value of the Pixel Color Filter parameter. For more information about the camera’s AOI feature, see Section 13.5 on page 185. Basler pioneer...

  • Page 161: Bayer Gb 8 Format (Equivalent To Dcam Raw 8)

    Blue value for P Green value for P Green value for P Red value for P Blue value for P Green value for P Green value for P Red value for P Blue value for P Green value for P Basler pioneer...
  • Page 162 The available range of data values and the corresponding indicated signal levels are as shown in the table below. This Data Value Indicates This Signal Level (Hexadecimal) (Decimal) 0xFF 0xFE • • • • • • 0x01 0x00 Basler pioneer...

  • Page 163: Bayer Gb 16 Format (Equivalent To Dcam Raw 16)

    • • • • • • • • • • Low byte of green value for P Low byte of red value for P High byte of green value for P High byte of red value for P Basler pioneer...
  • Page 164 • • • • 0x0001 0x0000 Note When a camera that is set for Bayer GB 16 has only 12 bits effective, the leader of transmitted frames will indicate Bayer GB 12 as the as the pixel format. Basler pioneer...

  • Page 165: Bayer Gb 12 Packed Format

    Blue value for P bits 11 ... 4 Green value for P bits 11 ... 4 Blue value for P bits 3 ... 0 Green value for P bits 3 ... 0 Blue value for P bits 11 ... 4 Basler pioneer...
  • Page 166 “unsigned” type. The available range of data values and the corresponding indicated signal levels are as shown in the table below. This Data Value Indicates This Signal Level (Hexadecimal) (Decimal) 0x0FFF 4095 0x0FFE 4094 • • • • • • 0x0001 0x0000 Basler pioneer...

  • Page 167: Yuv 4:2:2 Packed Format (Equivalent To Dcam Yuv 4:2:2)

    U values and V values with unsigned integers, 128 is added to each U value and to each V value before the values are transferred from the camera. This process allows the values to be transferred on a scale that ranges from 0 to 255. Basler pioneer...
  • Page 168 • • • • • • U value for P Y value for P V Value for P Y value for P U value for P Y value for P V Value for P Y value for P Basler pioneer...
  • Page 169 • 0x01 -127 0x00 -128 The signal level of a U component or a V component can range from -128 to +127 (decimal). Notice that the data values have been arranged to represent the full signal level range. Basler pioneer...

  • Page 170: Yuv 4:2:2 (Yuyv) Packed Format

    • • • • • • Y value for P U value for P Y value for P V value for P Y value for P U value for P Y value for P V value for P Basler pioneer...
  • Page 171 • 0x01 -127 0x00 -128 The signal level of a U component or a V component can range from -128 to +127 (decimal). Notice that the data values have been arranged to represent the full signal level range. Basler pioneer...

  • Page 172: Mono 8 Format (Equivalent To Dcam Mono 8)

    With the camera set for Mono 8, the pixel data output is 8 bit data of the “unsigned char” type. The available range of data values and the corresponding indicated signal levels are as shown in the table below. Basler pioneer...
  • Page 173 Pixel Data Formats This Data Value Indicates This Signal Level (Hexadecimal) (Decimal) 0xFF 0xFE • • • • • • 0x01 0x00 Basler pioneer...

  • Page 174: Pixel Transmission Sequence

    The columns are numbered 0 through m from the left side to the right side of the sensor The rows are numbered 0 through n from the top to the bottom of the sensor The sequence assumes that the camera is set for full resolution. Basler pioneer...

  • Page 175: O Control

    Note By default, physical input line 1 is assigned to receive the ExTrig signal. You can assign only one line to receive the ExTrig input signal. Basler pioneer...

  • Page 176: Using An Unassigned Input Line To Receive A User Input Signal

    The line assigned to receive the ExTrig input signal can’t be used to receive a user-designed input signal. For more information about using the Line Status and Line Status All parameters, see Section 12.3.1 on page 175 and Section 12.3.2 on page 175. Basler pioneer...

  • Page 177: Configuring Output Lines

    Camera.LineSource.SetValue( LineSource_ExposureActive ); Camera.LineSelector.SetValue( LineSelector_Out2 ); Camera.LineSource.SetValue( LineSource_TriggerReady ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.

  • Page 178: Setting The State Of User Settable Output Lines

    Camera.UserOutputValue.SetValue( true ); bool currentUserOutput3State = Camera.UserOutputValue.GetValue( ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.

  • Page 179: Setting An Output Line For Invert

    Camera.LineSelector.SetValue( LineSelector_Out1 ); Camera.LineInverter.SetValue( true ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.

  • Page 180: Working With Timers

    Camera.TimerSelector.SetValue( TimerSelector_Timer1 ); Camera.TimerTriggerSource.SetValue( TimerTriggerSource_ExposureStart ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.

  • Page 181: Setting A Timer Delay Time

    Camera.TimerSelector.SetValue( TimerSelector_Timer1 ); Camera.TimerDelayRaw.SetValue( 100 ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.

  • Page 182: Setting A Timer Duration Time

    Duration Time = (Timer Duration Raw Parameter Value) x (Timer Duration Time Base) By default, the Timer Duration Time Base is fixed at 1 µs. Typically, the duration time is adjusted by setting only the Timer Duration Raw parameter value. Basler pioneer...
  • Page 183 Camera.TimerSelector.SetValue( TimerSelector_Timer1 ); Camera.TimerDurationRaw.SetValue( 100 ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
  • Page 184 Duration Abs parameter will indicate the current duration time setting. You should also be aware that if you change the duration time using the raw settings, the Timer Duration Abs parameter will automatically be updated to reflect the new duration time. Basler pioneer...

  • Page 185: Checking The State Of The I/O Lines

    Camera.LineSelector.SetValue( LineSelector_Out2 ); bool outputLine2State = Camera.LineStatus.GetValue( ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
  • Page 186 Indicates output line 4 state Indicates output line 3 state Indicates output line 2 state Indicates input line 2 state Indicates output line 1 state Indicates input line 1 state Fig. 44: Line Status All Parameter Bits Basler pioneer...

  • Page 187: Standard Features

    Gain Raw All value plus the Gain Raw Tap 2 value. For each camera model, the minimum and maximum allowed Gain Raw and Gain Total settings are shown in the tables below: Basler pioneer...
  • Page 188 The Gain Raw All value can be set in a range from 0 to 400. The Gain Raw Tap 1 value can be set in a range from 0 to 400. The Gain Raw Tap 2 value can be set in a range from 0 to 400. Basler pioneer...
  • Page 189 Gain on the Right Sensor Half = ( 0.0359 x 450) + (0.0359 x 0) Gain on the Right Sensor Half = 16.2 dB Gain on the Left Sensor Half = ( 0.0359 x 450) + (0.0359 x 0) Gain on the Left Sensor Half = 16.2 dB Basler pioneer...

  • Page 190: Setting The Gain

    //Set Gain Raw Tap 2 Camera.GainSelector.SetValue( GainSelector_Tap2 ); Camera.GainRaw.SetValue( 0 ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.

  • Page 191: Black Level

    The sum of the Black Level Raw All setting plus the Black Level Raw Tap 1 setting must be less than or equal to 1023. The sum of the Black Level Raw All setting plus the Black Level Raw Tap 2 setting must also be less than or equal to 1023. Basler pioneer...

  • Page 192: Setting The Black Level

    //Set Black Level Raw Tap 2 Camera.BlackLevelSelector.SetValue ( BlackLevelSelector_Tap2 ); Camera.BlackLevelRaw.SetValue( 0 ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.

  • Page 193: White Balance (On Color Models)

    Camera.BalanceRatioSelector.SetValue( BalanceRatioSelector_Green ); Camera.BalanceRatioAbs.SetValue( 1.20 ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.

  • Page 194: Integrated Ir Cut Filter (On Color Models)

    The location of the IR cut filter limits the length of the threads on any lens you use with the camera. If a lens with a very long thread length is used, the IR cut filter will be damaged or destroyed and the camera will no longer operate. CAUTION Basler pioneer...

  • Page 195: Area Of Interest (Aoi)

    One of the main advantages of the AOI feature is that decreasing the height of the AOI can increase the camera’s maximum allowed acquisition frame rate. For more information about how changing the AOI height affects the maximum allowed frame rate, see Section 10.9 on page 137. Basler pioneer...
  • Page 196 Width and Height parameters. They also illustrate setting the X Offset, Y Offset, Width, and Height parameter values int64_t widthMax = Camera.Width.GetMax( ); int64_t widhInc = Camera.Width.GetInc(); Camera.Width.SetValue( 200 ); Camera.OffsetX.SetValue( 100 ); int64_t heightMax = Camera.Height.GetMax( ); int64_t heightInc = Camera.Height.GetInc(); Basler pioneer...

  • Page 197: Changing Aoi Parameters "On-The-Fly

    Standard Features Camera.Height.SetValue( 200 ); Camera.OffsetY.SetValue( 100 ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.

  • Page 198: Binning

    With horizontal binning, adjacent pixels from 2 columns, 3 columns, or a maximum of 4 columns are summed and are reported out of the camera as a single pixel. Figure 48 illustrates horizontal bin- ning. Horizontal Binning by 2 Horizontal Binning by 3 Horizontal Binning by 4 Fig. 48: Horizontal Binning Basler pioneer...
  • Page 199 // Disable vertical and horizontal binning Camera.BinningVertical.SetValue( 1 ); Camera.BinningHorizontal.SetValue( 1 ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.

  • Page 200: Considerations When Using Binning

    And when you set the Y Offset and the Height for the AOI, you will be setting these values in terms of virtual sensor lines. For more informtion about the area of interest (AOI) feature, see Section 13.5 on page 185 Basler pioneer...
  • Page 201 If binning is enabled, however, you must use the concept of a "virtual" sensor as described above and the height of the AOI that you use in the formulas would be in terms of virtual sensor lines. The affected formulas appear on page 136 and on page 138. Basler pioneer...

  • Page 202: Luminance Lookup Table

    The second graph is for a lookup table where the values are arranged so that the camera output increases quickly as the sensor output moves from 0 through 2048 and increases gradually as the sensor output moves from 2049 through 4096. Basler pioneer...
  • Page 203 Fig. 49: Lookup Table with Values Mapped in a Linear Fashion 4095 3072 12 Bit Camera Output 2048 1024 1024 2048 3072 4095 12 Bit Sensor Reading Fig. 50: Lookup Table with Values Mapped for Higher Camera Output at Low Sensor Readings Basler pioneer...
  • Page 204 // Enable the lookup table Camera.LUTEnable.SetValue( true ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.

  • Page 205: Event Reporting

    PC in an event message before the next event is placed in queue. If there is an occasional short term delay in event message transmission, the queue can buffer several events and can send them within a single event message as soon as transmission time is available. Basler pioneer...
  • Page 206 API. The pylon software development kit includes a "Camera Events" code sample that illustrates the entire process. For more detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference.

  • Page 207: Test Images

    // set for the first test image Camera.TestImageSelector.SetValue( TestImageSelector_Testimage1 ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
  • Page 208 The image moves by one pixel from right to left whenever a new image acquisition is initiated. The test pattern uses a counter that increments by one for each new image acquisition. The mathematical expression for this test image is: Gray Value = [column number + row number + counter] MOD 4096 Basler pioneer...
  • Page 209 The image moves by one pixel from right to left whenever you signal the camera to capture a new image. To display this test pattern on a monitor, you must convert the YUV output from the camera to 8 bit RGB. Fig. 52: Test Image Six Basler pioneer...

  • Page 210: Device Information Parameters

    Device User ID (read / write) - is used to assign a user defined name to a device. This name will be displayed in the Basler pylon Viewer and the Basler pylon IP Configuration Tool. The name will also be visible in the "friendly name" field of the device information objects returned by pylon’s device enumeration procedure.
  • Page 211 For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily read the parameters and to read or write the Device User ID.

  • Page 212: Configuration Sets

    The settings for frame transmission delay, inter packet delay, and the luminance lookup table are not saved in the user sets and are lost when the camera is reset or switched off. If used, these settings must be set again after each camera reset or restart. Basler pioneer...

  • Page 213: Saving Configuration Sets

    Camera.UserSetSelector.SetValue( UserSetSelector_UserSet1 ); Camera.UserSetSave.Execute( ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.

  • Page 214: Selecting The Default Startup Set

    Set the User Set Default Selector to User Set 1, User Set 2, User Set 3, or Default. You can set the User Set Default Selector from within your application software by using the pylon API. The following code snippet illustrates using the API to set the selector: Camera.UserSetDefaultSelector.SetValue( UserSetDefaultSelector_Default ); Basler pioneer...

  • Page 215: Chunk Features

    The features that add chunks to the acquired images are referred to as “chunk” features. Before you can use any of the features that add chunks to the image, you must make the chunk mode active. Making the chunk mode active is described in the next section. Basler pioneer...

  • Page 216: Making The "Chunk Mode" Active And Enabling The Extended Data Stamp

    Also note that when you enable ChunkModeActive, the PayloadType for the camera changes from "Pylon::PayloadType_Image" to "Pylon::PayloadType_ChunkData". For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
  • Page 217 = Camera.ChunkHeight.GetValue(); int64_t dynamicRangeMin = Camera.ChunkDynamicRangeMin.GetValue(); int64_t dynamicRangeMax = Camera.ChunkDynamicRangeMax.GetValue(); ChunkPixelFormatEnums pixelFormat = Camera.ChunkPixelFormat.GetValue(); For more information about using the chunk parser, see the sample code that is included with the Basler pylon Software Development Kit (SDK). Basler pioneer...

  • Page 218: Frame Counter

    // make chunk mode active and enable Frame Counter chunk Camera.ChunkModeActive.SetValue( true ); Camera.ChunkSelector.SetValue( ChunkSelector_Framecounter ); Camera.ChunkEnable.SetValue( true ); // retrieve date from the chunk IChunkParser &ChunkParser = *Camera.CreateChunkParser(); GrabResult Result; StreamGrabber.RetrieveResult( Result ); ChunkParser.AttachBuffer( (unsigned char*) Result.Buffer(), Basler pioneer...
  • Page 219 Chunk Features Result.GetPayloadSize() ); int64_t frameCounter = Camera.ChunkFramecounter.GetValue(); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.

  • Page 220: Time Stamp

    // make chunk mode active and enable Time Stamp chunk Camera.ChunkModeActive.SetValue( true ); Camera.ChunkSelector.SetValue( ChunkSelector_Timestamp ); Camera.ChunkEnable.SetValue( true ); // retrieve data from the chunk IChunkParser &ChunkParser = *Camera.CreateChunkParser(); GrabResult Result; StreamGrabber.RetrieveResult( Result ); ChunkParser.AttachBuffer( (unsigned char*) Result.Buffer(), Result.GetPayloadSize() ); int64_t timeStamp = Camera.ChunkTimestamp.GetValue(); Basler pioneer...
  • Page 221 Chunk Features For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon Viewer, see Section 2.2 on page 20 and Section 2.4 on...

  • Page 222: Line Status All

    API to activate the chunk mode, enable the line status all chunk, run the parser, and retrieve the line status all chunk data: // make chunk mode active and enable Line Status All chunk Camera.ChunkModeActive.SetValue( true ); Camera.ChunkSelector.SetValue( ChunkSelector_LineStatusAll ); Basler pioneer...
  • Page 223 ChunkParser.AttachBuffer( (unsigned char*) Result.Buffer(), Result.GetPayloadSize() ); int64_t lineStatusAll = Camera.ChunkLineStatusAll.GetValue(); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.

  • Page 224: Crc Checksum

    API to activate the chunk mode, enable the time stamp chunk, run the parser, and retrieve the frame counter chunk data: // Make chunk mode active and enable CRC chunk Camera.ChunkModeActive.SetValue( true ); Basler pioneer...
  • Page 225 ( ChunkParser.HasCRC() && ! ChunkParser.CheckCRC() ) cerr << "Image corrupted!" << endl; For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
  • Page 226 Chunk Features Basler pioneer...

  • Page 227: Troubleshooting And Support

    If you do decide to contact Basler technical support, please take a look at the form that appears on the last two pages of this section before you call. Filling out this form will help make sure that you have all of the information the Basler technical support team needs to help you with your problem.

  • Page 228: Before Contacting Basler Technical Support

    15.2 Before Contacting Basler Technical Support To help you as quickly and efficiently as possible when you have a problem with a Basler camera, it is important that you collect several pieces of information before you contact technical support. Copy the form that appears on the next two pages, fill it out, and fax the pages to your local dealer or to your nearest Basler support center.
  • Page 229 Parameter set It is very important for Basler Technical Support to get a copy of the exact camera parameters that you were using when the problem occurred. To make note of the parameters, use Basler’s "The Viewer" tool.
  • Page 230 Troubleshooting and Support Basler pioneer...

  • Page 231: Revision History

    24 May 2007 First release covering production cameras. AW00015104000 8 June 2007 Modified Section 2 for the installation of the Basler pylon software, version 1.0. AW00015105000 19 July 2007 Integrated the Kodak KAI-2093 sensor. Minor corrections throughout the manual. Added information on IP30 in Section 1.2.
  • Page 232 Revision History Basler pioneer...

  • Page 233: Feedback

    Feedback Feedback Your feedback will help us improve our documentation. Please click the link below to access an online feedback form. Your input is greatly appreciated. http://www.baslerweb.com/umfrage/survey.html Basler pioneer...
  • Page 234 Feedback Basler pioneer...

  • Page 235: Index

    1.......181 device model name parameter ....200 black level raw tap 2.......181 device scan type parameter....200 block diagram ...........99 device user ID parameter ...... 200 brightness, initial setup......47 device vendor name parameter ..... 200 Basler pioneer...
  • Page 236 ..118 jumbo frames........56, 93 maximum allowed ......137 jumbo packets ........56, 93 setting with a parameter....114 frame readout time .........135 frame retention parameter .......74 frame transmission delay parameter..86 frame transmission time ......135 free run...........114 functional description .......97 Basler pioneer...
  • Page 237 120 protection class........11 pylon API ........... 20, 52 network adapter, recommended..19, 53 pylon Viewer ........40, 51 network architectures, recommended ..54 pylon Viewer package......20 network drivers .........73 network switch........55, 56 Basler pioneer...
  • Page 238 YUV 422 packed pixel format ..148, 157 time delay time base abs parameter ..171 time stamp chunk ........210 timed exposure mode ......120 timer delay ..........172 timer delay abs parameter .....172 timer delay raw parameter .....171 Basler pioneer...

Table of Contents