Skip to content

GenICam Generic Data Container (GenDC)#

The Generic Data Container (GenDC) is a component of the GenICam standard suite, specifically designed to handle and transport image data and metadata in a standardized way across different vision systems. GenDC provides a flexible and efficient method for defining and accessing complex data structures, making it highly suitable for applications in machine vision and industrial imaging.

Structure of GenDC#

The image shows the structure of a data packet for a GenDC (Generic Data Container) with a maximum size of 60 MB. Here’s a brief explanation of each section:

Structure of GenDC

  • The layer section contains the image data. Multiple images can be included in one packet.
  • The junk data contains additional information

Adjustment MTU size#

MTU size

The RadarImager is tested with a MTU size of 9000 on client and server side

Linux#

To use the container, the MTU size needs to be adjusted on both the server and the client. For Ubuntu, the following commands need to be executed:

  1. nmcli con show → Select your network interface (connection-name)
  2. sudo nmcli con modify "<connection-name>" 802-3-ethernet.mtu <mtu_size>
  3. nmcli con down "<connection-name>" && nmcli con up "<connection-name>"

Please replace [connection-name] with the appropriate network interface name and [mtu_size] with the desired MTU size.

Windows#

  1. Open Device Manager:

    • Right-click on the Start menu and select Device Manager from the list of options.
    • Alternatively, you can press the Windows + X keyboard shortcut and select Device Manager.
  2. Navigate to Your Network Adapter:

    • In the Device Manager, you will see a list of hardware categories. Locate and expand the Network Adapters category by clicking on the small arrow icon next to the word. This will display all network devices installed on your computer.
  3. Access the Properties of the Network Adapter:

    • Find the network adapter for which you want to enable Jumbo Frames. This is typically a wired Ethernet adapter.
    • Right-click on the appropriate adapter and select Properties from the context menu.
  4. Look for the Jumbo Frame Setting:

    • In the properties of the network adapter, there are several tabs. Click on the Advanced tab.
    • Scroll through the list of properties until you find a setting named Jumbo Frame, Jumbo Packet, or something similar.
  5. Enable Jumbo Frames:

    • Select the Jumbo Frame setting and change the value in the dropdown menu or input field. Typical values for Jumbo Frames are 4088 bytes, 9014 bytes, or higher, depending on your network adapter and network device.
    • Select 9014 bytes
    • Ensure that all devices in your network support Jumbo Frames before enabling this setting.
  6. Save and Apply the Changes:

    • Click OK or Apply to save the changes.
    • It may be necessary to restart your computer for the changes to take effect.

Notes:

  • Not all network adapters support Jumbo Frames. Check the specifications of your adapter to ensure it supports this feature.
  • Using Jumbo Frames can improve network performance, but it can also lead to compatibility issues if not all network devices in the network support Jumbo Frames.

Limitations

Containers up to a maximum size of 60 MB can be sent. Exceeding this size may result in client-side crashes or similar issues.

Settings#

  • layerSelection.indexes : Here you can find how to configure the layers you want to be send
  • singleImage : Here you can find how to disable the GenDC, if you cannot process it