Automatically translate this page?
6 September, 2017

flespi test-drive: connecting WiaTag to Wialon Hosting and GPS Trace

A practical case showing basic functionality of the flespi platform from connecting devices to using streams for sending data across multiple applications
Disclaimer: flespi registry streams API has changed, so everything talking about streams in this article is outdated. This article applies an “each device has its own streams” model, i.e., streaming messages from several devices to one endpoint requires creating the same stream for each device.
We’ve got numerous requests to implement streams for channels and also to enable sending HTTP-requests with messages to the third-party platform instead of sending messages as a response to HTTP calls via our REST API. The solution was to redesign our streaming architecture. Which we did. Please meet and learn more about the brand new streams here.
Disclaimer 2: flespi registry module merged with the gateway module to form the telematics hub between devices and platforms.

Now that flespi features both Gateway module to collect data from tracking devices and Registry module to translate messages over diverse protocols to multiple platforms, we are ready to illustrate the entire procedure end to end. The testing environment includes:

Tracking device: WiaTag mobile app
Middleware: flespi
Business apps: Wialon Hosting, GPS Trace

Let's have a ride now.

flespi test drive

1. Configuring Wialon Hosting

  • On the receiving side we need to create a unit that will reflect the device position on the map.
  • Click Units -> New to create a unit in Wialon Hosting
  • Give it a descriptive name, set Device type to Wialon IPS, and specify the unique ident within the platform.
    wialon hosting unit create

2. Configuring GPS Trace

  • Log in or sign up with GPS Trace.
  • Click on the car icon in the bottom-right corner to create unit in GPS Trace.
  • Give it a name, set Device type to Wialon IPS, and specify the unique ident within the platform.
    gps trace unit create

3. Setting up WiaTag

  • Navigate to Google Play or App Store and install WiaTag on your smartphone.
  • Log in with your Wialon Hosting account. If you don’t have one, request it here.
  • Select WiaTag data sending mode — it will mostly affect the frequency of outgoing messages, and, consequently, the accuracy of tracking.
    wiatag mode select

4. Connecting device to flespi

  • Login to flespi panel — you can use any of your social media accounts or create a dedicated account.
  • Click Channels -> New channel to create a connection from WiaTag device to flespi (channels are operated by Gateway module). Give it a name and select WiaTag protocol from the drop-down list.
    flespi channel create
  • Now copy the URI of the newly created channel
    flespi channel uri
    into WiaTag app -> Settings -> Server
    wiatag server uri
  • Then on WiaTag main screen click the plus sign (“+”) and select Send position

  • To check that the message was received by the channel click the Show log icon for the created channel and switch to history mode
    flespi channel log
  • Now that we have the message in flespi, we will transmit it to the aforementioned business platforms
  • Click Devices -> "+" button to create a flespi device that will aggregate all messages from the smartphone (devices and streams are operated by Registry module). Give it a name, specify the ident value (you can find it in WiaTag settings -> Unit properties -> Unique ID), and select a device type from the drop-down list
    create flespi device
  • Next, we will create an outgoing stream to feed the data into Wialon Hosting. Click on the Streams icon
  • Then click New stream button and set up the new stream as follows:
    • give it a name
    • specify the protocol to transfer data into the business application — in our case it’s Wialon IPS
    • specify the URI: Wialon Hosting receives data via Wialon IPS at
    • specify the ident — the unique value you assigned to your unit in Wialon Hosting platform
  • flespi stream create wialon ips

    flespi stream create wialon hosting
  • Similarly, let’s set up another stream to GPS Trace:
    • give it a name
    • select Wialon IPS protocol from the drop-down list
    • specify the URI: GPS Trace receives data via Wialon IPS at
    • specify the ident — the unique value you assigned to your unit in GPS Trace platform
  • flespi stream create gps trace

5. Checking operability

  • In WiaTag click the plus sign (“+”) and select Send position.
  • The icon of the unit should appear in the location you and your phone is currently at:
    in Wialon Hostingwialon hosting unit location
    and in GPS Trace
    gps trace unit location


This brief demo shows how straightforward it is to connect devices to platforms and how flespi devices facilitate forking communication to multiple business applications, potentially, over multiple protocols.

Try flespi to unify your tracking infrastructure and contact us with any questions you may have.

Get the latest updates and monthly newsletters from flespi in your inbox

When The Clouds Close Down: Feeding GPS Data to Microsoft Azure IoT

How to get messages from GPS trackers in MS Azure IoT via flespi telematics hub.

12 July, 2018 | about flespi | Jan Bartnitsky

MQTT scores again: flespi REST API over MQTT

How to use flespi HTTP REST API over MQTT and when not to do that.