Bora Embedded Linux Kit (BELK)

Info Box Applies to Bora

Introduction

Bora Embedded Linux Kit (BELK for short) provides all the necessary components required to set up the developing environment for:

• configuring the system (PS and PL) at hardware level
• build the first-stage bootloader (FSBL)
• building the second stage bootloader (U-Boot)
• building and running Linux operating system on Bora-based systems
• building Linux applications that will run on the target

DAVE Embedded Systems provides all the customization required (in particular at bootloader and Linux kernel levels) to enable customers use the standard Zynq-7000 development tools for building all the firmware/software components that will run on the target system.

Logical structure of Bora Embedded Linux Kit (BELK)

Please refer to this page.

Kit Contents

Component	Description	Notes
	BORA SOM CPU: Xilinx Zynx 7000	Please refer to Bora Hardware Manual
	BORA Carrier board	Please refer to BoraEVB page
	AC/DC Single Output Wall Mount adapter Output: +12V – 2.0 A	Please refer to Belk Quick Start Guide
	MicroSDHC card with SD adapter and USB adapter	Please refer to Belk Quick Start Guide

BELK software components

DAVE Embedded Systems adds to the latest Linux BSP from Xilinx the customization required to support the Bora platform, in particular at bootloader and linux kernel levels.

The following table reports the BELK releases information.

	BELK version
Release number	1.0.0	1.1.0	2.0.0	2.1.0	2.2.0	3.0.0
Status	Released	Released	Released	Released	Released	Released
Release date	July 2013	November 2013	May 2014	August 2014	September 2015	March 2016
Release notes	Ver 1.0.0	Ver 1.1.0	Ver 2.0.0	Ver 2.1.0	Ver 2.2.0	Ver 3.0.0
SOM PCB version	CS020313A	CS020313A	CS020313B	CS020313B	CS020313B	CS020313C
Supported carrier boards	BoraEVB-Lite	BoraEVB-Lite	BoraEVB	BoraEVB	BoraEVB	BoraEVB
U-Boot version	2013.04-belk-1.0.0	2013.04-belk-1.1.0	2013.04-belk-2.0.0	2013.04-belk-2.1.0	2014.07-belk-2.2.0	2014.07-belk-3.0.0
Linux version	3.9.0-bora-1.0.0	3.9.0-bora-1.1.0	3.9.0-bora-2.0.0	3.9.0-bora-2.1.0	3.17.0-bora-2.2.0	3.17.0-bora-3.0.0
Drivers	-	-	Gigabit Eth #0 UART NOR NAND SD/MMC USB Host/Device RTC CAN I2C	Gigabit Eth #0 UART NOR NAND SD/MMC USB Host/Device RTC CAN I2C	Gigabit Eth #0 UART NOR NAND SD/MMC USB Host/Device RTC CAN I2C ConfigID	Gigabit Eth #0 UART NOR NAND SD/MMC USB Host/Device RTC CAN I2C ConfigID
Vivado version	2013.2	2013.3	2013.3	2013.3	2014.4	2014.4
Build System	-	-	-	Yocto Daisy (1.6)	Yocto Daisy (1.6)	Yocto Daisy (1.6)

How to update BELK

It's recommended to use the latest available BELK version. Please refer to Release notes for further information.

Updating git repositories

In BELK, the following source trees are clones of DAVE Embedded Systems public git repositories:

Component	GIT Remote
Vivado project	git@git.dave.eu:dave/bora/bora.git
Linux	git@git.dave.eu:dave/bora/linux-xlnx.git
U-Boot	git@git.dave.eu:dave/bora/u-boot-xlnx.git

This means that these components can be kept in sync and up to date with DAVE Embedded Systems repositories.

RSA key generation

Please follow the procedure reported below to generate the RSA ssh key:

• select your username (ad es. username@myhost.com)
• start your Linux development server machine
• start a shell session
• make sure the ssh client components are installed
• enter the .ssh subdirectory into your home directory: cd ~/.ssh/
• launch the following command:
  

  ssh-keygen -t rsa -C "username@myhost.com" -f username@myhost.com

• this command creates the files ~/.ssh/username@myhost.com (private key) and ~/.ssh/username@myhost.com.pub (public key)
• edit your ~/.ssh/config adding the following lines:

Host git.dave.eu
    User git
    Hostname git.dave.eu
    PreferredAuthentications publickey
    IdentityFile ~/.ssh/username@myhost.com

Please send the public key file to the following email support addresses:

• support-bora@dave.eu

with the request for the creation of a new public git account associated to your username. The support team will enable the account and send you a confirmation as soon as possible.

Updating the repositories from BELK 2.1.0

To update the repositories from BELK 2.1.0, the following commands should be used:

git fetch origin
git checkout -b <new_branch_name> origin/bora

Synchronizing the repositories

When the account is enabled, you can synchronize a source tree entering the repository directory and launching the git fetch command. Please note that git fetch doesn't merge the commits on the current branch. To do that, you should run the git merge command or replace the fetch-merge process with a single git pull command. Please note that the recommended method is the fetch-merge process. For further information on Git, please refer to Git Documentation.

Release notes

BELK 3.0.0

Updates:

1. Added support for BORA Xpress SOM
2. Updated U-Boot and Linux versions

Known Limitations

Issue	Description
Yocto ubi-utils command line	Some Yocto ubi-utils command line are in non standard format. For ubimkvol and ubirmvol the UBI device must be the last argument (e.g. ubimkvol -m -N belk /dev/ubi0)
External DDR3 bank	The DDR3 SDRAM bank on the BoraEVB is not supported in this BELK version.
ETH1 interface	The additional Gigabit Ethernet interface (ETH1) is not supported in this BELK version.
RTC	Date/time retention is limited to about 4 hours.

BELK 2.2.0

Updates:

1. Switched to Vivado 2014.4
2. Added “board part” for the BORA SOM, which includes all the settings of the Zynq PS for BORA, allowing users to manage projects from the Vivado GUI (and not only using the CLI).
3. Added ConfigID
4. Updated U-Boot and Linux versions

Known Limitations

Issue	Description
Kernel command line	User should remove mem=xxx from kernel command line to avoid system hang during boot. This is fixed in current u-boot default environment
Yocto ubi-utils command line	Some Yocto ubi-utils command line are in non standard format. For ubimkvol and ubirmvol the UBI device must be the last argument (e.g. ubimkvol -m -N belk /dev/ubi0)
External DDR3 bank	The DDR3 SDRAM bank on the BoraEVB is not supported in this BELK version.
ETH1 interface	The additional Gigabit Ethernet interface (ETH1) is not supported in this BELK version.
RTC	Date/time retention is limited to about 4 hours.
u-boot default environment	Default u-boot environment has a syntax error on sdboot command. This is already fixed in bora-next branch, release belk-2.2.1-rc1, available on u-boot repository.

BELK 2.1.0

Updates:

1. Fix and performance improvement on u-boot network interface
2. Fix SD card hotplug issue in Linux
3. First Yocto Daisy (1.6) BSP Release

Known Limitations

Issue	Description
ETH0 interface	Primary Gigabit Ethernet Interface (ETH0) is not working correctly at 10Mbps
Kernel command line	User should remove mem=xxx from kernel command line to avoid system hang during boot
Yocto ubi-utils command line	Some Yocto ubi-utils command line are in non standard format. For ubimkvol and ubirmvol the UBI device must be the last argument (e.g. ubimkvol -m -N belk /dev/ubi0)
External DDR3 bank	The DDR3 SDRAM bank on the BoraEVB is not supported in this BELK version.
ETH1 interface	The additional Gigabit Ethernet interface (ETH1) is not supported in this BELK version.
RTC	Date/time retention is limited to about 4 hours.

BELK 2.0.0

Updates:

1. Added support for the BoraEVB carrier board
2. Updated supported drivers list (please refer to BELK_software_components)

Known Limitations

The following table reports the known limitations of this BELK release:

Issue	Description
External DDR3 bank	The DDR3 SDRAM bank on the BoraEVB is not supported in this BELK version.
ETH1 interface	The additional Gigabit Ethernet interface (ETH1) is not supported in this BELK version.
RTC	Date/time retention is limited to about 4 hours.

BELK 1.1.0

Updates:

1. Switched to Vivado 2013.3
2. Added application note "AMP on Bora"

BELK 1.0.0

First official release

Related Documents

• Bora Hardware Manual
• BoraEVB-Lite
• BORAEVB
• BELK Quick Start Guide
• Application Notes
• BORA FAQs