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 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 your fields as below (we will update them later):
  1. Configure your endpoint as below (we will update it 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. Go to association
  1. Select all the tags you want to link (in this example, we have associated the tags “et-1431C” and “1-00773”)
  1. Go back to your dashboard: after a minute 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.

📘

If you don't receive any message, look into optimizing the reception of the Gateway

Look into this documentation to learn how to optimize the reception

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:

  • Start by creating the THNGs in the EVRYTHNG platform that will correspond to the Wiliot tags.
  • 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 “1-00773”

  • Go back to the Wiliot management dashboard and into your application. Click on edit and go to the Endpoint section. There you can 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 your EVRYTHNG Trusted App API Key here. Content-Type: set it to application/json.
  • 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}}"
   }
]

Don't forget to add all the fields you are using in the Fields section as well. Finally, in the Event Policy section, you can configure the filters that you would like to apply.

🚧

It is recommended to uncheck all the fields that you won't need!

Otherwise, the Wiliot proxy will push a lot of unwanted information into the EVRYTHNG platform, making it hard for you to work with the event. Find more details about each event here.

The following example is what a temperature event looks like in the EVRYTHNG developer dashboard.

Updated 6 days ago

Wiliot Battery-Free Bluetooth


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.