GenTL Interface 사용#

이 항목에서는 Basler Framegrabber SDK의 GenTL Producer 사용법을 설명합니다.

GenTL Producer는 GenICam GenTL 전송 계층 인터페이스를 구현하는 라이브러리입니다. GenTL 컨슈머는 pylon, HALCON 또는 사용자 지정 소프트웨어 등 해당 인터페이스를 통해 하나 이상의 Producer를 로드하는 모든 애플리케이션 또는 라이브러리를 의미합니다. 구현된 Producer는 GenICam GenTL Standard 1.5를 제공합니다.

GenTL Producer를 사용하여 다음 작업을 수행할 수 있습니다:

동일한 인터페이스(GenApi)를 통해 GenICam 호환 Camera Link 및 CoaXPress 카메라를 구성합니다.
이미지 취득 시스템의 계층 구조를 확인합니다.
사용 중인 카메라 표준을 고려하지 않고 일반적인 애플리케이션(GenTL consumer)을 개발합니다.

GenTL Producer 열기#

디렉토리 <Framegrabber SDK installation directory>/bin 에는 두 개의 GenTL Producer 파일이 포함되어 있습니다.

Producer	전송 기술
ProducerCL.cti	Camera Link
ProducerCXP.cti	CoaXPress

.cti 파일은 GenTL Producer를 식별합니다. 이 확장명은 Common Transport Interface의 약자입니다.

GenTL Producer를 직접 열지 마십시오. 대신 pylon 같은 GenTL consumer를 여십시오. Consumer는 다음과 같은 경우 GenTL Producer를 로드합니다. GENICAM_GENTL64_PATH 또는 GENICAM_GENTL32_PATH 환경 변수가 올바르게 설정되어 있습니다. 각 변수에는 하나 이상의 producer 디렉터리가 포함되어 있습니다. Framegrabber SDK가 추가합니다. <Framegrabber SDK installation directory>/bin (으)로 GENICAM_GENTL64_PATH 또는 GENICAM_GENTL32_PATH. 패키지를 설치하거나 제거한 후 다음 사항을 확인하십시오. GENICAM_GENTL64_PATH 또는 GENICAM_GENTL32_PATH 환경 변수에는 Basler producer 경로가 하나만 포함되어 있습니다. 설정 방법에 대한 자세한 내용은 GENICAM_GENTL64_PATH pylon과 Framegrabber SDK가 병렬로 설치된 경우는 다음을 참조하십시오. pylon 및 Framegrabber SDK 병행 설치.

GenTL 설정 파일#

GenTL Producer는 검색된 각 프레임 그래버에 대한 구성 파일을 다음 디렉터리에 저장합니다.

Windows: %AppData%\basler
Linux: ~/.config/basler

.config 파일에는 선택된 Applet, 검색 방법, 카메라 프로토콜 설정 등 해당 프레임 그래버의 Producer 설정이 저장됩니다. 파일을 삭제하면 Producer는 해당 프레임 그래버의 설정을 기본값으로 재설정합니다. 파일을 삭제하기 전에 컨슈머를 닫은 후 삭제가 완료되면 컨슈머를 다시 여십시오.

이 설정은 영구적이며 프레임 그래버에 속합니다. 하나의 애플리케이션 세션에서 지정한 설정은 다음 세션 및 다른 GenTL 컨슈머에서도 계속 활성 상태로 유지됩니다. 저장된 설정은 설정을 지정한 애플리케이션의 일시적인 선택 사항이 아니라 프레임 그래버의 활성 프로필로 취급해야 합니다. 변경된 설정이 적용되는 시점에 대한 자세한 내용은 Applying and Persisting Changes를 참조하십시오.

GenTL 모듈 계층 구조#

GenTL은 다음과 같은 모듈 계층 구조로 consumer에게 취득 시스템을 제공합니다.

모듈	Framegrabber SDK에서의 표현
`System`	Producer 자체입니다. 이 모듈은 계층 구조의 진입점입니다.
`Interface`	프레임 그래버 보드 1개입니다.
`Device`	카메라 1대 또는 취득 채널을 대신하는 유사 장치입니다.
`Data Stream`	장치의 취득 스트림 1개입니다.
`Buffer`	이미지 취득을 위해 할당된 Memory입니다.

Consumer는 이 계층 구조를 다르게 표시할 수 있습니다. 이 항목의 GenApi feature 이름은 모든 consumer에서 동일합니다. 다음 섹션의 대부분의 구성은 다음에 속합니다. Interface 모듈. 이는 카메라가 아닌 프레임 그래버에 속합니다.

Interface Applets#

이 Interface 모듈은 다음에서 사용 가능한 applet을 나열합니다. InterfaceApplets 범주. 다음에서 InterfaceApplets > InterfaceApplet, 현재 로드된 파일이 아닌 Applet 또는 .hap 파일을 선택할 수 있습니다.

Producer는 지속성 GenTL 구성 파일에 applet 변경 사항을 저장합니다. 이 변경 사항은 모든 장치를 닫고 장치 목록을 업데이트하거나, 다음 항목을 닫았다가 다시 연 후에만 적용됩니다. Interface. applet을 선택하고 장치를 업데이트한 후 몇 초 동안 기다리십시오. 그런 다음 확인하십시오. InterfaceAppletStatus Applet이 로드되었는지 확인합니다.

프레임 그래버 유형에 따라 사용 가능한 applet이 결정됩니다.

Frame Grabber	Applet을 사용할 수 있는 조건…
imaWorx, imaFlex	애플릿은 파일 시스템의 Framegrabber SDK 설치 경로 아래 DLL 또는 Hardware Applets 하위 디렉토리에 있습니다. 애플릿이 포함된 애플릿 설치 프로그램을 실행하거나 VisualApplets .hap 파일을 Hardware Applets 폴더(예: …\Basler\FramegrabberSDK5.x.x\Hardware Applets)로 복사하십시오.
marathon	애플릿이 프레임 그래버에 플래싱됩니다. 아직 플래싱되지 않은 경우 먼저 플래싱하십시오. 자세한 내용은 Flashing Applets onto marathon Frame Grabbers를 참조하십시오.

microDiagnostics에서 애플릿을 관리하는 방법에 대한 자세한 내용은 Managing Applets (microDiagnostics)를 참조하십시오.

User Sets를 통한 Applet 설정#

MCF 파일은 애플릿 구성을 저장합니다. MCF는 microEnable Configuration File의 약자입니다. 파일 확장자는 .mcf입니다. 자세한 내용은 MCF Files를 참조하십시오.

다음에서 UserSetControl 카테고리: Interface 모듈에서 현재 선택된 애플릿의 구성을 저장하고 로드할 수 있습니다. 해당 구성을 저장하거나 로드하려면 기존 경로 또는 새 경로를 입력하십시오. *.mcf 파일의 위치: UserSetFile parameter. 그런 다음 다음을 실행합니다. UserSetSave 또는 UserSetLoad경로가 비어 있거나 파일 확장자가 .mcf가 아니면 두 명령을 사용할 수 없습니다.

두 가지 서로 다른 구성 파일이 관련되어 있습니다. 범주와 수명이 다릅니다.

파일	Contains	Lifetime
*.mcf	단일 애플릿의 파라미터 값입니다.	Producer는 다음을 통해 필요에 따라 이러한 값을 로드합니다. `UserSetLoad`영구 저장되지 않음: Producer는 애플릿 변경 또는 시스템 종료 후에도 값을 유지하지 않습니다.
*.config	단일 프레임 그래버의 GenTL Producer 구성입니다.	영구 저장됨: Producer는 다음을 초기화할 때마다 이 파일을 자동으로 다시 로드합니다. `Interface`.

현재 로드된 애플릿이 다음 파일이 참조하는 애플릿과 일치하지 않는 경우 .mcf 파일 참조 시 Producer는 먼저 다음 설정을 시도합니다. InterfaceApplet 을(를) 구성 파일의 applet으로 설정합니다. 장치를 닫고 장치 목록을 업데이트합니다. 다음 항목을 닫지 마세요. System. 그러면 구성이 적용됩니다.

디바이스 검색 및 가상 디바이스#

이 DiscoveryMethod 기능(Interface.DiscoveryMethod in Interface > TransportLayerControl)은(는) 장치 목록이 업데이트될 때 프로듀서가 생성할 장치를 정의합니다.

검색 모드 개요#

`DiscoveryMethod`	Devices Exposed	다음의 기본값:
`EmulationDiscovery`	애플릿의 각 취득 채널마다 하나의 의사(pseudo) 장치입니다. 실제 카메라는 검색되지 않습니다.	Camera Link
`MixedDiscovery`	실제 카메라를 검색합니다. Camera Link에서는 검색에 GenCP 또는 CLP를 사용합니다. 검색된 카메라가 없는 취득 채널은 의사 장치로 채워집니다.	—
`CameraDiscovery`	실제 카메라만 검색되어 노출됩니다. 의사 장치는 생성되지 않습니다.	CoaXPress

의사 장치(에뮬레이션 장치)는 카메라를 감지할 수 없을 때 applet과 해당 획득 채널을 사용할 수 있게 해줍니다. 각 의사 장치에 대해 프로듀서는 기본 원격 장치 XML 파일을 생성합니다. Applet에 이미지 생성기가 포함된 경우 프로듀서는 기본적으로 이미지 생성기를 활성화합니다. 연결된 Camera Link 카메라에서 이미지를 수신하려면 원격 장치 노드에서 이미지 생성기를 비활성화하세요.

용도에 맞게 검색 모드를 선택하세요.

EmulationDiscovery: applet을 개발 또는 검사할 때, 카메라가 연결되어 있지 않을 때, 또는 카메라 제어 없이 applet 파라미터와 획득 채널 파라미터에 계속 액세스해야 할 때 이 모드를 사용합니다. 실제 카메라 검색이 비활성화되며 카메라 프로토콜 구성이 사용되지 않습니다.
MixedDiscovery: 실제 카메라를 찾아야 하고 빈 취득 채널을 의사 장치로 계속 액세스할 수 있어야 할 때 이 모드를 사용하십시오. Camera Link에서는 GenCP 또는 CLP를 통해 실제 카메라를 검색합니다. CXP 프레임 그래버를 포함하여 VisualApplets에서도 이 모드를 사용하십시오. .hap 파일에 적용됩니다. 자세한 내용은 다음을 참조하십시오. GenTL에서 VisualApplets Applet 사용.
CameraDiscovery: 애플리케이션에 실제 카메라만 나열해야 할 때 이 모드를 사용합니다.

Camera Link의 경우 실제 카메라 검색에도 카메라 프로토콜이 필요합니다. 자세한 내용은 Accessing Camera Link Cameras를 참조하십시오.

호환성 상태#

이 CompatibilityStatus 범주는 현재 frame grabber, applet, 카메라의 조합이 함께 작동하는지 여부를 나타냅니다.

인터페이스 모듈(프레임 그래버)#

기능	Reported Values
`InterfaceDriverVersion`	다음에 대한 드라이버의 버전 번호입니다. `Interface`.
`InterfaceProducerVersion`	GenTL Producer의 버전 번호입니다.
`InterfacePCIeStatus`	PCIe 속도가 요구 속도와 일치하거나 이를 초과하는 경우, 이 기능은 감지된 PCIe 속도를 표시합니다(예: `Gen3x8`). 그렇지 않은 경우, 이 기능은 다음과 같은 경고를 표시합니다 `Warning: Gen2x1 detected, but Gen3x8 possible`. 링크가 다운그레이드되면 사용 가능한 대역폭이 제한됩니다.
`InterfacePowerSupplyStatus`	이 기능은 frame grabber의 전원 커넥터가 연결된 경우 `Connected` 을(를) 표시합니다. 전원 커넥터가 연결되지 않은 경우 이 기능은 `Warning: PCI-Power connector missing` 을(를) 표시합니다.

pylon Viewer에서 호환성 상태 대상: Interface 모듈은 다음과 같습니다:

pylon Viewer Compatibility Status Interfaces

디바이스 모듈(카메라)#

기능	Reported Values
`DevicePixelformatStatus`	이 기능은 frame grabber의 전원 커넥터가 연결된 경우 `Supported` 카메라가 구성된 Pixel Format을 지원하는 경우입니다. 그렇지 않으면 기능이 다음을 표시합니다. `Warning: Not supported`.
`DeviceAutomaticROIControlStatus`	이 기능은 frame grabber의 전원 커넥터가 연결된 경우 `Activated` 기본적으로 또는 `Deactivated` Automatic ROI가 비활성화된 경우입니다. pylon Viewer에서 다음을 비활성화하세요. `Automatic ROI` 위치: `Device Transport Layer` > `Image Format Control`. 이 기능은 다음을 표시합니다. `Warning: ROI truncated according to stepping` 카메라의 단계 크기가 앱릿의 단계 크기와 다르고 ROI가 다음으로 낮은 일치 값으로 조정된 경우.
`DeviceTapGeometryStatus`	이 기능은 frame grabber의 전원 커넥터가 연결된 경우 `Supported` tap geometry 일치 항목을 찾은 경우입니다. 그렇지 않으면 기능이 다음을 표시합니다. `Warning: Driver does not support tap geometry setting` 또는 `Warning: Requested geometry not supported in applet`.

Tap geometry는 센서 데이터가 전송되는 방식을 설명합니다. 다음과 같이 1X_1Y(대부분의 카메라에서 기본값임) 전체 이미지는 하나의 데이터 스트림으로 전송됩니다. 크고 빠른 센서의 경우 1X_2YE이(가) 필요할 수 있습니다. 이 모드에서는 센서가 동시에 두 개의 서브프레임으로 읽혀집니다. 다음을 설정하세요. 1X_2YE 카메라에 필요하고 앱릿이 지원하는 경우에만 해당됩니다.

pylon Viewer에서 호환성 상태 대상: Device 모듈은 다음과 같습니다:

pylon Viewer Compatibility Status Devices

자동 ROI 및 포맷#

다음에서 ImageFormatControl 카테고리: Device 모듈에서 다음을 찾을 수 있습니다. AutomaticFormatControl, AutomaticROIControl, AutomaticTapGeometryControl및 OutputPacketFormats 노드. 동안 AutomaticFormatControl, AutomaticROIControl및 AutomaticTapGeometryControl (이)가 활성화되면, GenTL Producer는 카메라 설정과 일치하도록 앱릿의 형식, ROI 및 tap geometry를 구성합니다. 따라서 카메라와 앱릿을 한 번만 구성하면 됩니다. 이 동작은 microEnable 6 프레임 그래버의 앱릿에 적용됩니다.

applet이 자체 구성을 유지해야 하는 경우 이러한 기능을 비활성화하십시오. 이는 특히 VisualApplets로 설계된 applet에 적용됩니다. 자세한 내용은 Using VisualApplets Applets with GenTL을 참조하십시오.

Camera Link 카메라 액세스#

ProducerCL.cti는 Camera Link 카메라를 검색할 수 있으며, 카메라의 XML 설명 파일을 포함하여 해당 카메라에 대한 전체 GenApi 액세스를 제공할 수 있습니다. 대부분의 GenTL producer는 이러한 카메라에 대한 XML 액세스를 제공하지 않으므로, 이 액세스는 타사 Camera Link 카메라에 유용합니다. 다음 섹션에서는 지원되는 두 가지 카메라 프로토콜과 이를 구성하는 방법을 설명합니다.

Camera Link에 구성된 프로토콜이 필요한 이유#

Camera Link에서는 카메라 프로토콜을 구성합니다. 프로토콜은 자동으로 감지되지 않습니다. Camera Link는 이미지 전송과 직렬 연결을 표준화합니다. 해당 직렬 회선을 통해 카메라를 제어하는 방식은 표준화하지 않습니다. 각 공급업체는 자체 명령 프로토콜을 구현했습니다. 먼저 시도할 표준 프로토콜이 없기 때문에 자동 감지가 불가능합니다. 임의의 프로토콜 변수로 프로빙하는 데 너무 오랜 시간이 걸리며 일부 카메라 모델이 정의되지 않은 상태로 빠질 수 있습니다.

GenApi에는 레지던트 중심 액세스가 필요합니다. 이 주소를 읽고, 저 주소를 씁니다. 카메라의 XML 파일은 해당 액세스를 설명합니다. 두 가지 표준화된 경로가 직렬 회선을 이 레지스터 모델과 연결합니다.

Route	격차가 해소되는 방식	카메라 고유 부분이 상주하는 위치
GenCP	카메라 자체는 직렬 라인에서 표준화된 패킷 기반 레지스터 액세스 프로토콜을 구현합니다.	카메라 펌웨어. 호스트에 공급업체 소프트웨어가 필요하지 않습니다.
CLP (CLProtocol)	카메라 공급업체의 프로토콜 라이브러리가 GenApi 레지스터 액세스를 공급업체의 고유 직렬 프로토콜로 변환합니다.	호스트에 설치되는 CLProtocol 라이브러리(.dll 파일).

두 경로는 상호 교환할 수 없습니다. 공급업체 CLP 라이브러리가 있는 카메라는 GenCP를 이해하지 못합니다. GenCP 카메라는 CLP 라이브러리가 필요하지 않습니다.

정보

Basler Camera Link 카메라는 GenCP 호환이 아니지만 CLP를 지원합니다. Basler CLProtocol 라이브러리가 설치된 상태에서 ProducerCL은 카메라의 XML 파일 및 전체 카메라 구성에 대한 직접 액세스를 제공합니다.

GenCP(Generic Control Protocol)는 레지스터 기반 장치를 위한 GenICam 표준입니다. 카메라는 직렬 라인에서 표준화된 읽기 및 쓰기 명령에 응답합니다. 명령은 9600 baud의 Camera Link 웨이크업 속도로 시작됩니다. 카메라는 부트스트랩 레지스터 맵을 통해 ID를 노출하고, 해당 레지스터 공간의 매니페스트를 통해 GenICam XML 파일을 제공합니다. 카메라와 관련된 모든 항목은 펌웨어에 있으므로, GenCP 카메라는 호스트에 공급업체별 소프트웨어가 없어도 작동합니다.

CLP (CLProtocol)은 다른 모든 Camera Link 카메라를 위한 GenICam 표준입니다. 공급업체의 CLProtocol 라이브러리는 GenApi용 레지스터 인터페이스를 제공하고 해당 인터페이스를 카메라 자체의 직렬 프로토콜로 변환합니다. ASCII 기반 카메라의 경우, 라이브러리는 유사 레지스터 공간과 일치하는 XML 설명을 제공합니다. CLProtocol 라이브러리는 각 공급업체별로 설치되며 GENICAM_CLPROTOCOL 환경 변수를 통해 등록됩니다. 각 등록된 디렉터리 아래에 64비트 Windows 응용 프로그램을 위한 라이브러리가 있습니다. Win64_x64 하위 디렉터리. Basler 라이브러리의 경우 파일은 다음과 같습니다. \Win64_x64\BaslerClProtocol.dll.

Basler CLP용 자동 설정#

이 ConfigurationForBaslerCLP 기능은 Basler Camera Link 카메라에 대한 자동 구성을 제공합니다. 이 기능은 기본적으로 활성화되어 있습니다. 동안 Interface 초기화 시 producer는 다음을 확인할 수 있는지 검사합니다. BaslerClProtocol.dll 다음을 통해 찾을 수 있습니다. GENICAM_CLPROTOCOL. 프로듀서가 라이브러리를 찾으면 다음과 같이 변경됩니다.

설정 DiscoveryMethod (으)로 MixedDiscovery.
설정 ClpSharedLibraryPath 감지된 BaslerClProtocol.dll.

읽기 전용 Property인 BaslerCLPAutoConfigActive 은(는) 자동 설정이 적용되어 있음을 나타냅니다. 장치 목록을 업데이트한 후 다음에서 로드된 라이브러리를 확인하세요. LoadedClpSharedLibraryPath.

자동 설정이 활성화되어 있는 동안에는 다음을 제어합니다. DiscoveryMethod 및 ClpSharedLibraryPath. 두 Property 중 하나를 수동으로 설정하려면 먼저 다음을 설정하세요. ConfigurationForBaslerCLP (으)로 false.

수동 프로토콜 선택#

구성할 프로토콜(GenCP 또는 CLP)은 카메라에 따라 다릅니다. 다음을 설정하세요. ConfigurationForBaslerCLP (으)로 false 프로토콜을 구성하기 전에 설정해야 합니다.

GenCP의 경우(CLP 라이브러리가 구성되지 않았을 때 실제 카메라를 검색하는 데 사용되는 기본 프로토콜):

단계	기능	Value
1	`ConfigurationForBaslerCLP`	`false`
2	`ClpSharedLibraryPath`	Empty
3	`DiscoveryMethod`	`MixedDiscovery` 또는 `CameraDiscovery`

공급업체 라이브러리가 포함된 CLP의 경우:

단계	기능	Value
1	`ConfigurationForBaslerCLP`	`false`
2	`ClpSharedLibraryPath`	공급업체의 CLProtocol 라이브러리 전체 경로(.dll 또는 .so 파일), 일반적으로 다음 항목에 등록된 디렉터리: `GENICAM_CLPROTOCOL`
3	`DiscoveryMethod`	`MixedDiscovery` 또는 `CameraDiscovery`

장치 목록을 업데이트한 후 다음에서 결과를 확인하세요. LoadedClpSharedLibraryPath. ClpSharedLibraryPath 은(는) 요청된 경로만 저장합니다. LoadedClpSharedLibraryPath 은(는) 실제로 로드된 라이브러리를 보고합니다.

Camera Link Feature Reference#

모든 Feature는 다음 위치에 있습니다. Interface > TransportLayerControl:

기능	목적
`ConfigurationForBaslerCLP`	자동 Basler 설정을 활성화합니다. 이 Feature는 기본적으로 활성화되어 있습니다. 프로토콜을 수동으로 구성하기 전에 비활성화하세요.
`BaslerCLPAutoConfigActive`	읽기 전용. 자동 설정이 활성화되어 있으며 Basler CLProtocol 라이브러리를 찾았음을 나타냅니다.
`DiscoveryMethod`	실제 카메라, 의사 장치(pseudo device) 또는 둘 다를 선택합니다. 자세한 내용은 Device Discovery and Pseudo Devices를 참조하십시오.
`ClpSharedLibraryPath`	CLProtocol 라이브러리에 대해 요청된 전체 경로입니다. 경로가 비어 있으면 실제 카메라 검색을 위해 GenCP가 선택됩니다.
`LoadedClpSharedLibraryPath`	읽기 전용. 실제로로드된 CLProtocol 라이브러리입니다.

다음 표는 일반적인 구성을 보여줍니다.

권장 용도	`ConfigurationForBaslerCLP`	`DiscoveryMethod`	`ClpSharedLibraryPath`
Applet 또는 수집 채널 전용, 실제 카메라 없음	`false`	`EmulationDiscovery`	사용되지 않음
Basler Camera Link 카메라	`true`	자동 제어 (`MixedDiscovery`)	자동으로 제어됨(BaslerClProtocol.dll)
GenCP 호환 카메라	`false`	`MixedDiscovery` 또는 `CameraDiscovery`	Empty
공급업체 CLP 라이브러리가 있는 카메라	`false`	`MixedDiscovery` 또는 `CameraDiscovery`	공급업체 라이브러리의 전체 경로

직렬 연결이 설정되는 방식#

CLProtocol 라이브러리는 프레임 그래버와 직접 통신하지 않습니다. 라이브러리는 라이브러리를 로드하는 소프트웨어로부터 직렬 인터페이스(ISerial)를 수신합니다. 라이브러리가 ProducerCL 내에서 실행될 때, 프로듀서는 자체 내부 ISerial 구현을 제공합니다. 프레임 그래버에 대한 액세스는 프로듀서 내부에 유지되며 추가적인 직렬 컴포넌트는 관여하지 않습니다.

pylon과 같은 독립형 CLProtocol 클라이언트는 GenTL 내에서 실행되지 않습니다. 이러한 클라이언트는 다음을 통해 직렬 인터페이스를 획득합니다. CLAllSerial. CLAllSerial 레지스트리 값에 등록된 디렉터리에서 Camera Link Serial 라이브러리(clser*.dll)를 검색합니다. HKEY_LOCAL_MACHINE\SOFTWARE\CameraLink\CLSERIALPATH일반적으로 해당 디렉터리는 다음과 같습니다. C:\Program Files\CameraLink\Serial. 해당 디렉터리에서 clsersis.dll Basler 프레임 그래버용 Camera Link Serial을 구현합니다.

두 경로는 동일한 하드웨어로 연결됩니다. 프레임 그래버는 두 경로를 통해 동시에 초기화할 수 없습니다. 이 제약 사항은 주로 pylon이 설치되어 있을 때 중요합니다. 이 항목에서는 pylon 전송 계층으로 ProducerCL.cti를 사용하는 방법에 대해 설명하지 않습니다. 자세한 내용은 Installing pylon and the Framegrabber SDK in Parallel을 참조하십시오.

변경 사항 적용 및 유지#

변경 사항 DiscoveryMethod, Applet 선택, 그리고 GenCP 또는 CLP 설정은 장치 목록을 업데이트한 후에만 적용됩니다. 상황에 따라 변경 사항은 다음을 닫고 다시 연 후에만 적용됩니다. Interface 또는 컨슈머를 재시작하십시오. 적용하기 전에 전체 구성을 설정하십시오. 구성을 적용한 후 결과를 평가하십시오.

구성은 각 프레임 그래버마다 저장되며 프로듀서가 닫힌 후에도 세션 전반에 걸쳐 유지됩니다. 자세한 내용은 GenTL Configuration을 참조하십시오. 용도가 변경될 때 다음 사항을 기억하십시오.

영구 저장된 EmulationDiscovery 설정은 실제 카메라 검색을 방지합니다. 이는 의도된 것입니다.
영구 저장된 CameraDiscovery 선택한 프로토콜이 카메라를 식별할 수 없는 경우 설정은 가상 장치를 생성하지 않습니다.
영구 저장된 CLP 도로는 카메라가 교체된 후에도 해당 공급업체 라이브러리를 계속 선택합니다.
Basler 자동 구성이 활성화되면 MixedDiscovery 그리고 Basler CLP 경로는 Interface 이(가) 초기화될 때마다 복원됩니다.

Interface 일부 컨슈머에서의 노드 액세스

HALCON과 같은 일부 컨슈머에서는 Interface node map은 적어도 하나의 디바이스가 감지된 경우에만 사용할 수 있습니다. 만약 DiscoveryMethod 로 설정된 경우, CameraDiscovery 및 프로토콜이 카메라와 일치하지 않으면 프로듀서가 장치를 생성하지 않습니다. 이 경우 해당 컨슈머에서 검색 설정에 액세스할 수 없습니다. 프레임 그래버의 일련 번호와 연결된 구성 파일을 찾습니다. Windows의 경우 파일 위치는 다음과 같습니다. %AppData%\basler. Linux의 경우 파일 위치는 다음과 같습니다. ~/.config/basler. 해당 파일에서 검색(discovery) 설정을 변경하거나 파일을 삭제하여 구성을 초기화하세요. 애플릿 전용 설정을 하려면 다음을 사용하십시오. EmulationDiscovery 을(를) 사용하여 이러한 상황을 방지하십시오. 이 모드는 항상 가상 디바이스(pseudo device)를 생성합니다.

GenTL에서 VisualApplets Applet 사용#

설계 고려 사항#

애플릿 파일 이름: 애플릿의 파일 이름은 다음 용도로 직접 사용됩니다. Name 열거(enumeration)의 해당 항목에 대한 InterfaceApplets 속성으로 직접 사용됩니다. 따라서 파일 이름은 GenICam 네이밍 요구 사항을 준수해야 합니다. GenICam 표준 버전 2.1.1에서는 다음 요구 사항을 규정합니다.

Each node has a Name attribute. The Name must be unique within the camera description
file. Names can be composed of alphanumeric characters [A-Za-z0-9]. The schema also
allows the use of the underscore '_', but not as a leading character.

오퍼레이터 및 계층 이름: 애플릿의 파라미터 이름은 VisualApplets 디자인의 오퍼레이터 계층 구조에서 생성됩니다. 프로듀서는 GenICam 요구 사항을 준수하도록 이러한 이름을 변경합니다. 처음부터 GenApi 규칙에 따라 오퍼레이터 인스턴스 및 계층 구조 요소를 명명하면 결과 노드 이름을 더 쉽게 이해할 수 있습니다.

런타임 설정#

VisualApplets로 설계된 앱릿을 사용하는 경우 일반적인 카메라 검색만으로는 충분하지 않습니다. 또한 Producer는 카메라 파라미터를 앱릿에 자동으로 동기화하지 않습니다. 다음 설정을 수행하십시오.

설정 DiscoveryMethod (으)로 MixedDiscovery 디바이스를 열거하기 전에 수행하십시오. 이 설정은 모든 DmaToPc 모듈을 활성화합니다.
디바이스를 연 후 AutomaticFormatControl, AutomaticROIControl및 AutomaticTapGeometryControl 디바이스 XML의 false.

문제 해결#

관찰된 동작	해석 및 조치
`DiscoveryMethod` 또는 `ClpSharedLibraryPath` Camera Link `Interface`.	자동 Basler 구성이 활성화되어 있습니다. 다음을 설정하세요. `ConfigurationForBaslerCLP` (으)로 `false` 먼저.
Camera Link에 대해 의사 장치(pseudo device)만 나열됩니다. `Interface`.	`EmulationDiscovery` 이(가) 활성화되어 있거나, `MixedDiscovery` 실제 카메라를 찾지 못하여 채널이 의사 장치로 채워졌습니다. 프로토콜 구성을 확인하십시오.
Basler Camera Link 카메라가 검색되지 않습니다.	유지 `ConfigurationForBaslerCLP` 활성화됨. 다음을 확인하십시오. `GENICAM_CLPROTOCOL` 은(는) Basler CLProtocol 설치를 가리킵니다. 장치 목록을 업데이트하고 확인하십시오. BaslerClProtocol.dll in `LoadedClpSharedLibraryPath`.
CLP가 구성된 후 GenCP 호환 카메라가 검색되지 않습니다.	설정 `ConfigurationForBaslerCLP` (으)로 `false`, 지우기 `ClpSharedLibraryPath`를(을) 사용하려면 `MixedDiscovery` 또는 `CameraDiscovery`, 그리고 장치 목록을 업데이트하십시오.
제조사 CLP 라이브러리를 사용하는 카메라가 검색되지 않습니다.	설정 `ConfigurationForBaslerCLP` (으)로 `false`. 전체 라이브러리 경로를 입력하십시오. `ClpSharedLibraryPath`, 디바이스 목록을 업데이트하고 확인합니다. `LoadedClpSharedLibraryPath`.
의사 장치가 카메라 이미지 대신 Test Images을(를) 출력합니다.	애플릿의 이미지 생성기가 활성화되어 있습니다. 의사 장치의 원격 장치 노드에서 이미지 생성기를 비활성화하십시오.
`Interface` 또는 프레임 그래버 초기화에서 리소스가 사용 중이라고 보고합니다.	다른 프로세스가 이미 프레임 그래버를 점유하고 있습니다. 각 프레임 그래버는 한 번에 하나의 프로세스만 초기화할 수 있습니다. 대상:
Camera Link의 경우, 여기에는 clsersis.dll을(를) 사용하는 pylon 같은 독립형 CLProtocol 클라이언트가 포함됩니다. 자세한 내용은 Installing pylon and the Framegrabber SDK in Parallel을(를) 참조하십시오.
프로듀서는 초기화 시 다른 Framegrabber SDK 버전이 이미 활성화되어 있다고 보고합니다.	프로듀서가 다른 설치에서 fglib5.dll과(와) 같은 보호된 Framegrabber SDK 모듈을 로드했습니다. 자세한 내용은 Installing pylon and the Framegrabber SDK in Parallel을(를) 참조하십시오.
다음에 액세스할 수 없습니다. `Interface` 검색 변경 후 컨슈머의 설정.	장치가 생성되지 않았으며, 컨슈머는 `Interface` 적어도 하나의 장치가 존재할 때만 노드 맵을 표시합니다. 프레임 그래버의 .config 파일을 재설정하거나 편집하십시오. 자세한 내용은 다음을 참조하십시오. 변경 사항 적용 및 유지.