Wiliot Battery-Free Bluetooth

EVRYTHNG provided the first and most comprehensive integration with Wiliot tags the battery-free Bluetooth tags from Wiliot. This page describes the easy steps required to connect Wiliot tags to the EVRYTHNG Product Cloud and stream actionable sensor data from the tags.


Setting up a Wiliot Gateway

First, you'll need the tag signal to reach the Wiliot platform. You can do this using two approaches:

Using a Wiliot IoT Gateway

You'll find more details about this approach in the Wiliot documentation portal.

Using smartphone as a Gateway

This approach is detailed here.

Creating your EVRYTHNG project and application

We suppose you have already created a project dedicated to Wiliot in your EVRYTHNG dashboard. If you want more information on how to do it: https://developers.evrythng.com/docs/using-the-dashboard-resource-management.
Within this project create an application and store its trusted API key, which will be needed soon.

Creating your Wiliot application

  1. Go to the Wiliot management dashboard

  2. Click on ‘new application’ (top right of the dashboard).

  3. Set your application Name

  4. Configure the URL field as follows: https://api.evrythng.com/thngs/WiliotID:{{tagId}}/properties.
    Configure the Method as POST and add two headers: Authorization: add the EVRYTHNG Trusted App API Key of the application you previously created. Content-Type: set it to application/json.
    We will update the body field later.

  1. Leave the event policy field with its default value and hit the save button.

Linking the Wiliot tags with the Wiliot proxy

Two simple steps allow you to send the data from the tags to the Wiliot proxy:

  1. Click on your newly created application and go to Association:
  1. Select all the tags you want to link (in this example, we have associated the tags “...0055T0606” and “...005dT0215”)
  1. Make sure the Wiliot Gateway is on. In case you are using your smartphone as a gateway, you can check whether the tag is being detected. If so the tag's packets will be redirected to the Wiliot dashboard.
  1. Go back to your dashboard: after a few minutes you should receive some messages. If you see data in your report graph, it means it is working.

If you do not, ensure you have data on the report graph in the debug application. If you do not see the debug data then your gateway is probably not set up correctly or your tags are too far away from the gateway.

Linking the Wiliot Proxy to the EVRYTHNG Product Cloud

A few simple steps allow you to bridge the data from the Wiliot proxy onto the EVRYTHNG platform
First, you'll need to set up the endpoint to redirect the incoming message to the EVRYTHNG dashboard:

  • Start by creating the THNGs in the EVRYTHNG platform that will correspond to the Wiliot tags. Make sure this THNG is included in the project which contains the application you provided the EVT_trusted_app_key for, during the endpoint configuration. In this case, the project is called Wiliot.
  • Then, link the Wiliot IDs with the EVRYTHNG IDs. To do that, for each THNG, you’ll need to add an identifier with the name ‘WiliotID’, its value is the ID of the tag (it has to be exactly the same as it is defined in the Wiliot dashboard).
Example for tag “...0055T0606"Example for tag “...0055T0606"

Example for tag “...0055T0606"

  • Go back to the Wiliot management dashboard and into your application. Click on edit and go to the Endpoint section. Now, you can configure the body of the request. You can add all the fields that you need. Here is an example:
[
   {
      "key":"eventName",
      "value":"{{tagId}}:{{eventName}}"
   },
   {
      "key":"eventValue",
      "value":"{{eventValue}}"
   },
   {
      "key":"timestamp",
      "value":"{{timestamp}}"
   },
   {
      "key":"latitude",
      "value":"{{latitude}}"
   },
   {
      "key":"longitude",
      "value":"{{longitude}}"
   }
]

Finally, in the Event Policy section, you can configure the filters that you would like to apply. As an example, we removed all the events besides TEMP_C.

This way, you should be able to see the temperature evolution in the property eventvalue in your EVRYTHNG dashboard.