background image

 

 

XDL120 | User Manual 

10 | 25 

Data subj ect to change without notice 

Bosch Connected Devi ces and Sol utions  

 
Three different nodes in the config.xml file are available for user configuration: 
 

 

Sensors: Configuration for all the sensors 

 

System: Configuration such as auto save and data format 

 

Data Transfer: Configuration for enabling/disabling WLAN and configuring the time server 

 
Once the application is started and can read the configurations properly, data logging can be started and stopped by simply 
pressing button one. 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. Please note that errors are displayed via the onboard LEDs of the XDK. For information 
about them please refer to section 2.5 where these are explained in detail. 
 

 
CAUTION
 

 

Do not alter the name or sequence of the tags. 

 

Do not remove any of the tags in the XML file. 

 

Do not add any in-appropriate value OR out of range value to the corresponding 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 configured in the 
config.xml file. Details on the sensors can be found in the “XDK General Information” guide (

www.xdk.io

).  Each sensor has 

a specific set of parameters that can be configured to the need of the use case. The XML configuration file contains already 
all sensor configuration settings. Each sensor can be independently enabled or disabled by selecting the enable tag. 
 

<enabled>

true

</enabled>

  

to enable the sensor 

<enabled>

false

</enabled>

  

to disable the sensor 

 
The following excerpt  shows a sample of the configurable XDK sensors of the config.xml file with only the BMA280 
acceleration sensor enabled. 
 

    

<sensors>

 

        

<bmi160>

 

            

<enabled>

true

</enabled>

 

            

<gyro_odr>

0x0c

</gyro_odr>

 

            

<gyro_bw>

0x00

</gyro_bw>

 

            

<gyro_range>

0x04

</gyro_range>

 

            

<accel_odr>

0x0c

</accel_odr>

 

            

<accel_bw>

0x00

</accel_bw>

 

            

<accel_range>

0x03

</accel_range>

 

        

</bmi160>

 

        

<bmm150>

 

            

<enabled>

true

</enabled>

 

            

<odr>

0x07

</odr>

 

            

<rep_xy>

0x03

</rep_xy>

 

            

<rep_z>

0x03

</rep_z>

 

        

</bmm150>

 

        

<bma280>

 

            

<enabled>

true

</enabled>

 

Содержание 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 ...

Отзывы: