[PATCH v1] doc: imx: imxrt1170: Document imxrt1170-evk board

[Jesse T]

On Fri, Feb 2, 2024 at 3:40 AM Heinrich Schuchardt <xypron.glpk at gmx.de> wrote:
>
> On 2/1/24 16:00, Jesse Taube wrote:
> > Add documentation for imxrt1170-evk.
> >
> > Signed-off-by: Jesse Taube <Mr.Bossman075 at gmail.com>
> > ---
> >   doc/board/nxp/imxrt1170-evk.rst | 42 +++++++++++++++++++++++++++++++++
> >   1 file changed, 42 insertions(+)
> >   create mode 100644 doc/board/nxp/imxrt1170-evk.rst
> >
> > diff --git a/doc/board/nxp/imxrt1170-evk.rst b/doc/board/nxp/imxrt1170-evk.rst
> > new file mode 100644
> > index 0000000000..4acccdcc93
> > --- /dev/null
> > +++ b/doc/board/nxp/imxrt1170-evk.rst
> > @@ -0,0 +1,42 @@
> > +.. SPDX-License-Identifier: GPL-2.0+
> > +
> > +imxrt1170-evk
> > +=============
> > +
> > +How to use U-Boot on NXP i.MXRT1170 EVK
> > +---------------------------------------
> > +
> > +- Build U-Boot for i.MXRT1170 EVK:
> > +
> > +.. code-block:: bash
> > +
> > +   $ make mrproper
> > +   $ make imxrt1170-evk_defconfig
> > +   $ make
> > +
> > +This will generate the SPL image called SPL and the u-boot.img.
> > +
> > +- Flash the SPL image into the micro SD card:
> > +
> > +.. code-block:: bash
> > +
> > +   $sudo dd if=SPL of=/dev/sdX bs=1k seek=1 conv=notrunc; sync
>
> This location conflicts with GPT partitioning. Does the SoC support an
> alternative location for the SPL?

Unfortunately, it doesn't seem to, but it will still work as the
secondary table entry is intact.
As this is abuse of the GUID Partition Table it's probably best to just use MBR

Thanks,
Jesse Taube
>
> Best regards
>
> Heinrich
>
> > +
> > +- Flash the u-boot.img image into the micro SD card:
> > +
> > +.. code-block:: bash
> > +
> > +   $sudo dd if=u-boot.img of=/dev/sdX bs=1k seek=128 conv=notrunc; sync
> > +
> > +- Jumper settings::
> > +
> > +   SW1: 1 0 1 0
> > +   SW2: 0 0 0 0  0 0 0 0  1 0 0 0
> > +
> > +where 0 means bottom position and 1 means top position (from the
> > +switch label numbers reference).
> > +
> > +- Connect the USB cable between the EVK and the PC for the console.
> > +  The USB console connector is the one close the ethernet connector
> > +
> > +- Insert the micro SD card in the board, power it up and U-Boot messages should come up.
>