Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
dt-bindings: board: convert fsl-board.txt to yaml
Convert binding doc fsl-board.txt to yaml format. split to 3 part
fsl,bcsr.yaml, fsl,fpga-qixis.yaml, fsl,fpga-qixis-i2c.yaml
Additional change for fsl,fpga-qixis.yaml
- Add childnode mdio-mux-emi*
- Add compatible string fsl,ls1043aqds-fpga, fsl,ls1043ardb-fpga,
fsl,ls1046aqds-fpga, fsl,ls1046ardb-fpga, fsl,ls208xaqds-fpga,
fsl,ls1043ardb-cpld, fsl,ls1046ardb-cpld, fsl,ls1088aqds-fpga,
fsl,ls1088ardb-fpga, fsl,ls2080aqds-fpga, fsl,ls2080ardb-fpga.
- Change address to 32bit in example.
Additional change for fsl,fpga-qixis-i2c.yaml
- Add mux-controller
- Add compatible string fsl,ls1028aqds-fpga, fsl,lx2160aqds-fpga
Fix below warning:
arch/arm64/boot/dts/freescale/fsl-ls1028a-qds.dtb: /soc/i2c@2000000/fpga@66: failed to match any schema with compatible: ['fsl,ls1028aqds-fpga', 'fsl,fpga-qixis-i2c', 'simple-mfd']
Signed-off-by: Frank Li <Frank.Li@nxp.com>
Link: https://lore.kernel.org/r/20240813163638.3889778-1-Frank.Li@nxp.com
[robh: tweak mdio-mux node name, drop .dts change]
Signed-off-by: Rob Herring (Arm) <robh@kernel.org>
authored by
Frank Li
and committed by
Rob Herring (Arm)
daa2be74
d2a97be3
+183
-81
+32
Documentation/devicetree/bindings/board/fsl,bcsr.yaml
+32
Documentation/devicetree/bindings/board/fsl,bcsr.yaml
···
1
+
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2
+
%YAML 1.2
3
+
---
4
+
$id: http://devicetree.org/schemas/board/fsl,bcsr.yaml#
5
+
$schema: http://devicetree.org/meta-schemas/core.yaml#
6
+
7
+
title: Board Control and Status
8
+
9
+
maintainers:
10
+
- Frank Li <Frank.Li@nxp.com>
11
+
12
+
properties:
13
+
compatible:
14
+
enum:
15
+
- fsl,mpc8360mds-bcsr
16
+
17
+
reg:
18
+
maxItems: 1
19
+
20
+
required:
21
+
- compatible
22
+
- reg
23
+
24
+
additionalProperties: false
25
+
26
+
examples:
27
+
- |
28
+
board@f8000000 {
29
+
compatible = "fsl,mpc8360mds-bcsr";
30
+
reg = <0xf8000000 0x8000>;
31
+
};
32
+
+70
Documentation/devicetree/bindings/board/fsl,fpga-qixis-i2c.yaml
+70
Documentation/devicetree/bindings/board/fsl,fpga-qixis-i2c.yaml
···
1
+
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2
+
%YAML 1.2
3
+
---
4
+
$id: http://devicetree.org/schemas/board/fsl,fpga-qixis-i2c.yaml#
5
+
$schema: http://devicetree.org/meta-schemas/core.yaml#
6
+
7
+
title: Freescale on-board FPGA connected on I2C bus
8
+
9
+
maintainers:
10
+
- Frank Li <Frank.Li@nxp.com>
11
+
12
+
properties:
13
+
compatible:
14
+
oneOf:
15
+
- items:
16
+
- enum:
17
+
- fsl,bsc9132qds-fpga
18
+
- const: fsl,fpga-qixis-i2c
19
+
- items:
20
+
- enum:
21
+
- fsl,ls1028aqds-fpga
22
+
- fsl,lx2160aqds-fpga
23
+
- const: fsl,fpga-qixis-i2c
24
+
- const: simple-mfd
25
+
26
+
interrupts:
27
+
maxItems: 1
28
+
29
+
reg:
30
+
maxItems: 1
31
+
32
+
mux-controller:
33
+
$ref: /schemas/mux/reg-mux.yaml
34
+
35
+
required:
36
+
- compatible
37
+
- reg
38
+
39
+
additionalProperties: false
40
+
41
+
examples:
42
+
- |
43
+
i2c {
44
+
#address-cells = <1>;
45
+
#size-cells = <0>;
46
+
47
+
board-control@66 {
48
+
compatible = "fsl,bsc9132qds-fpga", "fsl,fpga-qixis-i2c";
49
+
reg = <0x66>;
50
+
};
51
+
};
52
+
53
+
- |
54
+
i2c {
55
+
#address-cells = <1>;
56
+
#size-cells = <0>;
57
+
58
+
board-control@66 {
59
+
compatible = "fsl,ls1028aqds-fpga", "fsl,fpga-qixis-i2c",
60
+
"simple-mfd";
61
+
reg = <0x66>;
62
+
63
+
mux-controller {
64
+
compatible = "reg-mux";
65
+
#mux-control-cells = <1>;
66
+
mux-reg-masks = <0x54 0xf0>; /* 0: reg 0x54, bits 7:4 */
67
+
};
68
+
};
69
+
};
70
+
+81
Documentation/devicetree/bindings/board/fsl,fpga-qixis.yaml
+81
Documentation/devicetree/bindings/board/fsl,fpga-qixis.yaml
···
1
+
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2
+
%YAML 1.2
3
+
---
4
+
$id: http://devicetree.org/schemas/board/fsl,fpga-qixis.yaml#
5
+
$schema: http://devicetree.org/meta-schemas/core.yaml#
6
+
7
+
title: Freescale on-board FPGA/CPLD
8
+
9
+
maintainers:
10
+
- Frank Li <Frank.Li@nxp.com>
11
+
12
+
properties:
13
+
compatible:
14
+
oneOf:
15
+
- items:
16
+
- const: fsl,p1022ds-fpga
17
+
- const: fsl,fpga-ngpixis
18
+
- items:
19
+
- enum:
20
+
- fsl,ls1088aqds-fpga
21
+
- fsl,ls1088ardb-fpga
22
+
- fsl,ls2080aqds-fpga
23
+
- fsl,ls2080ardb-fpga
24
+
- const: fsl,fpga-qixis
25
+
- items:
26
+
- enum:
27
+
- fsl,ls1043aqds-fpga
28
+
- fsl,ls1043ardb-fpga
29
+
- fsl,ls1046aqds-fpga
30
+
- fsl,ls1046ardb-fpga
31
+
- fsl,ls208xaqds-fpga
32
+
- const: fsl,fpga-qixis
33
+
- const: simple-mfd
34
+
- enum:
35
+
- fsl,ls1043ardb-cpld
36
+
- fsl,ls1046ardb-cpld
37
+
- fsl,t1040rdb-cpld
38
+
- fsl,t1042rdb-cpld
39
+
- fsl,t1042rdb_pi-cpld
40
+
41
+
interrupts:
42
+
maxItems: 1
43
+
44
+
reg:
45
+
maxItems: 1
46
+
47
+
"#address-cells":
48
+
const: 1
49
+
50
+
"#size-cells":
51
+
const: 1
52
+
53
+
ranges:
54
+
maxItems: 1
55
+
56
+
patternProperties:
57
+
'^mdio-mux@[a-f0-9,]+$':
58
+
$ref: /schemas/net/mdio-mux-mmioreg.yaml
59
+
60
+
required:
61
+
- compatible
62
+
- reg
63
+
64
+
additionalProperties: false
65
+
66
+
examples:
67
+
- |
68
+
#include <dt-bindings/interrupt-controller/irq.h>
69
+
board-control@3 {
70
+
compatible = "fsl,p1022ds-fpga", "fsl,fpga-ngpixis";
71
+
reg = <3 0x30>;
72
+
interrupt-parent = <&mpic>;
73
+
interrupts = <8 IRQ_TYPE_LEVEL_LOW 0 0>;
74
+
};
75
+
76
+
- |
77
+
board-control@3 {
78
+
compatible = "fsl,ls2080ardb-fpga", "fsl,fpga-qixis";
79
+
reg = <0x3 0x10000>;
80
+
};
81
+
-81
Documentation/devicetree/bindings/board/fsl-board.txt
-81
Documentation/devicetree/bindings/board/fsl-board.txt
···
1
-
Freescale Reference Board Bindings
2
-
3
-
This document describes device tree bindings for various devices that
4
-
exist on some Freescale reference boards.
5
-
6
-
* Board Control and Status (BCSR)
7
-
8
-
Required properties:
9
-
10
-
- compatible : Should be "fsl,<board>-bcsr"
11
-
- reg : Offset and length of the register set for the device
12
-
13
-
Example:
14
-
15
-
bcsr@f8000000 {
16
-
compatible = "fsl,mpc8360mds-bcsr";
17
-
reg = <f8000000 8000>;
18
-
};
19
-
20
-
* Freescale on-board FPGA
21
-
22
-
This is the memory-mapped registers for on board FPGA.
23
-
24
-
Required properties:
25
-
- compatible: should be a board-specific string followed by a string
26
-
indicating the type of FPGA. Example:
27
-
"fsl,<board>-fpga", "fsl,fpga-pixis", or
28
-
"fsl,<board>-fpga", "fsl,fpga-qixis"
29
-
- reg: should contain the address and the length of the FPGA register set.
30
-
31
-
Optional properties:
32
-
- interrupts: should specify event (wakeup) IRQ.
33
-
34
-
Example (P1022DS):
35
-
36
-
board-control@3,0 {
37
-
compatible = "fsl,p1022ds-fpga", "fsl,fpga-ngpixis";
38
-
reg = <3 0 0x30>;
39
-
interrupt-parent = <&mpic>;
40
-
interrupts = <8 8 0 0>;
41
-
};
42
-
43
-
Example (LS2080A-RDB):
44
-
45
-
cpld@3,0 {
46
-
compatible = "fsl,ls2080ardb-fpga", "fsl,fpga-qixis";
47
-
reg = <0x3 0 0x10000>;
48
-
};
49
-
50
-
* Freescale on-board FPGA connected on I2C bus
51
-
52
-
Some Freescale boards like BSC9132QDS have on board FPGA connected on
53
-
the i2c bus.
54
-
55
-
Required properties:
56
-
- compatible: Should be a board-specific string followed by a string
57
-
indicating the type of FPGA. Example:
58
-
"fsl,<board>-fpga", "fsl,fpga-qixis-i2c"
59
-
- reg: Should contain the address of the FPGA
60
-
61
-
Example:
62
-
fpga: fpga@66 {
63
-
compatible = "fsl,bsc9132qds-fpga", "fsl,fpga-qixis-i2c";
64
-
reg = <0x66>;
65
-
};
66
-
67
-
* Freescale on-board CPLD
68
-
69
-
Some Freescale boards like T1040RDB have an on board CPLD connected.
70
-
71
-
Required properties:
72
-
- compatible: Should be a board-specific string like "fsl,<board>-cpld"
73
-
Example:
74
-
"fsl,t1040rdb-cpld", "fsl,t1042rdb-cpld", "fsl,t1042rdb_pi-cpld"
75
-
- reg: should describe CPLD registers
76
-
77
-
Example:
78
-
cpld@3,0 {
79
-
compatible = "fsl,t1040rdb-cpld";
80
-
reg = <3 0 0x300>;
81
-
};