Provisioning of devices via Bosch IoT Suite Console

images/inline/13c2307e6c0af762a8c7dee7d5e001ffdb8999d1.png

Steps to follow for provisioning a stand-alone device:

Navigate to the Bosch IoT Suite Console

Bosch IoT Suite Console (aka developer console) is a Web UI, which 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 in the context of the Bosch IoT Hub service, and create a digital twin representation of this device called thing in the context of the Bosch IoT Things service.

  1. Navigate to the Bosch IoT Suite portal.

  2. Click Go to Developer Console for your subscribed instance.

    images/confluence/download/attachments/1634787845/dm_serviceSubscriptions_devConsole.png

    The developer console will open in a new browser tab.

Provide provisioning settings

images/confluence/download/attachments/1634787845/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 your prefer to start with a virtual demo device or real hardware, find examples in our Tutorials section, e.g. Device connection - demo device.

  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/1634787845/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/1634787845/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 thing to see the digital twin representation.

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

As soon as your device will need to communicate with Bosch IoT Hub, 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 things via Bosch IoT Suite Console.