srio.txt

  1* Freescale Serial RapidIO (SRIO) Controller
  2
  3RapidIO port node:
  4Properties:
  5   - compatible
  6	Usage: required
  7	Value type: <string>
  8	Definition: Must include "fsl,srio" for IP blocks with IP Block
  9	Revision Register (SRIO IPBRR1) Major ID equal to 0x01c0.
 10
 11	Optionally, a compatible string of "fsl,srio-vX.Y" where X is Major
 12	version in IP Block Revision Register and Y is Minor version.  If this
 13	compatible is provided it should be ordered before "fsl,srio".
 14
 15   - reg
 16	Usage: required
 17	Value type: <prop-encoded-array>
 18	Definition: A standard property.  Specifies the physical address and
 19		length of the SRIO configuration registers.  The size should
 20		be set to 0x11000.
 21
 22   - interrupts
 23	Usage: required
 24	Value type: <prop_encoded-array>
 25	Definition:  Specifies the interrupts generated by this device.  The
 26		value of the interrupts property consists of one interrupt
 27		specifier. The format of the specifier is defined by the
 28		binding document describing the node's interrupt parent.
 29
 30		A single IRQ that handles error conditions is specified by this
 31		property.  (Typically shared with port-write).
 32
 33   - fsl,srio-rmu-handle:
 34	Usage: required if rmu node is defined
 35	Value type: <phandle>
 36	Definition: A single <phandle> value that points to the RMU.
 37	(See srio-rmu.txt for more details on RMU node binding)
 38
 39Port Child Nodes:  There should a port child node for each port that exists in
 40the controller.  The ports are numbered starting at one (1) and should have
 41the following properties:
 42
 43   - cell-index
 44	Usage: required
 45	Value type: <u32>
 46	Definition: A standard property.  Matches the port id.
 47
 48   - ranges
 49	Usage: required if local access windows preset
 50	Value type: <prop-encoded-array>
 51	Definition: A standard property. Utilized to describe the memory mapped
 52		IO space utilized by the controller.  This corresponds to the
 53		setting of the local access windows that are targeted to this
 54		SRIO port.
 55
 56   - fsl,liodn
 57	Usage: optional-but-recommended (for devices with PAMU)
 58	Value type: <prop-encoded-array>
 59	Definition: The logical I/O device number for the PAMU (IOMMU) to be
 60		correctly configured for SRIO accesses.  The property should
 61		not exist on devices that do not support PAMU.
 62
 63		For HW (ie, the P4080) that only supports a LIODN for both
 64		memory and maintenance transactions then a single LIODN is
 65		represented in the property for both transactions.
 66
 67		For HW (ie, the P304x/P5020, etc) that supports an LIODN for
 68		memory transactions and a unique LIODN for maintenance
 69		transactions then a pair of LIODNs are represented in the
 70		property.  Within the pair, the first element represents the
 71		LIODN associated with memory transactions and the second element
 72		represents the LIODN associated with maintenance transactions
 73		for the port.
 74
 75Note: All other standard properties (see the Devicetree Specification)
 76are allowed but are optional.
 77
 78Example:
 79
 80	rapidio: rapidio@ffe0c0000 {
 81		#address-cells = <2>;
 82		#size-cells = <2>;
 83		reg = <0xf 0xfe0c0000 0 0x11000>;
 84		compatible = "fsl,srio";
 85		interrupts = <16 2 1 11>; /* err_irq */
 86		fsl,srio-rmu-handle = <&rmu>;
 87		ranges;
 88
 89		port1 {
 90			cell-index = <1>;
 91			#address-cells = <2>;
 92			#size-cells = <2>;
 93			fsl,liodn = <34>;
 94			ranges = <0 0 0xc 0x20000000 0 0x10000000>;
 95		};
 96
 97		port2 {
 98			cell-index = <2>;
 99			#address-cells = <2>;
100			#size-cells = <2>;
101			fsl,liodn = <48>;
102			ranges = <0 0 0xc 0x30000000 0 0x10000000>;
103		};
104	};