-
创建者：
foxluo，上次更新时间：4月 10, 2026
需要 3 分钟阅读时间
如开发环境未搭建，请参考Linux开发环境搭建
系统编译
1. sdk目录结构
├── app ├── buildroot #buildroot构建目录 ├── build.sh -> device/rockchip/common/scripts/build.sh #sdk编译脚本 ├── common -> device/rockchip/common #自动化编译脚本hook ├── Copyright_Statement.md -> docs/licenses/LICENSE #license ├── debian #debian构建目录 ├── device #板型配置目录 ├── docs #rockchip文档 ├── external #rockchip模块组件包 ├── hal # ├── kernel -> kernel-6.1 ├── kernel-6.1 ├── Makefile -> device/rockchip/common/Makefile ├── output ├── prebuilts ├── README.md ├── README_rk.md -> device/rockchip/common/README.md ├── repo_readme.txt ├── rkbin ├── rkflash.sh -> device/rockchip/common/scripts/rkflash.sh ├── rockdev -> output/firmware ├── rtos ├── test.txt ├── tmp ├── tools ├── u-boot └── yocto
2. 选择要编译的板型
./build.sh chip #选择要编译的芯片 Log colors: message notice warning error fatal Log saved at /home/foxluo/work0/rockchip/rk_linux/rk_linux_6.1/output/sessions/2025-11-18_19-37-19 Pick a chip: 1. rk3566_rk3568 2. rk3576 3. rk3588 Which would you like? [1]: 3 #选择rk3588 Switching to chip: rk3588 Pick a defconfig: 1. rockchip_defconfig 2. hugsun_rk3588_edge_lp4_v12_debain_defconfig 3. hugsun_rk3588_edge_lp4_v12_defconfig 4. hugsun_rk3588_edge_lp4_v14a_debain_defconfig 5. rockchip_rk3588_evb1_lp4_v10_amp_defconfig 6. rockchip_rk3588_evb1_lp4_v10_defconfig 7. rockchip_rk3588_evb1_lp4_v10_mcu_defconfig 8. rockchip_rk3588_evb7_v11_defconfig 9. rockchip_rk3588_ipc_evb1_v10_defconfig 10. rockchip_rk3588_ipc_evb7_lp4_v11_defconfig 11. rockchip_rk3588_multi_ipc_evb1_v10_defconfig 12. rockchip_rk3588s_evb1_lp4x_v10_defconfig Which would you like? [1]: 3 #选择hugsun edge v1.2a板型 Switching to defconfig: /home/foxluo/work0/rockchip/rk_linux/rk_linux_6.1/device/rockchip/.chip/hugsun_rk3588_edge_lp4_v12_defconfig # # configuration written to /home/foxluo/work0/rockchip/rk_linux/rk_linux_6.1/output/.config # Using last kernel version(6.1)
如需修改板型参数，在配置界面中调整参数
make menuconfig
板型配置文件说明
$ vi device/rockchip/rk3588/hugsun_rk3588_edge_lp4_v12_defconfig RK_YOCTO_CFG="rockchip-rk3588-evb" #kernel对应的dts RK_KERNEL_DTS_NAME="rk3588-hugsun-edge-v12-linux" #kernel对应的dts RK_KERNEL_CFG_FRAGMENTS="rockchip_linux_docker.config" #docker config配置片段 RK_USE_FIT_IMG=y #是否为FIT模块方式 RK_WIFIBT_CHIP="ALL_AP" #集成所有WIFI模块驱动 RK_WIFIBT_TTY="ttyS6" #蓝牙对应的串口
4. 全自动编译
为了确保软件开发套件（SDK）的每次更新都能顺利进行，建议在更新前清理之前的编译产物。这样做可以避免潜在的兼容性问题或编译错误，因为旧的编译产物可能不适用于新版本的SDK。要清理这些编译产物，可以直接运行命令
./build.sh cleanall
进入工程根目录执行以下命令自动完成所有的编译：
./build.sh all # 只编译模块代码（u-Boot，kernel，Rootfs，Recovery） # 需要再执行`./build.sh ./mkfirmware.sh 进行固件打包 ./build.sh # 编译模块代码（u-Boot，kernel，Rootfs，Recovery） # 打包成update.img完整升级包 # 所有编译信息复制和生成到out目录下
默认是 Buildroot，可以通过设置坏境变量 RK_ROOTFS_SYSTEM 指定不同 rootfs。RK_ROOTFS_SYSTEM目前可设定三种系统：buildroot、debian、 yocto 。
比如需要 debain 可以通过以下命令进行生成：
export RK_ROOTFS_SYSTEM=debian ./build.sh 或 RK_ROOTFS_SYSTEM=debian ./build.sh
5. 模块编译
5.1 U-Boot编译
进入SDK工程。运行如下命令进行编译：
#./build.sh uboot
具体板级编译参考SDK发布文档中编译说明。
5.2 Kernel编译
进入工程目录根目录执行以下命令自动完成 kernel 的编译及打包。
#./build.sh kernel
具体板级编译参考发布说明或者Quick Start中编译说明。
5.3 Recovery编译
进入工程根目录执行以下命令自动完成 Recovery 的编译及打包。
#./build.sh recovery
编译后在 Buildroot 目录 `output/rockchip_rk3562_recovery/images 生成 recovery.img。
注： recovery.img 是包含内核，所以每次 Kernel 更改，Recovery 是需要重新打包生成。Recovery重新打包的
方法如下：
#source buildroot/envsetup.sh #cd buildroot #make recovery-reconfigure #cd - #./build.sh recovery
注：Recovery是非必需的功能，有些板级配置不会设置
5.4 Buildroot编译
进入工程目录根目录执行以下命令自动完成 Rootfs 的编译及打包：
#./build.sh rootfs
编译后在Buildroot目录output/rockchip_rk3562/images下生成不同格式的镜像, 默认使用rootfs.ext4格式。
具体可参考Buildroot开发文档参考：
<SDK>/docs/cn/Linux/ApplicationNote/Rockchip_Developer_Guide_Buildroot_CN.pdf
5.5 Debian编译
#./build.sh debian
编译后在 debian 目录下生成 linaro-rootfs.img。
说明：需要预先安装相关依赖包
sudo apt-get install binfmt-support qemu-user-static live-build sudo dpkg -i ubuntu-build-service/packages/* sudo apt-get install -f
具体可参考Debian开发文档参考：
<SDK>/docs/cn/Linux/ApplicationNote/Rockchip_Developer_Guide_Debian_CN.pdf
5.6 Yocto 编译
进入工程目录根目录执行以下命令自动完成 Rootfs 的编译及打包：
#./build.sh yocto
编译后在 yocto 目录 build/lastest 下生成 rootfs.img。
默认用户名登录是 root。Yocto 更多信息请参考 Rockchip Wiki。
FAQ：
上面编译如果遇到如下问题情况：
Please use a locale setting which supports UTF-8 (such as LANG=en_US.UTF-8). Python can't change the filesystem locale after loading so we need a UTF-8 when Python starts or things won't work.
解决方法:
locale-gen en_US.UTF-8 export LANG=en_US.UTF-8 LANGUAGE=en_US.en LC_ALL=en_US.UTF-8
或者参考 setup-locale-python3