Vous êtes sur la page 1sur 19

TRIMBLE® PRECISION SDK™ RELEASE

NOTES

Trimble Precision
SDK

Sensor Software Interface

Controller Software Interface

Spatial Imagine Library

Version 3.7.15
Build 16899
Revision A
November 2018
Legal information
Trimble Navigation Limited
www.trimble.com
Copyright and Trademarks
© 2009–2018, Trimble Navigation Limited. All rights
reserved.
Trimble, the Globe and Triangle logo, Autolock,
CenterPoint, Geodimeter, GPS Pathfinder, GPS Total
Station, OmniSTAR, Spectra Precision, Terramodel,
Tracklight, TSC2, and xFill are trademarks of Trimble
Navigation Limited, registered in the United States
and in other countries.
FastStatic, FineLock, GX, RoadLink, Trimble RTX,
Trimble Total Control, TRIMMARK, VISION, VRS, VRS
Now, VX, and Zephyr are trademarks of Trimble
Navigation Limited.
Microsoft, ActiveSync, Excel, Internet Explorer,
Windows, Windows Mobile, Windows Vista and
Word are either registered trademarks or trademarks
of Microsoft Corporation in the United States and/or
other countries.
The Bluetooth word mark and logos are owned by the
Bluetooth SIG, Inc. and any use of such marks by
Trimble Navigation Limited is under license.
Wi-Fi is a registered trademark of the Wi-Fi Alliance.
All other trademarks are the property of their
respective owners.
This software is based in part on the work of the
Independent JPEG Group, derived from the RSA Data
Security, Inc, MD5 Message-Digest Algorithm.

Trimble Precision SDK | 1


Contents
Trimble Precision ........................................................................................................................................ 0
Version Overview ........................................................................................................................................ 3
Major New Features and improvements .................................................................................................... 5
SSI............................................................................................................................................................ 5
Drivers ................................................................................................................................................. 5
Features .............................................................................................................................................. 5
CSI ........................................................................................................................................................... 5
Features .............................................................................................................................................. 5
Supported devices ...................................................................................................................................... 6
Included Components ................................................................................................................................. 7
Core Interfaces........................................................................................................................................ 7
Drivers ..................................................................................................................................................... 7
Documentation ........................................................................................................................................... 8
Breaking Changes........................................................................................................................................ 9
Known Issues ............................................................................................................................................ 11
System Requirements ............................................................................................................................... 12
Package ..................................................................................................................................................... 13
Breaking changes details .......................................................................................................................... 14
Current: ................................................................................................................................................. 14
Older breaking changes: ....................................................................................................................... 15

Trimble Precision SDK | 2


Version Overview
These Release Notes contain information about the Trimble® Precision SDK™ version 3.7 and its
components.

The Trimble Precision SDK (TPSDK) is an application interface for developers to integrate Trimble
technology.
Its goal is to provide a set of lightweight components suitable for field applications. The developer can
choose the desired functionality based on his individual need.

TPSDK consists of a set of components helping the implementer to make full use of Trimble technology.
With version 3.7 the SDK contains:
 Sensor Software Interface (SSI)
 Controller Software Interface (CSI)
 Spatial Imaging Library (SIL)
 Advanced GNSS (AdvGNSS)
 Advanced TS (AdvTS)
Note that some components are subcomponents – AdvGNSS and AdvTS belong to SSI – but require a
separate license.

With TPSDK 3.7 there is a differentiation between basic and advanced components.
Basic components are SSI and CSI.
SIL, AdvGNSS and AdvTS belong to the group of advanced components.

Implementing application
Advanced

Adv
AdvGnss SIL
TS
Basic

SSI CSI

Trimble Precision SDK | 3


Basic components are free of charge and provide basic functionality to Trimble technology.

Advanced components aim to increase productivity as they provide functions; methods and interfaces
typically needed while implementing advanced technologies. They go on top of basic components and
are optional; nearly everything can be done with basic components.
Due to this advanced components come with a fee per subscription.
Development licenses contain free subscriptions for all (basic and advanced modules); product licenses
contain only basic licenses per default.
Advanced modules need to get ordered separately.

Trimble Precision SDK | 4


Major New Features and improvements
SSI

Drivers

Features and fixes


 Trimble R10-2 support
 Trimble SX10 Access Point support
 GNSS
o Geoid undulation output improved (removed filters)
o Improved RTCM3.2 handling via IP
o Improved modem handling for R Series receivers
 TS
o Trimble Illumination Ligh (TIL) support for SX10
o Set HA angle for S Series (reference circle)
o Fixed full round rectangle scan

CSI

Features
 Reworked Trimble SX10 communication code for simple SX10
o Search
o Connect

Trimble Precision SDK | 5


Supported devices
The following list provides an overview of all supported devices.
Note that this list contains the minimal hardware model/ revision of a device.
Optical GNSS Controllers

Trimble SX10™ Trimble R2™ Trimble TSC3


Trimble S3™ Trimble R4™ (Model 2 and later)1 Trimble TCU (Model 3)
Trimble S5™ Trimble R5™ Trimble Tablet 1
Trimble S6™ Trimble R6 (Model 2 and later) Trimble Tablet 2
Trimble S7™ Trimble R7 (Model 2 and later) Spectra Precision© Ranger™
Trimble S8™ Trimble R8 (Model 2 and later)
Trimble S9™ Trimble R8s™
Trimble Vision™/ VX™ Trimble R10/ R10 Lite
Trimble RTS™ Trimble GeoExplorer®
Trimble M3™ Spectra Precision© Epoch50
Trimble M1™ Spectra Precision© PM 700
Trimble C5™ Spectra Precision SP60/ SP80™
Trimble 5600™
Spectra Precision© Focus30™
Spectra Precision© Focus35™

1
The Trimble R4 requires the Advanced Data Controller Upgrade to work properly.

Trimble Precision SDK | 6


Included Components
The following list may give an overview but is not comprehensive.

Core Interfaces
Trimble.Ssi Contains the Sensor Software Interface; used for instrument communication.
Trimble.Csi Contains the Controller Software Interface; used for retrieving controller parameters.
Trimble.Sil Contains the Spatial Imaging Library, routines for spatial calculations

Drivers
Trimble SX Series (Trimble.Ssi.Driver.SXSeries.dll)
For connecting to Trimble SX Series instruments such as the Trimble SX10.
Trimble S Series (Trimble.Ssi.Driver.SSeries.dll)
For connecting to Trimble S Series instruments such as the Trimble S9.
Trimble M3 Driver (Trimble.Ssi.Driver.M3.dll)
For connecting to Trimble M3, M1 and C5 instruments.
Trimble 5600 Driver (Trimble.Ssi.Driver.5600.dll)
For connecting to Trimble 5600 instruments.
Trimble R Series (Trimble.Ssi.Driver.RSeries.dll)
For connecting to Trimble GNSS receivers such as Trimble R8 and Trimble R10
Spectra SP Series (Trimble.Ssi.Driver.SP80.dll)
For connecting to Spectra Precision GNSS receivers such as Spectra Precision SP60 and SP80.
Spectra SP Series (Trimble.Ssi.Driver. SpectraPrecisionGNSS.dll)
For connecting to Spectra Precision GNSS receivers such as PM700.
Spectra Precision FOCUS 30/ 35 (Trimble.Ssi.Driver.Focus30.dll)
For connecting to SP FOCUS 30 instruments.
Trimble SPS Series (Trimble.Ssi.Driver.SPS.dll)
For connecting to Trimble SPS total stations such as Trimble SPS730
Trimble SPS GNSS (Trimble.Ssi.Driver.SPSGNSS.dll)
For connecting to Trimble SPS GNSS receivers such as Trimble SPS585
Trimble Mock Driver (Trimble.Ssi.Driver.MockGnss.dll and Trimble.Ssi.Driver.MockTotalStation.dll)
For emulating either GNSS or total station connections without a physically connected instrument

Trimble Precision SDK | 7


Documentation
The documentation is available either on TCC or via a compiled help file (chm).
It contains:

Getting Started - A tutorial on how to


 Set up your project
 License your PC/ application
 Connect to an instrument using the Sensor Software Interface.

Guides - Advanced guides describing various topics of the Sensor Software Interface like
 GNSS antenna and antenna reduction
 Total station targets
 Total station measurement reduction
 Deployment
 Licensing
 Prism overview

Class Reference - Detailed information about all types contained in the Sensor Software Interface.

Trimble Precision SDK | 8


Breaking Changes
The following list provides an overview of the most critical breaking changes. A more comprehensive
list can be found at the end of this document.
Breaking changes are either renamed, relocated or removed items – so items that will break a
compilation based on the previous version.

Switched from beta to released interfaces:


 ISsiVision
 ISsiDataLogSurvey
 ISsiReceiverFiles
 ISsiWifiConfiguration

Component Version Interface

SSI V3.7  Removed CaptureParameterType.ImageFormat from


CameraFeatureImage.ListSupportedCaptureParameterTypes
(SX Series)

SSI V3.6  ISsiFirmwareUpdateBeta.Initialize()  changed to


ISsiFirmwareUpdateBeta.Initialize(string
firmwareFile)
 ISsiFirmwareUpdateBeta.FirmwareUpdate(string
firmwareFile)  changed to
ISsiFirmwareUpdateBeta.FirmwareUpdate()
 Trimble.Ssi.DriverCommon.Interfaces.Vision.Calibratio
n.CalibrationResultAutoFocusOffset  Namespace change
to
Trimble.Ssi.DriverCommon.Interfaces.TotalStation.Cali
bration.CalibrationResultAutoFocusOffset

SSI V3.5  Trimble.Ssi.Interfaces.Gnss.Rtk.ICorrectionDataSource


NTRIPSettings  moved ConnectionStatusChanged and
DataReceived events to new base
Trimble.Ssi.Interfaces.Gnss.Rtk.ICorrectionDataSource
TCPSettings
 Trimble.Ssi.Interfaces.Vision  complete rework, please check
details
 Trimble.Ssi.Interfaces.Scanner  complete rework, please check
details

SSI V3.1  Trimble.Ssi.Joystick  there was an issue with directions in face


2 – left/right in face 2 has been mixed up. This bug is now corrected but
might affect applications which worked around this issue.
SSI V3.0  Trimble.Ssi.Connection  Changed BluetoothSocketSettings; has

Trimble Precision SDK | 9


now both port and address
 Trimble.Ssi.Interfaces.Display  Reworked drawing,
removed line
 Trimble.Ssi.Interfaces.Joystick  Removed obsolete
JoystickTurnType
 Trimble.Ssi.Interfaces.Servo  Removed obsolete
AngleWithPositionServoFocus
 Trimble.Ssi.Interfaces.Gnss.Positioning; PostionRate
to PositionRate (typo in interface)
SSI v2.6  Trimble.Ssi.Interfaces.Gnss  RtkRadioSurveyDefaults;
Removed RtkRadioSurveyDefaults for serial port parameter (baudrate,
stopbits, databits).

Trimble Precision SDK | 10


Known Issues
The following items are known issues for TPSDK 3.5
 Bluetooth Scan 64bit

The following items are known issues for TPSDK 3.0


 Scanning 64bit
Due to an issue with a pointer to a double array on 64bit the scanning component in TPSDK-
ADV-TS (TS-ADV) is currently not working. The interface itself is ok but the scan will deliver bad
results (won’t scan the selected area).
Scanning is only supported on 32bit and Windows Mobile for TPSDK v3.0.
The problem will get addressed in the next version.

Trimble Precision SDK | 11


System Requirements
For developing applications using this version of the Trimble Precision SDK a Windows PC with Visual
Studio 2008 SP1 or higher and the Microsoft .NET Framework 3.5 is required.
If you are developing for Windows Mobile/ Windows CE you have to use Visual Studio 2008 due to the
mobile compiler support.
Otherwise any other Visual Studio edition can be used.

Trimble Precision SDK | 12


Package
The following items are included inside the TPSDK_3.7.zip
Filename Details

TPSDK.exe TPSDK Installer for developers (both 64 and 32bit)


TPSDKRedist.Win32.exe Redistributable Installer for Win32 that can be distributed to
customers; contains only 32bit drivers and components
TPSDKRedist.Win64.exe Redistributable Installer for Win64 that can be distributed to
customers; contains only 64bit drivers and components
TPSDKRedist.TCU_CE6.exe Redistributable Installer for TCU (Windows CE 6.0) that can be
distributed to customers
TPSDKRedist.TSC3_WM6.exe Redistributable Installer for TSC3 (Windows Mobile 6.0) that
can be distributed to customers
*.pdf/*.chm Help files
Trimble Product Activation Trimble Licensing component
Desktop Setup V1.16.1
SNP_COM_SERVER_R_4_4_22_ SNPCom for TCU (Windows CE 6.0)
TCU-R_CE6.CAB
SNP_COM_SERVER_R_4_4_22_ SNPCom for TSC3 (Windows Mobile 6.0)
TSC3_WM6X

Trimble Precision SDK | 13


Breaking changes details
Current:
New interfaces in TPSDK v3.7 compared to TPSDK v3.6
Type New Info

F = Function
E = Enum or enum entry

Changed interfaces in TPSDK v3.7 compared to TPSDK v3.6


Type Change Old New Namespace

I = Interface
P = Property
Par = Parameter
M = Moved

Removed interfaces in TPSDK v3.7 compared to TPSDK v3.6


Type Name Namespace Class or enum or info
P CaptureParameterTyp Trimble SX Series related enum
e.ImageFormat

Trimble Precision SDK | 14


Older breaking changes:
New interfaces in TPSDK v3.6 compared to TPSDK v3.5
Type New Info
F ISsiInterfaceProvider.ListLicensedInter
faceTypes()
ISsiInterfaceProvider.IsLicensed(Interf
F Check if interface is licensed
aceType interfaceType)
F IDriverManager.LoadFrom(string Load assembly from path
driverAssemblyPath)

F IDriverManager.IsSupported(Assembly Check if assembly is supported


assembly)

F IDriverManager.IsSupported(string Check if assembly is supported


driverAssemblyPath)

F IDriverManager.IsLicensed(Assembly Check if assembly is licsend


assembly)

F IPrism360DegreeTarget Functions for checking TargetLockMode and supported


lock modes

E RTKErrorStatus.NoRTXOffshore RTX offshore information

E SearchParameterType.TargetMode TargetMode for SearchParamater

F = Function
E = Enum or enum entry

Changed interfaces in TPSDK v3.6 compared to TPSDK v3.5


Type Change Old New Namespace
Par Name ISsiFirmwareUpdateB
ISsiFirmwareUpdateB eta.Initialize(stri
eta.Initialize() ng firmwareFile)

Par Name ISsiFirmwareUpdateB ISsiFirmwareUpdateB


eta.FirmwareUpdate( eta.FirmwareUpdate(
string )
firmwareFile)
M Name Trimble.Ssi.DriverC Trimble.Ssi.DriverC Trimble.Ssi.Interfaces.Vision
ommon.Interfaces.Vi ommon.Interfaces.To
sion.Calibration.Ca talStation.Calibrat
librationResultAuto ion.CalibrationResu
FocusOffset
ltAutoFocusOffset

I = Interface
P = Property
Par = Parameter
M = Moved

Removed interfaces in TPSDK v3.6 compared to TPSDK v3.5


Type Name Namespace Class or enum or info
Enum CameraInformation Trimble V10 related enum

Trimble Precision SDK | 15


Changed interfaces in TPSDK v3.5 compared to TPSDK v3.1
Type Change Old New Namespace
ISsiDataLogSurveyBe Trimble.Ssi.Interfaces.Gnss.DataLog
I Name ISsiDataLogSurvey
ta

ISsiReceiverFilesBe ISsiReceiverFiles Trimble.Ssi.Interfaces.Gnss.ReceiverFile


I Name
ta s

I Name ISsiVisionBeta ISsiVision Trimble.Ssi.Interfaces.Vision

I Name ISsiWifiConfigurati ISsiWifiConfigurati Trimble.Ssi.Interfaces.WifiConfiguration


onBeta on

P Type ICollection<> IEnumerable<> ListAllResolutionPresetsfrom in


Trimble.Ssi.Interfaces.Scanner.
IResolutionPresets

P Type ICollection<> IEnumerable<> ListAllScanResolutionTypes in


Trimble.Ssi.Interfaces.Scanner.IScanPara
meter

P Type ICollection<> IEnumerable<> ListAllFrameTypes in


Trimble.Ssi.Interfaces.Scanner.IScanPara
meter

P Type ICollection<> IEnumerable<> PointSet in


Trimble.Ssi.Interfaces.Scanner.ScanEvent
Args

P Type ICollection<> IEnumerable<> ListAvailableCameras in


Trimble.Ssi.Interfaces.Vision.ISsiVision

Par Type ICameraInformation CameraInformation HasCarmera in


Trimble.Ssi.Interfaces.Vision.ISsiVision
Par Type ICameraInformation CameraInformation GetCarmera in
Trimble.Ssi.Interfaces.Vision.ISsiVision
I = Interface
P = Property
Par = Parameter

Removed interfaces in TPSDK v3.5 compared to TPSDK v3.1


Type Name Namespace Class or enum
Enum Entry ExternalBluetooth Trimble.Ssi.Connection ConnectionType

Enum Entry TransferType Trimble.Ssi.Interfaces.Vision. CaptureParameterType


Image

Enum Entry VideoStream Trimble.Ssi.Interfaces.Vision. CaptureParameterType


Image

Enum Entry UniqueId Trimble.Ssi.Interfaces.Vision. CaptureType


Image

Enum Entry Horizontal Trimble.Ssi.Interfaces.Vision. FlipType


Image

Trimble Precision SDK | 16


Enum Entry Vertical Trimble.Ssi.Interfaces.Vision. FlipType
Image

Enum Entry ICameraImagePropert Trimble.Ssi.Interfaces.Vision. CameraPropertyType


yBrand Property

Enum Entry ICameraImagePropert Trimble.Ssi.Interfaces.Vision. CameraPropertyType


yModel Property

Enum ZoomType Trimble.Ssi.Interfaces.Vision.


Image

Event ConnectionStatusCha Trimble.Ssi.Interfaces.Gnss.Rt ICorrectionDataSourceNTRIPSetti


nged k ngs

Event DataReceived Trimble.Ssi.Interfaces.Gnss.Rt ICorrectionDataSourceNTRIPSetti


k ngs

Function ListSupportedCaptur Trimble.Ssi.Interfaces.Vision. ICamera


eParameterTypes, Camera
IsSupported,
CaptureImage,
BeginCaptureImage,
EndCaptureImage,
CreateCaptureParame
ter

Function CanFocusPixel, Trimble.Ssi.Interfaces.Vision. ICameraFeatureFocus


FocusToPixel, Camera
BeginFocusPixel,
EndFocusPixel

Object ICameraInformation Trimble.Ssi.Interfaces.Vision.


Camera

Object ICaptureParameterVi Trimble.Ssi.Interfaces.Vision.


deoStream CaptureParameter

Object ICaptureParameterTr Trimble.Ssi.Interfaces.Vision.


ansferType CaptureParameter

Object IDownloadParameterT Trimble.Ssi.Interfaces.Vision.


ransferType Download

Object IDownloadParameterG Trimble.Ssi.Interfaces.Vision.


uids Download

Object IDownloadParameter Trimble.Ssi.Interfaces.Vision.


Download

Object DownloadParameterTy Trimble.Ssi.Interfaces.Vision.


pe Download

Object IUniqueIdCapture Trimble.Ssi.Interfaces.Vision.


Image

P ServerAddress Trimble.Ssi.Interfaces.Gnss.Rt ICorrectionDataSourceNTRIPSetti


k ngs

P ServerPort Trimble.Ssi.Interfaces.Gnss.Rt ICorrectionDataSourceNTRIPSetti


k ngs

Trimble Precision SDK | 17


Trimble Precision SDK | 18