Bosch IoT Device Management

Device features

To follow this page, your entry point is Bosch IoT Suite UI (Developer console) > Device .

You are already familiar with the available device information and most of the device resources. In this page we are going to focus on the device features. The data related to a feature is managed in the form of a list of properties. These properties can be categorized, e.g. to manage the status, the configuration or any fault information.

Table of contents:


To work with the features of a particular device, just select Features from the right column of the Device blade and the Features blade will open to the right.

images/confluence/download/attachments/2221978982/dm_deviceFeatures_view.png

The Features blade is separated in two sections, the Updates view and the Manage view.

Updates view

The Updates tab is selected and open by default. It displays all features of the device and their current property values. When a property value of a feature changes, the tile of the related feature is highlighted.

See what happens when we connect our device which already has a couple of features:

images/confluence/download/attachments/2221978982/dm_deviceFeatures_update.gif

We could say that this view is intended for monitoring purposes.

Manage view

The manage view as its name suggest allows you to:

  • view feature information, its properties and definition

  • create, edit and delete features

  • search for features

  • set feature properties

  • manage the feature definitions

View feature information

To view the information of an already existing feature select it from the Manage view.

As part of the Feature blade you will find:

  • The ID of the feature - a unique string to identify the feature.

  • The feature properties in JSON format.

  • The feature definition.

images/confluence/download/attachments/2221978982/dm_deviceFeatures_viewFeature.png

Add a feature

To add a new feature follow the steps described below:

  1. Click the Add feature blue button and type in the needed feature information.

  2. Type in the feature ID.

  3. Add the feature properties as a JSON object.

  4. Add a feature definition by clicking the blue Add definition button.
    The Vorto model definition should follow the standard convention for Vorto models, in particular namespace:name:version. It should be the ID of an existing model or one that is expected to be created, in order to benefit from the capabilities defined in it.

    In addition, you may configure access to your private Vorto repository and use your private Vorto models stored in it. Check how to do that here.

    In our example we will create a feature using the already existing LedLamp Vorto model.
    images/confluence/download/attachments/2221978982/dm_deviceFeatures_addFeature1.png

  5. You can get the needed definition ID of an already existing Vorto model of the from the Vorto models UI feature as shown below:

    images/confluence/download/attachments/2221978982/dm_deviceFeatures_getDefinition.gif



    In our example it is com.bosch.iot.suite.example:LedLamp:1.0.0.

  6. Paste the definition ID in the field and click OK.

    images/confluence/download/attachments/2221978982/dm_deviceFeatures_addFeature2.png
  7. Once you click OK on the Feature blade the new feature will be added to the list of device features.

    images/confluence/download/attachments/2221978982/dm_deviceFeatures_addFeature3.png

Edit a feature

To edit a feature just select it from the Manage view and change any values in the Feature blade as shown above.

Delete a feature

To delete a feature:

  1. Select it from the Manage view.

  2. Click the Delete feature button on the right of the search.

    images/confluence/download/attachments/2221978982/dm_deviceFeatures_deleteFeature.png