Register a Device

Bosch IoT Manager allows registration of gateways and the edge devices connected to them in a couple of simple steps.

For illustration of the process, we will use the pre-configured gateway running Bosch IoT Gateway Software, which is available with your service subscription.

To access it, go back to your package subscription information on the 'Service Subscriptions' page and click 'Gateway Runtimes'.

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

Then download a pre-configured IoT runtime suitable for your system, for example images/confluence/download/thumbnails/1138697945/dm_di_gateway_runtimes_download_for_windows.png , and unzip it.

If you already have an installation of Bosch IoT Gateway Software or you want to use the SDK, download the suitable version of the Connectivity Add-On, then unzip it in <gateway-software-root-directory>/osgi/.

Now that you have a device ready for provisioning, proceed with the 'Device Provisioning Wizard'.

Device Provisioning Wizard

  1. To open the wizard, go to the 'Dashboard' of the Bosch IoT Manager Console and enter the 'Device Management' perspective, then click 'Register Device'.

    images/confluence/download/attachments/1138697945/dm_di_registerDevice.png

  2. On the first dialogue of the wizard, in the 'Device ID' field, enter <namespace>:<deviceId>, using the namespace created for your instance, and a deviceId chosen for the particular device.
    images/confluence/download/attachments/1138697945/dm_di_registerDeviceWizard.gif

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

  4. If you did not apply an AuthID, fill in the 'Password' and 'Confirm Password' fields. You can either type the new password manually, or generate one automatically by clicking the 'Generate' button.

  5. Click 'Next' to open the second dialogue of the wizard with optional fields, where 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.

  6. Click 'Finish' and wait until a new window appears containing the device provisioning information in JSON format. 'Download' the provisioning.json file or 'Copy' its information and save it ito a file named "provisioning.json", as you will need it in the next steps - the device-side actions.

images/confluence/download/attachments/1138697945/dm_di_deviceProvisioning_json.png

Device-side Actions

The provisioning.json content contains all the information you need in order to connect your device to Bosch IoT Suite. Follow these steps:

  1. Directly copy the downloaded file, or alternatively the file in which you pasted the provisioning information, and place it in the relevant folder of the device. The file containing the provisioning information should be named "provisioning.json". In our case the relevant folder is the <gateway-software-root-directory>/osgi/bin/vms folder.

  2. Turn the device runtime ON by using the launch script located at <gateway-software-root-directory>/osgi/bin/vms/<vm-name>.
    In particular, for Windows it is: <gateway-software-root-directory>/osgi/bin/vms/jdk/server.bat

Upon the launch of the gateway runtime, Bosch IoT Gateway Software will automatically use the provisioning settings to connect to Bosch IoT Hub (the service which provides the connectivity layer of the package).

Once the provisioning process is finished you will see the newly registered gateway and a simulated camera edge device as part of your device fleet in the Bosch IoT Manager Console.

images/confluence/download/attachments/1138697945/dm_di_registeredDevice.png

You can proceed with exploring device information and performing instant management actions.