Connection state
Every GPS device on the platform has a status that indicates its current connection state to the server. These statuses are color-coded and visible in the list of objects. This state does not necessarily mean the device is broken, it’s merely a visualization of the timing of data the platform receives from a device.
Color-coded indicators provide a quick and easy way for users to assess the status of their GPS devices at a glance.
The following table outlines the possible statuses for GPS devices, providing a description of each status and what it signifies about the device’s connection and activity. This information helps users understand the real-time condition of their devices, identify any issues, and take appropriate actions to ensure optimal performance.
Status | Description |
|---|---|
Activated devices | |
 | Online |
 | GPS Not Updated The object’s GPS device is connected to the server but hasn’t transmitted any data or coordinates for at least 5 minutes. Possible reasons include:
|
 | Offline The object's GPS device hasn’t sent any information to the platform given the user-specified time (default is 10 minutes). Possible reasons include:
|
 | Suspended During the suspension period, no data from the device is accepted by the platform, and data from this period won’t be available even after the suspension is lifted. To resume service, top up your balance or contact support. The device will be automatically unblocked within 15 minutes after payment. |
Devices added, but not yet activated | |
 | Activating now The GPS device has been newly added. This status will be displayed until activation ends which typically takes up to 2-3 minutes. (Exception: for the X-GPS Tracker mobile app this status extends indefinitely). |
 | Activation takes longer than expected The GPS device was added, but no connection was established with the platform so far. Additional actions may be needed, please refer to activation issue articles for troubleshooting. |
 | Manual configuration needed The GPS device requires manual configuration as it doesn’t support automatic activation. Follow the device configuration instructions or contact the support team of your Service Provider for assistance. Tips:
|
 | No data received from device |
Connection State Sequence
The diagram below illustrates the sequence of connection statuses for a successfully activated GPS device on the platform, showing the transitions between different states based on the data received and the time elapsed.
Here’s the detailed explanation:
Initially, the device is Online, indicated by a green circle, meaning it is connected to the server and transmitting valid GPS coordinates and timestamp. If no new GPS coordinates or data are received for 5 minutes, the status changes to GPS Not Updated, represented by a green circle with a hole. This can happen if the device loses GPS signal, enters power-saving mode, or sends outdated data from its memory.
If the connection timeout period (as set by a user or 10 minutes by default) is reached without receiving any new data, the status changes to Offline, shown as a red circle. This may occur if the device is in an area with poor cellular signal, in deep sleep mode, or has issues like SIM card problems or reached the SIM data limit.
When the device resumes sending valid GPS coordinates and timestamp, the status reverts to Online and the cycle repeats as long as the device operates, transitioning between statuses based on the data received and the elapsed time.
This sequence helps users monitor the real-time connectivity and data transmission status of their GPS devices, ensuring timely action can be taken if any issues arise.