Skip to content
STAGING SERVER
DEVELOPMENT SERVER

Basler Vision Connector#

With the Basler Vision Connector, you can operate and configure your Basler cameras on your in-factory industrial edge devices via the Siemens Industrial Edge Hub. In the following topics, you find information about downloading, installing, and configuring the Basler Vision Connector.

Info

You can configure different Basler camera models (GigE, USB) with the Basler Vision Connector app. However, the Basler Vision Connector app only supports GigE cameras as the Siemens Industrial Edge devices can currently only deal with GigE cameras, e.g., Basler ace 2.

Required Knowledge#

The Basler Vision Connector and Basler digital cameras for machine vision are designed for use by professionals only, concerned with the following tasks:

  • Camera integration and setup
  • Everyday camera use

For installing and configuring your Industrial Edge devices and the Basler Vision Connector app, you require the following knowledge:

  • Knowledge about MQTT / ZeroMQ protocol communication
  • Knowledge working with Docker and Docker container is helpful.

The Basler Vision Connector documentation assumes the skills of electrical engineers, systems engineers, mechatronics engineers, technicians, and information technology engineers. Basler Vision Connector and camera use isn't allowed for persons with insufficient skills or with impairments that prevent them from doing the following tasks:

  • Using cameras correctly
  • Adhering to the safety instructions
  • Fully understanding all relevant camera documentation and other linked documentation

Additional Information#

Prerequisites#

To install and use the Basler Vision Connector, you need the following tools and hardware:

  • A working Internet connection.
  • Access to the Siemens Industrial Edge Hub (provided by Siemens).
    Contact Siemens to get your personal access to the hub.
  • Installed and configured Siemens IEM Instances and all IE devices you require for your use case. For information about installing the IEM instances and IE devices, see the Siemens documentation. Requirements for the IE devices, see in section Prerequisites of the IE Device.
  • Installed Basler camera.
    For further information about Basler camera installation and configuration:
    • Go to the Camera Documentation, select the camera model you installed in your factory or search for your camera model via the camera filter (located to the left of the Search field of this documentation).
    • When the camera model is selected, the camera and its feature documentation are displayed. Read the safety instructions of your camera model.
  • To use vTools and more than one camera with the Basler Vision Connector, you need to purchase and assign licenses for the vTools and several cameras to your Industrial edge Device. See Basler Vision Connector Licensing for more details.
  • To create or edit vTool recipes, Basler recommends to use pylon version 25.08 or lower. vTool recipes created in pylon 25.09 might not work correctly in the Basler Vision Connector.

Prerequisites of the IE Device#

To connect your GigE camera, Basler recommends using the BX-59A, or BX-39A Industrial Edge device. See Connecting Cameras. Basler recommends the following prerequisites for these IE devices:

  • Memory limit: 5,5 GB of free memory space on your Edge Device.

    The memory limit reserves the maximum memory space needed by the Basler Vision Connector. The actual used memory depends on the number of cameras used, the image sizes and amount of frame buffers used (default is 10 frame buffers per camera) and vTools used. If you have a scenario in your project that requires less memory, e.g., if you have only one camera with a small image size and a small number of frame buffers, you can disable the memory limit check as described in the Siemens Industrial Edge Device documentation.

    If your use case requires more than 5,5 GB memory, contact the Basler Support.

  • Minimum version number of the Industrial Edge OS (running on the IEDs):

    • For hardware IEDs (such as BX39 and BX59): simatic-ipc-ied-os-3.0.0-51-x86-64
    • For virtual IEDs (IEVD): ievd-1.22.3-1-a
    • For IE own devices (IEOD): ieod-1.22.3-1-a

  • If you want to connect more than one camera to your IE device:

  • For 10GigE cameras, Basler recommends using the BX-59A device with a network interface card (such as the Broadcom NetXtreme 2x 10GbE, LAN-Adapter).

Programming and Test Tools#