Axel Embedded Linux Kit (XELK)

Info Box Applies to Dacu Applies to Axel Ultra Applies to Axel Lite Applies to AXEL ESATTA

Introduction

Customers are strongly recommended to register their kits. Registration grants access to reserved material such as source code and additional documentation. To register the kit, please send an email to support-axel@dave.eu, providing the kit P/N and S/N.

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

• build the bootloader (U-Boot)
• build and run Linux operating system on Axel-based systems
• build Linux applications that will run on the target.

The main kit components are:

• hardware platform composed of
  • Axel system-on-module (SOM for short)
  • AxelEVB-Lite plugged on Dacu carrier board
  • 800x480 7" LVDS display
• Development virtual machine containing:
  • Toolchain
  • U-Boot bootloader sources
  • Linux kernel sources
  • Root file systems
• Technical documentation such hardware manuals, mechanical drawings, reference schematics, application notes etc.

The documents related to the software issues help the user to quickly start configuring the bootloader and the operating system, by hiding most of the complexity of the underlying hardware. For more details about Axel hardware characteristics, please refer to the Axel Hardware Manual. An account for the reserved area of DAVE Embedded Systems website is required to access the kit contents.

Kit Contents

Component	Description	Notes
	Axel Ultra SOM CPU: Freescale i.MX6 SDRAM: 2 GB DDR3 NOR: bootable SPI flash 32 MB NAND: 1GB	Please refer to Axel Ultra Hardware Manual
	Axel Lite SOM CPU: Freescale i.MX6 SDRAM: 2 GB DDR3 NOR: bootable SPI flash 32 MB NAND: 1GB	Please refer to Axel Lite Hardware Manual
	AxelEVB-Lite Carrier board	Please refer to AxelEVB-Lite page
	Dacu Carrier board	Please refer to Dacu page
	Ampire AM-800480STMQW 7” 800x480 LCD display LVDS interface	Please refer to XELK Quick Start Guide
	AC/DC Single Output Wall Mount adapter Output: +12V – 2.0 A	Please refer to XELK Quick Start Guide
	DB9 Male Serial port adapter	Please refer to XELK Quick Start Guide
	MicroSDHC card with SD adapter and USB adapter	Please refer to XELK Quick Start Guide

XELK software components

DAVE Embedded Systems adds to the latest Linux BSP from NXP/Freescale the customization required to support the Axel platform. For this reason most of the documentation provided by NXP/Freescale remains valid for the XELK development kit. However, some customization is required, in particular at bootloader and linux kernel levels.

The following table reports the XELK releases information.

	XELK version
Release number	1.0.0	1.1.0	1.2.0	2.0.0	2.1.0	2.2.0	2.3.1	3.0.1	3.5.0	4.0.0	4.1.0	5.0.0
Release type	Major	Maintenance	Maintenance	Major	Maintenance	Maintenance	Maintenance	Major	Maintenance	Major	Maintenance	Major
Status	Released	Released	Released	Released	Released	Released	Released	Released	Released	Released	Released	In progress
Release date	November, 4th 2013	January 2014	May 2014	November 2014	May 2015	February 2016	October 2016	November 2017	April 2019	August 2019	October 2019	Q1 2020
Release notes	Ver 1.0.0	Ver 1.1.0	Ver 1.2.0	Ver 2.0.0	Ver 2.1.0	Ver 2.2.0	Ver 2.3.1	Ver 3.0.1	Ver 3.5.0	Ver 4.0.0	Ver 4.1.0	Ver 5.0.0
SOM PCB version	Axel Ultra: CS030713	Axel Ultra: CS030713A	Axel Ultra: CS030713A Axel Lite: CS335013A	Axel Ultra: CS030713A Axel Lite: CS335013A	Axel Ultra: CS030713B Axel Lite: CS335013A	Axel Ultra: CS030713B Axel Lite: CS335013A	Axel Ultra: CS030713B Axel Lite: CS335013A Axel Lite: CS335013C	Axel Lite: CS335013A Axel Lite: CS335013C	Axel Lite: CS335013A Axel Lite: CS335013C	Axel Lite: CS335013A Axel Lite: CS335013C	Axel Lite: CS335013A Axel Lite: CS335013C	Axel Lite: CS335013A Axel Lite: CS335013C
Supported carrier boards	AxelEVB-Lite Dacu	AxelEVB-Lite Dacu	AxelEVB-Lite Dacu	AxelEVB-Lite Dacu	AxelEVB-Lite AxelEVB-Lite rev.A Dacu	AxelEVB-Lite AxelEVB-Lite rev.A Dacu SBCX	AxelEVB-Lite AxelEVB-Lite rev.A Dacu SBCX	AxelEVB-Lite AxelEVB-Lite rev.A Dacu SBCX	AxelEVB-Lite AxelEVB-Lite rev.A Dacu SBCX	AxelEVB-Lite AxelEVB-Lite rev.A Dacu SBCX	AxelEVB-Lite AxelEVB-Lite rev.A Dacu SBCX	AxelEVB-Lite AxelEVB-Lite rev.A Dacu SBCX
MVM (distro version)	Ubuntu 12.04	Ubuntu 12.04	Ubuntu 12.04	Ubuntu 12.04	Ubuntu 12.04	Ubuntu 12.04	Ubuntu 12.04	Ubuntu 14.04	Ubuntu 14.04	Ubuntu 14.04	Ubuntu 14.04	Ubuntu 16.04
U-Boot version	2013.10-xelk-1.0.0	2013.10-xelk-1.1.0	2013.10-xelk-1.2.0	2013.04-xelk-2.0.0	2013.04-xelk-2.1.0	2013.04-xelk-2.2.0	2013.04-xelk-2.3.1	2016.03-xelk-3.0.2	2016.03-xelk-3.5.0	2017.03-xelk-4.0.0	2017.03-xelk-4.0.0	2018.03-xelk-5.0.0
Linux version	3.0.35-xelk-1.0.0	3.0.35-xelk-1.1.0	3.0.35-xelk-1.2.0	3.10.17-xelk-2.0.0	3.10.17-xelk-2.1.0	3.10.17-xelk-2.2.0	3.10.17-xelk-2.3.1	4.1.15-xelk-3.0.0	4.1.15-xelk-3.0.0	4.9.11-xelk-4.0.0	4.9.11-xelk-4.0.0	4.14.98-xelk-5.0.0
Drivers	SPI NOR Flash (boot) UART debug (2-wire) USB Host USB OTG SD/MMC1 CAN Touch screen controller EMAC SATA HDMI LVDS0	SPI NOR Flash (boot) UART debug (2-wire) USB Host USB OTG SD/MMC1 CAN Touch screen controller EMAC SATA HDMI LVDS0 NAND RTC I2C SPI	SPI NOR Flash (boot) UART debug (2-wire) USB Host USB OTG SD/MMC1 CAN Touch screen controller EMAC SATA HDMI LVDS0 NAND RTC I2C SPI	SPI NOR Flash (boot) UART debug (2-wire) USB Host USB OTG SD/MMC1 CAN Touch screen controller EMAC SATA HDMI LVDS0 NAND RTC I2C SPI Video Input (MIPI)	SPI NOR Flash (boot) UART debug (2-wire) USB Host USB OTG SD/MMC1 CAN Touch screen controller EMAC SATA HDMI LVDS0 NAND RTC I2C SPI Video Input (MIPI) PCIe ConfigID	SPI NOR Flash (boot) UART debug (2-wire) USB Host USB OTG SD/MMC1 CAN Touch screen controller EMAC SATA HDMI LVDS0 NAND RTC I2C SPI Video Input (MIPI) PCIe ConfigID Splash screen (U-Boot) [1]	SPI NOR Flash (boot) UART debug (2-wire) USB Host USB OTG SD/MMC1 CAN Touch screen controller EMAC SATA HDMI LVDS0 NAND RTC I2C SPI Video Input (MIPI) PCIe ConfigID Splash screen (U-Boot) [1]	SPI NOR Flash (boot) UART debug (2-wire) USB Host USB OTG SD/MMC1 CAN Touch screen controller EMAC SATA HDMI LVDS0 NAND RTC I2C SPI Video Input (MIPI) PCIe ConfigID Splash screen (U-Boot) [1]	SPI NOR Flash (boot) UART debug (2-wire) USB Host USB OTG SD/MMC1 CAN Touch screen controller EMAC SATA HDMI LVDS0 NAND RTC I2C SPI Video Input (MIPI) PCIe ConfigID Splash screen (U-Boot) [1] SPL boot[2]	SPI NOR Flash (boot) UART debug (2-wire) USB Host USB OTG SD/MMC1 CAN Touch screen controller EMAC SATA HDMI LVDS0 NAND RTC I2C SPI Video Input (MIPI) PCIe ConfigID Splash screen (U-Boot) [1] SPL boot[2]	SPI NOR Flash (boot) UART debug (2-wire) USB Host USB OTG SD/MMC1 CAN Touch screen controller EMAC SATA HDMI LVDS0 NAND RTC I2C SPI Video Input (MIPI) PCIe ConfigID Splash screen (U-Boot) [1] SPL boot[2]	SPI NOR Flash (boot) UART debug (2-wire) USB Host USB OTG SD/MMC1 CAN Touch screen controller EMAC SATA HDMI LVDS0 NAND RTC I2C SPI Video Input (MIPI) PCIe ConfigID Splash screen (U-Boot) [1] SPL boot[2]
NXP/Freescale BSP version	L3.0.35-4.1.0	L3.0.35-4.1.0	L3.0.35-4.1.0	L3.10.17-1.0.0	L3.10.17-1.0.0	L3.10.17-1.0.3	L3.10.17-1.0.3	L4.1.15-2.0.0	L4.1.15-2.0.0	L4.9.11_1.0.0	L4.9.11_1.0.0	imx_4.14.98_2.0.0_ga
Graphic libraries	Qt 4.8	Qt 4.8	Qt 4.8	Qt 5.3.2	Qt 5.3.2	Qt 5.3.2	Qt 5.3.2	Qt 5.6.2	Qt 5.6.2	Qt 5.9.8	Qt 5.9.8	Qt 5.12.4
Build System	LTIB	LTIB	LTIB	Yocto Dora (1.5)	Yocto Dora (1.5)	Yocto Dora (1.5)	Yocto Dora (1.5)	Yocto Krogoth (2.1)	Yocto Krogoth (2.1)	Yocto Morty (2.2)	Yocto Morty (2.2)	Yocto Sumo (2.5)
Android							Kitkat 4.4.2	Marshmallow 6.0.1	Marshmallow 6.0.1

[1] Splashscreen on LVDS0

[2] U-Boot SPL version

Downloadable binary images

All binary images for XELK are hosted on DAVE Embedded System mirror server. There you can find a sub directory for each version of this development kit.

A summary of images with a brief description can be found into the table below:

In order to boot Linux from SD card files, the binary files must be renamed as follows: bootscript: boot.scr U-boot file u-boot.imx must be stored into first raw sector of the SD card using dd command

Since XELK-3.5.0 U-boot performs 2-stage bootloader providing two files: SPL and u-boot.img. Both two files must be stored into SD card using dd command

Image	XELK version 2.3.1
Platform	XELK rev.A	SBCX rev.A	SBCX rev.A	SBCX rev.B	SBCX rev.B
Carrier Board ConfigID	0001	0002	0003	0012	0013
LCD panel	Ampire 800 x 480 7" LVDS 262K colors (RGB666) (AM-800480STMQW-TA1 or AM-800480SETMQW-TA1H)
Touchscreen	resistive	resistive	capacitive	resistive	capacitive
bootscript	boot.scr	boot.scr
U-Boot	u-boot (Quad - boot from NOR)	u-boot (DualLite - boot from NAND)
Linux kernel	uImage
Linux kernel (Android 4.4.2)	uImage
Device tree (Quad processor)	imx6q-xelk-l.dtb	imx6q-sbcx-cb0002.dtb	Not available	imx6q-sbcx-cb0012.dtb	Not available
Device tree (DualLite processor)	imx6dl-xelk-l.dtb	imx6dl-sbcx-cb0002.dtb	imx6dl-sbcx-cb0003.dtb	imx6dl-sbcx-cb0012.dtb	imx6dl-sbcx-cb0013.dtb

Image	XELK version 3.0.1
Platform	XELK rev.A	SBCX rev.B	SBCX rev.B
Carrier Board ConfigID	0001	0012	0013
LCD panel	Ampire 800 x 480 7" LVDS 262K colors (RGB666) (AM-800480STMQW-TA1 or AM-800480SETMQW-TA1H)
Touchscreen	resistive	resistive	capacitive
bootscript	boot.scr	boot.scr
U-Boot	u-boot (Quad - boot from NOR)	u-boot (DualLite - boot from NAND)
Linux kernel	uImage
Device tree (Quad processor)	imx6q-xelk-l.dtb	imx6q-sbcx-cb0012.dtb	imx6q-sbcx-cb0013.dtb
Device tree (DualLite processor)	imx6dl-xelk-l.dtb	imx6dl-sbcx-cb0012.dtb	imx6dl-sbcx-cb0013.dtb

Image	XELK version 3.5.0 (QUAD/DUAL LITE)
Platform	XELK / SBCX
U-Boot SPL	SPL (boot from NOR)	SPL (boot from NAND)
U-Boot img	img (boot from NOR)	img (boot from NAND)

Image	XELK version 4.0.0
Platform	XELK rev.A	SBCX rev.B	SBCX rev.B
Carrier Board ConfigID	0001	0012	0013
LCD panel	Ampire 800 x 480 7" LVDS 262K colors (RGB666) (AM-800480STMQW-TA1 or AM-800480SETMQW-TA1H)
Touchscreen	resistive	resistive	capacitive
bootscript	boot.scr	boot.scr
U-Boot SPL	SPL (Quad - boot from NOR)	SPL (DualLite - boot from NAND)
U-Boot	img (Quad - boot from NOR)	img (DualLite - boot from NAND)
Linux kernel	uImage
Device tree (Quad processor)	imx6q-xelk-l-2.0.0.dtb	imx6q-sbcx-cb0012.dtb	imx6q-sbcx-cb0013.dtb
Device tree (DualLite processor)	imx6dl-xelk-l.dtb	imx6dl-sbcx-cb0012.dtb	imx6dl-sbcx-cb0013.dtb

XELK microSD Layout

The microSD provided with XELK is used to store:

• A bootable partition (mmcblk0p1, vfat) containing:
  • binary images (u-boot and kernel images)
  • XELK documentation
  • XELK DVDK virtual machine image
• XELK root file system partition (mmcblk0p2, ext3)

XELK contains all the required software and documentation to start developing Linux application on the Axel platform. In particular, XELK provides a virtual machine, called DVDK, with the following features:

• VirtualBox virtual machine (.OVA archive)
• Based on Lubuntu 14.04 LTS (64-bit version)
• Pre-installed VirtualBox Guest Additions
• LXDE desktop environment
• Boot disk with the distro and pre-configured basic Linux services:
  • TFTP: with base directory /srv/tftp/
  • NFS: configured through the /etc/exports file
• Secondary disk containing source code and tools:
  • Bootloader (u-boot) source tree cloned from DAVE Embedded Systems public git repository
  • Linux kernel source tree cloned from DAVE Embedded Systems public git repository
  • External pre-built toolchain
  • Yocto bsp for AXEL
• Pre-installed Yocto-based root file systems with setup scripts, makefiles, example applications, ...
• Administrator account (dvdk) with autologin. Please note that the user account credentials are provided with the development kit (you can find them into the README file contained in the sw/dvdk folder of the kit distribution)

Please note that XELK u-boot and kernel source trees are derived from the official trees released by NXP/Freescale; these trees have been customized to add support for the Axel SOM.

XELK Updates

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

Updating git repositories

In XELK, the following source trees are clones of the correspondent DAVE Embedded Systems git repositories:

Component	GIT Remote
U-Boot	git@git.dave.eu:dave/axel/u-boot-imx.git
Linux kernel	git@git.dave.eu:dave/axel/linux-2.6-imx.git
Yocto BSP	git@git.dave.eu:dave/axel/axel-bsp.git

For more information about the access to these repositories, please refer to this link.

Access to DAVE Embedded Systems' git repositories is granted to development kit's owners only. Please refer to this page for detailed instructions on how to get access.

Synchronizing the repository

The components listed in the table above can be kept in sync and up to date with DAVE Embedded Systems' repositories.

Once the git account has been enabled, the developer can:

• clone the repository with the git clone <git_remote_repository> command
• synchronize a source tree entering the repository directory and launching the git fetch origin command.

Please note that git fetch doesn't merge the commits on the current branch. To do that, the developer 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 the official Git Documentation (http://git-scm.com

Release types

XELK release type can be:

• Major, when substantial changes are applied to the BSP (eg: major kernel version upgrades) or to the development kit (eg: new features, build system updates, ..). This usually means that a new DVDK is created for the XELK release
• Maintenance, when minor updates and bug fixes are introduced. This usually means that the DVDK remains the same provided with the previous major version, and only an update of the source tree repositories (and the tftp binaries) is required

As an example, XELK 2.2.0 is a maintenance release, so it provides the DVDK released with the 2.0.0 major release; customers can easily upgrade to the 2.2.0 release by updating the software components as described in XELK Updates.

Release notes

After the XELK DVDK installation, please check for updates of the source tree repositories provided with the kit, as described in XELK Updates.

XELK 4.1.0

New MVM must be installed for using XELK-4.0.0. The VM is available for download on DAVE's XELK Reserved Area for registered users.

Release notes:

• Updated Yocto targets recipes: added X11, browser, Qt5 Wayland root file system images

XELK 4.0.0

New MVM must be installed for using XELK-4.0.0. The VM is available for download on DAVE's XELK Reserved Area for registered users.

Release notes:

• Major change to NXP BSP 4.9.11
• Updated u-boot and kernel versions
• Updated Yocto version
• Updated Qt version

Known Limitations

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

Issue	Description
NAND Samsung	NAND Model K9F4G08U0D not detected in u-boot
Linux kernel xconfig	make xconfig does not work
Wayland not supported	Yocto QT5 images with Wayland backend is not yet supported

XELK 3.5.0

NXP iMX6 silicon revision 1.4 limited the u-boot binary size (due to bug fix in bootrom code). This required the switch to u-boot SPL version (first and second stage).

Release notes:

• Major change to u-boot SPL version
• Updated u-boot version

XELK 3.0.1

New MVM must be installed for using XELK-3.0.1. The VM is available for download on DAVE's XELK Reserved Area for registered users.

Release notes:

• Major change to NXP BSP 4.1.15
• Updated u-boot and kernel versions
• Updated Yocto version
• Updated Qt version

XELK older releases

For XELK older unsupported releases information, please click on Expand here below (on the right)

XELK 2.3.1

It's highly recommended to read the ConfigID and UniqueID page.

Release notes:

• Added support for other ConfigID splash screen on u-boot
• Added support for other ConfigID on linux with related device-tree source code and binaries
• Bug fixes and minor changes

XELK 2.2.0

It's highly recommended to read the ConfigID and UniqueID page.

• Added splash screen support in U-Boot
• Added support for SBCX carrier board
• Updated u-boot and kernel versions
• Bug fixes and minor changes

Known Limitations

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

Issue	Description
USB OTG	Verified in Host and Device modes
Reboot from software (not on SBC AXEL)	Rebooting the system from software (eg: launching the reboot command from Linux user space) can lead to a system lock. To solve it, reset the board with the dedicated button (S10). SBC AXEL is not affected by this issue.
Ethernet	10 Mbps connections have not been tested

XELK 2.1.0

It's highly recommended to read the ConfigID and UniqueID page.

• Updated u-boot and kernel versions
• Bug fixes and minor changes

Known Limitations

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

Issue	Description
USB OTG	Verified in Host and Device modes
Reboot from software	Rebooting the system from software (eg: launching the reboot command from Linux user space) can lead to a system lock. To solve it, reset the board with the dedicated button (S10)
Ethernet	10 Mbps connections have not been tested

XELK 2.0.0

• Added support for Yocto 1.5
• Updated u-boot and kernel versions
• Bug fixes and minor changes

Known Limitations

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

Issue	Description
ETH0 interface	On AxelEVB-Lite, there is a mistake in the connection of the center tap pins. They should be separated from one another and connected through separate 0.1μF common-mode capacitors to ground (for further details (eg: connection and selection of the magnetics), please refer to the Micrel KSZ9031RNX datasheet).
USB OTG	Verified in Host and Device modes
Reboot from software	Rebooting the system from software (eg: launching the reboot command from Linux user space) can lead to a system lock. To solve it, reset the board with the dedicated button (S10)
Ethernet	10 Mbps connections have not been tested

XELK 1.2.0

• Added support for Axel Lite SOM
• Bug fixes and minor changes

Known Limitations

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

Issue	Description
USB OTG	Verified in Host and Device modes
SD1	SD1 interface (available on the Axel Lite adapter board as microSD connector) detects the card only if it is inserted before booting Linux
Reboot from software	Rebooting the system from software (eg: launching the reboot command from Linux user space) can lead to a system lock. To solve it, reset the board with the dedicated button (S10)
Ethernet	10 Mbps connections have not been tested

XELK 1.1.0

• Minor update that adds support for more peripherals: nand, rtc, i2c, spi
• Touch screen works properly
• CAN works @ 1Mbps
• The system can boot from SD

Known Limitations

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

Issue	Description
Boot modes	This kit version supports boot from USB (for recovery purpose), from SPI nor flash and from SD card. Boot from NAND flash will be available on a future release.
CPU cores	Max 2 cores. 3rd and 4th cores will be available on a future release.
USB OTG	Verified in Host and Device modes
Reboot from software	Rebooting the system from software (eg: launching the reboot command from Linux user space) can lead to a system lock. To solve it, reset the board with the dedicated button (S10)
Ethernet	Verified speeds: 1 Gbps and 100 Mbps

XELK 1.0.0

• First official release

Known Limitations

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

Issue	Description
Boot modes	This kit version supports boot from USB (for recovery purpose) and from SPI nor flash. Other boot devices (MicroSD, NAND flash, ..) will be available on a future release.
CPU cores	Max 2 cores. 3rd and 4th cores will be available on a future release.
USB OTG	Verified in Host and Device modes
Reboot from software	Rebooting the system from software (eg: launching the reboot command from Linux user space) can lead to a system lock. To solve it, reset the board with the dedicated button (S10)
Ethernet	Verified speeds: 1 Gbps and 100 Mbps
CAN	Maximum supported speed: 500 kbps
Touch controller	Touch events are detected, but touch point is not resolved with precision

Quick start guide

This chapter describes how to quickly start working with the XELK kit. The following paragraphs will guide you through the setup and installation procedures.

Kit registration

Customers are strongly recommended to register their kits. Registration grants access to reserved material such as source code and additional documentation.

To register the kit, please send an email to support-axel@dave.eu, providing the kit P/N and S/N.

If you also wish to access git repositories containing source code, please follow the procedure described here.

Target setup and first boot

This section describes how to quick start the AxelEVB board delivered along with XELK kit (see also the following image). The hardware setup is the same for AxelUltra and AxelLite SOMs.

The picture below shows the AxelLite SOM inserted into the AxelEVB: please note the first HW release of AxelEVB-Lite

Axel Lite SOM / (first) AxelEVB setup

The picture below shows the AxelUltra SOM inserted into the AxelEVB: please note the new HW release of AxelEVB-Lite

Axel Ultra SOM / (latest) AxelEVB setup

The microSD provided with the XELK can be used to boot the system, since it contains a bootable partition (mmcblk0p1) and a root file system partition (mmcblk0p2).

1. Insert the MicroSD card provided with the development kit into the microSD slot
2. Connect the 12V power supply to the JP2 socket on the DACU board
3. (optional) To access the serial console:
   • Connect a serial cable, using a null-modem cable (https://en.wikipedia.org/wiki/Null_modem) not provided, between
     • the J251 connector on the DACU board and PC COM port - for the latest AxelEVB-Lite HW version (see picture above)
     • the J28 connector on the AxelEVB-Lite and PC COM port - for the first AxelEVB-Lite HW version (see picture above)
   • Start your favorite terminal software on hist side; communication parameters are:
     • Baud rate: 115200 Bps
     • Data bits: 8
     • Stop bits: 1
     • Parity: none
4. (optional) To connect the system to Ethernet LAN, please plug cable on connector J6 connector of the AXELEVB-Lite

By default, the system is configured to boot automatically from the microSD card when powered up.

Binary images on SD card

The XELK bootable microSD card delivered along with the kit is set up to do a full bootstrap sequence. For more details, please refer to this section.

Once you got the new binaries compiled from your modified sources, they have to be installed on first SD partition preserving the original file names used into boot.scr u-boot bootscript.

Otherwise, you may create a new boot.scr file using different file names. Here below there is an example on how to create a boot.scr file for booting from SD card:

The bootscript.txt is the text version of the boot.scr file:

echo 'bootscript generated with command "mkimage -A ARM -T script -C none -n XELK -d bootscript.txt boot.scr"'

setenv fdtfile imx6q-xelk-l.dtb
setenv bootfile uImage

setenv mmc_loadk 'fatload mmc ${mmcdev}:1 ${loadaddr} ${bootfile}'
setenv mmc_loadfdt 'fatload mmc ${mmcdev}:1 ${fdtaddr} ${fdtfile}'
setenv mmcboot 'run mmc_loadk mmc_loadfdt mmcargs addip addcons addmisc adddisp0; bootm ${loadaddr} - ${fdtaddr}'

echo Booting AxelLite-XELK via mmcboot

run mmcboot

echo mmcboot FAILURE

and compile it using:

mkimage -A ARM -T script -C none -n XELK -d bootscript.txt boot.scr

Then copy the kernel, dtb and boot.scr into the SD card first partion (the FAT one) and boot XELK with the new images.

Host setup

As stated previously, XELK host tools are based on a Managed Virtual Machine. As indicated here, microSD card delivered along with XELK includes basic version of MVM that is the default option.

Please follows the README file on the SD card to extract the *.ova archive and to install the MVM.

It is also worth remembering that access to git repositories is required to download target source code. To enable it, please refer to this page.

The MVM provides the tools required to build U-boot and Linux kernel. It does not include the tools required to run Yocto build system instead.

XELK MVM can be downloaded here. For accessing XELK Reserved area please contact our sales department

Target configuration for the development stage (net_nfs)

The default XELK Virtual Machine network configuration is using NAT: this allows to accessing external network (i.e. Internet) using the host computer's networking connection. For software development using net_nfs with tftp/nfs protocols, please configure your VM network interface in Bridge mode (see below)

During the development stage, the target is usually connected via Ethernet LAN to the host machine and is configured to:

• retrieve binary images (i.e. Linux kernel) via TFTP protocol
• mount the development root file system via NFS protocol. This root file system is physically in the file system of the host machine as depicted here. An example of Bridge mode configuration for DIVELK can be found here

In DAVE Embedded Systems development kits, this configuration is generally denoted as net_nfs. U-Boot bootloader supports this configuration. Some U-Boot environment variables are needed to set it up. They are detailed here.

For more details about TFTP and NFS servers on host side, please refer to this page.

Target configuration for standalone boot

Please refer to this page.

Related Documents

• AXEL ULTRA
• AXEL LITE
• AxelEVB-Lite
• Axel FAQs
• Axel Ultra Hardware Manual
• Axel Lite Hardware Manual
• Dacu category page
• Dacu carrier board
• Dacu for the Axel SOM