Re: [DistroKit] [PATCH 6/6] doc: add imx8mp-frdm

[Roland Hieber <rhi@pengutronix.de>]

On Tue, Jan 20, 2026 at 05:42:39PM +0100, Fabian Pfitzner wrote:
> ---
>  doc/hardware_v8a_imx8mp_frdm.rst | 46 ++++++++++++++++++++++++++++++++++++++++
>  1 file changed, 46 insertions(+)
> 
> diff --git a/doc/hardware_v8a_imx8mp_frdm.rst b/doc/hardware_v8a_imx8mp_frdm.rst
> new file mode 100644
> index 0000000000000000000000000000000000000000..bb2bad7f6cddf0bc525fecc3abac74cd486fbaa9
> --- /dev/null
> +++ b/doc/hardware_v8a_imx8mp_frdm.rst

You also have to add this file to the table of contents in the v8a section in
doc/hardware.rst, otherwise it is not included.

> @@ -0,0 +1,46 @@
> +NXP i.MX8MP FRDM Development Board
> +=================================
> +
> +
> +Boot Media
> +----------
> +
> +Booting is available via multiple sources (Compare Table 3: Boot Switch Configuration in Quick Start Guide)
> +
> +.. csv-table:: Boot Switch :rst:dir:`csv-table`

Oh cool, I didn't know this directive, but it seems useful!

> +   :header: "Boot Mode", "SW5-1", "SW5-2", "SW5-3", "SW5-4"
> +
> +   "Boot from Internal Fuses",      "0", "0", "0", "0"
> +   "Serial Downloader",             "0", "0", "0", "1"
> +   "Boot from USDHC3 eMMC 5.1",     "0", "0", "1", "0"
> +   "Boot from USDHC2 SD card",      "0", "0", "1", "1"
> +
> +
> +Booting from USB and NFS
> +~~~~~~~~~~~~~~~~~~~~~~~~
> +
> +Upload the bootloader ``platform-v8a/images/barebox-nxp-imx8mp-frdm.img`` via USB:
> +
> +.. code-block:: shell
> +
> +    platform-v8a/sysroot-host/bin/imx-usb-loader platform-v8a/images/barebox-nxp-imx8mp-frdm.img
> +
> +In Barebox, set the default boot location to nfs:

Double colon '::' at the end here so that the next line gets rendered as code…

> +
> +    nv boot.default nfs://dude05//ptx/work/user/fpf/DistroKit/platform-v8a/root

… but shouldn't it be easier to use the usual 'boot net' setup in barebox by
setting user=fpf, net.server=dude05 and boot.default=net in the barebox env?

> +
> +replace the path to one, where you have compiled your Distrokit

And add a full stop at the end of the sentence and no comma before 'where'

> +
> +
> +Booting via SD-Card
> +~~~~~~~~~~~~~~~~~~~
> +
> +Write the image ``platform-v8a/images/imx8mp-frdm.img`` to a microSD card. Put the
> +microSD card into the board and boot it.

Please keep semantic line breaks after full stops. <https://sembr.org/>

> +
> +
> +Serial Console
> +--------------
> +
> +The serial boot console is available via the USB-C Debug connector on the board.
> +It brings 2 UARTS, whereas the first is the serial console used by kernel and bootloader.

 - Roland

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