Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
dt-bindings: fpga: xilinx-pr-decoupler: convert bindings to json-schema
Convert xilinx-pr-decoupler bindings to DT schema format using json-schema
Signed-off-by: Nava kishore Manne <nava.kishore.manne@amd.com>
Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Link: https://lore.kernel.org/r/20230224111825.161593-1-nava.kishore.manne@amd.com
Signed-off-by: Rob Herring <robh@kernel.org>
authored by
Nava kishore Manne
and committed by
Rob Herring
7795c8d3
fe15c26e
+64
-54
-54
Documentation/devicetree/bindings/fpga/xilinx-pr-decoupler.txt
-54
Documentation/devicetree/bindings/fpga/xilinx-pr-decoupler.txt
···
1
-
Xilinx LogiCORE Partial Reconfig Decoupler Softcore
2
-
3
-
The Xilinx LogiCORE Partial Reconfig Decoupler manages one or more
4
-
decouplers / fpga bridges.
5
-
The controller can decouple/disable the bridges which prevents signal
6
-
changes from passing through the bridge. The controller can also
7
-
couple / enable the bridges which allows traffic to pass through the
8
-
bridge normally.
9
-
10
-
Xilinx LogiCORE Dynamic Function eXchange(DFX) AXI shutdown manager
11
-
Softcore is compatible with the Xilinx LogiCORE pr-decoupler.
12
-
13
-
The Dynamic Function eXchange AXI shutdown manager prevents AXI traffic
14
-
from passing through the bridge. The controller safely handles AXI4MM
15
-
and AXI4-Lite interfaces on a Reconfigurable Partition when it is
16
-
undergoing dynamic reconfiguration, preventing the system deadlock
17
-
that can occur if AXI transactions are interrupted by DFX
18
-
19
-
The Driver supports only MMIO handling. A PR region can have multiple
20
-
PR Decouplers which can be handled independently or chained via decouple/
21
-
decouple_status signals.
22
-
23
-
Required properties:
24
-
- compatible : Should contain "xlnx,pr-decoupler-1.00" followed by
25
-
"xlnx,pr-decoupler" or
26
-
"xlnx,dfx-axi-shutdown-manager-1.00" followed by
27
-
"xlnx,dfx-axi-shutdown-manager"
28
-
- regs : base address and size for decoupler module
29
-
- clocks : input clock to IP
30
-
- clock-names : should contain "aclk"
31
-
32
-
See Documentation/devicetree/bindings/fpga/fpga-region.txt and
33
-
Documentation/devicetree/bindings/fpga/fpga-bridge.txt for generic bindings.
34
-
35
-
Example:
36
-
Partial Reconfig Decoupler:
37
-
fpga-bridge@100000450 {
38
-
compatible = "xlnx,pr-decoupler-1.00",
39
-
"xlnx-pr-decoupler";
40
-
regs = <0x10000045 0x10>;
41
-
clocks = <&clkc 15>;
42
-
clock-names = "aclk";
43
-
bridge-enable = <0>;
44
-
};
45
-
46
-
Dynamic Function eXchange AXI shutdown manager:
47
-
fpga-bridge@100000450 {
48
-
compatible = "xlnx,dfx-axi-shutdown-manager-1.00",
49
-
"xlnx,dfx-axi-shutdown-manager";
50
-
regs = <0x10000045 0x10>;
51
-
clocks = <&clkc 15>;
52
-
clock-names = "aclk";
53
-
bridge-enable = <0>;
54
-
};
+64
Documentation/devicetree/bindings/fpga/xlnx,pr-decoupler.yaml
+64
Documentation/devicetree/bindings/fpga/xlnx,pr-decoupler.yaml
···
1
+
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2
+
%YAML 1.2
3
+
---
4
+
$id: http://devicetree.org/schemas/fpga/xlnx,pr-decoupler.yaml#
5
+
$schema: http://devicetree.org/meta-schemas/core.yaml#
6
+
7
+
title: Xilinx LogiCORE Partial Reconfig Decoupler/AXI shutdown manager Softcore
8
+
9
+
maintainers:
10
+
- Nava kishore Manne <nava.kishore.manne@amd.com>
11
+
12
+
description: |
13
+
The Xilinx LogiCORE Partial Reconfig(PR) Decoupler manages one or more
14
+
decouplers/fpga bridges. The controller can decouple/disable the bridges
15
+
which prevents signal changes from passing through the bridge. The controller
16
+
can also couple / enable the bridges which allows traffic to pass through the
17
+
bridge normally.
18
+
Xilinx LogiCORE Dynamic Function eXchange(DFX) AXI shutdown manager Softcore
19
+
is compatible with the Xilinx LogiCORE pr-decoupler. The Dynamic Function
20
+
eXchange AXI shutdown manager prevents AXI traffic from passing through the
21
+
bridge. The controller safely handles AXI4MM and AXI4-Lite interfaces on a
22
+
Reconfigurable Partition when it is undergoing dynamic reconfiguration,
23
+
preventing the system deadlock that can occur if AXI transactions are
24
+
interrupted by DFX.
25
+
Please refer to fpga-region.txt and fpga-bridge.txt in this directory for
26
+
common binding part and usage.
27
+
28
+
properties:
29
+
compatible:
30
+
oneOf:
31
+
- items:
32
+
- const: xlnx,pr-decoupler-1.00
33
+
- const: xlnx,pr-decoupler
34
+
- items:
35
+
- const: xlnx,dfx-axi-shutdown-manager-1.00
36
+
- const: xlnx,dfx-axi-shutdown-manager
37
+
38
+
reg:
39
+
maxItems: 1
40
+
41
+
clocks:
42
+
maxItems: 1
43
+
44
+
clock-names:
45
+
items:
46
+
- const: aclk
47
+
48
+
required:
49
+
- compatible
50
+
- reg
51
+
- clocks
52
+
- clock-names
53
+
54
+
additionalProperties: false
55
+
56
+
examples:
57
+
- |
58
+
fpga-bridge@100000450 {
59
+
compatible = "xlnx,pr-decoupler-1.00", "xlnx,pr-decoupler";
60
+
reg = <0x10000045 0x10>;
61
+
clocks = <&clkc 15>;
62
+
clock-names = "aclk";
63
+
};
64
+
...