Automatically translate this page?

Quick start guide (physical tracker)

Step-by-step instructions on how to connect a GPS tracker to flespi and access its messages.

When you have a physical GPS tracker at hand, you can set it up to send data into flespi, properly organize the received data inside the platform, and use it in the solutions you are developing.

Here’s the basic sequence of steps you want to follow to have the data from your tracker available in the flespi platform.

Channel

  • Create a channel (flespi.io -> Telematics hub -> Channels) with the protocol corresponding to your device manufacturer:
    create flespi channel

  • Point your tracker to the DNS:port of your newly created channel. You can do it via SMS or using a configuration tool provided by the manufacturer.

  • When done, make sure your device is set to send its position and open the Toolbox tab for your channel to see if messages are coming or if anything is going wrong:
    flespi channel toolbox

Device

You don’t have to create a device in the flespi platform — for some applications, it’s sufficient to consume messages from the flespi channel.

You want to create a flespi device if you need (a) dedicated long-term message storage, (b) access to telemetry, (c) device configuration capabilities. If you need at least one of these, follow the steps below:

  • Create a device (flespi.io -> Telematics hub -> Devices). Use the IMEI printed on the device case to populate the ident field.
    navtelecom device imei
    Or find it in the ident column of the Toolbox logs:
    flespi channel toolbox ident

  • Pick device type corresponding to your device model. Save.
    pick flespi device type

  • Open the Toolbox tab for your device to see if the messages from the tracker with the given ident (IMEI) successfully come to flespi:
    flespi device toolbox

Access to data

Once the data gets into flespi, you want to access it to use inside your solution. This can be achieved in three ways:


See also
Four ways for the massive creation of devices in the flespi platform.
Using flespi MQTT stream to publish the data from your devices to the MQTT broker.