Quick start

^{Home / Tutorial Index / Getting started}

List of basic commands needed to produce your first Linux build

Clone https://github.com/peteasa/parallella.git repository:

git clone https://github.com/peteasa/parallella.git

then in the parallella directory run:

cd parallella
./initgitsubmodules.sh

Alternatively if you are updating to the latest version:

source updatesubmodules.sh

Before you start for the kernel and linux build ensure you have the necessary linux build tools

sudo apt-get install gawk wget git-core diffstat unzip texinfo gcc-multilib build-essential chrpath socat libsdl1.2-dev xterm

Start the Yocto build

cd parallella-yoctobuild
source prepareyoctobuild.sh

This will change the path to the parallella-yoctobuild/build_parallella folder where you can build the yocto release

bitbake hdmi-image-example

DONT FORGET: do not press CTRL-C more than once to stop a bitbake build because you can corrupt the cache and cause many hours of failing builds for unexplained reasons.

Files to change to add a new FPGA

parallella/parallella-yoctobuild/meta-example/recipes-bsp/bitstream/parallella-hdmi-bitstream.bbappend Add your git repository that contains your updated FPGA bitstream for example

### You could setup a local bare repository with the fpga for example
SRC_URI = "git://~/parallella/myexamples.git"
SRCREV = "--enter your desired sha1 here!--"

parallella/parallella-yoctobuild/meta-example/recipes-bsp/device-tree/device-tree.bbappend Ensure that your device-tree changes are included in the referenced files, or create new files stored in parallella/parallella-yoctobuild/meta-example/conf/machine/boards/parallella

MACHINE_DEVICETREE = " \
		parallella/parallella-example.dtsi \
		parallella/parallella-hdmi-example.dtsi \
		parallella/parallella-hdmi-example.dts \
		parallella/parallella-hdmi-mmc-boot-example.dts \
		"

List of commands to build hello world application on the parallella target

Copy the hello world folders to the target

cd parallella/examples/epiphany
rcp -r ./hello_world [email protected]:/home/root
rcp setup-epiphany-sdk-on-target.sh [email protected]:/home/root

ssh to the parallella and compile the hello world program

ssh [email protected]
source setup-epiphany-sdk-on-target.sh
cd hello_world
make

Run the hello world program on the parallella

/usr/epiphany/bin/hello_world

List of commands to build hello world application on the build machine

Build the Yocto SDK on the build machine

cd parallella-yoctobuild/build_parallella
bitbake -c populate_sdk hdmi-image-example

Install the SDK on the build machine (install using the default settings) and create the folder for the SDK on the system and change the owner to yourid (ie if your linux name is jess then your home folder will be /home/jess and you should use chown jess:jess /opt/poky below:

sudo mkdir /opt/poky
sudo chown yourid:yourid /opt/poky
tmp/deploy/sdk/poky-glibc-x86_64-hdmi-image-debug-armv7ahf-vfp-neon-toolchain-1.8.sh

Install the SDK paths into environment

source /opt/poky/1.8/environment-setup-armv7ahf-vfp-neon-poky-linux-gnueabi

Setup the Epiphany specific environment

cd examples/epiphany
source setup-epiphany-sdk-in-poky-sdk.sh

Build the Hello world application

cd hello-world
make

Copy to the target

rcp ./host/hello_world [email protected]:/home/root
rcp ./epiphany/e_hello_world.srec [email protected]:/usr/epiphany/bin/

Run on the target

ssh [email protected]
source setup-epiphany-sdk-on-target.sh
./hello_world