Photon Force PF32 User manual

PF32 QUICK START GUIDE
v1.4.9

Page 2 of 28
W A R R A N T Y A N D D I S C L A I M E R S
Use of this product and the associated software implies acceptance of the Photon Force terms of use.
Bare electronic components are susceptible to electrostatic discharge (ESD). Failure to employ good
practice in handling the hardware, or to observe and comply with the warnings and handling precautions
stated in this guide will void the product warranty.
This product may not be used in military, aerospace, medical or other safety critical applications without
the express written permission of Photon Force Ltd. Any such use is undertaken entirely at the customer’s
own risk.
Specifications are subject to change without notice.

Page 3 of 28
C O N T E N T S
Warranty and disclaimers ................................................................................................................... 2
Welcome ............................................................................................................................................. 4
Software Installation – Microsoft Windows ....................................................................................... 5
Java Runtime Environment Installation .......................................................................................... 6
PF32 Software Package Installation ................................................................................................ 9
PF32 Java Demo Application First Run .......................................................................................... 15
Connecting the camera for TCSPC mode .......................................................................................... 18
Java Demo Application Guide ........................................................................................................... 20
Overview ....................................................................................................................................... 20
Start Tab ........................................................................................................................................ 20
Image Display And Streaming Controls ......................................................................................... 22
Exposure Tab ................................................................................................................................. 23
Display Tab .................................................................................................................................... 24
TCSPC Tab ...................................................................................................................................... 24
Frame Data Tab ............................................................................................................................. 26
Advanced Tab – Bias Setup ........................................................................................................... 26

Page 4 of 28
W E L C O M E
Thank you for choosing to purchase a PF32 system from Photon Force. We look forward to
supporting your research and hearing about your discoveries. Please do stay in touch!
We’ve put together the following quick start guide to help you get up to speed with your new
camera. If you have not yet already downloaded the software and documentation for your PF32
camera, this available online at https://www.photon-force.com/setup/
Photon Force supports a number of ways to use your PF32 camera, all built around our camera
driver. A Java demo application is provided, which can be used to quickly test the camera, view a
video stream, capture histograms, and explore the camera settings. The Java application is
discussed later in this guide. A MATLAB® wrapper is provided for scientific use, allowing the
camera to be operated and data acquired from within the MATLAB® environment. Demo
functions are provided for acquiring both live video for display, and high speed streaming of data
for analysis. The MATLAB® wrapper is discussed in a dedicated guide, available from the setup
link above. Finally, you may use the Photon Force API to communicate with the PF32 camera from
your own software. Please consult the API guide provided via the setup page above.
Illustration of software components.
PF32 camera
Driver
DLL
Java demo application
Your software
Photon Force MATLAB® wrapper

Page 5 of 28
S O F T W A R E I N S T A L L A T I O N – M I C R O S O F T W I N D O W S
The PF32 application and USB driver are designed for 64-bit Windows 10, but are also compatible
with older versions of Windows. 32-bit Windows and Linux versions are available upon request.
Software installation is performed in two steps:
1. Obtain up-to-date Java Runtime Environment (JRE).
2. Install PF32 driver and demo application.

Page 6 of 28
J A V A R U N T I M E E N V I R O N M E N T I N S T A L L A T I O N
The PF32 Java application requires the Java Runtime Environment (JRE). If not installed already,
please download the JRE from the Oracle Java web site:
https://www.java.com/en/download/manual.jsp
To install the Oracle Java Runtime Environment, download and run the Windows Offline (64-bit)
installer.
The installation of the JRE requires the following steps:
1. Run the installer and provide the necessary administrator rights to allow the installation.

Page 7 of 28
2. Accept the license agreement.
3. Wait for the installer to finish.

Page 8 of 28
4. Close the installer and proceed to the installation of the PF32 software package.

Page 9 of 28
P F 3 2 S O F T W A R E P A C K A G E I N S T A L L A T I O N
Regular updates for the USB driver and Java demo application are offered to Photon Force
customers.
Run the PF32 installer. The latest version 1.4.9 for Windows is called:
PF32-1.4.9-win64.exe
1. The installation may require Administrator permission. Press "Yes" when the following
window appears and provide the Administrator password if required.
2. The installer might not start immediately and you may need to provide the appropriate
permissions along the way. If so, Windows will guide the process. The following window
may appear before the installer starts. Click the "More info" link to proceed.

Page 10 of 28
3. A new button "Run anyway" appears. Click this button to override the default Windows
security setting.
4. Once again, you might be asked for the permission to install the PF32 software package.
Press “Yes” to proceed.

Page 11 of 28
5. Start the installation.
6. Accept the license agreement.

Page 12 of 28
7. Choose the installation folder.
8. Choose the start menu folder in which Photon Force shortcuts will be created.

Page 13 of 28
9. Choose the components to install. The PF32 camera API is the software interface to the
camera. The Java application is a standalone demo application and GUI to run the camera.
The USB driver is required for operating system communication with the camera.
10. Wait for the installer to finish.
11. Provide permission to install the driver.

Page 14 of 28
12. Finish the installer.

Page 15 of 28
P F 3 2 J A V A D E M O A P P L I C A T I O N F I R S T R U N
USB3 and Power Connection
Included within the PF32 carry-case are the 5V power supply (PSU) and the USB3 cable. It is
crucial that no other PSU is used since an incorrect voltage, polarity, or current may irreversibly
damage the PF32.
Please connect the USB3 cable and PSU. Windows will then perform a driver installation the first
time the board is connected.
Start the PF32 Java Win_x64 application.
Windows may prevent the application from loading the first time you attempt to run it. This is
due to an inbuilt security feature preventing the execution of unverified programs. Permission
will have to be granted to run the PF32 Java Application as explained below. If the program does
not start at all, ensure that the Java Runtime Environment is installed first (see here).
1. The following window will appear on the first run of the PF32 Java Win_x64 demo
application. Click the "More info" link to proceed.

Page 16 of 28
2. A new button "Run anyway" appears. Click this button to override the default Windows
security setting.
3. Finally, one last prompt window appears, where permission to run the software must be
granted. This may require an Administrator password.
4. Note that if the Java Runtime Environment has not been installed, the following warning
will be displayed. Please install a Java Runtime Environment as described above before
continuing (see Java Runtime Environment Installation).

Page 17 of 28
5. Once the application starts, the following window appears.
6. Ensure the PF32 system is connected and powered on.
7. Click “Choose bitfile” and select the “PF32_USB3.bit” file provided, which contains the
camera firmware. Note that other controls in the application are unresponsive until the
camera firmware has been programmed, and the connection status will display “NO”. If
programming is successful, the connection status will change to “YES” and the FPGA type,
serial number and system operating mode will be displayed.
By default, the system is configured in a photon counting mode, which does not provide timing
information. Settings may be changed by selecting the desired mode of operation from the drop-
down menu and pressing configure, or by changing the appropriate settings in the control tabs.
At this point, in order to see an image within the software, you should attach a lens to the PF32.
The PF32 has a CS-mount on the front. Should you wish you to use a C-mount lens, an appropriate
spacer should be used. To use any other lens, adapters must be purchased separately.

Page 18 of 28
C O N N E C T I N G T H E C A M E R A F O R T C S P C M O D E
The instructions for USB3 and Power Connection should already have been followed.
In order to synchronise your camera with a pulsed light source, there are a number of options
available to the user. The most common of these is for the camera to be used in slave mode,
whereby the timing reference is provided by an external source as shown in the example below:
PF32 Camera in slave TCSPC mode where the timing synchronisation is provided by the same
clock as the light source.
In this case, the laser driver provides an electrical synchronisation reference pulse to the camera
at the same time as the laser sends a pulse of light (to the target/sample depending on the
application). The camera, as standard, accepts +3.3V (measured with 50 Ω load) pulses as
reference through the SMA connector labelled “SYNC”, but can be configured to accept other
signals (NIM, for example) upon request. Care should be taken to ensure that the limits for the
synchronisation signal are not exceeded to prevent damage to the electronics and sensor. Note,
in the above example, the laser driver can also be triggered by an external source. In this case,
the external source could trigger both the PF32 and the laser, provided the electrical pulse is
within the limits stated in the PF32 SYNC Input Configuration document (supplied separately
according to the SYNC options chosen by the customer).
If the laser control unit does not include a synchronisation output, a portion of the outgoing beam
can be split off (using an appropriate beam splitter) and directed on to a fast photodiode with
circuitry that can provide an appropriate output signal. Photon Force can advise on the choice of
trigger detector. Please contact us if you have any queries in this area.

Page 19 of 28
PF32 camera in slave TCSPC mode where the timing synchronisation signal is provided by an
optical detector (fast photodiode, for example) with an appropriate output.
With the SYNC signal connected to the camera, open the Java software. As before, program the
FPGA by clicking on “Choose bitfile”, then select “PF32_USB3.bit”. Check that the sync rate
displayed on the start tab matches the expected value. In the box “Select mode of operation” select
“TCSPC (laser master)” then click “Configure”. Navigate to the TCSPC tab.
The simplest test to observe time-correlated data is to direct the pulsed light source, safely and
diffusely, at a wall or scattering surface and image this surface with the camera. Within the TCSPC
tab, click on “Capture TCSPC”. The default measurement time is 5 seconds, after which, the
measurement will stop. Next, select which pixel’s histogram you wish to see by selecting a “Row”
and “Col” value and click “Update Histogram”. Below is an example of a TCSPC histogram.
PF32 Java application displaying a captured histogram.

Page 20 of 28
J A V A D E M O A P P L I C A T I O N G U I D E
O V E R V I E W
The PF32 Java demo application GUI is shown below. It consists of a tab-based control panel, an
image display area, and streaming controls. These features are discussed in turn. Note that none
of the features will be active until a PF32 camera has been connected, powered on, and configured
using the start tab as described below.
Overview of the main PF32 Java demo application GUI features.
S T A R T T A B
When the PF32 Java GUI is launched, it will initially display the Start tab, as shown below. The
start tab displays status information, and provides controls to load the camera’s firmware and set
the operating mode.
PF32 Java application Start tab, with no PF32 camera connected.
Note that none of the software features are active until a PF32 camera has been connected, and
the firmware loaded. With a PF32 camera connected and powered on, press the “Choose bitfile”
Image display area Tabbed control panel
Streaming controls