Android Intents
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.INTENTNAMEAndroid Intents
Section titled “Android Intents”CORRECTIONSOURCESETTINGS
Section titled “CORRECTIONSOURCESETTINGS”Summary
Section titled “Summary”Open the Configuration page
Remarks
Section titled “Remarks”The com.trimble.tmm.CORRECTIONSOURCESETTINGS is used to display the correction source settings page in TMM.
Returns
Section titled “Returns”None
EBUBBLECALIBRATION
Section titled “EBUBBLECALIBRATION”Summary
Section titled “Summary”Open the Tilt calibration page
Remarks
Section titled “Remarks”The com.trimble.tmm.EBUBBLECALIBRATION intent is used to display the eBubble tilt calibration page in TMM.
Returns
Section titled “Returns”None
GNSS_STATUS
Section titled “GNSS_STATUS”Summary
Section titled “Summary”Open the GNSS Status page
Remarks
Section titled “Remarks”The com.trimble.tmm.GNSS_STATUS intent is used to display the GNSS Status page in TMM.
Returns
Section titled “Returns”None
Summary
Section titled “Summary”Open the Point Measurement page
Remarks
Section titled “Remarks”The com.trimble.tmm.HERE intent is used to display the Point Measurement page in TMM.
- distanceUnit (string): The unit of distance measurement.
- name (string): The name to be tested.
- comment (string): The comment to be tested.
- antennaHeight (double): The height of the antenna.
Returns
Section titled “Returns”None
IMUBIASCALIBRATION
Section titled “IMUBIASCALIBRATION”Summary
Section titled “Summary”Open the IMU calibration page
Remarks
Section titled “Remarks”The com.trimble.tmm.IMUBIASCALIBRATION intent is used to display the IMU Bias calibration page in TMM.
Returns
Section titled “Returns”None
Summary
Section titled “Summary”Client application login
Remarks
Section titled “Remarks”The com.trimble.tmm.LOGIN Downloads licenses for the user and client application, and sends the login information back to the caller.
- applicationID (string): The application ID.
Output
Section titled “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
Section titled “ONDEMAND”Summary
Section titled “Summary”Open to the On Demand page
Remarks
Section titled “Remarks”The com.trimble.tmm.ONDEMAND intent is used open the On-Demand licensing page in TMM if a user is signed in.
Output
Section titled “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
Section titled “OPENANTENNAHEIGHT”Summary
Section titled “Summary”Open the Antenna Height page
Remarks
Section titled “Remarks”The com.trimble.tmm.OPENANTENNAHEIGHT intent is used to start this activity.
This activity opens the Antenna Height page.
Returns
Section titled “Returns”None
OPEN_TO_CONFIGURATION
Section titled “OPEN_TO_CONFIGURATION”Summary
Section titled “Summary”Open the Configuration page
Remarks
Section titled “Remarks”The com.trimble.tmm.OPEN_TO_CONFIGURATION intent is used to display the Configuration page in TMM.
Returns
Section titled “Returns”None
OPEN_TO_LOGIN
Section titled “OPEN_TO_LOGIN”Summary
Section titled “Summary”Open the login page
Remarks
Section titled “Remarks”The com.trimble.tmm.OPEN_TO_LOGIN intent is used to start the login process in TMM.
- applicationID (string): The application ID.
Output
Section titled “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
Section titled “RECEIVERSELECTION”Summary
Section titled “Summary”Open the receiver selection page
Remarks
Section titled “Remarks”The com.trimble.tmm.RECEIVERSELECTION intent is used to start the receiver selection process in TMM.
Returns
Section titled “Returns”None
SKYPLOT
Section titled “SKYPLOT”Summary
Section titled “Summary”Open the Skyplot page
Remarks
Section titled “Remarks”The com.trimble.tmm.SKYPLOT intent is used to display the Skyplot page in TMM.
Returns
Section titled “Returns”None
POLEBIASADJUSTMENT
Section titled “POLEBIASADJUSTMENT”Summary
Section titled “Summary”Open the Pole bias adjustment page
Remarks
Section titled “Remarks”The com.trimble.tmm.POLEBIASADJUSTMENT intent is used to display the Pole Bias Adjustment page in TMM.
Returns
Section titled “Returns”None
PseudoSecureSocketServerPort
Section titled “PseudoSecureSocketServerPort”Summary
Section titled “Summary”Query the list of TMM server ports
Remarks
Section titled “Remarks”The com.trimble.tmm.SocketServerPort and com.trimble.tmm.PseudoSecureSocketServerPort intents are used to start the socket server port activities in TMM.
- applicationID (string): The application ID.
Output
Section titled “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
Section titled “RefreshUserToken”Summary
Section titled “Summary”Refresh the user token
Remarks
Section titled “Remarks”The com.trimble.tmm.RefreshUserToken intent is used to refresh the user token in TMM.
- applicationID (string): The application ID.
Output
Section titled “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
Section titled “REGISTER”Summary
Section titled “Summary”Register client application
Remarks
Section titled “Remarks”The com.trimble.tmm.REGISTER intent is used to start the registration process in TMM.
- applicationID (string): The application ID.
Output
Section titled “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
Section titled “SocketServerPort”Summary
Section titled “Summary”Query the list of TMM server ports
Remarks
Section titled “Remarks”The com.trimble.tmm.SocketServerPort and com.trimble.tmm.PseudoSecureSocketServerPort intents are used to start the socket server port activities in TMM.
- applicationID (string): The application ID.
Output
Section titled “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
Section titled “STATUS”Summary
Section titled “Summary”Query TMM account status information
Remarks
Section titled “Remarks”The com.trimble.tmm.STATUS intent is used to query the current user status information.
- applicationID (string): The application ID.
Output
Section titled “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.