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         };