KPN LocationTag II v2 Expert Mode

KPN LocationTag II v2 Expert Mode

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

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 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
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	s		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	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 → 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)