Template:Yocto Build Release IMX: Difference between revisions

@@ Line 12: / Line 12: @@
 -->{{#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.2|20.04/22.04|{{#var:UBUNTU_COMPAT}}}}}}
+-->{{#vardefine:UBUNTU_COMPAT|{{#ifexpr: {{#var:YOCTO_VERSION}} >= 4.2|20.04/22.04|{{#var:UBUNTU_COMPAT}}}}}}<!--
+-->{{#vardefine:UBUNTU_COMPAT|{{#if:{{#var:BUILD_YOCTO_IN_DOCKER_CONTAINER}}|18.04/20.04/22.04/24.04|{{#var:UBUNTU_COMPAT}}}}}}
 = Installing required packages =
@@ Line 19: / Line 20: @@
 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}}|}}<!--
+-->{{#ifexpr:{{#rpos:{{#var:UBUNTU_COMPAT}}|24.04}} >= 0|{{Ubuntu24_Docker}}|}}
+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}
+ # Logout and login again for the permissions to take effect.
+|
    $ sudo apt-get install gawk wget git diffstat unzip texinfo gcc-multilib \
@@ Line 45: / Line 66: @@
 {{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.}}
+}}
 = Reference documentation =
@@ Line 89: / Line 111: @@
 or<br>
 <br>
-* '''Download a release tag'''<br>
+* Download a release 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>
@@ Line 102: / Line 124: @@
   $ repo init -u https://github.com/varigit/variscite-bsp-platform.git -b refs/tags/{{#var:RELEASE_NAME}}
   $ 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 173: / Line 203: @@
 {{#lst:Yocto_Platform_Customization|YOCTO_ENV_SETUP_X}}
 {{#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}}
 <br>
@@ Line 180: / Line 211: @@
   Without Qt content:
-  $ bitbake fsl-image-gui
+  {{#var:SHELL_PROMPT}} bitbake fsl-image-gui
   {{#if:{{#var:YOCTO_SUPPORT_CHROMIUM}}|
   Or with Chromium:
-  $ bitbake fsl-image-gui-chromium
+  {{#var:SHELL_PROMPT}} bitbake fsl-image-gui-chromium
 |}}
   Or with Qt content:
-  $ bitbake fsl-image-qt{{#var:QT_VER}}
+  {{#var:SHELL_PROMPT}} bitbake fsl-image-qt{{#var:QT_VER}}
 {{#switch: {{#var:SOC_SERIES}} | imx8 | imx9=
@@ Line 219: / Line 250: @@
 Create a /opt/yocto_downloads directory and set its permissions:
-<pre>
+ {{#var:SHELL_PROMPT}} sudo mkdir /opt/yocto_downloads
-$ sudo mkdir /opt/yocto_downloads
+ {{#var:SHELL_PROMPT}} sudo chmod 777 /opt/yocto_downloads/
-$ sudo chmod 777 /opt/yocto_downloads/
-</pre>
 Direct downloads to it, by replacing 'DL_DIR ?= "${BSPDIR}/downloads/"' with 'DL_DIR = "/opt/yocto_downloads/"' in conf/local.conf under your build directory:
-<pre>
+ {{#var:SHELL_PROMPT}} sed -i 's/DL_DIR ?= "${BSPDIR}\/downloads/DL_DIR = "\/opt\/yocto_downloads/g' conf/local.conf
-$ sed -i 's/DL_DIR ?= "${BSPDIR}\/downloads/DL_DIR = "\/opt\/yocto_downloads/g' conf/local.conf
-</pre>
 === Add Qt creator and Eclipse debug support to your images ===
@@ Line 364: / Line 391: @@
   In order to update the kernel, U-Boot and rootfs:
-  $ bitbake -c cleanall u-boot-variscite linux-variscite kernel-module-imx-gpu-viv ti-compat-wireless-wl18xx wl18xx-firmware cryptodev-module
+  {{#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
-  $ bitbake -c clean fsl-image-gui
+  {{#var:SHELL_PROMPT}} bitbake -c clean fsl-image-gui
   for Qt{{#var:QT_VER}} image
-  $ bitbake -c clean fsl-image-qt{{#var:QT_VER}}
+  {{#var:SHELL_PROMPT}} bitbake -c clean fsl-image-qt{{#var:QT_VER}}
 {{#switch: {{#var:SOC_SERIES}} | imx8 | imx9=

Template:Yocto Build Release IMX: Difference between revisions

Latest revision as of 22:08, 18 November 2024