【rk3588】环境搭建及系统编译

开发板:ROC-RK3588S-PC

官方链接:Welcome to ROC-RK3588S-PC Manual --- Firefly Wiki (t-firefly.com)

串口调试配置

一、产品介绍 --- Firefly Wiki (t-firefly.com),可以按照官方链接的说明在个人PC上使用串口。这个串口会输出rk3588的日志信息,同时也可以允许用户输入shell命令进行调试。但是还不能互相传文件。

我们使用串口可以查询到包括内核名称、节点名称、内核发行版本、内核版本、机器类型、处理器类型、硬件平台和操作系统。aarch64是ARMv8架构下的64位指令集架构的官方名称,有时也被人们称为ARM64。

注:作者在使用过程中碰到过串口不能输入shell命令的情况,只能查看日志信息。最终发现是USB转串口模块的问题,更换一个就好了。作者使用的是CH340型号的,不是开发板随带的。

ADB调式配置

除了上述使用串口调试外,我们还可以使用ADB,它是Android的命令行调试工具,但是我们编译的是buildroot系统,其实也可以使用ADB,这一点后面再解释。

连接OTG端口,也就是Type-C的USB口,这一个端口在烧录固件的时候也会用到

安装RK-USB驱动。注意,如果正确进入loader模式但一直找不到设备,可以尝试更换USB线。下载安装ADB工具。

打开命令行窗口,进入ADB根目录。执行adb shell命令,即可输入shell命令了。

交叉编译环境

通常情况下,我们会把编译环境搭建在Linux服务器或者虚拟机上,在那个上面进行编译,然后把编译的文件用在RK3588平台上。显然,Linux服务器或者虚拟机肯定不是和RK3399平台使用相同的架构。例如我们使用的服务器为:

服务器上是x86架构,RK3588是ARM64架构。这个时候就需要交叉编译,其实就是在x86机器上编译的东西放在arm64机器上用。所以,后需的代码工作都是在x86服务器上展开的。(关于怎么登录访问服务器这里就不展开了。。。)

服务器环境啥的都提前配置好了,这里暂时不介绍。

获取SDK

1. 编译 Linux 固件 --- Firefly Wiki (t-firefly.com)

我们的计划是编译buildroot系统,那么需要厂商的Linuxsdk,压缩包文件为:rk3588_firefly-1.4.0b.tar.gz ,我们使用的是方式一,首先获取的是SDK repo压缩包,将该包解压后再使用命令 .repo/repo/repo sync -l导出源代码。

解压之后其实就一个 .repo的隐藏文件夹。然后执行导出源代码命令。

最后还需要同步代码

以后,我们就可以使用第二个命令进行代码更新了。

Linux SDK 配置介绍

配置文件介绍

device/rockchip/rk3588/ 目录下,有不同板型的配置文件(xxxx.mk),用于管理 SDK 每个环节的编译配置,可以查看一下

显然,根据名称,我们要使用的是roc-rk3588s-pc-buildroot.mk,因为我们要编译buildroot系统。

txt 复制代码
#**roc-rk3588s-pc-buildroot.mk**文件内容如下

CMD=`realpath $BASH_SOURCE`
CUR_DIR=`dirname $CMD`

source $CUR_DIR/itx-3588j-buildroot.mk

# Kernel dts
export RK_KERNEL_DTS=roc-rk3588s-pc-mipi101-M101014-BE45-A1

# PRODUCT MODEL
export RK_PRODUCT_MODEL=ROC_RK3588S_PC

前3行代码使用 source 命令来执行位于当前脚本同一目录下的 itx-3588j-buildroot.mk 文件。该文件内容如下:

CMD=`realpath $BASH_SOURCE`
CUR_DIR=`dirname $CMD`

source $CUR_DIR/BoardConfig.mk

# Kernel defconfig fragment
export RK_KERNEL_DEFCONFIG_FRAGMENT="$RK_KERNEL_DEFCONFIG_FRAGMENT firefly-linux.config"

# Uboot_defconfig_fragment
export RK_UBOOT_DEFCONFIG_FRAGMENT=firefly-linux.config

# parameter for GPT table
export RK_PARAMETER=parameter-ubuntu-fit.txt

# Kernel dts
export RK_KERNEL_DTS=rk3588-firefly-itx-3588j-mipi101-M101014-BE45-A1

# Set userdata partition type
export RK_USERDATA_FS_TYPE=ext4

# Set extboot
export FF_EXTBOOT=true

export FF_EXTBOOT_SIZE=256M

# PRODUCT MODEL
export RK_PRODUCT_MODEL=ITX_3588J

# recovery ramdisk
export RK_RECOVERY_RAMDISK=rk3588-recovery-arm64.cpio.gz

# Recovery config
export RK_CFG_RECOVERY=

# Buildroot config
export RK_CFG_BUILDROOT=firefly_rk3588

export RK_EXTRA_PARTITIONS=

# packagefile for make update image
export RK_PACKAGE_FILE=rk3588-ubuntu-package-file

前3行代码使用 source 命令来执行位于当前脚本同一目录下的 BoardConfig.mk 文件,该文件内容如下:

#!/bin/bash

# Target arch
export RK_ARCH=arm64
# Uboot defconfig
export RK_UBOOT_DEFCONFIG=rk3588
# Uboot image format type: fit(flattened image tree)
export RK_UBOOT_FORMAT_TYPE=fit
# Kernel defconfig
export RK_KERNEL_DEFCONFIG=rockchip_linux_defconfig
# Kernel defconfig fragment
export RK_KERNEL_DEFCONFIG_FRAGMENT=rk3588_linux.config
# Kernel dts
export RK_KERNEL_DTS=rk3588-evb3-lp5-v10-linux
# boot image type
export RK_BOOT_IMG=boot.img
# kernel image path
export RK_KERNEL_IMG=kernel/arch/arm64/boot/Image
# kernel image format type: fit(flattened image tree)
export RK_KERNEL_FIT_ITS=boot.its
# parameter for GPT table
export RK_PARAMETER=parameter.txt
# Buildroot config
export RK_CFG_BUILDROOT=rockchip_rk3588
# Recovery config
export RK_CFG_RECOVERY=rockchip_rk3588_recovery
# Recovery image format type: fit(flattened image tree)
export RK_RECOVERY_FIT_ITS=boot4recovery.its
# ramboot config
export RK_CFG_RAMBOOT=
# Pcba config
export RK_CFG_PCBA=rockchip_rk3588_pcba
# Build jobs
export RK_JOBS=12
# target chip
export RK_TARGET_PRODUCT=rk3588
# Set rootfs type, including ext2 ext4 squashfs
export RK_ROOTFS_TYPE=ext4
# debian version (debian10: buster, debian11: bullseye)
export RK_DEBIAN_VERSION=bullseye
# yocto machine
export RK_YOCTO_MACHINE=rockchip-rk3588-evb
# rootfs image path
export RK_ROOTFS_IMG=rockdev/rootfs.${RK_ROOTFS_TYPE}
# Set ramboot image type
export RK_RAMBOOT_TYPE=
# <dev>:<mount point>:<fs type>:<mount flags>:<source dir>:<image size(M|K|auto)>:[options]
export RK_EXTRA_PARTITIONS=" \
	oem:/oem:ext2:defaults:oem_normal:auto:resize
	userdata:/userdata:ext2:defaults:userdata_normal:auto:resize
"
# OEM build on buildroot
#export RK_OEM_BUILDIN_BUILDROOT=YES
#misc image
export RK_MISC=wipe_all-misc.img
#choose enable distro module
export RK_DISTRO_MODULE=
# Define pre-build script for this board
export RK_BOARD_PRE_BUILD_SCRIPT=app-build.sh
# Define package-file
export RK_PACKAGE_FILE=rk3588-package-file
# Define WiFi BT chip
# Compatible with Realtek and AP6XXX WiFi : RK_WIFIBT_CHIP=ALL_AP
# Compatible with Realtek and CYWXXX WiFi : RK_WIFIBT_CHIP=ALL_CY
# Single WiFi configuration: AP6256 or CYW43455: RK_WIFIBT_CHIP=AP6256
export RK_WIFIBT_CHIP=ALL_AP
# Define BT ttySX
export RK_WIFIBT_TTY=ttyS8

配置文件指定了DTS文件和分区表文件等其他文件。上述配置文件中是

RK_KERNEL_DTS = roc-rk3588s-pc-mipi101-M101014-BE45-A1

RK_PARAMETER = parameter-ubuntu-fit.txt

分区说明

parameter.txt 文件中包含了固件的分区信息,以 parameter-ubuntu-fit.txt 为例:

路径:device\rockchip\rk3588\parameter-ubuntu-fit.txt

FIRMWARE_VER: 1.0
MACHINE_MODEL: RK3588
MACHINE_ID: 007
MANUFACTURER: RK3588
MAGIC: 0x5041524B
ATAG: 0x00200800
MACHINE: 0xffffffff
CHECK_MASK: 0x80
PWR_HLD: 0,0,A,0,1
TYPE: GPT
CMDLINE: mtdparts=rk29xxnand:0x00004000@0x00004000(uboot),0x00002000@0x00008000(misc),0x00080000@0x0000a000(boot:bootable),0x00040000@0x0008a000(recovery),0x00010000@0x000ca000(backup),0x00c00000@0x000da000(rootfs),-@0x00cda000(userdata:grow)
uuid:rootfs=614e0000-0000-4b53-8000-1d28000054a9

CMDLINE 属性是我们关注的地方,以 misc 为例, 0x00002000@0x00008000(uboot) 中 0x00008000 为uboot 分区的起始位置,0x00002000 为分区的大小,以此类推。

package-file 文件用于打包固件时确定需要的分区镜像和镜像路径,同时它需要与 parameter.txt 文件保持一致。

路径:tools/linux/Linux_Pack_Firmware/rockdev/rk3588-package-file

编译Buildroot固件

说一句题外话,可以使用如下命令查询SDK版本:

shell 复制代码
zhudk@vm1:/expand/zhudk/rk3588_firefly$ readlink -f .repo/manifest.xml
/expand/zhudk/rk3588_firefly/.repo/manifests/rk3588/rk3588_linux_release_20240517_v1.4.0b.xml
编译前配置

device/rockchip/rk3588/ 目录下,有不同板型的配置文件,选择配置文件:

全自动编译

全自动编译会执行上述编译、打包操作,生成 RK 固件。

./build.sh

打包固件,生成的完整固件会保存到 rockdev/pack/ 目录。

部分编译
  • 编译 u-boot

    ./build.sh uboot

  • 编译 kernel

    ./build.sh extboot

  • 编译 recovery

    ./build.sh recovery

  • 编译 buildroot

    ./build.sh rootfs

  • 更新各部分镜像链接到 rockdev/ 目录:

    ./mkfirmware.sh

  • 打包固件,生成的完整固件会保存到 rockdev/pack/ 目录。

    ./build.sh updateimg

编译完成后 rockdev/ 目录如下

使用USB线缆升级固件

USB驱动和烧录工具不做解释,如果遇到问题可以尝试更换工具版本或者USB线缆。

进入升级模式

通常我们升级固件的模式有两种,分别是Loader模式和MaskRom模式。烧写固件前,我们需要连接好设备,并让板子进入到可升级模式。

MaskRom 模式是设备变砖的最后一条防线。强行进入 MaskRom 涉及硬件操作,有一定风险,因此仅在设备进入不了 Loader 模式的情况下,方可尝试 MaskRom 模式。进入 MaskRom 的原理是人为的把 EMMC 的数据脚与地线短接,系统会认为 EMMC 数据出错,从而清除 EMMC 数据。可以按maskrom 按键,然后进行上电,此时设备就会进入 MaskRom 模式。

进入Loader模式也有几种方式

  • 在串口调试终端或adb shell给板子运行以下命令reboot loader
  • 保持板子上电,先按住RECOVERY键并保持,再按住RESET按键大约两秒钟(其实可以看日志)后,松开RECOVERY键。
烧写统一固件

统一固件是由分区表、bootloader、uboot、kernel、system等所有文件打包合并成的单个文件。Firefly正式发布的固件都是采用统一固件格式,升级统一固件将会更新主板上所有分区的数据和分区表,并且擦除主板上所有数据。

烧写分区镜像

即各个功能独立的文件,如分区表、bootloader、kernel等,在开发阶段生成。独立分区镜像可以只更新指定的分区,而保持其它分区数据不被破坏,在开发过程中会很方便调试。

如果我们做驱动开发,其实可以仅烧录boot.img

相关推荐
迅为电子1 天前
迅为RK3588开发板Android多屏显示之多屏同显和多屏异显
人工智能·rk3588·多屏显示
通俗_易懂8 天前
44-RK3588s调试 camera-engine-rkaiq(rkaiq_3A_server)
人工智能·计算机视觉·rk3588·驱动·camera·imx415
mucheni1 个月前
探索巅峰性能 |迅为 RK3588开发板深度剖析
rk3588
零意@1 个月前
rk3588调试es8388语音编解码IC小结
linux·rk3588·音频编解码·es8388·声卡
不做签到员1 个月前
RKLLM部署
python·大模型·rk3588·rknn·rkllm
Industio_触觉智能2 个月前
新品|瑞芯微RK3588工控机IPC8801适用AI算力、边缘计算、工业视觉
人工智能·rk3588·openharmony·工控机
L1_Zhang2 个月前
RK3588 系列之3—rknn使用过程中遇到的bug
rk3588
做程序员的第一天2 个月前
RKNPU2从入门到实践 ---- 【8】借助 RKNN Toolkit lite2 在RK3588开发板上部署RKNN模型
linux·人工智能·pycharm·rk3588·rknpu
做程序员的第一天2 个月前
rknntoolkitlite2环境搭建
linux·人工智能·pycharm·rk3588·rknpu