Device Information Parameters

Device information parameters allow you to retrieve basic information about the camera.

This topic describes the parameters and the information each parameter provides.

In this topic Hide

Using the Feature

Standard Device Information Parameters

All Basler cameras mentioned in this documentation provide the following device information parameters:

Parameter Name

Access
(R = read-only,
RW = read / write)

Description

DeviceVendorName

R

The camera's vendor name, e.g., Basler.

DeviceModelName

R

The camera’s model name, e.g., acA3800-14um.

DeviceManufacturerInfo

R

The camera's manufacturer name. Usually contains an empty string.

DeviceVersion

R

The camera's version number.

DeviceFirmwareVersion

R

The camera's firmware version number.

DeviceIDDeviceSerialNumber

R

The camera's serial number.

DeviceUserID

RW

Used to assign a user-defined name to a camera. The name is displayed in the Basler pylon Viewer and the Basler pylon USB Configurator. The name is also visible in the "friendly name" field of the device information objects returned by pylon’s device enumeration procedure.

SensorWidth

R

The actual width of the camera's sensor in pixels.

SensorHeight

R

The actual height of the camera's sensor in pixels.

Additional Device Information Parameters

Depending on your camera model, the following additional device information parameters are available:

Parameter Name

Access
(R = read-only,
RW = read / write)

Description

DeviceScanType

R

The scan type of the camera's sensor (Areascan or Linescan).

DeviceSFNCVersionMajor

R

If available, the major version of the Standard Features Naming Convention (SFNC) that the camera complies with, e.g., "2" for SFNC 2.3.1.

DeviceSFNCVersionMinor

R

If available, the minor version of the Standard Features Naming Convention (SFNC) that the camera complies with, e.g., "3" for SFNC 2.3.1.

DeviceSFNCVersionSubMinor

R

If available, the subminor version of the Standard Features Naming Convention (SFNC) that the camera complies with, e.g., "1" for SFNC 2.3.1.

DeviceLinkSelector

RW

If available, allows you to select the link for data transmission. The parameter is preset to 0. Do not change this parameter.
DeviceLinkSpeed

R

If available, the bandwidth negotiated on the specified link in bytes per second.
DeviceLinkThroughputLimitMode

RW

If available, allows you to limit the maximum available bandwidth for data transmission. To enable the limit, set the parameter to On. The maximum bandwidth is limited to the DeviceLinkThroughputLimit parameter value. Note that the actual bandwidth used for data transmission may be lower than the DeviceLinkThroughputLimit parameter value.
DeviceLinkThroughputLimit

RW

If available, specifies the maximum available bandwidth for data transmission in bytes per second. To enable the limit, set the DeviceLinkThroughputLimitMode to On.
On GigE cameras, the camera automatically adjusts the inter-packet delay to set the bandwidth to the specified limit.
DeviceLinkCurrentThroughput

R

If available, the actual bandwidth currently used for data transmission in bytes per second.
DeviceIndicatorMode

RW

If available, allows you to turn the camera's status LED on or off. To turn the status LED on, set the parameter to Active. To turn the status LED off, set the parameter to Inactive.
WidthMax

R

The maximum allowed width of the image ROI in pixels. The value adapts to the current settings for Binning, Decimation, or Scaling (if available).

HeightMax

R

The maximum allowed height of the image ROI in pixels. The value adapts to the current settings for Binning, Decimation, or Scaling (if available).

Specifics

Camera Model

Additional Device Information Parameters

All ace 2 GigE camera models tbd
All ace 2 USB 3.0 camera models tbd
All ace USB 3.0 camera models
  • DeviceSFNCVersionMajor
  • DeviceSFNCVersionMinor
  • DeviceSFNCVersionSubMinor
  • DeviceLinkSelector
  • DeviceLinkSpeed
  • DeviceLinkThroughputLimitMode
  • DeviceLinkThroughputLimit
  • DeviceLinkCurrentThroughput
  • DeviceScanType
  • WidthMax
  • HeightMax
All ace GigE camera models
  • DeviceScanType
  • WidthMax
  • HeightMax
All boost CXP-12 camera models tbd
All dart BCON for LVDS camera models
  • DeviceSFNCVersionMajor
  • DeviceSFNCVersionMinor
  • DeviceSFNCVersionSubMinor
  • DeviceLinkSelector
  • DeviceLinkSpeed
  • DeviceLinkThroughputLimitMode
  • DeviceLinkThroughputLimit
  • DeviceIndicatorMode
  • DeviceScanType
  • WidthMax
  • HeightMax
All dart BCON for MIPI camera models None
All dart USB 3.0 camera models
  • DeviceSFNCVersionMajor
  • DeviceSFNCVersionMinor
  • DeviceSFNCVersionSubMinor
  • DeviceLinkSelector
  • DeviceLinkSpeed
  • DeviceLinkThroughputLimitMode
  • DeviceLinkThroughputLimit
  • DeviceIndicatorMode
  • DeviceScanType
  • WidthMax
  • HeightMax
All pulse USB 3.0 camera models
  • DeviceSFNCVersionMajor
  • DeviceSFNCVersionMinor
  • DeviceSFNCVersionSubMinor
  • DeviceLinkSelector
  • DeviceLinkSpeed
  • DeviceLinkThroughputLimitMode
  • DeviceLinkThroughputLimit
  • DeviceScanType
  • WidthMax
  • HeightMax

Sample Code

// Example: Getting some of the camera's device information parameters
// Get the camera's vendor name
String_t s = camera.DeviceVendorName.GetValue();
// Get the camera's firmware version
String_t s = camera.DeviceFirmwareVersion.GetValue();
// Get the camera's model name
String_t s = camera.DeviceModelName.GetValue();
// Get the width of the camera's sensor
int64_t i = camera.SensorWidth.GetValue();
INodeMap& nodemap = camera.GetNodeMap();
// Example: Getting some of the camera's device information parameters
// Get the camera's vendor name
String_t s = CStringPtr(nodemap.GetNode("DeviceVendorName"))->GetValue();
// Get the camera's firmware version
s = CStringPtr(nodemap.GetNode("DeviceFirmwareVersion"))->GetValue();
// Get the camera's model name
s = CStringPtr(nodemap.GetNode("DeviceModelName"))->GetValue();
// Get the width of the camera's sensor
int64_t i = CIntegerPtr(nodemap.GetNode("SensorWidth"))->GetValue();
// Example: Getting some of the camera's device information parameters
// Get the camera's vendor name
string s = camera.Parameters[PLCamera.DeviceVendorName].GetValue();
// Get the camera's firmware version
s = camera.Parameters[PLCamera.DeviceFirmwareVersion].GetValue();
// Get the camera's model name
s = camera.Parameters[PLCamera.DeviceModelName].GetValue();
// Get the width of the camera's sensor
Int64 i = camera.Parameters[PLCamera.SensorWidth].GetValue();
// Example: Getting some of the camera's device information parameters
// Get the camera's vendor name
string s = Pylon.DeviceFeatureToString(hdev, "DeviceVendorName");
// Get the camera's firmware version
s = Pylon.DeviceFeatureToString(hdev, "DeviceFirmwareVersion");
// Get the camera's model name
s = Pylon.DeviceFeatureToString(hdev, "DeviceModelName");
// Get the width of the camera's sensor
Int64 i = Pylon.DeviceGetIntegerFeature(hdev, "SensorWidth");
/* Macro to check for errors */
#define CHECK(errc) if (GENAPI_E_OK != errc) printErrorAndExit(errc)
GENAPIC_RESULT errRes = GENAPI_E_OK;  /* Return value of pylon methods */
char* s;
size_t len = 0;
 = null;
 = null;
int64_t i = 0;
/* Example: Getting some of the camera's device information parameters */
/* Get the camera's vendor name */
errRes = PylonDeviceFeatureToString(hdev, "DeviceVendorName", NULL, &len);
s = (char*) alloca(len);
errRes = PylonDeviceFeatureToString(hdev, "DeviceVendorName", s, &len);
CHECK(errRes);
/* Get the camera's firmware version */
errRes = PylonDeviceFeatureToString(hdev, "DeviceFirmwareVersion", NULL, &len);
s = (char*) alloca(len);
errRes = PylonDeviceFeatureToString(hdev, "DeviceFirmwareVersion", s, &len);
CHECK(errRes);
/* Get the camera's model name */
errRes = PylonDeviceFeatureToString(hdev, "DeviceModelName", NULL, &len);
s = (char*) alloca(len);
errRes = PylonDeviceFeatureToString(hdev, "DeviceModelName", s, &len);
CHECK(errRes);
/* Get the width of the camera's sensor */
errRes = PylonDeviceGetIntegerFeature(hdev, "SensorWidth", &i);
CHECK(errRes);

You can also use the pylon Viewer to easily set the parameters.