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.
Color-coded indicators provide a quick and easy way for users to assess the status of their GPS devices at a glance. Green indicates that everything is functioning correctly, while red, yellow and gray signals that there might be issues needing attention.
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 | |
Connected Visible | |
Connected Invisible The object’s GPS device is connected to the server but hasn’t transmitted current coordinates for more than 5 minutes. Possible reasons include:
| |
Not connected The object's GPS device hasn’t sent data for the user-specified time (default is 10 minutes). Possible reasons include:
| |
Suspended (Subscription expired) 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 Connected Visible, indicated by a green circle, meaning it is connected to the server and transmitting valid GPS coordinates and timestamp. If no new GPS coordinates are received for 5 minutes, the status changes to Connected Invisible, 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 Not connected, 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 exhausted GPRS traffic.
When the device resumes sending valid GPS coordinates and timestamp, the status reverts to Connected Visible 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.