安装驱动

下载驱动并安装:

• CH340

• PL2303

• CP210X

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

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

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

安装软件

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

到这里下载 MobaXterm：

1. 选择 session 为 Serial。

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

3. 设置 Speed (bsp) 为 1500000。

4. 点击 OK 按钮。

安装 minicom

注意：Hardware Flow Control 和 Software Flow Control 都要设成 No，否则可能导致无法输入。

设置完成后回到上一菜单，选择 Save setup as dfl 即可保存为默认配置，以后将默认使用该配置。

2.1. 前言

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

2.2. 准备工具

• ROC-RK3506B-CC 开发板

• 固件

• 主机

• 良好的Type-C 数据线

2.3. 准备固件

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

• 单个统一固件

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

• 多个分区镜像

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

2.4. 安装烧写工具

2.5. 进入升级模式

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

2.6. 烧写固件

2.7. 常见问题

3.1. 简介

MaskRom 模式是设备变砖的最后一条防线。强行进入 MaskRom 涉及硬件操作，有一定风险，因此仅在设备进入不了 Loader 模式的情况下，方可尝试 MaskRom 模式。进入 MaskRom 的原理是人为的把 EMMC 的数据脚与地线短接，系统会认为 EMMC 数据出错，从而清除 EMMC 数据。

请小心阅读，并谨慎操作！

操作步骤如下：

先断开电源，然后按住 maskrom 按键（Boot 按键），再上电，几秒后松开 

此时设备就会进入 MaskRom 模式。

1.2.3.1. parameter 分区表

parameter.txt 文件中包含了固件的分区信息，以 parameter-buildroot-emmc-fit.txt 为例：

路径：device/rockchip/rk3506/parameter-buildroot-emmc-fit.txt

FIRMWARE_VER:8.1
MACHINE_MODEL:RK3506
MACHINE_ID:007
MANUFACTURER: RK3506
MAGIC: 0x5041524B
ATAG: 0x00200800
MACHINE: 3506
CHECK_MASK: 0x80
PWR_HLD: 0,0,A,0,1
TYPE: GPT
GROW_ALIGN: 0
CMDLINE:mtdparts=:0x00002000@0x00002000(uboot),0x00000800@0x00004000(misc),0x0000A000@0x00004800(recovery),0x00010000@0x0000E800(boot),0x00010000@0x0001E800(backup),0x00008000@0x0002E800(oem),0x00c00000@0x00036800(rootfs),-@0x00c36800(userdata:grow)
uuid:rootfs=614e0000-0000-4b53-8000-1d28000054a9
uuid:boot=7A3F0000-0000-446A-8000-702F00006273

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

1.2.3.2. package-file

package-file 文件用于打包固件时确定需要的分区镜像和镜像路径，同时它需要与 parameter.txt 文件保持一致。

路径：/path/to/sdk/output/firmware/package-file

1.3.1.1. 搭建编译环境

1.3.2.1. 编译前配置

在 device/rockchip/rk3506/ 目录下，有不同板型的配置文件，选择配置文件：

1.3.2.2. 编译

2.4.1.1. 编译前配置

不同板型的配置文件存放在 /path/to/sdk/device/rockchip/rk3506/ 目录下

回到 SDK 根目录执行build.sh选择配置文件：

2.4.1.2. SDK统一编译与打包

RK3506 支持 Linux 、HAL 、RT-Thread的 AMP 混合架构设计，使得不同的 CPU 可以运行不同的系统，以满足灵活的产品设计需求。该 SDK 目前默认使用 Linux RT-Thread 的混合结构模型，其中运行 Linux 的 CPU 为主核，运行 rtt 的 CPU 为从核；0~1 核心运行 Linux ，2 核心运行 RT-Thread 。

2.4.1.2.1. 编译配置

SDK 的统一编译配置脚本位于 device/rockchip/rk3506/ 目录下，编译配置脚本内容包括 U-Boot、Kernel、HAL、RT-Thread 的配置，以及 AMP 相关的 CPU 分配，内存分配等配置。用户可以根据需求增加或者修改配置脚本文件，以满足自己的编译需求。主要的 AMP 配置文件如下:

注意：kernel 设备树位于 kernel/arch/arm/boot/dts 目录下，它使用的设备树rk3506b-firefly-roc-rk3506b-cc-amp-emmc.dts只适用于2G内存规格。 如果你需要适用于其他内存规格设备，需自行更改它的内存描述标签memory。

AMP 使用到的硬件资源需在内核设备树关闭，并在 rk3506-amp.dtsi 设备树的 rockchip_amp 标签下声明

2.4.1.3.1. 编译 AMP

编译 rt-thread 制作 amp 镜像

2.4.1.3.1.1. 打包 amp 固件

• 打包amp镜像

./build.sh amp

使用 /path/to/sdk/device/rockchip/rk3506/amp_linux.its 配置文件打包出 output/firmware/amp.img

2.4.1.3.1.2. 其他

hal 或 rt-thread 默认使用 uart5 作为调试串口，波特率为 1.5M 。

2.4.1.4. 打包固件

打包固件，生成的完整固件会保存到 output/update/ 目录。

2.4.2.1. parameter 分区表

parameter.txt 文件中包含了固件的分区信息，以 parameter-buildroot-amp-emmc-fit.txt 为例：

路径：device/rockchip/rk3506/parameter-buildroot-amp-emmc-fit.txt

FIRMWARE_VER:8.1
MACHINE_MODEL:RK3506
MACHINE_ID:007
MANUFACTURER: RK3506
MAGIC: 0x5041524B
ATAG: 0x00200800
MACHINE: 3506
CHECK_MASK: 0x80
PWR_HLD: 0,0,A,0,1
TYPE: GPT
GROW_ALIGN: 0
CMDLINE:mtdparts=:0x00002000@0x00002000(uboot),0x00000800@0x00004000(misc),0x0000A000@0x00004800(recovery),0x00010000@0x0000E800(boot),0x00010000@0x0001E800(backup),0x00008000@0x0002E800(oem),0x00002000@0x00036800(amp),0x00c00000@0x00038800(rootfs),-@0x00c36800(userdata:grow)
uuid:rootfs=614e0000-0000-4b53-8000-1d28000054a9
uuid:boot=7A3F0000-0000-446A-8000-702F00006273

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

2.4.2.2. package-file

package-file 文件用于打包固件时确定需要的分区镜像和镜像路径，同时它需要与 parameter.txt 文件保持一致。

路径：output/firmware/package-file

2.4.1.1. 编译前配置

不同板型的配置文件存放在 /path/to/sdk/device/rockchip/rk3506/ 目录下

回到 SDK 根目录执行build.sh选择配置文件：

2.4.1.2. SDK统一编译与打包

RK3506 支持 Linux 、HAL 、RT-Thread的 AMP 混合架构设计，使得不同的 CPU 可以运行不同的系统，以满足灵活的产品设计需求。该 SDK 目前默认使用 Linux RT-Thread 的混合结构模型，其中运行 Linux 的 CPU 为主核，运行 rtt 的 CPU 为从核；0~1 核心运行 Linux ，2 核心运行 RT-Thread 。

2.4.1.2.1. 编译配置

SDK 的统一编译配置脚本位于 device/rockchip/rk3506/ 目录下，编译配置脚本内容包括 U-Boot、Kernel、HAL、RT-Thread 的配置，以及 AMP 相关的 CPU 分配，内存分配等配置。用户可以根据需求增加或者修改配置脚本文件，以满足自己的编译需求。主要的 AMP 配置文件如下:

注意：kernel 设备树位于 kernel/arch/arm/boot/dts 目录下，它使用的设备树rk3506b-firefly-roc-rk3506b-cc-amp-emmc.dts只适用于2G内存规格。 如果你需要适用于其他内存规格设备，需自行更改它的内存描述标签memory。

AMP 使用到的硬件资源需在内核设备树关闭，并在 rk3506-amp.dtsi 设备树的 rockchip_amp 标签下声明

2.4.1.3.1. 编译 AMP

编译 rt-thread 制作 amp 镜像

2.4.1.3.1.1. 打包 amp 固件

• 打包amp镜像

使用 /path/to/sdk/device/rockchip/rk3506/amp_linux.its 配置文件打包出 output/firmware/amp.img

2.4.1.3.1.2. 其他

hal 或 rt-thread 默认使用 uart5 作为调试串口，波特率为 1.5M 。

2.4.1.4. 打包固件

打包固件，生成的完整固件会保存到 output/update/ 目录。

2.4.2.1. parameter 分区表

parameter.txt 文件中包含了固件的分区信息，以 parameter-buildroot-amp-emmc-fit.txt 为例：

路径：device/rockchip/rk3506/parameter-buildroot-amp-emmc-fit.txt

FIRMWARE_VER:8.1
MACHINE_MODEL:RK3506
MACHINE_ID:007
MANUFACTURER: RK3506
MAGIC: 0x5041524B
ATAG: 0x00200800
MACHINE: 3506
CHECK_MASK: 0x80
PWR_HLD: 0,0,A,0,1
TYPE: GPT
GROW_ALIGN: 0
CMDLINE:mtdparts=:0x00002000@0x00002000(uboot),0x00000800@0x00004000(misc),0x0000A000@0x00004800(recovery),0x00010000@0x0000E800(boot),0x00010000@0x0001E800(backup),0x00008000@0x0002E800(oem),0x00002000@0x00036800(amp),0x00c00000@0x00038800(rootfs),-@0x00c36800(userdata:grow)
uuid:rootfs=614e0000-0000-4b53-8000-1d28000054a9
uuid:boot=7A3F0000-0000-446A-8000-702F00006273

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

2.4.2.2. package-file

package-file 文件用于打包固件时确定需要的分区镜像和镜像路径，同时它需要与 parameter.txt 文件保持一致。

路径：output/firmware/package-file

1.1. 简介

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

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

• SAR-ADC(Successive Approximation Register)：支持四个单端输入通道，10位的SAR-ADC，最大转换速率为1MS/s 。

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

1.2. 硬件连接

• 排针上引出的 ADC 接口如下

1.3. DTS配置

1.4. 驱动说明

1.4.1. 获取 AD 通道

1.5. 接口说明

• 功能：获取 iio 通道描述

• 参数：

  • dev: 使用该通道的设备描述指针

  • consumer_channel: 该设备所使用的 IIO 通道描述指针

• 功能：释放 iio_channel_get 函数获取到的通道

• 参数：

  • chan：要被释放的通道描述指针

• 功能：读取 chan 通道 AD 采集的原始数据。

• 参数：

  • chan：要读取的采集通道指针

  • val：存放读取结果的指针

1.6. 调试方法

1.7. FAQs

2.1. CAN 简介

CAN(Controller Area Network)总线，即控制器局域网总线，是一种有效支持分布式控制或实时控制的串行通信网络。CAN总线是一种在汽车上广泛采用的总线协议，被设计作为汽车环境中的微控制器通讯。 如果想了解更多的内容可以参考CAN应用报告

2.2. 硬件连接

注意：排针上的 CAN 只引出了 CAN TX 和 CAN RX 接口，板子上没有内置 CAN 收发器 IC 。所以没有办法直接测试 CAN 接口，需要接入 CAN 收发器模块才能进行 CAN 收发测试。并且默认 CAN 配置是关闭的。需要使用和测试请在对应 dts 文件打开 CAN0 和 CAN1 配置。

• 打开 CAN0 和 CAN1配置

利用 RM_IO 特性，灵活设置了 CAN TX 和 CAN RX 的 GPIO 为以下管脚：

• CAN0

GPIO0_B6 –> can0_tx ; GPIO0_C0 –> can0_rx

• CAN1

GPIO0_C1 –> can1_tx ; GPIO0_C3 –> can1_rx

2.3. DTS 节点配置

• 公共配置 kernel/arch/arm/boot/dts/rk3506.dtsi

• 板级配置 kernel/arch/arm/boot/dts/rk3506b-firefly-roc-rk3506b-cc.dtsi

另外可设置时钟频率 assigned-clock-rates，如果 CAN 的比特率低于等于 3M 建议修改 CAN 时钟到 100M，信号更稳定。高于 3M 比特率的，时钟设置 200M 就可以。

2.4. 通信测试

2.4.1. CAN 通信测试

使用 candump 和 cansend 工具进行收发报文测试即可，Ubuntu 系统可使用 apt update && apt install can-utils 安装。

工具包含在 SDK 中,也可以在 官方 或者 github 下载。

2.6. FAQS

总结调试过程中遇到的几个问题及解决方法：

3.1. ROC-RK3506B-CC 显示接口的配置

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

• kernel/arch/arm/boot/dts/rk3506b-firefly-roc-rk3506b-cc.dts

• kernel/arch/arm/boot/dts/rk3506b-firefly-roc-rk3506b-cc-mipi101-BSD1218-A101KL68.dtsi

3.2. 调试手段

• 获取系统中正在使用的 Video Port（与所连接的显示控制器） 信息

一般如果遇到屏幕无法显示的问题，都需要先执行上面的命令去看一下连接状态和分辨率是否正确。

4.1. dts 配置

5.1. 简介

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

5.2. GPIO引脚计算

ROC-RK3506B-CC 有 4 组 GPIO bank：GPIO0~GPIO3，每组又以 A0~A7, B0~B7, C0~C7, D0~D7 作为编号区分，常用以下公式计算引脚：

下面演示 GPIO0_C2 pin脚计算方法：

bank = 0;      //GPIO0_C2 => 0, bank ∈ [0,4]

group = 2;      //GPIO0_C2 => 2, group ∈ {(A=0), (B=1), (C=2), (D=3)}

X = 2;       //GPIO0_C2 => 2, X ∈ [0,7]

number = group * 8 X = 2 * 8 2 = 18

pin = bank*32 number= 0 * 32 18 = 18;

GPIO0_C2 对应的设备树属性描述为:<&gpio0 18 GPIO_ACTIVE_HIGH>,由kernel/include/dt-bindings/pinctrl/rockchip.h的宏定义可知，也可以将GPIO0_C2 描述为<&gpio0 RK_PC2 GPIO_ACTIVE_HIGH>。

当 GPIO0_C2 脚没有被其它外设复用时，我们可以通过 export 导出该引脚去使用

5.3. 输入输出

5.4. 中断

IRQ_TYPE_EDGE_RISING 表示中断由上升沿触发，当该引脚接收到上升沿信号时可以触发中断函数。 这里还可以配置成如下：

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

调用 gpio_to_irq 把 GPIO 的 PIN 值转换为相应的 IRQ 值，调用 gpio_request 申请占用该 IO 口，调用 request_irq 申请中断，如果失败要调用 free_irq 释放，该函数中 gpio_info-firefly_irq 是要申请的硬件中断号，firefly_gpio_irq 是中断函数，gpio_info->firefly_irq_mode 是中断处理的属性，firefly-gpio 是设备驱动程序名称，gpio_info 是该设备的 device 结构，在注册共享中断时会用到。

5.5. 复用

该案例仅供参考，最终以实际硬件接口为准
GPIO 口除了通用输入输出、中断功能外，还可能有其它复用功能，以GPIO0_C2为例，就有如下几个功能：

查看 /sys/kernel/debug/pinctrl/pinctrl-rockchip-pinctrl/pinmux-pins，查看各个引脚的作用，如果发现 GPIO0_C2 被复用为 SPI0_MISO ，则需要在dts中关闭它。

5.6. 调试方法

5.7. FAQs

root@rk3506-buildroot:/# cat /sys/class/leds/:user/trigger
none rfkill-any rfkill-none kbd-scrolllock kbd-numlock kbd-capslock kbd-kanalock kbd-shiftlock kbd-altgrlock kbd-ctrllock kbd-altlock

7.1. 前言

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

ROC-RK3506B-CC的 PWM 驱动为：kernel/drivers/pwm/pwm-rockchip.c

7.2. DTS配置

配置 PWM 主要有以下三大步骤：配置 PWM DTS 节点、配置 PWM 内核驱动、控制 PWM 设备。

7.3. 接口说明

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

(1)在要使用 PWM 控制的设备驱动文件中包含以下头文件：

该头文件主要包含 PWM 的函数接口。

(2)申请 PWM

使用

7.4. 调试方法

通过内核丰富的 debug 接口查看 PWM 注册状态，adb shell 或者串口进入系统终端执行：

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

7.5. FAQs

8.1. 简介

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

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

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

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

• 内部集成振荡电容

• 漏极开路中断引脚

ROC-RK3506B-CC 需要接入 RTC 电池给 RTC 芯片供电才可以保证在短时间系统断电后 RTC 能正常运行。

8.2. RTC驱动

DTS配置参考: kernel/arch/arm/boot/dts/rk3506b-firefly-roc-rk3506b-cc.dtsi

驱动参考：kernel/drivers/rtc/rtc-hym8563.c

8.3. 接口使用

Linux 提供了三种用户空间调用接口。在 ROC-RK3506B-CC开发板中对应的路径为：

• SYSFS接口：/sys/class/rtc/rtc0/

• PROCFS接口： /proc/driver/rtc

• IOCTL接口： /dev/rtc0

8.4. FAQs

9.1. 硬件

ROC-RK3506B-CC 硬件版本的串口 5 接口图如下：

9.2. DTS配置

UART5 默认没有打开。在文件路径kernel/arch/arm/boot/dts/rk3506b-firefly-roc-rk3506b-cc.dtsi 末尾添加以下内容并且编译内核烧录到板子：

9.3. UART 收发验证

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

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

10.1. 简介

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

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

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

10.2. DTS配置

ROC-RK3506B-CC 有两个 watchdog 。 watchdog 的 DTS 节点在 kernel/arch/arm/boot/dts/rk3502.dtsi 文件中定义，如下所示：

10.3. 使用

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

watchdog 的驱动文件为 kernel/drivers/watchdog/dw_wdt.c。下面介绍两种方法来使用 watchdog：

内部看门狗的设备名称为/dev/watchdog，用户可通过 echo 命令来控制该设备

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

demo说明：

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

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

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

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

10.4. 外部看门狗

ROC-RK3506B-CC 还有 1 个外部看门狗，对应 /dev/wdt_crl

使用方法：

11.1. EarPhone && Speak

EarPhone 和 Speak 均采用双声道接口

• Speak 的接口如下： 

• 

使用 aplay 命令播放 wav 格式音频

11.2. Mic

• Mic 的接口如下：

• Mic 默认是关闭的，使用时需要将其打开，通过以下操作进行