互換性とパラメータマッピング#
Peripheral Devices Control機能には、Light Control機能およびOptic Control機能が含まれています。
Light Control機能は、従来のファームウェアバージョンですでに利用可能でした。Optic Control機能は、Peripheral Devices Control機能とともに導入されました。
照明デバイスまたは光学機器(レンズなど)のいずれ専用に設計されたパラメータは、対応する機能トピック(Light ControlまたはOptic Control)に記載されています。
情報
Basler Peripheral Devices Control機能を含むファームウェアにアップグレードする場合は、次の点に注意してください。
- 既存のセットアップに変更がない場合、つまり、カメラと照明がこれまで通り設定されており、新しいデバイスが追加されていない場合:
パラメータ設定を変更する必要はありません。既存のパラメータ名(レガシーパラメータ名)は引き続き有効であり、当面の間サポートされます。 - それにもかかわらず、既存の照明を引き続き使用する場合でも、将来の互換性を確保するために、新しいパラメータ名を使用するようにアプリケーションを更新することをお勧めします。古いパラメータ名と新しいパラメータ名を並行して使用すると、問題が発生する可能性があります。
- カメラと照明で構成される既存のセットアップに電子制御式レンズの追加を検討している場合は、パラメータ設定とソフトウェアコード全体を、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パラメータはありません。