跳至內容
測試伺服器
開發伺服器

相容性與參數對應#

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 功能所引入的對應新參數名稱。它可作為現有應用程式與組態的遷移參考,協助您識別重新命名的參數並更新軟體以確保未來的相容性。

裝置專屬參數(例如用於光源控制的亮度,或用於光學控制的光學專屬參數)記錄在對應的功能主題中,此處未予列出,除非它們被重新命名。

參數對應#

下表將舊版參數名稱對應至隨著 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 參數對應項目。