diff options
author | Hyungwoo Yang <hyungwoo.yang@intel.corp-partner.google.com> | 2021-03-19 15:25:05 -0700 |
---|---|---|
committer | Commit Bot <commit-bot@chromium.org> | 2021-03-23 23:13:18 +0000 |
commit | 52c66f7e5f5faf5d96625fe95c53a88b1f5c801c (patch) | |
tree | a860d2e5de70bf987eeaa37acf18c7f6bf84231a /zephyr/dts/bindings/motionsense/cros-ec,motionsense-rotation-ref.yaml | |
parent | 9ab043078548fd30c010b7c3d5dd394e29096491 (diff) | |
download | chrome-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.yaml | 55 |
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>; +# }; +# }; +# |