background image

 

 

XDL120 | User Manual 

1 | 25 

Data subj ect to change without notice 

Bosch Connected Devi ces and Sol utions  

 
 

 

 

XDL120: Data Logger/ Data Streamer for XDK110 
User Manual 

XDK110: Data Logger / Data Streamer: User Manual 

Document revision 

1.3 

Document release 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 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 

 

 

 

 

 

Summary of Contents for XDL120

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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 ...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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 ...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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 ...

Reviews: