Basic device connection troubleshooting guide

Basic device connection troubleshooting guide

When a GPS tracking device is not showing data or appearing offline, use the following steps to perform basic troubleshooting. This can help identify and resolve common connection issues quickly.

1. โœ… Confirm Device is Powered and Installed Correctly

  • Ensure the device is securely connected to a power source.

  • For vehicle devices, verify ignition is on (if applicable).

  • Check for visible LED indicators (power/GPS/GSM) and refer to the device manual for status meanings.

2. ๐ŸŒ Check Network Connectivity

  • Make sure the device has a working SIM card installed.

  • Ensure the SIM card has:

    • Data enabled.

    • Sufficient airtime or an active data plan.

    • No PIN lock.

  • The device should have GSM signal. Some models show signal strength via LEDs.

3. ๐ŸŒ Verify Server and Port Configuration

  • Production Server: data.gpsiot.net

  • Port: This must match the port assigned to your specific device brand/model. You can find the correct port here:
    ๐Ÿ”— Supported Hardware and Ports

Example: Teltonika devices often use port 12070

Check that your device is configured with:

  • The correct APN (provided by your SIM carrier).

  • Server set to data.gpsiot.net

  • The correct port number (as per device model).

  • Make sure the device is using TCP as the transmission protocol, not UDP.

4. ๐Ÿ› ๏ธ Use SMS or Platform Tools to Query Device

  • Most devices accept SMS commands to return current settings (e.g., APN, server, port).

  • Use these to confirm if the device is pointing to the correct server and port.

5. ๐Ÿ“ˆ Wait for First Fix

  • Devices may take a few minutes after power-up to obtain a GPS fix and begin transmitting.

  • Ensure the device has clear access to the sky for GPS signal.

6. ๐Ÿงช Cross-check with Platform

  • On our tracking platform, confirm the device IMEI or ID is correctly added.

  • Check telemetry logs or incoming data if available.

7. ๐Ÿ“ž Still Not Working?

If all settings are correct and the device is still offline:

  • Restart the device.

  • Try swapping the SIM card with a known working one.

  • Contact support@whitelabeltracking.com with:

    • Device model and IMEI/Device ID.

    • SIM card details (carrier, data status).

    • Current device settings (APN, server, port).


This general guide addresses most common/initial connection issues. For more advanced troubleshooting, please consult the device manufacturer and provide complete logs and configuration details.