兼容性和参数映射#
Peripheral Devices Control 功能包括 Light Control 和 Optic Control 功能。
Light Control 功能在之前的固件版本中就已经可用。Optic Control 功能与 Peripheral Devices Control 功能一同引入。
专用于光源设备或光学设备(例如镜头)的参数可以在相应的功能主题中找到,即在 Light Control 或 Optic Control 下。
信息
如果您升级到包含 Basler Peripheral Devices Control 功能的固件,请注意以下事项:
- 如果您的现有设置没有任何变化,即相机和光源保持之前的配置且未添加新设备:
您无需修改任何参数设置。现有的参数名称(旧版参数名称)仍然有效,并且在一段时间内将继续得到支持。 - 尽管如此,即使您仅打算继续使用现有的光源,也建议更新您的应用程序,以使用新的参数名称,从而确保未来的兼容性。同时使用新旧参数名称可能会引发潜在问题。
- 如果您考虑在由相机和光源组成的现有设置中添加电子可控镜头,Basler 建议将您的整个参数配置和软件代码迁移到随 Basler Peripheral Devices Control 功能引入的参数名称,即切换到新的参数名称。
- 如果您正在设置一个包含新相机、新光源以及可选镜头的全新系统,请使用 Basler Peripheral Devices Control 功能中提供的参数名称。
- 下方的 Parameters Mapping 表格将旧版参数名称映射到随 Peripheral Devices Control 功能引入的相应新参数名称。它可作为现有应用程序和配置的迁移参考,帮助您识别重命名的参数并更新软件以确保未来的兼容性。
设备特定参数(例如,用于光控的亮度,或用于光学校准的光学特定参数)记录在相应的功能主题中,除非它们被重命名,否则此处不予列出。
Parameters Mapping#
下表将旧版参数名称映射到随 Peripheral Devices Control 功能引入的相应新参数名称。它可作为现有应用程序和配置的迁移参考,帮助您识别重命名的参数并更新其软件以确保未来的兼容性。
| 旧版参数 | 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 |
即: BslPeripheralDeviceType 是新的。它用于标识所选外围设备的类型(例如光源或镜头)。没有先前等效的 Light Control 参数。