Compatibility and Parameter Mapping#

The Peripheral Devices Control feature provides a unified set of parameters for controlling peripheral devices such as lights and optic devices (e.g., lenses).

The Peripheral Devices Control feature includes the Light Control and Optic Control features.
The Light Control feature was already available in previous firmware versions. The Optic Control feature was introduced together with the Peripheral Devices Control feature.

Parameters that are intended exclusively for either light devices or optical devices (e.g., lenses) can be found in the corresponding feature topics, i.e., either under Light Control or under Optic Control.

Info

If you upgrade to a firmware that includes the Basler Peripheral Devices Control feature, note the following:

If nothing changes in your existing setup, i.e., the camera and lights remain configured as before and no new device is added:
You do not need to modify any parameter settings. The existing parameter names (legacy parameter names) remain valid and will continue to be supported for the time being.
Nevertheless, even if you only intend to continue using your existing lights, it is recommended to update your application to use the new parameter names in order to ensure future compatibility. Using old and new parameter names in parallel may potentially lead to issues.
If you are considering adding an electronically controllable lens to your existing setup consisting of a camera and lights, Basler recommends migrating your entire parameter configuration and software code to the parameter names introduced with the Basler Peripheral Devices Control feature, i.e., switching to the new parameter names.
If you are setting up a completely new system with a new camera, new lights, and optionally lenses, use the parameter names provided within the Basler Peripheral Devices Control feature.
The Parameters Mapping table below maps legacy parameter names to their corresponding new parameter names introduced with the Peripheral Devices Control feature. It serves as a migration reference for existing applications and configurations, helping you identify renamed parameters and update your software for future compatibility.

Device-specific parameters (e.g., brightness for light control, or optic-specific parameters for optic control) are documented in the corresponding feature topics and are not listed here unless they were renamed.

Parameters Mapping#

The following table maps legacy parameter names to their corresponding new parameter names introduced with the Peripheral Devices Control feature. It serves as a migration reference for existing applications and configurations, helping you identify renamed parameters and update their software for future compatibility.

Legacy Parameter	Parameter Name under Peripheral Devices Control
`BslLightControlMode`	`BslPeripheralControlMode`
`BslLightControlEnumerateDevices`	`BslPeripheralEnumerateDevices`
`BslLightControlErrorSummary`	`BslPeripheralErrorSummary`
`BslLightControlTriggerSource`	`BslPeripheralTriggerSource`
`BslLightControlTriggerActivation`	`BslPeripheralTriggerActivation`
`BslLightControlOvertriggerCount`	`BslPeripheralOvertriggerCount`
`BslLightControlOvertriggerCountReset`	`BslPeripheralOvertriggerCountReset`
`BslLightDeviceSelector`	`BslPeripheralDeviceSelector`
`BslLightDeviceModelName`	`BslPeripheralDeviceModelName`
`BslLightDeviceFirmwareVersion`	`BslPeripheralDeviceFirmwareVersion`
`BslLightDeviceErrorStatus`	`BslPeripheralDeviceErrorStatus`
–	`BslPeripheralDeviceType`

The BslPeripheralDeviceType is new. It identifies the type of the selected peripheral device (e.g., light or lens). There is no previous Light Control parameter equivalent.