2.4.1. 安装驱动

下载驱动并安装:

• CH340

• PL2303

• CP210X

如果在 Win8 上不能正常使用 PL2303，参考这篇文章， 采用 3.3.5.122 或更老版本的旧驱动即可。

如果在 Windows 系统上安装官网的 CP210X 驱动，使用 PUTTY 或 SecureCRT 等工具设置串口波特率为 1500000，如果出现设置不了或无效的问题，可以下载旧版本驱动。

插入适配器后，系统会提示发现新硬件，并初始化，之后可以在设备管理器找到对应的 COM 口：

2.4.2. 安装软件

Windows 上一般用 putty 或 SecureCRT。其中我们推荐使用 MobaXterm 免费版本。这是一款功能强大的终端软件，在这里介绍一下，MobaXterm 的使用方法与之类似。

到这里下载 MobaXterm：

1. 选择 session 为 Serial。

2. 将 Serial port 修改为在设备管理器中找到的 COM 端口。

3. 设置 Speed (bsp) 为 1500000。

4. 点击 OK 按钮。

2.5.1. 安装 minicom

根据提示按O进入设置界面，如下：

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

2.4.1. Windows操作系统

• 安装RK USB驱动

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

• 运行AndroidTool的RKDevTool.exe

为避免由下载工具版本引起的烧写问题，推荐使用公版固件压缩包内部打包好的工具进行烧写，例如安卓公版固件压缩包解压后如下：

4.3.1. 固件下载到NOR flash

系统在Maskrom模式下默认将固件下载到NOR flash中，不过由于NOR flash 比较小，不足以装载系统镜像，所以一般只会烧写比较小的文件，如MiniLoaderAll.bin。如果不小心将整个固件下载到NOR flash中，会出现下载固件失败的现象, 此时大家可以参考FAQ去处理

4.3.2. 固件下载到eMMC

有两种方法可以将固件烧写进eMMC中，一种是RK原厂提供的烧写方法，需要烧写MiniLoaderAll.bin并切换存储器；另一种是Firefly为了方便大家烧写，提供的一种参考烧写方法，该方法操作上无需要切换存储器，也可以使用Linux端的烧写工具upgrade_tool进行烧写

1.1.1. 获取 SDK

首先准备一个空文件夹用于存放 SDK，建议在 home 目录下，本文以~/proj为例

不要在虚拟机共享文件夹以及非英文目录存放、解压SDK，避免产生不必要的错误

获取 SDK 需要先安装：

• 方法一（推荐）

由于 Firefly_Linux_SDK 源码包比较大，部分用户电脑不支持4G以上文件或单个文件网络传输较慢, 所以我们采用分卷压缩的方法来打包 SDK。用户可以通过如下方式获取 Firefly_Linux_SDK 源码包：Firefly_Linux_SDK源码包

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

确认无误后，就可以解压：

• 方法二

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

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

mkdir ~/proj/rk356x_linux_release_v1.3.0b_20221213/
cd ~/proj/rk356x_linux_release_v1.3.0b_20221213/

## 完整 SDK
repo init --no-clone-bundle --repo-url https://gitlab.com/firefly-linux/git-repo.git --no-repo-verify -u https://gitlab.com/firefly-linux/manifests.git -b master -m rk356x_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 --no-repo-verify -u https://gitlab.com/firefly-linux/manifests.git -b master -m rk356x_linux_bsp_release.xml

FIRMWARE_VER: 1.0
MACHINE_MODEL: RK3568
MACHINE_ID: 007
MANUFACTURER: RK3568
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),0x00010000@0x00008000(boot),0x00010000@0x00018000(recovery),0x00010000@0x00028000(backup),0x00c00000@0x00038000(rootfs),-@0x00c38000(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 rk356x_yocto_kirkstone_release.xml
.repo/repo/repo sync -c

FIRMWARE_VER: 1.0
MACHINE_MODEL: RK3568
MACHINE_ID: 007
MANUFACTURER: RK3568
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),0x00010000@0x00008000(boot),0x00010000@0x00018000(recovery),0x00010000@0x00028000(backup),0x00040000@0x00038000(oem),0x00c00000@0x00078000(rootfs),-@0x00c78000(userdata:grow)
uuid:rootfs=614e0000-0000-4b53-8000-1d28000054a9

2.1.1. 获取 SDK

首先准备一个空文件夹用于存放 SDK，建议在 home 目录下，本文以~/proj为例

不要在虚拟机共享文件夹以及非英文目录存放、解压SDK，避免产生不必要的错误

获取 SDK 需要先安装：

• 方法一（推荐）

由于 Firefly_Linux_SDK 源码包比较大，部分用户电脑不支持4G以上文件或单个文件网络传输较慢, 所以我们采用分卷压缩的方法来打包 SDK。用户可以通过如下方式获取 Firefly_Linux_SDK 源码包：rk356x_linux5.10_release_20240319_v1.4.0b

下载完成后，提取 SDK：

• 方法二

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

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

# 创建 SDK 目录
mkdir ~/proj/rk356x_sdk-linux5.10
cd ~/proj/rk356x_sdk-linux5.10

## 完整 SDK
repo init --no-clone-bundle --repo-url https://gitlab.com/firefly-linux/git-repo.git --no-repo-verify -u https://gitlab.com/firefly-linux/manifests.git -b master -m rk356x_linux5.10_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 --no-repo-verify -u https://gitlab.com/firefly-linux/manifests.git -b master -m rk356x_linux5.10_bsp_release.xml

FIRMWARE_VER: 1.0
MACHINE_MODEL: RK3568
MACHINE_ID: 007
MANUFACTURER: RK3568
MAGIC: 0x5041524B
ATAG: 0x00200800
MACHINE: 0xffffffff
CHECK_MASK: 0x80
PWR_HLD: 0,0,A,0,1
TYPE: GPT
GROW_ALIGN: 0
CMDLINE: mtdparts=rk29xxnand:0x00002000@0x00004000(uboot),0x00002000@0x00006000(misc),0x00040000@0x00008000(boot:bootable),0x00020000@0x00048000(recovery),0x00010000@0x00068000(backup),0x00c00000@0x00078000(rootfs),-@0x00c78000(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 rk356x_yocto_kirkstone_release.xml
.repo/repo/repo sync -c

FIRMWARE_VER: 1.0
MACHINE_MODEL: RK3568
MACHINE_ID: 007
MANUFACTURER: RK3568
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),0x00020000@0x00048000(recovery),0x00010000@0x00068000(backup),0x00040000@0x00078000(oem),0x00c00000@0x000b8000(rootfs),-@0x00cb8000(userdata:grow)
uuid:rootfs=614e0000-0000-4b53-8000-1d28000054a9

1.6.1. 连接管理

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

1.7. 调试

3.1.1. 第一步，下载 SDK

• 由于 SDK 较大，可以去下载页面选择云盘下载 Firefly-RK356X_Android11.0_git

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

  

3.1.2. 第二步，更新 SDK

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

1.2.1. 配置DTS节点

用户首先需在 DTS 文件中添加 ADC 的资源描述：

Linux DTS: kernel/arch/arm64/boot/dts/rockchip/rk3566-firefly-roc-pc.dts

Android DTS: kernel/arch/arm64/boot/dts/rockchip/rk3566-roc-pc.dts

2.1.1. Full Mode

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

• data lane最大4 lanes;

• 最大速率2.5Gbps/lane;

2.1.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.2.1. Full Mode设备树配置要点

2.2.2. 配置sensor端

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

2.2.3. csi2_dphy0相关配置

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

2.2.4. isp相关配置

2.3. Split Mode配置

链接关系:

sensor1->csi_dphy1->isp_vir0

sensor2->csi_dphy2->mipi_csi2->vicap->isp_vir1

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.3.1. 定义 I2C 驱动

3.3.2. 注册 I2C 驱动

3.3.3. 通过 I2C 收发数据

在注册好 I2C 驱动后，即可进行 I2C 通讯。

3.4. FAQs

注：rockchip,key_table第一列为键值，第二列为要响应的按键码。

4.2.2. 如何获取用户码和IR 键值

在rockchip_pwm_remotectl.c驱动中的 remotectl_do_something 函数获取用户码和键值：

4.2.3. 将 IR 驱动编译进内核

这里定义了LCD的控制引脚：

在硬件信号上enable引脚高电平有效，而reset引脚是低电平有效。

具体的引脚配置请参考《GPIO 使用》一节。

5.2.2. 背光配置

在DTS文件中配置了背光信息，如下：

详细说明可参考以下附件： Rockchip DRM Panel Porting Guide.pdf

6.6. FAQs

查看注册是否成功，成功则返回接口名和寄存器地址。

8.5. FAQs

9.3.1. SYSFS接口

9.3.2. PROCFS 接口

打印 RTC 相关的信息：

2.1.1. 产品参数

• 型号：M101014_BE45_A1

• 尺寸：10.1寸

• 分辨率：800x1280

• 显示接口：MIPI

• 面板材料：IPS面板

• 可视角度：160°

• 触摸屏：多点电容触摸

2.1.2. 参考固件

支持10.1寸屏的官方固件名带有MIPI字样，下面是固件的链接：固件链接

如需使用双屏显示，请先参考FAQ

2.1.3. 编译命令

用官网SDK编译支持的10.1 寸mipi屏的固件时使用以下命令：

4.1.1. 产品参数

• 型号

  • EC20-C R2.0 Mini PCIe-C

• 电源电压

  • 3.3V~ 3.6V, 典型值： 3.3V

• 工作频段

  • TDD-LTE: B38/B39/B40/B41

  • FDD-LTE: B1/B3/B8

  • WCDMA: B1/B8

  • TD-SCDMA: B34/B39

  • GSM: 900/1800 MHz

• 数据传输

  • TDD-LTE： Max 130Mbps (DL) Max 35Mbps (UL)

  • FDD-LTE： Max 150Mbps (DL) Max 50Mbps (UL)

  • DC-HSPA ： Max 42Mbps (DL) Max 5.76Mbps (UL)

  • UMTS： Max 384Kbps (DL) Max 384Kbps (UL)

  • TD-SCDMA： Max 4.2Mbps (DL) Max 2.2Mbps (UL)

  • CDMA： Max 3.1Mbps (DL) Max 1.8Mbps (UL)

  • EDGE： Max 236.8Kbps (DL) Max 236.8Kbps (UL)

  • GPRS： Max 85.6Kbps (DL) Max 85.6Kbps (UL)

• 接口连接器

  • USB：USB 2.0 高速接口, 480Mbps

  • 数字语音：1个数字语音接口 (可选)

  • USIM：1.8V/3V

  • 网络指示：×2, NET_STATUS 和 NET_MODE

  • UART：×1 UART

  • 复位：低电平

  • PWRKEY：低电平

  • 天线接口：×3 (主天线, 分集天线和GNSS天线接口)

  • ADC：×2

• 结构尺寸

  • 51.0mm × 30.0mm × 4.9mm

• 重量

  • 约 10.5g

• 认证

  • CCC/ NAL*/ TA

4.1.2. GNSS 功能

EC20 模组分带GNSS和不带GNSS两种，Firefly官网售卖的EC20 4G模组是不支持GNSS的，后缀为SNNS，支持GNSS功能的EC20 模组一般带有后缀SGNS，公版固件支持GNSS功能，但是默认关闭，使用方法可参考EC20 GNSS功能章节。

4.1.3. 实物图

4.1.4. 连接方法

• USB 接口连接

• SIM 卡连接

4.2.1. 产品参数

• 型号

  • EC200T-CN Mini PCIe-D

• 电源电压

  • 3.4V~ 4.3V, 典型值： 3.8V

• 工作频段

  • TDD-LTE: B34/B38/B39/B40/B41

  • FDD-LTE: B1/B3/B5/B8

  • WCDMA: B1/B5/B8

  • GSM: 900/1800 MHz

• 数据传输

  • TDD-LTE： Max 120Mbps (DL) Max 3Mbps (UL)

  • FDD-LTE： Max 150Mbps (DL) Max 50Mbps (UL)

  • DC-HSDPA： Max 21Mbps (DL)

  • HSDPA: Max 5.76 Mbps (UL)

  • WCDMA: Max 384Kbps (DL) Max 384Kbps (UL)

  • EDGE: Max 236.8Kbps (DL) Max 236.8Kbps (UL)

  • GPRS： Max 85.6Kbps (DL) Max 85.6Kbps (UL)

• 接口连接器

  • USB：USB 2.0 高速接口, 480Mbps

  • 数字语音：1个数字语音接口 (可选)

  • USIM：1.8V/3V

  • UART：×1 UART

  • UART_DTR (睡眠控制)

  • W_DISABLE# (飞行模式控制)

  • LED_WWAN# (网络状态指示)

  • PERST# (模块复位)

  • RI (主机唤醒)

  • WAKEUP_IN (睡眠控制,低电平有效)

  • WAKEUP_OUT (睡眠状态指示)

  • 天线接口：×2 (主天线, 分集天线)

• 结构尺寸

  • 51.0mm × 30.0mm × 4.9mm

• 重量

  • 约 10.2g

• 认证

  • CCC/SRRC/NAL

4.2.2. 实物图

4.2.3. 连接方法

参考EC20 4G模组套件

4.2.4. 参考固件

公版固件默认支持 EC20 4G 模组、EC200T 4G模组

4.3.1. EC20 GNSS功能

EC20模组支持GPS、GLONASS、GALILEO、BEIDOU，兼容标准 NMEA 0183 协议，可通过 USB NMEA 接口输出 1Hz 频率的 NMEA 信息，默认输出串口为/dev/ttyUSB1，波特率115200 bit/s。

4.3.2. 如何使能GPS和修改串口配置

名词解释:

• SERIAL_DEVICE: 串口节点

• SERIAL_BAUD_RATE: 串口波特率

产品简介

发货清单(仅供参考)

规格参数

• 尺寸大小：43.5mm * 30 mm

• HDMI RX 接口：

  • 兼容HDMI 1.4/HDMI 2.0

  • 支持8/10bit 视频格式

  • 支持RGB888/YUV420

  • 最大支持分辨率4K@60fps (YUV420)

• MIPI CSI 接口：

  • 兼容MIPI DPHY V1.2

  • 支持YUV422

  • 主要分辨率支持：3840x2160@30fps，1920x1080@60fps，1280x720@60fps，720x480@60fps

• LINEOUT 接口：

  • 同一路音频输出：3.5mm 耳机接口 * 1、3P-2mm * 1、2P-1.25mm * 1

接口定义

Line Out：将声卡处理后的模拟信号通过此接口输出到音频设备上。

硬件连接

Android 使用HDMI-IN

系统默认内置HdmiIn2的应用，如图： 

点击进入应用后，就会有HDMI-IN 的图像显示，音频会从驱动板上的LineOut输出，最大支持输出分辨率3840x2160@30fps。

Linux 使用 HDMI-IN

在设备上运行如下脚本：

1.4. 烧录

参考分区烧写

2.3. 烧录

打开烧录工具，按住Recovery 按键，使用 Type-A to Type-C 线连接板子和PC 机上电，两秒后松开recovery按键.

2.4. 确认是否正确烧写新的 Loader

如果你已经成功烧写你最新编译的 Loader，在开机的串口输出中可以看到类似如下信息：

3.2. 非 RKNN 模型

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

3.3. RKNN-Toolkit2工具

这样I2C2就使用了M1通道，而RTC和MIPI DSI的触摸部分暂时用不了。

1.5.2. V1.1及以上版本设备

在V1.1及以上版本的设备中，MIPI CSI单独使用的I2C4_M0和RTC,MIPI DSI所使用的I2C2_M0是不冲突的，共用的，不需要使用上一步的配置来进行区分使用。

1.7. 3.5mm耳机座子接国标耳机有异常？

目前ROC-RK3566-PC仅支持美标类型(CTIA)的耳机,对于国标类型(OMTP)的耳机硬件不兼容,会出现左右声道同时存在双声道的现象。

1.8. 开机异常并循环重启怎么办？

有可能是电源电流不够，请使用PD 电源来供电。

1.9. Ubuntu 默认的用户名和密码是什么？

1.10. 写号工具写入SN，MAC地址

注意:如果开发板进行了eMMC擦除操作，之前写入的数据也会被清除。

1.1. 整机接口定义

ROC-RK3566-PC 提供了丰富的接口，主要包括：

• 1 x USB3.0 (host)

• 1 x USB2.0 (host)

• HDMI

• MIPI 屏幕接口

• TP 触摸接口

• 以太网

• WIFI 天线

• 3.5mm 耳机接口

• Type-C(PD)电源接口

• IR 接口

• TF 卡槽

• Power 按键

• Reset 按键

• Recovery 按键

• 调试串口

• NOR flash

• MIPI 摄像头接口

具体如下图：