Difference between revisions of "Bora Embedded Linux Kit (BELK)"

From DAVE Developer's Wiki
Jump to: navigation, search
 
(99 intermediate revisions by 8 users not shown)
Line 1: Line 1:
{{WorkInProgress}}
 
 
{{InfoBoxTop}}
 
{{InfoBoxTop}}
 
{{Applies To Bora}}
 
{{Applies To Bora}}
 
{{InfoBoxBottom}}
 
{{InfoBoxBottom}}
  
==Introduction==
+
{{ObsoleteWikiPage|link=DESK-XZ7-L}}
 +
 
 +
{{ImportantMessage|text='''For BELK 3.0.2 or older, the boot process was based on the FSBL+second-stage bootloader (U-Boot) combination. From BELK 4.0.0 on, the boot process is based on the first-stage bootloader (U-Boot SPL)+second-stage bootloader (U-Boot) combination.'''
 +
}}
 +
 
 +
<section begin="Unboxing" />
 +
==Unboxing==
 +
 
 +
[[File:Belk_01.png|500px]]
  
 
Bora Embedded Linux Kit (BELK for short) provides all the necessary components required to set up the developing environment for:
 
Bora Embedded Linux Kit (BELK for short) provides all the necessary components required to set up the developing environment for:
* configuring the system (PS and PL) at hardware level
+
* building the first-stage bootloader:
* build the first-stage bootloader (FSBL)
+
** FSBL for BELK 3.0.2 or older
* building the second stage bootloader (U-Boot)
+
** U-boot SPL for BELK 4.0.0 or newer
 +
* building the second-stage bootloader (U-Boot)
 
* building and running Linux operating system on Bora-based systems
 
* building and running Linux operating system on Bora-based systems
* building Linux applications that will run on the target
+
* building Linux applications that will run on the target.
  
Dave provides all the customization required (in particular at bootloader and Linux kernel levels) to enable customers use the standard Zynq-7000 development tools for building all the firmware/software components that will run on the target system.
+
'''DAVE Embedded Systems''' provides all the customization required (in particular at bootloader and Linux kernel levels) to enable customers to use the standard Zynq-7000 development tools for building all the firmware/software components that will run on the target system.
 +
<section end="Unboxing" />
  
==Kit Contents==
+
<section begin="Kit Content" />
 +
==Kit contents==
  
{| class="wikitable"  
+
{| class="wikitable" style="margin: auto;"
 
|-
 
|-
 
!Component
 
!Component
Line 23: Line 33:
 
!Notes
 
!Notes
 
|-
 
|-
|style="text-align: center;" | [[File:Bora5-small.jpg|60px]]
+
| style="text-align: center;" | [[File:Bora5-small.jpg|60px]]
|Bora SOM<br>CPU: Xilinx Zynx 7000
+
|[[:Category:Bora|Bora]] SOM  
|Please refer to [[Hardware Manual (Bora) | Bora Hardware Manual]]
+
 
 +
Default option is DBRF4110S2R (see [[#Order codes|Order codes]] for more options)
 +
*SoC: Xilinx XC7Z020 (866Mhz, Speed "-3", Tj 0-100°C)
 +
*SDRAM: 1 GB DDR3
 +
*NOR: bootable SPI flash 16 MB
 +
*NAND: 1GB (SLC)
 +
|
 +
* For more details, please refer to the[[Hardware Manual (Bora) | Bora Hardware Manual]]
 +
* By default, ARM cores frequency is set to 667 MHz and the [[Creating and building example Vivado project (BELK/BXELK)|example 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:Boraevb-lite-01.png|80px]]
+
| style="text-align: center;" | [[File:Boraevb-02.png|80px]]
|Bora-EVB-Lite Carrier board
+
|BORA Carrier board
|Please refer to [[BoraEVB-Lite | BoraEVB-Lite]] page
+
|Se also the[[BoraEVB | BoraEVB]] page
 
|-
 
|-
|style="text-align: center;" | [[File:Alimentatore.jpg|40px]]
+
| style="text-align: center;" | [[File:Alimentatore.jpg|40px]]
 
|AC/DC Single Output Wall Mount adapter<br>Output: +12V – 2.0 A
 
|AC/DC Single Output Wall Mount adapter<br>Output: +12V – 2.0 A
 
|Please refer to Belk Quick Start Guide
 
|Please refer to Belk Quick Start Guide
 
|-
 
|-
|style="text-align: center;" | [[File:ProdSDC-MBLY-thumb.png|50px]]
+
| [[File:FTDI-CHIPI-X10.png|60px|center]]
|MicroSDHC card with SD adapter and USB adapter
+
|FTDI USB/RS232 cable adapter<br>
|Please refer to Belk Quick Start Guide
+
|FTDI code: [https://ftdichip.com/products/chipi-x10/ CHIPI-X10]
 +
|-
 +
| [[File:EVK-kit-DB9-serial-cable.png.png|60px|center]]
 +
| D9 Female to D9 Female null modem cable
 +
|
 +
|-
 +
| [[File:Sandisk_Industrial_32GB.png|60px|center]]
 +
| MicroSDHC card
 +
|
 
|-
 
|-
 
|}
 
|}
  
==Logical structure of Bora Embedded Linux Kit (BELK)==
+
===Order codes===
To understand the structure of BELK, it is necessary to describe the basic organization of Xilinx Vivado Design Suite/Xilinx SDK and to recall briefly the recent history of development tools provided by Xilinx.
+
{| class="wikitable" style="margin: auto;"
===A little bit of history===
+
|+
At the time of this writing (October 2013) Xilinx is migrating from mature ISE 14.x Design Suite - that should be the last series of this suite - to the new Vivado environment. Both are composed by several programs and some of these are in common. From the general standpoint, the main difference between ISE and Vivado - even if ISE does support Zynq - is the the latter has been expressively conceived to support newer SOC architectures such as Zynq, besides traditional FPGAs. Thus, adopting Vivado as the default environment for BELK would seem the natural choice. However, the migration process mentioned above has just begun and the majority of application notes and reference designs released by Xilinx still refers to ISE suite. Plus Vivado is still a little bit "green" and several bug fixes and improvements are introduced by every new release.
+
!Order code
 +
!Description
 +
|-
 +
|BELK-L-S-S
 +
|This code refers to the default configuration detailed above
 +
|-
 +
|}
  
Since Bora was presented in 2013 and because this product addresses long longevity markets such as industrial and biomedical, DAVE chose to build BELK upon Vivado that undoubtedly represents today the future of Xilinx development environments.
+
<section end="Kit Content" />
===Basic structure of Vivado Design Suite and integration into BELK===
 
Vivado/SDK (1) can be viewed as a collection of programs required to deal with all of the development aspects related to Xilinx components (software running on ARM cores, FPGA fabric verification and programming, power estimation etc.). These include strictly FPGA-related tools such as Floorplanner and pure-software development tools such as SDK.
 
The ambitious objective is to provide a complete, user friendly, integrated environment that allows software developers to deal with FPGA development even if they are not familiar with this technology, by hiding a lot of its complexities (2). As usual this ease of use comes at the expence of control and flexibility. This could not be acceptable in many cases where engineers need to control and customize many aspects of the project to implement what is required by system specifications. For this reason BELK has been built around Vivado but some deviations from the default development approach suggested by Xilinx have been introduced, in order to push the modularization and the maintainability of the projects to the maximum extent.
 
 
 
The following pictures are retrieved from BELK Quick Start Guide and shows respectively the Vivado/SDK default development flow and how this has been integrated in the BELK infrastructure.
 
 
 
[[File:Belk-vivado-sdk-development-flow.png|thumbnail|center|300px|Vivado/SDK development flow]]
 
[[File:Belk-vivado-sdk-integration.png|thumbnail|center|300px|Vivado/SDK integration into BELK]]
 
  
 +
==Logical structure of Bora Embedded Linux Kit (BELK)==
 +
Please refer to [[Logical_structure_of_Bora_and_BoraX_Embedded_Linux_Kits_(BELK/BXELK)|this page]].
  
(1) The Software Development Kit (SDK) is the Xilinx Integrated Design Environment for creating embedded applications on Zynq™-7000 All Programmable SoCs. SDK is the first application IDE to deliver true homogenous and heterogenous multi-processor design and debug, it is optionally included with the Vivado Design Suite or ISE Design Suite, or available as a separate free download for application developers.
+
== BELK software components ==
 +
Please refer to [[BELK/BXELK_software_components|this page]].
  
(2) Nevertheless FPGA developers will find all the traditional tools that allow complete control of FPGA fabric.
+
==Quick start guide==
 +
Please refer to [[BELK/BXELK_Quick_Start_Guide|this page]].
 +
==Physical devices mapping==
 +
Please refer to [[Physical_devices_mapping_(BELK/BXELK)|this page]].
 +
==Advanced topics==
 +
===Debugging with Eclipse===
 +
Please refer to [[Debugging with Eclipse (MVM)|this page]].
 +
===ConfigID feature===
 +
Please refer to [[ConfigID_management_(BELK/BXELK)|this page]].
  
 
== Related Documents ==
 
== Related Documents ==
Line 65: Line 100:
 
* [[Hardware Manual (Bora) | Bora Hardware Manual]]
 
* [[Hardware Manual (Bora) | Bora Hardware Manual]]
 
* [[BoraEVB-Lite | BoraEVB-Lite]]
 
* [[BoraEVB-Lite | BoraEVB-Lite]]
* Belk Quick Start Guide (available for BELK kit owners)
+
* [[BoraEVB | BORAEVB]]
 +
* [[BELK/BXELK Quick Start Guide]]
 +
* [[FAQs_(Bora) | BORA FAQs]]

Latest revision as of 16:06, 31 January 2024

Info Box
Bora5-small.jpg Applies to Bora



Attention.png THIS PAGE IS OBSOLETE, DON'T USE IT AS REFERENCE
The new documentation is available here: DESK-XZ7-L


200px-Emblem-important.svg.png

For BELK 3.0.2 or older, the boot process was based on the FSBL+second-stage bootloader (U-Boot) combination. From BELK 4.0.0 on, the boot process is based on the first-stage bootloader (U-Boot SPL)+second-stage bootloader (U-Boot) combination.


Unboxing[edit | edit source]

Belk 01.png

Bora Embedded Linux Kit (BELK for short) provides all the necessary components required to set up the developing environment for:

  • building the first-stage bootloader:
    • FSBL for BELK 3.0.2 or older
    • U-boot SPL for BELK 4.0.0 or newer
  • building the second-stage bootloader (U-Boot)
  • building and running Linux operating system on Bora-based systems
  • building Linux applications that will run on the target.

DAVE Embedded Systems provides all the customization required (in particular at bootloader and Linux kernel levels) to enable customers to use the standard Zynq-7000 development tools for building all the firmware/software components that will run on the target system.


Kit contents[edit | edit source]

Component Description Notes
Bora5-small.jpg Bora SOM

Default option is DBRF4110S2R (see Order codes for more options)

  • SoC: Xilinx XC7Z020 (866Mhz, Speed "-3", Tj 0-100°C)
  • SDRAM: 1 GB DDR3
  • NOR: bootable SPI flash 16 MB
  • NAND: 1GB (SLC)
  • For more details, please refer to the Bora Hardware Manual
  • By default, ARM cores frequency is set to 667 MHz and the example 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 section.
Boraevb-02.png BORA Carrier board Se also the BoraEVB page
Alimentatore.jpg AC/DC Single Output Wall Mount adapter
Output: +12V – 2.0 A
Please refer to Belk Quick Start Guide
FTDI-CHIPI-X10.png
FTDI USB/RS232 cable adapter
FTDI code: CHIPI-X10
EVK-kit-DB9-serial-cable.png.png
D9 Female to D9 Female null modem cable
Sandisk Industrial 32GB.png
MicroSDHC card

Order codes[edit | edit source]

Order code Description
BELK-L-S-S This code refers to the default configuration detailed above


Logical structure of Bora Embedded Linux Kit (BELK)[edit | edit source]

Please refer to this page.

BELK software components[edit | edit source]

Please refer to this page.

Quick start guide[edit | edit source]

Please refer to this page.

Physical devices mapping[edit | edit source]

Please refer to this page.

Advanced topics[edit | edit source]

Debugging with Eclipse[edit | edit source]

Please refer to this page.

ConfigID feature[edit | edit source]

Please refer to this page.

Related Documents[edit | edit source]