Instructions to Install and build PICAM areaDetector driver
Note that these directions have been written assuming that you are working on a Windows 7 64-bit machine. The PICAM driver is a 64-bit only driver.
Prerequisites
Download & install Microsoft Visual C++. Note Express version will work.
Instructions here will use Visual Studio Express 2013 for Windows Desktop.
http://www.visualstudio.com/en-us/products/visual-studio-express-vs.aspx
Note that a different version of Visual Studio will require some modification
of Windows Powershell script mentioned below.
Download & install GnuWin32.
-Use GetGnuWin32 from http://sourceforge.net/projects/getgnuwin32/files/
- Run 'download.bat'
- Run 'install.bat C:\GnuWin32' (Note C:\GnuWin32 is the install directory
this can be set to anything but will need to be changed elsewere in directions)
Replace the version of re2c installed with GnuWin32 with the lastest from:
http://sourceforge.net/projects/re2c/
This will go inside the GnuWin32/bin directory.
Rename GnuWin32/bin/link.exe to avoid conflicts with Visual C++ link command.
Install Perl Environment. Should be able to use either:
Can use either Active State or Strawberry Perl. The Windows Powershell script
mentioned below assumes Active State Perl 64-bit. Use of Strawberry Perl or
32-bit version of Active State Perl will require modification of the script.
Install Git for windows.
- http://git-scm.com/download/win
Download and prep EPICS, synApps, etc.
To run EPICS displays you will need a copy of MEDM. On Windows install Exceed () and Windows EPICS Tools. On Linux use pre-built medm. On linux, you will need to copy displays from
C:\PICAM\synApps_5_7\support\areaDetector-2-x-git\ADCore\ADApp\op\adl
and
C:\PICAM\synApps_5_7\support\areaDetector-2-x-git\ADPICAM\PICamApp\op\adl
into the EPICS_DISPLAY_PATH.
For viewing images, I would suggest installing ImageJ and the AreaDetector Plugin. Follow instructions from Mark Rivers found here. A copy of the plugin can be found in the installed distribution (below) at:
C:\PICAM\synApps_5_7\support\areaDetector-2-x-git\ADCore\Viewers\ImageJ
--------------------------------------------------
Download Windows Powershell script This script will create a directory C:\PICAM with a downloads subdirectory. Everything from here out should be installed in these directories.
The script will then download tar files for EPICS base, synApps, and a number of updates to synApps, as well as a couple of patches for base. It will then untar the tar files and install patches to base under
C:\PICAM\base-3.14.12.4
and
C:\PICAM\synApps_5_7
The script will also clone a copy of areaDetector, ADCore and ADBinary modules from the Github repository. It will then proceed to install a copy of the ADPICam driver from my Github repository.
The script will make modifications to the appropriate configure files in base, synApps and areaDetector so that these can be build using the tools described above. Again, note that if you install a different version of the tools mentioned above, you may need to modify the powershell script accordingly.
To execute the Powershell script, execute the following line in a Powershell window. You can launch a powershell window from StartMenu->Accessories->Windows Power Shell->Windows PowerShell.
powershell -ExecutionPolicy bypass -File "<path-to-file>\DownloadNPreparePICAM.ps1"
When this script completes you will have a setup that is ready to compile.
From a Windows Command Prompt:
C:\PICAM\base-3.14.12.4\startup\win32.bat
set BUILD_IOCS=YES
cd C:\PICAM\base-3.14.12.4
make
cd ..\synApps_5_7\support
make release
make
At this point you should have a built version of the PICAM drivers.
Running PICAM driver
An IOC for this driver should be found installed at:
C:\PICAM\synApps_5_7\support\areaDetector_2_git\ADPICam\iocs\PICamIOC\iocBoot\iocPICam
To run the IOC launch start-epics-debug.bat
If MEDM is installed on the windows box, the displays can be launched by running the script start-epics-displays.bat
Prebuilt version for testing
The scripts described above seem to be having some problems. I have put together a prebuilt version in a zip file. This zip file can be installed with the files located at c:/jhSrc and everything should work. The launch files for the IOC and MEDM are located in C:\jhSrc\synApps_5_7\support\areaDetector_2_git\ADPICam\iocs\PICamIOC\iocBoot\iocPICam.
The class files for the PICAM driver are located in C:\jhSrc\synApps_5_7\support\areaDetector_2_git\ADPICam\PICamApp\src