Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

...

  • receive (values/measurements, events, sysmsgs, images etc...) for processing [publish]
  • send (e.g. actions, jobs, configurations etc.) [subscribe]

Prerequisites

...

  • name of the organization <orgShortName>
  • serial of the sensor/gateway <serial> (a serial is mapped to a location/site)
  • optional: certificate for encrypted connection (SSL/TLS)

...

Attribute nameData type Comments 

sensor_id

StringUnique sensor identifier

processing_level

Stringindicates if there was a problem during the processing on the data. the value will be tagged. 0 mean no problem

timestamp

String

ISO 8601 (with Timezone Information)

in case of an empty string would the server would generate a now() timestamp

value

Number, String, BooleanMeasurement taken

Special sensor: device_gps_location

...

  • this sensor is used to display the gateway status
  • the gateway should try after a successful connect to the MQTT Broker this message. Only by successfully receiving the acknoledgement it can be assured that next messages can be published. (access security might appear)
  • use events with state: "CONNECTED" 
  • on a regular shutdown of the gateway we recommend publishing a state: "OFFLINE" event
  • in order to show a unexpected disconnect we recommend using the MQTT feature lastWillTestament (using an offline payload)
  • the timezone information of the timestamp of the CONNECTED message is used to 

System Messages

Topic: <orgShortName>/sys_msg/<serial>

...