A Device represents a single physical device that can send data to the platform. When adding a device to KPN Things, you register the following information:
- Name - A descriptive name of the Device.
- Barcode (optional) - The serial number of other code that is visible on the outside of the Device.
- Description (optional) - More information about your Device.
- Device type - What type of Device it is.
- Network info - The information required to register the Device to the correct network.
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.
We have two categories of Device types, namely Own Devices, where you bring your own Device to KPN Things, and KPN Devices, where you buy a Device from us. 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.
Each Device in KPN Things will have a processing status. This will tell you whether data from and to that Device will be processed by KPN Things.
To connect a Device to KPN Things it needs either to be registered to our LoRa or M2M network, or it needs to be an Internet-connected device running our SDKs or other KPN Things compatible software.
Separate pages will explain more about the supported network types:
On the All Device page, you have an overview of all your Devices.
Elements on the page are:
- 1.Total number of Devices you have and see on the current page.
- 2.Device list of all your Devices with some information:
- 1.The Device name.
- 2.The Device type.
- 3.The primary identifier of your Device.
- For LoRa this is the DevEUI
- For M2M the IMEI
- For internet the DvnUUID
- 4.The moment Things last received a message from the Device.
- 5.The Project the Device belongs to.
- 6.The number of Flows your Device is in. Hover over the number to get a popup with a list of Flow names.
- 3.Search element to search for your specific Devices. You can search by Name and Primary identifier.
- 5.Bulk manipulation options. Select some or all Devices and choose the bulk action from the action bar at the bottom of the page.
- 6.Sorting options, by clicking on a specific table header the table will sort by the selected value.
This is the place where your 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.
- 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.
This step will look differently, depending on the type of network information.
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.
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.
- 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.
- 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 - kind of password.
The most impotant difference is that: Device deactivation can be used temporarily and is neccesary when you want stop data from devices being send to devices. As an example: a customer has not paid his invoice and in response this customer receives no data. Deletion is permanent. When you want to delete a device, you can log a ticket via our IoT Servicedesk to ask them to delete your devices. After the deletion, you can't onboard this device again.
In the table below you can read about the differeces between deleting a Device and deactivating a Device.
This page offers you all detailed information about your Device and its connectivity.
The elements on this page are:
- 9.A button to delete your Device. This will completely remove your Device from KPN Things! (Not available for KPN (managed) devices).
The Device information card contains general information about your Device:
The LoRa information card contains more LoRa specific information of your Device.
The M2M information card contains more M2M specific information of your Device.
- 1.The IMEI of your Device.
- 2.The ICCID of the SIM card linked to your Device.
- 3.The MSISDN of the subscription linked to the SIM card in your Device.
- 5.The moment KPN Things last received data from your Device.
- 6.The moment your SIM card has been activated.
- 7.The rate plan of the subscription linked to your SIM card.
- 8.Button to unlink the current SIM card from your Device. (Not available for KPN (managed) devices).
The Internet information card contains more Internet specific information of your Device.
On this tab you can send data or instructions to your Device, and you can see the status of requested data/instructions. Data to LoRa devices is also called a downlink.
Depending on your device type, different ways of sending data/instructions to your Device will be available. These could be:
Some Device types allow you to send raw LoRa data to your Device. To do this, you need to enter two values in the form as shown below:
- FPort - the LoRa application port you want to send the data on.
- Payload - the data you want to send to your Device in hexadecimal characters.
Things M2M devices and Internet devices can communicate with SenML. So downlinks to these devices should also be SenML.
The input form in the Portal should be filled in with a valid SenML measurement list formatted as JSON. Learn more about SenML. The entered SenML measurement list does not have to contain base values, KPN Things will add those before sending the downlink to the Device.
Example with one command
Example with two commands
For KPN Devices we provide a predefined list of human readable commands that you can send to the Device. Simply select the desired command to send by clicking on the radio button (if multiple commands are available), select the desired value for the command from the drop down, and click submit.
If downlink is not available for your Device, you will see the following:
If your Device is not yet linked to a Flow, doing this could enable Downlink for your device. A Flow is required to enable an encoder that is required for downlink communication. Learn more about downlink communication in de Developer Manual.
Often data or an instruction sent to your Device is not received immediately. Often the Device is in sleep mode and will be able to receive the data when it wakes up again. So to monitor the status of the requested data/instructions to your Device, you can check the downlink status table on this tab.
There are five downlink statuses, illustrated in the diagram below and further explained in the table below.
If your LoRa Device is not yet registered on the LoRa network, you can click Register Device on Network here. This will open a modal for you to enter the LoRa network information for this Device.
Additionally, you can perform some M2M specific actions:
2. Edit M2M Device Configuration - allows you to generate a new shared secret for your M2M device. 3. Switch SIM card - allows you to administratively switch the SIM card of your M2M device. 4. Unlink SIM card- allows you to administratively remove the SIM card from your M2M device.
If your M2M Device is not linked to a SIM card, you can click Link Connectivity here. This will open a new page to allow you to link your Device to a SIM card. The steps you take for this action are the same as for linking your SIM card to a Device.
In the Flows tab you can see:
- 1.A list of all the Flows your Device is linked to and the Project this Flow is in.
- 2.You can click on a Flow to open it.
- 3.You can click on Unlink from this Flow to remove the Device from that Flow.
- 4.Also you can add your Device to another Flow.
Available information and actions on Flow tab.
If there is a possible issue with one of the Flows your Device is in, a warning icon is shown on the Flow tab link and in the row of the concerning Flow. By clicking on the warning icon of a Flow, you will continue to the Flow detail page displaying more information about the warning.
Flow warning labels.
After you click on Link to another Flow in the Flows tab, a modal will open.
In this modal you can:
- 1.Select the Project to which you want to add the Device, if you have more than 1 Project.
- 2.Select the Flow to which to link your Device.
- 3.Optionally create a new Flow to which to link your Device.