Skip to content

Commanding Feature

Idea

Commanding feature provides functionality for applications to send data up to 20 Native MQTT agents. The data could be a command and/or data associated with the command sent to the agents. This feature provides RESTful APIs for the applications to directly send the command and associated data to the agents.

Access

For accessing the commanding feature, you need to have the respective roles listed in Commanding Feature roles and scopes.

Basics

A core.mcmqtt agent must be onboarded to access the commanding feature. For more information, refer to Onboarding Native MQTT Agent.

Onboarding an Agent

Once the agent is onboarded, the agent needs to subscribe to a corresponding MQTT topic to receive commands. For instructions to configure MQTT agents, refer Commanding Feature Async API specifications.

subscribe

In order to respond to a command received, the agent must publish to a predefined topic. For information about the predefined topics, refer to Commanding Feature Sync API specifications.

publish

Features

The Commanding feature exposes its API for applications and services to realize following tasks:

  • Create delivery jobs
  • List all delivery jobs
  • Get, Delete a delivery job
  • Get all commands related to a delivery job

Limitations

  • The maximum number of agents to which a command can be published is 20.
  • The command data size is restricted to 4 kB.

Example Scenario

The application developer of a brewery wants to send commands to certain group of MQTT agents in the brewery's production line.

Any questions left?

Ask the community


Except where otherwise noted, content on this site is licensed under the MindSphere Development License Agreement.


Last update: December 22, 2021