Bosch XDL120 User Manual
Bosch XDL120 User Manual

Bosch XDL120 User Manual

Data logger/ data streamer for xdk110

Advertisement

XDL120 | User Manual
XDL120: Data Logger/ Data Streamer for XDK110
User Manual
XDK110: Data Logger / Data Streamer: User Manual
Document revision
Document release date
Workbench version
Document number
Technical reference code(s)
Notes
Data subj ect to change without notice
1.3
July 20th, 2018
3.0.0 and above
BCDS-XDK110-DataLogger-Streamer
Data in this document is subject to change without notice. Product
photos and pictures are for illustration purposes only and may differ from
the real product's appearance.
This document is confidential and under NDA inherent with the purchase
of an XDK110.
Advance information – Subject to change without notice
1 | 25
Bosch Connected Devi ces and Sol utions

Advertisement

Table of Contents
loading

Summary of Contents for Bosch XDL120

  • Page 1 XDL120 | User Manual 1 | 25 XDL120: Data Logger/ Data Streamer for XDK110 User Manual XDK110: Data Logger / Data Streamer: User Manual Document revision Document release date July 20th, 2018 Workbench version 3.0.0 and above Document number BCDS-XDK110-DataLogger-Streamer...
  • Page 2: Table Of Contents

    XDL120 | User Manual 2 | 25 Table of contents 1 Introduction 1.1 Key features of the XDL120 DataLogger/Streamer ......................4 1.2 Components of XDL120 shipment ............................4 2 Feature details 2.1 Accurate logging of sensor samples with timestamps......................5 2.2 Global time stamp reference to sensor data........................5 2.3 Online streaming of sensor samples via WLAN.........................5...
  • Page 3 4.5 Access control..................................23 4.5.1 Media Handling 4.5.2 Access to Networks 4.6 Encryption ....................................24 4.7 Termination of service ................................24 5 Known Issues 6 References Data subj ect to change without notice Bosch Connected Devi ces and Sol utions...
  • Page 4: Introduction

     User manual (this document) NOTE If you are using the trial version of the XDL120, the features and usage as described in this manual are identical to the full version with the exception of the logging time. The trial version only allows for logging of up to 30 minutes per log.
  • Page 5: Feature Details

    2.1 Accurate logging of sensor samples with timestamps The XDL120 allows logging with high data rates for all on board sensors except the acoustic noise sensor without loss of data, when individual sensors are configured. Data is homogeneously timestamped with millisecond resolution based on the FreeRTOS system time.
  • Page 6 XDL120 | User Manual 6 | 25 Table 2: LED pattern of the XDL120 State Name LED State Condition for appearance / State description Yellow Orange Data logger /streamer Data logger / streamer initialization is not not ready / completed.
  • Page 7: Usage Of The Xdl120

    7 | 25 3 Usage of the XDL120 3.1 Prerequisites The following items are needed to use the XDL120:  microSD card for configuration and data storage  microSD card reader to write configuration and to retrieve sensor data  XDK device with micro USB cable ...
  • Page 8: Installing Python

    Devices view, e.g. from the explorer window. The binary will now be flashed to the XDK  After the binary file was flashed, the XDK will automatically start the flashed application. The XDL120 is now ready to log and stream sensor data.
  • Page 9: Configuration

     An alternative method is installing python and upgrading required package via single utility called “Anaconda” https://www.anaconda.com/download/ NOTICE: The following script files included in the XDL120 shipment are also needed for the conversion and must be available in the same folder as the datalogger.py: convert.py, custom_binary_parser.py, custom_dataframe_generator.py, msgpack_binaryparser.py, outputformater.py, xdk_wifi_datalogger.py.
  • Page 10: Sensor Configuration

    When data logging is started it needs to be stopped and the XDK turned off before the SD card should be removed. This is necessary because the XDL120 does not integrate auto detection regarding a removed SD card and will show unintended behavior.
  • Page 11 </bmi160> NOTICE The <marker> section of the config.xml is needed for internal use and must be enabled (true) for the XDL120 to work correctly. Please do not change this configuration. The full list of all parameters is summarized in Table 3 to Table 8. For more details, please refer to the data sheets of the respective sensors.
  • Page 12 Sensor Tag in XML Possible setting XML hex Notes parameter file value 10 Hz (standard) 0x00 Output Data <odr> 02 Hz 0x01 Rate 06 Hz 0x02 Data subj ect to change without notice Bosch Connected Devi ces and Sol utions...
  • Page 13 Coefficient COEFF_4 0x02 COEFF_8 0x03 The response time depends on the COEFF_16 0x04 filter coefficient selected. Note: The number of samples will increase if the Data subj ect to change without notice Bosch Connected Devi ces and Sol utions...
  • Page 14 Manual ENABLE 0x00 keep DISABLE Configuration <cdr> NORMAL_BRIGHTNESS 0x00 Division ratio used to divide the Current HIGH_BRIGHTNESS 0x01 photo diode current. Devision Ratio Data subj ect to change without notice Bosch Connected Devi ces and Sol utions...
  • Page 15: System Configuration

    Data format: The XDL120 offers the possibility to either store / stream files in binary or in MessagePack format. MessagePack is an efficient binary serialization format. It lets you exchange data among multiple languages like JSON and is aimed for users who want to integrate data from XDL120 directly into a third-party application via WLAN streaming.
  • Page 16: Data Extraction & Conversion

    4Data security concept. 3.6 Data extraction & conversion As mentioned, the XDL120 allows the user to either log data onto a microSD card, or to stream data via WLAN to a UDP port. The following sections describe how to use these features.
  • Page 17 Other parameters for a particular sensor are the respective sensor value descriptions as shown in Figure 4 . Figure 4: BMA280 detail view: .csv file A complete list of the different row parameters for the different sensors is displayed in Table 1Table 9. Data subj ect to change without notice Bosch Connected Devi ces and Sol utions...
  • Page 18: Data Streaming

     Set the <enable> tag within the <wifi> tag within the <datatransfer> tag in the XML configuration to true and enter the relevant parameters in the wlan.txt (see section 3.5). In addition, set sntp_globalAddress in the config.xml file to enable SNTP time stamp. Data subj ect to change without notice Bosch Connected Devi ces and Sol utions...
  • Page 19 For explanation on the file content, see Table 9. The XDL120 also supports to stream data via Enterprise WPA2 WLAN network for increased security. To enable WPA2 Enterprise connection and communication, make sure that in the wlan.txt file WLAN_ENTERPRISE and WLAN_SERVICEPACK_UPDATE are set to true apart from providing the right credentials for WLAN_SSID, WLAN_USERNAME and WLAN_PASSWORD.
  • Page 20: Dos And Don'ts

    3.7 Dos and Don’ts An inserted SD card is necessary for data logging purpose and configuration of the XDL120. If no SD card is inserted, the application will show an error indication via the LEDs. To insert the XDK, turn off the device (I/O switch), insert the SD- Card, and Turn the XDK back on.
  • Page 21: Data Security Concept

    IoT application. This is why we provide our users, in addition to the general Bosch guidelines and principles, with a security concept for the XDL120 data logger &...
  • Page 22: Stakeholders And Roles

    4.2.1 XDL user The user is the owner of the XDK device and can use the XDL120 to log XDK sensor data. The user can do the following:  Flash and run the XDL120 on the XDK ...
  • Page 23: Access Control

    This is especially the case in use case scenario 3. Classification whether data is sensitive or not depends on the use case and has to be done by the user. In summary, Bosch suggests a strong protection of the confidentiality, a very strong protection of the integrity, and a strong protection of the availability.
  • Page 24: Access To Networks

    4.7 Termination of service If the life cycle of the XDL120 ends or the purchased licence expires, the user should remove all external memory storages. In addition, the user should delete all data and perform a secure overwriting. This can be done by sending a command "E”...
  • Page 25: Xdl120 | User Manual

    XDL120 | User Manual 25 | 25 Bosch Connect ed Devices and Solut ions GmbH Ludwig-Erhard-Straße 2 72760 Reutlingen Germany support@bosch-connectivity.com Data subj ect to change without notice Bosch Connected Devi ces and Sol utions...

Table of Contents