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:

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.

   

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

   

   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.

   

   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.

   

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

   

   The Edit Network Interface dialog appears:

   

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:

   

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.

   

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

   

   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.

   

   

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.

   

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.

   

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.

   

   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.

   

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

   

   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.

   

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:

    

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:

    

    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.

   

   The Update Configuration wizard opens up.

   

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.

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.

   

   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:

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:
   • mqtt_test.json
   • zmq_test.json

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 button.

   

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

4. Subscribe to the root topic: Click the Add Topics button .

5. In the Add Topic dialog, add the topic BaslerVisionConnector/#, select the permission Publish and Subscribe and click Save.

   

6. Click Deploy.

   

   The Deploy dialog opens up:

   

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.

   

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.

    

    
    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.

    

12. Go to Security tab.

    

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:

    

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.

    

Instructions for ZMQ#

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

   

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

3. From the menu, select 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.

   

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

5. From the menu, select Import. Import 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.

   

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

   

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

   

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

   

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".