Quick Links
Cumulocity agent for Bosch XDK rapid
prototype device
This project is a device agent to connect the
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:
Control & monitor heating -> temperature sensor, acoustic sensor
•
Control & monitor lighting in building -> digital light sensor
•
Control & monitor machine -> acceleration sensor
•
1 Content
1.
Overview
2.
Register XDK in Cumulocity
3.
Operate XDK
3.1
Execute operations on device
3.2
3.3
3.4
3.5
3.6
4.
5.
2
Overview of features XDK device agent
The device agent allows to send measurements from the XDK to your Cumulocity tenant.
These measurements can be visualised in dashboards. In the downstream direction
operation commands can be sent to the XDK using the device managment app in
Cumulocity: change configuration of sensors, stop/start publishing measurements and
restarting the device.
To get an idea of the currently active configuration the device agent sends its current
1
©2019 Software AG. All rights reserved.
Bosch XDK
to Cumulocity (C8Y Agent for
Summary of Contents for Bosch XDK
-
Page 1: Table Of Contents
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. - Page 2 WIFISSID WIFIPASSWORD 2. Register XDK in Cumulocity & upload SMART Rest Template 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.
- Page 3 2. The agent uses the MAC of the WLAN chip as an external device ID. You have to check the sticker on the bottom side of your XDK under WLAN: 7C_7C_7C_7C_7C_7C e.g. 7C7C7C7C7C7C NOTE: remove the form the WLAN MAC adress 3.
- Page 4 2. After starting the XDK the agent runs in "Registration Mode" and waits until the registration is accepted in your cumulocity tenant. So you have to accept the registration in your C8Y tenant. See as well step 2.1. 3. After accepting the registration in C8Y the XDK agent receives device credentials and stores these on the SD card.
-
Page 5: View Events Sent From Device
• stop start View events sent from device You can view the last events transmitted form the XDK by accessing the app Device and follow: Device Management>Devices>All Devices. Then choose your XDK management and select the template... -
Page 6: Status Indicated By Leds
WIFI chip • config.txt 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 the are written to the config file on WIFI. -
Page 7: Define Root Certificate For Tls
16 Define Root Certificate for TLS For TLS the root certificate of the CA has to be flashed to the XDK. This certificate in included in the header file source\ServerCA.h in PEM format. The currently included certificate from "Go Daddy Class 2 Certification Authority" is used for tenants *.cumulcity.com. - Page 8 Maximal allowed size of flashed binary is exceeded When you use a XDK with bootloader version 1.1.0 the maximal allowed size of the flashed binary can't exceed 600MB. In this case either: cumulocity-xdk-agent.bin flash a new bootloader version 1.2.0 or •...
-
Page 9: Sample Dashboards
INFO | XDK DEVICE 2: SntpTimeCallback : received INFO | XDK DEVICE 2: ----- HEAP ISSUE ---- INFO | XDK DEVICE 2: MQTT_ConnectToBroker_Z: Failed since Connect event was not received INFO | XDK DEVICE 2: MQTTOperation: MQTT connection to the broker failed [0] time, try again ... - Page 10 Dashboard from above is build using the following standard Cumulocity widgets: 1. SCADA widget on the basis of SVG Container_V01.svg 2. Rotation widget to show the position of he XDK 3. Alarm widget to show recent alarms. This requires to define a smart rule "Container doors open":...
- Page 11 After installation of the collada widget you will need to upload the 3D model of the XDk. This is available . The following screenshots shows the required resources/XDK.dae configuration: back to content ©2019 Software AG. All rights reserved.
- Page 12 These tools are provided as-is and without warranty or support. They do not constitute part of the Software AG product suite. Users are free to use, fork and modify them, subject to the license agreement. While Software AG welcomes contributions, we cannot guarantee to include every contribution in the master project.