Difference between revisions of "BORA Lite SOM/BELK-L/General/Release Notes"

From DAVE Developer's Wiki
Jump to: navigation, search
Line 7: Line 7:
 
!style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#73B2C7; padding:5px; color:white"|Notes
 
!style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#73B2C7; padding:5px; color:white"|Notes
 
|-
 
|-
|style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#edf8fb; padding:5px; color:#000000"|X.Y.Z
+
|style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#edf8fb; padding:5px; color:#000000"|1.0.0
|style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#edf8fb; padding:5px; color:#000000"|Month Year
+
|style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#edf8fb; padding:5px; color:#000000"|Sep 2021
|style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#edf8fb; padding:5px; color:#000000"|TBD
+
|style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#edf8fb; padding:5px; color:#000000"|belk-4.1.5
|-
 
|-
 
|style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#edf8fb; padding:5px; color:#000000"|[TBD_link X.Y.Z]
 
|style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#edf8fb; padding:5px; color:#000000"|Month Year
 
|style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#edf8fb; padding:5px; color:#000000"|TBD
 
 
|-
 
|-
 
|}
 
|}
Line 24: Line 19:
 
==Release Notes==
 
==Release Notes==
  
'''DAVE Embedded Systems''' adds to the latest Linux BSP from ''TBD (e.g. NXP)'' the customization required to support the SOC platform. For this reason most of the documentation provided by ''TBD (e.g. NXP)'' remains valid for the DESK development kit.  
+
'''DAVE Embedded Systems''' adds to the latest Linux BSP from Xilinx the customization required to support the SOC platform. For this reason most of the documentation provided by ''TBD (e.g. NXP)'' remains valid for the DESK development kit.  
  
 
However, some customization is required, in particular at bootloader and linux kernel levels.
 
However, some customization is required, in particular at bootloader and linux kernel levels.
Line 31: Line 26:
 
{| class="wikitable"  
 
{| class="wikitable"  
 
!
 
!
!width="300pt"|DESK version
+
!width="300pt"|BELK version
 
|-
 
|-
 
|Release number
 
|Release number
|''1.x.x''
+
|4.1.5
 
|-
 
|-
 
|Release type
 
|Release type
|''TBD (e.g. Major or Minor)''
+
|Minor (base on [[BELK/BXELK_software_components#Release_notes | BELK 4.0.0]] major release)
 
|-
 
|-
 
|Status
 
|Status
|''TBD (e.g. In progress or Released)''
+
|Released
 
|-
 
|-
 
|Release date
 
|Release date
|Qx 20xx
+
|Sep 2021
 
|-
 
|-
 
|'''Release notes'''
 
|'''Release notes'''
| ''TBD (link to the Release page [[#DESK_1.0.0 | Ver 1.0.0]])''
+
| [[#BELK_4.1.5 | Ver 4.1.5]]
 
|-
 
|-
 
|Product support
 
|Product support
|{{{nome-som}}}
+
|BORA Lite
 
|-
 
|-
 
|MVM (distro version)
 
|MVM (distro version)
|Ubuntu ''TBD''
+
|Ubuntu 16.04
 
|-
 
|-
 
|U-Boot version
 
|U-Boot version
|''TBD''
+
|2017.01-belk-4.1.5
 
|-
 
|-
 
|Linux version
 
|Linux version
|''TBD''
+
|4.9.0-bora-4.1.4
 
|-
 
|-
 
|Drivers
 
|Drivers
Line 64: Line 59:
 
<div style="width:100%;">
 
<div style="width:100%;">
 
<div style="width:50%; float: left;">
 
<div style="width:50%; float: left;">
''SPI NOR Flash (boot)<br>UART debug (2-wire)<br>USB Host<br>USB OTG<br>SD/MMC1<br>CAN<br>Touch screen <br>EMAC<br>SATA      <br>HDMI<br>''
+
SPI NOR Flash (boot)<br>UART debug (2-wire)<br>USB OTG<br>SD/MMC<br>CAN
 
</div>
 
</div>
 
<div style="width:100%;">
 
<div style="width:100%;">
 
<div style="width:50%; float: left;">
 
<div style="width:50%; float: left;">
''LVDS0<br>NAND<br>RTC<br>I2C<br>SPI<br>Video Input (MIPI)<br>PCIe<br>[[ConfigID_and_UniqueID | ConfigID]]<br>Splash screen<br>SPL boot''
+
Ethernet0 gigabit<br>NAND<br>RTC<br>I2C<br>[[ConfigID_and_UniqueID | ConfigID]]
 
</div>
 
</div>
 
|-
 
|-
|Manufacturer BSP version
+
|Vivado version
|''TBD (e.g. imx_4.14.98_2.0.0_ga)''
+
|2017.1
|-
 
|Graphic libraries
 
|Qt ''TBD (e.g. 5.9.6)''
 
 
|-
 
|-
 
|Build System
 
|Build System
|Yocto ''TBD (e.g. sumo)''
+
|Yocto Morty (2.2)
|-
 
|Android
 
|
 
 
|}
 
|}
  
=== DESK 1.0.0 ===
+
=== BELK 4.1.5 ===
  
{{ImportantMessage|text=New MVM must be installed for using DESK-1.0.0. The VM is available for download on DAVE's XELK Reserved Area for registered users.}}
+
{{ImportantMessage|text=New MVM must be installed for using BELK-4.1.0. The VM is available for download on DAVE's BORA Reserved Area for registered users.}}
  
 
Release notes:
 
Release notes:
  
* Major change to NXP BSP 4.14.98
+
* Updated u-boot version for BORA Lite support (updated defconfig for NOR and SD boot)
* Updated u-boot and kernel versions
 
* Updated Yocto version
 
* Updated Qt version
 
  
 
==== Known Limitations ====
 
==== Known Limitations ====
  
The following table reports the known limitations of this XELK release:
+
The following table reports the known limitations of this BELK release:
  
 
{| class="wikitable"  
 
{| class="wikitable"  
 
|-
 
|-
!Issue
+
!ID
 +
!Component
 +
!Subsystem
 
!Description
 
!Description
 
|-
 
|-
|NAND Samsung
+
|0002
|NAND Model K9F4G08U0D not detected in u-boot
+
|BoraEVB/BoraXEVB
 +
|ETH1 interface
 +
|Please refer to [[AN-BELK-006:_Enabling_dual_Gigabit_Ethernet_support_on_BoraEVB/BoraXEVB|this application note]] for second Ethernet interface support.
 
|-
 
|-
|Linux kernel <code>xconfig</code>
+
|0003
|<code>make xconfig</code> does not work
+
|BoraEVB/BoraXEVB
|-
+
|RTC
|Wayland not supported
+
|Date/time retention is limited to about 4 hours.
|Yocto QT5 images with Wayland backend is not yet supported
 
 
|-
 
|-
 +
|0004
 +
|BoraEVB/BoraXEVB
 +
|System clock runs slower
 +
|As per [https://xilinx-wiki.atlassian.net/wiki/spaces/A/pages/18841831/CPU+frequency+scaling#Missing%20Features,%20Known%20Issues%20and%20Limitations Xilinx issue], @333MHz (speedgrade -3) system clock is slower then expected
 
|}
 
|}
  
 
====Downloadable binary images====
 
====Downloadable binary images====
  
<b><i>TBD: mettere l'indirizzo giusto della directory in ''mirror''</i></b>
+
All binary images for BELK are hosted on [[mirror:bora|DAVE Embedded System mirror server]]. There you can find a sub directory for each version of this development kit.
  
All binary images for [[DESK-{{{kit-code}}}-L]] are hosted on [[mirror:axel|DAVE Embedded System mirror server]]. There you can find a sub directory for each version of this development kit.
+
U-boot performs 2-stage bootloader providing two files: <code>boot.bin</code> and <code>u-boot.img</code>. Both two files must be stored into SD card using <code>dd</code> command.
  
U-boot performs 2-stage bootloader providing two files: <code>SPL</code> and <code>u-boot.img</code>. Both two files must be stored into SD card using <code>dd</code> command.
 
 
 
<b><i>TBD: editare la tabella con i corretti piattaforme, dtb e link ai binari</i></b>
 
  
 
A summary of images with a brief description can be found into the table below:
 
A summary of images with a brief description can be found into the table below:
Line 134: Line 123:
 
|-
 
|-
 
| Platform  
 
| Platform  
| style="text-align: center" | SBCX rev.B
+
| style="text-align: center" | BORAXEVB
| style="text-align: center" | SBCX rev.B
 
|-
 
| Carrier Board [[ConfigID_and_UniqueID | ConfigID]]
 
| style="text-align: center" | 0012
 
| style="text-align: center" | 0013
 
|-
 
| LCD panel
 
| colspan="2" style="text-align: center" | Ampire 800 x 480 7" LVDS 262K colors (RGB666)<br>(AM-800480STMQW-TA1 or AM-800480SETMQW-TA1H)
 
|-
 
| Touchscreen
 
| style="text-align: center" | resistive
 
| style="text-align: center" | capacitive
 
 
|-
 
|-
 
| bootscript  
 
| bootscript  
| colspan="2" style="text-align: center" | [[mirror:axel/xelk-5.0.0/boot.scr|boot.scr]]
+
| [[mirror:bora/belk-4.1.4/boot.scr|boot.scr]]
 
|-
 
|-
| SPL  
+
| SPL
| colspan="2" style="text-align: center" | [[mirror:axel/xelk-5.0.0/xelk-5.0.0_mx6qdlaxel_spi_SPL|SPL (Quad / NOR)]] [[mirror:axel/xelk-5.0.0/xelk-5.0.0_mx6qdlaxel_nand_SPL|SPL (DualLite / NAND)]]  
+
| [[mirror:bora/belk-4.1.5/belk-4.1.5_bora_mmc_boot.bin|boot.bin]]
 
|-
 
|-
| u-boot.img
+
| u-boot
| colspan="2" style="text-align: center" | [[mirror:axel/xelk-5.0.0/xelk-5.0.0_mx6qdlaxel_spi_u-boot.img|(Quad / NOR)]] [[mirror:axel/xelk-5.0.0/xelk-5.0.0_mx6qdlaxel_nand_u-boot.img|(DualLite / NAND)]]  
+
| [[mirror:bora/belk-4.1.5/belk-4.1.5_bora_mmc_u-boot.img|u-boot.img]]
 
|-
 
|-
 
| Linux kernel  
 
| Linux kernel  
| colspan="2" style="text-align: center" | [[mirror:axel/xelk-5.0.0/xelk-5.0.0_uImage|uImage]]
+
| [[mirror:bora/belk-4.1.4/belk-4.1.4_uImage|uImage]]
 
|-
 
|-
| Device tree (Quad)
+
| Device tree
| [[mirror:axel/xelk-5.0.0/xelk-5.0.0_imx6q-sbcx-cb0012.dtb|imx6q-sbcx-cb0012.dtb]]
+
| [[mirror:bora/belk-4.1.4/belk-4.1.4_bora.dtb|bora.dtb]]  
| [[mirror:axel/xelk-5.0.0/xelk-5.0.0_imx6q-sbcx-cb0013.dtb|imx6q-sbcx-cb0013.dtb]]
 
|-
 
| Device tree (DualLite)
 
| [[mirror:axel/xelk-5.0.0/xelk-5.0.0_imx6dl-sbcx-cb0012.dtb|imx6dl-sbcx-cb0012.dtb]]
 
| [[mirror:axel/xelk-5.0.0/xelk-5.0.0_imx6dl-sbcx-cb0013.dtb|imx6dl-sbcx-cb0013.dtb]]
 
 
|}
 
|}
  
 
=== Release types ===
 
=== Release types ===
  
DESK release type can be:
+
BELK 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 DESK release
 
* '''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 DESK 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
 
* '''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, DESK 1.1.0 is a maintenance release, so it provides the DVDK released with the 1.0.0 major release; customers can easily upgrade to the 1.1.0 release by updating the software components as described in [[{{{nome-som}}} SOM/DESK-{{{kit-code}}}-L/Development/Synchronizing_git_repositories|Synchronizing git repositories]].
+
As an example, BELK 4.1.0 is a maintenance release, so it provides the DVDK released with the 4.0.0 major release; customers can easily upgrade to the 1.1.0 release by updating the software components as described in [[BORA Lite SOM/BELK-L/Development/Synchronizing_the_git_repositories|Synchronizing git repositories]].
 
 
=== Supported platforms ===
 
 
 
The following table reports the supported platforms in this DESK release:
 
 
 
{| class="wikitable"
 
|-
 
!Platform
 
!Description
 
|-
 
|[[SBC_Axel_SBC | ''SBC AXEL'']]
 
|Single Board Computer using {{{nome-som}}} SOM as [[{{{nome-som}}} SOM/{{{nome-som}}} Evaluation_Kit | Evaluation Kit]]
 
|-
 
|}
 
 
 
  
 
----
 
----
  
[[Category:{{{nome-som}}}]]
+
[[Category:BORA Lite]]

Revision as of 10:29, 23 September 2021

History
Version Issue Date Notes
1.0.0 Sep 2021 belk-4.1.5


Release Notes[edit | edit source]

DAVE Embedded Systems adds to the latest Linux BSP from Xilinx the customization required to support the SOC platform. For this reason most of the documentation provided by TBD (e.g. NXP) remains valid for the DESK development kit.

However, some customization is required, in particular at bootloader and linux kernel levels.

The following table reports the DESK releases information.

BELK version
Release number 4.1.5
Release type Minor (base on BELK 4.0.0 major release)
Status Released
Release date Sep 2021
Release notes Ver 4.1.5
Product support BORA Lite
MVM (distro version) Ubuntu 16.04
U-Boot version 2017.01-belk-4.1.5
Linux version 4.9.0-bora-4.1.4
Drivers

SPI NOR Flash (boot)
UART debug (2-wire)
USB OTG
SD/MMC
CAN

Ethernet0 gigabit
NAND
RTC
I2C
ConfigID

Vivado version 2017.1
Build System Yocto Morty (2.2)

BELK 4.1.5[edit | edit source]

200px-Emblem-important.svg.png

New MVM must be installed for using BELK-4.1.0. The VM is available for download on DAVE's BORA Reserved Area for registered users.

Release notes:

  • Updated u-boot version for BORA Lite support (updated defconfig for NOR and SD boot)

Known Limitations[edit | edit source]

The following table reports the known limitations of this BELK release:

ID Component Subsystem Description
0002 BoraEVB/BoraXEVB ETH1 interface Please refer to this application note for second Ethernet interface support.
0003 BoraEVB/BoraXEVB RTC Date/time retention is limited to about 4 hours.
0004 BoraEVB/BoraXEVB System clock runs slower As per Xilinx issue, @333MHz (speedgrade -3) system clock is slower then expected

Downloadable binary images[edit | edit source]

All binary images for BELK are hosted on DAVE Embedded System mirror server. There you can find a sub directory for each version of this development kit.

U-boot performs 2-stage bootloader providing two files: boot.bin and u-boot.img. Both two files must be stored into SD card using dd command.


A summary of images with a brief description can be found into the table below:

Image DESK version x.y.z
Platform BORAXEVB
bootscript boot.scr
SPL boot.bin
u-boot u-boot.img
Linux kernel uImage
Device tree bora.dtb

Release types[edit | edit source]

BELK 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 DESK 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, BELK 4.1.0 is a maintenance release, so it provides the DVDK released with the 4.0.0 major release; customers can easily upgrade to the 1.1.0 release by updating the software components as described in Synchronizing git repositories.