LogoLogo
  • KPN THINGS USER GUIDE
    • Introduction
    • Getting started
      • Registration and setup
      • Device simulator app
      • Connect devices
        • SIM cards
        • Supported devices and KPN Devices
        • SODAQ R412M
        • Smartrak
        • Marvin development board
        • LoPy5
        • Arduino MKR WAN 1300/1310
        • Arduin MKR NB 1500
    • All videos
    • Tutorials
      • Configure a flow
      • Connect a HTTPs destination
      • Create a simple IoT web applicationPage
      • Send instruction to LoRa DevicePage
      • Send your data to Azure SQL
      • Technical overview
        • Management data model
        • Uplink communication
        • Downlink communication
        • Location data
      • Accounts and projects
        • Customer accounts and users
        • Projects
        • Customer management
        • Cost overview and contract
    • Frequently asked
      • Multi Factor Authentication
  • GENERAL FUNCTIONS
    • Quick reference videos
    • APIs
  • THE PORTAL EXPLAINED
    • Things Manager
      • Devices
        • Bulk operations
      • Data
        • Device data graph
      • Connectivity
        • LoRa connectivity configuration
      • Bulk reports
    • Things Creator
    • Support
      • News
      • Release notes
      • Real-time status
      • Service reports
      • Documents
      • Support tickets
      • Invoices
      • Contact info
    • Shop
  • BUILDING BLOCKS
    • Devices
      • Sensors
        • KPN Conditionsensor CO2 II
        • KPN Conditionsensor CO2 III
        • KPN Conditionsensor CO2 III motionPage 1
        • KPN FillTag I
        • KPN FillTag II
        • 1M2M ED1608
        • Elsys ERS
        • Device Simulator (Mobile Phone app)
        • Generic Device (Internet connected)
        • Generic LoRa device (preset connectivity)
        • Generic LoRa device (programmable)
        • Generic M2M device
        • Generic M2M device (with Internet connection)
      • Trackers
        • KPN Global Tracker Autonomous
        • KPN Global Tracker Wired
        • KPN LocationTag I
        • KPN LocationTag II
        • KPN LocationTag II v2
        • KPN LocationTag II v2 Expert Mode
        • KPN LocationTag II v3
        • KPN LocationTag III (with GPS)
        • KPN LocationTag III (without GPS)
        • KPN LocationTag III v2
        • KPN LocationTag III v2 Buffer
        • KPN LocationTag III v3
        • KPN LocationTag III v4
        • KPN LocationTag V
        • KPN LocationTag VI
        • KPN LocationTag WS
        • Streamline LoRa
        • Streamline M2M
        • Viloc
      • Routers
      • Gateways
        • KPN FSK Basestation
      • Device SDK
    • Connectivity
      • Connecting LoRa devices
        • LoRa connectivity configuration
      • Connecting M2M devices
      • Connecting Internet devices
      • Connecting MQTT Devices
    • Data Processing
      • ThingsML and SenML
        • ThingsML
        • SenML
          • Understanding and Interpreting SenML Data
          • Changes in KPN SenML
      • Device Twin
      • Decoders and encoders
        • Common measurements list
        • Decoder migrations
        • DIY Decoder
          • DIY decoder scripts
      • Merger
      • Device data
      • Devices
    • Destinations
      • HTTPS destination
      • MQTT broker
      • Cumulocity IoT Platform
      • Azure Event Hubs
      • Azure IoT Hub
      • Test Endpoint
      • ThingsBoard
      • Datacake
      • AWS Lambda
      • Google Cloud Run functions
  • IOT LINE UP
    • Freemium
      • Test SIM cards
    • Explorer
    • Modular
    • Tailored
    • Terms and Conditions
Powered by GitBook

© 2024 KPN - All rights reserved.

On this page
  • Data Processing
  • Uplink data, processed by Decoders
  • Downlink instructions, processed by Encoders
  • Flows
  • Flow overview page
  • Flow detail page
  • Devices in Flow page
  • Add Device to Flow
  • Data Processing in Flow page
  • Destinations in Flow page
  • Add Destination to Flow

Was this helpful?

Export as PDF
  1. BUILDING BLOCKS
PreviousConnecting MQTT DevicesNextThingsML and SenML

Last updated 5 months ago

Was this helpful?

Data Processing

Data Processing is the core of the KPN Things platform. Both in uplink and downlink communication it links the devices to the destinations and vise versa. It makes information from raw data, and translates universal instructions into device specific commands.

Data Processing can be configured on the Data Processing in Flow page.

Data Processing configuration is configured in a Flow. It expresses how data from and to your Devices should be processed by KPN Things. This processing is useful, because your Destination does not always understand what your Device is saying, and vice versa. This data should be transformed or interpreted between your Device and Destination.

We distinguish two type of actors that process data:

  • Decoders process data coming from your device (uplink data).

  • Encoders process data going to your device (downlink data).

Uplink data is processed by Decoders, Downlink data is processed by Encoders.

Uplink data, processed by Decoders

Uplink data configuration has to do with the data sent from your Device and possible metadata coming along when data is sent by your Device. An example of the latter is LoRa Geolocation data; location data that the LoRa network can determine when receiving the message from your Device.

We distinguish three types of data that can be enabled to forward to your Destination. Each type has its own symbol that is used in the name of the Decoder.

Symbol

Output data type

›

Decoded data, so incoming encoded data transformed into understandable measurements in SenML format.

+

Additional data (decoders) enabling metadata corresponding to the message send by your Device.

=

Raw data, just forwarding data like it is received by KPN Things.

Downlink instructions, processed by Encoders

Downlink data configuration has to do with the data sent to your Device. Often you want to send a clear instruction to your Device, which is transformed under water into a technical data message to your Device. This is where Encoders come into play. Next to that, also raw data can be sent to your Device.

We distinguish two different ways of sending data to your Device, identified by a symbol in the name of the Encoder.

Flows

Within a Flow you configure the way your IoT data should flow through KPN Things. You link one or more Devices to one or more Destinations through the Flow, and you determine the Data Processing in between. So, if data is received from a Device that is linked to a Flow, its data will be processed as configured and then forwarded to the Destinations that are linked to the same Flow.

A Flow has the following attributes:

  • UUID - the technical identifier of your Flow.

  • Name - the name you give to your Flow.

  • Description (optional) - further explanation of your Flow.

Flow overview page

This page gives you an overview of the configuration of a Flow.

It shows you:

  1. The name and description of your Flow.

  2. Removed. The configuration of Device Twin values has been removed in favor of showing all possibles values by default.

  3. The number of Destinations in your Flow and a smart link to the Destinations in your Flow.

  4. A delete button to remove your Flow. All Devices and Destinations that were linked to the Flow will not be deleted, they can still be found on the All Devices page and All Destinations page respectively after you deleted your Flow.

Warning labels

If there is an issue with the configuration of your Flow, a warning icon is shown in the description of the concerning part of the configuration. Click on the warning label to find out more about the issue.

Smart links

The smart link allows you to quickly get to the Devices and Destinations in your Flow from the overview page. Depending on the number of Devices or Destinations you have in your Flow, the card will link you to a different view:

Flow detail page

The Flow detail page shows the details of your Flow (#1 in the screenshot) and it allows you to edit the name and description of your Flow by clicking Edit (#2 in the screenshot).

Devices in Flow page

This page shows you the Devices that are linked to the current Flow.

Elements on this page are:

  1. The number of Devices in the current Flow.

  2. The list of devices, showing their name, device type and last message time.

    1. When you click on a table row, you are sent to the Device detail page of the selected Device.

    2. You can sort the Device list by clicking on the column header you want to sort by.

  3. A button to add another Device to this Flow.

  4. Checkboxes that allow you to start bulk actions.

Bulk editing

After selecting one or more Devices you enter the bulk editing mode. This allows you to select several Devices (#1 in the screenshot below) or all Devices at once (#2 in the screenshot below). After you completed your selection, click on the desired action in the bulk action bar in the bottom of your screen. In this case, you can Unlink all selected Devices from the current Flow.

Add Device to Flow

When you have reached the maximum number of unique devices in your Project, you will not be able to add another device to your Flow. The Add Device button will then be grey and disabled.

Also, it can occur that you have reached the total maximal amount of Devices in your account. Then you can only link an existing Device to your Flow, you cannot add a new Device. In that case the Add a new Device button will be grey and disabled.

When adding another Device to a Flow, you have two choices:

  1. Add a new Device - register a complete new device to KPN Things and directly add it to the Flow.

  2. Link an existing Device - link a device that is already registered to KPN Things. You can add one Device to multiple Flows.

Add a new Device

This page is identical to the Add new Device page coming from the All Devices page, with the additional step of Decoder activation.

At this step you can select the decoders you want to enable for this device type in the current Flow by checking the corresponding decoder (like #1 in the screenshot above). If you have previously activated decoders on this Flow for this Device type, they will be already checked (like #2 in the screenshot above). Learn more about Decoders.

Link an existing Device

This page will show you an overview of all Devices already linked to your Flow and other available Devices. There are two methods to link existing Devices to a Flow:

  1. By clicking Link on the row of a Device, you link that single Device to the Flow.

  2. By selecting a checkbox in a row of a Device, you start with linking multiple Devices to the Flow.

Link multiple Device to the Flow

After selecting one Device you can select more using the checkboxes (#1 in the screenshot below), or even select all Devices you have using the checkbox in the top row (#2 in the screenshot below). When you finalized your selection you can commit the linkage with the button Link selected (#3 in the screenshot below).

Data Processing in Flow page

The Data Processing in Flow page shows you the configuration of the data processing for Devices in that Flow.

When you visit the page, it first shows you the Device types that are present in the Flow. For each Device type it shows the number of devices linked to the Flow (#1 in the screenshot below), and the number of Decoders and Encoders enabled for that Device type (#2 in the screenshot below.

After you clicked on one of the Device types, all available Decoders (#1 in the screenshot below) and Encoders (#2 in the screenshot below) are shown for that Device type. The toggles to the right of the list (#3 in the screenshot below) indicate whether a Decoder or Encoder is enabled for that Flow. Learn more about Data Processing configuration

Warning labels

If there is a possible issue with your data processing configuration, a warning icon is shown for the concerning Device type (#1 in the screenshot below) and a warning message is shown explaining the issue (#2 in the screenshot below). We offer three possible solutions for the issue:

  • Show you where to fix the issue (#3 in the screenshot below)

  • Fix it for you (#4 in the screenshot below)

  • Let you ignore the warning (#5 in the screenshot below)

Destinations in Flow page

This page shows you the Destinations linked to the current Flow.

On this page you can see:

  1. The number of Destinations in the current Flow.

  2. A list of the Destinations in this Flow with their name, status and type. By clicking on a Destination, you will go to the Destination detail page of the selected Destination.

  3. A button to add another Destination to your Flow. If you have reached the maximum number of Destination links in your Project, this button will be disabled.

Add Destination to Flow

When you have reached the maximum number of Destination links in your Project, you will not be able to add another Destination to your Flow. The Add Destination button will then be grey and disabled.

Also, it can occur that you have reached the total maximal amount of Devices in your account. Then you can only link an existing Destination to your Flow, you cannot add a new Device. In that case the Create a new Destination option will not be available in the drop down.

When adding a Destination to a Flow, you have two options, as illustrated in the screenshot above:

  1. Create a new Destination

  2. Select an existing Destination to link to your Flow

Create a new Destination

This page is identical to the Add new Destination page coming from the All Destinations page.

Link existing Destination

After selecting the desired Destination in the drop down menu, click Add Destination to link the selected Destination to your Flow.

A link to the , where you can edit the name and description of your Flow.

The number of Devices in your Flow and a to the Devices in your Flow.

A summary of the Data Processing in your Flow and a link to the .

Flow detail page
smart link
Data Processing in Flow page
Data decoders
Additional data
Raw data
Warning in Data Processing
0 objects: links you to the page to add a Device or Destination.
1 object: links you directly to the details of the linked Device.
2 or more objects: links you to the Devices or Destinations in Flow page.
Page cover image