Differences

This shows you the differences between two versions of the page.

--- products:sbc:common:development:vims-build-yocto [2024/12/31 02:31]
nick
+++ products:sbc:common:development:vims-build-yocto [2025/01/12 23:02] (current)
nick
@@ Line 7: / Line 7: @@
 ===== Preparation =====
-Install essential dependencies. It is recommended to use ''Ubuntu 20.04/22.04'' for compilation.
+Install essential dependencies. **It is recommended to use Ubuntu 20.04/22.04 for compilation**, or you can choose to [[#build-in-docker | Build in Docker]].
 ```shell
@@ Line 21: / Line 21: @@
 . Download the base SDK packages here: [[https://dl.khadas.com/development/yocto/khadas_vims_yocto_sdk_base/ | khadas_vims_yocto_sdk_base.tar.gz0x]]
 <WRAP important >
-You need to download all 5 compressed files:
+You need to download all 3 compressed files:
   * khadas_vims_yocto_sdk_base.tar.gz00
   * khadas_vims_yocto_sdk_base.tar.gz01
@@ Line 30: / Line 29: @@
 </WRAP>
-. Create and enter the working directory:
+<WRAP tip >
+You can also download the [[dl>development/yocto/khadas_vims_yocto_sdk_base/md5sum/ | md5 checksum]] to verify the downloaded files:
-   ```
+```shell
-   mkdir ~/project && cd ~/project
+$ md5sum -c md5sum/*
-   ```
+khadas_vims_yocto_sdk_base.tar.gz00: OK
+khadas_vims_yocto_sdk_base.tar.gz01: OK
+khadas_vims_yocto_sdk_base.tar.gz02: OK
+```
+</WRAP>
-. Copy khadas_vims_yocto_sdk_base.tar.gz* to ~/project folder
-   ```
+. Create and enter the working directory:
-   cp khadas_vims_yocto_sdk_base.tar.gz* ~/project
-   ```
-. Decompress base SDK:
+```shell
+$ mkdir -p ~/project/vims-yocto-sdk && cd ~/project/vims-yocto-sdk
+```
-   ```
+. Decompress base SDK:
-   cat ~/project/khadas_vims_yocto_sdk_release.tar.gz* | tar -zxv
-   ```
-. Then you can see `.repo` derctory in `~/project` directory by using `ls -la` command.
+```shell
+$ cat path/to/sdk-base-packages/khadas_vims_yocto_sdk_base.tar.gz* | tar -zxv -C ~/project/vims-yocto-sdk
+```
-. Sync and update code:
+. Then you can see ''.repo'' derctory in ''~/project/vims-yocto-sdk'' directory by using ''ls -la'' command.
-   ```
+```shell
-   .repo/repo/repo sync -l
+$ ls -al ~/project/vims-yocto-sdk
-   .repo/repo/repo sync -c
+total 12
-   ```
+drwxrwxr-x 3 nick nick 4096 Dec 31 14:40 .
+drwxrwxr-x 3 nick nick 4096 Dec 31 14:39 ..
+drwxrwxr-x 7 nick nick 4096 Dec 30 16:21 .repo
+```
+. Sync and update code:
-. Create a work branch for each repository:
+```shell
+$ .repo/repo/repo sync -l
+$ .repo/repo/repo sync -c
+$ ls
+aml-comp  aml-patches  meta-aml-cfg  meta-gplv2  meta-meson  meta-openembedded  meta-python2  meta-qt5  meta-security  meta-selinux  poky
+```
-   ```
+. Create a work branch for each repository:
-   .repo/repo/repo start vims_yocto --all
-   ```
+```shell
+$ .repo/repo/repo start khadas --all
+```
 ===== Compile =====
+==== Setup the Compile Configuration ====
-.Select Configuration：
+You should setup the compile configuration before compilation.
-kvim1s board: mesons4-kvim1s-5.15
+```shell
+$ cd <SDK>
+$ source meta-meson/aml-setenv.sh
-kvim3 board: mesong12b-kvim3-k5.15
+You're building on Linux
+Lunch menu...pick a combo:
+.      mesong12b-kvim3-k5.15
+.      mesongsm1-kvim3l-k5.15
+.      mesons4-kvim1s-5.15
+.      mesont7c-kvim4-5.15
-kvim3l board: mesongsm1-kvim3l-k5.15
+Which would you like? [2]
-kvim4 board: mesont7c-kvim4-5.15
+```
+  * ''mesong12b-kvim3-k5.15'' - Configuration for ''VIM3''
+  * ''mesongsm1-kvim3l-k5.15'' - Configuration for ''VIM3L''
+  * ''mesons4-kvim1s-5.15'' - Configuration for ''VIM1S''
+  * ''mesont7c-kvim4-5.15'' - Configuration for ''VIM4''
+Build:
+```shell
+$ bitbake amlogic-yocto
 ```
-source meta-meson/aml-setenv.sh
-You're building on Linux
-Lunch menu...pick a combo:
-.	mesong12b-kvim3-k5.15
-.	mesongsm1-kvim3l-k5.15
-.	mesons4-kvim1s-5.15
-.	mesont7c-kvim4-5.15
-Which would you like? [2]
+The image located in ''SDK/build/tmp/deploy/images/CONFIGURATION/vimx-yocto-xxxxxx.img''.
+<WRAP tip >
+The CONFIGURATION should be:
+  * ''mesong12b-kvim3-k5.15''
+  * ''mesongsm1-kvim3l-k5.15''
+  * ''mesons4-kvim1s-5.15''
+  * ''mesont7c-kvim4-5.15''
+</WRAP>
+===== Build in Docker =====
+You can also choose to build the OS image in a Docker container.
+==== Install Docker ====
+Please refer to [[https://docs.docker.com/engine/install/|Docker Documentation]].
+==== Add User to a Docker Group ====
+```shell
+$ sudo usermod -aG docker $USER
 ```
-.Build:
+<WRAP important >
+You need to logout or reboot the system to take effect.
+</WRAP>
-```
+==== Build SDK in Docker ====
-bitbake amlogic-yocto
+Get Docker image:
+```shell
+$ docker pull wesion/yocto-amlogic
 ```
-.The constructed image path：
+Enter Docker:
+```shell
+$ cd ~/project/vims-yocto-sdk
+$ docker run --rm -it  -u $(id -u):$(id -g)  -v /opt:/opt -v $(pwd):/home/khadas/yocto wesion/yocto-amlogic bash
 ```
-SDK/build/tmp/deploy/images/$Configuration/vimx-yocto-xxxxxx.img
+Start your build from inside the Docker container.
+```shell
+khadas@0126a0629f9a:~/yocto$ source meta-meson/aml-setenv.sh
+khadas@0126a0629f9a:~/yocto$ bitbake amlogic-yocto
 ```
+===== Install the Yocto image =====
-===== Burn the image =====
+Please refer to:
-Please refer to: [固件烧录](https://docs.khadas.com/products/sbc/vim4/install-os/install-os-into-emmc-via-usb-tool#tab__vim4)
+  * [[products:sbc:vim4:install-os:install-os-into-emmc-via-usb-tool|]]
+  * [[products:sbc:vim3:install-os:install-os-into-emmc-via-usb-tool|]]
+  * [[products:sbc:vim1s:install-os:install-os-into-emmc-via-usb-tool|]]

Khadas Docs

User Tools

Site Tools

Differences

Page Tools