Track your XDK sensor values remotely!
This guide will help you connect your Cross-Domain Development Kit (XDK) to the Bosch IoT Suite. Once your device is registered with our cloud service, you can access its values over the API.
This opens up plenty of new opportunities to remotely monitor the valuable data in your custom applications, and to process it within your IoT scenarios.
Table of contents
To work through this tutorial, you will need:
Before the XDK can upload its data into the Things service, you will need to register it.
Click Register, and the Bosch IoT Things service will show you the configuration settings generated for your XDK.
Click Save as to store the content in a file called
Alternatively, click Copy and paste the content into a file you have created and given the same name.
Note: If you lose these credentials, you will need to re-register your XDK to generate a new credentials set.
config.txt configuration file by entering two additional values:
SSID- The Service Set Identifier is the name of your Wi-Fi network.
PASSWORD- This is the password used to access your Wi-Fi network.
Copy the configuration file to the SD card’s root directory, and insert the SD card into the XDK.
Note: Make sure to insert the SD card correctly into the slot. If it falls inside the XDK case, you can get it out by shaking the device with the SD card slot facing downwards.
In order to connect to the Bosch IoT Suite, the XDK needs to be flashed with a specific firmware package called BoschXDKCloudConnectivity:
The Workbench will now flash the XDK with the LWM2M firmware. The progress will be logged to the console.
Any problems with the connection will be logged to the console as well.
Upon successful connection, the XDK sensor values are transmitted to the Bosch IoT Things service.
When you remove the USB cable, only the orange and the yellow LED should be active:
Back on the Bosch IoT Things website, you should see your XDK listed under My Things.
An inactive XDK should appear in dark blue, while an active XDK (one that has recently uploaded new sensor data) is displayed in light blue.
The upper ribbon of each tile shows when the most recent change was processed in the cloud.
Each sensor measurement transmitted to the cloud will update the XDK values stored by the Things service.
Please note, however, that Bosch IoT Things will not store the full history of data reported by each sensor, but only the latest value of each.
Your application can directly access data from your Things by using the Bosch IoT Things APIs – the IoT device asset management of the Bosch IoT Suite.
You can refer to the XDK tutorial of the Bosch IoT Things service to learn how to view your sensor data and start writing your own applications.
The access control on the XDK data is organized in a policy. Find details at Control who may access your XDK as a Thing.
Further, in case you need a Basic Authentication flow for your own application, the easiest way is to book additionally a Bosch IoT Permission instance. Find details at Register Evaluation User.
Have fun using the XDK and share your experiences with the community at xdk.io!
The Cross-Domain Development Kit (XDK) is a wireless sensor device that enables rapid prototyping of sensor-based products and applications for the Internet of Things (IoT). Please visit xdk.io to learn more.
The Workbench is a software developer kit equipped with XDK-specific packages.
Download the latest Workbench at https://xdk.bosch-connectivity.com/software-downloads.
The Bosch IoT Suite provides middleware capabilities needed to build sophisticated IoT applications from top to bottom. It is provided as a set of cloud services.
Your XDK is connected to the Bosch IoT Hub service using the OMA Lightweight M2M (LWM2M) protocol and managed using the Bosch IoT Things service. You can book additional Bosch IoT Suite services to use with your IoT project.
Please visit the Bosch IoT Suite website to learn more.
The Bosch-ID service is an offering by the Bosch Group that allows their customers to use one user ID for services provided by various Bosch divisions.
Should you need to change your password or email address, or even close the account, you can do so in the Profile section that is available when you are logged in.
Why do I need two user accounts?
At present, the XDK community does not use the Bosch-ID service. You will be informed in the XDK community once that changes.
Where can I get further support?
The XDK community is happy to share knowledge on all XDK questions at https://xdk.bosch-connectivity.com/community.
If you want to know more about the Bosch IoT Suite services, please use our Bosch IoT Suite contact form.
What is the meaning of the different LEDs?
The XDK comes with four different LEDs that are used to indicate its current status.
Here is an overview of the meaning of each LED:
|General meaning||Specific to LWM2M||Example|
If it is off, there is no cause for alarm.
|If red, orange, and yellow LEDs are all blinking at the same time, a fatal error has occurred. |
Please restart the device.
|orange||Not urgent as long as it is not blinking.||A steady orange LED is nothing to worry about; |
however, if it blinks for long time, action is required.
|yellow||If it is blinking rapidly, action is required.|
The connection to the LWM2M server was successful and the XDK is running.
|green||Your XDK is being charged via USB cable|
If the USB cable had connected the XDK to your computer but the green LED is still off: