[PATCH v5 1/3] dt-bindings: mtd: partitions: Support label only partition

[Rob Herring]

On Mon, Jun 06, 2022 at 05:14:15PM +0200, Ansuel Smith wrote:
> Document new partition nodes that declare only the label instead of the
> reg used to provide an OF node for partition registred at runtime by
> parsers. This is required for nvmem system to declare and detect
> nvmem-cells.
> 
> With these special partitions, the reg / offset is not required.
> The label binding is used to match the partition allocated by the
> parser at runtime and the parser will provide reg and offset of the mtd.
> 
> NVMEM will use the data from the parser and provide the NVMEM cells
> declared in the DTS, "connecting" the dynamic partition with a
> static declaration of cells in them.
> 
> Signed-off-by: Ansuel Smith <ansuelsmth at gmail.com>
> ---
>  .../bindings/mtd/partitions/partition.yaml       | 16 ++++++++++++++--
>  1 file changed, 14 insertions(+), 2 deletions(-)
> 
> diff --git a/Documentation/devicetree/bindings/mtd/partitions/partition.yaml b/Documentation/devicetree/bindings/mtd/partitions/partition.yaml
> index e1ac08064425..bff6fb980e6b 100644
> --- a/Documentation/devicetree/bindings/mtd/partitions/partition.yaml
> +++ b/Documentation/devicetree/bindings/mtd/partitions/partition.yaml
> @@ -11,6 +11,13 @@ description: |
>    relative offset and size specified. Depending on partition function extra
>    properties can be used.
>  
> +  A partition may be dynamically allocated by a specific parser at runtime.
> +  In this specific case, the label is required instead of the reg.
> +  This is used to assign an OF node to the dynamiccally allocated partition
> +  so that subsystem like NVMEM can provide an OF node and declare NVMEM cells.
> +  The OF node will be assigned only if the partition label declared match the
> +  one assigned by the parser at runtime.
> +
>  maintainers:
>    - Rafał Miłecki <rafal at milecki.pl>
>  
> @@ -22,6 +29,8 @@ properties:
>    label:
>      description: The label / name for this partition. If omitted, the label
>        is taken from the node name (excluding the unit address).
> +      With dynamically allocated partition the label is required and won't
> +      fallback to the node name.

Generally, label is never required being something for humans rather 
than the s/w to consume. I don't see any reason why we can't still use 
the node name (with 'partition-' stripped off).

If the purpose is to define what the partition contains, then 
'compatible' is the right thing for that.

>  
>    read-only:
>      description: This parameter, if present, is a hint that this partition
> @@ -41,7 +50,10 @@ properties:
>        immune to paired-pages corruptions
>      type: boolean
>  
> -required:
> -  - reg
> +if:
> +  not:
> +    required: [ reg ]
> +then:
> +  required: [ label ]
>  
>  additionalProperties: true
> -- 
> 2.36.1
> 
>