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

Commit fe2585e9 authored by Michal Suchanek's avatar Michal Suchanek Committed by Brian Norris
Browse files

doc: dt: mtd: support partitions in a special 'partitions' subnode 



To avoid conflict with other drivers using subnodes of the mtd device
create only one ofpart-specific node rather than any number of
arbitrary partition subnodes.

Signed-off-by: default avatarMichal Suchanek <hramrach@gmail.com>
Acked-by: default avatarRob Herring <robh@kernel.org>
Signed-off-by: default avatarBrian Norris <computersforpeace@gmail.com>
parent 4d1ea982

Documentation/devicetree/bindings/mtd/partition.txt

+42 −29
Original line number Original line Diff line number Diff line
@@ -4,10 +4,17 @@ Partitions can be represented by sub-nodes of an mtd device. This can be used 
on platforms which have strong conventions about which portions of a flash are

on platforms which have strong conventions about which portions of a flash are

used for what purposes, but which don't use an on-flash partition table such

used for what purposes, but which don't use an on-flash partition table such

as RedBoot.

as RedBoot.

NOTE: if the sub-node has a compatible string, then it is not a partition.





#address-cells & #size-cells must both be present in the mtd device. There are

The partition table should be a subnode of the mtd node and should be named

two valid values for both:

'partitions'. Partitions are defined in subnodes of the partitions node.



For backwards compatibility partitions as direct subnodes of the mtd device are

supported. This use is discouraged.

NOTE: also for backwards compatibility, direct subnodes that have a compatible

string are not considered partitions, as they may be used for other bindings.



#address-cells & #size-cells must both be present in the partitions subnode of the

mtd device. There are two valid values for both:

<1>: for partitions that require a single 32-bit cell to represent their

<1>: for partitions that require a single 32-bit cell to represent their

     size/address (aka the value is below 4 GiB)

     size/address (aka the value is below 4 GiB)

<2>: for partitions that require two 32-bit cells to represent their

<2>: for partitions that require two 32-bit cells to represent their
@@ -28,6 +35,7 @@ Examples: 








flash@0 {

flash@0 {

	partitions {

		#address-cells = <1>;

		#address-cells = <1>;

		#size-cells = <1>;

		#size-cells = <1>;
@@ -41,8 +49,10 @@ flash@0 { 
			reg = <0x0100000 0x200000>;

			reg = <0x0100000 0x200000>;

		};

		};

	};

	};

};





flash@1 {

flash@1 {

	partitions {

		#address-cells = <1>;

		#address-cells = <1>;

		#size-cells = <2>;

		#size-cells = <2>;
@@ -52,8 +62,10 @@ flash@1 { 
			reg = <0x00000000 0x1 0x00000000>;

			reg = <0x00000000 0x1 0x00000000>;

		};

		};

	};

	};

};





flash@2 {

flash@2 {

	partitions {

		#address-cells = <2>;

		#address-cells = <2>;

		#size-cells = <2>;

		#size-cells = <2>;
@@ -69,3 +81,4 @@ flash@2 { 
			reg = <0x2 0x00000000 0x1 0x00000000>;

			reg = <0x2 0x00000000 0x1 0x00000000>;

		};

		};

	};

	};

};