background image

 

 

XDL120 | User Manual 

19 | 25 

Data subj ect to change without notice 

Bosch Connected Devi ces and Sol utions  

 

Start the datalogger server on the UDP port configured using the datalogger.exe using the command prompt on 
Windows. Alternatively,  the Python script datalogger.py can be used to start the server (please refer to section 3.4 for 
the python installation). The arguments of the server call are as follows: 
 

datalogger.exe server [-h] [-i SERVER_IP] [-p SERVER_PORT] [-t TIMEOUT] [-f 
{pandas,csv,hdf,xlsx,json,msgpack,parquet}] [-o OUTPUT] [-c OFFSET] 

or 

python datalogger.py server [-h] [-i SERVER_IP] [-p SERVER_PORT] [-t TIMEOUT] [-f 
{pandas,csv,hdf,xlsx,json,msgpack,parquet}] [-o OUTPUT] [-c OFFSET]  

 

Optional arguments:

 

-h, --help             

 
show this help message and exit

 

-i SERVER_IP, --ip SERVER_IP      

The IP address of the interface connected to the 
network the XDK is on. IPv4 only. Default is 0.0.0.0 
(listen on all interfaces). 

-p SERVER_PORT, --port SERVER_PORT 

The port the datalogger should listen on. Defaults 
to 6666. 

-t TIMEOUT,  --timeout TIMEOUT 

 

Timeout in seconds to wait for a connection. 
Default is 120s. 

-f {pandas,csv,hdf,xlsx,json,msgpack,parquet},  --format 
{pandas,csv,hdf,xlsx,json,msgpack,parquet} 

List of available format to convert  the bin file. 
Default is csv. 

-o OUTPUT,  --output OUTPUT 

Target file name. Default is 'WLAN_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 file on computer.   

 

Press button 1 again to stop logging. When stopped, the server will convert the .bin file to defined format: .csv (default), 
pandas, hdf xlsx, json, msgpack, or parquet.  

 
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.

 Please be aware that making the 

WLAN_SERVICEPACK_UPDATE 

as 

true 

is a 

pre-requisite for any bare-metal XDK to support Enterprise WPA2 connection and leaving this as 

true 

will update the 

WiFi chip every  single time it boots. Therefore, it is advised that the user should set 

WLAN_SERVICEPACK_UPDATE

 to 

false

 after the first time (for example, while re-using the data logger application or after ~one minute since the first device 

boot-up). After this, follow the same steps that were mentioned before.  
 

 

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

Отзывы: