Thing

Typically, a thing entity is structured as follows:

• Thing ID - (String) - composed of namespace and name separated by a colon (:) character.

  The namespace needs to fit the requirements described at the Namespace.

  The name will differ, depending on your use case:

  • The thing ID for a gateway is <namespace>:<gatewayId>.
  • The thing ID for an edge services runtime thing representation is <namespace>:<gatewayId>:edge:services:runtime.
  • The thing ID for OSGi bundles thing representation is <namespace>:<gatewayId>:edge:services:bundles.
  • The thing ID for OSGi configurations thing representation is <namespace>:<gatewayId>:edge:services:configurations.
  • The thing ID for an Device thing representation is <namespace>:<gatewayId>:<Device UID>.
• Features

  The thing features are constructed from the corresponding functional Items. For more information go to the sections bellow.

Feature

Typically, a thing feature is structured in the following way:

• Feature ID – (String)

  The feature ID is based on the UID of the particular Functional Item. For the Device items that are represented as a features there is the different rule how the feature ID is generated. For more information refer to the Physical device mapping guide.

• Definitions – (Array of definitions)

  The Definitions are derived from gateway abstractions - which can be modeled based on Eclipse Vorto.

• Properties

  The Feature properties are split into four sections – attributes, configuration, status and events

  • Functional item attributes are mapped to the attributes section
  • Functional item properties with access read and write are mapped to the configuration section
  • Functional item properties with access readable and eventable are mapped to the status section
  • Functional item properties with eventable access are mapped to the events section

The Things agent provides functional Item field annotation @Section that gives possibility to categorize the annotated property according its access. For more information how to categorize functional item property refer to Categorize functional item properties guide.