Difference between revisions of "Axel Embedded Linux Kit (XELK)"

From DAVE Developer's Wiki
Jump to: navigation, search
(Updating git repositories)
m (XELK software components)
(106 intermediate revisions by 10 users not shown)
Line 7: Line 7:
  
 
==Introduction==
 
==Introduction==
{{ImportantMessage|text='''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 [mailto:support-axel@dave.eu support-axel@dave.eu], [[Development_Kits_Identification_Codes|providing the kit P/N and S/N]].}}
 
  
 
[[File:Axel-on-evb-02.png|500px]]
 
[[File:Axel-on-evb-02.png|500px]]
Line 39: Line 36:
 
!Notes
 
!Notes
 
|-
 
|-
| style="text-align: center;" | [[File:Axel-01.png|60px]]
+
|style="text-align: center;" | [[File:Axel-01.png|60px]]
|Axel Ultra SOM<br>CPU: Freescale i.MX6<br>SDRAM: 2 GB DDR3<br>NOR: bootable SPI flash 32 MB<br>NAND: 1GB
+
|Axel Ultra SOM (or Axel Lite SOM) <br>CPU: Freescale i.MX6<br>SDRAM: 2 GB DDR3<br>NOR: bootable SPI flash 32 MB<br>NAND: 1GB
 
|Please refer to [[Hardware Manual (AxelUltra) | Axel Ultra Hardware Manual]]
 
|Please refer to [[Hardware Manual (AxelUltra) | Axel Ultra Hardware Manual]]
 
|-
 
|-
| style="text-align: center;" | [[File:AxelLite-SOM.jpg|80px]]
+
|style="text-align: center;" | [[File:Axelevb-lite-01.png|60px]]
|Axel Lite SOM<br>CPU: Freescale i.MX6<br>SDRAM: 2 GB DDR3<br>NOR: bootable SPI flash 32 MB<br>NAND: 1GB
 
|Please refer to [[Hardware Manual (AxelLite) | Axel Lite Hardware Manual]]
 
|-
 
| style="text-align: center;" | [[File:Axelevb-lite-01.png|60px]]
 
 
|AxelEVB-Lite Carrier board
 
|AxelEVB-Lite Carrier board
 
|Please refer to [[AxelEVB-Lite | AxelEVB-Lite]] page
 
|Please refer to [[AxelEVB-Lite | AxelEVB-Lite]] page
 
|-
 
|-
| style="text-align: center;" | [[File:Dacu-top-view.png|80px]]
+
|style="text-align: center;" | [[File:Dacu-top-view.png|80px]]
 
|Dacu Carrier board
 
|Dacu Carrier board
 
|Please refer to [[Dacu | Dacu]] page
 
|Please refer to [[Dacu | Dacu]] page
 
|-
 
|-
| style="text-align: center;" | [[File:Display.jpg|60px]]
+
|style="text-align: center;" | [[File:Display.jpg|60px]]
 
|Ampire AM-800480STMQW<br>7” 800x480 LCD display<br>LVDS interface
 
|Ampire AM-800480STMQW<br>7” 800x480 LCD display<br>LVDS interface
 
|Please refer to [[XELK Quick Start Guide]]
 
|Please refer to [[XELK Quick Start Guide]]
 
|-
 
|-
| style="text-align: center;" | [[File:Alimentatore.jpg|40px]]
+
|style="text-align: center;" | [[File:Alimentatore.jpg|40px]]
 
|AC/DC Single Output Wall Mount adapter<br>Output: +12V – 2.0 A
 
|AC/DC Single Output Wall Mount adapter<br>Output: +12V – 2.0 A
 
|Please refer to [[XELK Quick Start Guide]]
 
|Please refer to [[XELK Quick Start Guide]]
 
|-
 
|-
| style="text-align: center;" | [[File:Cavetto-seriale2.jpg|50px]]
+
|style="text-align: center;" | [[File:Cavetto-seriale2.jpg|50px]]
 
|DB9 Male Serial port adapter
 
|DB9 Male Serial port adapter
 
|Please refer to [[XELK Quick Start Guide]]
 
|Please refer to [[XELK Quick Start Guide]]
 
|-
 
|-
| style="text-align: center;" | [[File:ProdSDC-MBLY-thumb.png|50px]]
+
|style="text-align: center;" | [[File:ProdSDC-MBLY-thumb.png|50px]]
 
|MicroSDHC card with SD adapter and USB adapter
 
|MicroSDHC card with SD adapter and USB adapter
 
|Please refer to [[XELK Quick Start Guide]]
 
|Please refer to [[XELK Quick Start Guide]]
Line 75: Line 68:
 
== XELK software components ==
 
== 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.
+
'''DAVE Embedded Systems''' adds to the latest Linux BSP from Freescale the customization required to support the Axel platform. For this reason most of the documentation provided by 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.
 
The following table reports the XELK releases information.
 
{| class="wikitable"  
 
{| class="wikitable"  
 
!
 
!
! colspan="12" | XELK version
+
!colspan="5" | XELK version
 
|-
 
|-
 
|Release number
 
|Release number
Line 88: Line 81:
 
|2.0.0
 
|2.0.0
 
|2.1.0
 
|2.1.0
|2.2.0
+
|3.0.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
 
|Status
Line 116: Line 89:
 
|Released
 
|Released
 
|Released
 
|Released
|Released
+
|Planned
|Released
 
|Released
 
|Released
 
|Released
 
|Released
 
|In progress
 
 
|-
 
|-
 
|Release date
 
|Release date
Line 130: Line 97:
 
|November 2014
 
|November 2014
 
|May 2015
 
|May 2015
|February 2016
+
|3Q 2015
|October 2016
 
|November 2017
 
|April 2019
 
|August 2019
 
|October 2019
 
|Q1 2020
 
 
|-
 
|-
 
|'''Release notes'''
 
|'''Release notes'''
|[[#XELK 1.0.0 | Ver 1.0.0]]
+
|[[Axel_Embedded_Linux_Kit_(XELK)#XELK 1.0.0 | Ver 1.0.0]]
|[[#XELK 1.1.0 | Ver 1.1.0]]
+
|[[Axel_Embedded_Linux_Kit_(XELK)#XELK 1.1.0 | Ver 1.1.0]]
|[[#XELK 1.2.0 | Ver 1.2.0]]
+
|[[Axel_Embedded_Linux_Kit_(XELK)#XELK 1.2.0 | Ver 1.2.0]]
|[[#XELK 2.0.0 | Ver 2.0.0]]
+
|[[Axel_Embedded_Linux_Kit_(XELK)#XELK 2.0.0 | Ver 2.0.0]]
|[[#XELK 2.1.0 | Ver 2.1.0]]
+
|[[Axel_Embedded_Linux_Kit_(XELK)#XELK 2.1.0 | Ver 2.1.0]]
|[[#XELK 2.2.0 | Ver 2.2.0]]
+
| -
|[[#XELK 2.3.1 | Ver 2.3.1]]
 
|[[#XELK 3.0.1 | Ver 3.0.1]]
 
|[[#XELK 3.5.0 | Ver 3.5.0]]
 
|[[#XELK 4.0.0 | Ver 4.0.0]]
 
|[[#XELK 4.1.0 | Ver 4.1.0]]
 
|[[#XELK 5.0.0 | Ver 5.0.0]]
 
 
|-
 
|-
 
|SOM PCB version
 
|SOM PCB version
Line 156: Line 111:
 
|Axel Ultra: CS030713A
 
|Axel Ultra: CS030713A
 
|Axel Ultra: CS030713A<br>Axel Lite: CS335013A
 
|Axel Ultra: CS030713A<br>Axel Lite: CS335013A
|Axel Ultra: CS030713A<br>Axel Lite: CS335013A
+
|Axel Ultra: CS030713A<br>Axel Lite: CS335013B
|Axel Ultra: CS030713B<br>Axel Lite: CS335013A
+
|Axel Ultra: CS030713B<br>Axel Lite: CS335013B
|Axel Ultra: CS030713B<br>Axel Lite: CS335013A
+
|Axel Ultra: CS030713B<br>Axel Lite: CS335013B
|Axel Ultra: CS030713B<br>Axel Lite: CS335013A<br>Axel Lite: CS335013C
 
|Axel Lite: CS335013A<br>Axel Lite: CS335013C
 
|Axel Lite: CS335013A<br>Axel Lite: CS335013C
 
|Axel Lite: CS335013A<br>Axel Lite: CS335013C
 
|Axel Lite: CS335013A<br>Axel Lite: CS335013C
 
|Axel Lite: CS335013A<br>Axel Lite: CS335013C
 
 
|--
 
|--
 
|Supported carrier boards
 
|Supported carrier boards
|<span class="plainlinks">[{{fullurl:AxelEVB-Lite|oldid=2970}} AxelEVB-Lite]</span><br>[[:Category:Dacu | Dacu]]
+
|[[AxelEVB-Lite]]<br>[[:Category:Dacu | Dacu]]
|{{pageoldid|AxelEVB-Lite|2970}}<br>[[:Category:Dacu | Dacu]]
+
|[[AxelEVB-Lite]]<br>[[:Category:Dacu | Dacu]]
|{{pageoldid|AxelEVB-Lite|2970}}<br>[[:Category:Dacu | Dacu]]
+
|[[AxelEVB-Lite]]<br>[[:Category:Dacu | Dacu]]
|{{pageoldid|AxelEVB-Lite|2970}}<br>[[:Category:Dacu | Dacu]]
+
|[[AxelEVB-Lite]]<br>[[:Category:Dacu | Dacu]]
|{{pageoldid|AxelEVB-Lite|2970}}<br>[[AxelEVB-Lite|AxelEVB-Lite rev.A]]<br>[[:Category:Dacu | Dacu]]
+
|[[AxelEVB-Lite]]<br>[[:Category:Dacu | Dacu]]
|{{pageoldid|AxelEVB-Lite|2970}}<br>[[AxelEVB-Lite|AxelEVB-Lite rev.A]]<br>[[:Category:Dacu | Dacu]]<br>[[:Category:SBC-AXEL | SBCX]]
+
|[[AxelEVB-Lite]]<br>[[:Category:Dacu | Dacu]]
|{{pageoldid|AxelEVB-Lite|2970}}<br>[[AxelEVB-Lite|AxelEVB-Lite rev.A]]<br>[[:Category:Dacu | Dacu]]<br>[[:Category:SBC-AXEL | SBCX]]
 
|{{pageoldid|AxelEVB-Lite|2970}}<br>[[AxelEVB-Lite|AxelEVB-Lite rev.A]]<br>[[:Category:Dacu | Dacu]]<br>[[:Category:SBC-AXEL | SBCX]]
 
|{{pageoldid|AxelEVB-Lite|2970}}<br>[[AxelEVB-Lite|AxelEVB-Lite rev.A]]<br>[[:Category:Dacu | Dacu]]<br>[[:Category:SBC-AXEL | SBCX]]
 
|{{pageoldid|AxelEVB-Lite|2970}}<br>[[AxelEVB-Lite|AxelEVB-Lite rev.A]]<br>[[:Category:Dacu | Dacu]]<br>[[:Category:SBC-AXEL | SBCX]]
 
|{{pageoldid|AxelEVB-Lite|2970}}<br>[[AxelEVB-Lite|AxelEVB-Lite rev.A]]<br>[[:Category:Dacu | Dacu]]<br>[[:Category:SBC-AXEL | SBCX]]
 
|{{pageoldid|AxelEVB-Lite|2970}}<br>[[AxelEVB-Lite|AxelEVB-Lite rev.A]]<br>[[:Category:Dacu | Dacu]]<br>[[:Category:SBC-AXEL | SBCX]]
 
 
|-
 
|-
 
|U-Boot version
 
|U-Boot version
Line 186: Line 129:
 
|2013.04-xelk-2.0.0
 
|2013.04-xelk-2.0.0
 
|2013.04-xelk-2.1.0
 
|2013.04-xelk-2.1.0
|2013.04-xelk-2.2.0
+
|2014.04-xelk-3.0.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
 
|Linux version
Line 200: Line 137:
 
|3.10.17-xelk-2.0.0
 
|3.10.17-xelk-2.0.0
 
|3.10.17-xelk-2.1.0
 
|3.10.17-xelk-2.1.0
|3.10.17-xelk-2.2.0
+
|3.14.28-xelk-3.0.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
 
|Drivers
| valign="top" | SPI NOR Flash (boot)<br>UART debug (2-wire)<br>USB Host<br>USB OTG<br>SD/MMC1<br>CAN<br>Touch screen controller<br>EMAC<br>SATA<br>HDMI<br>LVDS0
+
|valign="top" | SPI NOR Flash (boot)<br>UART debug (2-wire)<br>USB Host<br>USB OTG<br>SD/MMC1<br>CAN<br>Touch screen controller<br>EMAC<br>SATA<br>HMDI<br>LVDS1
| valign="top" | SPI NOR Flash (boot)<br>UART debug (2-wire)<br>USB Host<br>USB OTG<br>SD/MMC1<br>CAN<br>Touch screen controller<br>EMAC<br>SATA<br>HDMI<br>LVDS0<br>NAND<br>RTC<br>I2C<br>SPI
+
|valign="top" | SPI NOR Flash (boot)<br>UART debug (2-wire)<br>USB Host<br>USB OTG<br>SD/MMC1<br>CAN<br>Touch screen controller<br>EMAC<br>SATA<br>HMDI<br>LVDS1<br>NAND<br>RTC<br>I2C<br>SPI
| valign="top" | SPI NOR Flash (boot)<br>UART debug (2-wire)<br>USB Host<br>USB OTG<br>SD/MMC1<br>CAN<br>Touch screen controller<br>EMAC<br>SATA<br>HDMI<br>LVDS0<br>NAND<br>RTC<br>I2C<br>SPI
+
|valign="top" | SPI NOR Flash (boot)<br>UART debug (2-wire)<br>USB Host<br>USB OTG<br>SD/MMC1<br>CAN<br>Touch screen controller<br>EMAC<br>SATA<br>HMDI<br>LVDS1<br>NAND<br>RTC<br>I2C<br>SPI
| valign="top" | SPI NOR Flash (boot)<br>UART debug (2-wire)<br>USB Host<br>USB OTG<br>SD/MMC1<br>CAN<br>Touch screen controller<br>EMAC<br>SATA<br>HDMI<br>LVDS0<br>NAND<br>RTC<br>I2C<br>SPI<br>Video Input (MIPI)
+
|valign="top" | SPI NOR Flash (boot)<br>UART debug (2-wire)<br>USB Host<br>USB OTG<br>SD/MMC1<br>CAN<br>Touch screen controller<br>EMAC<br>SATA<br>HMDI<br>LVDS1<br>NAND<br>RTC<br>I2C<br>SPI<br>Video Input (MIPI)
| valign="top" | SPI NOR Flash (boot)<br>UART debug (2-wire)<br>USB Host<br>USB OTG<br>SD/MMC1<br>CAN<br>Touch screen controller<br>EMAC<br>SATA<br>HDMI<br>LVDS0<br>NAND<br>RTC<br>I2C<br>SPI<br>Video Input (MIPI)<br>PCIe<br>[[ConfigID_and_UniqueID | ConfigID]]
+
|valign="top" | SPI NOR Flash (boot)<br>UART debug (2-wire)<br>USB Host<br>USB OTG<br>SD/MMC1<br>CAN<br>Touch screen controller<br>EMAC<br>SATA<br>HMDI<br>LVDS1<br>NAND<br>RTC<br>I2C<br>SPI<br>Video Input (MIPI)<br>PCIe<br>[[ConfigID_and_UniqueID | ConfigID]]
| valign="top" | SPI NOR Flash (boot)<br>UART debug (2-wire)<br>USB Host<br>USB OTG<br>SD/MMC1<br>CAN<br>Touch screen controller<br>EMAC<br>SATA<br>HDMI<br>LVDS0<br>NAND<br>RTC<br>I2C<br>SPI<br>Video Input (MIPI)<br>PCIe<br>[[ConfigID_and_UniqueID | ConfigID]]<br>Splash screen (U-Boot) [1]
+
|valign="top" | SPI NOR Flash (boot)<br>UART debug (2-wire)<br>USB Host<br>USB OTG<br>SD/MMC1<br>CAN<br>Touch screen controller<br>EMAC<br>SATA<br>HMDI<br>LVDS1<br>NAND<br>RTC<br>I2C<br>SPI<br>Video Input (MIPI)<br>PCIe<br>[[ConfigID_and_UniqueID | ConfigID]]
| valign="top" | SPI NOR Flash (boot)<br>UART debug (2-wire)<br>USB Host<br>USB OTG<br>SD/MMC1<br>CAN<br>Touch screen controller<br>EMAC<br>SATA<br>HDMI<br>LVDS0<br>NAND<br>RTC<br>I2C<br>SPI<br>Video Input (MIPI)<br>PCIe<br>[[ConfigID_and_UniqueID | ConfigID]]<br>Splash screen (U-Boot) [1]
 
| valign="top" | SPI NOR Flash (boot)<br>UART debug (2-wire)<br>USB Host<br>USB OTG<br>SD/MMC1<br>CAN<br>Touch screen controller<br>EMAC<br>SATA<br>HDMI<br>LVDS0<br>NAND<br>RTC<br>I2C<br>SPI<br>Video Input (MIPI)<br>PCIe<br>[[ConfigID_and_UniqueID | ConfigID]]<br>Splash screen (U-Boot) [1]
 
| valign="top" | SPI NOR Flash (boot)<br>UART debug (2-wire)<br>USB Host<br>USB OTG<br>SD/MMC1<br>CAN<br>Touch screen controller<br>EMAC<br>SATA<br>HDMI<br>LVDS0<br>NAND<br>RTC<br>I2C<br>SPI<br>Video Input (MIPI)<br>PCIe<br>[[ConfigID_and_UniqueID | ConfigID]]<br>Splash screen (U-Boot) [1]<br>SPL boot[2]
 
| valign="top" | SPI NOR Flash (boot)<br>UART debug (2-wire)<br>USB Host<br>USB OTG<br>SD/MMC1<br>CAN<br>Touch screen controller<br>EMAC<br>SATA<br>HDMI<br>LVDS0<br>NAND<br>RTC<br>I2C<br>SPI<br>Video Input (MIPI)<br>PCIe<br>[[ConfigID_and_UniqueID | ConfigID]]<br>Splash screen (U-Boot) [1]<br>SPL boot[2]
 
| valign="top" | SPI NOR Flash (boot)<br>UART debug (2-wire)<br>USB Host<br>USB OTG<br>SD/MMC1<br>CAN<br>Touch screen controller<br>EMAC<br>SATA<br>HDMI<br>LVDS0<br>NAND<br>RTC<br>I2C<br>SPI<br>Video Input (MIPI)<br>PCIe<br>[[ConfigID_and_UniqueID | ConfigID]]<br>Splash screen (U-Boot) [1]<br>SPL boot[2]
 
| valign="top" | SPI NOR Flash (boot)<br>UART debug (2-wire)<br>USB Host<br>USB OTG<br>SD/MMC1<br>CAN<br>Touch screen controller<br>EMAC<br>SATA<br>HDMI<br>LVDS0<br>NAND<br>RTC<br>I2C<br>SPI<br>Video Input (MIPI)<br>PCIe<br>[[ConfigID_and_UniqueID | ConfigID]]<br>Splash screen (U-Boot) [1]<br>SPL boot[2]
 
 
|-
 
|-
|NXP/Freescale BSP version
+
|Freescale BSP version
 
|L3.0.35-4.1.0
 
|L3.0.35-4.1.0
 
|L3.0.35-4.1.0
 
|L3.0.35-4.1.0
Line 228: Line 153:
 
|L3.10.17-1.0.0
 
|L3.10.17-1.0.0
 
|L3.10.17-1.0.0
 
|L3.10.17-1.0.0
|L3.10.17-1.0.3
+
|L3.14.28-1-1.0
|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
 
|Graphic libraries
Line 242: Line 161:
 
|Qt 5.3.2
 
|Qt 5.3.2
 
|Qt 5.3.2
 
|Qt 5.3.2
|Qt 5.3.2
+
|Qt 5.x
|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
 
|Build System
Line 256: Line 169:
 
|Yocto Dora (1.5)  
 
|Yocto Dora (1.5)  
 
|Yocto Dora (1.5)  
 
|Yocto Dora (1.5)  
|Yocto Dora (1.5)
+
|Yocto Dizzy (1.7)  
|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 [[mirror:axel|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:
 
 
 
{{ImportantMessage|text=In order to boot Linux from SD card files, '''the binary files must be renamed''' as follows:
 
*bootscript: <code>boot.scr</code>
 
 
 
U-boot file <code>u-boot.imx</code> must be stored into first raw sector of the SD card using <code>dd</code> command}} 
 
 
 
{{ImportantMessage|text=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 <code>dd</code> command}} 
 
{| class="wikitable"
 
|-
 
! Image !! colspan="5" |XELK version 2.3.1
 
|-
 
| Platform || XELK rev.A || SBCX rev.A || SBCX rev.A || SBCX rev.B || SBCX rev.B
 
|-
 
| Carrier Board [[ConfigID_and_UniqueID | ConfigID]]|| 0001 || 0002 || 0003 || 0012 || 0013
 
|-
 
| LCD panel || colspan="5" style="text-align: center" | Ampire 800 x 480 7" LVDS 262K colors (RGB666)<br>(AM-800480STMQW-TA1 or AM-800480SETMQW-TA1H)
 
|-
 
| Touchscreen || colspan="1" | resistive || colspan="1" | resistive || colspan="1" | capacitive || colspan="1" | resistive || colspan="1" style="text-align: center" | capacitive
 
|-
 
| bootscript || colspan="1" style="text-align: center" |[[mirror:axel/xelk-2.3.1/xelk-2.3.1_boot.scr|boot.scr]] || colspan="4" style="text-align: center" |[[mirror:axel/xelk-2.3.1/xelk-2.3.1_sbcx_boot.scr|boot.scr]]
 
|-
 
| U-Boot || colspan="1" style="text-align: center" |[[mirror:axel/xelk-2.3.1/xelk-2.3.1_mx6qaxel_spi_u-boot.imx|u-boot (Quad - boot from NOR)]] || colspan="4" style="text-align: center" |[[mirror:axel/xelk-2.3.1/xelk-2.3.1_mx6dlaxel_nand_u-boot.imx|u-boot (DualLite - boot from NAND)]]
 
|-
 
| Linux kernel || colspan="5" style="text-align: center" |[[mirror:axel/xelk-2.3.1/xelk-2.3.1_uImage|uImage]]
 
|-
 
| Linux kernel<br>(Android 4.4.2) || colspan="5" style="text-align: center" |[[mirror:axel/xelk-2.3.1/xelk-2.3.0-andr_uImage|uImage]]
 
|-
 
| Device tree (Quad processor) || [[mirror:axel/xelk-2.3.1/xelk-2.3.1_imx6q-xelk-l.dtb|imx6q-xelk-l.dtb]] || [[mirror:axel/xelk-2.3.1/xelk-2.3.1_imx6q-sbcx.dtb|imx6q-sbcx-cb0002.dtb]] || Not available || [[mirror:axel/xelk-2.3.1/xelk-2.3.1_imx6q-sbcx-cb0012.dtb|imx6q-sbcx-cb0012.dtb]] || Not available
 
|-
 
| Device tree (DualLite processor) || [[mirror:axel/xelk-2.3.1/xelk-2.3.1_imx6dl-xelk-l.dtb|imx6dl-xelk-l.dtb]] || [[mirror:axel/xelk-2.3.1/xelk-2.3.1_imx6dl-sbcx.dtb|imx6dl-sbcx-cb0002.dtb]] || [[mirror:axel/xelk-2.3.1/xelk-2.3.1_imx6dl-sbcx-cb0003.dtb|imx6dl-sbcx-cb0003.dtb]] || [[mirror:axel/xelk-2.3.1/xelk-2.3.1_imx6dl-sbcx-cb0012.dtb|imx6dl-sbcx-cb0012.dtb]] || [[mirror:axel/xelk-2.3.1/xelk-2.3.1_imx6dl-sbcx-cb0013.dtb|imx6dl-sbcx-cb0013.dtb]]
 
|}
 
{| class="wikitable"
 
|-
 
! Image !! colspan="5" |XELK version 3.0.1
 
|-
 
| Platform || XELK rev.A || SBCX rev.B || SBCX rev.B
 
|-
 
| Carrier Board [[ConfigID_and_UniqueID | ConfigID]]|| 0001 || 0012 || 0013
 
|-
 
| LCD panel || colspan="5" style="text-align: center" | Ampire 800 x 480 7" LVDS 262K colors (RGB666)<br>(AM-800480STMQW-TA1 or AM-800480SETMQW-TA1H)
 
|-
 
| Touchscreen || colspan="1" | resistive || colspan="1" | resistive || colspan="1" style="text-align: center" | capacitive
 
|-
 
| bootscript || colspan="1" style="text-align: center" |[[mirror:axel/xelk-3.0.1/xelk-3.0.1_boot.scr|boot.scr]] || colspan="4" style="text-align: center" |[[mirror:axel/xelk-3.0.1/xelk-3.0.1_boot.scr|boot.scr]]
 
|-
 
| U-Boot || colspan="1" style="text-align: center" |[[mirror:axel/xelk-3.0.1/xelk-3.0.2_mx6qaxel_spi_u-boot.imx|u-boot (Quad - boot from NOR)]] || colspan="4" style="text-align: center" |[[mirror:axel/xelk-3.0.1/xelk-3.0.2_mx6dlaxel_nand_u-boot.imx|u-boot (DualLite - boot from NAND)]]
 
|-
 
| Linux kernel || colspan="5" style="text-align: center" |[[mirror:axel/xelk-3.0.1/xelk-3.0.0_uImage|uImage]]
 
|-
 
| Device tree (Quad processor) || [[mirror:axel/xelk-3.0.1/xelk-3.0.0_imx6q-xelk-l.dtb|imx6q-xelk-l.dtb]] || [[mirror:axel/xelk-3.0.1/xelk-3.0.0_imx6q-sbcx-cb0012.dtb|imx6q-sbcx-cb0012.dtb]] || [[mirror:axel/xelk-3.0.1/xelk-3.0.0_imx6q-sbcx-cb0013.dtb|imx6q-sbcx-cb0013.dtb]]
 
|-
 
| Device tree (DualLite processor) || [[mirror:axel/xelk-3.0.1/xelk-3.0.0_imx6dl-xelk-l.dtb|imx6dl-xelk-l.dtb]] || [[mirror:axel/xelk-3.0.1/xelk-3.0.0_imx6dl-sbcx-cb0012.dtb|imx6dl-sbcx-cb0012.dtb]] || [[mirror:axel/xelk-3.0.1/xelk-3.0.0_imx6dl-sbcx-cb0013.dtb|imx6dl-sbcx-cb0013.dtb]]
 
|}
 
 
 
{| class="wikitable"
 
|-
 
! Image !! colspan="3" |XELK version 3.5.0 (QUAD/DUAL LITE)
 
|-
 
| Platform || colspan="2" style="text-align: center" |XELK / SBCX
 
|-
 
| U-Boot SPL || colspan="1" style="text-align: center" |[[mirror:axel/xelk-3.5.0/xelk-3.5.0_mx6qdlaxel_spi_SPL|SPL (boot from NOR)]] || colspan="1" style="text-align: center" |[[mirror:axel/xelk-3.5.0/xelk-3.5.0_mx6qdlaxel_nand_SPL|SPL (boot from NAND)]]
 
|-
 
| U-Boot img || colspan="1" style="text-align: center" |[[mirror:axel/xelk-3.5.0/xelk-3.5.0_mx6qdlaxel_spi_u-boot.img| img (boot from NOR)]] || colspan="1" style="text-align: center" |[[mirror:axel/xelk-3.5.0/xelk-3.5.0_mx6qdlaxel_nand_u-boot.img|img (boot from NAND)]]
 
|}
 
 
 
{| class="wikitable"
 
|-
 
! Image !! colspan="5" |XELK version 4.0.0
 
|-
 
| Platform || XELK rev.A || SBCX rev.B || SBCX rev.B
 
|-
 
| Carrier Board [[ConfigID_and_UniqueID | ConfigID]]|| 0001 || 0012 || 0013
 
|-
 
| LCD panel || colspan="5" style="text-align: center" | Ampire 800 x 480 7" LVDS 262K colors (RGB666)<br>(AM-800480STMQW-TA1 or AM-800480SETMQW-TA1H)
 
|-
 
| Touchscreen || colspan="1" | resistive || colspan="1" | resistive || colspan="1" style="text-align: center" | capacitive
 
|-
 
| bootscript || colspan="1" style="text-align: center" |[[mirror:axel/xelk-4.0.0/boot.scr|boot.scr]] || colspan="4" style="text-align: center" |[[mirror:axel/xelk-4.0.0/boot.scr|boot.scr]]
 
|-
 
| U-Boot SPL || colspan="1" style="text-align: center" |[[mirror:axel/xelk-4.0.0/xelk-4.0.0_mx6qdlaxel_spi_SPL|SPL (Quad - boot from NOR)]] || colspan="4" style="text-align: center" |[[mirror:axel/xelk-4.0.0/xelk-4.0.0_mx6qdlaxel_nand_SPL|SPL (DualLite - boot from NAND)]]
 
|-
 
| U-Boot || colspan="1" style="text-align: center" |[[mirror:axel/xelk-4.0.0/xelk-4.0.0_mx6qdlaxel_spi_u-boot.img|img (Quad - boot from NOR)]] || colspan="4" style="text-align: center" |[[mirror:axel/xelk-4.0.0/xelk-4.0.0_mx6qdlaxel_nand_u-boot.img|img (DualLite - boot from NAND)]]
 
|-
 
| Linux kernel || colspan="5" style="text-align: center" |[[mirror:axel/xelk-4.0.0/xelk-4.0.0_uImage|uImage]]
 
|-
 
| Device tree (Quad processor) || [[mirror:axel/xelk-4.0.0/xelk-4.0.0_imx6q-xelk-l-2.0.0.dtb|imx6q-xelk-l-2.0.0.dtb]] || [[mirror:axel/xelk-4.0.0/xelk-4.0.0_imx6q-sbcx-cb0012.dtb|imx6q-sbcx-cb0012.dtb]] || [[mirror:axel/xelk-4.0.0/xelk-4.0.0_imx6q-sbcx-cb0013.dtb|imx6q-sbcx-cb0013.dtb]]
 
 
|-
 
|-
| Device tree (DualLite processor) || [[mirror:axel/xelk-4.0.0/xelk-4.0.0_imx6dl-xelk-l.dtb|imx6dl-xelk-l.dtb]] || [[mirror:axel/xelk-4.0.0/xelk-4.0.0_imx6dl-sbcx-cb0012.dtb|imx6dl-sbcx-cb0012.dtb]] || [[mirror:axel/xelk-4.0.0/xelk-4.0.0_imx6dl-sbcx-cb0013.dtb|imx6dl-sbcx-cb0013.dtb]]
 
 
|}
 
|}
  
Line 393: Line 185:
  
 
* VirtualBox virtual machine (.OVA archive)
 
* VirtualBox virtual machine (.OVA archive)
* Based on Lubuntu 14.04 LTS (64-bit version)
+
* Based on Lubuntu 12.04 LTS (64-bit version)
 
* Pre-installed VirtualBox Guest Additions
 
* Pre-installed VirtualBox Guest Additions
 
* LXDE desktop environment
 
* LXDE desktop environment
 
* Boot disk with the distro and pre-configured basic Linux services:
 
* Boot disk with the distro and pre-configured basic Linux services:
** TFTP: with base directory <code>/srv/tftp/</code>
+
** TFTP: with base directory /srv/tftp/
** NFS: configured through the <code>/etc/exports</code> file
+
** NFS: configured through the /etc/exports file
 
* Secondary disk containing source code and tools:
 
* Secondary disk containing source code and tools:
 
** Bootloader (u-boot) source tree cloned from DAVE Embedded Systems public git repository  
 
** Bootloader (u-boot) source tree cloned from DAVE Embedded Systems public git repository  
Line 407: Line 199:
 
* 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)
 
* 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.
+
Please note that XELK u-boot and kernel source trees are derived from the official trees released by Freescale; these trees have been customized to add support for the Axel SOM.
  
 
=== XELK Updates ===
 
=== XELK Updates ===
Line 414: Line 206:
  
 
==== Updating git repositories ====
 
==== Updating git repositories ====
In XELK, the following source trees are clones of the correspondent '''DAVE Embedded Systems''' git repositories:
+
 
{| class="wikitable"
+
In XELK, the following source trees are clones of '''DAVE Embedded Systems''' public git repositories:
 +
 
 +
{| class="wikitable"  
 
|-
 
|-
 
!| Component
 
!| Component
 
!GIT Remote
 
!GIT Remote
 +
!XELK Installation Directory
 +
|-
 +
|Linux
 +
|git@git.dave.eu:dave/axel/linux-2.6-imx.git
 +
|/home/dvdk/xelk/linux-2.6-imx
 
|-
 
|-
 
|U-Boot
 
|U-Boot
|<code>git@git.dave.eu:dave/axel/u-boot-imx.git</code>
+
|git@git.dave.eu:dave/axel/u-boot-imx.git
 +
|/home/dvdk/xelk/u-boot-imx
 
|-
 
|-
|Linux kernel
+
|Yocto BSP
|<code>git@git.dave.eu:dave/axel/linux-2.6-imx.git</code>
+
|git@git.dave.eu:dave/axel/axel-bsp.git
 +
|/home/dvdk/xelk/axel-bsp
 
|-
 
|-
|Yocto BSP
 
|<code>git@git.dave.eu:dave/axel/axel-bsp.git</code>
 
 
|}
 
|}
For more information about the access to these repositories, please refer to [[Building_the_Yocto_BSP_(XELK)|this link]].
 
  
Access to DAVE Embedded Systems' git repositories is granted to development kit's owners only. Please refer to [[Accessing_DAVE_Embedded_Systems_restricted_git_repositories|this page]] for detailed instructions on how to get access.
+
This means that these components can be kept in sync and up to date with '''DAVE Embedded Systems''' repositories.
  
==== Synchronizing the repository ====
+
==== RSA key generation ====
  
The components listed in the table above can be kept in sync and up to date with DAVE Embedded Systems' repositories.
+
Please follow the procedure reported below to generate the RSA ssh key:
  
Once the git account has been enabled, the developer can:
+
* select your username (ad es. username@myhost.com)
*clone the repository with the <code>git clone <git_remote_repository></code> command
+
* start the DVDK and login into the virtual machine
*synchronize a source tree entering the repository directory and launching the <code>git fetch origin</code> command.
+
* start a shell session
 +
* enter the .ssh subdirectory into your home directory: <code>cd ~/.ssh/</code>
 +
* launch the following command: <br><pre>ssh-keygen -t rsa -C "username@myhost.com" -f username@myhost.com</pre>
 +
* this command creates the files <code>~/.ssh/username@myhost.com</code> ('''private key''') and <code>~/.ssh/username@myhost.com.pub</code> ('''public key''')
 +
* edit your <code>~/.ssh/config</code> adding the following lines:
  
Please note that git fetch doesn't merge the commits on the current branch. To do that, the developer should run the <code>git merge</code> command or replace the ''fetch-merge'' process with a single <code>git pull</code> 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
+
<pre>
 +
Host git.dave.eu
 +
    User git
 +
    Hostname git.dave.eu
 +
    PreferredAuthentications publickey
 +
    IdentityFile ~/.ssh/username@myhost.com
 +
</pre>
  
== Release types ==
+
Please send the public key file to one of the following email support addresses (depending on which SOM is included in your kit version)
  
XELK release type can be:
+
* [mailto:support-axel@dave.eu support-axel@dave.eu]
* '''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 [[Axel_Embedded_Linux_Kit_(XELK)#XELK_Updates|XELK Updates]].
+
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.
  
== Release notes ==
+
==== Synchronizing the repository ====
 
 
{{ImportantMessage|text=After the XELK DVDK installation, please check for updates of the source tree repositories provided with the kit, as described in [[Axel_Embedded_Linux_Kit_(XELK)#XELK_Updates | XELK Updates]].}}
 
  
=== XELK 4.1.0 ===
+
When the account is enabled, you can synchronize a source tree entering the repository directory and launching the <code>git fetch</code> command, like in the following example:
  
{{ImportantMessage|text=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.}}
+
<pre class="workstation-terminal">
 +
dvdk@dvdk-vm:~$ cd /home/dvdk/xelk/linux-2.6-imx/
 +
dvdk@dvdk-vm:/home/dvdk/xelk/linux-2.6-imx$ git fetch origin
 +
</pre>
  
Release notes:
+
Please note that <code>git fetch</code> doesn't merge the commits on the current branch. To do that, you should run
  
* Updated Yocto version: added X11, browser, Qt5 Wayland rot file system images
+
<pre class="workstation-terminal">
 +
git merge origin/axel
 +
</pre>
  
=== XELK 4.0.0 ===
+
or replace the ''fetch-merge'' process with a single <code>git pull</code> command. Please note that the recommended method is the ''fetch-merge'' process. For further information on Git, please refer to [http://git-scm.com/documentation Git Documentation].
  
{{ImportantMessage|text=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 ==
  
Release notes:
+
{{ImportantMessage|text=After the XELK DVDK installation, please check for updates of the source tree repositories provided with the kit, as described in [[Axel_Embedded_Linux_Kit_(XELK)#XELK_Updates | XELK Updates]].}}
 
 
* Major change to NXP BSP 4.9.11
 
* Updated u-boot and kernel versions
 
* Updated Yocto version
 
* Updated Qt version
 
  
==== Known Limitations ====
+
=== XELK 2.1.0 ===
  
The following table reports the known limitations of this XELK release:
+
* Release date: 04/05/2015
 +
* Status: released
 +
* Freescale Linux BSP: L3.10.17-1.0.0
 +
* Supported carrier boards: AxelEVB-Lite on Dacu
  
{| class="wikitable"
+
==== Notes ====
|-
 
!Issue
 
!Description
 
|-
 
|NAND Samsung
 
|NAND Model K9F4G08U0D not detected in u-boot
 
|-
 
|Linux kernel <code>xconfig</code>
 
|<code>make xconfig</code> does not work
 
|-
 
|Wayland not supported
 
|Yocto QT5 images with Wayland backend is not yet supported
 
|-
 
|}
 
  
=== XELK 3.5.0 ===
 
 
{{ImportantMessage|text=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 <b>SPL</b> version (first and second stage).}}
 
 
Release notes:
 
 
* Major change to u-boot SPL version
 
* Updated u-boot version
 
 
=== XELK 3.0.1 ===
 
 
{{ImportantMessage|text=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)
 
 
<div class="mw-collapsible mw-collapsed">
 
 
==== XELK 2.3.1 ====
 
 
{{ImportantMessage|text=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 ====
 
 
{{ImportantMessage|text=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
 
* Updated u-boot and kernel versions
 
* Bug fixes and minor changes
 
* Bug fixes and minor changes
  
===== Known Limitations =====
+
==== Known Limitations ====
  
 
The following table reports the known limitations of this XELK release:
 
The following table reports the known limitations of this XELK release:
Line 551: Line 302:
 
|Verified in Host and Device modes
 
|Verified in Host and Device modes
 
|-
 
|-
|Reboot from software (not on SBC AXEL)
+
|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). SBC AXEL is not affected by this issue.
+
|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
 
|Ethernet
Line 559: Line 310:
 
|}
 
|}
  
==== XELK 2.1.0 ====
 
 
{{ImportantMessage|text=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:
+
=== XELK 2.0.0 ===
  
{| class="wikitable"
+
* Release date: 26/11/2014
|-
+
* Status: released
!Issue
+
* Freescale Linux BSP: L3.10.17-1.0.0
!Description
+
* Supported carrier boards: AxelEVB-Lite on Dacu
|-
 
|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 ====
+
==== Notes ====
  
 
* Added support for Yocto 1.5
 
* Added support for Yocto 1.5
Line 592: Line 324:
 
* Bug fixes and minor changes
 
* Bug fixes and minor changes
  
===== Known Limitations =====
+
==== Known Limitations ====
  
 
The following table reports the known limitations of this XELK release:
 
The following table reports the known limitations of this XELK release:
Line 615: Line 347:
 
|}
 
|}
  
==== XELK 1.2.0 ====
+
 
 +
=== XELK 1.2.0 ===
 +
 
 +
* Release date: 20/05/2014
 +
* Status: released
 +
* Freescale Linux BSP: L3.0.35-4.1.0
 +
* Supported carrier boards: AxelEVB-Lite on Dacu
 +
 
 +
==== Notes ====
  
 
* Added support for Axel Lite SOM
 
* Added support for Axel Lite SOM
 
* Bug fixes and minor changes
 
* Bug fixes and minor changes
  
===== Known Limitations =====
+
==== Known Limitations ====
  
 
The following table reports the known limitations of this XELK release:
 
The following table reports the known limitations of this XELK release:
Line 643: Line 383:
 
|}
 
|}
  
==== XELK 1.1.0 ====
+
 
 +
=== XELK 1.1.0 ===
 +
 
 +
* Release date: January, 29th 2014
 +
* Status: released
 +
* Freescale Linux BSP: L3.0.35-4.1.0
 +
* Supported carrier boards: AxelEVB-Lite on Dacu
 +
 
 +
==== Notes ====
  
 
* Minor update that adds support for more peripherals: nand, rtc, i2c, spi
 
* Minor update that adds support for more peripherals: nand, rtc, i2c, spi
Line 650: Line 398:
 
* The system can boot from SD
 
* The system can boot from SD
  
===== Known Limitations =====
+
==== Known Limitations ====
  
 
The following table reports the known limitations of this XELK release:
 
The following table reports the known limitations of this XELK release:
Line 676: Line 424:
 
|}
 
|}
  
==== XELK 1.0.0 ====
+
 
 +
=== XELK 1.0.0 ===
 +
 
 +
* Release date: November, 4th 2013
 +
* Status: released
 +
* Freescale Linux BSP: L3.0.35-4.1.0
 +
* Supported carrier boards: AxelEVB-Lite on Dacu
 +
 
 +
==== Notes ====
  
 
* First official release
 
* First official release
  
===== Known Limitations =====
+
==== Known Limitations ====
  
 
The following table reports the known limitations of this XELK release:
 
The following table reports the known limitations of this XELK release:
Line 711: Line 467:
 
|-
 
|-
 
|}
 
|}
 
</div>
 
 
== 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===
 
{{ImportantMessage|text='''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 [mailto:support-axel@dave.eu support-axel@dave.eu], [[Development_Kits_Identification_Codes|providing the kit P/N and S/N]].
 
 
If you also wish to access git repositories containing source code, please follow the procedure described [[Accessing_DAVE_Embedded_Systems_restricted_git_repositories|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 {{oldid|3287|AxelEVB-Lite}}
 
[[File:AxelLite-AxelEVB.jpg|thumb|center|600px|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]]
 
[[File:AxelUltra-AxelEVB.jpg|thumb|center|600px|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 (<code>mmcblk0p1</code>) and a root file system partition (<code>mmcblk0p2</code>).
 
#Insert the MicroSD card provided with the development kit into the microSD slot
 
#Connect the 12V power supply to the JP2 socket on the DACU board
 
#(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
 
#(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===
 
 
{{ImportantMessage|text=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 [[Working_with_the_Yocto_build_system#bootscript|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 <i>boot.scr</i> 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 <i>boot.scr</i> file:
 
 
<pre>
 
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
 
</pre>
 
 
and compile it using:
 
 
<pre>
 
mkimage -A ARM -T script -C none -n XELK -d bootscript.txt boot.scr
 
</pre>
 
 
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_(MVM)|Managed Virtual Machine]]. As indicated [[Axel_Embedded_Linux_Kit_(XELK)#XELK_microSD_Layout|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 [[Accessing_DAVE_Embedded_Systems_restricted_git_repositories|this page]].
 
 
{{ImportantMessage|text=The MVM provides the tools required to build [[Building_U-Boot_(XELK)|U-boot]] and [[Building_Linux_kernel_(XELK)|Linux kernel]]. It does not include the tools required to run Yocto build system instead.}}
 
 
XELK MVM can be downloaded [https://cloud.dave.eu/ws-reserved-area-xelk/XELK-3.0.1 here]. For accessing <b><i>XELK Reserved area</i></b> please contact our [mailto:sales@dave.eu sales department]
 
 
===Target configuration for the development stage (<code>net_nfs</code>)===
 
 
{{ImportantMessage|text=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 <code>net_nfs</code> 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 [[Deploying_Embedded_Linux_Systems#The_development_environment|here]]. An example of ''Bridge mode'' configuration for DIVELK can be found [[Booting_from_NFS_(XELK) | here]]
 
In DAVE Embedded Systems development kits, this configuration is generally denoted as <code>net_nfs</code>. U-Boot bootloader supports this configuration. Some U-Boot environment variables are needed to set it up. They are detailed [[Booting_Linux_Kernel#Configuration_net_nfs|here]].
 
 
For more details about TFTP and NFS servers on host side, please refer to this [[Setting_up_tftp_and_nfs|page]].
 
 
===Target configuration for standalone boot===
 
Please refer to [[Standalone_boot_(XELK)|this page]].
 
  
 
==Related Documents ==
 
==Related Documents ==
  
* [[:Category:AxelUltra|AXEL ULTRA]]
+
* [[Axel_Ultra_SOM | Axel Ultra SOM]]
* [[:Category:AxelLite|AXEL LITE]]
+
* [[Axel_Lite_SOM | Axel Lite SOM]]
 
* [[AxelEVB-Lite | AxelEVB-Lite]]
 
* [[AxelEVB-Lite | AxelEVB-Lite]]
 
* [[FAQs_(Axel) | Axel FAQs]]
 
* [[FAQs_(Axel) | Axel FAQs]]
 
* [[Hardware Manual (AxelUltra) | Axel Ultra Hardware Manual]]
 
* [[Hardware Manual (AxelUltra) | Axel Ultra Hardware Manual]]
 
* [[Hardware Manual (AxelLite) | Axel Lite Hardware Manual]]
 
* [[Hardware Manual (AxelLite) | Axel Lite Hardware Manual]]
 +
* [[XELK Quick Start Guide]]
 
* [[:Category:Dacu | Dacu category page]]
 
* [[:Category:Dacu | Dacu category page]]
 
* [[Dacu | Dacu carrier board]]
 
* [[Dacu | Dacu carrier board]]
 
* [[Dacu_for_the_Axel_SOM | Dacu for the Axel SOM]]
 
* [[Dacu_for_the_Axel_SOM | Dacu for the Axel SOM]]
 
[[Category:SBC-AXEL]]
 

Revision as of 13:33, 20 August 2015

Info Box
Dacu-top-view.png Applies to Dacu
Axel-04.png Applies to Axel Ultra
Axel-lite 02.png Applies to Axel Lite
Axel-02.png Applies to AXEL ESATTA

Introduction[edit | edit source]

Axel-on-evb-02.png

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[edit | edit source]

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

XELK software components[edit | edit source]

DAVE Embedded Systems adds to the latest Linux BSP from Freescale the customization required to support the Axel platform. For this reason most of the documentation provided by 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 3.0.0
Status Released Released Released Released Released Planned
Release date November, 4th 2013 January 2014 May 2014 November 2014 May 2015 3Q 2015
Release notes Ver 1.0.0 Ver 1.1.0 Ver 1.2.0 Ver 2.0.0 Ver 2.1.0 -
SOM PCB version Axel Ultra: CS030713 Axel Ultra: CS030713A Axel Ultra: CS030713A
Axel Lite: CS335013A
Axel Ultra: CS030713A
Axel Lite: CS335013B
Axel Ultra: CS030713B
Axel Lite: CS335013B
Axel Ultra: CS030713B
Axel Lite: CS335013B
Supported carrier boards AxelEVB-Lite
Dacu
AxelEVB-Lite
Dacu
AxelEVB-Lite
Dacu
AxelEVB-Lite
Dacu
AxelEVB-Lite
Dacu
AxelEVB-Lite
Dacu
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 2014.04-xelk-3.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.14.28-xelk-3.0.0
Drivers SPI NOR Flash (boot)
UART debug (2-wire)
USB Host
USB OTG
SD/MMC1
CAN
Touch screen controller
EMAC
SATA
HMDI
LVDS1
SPI NOR Flash (boot)
UART debug (2-wire)
USB Host
USB OTG
SD/MMC1
CAN
Touch screen controller
EMAC
SATA
HMDI
LVDS1
NAND
RTC
I2C
SPI
SPI NOR Flash (boot)
UART debug (2-wire)
USB Host
USB OTG
SD/MMC1
CAN
Touch screen controller
EMAC
SATA
HMDI
LVDS1
NAND
RTC
I2C
SPI
SPI NOR Flash (boot)
UART debug (2-wire)
USB Host
USB OTG
SD/MMC1
CAN
Touch screen controller
EMAC
SATA
HMDI
LVDS1
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
HMDI
LVDS1
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
HMDI
LVDS1
NAND
RTC
I2C
SPI
Video Input (MIPI)
PCIe
ConfigID
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.14.28-1-1.0
Graphic libraries Qt 4.8 Qt 4.8 Qt 4.8 Qt 5.3.2 Qt 5.3.2 Qt 5.x
Build System LTIB LTIB LTIB Yocto Dora (1.5) Yocto Dora (1.5) Yocto Dizzy (1.7)

XELK microSD Layout[edit | edit source]

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 12.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 Freescale; these trees have been customized to add support for the Axel SOM.

XELK Updates[edit | edit source]

200px-Emblem-important.svg.png It's recommended to use the latest available XELK version. Please refer to Release notes for further information. 200px-Emblem-important.svg.png

Updating git repositories[edit | edit source]

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

Component GIT Remote XELK Installation Directory
Linux git@git.dave.eu:dave/axel/linux-2.6-imx.git /home/dvdk/xelk/linux-2.6-imx
U-Boot git@git.dave.eu:dave/axel/u-boot-imx.git /home/dvdk/xelk/u-boot-imx
Yocto BSP git@git.dave.eu:dave/axel/axel-bsp.git /home/dvdk/xelk/axel-bsp

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

RSA key generation[edit | edit source]

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

  • select your username (ad es. username@myhost.com)
  • start the DVDK and login into the virtual machine
  • start a shell session
  • 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 one of the following email support addresses (depending on which SOM is included in your kit version)

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.

Synchronizing the repository[edit | edit source]

When the account is enabled, you can synchronize a source tree entering the repository directory and launching the git fetch command, like in the following example:

dvdk@dvdk-vm:~$ cd /home/dvdk/xelk/linux-2.6-imx/
dvdk@dvdk-vm:/home/dvdk/xelk/linux-2.6-imx$ git fetch origin

Please note that git fetch doesn't merge the commits on the current branch. To do that, you should run

git merge origin/axel

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[edit | edit source]

200px-Emblem-important.svg.png After the XELK DVDK installation, please check for updates of the source tree repositories provided with the kit, as described in XELK Updates. 200px-Emblem-important.svg.png

XELK 2.1.0[edit | edit source]

  • Release date: 04/05/2015
  • Status: released
  • Freescale Linux BSP: L3.10.17-1.0.0
  • Supported carrier boards: AxelEVB-Lite on Dacu

Notes[edit | edit source]

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

Known Limitations[edit | edit source]

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[edit | edit source]

  • Release date: 26/11/2014
  • Status: released
  • Freescale Linux BSP: L3.10.17-1.0.0
  • Supported carrier boards: AxelEVB-Lite on Dacu

Notes[edit | edit source]

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

Known Limitations[edit | edit source]

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[edit | edit source]

  • Release date: 20/05/2014
  • Status: released
  • Freescale Linux BSP: L3.0.35-4.1.0
  • Supported carrier boards: AxelEVB-Lite on Dacu

Notes[edit | edit source]

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

Known Limitations[edit | edit source]

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[edit | edit source]

  • Release date: January, 29th 2014
  • Status: released
  • Freescale Linux BSP: L3.0.35-4.1.0
  • Supported carrier boards: AxelEVB-Lite on Dacu

Notes[edit | edit source]

  • 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[edit | edit source]

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[edit | edit source]

  • Release date: November, 4th 2013
  • Status: released
  • Freescale Linux BSP: L3.0.35-4.1.0
  • Supported carrier boards: AxelEVB-Lite on Dacu

Notes[edit | edit source]

  • First official release

Known Limitations[edit | edit source]

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

Related Documents[edit | edit source]