[[File:TBD{{ImportantMessage|text='''For BXELK 1.0.1 or older, the boot process was based on the FSBL+second-stage bootloader (U-Boot) combination. From BXELK 2.0.0 on, the boot process is based on the first-stage bootloader (U-Boot SPL)+second-stage bootloader (U-Boot) combination.png|thumb|center|100px|BoraX SOM]]'''}}
<section begin="Unboxing" />
==Unboxing==
BoraX Embedded Linux Kit (BXELK for short) provides all the necessary components required to set up the developing environment to:* build the first-stage bootloader (FSBL)* build the 2nd-stage bootloader (U-Boot)* build and run Linux operating system on [[File:Category:BoraXBORA_Xpress.png|thumb|center|BoraX system-on-module (SOM)]]* build and debug applications that will be executed on top of Yocto-based Linux distribution running on the target.The main kit components are:* hardware platform, composed by [[:Category:BoraX400px|BoraX SOM]] and [[BoraXEVB]]* development host released in the form of [[Managed_Virtual_Machine_(MVM)|Managed Virtual Machine]], tailored for [[Managed_Virtual_Machine_(MVM)#Yocto-based_Linux_distribution|Yocto-based distribution]]* technical documentation (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 BXELK organization.
For more details about SBC Lynx hardware characteristics, please refer BoraX Embedded Linux Kit (BXELK for short) provides all the necessary components required to set up the developing environment for:* building the first-stage bootloader:**FSBL for BXELK 1.0.1 or older**U-boot SPL for BXELK 2.0.0 or newer* building the second-stage bootloader (U-Boot)* building and running Linux operating system on [[Hardware_Manual_(SBC_Lynx)BORA_Xpress_SOM|SBC Lynx Hardware ManualBORA Xpress SOM]]. An account for the reserved area * building and debugging applications that will be executed on top of [http://www.dave.eu '''DAVE Embedded Systems''' website] is required to access Yocto-based Linux distribution running on the kit contentstarget.
The main kit components are:* hardware platform, composed by [[BORA_Xpress_SOM|BORA Xpress SOM]] and [[BORA_Xpress_SOM/BORA_Xpress_Evaluation_Kit | BORA Xpress Evalutation kit]]* source code of target software* technical documentation (hardware manuals, mechanical drawings, reference schematics, application notes etc.)<section end="Unboxing" /><section begin="Kit Contents==Content" />
|style="text-align: center;" | [[File:LynxBORA_Xpress.png|60px]]|SBC Lynx[[BORA Xpress SOM|BORA Xpress]] SOM (p/n DBXF4110S2R)<br>CPU*SoC: NXP i.MX6UL<br>Xilinx XC7Z030 (866Mhz, Speed "-3", Tj 0-100°C)*SDRAM: 512 MB 1 GB DDR3<br>*NOR: bootable SPI flash 32 16 MB<br>*NAND: 1GB(SLC)|Please * For more details, please refer to the[[BORA_Xpress_SOM/BORA_Xpress_Hardware | BORA Xpress Hardware Manual]]* By default, ARM cores frequency is set to 667 MHz and the [[Hardware_Manual_Creating and building example Vivado project (SBC_LynxBELK/BXELK)| SBC Lynx Hardware Manualexample Vivado project]] is implemented for a "-1" device. This choice makes the software released with the kit compatible with possible variants based on different SoM models. In this regard, see also the [[#Order codes|order codes section]].|-| style="text-align: center;" | [[File:BoraXEVB-01.png|60px]]|[[BORA_Xpress_SOM/BORA_Xpress_Evaluation_Kit | BORA Xpress]]Carrier board|
|style="text-align: center;" | [[File:TTL-232RG-VIP-WE.png|50px]]|FTDI TTL/USB cable|FTDI code: [http://www.ftdichip.com/Products/Cables/USBTTLSerial.htm TTL-232RG-VIP-WE]|-|style="text-align: center;" | [[File:ProdSDC-MBLY-thumb.png|50px]]|MicroSDHC microSDHC card with SD adapter and USB adapter
|
|-
|}
==Additional documentation==SBC Lynx documentation is provided on [[:Category:SBC_Lynx|Wiki]] product pages. The most important documents are listed below:* [[BXELK Quick Start Guide]]* [[Hardware_Manual_(SBC_Lynx)|Hardware Manual]]* [[Mechanicals_(SBC_Lynx)|Mechanicals]]== BXELK software components Order codes=={{ImportantMessage|text=From the software perspective, BXELK supports SBC Lynx and [[:Category:AXEL_ULite|AXEL ULite SOM]]. However, physical contents of the kit include SBC Lynx only.}}BoraX Embedded Linux Kit is largely derived from the Yocto distributions released by Xilinx for the Zynq product family. For this reason most of the documentation provided by Xilinx remains valid for the BXELK development kit.The following table reports the BXELK releases information.{| class="wikitable" !!colspan="3" | BXELK version|-|Release number|0.9.0|1.0.0|1.1.0|-|Release type|Major|Major|Minor|-|Status|Beta|Released|Released|-|Release date|March 2016|August 2016|November 2016|-|Release notes|[[#BXELK 0.9.0|0.9.0]]|[[#BXELK 1.0.0|1.0.0]]|[[#BXELK 1.1.0|1.1.0]]|-|PCB version|SBC Lynx CS214515|SBC Lynx CS214515A<br>(AXELULite CS184015) [1]|SBC Lynx CS214515A<br>(AXELULite CS184015) [1]|-|[[ConfigID_and_UniqueID|ConfigIDs]] (core/interfaces)|0x00000008/0x0000000E|0x00000008/0x0000000E<br>0x0000000C/NA<br>(0x0000000B/NA) [1]|0x00000008/0x0000000E<br>0x0000000C/NA<br>(0x0000000B/NA) [1]|-|[[Managed_Virtual_Machine_(MVM)|MVM]] version|xuelk-0.9.0, tested with:<br/>Virtual Box 5.0.14<br/>Vagrant 1.8.1|xuelk-1.0.0, tested with:<br/>Virtual Box 5.0.26<br/>Vagrant 1.8.1|xuelk-1.1.0, tested with:<br/>Virtual Box 5.1.10<br/>Vagrant 1.8.7|-|U-Boot version/release|U-Boot 2015.04/xuelk-0.9.0|U-Boot 2015.04/xuelk-1.0.0|U-Boot 2015.04/xuelk-1.1.0|-|Linux version/release|Linux 3.14.52/xuelk-0.9.0|Linux 3.14.52/xuelk-1.0.0|Linux 3.14.52/xuelk-1.1.0|-|Drivers|valign="top"|UART<br/>Ethernet<br/>SD/MMC<br/>USB Host<br/>USB Device<br/>NOR Flash<br/>NAND Flash<br/>ADC<br/>RTC<br/>|valignstyle="top"|UART<br/>Ethernet<br/>SD/MMC<br/>USB Host<br/>USB Device<br/>NOR Flash<br/>NAND Flash<br/>ADC<br/>RTC<br/>CAN<br/>DWM<br/>LCD<br/>|valign="top"|UART<br/>Ethernet<br/>SD/MMC<br/>USB Host<br/>USB Device<br/>NOR Flash<br/>NAND Flash<br/>ADC<br/>RTC<br/>CAN<br/>DWM<br/>LCD<br/>|-|NXP BSP version|3.14.52_1.1.0_ga|3.14.52_1.1.0_ga|3.14.52_1.1.0_ga|-|Build System|Yocto Fido (1.8)|Yocto Fido (1.8)|Yocto Fido (1.8)|-|}[1] Not included in the kit.====Downloadable binary images====All binary images for BXELK are hosted on [[mirror:lynx|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 belowmargin: {| class="wikitableauto;"|-+! rowspan=2|Image !! colspan=2|BXELK version|-| 1.0.0 || 1.1.0|-| bootscript || [[mirror:lynx/xuelk-1.0.0/xuelk-1.0.0_boot.scr|boot.scr]] || [[mirror:lynx/xuelk-1.1.0/xuelk-1.1.0_boot.scr|boot.scr]]|-| U-Boot || [[mirror:lynx/xuelk-1.0.0/xuelk-1.0.0_mx6ul_lynx_u-boot.imx|u-boot.imx]] || [[mirror:lynx/xuelk-1.1.0/xuelk-1.1.0_mx6ul_lynx_u-boot.imx|u-boot.imx]]|-| Linux kernel || [[mirror:lynx/xuelk-1.0.0/xuelk-1.0.0_uImage|uImage]] || [[mirror:lynx/xuelk-1.1.0/xuelk-1.1.0_uImage|uImage]]|-| Device tree || [[mirror:lynx/xuelk-1.0.0/xuelk-1.0.0_imx6ul-lynx-som000c.dtb|imx6ul-lynx-som000c.dtb]] || [[mirror:lynx/xuelk-1.1.0/xuelk-1.1.0_imx6ul-lynx-som000c.dtb|imx6ul-lynx-som000c.dtb]]|}=== BXELK microSD Layout ===The microSD card provided with BXELK is partitioned as shown in the following image:[[File:BXELK-uSD-partitioning.png|thumb|center|600px|microSD card partitioning]]Most of storage space is occupied by two partitions:*a <code>FAT32</code> partition (<code>mmcblk0p1</code>) containing:**U-Boot <code>bootscript</code>**Linux kernel and DTB binary images**BXELK virtual machine image in OFV format ([[Managed_Virtual_Machine_(MVM)|MVM]] basic version)**7-zip Windows executable file*an <Order code>ext3</code> partition (<code>mmcblk0p2</code>) containing the root file system for the target.<code>bootscript</code> and root file system are used to boot the target as described in [[#AXEL_ULite_and_SBC_Lynx_Embedded_Linux_Kit_(BXELK)|this section]].It is worth remembering that the microSD card is [[Booting_options_(SBC_Lynx)|bootable]], because U-Boot image is stored at address 0x400. However, even if U-Boot is run from the microSD card, '''the environment is retrieved from NOR flash'''.=== BXELK updates ==={{ImportantMessage|text=It's recommended to use the latest available BXELK version. Please refer to [[#Release notes | Release notes]] for further information.}}BXELK updating process consists of updating the [[Managed_Virtual_Machine_(MVM)|Managed Virtual Machine]] it is based on. The procedure is described [[Managed_Virtual_Machine_(MVM)#Updating_MVM|here]].Please note that this process '''implicitly updates git source code repositories of U-Boot and/or Linux kernel'''. Thus '''it is strongly recommended to create new local branches if you need to modify source code'''.=== Release notes ======= BXELK 1.1.0 ========= Notes =====Minor update on BXELK 1.0.0:* add some useful networking support (on both Linux and file system)* fix BXELK-1.0.0 shutdown issue* fix BXELK-1.0.0 MVM network-manager issues* minor fixes and enhancement===== Known issues and limitations =====The following table reports the known limitations of this BXELK release:{| class="wikitable" |-!Issue!Description|-|Rebooting in Linux may hang|Software reboot on Linux may hang (without rebooting the board) when root file system in on SD/MMC|-|USB OTG Current Limit|USB OTG current limit is set at 75mA in Host mode|-|Low Power Idle not supported|Low Power Idle is not supported in this release|-|Failing mount of root file system on microSD card|Some commercial microSD cards occasionally prevent the target from mounting the root file system stored on themselves. microSD cards delivered along with BXELK do not exhibit this problem.|}==== BXELK 1.0.0 ========= Notes =====First stable release with support for SBC Lynx revision A and Axel ULite===== Known issues and limitations =====The following table reports the known limitations of this BXELK release:{| class="wikitable" |-!Issue
!Description
|-
|Rebooting in Linux may hang|Software reboot on Linux may hang (without rebooting the board) when root file system in on SD/MMC|-|USB OTG Current Limit|USB OTG current limit is set at 75mA in Host mode|-|Low Power Idle not supported|Low Power Idle is not supported in this release|-|BXELK environment fixup for SD boot<br/>on SBC Lynx|To boot with the BXELK 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>|H-S|Failing mount of root file system on microSD card|Some commercial microSD cards occasionally prevent the target from mounting the root file system stored on themselves. microSD cards delivered along with BXELK do not exhibit this problem.|-|System shutdown mode using the <This code>shutdown -h now</code> command prevent the subsequent system's power-up|Issuing a system shutdown by the command <code>shutdown -h now</code> as described in [[Supported power mode transitions (SBC Lynx)]] will prevent refers to the subsequent system's boot.default configuration detailed above
|-
|Missing 7BXELK-zip Windows executable in microSD cardH-S-D|Please download it from http://www.7This variant is like BELK-zip.org. |L-|In S, except the MVMSOM, <code>network-manager</code> applet which is not installed by default.| Please refer to [[VirtualBox_Network_Configuration#VBox_Bridged_configuration|this page]] to install itDBXD4110S2R.
|}
<section end="Kit Content" />
==== Logical structure of BXELK 0.9.0 ========= Notes =====First beta releasePlease refer to [[Logical_structure_of_Bora_and_BoraX_Embedded_Linux_Kits_(BELK/BXELK)|this page]].===== Known issues and limitations =====The following table reports the known limitations of this BXELK release:
{| class="wikitable" = BXELK software components ==|-!Issue!Description|-|Rebooting in Linux may hang|Software reboot on Linux may hang (without rebooting the board) when root file system in on SDPlease refer to [[BELK/MMC|-|USB OTG Current Limit|USB OTG current limit is set at 75mA in Host mode|-|LDO Mode not supportedBXELK_software_components|LDO Mode is not supported in this SW release|-|Low Power Idle not supported|Low Power Idle is not supported in this release|-|DDR3 Frequency limited at 306 MHz|The DDR3 RAM frequency is limited at 306 MHz in this release|-|}page]].