Release history iOS - go to homepage
Release history iOS logo

Release history iOS

Trimble Precision SDK for Catalyst (Facade) iOS

Below is a list of all major TPSDK releases. Releases come typically in pairs - for iOS and Android - to keep build numbers synchronized.


v2024.2.28368.20; CatalystFacde 3.2.0.43

Platform update release

Major feature update

  • Geoid Support Without TMM: In previous versions, TMM served as the provider for geoid files. Now, it is possible to specify a path to a local geoid file provided directly through the application implementing TPSDK.
  • Improved IGroundCoordinateObservation: a new type is added that allows simpler differentiation between height based ground observations or INS based ground observations.
  • XFill support: the Trimble R580 was lacking this options before.

Worth knowing and breaking changes

  • Due to the introduction of local geoid support and the way the iOS facade is structured a handful of base functions have been updated in a none-optional way. This may result in build errors depending on how the facade was implemented. If you have used one of the StartSurveyXYZ base functions (so with parameters) you may need to add an empty path "" for the local geoid file.

    	- (TSSICFDriverReturnCode)startTrimbleCorrectionHubSurveyAndTransformTo:(TSSICFTargetReferenceFrame)targetReferenceFrame;

    vs

    	- (TSSICFDriverReturnCode)startTrimbleCorrectionHubSurveyAndTransformTo:(TSSICFTargetReferenceFrame)targetReferenceFrame andGeoidGridFilePath:(NSString*_Nonnull)geoidGridFileFullPath;

  • The RTXDataStream enum got extended by the stream for South America (RTXAL)


v2024.1.27400.78; CatalystFacde 3.1.0.80

Platform update release

Major feature update

  • Platform update release; mostly component updates & compile SDK updates etc; honing on .NET8 MAUI support
  • New instrument support
  • TGL 3.10.43; CSD 109
  • Rework of loadDeviceSubscription to provide issue date and expiry date for [device based subscriptions](\ref GuideDeviceBasedLicensing)

Bug fixes

  • Fixed issue with flipped precision values (horizontal and vertical flipped) under certain conditions in areas with negative latitude/ longitude (South America)

Worth knowing and breaking changes

  • While Android supports parsing the subscription file content this was not available on iOS. The changed signature of loadDeviceSubscription unifies the behavior of Android and iOS (although the actual implementation and hence return types differ). The insight into the subscription file is only provided for device based subscriptions; the default and preferred approach is using the [TMM Status Intent](\ref GuideTmmIntent).

-----------

v2023.1.26602.35; CatalystFacde 2.1.0.26

Major feature update

  • New receiver support
  • TGL 3.8.33; CSD 105
  • Introduction of packages for Microsoft MAUI and .NET6. For details on how to install them please check out the [related chapter](\ref Guides_NuGet).
  • Overall stability and performance improvements

Worth knowing and breaking changes

  • With the move to TGL 3.8.X and CSD 105 the default RTX reference datum is ITRF2020 (2015); before it was based on ITRF2014 (2010). While this should not affect positions much its potentially important for application which implement geodetic datums as strings within their UI layer.

  • The new [device based licensing](\ref GuideDeviceBasedLicensing) requires an additional, application specific contract and is only available for some receivers. Please reach out to the TPSDK team for further details.


v2022.0.27.25086; CatalystFacde 1.0.0.83

Maintenance release

Major feature update

  • Optimizes binary output (filesize of native so files reduced)
  • Added iOS simulator platform as target to the framework; xcframework now supports iPhone and Simulator. Note that the simulator is just a shell and does not implement any logic.

v2022.0.16.24707; CatalystFacde 1.0.0.73

Major feature update

  • Migration to new coordinate transformation component which provides improved local displacement models. Please check the worth knowing section on details.

  • Rework/ repackaging of Facade source code; CatalystFacade is now called CatalystFacadeX due do a unification of all supported platforms. For iOS the output is also changed to a XCFramework bundle.

  • Enhanced position output; the TSSICFPositionUpdate contains now also the error ellipse information as available on Android and Windows.

  • Enhanced TMM Status intent/ custom url schema to provide more granular details on subscriptions

Facade updates and changes

Worth knowing and breaking changes

  • Improvements have been made to the time-dependent coordinate transformation feature, which is used to transform Trimble RTX® positions between ITRF 2014 at the epoch of measurement and the global reference frame. These improvements ensure that users obtain optimal accuracy in coordinate transformations and the best possible coordinates in the selected coordinate system.

Note: Software packages mixing positions based on the old and new implementation will see a shift in positions. Those shifts are due to improved accuracy and depend heavily on the geographical location or more precisely active tectonic zones.

  • TMM has a backwards compatibility layer which allows to use the new transformation library with an old version of the SDK. So its perfectly fine to use TMM v3.0 or higher with TPSDK 2021 or lower. But TPSDK 2021 has only a subset of the transformations as available in TMM v3.0/ TPSDK 2022 - hence a user must select the previously selected frame.

Bug fixes


Known issues


v2021.0.78.24180

This release is a small maintenance release; its focus is on adding new hardware plus internal refactoring.

Major new features

  • %Trimble TDC650 support
  • %Trimble R750 support
  • New authentication method for none-subscription based receivers without the need of the TID login (guest login via TMM)

Minor feature update

Worth knowing


Known issues


Bug fixes

Breaking changes


v2021.0.57.22907

Major new features

  • %Trimble DA2 support, works as any Bluetooth receiver and uses RSeries driver (e.g. Trimble.Ssi.Driver.CarpoBased.Driver.RSeries.Android)
  • Enhancements within the facade layer
    • Exposure of OnDemand
    • Exposure of TMM custom NTRIP UI

Minor feature update

  • Missing meta data was added to the TSSICFPositionUpdate container (elements like stationID)

  • Option to set position output rate via (TSSICFDriverReturnCode)setOutputPositionRate

  • Added Check on demand to facade sample

  • Improved potential deadlocks in iOS Facade when TMM does return

Worth knowing


Known issues


Bug fixes

  • iOS Facade bugfix: fixed UseSBAS issue as SBAS wasn’t turned on if TMM was used before
  • iOS Facade bugfix: height wasn’t transformed
  • iOS bugfix: fix output rate > 1Hz crash for DA2

Breaking changes

  • The TMM bookmark custom URL schema has been updated to provide a return value
	-(BOOL)createTMMBookMarkWithUrl:(NSURL* _Nonnull) url;

v2020.3.11.21372

Major new features

  • First release of package
    • %Trimble Mobile Manager for iOS
    • TPSDK Facade for iOS

Minor feature update

Worth knowing

Known issues

Breaking changes