This topic describes the parameters and the information each parameter provides.
In this topic Hide
All Basler cameras mentioned in this documentation provide the following device information parameters:
Parameter Name |
Access |
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. |
Depending on your camera model, the following additional device information parameters are available:
Parameter Name |
Access |
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). |
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 |
|
All ace GigE camera models |
|
All boost CXP-12 camera models | tbd |
All dart BCON for LVDS camera models |
|
All dart BCON for MIPI camera models | None |
All dart USB 3.0 camera models |
|
All pulse USB 3.0 camera models |
|
// 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.