Elsys ERS

Last updated 2 months ago

Specification for Elsys ERS / ERS-lite / ERS-CO2 / ERS-sound.

Supported network type(s): KPNLORA
Device Specification ID: supported-elsys-ers
Device Specification UUID: 9e95ec32-cbd5-4202-b62b-1b8eb9d85a6d

Decoders

decoderSpecificationUUID

Description

Encoders

encoderSpecificationUUID

Description

+ LoRa Geolocation data

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

= Raw LoRa payload

Forward the raw LoRa payload and port number without decoding.

Expected SenML records

name

type

unit

= Raw LoRa payload (v2)

Forward the raw LoRa payload and port number without decoding.

This decoder also decodes Geolocation and Local Gateway data.

The following SenML records can be present, amongst others:

name

type

unit

example

description

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": "payload",
        "vs": "4D985C495AC4D8C9682CFD"
    },
    {
        "n": "port",
        "v": 1
    },
    {
        "n": "timeOrigin",
        "vs": "NETWORK"
    }
]

› Decoded Elsys ERS v9 payload

Decoder for v9 Elsys ERS payload.

Expected SenML records

name

type

unit

› Decoded Elsys ERS v9 payload (v2)

Decoder for v9 Elsys ERS payload, fixed repeating base name and rename CO2 to CO2Concentration (updated 20-10-2020).

Expected SenML records

name

type

unit

› Decoded Elsys ERS v9 payload (v3)

Decoder for Elsys ERS payloads. Fixes bugs in '› Decoded Elsys ERS v9 payload (v2)':

distance was incorrectly converted to dm instead of m. Now the containing value is in meters.
soundAverage was decoded incorrectly, resulting in a number that is way too large.
soundPeak was decoded incorrectly, resulting in a number that is way too large.
The grideye fields were decoded incorrectly, where most results would be too big.
Time offsets were added as positive ts instead of negative ts.
acceleration values were processed as unsigned values, but they should have been processed as signed values.

This decoder also decodes Geolocation and Local Gateway data.

The following SenML records can be present, amongst others:

name

type

unit

example

description

Example SenML

Long payload

[
    {
        "bn": "urn:dev:DEVEUI:0123456789012345:",
        "bt": 1693136532.83,
        "n": "temperature",
        "t": -16,
        "u": "Cel",
        "v": 21
    },
    {
        "n": "humidity",
        "t": -10,
        "u": "%RH",
        "v": 32
    },
    {
        "n": "accelerationX",
        "u": "m/s2",
        "v": 0.15566111111111108
    },
    {
        "n": "accelerationY",
        "u": "m/s2",
        "v": 0.31132222222222217
    },
    {
        "n": "accelerationZ",
        "u": "m/s2",
        "v": 0.46698333333333325
    },
    {
        "n": "illuminance",
        "u": "lx",
        "v": 354
    },
    {
        "n": "CO2Concentration",
        "u": "ppm",
        "v": 478
    },
    {
        "n": "CO2",
        "u": "ppm",
        "v": 478
    },
    {
        "n": "batteryVoltage",
        "u": "V",
        "v": 3.245
    },
    {
        "n": "analog1",
        "u": "V",
        "v": 57.071
    },
    {
        "n": "pulse",
        "u": "count",
        "v": 61438
    },
    {
        "n": "pulseAbsolute",
        "u": "count",
        "v": 2144202751
    },
    {
        "n": "temperatureExternal1",
        "u": "Cel",
        "v": 21.7
    },
    {
        "n": "digitalExternal",
        "vb": true
    },
    {
        "n": "distance",
        "u": "m",
        "v": 4.643
    },
    {
        "n": "motion",
        "u": "count",
        "v": 255
    },
    {
        "n": "temperatureIRInternal",
        "u": "Cel",
        "v": 24.5
    },
    {
        "n": "temperatureIRExternal",
        "u": "Cel",
        "v": 23
    },
    {
        "n": "occupancy",
        "u": "count",
        "v": 2
    },
    {
        "n": "waterLeak",
        "u": "count",
        "v": 0
    },
    {
        "n": "grideye0-0",
        "u": "Cel",
        "v": 16
    },
    {
        "n": "grideye1-0",
        "u": "Cel",
        "v": 16.1
    },
    {
        "n": "grideye2-0",
        "u": "Cel",
        "v": 16.2
    },
    {
        "n": "grideye3-0",
        "u": "Cel",
        "v": 16.3
    },
    {
        "n": "grideye4-0",
        "u": "Cel",
        "v": 16.4
    },
    {
        "n": "grideye5-0",
        "u": "Cel",
        "v": 16.5
    },
    {
        "n": "grideye6-0",
        "u": "Cel",
        "v": 16.6
    },
    {
        "n": "grideye7-0",
        "u": "Cel",
        "v": 16.7
    },
    {
        "n": "grideye0-1",
        "u": "Cel",
        "v": 16.8
    },
    {
        "n": "grideye1-1",
        "u": "Cel",
        "v": 16.9
    },
    {
        "n": "grideye2-1",
        "u": "Cel",
        "v": 17
    },
    {
        "n": "grideye3-1",
        "u": "Cel",
        "v": 17.1
    },
    {
        "n": "grideye4-1",
        "u": "Cel",
        "v": 17.2
    },
    {
        "n": "grideye5-1",
        "u": "Cel",
        "v": 17.3
    },
    {
        "n": "grideye6-1",
        "u": "Cel",
        "v": 17.4
    },
    {
        "n": "grideye7-1",
        "u": "Cel",
        "v": 17.5
    },
    {
        "n": "grideye0-2",
        "u": "Cel",
        "v": 17.6
    },
    {
        "n": "grideye1-2",
        "u": "Cel",
        "v": 17.7
    },
    {
        "n": "grideye2-2",
        "u": "Cel",
        "v": 17.8
    },
    {
        "n": "grideye3-2",
        "u": "Cel",
        "v": 17.9
    },
    {
        "n": "grideye4-2",
        "u": "Cel",
        "v": 18
    },
    {
        "n": "grideye5-2",
        "u": "Cel",
        "v": 18.1
    },
    {
        "n": "grideye6-2",
        "u": "Cel",
        "v": 18.2
    },
    {
        "n": "grideye7-2",
        "u": "Cel",
        "v": 18.3
    },
    {
        "n": "grideye0-3",
        "u": "Cel",
        "v": 18.4
    },
    {
        "n": "grideye1-3",
        "u": "Cel",
        "v": 18.5
    },
    {
        "n": "grideye2-3",
        "u": "Cel",
        "v": 18.6
    },
    {
        "n": "grideye3-3",
        "u": "Cel",
        "v": 18.7
    },
    {
        "n": "grideye4-3",
        "u": "Cel",
        "v": 18.8
    },
    {
        "n": "grideye5-3",
        "u": "Cel",
        "v": 18.9
    },
    {
        "n": "grideye6-3",
        "u": "Cel",
        "v": 19
    },
    {
        "n": "grideye7-3",
        "u": "Cel",
        "v": 19.1
    },
    {
        "n": "grideye0-4",
        "u": "Cel",
        "v": 19.2
    },
    {
        "n": "grideye1-4",
        "u": "Cel",
        "v": 19.3
    },
    {
        "n": "grideye2-4",
        "u": "Cel",
        "v": 19.4
    },
    {
        "n": "grideye3-4",
        "u": "Cel",
        "v": 19.5
    },
    {
        "n": "grideye4-4",
        "u": "Cel",
        "v": 19.6
    },
    {
        "n": "grideye5-4",
        "u": "Cel",
        "v": 19.7
    },
    {
        "n": "grideye6-4",
        "u": "Cel",
        "v": 19.8
    },
    {
        "n": "grideye7-4",
        "u": "Cel",
        "v": 19.9
    },
    {
        "n": "grideye0-5",
        "u": "Cel",
        "v": 20
    },
    {
        "n": "grideye1-5",
        "u": "Cel",
        "v": 20.1
    },
    {
        "n": "grideye2-5",
        "u": "Cel",
        "v": 20.2
    },
    {
        "n": "grideye3-5",
        "u": "Cel",
        "v": 20.3
    },
    {
        "n": "grideye4-5",
        "u": "Cel",
        "v": 20.4
    },
    {
        "n": "grideye5-5",
        "u": "Cel",
        "v": 20.5
    },
    {
        "n": "grideye6-5",
        "u": "Cel",
        "v": 20.6
    },
    {
        "n": "grideye7-5",
        "u": "Cel",
        "v": 20.7
    },
    {
        "n": "grideye0-6",
        "u": "Cel",
        "v": 20.8
    },
    {
        "n": "grideye1-6",
        "u": "Cel",
        "v": 20.9
    },
    {
        "n": "grideye2-6",
        "u": "Cel",
        "v": 21
    },
    {
        "n": "grideye3-6",
        "u": "Cel",
        "v": 21.1
    },
    {
        "n": "grideye4-6",
        "u": "Cel",
        "v": 21.2
    },
    {
        "n": "grideye5-6",
        "u": "Cel",
        "v": 21.3
    },
    {
        "n": "grideye6-6",
        "u": "Cel",
        "v": 21.4
    },
    {
        "n": "grideye7-6",
        "u": "Cel",
        "v": 21.5
    },
    {
        "n": "grideye0-7",
        "u": "Cel",
        "v": 21.6
    },
    {
        "n": "grideye1-7",
        "u": "Cel",
        "v": 21.7
    },
    {
        "n": "grideye2-7",
        "u": "Cel",
        "v": 21.8
    },
    {
        "n": "grideye3-7",
        "u": "Cel",
        "v": 21.9
    },
    {
        "n": "grideye4-7",
        "u": "Cel",
        "v": 22
    },
    {
        "n": "grideye5-7",
        "u": "Cel",
        "v": 22.1
    },
    {
        "n": "grideye6-7",
        "u": "Cel",
        "v": 22.2
    },
    {
        "n": "grideye7-7",
        "u": "Cel",
        "v": 22.3
    },
    {
        "n": "pressure",
        "u": "Pa",
        "v": 27054496
    },
    {
        "n": "soundPeak",
        "u": "dB",
        "v": 64
    },
    {
        "n": "soundAverage",
        "u": "dB",
        "v": 40
    },
    {
        "n": "Pulse2",
        "u": "count",
        "v": 235
    },
    {
        "n": "pulseAbsolute2",
        "u": "count",
        "v": 122
    },
    {
        "n": "analog2",
        "u": "V",
        "v": 17.767
    },
    {
        "n": "temperatureExternal2",
        "u": "Cel",
        "v": 28.1
    },
    {
        "n": "digitalIn2",
        "vb": true
    },
    {
        "n": "timeOrigin",
        "vs": "NETWORK"
    }
]

Short payload

[
    {
        "bn": "urn:dev:DEVEUI:0123456789012345:",
        "bt": 1704798016.891,
        "v": 17,
        "n": "temperature",
        "u": "Cel"
    },
    {
        "v": 32,
        "n": "humidity",
        "u": "%RH"
    },
    {
        "v": 262,
        "n": "illuminance",
        "u": "lx"
    },
    {
        "v": 1391,
        "n": "CO2Concentration",
        "u": "ppm"
    },
    {
        "v": 1391,
        "n": "CO2",
        "u": "ppm"
    },
    {
        "v": 3.607,
        "n": "batteryVoltage",
        "u": "V"
    },
    {
        "n": "timeOrigin",
        "vs": "NETWORK"
    }
]

= Raw LoRa payload

UUID: 377f294c-ae4b-4249-8c74-9e8fc26209e4
Description: Forward the raw LoRa payload and port number without decoding.
Exchange: decoder.lora.passthrough.exchange

Expected SenML outputs

Unknown