This example provides a web application to manage your things. It shows how to use the Bosch IoT Things API to communicate with the "digital twin" of the device and the physical device itself.
Further, the example assumes that you have successfully connected a device, and shows how to send command-and-control messages via the HTTP API to the physical device. Once your message reaches the device, and the firmware knows how to react on it, the respective change is reported back to the digital twin and visible on the frontend.
The frontend will look like in the following screenshot.
The Bearer Token input field is required for authentication. In case you went through the octopus-firmware or octopus-simulator example, you might have created already a Suite authorization token. Otherwise, create a Suite Auth Client as described in the Asset Communication package documentation. Upon request, the client will issue a token, which is valid 60 minutes.
The example uses the following dependencies:
Installation:
$ npm installRunning Dev-Server (with hot reloading):
$ npm run serveYou can now open your browser and navigate to the app at http://localhost:3000
Issue a new token at https://accounts.bosch-iot-suite.com/oauth2-clients/. Copy it to your clipboard and enter it into the Bearer Token field. Then click connect and you should see a list with things, which have been created in this context. At least we assume the Octopus device has been provisioned using the same token, thus, the policy should allow to read it and to send messages.
Click on a thing to see its details (JSON).
Depending on your device, you can now send command messages to it.
This example provides LED control on the Octopus board via messages.
Send following message to the topic switch_led.
{
"r": 0,
"g": 0,
"b": 0,
"w": 0
}This is in fact a POST request at the Messages API.
The response will be either success or an error message.
In case the request was successful, the LED is switched off. The board will send the respective telemetry data to the Hub, which forwards the data to Bosch IoT Things.
The web application uses SSE ('server sent events') to get live updates from Bosch IoT Things - these updates are directly reflected in the web application.
From this point on, feel free to extend the code and build your own IoT solution.
Happy coding!