Bosch IoT Device Management - will be discontinued by mid 2024

Provisioning of devices

images/confluence/download/attachments/2230549123/052-provision.png

This guide explains how to provision a stand-alone device:


The Bosch IoT Suite user interface supports various use cases related to device and software management.

One major use case is device provisioning. You will be able to register a device and create a digital twin representation of this device called thing.

Enter the Bosch IoT Suite UI and follow the steps:

Provide provisioning settings

images/confluence/download/attachments/2230549123/dev-console-provision-from-scratch.png

  1. Click Provisioning in the left sidebar.
    The opened view shows the 3 steps required for provisioning:

    • Settings: this view is opened by default

    • Preview: view and manage the data which will be used to provision the device

    • Connect device: prepare the connection of your device by saving the response data and configuration properties

  2. The preset option Start from scratch is pre-selected by default and you can continue with this one.

    If you prefer to start with a device based on a Vorto information model, go through the following examples for more information, depending on your use case:

    For devices based on a private Vorto model definition, see Configure access to a private Vorto repository - legacy first.

  3. Select how the device is connected, e.g. as a stand-alone, gateway, or edge device via gateway.
    The Stand-alone device is pre-selected and you can continue with this one.

  4. In section Thing ID you will need to specify the ID. This will be used for the device, thing, and policy.
    In case you have not defined a namespace yet, you will need to do it now - otherwise the namespace field will be populated with the namespace we just created.

  5. Enter a unique Name.
    The full identifier that Bosch IoT Device Management will register is your.namespace:your-device-name.

  6. Provide a password for your device in plain text.

  7. Confirm with Next.

Preview and send the provisioning request

Before sending the request, you can review, and if needed, manage and refine the data (thing ID, device credentials, attributes, features) according to your needs.

  1. Check whether all provided data are correct and ready for provisioning.

    1. The Manage tab will indicate all valid sections with images/confluence/download/thumbnails/2230549123/success.png .

    2. In tab Request body you can preview and adjust the content in JSON notation.

  2. Click Send request.

images/confluence/download/attachments/2230549123/dev-console-provision-from-scratch-preview.png


Save the response and prepare the connection of your device

The Connect device view provides information needed to connect your device (e.g. credentials) which should be saved.

  1. Save the response of the provision request containing properties which you will need to pass to the physical device or gateway, which will try to connect.
    A file called provisioning.json will be downloaded to our local machine.

  2. Copy your password in plain text and store it at a safe place.
    Note, that your password will henceforth only be displayed in encoded/hashed form.

  3. Click Go to device to see the digital twin representation.

images/confluence/download/attachments/2230549123/dev-console-provision-success.png

As soon as your device will need to communicate with the device connectivity layer, it will need to know the results of this provisioning.

You have provisioned the following entities:

  • A device in the context of Bosch IoT Hub, associated with credentials.

  • A digital twin called thing.

  • The twin is associated with a policy.


Please take into account that the protocol adapters of the Bosch IoT Hub have a caching mechanism in place for devices and their credentials. That means if you make changes in the device's or credentials' properties, it takes some time until the protocol adapters apply the changes. Currently the cache setting is configured to 10 minutes.

To continue the getting started guide see Manage your devices.