SBC Lynx Embedded Linux Kit (TBD XUELK 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 [[:Category:SBC Lynx|SBC Lynx board]]* build Linux and debug applications that will run be executed on top of Yocto-based Linux distribution running on the target.
The main kit components are:
* hardware platform composed of(SBC Lynx)** TBD* Development development host released in the form of [[Managed_Virtual_Machine_(MVM)|Managed Virtual Machine]] containing:** Toolchain** U, tailored for [[Managed_Virtual_Machine_(MVM)#Yocto-based_Linux_distribution|Yocto-Boot bootloader sources** Linux kernel sources** Root file systemsbased distribution]]* Technical 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. '''Reading of the [[Managed_Virtual_Machine_(MVM)|Managed Virtual Machine documentation]] is strongly recommended''', as it plays a '''major role''' in the XUELK organization. For more details about SBC Lynx hardware characteristics, please refer to the [[Hardware_Manual_(SBC_Lynx)|SBC Lynx Hardware Manual]]. An account for the reserved area of [http://www.dave.eu '''DAVE Embedded Systems''' website] is required to access the kit contents.
==Kit Contents==
!Notes
|-
|style="text-align: center;" | [[File:Axel-01Lynx.png|60px]]|Axel Ultra SOM (or Axel Lite SOM) SBC Lynx<br>CPU: Freescale NXP i.MX6MX6UL<br>SDRAM: 2 GB 512 MB DDR3<br>NOR: bootable SPI flash 32 MB<br>NAND: 1GB|Please refer to [[Hardware Manual Hardware_Manual_(AxelUltraSBC_Lynx) | Axel Ultra SBC Lynx Hardware Manual]]|-|style="text-align: center;" | [[File:Axelevb-lite-01.png|60px]]|AxelEVB-Lite Carrier board|Please refer to [[AxelEVB-Lite | AxelEVB-Lite]] page|-|style="text-align: center;" | [[File:Dacu-top-view.png|80px]]|Dacu Carrier board|Please refer to [[Dacu | Dacu]] page|-|style="text-align: center;" | [[File:Display.jpg|60px]]|Ampire AM-800480STMQW<br>7” 800x480 LCD display<br>LVDS interface|Please refer to [[XELK Quick Start Guide]]
|AC/DC Single Output Wall Mount adapter<br>Output: +12V – 2.0 A|Please refer to [[XELK Quick Start Guide]]
|-
|style="text-align: center;" | [[File:CavettoTTL-seriale2232RG-VIP-WE.jpgpng|50px]]|DB9 Male Serial port adapterFTDI TTL/USB cable|Please refer to FTDI code: [[XELK Quick Start Guide]http://www.ftdichip.com/Products/Cables/USBTTLSerial.htm TTL-232RG-VIP-WE]
== TBD Additional documentation==SBC Lynx documentation is provided on [[:Category:SBC_Lynx|Wiki]] product pages. The most important documents are listed below: * [[XUELK Quick Start Guide]]* [[Hardware_Manual_(SBC_Lynx)|Hardware Manual]]* [[Mechanicals_(SBC_Lynx)|Mechanicals]] == XUELK software components =={{ImportantMessage|text=From the software perspective, XUELK supports SBC Lynx and [[:Category:AXEL_ULite|AXEL ULite SOM]]. However, physical contents of the kit include SBC Lynx only.}}
'''DAVE SBC Lynx Embedded Systems''' adds to the latest Linux BSP Kit is largely derived from Freescale the customization required to support Yocto distributions released by NXP for the SBC Lynx platformi.MX6 product family. For this reason most of the documentation provided by Freescale NXP remains valid for the TBD XUELK development kit. However, some customization is required, in particular at bootloader and linux kernel levels.
The following table reports the XELK XUELK releases information.
* 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 [1] Not included in 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:kit
* VirtualBox virtual machine [2] Carrier Board 0x00000013 (.OVA archiveSBC Lynx CS214515B)* 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 uses same dtb 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)as 0x0000000C
Please note that XELK u-boot and kernel source trees are derived from the official trees released by Freescale; these trees [3] Carrier Board 0x0000002D/2E/2F/30 have been customized to add support its own device tree file for the Axel SOM.different peripherals mapping====Downloadable binary images====
=== XELK Updates ===
{{ImportantMessage|text=It's recommended to use the latest available XELK version. Please refer to All binary images for XUELK are hosted on [[Axel_Embedded_Linux_Kit_(XELK)#Release notes mirror:lynx| Release notesDAVE Embedded System mirror server]] . There you can find a sub directory for further informationeach version of this development kit.}}
==== Updating git repositories ====A summary of images with a brief description can be found into the table below:
In XELK{{ImportantMessage|text=For [[AXEL_ULite_and_SBC_Lynx_Embedded_Linux_Kit_(XUELK)#XUELK_software_components|XUELK releases]] 1.1.3 and older, in order to boot Linux from SD card files, the following source trees are clones of '''DAVE Embedded Systemsthe binary files must be renamed''' public git repositoriesas follows:*bootscript: <code>boot.scr</code>*Linux kernel: <code>uImage</code>*Device tree:<code>imx6ul-lynx.dtb</code>The default U-Boot enviroment variables assume in fact that these names are used.}}
This means that these components can be kept === XUELK microSD Layout ===The microSD card provided with XUELK is partitioned as shown in sync and up to date with '''DAVE Embedded Systems''' repositories.the following image:
==== RSA key generation ====
Please follow the procedure reported below to generate the RSA ssh key[[File:XUELK-uSD-partitioning.png|thumb|center|600px|microSD card partitioning]]
* 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: <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:
Most of storage space is occupied by two partitions:*a <code>FAT32</code> partition (<precode>mmcblk0p1</code>) containing:Host git.dave.eu**U-Boot <code>bootscript</code> User git**Linux kernel and DTB binary images Hostname git.dave.eu**XUELK virtual machine image in OFV format ([[Managed_Virtual_Machine_(MVM)|MVM]] basic version) PreferredAuthentications publickey**7-zip Windows executable file IdentityFile ~*an <code>ext3</.ssh/username@myhost.comcode> partition (<code>mmcblk0p2</precode>) containing the root file system for the target.
Please send the public key <code>bootscript</code> and root file system are used to one of boot the following email support addresses (depending on which SOM is included target as described in your kit version)[[#Target_setup_and_first_boot|this section]].
* It is worth remembering that the microSD card is [mailto:support[Booting_options_(SBC_Lynx)|bootable]], because U-axel@daveBoot image is stored at address 0x400.eu supportHowever, even if U-axel@daveBoot is run from the microSD card, '''the environment is retrieved from NOR flash'''.eu====How to create a bootable microSD card====Please refer to this [[How_to_create_a_bootable_microSD_card_(XUELK)|this page]].
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.=== XUELK updates ===
{{ImportantMessage|text==== Synchronizing It's recommended to use the repository ====latest available XUELK version. Please refer to [[#Release notes | Release notes]] for further information.}}
When XUELK updating process consists of updating the account [[Managed_Virtual_Machine_(MVM)|Managed Virtual Machine]] it 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:based on. The procedure is described [[Managed_Virtual_Machine_(MVM)#Updating_MVM|here]].
<pre class="workstationPlease note that this process '''implicitly updates git source code repositories of U-terminal">dvdk@dvdk-vm:~$ cd Boot and/home/dvdk/xelk/linux-2or Linux kernel'''.6-imx/dvdk@dvdk-vm:/home/dvdk/xelk/linux-2Thus '''it is strongly recommended to create new local branches if you need to modify source code'''.6-imx$ git fetch origin</pre>
Please note that <code>==== Updating git fetch</code> doesn't merge the commits on the current branch. To do that, you should run repositories ====
<pre class="workstation-terminal">In XUELK, the following source trees are clones of '''DAVE Embedded Systems''' public git merge origin/axel</pre>repositories:
or replace the ''fetch{| class="wikitable" |-merge'' process with a single <code>!| Component!GIT Remote!XUELK Installation Directory|-|Linux|git pull<@git.dave.eu:lynx/code> commandlinux-2. Please note that the recommended method is the ''fetch6-merge'' processimx. For further information on Git, please refer to [httpgit|/home/dvdk/lynx/linux|-|U-Boot|git@git.dave.eu:lynx/u-boot-imx.git|/home/dvdk/lynx/u-boot|-|Yocto BSP|git@git.dave.eu:lynx/lynx-scmbsp.comgit|/documentation Git Documentation].home/dvdk/lynx/lynx-bsp|-|}
== Release types ==This means that these components can be kept in sync and up to date with '''DAVE Embedded Systems''' repositories.
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=== Release notes ===
As an example, XELK ==== XUELK 2.20.0 is a maintenance release, so it provides the DVDK released with the 1/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]].3 ====
===== Notes 2.0.3 =====
== Release notes ==* Add support for ISSI SPI NOR flash
{{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]]==== Notes 2.0.}}2 =====
=== XELK 2* Update Yocto BSP to latest Krogoth to fix WPA2 key replay security bug (for more details see [http://git.yoctoproject.2org/cgit/cgit.0 =cgi/poky/commit/?h=krogoth&id=54e3f82bd77203c3d578e26c86506e6ef5c27000])
* Release date: 03/02/2016===== Notes 2.0.1 =====* StatusMajor update on XUELK 1.2.0: released* Freescale Linux BSP: L3update to NXP 4.101.1715-12.0.30_ga* Supported carrier boards: AxelEVB-Lite on Dacu, SBCXMinor fixes for Wifi and BT
==== Notes = Known issues and limitations =====
{{ImportantMessage|text=It's highly recommended to read The following table reports the [[ConfigID_and_UniqueID]] page.}}known limitations of this XUELK release:
* 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:
{| class="wikitable"
|-
!IssueLimitations
!Description
|-
|USB OTGCurrent Limit|Verified USB OTG current limit is set at 75mA 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 testedmode
|-
|Low Power Idle not supported
|Low Power Idle is not supported in this release
|}
=== XELK = XUELK 1.2.1.0 ====
* Release date: 04/05/2015* Status: released* Freescale Linux BSP: L3.10.17-1.0.0* Supported carrier boards: AxelEVB-Lite on Dacu===== Notes =====
==== Notes ====Minor update on XUELK 1.1.3:* add CPU temperature for thermal thresholds settings* add rf kill support for Bluetooth on device tree* add [[ConfigID and UniqueID|ConfigID]] support for different hardware configurations: SOM_ConfigID and CB_ConfigID* minor fixes and enhancement
{{ImportantMessage|text=It's highly recommended to read the [[ConfigID_and_UniqueID]] page.}}==== Known issues and limitations =====
* Updated u-boot and kernel versions* Bug fixes and minor changesThe following table reports the known limitations of this XUELK release:
==== Known Limitations ====
The following table reports the known limitations of this XELK release:
{| class="wikitable"
!Description
|-
|USB OTGCurrent Limit|Verified USB OTG current limit is set at 75mA in Host and Device modesmode
|-
|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)|-|EthernetLow Power Idle not supported|10 Mbps connections have Low Power Idle is not been testedsupported in this release
|-
|Bridged network configuration without DHCP server
Minor update on XUELK 1.1.0:* add some useful networking support (wireless WPA and bonding)* Release date: 26/11/2014add configid support for new hardware revision* Status: releasedadd support for Xenomai extension* Freescale Linux BSP: L3fix XUELK-1.101.170 commercial microSD mount issue* fix XUELK-1.01.0reboot when rfs is on SD/MMC* Supported carrier boards: AxelEVB-Lite on Dacuminor fixes and enhancement
==== Notes = Known issues and limitations =====
* Added support for Yocto 1.5* Updated u-boot and kernel versions* Bug fixes and minor changesThe following table reports the known limitations of this XUELK release:
==== Known Limitations ====
The following table reports the known limitations of this XELK release:
{| class="wikitable"
!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 Current Limit|USB OTG|Verified current limit is set at 75mA 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 testedmode
==== Notes ====Minor update on XUELK 1.0.0:* add some useful networking support (on both Linux and file system)* fix XUELK-1.0.0 shutdown issue* fix XUELK-1.0.0 MVM network-manager issues* minor fixes and enhancement
* Added support for Axel Lite SOM* Bug fixes ===== Known issues and minor changeslimitations =====
==== Known Limitations ====The following table reports the known limitations of this XUELK release:
The following table reports the known limitations of this XELK release:
{| class="wikitable"
!Description
|-
|USB OTGRebooting in Linux may hang|Verified Software reboot on Linux may hang (without rebooting the board) when root file system in Host and Device modeson SD/MMC
|-
|SD1USB OTG Current Limit|SD1 interface (available on the Axel Lite adapter board as microSD connector) detects the card only if it USB OTG current limit is inserted before booting Linuxset at 75mA in Host mode
|-
|Reboot from softwareLow Power Idle not supported|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)Low Power Idle is not supported in this release
|-
|EthernetFailing mount of root file system on microSD card|10 Mbps connections have Some commercial microSD cards occasionally prevent the target from mounting the root file system stored on themselves. microSD cards delivered along with XUELK do not been testedexhibit this problem.
|-
|Missing firmware file for Bluetooth
|In case [[XUELK-AN-001:_Using_WiFi-Bluetooth_combo_plugin_with_SBC_Lynx|DWM wireless plugin]] is used, the following file need to be copied in <code>/lib/firmware/ti-connectivity/</code>:
*<code>TIInit_7.6.15.bts</code> (please click [https://github.com/TI-ECS/bt-firmware/blob/master/am335x/TIInit_7.6.15.bts here] to download it)
|}
==== XUELK 1.0.0 ====
=== XELK 1.1.0 == Notes =====
* Release date: January, 29th 2014* Status: released* Freescale Linux BSP: L3.0.35-4.1.0* Supported carrier boards: AxelEVB-Lite on DacuFirst stable release with support for SBC Lynx revision A and Axel ULite
==== Notes =Known issues and limitations =====The following table reports the known limitations of this XUELK release:
* 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:
{| class="wikitable"
!Description
|-
|Boot modesRebooting in Linux may hang|This kit version supports boot from USB Software reboot on Linux may hang (for recovery purposewithout rebooting the board), from SPI nor flash and from when root file system in on SD card. Boot from NAND flash will be available on a future release./MMC
|-
|CPU coresUSB OTG Current Limit|Max 2 cores. 3rd and 4th cores will be available on a future release.USB OTG current limit is set at 75mA in Host mode
|-
|USB OTGLow Power Idle not supported|Verified Low Power Idle is not supported in Host and Device modesthis release
|-
|Reboot from softwareXUELK environment fixup for SD boot<br/>on SBC Lynx|Rebooting To boot with the XUELK SD card, user may need to execute the following commands at u-boot prompt<br/><pre>setenv mmcroot /dev/mmcblk0p2setenv mmc_loadfdt 'fatload mmc 0:1 ${fdtaddr} imx6ul-lynx-som000c.dtb'saveenv</pre>|-|Failing mount of root file system on microSD card|Some commercial microSD cards occasionally prevent the target from software (eg: launching mounting the reboot command from Linux user space) can lead to a root file system lockstored on themselves. To solve it, reset the board microSD cards delivered along with the dedicated button (S10)XUELK do not exhibit this problem.
|-
|EthernetSystem shutdown mode using the <code>shutdown -h now</code> command prevent the subsequent system's power-up|Verified speeds: 1 Gbps and 100 MbpsIssuing a system shutdown by the command <code>shutdown -h now</code> as described in [[Supported power mode transitions (SBC Lynx)]] will prevent the subsequent system's boot.
|-
|Missing 7-zip Windows executable in microSD card
|Please download it from http://www.7-zip.org.
|-
|In the MVM, <code>network-manager</code> applet is not installed by default.
| Please refer to [[VirtualBox_Network_Configuration#VBox_Bridged_configuration|this page]] to install it.
|-
|Missing firmware file for Bluetooth
|In case [[XUELK-AN-001:_Using_WiFi-Bluetooth_combo_plugin_with_SBC_Lynx|DWM wireless plugin]] is used, the following file need to be copied in <code>/lib/firmware/ti-connectivity/</code>:
*<code>TIInit_7.6.15.bts</code> (please click [https://github.com/TI-ECS/bt-firmware/blob/master/am335x/TIInit_7.6.15.bts here] to download it)
|}
=== XELK 1= XUELK 0.09.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 beta release. ===== Known Limitations issues and limitations ===== The following table reports the known limitations of this XELK XUELK release:
{| class="wikitable"
!Description
|-
|Boot modesRebooting in Linux may hang|This kit version supports boot from USB (for recovery purpose) and from SPI nor flash. Other boot devices Software reboot on Linux may hang (MicroSD, NAND flash, ..without rebooting the board) will be available when root file system in on a future release.SD/MMC
|-
|CPU coresUSB OTG Current Limit|Max 2 cores. 3rd and 4th cores will be available on a future release.USB OTG current limit is set at 75mA in Host mode
|-
|USB OTGLDO Mode not supported|Verified LDO Mode is not supported in Host and Device modesthis SW release
|-
|Reboot from softwareLow Power Idle not supported|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)Low Power Idle is not supported in this release
|-
|EthernetDDR3 Frequency limited at 306 MHz|Verified speeds: 1 Gbps and 100 Mbps|-|CAN|Maximum supported speed: 500 kbps|-|Touch controller|Touch events are detected, but touch point The DDR3 RAM frequency is not resolved with precisionlimited at 306 MHz in this release