Professional Documents
Culture Documents
prototype device
This project is a device agent to connect the Bosch XDK to Cumulocity (C8Y Agent for
XDK). The XDK is a quick and professional prototyping platform for prototyping IoT use
cases.
For this demo a Cumulocity tenant and an XDK device is required. For a free trial tenant
you can register here.
When the XDK is registered in a Cumulocity tenant the environmental sensor readings
measured by the XDK are sent to the Cumulocity IoT cloud. Potential use cases are:
1 Content
1. Overview
2. Register XDK in Cumulocity
3. Operate XDK
3.1 Execute operations on device
3.2 View events sent from device
3.3 Detailed configuration
3.4 Buttons
3.5 Status indicated by LEDs
3.6 Define Root Certificate for TLS
4. Troubleshooting
5. Sample dashboards
But before running the XDK in OPERATION mode you have to register the device in your
Cumulocity tenant. Initially the XDK is in REGISTRATION mode. The registration is
achieved automatically through the bootstrap meachnism. This is described in further
detail here.
After successful registration - device credentials are received by the XDK - the XDK
restarts automatically. Commands can be send from the Cumulocity App
Devicemanagement to change the sensor speed, toogle an LED or switch on/off sensors,
see documentation https://www.cumulocity.com/guides/users-guide/device-
management/#shell .
back to content
1. Prepare SD card
2. Register XDK in Cumulocity & Upload SMART Rest Template
3. Install XDK Workbench 3.6.1: https://developer.bosch.com/web/xdk/downloads
4. Prepare project
5. Flash your C8Y Device Agent on your XDK
6. Procedure when re-registering device in Cumulocity tenant
4 1. Prepare SD card
NOTE: Make sure your SD card is smaller than 32GB, otherwise it can't be formatted in
the FAT filesystem format
1. Before starting the XDK a C8Y device registration for the XDK has to be created in
your C8Y tenant, please see [here](https://www.cumulocity.com/guides/users-
guide/device-management for a detailed description. For this resgitration you
need the external device ID. This is decribed in the next step.
7 4. Prepare project
1. Delete entries MQTTUSER und MQTTPASSWORD from the file config.txt stored
on the SD card
2. Delete XDK from Cumulocity Tenant. Navigate to the device in the Cockpit and
delete device
3. Restart XDK and keep the button with 2 dots pressed for deleting the
configuration on the WIFI flash, see as well handing of buttons.
4. Register XDK again as before.
back to content
10 Operate XDK
This section contains all information that is relevant once the XDK is registered in
Cumulocity
1. XDK started!
2. Publish stopped!
3. Publish stated!
13 Buttons
The buttons have following on the XDK have the following functions:
14 Detailed configuration
The C8Y Agent for XDK sends the following sensor measurements to C8Y:
When registering the XDK a config on an SD card has to be inserted in the XDK. Upon
sucessful registration, i.e. device receives credentials from Cumulocity, the config value
including theMQTTUSER, MQTTPASSWORD are written to the config file on WIFI. From then on
the XDK can operate without an SDCard.
Nevertheless in certain situations it is helpful to only change the WIFI settings and keep
all the other settings. Then one can set values for WIFISSID,WIFIPASSWORD in
the config.txt on SD and thus overwrite settings stored on the file system of the WIFI
chip. The values defined in the config on the SDCard always take precedence.
NOTE: When setting up a hot spot for the WIFI connection, mak esure you use a network
band of 2.4GHz, the XDK only supports this band.
In addition to the above listed measurements the battery staus is send ervery minute.
Operation
Blinking Off Off & Starting
Registration
Blinking Received
Any Any Operation
once command
Running -
Off Blinking Any Operation
Publishing
Running -
Off On Any Operation Publishing
stopped
Running -
Off Off Blinking Registration Waiting for
credentials
Running -
Off Off On Registration Registration
successful
back to content
back to content
17 Troubleshooting
#define ENABLE_SENSOR_TOOLBOX 0
24 Sample dashboards
26 Rotation widget
Using the Cumulocity custom widget published on the
github: https://github.com/SoftwareAG/cumulocity-collada-3d-widget you can view the
rotation of the
After installation of the collada widget you will need to upload the 3D model of the XDk.
This is available resources/XDK.dae. The following screenshots shows the required
configuration:
back to content
For more information you can Ask a Question in the TECHcommunity Forums.