u-boot

History

Tom Rini 83d290c56f SPDX: Convert all of our single license tags to Linux Kernel style When U-Boot started using SPDX tags we were among the early adopters and there weren't a lot of other examples to borrow from. So we picked the area of the file that usually had a full license text and replaced it with an appropriate SPDX-License-Identifier: entry. Since then, the Linux Kernel has adopted SPDX tags and they place it as the very first line in a file (except where shebangs are used, then it's second line) and with slightly different comment styles than us. In part due to community overlap, in part due to better tag visibility and in part for other minor reasons, switch over to that style. This commit changes all instances where we have a single declared license in the tag as both the before and after are identical in tag contents. There's also a few places where I found we did not have a tag and have introduced one. Signed-off-by: Tom Rini <trini@konsulko.com>		2018-05-07 09:34:12 -04:00
..
Kconfig	arm: Add support for LEGO MINDSTORMS EV3	2016-03-14 19:18:40 -04:00
legoev3.c	SPDX: Convert all of our single license tags to Linux Kernel style	2018-05-07 09:34:12 -04:00
MAINTAINERS	arm: Add support for LEGO MINDSTORMS EV3	2016-03-14 19:18:40 -04:00
Makefile	SPDX: Convert all of our single license tags to Linux Kernel style	2018-05-07 09:34:12 -04:00
README	arm: Add support for LEGO MINDSTORMS EV3	2016-03-14 19:18:40 -04:00

README

Summary
=======

LEGO MINDSTORMS EV3 is a toy robot produced by the LEGO Group. It is based
on the davinci da850 evm. The EV3 has a 16MB spi flash and a SDHC microSD card
reader.

Booting
=======

The EV3 contains a bootloader in EEPROM that loads u-boot.bin from address 0x0
of the spi flash memory. Using the default configuration, u-boot will check to
see if there is a boot.scr file on the first FAT partition of the mmc. If there
is, it will run the script and boot the kernel from the uImage file also in
the FAT partition. Otherwise, it will load a kernel and rootfs from the flash.
The kernel must be stored at address 0x50000 on the flash and have a maximum
size of 3MiB. The rootfs must be a squasfs image and stored at 0x350000 in the
flash and have a maximum size of 9.3MiB. The flash starting at 0xCB0000 is
reserved for user data.

Writing image to flash
======================

The EEPROM contains a program for uploading an image file to the flash memory.
The program is started by holding down the right button on the EV3 when powering
it on. You can also `run fwupdateboot` in the u-boot shell to reboot into this
mode. The image can then be uploaded using the official LEGO MINDSTORMS EV3
software or a 3rd party program capable of uploading a firmware file.

If you are booting from the microSD card, it is enough to just write uboot.bin
to the flash. If you are not using a microSD card, you will need to create an
image file using the layout described above.