How to configure sending unit data from the High Mobility system to Wialon using flespi

This guide describes how to set up data retransmission from the High Mobility system to Wialon using flespi.

The configuration process consists of the following steps:

1. Creating a High Mobility account.
2. Configuring a High Mobility project.
3. Setting up data transfer from High Mobility to flespi.
4. Configuring a flespi stream to Wialon.
5. Receiving device data in Wialon.

Each of these steps is described below.

To create a High Mobility account:

1. Sign up on the High Mobility console.
2. In your account, click New data project.
3. Select the Fleet option, or another available option depending on your use case.
4. Specify the project name.
5. Click Create project.

After that, a project with the specified name is created in your account.

To configure a High Mobility project in your account:

1. Open the created project.
2. Go to the Car Data tab.
3. Select the brands of your vehicles and the data packages that meet your needs. For testing purposes, it’s enough to select a few brands and packages. All selected packages are displayed under Project Details → Selected Brands & Data.
4. Go to the API Credentials tab. For testing, use Sandbox mode.
5. Open the Streaming sub-tab.
6. Select the MQTT V2 (Enterprise) method.
7. Click Save and update.
8. Add an MQTT certificate chain by clicking the plus button. This downloads an archive containing the certificates.
9. Go to the OAuth Client sub-tab and keep it open because you’ll need this information in the next step.

To set up data transfer from High Mobility to flespi:

1. In a new browser tab, go to https://flespi.io and log in to your account.

2. In the Telematics Hub, select Channels.

   

3. Click the button .

4. Enter the channel name. For example, High Mobility vehicles.

5. From the Protocol id dropdown list, select high-mobility.

6. Copy the CLIENT ID from High Mobility (OAuth Client tab) and paste it into the OAuth Client ID field on flespi.

7. Copy the CLIENT SECRET from High Mobility and paste it into the OAuth Client Secret field on flespi.

8. Open the snippet.txt file from the archive you downloaded in step 8 of the previous instruction and do the following:

   • copy the id value and paste it into the Client ID field;
   • copy the topic value (without quotes) and paste it into the Topic to subscribe field.

9. Open the ca_crt.pem, client_crt.pem, and client_key.pem files from the same archive and paste their contents into the CA Certificate, Client Certificate and Private Key fields, respectively.

10. Double-check the specified data and click **Save.

1. Go back to your High Mobility project and open the Simulation Studio tab.

2. Click Create new simulator.

3. Open the created simulator.

4. In the Telematics Hub on flespi, select the Devices tab.

5. Click the button and create a new device:

   • In the Device type ID field, select High Mobility (high-mobility).
   • In the Device identifier field, paste the VIN from the High Mobility simulator.
   • Click Save + Open.

6. Navigate to the Commands & Settings tab.

7. Click New command and do the following:

   • Select the Provision device command type.
   • Enable the Vehicle brand field and specify the desired vehicle brand. See the High Mobility documentation for the input format, or check with HighMobility support. For the test simulator, leave it as sandbox.
   • Click Send.

   The command response should contain "status": "pending". If the status is different, verify the specified data or unlink the vehicle using the Deprovision device command and try again.

8. Go back to the High Mobility simulator and open the Simulations tab.

9. Click Create new and create a new simulation:

   • Specify the simulation name.
   • Optionally, enter a description.
   • Click Create new simulation.

10. Run the simulation.

If everything is configured correctly, you will see messages on the Logs & Messages tab of the device on flespi.

To create a stream for transmitting device data to Wialon Hosting, follow these steps:

1. In the Telematics hub, select Streams.

   

2. Click the button to create a new stream to Wialon Hosting.

3. Specify the stream name.

4. In the Protocol id field, specify wialon_retranslator.

5. In the Configuration section, specify your Wialon server address. You can find it in the Server address field on the General tab of the unit properties.

6. Click Save + Open.

7. Open the Devices tab.

8. Click the clip button in the lower-right corner.

9. Select the device configured earlier.

Now you have a stream to Wialon Hosting with your device assigned to it.

To receive the device data in Wialon, create a unit in Wialon with the following properties:

• Device type: your device type.
• Unique ID: the same value as the device identifier on flespi.

If everything is configured correctly and the simulation is running, the unit in Wialon starts receiving messages from the High Mobility system. To view them, you can request data messages from the unit in Wialon.

For further information, see the following articles in the flespi knowledge base:

• Setting up the High Mobility and flespi integration
• Setting up a stream on flespi