* [PATCH net-next] dt-bindings: net: Convert hisilicon,hns-nic to DT schema
@ 2026-09-25 21:59 Rob Herring (Arm)
0 siblings, 0 replies; only message in thread
From: Rob Herring (Arm) @ 2026-09-25 21:59 UTC (permalink / raw)
To: Andrew Lunn, David S. Miller, Eric Dumazet, Jakub Kicinski,
Paolo Abeni, Krzysztof Kozlowski, Conor Dooley, Jian Shen,
Jijie Shao
Cc: netdev, devicetree, linux-kernel
Convert the hisilicon,hns-nic binding to DT schema format. It's a
straight forward conversion.
Assisted-by: LLM
Signed-off-by: Rob Herring (Arm) <robh@kernel.org>
---
.../bindings/net/hisilicon,hns-nic.yaml | 107 ++++++++++++++++++
.../bindings/net/hisilicon-hns-nic.txt | 76 -------------
2 files changed, 107 insertions(+), 76 deletions(-)
create mode 100644 Documentation/devicetree/bindings/net/hisilicon,hns-nic.yaml
delete mode 100644 Documentation/devicetree/bindings/net/hisilicon-hns-nic.txt
diff --git a/Documentation/devicetree/bindings/net/hisilicon,hns-nic.yaml b/Documentation/devicetree/bindings/net/hisilicon,hns-nic.yaml
new file mode 100644
index 000000000000..1b14348e74d8
--- /dev/null
+++ b/Documentation/devicetree/bindings/net/hisilicon,hns-nic.yaml
@@ -0,0 +1,107 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/net/hisilicon,hns-nic.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Hisilicon Network Subsystem NIC controller
+
+maintainers:
+ - Jian Shen <shenjian15@huawei.com>
+ - Jijie Shao <shaojijie@huawei.com>
+
+allOf:
+ - $ref: ethernet-controller.yaml#
+
+properties:
+ compatible:
+ enum:
+ - hisilicon,hns-nic-v1
+ - hisilicon,hns-nic-v2
+
+ ae-handle:
+ description:
+ accelerator engine handle for hns, specifies a reference to the
+ associating hardware driver node.
+ $ref: /schemas/types.yaml#/definitions/phandle
+
+ port-id:
+ description: |
+ is the index of port provided by DSAF (the accelerator). DSAF can connect to 8 PHYs.
+ Port 0 to 1 are both used for administration purpose.
+ They are called debug ports.
+
+ The remaining 6 PHYs are taken according to the mode of DSAF.
+
+ In NIC mode of DSAF, all 6 PHYs are taken as ethernet ports to the CPU.
+ The port-id can be 2 to 7. Here is the diagram:
+ +-----+---------------+
+ | CPU |
+ +-+-+-+---+-+-+-+-+-+-+
+ | | | | | | | |
+ debug service
+ port port
+ (0,1) (2-7)
+
+ In Switch mode of DSAF, all 6 PHYs are taken as physical ports connect to a LAN Switch,
+ while the CPU side assume itself have one single NIC connect to this switch.
+ In this case, the port-id will be 2 only.
+ +-----+---------------+
+ | CPU |
+ +-+-+-+---+-+-+-+-+-+-+
+ | | service| port(2)
+ debug +------------+
+ port | switch |
+ (0,1) +-+-+-+-+-+-++
+ | | | | | |
+ external port
+ $ref: /schemas/types.yaml#/definitions/uint32
+ maximum: 7
+
+ port-idx-in-ae:
+ description: |
+ is the index of port provided by AE.
+ In NIC mode of DSAF, all 6 PHYs of service DSAF are taken as ethernet ports to the CPU.
+ The port-idx-in-ae can be 0 to 5. Here is the diagram:
+ +-----+---------------+
+ | CPU |
+ +-+-+-+---+-+-+-+-+-+-+
+ | | | | | | | |
+ debug debug service
+ port port port
+ (0) (0) (0-5)
+
+ In Switch mode of DSAF, all 6 PHYs of service DSAF are taken as physical ports connected to
+ a LAN Switch,
+ while the CPU side assume itself have one single NIC connected to this switch.
+ In this case, the port-idx-in-ae will be 0 only.
+ +-----+-----+------+------+
+ | CPU |
+ +-+-+-+-+-+-+-+-+-+-+-+-+-+
+ | | service| port(0)
+ debug debug +------------+
+ port port | switch |
+ (0) (0) +-+-+-+-+-+-++
+ | | | | | |
+ external port
+ $ref: /schemas/types.yaml#/definitions/uint32
+ maximum: 5
+
+ dma-coherent: true
+
+required:
+ - compatible
+ - ae-handle
+ - port-idx-in-ae
+ - local-mac-address
+
+unevaluatedProperties: false
+
+examples:
+ - |
+ ethernet {
+ compatible = "hisilicon,hns-nic-v1";
+ ae-handle = <&dsaf0>;
+ port-idx-in-ae = <0>;
+ local-mac-address = [a2 14 e4 4b 56 76];
+ };
diff --git a/Documentation/devicetree/bindings/net/hisilicon-hns-nic.txt b/Documentation/devicetree/bindings/net/hisilicon-hns-nic.txt
deleted file mode 100644
index f0421ee3c714..000000000000
--- a/Documentation/devicetree/bindings/net/hisilicon-hns-nic.txt
+++ /dev/null
@@ -1,76 +0,0 @@
-Hisilicon Network Subsystem NIC controller
-
-Required properties:
-- compatible: "hisilicon,hns-nic-v1" or "hisilicon,hns-nic-v2".
- "hisilicon,hns-nic-v1" is for hip05.
- "hisilicon,hns-nic-v2" is for Hi1610 and Hi1612.
-- ae-handle: accelerator engine handle for hns,
- specifies a reference to the associating hardware driver node.
- see Documentation/devicetree/bindings/net/hisilicon-hns-dsaf.txt
-- port-id: is the index of port provided by DSAF (the accelerator). DSAF can
- connect to 8 PHYs. Port 0 to 1 are both used for administration purpose. They
- are called debug ports.
-
- The remaining 6 PHYs are taken according to the mode of DSAF.
-
- In NIC mode of DSAF, all 6 PHYs are taken as ethernet ports to the CPU. The
- port-id can be 2 to 7. Here is the diagram:
- +-----+---------------+
- | CPU |
- +-+-+-+---+-+-+-+-+-+-+
- | | | | | | | |
- debug service
- port port
- (0,1) (2-7)
-
- In Switch mode of DSAF, all 6 PHYs are taken as physical ports connect to a
- LAN Switch while the CPU side assume itself have one single NIC connect to
- this switch. In this case, the port-id will be 2 only.
- +-----+---------------+
- | CPU |
- +-+-+-+---+-+-+-+-+-+-+
- | | service| port(2)
- debug +------------+
- port | switch |
- (0,1) +-+-+-+-+-+-++
- | | | | | |
- external port
-
- This attribute is remained for compatible purpose. It is not recommended to
- use it in new code.
-
-- port-idx-in-ae: is the index of port provided by AE.
- In NIC mode of DSAF, all 6 PHYs of service DSAF are taken as ethernet ports
- to the CPU. The port-idx-in-ae can be 0 to 5. Here is the diagram:
- +-----+---------------+
- | CPU |
- +-+-+-+---+-+-+-+-+-+-+
- | | | | | | | |
- debug debug service
- port port port
- (0) (0) (0-5)
-
- In Switch mode of DSAF, all 6 PHYs of service DSAF are taken as physical
- ports connected to a LAN Switch while the CPU side assume itself have one
- single NIC connected to this switch. In this case, the port-idx-in-ae
- will be 0 only.
- +-----+-----+------+------+
- | CPU |
- +-+-+-+-+-+-+-+-+-+-+-+-+-+
- | | service| port(0)
- debug debug +------------+
- port port | switch |
- (0) (0) +-+-+-+-+-+-++
- | | | | | |
- external port
-
-- local-mac-address: mac addr of the ethernet interface
-
-Example:
-
- ethernet@0{
- compatible = "hisilicon,hns-nic-v1";
- ae-handle = <&dsaf0>;
- port-idx-in-ae = <0>;
- local-mac-address = [a2 14 e4 4b 56 76];
- };
--
2.53.0
^ permalink raw reply [flat|nested] only message in thread
only message in thread, other threads:[~2026-09-25 21:59 UTC | newest]
Thread overview: (only message) (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2026-09-25 21:59 [PATCH net-next] dt-bindings: net: Convert hisilicon,hns-nic to DT schema Rob Herring (Arm)
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox
all inboxes | Powered by JetHome®