|
|
- -------------------------------MEDIAPAD README----------------------------------
- Ver.: 1.00 (February 2011)
- - Initial Release
- Author: Dung Dang
- MSP430 Applications
- Texas Instruments Inc.
- --------------------------------------------------------------------------------
-
- CONTENTS
-
- I. DESCRIPTION
- II. APPLICATION USAGE
- III. PROJECT SOLUTION & FILE CONFIGURATION
- IV. USB SERIAL COM PORT PROTOCOL
-
- I. DESCRIPTION
- -----------------------------------
-
- PC demo application for establishing a serial connection with the LaunchPad
- CapTouch BoosterPack. It receives capacitive touch button presses and capacitive
- wheel gestures that are captured and transmitted by the MSP430, and uses this
- data to simulate virtual keystrokes to control windows media. The program will
- not open a window; instead it will place a small icon into the taskbar
- notification area.
- To exit the program, right-click on the icon, and then select "Exit".
-
- The code was developed with the Express Edition of Visual C++ 2008
- http://www.microsoft.com/express/
- Big thanks to Andreas Dannenberg for creating the .NET COM Serial port
- auto-detection code.
-
- II. APPLICATION USAGE
- -----------------------------------
-
- Upon execution, the application starts looking for a LaunchPad or an eZ430
- emulator compatible USB serial COM port. If no compatible COM port is found,
- the application displays an error message which then exits the application.
- If a LaunchPad COM port is found, the application prompts a greeting start-up
- message. Once the message is closed, the application minimizes itself to the
- taskbar. The application then executes in background, receiving UART data from
- the serial port and translating them into Windows virtual key strokes.
- These keystrokes are determined based on the user capacitive input on the
- LaunchPad CapTouch BoosterPack when the device is in active mode*.
-
- 1. Center button press: Start Media Player [Windows Media Player by default]**
- 2. Bottom arrow button press: Play/Pause
- 3. Left arrow button press: Previous Track
- 4. Right arrow button press: Next Track
- 5. Scroll wheel clockwise: Volume Up
- 6. Scroll wheel counter-clockwise: Volume Down
-
- *Make sure to wake up device before providing touch inputs.
- Device frequently goes to sleep after inactivity. To wake up, slowly wave hand
- 1-2 inch away from the BoosterPack, an LED sequence (slow clockwise, then fast
- counter-clockwise) indicates a device wakeup. Only after device fully wakes up,
- the capacitive touch inputs can be captured and transmitted to the program.
-
- **Depending on the computer system, opening the Media Player might take some
- time.
-
- The prorgam's system tray icon provides an About dialog box and an option to
- exit the application.
-
- III. PROJECT SOLUTION & FILE CONFIGURATION
- -----------------------------------
-
- PROJECT SOLUTION ROOT - MediaPad
- | 430Boost_CapTouchMediaPad.ncb
- | 430Boost_CapTouchMediaPad.sln
- | ReadMe.txt
- |
- +---[MediaPad]
- | | MediaPad.cpp
- | | MediaPad.h
- | | MediaPad.ico
- | | MediaPad.rc
- | | MediaPad.vcproj
- | | MediaPad.vcproj.ENT.a0271518.user
- | | ReadMe.txt
- | | Resource.h
- | | small.ico
- | | stdafx.cpp
- | | stdafx.h
- | | targetver.h
- | |
- | \---[Release]
- |
- \---[Release]
- 430Boost_CapTouchMediaPad.exe <Executable Program>
- 430Boost_CapTouchMediaPad.pdb
-
- Legend: [Directory]
- |---filename
-
- IV. USB SERIAL COM PORT PROTOCOL
- -----------------------------------
-
- Per each event (wake up, go to sleep, touch/press, or gesture), the LaunchPad
- transmits a 2-byte UART packet, which appears from the USB serial COM port on
- the PC. They are specified as follows.
-
- WAKE UP [due to proximity sensor detection]: 0xBE 0xEF
- SLEEP [after period of inactivity]: 0xDE 0xAD
- CENTER BUTTON PRESS: 0x80 0x80
- WHEEL POSITION TOUCH/PRESS [z = touch position]: 0x3z 0x3z [z=1 nibble 0x0-F]
- GESTURE START [z = touch position]: 0xFC 0x2z [z=1 nibble 0x0-F]
- GESTURE STOP: 0xFB 0xFB
- GESTURE & GESTURE END POSITION : 0xGG 0x2z
- GG = [binary] b????????
- First bit is direction: 0 = clockwise, 1 = counter-clockwise
- Last 7 bits = count of gesture movement
- z = ending position of the immediate gesture [[z=1 nibble 0x0-F]
-
- The UART receiver can decipher the packets by comparing them against the fixed
- values (WAKE UP, SLEEP, CENTER BUTTON PRESS, GESTURE START & STOP) or against
- ranges (WHEEL TOUCH = 0x30-0x3F, GESTURE = 0x00-0x1F, GESTURE POSITION =
- 0x20-0x2F)
-
- MediaPad processes all UART packets and checks for their integrity. However, the
- application only uses the inputs from CENTER BUTTON PRESS, WHEEL POSITIONS, and
- GESTURES to generate virtual keystrokes.
|