[U-Boot] [PATCH] doc: socfpga: Update README.socfpga for Preloader development flow

[Marek Vasut]

On 09/21/2016 04:35 AM, Chin Liang See wrote:
> Update documentation to include the Cyclone V SoC Preloader
> development flow. This include the update of Preloader handoff
> through qts-filter.sh script. At same time, removed the SDMMC
> documentation as its using DM now.

Good stuff . s/folder/directory/ , this is not windows.

> Signed-off-by: Chin Liang See <clsee at altera.com>
> Cc: Marek Vasut <marex at denx.de>
> Cc: Dinh Nguyen <dinguyen at opensource.altera.com>
> ---
>  doc/README.socfpga | 69 +++++++++++++++++++++++-------------------------------
>  1 file changed, 29 insertions(+), 40 deletions(-)
> 
> diff --git a/doc/README.socfpga b/doc/README.socfpga
> index cfcbbfe..04c5c0e 100644
> --- a/doc/README.socfpga
> +++ b/doc/README.socfpga
> @@ -9,45 +9,34 @@ www.altera.com.

[...]

> +1. Please refer to SOCEDS documentation on generating handoff for Preloader
> +   Upon successful generation, there will be a folder "software/preloader" at
                                                  ^^^^^^
> +   the directory of your Qsys project.
> +
> +2. Then, you need to invoke qts-filter.sh at arch/arm/mach-socfpga folder to
> +   process the generated handoff files into Preloader source code.
> +   $ sh arch/arm/mach-socfpga/qts-filter.sh <device> <your Qsys directory> \
> +     <your Qsys directory>/software/preloader> <destination of handoff files>
> +
> +   Example:
> +
> +   $ cd <u-boot directory>
> +   $ sh arch/arm/mach-socfpga/qts-filter.sh cyclone5 \
> +     /hardware/cv_soc_devkit_ghrd/ \
> +     /hardware/cv_soc_devkit_ghrd/software/preloader/ \
> +     board/altera/cyclone5-socdk/qts/

You should be explicit that these are two separate examples , one for CV
and the other one for AV .

> +   $ cd <u-boot directory>
> +   $ sh arch/arm/mach-socfpga/qts-filter.sh arria5 \
> +     /hardware/av_soc_devkit_ghrd/ \
> +     /hardware/av_soc_devkit_ghrd/software/preloader/
> +     board/altera/arria5-socdk/qts/
> +
> +3. Build the Preloader + U-Boot

It's called U-Boot SPL , not preloader .

> +   $ export CROSS_COMPILE=arm-altera-eabi-
> +   $ make mrproper
> +   $ make socfpga_cyclone5_defconfig
> +   $ make

It's worth mentioning the generated u-boot-with-spl.sfp and how to
install it onto a card (mention partitioning layout) and into QSPI
NOR (just write the binary at the beginning). Regarding QSPI NOR, it
might be worth mentioning quartus_hps, see :
https://rocketboards.org/foswiki/view/Documentation/GSRD131QspiProgram



-- 
Best regards,
Marek Vasut