[PATCH] doc: board: freescale: advise to use newer atf and firmware

[Peng Fan]

> Subject: [PATCH] doc: board: freescale: advise to use newer atf and firmware
> 
> Update branch and version information of ATF and DDR firmware files to point
> to latest releases provided by NXP.
> 
> This is especially critical for imx8mp evk, as the ATF support for that SoC is
> only available in latest releases.
> 
> Align all SoCs from imx8m family to use identical revisions of ATF and DDR
> firmware.
> 
> Signed-off-by: Andrey Zhizhikin <andrey.zhizhikin at leica-geosystems.com>

Thanks for the effort.

Reviewed-by: Peng Fan <peng.fan at nxp.com>

> ---
>  doc/board/freescale/imx8mm_evk.rst | 10 +++++-----
> doc/board/freescale/imx8mn_evk.rst | 10 +++++-----
> doc/board/freescale/imx8mp_evk.rst | 16 ++++++++--------
> doc/board/freescale/imx8mq_evk.rst | 12 ++++++------
>  4 files changed, 24 insertions(+), 24 deletions(-)
> 
> diff --git a/doc/board/freescale/imx8mm_evk.rst
> b/doc/board/freescale/imx8mm_evk.rst
> index f75190227c..a9ccdb7850 100644
> --- a/doc/board/freescale/imx8mm_evk.rst
> +++ b/doc/board/freescale/imx8mm_evk.rst
> @@ -18,7 +18,7 @@ Get and Build the ARM Trusted firmware
> 
>  Note: builddir is U-Boot build directory (source directory for in-tree builds)
> Get ATF from:
> https://eur01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fsource
> .codeaurora.org%2Fexternal%2Fimx%2Fimx-atf&data=04%7C01%7Cpen
> g.fan%40nxp.com%7C17ea116c2ca44f3ee06008d89fa6bf7d%7C686ea1d3bc
> 2b4c6fa92cd99c5c301635%7C0%7C0%7C637434885818043019%7CUnknow
> n%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1ha
> WwiLCJXVCI6Mn0%3D%7C1000&sdata=JB5DHy0ymYFYB3JN4J%2FWS3
> WNBtwIIi7Zj0uNgu793fc%3D&reserved=0
> -branch: imx_4.19.35_1.0.0
> +branch: imx_5.4.47_2.2.0
> 
>  .. code-block:: bash
> 
> @@ -30,10 +30,10 @@ Get the ddr firmware
> 
>  .. code-block:: bash
> 
> -   $ wget
> https://eur01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fwww.
> nxp.com%2Flgfiles%2FNMG%2FMAD%2FYOCTO%2Ffirmware-imx-8.0.bin&a
> mp;data=04%7C01%7Cpeng.fan%40nxp.com%7C17ea116c2ca44f3ee06008d
> 89fa6bf7d%7C686ea1d3bc2b4c6fa92cd99c5c301635%7C0%7C0%7C6374348
> 85818043019%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJ
> QIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C1000&sdata=TsZF
> LW7w5c2tOeaB9kK5RC5V9%2BvvTfMTI7fidA1kH%2Bc%3D&reserved=0
> -   $ chmod +x firmware-imx-8.0.bin
> -   $ ./firmware-imx-8.0
> -   $ cp firmware-imx-8.0/firmware/ddr/synopsys/lpddr4*.bin $(builddir)
> +   $ wget
> https://eur01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fwww.
> nxp.com%2Flgfiles%2FNMG%2FMAD%2FYOCTO%2Ffirmware-imx-8.9.bin&a
> mp;data=04%7C01%7Cpeng.fan%40nxp.com%7C17ea116c2ca44f3ee06008d
> 89fa6bf7d%7C686ea1d3bc2b4c6fa92cd99c5c301635%7C0%7C0%7C6374348
> 85818043019%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJ
> QIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C1000&sdata=5vP4
> 2YnY58cCWV5cIc3X8eQJ%2F%2FACKikIrRxPXjaweSQ%3D&reserved=0
> +   $ chmod +x firmware-imx-8.9.bin
> +   $ ./firmware-imx-8.9
> +   $ cp firmware-imx-8.9/firmware/ddr/synopsys/lpddr4*.bin $(builddir)
> 
>  Build U-Boot
>  ------------
> diff --git a/doc/board/freescale/imx8mn_evk.rst
> b/doc/board/freescale/imx8mn_evk.rst
> index c3e92cecee..375e0bb761 100644
> --- a/doc/board/freescale/imx8mn_evk.rst
> +++ b/doc/board/freescale/imx8mn_evk.rst
> @@ -18,7 +18,7 @@ Get and Build the ARM Trusted firmware
> 
>  Note: srctree is U-Boot source directory  Get ATF from:
> https://eur01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fsource
> .codeaurora.org%2Fexternal%2Fimx%2Fimx-atf&data=04%7C01%7Cpen
> g.fan%40nxp.com%7C17ea116c2ca44f3ee06008d89fa6bf7d%7C686ea1d3bc
> 2b4c6fa92cd99c5c301635%7C0%7C0%7C637434885818043019%7CUnknow
> n%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1ha
> WwiLCJXVCI6Mn0%3D%7C1000&sdata=JB5DHy0ymYFYB3JN4J%2FWS3
> WNBtwIIi7Zj0uNgu793fc%3D&reserved=0
> -branch: imx_4.19.35_1.1.0
> +branch: imx_5.4.47_2.2.0
> 
>  .. code-block:: bash
> 
> @@ -30,10 +30,10 @@ Get the ddr firmware
> 
>  .. code-block:: bash
> 
> -   $ wget
> https://eur01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fwww.
> nxp.com%2Flgfiles%2FNMG%2FMAD%2FYOCTO%2Ffirmware-imx-8.5.bin&a
> mp;data=04%7C01%7Cpeng.fan%40nxp.com%7C17ea116c2ca44f3ee06008d
> 89fa6bf7d%7C686ea1d3bc2b4c6fa92cd99c5c301635%7C0%7C0%7C6374348
> 85818043019%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJ
> QIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C1000&sdata=2fTO
> 1XnVhcrXUIjNnP%2Bblgx7BB%2FuqUECFZjZeaPg9Xo%3D&reserved=0
> -   $ chmod +x firmware-imx-8.5.bin
> -   $ ./firmware-imx-8.5
> -   $ cp firmware-imx-8.5/firmware/ddr/synopsys/ddr4*.bin $(srctree)
> +   $ wget
> https://eur01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fwww.
> nxp.com%2Flgfiles%2FNMG%2FMAD%2FYOCTO%2Ffirmware-imx-8.9.bin&a
> mp;data=04%7C01%7Cpeng.fan%40nxp.com%7C17ea116c2ca44f3ee06008d
> 89fa6bf7d%7C686ea1d3bc2b4c6fa92cd99c5c301635%7C0%7C0%7C6374348
> 85818043019%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJ
> QIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C1000&sdata=5vP4
> 2YnY58cCWV5cIc3X8eQJ%2F%2FACKikIrRxPXjaweSQ%3D&reserved=0
> +   $ chmod +x firmware-imx-8.9.bin
> +   $ ./firmware-imx-8.9
> +   $ cp firmware-imx-8.9/firmware/ddr/synopsys/ddr4*.bin $(srctree)
> 
>  Build U-Boot
>  ------------
> diff --git a/doc/board/freescale/imx8mp_evk.rst
> b/doc/board/freescale/imx8mp_evk.rst
> index 96df6d470f..ccffcf7257 100644
> --- a/doc/board/freescale/imx8mp_evk.rst
> +++ b/doc/board/freescale/imx8mp_evk.rst
> @@ -18,7 +18,7 @@ Get and Build the ARM Trusted firmware
> 
>  Note: $(srctree) is the U-Boot source directory  Get ATF from:
> https://eur01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fsource
> .codeaurora.org%2Fexternal%2Fimx%2Fimx-atf&data=04%7C01%7Cpen
> g.fan%40nxp.com%7C17ea116c2ca44f3ee06008d89fa6bf7d%7C686ea1d3bc
> 2b4c6fa92cd99c5c301635%7C0%7C0%7C637434885818043019%7CUnknow
> n%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1ha
> WwiLCJXVCI6Mn0%3D%7C1000&sdata=JB5DHy0ymYFYB3JN4J%2FWS3
> WNBtwIIi7Zj0uNgu793fc%3D&reserved=0
> -branch: imx_5.4.3_2.0.0
> +branch: imx_5.4.47_2.2.0
> 
>  .. code-block:: bash
> 
> @@ -30,13 +30,13 @@ Get the ddr firmware
> 
>  .. code-block:: bash
> 
> -   $ wget
> https://eur01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fwww.
> nxp.com%2Flgfiles%2FNMG%2FMAD%2FYOCTO%2Ffirmware-imx-8.7.bin&a
> mp;data=04%7C01%7Cpeng.fan%40nxp.com%7C17ea116c2ca44f3ee06008d
> 89fa6bf7d%7C686ea1d3bc2b4c6fa92cd99c5c301635%7C0%7C0%7C6374348
> 85818043019%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJ
> QIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C1000&sdata=gh07
> U0uSMCibDEyXoaRxd%2Fb1c5gPTDWH7fveAMZWF8Q%3D&reserved=0
> -   $ chmod +x firmware-imx-8.7.bin
> -   $ ./firmware-imx-8.7.bin
> -   $ cp
> firmware-imx-8.7/firmware/ddr/synopsys/lpddr4_pmu_train_1d_dmem_201
> 904.bin $(srctree)/lpddr4_pmu_train_1d_dmem.bin
> -   $ cp
> firmware-imx-8.7/firmware/ddr/synopsys/lpddr4_pmu_train_1d_imem_2019
> 04.bin $(srctree)/lpddr4_pmu_train_1d_imem.bin
> -   $ cp
> firmware-imx-8.7/firmware/ddr/synopsys/lpddr4_pmu_train_2d_dmem_201
> 904.bin $(srctree)/lpddr4_pmu_train_2d_dmem.bin
> -   $ cp
> firmware-imx-8.7/firmware/ddr/synopsys/lpddr4_pmu_train_2d_imem_2019
> 04.bin $(srctree)/lpddr4_pmu_train_2d_imem.bin
> +   $ wget
> https://eur01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fwww.
> nxp.com%2Flgfiles%2FNMG%2FMAD%2FYOCTO%2Ffirmware-imx-8.9.bin&a
> mp;data=04%7C01%7Cpeng.fan%40nxp.com%7C17ea116c2ca44f3ee06008d
> 89fa6bf7d%7C686ea1d3bc2b4c6fa92cd99c5c301635%7C0%7C0%7C6374348
> 85818043019%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJ
> QIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C1000&sdata=5vP4
> 2YnY58cCWV5cIc3X8eQJ%2F%2FACKikIrRxPXjaweSQ%3D&reserved=0
> +   $ chmod +x firmware-imx-8.9.bin
> +   $ ./firmware-imx-8.9.bin
> +   $ cp
> firmware-imx-8.9/firmware/ddr/synopsys/lpddr4_pmu_train_1d_dmem_201
> 904.bin $(srctree)/lpddr4_pmu_train_1d_dmem.bin
> +   $ cp
> firmware-imx-8.9/firmware/ddr/synopsys/lpddr4_pmu_train_1d_imem_2019
> 04.bin $(srctree)/lpddr4_pmu_train_1d_imem.bin
> +   $ cp
> firmware-imx-8.9/firmware/ddr/synopsys/lpddr4_pmu_train_2d_dmem_201
> 904.bin $(srctree)/lpddr4_pmu_train_2d_dmem.bin
> +   $ cp
> +
> firmware-imx-8.9/firmware/ddr/synopsys/lpddr4_pmu_train_2d_imem_2019
> 04
> + .bin $(srctree)/lpddr4_pmu_train_2d_imem.bin
> 
>  Build U-Boot
>  ------------
> diff --git a/doc/board/freescale/imx8mq_evk.rst
> b/doc/board/freescale/imx8mq_evk.rst
> index 0a64ecc5ba..c269fdebe3 100644
> --- a/doc/board/freescale/imx8mq_evk.rst
> +++ b/doc/board/freescale/imx8mq_evk.rst
> @@ -18,7 +18,7 @@ Get and Build the ARM Trusted firmware
> 
>  Note: srctree is U-Boot source directory  Get ATF from:
> https://eur01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fsource
> .codeaurora.org%2Fexternal%2Fimx%2Fimx-atf&data=04%7C01%7Cpen
> g.fan%40nxp.com%7C17ea116c2ca44f3ee06008d89fa6bf7d%7C686ea1d3bc
> 2b4c6fa92cd99c5c301635%7C0%7C0%7C637434885818043019%7CUnknow
> n%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1ha
> WwiLCJXVCI6Mn0%3D%7C1000&sdata=JB5DHy0ymYFYB3JN4J%2FWS3
> WNBtwIIi7Zj0uNgu793fc%3D&reserved=0
> -branch: imx_4.19.35_1.0.0
> +branch: imx_5.4.47_2.2.0
> 
>  .. code-block:: bash
> 
> @@ -30,11 +30,11 @@ Get the ddr and hdmi firmware
> 
>  .. code-block:: bash
> 
> -   $ wget
> https://eur01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fwww.
> nxp.com%2Flgfiles%2FNMG%2FMAD%2FYOCTO%2Ffirmware-imx-7.9.bin&a
> mp;data=04%7C01%7Cpeng.fan%40nxp.com%7C17ea116c2ca44f3ee06008d
> 89fa6bf7d%7C686ea1d3bc2b4c6fa92cd99c5c301635%7C0%7C0%7C6374348
> 85818053014%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJ
> QIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C1000&sdata=PESa
> EwYork7GTo%2Fw8dqpB85yntYvhpu4R26bW40Au8U%3D&reserved=0
> -   $ chmod +x firmware-imx-7.9.bin
> -   $ ./firmware-imx-7.9.bin
> -   $ cp firmware-imx-7.9/firmware/hdmi/cadence/signed_hdmi_imx8m.bin
> $(builddir)
> -   $ cp firmware-imx-7.9/firmware/ddr/synopsys/lpddr4*.bin $(builddir)
> +   $ wget
> https://eur01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fwww.
> nxp.com%2Flgfiles%2FNMG%2FMAD%2FYOCTO%2Ffirmware-imx-8.9.bin&a
> mp;data=04%7C01%7Cpeng.fan%40nxp.com%7C17ea116c2ca44f3ee06008d
> 89fa6bf7d%7C686ea1d3bc2b4c6fa92cd99c5c301635%7C0%7C0%7C6374348
> 85818053014%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJ
> QIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C1000&sdata=W1v
> eu%2BLnADW6VxKEMxai%2FFxQXfRibSIn%2B3mD0WnCtyA%3D&reserv
> ed=0
> +   $ chmod +x firmware-imx-8.9.bin
> +   $ ./firmware-imx-8.9.bin
> +   $ cp
> firmware-imx-8.9/firmware/hdmi/cadence/signed_hdmi_imx8m.bin
> $(builddir)
> +   $ cp firmware-imx-8.9/firmware/ddr/synopsys/lpddr4*.bin $(builddir)
> 
>  Build U-Boot
>  ------------
> --
> 2.17.1