: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>

.. dtcompatible:: raspberrypi,pico-pio-ws2812
.. _dtbinding_raspberrypi_pico_pio_ws2812:

raspberrypi,pico-pio-ws2812
###########################

Vendor: :ref:`Raspberry Pi Foundation <dt_vendor_raspberrypi>`

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



.. code-block:: none

   The pio node configured for ws2812.

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

         * - ``bit-waveform``
           - ``array``
           - .. code-block:: none

                This property defines the waveform for sending 1-bit data.
                The program uses the first three elements of the array.
                Where, let these value be T0, T1, and T2.
                The T0 is equal to T0H in the datasheet.
                The T2 is equal to T1L in the datasheet.
                The T1 is equal to (T1H-T0H) or (T0L-T1L) in the datasheet.

                Code-0
                   +------+                 +---
                   |      |                 |
                   |  T0  |      T1+T2      |
                   |      |                 |
                ---+      +-----------------+

                Code-1
                   +---------------+        +---
                   |               |        |
                   |     T0+T1     |   T2   |
                   |               |        |
                ---+               +--------+


                The frequency determines the wave period.
                The T0～T2 means ratio in one period.

                For example, T0=3, T1=3, T2=4 and the frequency is 800kHz case,
                T0H is
                  (1 / 800kHz) * (3/10) = 375ns
                T0L is
                  (1 / 800kHz) * ((4+3)/10) = 875ns



         * - ``pinctrl-0``
           - ``phandles``
           - .. code-block:: none

                Pin configuration/s for the first state. Content is specific to the
                selected pin controller driver implementation.



         * - ``pinctrl-1``
           - ``phandles``
           - .. code-block:: none

                Pin configuration/s for the second state. See pinctrl-0.



         * - ``pinctrl-2``
           - ``phandles``
           - .. code-block:: none

                Pin configuration/s for the third state. See pinctrl-0.



         * - ``pinctrl-3``
           - ``phandles``
           - .. code-block:: none

                Pin configuration/s for the fourth state. See pinctrl-0.



         * - ``pinctrl-4``
           - ``phandles``
           - .. code-block:: none

                Pin configuration/s for the fifth state. See pinctrl-0.



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

                Names for the provided states. The number of names needs to match the
                number of states.





   .. 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 "raspberrypi,pico-pio-ws2812" compatible.

      (None)