软件开发指导
开发环境
文件下载
从网盘中找到VirtualBox安装包并下载，路径为：1.通用资料–>1.3-工具–>VirtualBox-5.2.12–>VirtualBox-5.2.12-122591-Win.exe
安装虚拟机软件
双击下载的VirtualBox-5.2.12-122591-Win.exe后如下进行安装
为虚拟机配置 Windows
添加 Windows 网卡
配置 Windows 网卡
导入虚拟机系统
虚拟机设置
虚拟机与PC互传文件
可使用Samba或SSH传送文件
Samba如下
SSH如下
虚拟机使用
用户和密码
默认用户：tangb，UserName：myzr，Password：myzr2012
超级用户：root，UserName：root，Password：myzr2012
Linux源码编译
编译环境要求
编译主机需在ubuntu系统中进行，且版本需Ubuntu 20.04以上，笔者主机系统为Ubuntu 20.04
主机需可连接外网，因为编译系统过程需要下载某些文件。
下载源码包
下载rk3588源码包，路径为：3.软件资料–>3.1源码–>rk3588-linux.tar.xz
创建编译目录:
mkdir -p ~/my-work/RK3588/02_sources/
把源码放到刚创建的目录中，并进行解压：
tar xvf rk3588-linux.tar.xz -C ~/my-work/RK3588/02_sources/
依赖安装
首次编译可能需要安装某些依赖，下面给出主机可能需要安装的某些依赖:
sudo apt-get install uuid uuid-dev zlib1g-dev liblz-dev liblzo2-2 liblzo2-dev lzop \
git curl u-boot-tools mtd-utils openjdk-8-jdk device-tree-compiler \
gdisk m4 zlib1g-dev git gnupg flex bison gperf libsdl1.2-dev libesd-java \
squashfs-tools build-essential zip curl libncurses5-dev zlib1g-dev pngcrush schedtool \
libxml2 libxml2-utils xsltproc lzop libc6-dev schedtool g++-multilib lib32z1-dev \
lib32ncurses-dev lib32readline-dev gcc-multilib libswitch-perl libssl-dev unzip \
zip liblz4-tool git ssh make gcc libssl-dev liblz4-tool vim expect \
g++ patchelf chrpath gawk texinfo chrpath diffstat binfmt-support \
qemu-user-static live-build bison flex fakeroot cmake gcc-multilib g++-multilib \
unzip device-tree-compiler python3-pip libncurses5-dev rsync subversion python-protobuf \
sed make binutils build-essential gcc g++ wget python-is-python2 libncurses5 bzr cvs git mercurial \
patch gzip bzip2 perl tar cpio unzip rsync file bc wget qemu-user-static live-build android-sdk-libsparse-utils android-sdk-ext4-utils -y libicu-dev
整体编译
运行整体编译(编译时间较长)，输入如下命令:
buildroot
./build.sh buildroot_update
ubuntu20
./build.sh ubuntu20_update
ubuntu22
./build.sh ubuntu22_update
debian11
./build.sh debian11_update
debian12
./build.sh debian12_update
编译成功后在rockdev/目录下可看到相关镜像，其中update.img是所有镜像的集合
单独编译uboot
编译前可先清除生成文件
cd u-boot/
make clean
回到SDK主目录，并进行uboot单独编译
cd ../
./build.sh uboot
单独编译Kernel
编译前可先清除生成文件
cd kernel/
make clean
回到SDK主目录，并进行kernel单独编译
cd ../
./build.sh kernel
单独编译recovery
在SDK主目录下输入如下命令:
./build.sh recovery
单独编译rootfs
在SDK主目录下输入如下命令:
buildroot
./build.sh rootfs
ubantu20
./build.sh ubuntu20
ubantu22
./build.sh ubuntu22
debian11
./build.sh debian11
debian12
./build.sh debian12
打包固件
在SDK主目录下输入如下命令:
./mkfirmware.sh
打包update.img
在rockdev将镜像打包成update.img
在SDK主目录下输入如下命令:
./build.sh updateimg
完成上述操作后可按照刷机手册重新刷机
最后提示用户应该重新刷机测试
安卓源码编译
编译环境要求
编译主机需在linux环境中进行，推荐主机系统为Ubuntu 20.04
主机需可连接外网，因为编译系统过程需要下载某些文件。
下载源码包
网盘目录下，下载源码包 MYZR-RK3588-EK360_Android12_20260108.tar.bz2(请将网盘内分卷文件下载后合并可以得到该压缩包)
创建编译目录：
mkdir ~/my-work/rk3588/05_android -p
把源码放到此目录中，并进行解压：
tar xvf MYZR-RK3588-EK360_Android12_20260108.tar.bz2 -C ~/my-work/rk3588/05_android/
配置编译环境
每次打开一个新的终端，都需要进行一个环境配置
进入3588-android12目录
输入如下命令配置java环境：
source javaenv.sh
输入如下命令配置编译环境：
source build/envsetup.sh
输入如下命令配置平台环境：
lunch myzr_rk3588-userdebug
整体编译
整体编译将整个android系统，包括kernel、uboot、android、recovery。
输入如下命令：
./build.sh -AUCKu
编译时间较长，本人使用16线程主机编译需要4个小时时间（仅作参考！）
成功编译后在rockdev/Image-myzr_rk3588/目录下可看到相关镜像，其中update.img是所有镜像的集合。
单独编译 uboot
编译前可先清除生成文件
cd u-boot/
make clean
回到SDK主目录，并进行uboot单独编译
cd ../
./build.sh -U
单独编译 Kernel
编译前可先清除生成文件
cd kernel/
make clean
回到SDK主目录，并进行kernel单独编译
cd ../
./build.sh -CKA
单独编译 android
在SDK主目录下
./build.sh -A
打包update.img
在rockdev将镜像打包成update.img
在SDK主目录下
./build.sh -u
开发指导
U-Boot 板级文件
u-boot 板级文件位置：board/myzr/myzr_rk3588
u-boot 板级配置文件：include/configs/myzr_rk3588.h
u-boot 极级编译配置文件：configs/myzr_rk3588_defconfig
Linux 内核板级文件
内核板级编译配置文件：arch/arm64/configs/myzr_linux_defconfig
内核板级设备树文件：arch/arm64/boot/dts/rockchip/myzr-.dts
内核开发参考手册：网盘中《Reference Manual.pdf》
Ethernet
开发板有俩个网口：J13、J14，以J13说明，J14同理
俩个网口都支持连接外网。
dts 配置
1.1 公共的配置
kernel/arch/arm64/boot/dts/rockchip/rk3588.dtsi
gmac0: ethernet@fe1b0000 {
compatible = "rockchip,rk3588-gmac", "snps,dwmac-4.20a";
reg = <0x0 0xfe1b0000 0x0 0x10000>;
interrupts = <GIC_SPI 227 IRQ_TYPE_LEVEL_HIGH>,
<GIC_SPI 226 IRQ_TYPE_LEVEL_HIGH>;
interrupt-names = "macirq", "eth_wake_irq";
rockchip,grf = <&sys_grf>;
rockchip,php_grf = <&php_grf>;
clocks = <&cru CLK_GMAC_125M>, <&cru CLK_GMAC_50M>,
<&cru PCLK_GMAC0>, <&cru ACLK_GMAC0>,
<&cru CLK_GMAC0_PTP_REF>;
clock-names = "stmmaceth", "clk_mac_ref",
"pclk_mac", "aclk_mac",
"ptp_ref";
resets = <&cru SRST_A_GMAC0>;
reset-names = "stmmaceth";
power-domains = <&power RK3588_PD_GMAC>;
snps,mixed-burst;
snps,tso;
snps,axi-config = <&gmac0_stmmac_axi_setup>;
snps,mtl-rx-config = <&gmac0_mtl_rx_setup>;
snps,mtl-tx-config = <&gmac0_mtl_tx_setup>;
status = "disabled";
mdio0: mdio {
compatible = "snps,dwmac-mdio";
#address-cells = <0x1>;
#size-cells = <0x0>;
};
1.2 板级的配置
kernel/arch/arm64/boot/dts/rockchip/myzr-rk3588-linux.dts
//有线网卡配置
&gmac0 {
/* Use rgmii-rxid mode to disable rx delay inside Soc */
phy-mode = "rgmii-rxid";
clock_in_out = "output";
snps,reset-active-low;
/* Reset time is 20ms, 100ms for rtl8211f */
snps,reset-delays-us = <0 20000 100000>;
pinctrl-names = "default";
pinctrl-0 = <&gmac0_miim
&gmac0_tx_bus2
&gmac0_rx_bus2
&gmac0_rgmii_clk
&gmac0_rgmii_bus>;
tx_delay = <0x44>;
/* rx_delay = <0x4f>; */
phy-handle = <&rgmii_phy0>;
status = "okay";
};
网口没有自动获取ip
等待或者电脑网络适配器能上网的网口关掉共享给以太网网口并重新开启共享，再重启板子便能自动获取ip。
RTC 使用
简介
MYZR-RK3588-EK360开发板采用HYM8563作为RTC(Real Time Clock)，HYM8563是一款低功耗CMOS实时时钟/日历芯片,它提供一个可编程的时钟输出,一个中断 输出和一个掉电检测器,所有的地址和数据都通过I2C总线接口串行传递。最大总线速度为 400Kbits/s,每次读写数据后,内嵌的字地址寄存器会自动递增
可计时基于 32.768kHz 晶体的秒,分,小时,星期,天,月和年
宽工作电压范围:1.0~5.5V
低休眠电流:典型值为 0.25μA(VDD =3.0V, TA =25°C)
内部集成振荡电容
漏极开路中断引脚
RTC驱动
驱动参考：kernel/drivers/rtc/rtc-hym8563.c
接口使用
Linux 提供了三种用户空间调用接口。在 MYZR-RK3588-EK360开发板中对应的路径为：
SYSFS接口：/sys/class/rtc/rtc0/
PROCFS接口： /proc/driver/rtc
IOCTL接口： /dev/rtc0
SYSFS接口
可以直接使用 cat 和 echo 操作 /sys/class/rtc/rtc0/ 下面的接口。
比如查看当前 RTC 的日期和时间：
root@root:/# date -s "2025-05-7 10:00:00"
Wed May 7 10:00:00 UTC 2025
root@root:/# cat /sys/class/rtc/rtc0/time
10:00:24
PROCFS 接口
打印 RTC 相关的信息：
root@root:/# cat /proc/driver/rtc
rtc_time : 10:03:19
rtc_date : 2025-05-07
alrm_time : 10:04:00
alrm_date : 2025-05-07
alarm_IRQ : no
alrm_pending : no
update IRQ enabled : no
periodic IRQ enabled : no
periodic IRQ frequency : 1
max user IRQ frequency : 64
24hr : yes
IOCTL接口
可以使用 ioctl 控制 /dev/rtc0。
详细使用说明请参考文档 kernel/Documentation/admin-guide/rtc.rst 。
FAQs
Q1: 开发板上电后时间不同步？
A1: 检查一下 RTC 电池是否正确接入。
GPIO
简介
GPIO，全称 General-Purpose Input/Output（通用输入输出），是一种软件运行期间能够动态配置和控制的通用引脚。 所有的 GPIO 在上电后的初始状态都是输入模式，可以通过软件设为上拉或下拉，也可以设置为中断脚，驱动强度都是可编程的，其核心是填充 GPIO bank 的方法和参数，并调用 gpiochip_add 注册到内核中。
GPIO引脚计算
RK3588 有 6 组 GPIO bank：GPIO0~GPIO5，每组又以 A0~A7, B0~B7, C0~C7, D0~D7 作为编号区分，常用以下公式计算引脚：
GPIO pin脚计算公式：pin = bank * 32 + number
GPIO 小组编号计算公式：number = group * 8 + X
下面演示GPIO2_C4 pin脚计算方法：
bank = 2; //GPIO2_C4 => 2, bank ∈ [0,5]
group = 2; //GPIO2_C4 => 2, group ∈ {(A=0), (B=1), (C=2), (D=3)}
X = 0; //GPIO2_C4 => 4, X ∈ [0,7]
number = group * 8 + X = 2 * 8 + 4 = 20
pin = bank*32 + number= 2 * 32 + 20 = 56;
GPIO2_C4 对应的设备树属性描述为:<&gpio2 20 GPIO_ACTIVE_HIGH>,由kerne/include/dt-bindings/pinctrl/rockchip.h的宏定义可知，也可以将GPIO2_C4描述为<&gpio2 RK_PC4 GPIO_ACTIVE_HIGH>。
#define RK_PA0 0
#define RK_PA1 1
#define RK_PA2 2
#define RK_PA3 3
#define RK_PA4 4
#define RK_PA5 5
#define RK_PA6 6
#define RK_PA7 7
#define RK_PB0 8
...
当GPIO2_C4脚没有被其它外设复用时, 我们可以通过export导出该引脚去使用
中断
interrupt-parent = <&gpio0>;
interrupts = <RK_PB0 IRQ_TYPE_LEVEL_LOW>;
IRQ_TYPE_LEVEL_LOW 表示中断由低电平触发，当该引脚接收到低电平信号时可以触发中断函数。 这里还可以配置成如下：
IRQ_TYPE_NONE //默认值，无定义中断触发类型
IRQ_TYPE_EDGE_RISING //上升沿触发
IRQ_TYPE_EDGE_FALLING //下降沿触发
IRQ_TYPE_EDGE_BOTH //上升沿和下降沿都触发
IRQ_TYPE_LEVEL_HIGH //高电平触发
IRQ_TYPE_LEVEL_LOW //低电平触发
复用
该案例仅供参考，最终以实际硬件接口为准
GPIO 口除了通用输入输出、中断功能外，还可能有其它复用功能，以GPIO2_C4为例，就有如下几个功能：
若要改变gpio的复用，可以通过rk3588-linuxkernelarcharm64bootdtsrockchiprk3588-vccio3-pinctrl.dtsi
输入4 RK_PA3去查找节点，引用并配置
/omit-if-no-ref/
uart0m2_xfer: uart0m2-xfer {
rockchip,pins =
/* uart0_rx_m2 */
<4 RK_PA4 10 &pcfg_pull_up>,
/* uart0_tx_m2 */
<4 RK_PA3 10 &pcfg_pull_up>;
};
//485
&uart0 {
status = "okay";
pinctrl-names = "default";
pinctrl-0 = <&uart0m2_xfer>;
};
GPIO 调试接口
Debugfs 文件系统目的是为开发人员提供更多内核数据，方便调试。 这里 GPIO 的调试也可以用 Debugfs 文件系统，获得更多的内核信息。GPIO 在 Debugfs 文件系统中的接口为 /sys/kernel/debug/gpio，可以这样读取该接口的信息：
root@topeet:/# cat sys/kernel/debug/gpio
gpiochip0: GPIOs 0-31, parent: platform/fd8a0000.gpio, gpio0:
gpio-15 ( |vcc-3v3-sd-s0-regula) out lo
gpiochip1: GPIOs 32-63, parent: platform/fec20000.gpio, gpio1:
gpio-43 ( |vcc3v3-lcd0-n ) out hi
gpio-52 ( |hp-det ) in hi ACTIVE LOW
gpio-61 ( |hdmirx-det ) in hi ACTIVE LOW
gpiochip2: GPIOs 64-95, parent: platform/fec30000.gpio, gpio2:
...
485
DTS配置
文件路径kernel/arch/arm64/boot/dts/rockchip/myzr-rk3588-linux.dts
//485
&uart0 {
status = "okay";
pinctrl-names = "default";
pinctrl-0 = <&uart0m2_xfer>;
};
配置好串口后，硬件接口对应软件上的节点为：
UART0: /dev/ttyS0
CAN
CAN 简介
CAN(Controller Area Network)总线，即控制器局域网总线，是一种有效支持分布式控制或实时控制的串行通信网络。CAN总线是一种在汽车上广泛采用的总线协议，被设计作为汽车环境中的微控制器通讯。 如果想了解更多的内容可以参考CAN应用报告
DTS 节点配置
公共配置 kernel/arch/arm64/boot/dts/rockchip/rk3588s.dtsi
can1: can@fea60000 {
compatible = "rockchip,can-2.0";
reg = <0x0 0xfea60000 0x0 0x1000>;
interrupts = <GIC_SPI 342 IRQ_TYPE_LEVEL_HIGH>;
clocks = <&cru CLK_CAN1>, <&cru PCLK_CAN1>;
clock-names = "baudclk", "apb_pclk";
resets = <&cru SRST_CAN1>, <&cru SRST_P_CAN1>;
reset-names = "can", "can-apb";
pinctrl-names = "default";
pinctrl-0 = <&can1m0_pins>;
tx-fifo-depth = <1>;
rx-fifo-depth = <6>;
status = "disabled";
};
板级配置 arch/arm64/boot/dts/rockchip/myzr-rk3588-linux.dts
//can
&can1 {
status = "okay";
compatible = "rockchip,can-2.0"; //使用can
pinctrl-0 = <&can1m1_pins>;
assigned-clocks = <&cru CLK_CAN1>;
assigned-clock-rates = <100000000>;
};
更多指令
1、 ip link set canX down //关闭can设备；
2、 ip link set canX up //开启can设备；
3、 ip -details link show canX //显示can设备详细信息；
4、 candump canX //接收can总线发来数据；
5、 ifconfig canX down //关闭can设备，以便配置;
6、 ip link set canX up type can bitrate 250000 //设置can波特率
7、 conconfig canX bitrate + 波特率；
8、 canconfig canX start //启动can设备；
9、 canconfig canX ctrlmode loopback on //回环测试；
10、canconfig canX restart // 重启can设备；
11、canconfig canX stop //停止can设备；
12、canecho canX //查看can设备总线状态；
13、cansend canX --identifier=ID+数据 //发送数据；
14、candump canX --filter=ID：mask //使用滤波器接收ID匹配的数据
报文发送后很久才接收到，或者接收不到。
检查总线 CAN_H 和 CAN_L， 杜邦线是否松动或者接反。
HDMI
HDMI接口的配置
硬件上有两个 HDMI 显示输出接口。
打开HDMI接口如下所示：
/rk3588-linux/kernel/arch/arm64/boot/dts/rockchip/myzr-screen-lcds.dts
//#define LCD_TYPE_MIPI0 //VP2
//#define LCD_TYPE_LVDS_10_1_1280x800_GT911 //VP2
//#define LCD_TYPE_LVDS_10_1_1280x800_GT9271 //VP2
//#define LCD_TYPE_LVDS_10_1_1024x600_GT911 //VP2
//#define LCD_TYPE_LVDS_7_0 //VP2
#define LCD_TYPE_HDMI1 //VP1
#define LCD_TYPE_HDMI0 //VP0
//#define LCD_TYPE_TYPEC_DP //VP1
//#define LCD_TYPE_MIPI1 //VP3
如果将两个 HDMI 接口同时接上屏幕，默认会双屏同显。
1.1. 软件配置
#if defined(LCD_TYPE_HDMI0)
//打开 hdmi0 的 硬件 phy
&hdptxphy_hdmi0 {
status = "okay";
};
//使能HDMI0
&hdmi0 {
enable-gpios = <&gpio4 RK_PB1 GPIO_ACTIVE_HIGH>;
status = "okay";
};
//配置HDMI0到VP0上面
&hdmi0_in_vp0 {
status = "okay";
};
//打开HDMI0 声音
&hdmi0_sound {
status = "okay";
};
//配置HDMI0上面显示开机logo
&route_hdmi0 {
status = "okay";
};
#endif
#if defined(LCD_TYPE_HDMI1)
//使能HDMI1
&hdptxphy_hdmi1 {
status = "okay";
};
&hdmi1 {
enable-gpios = <&gpio4 RK_PA2 GPIO_ACTIVE_HIGH>;
status = "okay";
};
//配置HDMI1到VP1上面
&hdmi1_in_vp1 {
status = "okay";
};
//打开HDMI1 声音
&hdmi1_sound {
status = "okay";
};
//配置HDMI1上面显示开机logo
&route_hdmi1 {
status = "okay";
};
#endif
Watchdog
简介
看门狗（watchdog）实际是一个定时器，启动之后会开始计时。系统或者软件需要在规定时间内与看门狗通信（俗称喂狗）重置计时，如此反复下去，以此来确定系统和软件正常运行。
如果规定时间内没有喂狗，看门狗超时，说明系统或应用陷入循环、卡死，此时看门狗会发出复位信号让主控复位，脱离卡死。
DTS配置
MYZR-RK3588-EK360的 watchdog 的 DTS 节点在 kernel/arch/arm64/boot/dts/rockchip/rk3588s.dtsi 文件中定义，如下所示：
wdt: watchdog@feaf0000 {
compatible = "snps,dw-wdt";
reg = <0x0 0xfeaf0000 0x0 0x100>;
clocks = <&cru TCLK_WDT0>, <&cru PCLK_WDT0>;
clock-names = "tclk", "pclk";
interrupts = <GIC_SPI 315 IRQ_TYPE_LEVEL_HIGH>;
status = "okay";
};
watchdog 的驱动文件为 kernel/drivers/watchdog/dw_wdt.c。