Transcript
APPLICATION NOTE AN032 Topic: PFRemote/SDK and Win 64 bit OS. Summary: This application note shows how to use PFRemote/SDK on Win 64 bit operating system.
Photonfocus AG
AN032 PFRemote/SDK and Win64bit, 04/2011 V1.0
CONTENT 1
INTRODUCTION............................................................................. 2
2
SOFTWARE STRUCTURE FOR CAMERALINK® CAMERAS .................. 2
3
2.1
clallserial.dll ....................................................................................... 2
2.2
clserYYY.dll examples ......................................................................... 3
ISSUES WITH WIN64 SETUPS ....................................................... 3 3.1
Folder on Win 64Bit OS ....................................................................... 3
3.2
PFRemote shows no frame grabber Ports ........................................... 4
4
CONTACT ....................................................................................... 4
5
REVISION HISTORY ...................................................................... 4
Photonfocus AG
I
AN032 PFRemote/SDK and Win64bit, 04/2011 V1.0
1 Introduction Photonfocus supports two different software installers (PFInstaller) which could be load down from the Photonfocus homepage: •
PFInstaller_Win32bit:
Files are generated with a 32bit compiler. Compatible with WinXP, Vista and Win7.
•
PFInstaller_Win64bit:
Files are generated with a 64bit compiler. Use only this installer on a Win 64bit OS version Compatible with WinXP_64bit, Vista_64bit and Win7_64bit.
On a Win 64 bit operating system 32 bit and 64 bit software could be installed. But 32 bit dll's and 64 bit dll's are not compatible. If a 64 bit program loads a 32 bit dll, the Windows Loader generates an error.
2 Software structure for CameraLink® cameras The following figure shows the software structure, when using a CameraLink camera on a Windows operation system.
PFRemote / user application Photonfocus SDK pfLib (SDK)
clallserial.dll
CameraLink standard
clserYYY.dll Part of frame grabber SDK Frame grabber Communication over RS-232 (CameraLink cable) Photonfocus camera
2.1 clallserial.dll The software interface between Photonfocus and the frame grabber manufacturer is the clallserial.dll. This dll is part of the CameraLink standard. The source code is open. The main tasks of the cllallserial.dll are: •
The clallserial.dll handles all clserYYY.dll’s. It forwards the incoming commands to the correct clserYYY.dll.
Photonfocus AG
2
AN032 PFRemote/SDK and Win64bit, 04/2011 V1.0
•
When the init function is called the clallserial.dll search for all clserYYY.dll in the specified folder and call the init function on all clserYYY.dll’s. Every frame grabber manufacturer has his own clserYYY.dll.
2.2 clserYYY.dll examples All frame grabber manufacturer have their own clserYYY.dll (YYY means three characters). The clserYYY.dll is the software interface to the RS232 signals on the CameraLink cable. Here some examples are listed: •
clserbit.dll
Bitflow
•
clsercor.dll
Dalsa (Coreco)
•
clseremc.dll
Euresys
•
clsermtx.dll
Matrox
•
clserme3.dll
Silicon Software Me3
•
clserme4.dll
Silicon Software Me4
3 Issues with Win64 setups PFRemote for Win64 is a 64 bit application. When PFRemote starts the pfLib initializes the clallserial.dll. This library search for all clserYYY.dll and initialize them. Clallserial.dll and all clserYYY.dll must be 64 bit too. It is not possible that a 64 bit application (or library) can access a 32 bit dll. The library calls of a 64 bit dll are incompatible with calls of a 32 bit dll. If the 64 bit clallserial.dll loads a 32 bit clserYYY.dll, the Windows Loader generates an error. Some frame grabber manufacturer copy both version of their clserYYY.dll (32 bit and 64 bit) during the installation process to the windows system.
3.1 Folder on Win 64Bit OS There are two folders were the dll’s are stored:
Windows\system32
All 64 bit dll's should be here (The name system32 is chosen from Microsoft to be compatible with older software!).
Windows\sysWOW64
All 32 bit dll's should be here (WOW64 = WinOnWin64).
The main issue for installation errors is that both folders are in the PATH environment variable. If the frame grabber installer copy both clserYYY.dll into the correct folder, clallserial.dll will found both of them but could only load the 64 bit one. The 32 bit dll will generate an exception from the Windows Loader.
Photonfocus AG
3
AN032 PFRemote/SDK and Win64bit, 04/2011 V1.0
3.2 PFRemote shows no frame grabber Ports 1) Search for all clserYYY.dll on your system and rename them to clserYYY_.dll (clallserial dll will not found them, because they have one more character). 2) Copy the 64bit version of clserYYY_.dll into the windows\system32 folder and rename the file back to clserYYY.dll. 3) Start PFRemote again.
4 Contact Photonfocus AG Bahnhofplatz 10 CH-8853 Lachen Switzerland www.photonfocus.com Support
Sales Phone: +41 55 451 00 00 Fax: +41 55 451 00 01
[email protected]
[email protected]
5 Revision History Rev
Description of the modifiacation
Date
1.0
First Release
28.04.2011
Table 1: Document revisions
Photonfocus AG
4
