Bosch IoT Device Management

Step 1 - Register your demo device with the cloud service

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

For steps 1 to 4 watch:

images/confluence/download/attachments/1634787919/Virtual-demo-device-tutorial---provisioning-telemetry-and-remote-control-1.png

Before the virtual device can upload its data into the Bosch IoT Suite, you will need to register it.

Subscribe to a service instance

We assume you have already a valid subscription to Bosch IoT Device Management, otherwise please get yourself a free instance.

Subscribe: https://accounts.bosch-iot-suite.com/subscriptions/new/subscription/bosch-iot-suite-for-device-management/

If you need help with subscribing, read our guide or watch our video tutorial on how to subscribe on our YouTube channel.

Navigate to the Bosch IoT Suite Console

Let us assume, you start your journey at the list of subscriptions https://accounts.bosch-iot-suite.com/subscriptions/

Click Go to Developer Console.

images/confluence/download/attachments/1634787919/developer-console.png

In case this is a new subscription, create a namespace. The namespace is required to register devices and digital twins with a unique ID.

Find help at Register a namespace.

Provisioning

  1. Click Provisioning in the left sidebar.

    The Settings view will guide you with the required input for provisioning:

  2. From the first drop-down, choose Use Vorto information model.

  3. In the new view you will see all Vorto models available.
    Select the row of the model VirtualDemoDevice (version 2.0.0).

  4. In the new view you will see details for the demo device.
    Click Select to confirm this is the model for your demo device.

  5. Set thing/device ID: First, select a namespace.

  6. Enter a unique name.
    The full identifier that our Hub and Things service will register is "your.namespace:your-device-name".

  7. Provide credentials for your device authentication.
    Username and password are pre-selected.

  8. Enter a password in plain text.

  9. Confirm with Next.

    images/confluence/download/attachments/1634787919/demo-provisioning.png

    As you might need other options when you will later provision a different type of device, keep in mind that each info (i) icon on the user interface will provide further help instructions to guide you into the right direction.

  10. The preview will indicate green markers if all entry values are valid.

    1. In case something went wrong, you can inspect the Request body.

    2. Proceed with Send request

      images/confluence/download/attachments/1634787919/demo-provisioning-send.png

      The Request body shows the thing in JSON notation. There, you can also see the prefilled features based on the Vorto model that was selected.


  11. The Connect device view will indicate your successful request:

    • Further it presents useful links for setting up the device;

    • Remember the password or store it safely, as you will never see it again in plain text in the console;

    • The Go to thing button will open the thing details in the Things section.

      images/confluence/download/attachments/1634787919/demo-provisioning-success.png

Summary - What is happening behind the scenes

Upon success, Bosch IoT Hub has registered the demo device and its credentials and a corresponding thing (digital twin) has been created with a default policy.

All entities (device, thing and policy) have the same ID.
Whereas, the authentication ID (which will be requested for the firmware settings uses an underscore character "_" instead of the colon separating the namespace from the name).

Manage your digital twin in section Things

images/confluence/download/attachments/1634787919/demo-thing.png

Thing > Information

The first section in the thing's detail view provides a link Show more information, which opens the information view on the right side.

This Information view is not a standard feature for all things generated via the Vorto model, but only available for this demo purposes.

It allows to simulate the device in a Web browser or on your cell phone.

In case you prefer to open it in browser e.g. to easier share your screen with a customer, support, etc.: use a completely other browser or at least a private tab to show that the device is potentially in a complete other network.

The demo device and the Bosch IoT Suite Console will not share the same session nor the same authentication to our cloud service in the backend.
Instead,

  • the demo device simulates the hardware.

  • and the console shows the digital twin values, like your custom monitoring application could do.