Skip to content

Basler Vision Connector: Getting Started#

Installing the Basler Vision Connector on the Local IE Management System#

The Siemens Industrial Edge Management System consists of three components:

Siemens Industrial Edge Infrastructure

To install the Basler Vision Connector on the local IE Management system, you need to perform steps in all three components as described in this topic.

Installation Steps in First Component: Industrial Edge Hub#

On the Industrial Edge Hub, you purchase apps:

  1. Open the Siemens Hub Page and the Siemens Marketplace website.
  2. In the Siemens Industrial Management Marketplace:
  3. Purchase the Basler Vision Connector app type you require: Multi Camera Connection or Single Camera Connector. The Single Camera Connector is free of charge, but you have to request login data in the Industrial Edge Hub. The Multi Camera Connector is not free of charge. See information under Prerequisites.
  4. You get the access code for the purchased Basler Vision Connector app from your Siemens contact person.
  5. Log into the Siemens Industrial Management Hub with your access data provided by Siemens.

    Siemens Industrial Hub

  6. In the Industrial Edge Management Hub: In the Library menu, click the Applications tab. A window with all available/purchased apps appears.

    Applications Displayed in the Hub

    Depending on your use case, select the corresponding Basler Vision Connector app:

    • If you want to use only one camera: Select the Basler Vision Connector Single Camera Connection app.
    • If you want to use more than one camera: Select the Basler Vision Connector Multi Camera Connection app.

    It's possible to use the Multi Camera Connection version of the Basler Vision Connector with a single camera. But if you use the Single Camera Connection version with more than one camera, an error message is displayed indicating that this isn't possible.

    In the following topics, the generic term Basler Vision Connector is used whenever it doesn't matter how many cameras are used. If it's important to differentiate, the specific Basler Vision Connector name is indicated, i.e. Basler Vision Connector (Multi Camera Connection) or Basler Vision Connector (Single Camera Connection).

  7. Select the Basler Vision Connector app version you want to install by clicking the app name. The Installation and subscription overview list appears.

    Installation and Subscription Overview List

    The Installation and subscription overview list displays the installed IE Management instances.

  8. Select the local repository or repositories (IEM) where you want to deploy the Basler Vision Connector app to: Activate the corresponding checkbox or checkboxes.

  9. Click Copy latest version to IEM(s).

The Basler Vision Connector app is now copied to your local Industrial Edge Device management system.

Installation Step in Component 3: Enabling the Layer 2 Network on your Edge Device#

Before you install the Basler Vision Connector on our Edge Device, you must enable the layer 2 network on your Edge Device. Otherwise an error occurs during the installation of the Basler Vision Connector app on your local Edge Device.

To enable the layer 2 network on your Edge Device:

  1. On your Edge Device: Go to the Settings menu item.

    Settings Menu of Edge Device

  2. Click the Connectivity tab > LAN Network > Edit (pencil symbol).

    LAN Network Dialog

    The Edit Network Interface dialog appears:

    Edit Network Interface Dialog

  3. In the Layer 2 (L2) for Apps (Optional) group: Enter the number for the start address in the Start IP Address field.

  4. Click Update. The Layer 2 network is now enabled.
  5. For a later step, check the available IP addresses: Click Advanced Settings to see the available IP addresses.

    These numbers are important when configuring the IP address of the camera.

    IP address numbers with activated checkboxes are available:

    L2 Network Advanced Settings (IP Numbers Grayed)

Installation Steps in Second Component: Industrial Edge Management Platform#

To install the Basler Vision Connector app to a local IE device in your factory:

  1. Open Application Manager in the Siemens Industrial Edge Management platform.

    IE App Configuration Service

  2. Make sure that IE App Configuration Service is installed.

    IE App Configuration Service

    This is important to get the right JSON form output and is thus a prerequisite that the Basler Vision Connector runs correctly. If IE App Configuration Service is not installed, go to Catalog, click the IE App Configuration Service and click Install Now.

    Installing the IE App Configuration Service

    Installing the IE App Configuration Service

  3. To install the Basler Vision Connector to your local device, go back to the start page of your Industrial Edge Management platform and select Edge Manager.

    Industrial Edge Management: Installing the Basler Vision Connector on Your Local Device

  4. Select the Catalog menu, and select the Basler Vision Connector app you want to install. The Catalog window displays the deployed Basler Vision Connector app.

    Selected Vision Connector in Catalog)

  5. Click Install.
    The Install App wizard appears.

  6. On the Install App > Configurations wizard page, configure the values required for your Basler Vision Connector.

    Basler Vision Connector Installation Wizard: Configure Settings

    This table shows the default values:

    Default Values
    ZeroMQ Settings
    Req/Rep Port: 5555 Pub/Sub Port: 5556
    MQTT Settings
    Hostname: ie-databus Port: 1883
    Username: <your_username> Password: <your_password>
    RootTopic: Enter a unique ID. If you don't fill out this field, the string BaslerVisionConnector is used. Client ID: Enter a unique ID. If you don't fill out this field, an ID is generated.
    Logging
    Level: Info Available values: Info / Warning / Error / Debug
  7. On the Install App > Configurations wizard page of the installation wizard, select the checkbox basler-vision-connector and click Next. If the basler-vision-connector checkbox isn't selected, your configured settings aren't saved to the installation of the Basler Vision Connector.

    Basler Vision Connector Installation Wizard

  8. If the layer 2 network hasn't been configured before (see Enabling the Layer 2 Network), an error message is displayed:

    Layer 2 Network Error Message

    If this message appears, enable the layer 2 network as described in Enabling the Layer 2 Network.

  9. Click Next.
    The Device Selection page appears.

    Install App > Device Selection

  10. In the Edge Devices List section, activate the checkbox of the local IE device or devices on which you want to install the Basler Vision Connector app and click Install Now.

  11. You can see the progress of your installation in the Edge Management platform under Job Status:

    Basler Vision Connector Installation Progress

  12. Once the Basler Vision Connector app has been installed, you can download a log file that documents the installation status in the Apps menu:

    Basler Vision Connector Installation Log File

    Use this log file later on when a problem occurs in the Basler Vision Connector. If problems occur, set the log level to Debug in the configuration of the Basler Vision Connector.

Changing the Configuration of the Basler Vision Connector (Edge Management Platform)#

You can change the settings you have configured during installation of the Basler Vision Connector. To change these settings:

  1. Go to your Edge Management platform, right-click the Basler Vision Connector in My Installed Apps and select Update Configuration from the drop-down menu.

    Basler Vision Connector: Updating the Configuration

    The Update Configuration wizard opens up.

    Basler Vision Connector: Update Configuration Wizard

  2. Configure the settings as required, go through the Update Configuration wizard and click Install Now.

  3. After you have updated the Basler Vision Connector on your local Edge Device, you must manually restart the Basler Vision Connector app. To restart the Basler Vision Connector, in you Edge Management Platform, open the My Installed Apps menu, select the Basler Vision Connector and click Restart.

Restarting the Basler Vision Connector

Configuring the Camera's IP Address#

To configure the IP address of your camera:

  1. Make sure the camera you want to configure is powered and online.
  2. On a PC that isn't the Edge Device (Windows or Linux), configure the camera's IP address so that it is in the range defined in the layer 2 network.
    Only then the camera is visible to the Edge Device and hence to the Basler Vision Connector app.
    You can use the pylon IP Configurator to check and if necessary to adapt the camera's IP address (see screenshot below). For information, see Assigning an IP Address to a Camera.

    Info

    The pylon IP Configurator isn't included in the delivery of the Basler Vision Connector, but is part of the Basler pylon Software Suite.

    pylon IP Configurator

    Info

    The following camera parameter names are always taken directly from the camera firmware:

    • SetParameters
    • GetParameters

    The SetQuickParameters changes all gain parameter names from the camera firmware to Gain.

Connecting Your App to the Basler Vision Connector#

You can connect any of your Siemens Industrial Edge app with the Basler Vision Connector. To connect your app to the Basler Vision Connector via ZMQ, use the following host name:

Linux
Multi Camera baslervisionconnector-multi-x86-64
Single Camera baslervisionconnector-single-x86-64

Alternatively, you can connect your app via the IP address of the Basler Vision Connector. To find out the IP address of the Basler Vision Connector, you can use the Data Flow Monitoring app.

To connect your app via MQTT, use the IP address or the host name of the Databus app.

Using the JSON Test Files with Industrial Edge Flow Creator#

To use the files:

  1. For the next steps (opening the camera, setting parameters, etc.), download the following JSON test files to your computer. These files are only available via the Basler Product Documentation:
  2. Make sure that the following apps are installed on your Edge Device in addition to the Basler Vision Connector:

    For the MQTT test you need:

    • the Flow Creator app
    • the Data Flow Monitoring app (to find out the IP address of the Basler Vision Connector)
    • the Databus app (= MQTT Broker)

    For the ZMQ test you need:

    • the Flow Creator app
    • the Data Flow Monitoring app (to find out the IP address of the Basler Vision Connector)

Instructions for MQTT#

A connection to the MQTT broker must be established and the root topics must be subscribed. To ensure that:

  1. Go to Data Connections in your Industrial Edge Management platform.
  2. Select the device where the Databus and the Basler Vision Connector app are installed and add a new user by clicking the Add User button.

    Siemens Databus: Add a New User

  3. Enter your username and password and select the permission Public and Subscribe.

  4. Subscribe to the root topic: Click the Add Topics button Add Topic Button.
  5. In the Add Topic dialog, add the topic BaslerVisionConnector/#, select the permission Publish and Subscribe and click Save.

    Siemens Databus: Add a New Topic

  6. Click Deploy.

    Siemens Databus: Deploy

    The Deploy dialog opens up:

    Siemens Databus: Deploying a New User

  7. Select the Device on which the BVC is installed and click Deploy. The deployment process takes some seconds.

  8. In the Edge Management platform, open your Edge Device.

    Opening the Siemens Flow Creator App

  9. Go to Apps and click Flow Creator. The Flow Creator app opens up.

  10. From the menu, select Import. Import the MQTT JSON test file.

    Siemens Flow Creator: Importing the MQTT JSON Test File


    The Test JSON file is imported and displayed as topics in the Flow Creator app.

  11. Double-click the topic BaslerVisionConnector/request. The Edit mqtt out node dialog opens up. Click the pencil/edit button.

    Siemens Flow Creator: Editing the BaslerVisionConnector/request Topic

  12. Go to Security tab.

    Siemens Flow Creator: Editing User Credentials in MQTT Broker Topic

  13. Ensure that your user name and password are correct. Click Update and Done.

  14. Double-click the topic BaslerVisionConnector/response. The Edit mqtt out node dialog opens up. Click the pencil/edit button.
  15. Go to Security tab.
  16. Ensure that your user name and password are correct. Click Update and Done.
  17. Click Deploy. The connection to the MQTT broker is established. If the connection is established correctly, the topics BaslerVisionConnector/request and BaslerVisionConnector/response are shown as connected:

    Siemens Flow Creator: Connection to the MQTT Broker Established

  18. Now you can send messages by clicking the available topics.

  19. Adapt the serial number of your camera in the relevant topics/messages.
  20. You can add new messages by adding a new inject node. See Messaging for information about available messages.

    Siemens Flow Creator: Adding New Nodes

Instructions for ZMQ#

  1. In the Edge Management platform, open your Edge Device.

    Opening the Siemens Flow Creator App

  2. Go to Apps and click Flow Creator. The Flow Creator app opens up.

  3. From the menu, select Manage palette.

    Siemens Flow Creator: Manage Palette

  4. The User Settings menu opens up. On the Install tab, type zmq into the search filed and click Install for the node-red-contrib-zeromq node.

    Siemens Flow Creator: Manage Palette

    The node-red-contrib-zeromq node is installed.

  5. From the menu, select Import. Import the ZMQ JSON test file.

    Siemens Flow Creator: Importing the ZMQ JSON Test File

  6. In the imported test file, connect the ZMQ topics, i.e. zeromq and {DeviceID}/stream, to the Basler Vision Connector app: Click the node and change the host name to baslervisionconnector-multi-x86-64 or baslervisionconnector-single-x86-64.

    Siemens Flow Creator: Connecting the ZMQ Topics

    If the connection is established correctly, the topics zeromq and {DeviceID}/stream are shown as connected:

    Siemens Flow Creator: Connection to the Basler Vision Connector Established

  7. Now you can send messages by clicking the available topics. To see the reply of the message, switch to the debug mode:

    Siemens Flow Creator: ZMQ Replies in Debug Mode

  8. You can add new messages by adding a new inject topic. See Messaging for information about available messages.

    Siemens Flow Creator: Adding New Nodes

Next Steps#

In the previous steps you've installed the Basler Vision Connector and configured the IP address of your camera. The next steps are:

  • Setting up and configuring the accessories you use in your setup (e.g. lens type, illumination, etc.). To do this you can use the pylon Viewer or use the commands in the Messaging section.

    Info

    The pylon Basler pylon Viewer isn't included in the delivery of the Basler Vision Connector, but is part of the Basler pylon Software Suite.

  • Configuring the camera: For information about the camera features and how to use them, see the Feature documentation

  • Configuring the image processing.
    For information about the different apps and possibilities, e.g. AI Interference Server that can be used for further image processing, see the Siemens documentation "How to build your use case".