summaryrefslogtreecommitdiffstats
path: root/include
diff options
context:
space:
mode:
authorMathias Agopian <mathias@google.com>2011-05-03 15:36:17 -0700
committerAndroid (Google) Code Review <android-gerrit@google.com>2011-05-03 15:36:17 -0700
commitbbc13bc837e0d7679f593056420b2b6c5de21b57 (patch)
tree72df1a6b79d9c2de3ef170b40f7040d6c412ab3e /include
parent1ca194d2d4415afbb946d67ae9993b48e74057ef (diff)
parentd93ff971bd507e92ac81c149079906d2123795af (diff)
downloadhardware_libhardware-bbc13bc837e0d7679f593056420b2b6c5de21b57.zip
hardware_libhardware-bbc13bc837e0d7679f593056420b2b6c5de21b57.tar.gz
hardware_libhardware-bbc13bc837e0d7679f593056420b2b6c5de21b57.tar.bz2
Merge "Improve ROTATION_VECTOR sensor documentation"
Diffstat (limited to 'include')
-rw-r--r--include/hardware/sensors.h12
1 files changed, 12 insertions, 0 deletions
diff --git a/include/hardware/sensors.h b/include/hardware/sensors.h
index fb83c3f..9c2aa2a 100644
--- a/include/hardware/sensors.h
+++ b/include/hardware/sensors.h
@@ -268,6 +268,18 @@ __BEGIN_DECLS
* Elements of the rotation vector are unitless. The x, y, and z axis are defined
* in the same was as for the acceleration sensor.
*
+ * The reference coordinate system is defined as a direct orthonormal basis,
+ * where:
+ *
+ * - X is defined as the vector product Y.Z (It is tangential to
+ * the ground at the device's current location and roughly points East).
+ *
+ * - Y is tangential to the ground at the device's current location and
+ * points towards the magnetic North Pole.
+ *
+ * - Z points towards the sky and is perpendicular to the ground.
+ *
+ *
* The rotation-vector is stored as:
*
* sensors_event_t.data[0] = x*sin(theta/2)