产品简介

发货清单

详细参数

硬件连接

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

使用说明

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

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. 进入升级模式

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

1.1.1. 校验与解压

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

1.2. SDK 配置介绍

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

2.1.1. 安装工具

获取 SDK 需要先安装：

2.1.2. 初始化仓库

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

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

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

2.1.3. 同步代码

执行如下命令同步代码：

2.2. Linux SDK 配置介绍

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

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

4.1.1. 介绍

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

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

4.1.2. RK3588 端

1.6.1. 连接管理

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

1.7. 调试

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. ROC-RK3588S-PC 产品编译方法

  3.2.1. 整体编译

  3.2.1.1. HDMI 固件编译

  

  3.2.1.3. 双目摄像头 CAM-2MS2MF 编译：

  3.2.1.3.1. HDMI CAM-2MS2MF

  

  3.2.1.4. HDMI TO MIPI_CSI(RK628D) 编译

  

  3.2.2. 分步编译

  

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

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

  

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

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

  3.3. 其他编译说明

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

  

  3.4. 分区镜像

  

  固件	说明
  boot.img	包含ramdis、kernel、dtb
  dtbo.img	Device Tree Overlays
  MiniLoaderAll.bin	包含一级loader
  misc.img	包含recovery-wipe开机标识信息,烧写后会进行recovery
  parameter.txt	包含分区信息
  recovery.img	包含recovery-ramdis、kernel、dtb
  super.img	包含odm、product、vendor、system、system_ext分区内容
  uboot.img	包含uboot固件
  vbmeta.img	包含avb校验信息,用于AVB校验
  update.img	包含以上需要烧写的img文件,可以用于工具直接烧写整个固件包

  请参照 《使用USB线缆升级固件》 一文来烧写分区镜像文件。

  3.5. OTA 编译

  请参照《OTA编译》章节

  3.6. 常见问题

  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. ROC-RK3588S-PC 产品编译方法

  4.2.1. 整体编译

  4.2.1.1. HDMI 固件编译

  

  4.2.2. 分步编译

  

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

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

1.3.1. 配置DTS节点

1.3.2. 在驱动文件中匹配 DTS 节点

接着在 firefly_adc_probe 中对 DTS 所添加的资源进行解析：

1.4. 驱动说明

2.2.1. Full Mode

• 仅使用csi2_dphy0,csi2_dphy0与csi2_dphy1/csi2_dphy2互斥,不可同时使用;

• data lane最大4 lanes;

• 最大速率2.5Gbps/lane;

2.2.2. Split Mode

• 仅使用csi2_dphy1和csi2_dphy2, 与csi2_dphy0互斥,不可同时使用;

• csi2_dphy1和csi2_dphy2可同时使用;

• csi2_dphy1和csi2_dphy2各自的data lane最大是2 lanes;

• csi2_dphy1对应物理dphy的lane0/lane1;

• csi2_dphy2对应物理dphy的lane2/lane3;

• 最大速率2.5Gbps/lane;

简单点来讲，如果用单目摄像头我们可以配置full mode，若使用双目摄像头我们可以配置split mode。

2.3.1. Full Mode设备树配置要点

2.3.2. 配置sensor端

我们需要根据板子原理图的MIPI CSI接口找到sensor是挂在哪个I2C总线上，然后在对应的I2C节点配置camera节点，正确配置camera模组的I2C设备地址、引脚等属性。如下ROC-RK3588S-PC的xc7160配置：

2.3.3. csi2_dphy0相关配置

csi2_dphy0与csi2_dphy1/csi2_dphy2互斥,不可同时使用。另外需要使能csi2_dphy0_hw节点

2.3.4. isp相关配置

2.4. Split Mode配置

链接关系:

sensor1->csi2_dphy1->mipi2_csi2->rkcif_mipi_lvds2 - - -> rkcif_mipi_lvds2_sditf->rkisp0_vir2

sensor2->csi2_dphy2->mipi3_csi2->rkcif_mipi_lvds3 - - -> rkcif_mipi_lvds3_sditf->rkisp1_vir0

v4l2-ctl --verbose -d /dev/video0 --set-fmt-video=width=1920,height=1080,pixelformat='NV12' --stream-mmap=4 --set-selection=target=crop,flags=0,top=0,left=0,width=1920,height=1080 --stream-to=/data/out.yuv

3.1.2.1. 软件配置

这里要注意，SDK 默认的软件配置是把 dp0 连接在 vp2 上面，这样会导致 dp0 最高只能输出 4096x2304@60Hz，所以如果需要 7680x4320@30Hz 的功能，需要把 dp0 连接在 vp0上面，软件修改如下：

3.1.3. MIPI DSI

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

4.1.1. 公共的配置

4.1.2. 板级的配置

4.1.3. 查看IP地址

5.6.1. GPIO 调试接口

8.3.1. SYSFS接口

8.3.2. PROCFS 接口

打印 RTC 相关的信息：

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

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

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

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

9.2.2. 方式二：DTS 配置

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

9.3. 挂载

demo说明：

1、内部看门狗在使用 open 函数打开后会立刻开始计时。

2、关于超时时间：用户可以用 ioctl 来设置超时时间和获取超时时间。当用户没有设置超时时间时，驱动会应用默认请求的超时时间为 30 s。需要说明的是驱动最终设置的超时时间并不一定是应用层传输的时间或者驱动一开始设置的默认时间。驱动函数里有一个超时时间的列表，该列表中存放了 16 个超时时间（前 9 个是 0）。驱动会在超时时间列表中找到一个合适的时间作为最终 watchdog 设置的超时时间。

以下为超时时间的详细列表：

参考文档：SDK/RKDocs(linux 为 docs)/common/watchdog

11.4. 外部看门狗

很多设备上有外部硬件看门狗，通过查看设备文件可以确认是否支持外部看门狗。如果有硬件看门狗 /dev/ 下应该会生成 wdt_XXX 的设备文件。

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 模型，并在ROC-RK3588S-PC 板端通过调用 NPU 驱动在 Rockchip NPU 上实现 RKLLM 模型的推理。在推理RKLLM 模型时，用户可以自行定义 RKLLM 模型的推理参数设置，定义不同的文本生成方式，并通过预先定义的回调函数不断获得模型的推理结果。

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

1.3.1.1. 在 PC 上转换模型

DeepSeek-R1-Distill-Qwen-1.5B 为例，依据表格链接，找到对应模型仓库，克隆完整仓库内容。 在前述RKLLM-Toolkit安装正确的前提下，进入 Conda 环境。然后执行generate_data_quant.py生成量化标定数据。

(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.2. 非 RKNN 模型

对于 Caffe、TensorFlow 等其他模型，想要在 RK3588 平台运行，需要先进行模型转换。可以使用 RKNN-Toolkit2 工具将模型转换成 RKNN 格式。

2.3. RKNN-Toolkit2工具

1.1. 整机接口定义

ROC-RK3588S-PC V1.1 使用的接口，主要包括：

• 1 x HDMI2.1（最大支持 8K@60Hz 输出）

• 1 x Display Port1.4（最大支持 8K@30Hz 输出）

• 1 x USB3.0 OTG(Type-C)

• 2 x MIPI-DSI

• 1 x MIPI-CSI

• 1 x SATA3.0 或 PCIe2.0

• 1 x TF Card

• 1 x USB3.0

• 3 x USB2.0 (其中2个USB2.0由20Pin排针引出)

• 1 x WIFI

• 1 x Bluetooth

• 1 x FAN

• 1 x RJ45（支持 1Gbps）

• 1 × 3.5mm耳机接口（V1.1版本支持录音）

• 1 × Mic输入（2P-1.25mm）

具体如下图：

ROC-RK3588S-PC 旧版本接口定义