diff mbox series

doc: board: freescale: advise to use newer atf and firmware

Message ID 20201213203606.21104-1-andrey.zhizhikin@leica-geosystems.com
State Accepted
Commit 1396e41c1f0c29e3d41de8d454faa7b20cbd3337
Delegated to: Tom Rini
Headers show
Series doc: board: freescale: advise to use newer atf and firmware | expand

Commit Message

ZHIZHIKIN Andrey Dec. 13, 2020, 8:36 p.m. UTC
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@leica-geosystems.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(-)

Comments

Fabio Estevam Dec. 21, 2020, 9:31 p.m. UTC | #1
Hi Andrey,

On Sun, Dec 13, 2020 at 5:36 PM Andrey Zhizhikin
<andrey.zhizhikin@leica-geosystems.com> wrote:
>
> 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@leica-geosystems.com>

Reviewed-by: Fabio Estevam <festevam@gmail.com>
Tom Rini Dec. 21, 2020, 9:40 p.m. UTC | #2
On Mon, Dec 21, 2020 at 06:31:08PM -0300, Fabio Estevam wrote:
> Hi Andrey,
> 
> On Sun, Dec 13, 2020 at 5:36 PM Andrey Zhizhikin
> <andrey.zhizhikin@leica-geosystems.com> wrote:
> >
> > 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@leica-geosystems.com>
> 
> Reviewed-by: Fabio Estevam <festevam@gmail.com>

Is this something that should get pulled in for v2021.01?  It kinda
sounds like yes.  Should I take this directly if so?
ZHIZHIKIN Andrey Dec. 21, 2020, 9:47 p.m. UTC | #3
Hello Tom,

> -----Original Message-----
> From: Tom Rini <trini@konsulko.com>
> Sent: Monday, December 21, 2020 10:41 PM
> To: Fabio Estevam <festevam@gmail.com>; Stefano Babic <sbabic@denx.de>
> Cc: ZHIZHIKIN Andrey <andrey.zhizhikin@leica-geosystems.com>; U-Boot-Denx
> <u-boot@lists.denx.de>; Peng Fan <peng.fan@nxp.com>
> Subject: Re: [PATCH] doc: board: freescale: advise to use newer atf and firmware
> 
> On Mon, Dec 21, 2020 at 06:31:08PM -0300, Fabio Estevam wrote:
> > Hi Andrey,
> >
> > On Sun, Dec 13, 2020 at 5:36 PM Andrey Zhizhikin
> > <andrey.zhizhikin@leica-geosystems.com> wrote:
> > >
> > > 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@leica-geosystems.com>
> >
> > Reviewed-by: Fabio Estevam <festevam@gmail.com>
> 
> Is this something that should get pulled in for v2021.01?  It kinda sounds like yes.
> Should I take this directly if so?

I'd suggest this docs update to be taken, as the combination of ATF and DDR firmware
recorded there is known to be working for those i.MX8M derivatives.

I've also realized that there is a newer version of ATF available from NXP on codeaurora,
but according to the last mail from Fabio - it is not bootable, and I haven't tried it
myself yet.

I guess for the upcoming 2021.01 this documentation update would be quite helpful,
as there has been few reports on the list that people tried to use outdated instructions
and were not able to produce a boot container for i.MX8M Nano and Plus SOCs due to
a newer version of ATF was required.

> 
> --
> Tom

-- andrey
Fabio Estevam Dec. 21, 2020, 10:04 p.m. UTC | #4
Hi Tom,

On Mon, Dec 21, 2020 at 6:40 PM Tom Rini <trini@konsulko.com> wrote:

> Is this something that should get pulled in for v2021.01?  It kinda
> sounds like yes.  Should I take this directly if so?

Yes, it would be nice to have this pulled in for v2021.01.

Thanks
Peng Fan Dec. 22, 2020, 1:19 a.m. UTC | #5
> 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@leica-geosystems.com>

Thanks for the effort.

Reviewed-by: Peng Fan <peng.fan@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&amp;data=04%7C01%7Cpen
> g.fan%40nxp.com%7C17ea116c2ca44f3ee06008d89fa6bf7d%7C686ea1d3bc
> 2b4c6fa92cd99c5c301635%7C0%7C0%7C637434885818043019%7CUnknow
> n%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1ha
> WwiLCJXVCI6Mn0%3D%7C1000&amp;sdata=JB5DHy0ymYFYB3JN4J%2FWS3
> WNBtwIIi7Zj0uNgu793fc%3D&amp;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&amp;sdata=TsZF
> LW7w5c2tOeaB9kK5RC5V9%2BvvTfMTI7fidA1kH%2Bc%3D&amp;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&amp;sdata=5vP4
> 2YnY58cCWV5cIc3X8eQJ%2F%2FACKikIrRxPXjaweSQ%3D&amp;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&amp;data=04%7C01%7Cpen
> g.fan%40nxp.com%7C17ea116c2ca44f3ee06008d89fa6bf7d%7C686ea1d3bc
> 2b4c6fa92cd99c5c301635%7C0%7C0%7C637434885818043019%7CUnknow
> n%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1ha
> WwiLCJXVCI6Mn0%3D%7C1000&amp;sdata=JB5DHy0ymYFYB3JN4J%2FWS3
> WNBtwIIi7Zj0uNgu793fc%3D&amp;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&amp;sdata=2fTO
> 1XnVhcrXUIjNnP%2Bblgx7BB%2FuqUECFZjZeaPg9Xo%3D&amp;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&amp;sdata=5vP4
> 2YnY58cCWV5cIc3X8eQJ%2F%2FACKikIrRxPXjaweSQ%3D&amp;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&amp;data=04%7C01%7Cpen
> g.fan%40nxp.com%7C17ea116c2ca44f3ee06008d89fa6bf7d%7C686ea1d3bc
> 2b4c6fa92cd99c5c301635%7C0%7C0%7C637434885818043019%7CUnknow
> n%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1ha
> WwiLCJXVCI6Mn0%3D%7C1000&amp;sdata=JB5DHy0ymYFYB3JN4J%2FWS3
> WNBtwIIi7Zj0uNgu793fc%3D&amp;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&amp;sdata=gh07
> U0uSMCibDEyXoaRxd%2Fb1c5gPTDWH7fveAMZWF8Q%3D&amp;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&amp;sdata=5vP4
> 2YnY58cCWV5cIc3X8eQJ%2F%2FACKikIrRxPXjaweSQ%3D&amp;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&amp;data=04%7C01%7Cpen
> g.fan%40nxp.com%7C17ea116c2ca44f3ee06008d89fa6bf7d%7C686ea1d3bc
> 2b4c6fa92cd99c5c301635%7C0%7C0%7C637434885818043019%7CUnknow
> n%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1ha
> WwiLCJXVCI6Mn0%3D%7C1000&amp;sdata=JB5DHy0ymYFYB3JN4J%2FWS3
> WNBtwIIi7Zj0uNgu793fc%3D&amp;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&amp;sdata=PESa
> EwYork7GTo%2Fw8dqpB85yntYvhpu4R26bW40Au8U%3D&amp;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&amp;sdata=W1v
> eu%2BLnADW6VxKEMxai%2FFxQXfRibSIn%2B3mD0WnCtyA%3D&amp;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
Tom Rini Jan. 19, 2021, 1:04 p.m. UTC | #6
On Sun, Dec 13, 2020 at 08:36:06PM +0000, Andrey Zhizhikin wrote:

> 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@leica-geosystems.com>
> Reviewed-by: Fabio Estevam <festevam@gmail.com>
> Reviewed-by: Peng Fan <peng.fan@nxp.com>

Applied to u-boot/master, thanks!
diff mbox series

Patch

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://source.codeaurora.org/external/imx/imx-atf
-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://www.nxp.com/lgfiles/NMG/MAD/YOCTO/firmware-imx-8.0.bin
-   $ chmod +x firmware-imx-8.0.bin
-   $ ./firmware-imx-8.0
-   $ cp firmware-imx-8.0/firmware/ddr/synopsys/lpddr4*.bin $(builddir)
+   $ wget https://www.nxp.com/lgfiles/NMG/MAD/YOCTO/firmware-imx-8.9.bin
+   $ 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://source.codeaurora.org/external/imx/imx-atf
-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://www.nxp.com/lgfiles/NMG/MAD/YOCTO/firmware-imx-8.5.bin
-   $ chmod +x firmware-imx-8.5.bin
-   $ ./firmware-imx-8.5
-   $ cp firmware-imx-8.5/firmware/ddr/synopsys/ddr4*.bin $(srctree)
+   $ wget https://www.nxp.com/lgfiles/NMG/MAD/YOCTO/firmware-imx-8.9.bin
+   $ 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://source.codeaurora.org/external/imx/imx-atf
-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://www.nxp.com/lgfiles/NMG/MAD/YOCTO/firmware-imx-8.7.bin
-   $ 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_201904.bin $(srctree)/lpddr4_pmu_train_1d_dmem.bin
-   $ cp firmware-imx-8.7/firmware/ddr/synopsys/lpddr4_pmu_train_1d_imem_201904.bin $(srctree)/lpddr4_pmu_train_1d_imem.bin
-   $ cp firmware-imx-8.7/firmware/ddr/synopsys/lpddr4_pmu_train_2d_dmem_201904.bin $(srctree)/lpddr4_pmu_train_2d_dmem.bin
-   $ cp firmware-imx-8.7/firmware/ddr/synopsys/lpddr4_pmu_train_2d_imem_201904.bin $(srctree)/lpddr4_pmu_train_2d_imem.bin
+   $ wget https://www.nxp.com/lgfiles/NMG/MAD/YOCTO/firmware-imx-8.9.bin
+   $ 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_201904.bin $(srctree)/lpddr4_pmu_train_1d_dmem.bin
+   $ cp firmware-imx-8.9/firmware/ddr/synopsys/lpddr4_pmu_train_1d_imem_201904.bin $(srctree)/lpddr4_pmu_train_1d_imem.bin
+   $ cp firmware-imx-8.9/firmware/ddr/synopsys/lpddr4_pmu_train_2d_dmem_201904.bin $(srctree)/lpddr4_pmu_train_2d_dmem.bin
+   $ cp firmware-imx-8.9/firmware/ddr/synopsys/lpddr4_pmu_train_2d_imem_201904.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://source.codeaurora.org/external/imx/imx-atf
-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://www.nxp.com/lgfiles/NMG/MAD/YOCTO/firmware-imx-7.9.bin
-   $ 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://www.nxp.com/lgfiles/NMG/MAD/YOCTO/firmware-imx-8.9.bin
+   $ 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
 ------------