开发板：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系统。

#**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版本：

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。