Changes

Jump to: navigation, search

AXEL ULite and SBC Lynx Embedded Linux Kit (XUELK)

2,260 bytes added, 16:23, 24 October 2017
XUELK 2.0.1/.2.0.2
{| class="wikitable"
!
!colspan="46" | XUELK version
|-
|Release number
|1.1.0
|1.1.3
|1.2.0
|2.0.1/2.0.2
|-
|Release type
|Minor
|Minor
|Minor
|Major
|-
|Status
|Beta
|Released
|Released
|Released
|Released
|November 2016
|March 2017
|May 2017
|Sep 2017
|-
|Release notes
|[[#XUELK 1.1.0|1.1.0]]
|[[#XUELK 1.1.3|1.1.3]]
|[[#XUELK 1.2.0|1.2.0]]
|[[#XUELK 2.0.1/2.0.2|2.0.1/2.0.2]]
|-
|PCB version
SBC Lynx CS214515B<br>
(AXELULite CS184015) [1]
|SBC Lynx CS214515A<br>
SBC Lynx CS214515B<br>
(AXELULite CS184015)<br>
(AXELULite CS184015A) [1]
|SBC Lynx CS214515A<br>
SBC Lynx CS214515B<br>
(AXELULite CS184015)<br>
(AXELULite CS184015A) [1]
|-
|[[ConfigID_and_UniqueIDConfigID_(XUELK)|ConfigIDs]] (core/interfaces)
|0x00000008/0x0000000E
|0x00000008/0x0000000E<br>
0x00000013/NA [2]<br>
(0x0000000B/0x00000010) [1]
|0x00000008/0x0000000E<br>
0x0000000C/NA<br>
0x00000013/0x0000002D [3]<br>
0x00000013/0x0000002E [3]<br>
0x00000013/0x0000002F [3]<br>
0x00000013/0x00000030 [3]<br>
(0x0000000B/0x00000010) [1]<br>
(0x00000014/0x00000010) [1]
|0x00000008/0x0000000E<br>
0x0000000C/NA<br>
0x00000013/0x0000002D [3]<br>
0x00000013/0x0000002E [3]<br>
0x00000013/0x0000002F [3]<br>
0x00000013/0x00000030 [3]<br>
(0x0000000B/0x00000010) [1]<br>
(0x00000014/0x00000010) [1]
|-
|[[Managed_Virtual_Machine_(MVM)|MVM]] version
Virtual Box 5.1.10<br/>
Vagrant 1.8.7
|xuelk-1.2.0, tested with:<br/>
Virtual Box 5.1.10<br/>
Vagrant 1.8.7
|xuelk-2.0.0, tested with:<br/>
Virtual Box 5.1.28<br/>
Vagrant 2.0.0
|-
|U-Boot version/release
|U-Boot 2015.04/xuelk-1.1.0
|U-Boot 2015.04/xuelk-1.1.3
|U-Boot 2015.04/xuelk-1.2.1
|U-Boot 2016.03/xuelk-2.0.0
|-
|Linux version/release
|Linux 3.14.52/xuelk-1.1.0
|Linux 3.14.52/xuelk-1.1.3
|Linux 3.14.52/xuelk-1.2.1
|Linux 4.1.15/xuelk-2.0.1
|-
|Drivers
CAN<br/>
DWM<br/>
LCD<br/>
|valign="top"|UART<br/>
Ethernet<br/>
SD/MMC<br/>
USB Host<br/>
USB OTG<br/>
NOR Flash<br/>
NAND Flash<br/>
ADC<br/>
RTC<br/>
CAN<br/>
DWM (WLAN/BT)<br/>
LCD<br/>
|valign="top"|UART<br/>
Ethernet<br/>
SD/MMC<br/>
USB Host<br/>
USB OTG<br/>
NOR Flash<br/>
NAND Flash<br/>
ADC<br/>
RTC<br/>
CAN<br/>
DWM (WLAN/BT)<br/>
LCD<br/>
|-
|3.14.52_1.1.0_ga
|3.14.52_1.1.0_ga
|3.14.52_1.1.0_ga
|4.1.15-2.0.0_ga
|-
|Xenomai version
|
| 2.6.5
| 2.6.5
|
|-
|Build System
|Yocto Fido (1.8)
|Yocto Fido (1.8)
|Yocto Fido (1.8)
|Yocto Krogoth (2.1)
|-
|}
[1] Not included in the kit
[2] Carrier Board 0x00000013 (SBC Lynx CS214515B) uses same dtb file as 0x0000000C [3] Carrier Board 0x0000002D/2E/2F/30 have its own device tree file for different peripherals mapping
====Downloadable binary images====
A summary of images with a brief description can be found into the table below:
{{ImportantMessage|text=In 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 binary files must be renamed''' as 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.}}
{| class="wikitable"
|-
! rowspan=2|Image !! colspan=46|XUELK version
|-
|style="text-align: center" |1.0.0 || style="text-align: center" |1.1.0 || style="text-align: center" |1.1.3 || style="text-align: center" |1.1.3-xenomai|| style="text-align: center" |1.2.0 || style="text-align: center" |2.0.1/2.0.2
|-
| 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]] || colspan=2 style="text-align: center" |[[mirror:lynx/xuelk-1.1.3/xuelk-1.1.3_boot.scr|boot.scr]]|| [[mirror:lynx/xuelk-1.2.0/boot.scr|boot.scr]]|| [[mirror:lynx/xuelk-2.0.2/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]] || colspan=2 style="text-align: center" |[[mirror:lynx/xuelk-1.1.3/xuelk-1.1.2_mx6ul_lynx_u-boot.imx|u-boot.imx]] || [[mirror:lynx/xuelk-1.2.0/xuelk-1.2.1_mx6ul_lynx_u-boot.imx|u-boot.imx]] || [[mirror:lynx/xuelk-2.0.2/xuelk-2.0.1_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]] || [[mirror:lynx/xuelk-1.1.3/xuelk-1.1.3_uImage|uImage]] || [[mirror:lynx/xuelk-1.1.3/xuelk-1.1.3-xeno1_uImage|xeno_uImage]] || [[mirror:lynx/xuelk-1.2.0/xuelk-1.2.1_uImage|uImage]] || [[mirror:lynx/xuelk-2.0.2/xuelk-2.0.1_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]] || style="text-align: center" |[[mirror:lynx/xuelk-1.1.3/xuelk-1.1.3_imx6ul-lynx-som000c.dtb|imx6ul-lynx-som000c.dtb]] ||[[mirror:lynx/xuelk-1.1.3/xuelk-1.1.3-xeno1_imx6ul-lynx-som000c.dtb|xeno_imx6ul-lynx-som000c.dtb]] || [[mirror:lynx/xuelk-1.2.0/xuelk-1.2.1_imx6ul-lynx-som000c.dtb|imx6ul-lynx-som000c.dtb]]<br>[[mirror:lynx/xuelk-1.2.0/xuelk-1.2.1_imx6ul-lynx-som0013-cb002f.dtb|imx6ul-lynx-som0013-cb002f.dtb]] || [[mirror:lynx/xuelk-2.0.2/xuelk-2.0.1_imx6ul-lynx-som000c.dtb|imx6ul-lynx-som000c.dtb]]<br>[[mirror:lynx/xuelk-2.0.2/xuelk-2.0.1_imx6ul-lynx-som0013-cb002f.dtb|imx6ul-lynx-som0013-cb002f.dtb]]
|-
| Root file system || [[mirror:lynx/xuelk-1.0.0/xuelk-1.0.0_lynx-image-gui-sbc-lynx.tar.bz2|gui-sbc-lynx]] || [[mirror:lynx/xuelk-1.1.0/xuelk-1.1.0_lynx-image-gui-sbc-lynx.tar.bz2|gui-sbc-lynx]] <br>[[mirror:lynx/xuelk-1.1.0/xuelk-1.1.0_lynx-image-networking-sbc-lynx.tar.bz2|networking-sbc-lynx]] || [[mirror:lynx/xuelk-1.1.3/xuelk-1.1.3_lynx-image-networking-sbc-lynx.tar.bz2|networking-sbc-lynx]] || [[mirror:lynx/xuelk-1.1.3/xuelk-1.1.3_lynx-image-networking-sbc-lynx-xeno.tar.bz2|networking-sbc-lynx-xeno]] || [[mirror:lynx/xuelk-1.2.0/xuelk-1.2.0_lynx-image-networking-sbc-lynx.tar.bz2|networking-sbc-lynx]] || [[mirror:lynx/xuelk-2.0.2/xuelk-2.0.2_lynx-image-networking-sbc-lynx.tar.bz2|networking-sbc-lynx]]
|}
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'''.
====How to create a bootable microSD card====
The following script can be used Please refer to create a bootable microSD cardthis [[How_to_create_a_bootable_microSD_card_(XUELK)|this page]]. Is has been tested with 16 GB microSD cards. In case you have a different size, you'll need to change the <code>sfdisk</code> parameters accordingly. The resulting card is partitioned as depicted in the previous section.<pre>#!/bin/bash
if [[ -z $1 || -z $2 || -z $3 || -z $4 ]]then echo "$0 Usage:" echo " $0 <device> <u-boot.imx> <binaries directory> <rootfs tar.bz2>" echo " Example: $0 /dev/sdc u-boot.imx binaries/ rootfs.tar.bz2" exitfi=== XUELK updates ===
if {{ImportantMessage|text=It's recommended to use the latest available XUELK version. Please refer to [ "$(whoami)" != "root" [#Release notes | Release notes]]then echo "you must be root to run this script!" exitfifor further information.}}
if ! XUELK updating process consists of updating the [[ -b $1 Managed_Virtual_Machine_(MVM)|Managed Virtual Machine]]then echo "$1 it is not a valid block device!" exitfibased 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 ! [[ -e $2 ]]then echo "Incorrect u-bootyou need to modify source code'''.imx location!" exitfi
if ! [[ -d $3 ]]then echo "Incorrect Binaries location!" exitfi=== Release notes ===
if ! [[ -f $4 ]]then echo "Incorrect rootfs location!" exitfi==== XUELK 2.0.1/2.0.2 ====
DRIVE=$1if [[ "$DRIVE" == *"mmcblk"* ]]then echo "You're using a mmc device, I need to fix partition names" PART="p"else PART=""fiUBOOTNotes 2.0.2 ===$2BINARIES=$3RFS=$4
echo "All data on "$DRIVE" now will be destroyed! Continue? * Update Yocto BSP to latest Krogoth to fix WPA2 key replay security bug (for more details see [yhttp://git.yoctoproject.org/cgit/cgit.cgi/poky/n]"read ansif ! [ $ans commit/?h=krogoth&id= 'y' 54e3f82bd77203c3d578e26c86506e6ef5c27000]then exitfi)
echo "[Partitioning $===== Notes 2.0.1 =====Major update on XUELK 1.2.0:* BSP update to NXP 4.1.15-2.0.]"0_ga* Minor fixes for Wifi and BT
dd if=/dev/zero of=$DRIVE bs=1024 count=1024= Known issues and limitations =====
SIZE=`fdisk -l $DRIVE | grep Disk | awk '{print $5}'`The following table reports the known limitations of this XUELK release:
echo DISK SIZE - $SIZE bytes
CYLINDERS{| class=`echo $SIZE/255/63/512 "wikitable" |-!Limitations!Description|-|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| bc`}
{ echo 10,1380,0x0c,* echo 1390,,83,-} | sfdisk -D -H 255 -S 63 -C $CYLINDERS $DRIVEsudo partprobe==== XUELK 1.2.0 ====
echo "[Making filesystems...]"mkfs.vfat -F 32 -n BOOT "$DRIVE$PART"1 #> /dev/nullmkfs.ext3 -L ROOTFS "$DRIVE$PART"2 #> /dev/null===== Notes =====
echo "[Copying files.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
binaries_dir=${BINARIES%/}mount "$DRIVE$PART"1 /mntcp -av --no-preserve=ownership $binaries_dir/* /mnt/umount "$DRIVE$PART"1=== Known issues and limitations =====
echo "[Extracting rfs (The following table reports the known limitations of this may take a while...)]"mount "$DRIVE$PART"2 /mnttar jxf $RFS -C /mnt > /dev/nullchmod 755 /mntumount "$DRIVE$PART"2XUELK release:
echo "[Programming u-boot.imx]"
dd if=$UBOOT of=$DRIVE bs=1k seek=1
echo {| class="[Done]wikitable"</pre>|-!Issue!Description|-Here |USB OTG Current Limit|USB OTG current limit is an example that shows how to use this script to program a bootable microSD card, containing the binaries delivered along with the XUELK 1.1.3.set at 75mA in Host mode|-=== XUELK updates ===|Low Power Idle not supported|Low Power Idle is not supported in this release{{ImportantMessage|text=It's recommended to use the latest available XUELK version. Please refer to [[#Release notes -| Release notes]] for further information.}}Bridged network configuration without DHCP server XUELK updating process consists of updating the [[Managed_Virtual_Machine_(MVM)|Managed Virtual Machine]] it is based on. The procedure is described See [[Managed_Virtual_Machine_(MVM)VirtualBox_Network_Configuration#Updating_MVMLXDE|herethis section]]. 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 ===|}
==== XUELK 1.1.3 ====
===Target setup and first boot===
This section describes how to quick start SBC Lynx board delivered along with XUELK kit(see also the following image):
*connect a TTL/USB serial cable to J42 connector; J42 pinout is:
** 1: TX data
* change dir to the ext3 SD card partition
* delete previous files and extract new files from tarball archive as described [[AXEL_ULite_and_SBC_Lynx_Embedded_Linux_Kit_(XUELK)#Update_rfs_on_target|here]]
===Developing the software for the target===
Please refer to [[Developing the software for the target (XUELK)|this page]].
==Physical devices mapping==
8,157
edits

Navigation menu