Welcome to Firefly
中文
中文
Firefly文档中心
最近更新: 2026-11-13 16:38:16

编译 Android 固件

运行 Android 11.0，ROC-RK3568-PC-SE 需要满足如下条件：

  • DDR 至少需要 2 GB
  • eMMC 至少需要 16 GB

Android SDK

SDK 源码与 bundle 压缩包均存放在云盘中。

下载 SDK

  • 由于 SDK 较大，可以去下载页面选择云盘下载 Firefly-RK356X_Android11.0_git。

  • 下载完成后，在解压前先校验 MD5 码：

    $ md5sum /path/to/Firefly-RK356X_Android11.0_git_20210824.7z.001
$ md5sum /path/to/Firefly-RK356X_Android11.0_git_20210824.7z.002
$ md5sum /path/to/Firefly-RK356X_Android11.0_git_20210824.7z.003
$ md5sum /path/to/Firefly-RK356X_Android11.0_git_20210824.7z.004
$ md5sum /path/to/Firefly-RK356X_Android11.0_git_20210824.7z.005

b4c3d014a688d230bb25156a4c5aea26  Firefly-RK356X_Android11.0_git_20210824.7z.001
1ddfec58d0d69aee6029982fcbe4343c  Firefly-RK356X_Android11.0_git_20210824.7z.002
d08b16c244545ac68b496e2980d3c6a7  Firefly-RK356X_Android11.0_git_20210824.7z.003
2b628cc10a55214b8d9a3619673c01c3  Firefly-RK356X_Android11.0_git_20210824.7z.004
6f7e63955c96ca3c9ba6e4e49d52c90c  Firefly-RK356X_Android11.0_git_20210824.7z.005

  • 然后解压：

注意

不要在共享文件夹、挂载文件夹以及非英文目录解压 SDK，避免产生不必要的错误。

    $ mkdir ~/proj
    $ mv /path/to/Firefly-RK356X_Android11.0_git_20210824.7z.*  ~/proj
    $ cd ~/proj/
    $ 7z x ./Firefly-RK356X_Android11.0_git_20210824.7z.001 -oRK356X_Android11.0
    $ cd ./RK356X_Android11.0
    $ git reset --hard

更新 SDK

下载 SDK 后，从 GitLab 处更新代码的方法：

#1. 进入 SDK 根目录
cd ~/proj/RK356X_Android11.0

#2. 下载远程 bundle 仓库
git clone https://gitlab.com/TeeFirefly/rk356x-android11-bundle.git .bundle

#3. 若下载仓库失败，目前 bundle 仓库占用空间较大，所以同步的时候可能会出现卡住或失败的问题，
# 可以从云盘下载 bundle 并解压到 SDK 根目录，解压指令如下：

7z x rk356x-android11-bundle.7z  -r -o. && mv rk356x-android11-bundle/ .bundle/

#4. 更新 SDK，并且后续更新不需要再次拉取远程仓库，直接执行以下命令即可
.bundle/update

#5. 按照提示已经更新内容到 FETCH_HEAD,同步 FETCH_HEAD 到 firefly 分支
git rebase FETCH_HEAD

随着 SDK 的更新，bundle 也会随之越来越大，可以去下载页面选择云盘下载 bundle。

ROC-RK3568-PC-SE 产品编译方法

注意：若是第一次编译该Android Product，请使用公版编译命令进行一次完整编译

编译配置总览

模组说明

本节编译配置对应的模组：显示屏 DM-M10R800 V2 / DM-M10R800 V3S、双目摄像头 CAM-2MS2MF、HDMI TO MIPI_CSI 驱动板（RK628D）。

编译配置模组DTS（-d 参数）lunch（-l 参数）
公版编译（HDMI）—rk3568-firefly-roc-pc-serk3568_firefly_roc_pc_se-userdebug
显示屏 DM-M10R800 V2 编译（MIPI_DSI0+HDMI）DM-M10R800 V2rk3568-firefly-roc-pc-se-mipi101_M101014_BE45_A1rk3568_firefly_roc_pc-userdebug
显示屏 DM-M10R800 V3S 编译（MIPI_DSI0+HDMI）DM-M10R800 V3Srk3568-firefly-roc-pc-se-mipi101_BSD1218_A101KL68rk3568_firefly_roc_pc-userdebug
双目摄像头 CAM-2MS2MF 编译（HDMI+CAM-2MS2MF）CAM-2MS2MFrk3568-firefly-roc-pc-se（需先修改 dts）rk3568_firefly_roc_pc_se-userdebug
HDMI TO MIPI_CSI（RK628D）编译RK628Drk3568-firefly-roc-pc-se（需先修改 dts）rk3568_firefly_roc_pc_se-userdebug

公版编译

HDMI

./FFTools/make.sh -d rk3568-firefly-roc-pc-se -j8 -l rk3568_firefly_roc_pc_se-userdebug
./FFTools/mkupdate/mkupdate.sh -l rk3568_firefly_roc_pc_se-userdebug

显示屏编译

DM-M10R800 V2

MIPI_DSI0+HDMI

./FFTools/make.sh -d rk3568-firefly-roc-pc-se-mipi101_M101014_BE45_A1 -j8 -l rk3568_firefly_roc_pc-userdebug
./FFTools/mkupdate/mkupdate.sh -l rk3568_firefly_roc_pc-userdebug

DM-M10R800 V3S

MIPI_DSI0+HDMI

./FFTools/make.sh -d rk3568-firefly-roc-pc-se-mipi101_BSD1218_A101KL68 -j8 -l rk3568_firefly_roc_pc-userdebug
./FFTools/mkupdate/mkupdate.sh -l rk3568_firefly_roc_pc-userdebug

摄像头编译

HDMI+CAM-2MS2MF

  • 修改 dts

    diff --git a/kernel/arch/arm64/boot/dts/rockchip/rk3568-firefly-roc-pc-se.dts b/kernel/arch/arm64/boot/dts/rockchip/rk3568-firefly-roc-pc-se.dts
index 7e2a8b2..14fa027 100755
--- a/kernel/arch/arm64/boot/dts/rockchip/rk3568-firefly-roc-pc-se.dts
+++ b/kernel/arch/arm64/boot/dts/rockchip/rk3568-firefly-roc-pc-se.dts
@@ -7,6 +7,15 @@
- #include "rk3568-firefly-roc-pc-se-cam-8ms1m.dtsi"
+//#include "rk3568-firefly-roc-pc-se-cam-8ms1m.dtsi"
- //#include "rk3568-firefly-roc-pc-se-cam-2ms2m.dtsi"
+ #include "rk3568-firefly-roc-pc-se-cam-2ms2m.dtsi"

  • 编译

    ./FFTools/make.sh -d rk3568-firefly-roc-pc-se -j8 -l rk3568_firefly_roc_pc_se-userdebug
./FFTools/mkupdate/mkupdate.sh -l rk3568_firefly_roc_pc_se-userdebug

RK628D 编译

  • 修改 dts

    diff --git a/kernel/arch/arm64/boot/dts/rockchip/rk3568-firefly-roc-pc-se.dts b/kernel/arch/arm64/boot/dts/rockchip/rk3568-firefly-roc-pc-se.dts
index 9a6d081b..e8e4712 100755
--- a/kernel/arch/arm64/boot/dts/rockchip/rk3568-firefly-roc-pc-se.dts
+++ b/kernel/arch/arm64/boot/dts/rockchip/rk3568-firefly-roc-pc-se.dts
@@ -13,9 +13,9 @@
* using dual camera gc2053/gc2093   ----> rk3568-firefly-roc-pc-se-cam-2ms2m.dtsi
* using rk628d   ----> rk3568-firefly-roc-pc-tf-hdmi-mipi-rk628.dtsi
*/
-#include "rk3568-firefly-roc-pc-se-cam-8ms1m.dtsi"
+//#include "rk3568-firefly-roc-pc-se-cam-8ms1m.dtsi"
//#include "rk3568-firefly-roc-pc-se-cam-2ms2m.dtsi"
-//#include "rk3568-firefly-roc-pc-tf-hdmi-mipi-rk628.dtsi"
+#include "rk3568-firefly-roc-pc-tf-hdmi-mipi-rk628.dtsi"

  • 编译

    ./FFTools/make.sh -d rk3568-firefly-roc-pc-se -j8 -l rk3568_firefly_roc_pc_se-userdebug
./FFTools/mkupdate/mkupdate.sh -l rk3568_firefly_roc_pc_se-userdebug

编译完成后，将在 rockdev/Image-XXX/ 目录下生成统一固件 update.img。

手动编译 ROC-RK3568-PC-SE Android 11.0

编译前执行如下命令配置环境变量：

export JAVA_HOME=/usr/lib/jvm/java-8-openjdk-amd64
export PATH=$JAVA_HOME/bin:$PATH
export CLASSPATH=.:$JAVA_HOME/lib:$JAVA_HOME/lib/tools.jar
  • 编译 kernel：
cd ~/proj/RK356X/kernel/
make ARCH=arm64 firefly_defconfig android-11.config rk356x.config firefly_wifi.config
make ARCH=arm64 BOOT_IMG=../rockdev/Image-rk3568_firefly_roc_pc_se/boot.img rk3568-firefly-roc-pc-se.img -j8

注意

进行内核 debug 的时候，单编译生成 boot.img 如果出现运行错误，可参考FAQs。

  • 编译 uboot：
cd ~/proj/RK356X/u-boot/
./make.sh rk3568
  • 编译 Android：
cd ~/proj/RK356X/
source build/envsetup.sh
lunch rk3568_firefly_roc_pc_se-userdebug
make installclean
make -j8
./mkimage.sh

打包成统一固件 update.img

编译完可以用 Firefly 官方的脚本打包成统一固件，执行如下命令：

./FFTools/mkupdate/mkupdate.sh -l rk3568_firefly_roc_pc_se-userdebug

打包完成后将在 rockdev/Image-XXX/ 目录下生成统一固件：product 名 XXX_XXX_日期XXX.img

在 Windows 下打包统一固件 update.img 也很简单，将编译生成的文件拷贝到 AndroidTool 的 rockdev\Image 目录中，然后运行 rockdev 目录下的 mkupdate.bat 批处理文件即可创建 update.img 并存放到 rockdev\Image 目录里。

OTA 编译

Firefly 完整OTA编译和升级

添加-o 参数进行OTA全局编译

./FFTools/make.sh -d rk3568-firefly-roc-pc-se -j8 -l rk3568_firefly_roc_pc_se-userdebug -o

生成完整包路径

out/target/product/rk3568_firefly_roc_pc_se/rk3568_firefly_roc_pc_se-ota-eng.xxx.zip

生成基础素材包路径

out/target/product/rk3568_firefly_roc_pc_se/obj/PACKAGING/target_files_intermediates/rk3568_firefly_roc_pc_se-target_files-eng.xxx.zip

拷贝基础素材包并重新命名，主要用在差分包升级。

cp out/target/product/rk3568_firefly_roc_pc_se/obj/PACKAGING/target_files_intermediates/rk3568_firefly_roc_pc_se-target_files-eng.xxx.zip ~/ota/v1.zip

打包编译的固件和升级

./FFTools/mkupdate/mkupdate.sh -l rk3568_firefly_roc_pc_se-userdebug

在 rockdev/Image-rk3568_firefly_roc_pc_se/ 目录下找到对应的固件烧录到机器，此后机器就可以进行全量包升级和差分包升级。将刚刚编译的完整包 rk3568_firefly_roc_pc_se-ota-eng.xxx.zip 命名为 update.zip，放到 /sdcard/ 目录下重启，并按照提示进行全量包升级。

OTA 差分包生成

生成新的基础素材包

如上已经制作了 v1.zip 的基础素材包，需要再做一个 v2.zip 的素材包才能生成差分包，需修改内核 dts 相关代码或 Android 的代码，然后重新执行命令。

./FFTools/make.sh -d rk3568-firefly-roc-pc-se -j8 -l rk3568_firefly_roc_pc_se-userdebug -o

重新生成新的基础素材包我们可以进行拷贝。

cp out/target/product/rk3568_firefly_roc_pc_se/obj/PACKAGING/target_files_intermediates/rk3568_firefly_roc_pc_se-target_files-eng.xxx.zip  ~/ota/v2.zip

生成差分包命令

out/host/linux-x86/bin/ota_from_target_files --block -v -i ~/ota/v1.zip -p out/host/linux-x86/ -k build/target/product/security/testkey ~/ota/v2.zip update.zip

升级OTA差分包

把 update.zip 放到机器 sdcard 目录下重启，就会自动识别到，然后按步骤点击升级即可完成。

OTA 服务器搭建

参考OTA 文档搭建服务器。

本页目录

编译 Android 固件
Android SDK
1下载 SDK
2更新 SDK
3ROC-RK3568-PC-SE 产品编译方法
整体编译
编译配置总览
1公版编译
2显示屏编译
3摄像头编译
4RK628D 编译