Bureaucrats, dave_user, Administrators
8,220
edits
Changes
→XUELK 2.0.1/2.0.2/2.0.3
|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]]
|-
|}
==Documentazione addizionaleAdditional documentation==TBDSBC 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]]da popolare* [[Mechanicals_(SBC_Lynx)|Mechanicals]]
== XUELK software components ==
{| class="wikitable"
!
!colspan="26" | XUELK version
|-
|Release number
|0.9.0
|1.0.0
|1.1.0
|1.1.3
|1.2.0
|2.0.1/2.0.2/2.0.3
|-
|Release type
|Major
|Major
|Minor
|Minor
|Minor
|Major
|-
|Status
|Beta
|Released
|Released
|Released
|Released
|Released
|-
|March 2016
|August 2016
|November 2016
|March 2017
|May 2017
|Sep 2017
|-
|Release notes
|[[#XUELK 0.9.0|0.9.0]]
|[[#XUELK 1.0.0|1.0.0]]
|[[#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.3|2.0.1/2.0.2/2.0.3]]
|-
|PCB version
|SBC Lynx CS214515A<br>
(AXELULite CS184015) [1]
|SBC Lynx CS214515A<br>
(AXELULite CS184015) [1]
|SBC Lynx CS214515A<br>
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>
0x0000000C/NA<br>
(0x0000000B/NA) [1]
|0x00000008/0x0000000E<br>
0x0000000C/NA<br>
(0x0000000B/NA) [1]
|0x00000008/0x0000000E<br>
0x0000000C/NA<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.0.26<br/>
Vagrant 1.8.1
|xuelk-1.1.0, tested with:<br/>
Virtual Box 5.1.10<br/>
Vagrant 1.8.7
|xuelk-1.1.3, tested with:<br/>
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-0.9.0
|U-Boot 2015.04/xuelk-1.0.0
|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.3
|-
|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
|Linux 3.14.52/xuelk-1.1.3
|Linux 3.14.52/xuelk-1.2.1
|Linux 4.1.15/xuelk-2.0.3
|-
|Drivers
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/>
|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/>
|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
|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 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==== All binary images for XUELK 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 below: {{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 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=6|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.3 |-| 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.3/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.3/xuelk-2.0.3_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.3/xuelk-2.0.3_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.3/xuelk-2.0.3_imx6ul-lynx-som000c.dtb|imx6ul-lynx-som000c.dtb]]<br>[[mirror:lynx/xuelk-2.0.3/xuelk-2.0.3_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.1/xuelk-2.0.1_lynx-image-networking-sbc-lynx.tar.bz2|networking-sbc-lynx]]|}
=== XUELK microSD Layout ===
The microSD card provided with XUELK is partitioned as shown in the following image:
**U-Boot <code>bootscript</code>
**Linux kernel and DTB binary images
**XUELK virtual machine image in OFV format ([[Managed_Virtual_Machine_(MVM )|MVM]] basic version)**7-zip Windows executable file
*an <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_(XUELK)Target_setup_and_first_boot|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'''.
====How to create a bootable microSD card====
Please refer to this [[How_to_create_a_bootable_microSD_card_(XUELK)|this page]].
=== XUELK updates ===
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'''.
==== Updating git repositories ====
In XUELK, the following source trees are clones of '''DAVE Embedded Systems''' public git repositories:
{| class="wikitable"
|-
!| Component
!GIT Remote
!XUELK Installation Directory
|-
|Linux
|git@git.dave.eu:lynx/linux-2.6-imx.git
|/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-bsp.git
|/home/dvdk/lynx/lynx-bsp
|-
|}
This means that these components can be kept in sync and up to date with '''DAVE Embedded Systems''' repositories.
=== Release notes ===
==== XUELK 2.0.1/2.0.2/2.0.3 ====
===== Notes 2.0.3 =====
* Add support for ISSI SPI NOR flash
===== Notes 2.0.2 =====
* Update Yocto BSP to latest Krogoth to fix WPA2 key replay security bug (for more details see [http://git.yoctoproject.org/cgit/cgit.cgi/poky/commit/?h=krogoth&id=54e3f82bd77203c3d578e26c86506e6ef5c27000])
===== 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
===== Known issues and limitations =====
The following table reports the known limitations of this XUELK release:
{| class="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
|}
==== XUELK 1.2.0 ====
===== 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
===== Known issues and limitations =====
The following table reports the known limitations of this XUELK release:
{| class="wikitable"
|-
!Issue
!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
|-
|Bridged network configuration without DHCP server
|See [[VirtualBox_Network_Configuration#LXDE|this section]].
|}
==== XUELK 1.1.3 ====
===== Notes =====
Minor update on XUELK 1.1.0:
* add some useful networking support (wireless WPA and bonding)
* add configid support for new hardware revision
* add support for Xenomai extension
* fix XUELK-1.1.0 commercial microSD mount issue
* fix XUELK-1.1.0 reboot when rfs is on SD/MMC
* minor fixes and enhancement
===== Known issues and limitations =====
The following table reports the known limitations of this XUELK release:
{| class="wikitable"
|-
!Issue
!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
|}
==== XUELK 1.1.0 ====
===== 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
===== Known issues and limitations =====
The following table reports the known limitations of this XUELK 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 XUELK do not exhibit 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 ====
|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 exhibit this problem.
|-
|System shutdown mode using the <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 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)
|}
This chapter describes how to quickly start working with the XUELK 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 updated additional documentation . To register the kit, please send an email to [mailto:support-lynx@dave.eu support-lynx@lynx.eu], [[Development_Kits_Identification_Codes|providing the kit P/N and softwareS/N]].
===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
[[File:TBDSBCLynx-XUELK.png|thumb|center|600px|Target setup for first boot]]
Once power has been applied to the target, U-Boot bootloader will be fetched from the SPI NOR flash and executed. Boot messages will be printed out on to the serial console. Redundant U-Boot environment is stored in the NOR flash as well, as depicted in the following image.
By default, U-Boot is configured to retrieve Linux kernel image stored in the microSD card [1]. In turn, Linux kernel shall mount root file system from the <code>mmcblk0p2</code> partition of the [[#XUELK microSD Layout|microSD card itself]]. At the end of boot process, Linux shell shall be available on the serial console.
The following dump shows the typical messages printed out to the console during bootstrap process.
<pre class="mw-collapsible mw-collapsed">
U-Boot 2015.04 (Mar 31 2016 - 23:22:16)-xuelk-0.9.0
===Host setup===
As stated previously, XUELK host tools are based on a [[Managed_Virtual_Machine_(MVM)|Managed Virtual Machine]]. To install itAs indicated [[#XUELK microSD Layout|here]], microSD card delivered along with XUELK includes basic version of MVM that is the default option. In case you choose to use the [[Managed_Virtual_Machine_(MVM)#Advanced_version|''Advanced'' version]] of the MVM instead, the <code><i>project-name</i></code> to be used is <code>lynx</code>. Either version you choose, please follow the procedure described [[Managed_Virtual_Machine_(MVM)#Installation_and_configuration|here]]to install the MVM.
===Target configuration for the development stage (<code>net_nfs</code>)===
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_(XUELK)|this page]].
===How to update root file system on SD card===
RFS update on SD card consists on expanding the new tarball compressed file on SD card ext3 partition.
It is possible, for example, to perform this operation using one of the following process:
* directly on the target
* using a Linux PC (or the XUELK VM)
The ext3 partition (mmcblk0p2) containing the root file system need to be:
* erased
* written with new rfs files
==== Update rfs on target====
* start SBC Lynx via nfs. See how to boot from nfs [[AXEL_ULite_and_SBC_Lynx_Embedded_Linux_Kit_(XUELK)#Target_configuration_for_the_development_stage_.28net_nfs.29|here]]
* change directory to the ext3 partition into the filesystem: typically <code>/run/media/mmcblk0p2</code>
<pre>
root@sbc-lynx:~# cd /run/media/mmcblk0p2
root@sbc-lynx:/run/media/mmcblk0p2#
</pre>
* delete all previous files
<pre>
root@sbc-lynx:/run/media/mmcblk0p2# rm -r *
</pre>
* extract new rfs files from tarball archive previously copied into nfs directory (the following command assumes that xuelk-1.1.0 rfs have been already copied into VM '''/home/dvdk/lynx/rfs/xuelk/home/root''' nfs directory
<pre>
root@sbc-lynx:/run/media/mmcblk0p2# tar jxvpf /home/dvdk/lynx/rfs/xuelk/home/root/xuelk-1.1.0_lynx-image-gui-sbc-lynx.tar.bz2
</pre>
==== Update rfs on a Linux PC====
* insert the SD card and check its mount point
* 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==