background image

 

 

XDL120 | User Manual 

4 | 25 

Data subj ect to change without notice 

Bosch Connected Devi ces and Sol utions  

1

 

Introduction 

The Data Logger / Streamer application for Cross-Domain Development Kit XDK110 is intended to extract  raw data from 
the XDK with the highest performance achievable with the build-in sensors, giving the user the ability to acquire reliable, 
highly accurate data for further analysis. The data are stored locally on the SD card within the device. Alternatively,  the data 
can also be sent to a network computer via WLAN. 

1.1

 

Key features of the XDL120 DataLogger/ Streamer 

 

Easy data acquisition from on-board sensors of XDK (except  acoustic noise) with high data rates 

 

Customizable: Sensor selection and configuration via xml file, no programming needed 

 

Saves data locally on SD card (logging mode)  

 

Transmits data continuously via WLAN to a UDP socket (streaming mode) (Enterprise WPA2 option available) 

 

Auto save feature with configurable saving frequency 

 

MessagePack format for integration in third-party applications 

 

Time-equidistant sampling with global time synchronization support with SNTP over WLAN 

 

Simply pressing a button starts and stops data logging/streaming 

1.2

 

Components of XDL120 shipment 

The following components are part of the XDL120: 
 

 

Binary  files (full version): 

o

 

XDL120_Rev1.bin : for XDK with bootloader <v1.0 

o

 

XDL120_Rev2.bin : for XDK with bootloader ≥v1.0 

 

Binary  files (trial version): 

o

 

XDL120_trial_Rev1.bin : for XDK with bootloader <v1.0 

o

 

XDL120_trial_Rev2.bin : for XDK with bootloader ≥v1.0 

 

Datalogger.exe  (alternative: datalogger.py  python script for systems with python3 environment available) 

 

config.XML file 

 

wlan.TXT file  

 

XDL120_tolerance_calculation.xls

 

 

EULA / Licence text  (PDF) 

 

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.  
 

 
 

 

 

Содержание XDL120

Страница 1: ... date July 20th 2018 Workbench version 3 0 0 and above Document number BCDS XDK110 DataLogger Streamer Technical reference code s Notes Data in this document is subject to change without notice Product photos and pictures are for illustration purposes onlyand may differ from the real product s appearance This document is confidential and under NDA inherent with the purchase of an XDK110 Advance in...

Страница 2: ... to sensor data 5 2 3 Online streaming of sensor samples via WLAN 5 2 4 Seamless auto save 5 2 5 LED indication on application state 5 3 Usage of the XDL120 7 3 1 Prerequisites 7 3 2 Overview 7 3 3 Installing the application on the XDK 7 3 4 Installing Python 8 3 5 Configuration 9 3 5 1 Sensor configuration 10 3 5 2 System configuration 15 3 5 3 Data transfer configuration 15 3 5 4 Network configu...

Страница 3: ...vices and Solutions 22 4 3 Physical and Environmental Security 22 4 3 1 Use Case Scenario 1 Deployment at private area 22 4 3 2 Use Case Scenario 2 Deployment in industry 22 4 3 3 Use Case Scenario 3 Deployment in public area 22 4 4 Asset Management Media Handling 22 4 5 Access control 23 4 5 1 Media Handling 23 4 5 2 Access to Networks 24 4 6 Encryption 24 4 7 Termination of service 24 5 Known Is...

Страница 4: ...2 option available Auto save feature with configurable saving frequency MessagePack format for integration in third party applications Time equidistant sampling with global time synchronization support with SNTP over WLAN Simplypressing a button starts and stops data logging streaming 1 2 Components of XDL120 shipment The following components are part of the XDL120 Binary files full version o XDL1...

Страница 5: ...For further details on sensor parameters please refer to section 3 5 1 2 2 Global time stamp reference to sensor data The application allows you to configure an SNTP time server see Configuration for details to obtain a global time stamp for your measurement data The Synchronization is done once on power on of the XDK The device will re try to establish a connection up to four times see Table 2 LE...

Страница 6: ...ogging state Blink If a data loss occurred OFF If no data loss occurred ON When the SNTP server did not send a response OR The application is not able to receive data from server OR WLAN connection could not be established Data Loss ON Blink depends on the frequency of the data loss OFF No SNTP error occurred ON If a SNTP error occurred Indicates data loss due to environmental conditions or sub op...

Страница 7: ...iew of XDK shows the user interface of the XDK110 device For more details please refer to the XDK documentation available at www xdk io 3 3 Installing the application on the XDK To use the XDK120 the respective binary file has to be installed flashed onto the XDK device This is done via the XDK workbench Information on how to install the XDK workbench is available on the XDK website www xdk io It ...

Страница 8: ...am sensor data 3 4 Installing Python If you cannot use the datalogger exe to convert the logging files see section 3 6 Python needs to be installed to run the datalogger py script If you can use the EXE file you can skip this chapter To install and setup python Download python version 3 x or higher here https www python org downloads o If working under windows it is recommended to add the Python i...

Страница 9: ...g pypi fastparquet Python is now setup to convert the logged files to required output format 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 con...

Страница 10: ...g tag Enabled tag should contain the value as either true or false 3 5 1 Sensor configuration The XDK provides an accelerometer Bosch Sensortec BMA280 gyroscope Bosch Sensortec BMG160 magnetometer Bosch Sensortec BMM150 inertial measurement unit Bosch Sensortec BMI160 a combined temperature humidity and pressure sensor Bosch Sensortec BME280 and a light sensor Maxim MAX44009 These sensors are conf...

Страница 11: ...cdr max44009 marker enabled true enabled marker sensors To configure the sensors to suit a desired behavior change the parameters according to it For example to set the Gyro Bandwidth of the BMI160 change the value in gyro_bw value gyro_bw to the desired possible value for the bandwidth listed in the table of the configuration parameters sensors bmi160 enabled true enabled Enabled gyro_odr 0x0a gy...

Страница 12: ...ee s 1000 degree s 500 degree s 250 degree s 125 degree s 0x00 0x01 0x02 0x03 0x04 Accelerometer Output Data Rate accel_odr 0 78 Hz 1 56 Hz 3 12 Hz 6 25 Hz 12 5 Hz 25 Hz 50 Hz 100 Hz 200 Hz 400 Hz 800 Hz 1600 Hz 0x01 0x02 0x03 0x04 0x05 0x06 0x07 0x08 0x09 0x0A 0x0B 0x0C Normal mode is selected for acceleration operation Note The product of the bandwidth parameter and Output data rate parameter mu...

Страница 13: ...0x00 0x01 0x02 0x03 Table 6 Sensor parameters for BME280 Sensor parameter Tag in XML file Possible setting XML hex value Notes Output Data Rate odr 0 1 Hz 0 2 Hz 25 Hz 0x00 0x01 0xf9 Output data rate setting resolution of 0 1 Hz Power Mode power_mode SLEEP_MODE FORCED_MODE NORMAL_MODE 0x00 0x01 0x03 The environmental sensor can operate in three different modes sleep forced and normal Standby Durat...

Страница 14: ... for MAX44009 Sensor parameter Tag in XML file Possible setting XML hex value Notes Integration Time integration_time 800 ms 400MS 200MS 100MS 50MS 25MS 12 5ms 6 25ms 0x00 0x01 0x02 0x03 0x04 0x05 0x06 0x07 The integration time is a time window during which a pulse is measured 800ms This is a preferred for boosting low light sensitivity 100ms for high brightness 6 25ms 50ms for manual mode only No...

Страница 15: ...isabled only one binary will be created containing the complete measured sensor values Please note that this feature is only available if the XDL120 is configured for data logging not for streaming 3 5 3 Data transfer configuration The user can select the data transfer medium microSD card or UDP via WLAN By default the data transfer medium is the microSD card The server IP address 6666 is predefin...

Страница 16: ... EXE file or as a python script to parse the sensor data Once the XDL120 binary is flashed on to the XDK take the following steps If you want to synchronize the timestamp via a global timeserver insert a microSD card with the WLAN credentials into the XDK and switch the device on The credentials will then be read and transferred to the flash memory It is recommended to replace the microSD card bef...

Страница 17: ...s internal processing time The file manual csv is holding the template row names which are present in all csv files where sensor values are stored The following names for the rows are stored in manual csv as templates Sensor_ID The sensor id is placed at the start of the preamble Each sensor is defined with specific ID numbers The sensor identification numbers are defined as follows bmi 1 BMI160 b...

Страница 18: ...t Sensor Light strength sensor_id sqn mcu_timestamp dataLength lightStrength RealTimestamp Furthermore the stat csv offers statistics on how much sensor data was lost during the processing time The following parameters are used as row descriptions Lost_count The total amount of times data was lost is stored in stat csv file For each sensor loss count is calculated and updated in the respective fie...

Страница 19: ...AN_Data_Log overwrite Overwrite bin file and all files produced conversion if they exist Default is to prompt if bin file exist Will not check if files exist before conversion c OFFSET temperature_correction OFFSET Temperature correction factor Default is 2 1K See section 3 8 for details Press button 1 on XDK within the configured timeout interval to start logging Data will now be saved as bin fil...

Страница 20: ...eating which can be from the sensor itself as well as from other components used at the time of measurement Unfortunately this self heating depends on manyfactors e g mounting position of the device and airflow This results in an increased temperature reading in the raw data The accuracy of the humidity measurement is stronglyrelated to the temperature as relative humidity is calculated using the ...

Страница 21: ...g from a hardware and software perspective By identifying the stakeholders the risks and implications of various hardware applications the user will gain an understanding on how to protect the physical environment of the XDK as well as the connectivity There will be a strong focus on software security we will look at encryption operational software security information transfers and business conti...

Страница 22: ...ess network gateway and network participants are assumed to be trustworthy The likelihood of security events triggered by unauthorized physical access is assumedto be low 4 3 2 Use Case Scenario 2 Deployment in industry In the second use case scenario the XDK user deploys the XDK device inside industrial environments These areas are usuallyprotected by access controls It is also possible to determ...

Страница 23: ...user The network itself should be protected by state of the art mechanisms like WPA2 In the third use case scenario explicit measures are necessaryto keep the Wi Fi credentials safe There is no access restriction to the Wi Fi network and any third party has access to it If the connection is secured by a standard security mechanism like WPA2 the XDK user should realize mechanisms to securelystore t...

Страница 24: ...transferred to the flash memory Now switch off the XDK and replace the microSD card or delete the wlan txt from the card This way if a third party gains access to the card the network credentials are protected The XDK will always use the internally saved network credentials unless at startup a wlan txt file is discovered in which case the new file will be read and the internally saved configuratio...

Страница 25: ... Manual 25 25 Data subj ect to change without notice Bosch Connected Devices and Sol utions Bosch Connected Devices and Solutions GmbH Ludwig Erhard Straße 2 72760 Reutlingen Germany support bosch connectivity com ...

Отзывы: