ECE597 Project SensorTag 3D

From eLinux.org
Revision as of 18:07, 17 November 2014 by Leihao (talk | contribs) (Installation Instructions)
Jump to: navigation, search

thumb‎ Embedded Linux Class by Mark A. Yoder


Team members: Leihao Wei

Grading Template

I'm using the following template to grade. Each slot is 10 points. 0 = Missing, 5=OK, 10=Wow!

00 Executive Summary
00 Installation Instructions 
00 User Instructions
00 Highlights
00 Theory of Operation
00 Work Breakdown
00 Future Work
00 Conclusions
00 Demo
00 Late
Comments: I'm looking forward to seeing this.

Score:  10/100

(Inline Comment)

Executive Summary

SensorTag is a portable low-power module that uses Blueooth Low Energy (BLE, Bluetooth 4.0) and various sensors to communicate data to any BLE receiver. The purpose of this project is to build an application interacting with a beaglebone to track the SensorTag’s rotation in 3D. We'll start off from the previous work SensorTag. We expect to see it sending updates at 10Hz by modifying the firmware.

Packaging

  • Beaglebone Black
  • TI SensorTag SensorTag
  • Bluetooth CSR 4.0 dongle
Beagleboneblack
TI SensorTag

Installation Instructions

  • Get the project repository
 git clone https://github.com/Litou1/sensorTag3D
  • Install necessary packages in the current directory.
npm install -g async 
npm install debug 
npm install noble 
npm install sensortag
  • Obtain the test code
git clone  https://github.com/Lahorde/node-sensortag.git

Update the SensorTag Firmware

NOTE: You will need an iOS device for this!

I obtained the following instructions from this website: http://www.myweathercenter.net/installing-a-new-firmware-for-ti-sensortag/


1) Make the changes to the firmware to get a faster refreshing rage. Here is how to do so (information obtained from: http://e2e.ti.com/support/wireless_connectivity/f/538/t/311302.aspx?pi310978=1):

  • a) Download IAR Workbench: http://supp.iar.com/Download/SW/?item=EW8051-EVAL (make sure to choose 30 day evaluation copy)
  • b) Download BLE-STACK from TI: http://www.ti.com/tool/ble-stack
  • c) In IAR Workbench Open SensorTag.eww file from following path: "C:\Texas Instruments\BLE-CC254x-1.4.0\Projects\ble\SensorTag\CC2541DB\SensorTag.eww"
  • d) After the gyro data is read, the gyro goes into sleep mode. A gyro wake up routine is called. This makes the gyro capture period limited to the gyro startup time which is 60ms. So, in order to get a faster refreshing rate, one must modify to code in HalGyro.c so the gyro does not go to sleep after data is read (line 296). Also, get rid of SENSOR_PERIOD_RESOLUTION in the gyro service source file
  • (Alternatively, instead of changing the firmware manually, you can get the updated version (with faster refreshing rate) from a github repository. Get the A and B images from the following repository: https://github.com/Lahorde/sensor_tag_firmware/tree/master/gyro_period)


    2) Get the SensorTag App from the app from the Apple App Store 3) Connect your iOS device to your computer and open up iTunes.
    4) Under the "Apps" section, go to the bottom of the page to find "File Sharing". The SensorTag App should appear in the "Apps"-list.
    5) Click "Add" on the right hand side and select both firmware files.
    6) Sync iTunes with iOS device.
    7) Open SensorTag App on your iOS device.
    8) Select "Upgrade FW" then "Select FW File" then "Shared Files"
    9) If you already have image A installed, install image B. (If you have B installed, install image A)
    10) Wait till firmware has been updated on your device.

    You have successfully updated your firmware, so now you can have a fast refreshing rate!

    Test the Gyroscope

    Press the side button on your sensorTag so that it enters discovery mode.

    root@beaglebone:~/sensorTag3D/MyRealtime# sudo DEBUG=test_gyro node test_gyro.js
    starting test_gyro
    connect
    discoverServicesAndCharacteristics
    readDeviceName
    	device name = TI BLE Sensor Tag
    readSystemId
    	system id = 90:59:af:0:0:b:b:b0
    readFirmwareRevision
    	firmware revision = 1.5 (Oct 23 2013)
    enableGyroscope
      test_gyro 	x = 2.7 °/s - y = -0.3 °/s - z = -1.1 °/s +0ms
      test_gyro 	x = 2.9 °/s - y = -0.1 °/s - z = -1.5 °/s +114ms
      test_gyro 	x = 2.6 °/s - y = -0.5 °/s - z = -1.5 °/s +68ms
      test_gyro 	x = 2.6 °/s - y = -0.4 °/s - z = -1.5 °/s +140ms
      test_gyro 	x = 2.7 °/s - y = -0.2 °/s - z = -1.5 °/s +71ms
      test_gyro 	x = 2.7 °/s - y = 0 °/s - z = -1.5 °/s +147ms
      test_gyro 	x = 2.8 °/s - y = -1 °/s - z = -1.5 °/s +62ms
      test_gyro 	x = 2.7 °/s - y = -0.2 °/s - z = -1.3 °/s +76ms
      test_gyro 	x = 2.4 °/s - y = -0.5 °/s - z = -1.3 °/s +134ms
      test_gyro 	x = 2.6 °/s - y = -0.7 °/s - z = -1.5 °/s +70ms
    

    Now, we can see that data are transmitted about the rate of 100 ms on average (10Hz).


    User Instructions

    To use the program run ./boneServer.js as shown below

    Go to 192.168.7.2.9090 and click on the ball and cube image.

    Wait a few seconds to connect.

    The image should be rendering on the screen as shown below.

    Highlights

    Here is where you brag about what your project can do.

    Include a YouTube demo.

    Theory of Operation

    This is the flow of our program:

    BallAndCube123.jpg

    Work Breakdown

    • Major Tasks:

    1) Get previous work working: Lei Hao and Yashi
    2) Look into firmware for faster refreshing rate: Lei Hao and Yashi
    3) Update javascript file to be compatible with new firmware version: Lei Hao
    4) Documentation: Lei Hao and Yashi


    Future Work

    Additional things that can improve project:

    • There are still some glitches in the program. For instance, the image isn't able to do a full 360 degree turn when you do a 360 degree turn on the SensorTag.


    Conclusions

    In conclusion, our project is able to pretty accurately display the SensorTage image and it's movements. We were also able to look into the firmware and update the refreshing rate to be faster than the previous project.




    thumb‎ Embedded Linux Class by Mark A. Yoder

    References: