Bureaucrats, dave_user, Administrators
8,154
edits
Changes
no edit summary
{{Applies To Bora}}
{{Applies To BoraX}}
{{Applies To BoraLite}}
{{InfoBoxBottom}}
{{ObsoleteWikiPage|link=BORA_SOM/BELK-L/General/Release_Notes}}
__FORCETOC__
==Introduction==
From the software standpoint, [[Bora Embedded Linux Kit (BELK)|Bora Embedded Linux Kit (BELK)]] and [[BoraX_Embedded_Linux_Kit_(BXELK)|BoraX Embedded Linux Kit (BXELK)]] are built on top of Zynq Linux BSP released by Xilinx. Customization Customizations are added to support for the Bora and BoraX platforms, in particular at bootloader and Linux kernel levels. BELK and BXELK share the '''same''' software modules, even if they are based on different hardware platforms.
Reading of [[Host_setup_and_development_flow_(BXELK)|this document]] is strongly recommended to understand the logical structure of the kits and how the software components are related.
The following table details the software modules of BELK/BXELK releases.
{| class="wikitable"
!colspan="1012" | Kit composition!
|-
|'''Release number'''<br>BELK<br>BXELK
|<br>3.0.2<br>1.0.1
|<br>4.0.0<br>2.0.0
|<br>4.1.0<br>4.1.0
|<br>4.1.2<br>4.1.2
|<br>4.1.4<br>4.1.4
|-
|'''Status'''<br>BELK<br>BXELK
|<br>Released<br>n/a
|<br>Released<br>n/a
|<br>Released<br>Released
|<br>Released<br>Released
|<br>Released<br>Released
|<br>Released<br>Released
|<br>Released<br>Released
|<br>January 2017<br>January 2017
|<br>July 2017<br>July 2017
|<br>Jan 2020<br>Jan 2020
|<br>Sep 2020<br>Sep 2020
|<br>Jul 2021<br>Jul 2021
|-
|'''Release notes'''<br>BELK<br>BXELK
|<br>[[#BELK_3.0.2_.2F_BXELK_1.0.1 | Ver 3.0.2]]
|<br>[[#BELK_4.0.0_.2F_BXELK_2.0.0 | Ver 4.0.0]]
|<br>[[#BELK_4.1.0 | Ver 4.1.0]]
|<br> [[BELK/BXELK software components#BELK 4.1.2|Ver 4.1.2]]
|<br> [[BELK/BXELK software components#BELK 4.1.4|Ver 4.1.4]]
|-
|'''SOM PCB version'''<br>BELK<br><br>BXELK
|<br>CS020313B/CS020313C<br><br>CS112714B
|<br>CS020313B/CS020313C<br><br>CS112714B
|<br>CS020313B/CS020313C/CS061919<br><br>CS112714B
|<br>CS020313B/CS020313C/CS061919<br><br>CS112714B
|<br>CS020313B/CS020313C/CS061919<br><br>CS112714B
|--
|'''Supported carrier boards'''<br>BELK<br>BXELK
|<br>[[BoraEVB]]<br>n/a
|<br>[[BoraEVB]]<br>n/a
|<br>[[BoraEVB]]<br>[[BoraXEVB]]
|<br>[[BoraEVB]]<br>[[BoraXEVB]]
|<br>[[BoraEVB]]<br>[[BoraXEVB]]
|<br>[[BoraEVB]]<br>[[BoraXEVB]]
|<br>[[BoraEVB]]<br>[[BoraXEVB]]
|2014.07-belk-3.0.2
|2017.01-belk-4.0.1
|2017.01-belk-4.1.1
|2017.01-belk-4.1.2
|2017.01-belk-4.1.4
|-
|'''Linux version'''
|3.17.0-bora-3.0.0
|4.9.0-bora-4.0.0
|4.9.0-bora-4.1.0
|4.9.0-bora-4.1.4
|4.9.0-bora-4.1.4
|-
|'''Drivers'''
|valign="top" | -|valign="top" | -|valign="top" | Gigabit Eth #0<br>UART<br>NOR<br>NAND<br>SD/MMC<br>USB Host/Device<br>RTC<br>CAN<br>I2C|valign="top" | Gigabit Eth #0<br>UART<br>NOR<br>NAND<br>SD/MMC<br>USB Host/Device<br>RTC<br>CAN<br>I2C| valign="top" | Gigabit Eth #0<br>UART<br>NOR<br>NAND<br>SD/MMC<br>USB Host/Device<br>RTC<br>CAN<br>I2C<br>[[ConfigID_and_UniqueID | ConfigID]]| valign="top" | Gigabit Eth #0<br>UART<br>NOR<br>NAND<br>SD/MMC<br>USB Host/Device<br>RTC<br>CAN<br>I2C<br>[[ConfigID_and_UniqueID | ConfigID]]| valign="top" | Gigabit Eth #0<br>UART<br>NOR<br>NAND<br>SD/MMC<br>USB Host/Device<br>RTC<br>CAN<br>I2C<br>[[ConfigID_and_UniqueID | ConfigID]]|valign="top" | Gigabit Eth #0<br>UART<br>NOR<br>NAND<br>SD/MMC<br>USB Host/Device<br>RTC<br>CAN<br>I2C<br>[[ConfigID_and_UniqueID | ConfigID]]|valign="top" | Gigabit Eth #0<br>UART<br>NOR<br>NAND<br>SD/MMC<br>USB Host/Device<br>RTC<br>CAN<br>I2C<br>[[ConfigID_and_UniqueID | ConfigID]]|valign="top" | Gigabit Eth #0<br>UART<br>NOR<br>NAND<br>SD/MMC<br>USB Host/Device<br>RTC<br>CAN<br>I2C<br>[[ConfigID_and_UniqueID | ConfigID]]|valign="top" | Gigabit Eth #0<br>UART<br>NOR<br>NAND<br>SD/MMC<br>USB Host/Device<br>RTC<br>CAN<br>I2C<br>[[ConfigID_and_UniqueID | ConfigID]]|valign="top" | Gigabit Eth #0<br>UART<br>NOR<br>NAND<br>SD/MMC<br>USB Host/Device<br>RTC<br>CAN<br>I2C<br>[[ConfigID_and_UniqueID | ConfigID]]
|-
|'''Vivado version'''
|valign="top" | 2013.2|valign="top" | 2013.3|valign="top" | 2013.3|valign="top" | 2013.3|valign="top" | 2014.4|valign="top" | 2014.4|valign="top" | 2014.4|valign="top" | 2014.4| valign="top" | 2017.1| valign="top" | 2017.1| valign="top" | 2017.1|valign="top" | 2017.1
|-
|'''Build System'''
|valign="top" | -|valign="top" | -|valign="top" | -|valign="top" | Yocto Daisy (1.6)|valign="top" | Yocto Daisy (1.6)|valign="top" | Yocto Daisy (1.6)|valign="top" | Yocto Daisy (1.6)|valign="top" | Yocto Daisy (1.6)|valign="top" | Yocto Morty (2.12)| valign="top" | Yocto Morty (2.2)| valign="top" | Yocto Morty (2.2)| valign="top" | Yocto Morty (2.2)
|-
|'''[[Managed Virtual Machine (MVM)]]'''
|N/A
|belk-4.0.0 (based on Ubuntu 14.04 64 bit)
|belk-4.1.0 (based on Ubuntu 14.04 64 bit)
|belk-4.1.0 (based on Ubuntu 14.04 64 bit)
|belk-4.1.0 (based on Ubuntu 14.04 64 bit)
|}
**Linux kernel: <code>uImage</code>
**Device tree: <code>bora.dtb</code>
* For '''BELK-4.01.0''' or newer and '''BXELK-2.0.0''' or newer:
**U-Boot SPL: <code>boot.bin</code>
**U-Boot: <code>u-boot.img</code>
**Fpga [[BELK-AN-008:_Programming_the_FPGA_Bitstream_with_U-Boot|FPGA Bitstream]]: <code>fpga.bit</code>
**Linux kernel: <code>uImage</code>
**Device tree: <code>bora.dtb</code>}}
{| class="wikitable"
|-
! rowspan="2" |Image !! colspan="1" |BELK version !! colspan="1" |BXELK version
|-
| 4.01.0 4 || 24.01.0 4
|-
| mksd.sh || [[mirror:bora/belk-4.01.04/mksd.sh|mksd.sh]] || [[mirror:bora/belk-4.01.04/mksd.sh|mksd.sh]]
|-
| [[Working_with_the_Yocto_build_system#bootscript| bootscript ]] || [[mirror:bora/belk-4.01.04/boot.scr|boot.scr]] || [[mirror:bora/belk-4.01.04/boot.scr|boot.scr]]
|-
| U-Boot SPL (for uSD boot)|| [[mirror:bora/belk-4.01.04/belk-4.01.1_bora_mmc_boot4_bora_mmc_boot.bin|boot.bin]] || [[mirror:bora/belk-4.01.04/belk-4.01.1_borax_mmc_boot4_borax_mmc_boot.bin|boot.bin]]
|-
| U-Boot SPL (for NOR flash boot)|| [[mirror:bora/belk-4.01.04/belk-4.01.1_bora_qspi_boot4_bora_qspi_boot.bin|boot.bin]] || [[mirror:bora/belk-4.01.04/belk-4.01.1_borax_qspi_boot4_borax_qspi_boot.bin|boot.bin]]
|-
| U-Boot SPL (for uSD NAND flash boot)<br>(for BoraLite SOM) || [[mirror:bora/belk-4.01.04/belk-4.01.1_bora_mmc_u-boot4_bora_nand_boot.imgbin|u-boot.imgbin]] || [[mirror:bora/belk-4.0.0/belk-4.0.1_borax_mmc_u-boot.img|u-boot.img]]
|-
| U-Boot (for NOR flash uSD boot)|| [[mirror:bora/belk-4.01.04/belk-4.01.1_bora_qspi_u4_bora_mmc_u-boot.img|u-boot.img]] || [[mirror:bora/belk-4.01.04/belk-4.01.1_borax_qspi_u4_borax_mmc_u-boot.img|u-boot.img]]
|-
| Fpga Bitstream U-Boot (for NOR flash boot)|| [[mirror:bora/belk-4.01.04/belk-4.01.0_bora_fpga4_bora_qspi_u-boot.bitimg|fpgau-boot.bitimg]] || [[mirror:bora/belk-4.01.04/belk-4.01.0_borax_fpga4_borax_qspi_u-boot.bitimg|fpgau-boot.bitimg]]
|-
| Linux kernel U-Boot (for NAND flash boot)<br>(for BoraLite SOM)|| [[mirror:bora/belk-4.01.04/belk-4.01.4_bora_nand_u-boot.0_uImageimg|uImageu-boot.img]] || [[mirror:bora/belk-4.0.0/belk-4.0.0_uImage|uImage]]
|-
| Device tree [[BELK-AN-008:_Programming_the_FPGA_Bitstream_with_U-Boot|FPGA Bitstream]] || [[mirror:bora/belk-4.01.0/belk-4.01.0_bora0_bora_BASE_fpga.dtbbit|borafpga.dtbbit]] || [[mirror:bora/belk-4.01.0/belk-4.01.0_bora0_borax_BASE__fpga.dtbbit|borafpga.dtbbit]]
|-
| Linux kernel || [[mirror:bora/belk-4.1.4/belk-4.1.4_uImage|uImage]] || [[mirror:bora/belk-4.1.4/belk-4.1.4_uImage|uImage]]|-| Device tree || [[mirror:bora/belk-4.1.4/belk-4.1.4_bora.dtb|bora.dtb]] || [[mirror:bora/belk-4.1.4/belk-4.1.4_bora.dtb|bora.dtb]]|-|Root File System || [[mirror:bora/belk-4.01.04/belk-4.01.0_bora4_dave-image-devel-bora.tar.gzbz2|bora.tar.gzbz2]] || [[mirror:bora/belk-4.01.04/belk-4.01.0_bora4_dave-image-devel-bora.tar.gzbz2|bora.tar.gzbz2]]
|}
{| class="wikitable"
|-
! rowspan="2" |Image !! colspan="1" |BELK version !! colspan="1" |BXELK version
|-
| 3.0.2 || 1.0.1
| mksd.sh || [[mirror:bora/belk-3.0.2/mksd.sh|mksd.sh]] || [[mirror:bora/bxelk-1.0.1/mksd.sh|mksd.sh]]
|-
| [[Working_with_the_Yocto_build_system#bootscript |bootscript]]|| [[mirror:bora/belk-3.0.2/boot.scr|boot.scr]] || [[mirror:bora/bxelk-1.0.1/boot.scr|boot.scr]]
|-
| FSBL (QSPI) || [[mirror:bora/belk-3.0.2/belk-3.0.0_bora_fsbl.bin|fsbl.bin]] || [[mirror:bora/bxelk-1.0.1/belk-3.0.0_borax_fsbl.bin|fsbl.bin]]
|Root File System || [[mirror:bora/belk-3.0.2/belk-3.0.2_bora-image-devel-bora.tar.gz|bora.tar.gz]] || [[mirror:bora/belk-3.0.2/belk-3.0.2_bora-image-devel-bora.tar.gz|bora.tar.gz]]
|}
{| class="wikitable"
|-
! rowspan="2" |Image !! colspan="1" |BELK version !! colspan="1" |BXELK version
|-
| 3.0.1 || 1.0.0
|}
<section begin=microSDlayout/>===microSD layout===
The microSD card provided with BELK/BXELK is partitioned as shown in the following image:
** For '''BELK 4.0.0''' or newer and '''BXELK 2.0.0''' or newer:
***<code>boot.bin</code> u-boot SPL image
***<code>fpga.bit</code> optional Fpga [[BELK-AN-008:_Programming_the_FPGA_Bitstream_with_U-Boot|FPGA bitstream]]
***<code>u-boot.img</code> u-boot image
***U-Boot <code>boot.scr</code> bootscript
*an <code>ext3</code> partition (<code>mmcblk0p2</code>) containing the root file system for the target.
bootscript and root file system are used to boot the target as described in [[BoraX_Embedded_Linux_Kit_(BXELK)BELK/BXELK_Quick_Start_Guide#Target_setup_and_first_boot|this section]].
It is worth remembering that the microSD card is [[System boot and recovery via microSD card (BELK/BXELK)|bootable]] and U-Boot environment is retrieved from (and stored to with <code>saveenv</code>) into the FAT partition as <code>bora.env</code>
<section end=microSDlayout/>
==Updates==
{{ImportantMessage|text=It's recommended to use the latest source release available. Please refer to [[#Release_notes | Release notes]] for further information.}}
<section begin="Synchronizing" the="" git="" repositories="" />
<section begin=Synchronizingthegitrepositories/>
=== Updating git repositories ===
|-
|}
For more information about the access to these repositories, please refer to [[Build_system_(BELK/BXELK)Accessing_DAVE_Embedded_Systems_restricted_git_repositories#U-Boot_and_Linux_git_repositoriesPublic_key_access|this link]].
=== Updating the repositories from BELK 2.1.0 ===
When the account is enabled, you can synchronize a source tree entering the repository directory and launching the <code>git fetch</code> command. Please note that <code>git fetch</code> doesn't merge the commits on the current branch. To do that, you should run the <code>git merge</code> command or replace the ''fetch-merge'' process with a single <code>git pull</code> command. Please note that the recommended method is the ''fetch-merge'' process. For further information on Git, please refer to [http://git-scm.com/documentation Git Documentation].
<section end=Synchronizingthegitrepositories/>
<section begin=Releasenotes/>
== Release notes ==
=== BELK 4.1.4 ===
Updates:
# Fixes for MAC programming on [[BELK-TN-010: MAC address programming on OTP|NOR SPI OTP]]
==== Known Limitations ====
{| class="wikitable"
|-
!ID
!Component
!Subsystem
!Description
|-
|0001
|BoraEVB
|External DDR3 bank (BoraEVB only)
|DDR3 bank can be populated on request. For more details please refer to [mailto:sales@dave.eu Sales Department].
|-
|0002
|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.
|-
|0003
|BoraEVB/BoraXEVB
|RTC
|Date/time retention is limited to about 4 hours.
|-
|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
|}
=== BELK 4.1.2 ===
Updates:
# Added support for MAC programming on [[BELK-TN-010: MAC address programming on OTP|NOR SPI OTP]]
==== Known Limitations ====
{| class="wikitable"
|-
!ID
!Component
!Subsystem
!Description
|-
|0001
|BoraEVB
|External DDR3 bank (BoraEVB only)
|DDR3 bank can be populated on request. For more details please refer to [mailto:sales@dave.eu Sales Department].
|-
|0002
|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.
|-
|0003
|BoraEVB/BoraXEVB
|RTC
|Date/time retention is limited to about 4 hours.
|-
|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
|-
|0005
|Bora/BoraX/BoraLite SOM
|NOR QSPI flash
|Wrong QSPI flash size detection in belk-4.x.x: this issue has been fixed on u-boot repository:
* tag '''belk-4.1.3'''
* related commit 6074f0dc148d9e40e82fab9ad44ab24156323312
|}
=== BELK 4.1.0 ===
Updates:
# Added support for [https://www.dave.eu/products/som/xilinx/zynq-XC7Z010-XC7Z020_boralite BoraLite SOM]
==== Known Limitations ====
{| class="wikitable"
|-
!ID
!Component
!Subsystem
!Description
|-
|0001
|BoraEVB
|External DDR3 bank (BoraEVB only)
|DDR3 bank can be populated on request. For more details please refer to [mailto:sales@dave.eu Sales Department].
|-
|0002
|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.
|-
|0003
|BoraEVB/BoraXEVB
|RTC
|Date/time retention is limited to about 4 hours.
|-
|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
|}
=== BELK 4.0.0 / BXELK 2.0.0 ===
{| class="wikitable"
|-
!IssueID!Component!Subsystem
!Description
|-
|0001
|BoraEVB
|External DDR3 bank (BoraEVB only)
|DDR3 bank can be populated on request. For more details please refer to [mailto:sales@dave.eu Sales Department].
|-
|0002
|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.
|-
|0003
|BoraEVB/BoraXEVB
|RTC
|Date/time retention is limited to about 4 hours.
|-
|0004
|MVM
|MVM Eclipse cross-toolchain configuration
|Cross-toolchain configuration in Eclipse in the BELK MVM cannot be saved correctly.<br/>To fix the problem the following commands must be issued in the MVM terminal:
<pre>
cd /home/dvdk/bora/sdk/belk-4.0.0/sysroots/
</pre>
otherwise, the SDK can be updated for fixing this issues issue using [https://mirror.dave.eu/bora/belk-4.0.0/belk-4.0.1_sdk.sh this] file
|-
|0005
|MVM
|MVM Eclipse gdb remote debug
|Remote debug of an application using Eclipse and gdb is not working due to an issue with the Yocto SDK included in the BELK/BXELK MVM.
This issue will be fixed in next BELK/BXELK release. The SDK can be updated for fixing this issues issue using [https://mirror.dave.eu/bora/belk-4.0.0/belk-4.0.1_sdk.sh this] file|-|0006|MVM|Cross-building environment|The script <code>~/env.sh</code> does not set the CC variable properly.To fix this, please comment out the following line: <code>export CC=gcc</code>|-|0007|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
|-
|}
{| class="wikitable"
|-
|-
!ID
!Component
!Issue
!Description
|-
|0001
|BoraEVB
|External DDR3 bank (BoraEVB only)
|DDR3 bank can be populated on request. For more details please refer to [mailto:sales@dave.eu Sales Department].
|-
|0002
|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.
|-
|0003
|BoraEVB/BoraXEVB
|RTC
|Date/time retention is limited to about 4 hours.
|}
=== BELK/BXELK older releases ===
For BELK/BXELK older releases information, please click on Expand here below (on the right)
<div class="mw-collapsible mw-collapsed">
==== BELK 3.0.1 / BXELK 1.0.0 ====
Updates: added support for BoraX/BoraXEVB evaluation system
(BoraXEVB only) For LCD interfacing, please refer to [[AN-BELK-004:_Interfacing_BoraEVB/BoraXEVB_to_TFT_LCD_display|this application note]].
===== Known Limitations =====
{| class="wikitable"
|}
==== BELK 3.0.0 ====
Updates:
(BoraXEVB only) For LCD interfacing, please refer to [[AN-BELK-004:_Interfacing_BoraEVB/BoraXEVB_to_TFT_LCD_display|this application note]].
===== Known Limitations =====
{| class="wikitable"
|}
==== BELK 2.2.0 ====
Updates:
# Updated U-Boot and Linux versions
===== Known Limitations =====
{| class="wikitable"
|}
==== BELK 2.1.0 ====
Updates:
# First [[Advanced_use_of_Yocto_build_system_(BELK/BXELK)|Yocto Daisy (1.6) BSP Release]]
===== Known Limitations =====
{| class="wikitable"
|}
==== BELK 2.0.0 ====
Updates:
# Updated supported drivers list (please refer to [[Bora_Embedded_Linux_Kit_(BELK)#BELK_software_components | BELK_software_components]])
===== Known Limitations =====
The following table reports the known limitations of this BELK release:
|}
==== BELK 1.1.0 ====
Updates:
# Added application note "AMP on Bora"
==== BELK 1.0.0 ====
First official release
</div>
<section end=Releasenotes/>
