Cross-Domain Development Kit XDK110 Platform for Application Development

Transcription

1 Examples Overview Cross-Domain Development Kit Platform for Application Development Bosch Connected Devices and Solutions : Data Sheet Document revision 1.0 Document release date 03/08/16 Document number Technical reference code(s) Notes --EXAMPLES-OVERVIEW 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. Subject to change without notice

2 Overview Examples Page 2 XDK Workbench 1.5 Examples Overview PLATFORM FOR APPLICATION DEVELOPMENT The XDK Workbench 1.5 Examples Overview provides a description of each example that can be found in the welcome screen of the XDK workbench. To import one of the examples simply click on one of them in the welcome screen. Table of Contents 1. HTTPEXAMPLECLIENT REQIREMENTS SETUP OUTPUT LEDSANDBUTTONS REQIREMENTS SETUP PROGRAMMING OUTPUT LWM2MEXAMPLECLIENT REQIREMENTS SETUP PROGRAMMING OUTPUT SDCARDEXAMPLE REQIREMENTS SETUP PROGRAMMING OUTPUT SENDACCELDATAOVERUDPANDBLE SENDACCELEROMETERDATAOVERBLE REQIREMENTS SETUP PROGRAMMING OUTPUT SENDDATAOVERUDP SENDVIRTUALSENSORDATAOVERUSB... 12

3 Overview Examples Page REQIREMENTS SETUP PROGRAMMING OUTPUT STREAMSENSORDATAOVERUSB REQIREMENTS SETUP PROGRAMMING OUTPUT WLANNETWORKMANAGEMENT REQIREMENTS SETUP PROGRAMMING OUTPUT XDKAPPLICATIONTEMPLATE... 18

4 Overview Examples Page 4 1. HttpExampleClient This example shows how to use the network stack to perform an HTTP Client Request. HTTPS is not yet working. The example connects to the server and establishes a connection to the server and requests data from the server every 10 seconds. My initial output indicates and error when trying to get data from I don t see where this website is set; perhaps the test server is down or unresponsive to GET requests. 1.1 Reqirements - XDK - USB Cable (USB A to USB micro) - Windows 7 or greater PC with XDK Workbench 1.5 Installed - Available Wireless Network 1.2 Setup - Connect the XDK to the PC via a USB cable - Open XDK Workbench From the Welcome screen, open the HttpExampleClient 1.3 Programming From the project explorer, expand the project, open the source folder and then open the HttpExampleClient.h file Edit the WLAN_CONNECT_WPA_SSID field to match the available networks name Edit the WLAN_CONNECT_WPA_PWD field to match the available networks password Picture 1: HttpExampleClient s Connection Settings Location - Save the file - Clean and build the project - Flash the project to the XDK 1.4 Output When running the program keep the USB plugged in to the PC. The USB will output a string of data you can read to indicate correct functionality.

5 Overview Examples Page 5 Picture 2: HttpExampleClient s USB Output, Visible in the XDK Workbench s Console Window 2. LedsAndButtons This example contains a showcase for the use of LEDs and buttons. The Led and Button example requires no extra programming, it is ready to run immediately. Once programmed you can press the 2 push buttons and will see the LEDs in 4 states. - Push Button 1 Pressed - Red LED State ON - Orange LED State OFF - Yellow LED State ON - Push Button 1 Released - Red LED State OFF - Orange LED State ON - Yellow LED State - OFF - Push Button 2 Pressed - Red LED State ON - Orange LED State ON - Yellow LED State - OFF - Push Button 2 Released - Red LED State OFF - Orange LED State OFF - Yellow LED State - ON 2.1 Reqirements - XDK - USB Cable (USB A to USB micro) - Windows 7 or greater PC with XDK Workbench 1.5 Installed 2.2 Setup - Connect the XDK to the PC via a USB cable - Open XDK Workbench From the Welcome screen, open the LedsAndButtons example 2.3 Programming - Clean and build the project - Flash the project to the XDK

6 Overview Examples Page Output When running the program keep the USB plugged in to the PC. The USB will output a string of data you can read to indicate correct functionality. Picture 3: LedsAndButtons USB Output, Visible in the XDK Workbench s Console Window 3. Lwm2mExampleClient This example demonstrates how to register with a LWM2M Server including the standard LWM2M Objects. Unsecure and encrypted communication is both supported. The example will connect to the Leshan Server which can be accessed on a PC at Currently it is necessary to enter credentials: username: bcds; password: tue123rt143 (should we keep this step and give out the credentials or should we make this more open?). Once the XDK is connected to the network and the Leshan server the orange LED will turn on. From the website you can now click on the desired client and read the objects. Picture 4: Leshan Client - User Interface to the Leshan Server; Client List

7 Overview Examples Page 7 Picture 5: Leshan Client User Interface to the Leshan Server; Object Read 3.1 Reqirements - XDK - USB Cable (USB A to USB micro) - Windows 7 or greater PC with XDK Workbench 1.5 Installed - Available Wireless Network 3.2 Setup - Connect the XDK to the PC via a USB cable - Open XDK Workbench From the Welcome screen, open the Lwm2mExampleClient example 3.3 Programming - From the project explorer, expand the project, open the source folder and then open the Lwm2mExampleclient.h file - Edit the WLAN_CONNECT_WPA_SSID field to match the available networks name - Edit the WLAN_CONNECT_WPA_PWD field to match the available networks password - Edit the CLIENT_CONNECT_PORT field to match the CoAP port Navigate to the Lwm2mInterface.c file and confirm the Leshan Server address is correct (coap:// :5683)

8 Overview Examples Page 8 Picture 6: Lwm2mExampleClient s Connection Settings Location Picture 7: Lwm2mExampleClient s CoAP Server address - Clean and build the project - Flash the project to the XDK 3.4 Output When running the program keep the USB plugged in to the PC. The USB will output a string of data you can read to indicate correct functionality. This string is mainly used for debug purposes. If the output differs from picture 8 then there is an error in the network setup or lwm2m setup.

9 Overview Examples Page 9 Picture 8: Lwm2mExampleClient s USB Output, Visible in the XDK Workbench s Console Window 4. SdCardExample This example contains the showcase for the use of the SD card file system. The example will read the presence of an SD Card in the SD Card slot and turn on the Red LED if one is present. The device will then create and write to the text file TEST_XDK.TXT the text This content is created by SD card Read/Write functionality using FAT32 file system. The code out of the box will continue to write the SD Card again and again, making it difficult to stop the program at an appropriate spot where the SD Card is not corrupted. To circumvent this I added a Stop timer command after the write. The SD Card can be removed from the XDK after the write is complete (as indicated by the output) and read on a computer. 4.1 Reqirements - XDK - USB Cable (USB A to USB micro) - Windows 7 or greater PC with XDK Workbench 1.5 Installed - Micro SD Card 4.2 Setup - Insert the Micro SD Card into the XDK - Connect the XDK to the PC via a USB cable - Open XDK Workbench From the Welcome screen, open the SdCardExample example 4.3 Programming - From the project explorer, expand the project, open the source folder and then open the SdCardExample.c file - In order to capture the SD Card in a readable state add the timer stop function to line OS_timerStop(sdCardWriteReadHandle, WRITEREAD_BLOCK_TIME);

10 Overview Examples Page 10 Picture 9: SdCardExample s Timer Stop Function - Clean and build the project - Flash the project to the XDK 4.4 Output When running the program keep the USB plugged in to the PC. The USB will output a string of data you can read to indicate correct functionality. Read the output and don t turn off the XDK or take out the SD card until the console indicates the write is complete. Picture 10: SdCardExample s USB Output, Visible in the XDK Workbench s Console Window 5. SendAccelDataOverUdpAndBle This example demonstrates how to read sensor values from the BMA280 Acceleration sensor and send the data over WLAN (UDP Broadcast) and Bluetooth Low Energy via the Alpwise Data Exchange Profile. Either use your Android or ios mobile phone (see Android or ios App Store) to connect to XDK and receive the data. Send start to XDK via Bluetooth Low Energy, so that streaming of data begins.

11 Overview Examples Page SendAccelerometerDataOverBle This example streams raw accelerometer data from the BMA280 Acceleration sensor via Bluetooth Low Energy (BLE). The Alpwise Data Exchange Profile is used; Alpwise ios/android App is required. Open the Alpwise app, press the play button, and select the XDK_demo device. Once the device connects select the Data Exchange Profile. Then send start to XDK, so that streaming of data begins and send end to XDK, so that streaming of data ends. Picture 11: Alpwise Screenshots from Andrioid Phone. From top left: Home, Device Scan, Device Profile, Data Exchange Start Command, Data Exchange Data, Data Exchange End Command 6.1 Reqirements - XDK - USB Cable (USB A to USB micro) - Windows 7 or greater PC with XDK Workbench 1.5 Installed - Andoid/iOS phone wih Alpwise BLE App

12 Overview Examples Page Setup - Connect the XDK to the PC via a USB cable - Open XDK Workbench From the Welcome screen, open the SendAccelerometerDataOverBle example 6.3 Programming - Clean and build the project - Flash the project to the XDK 6.4 Output When running the program keep the USB plugged in to the PC. The USB will output a string of data you can read to indicate correct functionality. Picture 12: SendAccelerometerDataOverBle s Output, Visible in the XDK Workbench s Console Window 7. SendDataOverUdp This example demonstrates how to send arbitrary data over WLAN as a UDP broadcast. 8. SendVirtualSensorDataOverUsb The example can print out raw or calibrated data from an array of physical sensors. The default example will capture the XDK s orientation data and can be used with the XDK Virtual Device Monitor Plug In (Window -> Show View -> Other -> Other -> XDK Virtual Device Monitor). The example is configurable to display different sets of data and can also demonstrate different functions of the XDK. The Step Counter will count the number steps taken by the device. The Magnetic Finger Print allows the user to mount the device on object, like a window, and program three unique magnetic finger prints based on the position of the XDK and the object. The device can be programed to print 1 of 6 features, some of these features can be further configured to display different data, or to toggle sensitivity of the function. The following describes the different configurations of the example.

13 Overview Examples Page 13 - Orientation - Euler Degree - Euler Radian - Quaternion (used with Virtual XDK Demo) - All (used with Virtual XDK Demo) - Compass - Humidity - Calibrated Sensors (each sensor can be set up with a status of unreliable, low, medium or high) - Accelerometer - Gyroscope - Magnetometer - Step Counter - Normal - Sensitive - Robust - Magnetic Finger Print 8.1 Reqirements - XDK - USB Cable (USB A to USB micro) - Windows 7 or greater PC with XDK Workbench 1.5 Installed 8.2 Setup - Connect the XDK to the PC via a USB cable - Open XDK Workbench From the Welcome screen, open the SendVirtualSensorDataOverUsb Example 8.3 Programming - Open the project in the project explorer and navigate to the following files: SendVirtualSensorDataOverUSB.c, StepCounter.c, CalibratedSensor.c and OrientationData.c - The files in the above step are all the files necessary to program/calibrate the program to output the desired data Picture 13: SendVirtualSensorDataOverUSB s Programmable Features - Clean and build the project - Flash the project to the XDK

14 Overview Examples Page Output When running the program keep the USB plugged in to the PC. The USB will output a string of data you can read to indicate correct functionality. Picture 14: SendVirtualSensorDataOverUSB s Output with Virtual Device Monitor; Quaternion Orientation Setup 9. StreamSensorDataOverUsb This example will print out the sensor data from the XDK over the USB port to the PCB to be read in the XDK Workbench s Console. The data from each sensor is printed out at the same time. This code can be easily modified to demonstrate the XDK Monitor Plug In (Window -> Show View -> Other -> Other -> XDK Monitor). This plug in will show a graphical stream of the data coming though. To implement this function, open the c file of the data you wish to stream (i.e. LightSensor.c). Scroll down to print function and add the formatted printf line: printf("{[monitor]%s(%lu):light=%d%s}", "Sensor", OS_timeGetSystemTime(), SensorData, "Units"); Format the line exactly as above, with quotes where shown. Light can be edited to match type of sensor data being printed, Sensor is the physical sensor being monitored (i.e. BMA280 or Ambient Light), SensorData is the variable that contains the data value, and Units is the units of measurement for the data being displayed.

15 Overview Examples Page 15 Picture 15: Addition of MONITOR printf Function to Visualize the Ambient Light 9.1 Reqirements - XDK - USB Cable (USB A to USB micro) - Windows 7 or greater PC with XDK Workbench 1.5 Installed 9.2 Setup - Connect the XDK to the PC via a USB cable - Open XDK Workbench From the Welcome screen, open the StreamSensorDataOverUsb Example 9.3 Programming - Add monitor function if desired as described above - Clean and build the project - Flash the project to the XDK 9.4 Output When running the program keep the USB plugged in to the PC. The USB will output a string of data you can read to indicate correct functionality.

16 Overview Examples Page 16 Picture 16: StreamSensorDataOverUsb s Output with XDK Monitor 10. WlanNetworkManagement This example demonstrates how to use the XDK WLAN abstraction to scan for networks, join networks, set a static IP address or dynamically obtain an IP address via DHCP. The example sets up a task that should repeatedly scan for networks and connect/disconnect from a network. However there is a bug in the code and I had to modify the code just to have it cycle through the code once. I commented out the setandgetip function and moved it to the last line of the scannetwork function. As shown in picture 17.

17 Overview Examples Page 17 Picture 17: WlanNetworkManagment Example Quick Code Fix Reqirements - XDK - USB Cable (USB A to USB micro) - Windows 7 or greater PC with XDK Workbench 1.5 Installed - Available Wireless Network 10.2 Setup - Connect the XDK to the PC via a USB cable - Open XDK Workbench From the Welcome screen, open the StreamSensorDataOverUsb Example 10.3 Programming - Open the project and navigate to the file WlanNetworkManagment.h file - Configure the Network and DHCP setting as desired

18 Overview Examples Page 18 Picture 18: WlanNetworkManagement s Network Settings - Clean and build the project - Flash the project to the XDK 10.4 Output When running the program keep the USB plugged in to the PC. The USB will output a string of data you can read to indicate correct functionality. Picture 18: WlanNetworkManagement s Output 11. XdkApplicationTemplate This is an empty template serving as a starting point for new projects.