Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit e14ba3cd authored by Andrew Bresticker's avatar Andrew Bresticker Committed by Ralf Baechle
Browse files

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: default avatarAndrew Bresticker <abrestic@chromium.org>
Cc: Rob Herring <robh+dt@kernel.org>
Cc: Pawel Moll <pawel.moll@arm.com>
Cc: Mark Rutland <mark.rutland@arm.com>
Cc: Ian Campbell <ijc+devicetree@hellion.org.uk>
Cc: Kumar Gala <galak@codeaurora.org>
Cc: devicetree@vger.kernel.org
Cc: linux-kernel@vger.kernel.org
Cc: linux-mips@linux-mips.org
Cc: Andrew Bresticker <abrestic@chromium.org>
Cc: Ezequiel Garcia <ezequiel.garcia@imgtec.com>
Cc: James Hartley <james.hartley@imgtec.com>
Cc: James Hogan <james.hogan@imgtec.com>
Patchwork: https://patchwork.linux-mips.org/patch/9568/


Signed-off-by: default avatarRalf Baechle <ralf@linux-mips.org>
parent b76a4c1a

Documentation/devicetree/bindings/mips/img/pistachio.txt

0 → 100644
+42 −0
Original line number Diff line number Diff line 
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