KPN LocationTag II v2

PreviousKPN LocationTag II NextKPN LocationTag II v2 Expert Mode

Last updated 1 month ago

Tag for localization and movement monitoring. Revision of KPN LocationTag II. Added functionality NFC and FSK.

Supported network type(s): KPNLORA
Device Specification ID: kpn-locationtag-ii-v2
Device Specification UUID: 43d4122f-b2ce-486b-9ede-d5463d2a822d

Decoders

decoderSpecificationUUID

Description

+ LoRa Geolocation data

19e12863-ad65-4fb7-a812-e6744be290d0

+ Location by LoRa On Premises Gateway reception

fa3928a9-8217-48a1-a3a6-1dcc945b4bb3

› Decoded payload for Asset Tracking

040627e5-0254-45ca-a0e1-cafab4c8b775

Decoder for Streamline LoRa short and long payloads containing a.o. NFC field detected flag, sabotaged flag, motion status, and battery voltage. Long payloads also contain a.o. firmware, power up, and transmission time.

› Decoded payload for Asset Tracking (v2)

1e530f69-1c43-54da-bc77-f3508486c21e

Decoder for Streamline LoRa short and long payloads containing a.o. NFC field detected flag, sabotaged flag, motion status, and battery voltage. Long payloads also contain a.o. firmware, power up, and transmission time.

› Decoded payload for counting rotations

10cf0159-822c-4039-a641-59d23cc38f49

Decoder outputting general information and specific rotation and orientation data

› Decoded payload for counting rotations (v2)

2aeeaef5-fb56-5b07-9675-58d568dc708f

Decoder outputting general information and specific rotation and orientation data

Encoders

encoderSpecificationUUID

Description

‹ Encoded device commands

9935fa32-6915-4fe9-b864-37e9913a97f9

Set the device mode and enabling of nfc writes.

+ 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 Asset Tracking

Decoder for Streamline LoRa short and long payloads containing a.o. NFC field detected flag, sabotaged flag, motion status, and battery voltage. Long payloads also contain a.o. firmware, power up, and transmission time.

Expected SenML outputs

name

type/unit

example

description

nfcFieldDetected

boolean

false

acceleratorActive

boolean

true

sabotaged

boolean

false

movementIndication

string

STATIONARY

indicates the devices movement status (STOP, STATIONARY, START, MOVING)

alarmMode

boolean

false

batteryVoltage

V

3.5

motionTime

min

2

temperature

Cel

21.0

firmwareVersion

only sent in long payload messages

firmwareCRC

only sent in long payload messages

settingsCRC

only sent in long payload messages

nfcState

only sent in long payload messages

RESERVED, NFC_READ_ONLY, NFC_OFF, NFC_RW

powerupTime

min

only sent in long payload messages

transmissionTime

s

only sent in long payload messages

nrOfLoraTransmissions

only sent in long payload messages

timeOrigin

string

NETWORK

indicates the origin of the timestamp

Example SenML message

[
	{
		"bn": "urn:dev:DEVEUI:7CC6C43012345678:",
		"bt": 1678778476
	},
	{
		"n": "nfcFieldDetected",
		"vb": false
	},
	{
		"n": "acceleratorActive",
		"vb": true
	},
	{
		"n": "sabotaged",
		"vb": false
	},
	{
		"n": "movementIndication",
		"vs": "STATIONARY"
	},
	{
		"n": "alarmMode",
		"vb": false
	},
	{
		"n": "batteryVoltage",
		"u": "V",
		"v": 2.96
	},
	{
		"n": "motionTime",
		"u": "min",
		"v": 39981.0
	},
	{
		"n": "temperature",
		"u": "Cel",
		"v": 15.0
	},
	{
		"n": "timeOrigin",
		"u": "enum",
		"vs": "NETWORK"
	}
]

› Decoded payload for Asset Tracking (v2)

Decoder for Streamline LoRa short and long payloads containing a.o. NFC field detected flag, sabotaged flag, motion status, and battery voltage. Long payloads also contain a.o. firmware, power up, and transmission time.

This decoder also decodes Geolocation and Local Gateway data.

The following SenML records can be present, amongst others:

name

type

unit

example

description

acceleratorActive

boolean

true

alarmMode

boolean

true

batteryVoltage

number

V

3.56

firmwareCRC

string

"9e17"

Only sent in long payload messages

firmwareVersion

string

"0604"

Only sent in long payload messages

motionTime

number

min

142271.0

movementIndication

string

"STOP"

Indicates the devices movement status. Either "STOP, "STATIONARY", "START" or "MOVING"

nfcFieldDetected

boolean

true

nfcState

string

"RESERVED"

Only sent in long payload messages. Either "RESERVED", "NFC_READ_ONLY", "NFC_OFF", or "NFC_RW"

nrOfLoraTransmissions

number

7427.0

Only sent in long payload messages

powerupTime

number

min

1334707

Only sent in long payload messages

sabotaged

boolean

true

settingsCRC

string

"a3e5"

Only sent in long payload messages

temperature

number

Cel

23.432

transmissionTime

number

s

5180

Only sent in long payload messages

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.

Short payload

[
    {
        "bn": "urn:dev:DEVEUI:0123456789012345:",
        "bt": 1693136532.83,
        "n": "nfcFieldDetected",
        "vb": false
    },
    {
        "n": "acceleratorActive",
        "vb": true
    },
    {
        "n": "sabotaged",
        "vb": true
    },
    {
        "n": "movementIndication",
        "vs": "START"
    },
    {
        "n": "alarmMode",
        "vb": true
    },
    {
        "n": "batteryVoltage",
        "u": "V",
        "v": 2.96
    },
    {
        "n": "motionTime",
        "u": "min",
        "v": 22756
    },
    {
        "n": "temperature",
        "u": "Cel",
        "v": -8
    },
    {
        "n": "timeOrigin",
        "vs": "NETWORK"
    }
]

Long payload

[
    {
        "bn": "urn:dev:DEVEUI:0123456789012345:",
        "bt": 1693136532.83,
        "n": "nfcFieldDetected",
        "vb": false
    },
    {
        "n": "acceleratorActive",
        "vb": true
    },
    {
        "n": "sabotaged",
        "vb": false
    },
    {
        "n": "movementIndication",
        "vs": "STATIONARY"
    },
    {
        "n": "alarmMode",
        "vb": false
    },
    {
        "n": "batteryVoltage",
        "u": "V",
        "v": 3.01
    },
    {
        "n": "temperature",
        "u": "Cel",
        "v": 1
    },
    {
        "n": "firmwareVersion",
        "vs": "06a9"
    },
    {
        "n": "firmwareCRC",
        "vs": "ac01"
    },
    {
        "n": "settingsCRC",
        "vs": "ec36"
    },
    {
        "n": "nfcState",
        "vs": "NFC_READ_ONLY"
    },
    {
        "n": "motionTime",
        "u": "min",
        "v": 18418
    },
    {
        "n": "powerupTime",
        "u": "min",
        "v": 1156219
    },
    {
        "n": "transmissionTime",
        "u": "s",
        "v": 4142
    },
    {
        "n": "nrOfLoraTransmissions",
        "v": 3255
    },
    {
        "n": "timeOrigin",
        "vs": "NETWORK"
    }
]

› Decoded payload for counting rotations

Decoder outputting general information and specific rotation and orientation data

Expected SenML records

name

type

unit

acceleratorActive

boolean

alarmMode

boolean

batteryVoltage

number

V

firmwareCRC

string

firmwareVersion

string

movementIndication

string

enum

nfcFieldDetected

boolean

enum

nfcState

string

enum

nrOfLoraTransmissions

number

orientationX

number

orientationY

number

powerupTime

number

min

rotationCount

number

rotationLeft

number

rotationRight

number

sabotaged

boolean

settingsCRC

string

temperature

number

Cel

transmissionTime

number

s

› Decoded payload for counting rotations (v2)

Decoder outputting general information and specific rotation and orientation data

Fixes from '› Decoded payload for counting rotations':

For the field nfcState, the values"NFC_READ_ONLY" & "NFC_OFF" were swapped.

This decoder also decodes Geolocation and Local Gateway data.

The following SenML records can be present, amongst others:

name

type

unit

example

description

acceleratorActive

boolean

true

alarmMode

boolean

false

batteryVoltage

number

V

3.03

firmwareCRC

string

"3407"

Not present in detail level 1 messages

firmwareVersion

string

"06b0"

Not present in detail level 1 messages

movementIndication

string

"STATIONARY"

Indicates the devices movement status. Either "STOP", "STATIONARY", "START" or "MOVING"

nfcFieldDetected

boolean

false

nfcState

string

"NFC_READ_ONLY"

Not present in detail level 1 messages. Either "RESERVED", "NFC_READ_ONLY", "NFC_OFF" or "NFC_RW"

nrOfLoraTransmissions

number

27

Not present in detail level 1 messages

orientationX

number

21

Only present in detail level 3 messages

orientationY

number

7

Only present in detail level 3 messages

powerupTime

number

min

184996

Not present in detail level 1 messages

rotationCount

number

2

rotationLeft

number

1

Only present in detail level 3 messages

rotationRight

number

3

Only present in detail level 3 messages

sabotaged

boolean

false

settingsCRC

string

"42b5"

Not present in detail level 1 messages

temperature

number

Cel

24.3

transmissionTime

number

s

67

Not present in detail level 1 messages

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": "nfcFieldDetected",
        "vb": false
    },
    {
        "n": "acceleratorActive",
        "vb": true
    },
    {
        "n": "sabotaged",
        "vb": false
    },
    {
        "n": "movementIndication",
        "vs": "STATIONARY"
    },
    {
        "n": "alarmMode",
        "vb": false
    },
    {
        "n": "batteryVoltage",
        "u": "V",
        "v": 3.03
    },
    {
        "n": "rotationCount",
        "v": 2.0
    },
    {
        "n": "temperature",
        "u": "Cel",
        "v": -24.0
    },
    {
        "n": "firmwareVersion",
        "vs": "06b0"
    },
    {
        "n": "firmwareCRC",
        "vs": "3407"
    },
    {
        "n": "settingsCRC",
        "vs": "42b5"
    },
    {
        "n": "nfcState",
        "vs": "NFC_READ_ONLY"
    },
    {
        "n": "powerupTime",
        "u": "min",
        "v": 184996.0
    },
    {
        "n": "transmissionTime",
        "u": "s",
        "v": 67.0
    },
    {
        "n": "nrOfLoraTransmissions",
        "v": 27.0
    },
    {
        "n": "rotationLeft",
        "v": 1.0
    },
    {
        "n": "rotationRight",
        "v": 3.0
    },
    {
        "n": "orientationX",
        "v": 21.0
    },
    {
        "n": "orientationY",
        "v": 7.0
    },
    {
        "n": "timeOrigin",
        "vs": "NETWORK"
    }
]

‹ Encoded device commands

Protocol: LoRa downlink
Description: Set the device mode and enabling of nfc writes.
Multiple commands in one downlink: No

Input mapping:

Name: mode
- Value: Missing (translates into → 118000000080000000)
Name: deviceControl
- Value: Reset (translates into → 0200)
- Value: NFC_Write (translates into → 1B11FA1816)