1049 User Guide

	Go to this device's product page

Getting Started

Checking the Contents

You should have received: A PhidgetSpatial 0/0/3 A Mini-USB Cable A mounting hardware kit

Connecting the Pieces

Connect the PhidgetSpatial 3-Axis 5G to your PC using the Mini-USB cable.

Testing Using Windows 2000 / XP / Vista / 7

Make sure you have the current version of the Phidget library installed on your PC. If you don't, follow these steps:

1. Go to the Quick Downloads section on the Windows page
2. Download and run the Phidget21 Installer (32-bit, or 64-bit, depending on your system)
3. You should see the icon on the right hand corner of the Task Bar.

Running Phidgets Sample Program

Double clicking on the icon loads the Phidget Control Panel; we will use this program to ensure that your new Phidget works properly.

The source code for the Spatial-full sample program can be found in the quick downloads section on the C# Language Page. If you'd like to see examples in other languages, you can visit our Languages page.

Updating Device Firmware

If an entry in this list is red, it means the firmware for that device is out of date. Double click on the entry to be given the option of updating the firmware. If you choose not to update the firmware, you can still run the example for that device after refusing.

Double Click on the icon to activate the Phidget Control Panel and make sure that the Phidget Spatial 0/0/3 is properly attached to your PC.
Double Click on Phidget Spatial 0/0/3 in the Phidget Control Panel to bring up Spatialfull and check that the box labelled Attached contains the word True. Move the 1049 board and you should see the data change to reflect the change of position along the 3 axes. You can also see the changes plotted in the Accelerometer Graph. The line describes the movement in the x and y axes and the red circle displays movement in the z axis. You can adjust the data rate by moving the slider.

Testing Using Mac OS X

1. Go to the Quick Downloads section on the Mac OS X page
2. Download and run the Phidget OS X Installer
3. Click on System Preferences >> Phidgets (under Other) to activate the Preference Pane
4. Make sure that the Phidget Spatial 0/0/3 is properly attached.
5. Double Click on Phidget Spatial 0/0/3 in the Phidget Preference Pane to bring up the Spatial-full Sample program. This program will function in a similar way as the Windows version.

Using Linux

For a step-by-step guide on getting Phidgets running on Linux, check the Linux page.

Using Windows Mobile / CE 5.0 / CE 6.0

For a step-by-step guide on getting Phidgets running on Windows CE, check the Windows CE page.

Technical Details

For more information on testing and calibrating this device, check the Accelerometer Primer.

API

We document API Calls specific to this product in this section. Functions common to all Phidgets and functions not applicable to this device are not covered here. This section is deliberately generic. For calling conventions under a specific language, refer to the associated API manual in the Quick Downloads section for that language. For exact values, refer to the device specifications.

Data Structures

SpatialData {

double acceleration[3];

Timestamp time;

};

The SpatialData Structure is used by the OnSpatialData event. This contains acceleration data, as well as a timestamp. The timestamp is an accurate measurement streamed from the hardware, and can be trusted over a local software timestamp.

Note the the structure also contains angularRate and magneticField fields, but these are not shown, as they don’tapply to the PhidgetSpatial 3-axis 5G.

Functions

int AccelerationAxisCount() [get] : Constant = 3

Returns the number of axes the PhidgetSpatial can measure acceleration on.

double Acceleration (int AxisIndex) [get] : Units = g (standard gravity = 9.81m/s²)

Returns the acceleration of an axis. At a standstill each axis will measure between -1.0 and 1.0 g’s depending on orientation - the effect of gravity. This value will always be between AccelerationMin and AccelerationMax.

double AccelerationMax (int AxisIndex) [get] : Constant = 5.1g

Returns the maximum acceleration value that this axis will report. Acceleration can be accurately measured up to 5.0g - any value past this will be reported as 5.1g, which represents saturation. If the acceleration data is equal to AccelerationMax, it should be treated as suspect, as the real acceleration could be far greater than the reported number.

double AccelerationMin (int AxisIndex) [get] : Constant = -5.1g

Returns the maximum negative acceleration value that this axis will report. Negative acceleration can be accurately measured up to -5.0g - any value past this will be reported as -5.1g, which represents saturation. If the acceleration data is equal to AccelerationMin, it should be treated as suspect, as the real acceleration could be far greater than the reported number.

int DataRate () [get,set] : Units = ms (milliseconds)

Gets/sets the data rate, in ms. This is corresponds to the rate at which SpatialData events will be fired. This is bound by DataRateMax and DataRateMin. When set to less then the maximum data rate, data is still sampled at the maximum rate, and averaged before being sent to the user. This defaults to 8ms. Supported data rates are: 1, 2, 4, 8, and every multiple of 8 until DataRateMin.

Note that data rate is limited to 16ms when opening over the Phidget Webservice. Actual data rate will depend on network latency.

int DataRateMax () [get] : Constant = 1ms

The maximum supported data rate.

int DataRateMin () [get] : Constant = 1000ms

The minimum supported data rate.

Events

OnSpatialData (SpatialData[] data) [event]

An event issued at the specified data rate. If the data rate is set faster then 8ms, then there will be multiple items in the data array - use the timestamp field to get the timing data. When the data rate is >= 8ms, there will only be one item in the data array.

Product History

Date	Board Revision	Device Version	Comment
June 2010	0	100	Product Release
June 2010	0	101	setLabel fix
May 2011	0	102	getLabelString fix for lables > 7 characters
April 2012	Product Discontinued. Succeeded by the 1041 - PhidgetSpatial 0/0/3 Basic or the 1043 - PhidgetSpatial Precision 0/0/3.