This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
products:sbc:common:development:edges-rockchip-linux-sdk [2024/12/31 01:25] nick |
products:sbc:common:development:edges-rockchip-linux-sdk [2025/02/27 20:08] (current) gray [Get SDK] Add update repo |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | # Edge2 Yocto SDK developer guide | + | ====== |
- | ## Introduction | ||
- | The Rockchip | + | ===== Introduction ===== |
+ | |||
+ | |||
+ | The Rockchip | ||
For readability, | For readability, | ||
- | ## Preparation | + | ===== Preparation |
- | Install essential dependencies. It is recommended to use Ubuntu 22.04 for compilation. | + | Install essential dependencies. |
```shell | ```shell | ||
- | sudo apt-get update && sudo apt-get install | + | $ sudo apt update && sudo apt install |
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 19: | Line 21: | ||
``` | ``` | ||
- | ## Get SDK | + | ===== Get SDK ===== |
1. Download the base SDK packages here: [[https:// | 1. Download the base SDK packages here: [[https:// | ||
<WRAP important > | <WRAP important > | ||
- | Need download all 5 compress | + | You need to download all 5 compressed |
+ | * khadas_edges_yocto_sdk_base.tar.gz00 | ||
+ | * khadas_edges_yocto_sdk_base.tar.gz01 | ||
+ | * khadas_edges_yocto_sdk_base.tar.gz02 | ||
+ | * khadas_edges_yocto_sdk_base.tar.gz03 | ||
+ | * khadas_edges_yocto_sdk_base.tar.gz04 | ||
</ | </ | ||
+ | <WRAP tip > | ||
+ | You can also download the [[dl> | ||
+ | |||
+ | ```shell | ||
+ | $ md5sum -c md5sum/* | ||
+ | khadas_edges_yocto_sdk_base.tar.gz00: | ||
+ | khadas_edges_yocto_sdk_base.tar.gz01: | ||
+ | khadas_edges_yocto_sdk_base.tar.gz02: | ||
+ | khadas_edges_yocto_sdk_base.tar.gz03: | ||
+ | khadas_edges_yocto_sdk_base.tar.gz04: | ||
+ | ``` | ||
+ | </ | ||
2. Create and enter the working directory: | 2. Create and enter the working directory: | ||
```shell | ```shell | ||
- | $ mkdir ~/project && cd ~/project | + | $ mkdir -p ~/project/ |
``` | ``` | ||
3. Decompress base SDK: | 3. Decompress base SDK: | ||
+ | |||
```shell | ```shell | ||
- | $ cat path/to/SDK_packages/ | + | $ cat path/to/sdk-base-packages/ |
``` | ``` | ||
- | 4. Then you can see '' | + | 4. Then you can see '' |
+ | |||
+ | ```shell | ||
+ | $ ls -al ~/ | ||
+ | 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: | 5. Sync and update code: | ||
+ | |||
```shell | ```shell | ||
+ | $ cd .repo/repo | ||
+ | $ git pull | ||
+ | $ cd - | ||
$ .repo/ | $ .repo/ | ||
$ .repo/ | $ .repo/ | ||
+ | $ ls | ||
+ | Copyright_Statement.md | ||
``` | ``` | ||
- | 6. Create a work branch for each repository: | + | 6. Sync large files: |
+ | |||
+ | ```shell | ||
+ | $ .repo/ | ||
+ | ``` | ||
+ | |||
+ | 7. If you need to build Yocto, please disable the auto-detaching feature of git gc: | ||
+ | ```shell | ||
+ | $ git config --global gc.autoDetach false | ||
+ | ``` | ||
+ | |||
+ | 8. Create a work branch for each repository: | ||
```shell | ```shell | ||
$ .repo/ | $ .repo/ | ||
``` | ``` | ||
- | ## Update SDK | + | ===== Update SDK ===== |
In the future, you can use the following command to update the SDK code: | In the future, you can use the following command to update the SDK code: | ||
```shell | ```shell | ||
- | $ cd ~/project/ | + | $ cd ~/project/edge2-linux-sdk |
$ .repo/ | $ .repo/ | ||
``` | ``` | ||
- | ## Introduction to SDK project directory | + | ===== Introduction to SDK project directory |
The SDK project directory includes buildroot, debian, app, kernel, u-boot, device, docs, external, etc. | The SDK project directory includes buildroot, debian, app, kernel, u-boot, device, docs, external, etc. | ||
Line 79: | Line 126: | ||
- | ## Compilation | + | ===== Compilation |
The SDK can be easily compiled using the '' | The SDK can be easily compiled using the '' | ||
- | ### Setup the Compile Configuration | + | ==== Setup the Compile Configuration |
You should setup the compile configuration before compilation. | You should setup the compile configuration before compilation. | ||
Line 143: | Line 192: | ||
</ | </ | ||
- | ### Build the OS Image | + | ==== Build the OS Image ==== |
After setting up the compile configuration, | After setting up the compile configuration, | ||
Line 166: | Line 216: | ||
</ | </ | ||
- | ### Other Build Commands | + | ==== Other Build Commands |
+ | |||
+ | |||
+ | === Build u-boot === | ||
- | #### Build U-Boot | ||
```shell | ```shell | ||
Line 174: | Line 226: | ||
``` | ``` | ||
- | #### Build Kernel | + | === Build kernel === |
```shell | ```shell | ||
Line 180: | Line 233: | ||
``` | ``` | ||
- | #### Build Rootfs | + | === Build rootfs === |
```shell | ```shell | ||
Line 186: | Line 240: | ||
``` | ``` | ||
- | ### Help Messages | + | ==== Help messages ==== |
You can get help messages by executing '' | You can get help messages by executing '' | ||
Line 200: | Line 255: | ||
khadas_rk3588s_edge2_debian_defconfig | khadas_rk3588s_edge2_debian_defconfig | ||
khadas_rk3588s_edge2_yocto_defconfig | khadas_rk3588s_edge2_yocto_defconfig | ||
- | rockchip_defconfig | ||
- | rockchip_rk3588_evb1_lp4_v10_defconfig | ||
- | rockchip_rk3588_evb7_v11_defconfig | ||
- | rockchip_rk3588s_evb1_lp4x_v10_defconfig | ||
| | ||
| | ||
Line 278: | Line 329: | ||
``` | ``` | ||
- | ## Build in Docker | + | ===== Build in Docker |
You can also choose to build the OS image in a Docker container. | You can also choose to build the OS image in a Docker container. | ||
- | ### Install Docker | + | ==== Install Docker |
Please refer to [[https:// | Please refer to [[https:// | ||
- | ### Add User to a Docker Group | + | ==== Add User to a Docker Group ==== |
```shell | ```shell | ||
Line 296: | Line 348: | ||
</ | </ | ||
+ | ==== Build SDK in Docker ==== | ||
- | ### Check Docker | ||
- | |||
- | ```shell | ||
- | $ docker run hello-world | ||
- | ``` | ||
- | |||
- | If you see the following print-out, Docker has installed successfully: | ||
- | |||
- | ```txt | ||
- | Unable to find image ' | ||
- | latest: Pulling from library/ | ||
- | ca4f61b1923c: | ||
- | Digest: sha256: | ||
- | Status: Downloaded newer image for hello-world: | ||
- | |||
- | Hello from Docker! | ||
- | This message shows that your installation appears to be working correctly. | ||
- | |||
- | To generate this message, Docker took the following steps: | ||
- | 1. The Docker client contacted the Docker daemon. | ||
- | 2. The Docker daemon pulled the " | ||
- | (amd64) | ||
- | 3. The Docker daemon created a new container from that image which runs the | ||
- | executable that produces the output you are currently reading. | ||
- | 4. The Docker daemon streamed that output to the Docker client, which sent it | ||
- | to your terminal. | ||
- | |||
- | To try something more ambitious, you can run an Ubuntu container with: | ||
- | $ docker run -it ubuntu bash | ||
- | |||
- | Share images, automate workflows, and more with a free Docker ID: | ||
- | | ||
- | |||
- | For more examples and ideas, visit: | ||
- | | ||
- | ``` | ||
- | |||
- | ### Build SDK in Docker | ||
Get Docker image: | Get Docker image: | ||
```shell | ```shell | ||
- | $ cd ~/project/ | ||
$ docker pull wesion/ | $ docker pull wesion/ | ||
``` | ``` | ||
Line 346: | Line 360: | ||
```shell | ```shell | ||
+ | $ cd ~/ | ||
$ docker run --rm -it --privileged --device=/ | $ docker run --rm -it --privileged --device=/ | ||
| | ||
Line 357: | Line 372: | ||
``` | ``` | ||
- | ## Install OS | + | ===== Install OS ===== |
- | ### Preparation | + | ==== Preparation |
1. Copy upgrade tool to your local path | 1. Copy upgrade tool to your local path | ||
Line 369: | Line 384: | ||
2. Put your Edge2 into upgrade mode. Ref: | 2. Put your Edge2 into upgrade mode. Ref: | ||
- | ### Install OS into eMMc | + | ==== Install OS into eMMC ==== |
- | ```shell | + | Please check [[products: |
- | $ upgrade_tool uf < | + | |
- | ``` | + | |
+ | ==== Partition Upgrade ==== | ||
- | ## Partition Upgrade | ||
<WRAP important > | <WRAP important > | ||
Invalid in Maskrom Mode! | Invalid in Maskrom Mode! | ||
</ | </ | ||
- | ### Upgrade Uboot | + | ==== Upgrade Uboot ==== |
```shell | ```shell | ||
$ sudo upgrade_tool di -uboot < | $ sudo upgrade_tool di -uboot < | ||
``` | ``` | ||
- | ### Upgrade | + | ==== Upgrade |
```shell | ```shell | ||
Line 391: | Line 408: | ||
``` | ``` | ||
- | ### Upgrade | + | ==== Upgrade |
```shell | ```shell | ||
Line 401: | Line 419: | ||
</ | </ | ||
- | ## User and password | + | ===== User and password |
<tabbox Buildroot> | <tabbox Buildroot> | ||
Line 426: | Line 445: | ||
</ | </ | ||
- | ## WIFI | + | ===== WIFI ===== |
<tabbox Buildroot && Yocto> | <tabbox Buildroot && Yocto> | ||
Line 461: | Line 481: | ||
- | ## Bluetooth | + | ===== Bluetooth |
<tabbox Buildroot && Yocto> | <tabbox Buildroot && Yocto> | ||
Line 473: | Line 494: | ||
</ | </ | ||
- | ## Camera | + | ===== Camera |
Please refer to [[products: | Please refer to [[products: | ||