Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
dt-bindings: fsi: ast2600-fsi-master: Convert to json-schema
Convert to json-schema for the AST2600 FSI master documentation.
Signed-off-by: Eddie James <eajames@linux.ibm.com>
Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Link: https://lore.kernel.org/r/20240522192524.3286237-9-eajames@linux.ibm.com
Signed-off-by: Rob Herring (Arm) <robh@kernel.org>
authored by
Eddie James
and committed by
Rob Herring (Arm)
7767cd04
07f8b912
+80
-36
+80
Documentation/devicetree/bindings/fsi/aspeed,ast2600-fsi-master.yaml
+80
Documentation/devicetree/bindings/fsi/aspeed,ast2600-fsi-master.yaml
···
1
+
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2
+
%YAML 1.2
3
+
---
4
+
$id: http://devicetree.org/schemas/fsi/aspeed,ast2600-fsi-master.yaml#
5
+
$schema: http://devicetree.org/meta-schemas/core.yaml#
6
+
7
+
title: Aspeed FSI master
8
+
9
+
maintainers:
10
+
- Eddie James <eajames@linux.ibm.com>
11
+
12
+
description:
13
+
The AST2600 and later contain two identical FSI masters. They share a
14
+
clock and have a separate interrupt line and output pins.
15
+
16
+
properties:
17
+
compatible:
18
+
enum:
19
+
- aspeed,ast2600-fsi-master
20
+
21
+
reg:
22
+
maxItems: 1
23
+
24
+
clocks:
25
+
maxItems: 1
26
+
27
+
cfam-reset-gpios:
28
+
maxItems: 1
29
+
description:
30
+
Output GPIO pin for CFAM reset
31
+
32
+
fsi-routing-gpios:
33
+
maxItems: 1
34
+
description:
35
+
Output GPIO pin for setting the FSI mux (internal or cabled)
36
+
37
+
fsi-mux-gpios:
38
+
maxItems: 1
39
+
description:
40
+
Input GPIO pin for detecting the desired FSI mux state
41
+
42
+
interrupts:
43
+
maxItems: 1
44
+
45
+
required:
46
+
- compatible
47
+
- reg
48
+
- clocks
49
+
- interrupts
50
+
51
+
allOf:
52
+
- $ref: fsi-controller.yaml#
53
+
54
+
unevaluatedProperties: false
55
+
56
+
examples:
57
+
- |
58
+
#include <dt-bindings/clock/ast2600-clock.h>
59
+
#include <dt-bindings/gpio/aspeed-gpio.h>
60
+
#include <dt-bindings/interrupt-controller/arm-gic.h>
61
+
fsi-master@1e79b000 {
62
+
compatible = "aspeed,ast2600-fsi-master";
63
+
reg = <0x1e79b000 0x94>;
64
+
#address-cells = <2>;
65
+
#size-cells = <0>;
66
+
interrupts = <GIC_SPI 100 IRQ_TYPE_LEVEL_HIGH>;
67
+
pinctrl-names = "default";
68
+
pinctrl-0 = <&pinctrl_fsi1_default>;
69
+
clocks = <&syscon ASPEED_CLK_GATE_FSICLK>;
70
+
fsi-routing-gpios = <&gpio0 ASPEED_GPIO(Q, 7) GPIO_ACTIVE_HIGH>;
71
+
fsi-mux-gpios = <&gpio0 ASPEED_GPIO(B, 0) GPIO_ACTIVE_HIGH>;
72
+
cfam-reset-gpios = <&gpio0 ASPEED_GPIO(Q, 0) GPIO_ACTIVE_LOW>;
73
+
74
+
cfam@0,0 {
75
+
reg = <0 0>;
76
+
#address-cells = <1>;
77
+
#size-cells = <1>;
78
+
chip-id = <0>;
79
+
};
80
+
};
-36
Documentation/devicetree/bindings/fsi/fsi-master-aspeed.txt
-36
Documentation/devicetree/bindings/fsi/fsi-master-aspeed.txt
···
1
-
Device-tree bindings for AST2600 FSI master
2
-
-------------------------------------------
3
-
4
-
The AST2600 contains two identical FSI masters. They share a clock and have a
5
-
separate interrupt line and output pins.
6
-
7
-
Required properties:
8
-
- compatible: "aspeed,ast2600-fsi-master"
9
-
- reg: base address and length
10
-
- clocks: phandle and clock number
11
-
- interrupts: platform dependent interrupt description
12
-
- pinctrl-0: phandle to pinctrl node
13
-
- pinctrl-names: pinctrl state
14
-
15
-
Optional properties:
16
-
- cfam-reset-gpios: GPIO for CFAM reset
17
-
18
-
- fsi-routing-gpios: GPIO for setting the FSI mux (internal or cabled)
19
-
- fsi-mux-gpios: GPIO for detecting the desired FSI mux state
20
-
21
-
22
-
Examples:
23
-
24
-
fsi-master {
25
-
compatible = "aspeed,ast2600-fsi-master", "fsi-master";
26
-
reg = <0x1e79b000 0x94>;
27
-
interrupts = <GIC_SPI 100 IRQ_TYPE_LEVEL_HIGH>;
28
-
pinctrl-names = "default";
29
-
pinctrl-0 = <&pinctrl_fsi1_default>;
30
-
clocks = <&syscon ASPEED_CLK_GATE_FSICLK>;
31
-
32
-
fsi-routing-gpios = <&gpio0 ASPEED_GPIO(Q, 7) GPIO_ACTIVE_HIGH>;
33
-
fsi-mux-gpios = <&gpio0 ASPEED_GPIO(B, 0) GPIO_ACTIVE_HIGH>;
34
-
35
-
cfam-reset-gpios = <&gpio0 ASPEED_GPIO(Q, 0) GPIO_ACTIVE_LOW>;
36
-
};