:orphan:

.. _st_stm32_otghs:

st,stm32-otghs
##############

Vendor: :ref:`STMicroelectronics <dt_vendor_st>`

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



.. code-block:: none

   STM32 OTGHS controller

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

         * - ``ram-size``
           - ``int``
           - .. code-block:: none

                Size of USB dedicated RAM. STM32 SOC's reference manual defines a shared FIFO size.


             This property is **required**.

         * - ``phys``
           - ``phandle``
           - .. code-block:: none

                PHY provider specifier


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

                Pin configuration for USB OTG HS signals (DM/DP/SOF/ID/VBUS and
                ULPI_DIR/ULPI_STP/ULPI_NXT/ULPI_D[0-7]).
                We expect that the phandles will reference pinctrl nodes.

                For example:
                   <&usb_otg_hs_dm_pa11 &usb_otg_hs_dp_pa12>;



         * - ``num-bidir-endpoints``
           - ``int``
           - .. code-block:: none

                Number of bi-directional endpoints supported by hardware (including EP0)


             This property is **required**.

         * - ``num-in-endpoints``
           - ``int``
           - .. code-block:: none

                Number of IN endpoints supported by hardware (including EP0 IN)


         * - ``num-out-endpoints``
           - ``int``
           - .. code-block:: none

                Number of OUT endpoints supported by hardware (including EP0 OUT)


         * - ``maximum-speed``
           - ``string``
           - .. code-block:: none

                Configures USB controllers to work up to a specific speed. Valid arguments are "super-speed", "high-speed", "full-speed" and "low-speed". If this is not passed via DT, USB controllers should use their maximum hardware capability.


             Legal values: ``'low-speed'``, ``'full-speed'``, ``'high-speed'``, ``'super-speed'``

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

                Control VBUS via GPIO pin.




   .. 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,stm32-otghs" compatible.

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

         * - Name
           - Type
           - Details

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

                register space


             This property is **required**.

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

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

                interrupts for device


             This property is **required**.

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

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

                Clock gate information


             This property is **required**.

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

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


             This property is **required**.

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

         * - ``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-names``
           - ``string-array``
           - .. code-block:: none

                name of each register space


         * - ``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


         * - ``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