Template:Yocto Build Release IMX: Difference between revisions
From Variscite Wiki
No edit summary |
|||
(52 intermediate revisions by 5 users not shown) | |||
Line 1: | Line 1: | ||
<includeonly>{{#vardefine:GITHUB_WARNING|{{#ifexpr: {{#var:YOCTO_VERSION}} < 2.3 |{{Note|'''Warning:''' Due to a GitHub policy change, it is necessary to add HTTPS mirrors to local.conf for Yocto Morty and older. Please refer to [[:Yocto_Common_Errors#GitHub Git protocol on port 9418|Yocto Common Errors]].}}}}}}<!-- | <includeonly>{{#vardefine:GITHUB_WARNING|{{#ifexpr: {{#var:YOCTO_VERSION}} < 2.3 |{{Note|'''Warning:''' Due to a GitHub policy change, it is necessary to add HTTPS mirrors to local.conf for Yocto Morty and older. Please refer to [[:Yocto_Common_Errors#GitHub Git protocol on port 9418|Yocto Common Errors]].}}}}}}<!-- | ||
--> {{PageHeader|{{#var:HARDWARE_NAME}} - Yocto {{#var:YOCTO_NAME}} {{#var:YOCTO_VERSION}} based on FSL Community BSP {{#var:FSLC_BSP_VERSION}} with {{#var:FSL_BSP_VERSION}} Linux release}} {{DocImage|category1=Yocto|category2={{#var:HARDWARE_NAME}}}} __toc__ | --> {{PageHeader|{{#var:HARDWARE_NAME}} - Yocto {{#var:YOCTO_NAME}} {{#var:YOCTO_VERSION}} based on {{#varexists:FSLC_BSP_VERSION|FSL Community BSP {{#var:FSLC_BSP_VERSION}}|NXP BSP {{#var:FSL_BSP_VERSION}}}} with {{#var:FSL_BSP_VERSION}} Linux release}} {{DocImage|category1=Yocto|category2={{#var:HARDWARE_NAME}}}} __toc__ | ||
<!-- Set local variables | <!-- Set local variables | ||
Line 11: | Line 11: | ||
-->{{#vardefine:UBUNTU_COMPAT|{{#ifeq:{{#var:YOCTO_NAME}}|Zeus|18.04|{{#var:UBUNTU_COMPAT}}}}}}<!-- | -->{{#vardefine:UBUNTU_COMPAT|{{#ifeq:{{#var:YOCTO_NAME}}|Zeus|18.04|{{#var:UBUNTU_COMPAT}}}}}}<!-- | ||
-->{{#vardefine:UBUNTU_COMPAT|{{#ifexpr: {{#var:YOCTO_VERSION}} >= 3.1|18.04/20.04|{{#var:UBUNTU_COMPAT}}}}}}<!-- | -->{{#vardefine:UBUNTU_COMPAT|{{#ifexpr: {{#var:YOCTO_VERSION}} >= 3.1|18.04/20.04|{{#var:UBUNTU_COMPAT}}}}}}<!-- | ||
-->{{#vardefine:UBUNTU_COMPAT|{{#ifexpr: {{#var:YOCTO_VERSION}} >= 4.0|18.04/20.04/22.04|{{#var:UBUNTU_COMPAT}}}}}} | -->{{#vardefine:UBUNTU_COMPAT|{{#ifexpr: {{#var:YOCTO_VERSION}} >= 4.0|18.04/20.04/22.04|{{#var:UBUNTU_COMPAT}}}}}}<!-- | ||
-->{{#vardefine:UBUNTU_COMPAT|{{#ifexpr: {{#var:YOCTO_VERSION}} >= 4.2|20.04/22.04|{{#var:UBUNTU_COMPAT}}}}}} | |||
= Installing required packages = | = Installing required packages = | ||
Please make sure your host PC is running Ubuntu {{#var:UBUNTU_COMPAT}} 64-bit and is up to date: | Please make sure your host PC is running Ubuntu {{#var:UBUNTU_COMPAT}} 64-bit and is up to date: | ||
Line 17: | Line 19: | ||
Then, install the following packages: | Then, install the following packages: | ||
{{#if:{{#var:BUILD_YOCTO_IN_DOCKER_CONTAINER}}| | |||
$ sudo apt-get install python3 python3-pip python3-pexpect \ | |||
python3-git python3-jinja2 python3-subunit python3-git liblz4-tool \ | |||
python3-jinja2 python3-subunit curl zstd | |||
For Ubuntu 20.04 and earlier, install python2: | |||
$ sudo apt-get install python python-pysqlite2 | |||
{{#ifexpr:{{#rpos:{{#var:UBUNTU_COMPAT}}|16.04}} >= 0|{{Ubuntu16_Python}}|}}<!-- | |||
-->{{#ifexpr:{{#rpos:{{#var:UBUNTU_COMPAT}}|22.04}} >= 0|{{Ubuntu22_Python}}|}} | |||
Install Docker: | |||
$ sudo apt update && sudo apt install docker.io qemu-user-static | |||
Give permissions to run Docker without sudo: | |||
$ sudo usermod -aG docker ${USER} | |||
{{Note|'''Note:''' Logout and login again for permissions to take effect.}} | |||
| | |||
$ sudo apt-get install gawk wget git diffstat unzip texinfo gcc-multilib \ | $ sudo apt-get install gawk wget git diffstat unzip texinfo gcc-multilib \ | ||
build-essential chrpath socat cpio | build-essential chrpath socat cpio python3 python3-pip python3-pexpect \ | ||
xz-utils debianutils iputils-ping libsdl1.2-dev xterm libyaml-dev libssl-dev | xz-utils debianutils iputils-ping libsdl1.2-dev xterm libyaml-dev libssl-dev | ||
$ sudo apt-get install autoconf libtool libglib2.0-dev libarchive-dev \ | $ sudo apt-get install autoconf libtool libglib2.0-dev libarchive-dev \ | ||
sed cvs subversion coreutils texi2html docbook-utils | sed cvs subversion coreutils texi2html docbook-utils \ | ||
help2man make gcc g++ desktop-file-utils libgl1-mesa-dev libglu1-mesa-dev \ | help2man make gcc g++ desktop-file-utils libgl1-mesa-dev libglu1-mesa-dev \ | ||
mercurial automake groff curl lzop asciidoc u-boot-tools dos2unix mtd-utils pv \ | mercurial automake groff curl lzop asciidoc u-boot-tools dos2unix mtd-utils pv \ | ||
Line 30: | Line 54: | ||
{{#ifexpr: {{#var:YOCTO_VERSION}} >= 3.1| | {{#ifexpr: {{#var:YOCTO_VERSION}} >= 3.1| | ||
$ sudo apt-get install python3-git | $ sudo apt-get install python3-git liblz4-tool python3-jinja2 python3-subunit locales libacl1 | ||
| | | | ||
$ sudo apt-get install python-git | $ sudo apt-get install python-git | ||
}} | }} | ||
For Ubuntu 20.04 and earlier, install python2: | |||
$ sudo apt-get install python python-pysqlite2 | |||
{{#ifexpr:{{#rpos:{{#var:UBUNTU_COMPAT}}|16.04}} >= 0|{{Ubuntu16_Python}}|}}<!-- | {{#ifexpr:{{#rpos:{{#var:UBUNTU_COMPAT}}|16.04}} >= 0|{{Ubuntu16_Python}}|}}<!-- | ||
-->{{#ifexpr:{{#rpos:{{#var:UBUNTU_COMPAT}}|22.04}} >= 0|{{Ubuntu22_Python}}|}} | -->{{#ifexpr:{{#rpos:{{#var:UBUNTU_COMPAT}}|22.04}} >= 0|{{Ubuntu22_Python}}|}} | ||
Line 39: | Line 67: | ||
{{Note|'''Note:''' Variscite provides Docker containers that can be used for a development environment as an alternative to using a virtual machine or a dedicated computer. | {{Note|'''Note:''' Variscite provides Docker containers that can be used for a development environment as an alternative to using a virtual machine or a dedicated computer. | ||
To learn more, please see Variscite's [[Docker_Build_Environment | Docker Build Environment]] guide.}} | To learn more, please see Variscite's [[Docker_Build_Environment | Docker Build Environment]] guide.}} | ||
}} | |||
= Reference documentation = | = Reference documentation = | ||
Line 46: | Line 75: | ||
= Download Yocto {{#var:YOCTO_NAME}} based on {{#varexists:FSLC_BSP_VERSION|Freescale Community BSP {{#var:FSLC_BSP_VERSION}}|NXP BSP {{#var:FSL_BSP_VERSION}}}} = | = Download Yocto {{#var:YOCTO_NAME}} based on {{#varexists:FSLC_BSP_VERSION|Freescale Community BSP {{#var:FSLC_BSP_VERSION}}|NXP BSP {{#var:FSL_BSP_VERSION}}}} = | ||
$ mkdir ~/bin | Configure git user and email: | ||
$ curl https://commondatastorage.googleapis.com/git-repo-downloads/repo > ~/bin/repo | |||
$ chmod a+x ~/bin/repo | $ git config --global user.name "Your Name" | ||
$ export PATH=~/bin:$PATH | $ git config --global user.email "Your Email" | ||
Fetch and install the Google [https://gerrit.googlesource.com/git-repo/ git-repo] tool: | |||
$ mkdir -p ~/bin | |||
# For Ubuntu 20.04 and older, install repo 2.32 according to https://gerrit.googlesource.com/git-repo/+/HEAD/docs/python-support.md: | |||
$ curl https://commondatastorage.googleapis.com/git-repo-downloads/repo-2.32 > ~/bin/repo | |||
# For Ubuntu 22.04 and newer, install the latest repo tool: | |||
$ curl https://commondatastorage.googleapis.com/git-repo-downloads/repo > ~/bin/repo | |||
# Give repo execute permissions and add it to the path: | |||
$ chmod a+x ~/bin/repo | |||
$ export PATH=~/bin:$PATH | |||
Create a build directory: | |||
$ mkdir {{#var:BUILD_FOLDER}} | $ mkdir {{#var:BUILD_FOLDER}} | ||
$ cd {{#var:BUILD_FOLDER}} | $ cd {{#var:BUILD_FOLDER}} | ||
Line 72: | Line 112: | ||
or<br> | or<br> | ||
<br> | <br> | ||
* | * Download a release tag<br> | ||
Each release in https://github.com/varigit/variscite-bsp-platform/releases corresponds to a tag.<br> | Each release in https://github.com/varigit/variscite-bsp-platform/releases corresponds to a tag.<br> | ||
The tags are also listed in https://github.com/varigit/variscite-bsp-platform/tags<br> | The tags are also listed in https://github.com/varigit/variscite-bsp-platform/tags<br> | ||
Line 85: | Line 125: | ||
$ repo init -u https://github.com/varigit/variscite-bsp-platform.git -b refs/tags/{{#var:RELEASE_NAME}} | $ repo init -u https://github.com/varigit/variscite-bsp-platform.git -b refs/tags/{{#var:RELEASE_NAME}} | ||
$ repo sync -j$(nproc) | $ repo sync -j$(nproc) | ||
}} | |||
{{#if:{{#var:BUILD_YOCTO_IN_DOCKER_CONTAINER}}| | |||
Start a Ubuntu Docker container: | |||
$ ./var-start-container.sh {{Note|'''Note:''' After Ubuntu Docker container is started you can see the shell prompt similar to: '''vari@yocto-{{#var:DOCKER_CONTAINER_INFO}}:/workdir$''' | |||
All references to commands without this prompt should be executed in a native terminal (outside Docker). | |||
}} | |||
}} | }} | ||
Line 92: | Line 140: | ||
The following images are provided by Variscite for evaluation purpose | The following images are provided by Variscite for evaluation purpose | ||
* '''fsl-image-gui''': Default Variscite demo image with GUI and without any Qt{{#var:QT_VER}} content. This image recipe works for Xwayland and Wayland backends. | * '''fsl-image-gui''': Default Variscite demo image with GUI and without any Qt{{#var:QT_VER}} content. This image recipe works for Xwayland and Wayland backends. | ||
{{#if:{{#var:YOCTO_SUPPORT_CHROMIUM}}| | |||
* '''fsl-image-gui-chromium''': Extends fsl-image-gui image with Chromium web browser. | |||
|}} | |||
* '''fsl-image-qt{{#var:QT_VER}}''': Extends fsl-image-gui image with Qt{{#var:QT_VER}} support and various Qt samples for Xwayland and Wayland backends. | * '''fsl-image-qt{{#var:QT_VER}}''': Extends fsl-image-gui image with Qt{{#var:QT_VER}} support and various Qt samples for Xwayland and Wayland backends. | ||
| | | | ||
Line 109: | Line 160: | ||
|}} | |}} | ||
}} | }} | ||
See the list of Yocto Project’s reference images in [ | See the list of Yocto Project’s reference images in [https://www.yoctoproject.org/docs/{{#var:YOCTO_VERSION}}/ref-manual/ref-manual.html#ref-images Yocto Project Reference Manual] | ||
== Supported distros == | == Supported distros == | ||
Line 153: | Line 204: | ||
{{#lst:Yocto_Platform_Customization|YOCTO_ENV_SETUP_X}} | {{#lst:Yocto_Platform_Customization|YOCTO_ENV_SETUP_X}} | ||
{{#lst:Yocto_Platform_Customization|YOCTO_ENV_SETUP_X_SHORT}} | {{#lst:Yocto_Platform_Customization|YOCTO_ENV_SETUP_X_SHORT}} | ||
{{#vardefine:SHELL_PROMPT|{{#if:{{#var:BUILD_YOCTO_IN_DOCKER_CONTAINER}}|vari@yocto-{{#var:DOCKER_CONTAINER_INFO}}:/workdir/{{#var:BUILD_FOLDER_ENV}}$|$}}}} | |||
{{#var:GITHUB_WARNING}} | {{#var:GITHUB_WARNING}} | ||
<br> | <br> | ||
Line 160: | Line 212: | ||
Without Qt content: | Without Qt content: | ||
{{#var:SHELL_PROMPT}} bitbake fsl-image-gui | |||
{{#if:{{#var:YOCTO_SUPPORT_CHROMIUM}}| | |||
Or with Chromium: | |||
{{#var:SHELL_PROMPT}} bitbake fsl-image-gui-chromium | |||
|}} | |||
Or with Qt content: | Or with Qt content: | ||
{{#var:SHELL_PROMPT}} bitbake fsl-image-qt{{#var:QT_VER}} | |||
{{#switch: {{#var:SOC_SERIES}} | imx8 | imx9= | {{#switch: {{#var:SOC_SERIES}} | imx8 | imx9= | ||
Line 181: | Line 237: | ||
Without Qt content: | Without Qt content: | ||
$ bitbake fsl-image-gui | $ bitbake fsl-image-gui | ||
{{#if:{{#var:YOCTO_SUPPORT_CHROMIUM}}| | |||
Or with Chromium: | |||
$ bitbake fsl-image-gui-chromium | |||
|}} | |||
Or with Qt content: | Or with Qt content: | ||
$ bitbake fsl-image-qt{{#var:QT_VER}} | $ bitbake fsl-image-qt{{#var:QT_VER}} | ||
Line 267: | Line 327: | ||
{{#lst:Yocto_Platform_Customization|{{#var:YOCTO_BUILD_RESULTS_SECTION}}}} | {{#lst:Yocto_Platform_Customization|{{#var:YOCTO_BUILD_RESULTS_SECTION}}}} | ||
{{#ifexpr: {{#var:YOCTO_VERSION}} < 4.1 | |||
| {{Yocto_Create_Bootable_SD_Legacy}} | |||
| {{Yocto_Create_Bootable_SD}} | |||
{{# | |||
}} | }} | ||
= Boot the board with a bootable SD card = | = Boot the board with a bootable SD card = | ||
Line 470: | Line 396: | ||
In order to update the kernel, U-Boot and rootfs: | In order to update the kernel, U-Boot and rootfs: | ||
{{#var:SHELL_PROMPT}} bitbake -c cleanall u-boot-variscite linux-variscite kernel-module-imx-gpu-viv ti-compat-wireless-wl18xx wl18xx-firmware cryptodev-module | |||
for GUI image | for GUI image | ||
{{#var:SHELL_PROMPT}} bitbake -c clean fsl-image-gui | |||
for Qt{{#var:QT_VER}} image | for Qt{{#var:QT_VER}} image | ||
{{#var:SHELL_PROMPT}} bitbake -c clean fsl-image-qt{{#var:QT_VER}} | |||
{{#switch: {{#var:SOC_SERIES}} | imx8 | imx9= | {{#switch: {{#var:SOC_SERIES}} | imx8 | imx9= |