[PATCH v5 1/3] dt-bindings: hwlock: Adding brcmstb-hwspinlock support
From: Kamal Dasu <kamal.dasu@broadcom.com>
Date: 2026-02-24 01:48:17
Also in:
linux-devicetree, linux-remoteproc, lkml
Subsystem:
hardware spinlock core, open firmware and flattened device tree bindings, the rest · Maintainers:
Bjorn Andersson, Rob Herring, Krzysztof Kozlowski, Conor Dooley, Linus Torvalds
The Broadcom settop SoCs have hardware semaphores as part of the "sundry" IP block which has other controls that do not belong anywhere else e.g. pin/mux controls, SoC identification, drive strength, reset controls, and other misc bits are part of this block. Adding brcmstb-hwspinlock bindings which allows the hwspinlock driver to iomap only the 16 hardware semaphore registers that are part of all settop SoCs. The semaphore registers are based on the BCM7038 SoC where they were first introduced in settop chips. Signed-off-by: Kamal Dasu <kamal.dasu@broadcom.com> --- .../hwlock/brcm,brcmstb-hwspinlock.yaml | 45 +++++++++++++++++++ 1 file changed, 45 insertions(+) create mode 100644 Documentation/devicetree/bindings/hwlock/brcm,brcmstb-hwspinlock.yaml
diff --git a/Documentation/devicetree/bindings/hwlock/brcm,brcmstb-hwspinlock.yaml b/Documentation/devicetree/bindings/hwlock/brcm,brcmstb-hwspinlock.yaml
new file mode 100644
index 000000000000..416d8d2948af
--- /dev/null
+++ b/Documentation/devicetree/bindings/hwlock/brcm,brcmstb-hwspinlock.yaml@@ -0,0 +1,45 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/hwlock/brcm,brcmstb-hwspinlock.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Broadcom Settop Sundry Block Hardware Semaphore + +description: + Broadcom settop SoCs contain 16 hardware semaphore registers + (SEMAPHORE_0 through SEMAPHORE_15) that provide hardware-arbitrated + mutual exclusion between drivers running on the SoC. + + The semaphore registers belong to the sundry hardware block. The + node describes the semaphore register range carved out of the larger + sundry block address space. + +maintainers: + - Kamal Dasu <kamal.dasu@broadcom.com> + +properties: + compatible: + const: brcm,bcm7038-sun-top-ctrl-semaphore + + "#hwlock-cells": + const: 1 + + reg: + maxItems: 1 + +required: + - compatible + - reg + - "#hwlock-cells" + +additionalProperties: false + +examples: + - | + hwlock@404038 { + compatible = "brcm,bcm7038-sun-top-ctrl-semaphore"; + reg = <0x404038 0x40>; + #hwlock-cells = <1>; + }; +
--
2.34.1