u-boot/doc/board/nxp/mx6sabresd.rst
Michal Simek 1be82afa80 global: Use proper project name U-Boot
Use proper project name in comments, Kconfig, readmes.

Reviewed-by: Neil Armstrong <neil.armstrong@linaro.org>
Acked-by: Ilias Apalodimas <ilias.apalodimas@linaro.org>
Reviewed-by: Stefan Roese <sr@denx.de>
Reviewed-by: Qu Wenruo <wqu@suse.com>
Signed-off-by: Michal Simek <michal.simek@amd.com>
Link: https://lore.kernel.org/r/0dbdf0432405c1c38ffca55703b6737a48219e79.1684307818.git.michal.simek@amd.com
2023-06-12 13:24:31 +02:00

132 lines
2.9 KiB
ReStructuredText

.. SPDX-License-Identifier: GPL-2.0+
mx6sabresd
==========
How to use and build U-Boot on mx6sabresd
-----------------------------------------
The following methods can be used for booting mx6sabresd boards:
1. Booting from SD card
2. Booting from eMMC
3. Booting via Falcon mode (SPL launches the kernel directly)
1. Booting from SD card via SPL
-------------------------------
mx6sabresd_defconfig target supports mx6q/mx6dl/mx6qp sabresd variants.
In order to build it:
.. code-block:: bash
$ make mx6sabresd_defconfig
$ make
This will generate the SPL and u-boot-dtb.img binaries.
- Flash the SPL binary into the SD card:
.. code-block:: bash
$ sudo dd if=SPL of=/dev/sdX bs=1K seek=1 conv=notrunc && sync
- Flash the u-boot-dtb.img binary into the SD card:
.. code-block:: bash
$ sudo dd if=u-boot-dtb.img of=/dev/sdX bs=1K seek=69 conv=notrunc && sync
2. Booting from eMMC
--------------------
.. code-block:: bash
$ make mx6sabresd_defconfig
$ make
This will generate the SPL and u-boot-dtb.img binaries.
- Boot first from SD card as shown in the previous section
In U-Boot change the eMMC partition config::
=> mmc partconf 2 1 0 0
Mount the eMMC in the host PC::
=> ums 0 mmc 2
- Flash SPL and u-boot-dtb.img binaries into the eMMC:
.. code-block:: bash
$ sudo dd if=SPL of=/dev/sdX bs=1K seek=1 conv=notrunc && sync
$ sudo dd if=u-boot-dtb.img of=/dev/sdX bs=1K seek=69 conv=notrunc && sync
Set SW6 to eMMC 8-bit boot: 11010110
3. Booting via Falcon mode
--------------------------
.. code-block:: bash
$ make mx6sabresd_defconfig
$ make
This will generate the SPL image called SPL and the u-boot-dtb.img.
- Flash the SPL image into the SD card
.. code-block:: bash
$ sudo dd if=SPL of=/dev/sdX bs=1K seek=1 oflag=sync status=none conv=notrunc && sync
- Flash the u-boot-dtb.img image into the SD card
.. code-block:: bash
$ sudo dd if=u-boot-dtb.img of=/dev/sdX bs=1K seek=69 oflag=sync status=none conv=notrunc && sync
Create a partition for root file system and extract it there
.. code-block:: bash
$ sudo tar xvf rootfs.tar.gz -C /media/root
The SD card must have enough space for raw "args" and "kernel".
To configure Falcon mode for the first time, on U-Boot do the following commands:
- Setup the IP server::
# setenv serverip <server_ip_address>
- Download dtb file::
# dhcp ${fdt_addr} imx6q-sabresd.dtb
- Download kernel image::
# dhcp ${loadaddr} uImage
- Write kernel at 2MB offset::
# mmc write ${loadaddr} 0x1000 0x4000
- Setup kernel bootargs::
# setenv bootargs "console=ttymxc0,115200 root=/dev/mmcblk1p1 rootfstype=ext4 rootwait quiet rw"
- Prepare args::
# spl export fdt ${loadaddr} - ${fdt_addr}
- Write args 1MB data (0x800 sectors) to 1MB offset (0x800 sectors)::
# mmc write 18000000 0x800 0x800
- Press KEY_VOL_UP key, power up the board and then SPL binary will launch the kernel directly.