Register a gateway device

images/inline/8ea111c905db5e1aaa449b58cf216e8c86491d9c.png

Steps to follow to provision a gateway device:

Prepare the provisioning request

The following device provisioning steps create valid credentials for your gateway.

  1. From the Service Subscriptions page of Bosch IoT Suite portal, click Go to Developer Console.

    images/confluence/download/attachments/1698703895/dm_serviceSubscriptions_devConsole.png
  2. 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

  3. In the Settings view, the preset option Start from scratch is pre-selected by default and you can continue with this one.

  4. Select how the device is connected (as a stand-alone, gateway device or edge device). The stand-alone device is pre-selected but for our device management use cases you should select Gateway device from the drop-down menu.

  5. Click Enable automatic provisioning of edge devices. This is needed, if you want your gateway to automatically register all devices attached to it.

  6. In the Thing ID section you will need to specify the ID. This will be used for the device, thing, and policy.
    The full identifier that the Bosch IoT Device Management will register is "your.namespace:your-device-name".

  7. The Namespace field will be populated if a namespace is already associated with this specific subscription.

    In case you have not defined a namespace yet, you will need to do it now. See Register a namespace.

  8. Enter a unique Name for the gateway.

  9. Provide a Password for your device in plain text.

  10. Confirm with Next.
    images/confluence/download/attachments/1698703895/dm_getStarted_provisionDevConsole1.png

Preview and send the provisioning request

  1. Once on the Preview view, check whether all provided data is ready for provisioning (indicated by images/confluence/download/thumbnails/1698703895/success.png ).

    Before sending the request, you are able to manage and refine the data (thing ID, device credentials, attributes, features) according to your needs.
    You can also view the Request Body in JSON notation which is based on your settings and will be sent.

  2. Send the request.

    images/confluence/download/attachments/1698703895/dm_getStarted_provisionDevConsole2.png

Save the response and prepare the connection of your gateway

Upon success, you have created the following entities:

Device, thing and default policy have the same ID.

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

  1. 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.

  2. You can download the results. Click Save response.
    A file called provisioning.json will be downloaded to our local machine.
    It holds the provision results containing important properties to configure your device, and can easily be ingested by our Bosch IoT Edge Agent in the next steps.

    images/confluence/download/attachments/1698703895/dm_getStarted_provisionDevConsole3.png