View source for Linux BSP User Guide for AOM-3841 Series-Debian12


== Linux BSP Version ==

Debian 12.x

Kernel 6.1.xx

== Build Environment on Host ==

Currently, we adopt [https://www.docker.com/ Docker] as build environment.

You can get the latest version of advrisc/u20.04-rklbv1 Docker image for developing Rockchip RK3588&nbsp;projects.

Docker command:
<pre>$ sudo apt-get update
$ sudo apt-get install -y qemu-user-static
$ sudo apt-get install -y live-build
$ sudo docker pull advrisc/u20.04-rklbv1
</pre>

== Run Docker example ==

Step1 Run docker container (example)
<pre>$ sudo docker run -it --name rk3576_linux_risc -v /home/bsp/myLinux:/home/adv/BSP:rw --privileged advrisc/u20.04-rklbv1:latest /bin/bash
</pre>

Step2 In container, change the user. (example) &nbsp;
<pre>$ adv@7cc0fa834366:~$ sudo chown adv:adv -R BSP
</pre>

&nbsp;

== Getting Linux Source Code ==

Debian 12.x

Please contact PM to get BSP.

If you have BSP tarball (eg. AOM3841A1AIM38DBV110020_2025-07-10.bsp.tgz), then you have to copy it into container.

Follow the steps below:

1.Exit container and back to local machine
<pre>$ exit
</pre>

2.Copy BSP tarball to ${WORKSPACE} , and change owner
<pre>$ cp AOM3841A1AIM38DBV110020_2025-07-10.bsp.tgz '''${WORKSPACE}'''
$ sudo chown adv:adv ${WORKSPACE}/AOM3841A1AIM38DBV110020_2025-07-10.bsp.tgz &nbsp;
</pre>

3.Back to container
<pre>$ docker start '''${CONTAINER_NAME}'''
$ docker attach '''${CONTAINER_NAME}'''
</pre>

4.Unpack BSP tarball
<pre>$ tar zxvf AOM3841A1AIM38DBV110020_2025-07-10.bsp.tgz
</pre>

&nbsp;

== Build Choose Project ==

=== Build Choose Project A0M-3841 ===
<pre>$ export TOP=`pwd`
$ cd $TOP
$ ./build.sh adv_rk3576_aom3841a1_defconfig
$ 
</pre>

&nbsp;

== Build U-boot ==
<pre> 
$ cd $TOP
$ ./build.sh uboot
</pre>

== Build Kernel ==
<pre>$ cd $TOP
$ ./build.sh kernel
</pre>

== Build Recovery ==
<pre>$ cd $TOP
$ rm buildroot/output/rockchip_rk3588_recovery -rf
$ ./build.sh recovery
</pre>

&nbsp;

'''CAUTION'''

BSP tarball is for fast developping <code>uboot</code> and <code>kernel</code> .

BSP tarball DONOT support to build <code>recovery</code>.

== Build&nbsp;Debian 12.x ==
<pre>$ cd $TOP
$ sudo dpkg -i debian/ubuntu-build-service/packages/*
$ sudo apt-get install -f -y
$ ./build.sh debian
</pre>

&nbsp;

'''CAUTION'''

BSP tarball is for fast developping <code>uboot</code> and <code>kernel</code> .

BSP tarball DONOT support to build <code>debian</code>.

&nbsp;

== Push all image to rockdev folder ==

'''SDK V110 and after:'''
<pre>$ cd $TOP
$ ./build.sh firmware
</pre>

The common image files are listed below:

&nbsp;
<pre># boot.img     
# misc.img    
# oem.img 
# recovery.img    
# rootfs.img    
# uboot.img   
# userdata.img       
# MiniLoaderAll.bin
# parameter.txt
# 
</pre>

== Make update.img ==
<pre>$ cd $TOP
$ sudo apt-get install bsdmainutils
$ ./build.sh updateimg
</pre>

You can get update.img in rockdev/

&nbsp;

'''CAUTION'''

BSP tarball is for fast developping <code>uboot</code> and <code>kernel</code> .

BSP tarball DONOT support to build <code>updateimg</code>.