跳转到内容
STAGING SERVER
DEVELOPMENT SERVER

兼容性和参数映射#

Peripheral Devices Control 功能提供了一套统一的参数,用于控制光源和光学设备(例如镜头)等外围设备。

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 参数。