文章目录
- RV1126芯片介绍
- rv1126 模块代码目录相关说明
- SDK 包下的脚本使用
- build.sh 脚本使用
- envsetup.sh 脚本使用
- mkfirmware.sh 脚本使用
- rkflash.sh 脚本使用
- U-Boot 编译和配置
- uboot 的配置修改编译操作
- kernel 的修改编译
- rootfs 编译和配置
- buildroot 配置
- busybox 配置
- 固件打包
RV1126芯片介绍
RV1126 是 Rockchip 推出的一款编解码芯片,CPU 为 4 核 ARM Cortex-A7 32 位,专用于面向人工智能的机械视觉领域,支持 4K 编解码,支持 8 路 1080P 同时进行编解码,内置 2.0TOPS的 NPU。像这种专用芯片,芯片厂商都会给出芯片的 SDK 包进行二次开发,用它来开发有很多好处,比如:不用安装一下特殊的软件和库,自带交叉工具链、文件系统和第三方库,可以直接编译出系统镜像,开发环境搭建比较容易等等。但是开发自由度不够高,更新软件版本很麻烦,代码里有很多私货(芯片厂商自己定义的代码)等等
⚫ app : 存放上层应用程序的目录。
⚫ buildroot :SDK 包使用的文件系统为 buildroot。
⚫ build.sh :编译用的脚本,使用方法后面会教。
⚫ device/rockchip :存放每个平台的一些编译和打包固件的脚步和预备文件。
⚫ docs :存放 RK 开发指导文件、平台支持列表、工具使用文档、Linux 开发指南等。
⚫ envsetup.sh :要修改文件系统时候要设置的环境脚本。
⚫ external : 存放相关的库,包括音频,视频等。
⚫ kernel :kernel 源码。
⚫ makefile :整个 SDK 包编译的 Makefile。
⚫ mkfirmware.sh :固件打包使用的脚本,默认在当前路径下的 rockdev 目录。
⚫ prebuilts : 存放交叉编译工具链。
⚫ rkbin: 存放固件和工具。
⚫ rkflash.sh : linux 下的系统烧录脚本。
⚫ tools :存放固件和工具的目录。
⚫ u-boot :U-boot 源码目录。
⚫ rockdev:存放编译输出固件的目录(整个 SDK 包编译完成后就会创建
rv1126 模块代码目录相关说明
什么叫做模块代码?一个完整的 SDK 包除了 kernel、u-boot、buildroot 之外,还需要提供上层的第三方库和 APP,第三方库和 APP 合起来叫做模块代码。
SDK 包下的脚本使用
build.sh 脚本使用
查看 build.sh 使用帮助
morgan@morgan-machine:~/Work/rv1126$ ./build.sh lunch -h
Usage: build.sh [OPTIONS]
Available options:
BoardConfig*.mk -switch to specified board config
lunch -list current SDK boards and switch to specified board config
uboot -build uboot
spl -build spl
loader -build loader
kernel -build kernel
modules -build kernel modules
toolchain -build toolchain
rootfs -build default rootfs, currently build buildroot as default
buildroot -build buildroot rootfs
ramboot -build ramboot image
multi-npu_boot -build boot image for multi-npu board
yocto -build yocto rootfs
debian -build debian10 buster/x11 rootfs
distro -build debian10 buster/wayland rootfs
pcba -build pcba
recovery -build recovery
all -build uboot, kernel, rootfs, recovery image
cleanall -clean uboot, kernel, rootfs, recovery
firmware -pack all the image we need to boot up system
updateimg -pack update image
otapackage -pack ab update otapackage image (update_ota.img)
sdpackage -pack update sdcard package image (update_sdcard.img)
save -save images, patches, commands used to debug
allsave -build all & firmware & updateimg & save
check -check the environment of building
info -see the current board building information
app/<pkg> -build packages in the dir of app/*
external/<pkg> -build packages in the dir of external/*
实际编译测试使用耗时
morgan@morgan-machine:~/Work/rv1126$ time ./build.sh
processing board option: allsave
processing option: allsave
.....
vccio7-supply
regulator-min-microvolt = 1800mV
regulator-max-microvolt = 1800mV
Running build_allsave succeeded.real 116m26.217s
user 244m36.079s
sys 41m30.641s
envsetup.sh 脚本使用
envsetup.sh 脚本主要的作用是,使能 buildroot 的配置文件。在 RV1126 这个芯片里,一共可以选择的配置文件有 3 种分别为:文件系统的配置文件,recovery 分区的配置文件(此分区主要是用作升级和复原的文件系统,它也是一个文件系统)和 libs 的配置文件(生成一些库,方便
我们写应用层代码做测试,导出文件系统的库文件)。
mkfirmware.sh 脚本使用
mkfirmware.sh 脚本主要的作用是,把 uboot、kernel、文件系统等等进行打包和生成镜像。
rkflash.sh 脚本使用
rkflash.sh 脚本主要的作用是,在 linux 系统下进行固件的烧录
U-Boot 编译和配置
RK 官方提供了很方便的编译方法,直接运行以下./build.sh uboot 命令可以编译 uboot。
morgan@morgan-machine:~/Work/rv1126$ ./build.sh uboot
编译完成后,会在 u-boot 目录下生成 uboot.img 文件和 rv1126_spl_loader_v1.08.108.bin 文件,uboot.img 文件就是我们要烧录的 img 镜像,rv1126_spl_loader_v1.08.108.bin 是启动引导uboot 的文件
uboot 的配置修改编译操作
选择要修改 Uboot 配置文件,从板级文件知道
morgan@morgan-machine:~/Work/rv1126/u-boot$ make alientek_rv1126_defconfig
进入图形界面配置
morgan@morgan-machine:~/Work/rv1126/u-boot$ make menuconfig
把.config 保存为 defconfig
morgan@morgan-machine:~/Work/rv1126/u-boot$ make savedefconfig
scripts/kconfig/conf --savedefconfig=defconfig Kconfig
更新修改好的配 置文件到alientek_rv1126_defconfig
morgan@morgan-machine:~/Work/rv1126/u-boot$ cp defconfig configs/alientek_rv1126_defconfig
重新编译 uboot
morgan@morgan-machine:~/Work/rv1126$ ./build.sh uboot
红色框里打印日期为“2024-01-12 22:34:42
kernel 的修改编译
选择要修改的 kernel 配置文件
morgan@morgan-machine:~/Work/rv1126/kernel$ make ARCH=arm alientek_rv1126_defconfig
#
# configuration written to .config
#
进入图形界面配置
morgan@morgan-machine:~/Work/rv1126/kernel$ make ARCH=arm alientek_rv1126_defconfig
把.config 保存为 defconfig
morgan@morgan-machine:~/Work/rv1126/kernel$ make ARCH=arm savedefconfig
scripts/kconfig/conf --savedefconfig=defconfig Kconfig
更 新 修 改 好 的 配 置 文 件 到 alientek_rv1126_defconfig
cp defconfig arch/arm/configs/alientek_rv1126_defconfig
编译内核
morgan@morgan-machine:~/Work/rv1126$ ./build.sh kernel
配置完成后我们可以直接用 build.sh kernel 脚本进行编译了,就会生成我们想要的 zboot.img 文件
烧录成功会自动重启,我们查看打印信息内核有没有替换成功
rootfs 编译和配置
buildroot 配置
在 SDK 包源码目录下,运行以下命令进行配置 buildroot:
配置 buildroot 对应 defconfig
morgan@morgan-machine:~/Work/rv1126$ source envsetup.sh alientek_rv1126
Top of tree: /home/morgan/Work/rv1126
===========================================#TARGET_BOARD=rv1126
#OUTPUT_DIR=output/alientek_rv1126
#CONFIG=alientek_rv1126_defconfig===========================================
make: 进入目录“/home/morgan/Work/rv1126/buildroot”GEN /home/morgan/Work/rv1126/buildroot/output/alientek_rv1126/Makefile
/home/morgan/Work/rv1126/buildroot/build/defconfig_hook.py -m /home/morgan/Work/rv1126/buildroot/configs/alientek_rv1126_defconfig /home/morgan/Work/rv1126/buildroot/output/alientek_rv1126/.rockchipconfig
BR2_DEFCONFIG='' KCONFIG_AUTOCONFIG=/home/morgan/Work/rv1126/buildroot/output/alientek_rv1126/build/buildroot-config/auto.conf KCONFIG_AUTOHEADER=/home/morgan/Work/rv1126/buildroot/output/alientek_rv1126/build/buildroot-config/autoconf.h KCONFIG_TRISTATE=/home/morgan/Work/rv1126/buildroot/output/alientek_rv1126/build/buildroot-config/tristate.config BR2_CONFIG=/home/morgan/Work/rv1126/buildroot/output/alientek_rv1126/.config HOST_GCC_VERSION="9" BUILD_DIR=/home/morgan/Work/rv1126/buildroot/output/alientek_rv1126/build SKIP_LEGACY= BR2_DEFCONFIG=/home/morgan/Work/rv1126/buildroot/configs/alientek_rv1126_defconfig /home/morgan/Work/rv1126/buildroot/output/alientek_rv1126/build/buildroot-config/conf --defconfig=/home/morgan/Work/rv1126/buildroot/output/alientek_rv1126/.rockchipconfig Config.in
/home/morgan/Work/rv1126/buildroot/output/alientek_rv1126/.rockchipconfig:142:warning: override: reassigning to symbol BR2_PACKAGE_RKWIFIBT
/home/morgan/Work/rv1126/buildroot/output/alientek_rv1126/.rockchipconfig:179:warning: override: reassigning to symbol BR2_PACKAGE_UPDATE
/home/morgan/Work/rv1126/buildroot/output/alientek_rv1126/.rockchipconfig:185:warning: override: reassigning to symbol BR2_PACKAGE_RKSCRIPT
/home/morgan/Work/rv1126/buildroot/output/alientek_rv1126/.rockchipconfig:208:warning: override: reassigning to symbol BR2_TARGET_GENERIC_HOSTNAME
/home/morgan/Work/rv1126/buildroot/output/alientek_rv1126/.rockchipconfig:209:warning: override: reassigning to symbol BR2_TARGET_GENERIC_ISSUE
/home/morgan/Work/rv1126/buildroot/output/alientek_rv1126/.rockchipconfig:210:warning: override: reassigning to symbol BR2_TARGET_GENERIC_ROOT_PASSWD
/home/morgan/Work/rv1126/buildroot/output/alientek_rv1126/.rockchipconfig:235:warning: override: reassigning to symbol BR2_PACKAGE_ALSA_UTILS
/home/morgan/Work/rv1126/buildroot/output/alientek_rv1126/.rockchipconfig:236:warning: override: reassigning to symbol BR2_PACKAGE_ALSA_UTILS_ALSACONF
/home/morgan/Work/rv1126/buildroot/output/alientek_rv1126/.rockchipconfig:237:warning: override: reassigning to symbol BR2_PACKAGE_ALSA_UTILS_AMIXER
/home/morgan/Work/rv1126/buildroot/output/alientek_rv1126/.rockchipconfig:238:warning: override: reassigning to symbol BR2_PACKAGE_ALSA_UTILS_APLAY
/home/morgan/Work/rv1126/buildroot/output/alientek_rv1126/.rockchipconfig:239:warning: override: reassigning to symbol BR2_PACKAGE_ALSA_PLUGINS
/home/morgan/Work/rv1126/buildroot/output/alientek_rv1126/.rockchipconfig:240:warning: override: reassigning to symbol BR2_PACKAGE_LIBMAD
/home/morgan/Work/rv1126/buildroot/output/alientek_rv1126/.rockchipconfig:243:warning: override: reassigning to symbol BR2_PACKAGE_ALSA_CONFIG
/home/morgan/Work/rv1126/buildroot/output/alientek_rv1126/.rockchipconfig:251:warning: override: reassigning to symbol BR2_PACKAGE_LIBV4L
/home/morgan/Work/rv1126/buildroot/output/alientek_rv1126/.rockchipconfig:252:warning: override: reassigning to symbol BR2_PACKAGE_LIBV4L_UTILS
/home/morgan/Work/rv1126/buildroot/output/alientek_rv1126/.rockchipconfig:253:warning: override: reassigning to symbol BR2_PACKAGE_CAMERA_ENGINE
/home/morgan/Work/rv1126/buildroot/output/alientek_rv1126/.rockchipconfig:315:warning: override: reassigning to symbol BR2_PACKAGE_MPP
/home/morgan/Work/rv1126/buildroot/output/alientek_rv1126/.rockchipconfig:316:warning: override: reassigning to symbol BR2_PACKAGE_MPP_ALLOCATOR_DRM
/home/morgan/Work/rv1126/buildroot/output/alientek_rv1126/.rockchipconfig:318:warning: override: reassigning to symbol BR2_PACKAGE_LINUX_RGA
/home/morgan/Work/rv1126/buildroot/output/alientek_rv1126/.rockchipconfig:343:warning: override: reassigning to symbol BR2_PACKAGE_GST1_PLUGINS_GOOD_PLUGIN_RTP
/home/morgan/Work/rv1126/buildroot/output/alientek_rv1126/.rockchipconfig:344:warning: override: reassigning to symbol BR2_PACKAGE_GST1_PLUGINS_GOOD_PLUGIN_RTPMANAGER
/home/morgan/Work/rv1126/buildroot/output/alientek_rv1126/.rockchipconfig:345:warning: override: reassigning to symbol BR2_PACKAGE_GST1_PLUGINS_GOOD_PLUGIN_RTSP
/home/morgan/Work/rv1126/buildroot/output/alientek_rv1126/.rockchipconfig:351:warning: override: reassigning to symbol BR2_PACKAGE_GST1_PLUGINS_BASE_PLUGIN_VIDEORATE
/home/morgan/Work/rv1126/buildroot/output/alientek_rv1126/.rockchipconfig:352:warning: override: reassigning to symbol BR2_PACKAGE_GST1_PLUGINS_BASE_PLUGIN_VORBIS
/home/morgan/Work/rv1126/buildroot/output/alientek_rv1126/.rockchipconfig:353:warning: override: reassigning to symbol BR2_PACKAGE_GST1_PLUGINS_BASE_PLUGIN_OGG
/home/morgan/Work/rv1126/buildroot/output/alientek_rv1126/.rockchipconfig:558:warning: override: reassigning to symbol BR2_PACKAGE_NTP_NTPD
#
# configuration written to /home/morgan/Work/rv1126/buildroot/output/alientek_rv1126/.config
#
make: 离开目录“/home/morgan/Work/rv1126/buildroot”
进入图形化界面
morgan@morgan-machine:~/Work/rv1126$ make menuconfig
配置完成好保存。运行以下命令进行保存和重新编译(注意:buildroot 有时候不能生成一些配置选项,要运行./build.sh cleanall 命令清除,在编译)
保存配置文件到 buildroot/configs/alientek_rv1126_defconfig
morgan@morgan-machine:~/Work/rv1126$ make savedefconfig
umask 0022 && make -C /home/morgan/Work/rv1126/buildroot O=/home/morgan/Work/rv1126/buildroot/output/alientek_rv1126 savedefconfigGEN /home/morgan/Work/rv1126/buildroot/output/alientek_rv1126/Makefile
grep "#include" /home/morgan/Work/rv1126/buildroot/configs/alientek_rv1126_defconfig > /home/morgan/Work/rv1126/buildroot/configs/alientek_rv1126_defconfig.split || true
cat /home/morgan/Work/rv1126/buildroot/configs/alientek_rv1126_defconfig >> /home/morgan/Work/rv1126/buildroot/configs/alientek_rv1126_defconfig.split
/home/morgan/Work/rv1126/buildroot/build/defconfig_hook.py -s /home/morgan/Work/rv1126/buildroot/configs/alientek_rv1126_defconfig.split /home/morgan/Work/rv1126/buildroot/configs/alientek_rv1126_defconfig
rm /home/morgan/Work/rv1126/buildroot/configs/alientek_rv1126_defconfig.split
编译
morgan@morgan-machine:~/Work/rv1126$ ./build.sh rootfs
busybox 配置
在 SDK 包源码目录下,运行以下命令进行配置 busybox
/配置 buildroot 对应 defconfig
morgan@morgan-machine:~/Work/rv1126$ source envsetup.sh alientek_rv1126
进入图形化界面
morgan@morgan-machine:~/Work/rv1126$ make busybox-menuconfig
保存刚刚修改的配置
morgan@morgan-machine:~/Work/rv1126$ make busybox-menuconfig
重新编译文件系统
固件打包
官方提供了一个脚本,运行脚本命令如下所示(在 SDK 源码目录下运行)
选择环境变量 alientek_rv1126
morgan@morgan-machine:~/Work/rv1126$ source envsetup.sh alientek_rv1126
morgan@morgan-machine:~/Work/rv1126$ ./mkfirmware.sh
/usr/bin/fakeroot
Making /home/morgan/Work/rv1126/rockdev/demo.img from /home/morgan/Work/rv1126/buildroot/output/alientek_rv1126/demo (auto sized)
Making /home/morgan/Work/rv1126/rockdev/demo.img from /home/morgan/Work/rv1126/buildroot/output/alientek_rv1126/demo with size(50M)
记录了0+0 的读入
记录了0+0 的写出
0字节已复制,8.48e-05 s,0.0 kB/s
mke2fs 1.43.9 (8-Feb-2018)
丢弃设备块: 完成
创建含有 51200 个块(每块 1k)和 12824 个inode的文件系统
文件系统UUID:59f4ffb9-8e21-425c-ba5d-c9064bcd84f2
超级块的备份存储于下列块: 8193, 24577, 40961正在分配组表: 完成
正在写入inode表: 完成
创建日志(4096 个块)完成
将文件复制到设备:__populate_fs: 无法为ext2文件系统分配块 写入文件“ECM_DEMO”时
mke2fs: 无法为ext2文件系统分配块 于填充文件系统时
Retring with increased size....(1/10)
Making /home/morgan/Work/rv1126/rockdev/demo.img from /home/morgan/Work/rv1126/buildroot/output/alientek_rv1126/demo with size(54M)
记录了0+0 的读入
记录了0+0 的写出
0字节已复制,0.0001081 s,0.0 kB/s
mke2fs 1.43.9 (8-Feb-2018)
丢弃设备块: 完成
创建含有 55296 个块(每块 1k)和 13832 个inode的文件系统
文件系统UUID:881d2979-37bc-4bf4-93ea-91ba83a1332b
超级块的备份存储于下列块: 8193, 24577, 40961正在分配组表: 完成
正在写入inode表: 完成
创建日志(4096 个块)完成
将文件复制到设备:完成
写入超级块和文件系统账户统计信息: 已完成tune2fs 1.43.9 (8-Feb-2018)
设置最大挂载次数为 -1
将检查间隔设置为 0 秒
create rootfs.img...done.
create parameter...done.
/home/morgan/Work/rv1126/device/rockchip/rv1126_rv1109/parameter-buildroot-fit.txt
0x00002000@0x00004000(uboot),0x00002000@0x00006000(misc),0x00010000@0x00008000(boot),0x00010000@0x00018000(recovery),0x00010000@0x00028000(backup),0x00200000@0x00038000(rootfs),0x00060000@0x00238000(oem),0x00200000@0x00298000(userdata),0x00200000@0x00498000(media),-@0x00698000(demo:grow)
create recovery.img...done.
create misc.img...done.
Making /home/morgan/Work/rv1126/rockdev/userdata.img from /home/morgan/Work/rv1126/device/rockchip/userdata/userdata_normal (auto sized)
Making /home/morgan/Work/rv1126/rockdev/userdata.img from /home/morgan/Work/rv1126/device/rockchip/userdata/userdata_normal with size(5M)
记录了0+0 的读入
记录了0+0 的写出
0字节已复制,0.0001265 s,0.0 kB/s
mke2fs 1.43.9 (8-Feb-2018)
丢弃设备块: 完成
创建含有 5120 个块(每块 1k)和 1280 个inode的文件系统正在分配组表: 完成
正在写入inode表: 完成
将文件复制到设备:完成
写入超级块和文件系统账户统计信息: 已完成tune2fs 1.43.9 (8-Feb-2018)
设置最大挂载次数为 -1
将检查间隔设置为 0 秒
create uboot.img...done.
uboot fotmat type is fit, so ignore trust.img...
create loader...done.
create boot.img...done.Image: image in rockdev is ready
打包成功会在源码目录下新建一个“rockdev”目录,把需要烧录的文件打包进里面
可以看出很多文件都是通过软连接,简单的讲解每个文件的作用:
boot.img:里面包含了设备树、kernel 和 logo。注:里面有多个设备树文件。
demo.img:正点原子官方出厂 demo。
MiniLoaderAll.bin:此文件负责初始化 DDR,引导 Uboot。相当于 SPL 或者 TF-A。
misc.img:常用来作为系统升级时或者恢复出厂设置时使用。
oem.img:提供给厂商用的分区文件,像 RK 把他们自己库都放到这里。
parameter.txt:分区相关的文件。
recovery.img:升级相关的文件系统。
rootfs.img:buildroot 的文件系统。
uboot.img:里面包含 uboot 和设备树。
update.img:整个 SDK 的 img。
userdata.img:用户分区。