KPN LocationTag II v2 Expert Mode

PreviousKPN LocationTag II v2 NextKPN LocationTag II v3

Last updated 1 month ago

Tag for localization and movement monitoring. Revision of KPN LocationTag II. Added functionality NFC and FSK. Expert Mode: configurable lifebeat and accelerometers sensitivity.

Supported network type(s): KPNLORA
Device Specification ID: kpn-locationtag-ii-v2-expert-mode
Device Specification UUID: 1a1fc7f4-e6b5-4e36-ad09-60624cae6774

Decoders

decoderSpecificationUUID

Description

+ LoRa Geolocation data

f0e87fa4-49da-4433-9092-eb70ba69af82

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

+ Location by LoRa On Premises Gateway reception

d628e1d0-7ced-46da-b586-cbfb6f598a3a

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

› Decoded payload for Asset Tracking

45ec6598-2abf-4fd2-afd5-b4680a97ce01

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)

0608cc3f-7136-5fde-9947-07cb11d2a60a

› Decoded payload for counting rotations

bd154000-0384-4bec-9e66-8edf4dcaeaf3

Decoder outputting general information and specific rotation and orientation data

› Decoded payload for counting rotations (v2)

ac0b8a25-bd54-57d1-9de5-e9f2a6acb97b

Decoder outputting general information and specific rotation and orientation data

Encoders

encoderSpecificationUUID

Description

‹ Encoded device commands

a9c437e4-cdda-4a30-911f-c359fa16b598

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

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

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

3.5

motionTime

min

temperature

Cel

21.0

firmwareVersion

not present in detail level 1 messages

firmwareCRC

not present in detail level 1 messages

settingsCRC

not present in detail level 1 messages

nfcState

not present in detail level 1 messages

RESERVED, NFC_READ_ONLY, NFC_OFF, NFC_RW

powerupTime

min

not present in detail level 1 messages

transmissionTime

not present in detail level 1 messages

nrOfLoraTransmissions

not present in detail level 1 messages

timeOrigin

string

NETWORK

indicates the origin of the timestamp

Example SenML-message - detail level 1

[
	{
		"bn": "urn:dev:DEVEUI:7CC6C43012345678:",
		"bt": 1678779611
	},
	{
		"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.98
	},
	{
		"n": "motionTime",
		"u": "min",
		"v": 590.0
	},
	{
		"n": "temperature",
		"u": "Cel",
		"v": 11.0
	},
	{
		"n": "timeOrigin",
		"u": "enum",
		"vs": "NETWORK"
	}
]

› Decoded payload for Asset Tracking (v2)

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

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

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 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

3.5

rotationCount

numeric

277

temperature

Cel

21.0

firmwareVersion

not present in detail level 1 messages

firmwareCRC

not present in detail level 1 messages

settingsCRC

not present in detail level 1 messages

nfcState

string

not present in detail level 1 messages

RESERVED, NFC_READ_ONLY, NFC_OFF, NFC_RW

powerupTime

min

not present in detail level 1 messages

transmissionTime

not present in detail level 1 messages

nrOfLoraTransmissions

numeric

not present in detail level 1 messages

rotationLeft

numeric

only present in detail level 3 messages

rotationRight

numeric

only present in detail level 3 messages

orientationX

numeric

only present in detail level 3 messages

orientationY

numeric

only present in detail level 3 messages

timeOrigin

string

NETWORK

indicates the origin of the timestamp

Example SenML-message - detail level 1

[
	{
		"bn": "urn:dev:DEVEUI:7CC6C43012345678:",
		"bt": 1678779611
	},
	{
		"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.98
	},
	{
		"n": "rotationCount",
		"v": 227
	},
	{
		"n": "temperature",
		"u": "Cel",
		"v": 11.0
	},
	{
		"n": "timeOrigin",
		"u": "enum",
		"vs": "NETWORK"
	}
]

Example SenML-message - detail level 2

[
	{
		"bn": "urn:dev:DEVEUI:7CC6C43000010445:",
		"bt": 1639575781
	},
	{
		"n": "nfcFieldDetected",
		"u": "enum",
		"vb": false
	},
	{
		"n": "acceleratorActive",
		"vb": false
	},
	{
		"n": "sabotaged",
		"vb": false
	},
	{
		"n": "movementIndication",
		"u": "enum",
		"vs": "STATIONARY"
	},
	{
		"n": "alarmMode",
		"vb": false
	},
	{
		"n": "batteryVoltage",
		"u": "V",
		"v": 2.99
	},
	{
		"n": "rotationCount",
		"v": 227
	},
	{
		"n": "temperature",
		"u": "Cel",
		"v": 17
	},
	{
		"n": "firmwareVersion",
		"vs": "06b0"
	},
	{
		"n": "firmwareCRC",
		"vs": "3407"
	},
	{
		"n": "settingsCRC",
		"vs": "117c"
	},
	{
		"n": "nfcState",
		"u": "enum",
		"vs": "NFC_RW"
	},
	{
		"n": "powerupTime",
		"u": "min",
		"v": 294794
	},
	{
		"n": "transmissionTime",
		"u": "s",
		"v": 894
	},
	{
		"n": "nrOfLoraTransmissions",
		"v": 539
	},
	{
		"n": "TIME_ORIGIN",
		"vs": "THINGSENGINE"
	}
]

Example SenML-message - detail level 3

[
	{
		"bn": "urn:dev:DEVEUI:7CC6C43000010445:",
		"bt": 1639571120
	},
	{
		"n": "nfcFieldDetected",
		"u": "enum",
		"vb": false
	},
	{
		"n": "acceleratorActive",
		"vb": true
	},
	{
		"n": "sabotaged",
		"vb": false
	},
	{
		"n": "movementIndication",
		"u": "enum",
		"vs": "STATIONARY"
	},
	{
		"n": "alarmMode",
		"vb": false
	},
	{
		"n": "batteryVoltage",
		"u": "V",
		"v": 3
	},
	{
		"n": "rotationCount",
		"v": 227
	},
	{
		"n": "temperature",
		"u": "Cel",
		"v": 16
	},
	{
		"n": "firmwareVersion",
		"vs": "06b0"
	},
	{
		"n": "firmwareCRC",
		"vs": "3407"
	},
	{
		"n": "settingsCRC",
		"vs": "5386"
	},
	{
		"n": "nfcState",
		"u": "enum",
		"vs": "NFC_RW"
	},
	{
		"n": "powerupTime",
		"u": "min",
		"v": 294725
	},
	{
		"n": "transmissionTime",
		"u": "s",
		"v": 861
	},
	{
		"n": "nrOfLoraTransmissions",
		"v": 522
	},
	{
		"n": "rotationLeft",
		"v": 1
	},
	{
		"n": "rotationRight",
		"v": 228
	},
	{
		"n": "orientationX",
		"v": 61
	},
	{
		"n": "orientationY",
		"v": 0
	},
	{
		"n": "TIME_ORIGIN",
		"vs": "THINGSENGINE"
	}
]

› 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

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

67

Not present in detail level 1 messages

Example SenML

[
    {
        "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 → 1A7A10008D2700008D27722C008D2700008D27118000000080000000)
Name: deviceControl
- Value: Reset (translates into → 0200)
- Value: NFC_Write (translates into → 1B11FA1816)
- Value: 8 uur lifebeat interval. Warning: only send to TAG IIv2 start/stop configurations. (translates into → 1B8108807000008070000016)
- Value: 12 uur lifebeat interval. Warning: only send to TAG IIv2 start/stop configurations. (translates into → 1B8108C0A80000C0A8000016)
- Value: 24 uur lifebeat interval. Warning: only send to TAG IIv2 start/stop configurations. (default) (translates into → 1B8108805101008051010016)
- Value: Set moving sensitivity to 5. Warning: only send to TAG IIv2 start/stop configurations. (default) (translates into → 1B14470516)
- Value: Set moving sensitivity to 6. Warning: only send to TAG IIv2 start/stop configurations. (translates into → 1B14470616)
- Value: Set moving sensitivity to 7. Warning: only send to TAG IIv2 start/stop configurations. (translates into → 1B14470716)
- Value: Set moving sensitivity to 8. Warning: only send to TAG IIv2 start/stop configurations. (translates into → 1B14470816)