Provisioning of devices via developer console

images/confluence/download/attachments/894245057/provisioning.svg

If you are prefer provisioning a gateway, find an example at Connect gateways running Bosch IoT Edge.

Steps to follow for provisioning a stand-alone device

Navigate to the Bosch IoT Suite Console

The Bosch IoT Suite Console (aka developer console) is a Web UI of the Bosch IoT Suite, which supports various use cases of the Bosch IoT Suite.

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 - in the context of the Bosch IoT Things service - called thing.

  1. Navigate to the Bosch IoT Suite portal https://accounts.bosch-iot-suite.com/subscriptions/.

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

    images/confluence/download/attachments/894245057/subscriptions-go-to-developer-console.png

    The developer console will open in a new browser tab.

Provide settings for provisioning

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

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

    • Settings: provide essential settings (this step is already selected and the related view is opened, too)

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

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

  2. In the Settings view, 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.
    First, select a Namespace.
    In case you have not defined a namespace yet, you will need to do it now.

  5. Enter a unique Name.
    The full identifier that our Hub and Things services 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 manage and refine the data (thing ID, device credentials, attributes, features) according to your needs.

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

    1. The Manage tab will indicate all valid sections with images/confluence/download/thumbnails/894245057/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/894245057/dev-console-provision-from-scratch-preview.png

Save the response and prepare the connection of your device

The Connect device view provides information 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/894245057/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 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.