一、产品介绍

二、使用方法

2.1. 前言

本文介绍了如何将主机上的固件，通过Type-C 数据线烧录到 ROC-RK3576-PC 开发板的存储器中。升级时，需要根据主机操作系统和固件类型来选择合适的升级方式。

2.2. 准备工具

• ROC-RK3576-PC 开发板

• 固件

• 主机

• 良好的Type-C 数据线

2.3. 准备固件

固件可以通过编译SDK获得，也可以通过资源下载处下载公版固件（统一固件）。固件文件一般有两种：

• 单个统一固件

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

• 多个分区镜像

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

2.4. 安装烧写工具

1.1. 编译 Ubuntu 固件

本章介绍 Ubuntu 固件的编译流程，推荐在 Ubuntu 20.04 系统环境下进行开发，若使用其它系统版本，可能需要对编译环境做相应调整。

本教程的编译部分适用于 v0.1.0a 以上 SDK 版本

1.1.1. 准备工作

MACHINE=roc-rk3576-pc bitbake u-boot-rockchip

1.1. 前言

ADB，全称 Android Debug Bridge，是 Android 的命令行调试工具，可以完成多种功能，如跟踪系统日志，上传下载文件，安装应用等。

1.2. 准备连接

使用 Type-C 数据线连接 PC 以及设备的 OTG 端口。

设备的 OTG 端口详细见接口定义。

1.3. 网络 ADB

1.4. Windows下的 ADB 安装

首先参照安装 RK USB 驱动一节安装好驱动。

然后下载 adb.zip，解压到 C:adb 以方便调用。

打开命令行窗口，输入：

1.5. Ubuntu 下的 ADB 安装

1.6. 常用 ADB 命令

2.1. 准备工作

编译 Android 对机器的配置要求较高：

• 64 位 CPU

• 64GB 物理内存 交换内存

• 250GB 空闲的磁盘空间

如需编译 Android 14，您必须使用 Ubuntu 20.04 或更高版本。
如需安装 Ubuntu 20.04 或更高版本所需的软件包，请运行以下命令：

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

3.1. 下载 Android14.0 SDK

SDK 源码与 bundle 压缩包均存放在云盘中。如有需要请联系商务 ： sales@t-firefly.com

1.1. 简介

ROC-RK3576-PC 开发板上的 AD 接口有两种，分别为：温度传感器 (Temperature Sensor)、逐次逼近ADC (Successive Approximation Register)。其中：

• TS-ADC(Temperature Sensor)：支持七通道。

• SAR-ADC(Successive Approximation Register)：支持八通道单端12位的SAR-ADC，最大转换速率为1MSPS，采用20MHz的A/D转换器时钟。

内核采用工业 I/O 子系统来控制 ADC，该子系统主要为 AD 转换或者 DA 转换的传感器设计。 下面以 SAR-ADC 为例子，介绍 ADC 的基本配置方法。

1.2. 硬件

ROC-RK3576-PC 的ADC接口图如下：

1.3. DTS配置

2.1. PHY 介绍

RK3576 芯片有 1 个 DCPHY 和 2 个 DPHY, 两个 DPHY 可以工作在两个模式: full mode 和 split mode。DCPHY 则只有 full mode。

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

目前ROC-RK3576-PC硬件只引出 1 个 DPHY。

2.2. Full Mode 配置

配置链路为：csi2_dphy0 –> mipi1_csi2 –> rkcif_mipi_lvds1

详情请查看设备树：rk3576-roc-pc-cam-8ms1m.dtsi

2.3. Camera底层调试

查找摄像头节点

使用v4l2-ctl抓取camera数据帧

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

把out.yuv文件拷贝出来通过ubuntu去查看

3.1. ROC-RK3576-PC 显示接口的配置

ROC-RK3576-PC 有三种显示输出接口，分别是 HDMI、Display Port 以及 MIPI DSI，可以做到多屏同显/异显，接口图如下所示：

• HDMI/ Display Port/ MIPI DSI

下面对各个显示输出接口的配置和使用作基本的介绍，详细内容可以参考文件：

• kernel/arch/arm64/boot/dts/rockchip/rk3576-firefly-roc-rk3576-pc.dtsi

• kernel/arch/arm64/boot/dts/rockchip/rk3576-firefly-roc-rk3576-pc-mipi101-M101014-BE45-A1.dts

4.1. dts 配置

5.1. 简介

GPIO，全称 General-Purpose Input/Output（通用输入输出），是一种软件运行期间能够动态配置和控制的通用引脚。 所有的 GPIO 在上电后的初始状态都是输入模式，可以通过软件设为上拉或下拉，也可以设置为中断脚，驱动强度都是可编程的，其核心是填充 GPIO bank 的方法和参数，并调用 gpiochip_add 注册到内核中。

ROC-RK3576-PC 开发板为了方便用户开发使用，引出了GPIO口供用户调试和开发,可以用到的GPIO3_A4

5.3. 输入输出

首先在 DTS 文件中增加驱动的资源描述：

5.4. 中断

在 Firefly 的例子程序中还包含了一个中断引脚，GPIO 口的中断使用与 GPIO 的输入输出类似，首先在 DTS 文件中增加驱动的资源描述：

然后在 probe 函数中对 DTS 所添加的资源进行解析，再做中断的注册申请，代码如下：

5.6. 调试方法

6.1. 前言

ROC-RK3576-PC开发板上有个三色LED灯，如下表所示：

可通过使用 LED 设备子系统或者直接操作 GPIO 控制该 LED。

6.2. 以设备的方式控制 LED

6.3. 使用 trigger 方式控制 LED

Trigger 包含多种方式可以控制 LED，这里就用两个例子来说明。

• Simple trigger LED

• Complex trigger LED

默认应该就是开启的，如果没有，打开后要保存配置并编译烧录内核。

之后我们可以使用串口输入命令，就可以看到灯不停的间隔闪烁。

7.1. 前言

本章主要描述如何配置 PWM。

7.3. 接口说明

用户可在其它驱动文件中使用以上步骤生成的 PWM 节点。具体方法如下：

7.4. 调试方法

8.1. 简介

ROC-RK3576-PC开发板采用 TT8563RH 作为RTC(Real Time Clock)，TT8563RH 是一款低功耗CMOS实时时钟/日历芯片,它提供一个可编程的时钟输出,一个中断 输出和一个掉电检测器,所有的地址和数据都通过I2C总线接口串行传递。

• 可计时基于 32.768kHz 晶体的秒,分,小时,星期,天,月和年

• 宽工作电压范围:1.0~5.5V

• 低休眠电流:典型值为 0.25μA(VDD =3.0V, TA =25°C)

• 内部集成振荡电容

• 漏极开路中断引脚

ROC-RK3576-PC 存在电容给RTC供电，可以在短时间内保证RTC运行。

8.2. RTC驱动

8.3.2. PROCFS 接口

打印 RTC 相关的信息：

9.1. 简介

ROC-RK3576-PC 开发板上有 1 个 M.2 接口。

可以软件配置成 M.2 SATA3.0 接口，支持 SATA 协议的 SSD 使用，也可以软件配置成 M.2 PCIe2.0 接口，支持 NVMe 协议的 SSD 使用。

默认软件配置成 M.2 SATA3.0 接口, 支持 SATA 协议的 SSD 使用。

9.2. 软件配置

10.1. 硬件

ROC-RK3576-PC 硬件版本的串口接口图如下：

10.2. DTS配置

10.3. UART 收发验证

最简单的方式短接UART6 TX RX 引脚, 然后使用命令在调试串口或ADB执行命令

最终调试串口终端即可接收到字符串 “firefly uart test…”

11.1. 简介

看门狗（watchdog）实际是一个定时器，启动之后会开始计时。系统或者软件需要在规定时间内与看门狗通信（俗称喂狗）重置计时，如此反复下去，以此来确定系统和软件正常运行。

如果规定时间内没有喂狗，看门狗超时，说明系统或应用陷入循环、卡死，此时看门狗会发出复位信号让主控复位，脱离卡死。

本章节主要介绍 ROC-RK3576-PC 开发板看门狗的使用。

11.2. DTS配置

11.3. 使用

watchdog 默认是关闭的，需按上述说明在 DTS 文件中打开相关节点方能使用。

也可以通过程序来控制看门狗，通过Android.mk编译生成可执行文件，在机器启动后，push到上面运行，demo代码如下：

demo说明：

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

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

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

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

1.1. RKLLM 介绍

RKLLM SDK可以帮助用户快速将大语言模型部署到ROC-RK3576-PC上。 SDK下载

1.2. RKLLM-Toolkit 安装

1.3. 大语言模型部署例程

RKLLM已支持的大模型如下

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

RKNN 是 Rockchip NPU 平台使用的模型类型，以.rknn后缀结尾的模型文件。用户可以通过RKNN SDK提供的工具将自主研发的算法模型转换成 RKNN 模型

RKNN 模型可以直接运行在 RK3576 平台上，在rknpu2/examples中有例子，根据README.md编译生成 Android 或 Linux Demo（需要交叉编译环境）。也可以直接下载编译好的 Demo。

在 ROC-RK3576-PC 上运行yolov5 demo如下:

# Platform 为芯片平台，如RK3576，RK3588, RK3566_RK3568等
:/ # cd /data/rknn_yolov5_demo_Android  (Linux 系统使用 rknn_yolov5_demo_Linux 即可)
:/data/rknn_yolov5_demo_Android # chmod 777 rknn_yolov5_demo
:/data/rknn_yolov5_demo_Android # export LD_LIBRARY_PATH=./lib
:/data/rknn_yolov5_demo_Android # ./rknn_yolov5_demo model/Platform/yolov5s-640-640.rknn ./model/bus.jpg resize ./out.jpg
post process config: box_conf_threshold = 0.25, nms_threshold = 0.45
Loading mode...
sdk version: 2.3.0 (c949ad889d@2024-11-07T11:35:33) driver version: 0.9.3
model input num: 1, output num: 3
  index=0, name=images, n_dims=4, dims=[1, 640, 640, 3], n_elems=1228800, size=1228800, w_stride = 640, size_with_stride=1228800, fmt=NHWC, type=INT8, qnt_type=AFFINE, zp=-128, scale=0.003922
  index=0, name=output0, n_dims=4, dims=[1, 255, 80, 80], n_elems=1632000, size=1632000, w_stride = 0, size_with_stride=1638400, fmt=NCHW, type=INT8, qnt_type=AFFINE, zp=-128, scale=0.003922
  index=1, name=286, n_dims=4, dims=[1, 255, 40, 40], n_elems=408000, size=408000, w_stride = 0, size_with_stride=409600, fmt=NCHW, type=INT8, qnt_type=AFFINE, zp=-128, scale=0.003922
  index=2, name=288, n_dims=4, dims=[1, 255, 20, 20], n_elems=102000, size=102000, w_stride = 0, size_with_stride=122880, fmt=NCHW, type=INT8, qnt_type=AFFINE, zp=-128, scale=0.003922
model is NHWC input fmt
model input height=640, width=640, channel=3
Read ./model/bus.jpg ...
img width = 640, img height = 640
once run use 67.055000 ms
loadLabelName ./model/coco_80_labels_list.txt
person @ (209 243 286 510) 0.879723
person @ (479 238 560 526) 0.870588
person @ (109 238 231 534) 0.839831
bus @ (91 129 555 464) 0.692042
person @ (79 353 121 517) 0.300961
save detect result to ./out.jpg
loop count = 10 , average run  59.530100 ms

1. 接口定义