Developer Documentation

Android Intents

Using Intents to control TMM

TMM supports several Android intents you can use to configure and control the program.

An intent may trigger TMM to show user interface, or it may do a configuration action in the background.

An intent may return information to the calling program, or it may simply perform the requested action without any return.

TMM intents can be invoked with:

com.trimble.tmm.INTENTNAME

Android Intents

CORRECTIONSOURCESETTINGS

Summary

Open the Configuration page

Remarks

The com.trimble.tmm.CORRECTIONSOURCESETTINGS is used to display the correction source settings page in TMM.

Returns

None

EBUBBLECALIBRATION

Summary

Open the Tilt calibration page

Remarks

The com.trimble.tmm.EBUBBLECALIBRATION intent is used to display the eBubble tilt calibration page in TMM.

Returns

None

GNSS_STATUS

Summary

Open the GNSS Status page

Remarks

The com.trimble.tmm.GNSS_STATUS intent is used to display the GNSS Status page in TMM.

Returns

None

HERE

Summary

Open the Point Measurement page

Remarks

The com.trimble.tmm.HERE intent is used to display the Point Measurement page in TMM.

Input

  • name (string): The name to be tested.
  • comment (string): The comment to be tested.
  • antennaHeight (double): The height of the antenna.

Returns

None

IMUBIASCALIBRATION

Summary

Open the IMU calibration page

Remarks

The com.trimble.tmm.IMUBIASCALIBRATION intent is used to display the IMU Bias calibration page in TMM.

Returns

None

LOGIN

Summary

Client application login

Remarks

The com.trimble.tmm.LOGIN Downloads licenses for the user and client application, and sends the login information back to the caller.

Input

  • applicationID (string): The application ID.

Output

Returns an intent containing the login information.

  • accountName (string): The name of the logged-in user.
  • accountJWT (string): The ID token of the logged-in user.
  • accountAT (string): The access token of the logged-in user.
  • refreshToken (string): The refresh token of the logged-in user.
  • tpsdkVersion (string): The version of the Trimble Precision SDK.

ONDEMAND

Summary

Open to the On Demand page

Remarks

The com.trimble.tmm.ONDEMAND intent is used open the On-Demand licensing page in TMM if a user is signed in.

Input

  • applicationID (string): The application ID.

Output

Returns an intent containing the On-Demand claim and remaining time.

  • currentClaim (string): The current On-Demand claim selected by the user.
  • claimCountdown (string): The remaining time for the current On-Demand claim.

OPENANTENNAHEIGHT

Summary

Open the Antenna Height page

Remarks

The com.trimble.tmm.OPENANTENNAHEIGHT intent is used to start this activity. This activity opens the Antenna Height page.

Returns

None

OPEN_TO_CONFIGURATION

Summary

Open the Configuration page

Remarks

The com.trimble.tmm.OPEN_TO_CONFIGURATION intent is used to display the Configuration page in TMM.

Returns

None

OPEN_TO_LOGIN

Summary

Open the login page

Remarks

The com.trimble.tmm.OPEN_TO_LOGIN intent is used to start the login process in TMM.

Input

  • applicationID (string): The application ID.

Output

Returns an intent containing the user’s account information and the Trimble Precision SDK version.

  • accountName (string): The name of the logged-in user.
  • accountTID (string): The TID of the logged-in user.
  • accountJWT (string): The ID token of the logged-in user.
  • accountAT (string): The access token of the logged-in user.
  • tpsdkVersion (string): The version of the Trimble Precision SDK.

RECEIVERSELECTION

Summary

Open the receiver selection page

Remarks

The com.trimble.tmm.RECEIVERSELECTION intent is used to start the receiver selection process in TMM.

Returns

None

SKYPLOT

Summary

Open the Skyplot page

Remarks

The com.trimble.tmm.SKYPLOT intent is used to display the Skyplot page in TMM.

Returns

None

POLEBIASADJUSTMENT

Summary

Open the Pole bias adjustment page

Remarks

The com.trimble.tmm.POLEBIASADJUSTMENT intent is used to display the Pole Bias Adjustment page in TMM.

Returns

None

PseudoSecureSocketServerPort

Summary

Query the list of TMM server ports

Remarks

The com.trimble.tmm.SocketServerPort and com.trimble.tmm.PseudoSecureSocketServerPort intents are used to start the socket server port activities in TMM.

Input

  • applicationID (string): The application ID.

Output

Returns an intent containing the registration result and port information.

  • port (integer): The port number for the secure socket server.
  • apiPort (integer): The port number for the API server.
  • locationPort (integer): The port number for the LocalHost server.
  • locationSecurePort (integer): The secure port number for the LocalHost server.
  • locationV2Port (integer): The port number for the LocalHost server V2.

RefreshUserToken

Summary

Refresh the user token

Remarks

The com.trimble.tmm.RefreshUserToken intent is used to refresh the user token in TMM.

Input

  • applicationID (string): The application ID.

Output

Returns an intent containing information about the token refresh process or any errors that occurred.

  • info (string): “Success” is returned when the process is successful. “RecentlyRefreshed” is returned if token refresh is not needed
  • error (string): “No user logged in” if a user has not been correctly logged.

REGISTER

Summary

Register client application

Remarks

The com.trimble.tmm.REGISTER intent is used to start the registration process in TMM.

Input

  • applicationID (string): The application ID.

Output

Returns an intent containing the registration result and port information.

  • registrationResult (string): The result of the registration process. This could be “OK”, “NoNetwork”, “Unauthorized”, or “Error”.
  • apiPort (integer): The port number for the API server.
  • locationPort (integer): The port number for the LocalHost server.
  • locationSecurePort (integer): The secure port number for the LocalHost server.
  • locationV2Port (integer): The port number for the LocalHost server V2.

SocketServerPort

Summary

Query the list of TMM server ports

Remarks

The com.trimble.tmm.SocketServerPort and com.trimble.tmm.PseudoSecureSocketServerPort intents are used to start the socket server port activities in TMM.

Input

  • applicationID (string): The application ID.

Output

Returns an intent containing the registration result and port information.

  • port (integer): The port number for the socket server.
  • apiPort (integer): The port number for the API server.
  • locationPort (integer): The port number for the LocalHost server.
  • locationSecurePort (integer): The secure port number for the LocalHost server.
  • locationV2Port (integer): The port number for the LocalHost server V2.

STATUS

Summary

Query TMM account status information

Remarks

The com.trimble.tmm.STATUS intent is used to query the current user status information.

Input

  • applicationID (string): The application ID.

Output

Returns an intent containing the status information.

  • accountName (string): The name of the logged-in user.
  • accountTID (string): The TID of the logged-in user.
  • accountJWT (string): The ID token of the logged-in user.
  • accountAT (string): The access token of the logged-in user.
  • accountRefreshRecommended (boolean): Indicates whether a refresh is recommended.
  • subscriptionPrecision (double): The precision limit of the subscription.
  • badPrecisionThreshold (double): The bad precision threshold of the subscription.
  • goodPrecisionThreshold (double): The good precision threshold of the subscription.
  • subscriptionName (string): The name of the subscription in use.
  • subscriptionExpiration (string): The expiration date of the subscription in use.
  • distanceUnit (string): The distance unit in use.
  • componentInstallationNeeded (boolean): Indicates whether the Catalyst Service needs to be installed.
  • deviceHardwareSupport (integer): The level of device hardware support.

Copyright © 2024, Trimble Inc.