Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

dt-bindings: net: ftgmac100: convert to yaml version from txt

Conversion from ftgmac100.txt to yaml format version.

Signed-off-by: Ivan Mikhaylov <fr0st61te@gmail.com>
Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Link: https://lore.kernel.org/r/20230805135318.6102-1-fr0st61te@gmail.com
Signed-off-by: Rob Herring <robh@kernel.org>

authored by

Ivan Mikhaylov and committed by
Rob Herring
7d0fef8e 7cd8f2ab

+102 -67
+102
Documentation/devicetree/bindings/net/faraday,ftgmac100.yaml
··· 1 + # SPDX-License-Identifier: GPL-2.0 2 + %YAML 1.2 3 + --- 4 + $id: http://devicetree.org/schemas/net/faraday,ftgmac100.yaml# 5 + $schema: http://devicetree.org/meta-schemas/core.yaml# 6 + 7 + title: Faraday Technology FTGMAC100 gigabit ethernet controller 8 + 9 + allOf: 10 + - $ref: ethernet-controller.yaml# 11 + 12 + maintainers: 13 + - Po-Yu Chuang <ratbert@faraday-tech.com> 14 + 15 + properties: 16 + compatible: 17 + oneOf: 18 + - const: faraday,ftgmac100 19 + - items: 20 + - enum: 21 + - aspeed,ast2400-mac 22 + - aspeed,ast2500-mac 23 + - aspeed,ast2600-mac 24 + - const: faraday,ftgmac100 25 + 26 + reg: 27 + maxItems: 1 28 + 29 + interrupts: 30 + maxItems: 1 31 + 32 + clocks: 33 + minItems: 1 34 + items: 35 + - description: MAC IP clock 36 + - description: RMII RCLK gate for AST2500/2600 37 + 38 + clock-names: 39 + minItems: 1 40 + items: 41 + - const: MACCLK 42 + - const: RCLK 43 + 44 + phy-mode: 45 + enum: 46 + - rgmii 47 + - rmii 48 + 49 + phy-handle: true 50 + 51 + use-ncsi: 52 + description: 53 + Use the NC-SI stack instead of an MDIO PHY. Currently assumes 54 + rmii (100bT) but kept as a separate property in case NC-SI grows support 55 + for a gigabit link. 56 + type: boolean 57 + 58 + no-hw-checksum: 59 + description: 60 + Used to disable HW checksum support. Here for backward 61 + compatibility as the driver now should have correct defaults based on 62 + the SoC. 63 + type: boolean 64 + deprecated: true 65 + 66 + mdio: 67 + $ref: /schemas/net/mdio.yaml# 68 + 69 + required: 70 + - compatible 71 + - reg 72 + - interrupts 73 + 74 + unevaluatedProperties: false 75 + 76 + examples: 77 + - | 78 + ethernet@1e660000 { 79 + compatible = "aspeed,ast2500-mac", "faraday,ftgmac100"; 80 + reg = <0x1e660000 0x180>; 81 + interrupts = <2>; 82 + use-ncsi; 83 + }; 84 + 85 + ethernet@1e680000 { 86 + compatible = "aspeed,ast2500-mac", "faraday,ftgmac100"; 87 + reg = <0x1e680000 0x180>; 88 + interrupts = <2>; 89 + 90 + phy-handle = <&phy>; 91 + phy-mode = "rgmii"; 92 + 93 + mdio { 94 + #address-cells = <1>; 95 + #size-cells = <0>; 96 + 97 + phy: ethernet-phy@1 { 98 + compatible = "ethernet-phy-ieee802.3-c22"; 99 + reg = <1>; 100 + }; 101 + }; 102 + };
-67
Documentation/devicetree/bindings/net/ftgmac100.txt
··· 1 - * Faraday Technology FTGMAC100 gigabit ethernet controller 2 - 3 - Required properties: 4 - - compatible: "faraday,ftgmac100" 5 - 6 - Must also contain one of these if used as part of an Aspeed AST2400 7 - or 2500 family SoC as they have some subtle tweaks to the 8 - implementation: 9 - 10 - - "aspeed,ast2400-mac" 11 - - "aspeed,ast2500-mac" 12 - - "aspeed,ast2600-mac" 13 - 14 - - reg: Address and length of the register set for the device 15 - - interrupts: Should contain ethernet controller interrupt 16 - 17 - Optional properties: 18 - - phy-handle: See ethernet.txt file in the same directory. 19 - - phy-mode: See ethernet.txt file in the same directory. If the property is 20 - absent, "rgmii" is assumed. Supported values are "rgmii*" and "rmii" for 21 - aspeed parts. Other (unknown) parts will accept any value. 22 - - use-ncsi: Use the NC-SI stack instead of an MDIO PHY. Currently assumes 23 - rmii (100bT) but kept as a separate property in case NC-SI grows support 24 - for a gigabit link. 25 - - no-hw-checksum: Used to disable HW checksum support. Here for backward 26 - compatibility as the driver now should have correct defaults based on 27 - the SoC. 28 - - clocks: In accordance with the generic clock bindings. Must describe the MAC 29 - IP clock, and optionally an RMII RCLK gate for the AST2500/AST2600. The 30 - required MAC clock must be the first cell. 31 - - clock-names: 32 - 33 - - "MACCLK": The MAC IP clock 34 - - "RCLK": Clock gate for the RMII RCLK 35 - 36 - Optional subnodes: 37 - - mdio: See mdio.txt file in the same directory. 38 - 39 - Example: 40 - 41 - mac0: ethernet@1e660000 { 42 - compatible = "aspeed,ast2500-mac", "faraday,ftgmac100"; 43 - reg = <0x1e660000 0x180>; 44 - interrupts = <2>; 45 - use-ncsi; 46 - }; 47 - 48 - Example with phy-handle: 49 - 50 - mac1: ethernet@1e680000 { 51 - compatible = "aspeed,ast2500-mac", "faraday,ftgmac100"; 52 - reg = <0x1e680000 0x180>; 53 - interrupts = <2>; 54 - 55 - phy-handle = <&phy>; 56 - phy-mode = "rgmii"; 57 - 58 - mdio { 59 - #address-cells = <1>; 60 - #size-cells = <0>; 61 - 62 - phy: ethernet-phy@1 { 63 - compatible = "ethernet-phy-ieee802.3-c22"; 64 - reg = <1>; 65 - }; 66 - }; 67 - };