该文章仅供参考,编写人不对任何实验设备、人员及测量结果负责!!!
0 引言
文章主要介绍King3399(瑞芯微rk3399开发板,荣品)官方SDK编译过程,涉及环境配置、补丁以及编译过程中注意事项等说明,编译过程主要参考荣品官网-瑞芯微系列-rk3399
1 编译环境
下表为编译SDK时主、从机的配置:
CPU | Memory | Disk | Core | System | |
---|---|---|---|---|---|
Master | i5 | 16G | / | 4 | Win10 64bit |
Slave | / | 10G | 120G | 2 | Ubuntu 18.04 |
- 此处从机为安装在主机VMWare17中的虚拟机
- 从机的10G内存是从主机16G内存中分配的,磁盘与内核同理
- VMware17安装Ubuntu18.04,若环境一致可参考此链接,安装时网络类型为
使用桥接网络
,更新和其他软件为最小安装
- 编译内存分配建议不小于8G,官方编译文档中有明确说明,本人在一开始时使用2G内存会报错且速度较慢
- 从机磁盘空间分配建议不小于100G,官方编译文档中虽无明确说明,但本人第一次成功编译后查看磁盘占用为90G+(编译过程只安装必要的依赖,连VS Code都没安装,且源码linux-5.10-20240531.tgz存放在共享文件夹中)
- 编译环境建议选择Ubuntu18.04,本人第一次安装的为Ubuntu22.04,但存在部分依赖未更新至该版本,Ubuntu20.04未尝试
- 建议在VMware中新建一个虚拟机进行SDK开发,编译过程未知事件频发,可能导致虚拟机崩掉
2 环境配置
从机安装完成后更新包和依赖:
>>>sudo apt update && apt upgrade
# 若返回如下错误可以继续执行下述指令:
unable to acquire the dpkg frontend lock xxx are you root
# 参考:https://blog.csdn.net/Julykkk/article/details/108771331
>>>sudo passwd root
>>>xxx # your password
>>>xxx # your password
>>su
>>>xxx # your password
# 执行完上述指令后成为 root,再次尝试更新
>>>sudo apt update && apt upgradesu
>>>su ooo # ooo:one of member in this system
设置共享文件夹:
# 参考:https://blog.csdn.net/bigger_belief/article/details/134333114
# 完成参考链接中的步骤后执行如下指令
>>>ls /mnt/hgfs # return share floder you set just now
# 若返回hgfs not exit,执行如下指令
# 参考:https://blog.csdn.net/challenglistic/article/details/129026025
>>>sudo mkdir -p /mnt/hgfs
>>>sudo chmod a+w /mnt/hgfs
>>>vmhgfs-fuse .host:/ /mnt/hgfs/
# 再次执行
>>>ls /mnt/hgfs # return share floder you set just now
# 注:这种方法在每次重启从机后都需要手动挂载共享文件夹,步骤如下
# 1、虚拟机-设置-选项-共享文件夹-已禁用-确定
# 2、虚拟机-设置-选项-共享文件夹-总是启用-确定
# 对于此问题有更好的解决方案,可自行查找
安装vim,个人认为vim比自带的vi好用,建议安装(前提是会使用基本指令,否则可自行安装VS Code等编辑器)
>>>sudo apt-get install vim
关闭终端音效
# 参考:https://blog.csdn.net/qq_32708605/article/details/123987268
>>>sudo vim /etc/inputrc
# 找到“# set bell-style none”,删除该行行首的“#”和“ ”并保存
# 打开新的终端
从机(Ubuntu)获取主机(Windows)复制(剪切板)中的内容
# 参考:https://blog.csdn.net/childbor/article/details/95073956
>>>sudo apt install open-vm-tools
>>>sudo apt install open-vm-tools-desktop
>>>reboot # reboot slave
# 注:上述指令会重启从机,及时保存相关文件
3 编译SDK
首先到荣品官网下载SDK,该SDK大约有12G+,可以提前两天下载,具体路径为:
cdrom_king3399_new/01-SDK/Linux/source/linux-5.10-20240531.tgz
cdrom_king3399_new/01-SDK/Linux/source/linux-5.10-20240531.md5
另外还需要下载烧写驱动与烧写软件,具体路径为:
cdrom_king3399_new/05-工具/USB烧写驱动/DriverAssitant_v4.5zip
cdrom_king3399_new/05-工具/烧写工具/android烧写工具/android10烧写软件/AndroidTool_Release_v2.71.rar
注:
- 上述路径不尽相同,若在上述路径中没有找到相应工具或者文档,可以查看其他路径
- 本人使用的烧写工具为
AndroidTool_v2.61.rar
- 上述文件或者工具全部都是下载到主机磁盘中
- 网盘中还存在大量其他工具与参考文档,可按需下载查看
3.1 安装编译SDK环境搭建所依赖的包
官方文档所要求的依赖包:
sudo apt-get install repo git-core gitk git-gui gcc-arm-linux-gnueabihf
sudo apt-get install device-tree-compiler gcc-aarch64-linux-gnu mtools parted
sudo apt-get install libudev-dev libusb-1.0-0-dev python-linaro-image-tools
sudo apt-get install linaro-image-tools autoconf autotools-dev libsigsegv2 m4
sudo apt-get install intltool libdrm-dev curl sed make binutils build-essential gcc
sudo apt-get install g++ bash patch gzip bzip2 perl tar cpio python unzip rsync flex
sudo apt-get install bc wget libncurses5 libqt4-dev libglib2.0-dev libgtk2.0-dev
sudo apt-get install libglade2-dev cvs git mercurial rsync openssh-client subversion
sudo apt-get install asciidoc w3m dblatex graphviz python-matplotlib libc6:i386
sudo apt-get install libssl-dev texinfo genext2fs u-boot-tools
# 若使用Ubuntu18.04,还需安装
sudo apt-get install liblz4-tool lib32gcc-7-dev g++-7 libstdc++-7-dev
# 若某一步安装失败,请单独安装对应的包,并根据情况处理
# 如果安装完后续编译遇到报错,可以视报错信息,安装对应的软件包
本人在编译时没有直接使用全局编译SDK:./build.sh
,而是先单独编译uboot、kernel、recovery,在单独编译过程中出现缺少依赖的情况及安装补丁如下:
# 1.awk: line 2: function strtonum never defined
# 参考:https://blog.csdn.net/liangtianmeng/article/details/86020254
>>>sudo apt-get install gawk
# 2./bin/sh: 1: bison: not found
# 参考:https://blog.csdn.net/qq_36393978/article/details/117816425
>>>sudo apt install bison flex
# 3.ERROR: Running xxx mk-kernel.sh - do_build failed!
>>>git clone https://github.com/lz4/lz4.git --depth 1 -b v1.9.4
>>>cd lz4
>>>sudo make install -j8
# 4.Your gmp headers are missing
>>>sudo apt install libgmp-dev
# 5.Your gmp headers are missing
>>>sudo apt-get install libgmp-dev
# 6.Your mpc headers are missing
>>>sudo apt-get install libmpc-dev
# 7.Your unbuffer is missing
>>>sudo apt-get install expect expect-dev
在单独编译某个部分报错时,可根据报错信息安装相关依赖,若使用环境与本文章相同,可以直接安装上述两部分依赖(官方要求的和本人在单独编译时报错后安装的)
3.2 源码SDK的md5校验
将下载的linux-5.10-20240531.tgz和linux-5.10-20240531.md5移动到共享文件夹下(此处放在共享文件夹下是避免占用从机磁盘空间),并执行如下指令:
>>>cd /mnt/hgfs/sharefile # sharefile:your share folder
>>>md5sum linux-5.10-20240531.tgz # return : xxxooo
>>>vim ubuntu-xxx.md5 # show : xxxuuu
# 若返回的xxxooo与xxxuuu相同,则检验通过
# 反之可能需要重新下载linux-5.10-20240531.tgz文件
# 由于本人没有遇到不相同的情况,因此没有深入了解解决方案
# md5校验通过后将linux-5.10-20240531.tgz解压到指定目录
# 提前在当前用户下创建目录 /home/username/ws/sdk,此处为自定义目录
# 参考:https://blog.csdn.net/libing_zeng/article/details/73268032
tar xzvf /mnt/hgfs/sharefile/linux-5.10-20240531.tgz -C /home/username/ws/sdk # about 4 minute
# 解压完成后并不能看到源码,需要从git版本库中检出,查看是否生成 .git
>>> ls -al # return list exit file : .git
# 检出源码
>>> git reset --hard # about 2 minute
# 此时在/home/username/ws/sdk下生成如下文件夹
SDK
├──app: #存放上层应用 APP,主要是 qcamera/qfm/qplayer/qseting 等一些应用程序。
├──buildroot: #基于 Buildroot开发的根文件系统。
├──device/rockchip:#存放各芯片板级配置以及一些编译和打包固件的脚本和预备文件。
├──docs: #存放开发指导文件、平台支持列表、工具使用文档、Linux 开发指南等。
├──external: #存放第三方相关仓库,包括音频、视频、网络、recovery 等。
├──kernel: #存放 Kernel源代码。
├──prebuilts: #存放交叉编译工具链。
├──rkbin: #存放 Rockchip 相关 Binary 和工具。
├──rockdev: #存放编译输出固件,完整编译后生成(该文件夹当前并不存在)
├──tools: #存放 Linux 和 Window 操作系统下常用工具。
├──u-boot: #存放 U-Boot 源代码。
├──debian: #存放 debian 文件系统镜像(需单独下载)。
├──README.md
├──Makefile
├──build.sh
├──output
├──rkflash.sh
├──uefi
├──common
├──external
└──yocto
3.3 编译SDK
SDK编译可分为buildroot系统编译、debian系统编译和ubuntu系统编译,无论最后要使用什么系统,都请先全局编译一次 buildroot,之后再进行其他系统的编译,以避免出现需要某个依赖的工具找不到的情况
,本文选择buildroot系统编译
若需要点亮对应屏幕,在编译之前修改相关配置,参见显示屏配置,由于本人手边没有合适的屏幕,因此没有配置此处,在编译完成后直接使用板子上的hdmi接口连接的电脑复屏,画质勉强可以接受
根据选项和当前主板的型号进行选择,主板型号可查看 CPU 确认,输入对应的序号选择
# 注:编译部分的所有指令都是在/home/username/ws/sdk下执行
./build.sh init
# 返回结果如下
Log saved at /home/rpdzkj/fourth/zzc/rk-linux5.10/output/log/2023-07-27_08-39-50
Pick a chip:
1. rk3399
2. rk3566_rk3568
3. rk3588
Which would you like? [1]: 1 # 根据板载芯片选择
Pick a defconfig: #输入需要编译的板型
1. king-rk3399-buildroot_defconfig
2. king-rk3399-debian_defconfig
3. king-rk3399-ubuntu_defconfig
4. nano-rk3399-buildroot_defconfig
......
19. rp-rk3399-buildroot_defconfig
20. rp-rk3399-debian_defconfig
21. rp-rk3399-ubuntu_defconfig
Which would you like? [1]:
#输入需要编译的板型和系统序号,如输入 1 编译king-rk3399-buildroot
# 全局编译SDk
./build.sh # about 2.5 hour
# --------------------------------------
# 若选择单独编译可以使用如下指令:
# 单独编译 uboot
# ./build.sh uboot
# 单独编译kernel,about 30 miunte
# ./build.sh kernel
# 单独编译 recovery,about 60 miunte
# ./build.sh recovery
# 上述时间仅供参考,本人中途换过电脑与内存条,
# 具体在哪台设备上编译的已记不太清,
# 建议找个完整的时间守在电脑旁边进行编译
4 烧录镜像
编译成功后所有的镜像文件都会在/home/username/ws/sdk/rockdev
目录下
xxx@ooo:~/ws/sdk/rockdev$ ls -hl
total 94M
boot.img -> ../../kernel/boot.img
linux-headers.tar
MiniLoaderAll.bin -> ../../u-boot/rk3399_loader_v1.30.130.bin
misc.img -> ../misc.img
oem.img
parameter.txt -> ../../device/rockchip/.chips/rk3399/parameter.txt
recovery.img -> ../recovery/ramboot.img
rootfs.img -> ../../buildroot/output/rockchip_rk3399/images/rootfs.ext2
trust.img -> ../../u-boot/trust.img
uboot.img -> ../../u-boot/uboot.img
update.img -> ../update/Image/update.img
update-rk3399-king-rk3399-buildroot-mipi-7-1024-600-20240912-214925.img -> ../update/Image/update.img
userdata.img
将该目录下的所有文件复制到共享目录下,在主机中打开前文中下载的烧写驱动
并安装,烧录流程参考,烧录时的硬件连接如下图所示:
烧录分立镜像:
烧录完整镜像:
烧录完成后,掉电重启:
重启的桌面上有几个测试软件,可以打开进行测试,在进行视频、图片以及3D渲染测试时建议不要长时间运行,板载CPU及内存颗粒发热严重!!!
另外脚注[3]中提供的镜像仅供King3399这个型号的板子使用,不可随意烧录!!!
[1] 荣品官网-网盘链接
[2] 荣品官网-在线文档
[3] SDK编译后的镜像(分立+完整)BaiduPan( pwd : vllt)