Linux arm64

This guide provides instructions for setting up the development environment and using ItalaApi on Linux arm64 machines. When installing ItalaSDK on Linux arm64, several components are provided to support camera integration and development.

  • ItalaView is a desktop application designed to demonstrate and test camera features interactively.

  • ItalaApi, which offers programming interfaces for C++, C, Python, and .NET, enabling developers to integrate camera functionality into a wide range of applications.

  • Itala GENTL producer as a .cti file, allowing third-party software to interface with Itala cameras using the GenICam standard.

Note

oegevmodule is not distributed with the SDK, but a script located in scripts/oegevmodules is included to download and install it on your system. Make sure that you have the necessary permissions to run the installation script and to install packages on your system.

Warning

If the kernel is updated, you will need to reinstall the oegevmodule to ensure compatibility with the new kernel version. After running a command such as sudo apt update && sudo apt upgrade, check your kernel version using uname -r. If the kernel version has changed, reinstall oegevmodule by running the installation script:

sudo ./scripts/oegevmodules/install.sh

Shared library management

The ItalaSDK installer automatically adds its shared library locations to the linker search path by creating a configuration file under /etc/ld.so.conf.d/. This ensures that the necessary .so files are found by the system at runtime.

Configuration by language

The following sections outline the necessary steps for the different supported programming languages.

With CMake

ItalaApi can be easily integrated into a CMake project. You can make the package findable by either:

  • Adding the ItalaApi CMake export path to the CMAKE_PREFIX_PATH variable: /opt/itala-sdk/cmake.

  • Setting the ItalaApi_DIR variable to that same location.

After that, you can find the package and link against its targets in your CMakeLists.txt:

find_package(ItalaApi REQUIRED)
find_package(GenApi REQUIRED)

# ...

target_link_libraries(your_target PRIVATE ItalaApi::ItalaApi GenApi::GenApi)

A set of CMake samples under /opt/itala-sdk/samples demonstrates how to configure projects to use ItalaApi.

Without CMake

If you are not using CMake, configure your tools as follows:

  • Include Path: Point to the /opt/itala-sdk/include folder.

  • Linker: Compile your code against the following shared libraries located in /opt/itala-sdk: * libItalaApi.so * libGenApi_gcc7_v3_3_OptoE.so * libGCBase_gcc7_v3_3_OptoE.so * libLog_gcc7_v3_3_OptoE.so

For users without a CMake installation, a sample Makefile is available under samples/ItalaApi/_Makefiles. It compiles and links all samples, placing the executables in the same directory. Note that this file is not relocatable.

With CMake

ItalaApiC can be easily integrated into a CMake project. You can make the package findable by either:

  • Adding the ItalaApiC CMake export path to the CMAKE_PREFIX_PATH variable: /opt/itala-sdk/cmake.

  • Setting the ItalaApiC_DIR variable to that same location.

Then, call find_package(ItalaApiC) in your CMakeLists.txt to make the target available for linking.

A set of CMake samples under /opt/itala-sdk/samples demonstrates how to configure projects to use ItalaApiC.

Without CMake

If you are not using CMake, configure your tools as follows:

  • Include Path: Point to the /opt/itala-sdk/include folder.

  • Linker: Compile your code against the libItalaApiC.so shared library available under /opt/itala-sdk.

For users without a CMake installation, a sample Makefile is available under samples/ItalaApiC/_Makefiles. It compiles and links all samples, placing the executables in the same directory. Note that this file is not relocatable.

On Linux, ItalaApiNET must be referenced manually in your project. When using the dotnet CLI, you can reference ItalaApiNET.dll inside your .csproj file using the <HintPath> tag.

<Reference Include="ItalaApiNET">
  <HintPath>/opt/itala-sdk/bin/ItalaApiNET.dll</HintPath>
</Reference>

Warning

ItalaApiNET.dll depends on other native shared libraries installed by the ItalaSDK. These libraries must be kept in the same folder as the DLL for the application to work correctly.

To use ItalaApiPython, you must install the itala wheel package using pip. The wheel file is located under /opt/itala-sdk/bindings.

Warning

On aarch64, the Itala wheel requires pip 19.3 or higher due to the manylinux standard.

Run the following command from the bindings directory to install the package:

.../bindings> python -m pip install itala-1.0.0-....whl

To use the API in your code, import the itala module from the itala package:

from itala import itala

ItalaView

To execute ItalaView from terminal you can navigate to /opt/itala-sdk/application. To launch ItalaView:

/opt/itala-sdk/application ./ItalaView.Linux

Hardware configuration

For hardware or network configuration instructions, please refer to the camera’s manual.