Our KPN Things platform is your environment to start working on IoT Solutions and manage in a single environment. This guide will help you get started. Before we dive in, make sure you have a subscription and you're able to sign in.

Account types

There are two types of accounts. For both types the authentication is managed in our GRIP platform developed by KPN. This provides you with a secure and easy access to your KPN applications. With the GRIP portal you can manage your subscriptions and perform user management.

KPN Things Freemium

Once you have registered you have a developer account. With this account you get a Freemium project. Here you can test LoRa and M2M connectivity for a limited number of devices for free.

Let's get started

Create your Freemium KPN Things Portal account

Follow our step-by-step guide to further set up the environment.

KPN Things Explorer

You can easily upgrade this registration to a paid subscription later. This is our low threshold Explorer solution and suitable for even a couple of devices.

KPN Things Modular

An account will be created for you and you will receive an email to create a password. This is out dynamic solutions based on standard building blocks suitable for high-volumes.

KPN Things or Tailored

Accounts will be created for you and you will receive an email to create a password. This is our customized connectivity focussed solutions suitable for high-volumes.

Want to learn more about our propositions

KPN Things is available in four distinct propositions.

Freemium

Experience the core functionalities

Explorer

Expand your connectivity and grow your solution

Modular

Build a solution using standard building blocks

Tailored

For customized connectivity focussed solutions

We are happy to help you on your way as best as possible. Nothing is more fun than seeing a visible result in your account quick. Follow our tutorials to get of to a good start.

KPN Things supports a wide range of IoT devices out of the box. However, if your project uses devices that are not yet supported, you can define your own private device types and decoders within Things Creator. Once created, these custom device types and decoders will be available across all of your projects.

To access Things Creator, log in to the KPN Things Portal and select Things Creator from the top navigation menu. If this option is not visible, you do not have the required permissions. Access is managed via roles in KPN Grip; please contact your Grip tenant administrator to request access.

The Things Creator includes the following menu items

Device Types

Add and configure custom device types.

Decoders

Manage payload decoders for your custom device types.

Destination Formats

Add and configure custom data formats if your destinations require an alternative to SenML.

Getting Started

To start using the API, you will need to:

• Obtain an access token to authenticate requests.

• Learn how to navigate error handling, pagination, filtering and sorting to efficiently retrieve data.

See the Getting Started guide for details.

Resources:

The API is organized around key resources. Each resource has its own dedicated reference page generated from the OpenAPI specification:

• Connector Bindings

• Devices

• Device Groups

• Downlinks

• Firmwares

• Projects

Additional information

• Getting Started (authentication, pagination, filtering, sorting)

• Beta API (Deprecated)

SSL certificate information

The SSL server certificates of KPN Things and GRIP are signed by Sectigo and Certsign respectively.

Both certificate providers are trusted by default by most operating systems. If required for your security implementation, all certificate files of the chain can be downloaded here:

• Sectigo R46 root CA: https://crt.sh/?d=4256644734

• Sectigo R36 intermediate CA: https://crt.sh/?d=4267304690

• certSIGN ROOT CA G2: https://crl.certsign.ro/certsign-rootg2.crt

• certSIGN Public Web CA: https://crl.certsign.ro/certsign-webca.crt

All KPN services use the GRIP authentication solution. As of 16 April two-factor authentication (2FA) is enabled for all Freemium and Explorer users. For other customers, this will be enabled as the default at a later stage; however, they can already activate it themselves. On this page, you can read how to manage the settings for two-factor authentication. Changes made to authentication settings will apply to all users.

How to manage 2FA

These settings can be adjusted by an admin user in the GRIP portal. Go to the GRIP portal or go in the Things Portal to the Organization tab, the Users page and click 'Edit roles':

1. Go to Directories in the menu

2. Select the GRIP directory

3. Open the Authentication tab

You are now in the Authentication settings of your GRIP environment.

Standard setting (for Freemium and Explorer)

Scroll down in the Authentication menu to find the Authentication Level settings.

1. The Required Authentication Level score determines the points you need to reach before you can log in successfully. The standard setting is 30 points.

2. Credentials (username/password) provide 20 points. Additionally, 10 (extra) points can be obtained with verification via SMS or Email.

3. The verification method Passkey provides the user with 30 points,once the Passkey has been created.

Activate two-factor authentication (for other customers)

After you logged in to the GRIP portal and followed the steps as mentioned at How to manage 2FA, scroll down in the Authentication menu to find the Authentication Level settings.

Adjust the settings for the Required Authentication Level and set the Authentication points for SMS and Email.

Two Factor login

The login interface for all users has been updated. After filling in your credentials (username and password) you can choose your preferred option to log in successfully.

The Contact info page provides you with all methods to contact us for questions and in case of an incident.

1. Click on Contact info in the menu to see all options to get in touch with us

2. We will always be there to help you, contact us if you have any questions

3. Support methods avaible for Modular and Tailored subscriptions

The documents page provides you with documentation and manuals about our services.

1. Click on Knowledge Base in the menu for an overview of the available documentation

2. The highlighted documents contain important information and are shown in tiles

3. All other documentations about a topic are listed below the tiles

4. Every header indicates another topic, scroll down to check for more subjects

5. Use the search field to look for specific topics

6. This online KPN Things User Guide can be accessed through this link

The Service reports page provides in an overview of the availability of our service per month.

1. Click on SLA Reports in the menu for an overview of the availability of our services

2. Click on the calendar icon to choose another month to see report history

3. Click on the info icon for a brief explanation of the key performance indicator (KPI)

4. Click on a specific service for more report details on performance history

5. Shows the service level of a specific service for the selected month

Report details

The report details show more report details on performance history.

1. Choose a from date and to date to present the graphs for a certain period

2. The KPI Value is the measurement of an availability for the specific month

3. The KPI Norm is the standard we strive for and use as minimum availability standard

4. Click SLA Report overview to go back to the Service reports page

The Flows tab provides a visual and interactive overview of the complete data flow of your device. This view is designed to give you immediate insight into how data from your IoT device is processed and routed. You find this tab on the Device & Connectivity detail page.

What you see in the Flows tab

The schematic overview shows the following components of the flow:

• Device: your IoT device sending data

• Decoders: Convert the raw payload from the device into readable data

• Encoders: Translate the data into a specific format for the Destination

• Destinations: The endpoints where the data is sent, such as a webhook, MQTT broker, or cloud platform

The components are visually connected, allowing you to see at a glance how the flow is structured and if/how each element is linked.

Interactive editing

The Flows tab is not just a visual representation, it is also an editable interface. You can:

• Enable or disable components using toggle switches

• Edit components by clicking on the link, which takes you directly to the configuration page

• Remove a link, for example the Destination, by clicking the 'X' in the link

Error detection and warnings

If something goes wrong in the flow the affected component will be highlighted in orange. The visual cue helps you quickly identify where the issue lies. Clicking in the highlighted component (i) provides more details about the problem and suggestions how to fix it. The links in the highlighted component brings you to the configuration page, so you can fix it right away.

Examples of possible issues are:

• A required decoder is disabled or missing

• A destination is missing or misconfigured

• There's an incompatability between components

The Things Manager includes the following menu items

Projects

Select the project you want to work to show only the information relevant to that project

IoT Devices

Add and configure new devices, monitor device status, manage device settings, process and interpret data from devices

Connectivity

Manage and control your connectivity for your IoT solutions across all connectivity options

Processing

Select the data processing options for your data flow and organize your decoders and encoders

Destinations

Connect your IoT data to the location where you want to use it using our destinations options

Activity

Track the status and progress of your activities and verify that everything has been processed correctly

Requests for a new APN or changes to an existing APN must be submitted via a Standard Change Request (SCR) in ServiceNow. The form below must be filled in and attached to the request.

When you open Things Manager, you’ll start with an overview of your projects. The first step is to select the project you want to work with.

We’ll show you how this works

Project overview

Once you select the desired project, the Project Picker field will automatically display the project name (see image below).

You are now on the Project Overview page. Here you can view everything included in this project, including the contract linked to it.

Contract

To view the contract, first enable access by assigning the Finance Read-only role to your users in GRIP.

Need help managing your users in GRIP? Go to User Management.

Contract details

You are now on the Contract Details page.

This page is divided into several sections. First, you’ll see Base Details. This section shows key information about the contract, including the contract type and activation date.

Under Implementation, you’ll see the project linked to the contract.

Next, you’ll find the different items included in the contract. Items and discounts are shown by charge type: recurring, one-time, or usage. These items are grouped by product family. The regular price for each item appears in the Unit Price column next to the bold item name.

If applicable, optional tiered discounts are listed below the corresponding row. The actual discount depends on the quantity, with the applicable range shown in the From and To columns. These columns only appear if the contract includes at least one item with tiered discounts.

Users with an Explorer or Modular contract can view their contract and costs per billing cycle in the KPN Things Portal. To view the costs and contract, enable access by assigning the Finance Read-only role to your users in GRIP. See Roles and Access Levels on the Customer accounts & users page.

Starting point

To see an overview of the costs per billing cycle, click on your Customer name in the menu on the left. The Account card shows an item called Costs overview, if at least one of your projects has an Explorer or Modular contract.

Costs overview

Click on the item Costs overview to navigate to the Costs Overview page. This page shows the costs that will appear on your invoices, presented in both a table and a chart. The costs are categorized by type; recurring costs, usage-based costs and one time costs (such as hardware). Any applicable discounts are already subtracted from the displayed amounts.

Costs details

Click on a row in the Costs table or on one of the bars in the chart to navigate to the Cost Details page for that billing cycle.

Under Base details information about the billing cycle, the rating period and the contract is shown. The items and discounts are shown under Items. The costs for the current month are a forecast of the upcoming invoice and are updated periodically throughout the billing cycle. Please not that the actual invoice may include additional costs and/or discounts that are not visible on this page. You can find all your previous invoices in MijnKPN Zakelijk.

The Previous and Next buttons above the card on the right allow you to navigate to the previous or next billing cycle.

Contract

To view your contract, go to the Project Overview page. To do this, click on the company name in the menu and then on the desired (Explorer of Modular) project. There you will see an item with the name of the contract.

Contract details

Click on the contract line to navigate to the Contract Details. Under Base details information about the contract, contract type and the activation date is shown.

Under Implementation, the project to which the contract is linked is shown. Items and discounts are shown per charge type, which can be recurring, one time or usage. These items are then grouped per product family. The regular price of each item is shown in the Unit price column of each row with a bold item name. If applicable, optional tiered discounts are shown below the corresponding row. The actual discount depends on the quantity, with the applicable range shown in the From and To columns . These columns are only visible if the contract includes at least one item with tiered discounts.

All downlink communication is requested on and managed by the Actuator API. Optionally a Destination can request and manage downlink communication as well. See Destination types to learn which destinations can support downlink communication.

After a downlink is requested on the Actuator API it is encoded. Meaning the downlink is translated to a message the device will understand. After encoding the downlink is send over the selected network to your device.

The network (and the device) will report feedback about the delivery of the downlink to the Actuator API. This information can be retrieved by the application, or the Things Connector fetches this information into your system.

Actuator API

Using the KPN Things Portal, you can request downlinks, and check their progress.

Since December 2020 it is also possible to directly call the Actuator API. Head on over to the API access documentation for more information!

Encoder

Using our encoders the downlink request is translated to a device specific message. All available encoders are listed on the Supported devices page.

Network support

Currently the following networks are supported for downlink communication:

• LoRa downlink

• HTTP response downlink for M2M devices

• HTTP response downlink for Internet-connected devices

Downlink via Destinations

Some Destination types also support sending downlinks.

My Organization

Organization details

On this page, you’ll find an overview of the company details linked to your account and the number of existing user profiles. Additionally, you can navigate from here to the Costs Overview to gain insight into expenses per billing cycle (if you have the necessary permissions).

Costs overview

Users with an Explorer or Modular contract can view their costs per billing cycle in the KPN Things Portal. To view the costs overview, enable access by assigning the Finance Read-only role to your users in GRIP. If you need help with how manage your users, check the next page.

Starting point

The Organization details card shows an item called Costs overview (as shown in the image above), if at least one of your projects has an Explorer or Modular contract.

Costs overview

Click on the item Costs overview to navigate to the Costs Overview page. This page shows the costs that will appear on your invoices, presented in both a table and a chart. The costs are categorized by type; recurring costs, usage-based costs and one time costs (such as hardware). Any applicable discounts are already subtracted from the displayed amounts.

Costs details

Click on a row in the Costs table or on one of the bars in the chart to navigate to the Cost Details page for that billing cycle.

Under Base details information about the billing cycle, the rating period and the contract is shown. The items and discounts are shown under Items. The costs for the current month are a forecast of the upcoming invoice and are updated periodically throughout the billing cycle. Please not that the actual invoice may include additional costs and/or discounts that are not visible on this page. You can find all your previous invoices in MijnKPN Zakelijk.

The Previous and Next buttons above the card on the right allow you to navigate to the previous or next billing cycle.

Users

On this page, you will find an overview of the users under this account. Insight into the user details and which roles have been assigned to the user.

KPN Things Data Management is a data processing platform that enables you to connect all your KPN Things devices to all supported destinations through one standard way of data processing. This principle is visualized in the diagram below:

Device support

Read more on device support:

Network support

KPN Things Data Management supports multiple forms of connectivity to receive data from devices. When you have a KPN Things device it is already configured to work with KPN Things Data Management.

Read more on connectivity support here:

Processing

Decode

During the optional decoding phase the device specific data protocol is transformed to the universal language of SenML. This is called decoding. Decoding for KPN Things devices and custom devices that use the KPN Things client libraries is taken care of automatically. Therefor there is automatic compatibility with the enrichment phase.

Enrich

In future releases KPN will introduce data enrichment functionality in KPN Things Data Management.

Destination support

After processing your data will be forwarded to one or more Destinations you have configured.

The support page provides access to all service related items. Here you can submit a request for information of report a service disruption.

1. These support items are available for everyone

2. Support tooling avaible for Modular and Tailored subscriptions

3. We will always be there to help you, contact us if you have any questions

Contact Support

When support is needed, click on the Contact Support tile. This opens the General inquiries form.

The Release Notes page provides you with all new features and items we fixed or improved.

1. Click on the Release Notes links on the News page

1. All releases come with a version number as reference in case you have questions

2. The items of changes and fixes in the according release are stated below every version number

3. This is the date the article is published

4. Use the search field to look for specific topics

5. In case Cisco Control Center is used you have the option to select for Release notes Cisco to see the information related to the platform

Follow the steps to create your Freemium account.

If your IoT devices are not supported by KPN Things out of the box, you can easily integrate them by defining a custom Device Type and creating a Decoder to parse their incoming payloads.

Step 1: Manage Custom Device Types

Create a New Device Type

1. From the Things Creator menu, click All Device Types.

2. Click Add new Device Type.

3. Fill in the required details, such as Name, Description, and any specific properties.

4. Click Add Device Type to save.

Once created, this custom device type will immediately become available in the Things Manager when adding new devices to your projects.

Edit or Delete a Device Type

If you need to make changes, navigate to All Device Types, select the device type from the list, and click Edit or Delete on its details page.

Step 2: Create and Test a Decoder

Decoders translate raw, device-specific payload data into a structured format. You can create multiple decoders for a single device type.

Create a New Decoder

1. From the Things Creator menu, click All Decoders.

2. Click Add new Decoder.

3. Select your custom device type from the drop-down menu.

4. Enter a Name and Description for the decoder, then click Add Decoder.

Write and Test the Decoder Script

1. On the decoder details page, locate the Script section and click Create.

2. Write your JavaScript parsing logic in the provided editor.

3. To test your script, use the built-in test payload section. You can use the provided sample payloads or paste your own raw device payload.

4. Click Run script with test payload to review the output and logs.

5. Once your script is validating data correctly, click Save.

For advanced guidance on writing decoder logic, please refer to the DIY Decoder Scripts Documentation.

Edit or Delete a Decoder Script

To update a script, open the decoder's details page and click Edit. Make your adjustments and click Save. If you wish to remove the script entirely, click Delete within the edit dialog.

Step 3: Activate the Decoder in Your Flow

After creating your device type and writing its decoder, you must activate the decoder within your project's data flow using the Things Manager application.

1. Open the Things Manager and navigate to your project.

2. Select the specific Flow where your custom devices are active.

3. Click on Data Processing.

4. Locate your custom device type in the list and toggle on the decoder you wish to use.

• Green bordered blocks are objects provided to you.

• Green filled blocks are objects you can create and manage.

• Grey bordered blocks are objects globally managed by the system.

Customer

If you have an account on KPN Things Data Management, it belongs to a Customer account. All main objects in the KPN Things Data Management belong to a Customer: Projects, Devices, Destination and Network subscriptions.

A Network subscription contains information for network types for a specific client. Learn more about connectivity types.

Project

Each Project defines a solution you buy or build in KPN Things. Learn more about Projects.

Flow

With a Flow you link one or more devices to one or more plugs. So, if data is received from a device in a device group, its data will be forwarded to the plugs that are in the same device group.

A project has one or multiple activated decoders and encoders. These decoders prescribe which decoders should be used when data is received by a device that is in a device group that belongs to this project. Learn more about Flows.

Device

A Device represents a single physical device that can send data to the platform. When creating a device you tell the system the device specification it belongs to.

A Device specification has one or multiple supported network types. For all our supported device types, go to Devices.

For a device, you can create a Network info for each supported network type of the given device specification.

Destination

A Destination allows you to forward the data from your devices to an external system. For detailed information go to Destinations.

Now your Device is linked to the Flow!

With a Flow you configure the way your IoT data should flow through KPN Things, from device to destination. Learn more about Flows.

1. Your first Flow

We have already created a first empty flow for you named My first flow. You can create new flows using the Add flow button on the top right.

2. Link Device to Flow

Click on Add Devices in the Flow overview page.

Now you see all Devices you can add to this Flow. Click on your Device to link it to the Flow.

Now your Device is linked to the Flow!

3. Activate a Decoder

Open your Project, open your Flow, and then click Data Processing.

Click on the Device type for which you want to activate a decoder (#1 in the screenshot below). At this moment you probably have only one type of device linked to the Flow, so open that one. All available decoders are now shown (#2 in the screenshot below).

Here you can toggle on and off what (decoded) data you want to receive in your application (like indicated with #3 in the screenshot below). If you want to know more about the decoder, click on the link in the description.

Note that the "Add new Decoder" button and "Edit" button are only visibleif this is your own device type. Own Device Types and Decoders can be created using the Things Creator app.

KPN Things offers flexible building blocks with which you can easily build complete IoT solutions. You can build a solution for virtually any use case. Do you want to know how full a waste container is, or where it is physically located? You can connect your Solution with our KPN Things platform.

Building blocks are available for each part of the chain that can easily be used together.

Thanks to standard connections, you can also use your own Device or Data platform. And with the KPN Things Portal, you have full control over your solutions.

KPN Things Portal Introduction

Learn why we built Things Portal and how it will benefit your IoT business

Quick reference instructional videos

For a kickstart, watch our instructional videos. They say more than a thousand words!

Look for the icon in the menu for more Quick reference videos.

This page explains about Getting started by creating an account and logging in for the first time.

Flexible Building Blocks

KPN Things offers you a flexible package of building blocks that you put together yourself. This allows you to set up and manage all your IoT solutions quickly and easily. You manage these building blocks in our KPN Things Portal.

Device Management

With KPN Things Device Management you have the insights and control over all your devices. ​

• Manage all your devices in one overview - From sensors to complex IP gateways and routers

• Device Twin - Insight in the status of every device

• Bulk actions - Manage solutions in bulk to control solution of any size​

• Firmware over the air - Update your devices remotely

Connectivity Management

Manage all your LoRa, LTE-M and M2M connectivity in a single platform.

• All your connectivity in one view - Manage LoRa, LTE-M and M2M connectivity in one view

• Manage connectivity for your device - Provide your devices with a connection

• Extensive network information - Have insights in your solutions all the time

• HTTP and MQTT protocols for M2M devices - You decide how to connect your devices

Destinations

A seamless integration of IoT data with any platform for maximum value.

• Platform Independence - Easily connect any data platform to the KPN Things environment, regardless of which platform you use or want to use

• Easy-to-Use Tools - We provide simple tools and extensive documentation to help customers create links and modify data.

• Extensive Functionalities - Access to a wide range of functionalities and additional services, allowing customers to use a platform that directly suits their specific use case

Customer and User Management

Provide your customers and users with a easy access to IoT solutions.

• Customer Management ​​- Manage IoT solutions of your customers

• Data Segregation - We provide in secure separation of data between your customers

• Customer Insight Overview - Have an overview of the different IoT solutions per customer

• Self Service - Provide your customers access to the Things Portal to manage their own solutions

• User Management - ​​Decide which users have access and to what functionality

Our KPN Things Device Simulator Web app allows you to test KPN Things with your own mobile phone/laptop as a device. If you do not yet have a suitable device, you can use the Web app to still build a working data flow.

Features

• Mobile/laptop as a device - Easily add the Web app as a Device in your KPN Things account.

• Choose sensors - The app allows you to choose which metrics to use as Device data.

Add the Device Simulator Web app

Follow the steps to add the Device Simulator Web app as a device.

1

Register your Web app in KPN Things

On your computer go to the KPN Things portal.

1. Click on Devices to show the device overview on the Things Manager tab

2. Click on Add new Device to add the Device Simulator

1. Click on Device Simulator Web app

2. Give your device a recognizable name

3. You can add a description, this is useful when you have multiple devices and want to provide context. This is not a mandatory field.

4. Click Add Device to finish this step

2

Open the Device Simulator Web app

You can open the Device Simulator Web app in three ways:

1. In your internetbrowser on your computer or laptop

2. On your phone with the QR code

3. Share the URL and open the Device Simulator Web app

3

Send your first measurement

Select which measurements you want to be send.

1. Click the corresponding checkboxes by selecting or deselecting to choose measurements

2. Click Send data now to send your first measurement

4

Check the incoming message

In KPN Things portal refresh the page. You now see a value next to Last message, indicating that the measurement is recieved from your Device simulator app.

5

Ready to build your data flow

You are now ready to setup your first data Flow in KPN Things.

Or connect your own test devices with our other device templates.

KPN Things Portal Introduction

Learn why we built Things Portal and how it will benefit your IoT Business

User interface

This video explains how the User Interface and main navigation works.

Tables

This video explains how Tables work.

Bulk by multiselect

This video explains how Bulk by multiselect works in the User Interface.

Bulk by file

This video explains how Bulk by file works in the User Interface.

You can use KPN Things Destinations to forward your device data to any supported platform or destination. The tool Webhook.site is used for this tutorial. Although we have good experience with this tool, KPN is not responsible for the proper working of the tool.

1. Create test HTTPS endpoint

Go to https://webhook.site. Webhook.site is a service with which you can easily inspect incoming HTTP requests. When vising the site it will automatically create a unique HTTPS endpoint for you. Use the Copy to clipboard button that is highlighted in the screenshot below to copy the URL of your new endpoint.

2. Create your first Destination

Go to the Flows > My first flow and click Link destination

Choose Create a new Destination.

Select HTTPS endpoint as destination type.

3. Fill in your Destination Information

After selecting HTTPS Endpoint, fill in the following information:

• Destination name: you can think of a good recognisable name for your first destination, like My First Destination.

• URL: this should be the URL you just copied from webhook.site.

• Shared secret: this is a kind of password that an application should use to verify that KPN Things sent the data to the endpoint. It should be at least 32 characters long and should contain at least an uppercase character, lowercase character, digit, and special character.

4. Test connection with test message

Send a test message, e.g. by using the Device simulator app. You should see incoming information on your webhook.

Congratulations! 🎉

You successfully set up your first IoT solution!

To continue learning you can continue with:

With this tutorial you will create a simple web application showing a map showing your tracked LoRa data. This runs an in-memory data store, so on restart the store will be reset and all recorded data will be lost. The application runs on Next.JS

As an optional step the IoT web application can be deployed to Azure Web App.

1. Install the IoT web application

1. Get all the files needed for this tutorial at https://github.com/kpn-iot/c3y and save these in a local folder

2. Go to the folder 'c3y' and install: npm i

3. Build: npm run build

4. Start server in production mode: npm start

5. (optional) Seed with dummy data: ./postDummyData.sh

2. Redirect your webhook to localhost

Enable XHR Redirect in your webhook (tested in Firefox & Chrome, does NOT work in Safari):

• Target: http://localhost:3000/api/lora

• Content Type: application/json

• HTTP Method: POST

3. Test connection with test message

1. Send a location message using the device simulator.

2. Go to http://localhost:3000/ and click UPDATE.

You should see the location update with the location you have sent via the device simulator.

4. (optional) Deploy as Azure web application

1. Install azcli: brew install azure-cli ((https://learn.microsoft.com/en-us/cli/azure/install-azure-cli)

2. Log into Azure, where ??? is the tenant ID from Azure Active Directory: az login --tenant ???

3. Deploy: az webapp up --sku B1 --location westeurope (takes about 5 minutes)

4. After deployment the URL is logged

5. Modify the URL in the HTTPS destination created in Connect a HTTPS destination to the URL returned by Azure CLI:[generated URL]/api/lora

6. Inspect logs: az webapp log tail

7. Open [generated URL] in the browser to see the web app

Note that for this tutorial you need to use a LoRa device.

1. Request downlink

Go to the All Devices page and click on the device you want to send a downlink to.

Open the Send Instruction tab. There you will find the input fields to send a downlink to your LoRa device:

• FPort: is the LoRa application port on which to send the data. If you don't use application ports on your device, you can just use 1.

• Payload: is the data you want to send to your device, written in hexadecimal characters. You could use for instance 010203.

Click Submit to request the downlink to be sent to the device.

2. Check status of downlink

After requesting the downlink, under Status Downlink your downlink will have appeared. Maybe you first see your downlink with the PENDING status, meaning it is still being processed, but if you hit the refresh button (#2 in the screenshot) you should see it switching to EXECUTING.

Queuing At most one downlink can be in EXECUTING at a time. When you submit more downlinks, they will stay in the PENDING state and they will be processed "first in first out". You can have at most 5 downlinks in PENDING. As long as a downlink is in PENDING mode, you can cancel it. If you do so, it will not be send anymore and the status will change to CANCELLED.

Learn more about downlink statuses. LoRa Downlinks sent through KPN Things are always Confirmed downlinks. That way we trigger an Acknowledgement (ACK) from the device in the next uplink, and with that information we can determine whether a downlink was received or not.

Click on the refresh button (#1 in the screenshot) to refresh your Data History table. There should now be an uplink record following your downlink record that contains an ACK (#2 in the screenshot).

• If the uplink containing the ACK was not received by the network, you will see your downlink is still in EXECUTING. When a next uplink is received we conclude the downlink as FAILED, since we do not know for sure whether the downlink has been received. You could state that the quality of service for downlinks through KPN Things is "at least once".

If you switch back to the Send Instruction tab, you should see that the status of your requested downlink has switched to DELIVERED. That means the acknowledgement has been received by the network.

Optional: send your data to Azure SQL

1. Check contents of the delivery

First, let us check if you received everything correctly. There should be two KPN Things SIM cards in the package.

2. Check KPN Things Portal

Then, the SIM cards should be visible in your KPN Things Portal on the All Connectivity page.

3. Obtain a Device

You now have a KPN Things SIM card in your possession, a SIM card that can be put in a programmable device to grant it direct access to KPN Things through a secure channel.

This SIM card supports connection to the following networks of KPN:

• LTE-M

• 2G

• 3G

• 4G

• 5G

Don't you have a programmable M2M Device yet? You should get one! We have some tips for you:

1. We have the most elaborate documentation on getting the SODAQ SARA AFF R412M to work with KPN Things, so getting such a device will provide you the best getting started guide that we have.

2. Other SODAQ SARA devices, like the SFF R412M or devices with a different modem should also work with our developer kit guide. You should only take into account some different settings.

   • For instance for SARA SFF devices, you should use Board type SODAQ SFF.

3. Our Device SDK also contains example code for the Arduino MKR GSM 1400, laying the basics for all Arduino based M2M devices.

4. If you want to use non-Arduino based devices, you would need to write your own code to interface with KPN Things. This M2M interface is explained in the Things M2M documentation.

For more information about the devices that are supported in Things portal head over to IoT devices. Would you like to add your own device, head over to the Things Creator section.

1. Add new Device

Head to the Devices in the left menu. Click the Add new device button in the left top corner. This is the place where you register new Devices and add them to KPN Things and our networks.

If you have more than one Project, you will have to select to which Project you would like to add your Device.

2. Select your Device type

You can select an existing device-type offered by KPN Things, or create a new device type using the Things Creator app.

3. Fill in Device Information

• Name: Typically can be a Device ID or the name of a physical asset which the device is linked to.

• Barcode (optional): Barcode or serial number used to identify a device.

• Description (optional): Any additional device information.

When done, click Add Device to continue.

4. Provide or get Network information

This step will look differently, depending on the type of network information.

• Generated LoRa network information (programmable device)

• Provided LoRa network information (device with preset connectivity)

• M2M network information

• Internet network information

Generated LoRa network information (programmable device)

If you selected Own LoRa device (programmable) device type in the previous step, the Portal will give you the OTAA join information (DevEUI, AppEUI and AppKey). Make sure to copy-paste or write down the provided identifiers. For security reasons the secret values will not be retrievable through the Portal after closing this page.

Click Finish to continue.

Provided LoRa network information (device with preset connectivity)

If you selected Own LoRa device (preset connectivity) or a supported device type, you should provide the LoRa network information for your device in this step.

Click Add network info to save the network information and then Finish to continue.

M2M network information

1. IMEI of your Device.

2. ICCID of your SIM-card - select the correct SIM card from the drop down. If you have an Early access SIM, you choose the option "Add early access SIM" and enter the ICCID of the SIM manually in the newly appeared input field (see A in the screenshot below).

3. Shared secret

After entering the values, click Add network info to save the information, or click Finish without adding Network to continue without adding network information to your Device object.

Internet network information

1. DvnUUID - the unique number to identify incoming data from your Device. Your Device UUID is prefilled, but you can enter any UUID you like.

2. Shared secret

5. Check incoming data in the Portal

You can visit the LoRa data or M2M data tab on your Device Detail Page in the Portal. You should see messages here as soon as the device has activity on the network.

You're ready for the next step:

The Smartrak M2M GPS tracker is a device produced by Streamline and used for demo purposes. When you push the button the device will send its location to KPN Things.

Check contents of the test device box

The first step is to check if everything is present in the box:

Contents:

• Battery (1)

• Logic board (2)

• Bottom part of the casing (3)

• Top part of the casing (4)

• KPN M2M SIM card (5)

• Wireless Charger (not shown)

1. Insert SIM and assemble device

Assemble the device

Step 1: Insert the SIM-card and write down the IMEI (1), we need that later.

Step 2: Connect the battery.

Step 3: Connect the vibration motor. This can be a bit of challenge, but you can do this. The connector has to be pushed on the terminal from above instead of sliding

Step 4: Connect the bottom part. This is the wireless charging circuit.

Step 5: Put everything together.

Step 6: Rotate the two parts as shown. The on/off button has to be on the side of the vibration motor.

Step 7: Click two parts of the casing together.

Charge the device

1. Plug in your QI charging device.

2. Place the device on the QI charging device and allow it to charge for a few hours.

3. You should hear a beep when the device starts charging.

2. Configure the device in the KPN Things Portal

Open the KPN Things Portal

Open the KPN Things Portal, and log in with the credentials you received in the mail. Go to the All Devices page and click on Add new Device.

Fill in your device information

1. Select the Streamline M2M device device type

2. Enter a name for your test device

3. Click Add Device to continue

Provide Network Information

Now enter the Streamline M2M specific information of your Device.​‌

1. IMEI of your Device. This value is printed on the logic board. If you followed the assembly instructions in step 1, you have written this value down.

2. ICCID of your SIM card. This value is printed on your SIM card. Select the correct SIM card from the drop down.‌

3. Click Add Network Info to save the network information and then Finish to continue.‌

If you want, you can learn more about M2M in KPN Things.

Check incoming data in the Portal

Push the button on the device and it will send its location to KPN Things! After the push the LEDs start blinking:

1. Lightning icon: GPS location is being searched

2. Battery icon: Device is turned on / charging

3. Waving person icon: indicates the button is pressed

The first time after connecting the battery it can take up to 5 minutes to receive a message. If the LEDs do not start blinking try to push and hold the on / off button for 10 seconds. The battery LED in the middle should start blinking. If still nothing happens, try to charge the device for at least 2 hours.

You should now visit the Device Detail Page in the Portal of this Device. In the connectivity block, you should see that the last message time indicates that KPN Things just received a message from your Device!

Continue to the next step:

This is an old development board which is no longer available for purchase and should not be used for new designs.

The LoPy4 is a quadruple bearer MicroPython enabled development board (LoRa, Sigfox, WiFi, Bluetooth) perfect enterprise grade IoT platform for your connected Things. With the latest Espressif chipset the LoPy4 offers a perfect combination of power, friendliness and flexibility.

1. Setup your LoPy4 device

Use the getting started from the Pycom documentation to get started with your LoPy4. Make sure you setup both the hardware and software. You should be able to program the module when continuing this getting started.

2. Determine device identifiers

The LoPy4 is a LoRa device, and to register a LoRa-device to a network you need three values: DevEUI, AppEUI and AppKey. These values must be registered in KPN Things and in the device. For more information on these three values you can read Device Identification in the LoRa documentation.

3. Register your LoPy4 to KPN Things

Open the KPN Things Portal

Open the KPN Things Portal. Go to the All Devices page and click on Add new Device.

Fill in your device information

1. Select the Own LoRa device (preset connectivity) device type

2. Enter a name for your LoPy4

3. Click Add Device to continue

Provide Network Information

Fill in the three values you determined in the previous step Determine device identifiers. Then click Add Network Info to save the network information and then Finish to continue.

Check your newly created Device

You are now on the Device Detail Page. In the LoRa tab you will see the network status. This can temporarily be Pending creation, but if you refresh the page it should switch to Active. This means your device is correctly registered to the network.

If the network status sticks to Pending creation, you could try to delete the Device and register the device again.

5. Program your device

Use the LoRaWAN with OTAA example from Pycom to get your device connected with our LoRa network and have it send data to KPN Things.

Check incoming data in the Portal

Now your LoPy4 has joined and is sending data, you could visit the LoRa data tab on your Device Detail Page in the Portal. You should see your Join request and Join accept appear like in the screenshot below and at this point you will see more data as well.

Read more information about what you see on the LoRa Data History tab.

Setup data flow in KPN Things

You now successfully connected your LoPy5 device to KPN Things! To further setup your data flow in KPN Things, you can go to the next step:

Each company has a Customer Account. You can create multiple users within this Customer Account.

Projects describe your commercial plan and available features. One Customer Account can have multiple projects.

Manage your customers

Upon request we can create a 'Reseller account' account for you, so that you can manage IoT solutions for your customers. Learn more about Customer management

With Customer Management, you get the possibility to manage your own customers using separate customer environment in KPN Things. It is an extra administrative layer in the KPN Things Portal.

If you have Customer Management enabled in your KPN Things license, you will have an additional link in your side menu: All Customers (as indicated in the screenshot below). Click on it to open your customer list.

All Customers page

After clicking All Customers in the side menu, you will get an overview of all your customers.

In the screenshot the following elements are highlighted:

1. The number of Customers in your current view and your total number of Customers.

2. The company name of your Customer.

3. The name of the primary contact of your Customer.

4. The number of Projects your Customer has.

5. The number of Devices your Customer has.

6. The number of Destinations your Customer has.

7. A quick link to the All Devices page of your Customer.

8. Clicking on a row in the table will direct you to the Customer details page of the selected Customer.

9. A search bar to search for a specific Customer name.

Switching to Customer environment

After opening one of your Customers, your submenu will change. The top part will stay the same and will provide you a way back to your own Customer environment (#1 in the screenshot below). The bottom part of the side menu will now show you navigation for the environment of your Customer (#2 in the screenshot below), allowing you to open and/or manage the objects in the environment of your Customer.

Add new Customer

Adding new Customers will be added later. For now, if you want to add a new Customer, you should contact our service desk.

Customer overview

The Customer overview page provides you with a quick overview of the environment of your customer.

On this page you find:

1. A summary of the properties of your Customer.

2. A link to the Customer details.

3. The number of Projects of your Customer and a link to those Projects.

4. The number of Devices of your Customer and a link to those Devices.

5. The number of Destinations of your Customer and a link to those Destinations.

6. Quick links to add new objects to your Customer (buttons are disabled if you do not have rights)

Customer details

After switching to the Customer environment, you see the Customer details page. This page gives you a quick overview of the Customer details, like name and email address.

Latest releases

Release 01-10-2026: Download Activation codes

We have added a new 'Bulk by CSV file' action to the connectivity page. You can now use this action to generate and download activation codes for one or more eSIM profiles in a single operation.

For more information, go to Download Activation codes.

Release 24-06-2026: eSIM connectivity configuration

We have introduced a new connectivity page, the eSIM connectivity page. Through this page, you can manage eSIM connectivity profiles and we explain which management options are available. This includes downloading, enabling, and/or deleting existing profiles. In addition, you will find an overview of the operations that have been performed for the respective eSIM connectivity.

For more information, go to eSIM Connectivity configuration.

User interface

This video explains how the User Interface and main navigation works.

Tables

This video explains how Tables work.

Bulk by multiselect

This video explains how Bulk by multiselect works in the User Interface.

Bulk by file

This video explains how Bulk by file works in the User Interface.

Look for the icon in the menu for more Quick reference videos.

User interface

This video explains how the User Interface and main navigation works.

Tables

This video explains how Tables work.

Bulk by multiselect

This video explains how Bulk by multiselect works in the User Interface.

Bulk by file

This video explains how Bulk by file works in the User Interface.

Managing access to your IoT services is essential for maintaining control, security and efficiency. We offer a range of IoT propositions, each designed to meet different business needs. For each service, there is a need for clear and effective user management.

User Management ensures that the right people in your organization have the appropriate access to the tools and data they need.

Tips for effective user management

• Define clear roles and responsibilities - Assign roles based on actual responsibilities. Avoid giving users more access than they need, this helps reduce security risks and keeps your environment organized.

• Regularly review User Access - Periodically check who has access to the services. Remove inactive users and adjust permissions when their roles changes.

• Train your users - Make sure users understand their roles and how to use the platform securely and effectively. A little training goes a long way in preventing mistakes.

• Ask for KPN support - If you're unsure about how to structure your user access or need help, don’t hesitate to reach out to for guidance.

Next Step

To learn more about how to manage users within your specific IoT service, please select the page that matches your KPN IoT solution. Each section provides tailored guidance to help you manage users effectively within your environment.

Connector Bindings define the configuration that enables a device to communicate with the Things platform through a specific connector.

While connectors provide the communication interfaces themselves, a device typically needs connector-specific settings—such as credentials, shared secrets, or protocol parameters—to authenticate and exchange uplinks or downlinks. This per-device configuration is captured in a Connector Binding.

The Things platform supports multiple binding types aligned with the available connectors:

• http for devices sending SenML or Streamline-protocol uplinks over HTTP(S)

• lora for devices using ThingPark LoRaWAN

• mqtt for devices exchanging messages via MQTT

Connector Bindings let you precisely define how each device connects and communicates through the Things platform.

Lora Bindings

Download the specification.

HTTP Bindings

Download the specification.

MQTT Bindings

Download the specification.

Download the specification

In addition to the standard create, retrieve, update, delete, and list actions, devices expose two important sub-collections.

The device-groups sub-resource allows you to view and manage the groups a device belongs to, complementing the platform’s top-level /device-groups resource.

The network-adapters sub-resource provides access to the physical connectivity interfaces of a device—such as cellular (IMEI-based), LoRa (DevEUI-based), or generic internet adapters—which determine how the device connects to the platform.

Download the specification.

Device Groups provide a way to organize and manage devices within a project. Each group represents a subset of the project’s registered devices, and a device may belong to multiple groups in the same project. Beyond simple grouping, a Device Group also defines the project’s “processing plan” for incoming device data—known as a flow in the Things Manager. A flow brings together four elements: the devices it applies to, the decoders used to interpret their uplinks, encoders used to encode downlinks, and the destinations where decoded messages are forwarded.

At present, the Device Groups API focuses on device membership, allowing you to add or remove devices from a group. Configuration of flows themselves—such as managing decoders, encoders, or destinations—remains available through the Things Manager web interface.

Downlinks are messages sent from KPN Things to a device. The API provides two main approaches to sending downlinks:

1. Actuator-style downlinks (recommended for most cases)

   • Use the /downlinks resource.

   • You provide a high-level command, and KPN Things translates it into the correct low-level protocol format using the configured encoder for your device.

   • This approach is safer and easier to use, since KPN Things handles protocol-specific details.

2. Connection-specific downlinks (advanced usage)

   • Use protocol-specific APIs such as /http/downlinks, /mqtt/downlinks, /sms/downlinks, /lora/downlinks, or /digitalmatter/downlinks.

   • You send downlink payloads in the native format of the underlying connection type.

   • This allows greater flexibility but comes with risks: you may send commands that disrupt device operation (for example, disabling communication). Use these APIs only when actuator-style downlinks do not meet your requirements.

Choosing the Right API

• Use actuator-style downlinks whenever possible. They are protocol-agnostic, simpler, and safer.

• Use connection-specific APIs if you need full control over the payload format or protocol-specific features.

Actuator-Style Downlinks

Download the /downlinks specification

HTTP Downlinks

Download the /http/downlinks specification

LoRa downlinks

Download the /lora/downlinks specification

SMS Downlinks

Download the /sms/downlinks specification

MQTT Downlinks

Download the /mqtt/downlinks specification

The Firmwares API can be used to retrieve the firmware status and to update the firmware of your devices. Read more about the Firmware Update Service.

You can use this API using your Grip API Key. Please note that not all Grip API Keys automatically have access to the Firmwares API. A firmware specific authorization is required, which must be requested from KPN via a standard Request. To do so, please contact your KPN representative.

Download the specification

Download the specification

The Devices Landing Page in the KPN Things platform provides an overview and management interface for all your registered devices.

Device Management

• Search and Filter: At the top, there’s a search bar that allows you to quickly find specific devices by name or other attributes. You can also apply filters to narrow down the devices based on type, status, or other criteria.

• Add a New Device: You can manually add a new device by clicking on the "Add new Device" button. This will guide you through the process of registering a new device with details such as its type, unique ID, and configurations.

• Bulk Management Options:

  • Bulk by CSV File: This is a key feature that allows you to upload multiple devices at once using a CSV file. You can use this feature to save time when you need to add or manage large numbers of devices at once.

  • Firmware Management: This option lets you add new firmware version on your devices. Keeping firmware updated is important for security and functionality improvements.

Bulk actions

Next to the device list, you will see options for bulk actions, like activating or deactivating your M2M devices, or editing device settings in batches. These actions can be initiated by selecting multiple devices from the list or by uploading a CSV file that contains the necessary device information.

Exporting to CSV

You can easily download the Devices - Data result set by clicking the Download icon just below the Search icon.

This will generate CSV file, containing all devices in the current selection. The CSV file will contain the measurements accompanied with the timestamp of that specific measurement.

Click on the Bulk by CSV file button.

This step opens the process for uploading multiple devices at once via a CSV file. This saves time since you don’t need to add each device individually.

You are asked to upload a CSV file with the device data. Ensure that the structure of the file matches the template exactly, which you can download. Use a comma (,) as the CSV separator.

After uploading the CSV file, it will be validated.

This screen gives you feedback on the validation. All devices with valid data are displayed, and devices with errors won’t be processed. The system checks fields such as IMEI, ICCID, and other required fields.

After validation, choose the target project and flow where the new devices should be added. You can also specify the device details, such as the device type.

Here, you define the project and flow in which the new devices will be processed. You can also choose the type of devices being added, for example, M2M devices or another type.

Click on Add new M2M Devices to start adding the devices.

The system will now begin adding the devices. You can monitor the process by following the progress in the Bulk reports where you can see if all devices were successfully created.

The M2M Bulk by CSV file actions feature enables you to perform modifications on large numbers of SIMs through a file upload. Instead of updating SIMs individually, you can upload a CSV file containing the required data and configuration, allowing changes to be processed efficiently and consistently at scale.

The bulk update process consists of four steps:

• Upload – Upload the CSV file containing the data for the desired modification.

• Validation – The system verifies the file structure, content, and data integrity before proceeding.

• Configuration – Select the type of modification you want to perform and provide any required settings.

• Execution – Once the file has been validated and configured, the bulk action is executed on the selected assets.

Different modification types may require a specific CSV template or file structure. Before starting a bulk action, ensure that your file complies with the required format. By using Bulk Actions, large-scale changes can be performed in a controlled, repeatable, and efficient manner while reducing the need for manual updates.

This feature supports several modification types, each designed for a specific M2M use case. When creating a bulk action, select the appropriate modification type and use the corresponding CSV template.

Pair SIM Card with Device

Use this action to pair one or more SIM cards with devices in bulk. The uploaded file must specify both the SIM card identifier and the target device identifier for each record.

Typical use cases:

• Initial device deployment

• Migrating SIM cards to new devices

• Mass onboarding of connectivity-enabled assets

Unpair Connectivity

Use this action to remove the association between a SIM and a device. This is typically required when devices are decommissioned, replaced, or reassigned.

Typical use cases:

• Device replacement

• Asset retirement

• Connectivity cleanup

Change Connection Status

Use this action to modify the operational status of one or more SIM cards. Depending on the platform configuration, this may include actions such as activating, suspending, or reactivating connections.

Typical use cases:

• Temporary service suspension

• Reactivating inactive connections

• Managing connectivity lifecycle states

Change Communication Plan

Use this action to assign a different communication plan to selected SIM cards. Communication plans determine how devices communicate within the network and which services are available.

Typical use cases:

• Migrating devices between communication plans

• Enabling additional connectivity features

• Standardizing communication settings across device groups

Change Rate Plan

Use this action to change the billing or service plan associated with one or more SIM cards. This allows you to optimize costs and service levels based on device usage patterns.

Typical use cases:

• Upgrading subscriptions

• Downgrading unused capacity

Download Activation Codes

Use this action to generate and download activation codes for multiple eSIM profiles in a single operation. These activation codes can be used to download and install eSIM profiles on compatible devices.

The LoRa Connectivity configuration page gives you the opportunity to choose the connectivity profile that best suits your application.

The Devices overview provide you with a list of all devices als the connectivity used.

1. Click on Devices to show the device overview on the Things Manager tab

2. Search for a device Name of DevEUI to find the device and click the icon to open the Device and Connectivity details

3. Or click on the icon to open the Device and Connectivity directly in your device overview list

1. Click on the Connectivy Plan name to go to the LoRa Connectivity configuration section

2. Or open the LoRa tab and scroll down to the LoRa Connectivity configuration section

1. Click Edit LoRa Connectivity configuration

2. The page show an overview of the current connecivity settings for this device

3. Want to learn more about the different settings how they work then click the link to go to the documentation about LoRa connectivity configuration

Edit configuration

The connectivity plan can be updated here, by selecting the Connectivity plan selection box a new dialog opens In this dialog all available connectivity plans are shown, it shows per connectivity plan if it includes geolocation.

By default, KPN Things forwards ingested uplink data to your destinations (such as HTTPS, MQTT, AWS Lambda, or Google Cloud Functions) in standard SenML format (RFC 8428 - Sensor Measurement Lists).

If your external systems or third-party applications require data in a specific or proprietary layout, you can create a custom Destination Format. This allows you to write a JavaScript script that automatically transforms the standard SenML payload into your desired format before it is sent.

Creating a Custom Destination Format

Follow these steps to set up and configure a custom destination format:

Step 1: Create the Format Profile

1. In the Things Creator menu, click All Destination Formats.

2. Click Add new Destination Format.

3. Enter a Name and Description for your format.

   Tip: Choose a clear, recognizable name. This name will appear in the "Destination Format" drop-down menu when you configure destinations within your projects.

4. Click Add Destination Format to save the profile.

Step 2: Write and Test Your Script

1. On the Destination Format details page that appears, locate the Script section and click Create.

2. A JavaScript editor will open, pre-populated with a placeholder example script to help you get started.

3. Write your transformation logic. You can use the built-in testing tool to validate your script against a sample SenML input payload and preview the output. See Destination Format Scripts for more details.

4. Once you are satisfied with the transformation results, click Create.

Next Steps

Your new custom format is now ready for use. When adding a new destination or updating an existing one in any of your KPN Things projects, simply select your custom format from the Destination Format drop-down menu to apply the transformation.

The Support tickets page provides you with an interface to our IoT Service Desk. This is a click out to ServiceNow to allow you to raise and edit tickets.

Need support now?

Click the method that matches your subscription below to contact us right away.

Contact a specialist

Ask for support when you have a Freemium or Explorer subscription

Contact our Support Desk

Raise a ticket when you have a Modular of Tailored subscription

Like to read the Contact Support manual first? Click on the Support link below.

Support tickets

Support tickets can be accessed via the following options.

1. Click on Support Tickets in the menu

2. Click on the Support Tickets tile

The Service status page provides you with the current operational status of our platforms.

1. Click on Incidents in the menu for an overview of the status of our platforms

2. If Overall status is OPERATIONAL all underlaying items are functional

3. All major incidents are shown in the overview with one of the statuses below

Investigating

Under investigation but no cause has yet been found

Identified

We found the cause, we are going to apply a fix

Monitoring

We applied a fix and monitor if the platform remains stable

Resolved

Everything is working fine again

Closed

All operational actions are done, we have taken up the learnings to improve our services

1. This is the date and time of the last update of the incident

2. The information on this page is also available on status.kpnthings.com in case the Things Portal itself is inaccessible and also more detailed updates on the incident are available

Subsytem details

Below the KPN Things Incidents overview more details are available to show which service has been affected.

Cisco Control Center API

There is a disruption to the API, please use Cisco Control Center as a workaround when possible

Cisco Control Center Portal

There is a disruption at the Cisco Control Center portal, please use Things Portal as a workaround when possible

KPN Things API

There is a disruption to the API, please use KPN Things Portal as a workaround when possible

KPN Things Engine

There is a disruption of the KPN Things backend that results in not receiving data for customers that use Flows

KPN Things Portal

There is a disruption to the user interface of Things Portal, please use the KPN Things API when possible or wait with making changes until the incident is resolved

LoRa Connectivity

There is a disruption of the whole or a large part of the LoRa network

M2M Connectivity

There is a disruption of the whole or a large part of the M2M networks of KPN in the Netherlands

M2M Roaming Connectivity

There is a disruption in the roaming domain or with a roaming partner.

RSS feed

The RSS feed (Really Simple Syndication) makes it possible to automatically receive status updates. You will need an RSS-feed reader or plugin in applications like Slack or Mattermost to be able to recieve the updates.

The RSS feed for status updates is located at the following URL:

https://kpnthings.statuspage.io/history.rss

The Invoices page provides you with a copy of your invoices. This is a click out to MijnKPN Zakelijk portal to allow you to download invoices as Adobe PDF files.

Need your invoices now?

Click the tile below to open MijnKPN Zakelijk right away.

Download your invoice

Go to the Invoices module in MijnKPN Zakelijk and open or download your copy

Invoices

Invoices can be accessed via the following options.

1. Click on Invoices in the menu

2. Click on the Invoices tile

The Zone list page provides a comprehensive view of available mobile technologies across the globe. It consists of two main components:

• An interactive world map for visual exploration

• A detailed Zone list table for in-depth analyses

Interactive Map

The Zone list map offers a global overview of operator availability by country. Key features include:

1. Zone filtering: toggle between Premium, Economy and Satellite zones

2. Color Legend: easily identify zone types using the map legend

3. Country details: click on a country to view available operators

4. Dynamic updates: the map shows the filtered countries and their operators from the Zone list table, divided/shown by economy or premium maps

Zone list Table

The Zone list table provides detailed, country-specific information about available mobile technologies. Users can:

• Apply Filters: Narrow down results by country, zone type, technology and more

• Check Technology status:

  • Live: the technology is currently active and available

  • Ending: the technology is still available but is being phased out

This table is designed to support decision-making by offering granular insights into global technology availability. Click the information button (next to 'Zone list' at the top of the table) for tips on how to use the table and additional details about the displayed data.

RRS column

A Roaming Restriction Set (RRS) determines with which foreign operators use of the data network is permitted or not. KPN IoT offers a rich set of predefined RRSs that can be assigned to a connection via the Communication Plan. These RRSs are largely linked to the countries within the available billing zones.

Tips for use

• Use the Zone toggle on the top to toggle the map view between Premium & Economy zones

• Use Alt (Windows) or Command (Mac) + Scrollwheel to zoom in on the map, drag it to pan the map

• Use the toggle above the legend to make the map reflect what you filtered in the table

• Click a county to pin the data in the information field, click unpin to show data on hover again

• Use the right mouse button on the table to export to your spreadsheet software

• Hover on the link on the bottom of the table to see when the table was last updated

Zone information

In the list the 2 standard sets of zones are represented: the Premium zones (also known as full zones) and the Economy zones. The list contains as well a column with the name of the zone as a separate column for each zone.

Note: The Premium Zones are based on countries. All for KPN IoT available networks are accessible for usage within that zone. Each higher zone actually also contains the countries (and operators) in the earlier zone. If a Rate Plan doesn't contain one of the first zones, the countries will be included in the first next mentioned zone.

Note: The Economy Zones are based on a selected set of operators within a country. KPN IoT tries to make the best balance between coverage, quality and price. This means that not all for KPN IoT available networks are accessible for usage within that zone. Note as well that each higher zone doesn't contains the operators (and countries) in the earlier zone. This means that if a Rate Plan doesn't contain one of the first zones, the usage on those operators (in those countries) will NOT be included in the first next mentioned zone, but will be stated as usage in 'Other' (which is most of the times highly priced). Always make sure that when a Rate Plan containing these zones is connected to a subscription (SIM), that also the Communication Plan is related and handles the roaming restriction set that belongs to the economy zones.

Connect your own M2M Device that communicates over the Internet. Useful when only Device management data is sent to KPN Things. Part of the Device Management + Connectivity only proposition.

• Supported network type(s): MQTT,INTERNET,KPNM2M

• Device Specification ID: own-m2m-with-internet

• Device Specification UUID: cf872c9e-9343-47db-b972-35dc4df340c8

› Decoded ThingsML and raw SenML data (v2)

Decoder that forwards raw SenML data and decoded ThingsML data sent by the device.

Example SenML

This is completely dependent on the SenML or ThingsML input and could output almost any SenML. The decoded ThingsML below is just illustrative of what is possible.

[
    {
        "bn": "urn:dev:DEVEUI:fe782a953c642aeb:",
        "bt": 1693136532.83,
        "n": "latitude",
        "u": "lat",
        "v": 51.90717
    },
    {
        "n": "longitude",
        "u": "lon",
        "v": 4.48940
    },
    {
        "n": "temperature",
        "u": "Cel",
        "v": 29.75
    },
    {
        "n": "batteryVoltage",
        "u": "V",
        "v": 3.59
    },
    {
        "n": "extTemp",
        "u": "Cel",
        "v": 17.22
    },
    {
        "n": "io",
        "vb": false
    }
]

= SenML data encoding

• Protocol: HTTP response

• Description: Send SenML data to your device.

• Multiple commands in one downlink: No

• No input mapping

Project types

The Project type determines what you can and may do in KPN Things Portal. Some KPN Things Projects provide you with more features in the Portal than others.

Depending on the subscription of your Project, one or more of the following restrictions can apply:

You can find applicable restrictions on the of a Project.

A project has the following attributes:

• UUID - the technical identifier of your project.

• Name - the name you give to your project.

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

• Creation date - the moment your project was created.

The Freemium Project gives you free limited access to the KPN Things Portal:

• One Project in KPN Things Portal.

• Access to our to get you started with programming your Device.

• Integrated KPN LoRa functionality:

  • Free registration of up to 3 devices to KPN's nationwide LoRaWAN network.

You can find your Projects by clicking on your Customer name in the left menu. If you are a free user, you will get one project named My first project.

Do you want to upgrade one of your Projects? Click on Upgrade.

When clicking a project you go to the Project overview page. It gives you an overview of a selected Project:

• You can see the name, description and type of subscription of the selected project.

• Link to the .

• You can also see which , and are part of this project.

On this page you will find technical details of your project. At the project details page, you can edit the name and description of your project yourself.

Choose one of the below device types to continue setting up your IoT solution.

Sim card

You can request KPN M2M sim cards at https://portal.kpnthings.com. Register for free and find the link in the M2M is now available notification to order your SIM cards.

Continue configuring your SIM cards.

Device Simulator Web app

We recommend starting with connecting the KPN Things device simulator app. You can use this app to simulate a device and send messages whenever your want.

Continue with the Device Simulator Web app.

Supported devices & KPN devices

KPN Things supports commonly used IoT devices out of the box. If you want to get started with one of these devices, continue with Supported devices & KPN devices.

Developer devices

Start experimenting and discover the wide range of possibilities with these developer devices.​

These development boards are no longer available for purchase and should not be used for new designs.​

To connect other devices head over to the .

Continue to the next step:

The Connectivity page gives you a clear overview of all your connections. Here, you gain insight into their status and settings. We distinguish between LoRa and M2M connectivity.

Connectivity menu

Show all or narrow down

1. At the top left you see the project picker. Leave the project picker empty and the side menu allows you to work accross all your projects

2. Pick a project and both the menu and the data will narrow down to just that specific project, just like the filters you can use in your tables

3. To open all connectivity items click one of the seperate tables for M2M and LoRa connectivity without selecting a project first.

1. Once you’ve selected a project, you can choose the connectivity overview in the project’s detail view

2. You can also use the side menu to open the same view

Below the table we show.

1. number of ICCIDs shown per page

2. total number of ICCID's

3. current page and total number of pages

Use the filter options in the top-right corner to refine your overview.

1. Save your filter after making changes, you can store up to 10 different layouts

2. Expand the table to full screen, then click the ie to return to the standard view

3. Open the view options menu

4. Open the

In the view options menu under the icon, you’ll find tools to tailor the view to your needs.

1. Open the columns selector

2. Click an item and hold the left mouse button to drag it to your preferred position

3. Click a header and hold the left mouse button to drag it to your preferred position

It is possible to filter on multiple variables to create a cross-section of the data. The filters applied to the overview are shown at the top in light blue boxes.

1. Open the filter selector

2. Click an item and select the desired check boxes, or enter part of the value to search

3. Click the icon at the top of the overview or by using Reset in the filter selector

4. Click the

When you choose the connectivity variant, you’ll see an overview of connections, based on whether you selected a specific project or all connectivity.

Things Manager includes the following menu items

We aim to keep you well-informed. You’ll receive relevant updates based on your email subscriptions. However, some content may not apply to you, or you might prefer not to receive updates at all. You can adjust your preferences anytime in the Things Portal.

To change email subscriptions, you need to have a Things Manager role.

Access email subscriptions

You can access email subscriptions in two ways.

1. Via My Things User Details (personal settings only)

2. Via (change settings of all users, admin only)

To manage email subscriptions of other users, you need the Things Manager - Admin role.

• Already an admin? Great! Let’s get started!

• Not an admin yet? Ask your organization’s administrator to grant you admin rights Not sure who that is? us and we’ll help you out

In KPN Things the Device type is used to express the connectivity and data capabilities of a Device, like whether it is a LoRa or an M2M device, and its compatibility to Data Processing components such as decoders and encoders.

KPN Things supports the devices as shown in the subpages of this page.

KPN Things Devices versus Supported Devices

We have two categories of Device types, namely KPN Things Devices, when you buy a Device from us, and Supported Devices, when you bring your own Device to KPN Things. Each categorie has its own set of Device Management features in the Portal.

Legenda ✅ - Available for this device type. 🟡* - Configurable for your own device, coming soon. ❌ - Not available for this device type.

The KPN Things Platform is the bridge between IoT Devices and IoT Applications. It offers a unified way of connecting Devices at the one side, and applications at the other side, making Devices and applications completely interchangeable in every IoT solution that uses KPN Things.

Device integration

Devices can communicate with the platform using one of our networks, LoRa or M2M (2G/3G/4G/LTE-M), or a Device using another network can get its data to and from KPN Things over the Internet.

Communication from your Device is called uplink communication. When data or instructions are sent to your Device, it is called downlink communication. The communication within KPN Things Platform uses the SenML data protocol. Devices using other languages can be translated from and to SenML using decoders and encoders.

Application integration

KPN Things will connect to your application through a dedicated connection layer. To connect your application to KPN Things you can use one of the available Destination types. We support connecting plain HTTPS endpoints to KPN Things, but if you are developing in Microsoft Azure, you can connect directly to the Azure Event Hub.

The Destination types that support 'management' connect on a platform level and can also manage objects in the application. The Cumulocity destination for instance will create Device objects in the Cumulocity tenant for each Device that KPN Things sends data of.

The is the web application through which you can manage and monitor almost all parts of the KPN Things solutions. You can manage each part of the KPN Things solution, from Device to Destination, to bring your IoT data from the real world to the digital world. You are also able to use directly to manage your IoT solutions.

The KPN Things Portal is the visual interface with which you configure your solutions on the KPN Things Data Management platform.

To manage your IoT solution you use and in a Flow you link , configure and set up together. See how these components relate to each other in the . Since network configuration, or , is part of the Device in KPN Things, a Flow expresses the complete way how IoT data should be received, processed and forwarded, from the Device to the Destination and vice versa.

A device specification for the Things Device phone App.

• Supported network type(s): INTERNET

• Device Specification ID: own-phone-qr

• Device Specification UUID: 3f77934a-2310-4504-89d7-08f40a25c2b8

Decoder that forwards raw SenML data and decoded ThingsML data sent by the device.

This is completely dependent on the SenML or ThingsML input and could output almost any SenML. The decoded ThingsML below is just illustrative of what is possible.

• Protocol: HTTP response

• Description: Send SenML data to your device.

• Multiple commands in one downlink: No

• No input mapping

One of the main use cases in the Internet of Things is tracking of assets. Therefore KPN Things has location data at the core of its design, especially if you take into account the wide variety of tracking hardware we sell.

We consider two different types of determining the location of your Device:

• Localization: really determining the absolute location of your Device on the world.

• Detection: detecting the presence of your Device with an anchor in the world which has a known location. With this you can safely say your Device is close to the anchor.

Localization

Using multiple measurements in a single domain to try to approximate the location of the device.

The following measurement values are outputted by KPN Things:

• latitude

• longitude

• radius (if available)

• source

The device determines location using GPS. An implementation works for a given device and decoder.

• Device: Should have a GPS module and send GPS location.

• Decoder: A decoder for each device type that sends GPS data (unless a Things protocol is used)

The LoRa network determines the approximate location of the device using three or more fine timestamps calculated by the gateways. An implementation works for all LoRa devices.

• Network: Should be KPN LoRa with a geo-enabled connectivity plan

• Decoder: LoRa Geolocation decoder should be enabled.

There should be WiFi infrastructure, dense enough for a device to pick up multiple access points. A device should scan for available WiFi access points and send their MAC-address and received signal strength to Things DM. Things DM should then decode the payload whereafter an external service can be called to resolve the measurements to a latitude and longitude.

• Device: Device should be able to scan for WiFi access points

• Decoder: A decoder for each device type that scans for WiFi access points (unless a Things protocol is used)

• Processing: A WiFi Localization processor should translate incoming WiFi MAC+RSSI measurements to a latitude, longitude and radius using an external service.

Trying to detect another identifiable object with a known location and using the location of that object as approximate location of the device.

• detectedBeacon

• source

The LoRa network forwards the identifier of the best receiving gateway. Using the user-administrated location of this gateway the general location of the device is determined.

• Network: Should be KPN LoRa.

• Decoder: Metadata embedded in the DevEUI_uplink message from Thingpark should be accepted as information to be processed in Things DM.

• Processing: One LoRa Metadata decoder for location detection using LoRa Gateway ID

There should be managed infrastructure of Bluetooth beacons that transmit their identifier in a known manner. The locations of these beacons should be administrated in an (out-of-scope) application. There should be devices being able to detect the beacon and send the beacon identifier to Things.

• Device: There should be a beacon device transmitting a Bluetooth beacon. There should be another device picking up the beacon and sending its identifier to Things.

• Decoder: A decoder for each device type that sends a bluetooth beacon ID (unless a Things protocol is used)

• Processing: trancelate beacon to coordinates.

Connect your own M2M device to KPN Things.

• Supported network type(s): KPNM2M

• Device Specification ID: own-m2m

• Device Specification UUID: 7748b913-3901-4cbd-be66-96d366e85539

Decoder that forwards raw SenML data and decoded ThingsML data sent by the device.

This is completely dependent on the SenML or ThingsML input and could output almost any SenML. The decoded ThingsML below is just illustrative of what is possible.

• Protocol: HTTP response

• Description: Send SenML data to your device.

• Multiple commands in one downlink: No

• No input mapping

Connect your (virtual) Internet-connected device to KPN Things.

• Supported network type(s): INTERNET

• Device Specification ID: own-internet

• Device Specification UUID: b2c5c303-4f74-4b58-95f5-b80455fdafbc

Decoder that forwards raw SenML data and decoded ThingsML data sent by the device.

This is completely dependent on the SenML or ThingsML input and could output almost any SenML. The decoded ThingsML below is just illustrative of what is possible.

• Protocol: HTTP response

• Description: Send SenML data to your device.

• Multiple commands in one downlink: No

• No input mapping

Get your KPN Things device data in a Azure SQL database. This QuickStart will help you set up a KPN Things flow towards an Azure Eventhub. The Azure Eventhub is used to ingest data in to the Azure platform. An Azure Streamanalytics job will process incoming data. The data will be stored in an Azure SQL database. For this QuickStart you’ll need a KPN Things account with an active device (or download the ) and an active Azure subscription.

In this QuickStart you’ll learn how to:

• Create and configure the necessary Azure resources

  • Create and configure Azure Eventhub

In KPN Things the Device type is used to express the connectivity and data capabilities of a Device, like whether it is a LoRa or an M2M device, and its compatibility to Data Processing components such as decoders and encoders.

KPN Things supports the devices as shown in the subpages of this page.

We have two categories of Device types, namely KPN Things Devices, when you buy a Device from us, and Supported Devices, when you bring your own Device to KPN Things. Each categorie has its own set of Device Management features in the Portal.

The news page provides you with all relevant information.

1. Click on News in the menu to see all news items under All News

2. Click on the title of a news item to open and read the full article

3. Use the search field to look for specific topics