Installation Guide for the pylon Supplementary Package for blaze Cameras
========================================================================

Software Installation
=====================

Prerequisites
-------------

Before you can install the pylon Supplementary Package for blaze, you have to
install pylon 6.2 or higher. You can download the latest version here:
<https://www.baslerweb.com/en/products/software/basler-pylon-camera-software-suite/>

On Debian-based systems (like Ubuntu), Basler recommends downloading and 
installing the pylon_7.*.*.deb Debian package.

For other Linux distributions, download the pylon_7.*.*.setup.tar.gz archive,
extract it, and follow the instructions in the extracted INSTALL document.


Installation of the pylon Supplementary Package for blaze Using Debian Packages
-------------------------------------------------------------------------------

* Ubuntu and other Debian-based Distributions

-- Linux x86_64

Perform the installation by issuing the following command:

    sudo apt-get install \
      ./pylon-supplementary-package-for-blaze-1.7.2.f00d43816_amd64.deb

-- ARM64 Linux

Perform the installation by issuing the following command:

    sudo apt-get install \
      ./pylon-supplementary-package-for-blaze-1.7.2.f00d43816_arm64.deb



* Installation of the pylon Supplementary Package for blaze using tar.gz files
------------------------------------------------------------------------------

For Linux distributions that are not based on Debian, download and extract the
pylon-supplementary-package-for-blaze-1.7.2.f00d43816_x86_64_setup.tar.gz archive.

Change to the extracted directory and extract the
pylon-supplementary-package-for-blaze-1.7.2.f00d43816_x86_64_setup.tar.gz archive
to /opt/pylon

Example:

    tar xf pylon-supplementary-package-for-blaze-1.7.2.f00d43816_x86_64_setup.tar.gz
    cd pylon-supplementary-package-for-blaze-1.7.2.f00d43816_x86_64_setup
    sudo tar -C /opt/pylon -xzf \
      ./pylon-supplementary-package-for-blaze-1.7.2.f00d43816_x86_64.tar.gz

Note
----
To use the blaze Viewer, you must install the latest Mesa OpenGL driver for
your system. On Debian-based platforms, you also need to install the
following packages:
      libgl1-mesa-dri, libgl1-mesa-glx, libxcb-xinerama0, libxcb-xinput0


GENICAM_GENTL64_PATH Environment Variable
-----------------------------------------

To use blaze cameras you need to set up the GENICAM_GENTL64_PATH variable. 

**Note**
If you installed pylon using the Debian package, the environment settings will
be adjusted automatically. To make the settings effective, you have to log out and 
log on again.

If you installed pylon using the .tar.gz archive, you have to setup the environment
yourself. For your convenience, Basler created the pylon-setup-env.sh script, located in
the <PYLON_ROOT>/bin directory, which can carry out the setup.

To set up the environment for a pylon installation in /opt/pylon, execute:

  source /opt/pylon/bin/pylon-setup-env.sh /opt/pylon

If you want the environment to be persistent, you
can add

   source /opt/pylon/bin/pylon-setup-env.sh /opt/pylon

to ~/.bashrc

If you do not use this script, you will have to set up your environment as follows:

   export GENICAM_GENTL64_PATH=/opt/pylon/lib/gentlproducer/gtl:$GENICAM_GENTL64_PATH


Hardware Installation
======================

Refer to the 'Hardware Installation' topic in the Basler Product Documentation:
https://docs.baslerweb.com/hardware-installation-(blaze)

Camera IP Configuration
=======================

By default, the Basler blaze cameras are set up for automatic IP address
assignment by DHCP, or, if no DHCP server is available, Auto IP. Depending on  
the Linux distribution, Auto IP is also known as Automatic Private IP 
Addressing, LLA, Zeroconf, link-local, or dynamic address assignment.

Using the IP Configurator tool (/opt/pylon/bin/ipconfigurator), a 
static IP address can be assigned manually.

For more information about choosing the right network configuration, refer to
the 'Network Configuration' topic in the Basler Product Documentation:
https://docs.baslerweb.com/network-configuration-(blaze)


Network Performance Optimization
================================

For more information about optimizing the network settings to avoid network
package losses, refer to the 'Performance Optimization' section in the
'Network Configuration' topic in the Basler Product Documentation:
https://docs.baslerweb.com/network-configuration-(blaze)#linux_2
