복사 배포를 통한 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 재배포 가능 패키지를 다운로드하여 소스 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>.

패키지 생성#

패키지 필수 구성 요소 생성#

이 섹션에서는 사용하는 frame grabber에 관계없이 항상 필요한 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 / 인터페이스 카드#

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

마지막 두 라이브러리의 경우 배포할 Framegrabber SDK 버전에 따라 버전 접미사(여기서는 _v3)가 다르거나 없을 수 있습니다.

로깅 구성 방법에 대한 자세한 내용은 로그 메시지 시스템을 참조하십시오.

Cognex VisionPro#

Basler 프레임 그래버를 Cognex VisionPro와 함께 사용하려면 다음 지침을 따르십시오.

Framegrabber Runtime 5.7을 다운로드하여 소스 PC에 설치합니다.
설치 프로그램을 실행할 때 다음 옵션을 선택하거나 선택 해제해야 합니다:
- 구성 요소 선택 대화 상자에서 Cognex Adapter를 선택합니다.
- 다음 파라미터 블록에서 Select Additional Tasks 대화 상자:
  - 장치 드라이버 업데이트 및 환경 변수 업데이트를 선택 해제합니다.
- 레지스트리가 수정되지 않았는지 확인하십시오:
  - 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.
다음을 추가합니다. bin SDK 패키지의 폴더를 다음 항목에 추가합니다. PATH 환경 변수에 추가합니다.

Cognex VisionPro Adapter 배포#

대상 PC에서 Cognex VisionPro Adapter를 사용하려면 Cognex VisionPro Adapter 문서의 Installing the Adapter Manually 장을 참조하십시오.