Bosch IoT Device Management

Register a gateway device running Bosch IoT Edge via the Bosch IoT Manager UI

The content of this text-based tutorial is also available as a video on our Bosch IO YouTube channel.

For the steps on how to provision your device watch:images/confluence/download/attachments/1634792653/registerDeviceYoutubeScreenshot.png

In addition to the Developer Console and the Device Provisioning API, you can also register gateways and edge devices through the wizard of the Bosch IoT Manager Console (referred to as Dashboard).
To try it out, you may use any of the full-featured ready installations of Bosch IoT Edge Agent for the most common edge platforms, which have been provided along with your Bosch IoT Device Management subscription.

To reach them, click Edge Downloads on your Service Subscriptions page.

images/confluence/download/attachments/1634792653/dm_di_gateway_runtimes.png

On the page that opens you will also find out more about Bosch IoT Edge and its components - Bosch IoT Edge Agent and Bosch IoT Edge Services.

images/confluence/download/attachments/1634792653/dm_di_Edge_Downloads.png

For our example we will use a Linux-based gateway simulation, so select one among the first three options (depending on your hardware), and install it as described in the installation instructions in the Bosch IoT Edge Agent documentation.

Now that you have a device which you can provision, go back to your subscription on the Service Subscriptions page and click Go to Dashboard.

Device Provisioning wizard

  1. In the Dashboard enter the Device Management perspective, then click Register Device.

    images/confluence/download/attachments/1634792653/dm_di_registerDevice.png
  2. You will see the following wizard where you should identify and authenticate the device, as explained below:
    images/confluence/download/attachments/1634792653/dm_di_registerDeviceWizard1.png

    1. In Device type you can choose between a gateway, a standalone device, or an (edge) device via a gateway

    2. The Auto-provisioning field is optional and is applicable only if you chose the gateway option above. When activated, it will automatically fulfill the provisioning of all edge devices connected to this gateway, through a Bosch IoT Edge Services Runtime.

    3. In the Namespace field enter the namespace of your subscription. You may check it in the Developer Console under Namespaces or in the Things Dashboard under Namespaces.

    4. The next field on this dialogue - AuthID - is optional and indicates an already created identity with which the device should be authenticated. If you already have an AuthID and you want to use it for this device, check the AuthID box and the password fields will be automatically populated with the associated password.

    5. As an alternative to the AuthID, fill in the Password and Confirm Password fields by manually typing your password or automatically generating and copying it.

    6. Click Next if you want to open the second dialogue of the wizard which contains optional fields or directly click Finish.
      images/confluence/download/attachments/1634792653/dm_di_registerDeviceWizard2.png

  3. On the second dialogue, you can:

    1. select the directory group to which the device will be added automatically. This group may be changed later on.

    2. add specific attributes for the device by typing in the desired property name and its corresponding value.

  4. Click Finish and wait until a new window appears containing the device provisioning information in JSON format.

    images/confluence/download/attachments/1634792653/dm_di_deviceProvisioning_json.png
  5. Finally, click Download to store a copy of the result to your local machine. You will need the provisioning.json file in the next steps - the device-side actions.

Make sure to not alter the file name or the file content, because Bosch IoT Edge is pre-configured to consume the content as is.

Device-side actions

Move or paste the provisioning.json file in the root directory of the extracted folder of your Bosch IoT Edge Agent which you downloaded from the service subscription page (as described above).

If you have not installed the Edge Agent yet, follow the installation instructions in the Bosch IoT Edge Agent documentation.

Upon the launch of the Edge Agent , through the start.sh script (see Bosch IoT Edge documentation for more details), Bosch IoT Edge will automatically use the provisioning settings from the provisioning.json file to connect to the Bosch IoT Suite.

Once the Edge Agent has successfully connected to the cloud service, you will see the newly registered device as part of your device fleet in the IoT Manager Console (see screenshot) and can explore its features and attributes, as well as send device management commands to it.

images/confluence/download/attachments/1634792653/dm_di_registeredGateway.png

In our example the registered gatewayDevice represents a field gateway. If you applied the auto-provisioning option, all edge devices connected to the field gateway via Bosch IoT Edge Services will be provisioned automatically upon start-up. For more information on how to do this, visit Enable Edge Services for Device Management package . Upon success all edge devices will appear in the IoT Manager Console, as part of the specific gateway.

images/confluence/download/attachments/1634792653/registeredGateway4.png