EasyManua.ls Logo

Bosch XDK - User Manual

Bosch XDK
12 pages
Print Icon
To Next Page IconTo Next Page
To Next Page IconTo Next Page
Loading...
1 ©2019 Software AG. All rights reserved.
Cumulocity agent for Bosch XDK rapid
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:
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 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
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
Question and Answer IconNeed help?

Do you have a question about the Bosch XDK and is the answer not in the manual?

Summary

Overview of features XDK device agent

Register XDK in C8 Y tenant

Prepare SD card

Format SD card and adapt configuration file for device registration.

Register XDK in Cumulocity & upload SMART Rest Template

Create device registration in Cumulocity and upload the SMART Rest Template.

Install XDK Workbench

Install the XDK Workbench development environment and configure for Cumulocity.

Prepare project

Clone the git repository and import/build the project in the XDK Workbench.

Flash your C8 Y Device Agent

Flash the Cumulocity device agent onto the XDK using the XDK Workbench.

Procedure when re-registering device

Steps for deleting and re-registering the XDK device in Cumulocity.

Operate XDK

Execute operations on device

Issue operations and messages to the XDK from Cumulocity via shell or widgets.

View events sent from device

Access the Device Management app to view events transmitted by the XDK.

Buttons

Understand the functions of the XDK's physical buttons for device control.

Detailed configuration

Details on sensor measurements sent by the C8Y Agent for XDK to Cumulocity.

Status indicated by LEDs

Table describing XDK LED status indications for mode and possible causes.

Define Root Certificate for TLS

Instructions for flashing the root CA certificate to the XDK for secure TLS connections.

Troubleshooting

Guidance and solutions for common issues encountered during XDK setup and operation.

Troubleshooting Specific Errors

Maximal allowed size of flashed binary exceeded

Resolving issues when the flashed binary exceeds the bootloader's size limit.

Error after building and flashing

Steps to take when errors like 'Application Firmware Corrupted' occur.

Workspace path contains spaces

Error resolution for issues caused by spaces in the XDK Workbench workspace path.

Error configuring XDK project

Troubleshooting errors when configuring the Cumulocity XDK project, e.g., adding XDK nature.

Advanced Troubleshooting and Configuration

Log in XDK Workbench shows HEAP ISSUE

Increase heap size in FreeRTOSConfig.h to resolve HEAP ISSUE exceptions.

Config file cannot be pared

Verify Linux line endings for correct parsing of configuration files.

Dashboard with SCADA widget

Guidance on building dashboards using the SCADA widget and SVG resources.

Cumulocity Widgets and Customization

Standard Cumulocity widgets for dashboard

Details on using SCADA, Rotation, Alarm, and Data Point widgets in Cumulocity dashboards.

Rotation widget

Using the custom Cumulocity collada-3d-widget to display XDK rotation.

3 D Model Configuration

Upload 3 D model for Collada widget

Steps to upload the XDK 3D model (XDK.dae) for the Collada widget configuration.

Summary

Overview of features XDK device agent

Register XDK in C8 Y tenant

Prepare SD card

Format SD card and adapt configuration file for device registration.

Register XDK in Cumulocity & upload SMART Rest Template

Create device registration in Cumulocity and upload the SMART Rest Template.

Install XDK Workbench

Install the XDK Workbench development environment and configure for Cumulocity.

Prepare project

Clone the git repository and import/build the project in the XDK Workbench.

Flash your C8 Y Device Agent

Flash the Cumulocity device agent onto the XDK using the XDK Workbench.

Procedure when re-registering device

Steps for deleting and re-registering the XDK device in Cumulocity.

Operate XDK

Execute operations on device

Issue operations and messages to the XDK from Cumulocity via shell or widgets.

View events sent from device

Access the Device Management app to view events transmitted by the XDK.

Buttons

Understand the functions of the XDK's physical buttons for device control.

Detailed configuration

Details on sensor measurements sent by the C8Y Agent for XDK to Cumulocity.

Status indicated by LEDs

Table describing XDK LED status indications for mode and possible causes.

Define Root Certificate for TLS

Instructions for flashing the root CA certificate to the XDK for secure TLS connections.

Troubleshooting

Guidance and solutions for common issues encountered during XDK setup and operation.

Troubleshooting Specific Errors

Maximal allowed size of flashed binary exceeded

Resolving issues when the flashed binary exceeds the bootloader's size limit.

Error after building and flashing

Steps to take when errors like 'Application Firmware Corrupted' occur.

Workspace path contains spaces

Error resolution for issues caused by spaces in the XDK Workbench workspace path.

Error configuring XDK project

Troubleshooting errors when configuring the Cumulocity XDK project, e.g., adding XDK nature.

Advanced Troubleshooting and Configuration

Log in XDK Workbench shows HEAP ISSUE

Increase heap size in FreeRTOSConfig.h to resolve HEAP ISSUE exceptions.

Config file cannot be pared

Verify Linux line endings for correct parsing of configuration files.

Dashboard with SCADA widget

Guidance on building dashboards using the SCADA widget and SVG resources.

Cumulocity Widgets and Customization

Standard Cumulocity widgets for dashboard

Details on using SCADA, Rotation, Alarm, and Data Point widgets in Cumulocity dashboards.

Rotation widget

Using the custom Cumulocity collada-3d-widget to display XDK rotation.

3 D Model Configuration

Upload 3 D model for Collada widget

Steps to upload the XDK 3D model (XDK.dae) for the Collada widget configuration.

Bosch XDK Specifications

General IconGeneral
BrandBosch
ModelXDK
CategoryMulti-service Platforms
LanguageEnglish