u-boot/board/freescale/mx6sabreauto
Masahiro Yamada b75d8dc564 treewide: convert bd_t to struct bd_info by coccinelle
The Linux coding style guide (Documentation/process/coding-style.rst)
clearly says:

  It's a **mistake** to use typedef for structures and pointers.

Besides, using typedef for structures is annoying when you try to make
headers self-contained.

Let's say you have the following function declaration in a header:

  void foo(bd_t *bd);

This is not self-contained since bd_t is not defined.

To tell the compiler what 'bd_t' is, you need to include <asm/u-boot.h>

  #include <asm/u-boot.h>
  void foo(bd_t *bd);

Then, the include direcective pulls in more bloat needlessly.

If you use 'struct bd_info' instead, it is enough to put a forward
declaration as follows:

  struct bd_info;
  void foo(struct bd_info *bd);

Right, typedef'ing bd_t is a mistake.

I used coccinelle to generate this commit.

The semantic patch that makes this change is as follows:

  <smpl>
  @@
  typedef bd_t;
  @@
  -bd_t
  +struct bd_info
  </smpl>

Signed-off-by: Masahiro Yamada <masahiroy@kernel.org>
2020-07-17 09:30:13 -04:00
..
Kconfig mx6sabreauto: Update to SPL only mode 2017-07-12 09:44:22 +02:00
MAINTAINERS mx6sabreauto: Update to SPL only mode 2017-07-12 09:44:22 +02:00
Makefile SPDX: Convert all of our single license tags to Linux Kernel style 2018-05-07 09:34:12 -04:00
mx6sabreauto.c treewide: convert bd_t to struct bd_info by coccinelle 2020-07-17 09:30:13 -04:00
README mx6sabreauto: README: Adjust the binary name after DM conversion 2019-03-13 09:14:35 +01:00

How to use and build U-Boot on mx6sabreauto
-------------------------------------------

mx6sabreauto_defconfig target supports mx6q/mx6dl/mx6qp sabreauto variants.

In order to build it:

$ make mx6sabreauto_defconfig

$ make

This will generate the SPL and u-boot-dtb.img binaries.

- Flash the SPL binary into the SD card:

$ sudo dd if=SPL of=/dev/sdX bs=1K seek=1 && sync

- Flash the u-boot-dtb.img binary into the SD card:

$ sudo dd if=u-boot-dtb.img of=/dev/sdX bs=1K seek=69 && sync

Booting via Falcon mode
-----------------------

Write in mx6sabreauto_defconfig the following define below:

CONFIG_SPL_OS_BOOT=y

In order to build it:

$ make mx6sabreauto_defconfig

$ make

This will generate the SPL image called SPL and the u-boot-dtb.img.

- Flash the SPL image into the SD card:

$ sudo dd if=SPL of=/dev/sdb bs=1K seek=1 && sync

- Flash the u-boot-dtb.img image into the SD card:

$ sudo dd if=u-boot-dtb.img of=/dev/sdb bs=1K seek=69 && sync

Create a FAT16 boot partition to store uImage and the dtb file, then copy the files there:

$ sudo cp uImage /media/boot

$ sudo cp imx6dl-sabreauto.dtb /media/boot

Create a partition for root file system and extract it there:

$ 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:

- Load dtb file from boot partition:

# load mmc 0:1 ${fdt_addr} imx6dl-sabreauto.dtb

- Load kernel image from boot partition:

# load mmc 0:1 ${loadaddr} uImage

- Write kernel at 2MB offset:

# mmc write ${loadaddr} 0x1000 0x4000

- Setup kernel bootargs:

# setenv bootargs "console=ttymxc3,115200 root=/dev/mmcblk0p1 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

- Restart the board and then SPL binary will launch the kernel directly.