View source for 1042 User Guide

__NOINDEX__
<metadesc>The PhidgetSpatial 3/3/3 basic has a 3-axis accelerometer, gyroscope and compass and connects to your computer via USB.</metadesc>
[[Category:UserGuide]]
==Getting Started==
{{UGIntro|1042}}
*[{{SERVER}}/products.php?product_id=1042 1042 Spatial Phidget]
*USB cable and computer


Next, you will need to connect the pieces:
[[Image:1056_0_Connecting_The_Hardware.jpg|500px|right|link=]]
# Connect your device to your computer using the USB cable.

<br clear="all">
{{UGIntroDone|1042}}

==Using the 1042==

{{UGcontrolpanel|1042}}

{{ugAccelerometer|1042|}}

{{ugGyroscope|1042}}

{{ugMagnetometer|1042}}

{{ugSpatial|1042}}

{{ugAddressingInformation}}

{{ugUsingYourOwnProgram|1042}}

==Technical Details==
===3-Axis Accelerometer===
The 1042 has a 3-Axis accelerometer that can measure ±8 g (±78 m/s2) per axis.  It will measure both dynamic acceleration (change in velocity) and static acceleration (gravity vector).  

====Orientation====

[[File:1041 0 Axis Diagram.jpg|500px|link=]]

When working with an accelerometer it is important to know which is the positive and negative direction on each of the axes.  This can be determined by orienting the accelerometer along each axis and checking the output. The above image shows what the axis readings should be for each orientation of the 1042.


For more information on how to use the accelerometer, check the [[Accelerometer Primer]].

===3-Axis Gyroscope===
For more information on the gyroscope, see the [[Gyroscope Primer]].

===3-Axis Magnetometer (Compass)===
The magnetometer reports the sum of all magnetic fields acting on the 1042. The Earth's magnetic field is only one source that affects this measurement. In order to get accurate bearing data from the magnetometer ( i.e. to find magnetic north as a compass) any interfering magnetic effects need to be calibrated out. For more information about calibration, see the [[#Magnetic Error Correction (Calibration)|section below]], or the [[Compass Primer]].

Any magnetic field that is stationary with respect to the 1042, and less than ± 3 Gauss, can be calibrated out of the magnetic field measurement. This includes both hard and soft iron effects caused by nearby ferrous and magnetic materials. Interfering magnetic fields that vary in strength and orientation with respect to the 1042 can not be easily calibrated out.

Magnetic field data will become unavailable during every other sample as the compass performs internal calibrations. When this happens, the magneticField array in the SpatialData structure will either have a length of zero, or each element will equal <code>PUNK_DBL</code>, depending on the API being used. This needs to be handled explicitly in the event handling code to avoid erroneous program behavior. The maximum sampling rate of the compass is 125 Hz.


{{compasscalibration|1042}}

For more information on magnetometers (compasses), see the [[Compass Primer]].

{{UGnext|}}