Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
dt-bindings: net: davinci-mdio: convert bindings to json-schema
Now that we have the DT validation in place, let's convert the device tree
bindings for the TI SoC Davinci/OMAP/Keystone2 MDIO Controllerr over to a
YAML schemas.
Signed-off-by: Grygorii Strashko <grygorii.strashko@ti.com>
Reviewed-by: Simon Horman <simon.horman@netronome.com>
Signed-off-by: Rob Herring <robh@kernel.org>
authored by
Grygorii Strashko
and committed by
Rob Herring
6453ae7f
454f5d9d
+71
-36
-36
Documentation/devicetree/bindings/net/davinci-mdio.txt
-36
Documentation/devicetree/bindings/net/davinci-mdio.txt
···
1
-
TI SoC Davinci/Keystone2 MDIO Controller Device Tree Bindings
2
-
---------------------------------------------------
3
-
4
-
Required properties:
5
-
- compatible : Should be "ti,davinci_mdio"
6
-
and "ti,keystone_mdio" for Keystone 2 SoCs
7
-
and "ti,cpsw-mdio" for am335x, am472x, am57xx/dra7, dm814x SoCs
8
-
and "ti,am4372-mdio" for am472x SoC
9
-
- reg : physical base address and size of the davinci mdio
10
-
registers map
11
-
- bus_freq : Mdio Bus frequency
12
-
13
-
Optional properties:
14
-
- ti,hwmods : Must be "davinci_mdio"
15
-
16
-
Note: "ti,hwmods" field is used to fetch the base address and irq
17
-
resources from TI, omap hwmod data base during device registration.
18
-
Future plan is to migrate hwmod data base contents into device tree
19
-
blob so that, all the required data will be used from device tree dts
20
-
file.
21
-
22
-
Examples:
23
-
24
-
mdio: davinci_mdio@4a101000 {
25
-
compatible = "ti,davinci_mdio";
26
-
reg = <0x4A101000 0x1000>;
27
-
bus_freq = <1000000>;
28
-
};
29
-
30
-
(or)
31
-
32
-
mdio: davinci_mdio@4a101000 {
33
-
compatible = "ti,davinci_mdio";
34
-
ti,hwmods = "davinci_mdio";
35
-
bus_freq = <1000000>;
36
-
};
+71
Documentation/devicetree/bindings/net/ti,davinci-mdio.yaml
+71
Documentation/devicetree/bindings/net/ti,davinci-mdio.yaml
···
1
+
# SPDX-License-Identifier: GPL-2.0
2
+
%YAML 1.2
3
+
---
4
+
$id: http://devicetree.org/schemas/net/ti,davinci-mdio.yaml#
5
+
$schema: http://devicetree.org/meta-schemas/core.yaml#
6
+
7
+
title: TI SoC Davinci/Keystone2 MDIO Controller
8
+
9
+
maintainers:
10
+
- Grygorii Strashko <grygorii.strashko@ti.com>
11
+
12
+
description:
13
+
TI SoC Davinci/Keystone2 MDIO Controller
14
+
15
+
allOf:
16
+
- $ref: "mdio.yaml#"
17
+
18
+
properties:
19
+
compatible:
20
+
oneOf:
21
+
- const: ti,davinci_mdio
22
+
- items:
23
+
- const: ti,keystone_mdio
24
+
- const: ti,davinci_mdio
25
+
- items:
26
+
- const: ti,cpsw-mdio
27
+
- const: ti,davinci_mdio
28
+
- items:
29
+
- const: ti,am4372-mdio
30
+
- const: ti,cpsw-mdio
31
+
- const: ti,davinci_mdio
32
+
33
+
reg:
34
+
maxItems: 1
35
+
36
+
bus_freq:
37
+
maximum: 2500000
38
+
description:
39
+
MDIO Bus frequency
40
+
41
+
ti,hwmods:
42
+
description: TI hwmod name
43
+
deprecated: true
44
+
allOf:
45
+
- $ref: /schemas/types.yaml#/definitions/string-array
46
+
- items:
47
+
const: davinci_mdio
48
+
49
+
if:
50
+
properties:
51
+
compatible:
52
+
contains:
53
+
const: ti,davinci_mdio
54
+
required:
55
+
- bus_freq
56
+
57
+
required:
58
+
- compatible
59
+
- reg
60
+
- "#address-cells"
61
+
- "#size-cells"
62
+
63
+
examples:
64
+
- |
65
+
davinci_mdio: mdio@4a101000 {
66
+
compatible = "ti,davinci_mdio";
67
+
#address-cells = <1>;
68
+
#size-cells = <0>;
69
+
reg = <0x4a101000 0x1000>;
70
+
bus_freq = <1000000>;
71
+
};