产品简介

发货清单

详细参数

硬件连接

注意： 如使用其它串口适配器遇到 TX 和 RX 不能输入和输出的问题，可以尝试对调 TX 和 RX 的连接。

使用说明

1.5.1. Normal 模式

Normal 模式就是正常的启动过程，各个组件依次加载，正常进入系统。

1.5.2. Loader 模式

在 Loader 模式下，bootloader 会进入升级状态，等待主机命令，用于固件升级等。

1.5.3. MaskRom 模式

MaskRom 模式用于 bootloader 损坏时的系统修复。

一般情况下是不用进入 MaskRom 模式的，只有在 bootloader 校验失败（读取不了 IDB 块，或 bootloader 损坏） 的情况下，BootRom 代码 就会进入 MaskRom 模式。此时 BootRom 代码等待主机通过 USB 接口传送 bootloader 代码，加载并运行之。

要强行进入 MaskRom 模式，请参阅《MaskRom模式》一章。

通过统一固件解包/打包工具，可以把统一固件解包为多个分区镜像，也可以将多个分区镜像合并为一个统一固件。

2.4.1. Windows操作系统

• 安装RK USB驱动

下载 Release_DriverAssistant.zip，解压，然后运行里面的 DriverInstall.exe 。为了所有设备都使用更新的驱动，请先选择驱动卸载，然后再选择驱动安装。

• 运行AndroidTool的RKDevTool.exe

2.4.2. Linux操作系统

Linux 下无须安装设备驱动

• Linux_Upgrade_Tool工具

下载 Linux_Upgrade_Tool, 并按以下方法安装到系统中，方便调用：

• Linux_adb_fastboot工具

下载 Linux_adb_fastboot, 并按以下方法安装到系统中，方便调用：

2.5.1. Loader模式

2.5.2. MaskRom模式

进入MaskRom模式的方法，请参考《MaskRom模式》

2.6.1. windows操作系统

2.6.2. Linux操作系统

2.7.1. 1. 如何强行进入 MaskRom 模式

如果板子进入不了 Loader 模式，此时可以尝试强行进入 MaskRom 模式。操作方法见《MaskRom模式》。

2.7.2. 2. 烧写失败分析

如果烧写过程中出现Download Boot Fail, 或者烧写过程中出错，如下图所示，通常是由于使用的USB线连接不良、劣质线材，或者电脑USB口驱动能力不足导致的，请更换USB线或者电脑USB端口排查。 

1.1.1. 校验与解压

下载完成后先验证一下 MD5 码：

1.2.1. 目录介绍

1.2.2. 配置文件介绍

在 device/rockchip/rk3588/ 目录下，有不同板型的配置文件(xxxx_defconfig)，用于管理 SDK 每个环节的编译配置。

配置文件命名规则：

1.2.3. 分区说明

parameter 文件中包含了固件的分区信息，比如 device/rockchip/rk3588/parameter-xxxxxx-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
GROW_ALIGN: 0
CMDLINE: mtdparts=:0x00002000@0x00004000(uboot),0x00002000@0x00006000(misc),0x00040000@0x00008000(boot:bootable),0x00040000@0x00048000(recovery),0x00010000@0x00088000(backup),0x01c00000@0x00098000(rootfs),-@0x01c98000(userdata:grow)
uuid:rootfs=614e0000-0000-4b53-8000-1d28000054a9
uuid:boot=7A3F0000-0000-446A-8000-702F00006273

CMDLINE 属性是我们关注的地方，以 uboot 为例， 0x00002000@0x00004000(uboot) 中 0x00004000 为 uboot 分区的起始位置，0x00002000 为分区的大小，以此类推。分区的起始位置 分区大小 = 下一个分区的起始位置。

parameter 中数字的单位是 “块”，每块 512 字节。所以 uboot 分区大小为 0x00002000，即 8192 块，共 8192 x 512 / 1024 / 1024 = 4 MiB

1.3.1. 准备工作

执行下面两条命令来安装需要的工具

下载根文件系统：Ubuntu 根文件系统(64位) Kernel6.1，请使用网盘中 kernel-6.1 目录下的文件系统。

下载后将文件系统解压到 SDK/prebuilt_rootfs/ 下，并创建链接

1.3.2. 编译前配置

执行 ./build.sh lunch 列出所有可用的配置文件，输入编号选择对应的配置文件，注意要选择带有 ubuntu 字样的配置文件：

1.3.3. 编译

1.4.1. 准备工作

执行下面两条命令来安装需要的工具

下载根文件系统：Debian 根文件系统(64位)，请使用网盘中 kernel-6.1 目录下的文件系统。

下载后将文件系统解压到 SDK/prebuilt_rootfs/ 下，并创建链接

1.4.2. 编译前配置

执行 ./build.sh lunch 列出所有可用的配置文件，输入编号选择对应的配置文件，注意要选择带有 debian 字样的配置文件：

1.4.3. 编译

1.5.1. 准备工作

执行下面两条命令来安装需要的工具

1.5.2. 编译前配置

执行 ./build.sh lunch 列出所有可用的配置文件，输入编号选择对应的配置文件，注意要选择带有 buildroot 字样的配置文件：

1.5.3. 编译

2.1.1. 安装工具

获取 SDK 需要先安装：

2.1.2. 初始化仓库

• 方法一（推荐国内用户使用）

SDK 源码存放于 gitlab，国内用户可能下载完整的 SDK 仓库速度比较慢，所以我们提供了一个 SDK 基础包(Linux SDK)，国内用户只需要在此基础包上同步 gitlab 上的代码就可以了

下载完成后先验证一下 MD5 码：

• 方法二

通过 repo 拉取代码，此方法对网络要求较高，有条件可以使用

可选择获取完整 SDK 或者 BSP：

mkdir ~/proj/rk3588_sdk/
cd ~/proj/rk3588_sdk/

## 完整 SDK
repo init --no-clone-bundle --repo-url https://gitlab.com/firefly-linux/git-repo.git -u https://gitlab.com/firefly-linux/manifests.git -b master -m rk3588_linux_release.xml

## BSP （ 只包含基础仓库和编译工具 ）
## BSP 包括 device/rockchip 、docs 、 kernel 、 u-boot 、 rkbin 、 tools 和交叉编译链
repo init --no-clone-bundle --repo-url https://gitlab.com/firefly-linux/git-repo.git -u https://gitlab.com/firefly-linux/manifests.git -b master -m rk3588_linux_bsp_release.xml

2.1.3. 同步代码

执行如下命令同步代码：

因为网络环境等原因，.repo/repo/repo sync -c --no-tags 命令更新代码可能会失败，可多次反复执行。

2.2.1. 目录介绍

2.2.2. 配置文件介绍

在 device/rockchip/rk3588/ 目录下，有不同板型的配置文件(xxxx.mk)，用于管理 SDK 每个环节的编译配置，相关配置介绍：

2.2.3. 分区说明

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:0x00002000@0x00004000(uboot),0x00002000@0x00006000(misc),0x00020000@0x00008000(boot:bootable),0x00040000@0x00028000(recovery),0x00010000@0x00068000(backup),0x00c00000@0x00078000(rootfs),0x00040000@0x00c78000(oem),-@0x00cb8000(userdata:grow)
uuid:rootfs=614e0000-0000-4b53-8000-1d28000054a9

2.3.2. 编译 SDK

2.4.1. 获取SDK

repo init --no-clone-bundle --repo-url https://gitlab.com/firefly-linux/git-repo.git -u https://gitlab.com/firefly-linux/manifests.git -b master -m rk3588_yocto_kirkstone_release.xml
.repo/repo/repo sync -c

2.4.2. 编译

2.4.3. 编译映像文件

使用 bitbake 命令构建的过程需要保证网络连接正常，如果是中国内陆客户需要保证能 ping 通外网

进入目录 ，按顺序执行如下命令

以下是基于 wayland 的 core-image 。需要在 /path/to/yocto/meta-rockchip/conf/machine/include/display.conf 修改 DISPLAY_PLATFORM 为 wayland 。修改如下：

如果想单独编译部分 recipes 可以参考以下内容：

2.4.4. 调整编译速度

修改文件/path/to/yocto/meta-rockchip/conf/machine/firefly-rk3588.conf 中的 BB_NUMBER_THREADS 和 PARALLEL_MAKE 变量配置。若线程数量设置过大可能会导致机器内存不足，导致编译失败。请根据编译机器的配置来设置编译速度。

• BB_NUMBER_THREADS: The maximum number of threads BitBake simultaneously executes.

• BB_NUMBER_PARSE_THREADS: The number of threads BitBake uses during parsing.

• PARALLEL_MAKE: Extra options passed to the make command during the do_compile task in order to specify parallel compilation on the local build host.

• PARALLEL_MAKEINST: Extra options passed to the make command during the do_install task in order to specify parallel installation on the local build host.

2.4.5. 更多 bitbake 选项

从根本上说，BitBake 是一个通用任务执行引擎，它允许 shell 和 Python 任务高效并行运行，同时在复杂的任务间依赖约束下工作。 BitBake 的主要用户之一，OpenEmbedded，利用这个核心并使用面向任务的方法构建嵌入式 Linux 软件堆栈。更多详细使用方法请查看《bitbake-user-manual》。

2.4.6. 分区固件烧写

编译生成的固件位于目录/build/tmp/deploy/images/board/

• 分区烧写适用于调试阶段，固件验证请使用下文的统一固件烧写

• rootfs 不支持单独烧写，需要打包完整固件再烧写

2.4.7. 统一固件烧写

编译生成的固件位于目录/build/tmp/deploy/images/board/，待下载的文件为.wic与update.img，进入loader模式后执行如下命令：

• 固件默认登录账号为：root，密码为：firefly 。固件含有普通用户账号名称为：firefly ，密码为：firefly 。

注意：如果客户在 Windows PC 上开发，使用 RKdevtool 直接烧录 update.img 即可，不需要烧录 IMAGE NAME.wic。但是要注意一点是 update.img 是一个链接文件，实际得选择链接文件所指向的实际文件。

2.4.8. 相关概述

Yocto Project 是一个专注于嵌入式 Linux® 操作系统开发的开源协作项目，它提供灵活的工具集和开发环境，允许全球的嵌入式设备开发人员通过共享技术，软件堆栈，配置和用于创建这些定制的Linux映像的最佳实践进行协作。有关 Yocto 项目的更多信息，请参阅 Yocto Project 官网：www.yoctoproject.org/。 Yocto Project 官网上有 Yocto Project Reference Manual 和 Yocto Project Overview 等相关文档详细描述了如何构建系统。

2.4.9. Yocto Project Release layer 介绍

2.5.2. 编译 SDK

2.5.2.2. 编译

2.5.2.2.1. 全自动编译

• 下载根文件系统：Debian 根文件系统(64位)，放到 SDK 路径下

2.5.2.2.2. 部分编译

• 编译 u-boot

• 下载根文件系统：Debian 根文件系统(64位)，放到 SDK 路径下

2.6.2. 编译 SDK

4.1.1. 介绍

FastDeploy 是一款全场景、易用灵活、极致高效的 AI 推理部署工具。提供开箱即用的云边端部署体验, 支持超过 150 Text, Vision, Speech和跨模态模型，并实现端到端的推理性能优化。包括图像分类、物体检测、图像分割、人脸检测、人脸识别、关键点检测、抠图、OCR、NLP、TTS等任务，满足开发者多场景、多硬件、多平台的产业部署需求。

目前 FastDeploy 初步支持 rknpu2，可以在 RK3588 平台上推理部分模型，其他模型还在适配中，具体支持列表和进度请前往：github

4.1.2. RK3588 端

4.1.3. PC 端

上一章节在 RK3588 上进行部署的只是运行环境，demo 是提前在 PC 端转换与调整好的。也就是说进一步的开发例如模型转换、参数调整等，是需要在 PC 端进行，所以还需要在 x86_64 Linux PC 上安装 FastDeploy。

4.2.1. 使用方法

说明：

1. 固件使用的宿主系统是 Ubuntu Minimal 版本，使用 debug 串口、ssh、adb shell 等方式进行交互，没有桌面显示。

2. 安卓的交互是通过网络 adb 连接并配合 scrcpy 等投屏工具实现，不是接入鼠标键盘来操作。

3. 操作 AIC 需要知道基础的 Linux 终端操作知识、docker 容器知识、adb 使用方法。

4.2.2. 性能展示

以 root 身份执行以下命令开启性能模式可以获得更好的体验：

单个 RK3588 使用 AIC 同时运行两个最高画质原神可达 35 帧以上: 

1.6.1. 连接管理

列出所有连接设备及其序列号：

1.7.1. 获取系统日志 adb logcat

• 用法

1.7.2. 运行命令 adb shell

1.7.3. root 权限

如果 TARGET_BUILD_VARIANT 使用的是 userdebug 模式，要获得 root 权限，需要先运行：

让 ADB 的设备端切换到 root 权限模式，这样 adb remount 等需要 root 权限的命令才会成功。

1.8.1. 安装应用 adb install

• 用法：

如果安装成功，工具会返回成功提示 Success；失败的话，一般是以下几种情况:

• INSTALL_FAILED_ALREADY_EXISTS: 此时需要用 -r 参数来重新安装。

• INSTALL_FAILED_SIGNATURE_ERROR: 应用的签名不一致，可能是发布版和调试版签名不同所致。如果确认 APK 文件签名正常，可以用 adb uninstall 命令先卸载旧的应用，然后再安装。

• INSTALL_FAILED_INSUFFICIENT_STORAGE: 存储空间不足，需要检查设备存储情况。

1.8.2. 卸载应用 adb uninstall

• 用法：

前面是 apk 文件，后面则是对应的包名称。

1.8.3. 命令行帮助信息 adb help

此时视报错信息去安装缺少的软件包（dtc）即可

3.1.1. 下载 SDK

• SDK通过邮件的方式获取，把订单号发送到sales@t-firefly.com邮箱并注明需要的SDK名称firefly_rk3588_android12_git_20240704

• 下载完成后，在解压前先校验下 MD5 码：

• 然后解压：

注意：不要在共享文件夹、挂载文件夹以及非英文目录解压SDK，避免产生不必要的错误

3.1.2. 更新 SDK

下载 SDK 后，从 gitlab 处更新代码的方法：

下载页面选择云盘下载 Android12.0 Bundle。

3.2.1. 整体编译

3.2.2. 分步编译

• 编译 kernel：

3.2.3. 打包成统一固件 update.img

编译完可以用Firefly官方的脚本打包成统一固件，执行如下命令：

打包完成后将在rockdev/Image-aio_3588l/ 目录下生成统一固件： product名XXX_XXX_日期XXX.img

在 Windows 下打包统一固件 update.img 也很简单，将编译生成的文件拷贝到 AndroidTool 的 rockdevImage 目录中，然后运行 rockdev 目录下的 mkupdate.bat 批处理文件即可创建 update.img 并存放到 rockdevImage 目录里。

3.3.1. Android12.0 不能直接烧写 kernel.img 和 resource.img

Android12.0的kernel.img和resource.img包含在boot.img中，编译kernel后需要在android根目录下执行./mkimage.sh重新打包boot.img,然后烧写rockdev/Image-aio_3588l/目录下的boot.img。

3.3.2. 单独编译kernel生成boot.img

编译的原理：在kernel目录下将编译生成的 kernel.img 和 resource.img 替换到旧的 boot.img 中， 所以编译的时候需要用 BOOT_IMG=xxx 参数指定boot.img的路径，命令如下：

编译后可以直接烧写kernel目录下的boot.img。

3.6.1. git clone 远程 bundle 仓库失败

Q：更新SDK时，git clone 远程 bundle 仓库出错：

4.1.1. 下载 SDK

• SDK通过邮件的方式获取，把订单号发送到sales@t-firefly.com邮箱并注明需要的SDK名称firefly_rk3588_android14_git_20240822

• 下载完成后，在解压前先校验下 MD5 码：

• 然后解压：

注意：不要在共享文件夹、挂载文件夹以及非英文目录解压SDK，避免产生不必要的错误

4.1.2. 更新 SDK

下载 SDK 后，从 gitlab 处更新代码的方法：

下载页面选择云盘下载 Android14.0 Bundle。

4.2.1. 整体编译

4.2.1.1. HDMI 固件编译

4.2.2. 分步编译

• 编译 kernel：

4.2.3. 打包成统一固件 update.img

编译完可以用Firefly官方的脚本打包成统一固件，执行如下命令：

打包完成后将在rockdev/Image-aio_3588l/ 目录下生成统一固件： product名XXX_XXX_日期XXX.img

在 Windows 下打包统一固件 update.img 也很简单，将编译生成的文件拷贝到 AndroidTool 的 rockdevImage 目录中，然后运行 rockdev 目录下的 mkupdate.bat 批处理文件即可创建 update.img 并存放到 rockdevImage 目录里。

4.3.1. Android14.0 不能直接烧写 kernel.img 和 resource.img

Android14.0的kernel.img和resource.img包含在boot.img中，编译kernel后需要在android根目录下执行./mkimage.sh重新打包boot.img,然后烧写rockdev/Image-aio_3588l/目录下的boot.img。

4.3.2. 单独编译kernel生成boot.img

编译的原理：在kernel目录下将编译生成的 kernel.img 和 resource.img 替换到旧的 boot.img 中， 所以编译的时候需要用 BOOT_IMG=xxx 参数指定boot.img的路径，命令如下：

编译后可以直接烧写kernel目录下的boot.img。

4.6.1. git clone 远程 bundle 仓库失败

Q：更新SDK时，git clone 远程 bundle 仓库出错：

3.1.1. HDMI

AIO-3588L 硬件上有两个 HDMI 显示输出接口：

• HDMI0 支持 HDMI2.1 协议，分辨率最高可以支持 7680x4320@60Hz

• HDMI1 支持 HDMI2.0 协议，分辨率最高可以支持 4096x2304@60Hz

3.1.2. Display Port

AIO-3588L 有一个 Display Port 显示输出接口，支持 DP TX 1.4a 协议，分辨率最高可以支持 7680x4320@30Hz。

3.1.3. MIPI DSI

AIO-3588L 有两路 MIPI DSI 显示输出接口，均支持 DPHY2.0 和 4 Lane 的数据输出，最高可输出 4096x2304@60Hz（取决于连接的 Portx）。

4.1.1. 公共的配置

kernel-5.10/arch/arm64/boot/dts/rockchip/rk3588-diff.dtsi

kernel-5.10/arch/arm64/boot/dts/rockchip/rk3588-firefly-port.dtsi

4.1.2. 板级的配置

kernel-5.10/arch/arm64/boot/dts/rockchip/aio-3588l.dtsi

4.1.3. 查看IP地址

• 双以太网口接入网络，可以通过调试串口或者adb来查看IP地址，比如

4.1.4. 连通性测试

5.6.1. GPIO 调试接口

Debugfs 文件系统目的是为开发人员提供更多内核数据，方便调试。 这里 GPIO 的调试也可以用 Debugfs 文件系统，获得更多的内核信息。GPIO 在 Debugfs 文件系统中的接口为 /sys/kernel/debug/gpio，可以这样读取该接口的信息：

从读取到的信息中可以知道，内核把 GPIO 当前的状态都列出来了，以 GPIO1 组为例，gpio-56(GPIO1_D0) 输出高电平 (out hi)。

5.6.2. 查看 pinmux-pins

使用命令

解析： pin 0这一列表示引脚编号，gpio0-0这一列表示gpio组编号，后面MUX UNCLAIMED这一列表示数据选择器的拥有者，GPIO UNCLAIMED这一列表示gpio的拥有者。

其中 MUX UNCLAIMED 表示该引脚还没有被节点使用pinctrl去进行控制，例如：节点 i2c7 被启用，它拥有pinctrl-0属性，对引脚pin 56功能作出出修改，复用为i2c ，则该引脚的信息会变为pin 56 (gpio1-24): fec90000.i2c (GPIO UNCLAIMED) function i2c7 group i2c7m0-xfer ，它被地址为0xfec90000、名字为i2c的节点使用pinctrl配置，pinctrl的值是i2cm0-xfer。

GPIO UNCLAIMED表示还没有注册的gpio使用该引脚，我们用上述gpio_demo例子去注册该引脚，引脚信息会变成pin 56 (gpio1-24): gpio_demo gpio1:56 function gpio group pin56_57_gpio ，它被名为gpio_demo的节点使用pinctrl配置，pinctrl的值是pin56_57_gpio，该引脚还被申请为gpio。

5.7.1. Q1: 如何将 PIN 的 MUX 值切换为一般的 GPIO？

A1: 当使用 GPIO request 时候，会将该 PIN 的 MUX 值强制切换为 GPIO，所以使用该 PIN 脚为 GPIO 功能的时候确保该 PIN 脚没有被其他模块所使用。

5.7.2. Q2: 为什么我用 IO 指令读出来的值都是 0x00000000？

A2: 如果用 IO 命令读某个 GPIO 的寄存器，读出来的值异常,如 0x00000000 或 0xffffffff 等，请确认该 GPIO 的 CLK 是不是被关了，GPIO 的 CLK 是由 CRU 控制，可以通过读取 datasheet 下面 CRU_CLKGATE_CON* 寄存器来查到 CLK 是否开启，如果没有开启可以用 io 命令设置对应的寄存器，从而打开对应的 CLK，打开 CLK 之后应该就可以读到正确的寄存器值了。

5.7.3. Q3: 测量到 PIN 脚的电压不对应该怎么查？

A3: 测量该 PIN 脚的电压不对时，如果排除了外部因素，可以确认下该 PIN 所在的 IO 电压源是否正确，以及 IO-Domain 配置是否正确。

5.7.4. Q4: gpio_set_value() 与 gpio_direction_output() 有什么区别？

A4: 如果使用该 GPIO 时，不会动态的切换输入输出，建议在开始时就设置好 GPIO 输出方向，后面拉高拉低时使用 gpio_set_value() 接口，而不建议使用 gpio_direction_output(), 因为 gpio_direction_output 接口里面有 mutex 锁，对中断上下文调用会有错误异常，且相比 gpio_set_value，gpio_direction_output 所做事情更多，浪费。

6.3.1. 视频调试

HDMI-IN 设备在内核中会被注册为 video 设备，生成的节点如：/dev/video8，可以通过 v4l2-ctl 命令来获取设备信息和抓帧。

• 获取设备信息

• 获取外部设备输入的分辨率信息

• 抓取帧率（需要设置好分辨率和像素格式）

• 把抓取到的帧保存为文件,这里表示抓一帧并保存在 data/4kp60_nv12.yuv

  :/ # v4l2-ctl  -d /dev/video8 --set-fmt-video=width=3840,height=2160,pixelformat='NV12' --stream-mmap=4  --stream-skip=10  --stream-to=/data/4kp60_nv12.yuv --stream-count=1 --stream-poll
  <<<<<<<<<<<
  

• 在 PC 端查看抓取到的帧文件

  • Window 端可以使用 7yuv 工具

  • Linux 端可以使用 ffplay 命令

6.3.2. 音频调试

可以通过 tinycap 命令去录制输入的音频。

可以看到，hdminrx（hdmiin）的声卡号为2，可以在 HDMI-IN 有音频输入的时候运行以下命令来录制和播放音频。

7.3.1. Simple trigger LED

按名字来是看就是简单的触发方式控制 LED，如下就默认打开黄灯，AIO-3588L开机后黄灯就亮。

（1）定义 LED 触发器在 kernel-5.10/drivers/leds/trigger/led-firefly-demo.c 文件中有如下添加：

7.3.2. Complex trigger LED

如下是 trigger 方式控制 LED 复杂一点的例子，timer trigger 就是让 LED 达到不断亮灭的效果：

我们需要在内核把 timer trigger 配置上。

在 kernel-5.10 路径下使用 make menuconfig，按照如下方法将 timer trigger 驱动选中。

9.2.1. 配置 PWM DTS节点

在 DTS 源文件 kernel-5.10/arch/arm64/boot/dts/rockchip/rk3588-firefly-demo.dtsi 添加 PWM DTS 配置，如下所示：

pwms参数分析： &pwm15: 在 rk3588s.dtsi 中有定义。 0 ：表示 chip index ,一般是0,因为rockchip pwm每个chip只有一个。 100000000 ： 一个周期时间为100000000纳秒 ，一秒有10个100000000纳秒 ，所以这个pwm输出周期为10Hz。 1: 表示极性， 0为正常极性，1为反转极性。

duty_ns表示占空比激活时间，单位也是纳秒

9.5.1. PWM 无法注册成功：

• dts 配置文件是否打开对应的 PWM。

• PWM 所在的 IO 口是否被其他资源占用，可以根据报错的返回值去查看原因。

10.3.1. SYSFS接口

可以直接使用 cat 和 echo 操作 /sys/class/rtc/rtc0/ 下面的接口。

比如查看当前 RTC 的日期和时间：

10.3.2. PROCFS 接口

打印 RTC 相关的信息：

10.3.3. IOCTL接口

可以使用 ioctl 控制 /dev/rtc0。

详细使用说明请参考文档 kernel-5.10/Documentation/admin-guide/rtc.rst 。

10.4.1. Q1: 开发板上电后时间不同步？

A1: 检查一下 RTC 电池是否正确接入。

11.2.1. 方式一：系统设置修改

Settings->Connected devices -> M.2 SSD Type

选择需要生效的选项SATA 或 PCIe

修改后需要重启系统才会生效

11.2.2. 方式二：DTS 配置

一般根据原理图在 DTS 中选择正确的控制器节点和 PHY 节点使能，并关闭与其复用的控制器节点就可以。

在 kernel-5.10/arch/arm64/boot/dts/rockchip/aio-3588l.dtsi 中有下面一段配置：

combphy0_ps：PHY 节点

sata0：sata0 控制器节点

pcie2x1l2：pcie2x1l2 控制器节点

M2_SATA_OR_PCIE：默认值为 1 即配置成 SATA3.0，如果需要配置成 PCIe2.0，需修改为 0

11.3.1. 自动挂载

在 Android 系统界面中将硬盘格式化为可用格式就可以开机自动挂载

11.3.2. 命令手动挂载

• 查找设备节点

12.3.1. 硬件连接

AIO-3588L与 XM25QU128C 硬件连接如下表：

12.3.2. 编写Makefile/Kconfig

在 kernel-5.10/drivers/spi/Kconfig 中添加对应的驱动文件配置：

在 kernel-5.10/drivers/spi/Makefile 中添加对应的驱动文件名：

12.3.3. 配置 DTS 节点

在 kernel-5.10/arch/arm64/boot/dts/rockchip/rk3588-firefly-demo.dtsi 中添加 SPI 驱动结点描述，如下所示：

• status:如果要启用 SPI，则设为 okay，如不启用，设为 disable。

• spi-demo@00:由于本例子使用 CS0，故此处设为 00，如果使用 CS1，则设为 01。

• compatible:这里的属性必须与驱动中的结构体：of_device_id 中的成员 compatible 保持一致。

• reg:此处与 spi-demo@00 保持一致，本例设为：0x00。

• spi-max-frequency：此处设置 spi 使用的最高频率，AIO-3588L最高支持 50000000。

• spi-cpha，spi-cpol：SPI 的工作模式在此设置，本例所用的模块 SPI 工作模式为 SPI_MODE_0 或者 SPI_MODE_3，这里我们选用 SPI_MODE_0，如果使用 SPI_MODE_3，spi_demo 中打开 spi-cpha 和 spi-cpol 即可。

12.3.4. 定义SPI驱动

在内核源码目录 kernel-5.10/drivers/spi/ 中创建新的驱动文件，如：spi-firefly-demo.c。

在定义 SPI 驱动之前，用户首先要定义变量 of_device_id 。of_device_id 用于在驱动中调用 DTS 文件中定义的设备信息，其定义如下所示：

此处的 compatible 与 DTS 文件中的保持一致。

spi_driver定义如下所示：

12.3.5. 注册SPI设备

在初始化函数 static int __init firefly_spi_init(void) 中向内核注册 SPI 驱动：spi_register_driver(&firefly_spi_driver);

如果内核启动时匹配成功，则 SPI 核心会配置 SPI 的参数（mode、speed 等），并调用 firefly_spi_probe。

12.3.6. 读写 SPI 数据

• firefly_spi_probe 中使用了两种接口操作读取 XM25QU128C 的 ID:

• firefly_spi_read_xm25x_id_0 接口直接使用了 spi_transfer 和 spi_message 来传送数据。

• firefly_spi_read_xm25x_id_1 接口则使用 SPI 接口 spi_write_then_read 来读写数据。

成功后会打印：

12.3.7. 打开 SPI demo

spi-firefly-demo 默认没有打开，如果需要的话可以使用以下补丁打开 demo 驱动：

12.3.8. 常用 SPI 接口

下面是常用的 SPI API 定义：

12.5.1. Q1: SPI 数据传送异常

A1: 确保 SPI 4 个引脚的 IOMUX 配置正确， 确认 TX 送数据时，TX 引脚有正常的波形，CLK 频率正确，CS 信号有拉低，mode 与设备匹配。

1.1.1. RKLLM-Toolkit 功能介绍

RKLLM-Toolkit 是为用户提供在计算机上进行大语言模型的量化、转换的开发套件。通过该工具提供的 Python 接口可以便捷地完成以下功能：

• 模型转换：支持将 Hugging Face 格式的大语言模型（Large Language Model, LLM）转换为RKLLM 模型，转换后的 RKLLM 模型能够在 Rockchip NPU 平台上加载使用。

• 量化功能：支持将浮点模型量化为定点模型，目前支持的量化类型包括 w4a16 和 w8a8。

1.1.2. RKLLM Runtime 功能介绍

RKLLM Runtime 主 要 负 责 加 载 RKLLM-Toolkit 转换得到的 RKLLM 模型，并在AIO-3588L 板端通过调用 NPU 驱动在 Rockchip NPU 上实现 RKLLM 模型的推理。在推理RKLLM 模型时，用户可以自行定义 RKLLM 模型的推理参数设置，定义不同的文本生成方式，并通过预先定义的回调函数不断获得模型的推理结果。

1.3.1. 大语言模型转换运行Demo

下面以RKLLM SDK的DeepSeek-R1-Distill-Qwen-1.5B_Demo为例演示如何转换、量化、导出大语言模型，最后在板端部署运行。

(RKLLM-Toolkit-1.1.4) root@ea5d57ca8e66:/rkllm/rknn-llm/examples/DeepSeek-R1-Distill-Qwen-1.5B_Demo/export# python3 export_rkllm.py 
INFO: rkllm-toolkit version: 1.1.4
WARNING: Cuda device not available! switch to cpu device!
The argument `trust_remote_code` is to be used with Auto classes. It has no effect here and is ignored.
Downloading data files: 100%|███████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 1/1 [00:00<00:00, 15307.68it/s]
Extracting data files: 100%|█████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 1/1 [00:00<00:00, 2377.72it/s]
Generating train split: 21 examples [00:00, 3327.05 examples/s]
Optimizing model: 100%|██████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 28/28 [21:16<00:00, 45.59s/it]
Building model: 100%|██████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 399/399 [00:07<00:00, 52.78it/s]
WARNING: The bos token has two ids: 151646 and 151643, please ensure that the bos token ids in config.json and tokenizer_config.json are consistent!
INFO: The token_id of bos is set to 151646
INFO: The token_id of eos is set to 151643
INFO: The token_id of pad is set to 151643
Converting model: 100%|███████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 339/339 [00:00<00:00, 2494507.12it/s]
INFO: Exporting the model, please wait ....
[=================================================>] 597/597 (100%)
INFO: Model has been saved to ./DeepSeek-R1-Distill-Qwen-1.5B_W8A8_RK3588.rkllm!

2.3.1. 工具介绍

RKNN-Toolkit2 是为用户提供在 PC、Rockchip NPU 平台上进行模型转换、推理和性能评估的开发套件，用户通过该工具提供的 Python 接口可以便捷地完成各种操作。

工具的全部功能简单介绍如下：

• 模型转换: 支持 Caffe、TensorFlow、TensorFlow Lite、ONNX、DarkNet、PyTorch 等模型转为 RKNN 模型，并支持 RKNN 模型导入导出，RKNN 模型能够在 Rockchip NPU 平台上加载使用
   

• 量化功能: 支持将浮点模型量化为定点模型，目前支持的量化方法为非对称量化 ( asymmetric_quantized-8 及 asymmetric_quantized-16 )，并支持混合量化功能 。 asymmetric_quantized-16 目前版本暂不支持
   

• 模型推理: 能够在 PC 上模拟 Rockchip NPU 运行 RKNN 模型并获取推理结果; 或将 RKNN 模型分发到指定的 NPU 设备上进行推理并获取推理结果
   

• 性能评估: 将 RKNN 模型分发到指定 NPU 设备上运行，以评估模型在实际设备上运行时的性能
   

• 内存评估: 评估模型运行时的内存的占用情况。使用该功能时，必须将 RKNN 模型分发到 NPU 设备中运行，并调用相关接口获取内存使用信息
   

• 量化精度分析: 该功能将给出模型量化前后每一层推理结果与浮点模型推理结果的余弦距离，以便于分析量化误差是如何出现的，为提高量化模型的精度提供思路

2.3.2. 环境依赖

• 系统依赖：RKNN-Toolkit2 目前版本适用系统Ubuntu18.04(x64)及以上，工具只能安装在 PC 上，暂不支持 Windows、MacOS、Debian 等操作系统

• Python版本：3.6/3.8

• Python依赖库：

2.3.3. RKNN-Toolkit2 安装

建议使用 virtualenv 管理 Python 环境，因为系统中可能同时有多个版本的 Python 环境，以 Python3.6 为例

2.3.4. 模型转换 Demo

在rknn-toolkit2/examples下有各种功能的 Toolkit Demo ，这里我们运行一个模型转换 Demo 为例子，这个 Demo 展示了在 PC 上将 tflite 模型转换成 RKNN 模型，然后导出、推理、部署到 NPU 平台运行并取回结果的过程。模型转换的具体实现请参考 Demo 内源代码以及本页末尾的文档。

2.3.5. 其他 Toolkit Demo

其他 Toolkit Demo 可以在rknn-toolkit2/examples/下找到，例如量化、精度评估等。具体实现以及使用方法请参考 Demo 内源代码以及详细开发文档。