发货清单（仅供参考）

• ROC-RK3399-PC Pro 主板 ×1

• Type-C data cable x1

• 铜管天线×1

选购适配器

网店上有许多 USB 转串口的适配器，按芯片来分，有以下几种：

注意： ROC-RK3399-PC Pro 默认的波特率是 1500000，有些USB转串口芯片波特率无法达到 1500000，同一芯片的不同系列也可能会有差异，所以在选购之前一定要确认是否支持。

硬件连接

串口转 USB 适配器，有四个引脚：

• 3.3V 电源（NC），不需要连接

• GND，串口的地线，接开发板串口的 GND 针

• TXD，串口的输出线，接开发板串口的 TX 针

• RXD，串口的输入线，接开发板串口的 RX 针

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

ROC-RK3399-PC Pro 串口连接图：

串口参数配置

ROC-RK3399-PC Pro 使用以下串口参数：

• 波特率：1500000

• 数据位：8

• 停止位：1

• 奇偶校验：无

• 流控：无

Windows 上使用串口调试

Ubuntu 上使用串口调试

在 Ubuntu 上可以有多种选择：

• minicom

• picocom

• kermit

篇幅关系，以下就介绍 minicom 的使用。

2.1. 前言

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

2.2. 准备工具

• ROC-RK3399-PC Pro 开发板

• 固件

• 主机

• 良好的Type-C data cable数据线

2.3. 准备固件

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

• 单个统一固件

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

• 多个分区镜像

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

2.4. 安装烧写工具

4.1. 准备工作

• ROC-RK3399-PC Pro

• 电脑

• MicroSD卡(即TF 卡)

• USB读卡器

• SD_Firmware_Tool

4.2. 操作步骤

7. 取出MicroSD卡，插入主板的MicroSD卡插槽，对主板上电开机，主板自动开始升级。

8. 升级完成后，取出MicroSD卡，主板自动重启，完成整个更新固件的流程。

1.1. 准备工作

FIRMWARE_VER: 1.0
MACHINE_MODEL: RK3399
MACHINE_ID: 007
MANUFACTURER: RK3399
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(trust),0x00002000@0x00008000(misc),0x00040000@0x0000a000(boot:bootable),0x00040000@0x0004a000(recovery),0x00010000@0x0008a000(backup),0x00c00000@0x0009a000(rootfs),0x00040000@0x00c9a000(oem),-@0x00d1a000(userdata:grow)
uuid:rootfs=614e0000-0000-4b53-8000-1d28000054a9

3.1. OpenSIP搭建

SIP（Session Initiation Protocol，会话初始协议）的开发目的是用来帮助提供跨越因特网的高级电话业务。因特网电话（IP电话）正在向一种正式的商业电话模式演进，SIP就是用来确保这种演进实现而需要的NGN(下一代网络）系列协议中重要的一员。支持H.264协议。

• 本次使用的系统为Ubuntu18.04（若使用ubutu20.04或Debian等可能需稍作修改）

# 安装编译环境、gtk包和相关编解码库
sudo apt install cmake build-essential libgtk2.0-dev pkg-config libavcodec-dev libavformat-dev libswscale-dev libtbb2 libtbb-dev libjpeg-dev libpng-dev libtiff-dev libdc1394-22-dev libjasper-dev

# 注意！如果安装了rknn_toolkit(or lite)则不需要再安装Python-numpy，否则会导致rknn_toolkit(or lite)无法使用
sudo apt install python-numpy

1.1. 前言

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

1.2. 准备连接

一般情况下adb是默认开启的，如果没有开启请执行以下步骤：

• ROC-RK3399-PC Pro用Type-C data cable连接设备和主机;

• 根据当前Android版本勾选对应路径下的Connect to PC

  • Android7.1、Android8.1 选择 Setting -> USB，然后勾选 Connect to PC

  • Android10.0 选择 Setting -> Connected devices 然后勾选 Connect to PC

• 基于你的系统安装 adb 驱动和命令。

当设备端状态栏提示 USB debugging connected 时，便可进行调试：

1.4. Windows下的 ADB 安装

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

然后到 http://www.t-firefly.com/share/index/index/id/6afafdf7c54b8eb95e81156d94e54db5.html 下载 adb.zip，解压到 C:adb 以方便调用。

打开命令行窗口，输入：

1.5. Ubuntu 下的 ADB 安装

1.6. 常用 ADB 命令

2.1. 准备工作

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

• 64 位 CPU

• 16GB 物理内存 交换内存

• 30GB 空闲的磁盘空间用于构建，源码树另外占用大约 25GB, 如果要编译源码则还需要 150GB 的磁盘空间。

RK官方推荐 Ubuntu 14.04 操作系统，不过该系统比较老且不再维护了，所以这里推荐使用 Ubuntu 16.04或18.04，只需要满足 http://source.android.com/source/building.html 里的软硬件配置即可。

编译环境的初始化可参考 http://source.android.com/source/initializing.html 。

3.1. 下载编译须知

Android7.1 industry 版本在工业和平板和盒子等领域的使用上范围更加广泛，而且性能稳定大批量生产验证过， 该版本也作为我司主要维护版本，适用于我司RK3399系统的所有机型。

3.2. 下载 Android SDK

Android SDK 源码包比较大,可以去下载页面来获取Android7.1 industry源码包： Android7.1 industry源码包

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

注意：解压后务必要先更新下远程仓库。 以下为从 gitlab 处更新的方法：

4.1. 下载 Android SDK

由于 SDK 较大，可以去下载页面选择云盘下载 Firefly-RK3399_Android10.0_git_20211222.7z：

下载链接

注：源码与bundle压缩包均存放在云盘中

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

4.2. 编译 Android SDK

5.1. 前言

注意： 以下内容仅适用于 Android8.1 及以下版本。

定制 Android 固件，有两种方法：

• 改源码，然后编译生成固件。

• 在现有固件的基础上进行裁剪。

前一种方法，可以从各个层面去定制 Android，自由度大，但对编译环境和技术要求比较高，参见《编译 Android 固件》一文。 现在介绍后一种方法，分为解包、定制和打包三个阶段。主机操作系统为 Linux，采用的工具为开源软件。

5.2. 固件格式

5.3. 工具准备

5.4. 解包

这样，固件就解包成功了，下面开始定制。

简介

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

• TS-ADC(Temperature Sensor)：支持两通道，时钟频率必须低于800KHZ

• SAR-ADC(Successive Approximation Register)：支持六通道单端10位的SAR-ADC，时钟频率必须小于13MHZ。

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

DTS配置

简介

GPIO, 全称 General-Purpose Input/Output（通用输入输出），是一种软件运行期间能够动态配置和控制的通用引脚。 RK3399 有 5 组 GPIO bank：GPIO0~GPIO4，每组又以 A0~A7, B0~B7, C0~C7, D0~D7 作为编号区分。所有的 GPIO 在上电后的初始状态都是输入模式，可以通过软件设为上拉或下拉，也可以设置为中断脚，驱动强度都是可编程的。 每个 GPIO 口除了通用输入输出功能外，还可能有其它复用功能，例如 GPIO2_A2，可以利用成以下功能：

• GPIO2_A2

• GIF_D2

每个 GPIO 口的驱动电流、上下拉和重置后的初始状态都不尽相同，详细情况请参考《RK3399 规格书》中的 “Chapter 10 GPIO” 一章。 RK3399 的 GPIO 驱动是在以下 pinctrl 文件中实现的：

简介

ROC-RK3399-PC Pro 开发板上有 9 个片上 I2C 控制器，各个 I2C 的使用情况如下表：

本文主要描述如何在该开发板上配置 I2C。

配置 I2C 可分为两大步骤：

• 定义和注册 I2C 设备

• 定义和注册 I2C 驱动

下面以配置 GSL3680 为例。

定义和注册 I2C 设备

定义和注册 I2C 驱动

红外遥控配置

其配置步骤可分为两个部分：

• 修改内核驱动：内核空间修改，Linux 和 Android 都要修改这部分的内容。

• 修改键值映射：用户空间修改（仅限 Android 系统）。

内核驱动

在 Linux 内核中，IR 驱动仅支持 NEC 编码格式。以下是在内核中配置红外遥控的方法。

所涉及到的文件：

简介

ROC-RK3399-PC Pro 开发板默认外置支持了两种 LCD 屏接口，一个是 MIPI(最大支持 2560x1600@60fps) 接口，另外一个是 EDP (最大支持 2K@60fps) 接口。硬件连接图参考如下：

• 10.1 寸 MIPI 

• 

• 10.1寸 EDP 

• 

MIPI 驱动配置

前言

ROC-RK3399-PC Pro 开发板上有 2 个 LED 灯，如下表所示：

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

以设备的方式控制 LED

标准的 Linux 专门为 LED 设备定义了 LED 子系统。 在 ROC-RK3399-PC Pro 开发板中的两个 LED 均以设备的形式被定义。

使用 trigger 方式控制 LED

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

Simple trigger LED

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

Complex trigger LED

前言

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

接口说明

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

调试方法

SPI 简介

SPI是一种高速的，全双工，同步串行通信接口，用于连接微控制器、传感器、存储设备等。ROC-RK3399-PC Pro 的双排扩展引脚仅对SPI2作引出，具体位置参考底板丝印。

SPI 工作方式

SPI 以主从方式工作，这种模式通常有一个主设备和一个或多个从设备，需要至少 4 根线，分别是：

前言

RK3399有 12 个 Timers (timer0-timer11)，有 12 个 Secure Timers(stimer0~stimer11) 和 2 个 Timers(pmutimer0~pmutimer1)， 我们主要用到的是 Timers(timer0-timer11) 时钟频率为 24MHZ ，工作模式有 free-running 和 user-defined count 模式。

框架图

工作模式

其中定义的 Timer0 的寄存器和中断号和时钟等。

其他 Timer 对应的中断号可看如下图片：

简介

为了方便用户开发，ROC-RK3399-PC Pro 在板子的双排扩展接口上引出了 UART4（与 SPI1 复用）等两个通道。

• UART4 为 TTL 电平接口

• UART4 最高支持波特率 691,200

• 每个子通道都具备收与发的独立FIFO（256 BYTE），FIFO 的中断可按用户需求进行编程触发点

• 具备子串口接收 FIFO 的超时中断

• 支持起始位错误的检测

DTS 配置

调试方法

配置好串口后，硬件接口对应软件上的节点分别为：

然后在主机的串口终端输入字符串 “firefly test…”，设备端即可见到相同的字符串。

DM-M10R800V2 MIPI 屏模组

OV13850 摄像头模组(已停产)

EC20 4G模组套件

EC200T 4G模组套件

GNSS 模块

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

有可能是电源电流不够，请使用电压为 12V，电流为 2.5A~3A 的电源。

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