Khadas Docs

Amazing Khadas, always amazes you!

User Tools

Site Tools

Home / products / sbc / common / development / vims-build-yocto
products:sbc:common:development:vims-build-yocto

Differences

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

Link to this comparison view

Next revision 		Previous revision
products:sbc:common:development:vims-build-yocto [2024/12/31 02:26]
nick created 		products:sbc:common:development:vims-build-yocto [2025/01/12 23:02] (current)
nick
Line 1: Line 1:
-====== VIM4 Amlogic Linux 5.15 SDK developer guide ====== +====== VIM Yocto SDK developer guide ======
  
 ===== Introduction ===== ===== Introduction =====
  
- +This documentation will guide you to build Yocto images for ''VIM4/3/3L/1S''.
-The Amlogic Linux 5.15 SDK support for Yocto. We will introduce how to build VIM4 firmware using the Amlogic Linux5.15 SDK here. For readability, the subsequent Amlogic Linux SDK will be referred to as SDK.+
  
 ===== Preparation ===== ===== Preparation =====
  
- +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]].
-Install essential dependencies. It is recommended to use Ubuntu 22.04 for compilation.+
  
 ```shell ```shell
-sudo apt-get update && sudo apt-get install git ssh make gcc libssl-dev \+sudo apt update && sudo apt install git ssh make gcc libssl-dev \
 liblz4-tool expect expect-dev g++ patchelf chrpath gawk texinfo chrpath \ liblz4-tool expect expect-dev g++ patchelf chrpath gawk texinfo chrpath \
 diffstat binfmt-support qemu-user-static live-build bison flex fakeroot \ diffstat binfmt-support qemu-user-static live-build bison flex fakeroot \
Line 23: Line 20:
 ===== Get SDK ===== ===== Get SDK =====
  
 +1. Download the base SDK packages here: [[https://dl.khadas.com/development/yocto/khadas_vims_yocto_sdk_base/ | khadas_vims_yocto_sdk_base.tar.gz0x]]
  
-1. Download the base SDK packages here: [khadas_vims_yocto_sdk_base.tar.gz* ](https://dl.khadas.com/development/yocto/khadas_vims_yocto_sdk_base)+<WRAP important > 
 +You need to download all 3 compressed files: 
 +  * khadas_vims_yocto_sdk_base.tar.gz00 
 +  * khadas_vims_yocto_sdk_base.tar.gz01 
 +  * khadas_vims_yocto_sdk_base.tar.gz02 
 +</WRAP>
  
-2. 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>
  
-3. Copy khadas_vims_yocto_sdk_base.tar.gz* to ~/project folder 
  
-   ``` +2. Create and enter the working directory:
-   cp khadas_vims_yocto_sdk_base.tar.gz* ~/project +
-   ```+
  
-4. Decompress base SDK:+```shell 
 +$ mkdir -p ~/project/vims-yocto-sdk && cd ~/project/vims-yocto-sdk 
 +```
  
-   ``` +3. Decompress base SDK:
-   cat ~/project/khadas_vims_yocto_sdk_release.tar.gz* | tar -zxv +
-   ```+
  
-5. 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 
 +```
  
-6. Sync and update code:+4. 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 
 +``` 
 +5. Sync and update code:
  
-7. 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 
 +```
  
-   ``` +6. Create a work branch for each repository:
-   .repo/repo/repo start vims_yocto --all +
-   ```+
  
 +```shell
 +$ .repo/repo/repo start khadas --all
 +```
  
 ===== Compile ===== ===== Compile =====
  
 +==== Setup the Compile Configuration ====
  
-1.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: 
 +1.      mesong12b-kvim3-k5.15 
 +2.      mesongsm1-kvim3l-k5.15 
 +3.      mesons4-kvim1s-5.15 
 +4.      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: 
-1. mesong12b-kvim3-k5.15 
-2. mesongsm1-kvim3l-k5.15 
-3. mesons4-kvim1s-5.15 
-4. 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
 ``` ```
  
-2.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
 ``` ```
  
-3.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|]]
  
  
Last modified: 2024/12/31 02:26 by nick

Page Tools

Khadas Site

Khadas Community

Khadas GitHub

Khadas Downloads