Bureaucrats, dave_user, Administrators
4,650
edits
Changes
no edit summary
{{InfoBoxTop}}
{{Applies To Bora}}
}}
==Quick reference==
{| class="wikitable" border="1"
|+Repository Information
|-
! Repository
| BSP Manifest
| Yocto BSP Layer
|-
! URL
| git@git.dave.eu:lynx/lynx-bsp.git
| git@git.dave.eu:lynx/meta-lynx.git
|-
! stable branch
| lynx-fido
| lynx-fido
|-
! stable tag
| xuelk-1.2.0
| xuelk-1.2.0
|}
{| class="wikitable" border="1"
|+Build targets
! Name
! Description
|-
| bora-image
| Minimal image
|-
| bora-image-devel
| This image include tools for development/debugging
|-
| bora-image-networking
| In addition <code>bora-image-devel</code>, this image provides several networking tools
|-
|<code>lynx-image-networking-sbc-lynx-xeno</code>
|With respect to the <code>lynx-image-networking</code> image, this includes additional libraries required to run the Linux kernel featuring the Xenomai real-time extension. For more details about it, please refer to https://xenomai.org/.
|}
==Introduction==
{{ImportantMessage|text=This process requires a lot of hardware resources in terms of disk storage, RAM, and processing power. For this reason, it also is recommended to consider the use of a physical machine. For more details on this topic, please refer to [[Advanced_use_of_Yocto_build_system_(BELK/BXELK)|this document]] which talks about the advanced use of the Yocto build system.}}
=== Initialize the build environment ===
BELK/BXELK Yocto BSP uses [https://code.google.com/p/git-repo/ git-repo] tool to fetch all the required git repositories. To install it, please use the following commands:
<pre class="workstation-terminal">
dvdk@dvdk-vm:~/lynxbelk$ curl http://commondatastorage.googleapis.com/git-repo-downloads/repo > repodvdk@dvdk-vm:~/lynxbelk$ chmod a+x repodvdk@dvdk-vm:~/lynxbelk$ ./repo init -u git@git.dave.eu:lynxbora/lynxbora-bsp.git -b lynxbora-fidomortydvdk@dvdk-vm:~/lynxbelk$ ./repo syncdvdk@dvdk-vm:~/belk$ source bora-bsp-init-env.sh
</pre>
=== Run Running the build === Please note that even the basic root file system requires a few hours to build on a mid/hi range desktop (4-6 cores, 8-12 GiB RAM) also depending on your Internet connection speed (all sources are fetched from the network). Nearly 20GiB of disk space is required for the build. Moreover, building inside the DVDK adds some overhead, The process may be slowed down significantly since the performances of a virtual machine are reduced if compared to the physical hardware. Thus, it's recommended to check the hardware capabilities of the host system and, when building with Yocto is required, developers should to consider the following options: * migrating Migrating the build system to a physical machine* assuming Assuming that the host system has the required resources, extending the hardware capabilities of the default DVDK MVM (eg: e.g. adding more cores and disk space).
Once completed the initialization phase, developers can launch the Yocto image build process with the following commands:
<pre class="workstation-terminal">
dvdk@dvdk-vm:~/lynx$ DISTRO=fsl-imx-fb MACHINE=sbc-lynx source lynx-setup-release.sh -b build-fb -e fbdvdk@dvdk-vm:~/lynxbelk/build$ bitbake lynx<target-image-networkingname>
</pre>
Where <code><target-image-name></code> is one of the images listed in [[#Quick sreference|here]].
=== Build Building additional packages ===
To build additional packages the user must first enter the directory where the <code>lynx-setup-release.sh</code> is placed and source it
The components listed in the table above can be kept in sync and up to date with DAVE Embedded Systems' repositories.