Basler Vision Connector Messaging: Opening the Camera Connection#

GenICam cameras demand the connection to be open before you can start to set parameters and image streaming. This connection is an exclusive access. This means that no other app can access the camera and change parameters nor stream images.

You can open a camera by defining an identification string in the DeviceID field. The Basler Vision Connector then tries to find a matching camera by searching for this identification string in the information from the available cameras. The search order is as follows:

1. MAC address
2. Serial number
3. IP address
4. User defined name
5. Model name
6. Vendor name
7. Interface

Example:

An identification string is provided in the DeviceID field. The Basler Vision Connector first tries to find a camera with a matching MAC address. If no matching MAC address is found, the Basler Vision Connector tries to find a camera with a matching serial number. The Basler Vision Connector continues with the other identification criteria until a matching camera is found and tries to open this camera.

If several cameras are found matching the same information, the Basler Vision Connector tries to open the first camera. It's up to the Basler Vision Connector which camera is the first one.

The following restrictions apply to DeviceID, and MAC address:

DeviceIDs must only contain the following characters:

• Letters (A-Z or a-z)
• Digits (0-9)
• Hyphens (-)
• Colons (:)
• Underscores (_)
• Full stop (.)

The following identifiers can't be used as a DeviceID:

• "request"
• "response"
• "logging"
• "app"
• "device"

MAC addresses can be formatted using these formats:

• Using no delimiter (e.g., "208756709504")
• Using hyphens as delimiter (e.g., "20-87-56-70-95-04")
• Using colons as delimiter (e.g., "20:87:56:70:95:04")

The term DeviceID refers to the identifying string used for a camera device when opening it. This exact string is used in all DeviceID fields of all requests regarding this camera for identifying the opened camera device while it's used and until it's closed again. Only after closing a camera, a camera device can be opened with a different DeviceID. The value of the DeviceID is one of the fields returned during the device info.

Using a different DeviceID for a camera device while it's open, even if it refers to the same device, leads to an error.

JSON Payload#

{
    "TransactionID": "1232156",
    "Action": "OpenDevice",
    "DeviceID": "548451887"
}

Response Object#

{
    "TransactionID": "123456",
    "ReturnCode": 0,
    "Message": "Camera open."
}