PST SDK  5.0.1.0-acae3ae
Install and Redistribute
Note
By choosing to install the PST SDK, the PST Interface Service will not be installed as a Windows service. This mean that it will not be possible to start the PST-Client application without first starting the PST-Server application manually from the Windows Start menu. This is done because running an application using the PST SDK while the PST Interface Service is running at the same time can cause conflicts.

The PST SDK is installed by selecting the SDK component from the PST installer. This will create a Development directory inside the installation directory. The Development directory is structured as follows:

  • Debug_no_redist: Debug versions of the files in the Redist directory. Please do not redistribute those files.
  • Docs: This documentation.
  • Drivers: The drivers required to connect to the different types of PST Trackers.
    • PST: The driver used for the standard PST Iris and PST Base trackers.
    • PST-HD: The driver used for the PST Iris HD, PST Base HD and PST Pico trackers.
  • Examlpes: Several examples explaining how to use the PST SDK.
  • Include: The header files needed to work with the C++ API.
  • Lib: The lib file needed to link to the C++ API.
  • Redist: The dll files and miscellaneous files required to run an application that is using the C++ API.

In order to start working with the PST SDK, create a Visual Studio 2015 or Visual Studio 2017 project and add the include directory to the include path. Add the pstsdk.lib file to the linker dependencies and Visual studio should be able to find the C++ API and use it. In order to run an application that is linked to the PST SDK, copy the required files from the Development\Redist directory to the location of the application.

Redistribution

Installer

Redistribution of the PST SDK can be done in two ways. The first one is by redistributing the complete PST installer application. This way, an end user will get all the required components automatically, but it is likely that the package contains components that are unnecessary to make the end-user application work.

Files

The second way of redistribution is to package a copy of the required files together with the installer of the end-user application. This way only the files that are necessary for the specific use case of the end-user application will be redistributed, lowering the overhead. Depending on which PST Tracker is used, a different set of files will need to be redistributed. The table below shows which files need to be redistributed in which use case.

  • The mandatory files should always be redistributed in order to make the PST SDK work.
  • The PST files are only necessary when making use of a standard PST Iris or PST Base tracker.
  • The PST HD files are only necessary when making use of a PST Iris HD, a PST Base HD or a PST Pico tracker.
  • The PST-Client files are only necessary if the end-user application should be used in combination with the PST-Client application. This would for example be the case if the PST-Client is used for tracker initialization and tracking target training.
  • The PST REST Server executable is only necessary if the end-user application should be used in combination with the stand-alone PST REST Server.
File Mandatory PST PST HD PST-Client PST REST Server
libcurl.dll X
pst-client.exe X
pst-rest.exe X
V3D.dll X
Development\Redist\baslercameraplugin.dll X
Development\Redist\basler_ace.xml X
Development\Redist\basler_dart.xml X
Development\Redist\CameraLibrary2015D.dll X
Development\Redist\cpprest140_2_10.dll X
Development\Redist\Freeimage.dll X
Development\Redist\GCBase_MD_VC120_v3_0_Basler_pylon_v5_0.dll X
Development\Redist\GenApi_MD_VC120_v3_0_Basler_pylon_v5_0.dll X
Development\Redist\iris120cameraplugin.dll X
Development\Redist\iris_120.xml X
Development\Redist\libeay32.dll X
Development\Redist\libiconv-2.dll X
Development\Redist\libxml2.dll X
Development\Redist\Log_MD_VC120_v3_0_Basler_pylon_v5_0.dll X
Development\Redist\MathParser_MD_VC120_v3_0_Basler_pylon_v5_0.dll X
Development\Redist\nlopt-0.dll X
Development\Redist\NodeMapData_MD_VC120_v3_0_Basler_pylon_v5_0.dll X
Development\Redist\PocoFoundation.dll X
Development\Redist\pstsdk.dll X
Development\Redist\pthreadVCE2.dll X
Development\Redist\PylonBase_MD_VC120_v5_0.dll X
Development\Redist\PylonUsb_MD_VC120_V5_0_TL.dll X
Development\Redist\PylonUtility_MD_VC120_v5_0.dll X
Development\Redist\ssleay32.dll X
Development\Redist\uxapi_MD_VC120_v5_0.dll X
Development\Redist\XmlParser_MD_VC120_v3_0_Basler_pylon_v5_0.dll X

Drivers

Depending on which PST Tracker will be used in the end-user application, a different driver will need to be installed on the end-user machine.

For the standard PST Iris or PST Base, the files located in the Development\Drivers\PST directory should be used. Depending on the target operating system, the following commands can be used to install the driver:

  • For a 64bit OS: dpinst64.exe /c /f /sw /PATH npusbio_x64
  • For a 32bit OS: dpinst32.exe /c /f /sw /PATH npusbio

For the PST Iris HD, the PST Base HD and the PST Pico, the pylon_USB_Camera_Driver.msi file located in the Development\Drivers\PST-HD directory should be used. Executing this installer package will automatically install the required driver for the PST HD and Pico Trackers.