TMM Servers
Trimble Mobile Manager uses local REST API servers for TMM configuration, and local WebSocket servers to stream real-time data to client applications. The following servers are available:
Server Addresses
Section titled “Server Addresses”The local servers are available on the following addresses:
| Address | Supported Protocols | Requires Internet Connection |
|---|---|---|
| tmm-api-local.fieldsystems.trimble.com | HTTP, HTTPS, WS, WSS | Yes |
| localhost | HTTP, WS | No |
| 127.0.0.1 | HTTP, WS | No |
Server Ports
Section titled “Server Ports”The local servers are available on the following default ports:
| Name | Security | Port | Protocol |
|---|---|---|---|
| WebSocket V1 | Insecure | 9635 | WS |
| Secure | 9636 | WSS | |
| REST API | Insecure | 9637 | HTTP |
| Secure | 9638 | HTTPS | |
| WebSocket V2 | Insecure | 9639 | WS |
| Secure | 9640 | WSS |
In the unlikely event that the default ports are unavailable, the servers will find the next available port starting at 9650. Actual port assignments may be queried from TMM using the following interfaces:
- iOS URL Schemes: tmmRegister, tmmSocketServerPort
- Android Intents: REGISTER, SocketServerPort
- Windows URI Requests: tmmRegister, tmmSocketServerPort
- REST API: GET /api/v1/tmmInfo
REST API Server
Section titled “REST API Server”The REST API server is available on Android, iOS and Windows platforms. It is used to get and set configuration details in Trimble Mobile Manager, such as antenna height, NTRIP server configuration, and more.
WebSocket V1 (Deprecated)
Section titled “WebSocket V1 (Deprecated)”WebSocket V1 is the original WebSocket interface. It is now deprecated in favor of the more robust WebSocket V2 interface, but is still supported for backward compatibility. We recommend using WebSocket V2 for all new integrations.
The WebSocket V1 interface:
- Supported for backward compatibility.
- Supports a single channel which sends location data in the LocationV1 format.
- Available on Android, iOS and Windows platforms.
- Open availability (no Application ID required).
| Channel | Address | Frequency | Description |
|---|---|---|---|
| Root | / | 1 Hz | Stream of LocationV1 messages |
WebSocket V2
Section titled “WebSocket V2”The WebSocket V2 interface is the latest WebSocket interface which sends robust location data, and application event data on separate channels.
The WebSocket V2 interface:
- Recommended for new integrations.
- Supports multiple channels for different types of data, such as location and application events.
- Available on Android, iOS and Windows platforms.
- Requires a valid TMM Application ID to unlock.
| Channel | Address | Frequency | Description |
|---|---|---|---|
| Root | / | 1-10 Hz | Stream of LocationV2 messages |
| LocationV2 | /locationV2 | 1-10 Hz | Stream of LocationV2 messages |
| Event | /events | As needed | Stream of application event messages |