1.. zephyr:code-sample:: stream_drdy
2 :name: Generic device sample streaming using Data Ready trigger
3 :relevant-api: sensor_interface
4
5 Get accelerometer data frames from a sensor using SENSOR_TRIG_DATA_READY.
6
7Overview
8********
9
10This sample application demonstrates how to stream accel data using the
11:ref:`RTIO framework <rtio>` based :ref:`Read and Decode method <sensor-read-and-decode>`.
12
13The streaming is started using the sensor_stream() API and it is self-sustained by the
14SENSOR_TRIG_DATA_READY trigger.
15
16Currently the sample gets/prints data only for the accel sensor channel:
17
18 - SENSOR_CHAN_ACCEL_XYZ
19
20Building and Running
21********************
22
23This sample supports up to 10 streaming devices. Each device needs
24to be aliased as ``streamN`` where ``N`` goes from ``0`` to ``9``. For example:
25
26.. code-block:: devicetree
27
28 / {
29 aliases {
30 stream0 = &lsm6dsv16x_6b_x_nucleo_iks4a1;
31 };
32 };
33
34Example devicetree overlays and configurations are already available for sensortile_box_pro,
35nucleo_f401re and nucleo_h503rb in the boards directory:
36
37- :zephyr_file:`samples/sensor/stream_drdy/boards/sensortile_box_pro.overlay`
38
39 DT overlay file for the sensortile_box_pro board.
40
41- :zephyr_file:`samples/sensor/stream_drdy/boards/sensortile_box_pro.conf`
42
43 Configuration file for the sensortile_box_pro board.
44
45- :zephyr_file:`samples/sensor/stream_drdy/boards/nucleo_f401re.overlay`
46
47 DT overlay file for the nucleo_f401re board.
48
49- :zephyr_file:`samples/sensor/stream_drdy/boards/nucleo_f401re.conf`
50
51 Configuration file for the nucleo_f401re board.
52
53- :zephyr_file:`samples/sensor/stream_drdy/boards/nucleo_h503rb.overlay`
54
55 DT overlay file for the nucleo_h503rb board.
56
57- :zephyr_file:`samples/sensor/stream_drdy/boards/nucleo_h503rb.conf`
58
59 Configuration file for the nucleo_h503rb board.
60
61For example, build and run sample for sensortile_box_pro with:
62
63.. zephyr-app-commands::
64 :zephyr-app: samples/sensor/stream_drdy
65 :board: sensortile_box_pro
66 :goals: build flash
67 :compact:
68
69Sample Output
70=============
71
72The following example output is for a lsm6dsv16x IMU device with accelerometer sensor.
73The board used is a sensortile_box_pro.
74
75.. code-block:: console
76
77XL data for lsm6dsv16x@0 7320515312ns (-0.387584, 0.224894, 9.766184)
78XL data for lsm6dsv16x@0 7321538600ns (-0.363659, 0.282314, 9.948014)
79XL data for lsm6dsv16x@0 7322561362ns (-0.301454, 0.172259, 9.775754)
80XL data for lsm6dsv16x@0 7323584881ns (-0.210539, 0.153119, 9.857099)
81XL data for lsm6dsv16x@0 7324608368ns (-0.287099, 0.167474, 9.852314)
82XL data for lsm6dsv16x@0 7325631281ns (-0.306239, 0.181829, 9.847529)
83XL data for lsm6dsv16x@0 7326654425ns (-0.272744, 0.167474, 9.842744)
84XL data for lsm6dsv16x@0 7327677993ns (-0.296669, 0.224894, 9.981509)
85XL data for lsm6dsv16x@0 7328701506ns (-0.282314, 0.210539, 9.828389)
86XL data for lsm6dsv16x@0 7329724306ns (-0.244034, 0.153119, 9.866669)
87XL data for lsm6dsv16x@0 7330747556ns (-0.234464, 0.119624, 9.780539)
88XL data for lsm6dsv16x@0 7331771000ns (-0.239249, 0.148334, 9.933659)
89XL data for lsm6dsv16x@0 7332794575ns (-0.220109, 0.119624, 9.833174)
90XL data for lsm6dsv16x@0 7333817437ns (-0.205754, 0.119624, 9.823604)
91XL data for lsm6dsv16x@0 7334840643ns (-0.205754, 0.148334, 9.866669)
92XL data for lsm6dsv16x@0 7335864162ns (-0.186614, 0.129194, 9.861884)
93XL data for lsm6dsv16x@0 7336887593ns (-0.196184, 0.110054, 9.804464)
94XL data for lsm6dsv16x@0 7337910356ns (-0.181829, 0.133979, 9.938444)
95XL data for lsm6dsv16x@0 7338933650ns (-0.215324, 0.081344, 9.536504)
96XL data for lsm6dsv16x@0 7339957075ns (-0.157904, 0.119624, 9.995864)
97XL data for lsm6dsv16x@0 7340980675ns (-0.205754, 0.110054, 9.809249)
98XL data for lsm6dsv16x@0 7342003487ns (-0.177044, 0.143549, 9.971939)
99XL data for lsm6dsv16x@0 7343026593ns (-0.172259, 0.100484, 9.794894)
100XL data for lsm6dsv16x@0 7344050168ns (-0.177044, 0.124409, 9.881024)
101XL data for lsm6dsv16x@0 7345073643ns (-0.191399, 0.124409, 9.986294)
102XL data for lsm6dsv16x@0 7346096587ns (-0.191399, 0.105269, 9.790109)
103
104References
105==========
106
107.. target-notes::
108
109.. _RTIO framework:
110 https://docs.zephyrproject.org/latest/services/rtio/index.html
111
112.. _x-nucleo-iks4a1:
113 http://www.st.com/en/ecosystems/x-nucleo-iks4a1.html
114
