From: Bernhard Frauendienst <kernel@xxxxxxxxxxxxxxxxx> The main use case to concatenate MTD devices is probably SPI-NOR flashes where the number of address bits is limited to 24, which can access a range of 16MiB. Board manufacturers might want to double the SPI storage size by adding a second flash asserted thanks to a second chip selects which enhances the addressing capabilities to 25 bits, 32MiB. Having two devices for twice the size is great but without more glue, we cannot define partition boundaries spread across the two devices. This is the gap mtd-concat intends to address. There are two options to describe concatenated devices: 1/ One flash chip is described in the DT with two CS; 2/ Two flash chips are described in the DT with one CS each, a virtual device is also created to describe the concatenation. Solution 1/ presents at least 3 issues: * The hardware description is abused; * The concatenation only works for SPI devices (while it could be helpful for any MTD); * It would require a lot of rework in the SPI core as most of the logic assumes there is and there always will be only one CS per chip. Solution 2/ also has caveats: * The virtual device has no hardware reality; * Possible optimizations at the hardware level will be hard to enable efficiently (ie. a common direct mapping abstracted by a SPI memories oriented controller). There is no easy and perfect answer to this need but it feels more reasonable to address the problem with solution 2, with the information/needs we have today. Signed-off-by: Bernhard Frauendienst <kernel@xxxxxxxxxxxxxxxxx> [<miquel.raynal@xxxxxxxxxxx>: Wrote a commit message explaining what mtd-concat is. Explained the implementation details. Switched to yaml schema.] Signed-off-by: Miquel Raynal <miquel.raynal@xxxxxxxxxxx> --- .../devicetree/bindings/mtd/mtd-concat.yaml | 56 +++++++++++++++++++ 1 file changed, 56 insertions(+) create mode 100644 Documentation/devicetree/bindings/mtd/mtd-concat.yaml diff --git a/Documentation/devicetree/bindings/mtd/mtd-concat.yaml b/Documentation/devicetree/bindings/mtd/mtd-concat.yaml new file mode 100644 index 000000000000..7341198575cf --- /dev/null +++ b/Documentation/devicetree/bindings/mtd/mtd-concat.yaml @@ -0,0 +1,56 @@ +# SPDX-License-Identifier: GPL-2.0 +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/mtd/mtd-concat.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Virtual MTD concatenation device bindings + +maintainers: + - Miquel Raynal <miquel.raynal@xxxxxxxxxxx> + +properties: + compatible: + const: "mtd-concat" + + devices: + minItems: 2 + description: | + List of phandles to MTD nodes that should be concatenated (in + order). + +required: + - compatible + - devices + +examples: + - | + &spi { + flash0: flash@0 { + reg = <0>; + }; + flash1: flash@1 { + reg = <1>; + }; + }; + + flash { + compatible = "mtd-concat"; + devices = <&flash0 &flash1>; + + partitions { + compatible = "fixed-partitions"; + #address-cells = <1>; + #size-cells = <1>; + + partition@0 { + label = "boot"; + reg = <0x0000000 0x0040000>; + read-only; + }; + partition@40000 { + label = "firmware"; + reg = <0x0040000 0x1fc0000>; + }; + }; + }; -- 2.20.1
