Merge tag 'hwlock-v6.12' of git://git.kernel.org/pub/scm/linux/kernel/git/remoteproc/linux

# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause

%YAML 1.2

---

$id: http://devicetree.org/schemas/hwlock/sprd,hwspinlock-r3p0.yaml#

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

title: Spreadtrum hardware spinlock

maintainers:

  - Orson Zhai <orsonzhai@gmail.com>

  - Baolin Wang <baolin.wang7@gmail.com>

  - Chunyan Zhang <zhang.lyra@gmail.com>

properties:

  compatible:

    const: sprd,hwspinlock-r3p0

  reg:

    maxItems: 1

  clocks:

    maxItems: 1

  clock-names:

    const: enable

  '#hwlock-cells':

    const: 1

required:

  - compatible

  - reg

  - clocks

  - clock-names

  - '#hwlock-cells'

additionalProperties: false

examples:

  - |

    #include <dt-bindings/clock/sprd,sc9860-clk.h>

    hwlock@40500000 {

      compatible = "sprd,hwspinlock-r3p0";

      reg = <0x40500000 0x1000>;

      clocks = <&aon_gate CLK_SPLK_EB>;

      clock-names = "enable";

      #hwlock-cells = <1>;

    };

...

SPRD Hardware Spinlock Device Binding

-------------------------------------

Required properties :

- compatible : should be "sprd,hwspinlock-r3p0".

- reg : the register address of hwspinlock.

- #hwlock-cells : hwlock users only use the hwlock id to represent a specific

	hwlock, so the number of cells should be <1> here.

- clock-names : Must contain "enable".

- clocks : Must contain a phandle entry for the clock in clock-names, see the

	common clock bindings.

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

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

Example of hwlock provider:

	hwspinlock@40500000 {

		compatible  = "sprd,hwspinlock-r3p0";

		reg = <0 0x40500000 0 0x1000>;

		#hwlock-cells = <1>;

		clock-names = "enable";

		clocks = <&clk_aon_apb_gates0 22>;

	};