ST LPS22DF I3C Pressure and Temperature Sensor 바인딩

:orphan:

.. raw:: html

    <!--
    FIXME: do not limit page width until content uses another representation
    format other than tables
    -->
    <style>.wy-nav-content { max-width: none; !important }</style>


.. _dtbinding_st_lps22df_i3c:

st,lps22df (on i3c bus)
#######################

Vendor: :ref:`STMicroelectronics <dt_vendor_st>`

Description
***********



.. code-block:: none

   STMicroelectronics LPS22DF pressure and temperature sensor connected to I3C
   bus

Properties
**********

.. tabs::

   .. group-tab:: Node specific properties

      Properties not inherited from the base binding file.

      .. list-table::
         :widths: 1 1 4
         :header-rows: 1

         * - Name
           - Type
           - Details

         * - ``supply-gpios``
           - ``phandle-array``
           - .. code-block:: none

                GPIO specifier that controls power to the device.

                This property should be provided when the device has a dedicated
                switch that controls power to the device.  The supply state is
                entirely the responsibility of the device driver.

                Contrast with vin-supply.



         * - ``vin-supply``
           - ``phandle``
           - .. code-block:: none

                Reference to the regulator that controls power to the device.
                The referenced devicetree node must have a regulator compatible.

                This property should be provided when device power is supplied
                by a shared regulator.  The supply state is dependent on the
                request status of all devices fed by the regulator.

                Contrast with supply-gpios.  If both properties are provided
                then the regulator must be requested before the supply GPIOS is
                set to an active state, and the supply GPIOS must be set to an
                inactive state before releasing the regulator.



         * - ``assigned-address``
           - ``int``
           - .. code-block:: none

                Dynamic address to be assigned to the device.



         * - ``friendly-name``
           - ``string``
           - .. code-block:: none

                Human readable string describing the sensor. It can be used to
                distinguish multiple instances of the same model (e.g., lid accelerometer
                vs. base accelerometer in a laptop) to a host operating system.

                This property is defined in the Generic Sensor Property Usages of the HID
                Usage Tables specification
                (https://usb.org/sites/default/files/hut1_3_0.pdf, section 22.5).



         * - ``drdy-gpios``
           - ``phandle-array``
           - .. code-block:: none

                DRDY pin

                This pin defaults to active high when produced by the sensor.
                The property value should ensure the flags properly describe
                the signal that is presented to the driver.



         * - ``drdy-pulsed``
           - ``boolean``
           - .. code-block:: none

                Selects the pulsed mode for data-ready interrupt when enabled,
                and the latched mode when disabled.



         * - ``odr``
           - ``int``
           - .. code-block:: none

                Specify the output data rate expressed in samples per second (Hz).
                The default is the power-on reset value.

                - 0 # LPS2xDF_DT_ODR_POWER_DOWN
                - 1 # LPS2xDF_DT_ODR_1HZ
                - 2 # LPS2xDF_DT_ODR_4HZ
                - 3 # LPS2xDF_DT_ODR_10HZ
                - 4 # LPS2xDF_DT_ODR_25HZ
                - 5 # LPS2xDF_DT_ODR_50HZ
                - 6 # LPS2xDF_DT_ODR_75HZ
                - 7 # LPS2xDF_DT_ODR_100HZ
                - 8 # LPS2xDF_DT_ODR_200HZ



             Legal values: ``0``, ``1``, ``2``, ``3``, ``4``, ``5``, ``6``, ``7``, ``8``

         * - ``lpf``
           - ``int``
           - .. code-block:: none

                Specify the low pass filter value to be applied to pressure data.
                The default is the power-on reset value.

                - 0 # LPS2xDF_DT_LP_FILTER_OFF
                - 1 # LPS2xDF_DT_LP_FILTER_ODR_4
                - 3 # LPS2xDF_DT_LP_FILTER_ODR_9



             Legal values: ``0``, ``1``, ``3``

         * - ``avg``
           - ``int``
           - .. code-block:: none

                Specify the average filter value (i.e. number of samples) to be applied
                to pressure and temperature data.
                The default is the power-on reset value.

                - 0 # LPS2xDF_DT_AVG_4_SAMPLES
                - 1 # LPS2xDF_DT_AVG_8_SAMPLES
                - 2 # LPS2xDF_DT_AVG_16_SAMPLES
                - 3 # LPS2xDF_DT_AVG_32_SAMPLES
                - 4 # LPS2xDF_DT_AVG_64_SAMPLES
                - 5 # LPS2xDF_DT_AVG_128_SAMPLES
                - 6 # LPS2xDF_DT_AVG_256_SAMPLES
                - 7 # LPS2xDF_DT_AVG_512_SAMPLES



             Legal values: ``0``, ``1``, ``2``, ``3``, ``4``, ``5``, ``6``, ``7``



   .. group-tab:: Deprecated node specific properties

      Deprecated properties not inherited from the base binding file.

      (None)

   .. group-tab:: Base properties

      Properties inherited from the base binding file, which defines
      common properties that may be set on many nodes. Not all of these
      may apply to the "st,lps22df" compatible.

      .. list-table::
         :widths: 1 1 4
         :header-rows: 1

         * - Name
           - Type
           - Details

         * - ``wakeup-source``
           - ``boolean``
           - .. code-block:: none

                Property to identify that a device can be used as wake up source.

                When this property is provided a specific flag is set into the
                device that tells the system that the device is capable of
                wake up the system.

                Wake up capable devices are disabled (interruptions will not wake up
                the system) by default but they can be enabled at runtime if necessary.



         * - ``power-domain``
           - ``phandle``
           - .. code-block:: none


                Power domain the device belongs to.

                The device will be notified when the power domain it belongs to is either
                suspended or resumed.



         * - ``zephyr,pm-device-runtime-auto``
           - ``boolean``
           - .. code-block:: none

                Automatically configure the device for runtime power management after the
                init function runs.



         * - ``zephyr,disabling-power-states``
           - ``phandles``
           - .. code-block:: none

                List of power states that will disable this device power.



         * - ``status``
           - ``string``
           - .. code-block:: none

                indicates the operational status of a device


             Legal values: ``'ok'``, ``'okay'``, ``'disabled'``, ``'reserved'``, ``'fail'``, ``'fail-sss'``

             See :ref:`dt-important-props` for more information.

         * - ``compatible``
           - ``string-array``
           - .. code-block:: none

                compatible strings


             This property is **required**.

             See :ref:`dt-important-props` for more information.

         * - ``reg``
           - ``array``
           - .. code-block:: none

                Contains 3 fields.

                For I3C devices, the 3 fields are static address, first half
                of Provisioned ID, and the second half of the Provisioned ID.
                  1. The static address can be assigned to be the target device's
                     dynamic address before Dynamic Address Assignment (DAA)
                     starts. Can be zero if static address is not used, and
                     target address is determined via DAA.
                  2. First half of the Provisioned ID contains the manufacturer
                     ID left-shifted by 1, where the manufacturer ID is
                     the bits 33-47 (zero-based) of the 48-bit Provisioned ID.
                  3. Second half of the Provisioned ID contains the combination of
                     the part ID (bits 16-31 of the Provisioned ID) left-shifted
                     by 16, and the instance ID (bits 12-15 of the Provisioned ID)
                     left-shifted by 12. Basically, this is the lower 32 bits
                     of the Provisioned ID.

                Note that the DT node of a I3C target device should be in format
                "<node name>@<address + PID>", e.g. "sensor@4200001234012345678",
                where the PID part is expanded to be a 64-bit integer.

                For I2C devices, the 3 fields are static address, 0x00, and
                value of the Legacy Virtual Register (LVR).
                   1. 7-bit address of the I2C device. (Note that 10-bit
                      addressing is not supported.)
                   2. Always 0x00.
                   3. LVR describes the I2C device where,
                      * bit[31:8]: unused.
                      * bit[7:5]: I2C device index:
                          * Index 0: I2C device has a 50 ns spike filter where
                                     it is not affected by high frequency on SCL.
                          * Index 1: I2C device does not have a 50 ns spike filter
                                     but can work with high frequency on SCL.
                          * Index 2: I2C device does not have a 50 ns spike filter
                                     and cannot work with high frequency on SCL.
                          * Other values are reserved.
                      * bit[4]: I2C mode indicator:
                          * 0: FM+ mode
                          * 1: FM mode
                      * bit[3:0]: reserved.

                The DT node of a I2C device should be in format
                "<node name>@<address + 00000000 + LVR>",
                e.g. "sensor@5000000000000000FF", where the middle 0x00 and LVR
                are both expanded to 32-bit integers.



             This property is **required**.

             See :ref:`dt-important-props` for more information.

         * - ``reg-names``
           - ``string-array``
           - .. code-block:: none

                name of each register space


         * - ``interrupts``
           - ``array``
           - .. code-block:: none

                interrupts for device


             See :ref:`dt-important-props` for more information.

         * - ``interrupts-extended``
           - ``compound``
           - .. code-block:: none

                extended interrupt specifier for device


         * - ``interrupt-names``
           - ``string-array``
           - .. code-block:: none

                name of each interrupt


         * - ``interrupt-parent``
           - ``phandle``
           - .. code-block:: none

                phandle to interrupt controller node


         * - ``label``
           - ``string``
           - .. code-block:: none

                Human readable string describing the device (used as device_get_binding() argument)



             See :ref:`dt-important-props` for more information.

             This property is **deprecated**.

         * - ``clocks``
           - ``phandle-array``
           - .. code-block:: none

                Clock gate information


         * - ``clock-names``
           - ``string-array``
           - .. code-block:: none

                name of each clock


         * - ``#address-cells``
           - ``int``
           - .. code-block:: none

                number of address cells in reg property


         * - ``#size-cells``
           - ``int``
           - .. code-block:: none

                number of size cells in reg property


         * - ``dmas``
           - ``phandle-array``
           - .. code-block:: none

                DMA channels specifiers


         * - ``dma-names``
           - ``string-array``
           - .. code-block:: none

                Provided names of DMA channel specifiers


         * - ``io-channels``
           - ``phandle-array``
           - .. code-block:: none

                IO channels specifiers


         * - ``io-channel-names``
           - ``string-array``
           - .. code-block:: none

                Provided names of IO channel specifiers


         * - ``mboxes``
           - ``phandle-array``
           - .. code-block:: none

                mailbox / IPM channels specifiers


         * - ``mbox-names``
           - ``string-array``
           - .. code-block:: none

                Provided names of mailbox / IPM channel specifiers


         * - ``zephyr,deferred-init``
           - ``boolean``
           - .. code-block:: none

                Do not initialize device automatically on boot. Device should be manually
                initialized using device_init().