Trimble Precision SDK
Trimble Katastermodul Deutschland
Trimble Precision SDK, TPSDK
Nico Becke@Trimble.com
Geospatial Release Notes - Trimble Precision SDK TRIMBLE® PRECISION SDKTM 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 © 20092018, 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 SDKTM 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.
Basic Advanced
Implementing application
Adv TS
AdvGnss
SIL
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 SX10TM
Trimble R2TM
Trimble TSC3
Trimble S3TM
Trimble R4TM (Model 2 and later)1 Trimble TCU (Model 3)
Trimble S5TM
Trimble R5TM
Trimble Tablet 1
Trimble S6TM
Trimble R6 (Model 2 and later)
Trimble Tablet 2
Trimble S7TM
Trimble R7 (Model 2 and later)
Spectra Precision© RangerTM
Trimble S8TM
Trimble R8 (Model 2 and later)
Trimble S9TM
Trimble R8sTM
Trimble VisionTM/ VXTM
Trimble R10/ R10 Lite
Trimble RTSTM
Trimble GeoExplorer®
Trimble M3TM
Spectra Precision© Epoch50
Trimble M1TM
Spectra Precision© PM 700
Trimble C5TM
Spectra Precision SP60/ SP80TM
Trimble 5600TM
Spectra Precision© Focus30TM
Spectra Precision© Focus35TM
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
SSI
V3.7
SSI
V3.6
SSI
V3.5
SSI
V3.1
SSI
V3.0
Interface
Removed CaptureParameterType.ImageFormat from CameraFeatureImage.ListSupportedCaptureParameterTypes (SX Series)
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
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
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.
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 TPSDKADV-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 Desktop Setup V1.16.1
Trimble Licensing component
SNP_COM_SERVER_R_4_4_22_ TCU-R_CE6.CAB
SNPCom for TCU (Windows CE 6.0)
SNP_COM_SERVER_R_4_4_22_ TSC3_WM6X
SNPCom for TSC3 (Windows Mobile 6.0)
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
e.ImageFormat
Trimble SX Series related enum
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()
F
ISsiInterfaceProvider.IsLicensed(Interf Check if interface is licensed
aceType interfaceType)
F
IDriverManager.LoadFrom(string
driverAssemblyPath)
Load assembly from path
F
IDriverManager.IsSupported(Assembly
assembly)
Check if assembly is supported
F
IDriverManager.IsSupported(string
driverAssemblyPath)
Check if assembly is supported
F
IDriverManager.IsLicensed(Assembly
assembly)
Check if assembly is licsend
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 eta.Initialize()
Par Name
M
Name
ISsiFirmwareUpdateB eta.FirmwareUpdate( string firmwareFile) Trimble.Ssi.DriverC ommon.Interfaces.Vi sion.Calibration.Ca librationResultAuto FocusOffset
I = Interface P = Property Par = Parameter M = Moved
ISsiFirmwareUpdateB eta.Initialize(stri ng firmwareFile)
ISsiFirmwareUpdateB eta.FirmwareUpdate( )
Trimble.Ssi.DriverC ommon.Interfaces.To talStation.Calibrat ion.CalibrationResu ltAutoFocusOffset
Trimble.Ssi.Interfaces.Vision
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
I
Change
Name
Old
ISsiDataLogSurveyBe ta
New
ISsiDataLogSurvey
Namespace
Trimble.Ssi.Interfaces.Gnss.DataLog
I
Name
ISsiReceiverFilesBe ISsiReceiverFiles
Trimble.Ssi.Interfaces.Gnss.ReceiverFile
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
Par Type
ICameraInformation
I = Interface P = Property Par = Parameter
CameraInformation
HasCarmera in Trimble.Ssi.Interfaces.Vision.ISsiVision GetCarmera in Trimble.Ssi.Interfaces.Vision.ISsiVision
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
Enum Entry
VideoStream
Enum Entry
UniqueId
Enum Entry
Horizontal
Trimble.Ssi.Interfaces.Vision. CaptureParameterType Image
Trimble.Ssi.Interfaces.Vision. CaptureParameterType Image
Trimble.Ssi.Interfaces.Vision. CaptureType Image
Trimble.Ssi.Interfaces.Vision. FlipType Image
Trimble Precision SDK | 16
Enum Entry Enum Entry Enum Entry Enum Event Event Function
Function
Object Object Object Object Object Object Object Object P P
Vertical
Trimble.Ssi.Interfaces.Vision. FlipType Image
ICameraImagePropert yBrand
ICameraImagePropert yModel
ZoomType
ConnectionStatusCha nged
DataReceived
ListSupportedCaptur eParameterTypes, IsSupported, CaptureImage, BeginCaptureImage, EndCaptureImage, CreateCaptureParame ter
CanFocusPixel, FocusToPixel, BeginFocusPixel, EndFocusPixel
ICameraInformation
ICaptureParameterVi deoStream
ICaptureParameterTr ansferType
IDownloadParameterT ransferType
IDownloadParameterG uids
IDownloadParameter
DownloadParameterTy pe
IUniqueIdCapture
ServerAddress
ServerPort
Trimble.Ssi.Interfaces.Vision. CameraPropertyType Property
Trimble.Ssi.Interfaces.Vision. CameraPropertyType Property
Trimble.Ssi.Interfaces.Vision. Image
Trimble.Ssi.Interfaces.Gnss.Rt ICorrectionDataSourceNTRIPSetti
k
ngs
Trimble.Ssi.Interfaces.Gnss.Rt ICorrectionDataSourceNTRIPSetti
k
ngs
Trimble.Ssi.Interfaces.Vision. ICamera Camera
Trimble.Ssi.Interfaces.Vision. ICameraFeatureFocus Camera
Trimble.Ssi.Interfaces.Vision. Camera
Trimble.Ssi.Interfaces.Vision. CaptureParameter
Trimble.Ssi.Interfaces.Vision. CaptureParameter
Trimble.Ssi.Interfaces.Vision. Download
Trimble.Ssi.Interfaces.Vision. Download
Trimble.Ssi.Interfaces.Vision. Download
Trimble.Ssi.Interfaces.Vision. Download
Trimble.Ssi.Interfaces.Vision. Image
Trimble.Ssi.Interfaces.Gnss.Rt ICorrectionDataSourceNTRIPSetti
k
ngs
Trimble.Ssi.Interfaces.Gnss.Rt ICorrectionDataSourceNTRIPSetti
k
ngs
Trimble Precision SDK | 17
Trimble Precision SDK | 18
Microsoft Word 2016 Microsoft Word 2016