[PATCH net-next v5 4/9] dt-bindings: mfd: Add SoC-e SWIP parent
From: Vasilij Strassheim
Date: Fri Nov 20 2026 - 09:54:32 EST
Add a binding for the SoC-e SWIP multifunction FPGA IP core.
Describe the shared MMIO address space and address translation for the
required addressed ethernet-switch child and the optional integrated
MDIO controller and MMIO-controlled MDIO multiplexer.
The parent is represented as an IP core, while the Ethernet switch is a
separate ethernet-switch@0 child with its own reg resource.
There are additional synthesis options like an integrated I2C controller
for SFPs, but these are not documented yet. The MFD representation makes
it easier to instantiate such subfunctionalities in future bindings.
Signed-off-by: Vasilij Strassheim <v.strassheim@xxxxxxxxxxxxx>
---
.../devicetree/bindings/mfd/soce,swip.yaml | 138 +++++++++++++++++++++
1 file changed, 138 insertions(+)
diff --git a/Documentation/devicetree/bindings/mfd/soce,swip.yaml b/Documentation/devicetree/bindings/mfd/soce,swip.yaml
new file mode 100644
index 000000000000..69bb9eae379f
--- /dev/null
+++ b/Documentation/devicetree/bindings/mfd/soce,swip.yaml
@@ -0,0 +1,138 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/mfd/soce,swip.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: SoC-e SWIP multifunction Ethernet switch FPGA IP core
+
+maintainers:
+ - Vasilij Strassheim <v.strassheim@xxxxxxxxxxxxx>
+
+description:
+ SoC-e Switch IP (SWIP) cores integrate Ethernet switching logic, an
+ MDIO controller, and an MDIO bus multiplexer in one memory-mapped device.
+ The MDIO bus multiplexer is wired to the integrated MDIO controller.
+
+properties:
+ compatible:
+ const: soce,swip
+
+ reg:
+ maxItems: 1
+
+ '#address-cells':
+ const: 1
+
+ '#size-cells':
+ const: 1
+
+ ranges: true
+
+ ethernet-switch@0:
+ $ref: /schemas/net/dsa/soce,swip-switch.yaml#
+ unevaluatedProperties: false
+
+ mdio-mux@202:
+ $ref: /schemas/net/mdio-mux-mmioreg.yaml#
+ unevaluatedProperties: false
+
+ mdio@204:
+ $ref: /schemas/net/soce,swip-mdio.yaml#
+ unevaluatedProperties: false
+
+required:
+ - compatible
+ - reg
+ - '#address-cells'
+ - '#size-cells'
+ - ranges
+ - ethernet-switch@0
+
+dependentRequired:
+ mdio-mux@202:
+ - mdio@204
+
+additionalProperties: false
+
+examples:
+ - |
+ ip-core@80020000 {
+ compatible = "soce,swip";
+ reg = <0x80020000 0x10000>;
+ ranges = <0x0 0x80020000 0x10000>;
+ #address-cells = <1>;
+ #size-cells = <1>;
+
+ ethernet-switch@0 {
+ compatible = "soce,swip-switch-00-04-0c-10";
+ reg = <0x0 0x10000>;
+
+ ethernet-ports {
+ #address-cells = <1>;
+ #size-cells = <0>;
+
+ ethernet-port@0 {
+ reg = <0>;
+ phy-handle = <&switchphy0>;
+ phy-mode = "rgmii-id";
+ };
+
+ ethernet-port@1 {
+ reg = <1>;
+ phy-handle = <&switchphy1>;
+ phy-mode = "rgmii-id";
+ };
+
+ ethernet-port@2 {
+ reg = <2>;
+ ethernet = <ð0>;
+ phy-mode = "gmii";
+
+ fixed-link {
+ speed = <1000>;
+ full-duplex;
+ };
+ };
+ };
+ };
+
+ mdio-mux@202 {
+ compatible = "mdio-mux-mmioreg", "mdio-mux";
+ reg = <0x202 0x2>;
+ mux-mask = <0x07ff>;
+ mdio-parent-bus = <&mdio_parent>;
+ #address-cells = <1>;
+ #size-cells = <0>;
+
+ mdio@0 {
+ reg = <0>;
+ #address-cells = <1>;
+ #size-cells = <0>;
+
+ switchphy0: ethernet-phy@1 {
+ compatible = "ethernet-phy-ieee802.3-c22";
+ reg = <1>;
+ };
+ };
+
+ mdio@1 {
+ reg = <1>;
+ #address-cells = <1>;
+ #size-cells = <0>;
+
+ switchphy1: ethernet-phy@1 {
+ compatible = "ethernet-phy-ieee802.3-c22";
+ reg = <1>;
+ };
+ };
+ };
+
+ mdio_parent: mdio@204 {
+ compatible = "soce,swip-mdio";
+ reg = <0x204 0xc>, <0x200 0x2>;
+ reg-names = "data", "control";
+ #address-cells = <1>;
+ #size-cells = <0>;
+ };
+ };
--
2.39.5