Thingsee Development Profile (10000-10999)

This profile is meant to be used only as a demonstration and R&D specification with Thingsee based devices. Any commercial deployment or development must use its own profile.

This specification is only for development and shouldn’t be used by the clients.

Movement dataId 10100

{
  "tsmId"     : 10100,
  "move"      : 1,
  "moveCount" : 5
}
  • move contains the count of detection between reporting periods. For example, in case ThingseePIR reports its current move status every 1 minute, this property can contain the count of detection during that 1 minute period.

Weather dataId 10110

Air pressure is given as pascals, relative humidity as percentage, temperature as Celsius and light as xxxx.

{
  "tsmId": 10110,
  "airp" : 102092.358,
  "humd" : 67.2,
  "temp" : 22.5,
  "lght" : 270
}

Carbon dioxide dataId 10111

Carbon dioxide level as parts per million (ppm).

{
  "tsmId" : 10111,
  "level" : 10
}

Air particle dataId 10112

Air particle level as parts per million (ppm), particle min/max size as micrometers.

{
  "tsmId" : 10112,
  "level" : 10,
  "min" : 3,
  "max" : 10
}
  • min and max defines particle size. E.g. following areas
  • min 0 - max 2
  • min 3 - max 10

Air particle mass concentration dataId 10113

Air particle mass concentration as micrograms per cubic meter (µg/m³), particle min/max size as micrometers.

{
  "tsmId" : 10113,
  "level" : 10,
  "min" : 3,
  "max" : 10
}
  • min and max defines particle size. E.g. following areas
    • min 0 - max 2
    • min 3 - max 10

Air particle number concentration dataId 10114

Air particle mass concentration as number per cubic meter (1/m³), particle min/max size as micrometers.

{
  "tsmId" : 10114,
  "level" : 10,
  "min" : 3,
  "max" : 10
}
  • min and max defines particle size. E.g. following areas
    • min 0 - max 2
    • min 3 - max 10

Air particle typical particle size dataId 10115

Air particle mass concentration as micrometers (µm).

{
  "tsmId" : 10115,
  "level" : 10,
}

Total Volatile Organic Compounds dataId 10116

Total Volatile Organic Compounds level as parts per billion (ppb).

{
  "tsmId" : 10116,
  "level" : 670
}

Magneto switch dataId 10120

Hall sensor value can be

  • 0 = open
  • 1 = closed
{
  "tsmId": 10120,
  "hall" : 0
}

Acceleration dataId 10130

Acceleration data is given as milli-Gs.

{
  "tsmId": 10130,
  "accx" : -10,
  "accy" : 15,
  "accz" : 990
}

System dataId 10140

Battery level is given as percentage 0-100%.

{
  "tsmId": 10140,
  "batl" : 76.2
}

Location data 10150

Latitude and longitude are given as decimal degrees, altitude and location accuracy as meters, speed as meters per second, and heading degrees.

{
  "tsmId": 10150,
  "lat"  : 65.00000,
  "lon"  : 24.00000,
  "alt"  : 100,
  "lacr" : 5.1,
  "spd"  : 50.1,
  "hdg"  : 320.1
}

Weight data 10160

Weight given as raw ADC reading from load cell sensor.

{
  "tsmId": 10160,
  "weight": -85972
}

ADC voltage data 10170

Voltage given as ADC reading from sensor. Unit is volts.

{
  "tsmId": 10170,
  "voltage": 3.111
}

ADC resistance data 10171

Resistance given as ADC reading from sensor. Unit is ohms.

{
  "tsmId": 10171,
  "resistance": 1023
}

Pressure data 10172

Pressure from sensor. Unit is pascals.

{
  "tsmId": 10172,
  "pressure": 1023
}

Gateway Internal Sensor Application interval configuration request 10600

This request is always sent from a cloud by using common event id tsmEv : 30 (Application profile update requested).

{
  "tsmId": 10600,
  "tsmEv": 30,
  "data":"gps=300;pressure=-1;temp=60",
  "transactionId":1234
}

R&D configuration message for GISA application. Message details subject to changes, spec may be outdated.

GISA responds with current configuration with message tsmId=10601 and tsmEv=31.

Gateway Internal Sensor Application interval configuration response 10601

This response is always sent by a device using common event id tsmEv : 31 (Application profile update response).

{
  "tsmId": 10601,
  "tsmEv": 31,
  "data":"gps=300;pressure=-1;temp=60",
  "transactionId":1234
}

Gateway Internal Sensor Application GNSS mode configuration request 10602

This request is always sent from a cloud by using common event id tsmEv : 30 (Application profile update requested).

Idle interval defines location update interval in idle state, unit is seconds. Measurement interval defines location update interval in active state, unit is seconds. Impact threshold defines rule for measurement interval change. Impact value over the threshold cause updates to happen in measurement interval. If no impacts (over the threshold) are received within active state measurement interval, the update interval is set to idle interval value. Impact threshold unit is mg.

{
  "tsmId": 10602,
  "tsmEv": 30,
  "transactionId":1234,
  "idleInterval": 20,
  "measurementInterval": 5,
  "impactThresholdMin": 200
}

GISA responds with current GNSS mode configuration with message tsmId=10603 and tsmEv=31.

Gateway Internal Sensor Application GNSS mode configuration response 10603

This response is always sent by a device using common event id tsmEv : 31 (Application profile update response).

{
  "tsmId": 10603,
  "tsmEv": 31,
  "transactionId":1234,
  "idleInterval": 20,
  "measurementInterval": 5,
  "impactThresholdMin": 200
}

Debug memory read request 10900

This request is always sent from a cloud by using common event id tsmEv : 32 (Firmware information request).

{
  "tsmId": 10900,
  "tsmEv": 32,
  "address" : Number,
  "length" : Number
}
  • address is memory address where to read data.
  • length is length of data to read.

Debug memory read response 10901

This response is always sent to a cloud by using common event id tsmEv : 33 (Firmware information response).

{
  "tsmId": 10901,
  "tsmEv": 33,
  "address" : Number,
  "data" : { "type" : "Buffer", "data" : Array }
}
  • address is memory address where data was read.
  • data is CBOR buffer containing data read from device. Returned data length may be shorter than requested.

Debug Send UDP packet command 10902

This command is always sent from a cloud by using common event id tsmEv : 35.

{
  "tsmId": 10902,
  "tsmEv": 35,
  "transactionId" : Number,
  "host" : String,
  "port" : Number,
  "payload" : { "type" : "Buffer", "data" : Array }
}
  • transactionId is optional 32-bit integer number that will be included in the response as is.
  • host is target hostname for UDP packet.
  • port is target port for UDP packet.
  • payload is CBOR buffer containing payload of UDP packet.

Device sends following style response for this command.

{
  "tsmId": 10902,
  "tsmEv": 36,
  "address": String,
  "port": Number,
  "transactionId": Number
}
  • address is resolved IP-address of target hostname.

Debug Read DNS server address 10903

This command is always sent from a cloud by using common event id tsmEv : 32.

{
  "tsmId": 10903,
  "tsmEv": 32,
  "transactionId" : Number
}
  • transactionId is optional 32-bit integer number that will be included in the response as is.

Device sends following style response for this command.

{
  "tsmId": 10903,
  "tsmEv": 33,
  "transactionId" : Number,
  "address": String,
  "port": Number
}
  • address is IP-address of DNS server used by device.
  • port is port number for DNS server.

Debug Read IP address 10904

This command is always sent from a cloud by using common event id tsmEv : 32.

{
  "tsmId": 10904,
  "tsmEv": 32,
  "transactionId" : Number
}
  • transactionId is optional 32-bit integer number that will be included in the response as is.

Device sends following style response for this command.

{
  "tsmId": 10904,
  "tsmEv": 33,
  "transactionId" : Number,
  "address": String
}
  • address is IP-address of device.

Debug Read network mask 10905

This command is always sent from a cloud by using common event id tsmEv : 32.

{
  "tsmId": 10905,
  "tsmEv": 32,
  "transactionId" : Number
}
  • transactionId is optional 32-bit integer number that will be included in the response as is.

Device sends following style response for this command.

{
  "tsmId": 10905,
  "tsmEv": 33,
  "transactionId" : Number,
  "address": String
}
  • address is network mask for device.

Debug Read default IP route 10906

This command is always sent from a cloud by using common event id tsmEv : 32.

{
  "tsmId": 10906,
  "tsmEv": 32,
  "transactionId" : Number
}
  • transactionId is optional 32-bit integer number that will be included in the response as is.

Device sends following style response for this command.

{
  "tsmId": 10906,
  "tsmEv": 33,
  "transactionId" : Number,
  "address": String
}
  • address is default IP route address for device.

Debug Read DHCP status 10907

This command is always sent from a cloud by using common event id tsmEv : 32.

{
  "tsmId": 10907,
  "tsmEv": 32,
  "transactionId" : Number
}
  • transactionId is optional 32-bit integer number that will be included in the response as is.

Device sends following style response for this command.

{
  "tsmId": 10907,
  "tsmEv": 33,
  "transactionId" : Number,
  "data": String
}
  • data is string with current DHCP lease information of device.

Reserved for temporary R&D use only: 10950-10999

Next