Copy Deployment를 통한 Framegrabber SDK 설치#

복사 배포를 사용하면 Framegrabber SDK 설치 파일에서 단일 구성 요소를 선택한 디렉터리로 복사할 수 있습니다. 이를 통해 사용자 응용 프로그램과 함께 제공할 패키지를 제어하거나 줄일 수 있습니다.

복사를 통해 Framegrabber SDK를 배포하는 경우 Framegrabber SDK의 모든 기능과 툴을 사용할 수 없으므로 주의하십시오.

사전 요구 사항#

Framegrabber SDK를 설치하려면 관리자 권한이 있는 PC가 필요합니다. 이 지침에서는 이 PC를 소스 PC라고 합니다.
Basler 웹사이트에서 Basler Framegrabber SDK를 다운로드하여 소스 PC에 설치합니다.
소스 PC에서 Framegrabber SDK 기반 응용 프로그램을 실행하지 않으려면 설치 중에 모든 옵션을 선택 해제할 수 있습니다. 이렇게 하면 드라이버가 설치되는 것을 방지하고 환경 변수나 레지스트리가 수정되지 않습니다.
파일 복사 배포를 위한 파일만 준비하는 중이므로, Framegrabber SDK 설치 후 소스 PC를 재부팅하라는 메시지는 무시해도 됩니다.
The installation folder into which you have installed the Framegrabber SDK, is called <SDKRoot> in the following instructions.
Microsoft에서 Visual Studio 2015, 2017, 2019 또는 2022용 MSVC Redistributable Package를 다운로드하여 소스 PC에 설치합니다.
파일 복사 배포를 위한 파일만 준비하는 중이므로, Visual Code 설치 후 소스 PC를 재부팅하라는 메시지는 무시해도 됩니다.
소스 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의 핵심 부분을 복사하는 방법을 설명합니다.

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

다음 위치에서 다음 파일들을 복사합니다. C:\Windows\system32 (으)로 \bin:

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

프레임 래버 지원 추가#

mE5 Marathon#

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

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

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

imaFlex / imaWorx / Interface Cards#

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

애플리케이션용 앱릿 폴더 및 파일을 다음 위치에서 복사합니다. \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

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#

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

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
```

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

로깅#

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와 함께 사용하려면 다음 지침을 따르십시오.

Framegrabber Runtime 5.7을 다운로드하여 소스 PC에 설치합니다.
설치 프로그램을 실행할 때 다음 옵션을 선택하거나 선택 해제해야 합니다.
- 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의 선택을 해제합니다.
Copy the file SisoCognexAdapter.dll from the bin folder of the Runtime 5.7 installation to <packageRoot>\bin.

패키지 배포#

필수 요소 배포#

복사된 버전의 Framegrabber SDK를 타겟 PC에 배포하려면:

SDK 패키지를 타겟 PC로 복사합니다.
Framegrabber SDK의 드라이버를 설치합니다.
환경 변수를 설정합니다. BASLER_FG_SDK_DIR to the full path of the <packageRoot> folder.
SDK 패키지의 bin 폴더를 다음 항목에 추가합니다. PATH 환경 변수.

Cognex VisionPro Adapter 배포#

대상 PC에서 Cognex VisionPro Adapter를 사용하려면 Cognex VisionPro Adapter 설명서의 Installing the Adapter Manually 단원을 따르세요.