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

+ LoRa Geolocation data

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

Expected SenML outputs

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

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:

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

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:

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)

Last updated