Framegrabber SDK 5.11.5の既知の問題
このセクションでは、Basler Framegrabber SDK バージョン 5.11.5 の既知の問題に関する情報を説明します。
すべてのコンポーネント
| 概要 | Vivado 2025.1 で構築されたアプレットが読み込まれない場合がある |
| 説明 | Vivado バージョン 2025.1 を使用して作成されたアプレットは、読み込みに失敗する場合があります。 |
| 影響を受ける OS | Linux および Windows |
| 回避策 | この問題は Framegrabber SDK 5.11.6 で修正されています。そのため、この問題を回避するには、Framegrabber SDK 5.11.6 以降を使用するか、Vivado 2023.2 でアプレットをビルドしてください。 |
| チケット ID | 341684 |
| 概要 | Gen 3x8 未満の PCIe で Basler CXP-12 Interface Card 2C/4C および imaWorx CXP-12 Quad フレームグラバーを使用すると、カメラの Acquisition Frame Rate が低下し、画像損失が発生する場合がある |
| 説明 | Basler CXP-12 Interface Card 2C/4C および imaWorx CXP-12 Quad フレームグラバーには、PCIe Gen 3x8（Direct Memory Access）以上に対応するホストインターフェイスが必要です。より低速なホストインターフェイスを使用すると、カメラの Acquisition Frame Rate が低下し、画像損失が発生する可能性があります。 |
| 影響を受ける OS | Linux および Windows |
| 回避策 | 回避策はありません。 |
| チケット ID | – |
| 概要 | フレームグラバーまたはインターフェイスカードで画像が失われた場合、失われた画像は次に配信されるバッファによって示される |
| 説明 | バッファオーバーフローが原因でフレームグラバーまたはインターフェイスカードで画像が失われた場合（ユーザーアプリケーションがバッファを十分に迅速に（再）キューイングして画像を配信できない場合など）、失われた画像は次に配信されるバッファによって示されます。失われた画像は次のようにマークされます： INCOMPLETE、ファイルサイズは 0、カスタムエラーコードは BUFFER_INFO_BASLER_XAPI_ERROR_CODE が次のように設定されている場合、自動的に無効になります： 42。さらに、失われたフレームがストリーム情報に 1 つ追加されます。オーバーフローにより何フレーム失われたかに関係なく、追加される失われたフレームは常に 1 つであることに注意してください。 |
| 影響を受ける OS | Linux および Windows |
| 回避策 | 回避策はありません。 |
| チケット ID | – |
| 概要 | インターフェイスカードでのアプレットの変更によりデバイスリストが正しくなくなる |
| 説明 | アプレットの変更中、インターフェイスカードに接続されているカメラはアクセスできなくなっているにもかかわらず、デバイスリストに表示され続けます。この状態でカメラを開こうとすると、エラーメッセージが表示されます。 |
| 影響を受ける OS | Linux および Windows |
| 回避策 | 回避策はありません。 |
| チケット ID | – |
| 概要 | コンピュータの起動後にカメラが検出されない場合がある |
| 説明 | まれに、コンピュータの起動後にカメラが検出されないことがあります。 |
| 影響を受ける OS | Linux および Windows |
| 回避策 | カメラを検出するには、カメラの電源を入れ直してください。 |
| チケット ID | – |
| 概要 | グラビングに使用するバッファの割り当ては、ヒープメモリを使用して行う必要があります |
| 説明 | グラビングに使用するバッファを割り当てる際、バッファアドレスは8バイト単位でアライメントされている必要があります。ヒープメモリを使用している場合は、これが自動的に行われます。 |
| 影響を受ける OS | Linux および Windows |
| 回避策 | ヒープメモリを使用します。 |
| チケット ID | – |
| 概要 | PCへのpylonとFramegrabber SDKの同時インストールにおける非互換性 |
| 説明 | pylonとFramegrabber SDKの両方がコンピューターにインストールされている場合、Baslerではpylonのインストール時にCXPオプションの選択を解除することを推奨しています。競合するCXPプロデューサーに起因する問題を回避するため、pylonまたはFramegrabber SDKのいずれかがBaslerフレームグラバーおよび/またはインターフェースカードの操作を担当するようにする必要があります。 |
| 影響を受ける OS | Linux および Windows |
| 回避策 | pylonとFramegrabber SDKの両方がコンピューターにインストールされている場合は、pylonのインストール時にCXPオプションの選択を解除してください。 |
| チケット ID | – |
| 概要 | 1秒あたりのフレーム数（fps）の制限は50000 fps〜90000 fpsの間です |
| 説明 | 1秒あたりのフレーム数（fps）の制限は、バッファの数と画像サイズに応じて50000 fps〜90000 fpsの間になります： - 10個のバッファと48x1の最小画像サイズの場合、制限は約50000 fpsになります
- 50個のバッファと48x1の最小画像サイズの場合、制限は約90000 fpsになります
- 50個のバッファと8192x1の画像サイズの場合、制限は約50000 fpsになります
|
| 影響を受ける OS | Linux および Windows |
| 回避策 | 回避策はありません。 |
| チケット ID | – |
| 概要 | MCFファイルの保存と読み込みにより、倍精度浮動小数点数が整数に丸められる |
| 説明 | MCFファイルから設定を読み込む際、カンマ区切りの倍精度浮動小数点数が最も近い整数に丸められることがあります。これは、Linuxオペレーティングシステムの現在のロケール設定が原因です。ロケールで区切り文字としてドットが定義されている場合、丸め処理は発生しません。 |
| 影響を受ける OS | Linux |
| 回避策 | 次のような適切なロケールを設定します： LC_NUMERIC="C" ./<applicationName>、microDisplay XまたはmicroDiagnosticsを開始する前に。 |
| チケット ID | 265213 |
| 概要 | カメラが正しい画像を出力しない |
| 説明 | 複数のリンクを持つカメラが、リンク間での画像データの分散に関してCXP規格に準拠していない場合、カメラは画像を正しく送信しません。この問題はJAI SP-12000C-CXP4カメラで確認されています。 |
| 影響を受ける OS | WindowsおよびLinux |
| 回避策 | 回避策はありません。 |
| チケット ID | 211645 |
| 概要 | Linuxドライバに信頼されたBasler証明書で署名できない |
| 説明 | Linuxでセキュアブート（UEFIモード）を使用する場合、信頼された証明書で署名されたドライバが必要です。ドライバはソースコードとして提供されるため、信頼されたBasler証明書で署名する方法はありません。 |
| 影響を受ける OS | Linux |
| 回避策 | ドライバを使用するには、セキュアブートを無効にすることができます。または、このUbuntuのブログ記事で説明されているようにドライバに署名することもできます。 |
| チケット ID | – |
Framegrabber API
| 概要 | 高フレームレートでの画像表示により入力遅延が発生する場合がある |
| 説明 | display_lib Framegrabber APIライブラリ（Windowsでのみ利用可能）を使用する場合、高フレームレート（1秒あたり約10,000フレーム）で画像を表示すると、ホストコンピュータで入力遅延（キーボードやマウスの遅延など）が発生する場合があります。 |
| 影響を受ける OS | Windows |
| 回避策 | 回避策はありません。 |
| チケット ID | – |
CLComDriver
| 概要 | システム内のCLSerポートよりも多くのドライバがインストールされている |
| 説明 | Install COM driver(s) for all Portsを使用しているときに、システム内のCLSerポートの数よりも多くのドライバーがインストールされることがあります。 |
| 影響を受ける OS | Windows |
| 回避策 | 追加のポートを選択し、Remove selected COM driverコマンドを使用してそれらを削除します。 |
| チケット ID | – |
| 概要 | Basler Runtime 5.9.0以前ではボードタイプが認識されない |
| 説明 | Basler Runtime 5.9.0以前では、ボードタイプが認識されず、ポートはCLSer識別子を使用してのみ表示されます。 |
| 影響を受ける OS | Windows |
| 回避策 | Basler Runtime/Framegrabber SDKのバージョンを5.10以降にアップデートしてください。 |
| チケット ID | – |
| 概要 | デバイスマネージャーのポート設定が実際の設定を反映していない |
| 説明 | デバイスマネージャーのポート設定が実際の設定を反映しておらず、変更が考慮されません。 |
| 影響を受ける OS | Windows |
| 回避策 | Windows COM Port APIを使用してポート設定を変更してください。 |
| チケット ID | – |
Linux ドライバー
| 概要 | marathon Frame Grabberでの取得画像が歪む |
| 説明 | marathon CXPおよびCLフレームグラバーで取得した画像が歪んで表示される場合があります。これは、LinuxドライバーがInput-Output Memory Management Unit (IOMMU)の使用をサポートしていないためです。 |
| 影響を受ける OS | Linux |
| 回避策 | 次の行をファイルに追加して、Input-Output Memory Management Unit (IOMMU)を無効にします。 etc/default/grub.txt: GRUB_CMDLINE_LINUX_DEFAULT="intel_iommu=off" |
| チケット ID | 336093 |
GenTL Producer
| 概要 | GenTL BUFFER_INFO_FRAME_ID CXPイメージヘッダーソースタグの代わりにすべてのフレームのCounterが含まれる |
| 説明 | GenTL BUFFER_INFO_FRAME_ID（これは、 DSGetBufferInfo経由でクエリを実行できます）には、CXPイメージヘッダーからのソースタグが含まれていません。その代わりに、コンピュータに配信されたすべてのフレームのCounterが含まれています。 |
| 影響を受ける OS | WindowsおよびLinux |
| 回避策 | 回避策はありません。 |
| チケット ID | – |
| 概要 | の変更後に再起動が必要 DeviceUserID カメラの |
| 説明 | カメラの DeviceUserID を変更した場合、変更を反映させるにはGenTL Producerの再起動が必要です。これは、GenTL API経由、およびGenTLを介してカメラと対話するGUI（pylon Viewerなど）を使用するという、GenTL Producerを使用する両方の方法に影響します。 |
| 影響を受ける OS | WindowsおよびLinux |
| 回避策 | 回避策はありません。 |
| チケット ID | – |
| 概要 | GenTLバージョン1.4以下のProducerに対するGenTLサポートの制限 |
| 説明 | GenTLバージョン1.4以下のProducerに対するGenTLサポートの制限。 |
| 影響を受ける OS | WindowsおよびLinux |
| 回避策 | 回避策はありません。 |
| チケット ID | – |
| 概要 | 画像サイズが2 GBに制限される |
| 説明 | GenTL Producerのバッファサイズの制限により、画像サイズは2 GBに制限されます。 |
| 影響を受ける OS | WindowsおよびLinux |
| 回避策 | 回避策はありません。 |
| チケット ID | – |
| 概要 | Acquisition Start後に変更されたカメラパラメータがフレームグラバーに反映されない |
| 説明 | 画像取り込み中にカメラパラメータを変更した場合、その変更はフレームグラバーに反映されません。これは、GenTL Producerが取り込みの開始前に該当するパラメータ（幅、高さ、画像フォーマットなど）を取得し、それらをフレームグラバーと同期させるためです。 |
| 影響を受ける OS | WindowsおよびLinux |
| 回避策 | 回避策はありません。 |
| チケット ID | 195482および225591 |
| 概要 | アプレットの変更時にGenTLデバイスIDが変更される |
| 説明 | GenTL標準によると、デバイスIDは2つのセッション間で一定に保たれる必要があります。しかし、アプレットを変更するとGenTLデバイスIDが変更されます。そのため、デバイスIDは、そのデバイスIDが生成されたアプレットと同じ名前のアプレットを使用している場合にのみ再利用できます。 |
| 影響を受ける OS | WindowsおよびLinux |
| 回避策 | 回避策はありません。 |
| チケット ID | – |
microDisplay X
| 概要 | 2つのCameraオペレーターを含むVisualAppletsデザインで、microDisplay Xでのカメラ検出が機能しないことがある |
| 説明 | 2つのCameraオペレーターが含まれ、そのうち少なくとも1つのオペレーターが2つのチャンネルを持ち、リソースインデックスが直接昇順で割り当てられているVisualAppletsデザインでは、microDisplay Xでのカメラ検出が機能しません。例えば、それぞれ2つのチャンネルを持つ2つのCameraオペレーターがあり、オペレーターAがポート0および1を使用し、オペレーターBがポート2および3を使用する場合などです。 |
| 影響を受ける OS | WindowsおよびLinux |
| 回避策 | リソースインデックスを直接昇順で割り当てないでください。例えば、オペレーターAのチャンネルをポート0および2に割り当て、オペレーターBのチャンネルをポート1および3に割り当てます。 |
| チケット ID | 314206 |
| 概要 | 複雑なデザインのHAPファイルを読み込むときにmicroDisplay Xがクラッシュする |
| 説明 | 非常に複雑なVisualAppletデザインの一部では、microDisplay Xでのアプレットの読み込み中または読み込み直後にクラッシュが発生する場合があります。SDKプログラムでは、このようなクラッシュは確認されていません。 |
| 影響を受ける OS | WindowsおよびLinux |
| 回避策 | microDisplay Xでアプレットを再度読み込みます。通常、microDisplay Xでのアプレットの読み込みは、2回目または3回目の試行で成功します。 |
| チケット ID | 314234 |
| 概要 | クリーンなLinuxインストール環境でmicroDisplay Xが起動しない |
| 説明 | クリーンなLinuxインストール環境で、microDisplay Xが起動しません。この問題の原因は、クリーンなLinuxインストール環境において、 xcb Qtプラットフォームプラグインが不足していることです。 |
| 影響を受ける OS | Linux |
| 回避策 | 不足しているプラグインを以下の方法でインストールします。 sudo apt install libxcb-xinerama0 コマンド。 |
| チケット ID | 259941 |
| 概要 | Linux環境で、終了時にmicroDisplay Xがクラッシュすることがある |
| 説明 | Linux環境で、終了時にmicroDisplay Xがクラッシュすることがあります。これによる影響はなく、無視して問題ありません。 |
| 影響を受ける OS | Linux |
| 回避策 | 回避策はありません。 |
| チケット ID | 211811 |
| 概要 | Cameraタブを開くとmicroDisplay Xがクラッシュする場合がある |
| 説明 | これは、mE6グラバーが1つだけインストールされており、1台のカメラが接続され、検出が完了した状態で、microDisplay Xでの最初のクリックがCameraタブに対して行われた場合に発生します。 |
| 影響を受ける OS | WindowsおよびLinux |
| 回避策 | カメラが検出される前にCameraタブを開いてください。 |
| チケット ID | 333828 |
python ラッパー
| 概要 | imaFlexプラットフォーム用のPythonラッパーのサンプルが用意されていない |
| 説明 | imaFlexプラットフォーム用のPythonラッパーのサンプルは、Framegrabber SDKに同梱されていません。 |
| 影響を受ける OS | WindowsおよびLinux |
| 回避策 | 他のプラットフォーム向けのサンプルを使用し、適宜調整してください。 |
| チケット ID | – |