[deliverable/linux.git] / Documentation / devicetree / bindings / pci / pci-thunder-ecam.txt

* ThunderX PCI host controller for pass-1.x silicon

Firmware-initialized PCI host controller to on-chip devices found on
some Cavium ThunderX processors.  These devices have ECAM-based config
access, but the BARs are all at fixed addresses.  We handle the fixed
addresses by synthesizing Enhanced Allocation (EA) capabilities for
these devices.

The properties and their meanings are identical to those described in
host-generic-pci.txt except as listed below.

Properties of the host controller node that differ from
host-generic-pci.txt:

- compatible     : Must be "cavium,pci-host-thunder-ecam"

Example:

	pcie@84b000000000 {
		compatible = "cavium,pci-host-thunder-ecam";
		device_type = "pci";
		msi-parent = <&its>;
		msi-map = <0 &its 0x30000 0x10000>;
		bus-range = <0 31>;
		#size-cells = <2>;
		#address-cells = <3>;
		#stream-id-cells = <1>;
		reg = <0x84b0 0x00000000 0 0x02000000>;  /* Configuration space */
		ranges = <0x03000000 0x8180 0x00000000 0x8180 0x00000000 0x80 0x00000000>; /* mem ranges */
	};
Commit	Line	Data
7b6e7ba8 DD	1	* ThunderX PCI host controller for pass-1.x silicon
	2
	3	Firmware-initialized PCI host controller to on-chip devices found on
	4	some Cavium ThunderX processors. These devices have ECAM-based config
	5	access, but the BARs are all at fixed addresses. We handle the fixed
	6	addresses by synthesizing Enhanced Allocation (EA) capabilities for
	7	these devices.
	8
	9	The properties and their meanings are identical to those described in
	10	host-generic-pci.txt except as listed below.
	11
	12	Properties of the host controller node that differ from
	13	host-generic-pci.txt:
	14
	15	- compatible : Must be "cavium,pci-host-thunder-ecam"
	16
	17	Example:
	18
	19	pcie@84b000000000 {
	20	compatible = "cavium,pci-host-thunder-ecam";
	21	device_type = "pci";
	22	msi-parent = <&its>;
	23	msi-map = <0 &its 0x30000 0x10000>;
	24	bus-range = <0 31>;
	25	#size-cells = <2>;
	26	#address-cells = <3>;
	27	#stream-id-cells = <1>;
	28	reg = <0x84b0 0x00000000 0 0x02000000>; /* Configuration space */
	29	ranges = <0x03000000 0x8180 0x00000000 0x8180 0x00000000 0x80 0x00000000>; /* mem ranges */
	30	};