Bureaucrats, dave_user, Administrators
8,226
edits
Changes
no edit summary
<section begin="History" />
{| style="border-collapse:collapse; "
!colspan="4" style="width:100%; text-align:left"; border-bottom:solid 2px #ededed"|History
|-
|-
|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"|[[Building_the_Yocto_BSP_(XELK) | XELK2022/09/01]]|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"|Aug 2019Previous XELK release|-| 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" |{{oldid|14300|2021/07/21}}|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"|Previous XELK versionFirst DESK release|-| 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" |{{oldid|16284|2021/07/16}}| 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" |DESK-MX6-L 3.0.0 release|-| 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" |{{oldid|16988|2022/04/22}}| 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" |Added info for unauthenticated git protocol error|-! style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#ededed; padding:5px; color:#000000" |2023/04/06! style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#ededed; padding:5px; color:#000000" |DESK-MX6-L 4.0.0 release
|-
|}
<section end="History" /><section begin="Body" />
==Building the Yocto BSP==
===Quick reference===
{| class="wikitable" border="1"
!colspan="3" |Repository Information
|-
! Repository
! URL
| git@git.dave.eu:desk-mx-l/desk-mx-l-bsp.git
| git@git.dave.eu:desk-mx-l/meta-desk-mx.git
|-
! stable branch
| desk-mx-lkirkstone| sumokirkstone
|-
! stable tag
| desk-mxmx6-l-14.x0.x0| desk-mxmx6-l-14.x0.x0
|}
{| class="wikitable" border="1"
!colspan="2" |Build targets
|-
! Name
| This image include a X11 graphic backend
|-
| desk-mx-image-qt5qt6| This image include a Qt5 Qt6 graphic backend with OpenGL ES accelerated framebuffer
|}
For more information on the Linux filesystem, please refer to http://www.thegeekstuff.com/2010/09/linux-file-system-structure/.
''desk-mx-l'' provides one (or more) pre-built root file system, that can be used during the evaluation/development/deployment cycle. For instance, the root file system included in the <code>dave-image-devel</code> image is suited for the development phase, since it provides a relatively rich set of packages including tools and libraries used to debug the application code. The pre-built root file systems are located here: <code>/home/dvdk/desk-mx-l/rfs/<kit_name></code>.
Besides the pre-built root file systems, DAVE also provides a rich repository containing pre-built applications and libraries. These packages can be easily installed on the target by using the <code>dnf</code> tool. Please refer to [[Advanced_use_of_Yocto_build_system_(''desk-mx-l'')#Using_pre-built_package_archive|this section]] for more details.
===How to build the Yocto BSP images including the U-Boot binary file, the Linux kernel image, and the target root file system image===
{{ImportantMessage|text=The following procedure requires the access to the DAVE Embedded Systems' git repositories. The access to such repositories is granted to development kit's owners only. Please refer to [[Accessing_DAVE_Embedded_Systems_restricted_git_repositories|this page]] for detailed instructions on how to get it.}}
{{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.
Before running the build, the environment must be initialized properly.
[[AXEL_Lite_SOM/DESK-MX6-L | DESK-MX6-L]] 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@vagrant:~/desk-mx-l$ curl http://commondatastorage.googleapis.com/git-repo-downloads/repo-1 > repo
dvdk@vagrant:~/desk-mx-l$ chmod a+x repo
dvdk@vagrant:~/desk-mx-l$ ./repo init -u git@git.dave.eu:desk-mx-l/desk-mx-l-bsp.git -b refs/tags/desk-mx6-l-14.0.10
dvdk@vagrant:~/desk-mx-l$ ./repo sync
</pre>
===== unautheticated git protocol error =====
{{ImportantMessage|text=Since March 15th, 2022, GitHub stopped accepting DSA keys. RSA keys uploaded after Nov 2, 2021 will work only with SHA-2 signatures.
The deprecated MACs, ciphers, and unencrypted Git protocol are permanently disabled.<br>For more details on this topic, please refer to [[MISC-TN-015:_Yocto_and_git_protocol_error|this Technical Note]].}}
==== 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 80GiB of disk space is required for the build. 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, to consider the following options:
* Migrating the build system to a physical machine
* Assuming that the host system has the required resources, extending the hardware capabilities of the default MVM (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@vagrant:~/desk-mx-l/yocto$ DISTRO=fsl-imx-x11 MACHINE=desk-mx6 source desk-setup-release.sh -b build-x11dvdk@vagrant:~/desk-mx-l/yocto/build-x11$ bitbake desk-image-x11
</pre>
Where <code><target-image-name></code> is one of the images listed in [[#Quick reference|here]].
Once the build process is completed, the resulting files (the U-Boot binaries, the Linux kernel image, the device tree blob, the .tar.gz compressed root file system image, etc.) will be available in <code>build-x11/tmp/deploy/images/desk-mx-lmx6</code>using the environment prepared as stated above.
====Generating the SDKs====
==== Building additional packages ====
To build additional packages the user must first enter select the directory where ''DISTRO'' and source the <code>desk-mx-lsetup-bsp-init-envrelease.sh</code> is placed and source itscript
<pre class="workstation-terminal">
dvdk@vagrant:~/desk-mx-l/yocto$ DISTRO=fsl-imx-x11 MACHINE=desk-mx6 source desk-setup-release.sh -b build-x11
</pre>
<pre class="workstation-terminal">
dvdk@vagrant:~/desk-mx-l/build-x11$ bitbake memtestercanutils
</pre>
The resulting packages (the default format is <code>rpm</code>) can be found inside ''<code>build-x11/tmp/deploy/rpm''</code>.
<pre class="workstation-terminal">
dvdk@vagrant:~/desk-mx-l/build-x11$ ls -l tmp/deploy/rpm/cortexa9hf_neoncortexa9t2hf_neon/memtestercanutils-*-rw-r--r-- 1 dvdk dvdk 10692 Sep 12 16:05 tmp/deploy/rpm/cortexa9hf_neoncortexa9t2hf_neon/memtestercanutils-4.30.06-r0.cortexa9hf_neoncortexa9t2hf_neon.rpm-rw-r--r-- 1 dvdk dvdk 27693 Sep 12 16:05 tmp/deploy/rpm/cortexa9hf_neoncortexa9t2hf_neon/memtestercanutils-dbg-4.30.06-r0.cortexa9hf_neoncortexa9t2hf_neon.rpm-rw-r--r-- 1 dvdk dvdk 2872 Sep 12 16:05 tmp/deploy/rpm/cortexa9hf_neoncortexa9t2hf_neon/memtestercanutils-dev-4.30.06-r0.cortexa9hf_neoncortexa9t2hf_neon.rpmtmp/deploy/rpm/cortexa9t2hf_neon/canutils-rwdoc-r4.0.6--r-- 1 dvdk dvdk 5903 Sep 12 16:05 r0.cortexa9t2hf_neon.rpmtmp/deploy/rpm/cortexa9hf_neoncortexa9t2hf_neon/memtestercanutils-docsrc-4.30.06-r0.cortexa9hf_neoncortexa9t2hf_neon.rpm
</pre>