KPN LocationTag II

KPN LocationTag II

Also known as Security Tag.

  • Supported network type(s): KPNLORA

  • Device Specification ID: kpn-locationtag-ii

  • Device Specification UUID: 2f16485d-1301-4d11-9fb8-1b74b5a8909f

Decoders
decoderSpecificationUUID
Description

+ LoRa Geolocation data

d2593092-bc42-4b84-a053-2301f499bbc4

Add LoRa Geolocation data to messages where location could be calculated.

+ Location by LoRa On Premises Gateway reception

71703178-038d-4ea9-b865-00819fb42417

Add location data to messages that are received by known LoRa On Premise Gateways.

› Decoded payload for Device Management

aec28f98-7e78-4eb9-a314-04f435219bc5

Decoder for Streamline LoRa short payloads, containing firmware version, mode, and battery status.

› Decoded payload for Device Management (v2)

c0d1ea0f-2470-5f88-897c-c1ec25f360d6

Decoder for Streamline LoRa short payloads, containing firmware version, mode, and battery status.

› Decoded payload for Medical Tracker application

9e8b2100-537d-46f8-ab21-4fad11d04bc9

Decoder for Streamline LoRa message type 0xD282 containing only temperature and movement bit.

› Decoded payload for Medical Tracker application (v2)

6a7a4ef4-e7a3-5eab-90ba-6901cf360d08

Decoder for Streamline LoRa message type 0xD282 containing only temperature and movement bit.

Encoders
encoderSpecificationUUID
Description

‹ Encoded device modes for Asset Recovery application

9e2a47a3-a239-4f1f-b14b-f16fa70fe99d

Send device modes for Asset Recovery: Presales (24h interval), Active (2h interval), Missing (5min interval + BLE), or Inactive.

+ LoRa Geolocation data

Add LoRa Geolocation data to messages where location could be calculated.

Expected SenML outputs

name
type/unit
example
description

locOrigin

string

KPNLORA

indicates the origin of the location data

latitude

numeric

51.79

longitude

numeric

4.68

radius

m

319

locAccuracy

%

locPrecision

%

locTime

timestamp

1637165561

Example SenML-message

This location info can be merged with the payload of the device

[
  {
    "bn": "urn:dev:DEVEUI:A41163C212345678:",
    "bt": 1637165561
  },
  {
    "n": "locOrigin",
    "vs": "KPNLORA"
  },
  {
    "n": "latitude",
    "u": "lat",
    "v": 51.794884
  },
  {
    "n": "longitude",
    "u": "lon",
    "v": 4.687986
  },
  {
    "n": "radius",
    "u": "m",
    "v": 319.730194
  },
  {
    "n": "locAccuracy",
    "u": "%",
    "v": 9999
  },
  {
    "n": "locPrecision",
    "u": "%",
    "v": 9999
  },
  {
    "n": "locTime",
    "vs": "1637165561192"
  }
]

+ Location by LoRa On Premises Gateway reception

Add location data to messages that are received by known LoRa On Premise Gateways.

Expected SenML outputs

See above. Output is comparable to LoRa Geolocation data.

› Decoded payload for Device Management

Decoder for Streamline LoRa short payloads, containing firmware version, mode, and battery status.

Expected SenML output attributes

name
type/unit
example
description

mode

string

active

operation modus (production, active, presales, missing)

batteryVoltage

V

3.58

batteryLevelLow

boolean

false

indicates if the battery voltage has been below the threshold

timeOrigin

string

NETWORK

indicates the origin of the timestamp

firmwareVersion

string

firmware info, only sent after device boot

firmwareCRC

string

firmware info, only sent after device boot

settingsCRC

string

settings info, only sent after device boot

Example SenML messages

[
	{
		"n": "mode",
		"u": "enum",
		"bn": "urn:dev:DEVEUI:7CC6C40512345678:",
		"bt": 1678778462,
		"vs": "active"
	},
	{
		"n": "batteryVoltage",
		"u": "V",
		"v": 3.58
	},
	{
		"n": "batteryLevelLow",
		"vb": false
	},
	{
		"n": "timeOrigin",
		"u": "enum",
		"vs": "NETWORK"
	}
]

The first 10 messages after boot of a device contain firmware information attributes:

[
	{
		"n": "mode",
		"u": "enum",
		"bn": "urn:dev:DEVEUI:7CC6C40512345678:",
		"bt": 1678864786,
		"vs": "active"
	},
	{
		"n": "batteryVoltage",
		"u": "V",
		"v": 3.37
	},
	{
		"n": "batteryLevelLow",
		"vb": false
	},
	{
		"n": "firmwareVersion",
		"vs": "0443"
	},
	{
		"n": "firmwareCRC",
		"vs": "397f"
	},
	{
		"n": "settingsCRC",
		"vs": "a3e5"
	},
	{
		"n": "timeOrigin",
		"u": "enum",
		"vs": "NETWORK"
	}
]

› Decoded payload for Device Management (v2)

Decoder for Streamline LoRa short payloads, containing firmware version, mode, and battery status.

This decoder also decodes Geolocation and Local Gateway data.

The following SenML records can be present, amongst others:

name
type
unit
example
description

batteryLevelLow

boolean

false

Indicates if the battery voltage has been below the threshold

batteryVoltage

number

V

firmwareCRC

string

Firmware info, only sent after device boot

firmwareVersion

string

Firmware info, only sent after device boot

mode

string

"active"

Operation modus. Either "production", "active", "presales" or "missing")

settingsCRC

string

Settings info, only sent after device boot

Example SenML

SenML can be structured in different ways, and we do not guarantee the examples below will look the same as what you will receive on your Destination. To make sure you can handle the SenML optimally, take a look at our documentation about Understanding and Interpreting SenML Data.

[
    {
        "bn": "urn:dev:DEVEUI:0123456789012345:",
        "bt": 1693136532.83,
        "n": "mode",
        "vs": "active"
    },
    {
        "n": "batteryLevelLow",
        "vb": false
    },
    {
        "n": "batteryVoltage",
        "u": "V",
        "v": 3.59
    },
    {
        "n": "firmwareVersion",
        "vs": "0443"
    },
    {
        "n": "firmwareCRC",
        "vs": "397F"
    },
    {
        "n": "settingsCRC",
        "vs": "A3E5"
    },
    {
        "n": "timeOrigin",
        "vs": "NETWORK"
    }
]

› Decoded payload for Medical Tracker application

Decoder for Streamline LoRa message type 0xD282 containing only temperature and movement bit.

Expected SenML records

name
type
unit

hasMovedSincePreviousTransmission

boolean

/

temperature

number

Cel

› Decoded payload for Medical Tracker application (v2)

Decoder for Streamline LoRa message type 0xD282 containing only temperature and movement bit.

This decoder also decodes Geolocation and Local Gateway data.

The following SenML records can be present, amongst others:

name
type
unit
example
description

hasMovedSincePreviousTransmission

boolean

true

temperature

number

Cel

18.875

Example SenML

SenML can be structured in different ways, and we do not guarantee the examples below will look the same as what you will receive on your Destination. To make sure you can handle the SenML optimally, take a look at our documentation about Understanding and Interpreting SenML Data.

[
    {
        "bn": "urn:dev:DEVEUI:0123456789012345:",
        "bt": 1633896968.04,
        "n": "temperature",
        "u": "Cel",
        "v": 18.875
    },
    {
        "n": "hasMovedSincePreviousTransmission",
        "vb": true
    },
    {
        "n": "timeOrigin",
        "vs": "NETWORK"
    }
]

‹ Encoded device modes for Asset Recovery application

  • Protocol: LoRa downlink

  • Description: Send device modes for Asset Recovery: Presales (24h interval), Active (2h interval), Missing (5min interval + BLE), or Inactive.

  • Multiple commands in one downlink: No

Input mapping:

  • Name: mode

    • Value: Presales (translates into → 150098078051010080510115013F01001501FB018016)

    • Value: Active (translates into → 15009807201C0000201C0015013F01001501FB014016)

    • Value: Missing (translates into → 15009807F0000000F0000015013907000000000000001501FB01C1150402010115040E010015042C02050516)

    • Value: Inactive (translates into → 14009808FFFFFFFFFFFFFFFF110000000001000000)

PreviousKPN LocationTag INextKPN LocationTag II v2

Last updated

Was this helpful?