[PATCH] Documentation: dt-bindings: ocotp: deprecate barebox,provide-mac-address

[Sascha Hauer]

On Mon, Sep 11, 2023 at 02:23:56PM +0200, Ahmad Fatoum wrote:
> While we'll continue to support barebox,provide-mac-address, new boards
> should prefer using the upstream NVMEM binding for describing the MAC address.
> 
> Add an example to the documentation.
> 
> Signed-off-by: Ahmad Fatoum <a.fatoum at pengutronix.de>
> ---
>  .../bindings/misc/fsl,imx-ocotp.rst           | 25 ++++++++++++++++---
>  1 file changed, 22 insertions(+), 3 deletions(-)

Applied, thanks

Sascha

> 
> diff --git a/Documentation/devicetree/bindings/misc/fsl,imx-ocotp.rst b/Documentation/devicetree/bindings/misc/fsl,imx-ocotp.rst
> index 202bb3aa07ef..1c45267b1b58 100644
> --- a/Documentation/devicetree/bindings/misc/fsl,imx-ocotp.rst
> +++ b/Documentation/devicetree/bindings/misc/fsl,imx-ocotp.rst
> @@ -6,13 +6,14 @@ Required properties:
>  * ``compatible``: ``fsl,imx6q-ocotp``
>  * ``reg``: physical register base and size
>  
> -Optional properties:
> +Deprecated properties:
>  
>  * ``barebox,provide-mac-address``: Provide MAC addresses for Ethernet devices. This
>    can be multiple entries in the form <&phandle regofs> to assign a MAC
> -  address to an Ethernet device.
> +  address to an Ethernet device. This has been deprecated in favor or the upstream
> +  nvmem cell binding.
>  
> -Example:
> +Legacy example:
>  
>  .. code-block:: none
>  
> @@ -21,3 +22,21 @@ Example:
>    	reg = <0x021bc000 0x4000>;
>    	barebox,provide-mac-address = <&fec 0x620>;
>    };
> +
> +Upstream alternative:
> +
> +.. code-block:: none
> +
> +  &ocotp1 {
> +  	#address-cells = <1>;
> +  	#size-cells = <1>;
> +
> +  	fec_mac_addr: mac-addr at 88 {
> +  		reg = <0x88 6>;
> +  	};
> +  };
> +
> +  &fec {
> +  	nvmem-cells = <&fec_mac_addr>;
> +  	nvmem-cell-names = "mac-address";
> +  };
> -- 
> 2.39.2
> 
> 
> 

-- 
Pengutronix e.K.                           |                             |
Steuerwalder Str. 21                       | http://www.pengutronix.de/  |
31137 Hildesheim, Germany                  | Phone: +49-5121-206917-0    |
Amtsgericht Hildesheim, HRA 2686           | Fax:   +49-5121-206917-5555 |