linux/Documentation/devicetree/bindings/mtd
Brian Norris e488ca9f8d doc: dt: mtd: partitions: add compatible property to "partitions" node
As noted here [1], there are potentially future conflicts if we try to
use MTD's "partitions" subnode to describe anything besides just the
fixed-in-the-device-tree partitions currently described in this
document. Particularly, there was a proposal to use this node for the
AFS parser too.

It can pose a (small) problem to try to differentiate the following
nodes:

	// using binding as currently specified
	partitions {
		#address-cells = <x>;
		#size-cells = <y>;
		partition@0 {
			...;
		};
	};

and

	// proposed future binding
	partitions {
		compatible = "arm,arm-flash-structure";
	};

It's especially difficult if other uses of this node start having
subnodes.

So, since the "partitions" node is new in v4.4, let's fixup the binding
before release so that it requires a compatible property, so it's much
clearer to distinguish. e.g.:

	// proposed
	partitions {
		compatible = "fixed-partitions";
		#address-cells = <x>;
		#size-cells = <y>;
		partition@0 {
			...;
		};
	};

[1] Subject: "mtd: create a partition type device tree binding"
    http://lkml.kernel.org/g/20151113220039.GA74382@google.com
    http://lists.infradead.org/pipermail/linux-mtd/2015-November/063355.html
    http://lists.infradead.org/pipermail/linux-mtd/2015-November/063364.html

Cc: Michal Suchanek <hramrach@gmail.com>
Signed-off-by: Brian Norris <computersforpeace@gmail.com>
Acked-by: Rob Herring <robh@kernel.org>
2015-12-08 17:10:20 -08:00
..
arm-versatile.txt mtd: Move fdt partition documentation to a seperate file 2012-03-28 17:07:30 -06:00
atmel-dataflash.txt mtd: Move fdt partition documentation to a seperate file 2012-03-28 17:07:30 -06:00
atmel-nand.txt mtd: atmel_nand: introduce a new compatible string for sama5d4 chip 2015-01-20 12:47:01 -08:00
brcm,brcmnand.txt Documentation: devicetree: brcmstb_nand: add BCM63138 and Cygnus/iProc 2015-05-15 13:19:59 -07:00
davinci-nand.txt mtd: nand: davinci: reuse driver for Keystone arch 2014-01-03 11:22:26 -08:00
denali-nand.txt mtd: denali: add a DT driver 2012-11-15 15:37:46 +02:00
diskonchip.txt mtd: docg3: add device-tree documentation 2014-10-22 01:35:40 -07:00
elm.txt mtd: devices: elm: Removes <xx> literals in elm DT node 2013-02-04 10:07:11 +02:00
flctl-nand.txt mtd: sh_flctl: Add device tree support 2012-11-15 15:37:50 +02:00
fsl-quadspi.txt Documentation: fsl-quadspi: Add fsl, imx6ul-qspi compatible string 2015-08-06 10:07:42 -07:00
fsl-upm-nand.txt mtd: Move fdt partition documentation to a seperate file 2012-03-28 17:07:30 -06:00
fsmc-nand.txt mtd: fsmc_nand: Add BCH4 SW ECC support for SPEAr600 2015-10-26 13:19:40 -07:00
gpio-control-nand.txt devicetree: bindings: improve description for GPIO assisted NAND flash 2014-11-04 23:53:06 -08:00
gpmc-nand.txt Merge branch 'for-linus' of git://git.kernel.org/pub/scm/linux/kernel/git/jikos/trivial 2014-10-07 21:16:26 -04:00
gpmc-nor.txt doc: spelling error changes 2014-05-05 15:32:05 +02:00
gpmc-onenand.txt doc: spelling error changes 2014-05-05 15:32:05 +02:00
gpmi-nand.txt mtd: gpmi: Remove "We support only one NAND chip" from bindings doc 2014-12-22 12:58:24 -08:00
hisi504-nand.txt mtd: hisilicon: add device tree binding documentation 2015-02-08 00:20:20 -08:00
jedec,spi-nor.txt Documentation: dt: mtd: replace "nor-jedec" binding with "jedec, spi-nor" 2015-05-15 13:04:00 -07:00
lpc32xx-mlc.txt mtd: add LPC32xx MLC NAND driver 2012-07-06 18:27:04 +01:00
lpc32xx-slc.txt mtd: add LPC32xx SLC NAND driver 2012-07-06 18:17:07 +01:00
mtd-physmap.txt mtd: map_rom: Support UBI on ROM 2015-01-09 23:24:27 -08:00
mxc-nand.txt mtd: mxc_nand: implement device tree probing 2012-05-13 23:03:08 -05:00
nand.txt mtd: nand: Add a devicetree binding for ECC strength and ECC step size 2014-03-10 22:42:29 -07:00
nxp-spifi.txt doc: dt: add documentation for nxp,lpc1773-spifi 2015-08-14 11:22:54 -07:00
orion-nand.txt ARM: Kirkwood: Replace mrvl with marvell 2012-07-25 17:06:23 +02:00
partition.txt doc: dt: mtd: partitions: add compatible property to "partitions" node 2015-12-08 17:10:20 -08:00
pxa3xx-nand.txt mtd: nand: pxa3xx: add optional dma for pxa architecture 2015-09-01 08:18:12 -05:00
spear_smi.txt mtd: add device-tree support to spear_smi 2012-03-27 01:01:21 +01:00
st-fsm.txt mtd: st_spi_fsm: Add device-tree binding documentation 2014-03-20 04:17:16 -07:00
sunxi-nand.txt mtd: nand: sunxi: fix generic nand binding reference 2015-02-26 19:23:56 -08:00
vf610-nfc.txt mtd: nand: vf610_nfc: add device tree bindings 2015-09-29 13:54:54 -07:00