Roboception GenICam Convenience Layer

This package combines the Roboception convenience layer for images with the GenICam reference implementation and a GigE Vision transport layer. It is a self contained package that permits configuration and image streaming of GenICam / GigE Vision 2.0 compatible cameras like the Roboception rc_visard. The API is based on C++ 11 and can be compiled under Linux and Windows.

This package also provides some tools that can be called from the command line for discovering cameras, changing their configuration and streaming images.

Prebuilt binaries can be downloaded on the releases page.

Contents

• Minimum Requirements
• Compiling and Installing
  • Linux
  • Windows
• Description of Tools
  • gc_info
  • gc_config
  • gc_stream
  • gc_pointcloud
  • gc_file
• Definition of Device ID
• Finding the Transport Layer
• Network Optimization under Linux

Minimum Requirements

• Linux x64 / i86: gcc >= 4.8
• ARMhf: gcc >= 4.9.4
• Linux AArch64: gcc >= 5.4
• Windows 10: Visual Studio >= VC140

Compiling and Installing

Linux

Building follows the standard cmake build flow. Please make sure to set the install path before compiling. Otherwise it can happen that the transport layer is not found when calling the tools.

cd <main-directory>
mkdir build
cd build
cmake -DCMAKE_INSTALL_PREFIX=<install-directory> ..
make
make install

Bash completion

To install bash completion, configure cmake with -DINSTALL_COMPLETION=ON

Debian package

A Debian package can be built with e.g.

cd <main-directory>
mkdir build
cd build
cmake -DCMAKE_INSTALL_PREFIX=/usr ..
make
make package

Windows

The main directory contains the script build_win.bat. Execute this script in the Visual Studio Developer Command Prompt for building the package. Alternatively, you can use cmake manually to generate a build project for compilation with your favorite compiler.

NOTE: For using the libraries in own projects, define the symbol GENICAM_NO_AUTO_IMPLIB in your project file to avoid linker problems with the GenICam libraries.

Description of Tools

The tools do not offer a graphical user interface. They are meant to be called from a shell (e.g. Power Shell under Windows) or script and controlled by command line parameters. Calling the tools without any parameters prints a help text on the standard output.

NOTE: If any tool returns the error No transport layers found in path ..., then read the section ‘Transport Layer’ below.

gc_info

Lists all available systems (i.e. transport layers), interfaces and devices with some information. If a device ID is given on the command line, then the complete GenICam nodemap with all parameters and their current values are listed.

```

File truncated at 100 lines see the full file

2.7.0 (2024-12-02)

• Added possibility to receive module events for a device
• gc_info: Added interface to test receiving module events
• Improved exception message when opening device is failing
• Fixed crashing when stream and device is closed after loosing connection

2.6.8 (2024-10-16)

• gc_stream:
  • split RawCombined like IntensityCombined
  • apply writable chunk parameters every time after attaching the buffer
• gc_file:
  • Fixed possible problem when reading file via gc_file

2.6.7 (2024-08-23)

• Added functions and parameters to command line tools for loading and storing streamable parameters
• Throw an exception if an image buffer does not contain any data
• Added methods and function with timeout parameters for device discovery

2.6.6 (2024-06-04)

• Added armhf jobs for jammy

2.6.5 (2024-03-12)

• Added method to get remote port of device to directly read and write register
• Added functions to read and write GenICam register parameters
• Fixed write error message of gc_file tool
• fix for gcc 13: use global stdint

2.6.4 (2023-11-09)

• Fixed loading nodemap from file system
• Return device display name, if device user defined name returns an error

2.6.3 (2023-10-06)

• gc_config: -Fixed calling data latch to properly show PTP status
• gc_info:
  • Added choice to either use local or remote nodemap of device
  • Added extended output that includes printing the local nodemaps of system, interface and device as well

2.6.2 (2023-05-17)

• If available, use user defined name of device as display name
• Moving function for printing (part of) nodemap from tools to library
• gc_info:
  • Added possibility to edit nodemap in curses gui
• gc_stream:
  • Storing ChunkRcLineRatio in properties, if available
  • Added option to print chunk data
• Fixed build_win.bat: Include cmake files and allow renaming of base directory
• Fixed allocating too much memory in Image class

2.6.1 (2023-01-09)

• Fixed resetting of systems so that setSystemsPath() can be called again
• Report reason if loading of producer fails
• Fixed compiling under Windows
• Fixed reading registers with size that is less than the requested size
• Added convenience functions for loading and storing data on the camera via GenICam file interface

2.6.0 (2022-11-09)

• Upgraded GenAPI to version 3.4
• Changed gc_file to read and write in blocks of 512 bytes and made FileSize parameter optional

2.5.17 (2022-10-13)

• Added building for Jammy
• Added possibility to specify GenICam parameters on the command line of gc_pointcloud tool
• README: change grep for newer netstat versions

2.5.16 (2022-05-29)

• Added CI build pipelines for ARM64
• net_perf_check.sh use first default interface
• Show enum options even if WriteOnly

2.5.14 (2022-02-02)

• Install licenses of included binaries
• Reporting interface id instead of display name in output of gc_info -s

File truncated at 100 lines see the full file