Grapeboard is a development board based on NXP LS1012A processor.

Environment

BSP build was verified to work on Debian Jessie. To install all included packages:

$ apt-get update
$ apt-get install binutils bzip2 chrpath cpio cpp diffstat g++ gawk gcc git make patch wget
$ apt-get install python3

Download

This BSP is organized using git submodules. To fetch latest BSP version use command:

$ git clone --recursive https://github.com/Scalys/yocto-bsp.git

Build

To build image first go into the BSP sources directory and source the environment script:

$ cd <bsp-location>
$ source grapeboard-env

Then build image either for SD card/USB stick/SSD driver with:

$ bitbake scalys-base-image

Or the version for deployment on the internal QSPI flesh memory:

$ bitbake scalys-base-image-qspi

Once build completes, all the built images will be availabe at /build/tmp/deploy/images/grapeboard

Deploy

U-Boot

There are two u-boot images generated by the yocto build:

u-boot.bin-pcie
u-boot.bin-sata

They differ in the way bootloader configures m.2 slot. Depending on the required configuration take the needed image.

Put the generated u-boot image in the root of the SD card.
Rename it as a u-boot-with-pbl.bin
Power on the Grapeboard and stop the boot process at the bootloader stage.
Run the u-boot update scrip:

=> run update_mmc_uboot_qspi_nor

PFE firmware

Place the pfe firmware engine-pfe-bin/pfe_fw_sbl.itb in the SD card root
Boot the grapeboard and stop the boot process at the bootloader stage.
Run the pfe update scrip:

=> run update_mmc_pfe_qspi_nor

PPA firmware

Place the ppa firmware ppa.itb in the SD card root
Boot the grapeboard and stop the boot process at the bootloader stage.
Run the ppa update scrip:

=> run update_mmc_ppa_qspi_nor

SD card root

Format SD card into a single ext4 partition
Unpack contents of the generated scalys-base-image-grapeboard.tar.gz to the SD card

Development

Development of custom applications for the Yocto-based BSP can be done via Yocto SDK. It includes compilers, linker and all the development files for packages configured in the scalys-base-image image. Pre-built version of this SDK is available in a form of shell script poky-glibc-x86_64-s-tracks-image-base-aarch64-toolchain-2.5.sh.

To install it execute the script and enter SDK installation path. Once installed, source generated environment via:

$ source /opt/poky/2.5/environment-setup-aarch64-poky-linux

To build an SDK for a custom image with set of packages different from the default one:

$ bitbake -c populate_sdk <custom_image>

The resulting SDK will be located in the directory /build/tmp/deploy/sdk.

githaff/yocto-bsp