Imagination Pistachio SoC
=========================

Required properties:
--------------------
 - compatible: Must include "img,pistachio".

CPU nodes:
----------
A "cpus" node is required.  Required properties:
 - #address-cells: Must be 1.
 - #size-cells: Must be 0.
A CPU sub-node is also required for at least CPU 0.  Since the topology may
be probed via CPS, it is not necessary to specify secondary CPUs.  Required
propertis:
 - device_type: Must be "cpu".
 - compatible: Must be "mti,interaptiv".
 - reg: CPU number.
 - clocks: Must include the CPU clock.  See ../../clock/clock-bindings.txt for
   details on clock bindings.
Example:
	cpus {
		#address-cells = <1>;
		#size-cells = <0>;

		cpu0: cpu@0 {
			device_type = "cpu";
			compatible = "mti,interaptiv";
			reg = <0>;
			clocks = <&clk_core CLK_MIPS>;
		};
	};


Boot protocol:
--------------
In accordance with the MIPS UHI specification[1], the bootloader must pass the
following arguments to the kernel:
 - $a0: -2.
 - $a1: KSEG0 address of the flattened device-tree blob.

[1] http://prplfoundation.org/wiki/MIPS_documentation

Document Pistachio boot protocol and device-tree bindings
MIPS: Document Pistachio boot protocol and device-tree bindings

The Pistachio SoC boots only with device-tree.  Document the required
properties and nodes as well as the boot protocol between the bootlaoder
and the kernel.

Signed-off-by: Andrew Bresticker <6f9d97df82107736b1c4f0e11d74242c25499ec8@chromium.org>
Cc: Rob Herring <988782c95b9025801edfc9a5b1fd5a8e93699e07@kernel.org>
Cc: Pawel Moll <9508d67e84a03f69673bee3bb7ec593a47efeb0d@arm.com>
Cc: Mark Rutland <1db9dd262beaa64f35756dd39531d9747b7778bb@arm.com>
Cc: Ian Campbell <ea71a0dcef14058f83aacb9a32bd3c02e11f589b@hellion.org.uk>
Cc: Kumar Gala <383ef5577c6e1178b93f59ec8d0936f76d2a98c4@codeaurora.org>
Cc: eb682e570f95b554c8a7dc560ee59b91b930a718@vger.kernel.org
Cc: 2578944098299abf708b08eff6fcf60565553586@vger.kernel.org
Cc: 562397917b9a8bf316569a848858b12fb417723f@linux-mips.org
Cc: Andrew Bresticker <6f9d97df82107736b1c4f0e11d74242c25499ec8@chromium.org>
Cc: Ezequiel Garcia <7248f52d8926fd82a5eb079a13afe9dd79e34c7a@imgtec.com>
Cc: James Hartley <9656dd1efcf43da7ee9c9a45b212b02529f17710@imgtec.com>
Cc: James Hogan <547fa85bb3888a0222eed8ec39e36708605c6d53@imgtec.com>
Patchwork: https://patchwork.linux-mips.org/patch/9568/
Signed-off-by: Ralf Baechle <92f48d309cda194c8eda36aa8f9ae28c488fa208@linux-mips.org>
