====================================================================================== ====================================================================================== ##### # # # ###### ####### ####### # # # # ## ## # # # # # # # # # # # #### # #### # # # # # # # # # # # # # # # # # # # # # # ## # ##### # # # # # ###### # ##### ### # # # #### # # # # # # # # # ####### # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # ## ##### # # # # # # # ####### # # ## # #### # #### # # ====================================================================================== ====================================================================================== CameraSuite for Linux v3.4.2.0 Installation Guide ====================================================================================== ====================================================================================== ====================================================================================== Supported Platforms ====================================================================================== CameraSuite officially supports following Linux distributions: Ubuntu Desktop 18 LTS x86_64 Ubuntu Desktop 16 LTS x86_64 Ubuntu Desktop 16 LTS i686 Ubuntu Desktop 14 LTS x86_64 Ubuntu Desktop 14 LTS i686 Fedora Workstation 28 x86_64 Fedora Workstation 28 i686 Fedora Workstation 27 x86_64 Fedora Workstation 27 i686 CameraSuite officially supports following ARM platforms: NVIDIA Jetson TX2, Ubuntu 16.04 aarch64, l4t-28.2.1 NVIDIA Jetson TK1, Ubuntu 14.04 armv7l, l4t-28.1 Latest kernel version that CameraSuite officially supports: 4.17.4 Oldest kernel version that CameraSuite officially supports: 3.10.40 Platforms that are not officially supported may require additional setup not described in this installation guide. ====================================================================================== Installation Overview ====================================================================================== CameraSuite is available in following package formats: .deb - for installation on x86 Ubuntu .rpm - for installation on x86 Fedora .run - for installation on ARM platforms Advanced users can also install CameraSuite manually using the .run package. ====================================================================================== Important installation notes ====================================================================================== Reboot is required after installing CameraSuite. This applies to all packages. Information on CameraSuite components and features is available in the file 'readme.txt'. Recommended settings are available in the file 'recommended_settings.txt'. Notes describing additional configuration required by some setups are available in the file 'notes.txt'. These files are available in '/usr/doc/smaretkvision/camerasuite' after installation. ====================================================================================== Installation using .deb package (Ubuntu x86) ====================================================================================== Ubuntu has kernel headers installed by default. If they were removed, enter the following command to install them again: sudo apt-get install linux-headers-$(uname -r) This command requires working network connection. To install CameraSuite from terminal enter the following command: sudo dpkg -i SMARTEKvision_CameraSuite*.deb || sudo apt-get install -f If dpkg command fails due to unmet dependencies, apt-get command will automatically install required dependencies and finish installation of CameraSuite. Automatically installing dependencies requires working internet connection. Reboot your system to finish installing CameraSuite. CameraSuite can be uninstalled using the following command: sudo dpkg -r camerasuite ====================================================================================== Installation using .rpm package (Fedora x86) ====================================================================================== Before installing CameraSuite, install kernel headers using the following command: sudo dnf install kernel-devel-$(uname -r) This command requires working network connection. To install CameraSuite from terminal enter the following command: sudo dnf install SMARTEKvision_CameraSuite*.rpm Any unmet dependencies will be installed automatically. Automatically installing dependencies requires working internet connection. Reboot your system to finish installing CameraSuite. CameraSuite can be uninstalled using the following command: sudo dnf remove camerasuite ====================================================================================== Installation using .run package (ARM) ====================================================================================== Installation using .run package is designed to be flexible and to enable simple installation on various ARM platforms. Installation using .run package also works on x86 platforms. It can be used as an alternative to .deb and .rpm packages. Before installing CameraSuite, give the .run package the permission to run: sudo chmod +x SMARTEKvision_CameraSuite*.run To install CameraSuite, execute the .run package: sudo ./SMARTEKvision_CameraSuite*.run Installation script will detect the system architecture and install appropriate files. Installation script will also detect available packet system and automatically attempt to install missing dependencies. This feature is available only on platforms that have a working network connection and packet systems installed. If automatic installation of a dependency fails, appropriate message will be printed and the installation will continue. Installation script will prompt for installation of various components of CameraSuite: - CameraSuite executables - CameraSuiteClient executable for x86 - C and C++ Examples executables for ARM - GigEVision driver - high performance kernel driver for GigEVision cameras - USB3Vision driver - high performance kernel driver for USB3Vision cameras - Membership in 'video' group - required for using SMARTEKvision kernel drivers without administrator privileges - CameraSuite build environment - files and configurations required for building applications with CameraSuite - supports native build and cross-compiling - Source for CameraSuite Examples - supports building C, C++, Qt4, Qt5 and C# examples natively - supports cross-compiling C and C++ examples - Source for CameraSuiteClient - supports building CameraSuiteClient natively - Automatic installation of dependencies for building examples - tools required for building Examples and CameraSuite Client - they can also be installed manually and are documented in examples.txt - Automatic installation of dependencies for cross-compiling examples - tools required for cross-compiling Examples - they can also be installed manually and are documented in cross_compiling.txt Basic components of CameraSuite will be installed without prompting: - CameraSuite libraries - CameraSuite scripts - CameraSuite driver sources - CameraSuite environment variables - CameraSuite documentation If installation detects that some of the tools required for installation are missing, it will print a warning and ask the user if they want to continue. Installation script offers following installation options to avoid prompting: - full - install every available component - host - install only build environment, sources, build dependencies, and basic components - target - install only drivers and basic components Installation options can be passed to the installation script as parameters: sudo ./SMARTEKvision_CameraSuite*.run full CameraSuite can be uninstalled using the following commands: cd /usr/src/smartekvision/camerasuite/Scripts sudo ./uninstall_camera_suite.sh ====================================================================================== Manual installation ====================================================================================== It is possible to manually install and configure CameraSuite on a Linux system. This option is intended for advanced users who want to control every aspect of installation. The .run package can be extracted as an archive. This archive contains all files required for installing CameraSuite on any platform. Before extracting it, give the .run package the permission to run: sudo chmod +x SMARTEKvision_CameraSuite*.run To extract the archive, execute the .run package with following parameters: ./SMARTEKvision_CameraSuite*.run --keep --noexec This will create a folder named SMARTEKvision_CameraSuite* that contains all CameraSuite files required for manual installation. All components required for manual installation are described in the file 'manual_deployment.txt'. Additionally, a step-by-step example of manual installation is given in the folder 'manual_deployment_example'. These files and folders are available in the doc folder inside the extracted package.