Getting started with the MSP: Difference between revisions
Karl Koscher (talk | contribs) |
Karl Koscher (talk | contribs) No edit summary |
||
Line 10: | Line 10: | ||
The MSB should be preloaded with the MSB firmware and the Bluetooth chip flashed and configured. If this is not the case, you'll need to [[Sensor_Board_Programming|follow these directions]]. | The MSB should be preloaded with the MSB firmware and the Bluetooth chip flashed and configured. If this is not the case, you'll need to [[Sensor_Board_Programming|follow these directions]]. | ||
= The Software = | |||
== MSP System Software == | |||
Below is a summary of the commonly-used software that runs on the MSP, with links to the reference page for each program. Other MSP system programs are documented [[MSP_System_Software|here]]. | |||
* [[Msb-server|msb-server]] is a program which interfaces with the MSB via the serial port and handles logging of uwar files and transmission of the sensor data over IPC and other shared memory mechanisms. | |||
* [[Logger|logger]] is a program which integrates MSB, LSB, GPS, and Camera data into a single UWAR stream. It <b>must</b> be used if you're collecting data in the UWAR format with anything but the MSB. | |||
* [[Central|central]] is the server for the IPC (Inter Process Communications) package developed by Reid Simmons. IPC provides a simple means of communicating between applications on the same computer and other machines via TCP/IP. Central is used by the [[Msb-server|msb-server]] and several other applications to share information. | |||
* [[Proccontrol|proccontrol]] is a program which launches and monitors all of the other processes involved in the MSP data collection. | |||
= Collecting Data = | = Collecting Data = |
Revision as of 22:05, 21 August 2007
The Hardware
An MSP consists of an iMote2, an MSB, a miniSD card, and optionally, a GPS unit, WiFi dongle, or LSB. If your MSP is not pre-assembled, you'll need to follow these directions to assemble your MSP.
The iMote2
The iMote2 should be preloaded with Linux, configured to automatically load the MSP software off of the SD card. If this is not the case, you'll need to grab the latest system images and flash them onto the iMote2. Unfortunately, with Intel's sale of the PXA line to Marvell, the tools used to reflash the iMote2 are difficult to obtain.
The MSB
The MSB should be preloaded with the MSB firmware and the Bluetooth chip flashed and configured. If this is not the case, you'll need to follow these directions.
The Software
MSP System Software
Below is a summary of the commonly-used software that runs on the MSP, with links to the reference page for each program. Other MSP system programs are documented here.
- msb-server is a program which interfaces with the MSB via the serial port and handles logging of uwar files and transmission of the sensor data over IPC and other shared memory mechanisms.
- logger is a program which integrates MSB, LSB, GPS, and Camera data into a single UWAR stream. It must be used if you're collecting data in the UWAR format with anything but the MSB.
- central is the server for the IPC (Inter Process Communications) package developed by Reid Simmons. IPC provides a simple means of communicating between applications on the same computer and other machines via TCP/IP. Central is used by the msb-server and several other applications to share information.
- proccontrol is a program which launches and monitors all of the other processes involved in the MSP data collection.
Collecting Data
Your first data collection
Collecting data with the MSP is easy:
- Plug in the MSP to the charger until the amber charging LED is no longer solid.
- Copy the latest SD card image to your miniSD card.
- Insert the miniSD card into the unit.
- Press the power button on the MSP. You may need to use a pen or similar object to press the button.
- Wait for the logger to start. When it starts, the LEDs on the MSB will all turn on, and then go back to just green.
- Collect data.
- Press the power button down for at least five seconds. The MSP will shut down after another 5-10 seconds.
- Remove the miniSD card and move (not copy) the files in the msp-data directory to your computer.
If you have Matlab, you can import the data into it:
- Use uwarToMatlab to extract the data from the UWAR files in the msp-data directory.
- Import the resulting .mat files into Matlab.
Otherwise, you can use uwar_cat to generate a text dump of the sensor readings.
Customizing the data collection
If you need to collect data at different sampling rates, simply edit the msb.ini file in the msp directory on the miniSD card. More information on how to edit the msb.ini file is available here.