King3399 SDK编译简明教程
该文章仅供参考，编写人不对任何实验设备、人员及测量结果负责！！！
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)