[PATCH RFC 2/5] dt-bindings: soc: Describe the BCM6846 Processor Monitor Bus

[Linus Walleij]

The third generation Platform Management Controller (PMC3) accesses
SoC block control registers through the Processor Monitor Bus (PMB).
Describe the BCM6846 PMB controller and its shared register bank.

Assisted-by: LLM
Signed-off-by: Linus Walleij <linusw at kernel.org>
---
 .../bindings/soc/bcm/brcm,bcm6846-pmb.yaml         | 51 ++++++++++++++++++++++
 1 file changed, 51 insertions(+)

diff --git a/Documentation/devicetree/bindings/soc/bcm/brcm,bcm6846-pmb.yaml b/Documentation/devicetree/bindings/soc/bcm/brcm,bcm6846-pmb.yaml
new file mode 100644
index 000000000000..85850dc16418
--- /dev/null
+++ b/Documentation/devicetree/bindings/soc/bcm/brcm,bcm6846-pmb.yaml
@@ -0,0 +1,51 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/soc/bcm/brcm,bcm6846-pmb.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Broadcom BCM6846 Processor Monitor Bus
+
+maintainers:
+  - Linus Walleij <linusw at kernel.org>
+
+description: |
+  The Processor Monitor Bus (PMB) connects the third generation Platform
+  Management Controller (PMC3) to the control registers of SoC blocks.
+  The controller provides configuration, arbitration and four keyhole
+  interfaces for indirect register access. Its children share this
+  transport, including serialization of complete register sequences.
+
+  The PMB interface is part of Procmon within the PMC complex and is
+  described by its bus child node. The register bank starts at the
+  PMB configuration register, not at the beginning of Procmon.
+
+properties:
+  compatible:
+    const: brcm,bcm6846-pmb
+
+  reg:
+    maxItems: 1
+    description: PMB configuration, keyhole and address mapping registers
+
+  reset-controller:
+    $ref: /schemas/reset/brcm,bcm6846-pmb-reset.yaml#
+
+required:
+  - compatible
+  - reg
+
+additionalProperties: false
+
+examples:
+  - |
+    /* Called PMB Processor Monitor Bus in vendor tree */
+    bus at ffb20100 {
+        compatible = "brcm,bcm6846-pmb";
+        reg = <0xffb20100 0x200>;
+
+        reset-controller {
+            compatible = "brcm,bcm6846-pmb-reset";
+            #reset-cells = <1>;
+        };
+    };

-- 
2.56.0