Commit d8db9dc3 authored by Suman Anna's avatar Suman Anna Committed by Rob Herring
Browse files

dt-bindings: hwlock: omap: Convert binding to YAML 



Convert the current OMAP hwspinlock binding from text format to YAML
format/DT schema, and delete the legacy text binding file.

The new YAML binding conversion is a slightly updated version compared
to the original. The legacy "ti,hwmods" property is now obsolete and
is dropped altogether, and the K3 example is updated to showcase the
actual dts node usage.

Signed-off-by: default avatarSuman Anna <s-anna@ti.com>
Link: https://lore.kernel.org/r/20200828041447.5900-1-s-anna@ti.com


Signed-off-by: default avatarRob Herring <robh@kernel.org>
parent f710b49e

Documentation/devicetree/bindings/hwlock/omap-hwspinlock.txt

deleted100644 → 0
+0 −41
Original line number Diff line number Diff line 
TI HwSpinlock for OMAP and K3 based SoCs

=========================================



Required properties:

- compatible:		Should be one of the following,

			  "ti,omap4-hwspinlock" for

				OMAP44xx, OMAP54xx, AM33xx, AM43xx, DRA7xx SoCs

			  "ti,am654-hwspinlock" for

				K3 AM65x and J721E SoCs

- reg:			Contains the hwspinlock module register address space

			(base address and length)

- ti,hwmods:		Name of the hwmod associated with the hwspinlock device

			(for OMAP architecture based SoCs only)

- #hwlock-cells:	Should be 1. The OMAP hwspinlock users will use a

			0-indexed relative hwlock number as the argument

			specifier value for requesting a specific hwspinlock

			within a hwspinlock bank.



Please look at the generic hwlock binding for usage information for consumers,

"Documentation/devicetree/bindings/hwlock/hwlock.txt"



Example:



1. OMAP4 SoCs

hwspinlock: spinlock@4a0f6000 {

	compatible = "ti,omap4-hwspinlock";

	reg = <0x4a0f6000 0x1000>;

	ti,hwmods = "spinlock";

	#hwlock-cells = <1>;

};



2. AM65x SoCs and J721E SoCs

&cbass_main {

	cbass_main_navss: interconnect0 {

		hwspinlock: spinlock@30e00000 {

			compatible = "ti,am654-hwspinlock";

			reg = <0x00 0x30e00000 0x00 0x1000>;

			#hwlock-cells = <1>;

		};

	};

};

Documentation/devicetree/bindings/hwlock/ti,omap-hwspinlock.yaml

0 → 100644
+76 −0
Original line number Diff line number Diff line 
# SPDX-License-Identifier: (GPL-2.0-only or BSD-2-Clause)

%YAML 1.2

---

$id: http://devicetree.org/schemas/hwlock/ti,omap-hwspinlock.yaml#

$schema: http://devicetree.org/meta-schemas/core.yaml#



title: TI HwSpinlock for OMAP and K3 based SoCs



maintainers:

  - Suman Anna <s-anna@ti.com>



properties:

  compatible:

    enum:

      - ti,omap4-hwspinlock  # for OMAP44xx, OMAP54xx, AM33xx, AM43xx, DRA7xx SoCs

      - ti,am654-hwspinlock  # for K3 AM65x, J721E and J7200 SoCs



  reg:

    maxItems: 1



  "#hwlock-cells":

    const: 1

    description: |

      The OMAP hwspinlock users will use a 0-indexed relative hwlock number as

      the argument specifier value for requesting a specific hwspinlock within

      a hwspinlock bank.



      Please look at the generic hwlock binding for usage information for

      consumers, "Documentation/devicetree/bindings/hwlock/hwlock.txt"



required:

  - compatible

  - reg

  - "#hwlock-cells"



additionalProperties: false



examples:



  - |

    /* OMAP4 SoCs */

    hwspinlock: spinlock@4a0f6000 {

        compatible = "ti,omap4-hwspinlock";

        reg = <0x4a0f6000 0x1000>;

        #hwlock-cells = <1>;

    };



  - |

    / {

        /* K3 AM65x SoCs */

        model = "Texas Instruments K3 AM654 SoC";

        compatible = "ti,am654";

        #address-cells = <2>;

        #size-cells = <2>;



        bus@100000 {

            compatible = "simple-bus";

            #address-cells = <2>;

            #size-cells = <2>;

            ranges = <0x00 0x00100000 0x00 0x00100000 0x00 0x00020000>, /* ctrl mmr */

                     <0x00 0x30800000 0x00 0x30800000 0x00 0x0bc00000>; /* Main NavSS */



            main_navss@30800000 {

                compatible = "simple-mfd";

                #address-cells = <2>;

                #size-cells = <2>;

                ranges = <0x00 0x30800000 0x00 0x30800000 0x00 0x0bc00000>;



                spinlock@30e00000 {

                    compatible = "ti,am654-hwspinlock";

                    reg = <0x00 0x30e00000 0x00 0x1000>;

                    #hwlock-cells = <1>;

                };

            };

        };

    };