mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
synced 2024-10-06 08:46:46 +00:00
04e9ab7526
This standardizes its documentation, allows validating with Makefile checks and helps writing DTS files. Noticeable changes: 1. Dropped "Partitions can be represented by sub-nodes of a flash device." as we also support subpartitions (don't have to be part of flash device node) 2. Dropped "to Linux" as bindings are meant to be os agnostic. Signed-off-by: Rafał Miłecki <rafal@milecki.pl> Link: https://lore.kernel.org/r/20201210172352.31632-1-zajec5@gmail.com Signed-off-by: Rob Herring <robh@kernel.org>
33 lines
1.5 KiB
Text
33 lines
1.5 KiB
Text
Flash partitions in device tree
|
|
===============================
|
|
|
|
Flash devices can be partitioned into one or more functional ranges (e.g. "boot
|
|
code", "nvram", "kernel").
|
|
|
|
Different devices may be partitioned in a different ways. Some may use a fixed
|
|
flash layout set at production time. Some may use on-flash table that describes
|
|
the geometry and naming/purpose of each functional region. It is also possible
|
|
to see these methods mixed.
|
|
|
|
To assist system software in locating partitions, we allow describing which
|
|
method is used for a given flash device. To describe the method there should be
|
|
a subnode of the flash device that is named 'partitions'. It must have a
|
|
'compatible' property, which is used to identify the method to use.
|
|
|
|
When a single partition is represented with a DT node (it depends on a used
|
|
format) it may also be described using above rules ('compatible' and optionally
|
|
some extra properties / subnodes). It allows describing more complex,
|
|
hierarchical (multi-level) layouts and should be used if there is some
|
|
significant relation between partitions or some partition internally uses
|
|
another partitioning method.
|
|
|
|
Available bindings are listed in the "partitions" subdirectory.
|
|
|
|
|
|
Deprecated: partitions defined in flash node
|
|
============================================
|
|
|
|
For backwards compatibility partitions as direct subnodes of the flash 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.
|