[PATCH net-next 4/9] dt-bindings: net: describe the Northstar flow accelerator
From: Florian Fainelli
Date: Mon Nov 16 2026 - 17:27:02 EST
Describe the BCM4708/BCM53011/BCM53012 accelerator register resource and
the GMAC2 consumer phandle. The accelerator is inline on switch CPU port
8; GMAC0 and GMAC1 bypass it. Document the additional port-5/GMAC0 CPU
connection for exceptions that cannot safely traverse the inline lookup.
Keep existing boards unchanged unless their topology explicitly opts in.
Signed-off-by: Florian Fainelli <florian.fainelli@xxxxxxxxxxxx>
---
.../bindings/net/brcm,bcm4708-fa.yaml | 45 +++++++++++++++++++
.../bindings/net/brcm,bcm5301x-gmac.yaml | 27 +++++++++++
MAINTAINERS | 2 +
3 files changed, 74 insertions(+)
create mode 100644 Documentation/devicetree/bindings/net/brcm,bcm4708-fa.yaml
create mode 100644 Documentation/devicetree/bindings/net/brcm,bcm5301x-gmac.yaml
diff --git a/Documentation/devicetree/bindings/net/brcm,bcm4708-fa.yaml b/Documentation/devicetree/bindings/net/brcm,bcm4708-fa.yaml
new file mode 100644
index 000000000000..f744b23433c4
--- /dev/null
+++ b/Documentation/devicetree/bindings/net/brcm,bcm4708-fa.yaml
@@ -0,0 +1,45 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/net/brcm,bcm4708-fa.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Broadcom Northstar BCM4708 and BCM5301X flow accelerator
+
+maintainers:
+ - Florian Fainelli <f.fainelli@xxxxxxxxx>
+
+description: |
+ The flow accelerator is inline between GMAC2 and switch port 8 (IMP0).
+ GMAC0 and GMAC1 bypass it. The GMAC2 BCMA Ethernet node references this
+ register block through a brcm,flow-accelerator phandle. Miss packets carry
+ a prepended accelerator descriptor in place of the embedded switch tag.
+
+ Switch port 5 (IMP5), connected to GMAC0, provides a second CPU path for
+ exceptions that must bypass the accelerator, including TCP control,
+ low-TTL and oversized packets. Describe that CPU port with an ethernet
+ phandle to GMAC0 and an internal, 1 Gbps full-duplex fixed link in the
+ switch's ports node. Port 8 remains the data connection to GMAC2.
+
+properties:
+ compatible:
+ enum:
+ - brcm,bcm4708-fa
+ - brcm,bcm53011-fa
+ - brcm,bcm53012-fa
+
+ reg:
+ maxItems: 1
+
+required:
+ - compatible
+ - reg
+
+additionalProperties: false
+
+examples:
+ - |
+ flow-accelerator@18027c00 {
+ compatible = "brcm,bcm53011-fa";
+ reg = <0x18027c00 0xc0>;
+ };
diff --git a/Documentation/devicetree/bindings/net/brcm,bcm5301x-gmac.yaml b/Documentation/devicetree/bindings/net/brcm,bcm5301x-gmac.yaml
new file mode 100644
index 000000000000..76fbe2abf515
--- /dev/null
+++ b/Documentation/devicetree/bindings/net/brcm,bcm5301x-gmac.yaml
@@ -0,0 +1,27 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/net/brcm,bcm5301x-gmac.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Broadcom Northstar BCMA GMAC flow accelerator connection
+
+maintainers:
+ - Florian Fainelli <f.fainelli@xxxxxxxxx>
+
+description: |
+ BCMA enumerates the Northstar GMACs. This binding describes the optional
+ inline flow accelerator connection on GMAC2, connected to switch IMP0.
+
+select:
+ required:
+ - brcm,flow-accelerator
+
+properties:
+ brcm,flow-accelerator:
+ $ref: /schemas/types.yaml#/definitions/phandle
+ description: |
+ Phandle to the BCM4708, BCM53011 or BCM53012 inline flow accelerator.
+ Only GMAC2 (BCMA Ethernet core unit 2) has this connection.
+
+additionalProperties: true
diff --git a/MAINTAINERS b/MAINTAINERS
index 56212dbc9a0d..dce9a88f4aef 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -5669,6 +5669,8 @@ R: Broadcom internal kernel review list <bcm-kernel-feedback-list@xxxxxxxxxxxx>
L: netdev@xxxxxxxxxxxxxxx
S: Maintained
F: Documentation/devicetree/bindings/net/brcm,amac.yaml
+F: Documentation/devicetree/bindings/net/brcm,bcm4708-fa.yaml
+F: Documentation/devicetree/bindings/net/brcm,bcm5301x-gmac.yaml
F: drivers/net/ethernet/broadcom/bgmac*
F: drivers/net/ethernet/broadcom/unimac.h
--
2.53.0