summaryrefslogtreecommitdiff
path: root/zephyr/dts/bindings/motionsense/cros-ec,motionsense-rotation-ref.yaml
diff options
context:
space:
mode:
authorHyungwoo Yang <hyungwoo.yang@intel.corp-partner.google.com>2021-03-19 15:25:05 -0700
committerCommit Bot <commit-bot@chromium.org>2021-03-23 23:13:18 +0000
commit52c66f7e5f5faf5d96625fe95c53a88b1f5c801c (patch)
treea860d2e5de70bf987eeaa37acf18c7f6bf84231a /zephyr/dts/bindings/motionsense/cros-ec,motionsense-rotation-ref.yaml
parent9ab043078548fd30c010b7c3d5dd394e29096491 (diff)
downloadchrome-ec-52c66f7e5f5faf5d96625fe95c53a88b1f5c801c.tar.gz
zephyr: DT: support sensor rotation matrix
This creates instances of rotation matrix(mat33_fp_t) which is used to convert raw value from a sensor to X, Y and Z on the defined coordinate system. BUG=b:173507858 BRANCH=none TEST=make buildall -j8 build volteer on zephyr Signed-off-by: Hyungwoo Yang <hyungwoo.yang@intel.corp-partner.google.com> Change-Id: Ifc80fe7ff33c46904af279b9f52e611c7157c346 Reviewed-on: https://chromium-review.googlesource.com/c/chromiumos/platform/ec/+/2778814 Reviewed-by: Simon Glass <sjg@chromium.org>
Diffstat (limited to 'zephyr/dts/bindings/motionsense/cros-ec,motionsense-rotation-ref.yaml')
-rw-r--r--zephyr/dts/bindings/motionsense/cros-ec,motionsense-rotation-ref.yaml55
1 files changed, 55 insertions, 0 deletions
diff --git a/zephyr/dts/bindings/motionsense/cros-ec,motionsense-rotation-ref.yaml b/zephyr/dts/bindings/motionsense/cros-ec,motionsense-rotation-ref.yaml
new file mode 100644
index 0000000000..7de86ec8db
--- /dev/null
+++ b/zephyr/dts/bindings/motionsense/cros-ec,motionsense-rotation-ref.yaml
@@ -0,0 +1,55 @@
+# Copyright 2021 The Chromium OS Authors. All rights reserved.
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+
+description: rotation reference parent node
+
+compatible: "cros-ec,motionsense-rotation-ref"
+
+child-binding:
+ description: |
+ A rotation matrix node is used to create
+ an instance of mat33_fp_t which is used by
+ sensor drivers.
+ properties:
+ mat33:
+ required: true
+ type: array
+ description: |
+ 3x3 matrix to rotate x, y, and z axes.
+ Applications with the sensor API expects sansor data
+ based on the same defined coordinate system.
+ * X-axis is horizontal and positive toward the right
+ * Y-axis is vertical and positive toward the top
+ * Z-axis points toward the user
+
+ Depending on how the sensor is mounted on board(PCB), we
+ may need to change the direction of a axis and swap X and
+ Y-axis. Using the 3x3 matrix, it generates the correct
+ X,Y, and Z on the defined coordinate system.
+
+ +- -+ +- -+ +- -+
+ | v1 v2 v3 | | sensor_X | | X |
+ | v4 v5 v6 | * | sensor_Y | = | Y |
+ | v7 v8 v9 | | sensor_Z | | Z |
+ +- -+ +- -+ +- -+
+
+#
+# examples:
+#
+# motionsense-rotation-ref {
+# compatible = "cros-ec,motionsense-rotation-ref";
+# /* change the direction of Y and Z-axis */
+# lid_rot_ref: lid-rotation-ref {
+# mat33 = <1 0 0
+# 0 (-1) 0
+# 0 0 (-1)>;
+# };
+# /* swap X and Y-axis, and then change the direction of Y-axis */
+# base_rot_ref: base-rotation-ref {
+# mat33 = <0 1 0
+# (-1) 0 0
+# 0 0 1>;
+# };
+# };
+#