3. 编译 Android14.0 固件¶
3.1. 下载 Android14.0 SDK¶
SDK 源码与 bundle 压缩包均存放在云盘中。如有需要请联系商务 ： sales@t-firefly.com
3.1.1. 下载 SDK¶
SDK通过邮件的方式获取，把订单号发送到sales@t-firefly.com邮箱并注明需要的SDK名称firefly_rk3576_android14.0_git_20241126
下载完成后，在解压前先校验下 MD5 码：
$ md5sum /path/to/firefly_rk3576_android14.0_git_20241126.7z.001 $ md5sum /path/to/firefly_rk3576_android14.0_git_20241126.7z.002 $ md5sum /path/to/firefly_rk3576_android14.0_git_20241126.7z.003 $ md5sum /path/to/firefly_rk3576_android14.0_git_20241126.7z.004 $ md5sum /path/to/firefly_rk3576_android14.0_git_20241126.7z.005 $ md5sum /path/to/firefly_rk3576_android14.0_git_20241126.7z.006 e368c4274125e754eeea35a97306e47b firefly_rk3576_android14.0_git_20241126.7z.001 d4436c73b800523dbb1df2ae0d524b26 firefly_rk3576_android14.0_git_20241126.7z.002 9f6a7ed4f01a8952c135cc5bf6fd4ecd firefly_rk3576_android14.0_git_20241126.7z.003 3d2babe7c2c9f737d23e8843c2df3117 firefly_rk3576_android14.0_git_20241126.7z.004 1d9ae98cc3e0959de19bc1dd628ed112 firefly_rk3576_android14.0_git_20241126.7z.005 09e35581108741bf4a564829edcd1a5f firefly_rk3576_android14.0_git_20241126.7z.006
然后解压：
cd ~/proj/ 7z x ./firefly_rk3576_android14.0_git_20241126.7z.001 -oRK3576_Android14.0 cd ./RK3576_Android14.0 git reset --hard
注意：不要在共享文件夹、挂载文件夹以及非英文目录解压SDK，避免产生不必要的错误
3.1.2. 更新 SDK¶
下载 SDK 后，更新代码的方法：
#1. 进入 SDK 根目录
cd ~/proj/RK3576_Android14.0
#2. 在资源下载界面下载bundle文件并解压到SDK根目录，解压指令如下:
7z x rk3576-android14.0-bundle.7z* -r -o. && mv rk3576-android14.0-bundle .bundle
#3. 更新 SDK
.bundle/update
#4. 按照提示已经更新内容到 FETCH_HEAD,同步 FETCH_HEAD 到 firefly 分支
git rebase FETCH_HEAD
下载页面选择云盘下载 Android14.0 Bundle。
3.2. Core-3576JD4 产品编译方法¶
3.2.1. 整体编译¶
3.2.1.1. HDMI 固件编译¶
./FFTools/make.sh -j8 -l rk3576_firefly_aio_3576_jd4-userdebug
./FFTools/mkupdate/mkupdate.sh -l rk3576_firefly_aio_3576_jd4-userdebug
3.2.2. 分步编译¶
编译 kernel：
cd ~/proj/RK3576_Android14.0/kernel-6.10
export PATH=../prebuilts/clang/host/linux-x86/clang-r487747c/bin:$PATH
alias msk='make CROSS_COMPILE=aarch64-linux-gnu- LLVM=1 LLVM_IAS=1'
msk ARCH=arm64 firefly_defconfig android-14.config rk3576.config
msk ARCH=arm64 BOOT_IMG=../rockdev/Image-rk3576_firefly_aio_3576_jd4/boot.img rk3576-firefly-aio-3576jd4.img -j8
编译 uboot：
cd ~/proj/RK3576_Android14.0/u-boot/
make rk3576_defconfig
./make.sh --spl-new
编译 Android：
cd ~/proj/RK3576_Android14.0/
source build/envsetup.sh
lunch rk3576_firefly_aio_3576_jd4-userdebug
make installclean
make -j8
./mkimage.sh
3.2.3. 打包成统一固件 update.img¶
编译完可以用Firefly官方的脚本打包成统一固件，执行如下命令：
./FFTools/mkupdate/mkupdate.sh -l rk3576_firefly_aio_3576_jd4-userdebug
打包完成后将在rockdev/Image-rk3576_firefly_aio_3576_jd4/ 目录下生成统一固件： product名XXX_XXX_日期XXX.img
在 Windows 下打包统一固件 update.img 也很简单，将编译生成的文件拷贝到 AndroidTool 的 rockdev\Image 目录中，然后运行 rockdev 目录下的 mkupdate.bat 批处理文件即可创建 update.img 并存放到 rockdev\Image 目录里。
3.3. 其他编译说明¶
3.3.1. Android14.0 不能直接烧写 kernel.img 和 resource.img¶
Android14.0的kernel.img和resource.img包含在boot.img中，编译kernel后需要在android根目录下执行./mkimage.sh重新打包boot.img,然后烧写rockdev/Image-rk3576_firefly_aio_3576_jd4/目录下的boot.img。
3.3.2. 单独编译kernel生成boot.img¶
编译的原理：在kernel目录下将编译生成的 kernel.img 和 resource.img 替换到旧的 boot.img 中， 所以编译的时候需要用 BOOT_IMG=xxx 参数指定boot.img的路径，命令如下：
cd ~/proj/RK3576_Android14.0/kernel-6.10
export PATH=../prebuilts/clang/host/linux-x86/clang-r487747c/bin:$PATH
alias msk='make CROSS_COMPILE=aarch64-linux-gnu- LLVM=1 LLVM_IAS=1'
msk ARCH=arm64 firefly_defconfig android-14.config rk3576.config
msk ARCH=arm64 BOOT_IMG=../rockdev/Image-rk3576_firefly_aio_3576_jd4/boot.img rk3576-firefly-aio-3576jd4.img -j8
编译后可以直接烧写kernel目录下的boot.img。
3.4. 分区镜像¶
编译的时候执行 ./mkimage.sh 会重新打包 boot.img 和 super.img, 并将其它相关的镜像文件拷贝到目录 rockdev/Image-rk3576_firefly_aio_3576_jd4/ 中。以下列出一般固件用到的镜像文件：
| 固件 | 说明 |
|---|---|
| boot.img | 包含ramdis、kernel、dtb |
| dtbo.img | Device Tree Overlays |
| MiniLoaderAll.bin | 包含一级loader |
| misc.img | 包含recovery-wipe开机标识信息,烧写后会进行recovery |
| parameter.txt | 包含分区信息 |
| recovery.img | 包含recovery-ramdis、kernel、dtb |
| super.img | 包含odm、product、vendor、system、system_ext分区内容 |
| uboot.img | 包含uboot固件 |
| vbmeta.img | 包含avb校验信息,用于AVB校验 |
| update.img | 包含以上需要烧写的img文件,可以用于工具直接烧写整个固件包 |
请参照 《使用USB线缆升级固件》 一文来烧写分区镜像文件。
3.6. 常见问题¶
3.6.1. git clone 远程 bundle 仓库失败¶
Q：更新SDK时，git clone 远程 bundle 仓库出错：
$ git clone https://gitlab.com/T-Firefly/rk3588-Android14.0-bundle.git .bundle
Cloning into '.bundle'...
remote: Enumerating objects: 20, done.
remote: Counting objects: 100% (20/20), done.
remote: Compressing objects: 100% (18/18), done.
error: RPC failed; curl 56 GnuTLS recv error (-9): A TLS packet with unexpected length was received.
fatal: the remote end hung up unexpectedly
fatal: early EOF
fatal: unpack-objects failed
A：缓冲区大小不够，需要扩大缓冲区：
git config --global https.postBuffer 1048576000