McAllen Software User Manual
Contents
1. 1 6 Intel Corporation Copyright 2009 2 Installation 2 1 Installation Prerequisites 2 1 1 Linux Software The McAllen Linux Software requires the default installation of one of the following operating systems Red Hat Enterprise Linux 5 3 5 4 Desktop 32 bit Red Hat Enterprise Linux 5 3 5 4 Server 32 bit Red Hat Enterprise Linux 5 3 5 4 Desktop 64 bit Red Hat Enterprise Linux 5 3 5 4 Server 64 bit Ubuntu Server 9 04 Jaunty Jackalope 32 bit Ubuntu Server 9 04 Jaunty Jackalope 64 bit ON Oboe The McAllen Linux Software has the following prerequisites BlueZ Bluetooth Stack tested with versions 3 70 and 4 53 BlueZ headers and libraries tested with versions 3 70 and 4 53 MySQL Community Server 5 1 or later MySQL Connector C 6 0 Dr Intel Corporation Copyright 2009 2 1 2 Windows Software The McAllen Windows Software requires one of the following operating systems 1 Microsoft Windows XP SP2 or later 2 Microsoft Windows Vista 3 Microsoft Windows 7 The McAllen Windows Software has the following prerequisites 1 Microsoft NET Framework Version 3 5 2 2 Installing the McAllen Linux Software To install the McAllen Linux Software perform the following steps in order 1 Login to your Linux system as user root if possible If you cannot login as root you must run all commands below prefixed by the sudo command 2 Open a terminal window if one is not already open 3 Change directory to the di2. McAllen Software User Manual 1 0 Intel Corporation Copyright 2009 Table of Contents 1 1 A Rn een ba EER i REI i ei i NN 3 1 2 SEOPE A Rene 3 2 1 INSTALLATION PREREQUISITES 2 220 kennen liste nenne lese ensure 4 2 1 1 ONU Software a E E isso 4 DA 22 Windows DO IWATE Ha e Aen as aie eal oe Aa A RAL An eA 5 2 2 INSTALLING THE MCALLEN LINUX SOFTWARE ccococononononononononononononononononononononononononononononononononononononononononono 5 2 3 INSTALLING THE MCALLEN WINDOWS SOFTWARE coococonononononononononononononononononononononononononono nono no nono nononanononono 5 2 4 UNINSTALLING THE MCALLEN LINUX SOFTWARE occonocononononononononononononononononononononononononononononono nono nononononononono 6 2 5 UNINSTALLING THE MCALLEN WINDOWS SOFTWARE ccocococononononononononononononononononononononononononononononononononononono 6 3 1 USING THE MCALLEN LINUX SOFTWARE cocococonononononononononononononononononononononononononononono nono s ees nono no nono nononanononono 7 LER COMMON USAR CLA AAA A A a 7 3 2 USING THE MCALLEN WINDOWS SOFTWARE cccococononononononononononononononononononononononononononononononononononononanonanononon 8 A Intel Corporation Copyright 2009 1 Introduction 1 1 Purpose This document is meant to serve as a guide to installing and using the Intel McAllen Software 1 2 Scope This document pertains to the Intel McAllen Windows Software Version 1 0 0 2 and McAllen Linux Software Version 1
3. Shimmer for acquisition for each Shimmer Send sequence walking 1 s inside 16 bit payload to Bluetooth the MSP430 on each Shimmer 16 bit payload to Bluetooth the MSP430 on each Shimmer inside payload to Bluetooth the MSP430 on each Shimmer inside payload to Bluetooth the MSP430 on each Shimmer 0xa5 Send sequence walking Set the data pattern generated by mal 01101001 s inside payload to the MSP430 on each Shimmer Bluetooth 0xa6 Continuous sequence from 0 to Oxfff Set the data pattern generated by incremented by 1 inside payload to the MSP430 on each Shimmer Bluetooth Intel Corporation Copyright 2009 decremented by 1 inside payload to the MSP430 on each Shimmer Bluetooth OxcY to the SPI port port continuously port continuous OxbY Send filled value represented by 3 N copies of the Y nibble 0000yyyyyyyyyyyy to SPI bus continuousl OxcY Send filled value represented by 3 N A copies of the Y nibble 0000yyyyyyyyyyyy to Bluetooth Go to Idle Mode Set all shimmers to Idle Mode startup state Oxd0 Send first 2048 bytes from the Diagnostic Data Table DDT located in the MSP 430 Flash memory Oxd1 Send second 2048 bytes from Diagnostic Data Table DDT located in the MSP 430 Flash memory Oxd2 Send third 2048 bytes from Diagnostic Data Table DDT located in the MSP 430 Flash memor Oxd3 Send fourth 2048 bytes from Diagnostic Data Table DDT located in the MSP 430 Flash memor Oxd4 Send fifth 2048 b
4. ck the Uninstall button Follow the on screen instructions and click OK to uninstall the application Intel Corporation Copyright 2009 3 Usage 3 1 Using the McAllen Linux Software The McAllen Linux Software executable is called start_acquire_data and is installed under the folder usr local McAllen bin The application takes the following command line arguments at startup al11 Pair all detected Shimmers to the adapters on the system in sequential order fills up each adapter before moving to the next best_case Pair all detected Shimmers to the adapters on the system in a balanced configuration ensures an even split of Shimmers among the number of adapters in the system emulation XxX Start the application in Shimmer emulation mode with XX being the number of Shimmers to emulate XXXX Pairs one Shimmer which has a name containing the string e g XXXX entered If there is a second command line argument the string is used as an exclude string the application will ignore any detected devices containing this string in the name Once the application is started it will scan for Bluetooth devices in range in all modes except emulation mode If no Shimmer devices are found during this scan the application will report this and exit If any Shimmer devices are found the application will create a thread for each one and attempt to pair with it A message is printed indicating successf
5. eckboxes are two radio buttons which control the source of input data If the first radio button is selected called Shimmer Data by default the system assumes there is a remote system running the Linux software and will send receive commands and data to it If the second radio button is selected called Captured Data by default the system will assume there is no remote system and will not attempt to send commands via TCP When a start command is issued it will be handled internally and the data stored in the CSV file inputData txt will be looped through and displayed Note If the McAllen Linux Software is acquiring data but the Windows application is restarted there is no mechanism to report this to the McAllen Windows Software However another Start command may be sent to resume display of the data without causing any problems Intel Corporation Copyright 2009 4 Revision History REVISION DATE NAME DESCRIPTION OF CHANGE 9 29 2009 Chris Bradley Completed review with modifications Intel Corporation Copyright 2009 5 Appendix A Command List Command Name Description Start Acquisition Start acquiring data and send to the remote client database the remote client database the remote client Mode Select the A D converter as the data source for acquisition for each Shimmer source for acquisition for each Shimmer source for acquisition for each Shimmer SPI bus for each Shimmer bus for each
6. rectory containing the installer script McAllenSetup sh For example cd media cdrom 4 Run the self extracting installer script McAllenSetup sh For example McAllenSetup sh 2 3 Installing the McAllen Windows Software To install the McAllen Windows Software perform the following steps in order 1 Navigate to the drive or folder containing the installer McAllen Setup msi 2 Double click the installer McAllen Setup msi and follow the on screen instructions Intel Corporation Copyright 2009 2 4 Uninstalling the McAllen Linux Software To uninstall the McAllen Linux Software perform the following steps in order 1 Login to your Linux system as user root if possible If you cannot login as root you must run all commands below prefixed by the sudo command Open a terminal window if one is not already open Change directory to the directory containing the installer script McAllenSetup sh For example cd media cdrom Run the self extracting installer script McAllenSetup sh with the argument uninstall For example McAllenSetup sh uninstall 2 5 Uninstalling the McAllen Windows Software To uninstall the McAllen Windows Software perform the following steps in order 1 23 Open Control Panel and double click on the Add Remove Programs Windows XP or Programs and Features Windows Vista or later applet Locate the entry in the programs list called McAllen GUI and cli
7. tion 3 2 Using the McAllen Windows Software After installation the McAllen Windows Software can be executed by clicking the Start Menu shortcut that is created under the Intel McAllen folder in the Start Menu When the application is launched it reads a text file called labelNames txt which is stored in the application s installation folder by default C Program Files Intel McAllen This file contains a number of lines of text which map the text displayed on each GUI control to the desired name which is to the right of the equals sign e g graphCheckboxl Graph 1 will cause the text next to the first checkbox to read Graph ibaa Once the application is running you can send commands to the Linux application through TCP The IP Address and Port numbers should match those of the machine you wish to connect to these are also configurable with the labelNames txt file Expanding the Quick Commands box allows you to send Start and Stop Acquisition commands without entering any commands in the Command text box Alternatively you can enter any command in the box and click Send to send it Any single byte command in ASCII hexadecimal format can be sent through this text box e g SA 5a Ox5A or Ox5a A list of valid commands can be found in Appendix A Below the command box you will see 7 checkboxes which control the visibility of the graph at that position on the page these apply to all tabs Below the ch
8. ul pairing A message is also printed indicating the TCP port the application is listening for commands on Once running commands may be sent from a remote host through TCP such as the McAllen Windows Software To exit the application CTRL C should be used Note that when the application is running the receive data tables in MySQL are locked to increase write performance To access the data in the tables exit the application and the locks will disappear The data is written into the database named McAllen The default user for MySQL is root with no password 3 1 1 Command Usage Intel Corporation Copyright 2009 Valid commands for the system are listed in the table in Appendix A In general commands should only be sent when the system is not acquiring data The only command that should be sent during data acquisition is the Stop Acquisition 0x56 command The default mode of the Shimmer is a 1 KHz sample rate with the data payload alternating from full scale to zero To use data from the A D converter send the command Enter A D to Bluetooth Mode 0x61 This will select the data source to be the A D converters on the Shimmer when data acquisition is started To use the various built in test patterns send the command Enter MSP430 to Bluetooth Mode 0x63 followed by the desired test pattern command e g 0xA6 This will select the MSP430 microcontroller on the Shimmer to be the source of the data being sent during acquisi
9. ytes from Diagnostic Data Table DDT located in the MSP 430 Flash memory Oxd5 Send sixth 2048 bytes from Diagnostic Data Table DDT located in the MSP 430 Flash memory Oxd6 Send seventh 2048 bytes from Diagnostic Data Table DDT located in the MSP 480 Flash memory Intel Corporation Copyright 2009 N A N A N A A lt gt SE Diagnostic Data Table DDT located in the MSP 430 Flash memory 1000 samples sec to 1000 Hz 500 samples sec to 500 Hz 250 samples sec to 250 Hz 100 samples sec to 100 Hz 50 samples sec to 50 Hz 25 samples sec to 25 Hz 10 samples sec to 10 Hz samples sec to 5 Hz sample sec to 1 Hz Return to default mode database active real Shimmer data default mode the database Oxf2 Activate Shimmer emulation mode Instruct the Linux software to switch from reading data from Bluetooth to using text files as a source for each Shimmer already paired Oxf3 Kill remote application Kills the main process of the Linux software Intel Corporation Copyright 2009
Download Pdf Manuals
Related Search