Bosch IoT Things Protocol

The Bosch IoT Things protocol covers two communication channels to address two different aspects of devices and their digital representation: twin and live.

Twin

The first aspect handles the digital representation of a device or any IoT asset. This thing entity (alias digital twin) is managed with the Things service and its state and properties can be read and updated. The channel to work with the digital representation is called twin.

This channel is available both at the Bosch IoT Things HTTP API and the WebSocket interface which talks the Bosch IoT Things Protocol. (The REST-like API is not scope of this specification but mentioned here to outline the context.)

Updating a digital twin via protocol

Bosch IoT Twin Things Protocol

A command can be sent to the Things service to request a modification of a thing. When the Things service handled the command successfully, i.e. the updated thing is persisted, the service publishes an event. An event is the unit that describes a modification of a thing, e.g. a property change, or an attribute change. When sending a command, a response can be requested. The Things service (asynchronously) replies to such commands as soon as the change has been applied.

Managing the policy for a digital twin via protocol

Similar to the Policies resources at the HTTP API, you can manage the policy via protocol.

Protocol specification:
https://www.eclipse.org/ditto/protocol-specification-policies.html

Examples:
https://www.eclipse.org/ditto/protocol-examples-policies-createpolicy.html

Searching for digital twins via protocol

All search filters and options described at Search resources can also be applied when employing the reactive-streams protocol for search.

Protocol specification:
https://www.eclipse.org/ditto/protocol-specification-things-search.html

Examples:
https://www.eclipse.org/ditto/protocol-examples-search.html

Live

The channel to work with the physical device is called live channel.

Commands, events and messages are directly exchanged when using the live channel.

Bosch IoT Live Things Protocol

Commands are defined to be used to change properties of e.g. connected device. In case a response to a command is requested, the receiver must fulfill this request. It is also always required that a live thing event is published after a command has been applied (to the device) successfully.

A message carries a custom payload and can be answered by another, correlated message.

Imprint Legal info Privacy statement