Documentation

Integrations / Connection guides / KPN things

KPN Things

KPN Things is a superset of the SenML data format created by KPN. It aims to be a simple and small message format used by constraint devices while still being self-describing. A great benefit of KPN Things is that it is a standardized way to represent sensor data eliminating most of the usual integration hassle of converting from on data format to another.

Goal

The goal is to set up an inbound connector to parse KPN Things data.

Prerequisites
  1. Blockbax project
Steps to connect a device

Before you can connect your device you will first need to setup an ‘Inbound Connector’ in Blockbax.

  1. Open the Blockbax web app and go to ‘Settings’ -> ‘Inbound Connectors’.
  2. Press the ‘+’ icon or ‘Create Inbound connector’ button.
  3. Select the SenML template under ‘KPN’ -> ‘ThingsML’.
  4. (Optional) If you wish to change the protocol click on Show advanced settings and change the Transfer protocol.
  5. Press ‘Save changes’.

You can test if everything works by opening the Blockbax web app, creating a subject type with the previously mentioned metric external IDs and a subject with the device serial number as the subject external ID.

Configure your subject type

Like SenML, KPN Things has a standard naming schema that the SenML template uses to map out and ingest measurements. The main difference is that the KPN Things has a common measurements list that we use for the metric IDs. If the index for one of these common measurements is not available, the conversion acts the same as the SenML template.