透過複製部署安裝 Framegrabber SDK

透過複製部署，您可以將 Framegrabber SDK 安裝中的單一元件複製到您選擇的目錄中。透過這種方式，您可以控制或縮減隨使用者應用程式一同交付的套件。

請注意，如果您透過複製方式部署 Framegrabber SDK，將無法使用 Framegrabber SDK 的所有功能與工具。

先決條件

1. 您需要一部具有管理員權限的電腦以便安裝 Framegrabber SDK。在下列說明中，這部電腦稱為 來源電腦。
2. 從 Basler 網站下載 Basler Framegrabber SDK 並將其安裝在來源電腦上。
3. 如果您不想在來源 PC 上執行基於 Framegrabber SDK 的應用程式，則可以在安装過程中取消選取所有選項。這樣可以避免安装驅動程式，並避免修改環境變數或登錄檔。
4. 由於您只是在準備用於複製部署的檔案，因此可以忽略安装 Framegrabber SDK 後重新啟動來源 PC 的要求。
5. The installation folder into which you have installed the Framegrabber SDK, is called <SDKRoot> in the following instructions.
6. 從 Microsoft 下載適用於 Visual Studio 2015、2017、2019 或 2022 的 MSVC Redistributable Package，並將其安裝在來源電腦上。
7. 由於您只是在準備用於複製部署的檔案，因此可以忽略安装 Visual Code 後重新啟動來源 PC 的要求。

8. 在來源 PC 上為複製部署建立以下資料夾階層：

   FramegrabberSDK
   ├───bin
   ├───dll
   ├───drivers
   └───lib
   

This folder structure is called SDK package in the following instructions. Its root folder FramegrabberSDK is called <packageRoot>.

建立套件

建立套件的核心元件

本節提供複製 Framegrabber SDK 核心元件的說明，亦即無論您使用哪種擷取卡都隨時需要的元件。

1. Copy the following files from <SDKRoot> into the corresponding folder inside <packageRoot>:

   <SDKRoot>
   └───bin
       ├───fglib5.dll
       ├───siso_hal.dll
       ├───siso_hw.dll
       ├───haprt.dll
       ├───iolibrt.dll
       └───logging-context.dll
   

2. 從以下位置複製下列檔案 C:\Windows\system32 設定為 \bin:

   Windows
   └───system32
       ├───vcruntime140.dll
       ├───vcruntime140_1.dll
       └───msvcp140.dll
   

新增對擷取卡的支援

mE5 marathon

1. Copy the following folders and files from <SDKRoot> to the corresponding folders in <packageRoot>:

   <SDKRoot>
   ├───bin
   |   └───GrabberFirmwareFlasher.exe
   ├───drivers
   |   └───me5
   │       ├───me5.cat
   │       ├───me5.inf
   │       ├───me5.sys
   │       └───WdfCoInstaller01009.dll
   └───lib
       └───siso_hw_me5.dll
   

2. Copy the applet folders and files for your application from <SDKRoot>\dll\<board-type> to the corresponding folders in <packageRoot>:

   <SDKRoot>
   └───dll
       ├───mE5-MA-ACL
       ├───mE5-MA-ACX-DP
       ├───mE5-MA-ACX-QP
       ├───mE5-MA-ACX-SP
       ├───mE5-MA-VCL
       ├───mE5-MA-VCLx
       └───mE5-MA-VCX-QP
   

3. Optionally: Copy your applets designed with VisualApplets to <packageRoot>\Hardware Applets<board-type>.

imaFlex / imaWorx / Interface Cards

1. Copy the following folders and files from <SDKRoot> to the corresponding folders in <packageRoot>:

   <SDKRoot>
   ├───bin
   |   └───GrabberFirmwareUpdater.exe
   ├───drivers
   |   └───me6
   │       ├───basler_ic.cat
   │       ├───basler_ic.inf
   │       ├───basler_ic.sys
   │       └───WdfCoInstaller01009.dll
   └───lib
       └───siso_hw_me6.dll
   

2. 從以下位置複製應用程式的 Applet 資料夾與檔案 \dll<board-type> to the corresponding folders in <packageRoot>:

   <SDKRoot>
   └───dll
       ├───CXP12-IC-1C
       │   ├───S1.1
       │   └───S1.2
       ├───CXP12-IC-2C
       │   └───S1.0
       ├───CXP12-IC-4C
       │   └───S1.0
       ├───iF-CXP12-P
       │   └───S1.1
       ├───iF-CXP12-Q
       │   └───S2.0
       └───iW-CXP12-Q
           └───S1.0
   

3. Optionally: Copy your applets designed with VisualApplets to <packageRoot>\Hardware Applets<board-type>

新增對相機通訊協定的支援

CoaXPress

If you use a CoaXPress frame grabber in your project, copy the following files from <SDKRoot> to the corresponding folders in <packageRoot>:

    <SDKRoot>
    └───bin
        ├───GCBase_MD_VC141_v3_1_Basler_pylon_v3.dll
        ├───GenApi_MD_VC141_v3_1_Basler_pylon_v3.dll
        ├───Log_MD_VC141_v3_1_Basler_pylon_v3.dll
        ├───MathParser_MD_VC141_v3_1_Basler_pylon_v3.dll
        ├───NodeMapData_MD_VC141_v3_1_Basler_pylon_v3.dll
        ├───siso_genicam.dll
        └───XmlParser_MD_VC141_v3_1_Basler_pylon_v3.dll

Camera Link

If you use a Camera Link frame grabber in your project, copy the following files from <SDKRoot> to the corresponding folders in <packageRoot>:

    <SDKRoot>
    └───bin
        ├───clsersis.dll
        └───clshell.exe

GenTL

1. To use the GenTL producer, copy the following files from <SDKRoot> to the corresponding folders in <packageRoot>:

   <SDKRoot>
   └───bin
       ├───GCBase_MD_VC141_v3_1_Basler_pylon_v3.dll
       ├───GenApi_MD_VC141_v3_1_Basler_pylon_v3.dll
       ├───Log_MD_VC141_v3_1_Basler_pylon_v3.dll
       ├───MathParser_MD_VC141_v3_1_Basler_pylon_v3.dll
       ├───NodeMapData_MD_VC141_v3_1_Basler_pylon_v3.dll
       └───XmlParser_MD_VC141_v3_1_Basler_pylon_v3.dll
   

2. To use the CXP GenTL producer, copy the following files from <SDKRoot> to the corresponding folders in <packageRoot>:

   <SDKRoot>
   └───bin
       ├───ProducerCXP.cti
       └───siso_genicam.dll
   

3. To use the Camera Link GenTL producer, copy the following files from <SDKRoot> to the corresponding folders in <packageRoot>:

   <SDKRoot>
   └───bin
       ├───BaslerCLProtocol.dll
       ├───CLAllSerial_MD_VC141_v3_1_Basler_pylon_v3.dll
       ├───CLProtocol_MD_VC141_v3_1_Basler_pylon_v3.dll
       ├───clsercom.dll
       ├───clsersis.dll
       ├───GenCP_MD_VC141_v3_1_Basler_pylon_v3.dll
       └───ProducerCL.cti
   

新增工具

gpioTool

If you want to use the gpioTool in your project, copy the following files from <SDKRoot> to the corresponding folders in <packageRoot>:

    <SDKRoot>
    └───bin
        ├───siso_auxport.dll
        └───gpioTool.exe

Logging

To get logging output from a running Framegrabber SDK application, e.g. in log files or by attaching the pylon Event Logger, copy the following files from <SDKRoot> to the corresponding folders in <packageRoot>:

<SDKRoot>
└───bin
    ├───common-logging-dispatcher.dll
    ├───common-logging-log4cpp.dll
    ├───BaslerFgSdkLogging.properties
    ├───GCBase_MD_VC141_v3_1_Basler_pylon_v3.dll
    ├───Log_MD_VC141_v3_1_Basler_pylon_v3.dll
    └───log4cpp_MD_VC141_v3_1_Basler_pylon_v3.dll

請注意，對於最後兩個函式庫，版本字尾（此處為：_v3）可能會根據要部署的 Framegrabber SDK 版本而有所不同或省略。

如需如何設定日誌記錄的詳細資訊，請參閱 Log Message System。

Cognex VisionPro

若要將 Basler 擷取卡與 Cognex VisionPro 搭配使用，請遵循以下說明：

1. 下載 Framegrabber Runtime 5.7 並將其安裝在來源電腦上。
2. 執行安裝程式時，請務必選取 / 取消選取以下選項：
   • 在 Select Components 對話方塊中，選取 Cognex Adapter。
   • 在 選取其他工作 對話方塊：
     • 取消勾選 Update Device Drivers 與 Update Environment Variables。
   • 確保未修改登錄檔：
     • 在 Select Start Menu Folder 對話方塊中，選取 Don't create a start menu folder。
     • 在 Select Additional Tasks 對話方塊中，取消勾選 Desktop icon、Activate Virtual COM Port 以及 Always Run COMWrapper Autorun at System Start。
3. Copy the file SisoCognexAdapter.dll from the bin folder of the Runtime 5.7 installation to <packageRoot>\bin.

部署套件

部署核心元件

若要將複製的 Framegrabber SDK 版本部署到目標 PC：

1. 將 SDK 套件複製到目標 PC。
2. 安裝 Framegrabber SDK 的驅動程式。
3. 設定環境變數 BASLER_FG_SDK_DIR to the full path of the <packageRoot> folder.
4. 將 SDK 套件的 bin 資料夾新增至 PATH 環境變數中。

部署 Cognex VisionPro Adapter

若要在目標 PC 上使用 Cognex VisionPro Adapter，請參閱 Cognex VisionPro Adapter 文件中的Installing the Adapter Manually一章。