Difference between revisions of "BoraX Embedded Linux Kit (BXELK)"

From DAVE Developer's Wiki
Jump to: navigation, search
(Quick start guide)
 
(30 intermediate revisions by 4 users not shown)
Line 2: Line 2:
 
{{Applies To BoraX}}
 
{{Applies To BoraX}}
 
{{InfoBoxBottom}}
 
{{InfoBoxBottom}}
==Introduction==
 
  
 +
{{ObsoleteWikiPage|link=DESK-XZ7-L}}
  
[[File:TBD.png|thumb|center|100px|BoraX SOM]]
+
{{ImportantMessage|text='''For BXELK 1.0.1 or older, the boot process was based on the FSBL+second-stage bootloader (U-Boot) combination. From BXELK 2.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:BORA_Xpress.png|thumb|center|400px|BoraX SOM]]
 +
 +
 +
BoraX Embedded Linux Kit (BXELK for short) provides all the necessary components required to set up the developing environment for:
 +
* building the first-stage bootloader:
 +
**FSBL for BXELK 1.0.1 or older
 +
**U-boot SPL for BXELK 2.0.0 or newer
 +
* building the second-stage bootloader (U-Boot)
 +
* building and running Linux operating system on [[BORA_Xpress_SOM|BORA Xpress SOM]]
 +
* building and debugging applications that will be executed on top of Yocto-based Linux distribution running on the target.
  
BoraX Embedded Linux Kit (BXELK for short) provides all the necessary components required to set up the developing environment to:
 
* build the first-stage bootloader (FSBL)
 
* build the 2nd-stage bootloader (U-Boot)
 
* build and run Linux operating system on [[:Category:BoraX|BoraX system-on-module (SOM)]]
 
* build and debug applications that will be executed on top of Yocto-based Linux distribution running on the target.
 
 
The main kit components are:
 
The main kit components are:
* hardware platform, composed by [[:Category:BoraX|BoraX SOM]] and [[BoraXEVB]]
+
* hardware platform, composed by [[BORA_Xpress_SOM|BORA Xpress SOM]] and [[BORA_Xpress_SOM/BORA_Xpress_Evaluation_Kit | BORA Xpress Evalutation kit]]
 +
* source code of target software
 
* technical documentation (hardware manuals, mechanical drawings, reference schematics, application notes etc.)
 
* technical documentation (hardware manuals, mechanical drawings, reference schematics, application notes etc.)
 +
<section end="Unboxing" />
 +
<section begin="Kit Content" />
  
==Kit content==
+
==Kit contents==
 
+
{| class="wikitable" style="margin: auto;"
{| class="wikitable"  
 
 
|-
 
|-
 
!Component
 
!Component
Line 25: Line 36:
 
!Notes
 
!Notes
 
|-
 
|-
|style="text-align: center;" | [[File:TBD.png|60px]]
+
| style="text-align: center;" | [[File:BORA_Xpress.png|60px]]
|BoraX SOM (p/n DBXF4110D2R)<br>
+
|[[BORA Xpress SOM|BORA Xpress]] SOM (p/n DBXF4110S2R)<br>
 
*SoC: Xilinx XC7Z030 (866Mhz, Speed "-3", Tj 0-100°C)
 
*SoC: Xilinx XC7Z030 (866Mhz, Speed "-3", Tj 0-100°C)
 
*SDRAM: 1 GB DDR3
 
*SDRAM: 1 GB DDR3
Line 32: Line 43:
 
*NAND: 1GB (SLC)
 
*NAND: 1GB (SLC)
 
|
 
|
 +
* For more details, please refer to the[[BORA_Xpress_SOM/BORA_Xpress_Hardware | BORA Xpress 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:TBD.png|40px]]
+
| style="text-align: center;" | [[File:BoraXEVB-01.png|60px]]
|[[BoraXEVB]] carrier board
+
|[[BORA_Xpress_SOM/BORA_Xpress_Evaluation_Kit | BORA Xpress]] Carrier board
 
|
 
|
 
|-
 
|-
|style="text-align: center;" | [[File:Alimentatore.jpg|40px]]
+
| style="text-align: center;" | [[File:Alimentatore.jpg|40px]]
 
|AC/DC Single Output Wall Mount adapter<br>
 
|AC/DC Single Output Wall Mount adapter<br>
 
Output: +12V – 2.0 A
 
Output: +12V – 2.0 A
 
|
 
|
 
|-
 
|-
|style="text-align: center;" | [[File:ProdSDC-MBLY-thumb.png|50px]]
+
| style="text-align: center;" | [[File:ProdSDC-MBLY-thumb.png|50px]]
|MicroSDHC card with SD adapter and USB adapter
+
|microSDHC card with SD adapter and USB adapter
 
|
 
|
 
|-
 
|-
 
|}
 
|}
 +
 +
===Order codes===
 +
{| class="wikitable" style="margin: auto;"
 +
|+
 +
!Order code
 +
!Description
 +
|-
 +
|BXELK-H-S
 +
|This code refers to the default configuration detailed above
 +
|-
 +
|BXELK-H-S-D
 +
|This variant is like BELK-L-S, except the SOM, which is DBXD4110S2R.
 +
|}
 +
<section end="Kit Content" />
  
 
==Logical structure of BXELK==
 
==Logical structure of BXELK==
Line 55: Line 82:
  
 
==Quick start guide==
 
==Quick start guide==
This chapter describes how to quickly start working with the BXELK kit. The following paragraphs will guide you through the setup and installation procedures.
+
Please refer to [[BELK/BXELK_Quick_Start_Guide|this page]].
===Kit registration===
 
{{ImportantMessage|text='''Customers are strongly recommended to register their kits'''. Registration grants access to reserved material such as source code and additional documentation.}}
 
 
 
Please register your development kit by sending an email to [mailto:support-bora@dave.eu support-bora@dave.eu], providing the kit P/N and CODE.
 
 
 
===Target setup and first boot===
 
This section describes how to quickly start BoraX/BoraXEVB system included in the BXELK:
 
*on target side, connect a null-modem cable on J17 DB9 connector, denoted also as UART1
 
*on host side, connect the other end of the null-modem cable to a COM port and start your favorite terminal software that will be used to interact with the target's serial console; communication parameters are 115200-8-N-1
 
*optionally connect the BoraXEVB board to an Ethernet LAN by plugging cable into connector J8, also denoted as BORAX ETHERNET
 
*connect 12V power supply to JP2 connector, also denoted as PSU 12V JACK
 
*insert the microSD card in the slot J21, also denoted as MICROSD.
 
 
 
 
 
[[File:TBD.png|thumb|center|600px|Target setup for first boot]]
 
 
 
 
 
Once power has been applied to the target, FSBL and U-Boot bootloaders will be fetched from the SPI NOR flash that equips BoraX SOM and executed. Boot messages will be printed out to the serial console. Redundant U-Boot environment is stored in the NOR flash as well, as depicted in the following image.
 
 
 
 
 
[[File:TBD.png|thumb|center|350px|NOR flash default partitioning]]
 
 
 
 
 
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 [[#BXELK 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">
 
TBD
 
</pre>
 
 
 
 
 
 
 
[1] <code>bootscript</code> is used to do this task.
 
 
 
===Host setup===
 
Please refer to [[Host setup (BXELK)|this page]].
 
===Target configuration for the development stage (<code>net_nfs</code>)===
 
During the development stage, the target is usually connected via Ethernet LAN to the host machine and is configured to:
 
*retrieve binary images (i.e. Linux kernel) via TFTP protocol
 
*mount the development root file system via NFS protocol. This root file system is physically in the file system of the host machine as depicted [[Deploying_Embedded_Linux_Systems#The_development_environment|here]].
 
In DAVE Embedded Systems development kits, this configuration is generally denoted as <code>net_nfs</code>. U-Boot bootloader supports this configuration. Some U-Boot environment variables are needed to set it up. They are detailed [[Booting_Linux_Kernel#Configuration_net_nfs|here]].
 
 
 
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_(BXELK)|this page]].
 
  
 
==Physical devices mapping==
 
==Physical devices mapping==
Please refer to [[Physical_devices_mapping_(BXELK)|this page]].
+
Please refer to [[Physical_devices_mapping_(BELK/BXELK)|this page]].
 
==Advanced topics==
 
==Advanced topics==
 
===Debugging with Eclipse===
 
===Debugging with Eclipse===
 
Please refer to [[Debugging with Eclipse (MVM)|this page]].
 
Please refer to [[Debugging with Eclipse (MVM)|this page]].
 +
===ConfigID feature===
 +
Please refer to [[ConfigID_management_(BELK/BXELK)|this page]].

Latest revision as of 16:05, 31 January 2024

Info Box
BORA Xpress.png Applies to BORA Xpress



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 BXELK 1.0.1 or older, the boot process was based on the FSBL+second-stage bootloader (U-Boot) combination. From BXELK 2.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]

BoraX SOM


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

  • building the first-stage bootloader:
    • FSBL for BXELK 1.0.1 or older
    • U-boot SPL for BXELK 2.0.0 or newer
  • building the second-stage bootloader (U-Boot)
  • building and running Linux operating system on BORA Xpress SOM
  • building and debugging applications that will be executed on top of Yocto-based Linux distribution running on the target.

The main kit components are:

  • hardware platform, composed by BORA Xpress SOM and BORA Xpress Evalutation kit
  • source code of target software
  • technical documentation (hardware manuals, mechanical drawings, reference schematics, application notes etc.)


Kit contents[edit | edit source]

Component Description Notes
BORA Xpress.png BORA Xpress SOM (p/n DBXF4110S2R)
  • SoC: Xilinx XC7Z030 (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 Xpress 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.
BoraXEVB-01.png BORA Xpress Carrier board
Alimentatore.jpg AC/DC Single Output Wall Mount adapter

Output: +12V – 2.0 A

ProdSDC-MBLY-thumb.png microSDHC card with SD adapter and USB adapter

Order codes[edit | edit source]

Order code Description
BXELK-H-S This code refers to the default configuration detailed above
BXELK-H-S-D This variant is like BELK-L-S, except the SOM, which is DBXD4110S2R.


Logical structure of BXELK[edit | edit source]

Please refer to this page.

BXELK 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.