Documentation/devicetree/bindings/mtd/partition.txt

   1 Flash partitions in device tree
   2 ===============================
   3
   4 Flash devices can be partitioned into one or more functional ranges (e.g. "boot
   5 code", "nvram", "kernel").
   6
   7 Different devices may be partitioned in a different ways. Some may use a fixed
   8 flash layout set at production time. Some may use on-flash table that describes
   9 the geometry and naming/purpose of each functional region. It is also possible
  10 to see these methods mixed.
  11
  12 To assist system software in locating partitions, we allow describing which
  13 method is used for a given flash device. To describe the method there should be
  14 a subnode of the flash device that is named 'partitions'. It must have a
  15 'compatible' property, which is used to identify the method to use.
  16
  17 When a single partition is represented with a DT node (it depends on a used
  18 format) it may also be described using above rules ('compatible' and optionally
  19 some extra properties / subnodes). It allows describing more complex,
  20 hierarchical (multi-level) layouts and should be used if there is some
  21 significant relation between partitions or some partition internally uses
  22 another partitioning method.
  23
  24 Available bindings are listed in the "partitions" subdirectory.
  25
  26
  27 Deprecated: partitions defined in flash node
  28 ============================================
  29
  30 For backwards compatibility partitions as direct subnodes of the flash device are
  31 supported. This use is discouraged.
  32 NOTE: also for backwards compatibility, direct subnodes that have a compatible
  33 string are not considered partitions, as they may be used for other bindings.