zephyr/samples/sensor/lsm6dso_i2c_on_i3c
Daniel Leung 47bf9ee51c samples: sensors: add a new one for lsm6dso as I2C on I3C bus
This adds some skeleton files to enable using LSM6DSO on I3C bus
while still acting like a I2C device. The new files here are
simply to provide a way to have overlay for each board that
would not conflict with the pure I2C one. Also this is set to
build only because it require external hardware that is not
necessary on the board being tested.

Signed-off-by: Daniel Leung <daniel.leung@intel.com>
2022-09-09 17:42:33 -04:00
..
boards
CMakeLists.txt
README.rst
prj.conf
sample.yaml

README.rst

.. _lsm6dso_i2c_on_i3c:

LSM6DSO: IMU Sensor Monitor (I2C on I3C bus)
############################################

Overview
********
This sample sets the date rate of LSM6DSO accelerometer and gyroscope to
12.5Hz and enables a trigger on data ready. It displays on the console
the values for accelerometer and gyroscope.

Requirements
************

This sample uses the LSM6DSO sensor controlled using the I2C interface
exposed by the I3C controller. It has been tested using the LSM6DSO on
the evaluation board STEVAL-MKI196V1 connected to the I3C header
on :ref:`mimxrt685_evk`.

References
**********

- LSM6DSO http://www.st.com/en/mems-and-sensors/lsm6dso.html

Building and Running
********************

This project outputs sensor data to the console. It requires an LSM6DSO
sensor (for example, the one on evaluation board STEVAL-MKI196V1).

Building on mimxrt685_evk_cm33 board
====================================

.. zephyr-app-commands::
   :zephyr-app: samples/sensor/lsm6dso_i2c_on_i3c
   :host-os: unix
   :board: mimxrt685_evk_cm33
   :goals: build
   :compact:

Board Preparations
==================

mimxrt685_evk_cm33
------------------

On the board :ref:`mimxrt685_evk`, the I3C pins are exposed on the J18
header, where:

  * SCL is on pin 1
  * SDA is on pin 2
  * Internal pull-up is on pin 3 (which is connected to pin 2 already)
  * Ground is on pin4

LSM6DSO
^^^^^^^

A LSM6DSO sensor needs to be connected to this header. For example,
the evaluation board STEVAL-MKI196V1 can be used. This needs to be
prepared so that the LSM6DSO sensor has address 0x6B (i.e. 0xD6,
left-shifed).

Sample Output
=============

.. code-block:: console

    Testing LSM6DSO sensor in trigger mode.

    accel x:-0.650847 ms/2 y:-5.300102 ms/2 z:-8.163114 ms/2
    gyro x:-0.167835 dps y:-0.063377 dps z:0.002367 dps
    trig_cnt:1

    accel x:0.341575 ms/2 y:5.209773 ms/2 z:-7.938787 ms/2
    gyro x:-0.034284 dps y:-0.004428 dps z:-0.003512 dps
    trig_cnt:2

    <repeats endlessly>