KPN LocationTag V

KPN LocationTag V

Also known as StreamLineTM-2001/P1A5.

• Supported network type(s): KPNLORA

• Device Specification ID: kpn-locationtag-v

• Device Specification UUID: be8617b8-831c-4781-84ed-d535b862eace

Decoders	decoderSpecificationUUID	Description
+ LoRa Geolocation data	ec67cf00-68c2-4caa-bbd2-9d3454453295	Add LoRa Geolocation data to messages where location could be calculated.
+ Location by LoRa On Premises Gateway reception	d9c25a43-e073-4c0f-a488-b12119462b84	Add location data to messages that are received by known LoRa On Premise Gateways.
› Decoded payload for Asset Tracking application	5cf4f661-d764-4986-bd62-4b68ffc627e7	Decoder outputting legacy SenML naming, compatible with Asset Tracking v1.x application.
› Decoded payload for Asset Tracking application (v2)	b2b9da8f-761e-599f-8464-3a916d54b6b8	Decoder for Streamline lora messages encoded as P3K3 (loctagiiiv2) with RotationCount (byte length 2-49).
› Decoded payload with motion indication	b56341ae-6ab5-4b8d-a4aa-790b7a9e2ffa	Decoder for Streamline LoRa devices configured with motion indicator configuration.
› Decoded payload with motion indication (v2)	e36ca071-eb67-5bf4-93de-0efa2ca087ea	Decoder for Streamline LoRa devices configured with motion indicator configuration.

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

› Decoded payload for Asset Tracking application

Decoder outputting legacy SenML naming, compatible with Asset Tracking v1.x application.

Expected SenML outputs

name	type/unit	example	description
DvLon	numeric	5.8	Longitude
DvLat	numeric	51.8	Latitude
Speed	m/s	0.0
Heading	rad	3.316
IoButt	numeric	1.0
IoRxd	numeric	1.0
IoMot	numeric	1.0
Io31	numeric	1.0
AccX	numeric	-1.3	Acceleration X
AccY	numeric	-0.5	Acceleration Y
AccZ	numeric	3.0	Acceleration Z
CompX	numeric	0.0	Compass X
CompY	numeric	0.0	Compass Y
CompZ	numeric	0.0	Compass Z
Temp	Cel	9.5	Temperature
VBat	V	3.6	Battery Voltage
TIME_ORIGINE	string	THINGSENGINE

Example SenML-message

[
	{
		"bn": "urn:dev:DEVEUI:7CC6C41000000457:",
		"bt": 1678778484
	},
	{
		"n": "DvLon",
		"u": "lon",
		"v": 5.82224
	},
	{
		"n": "DvLat",
		"u": "lat",
		"v": 51.85008
	},
	{
		"n": "Speed",
		"u": "m/s",
		"v": 0.0
	},
	{
		"n": "Heading",
		"u": "rad",
		"v": 3.316
	},
	{
		"n": "IoButt",
		"v": 1.0
	},
	{
		"n": "IoRxd",
		"v": 1.0
	},
	{
		"n": "IoMot",
		"v": 1.0
	},
	{
		"n": "Io31",
		"v": 0.0
	},
	{
		"n": "AccX",
		"u": "m/s2",
		"v": -9.9599
	},
	{
		"n": "AccY",
		"u": "m/s2",
		"v": -0.7661
	},
	{
		"n": "AccZ",
		"u": "m/s2",
		"v": -0.6129
	},
	{
		"n": "CompX",
		"u": "T",
		"v": 0.0
	},
	{
		"n": "CompY",
		"u": "T",
		"v": 0.0
	},
	{
		"n": "CompZ",
		"u": "T",
		"v": 0.0
	},
	{
		"n": "Temp",
		"u": "Cel",
		"v": 9.5
	},
	{
		"n": "VBat",
		"u": "V",
		"v": 3.59
	},
	{
		"n": "TIME_ORIGIN",
		"vs": "THINGSENGINE"
	}
]

› Decoded payload for Asset Tracking application (v2)

Decoder for Streamline lora messages encoded as P3K3 (loctagiiiv2) with RotationCount (byte length 2-49).

This decoder also decodes Geolocation and Local Gateway data.

The following SenML records can be present, amongst others:

name	type	unit	example	description
batteryVoltage	number	V
devEui	string			Not present in detail level 1 messages
DvLat	number	lat		Latitude
DvLon	number	lon		Longitude
firmwareCRC	string			Not present in detail level 1 messages
firmwareVersion	string			Not present in detail level 1 messages
gpsActiveStill	boolean		true
gpsFixStill	boolean		true
gpsModuleActive	boolean		true	Not present in detail level 1 messages
nfcScanned	boolean		true
nfcState	string			Not present in detail level 1 messages
nrOfLoraTransmissions	number			Not present in detail level 1 messages
orientationX	number			Not present in detail level 1 messages
orientationY	number			Not present in detail level 1 messages
powerupTime	number	min		Not present in detail level 1 messages
rotationCount	number
rotationLeft	number			Not present in detail level 1 messages
rotationRight	number			Not present in detail level 1 messages
settingsCRC	string			Not present in detail level 1 messages
status	string			Not present in detail level 1 messages
temperature	number	Cel	18.334
transmissionTime	number	s		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": "gpsActiveStill",
        "vb": true
    },
    {
        "n": "gpsFixStill",
        "vb": true
    },
    {
        "n": "nfcScanned",
        "vb": false
    },
    {
        "n": "batteryVoltage",
        "u": "V",
        "v": 3
    },
    {
        "n": "DvLat",
        "u": "lat",
        "v": 51.90717
    },
    {
        "n": "DvLon",
        "u": "lon",
        "v": 4.48940
    },
    {
        "n": "rotationCount",
        "v": 154
    },
    {
        "n": "temperature",
        "u": "Cel",
        "v": 1
    },
    {
        "n": "firmwareVersion",
        "vs": "cdab"
    },
    {
        "n": "firmwareCRC",
        "vs": "2143"
    },
    {
        "n": "settingsCRC",
        "vs": "7698"
    },
    {
        "n": "gpsModuleActive",
        "vb": true
    },
    {
        "n": "nfcState",
        "vs": "NFC_OFF"
    },
    {
        "n": "powerupTime",
        "u": "min",
        "v": 872379
    },
    {
        "n": "transmissionTime",
        "u": "s",
        "v": 238792
    },
    {
        "n": "nrOfLoraTransmissions",
        "v": 55
    },
    {
        "n": "devEui",
        "vs": "babcdef012"
    },
    {
        "n": "rotationLeft",
        "v": 3407873
    },
    {
        "n": "rotationRight",
        "v": 1507507
    },
    {
        "n": "orientationX",
        "v": 122
    },
    {
        "n": "orientationY",
        "v": 12
    },
    {
        "n": "status",
        "vs": "9a"
    },
    {
        "n": "timeOrigin",
        "vs": "NETWORK"
    }
]

› Decoded payload with motion indication

Decoder for Streamline LoRa devices configured with motion indicator configuration.

Expected SenML outputs

• name	type/unit	example	description
  DvLon	numeric	5.8	Longitude
  DvLat	numeric	51.8	Latitude
  Speed	m/s	0.0
  Heading	rad	3.316
  movementIndication	string	START	STATIONARY, STOP, START, MOVING
  IoButt	numeric	1.0
  IoRxd	numeric	1.0
  IoMot	numeric	1.0
  Io31	numeric	1.0
  AccX	numeric	-1.3	Acceleration X
  AccY	numeric	-0.5	Acceleration Y
  AccZ	numeric	3.0	Acceleration Z
  CompX	numeric	0.0
  CompY	numeric	0.0
  CompZ	numeric	0.0
  Temp	Cel	9.5	Temperature
  VBat	V	3.6	Battery Voltage
  TIME_ORIGINE	string	THINGSENGINE

Example SenML-message

[
	{
		"bn": "urn:dev:DEVEUI:7CC6C42600000272:",
		"bt": 1678778546
	},
	{
		"n": "DvLon",
		"u": "lon",
		"v": 6.92017
	},
	{
		"n": "DvLat",
		"u": "lat",
		"v": 52.75613
	},
	{
		"n": "Speed",
		"u": "m/s",
		"v": 0.0
	},
	{
		"n": "Heading",
		"u": "rad",
		"v": 2.862
	},
	{
		"n": "movementIndication",
		"vs": "START"
	},
	{
		"n": "GpsFix",
		"vs": "RECENT"
	},
	{
		"n": "IoButt",
		"v": 1.0
	},
	{
		"n": "IoRxd",
		"v": 1.0
	},
	{
		"n": "IoMot",
		"v": 1.0
	},
	{
		"n": "Io31",
		"v": 0.0
	},
	{
		"n": "AccX",
		"u": "m/s2",
		"v": -9.9599
	},
	{
		"n": "AccY",
		"u": "m/s2",
		"v": 1.6855
	},
	{
		"n": "AccZ",
		"u": "m/s2",
		"v": 0.0
	},
	{
		"n": "CompX",
		"u": "T",
		"v": 0.0
	},
	{
		"n": "CompY",
		"u": "T",
		"v": 0.0
	},
	{
		"n": "CompZ",
		"u": "T",
		"v": 0.0
	},
	{
		"n": "Temp",
		"u": "Cel",
		"v": 12.25
	},
	{
		"n": "VBat",
		"u": "V",
		"v": 3.59
	},
	{
		"n": "TIME_ORIGIN",
		"vs": "THINGSENGINE"
	}
]

› Decoded payload with motion indication (v2)

Decoder for Streamline LoRa devices configured with motion indicator configuration.

This decoder also decodes Geolocation and Local Gateway data.

The following SenML records can be present, amongst others:

name	type	unit	example	description
AccX	number	m/s2	-1.3	Measured acceleration in the X-axis
AccY	number	m/s2	-0.5	Measured acceleration in the Y-axis
AccZ	number	m/s2	3.0	Measured acceleration in the Z-axis
CompX	number	T	0.0000010	Measured compass orientation in the X-axis
CompY	number	T	-0.001507	Measured compass orientation in the Y-axis
CompZ	number	T	-0.002638	Measured compass orientation in the Z-axis
DvLat	number	lat	51.90717	Latitude
DvLon	number	lon	4.48940	Longitude
GpsFix	string		"RECENT"	Either "RECENT" or "OUTDATED"
Heading	number	rad	3.316
Io31	number		1.0	arbitrary bit
IoButt	number		1.0	whether the Device's button was pressed
IoMot	number		1.0	whether the Device is in motion
IoRxd	number		1.0	Device's external digital i/o value
movementIndication	string		"STATIONARY"	Either "STATIONARY", "STOP", "START" or "MOVING"
Speed	number	m/s	4.12
Temp	string	Cel	7.0	Temperature
VBat	number	V	3.59	Battery voltage

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": 1701882708.84,
        "n": "DvLon",
        "u": "lon",
        "v": 4.48940
    },
    {
        "n": "DvLat",
        "u": "lat",
        "v": 51.90717
    },
    {
        "n": "Speed",
        "u": "m/s",
        "v": 4.12
    },
    {
        "n": "Heading",
        "u": "rad",
        "v": -3.944
    },
    {
        "n": "IoButt",
        "v": 1.0
    },
    {
        "n": "IoRxd",
        "v": 1.0
    },
    {
        "n": "IoMot",
        "v": 0.0
    },
    {
        "n": "Io31",
        "v": 0.0
    },
    {
        "n": "AccX",
        "u": "m/s2",
        "v": 9.5002
    },
    {
        "n": "AccY",
        "u": "m/s2",
        "v": 0.7661
    },
    {
        "n": "AccZ",
        "u": "m/s2",
        "v": 0.1532
    },
    {
        "n": "CompX",
        "u": "T",
        "v": 0.0000010
    },
    {
        "n": "CompY",
        "u": "T",
        "v": -0.001507
    },
    {
        "n": "CompZ",
        "u": "T",
        "v": -0.002638
    },
    {
        "n": "Temp",
        "u": "Cel",
        "v": 7.0
    },
    {
        "n": "movementIndication",
        "vs": "STATIONARY"
    },
    {
        "n": "GpsFix",
        "vs": "RECENT"
    },
    {
        "n": "VBat",
        "u": "V",
        "v": 3.59
    },
    {
        "n": "timeOrigin",
        "vs": "NETWORK"
    }
]