Step 1 - Register your Octopus with the cloud service
Before the Octopus can upload its data into the Bosch IoT Suite, you will need to register it.
Bosch IoT Suite service subscription
We assume you have already a valid subscription on Bosch IoT Device Management, otherwise please get yourself a free instance.
Service configuration - namespace
The definition of a namespace and the configuration of the connection are necessary.
In case you have not defined a namespace yet, you will need to do it now. See Register a namespace.
Provide settings for provisioning
Click Provisioning 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
From the drop-down, choose Use Vorto information model
Select Vorto information model OctopusSuiteEdition (version 1.1.0).
Select how the device is connected. The stand-alone device is pre-selected and you can continue with this one.
Set thing ID: First, select a namespace.
Enter a unique name.
The full identifier that our Hub and Things service will register is "your.namespace:your-device-name".
Provide credentials for your device: enter a password in plain text.
Confirm with Next.
Preview and send the provisioning request
The preview indicates with check marks , that you are ready for provisioning.
Before sending the request, you could 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. Here, you can also see the prefilled features based on your selected Vorto model.
Click Send request.
Save the response and prepare the connection of your device
Upon success, the Connect device view provides information to connect the Octopus (e.g. credentials) which should be saved.
Save the response of the provision request containing important properties to configure your device.
A file called provisioning.json will be downloaded to our local machine.
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.
As soon as your device will need to communicate with the Hub service, it will authenticate with the Authentication ID (i.e. "your.namespace_your-device-name") and this password. Therefore, it is important that you remember this password in plain text.
Further, Bosch IoT Hub additionally offers certificate based authentication options. See Device authentication.
For devices which we don't provide a tutorial for, you can use the links displayed in section "useful links to set up the device" to continue , e.g. to get the firmware or to verify the connection that messages have been received.
In this case, you can proceed with the next part of the tutorial: Step 2 - Configure the Octopus.
Upon success, Bosch IoT Hub has registered the Octopus 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 ":".
To see the thing generated out of the model, feel free to click Go to thing and there open the JSON view, where you can see all features.