Re: [PATCH v3 1/2] dt-bindings: nvmem: add byte-mask property for non-contiguous byte selection
From: Srinivas Kandagatla
Date: Tue Nov 17 2026 - 10:29:27 EST
On 11/17/26 6:04 AM, Hongmei Xu wrote:
> Add the byte-mask property to the fixed-cell binding. This allows
> selecting non-contiguous physical bytes from an NVMEM region to form
> a logical cell value.
>
> Some SoCs (e.g. Qualcomm efuse controllers) store a logical value such
> as a MAC address across non-contiguous physical bytes, with one or more
> bytes in between reserved or unused. byte-mask lets the DT describe this
> directly in the fixed-cell binding without requiring a device-specific
> provider for a common pattern.
Pl take a look at layouts, which does exactly what you are trying to do.
--srini
>
> Bit N set in byte-mask means physical byte N relative to the cell's
> base offset is included in the output; selected bytes are packed into
> the output buffer in ascending byte order. The number of set bits must
> not exceed the cell's logical size given by reg. byte-mask and bits are
> mutually exclusive. Cells using byte-mask are read-only.
>
> Signed-off-by: Hongmei Xu <hongmei.xu@xxxxxxxxxxxxxxxx>
> ---
> .../bindings/nvmem/layouts/fixed-cell.yaml | 21 +++++++++++++++++++++
> 1 file changed, 21 insertions(+)
>
> diff --git a/Documentation/devicetree/bindings/nvmem/layouts/fixed-cell.yaml b/Documentation/devicetree/bindings/nvmem/layouts/fixed-cell.yaml
> index 38e3ad50ff4f..46e1101ee98a 100644
> --- a/Documentation/devicetree/bindings/nvmem/layouts/fixed-cell.yaml
> +++ b/Documentation/devicetree/bindings/nvmem/layouts/fixed-cell.yaml
> @@ -34,6 +34,20 @@ properties:
> description:
> Size in bit within the address range specified by reg.
>
> + byte-mask:
> + $ref: /schemas/types.yaml#/definitions/uint32
> + minimum: 1
> + description: >
> + Bitmask selecting which physical bytes within the NVMEM device region
> + contribute to this cell's output. Bit N set means physical byte N
> + relative to the cell's base offset is included; selected bytes are
> + packed into the output buffer in ascending byte order. Byte positions
> + are relative to the cell's base offset and limited to a 32-byte window.
> + The highest set bit must not reference a byte beyond the device size.
> + The number of set bits must not exceed the cell's logical size given by
> + reg. Cannot be used together with bits. Cells using byte-mask are
> + read-only; write operations are not supported.
> +
> allOf:
> - if:
> properties:
> @@ -48,6 +62,13 @@ allOf:
> const: 1
> required:
> - "#nvmem-cell-cells"
> + - if:
> + required: [ byte-mask ]
> + then:
> + properties:
> + bits: false
> + description:
> + byte-mask and bits are mutually exclusive.
>
> required:
> - reg
>