Trimble Precision SDK for Catalyst (Facade) iOS

Below is a list of all major TPSDK releases. Releases come typically in pairs - for Swift and .NET8 - to keep build numbers synchronized. Features are also valid for both flavors - Swift and .NET8 - as they are based on the same core. So only the external interface changes between the mentioned flavors (more or less).

With TPSDK 2026, the version numbering scheme has changed; both TPSDK and the Facade wrapper use 2026.X.Y but may have different build/revision numbers.

v2026.3.12 targeting; CatalystFacde 2026.3.18

Platform update release

Major feature update

• Improved survey state handling
• Improved data logging
• Enhanced TSSICFCatalystFacade with regards to
  • Fix frame id for NTRIP
  • Added missing getReducedAntennaHeight
  • Added updateDeviceSubscription to force refresh a subscription; required for workflow related for device licenses.

Worth knowing and breaking changes

• CSD 114

\n

v2025.1.28482.64 targeting; CatalystFacde 4.1.0.58

Platform update release

Major feature update

• Time‑dependent datum transformations without TMM: Previously TMM provided all files required for time‑dependent transformations. It is now possible to copy the (so‑called) GeoData folder directly into the application’s private storage and run transformations without TMM. See the related facade chapter and the TPSDK SSI chapter for details.
• Added inertial navigation (INS) derived fields (IMU state, pitch, roll, yaw, etc.) to the default position output.
  • If no IMU is available, these fields are reported as NaN (or the platform‑specific equivalent).
• Improved geoid file side‑loading without TMM.

Worth knowing and breaking changes

• Native binaries built with 16 KB page size as required by Google Play.
• The ImuStateChanged event got removed due to the addition to the default position output.
• CSD 111

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.0.27600.96; CatalystFacde 3.1.0.91

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

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.

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.
• 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 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.
• 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.

[!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.

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