注意事项

AIO-3128C 开发板的调试串口与 TF 卡接口有信号引脚复用，因此无法同时使用，即： 使用调试串口时必须拔掉 TF 卡，而使用 TF 卡时不要连接调试串口。

选购适配器

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

• CP2104

• PL2303

• CH340

硬件连接

串口转 USB 适配器，有四根不同颜色的连接线：

• 红色：3.3V 电源，不需要连接

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

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

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

注：如使用其它串口适配器遇到TX和RX不能输入和输出的问题，可以尝试对调TX和RX的链接线，AIO-3128C串口连接如图所示: 

连接参数

AIO-3128C 使用以下串口参数：

• 波特率：115200

• 数据位：8

• 停止位：1

• 奇偶校验：无

• 流控：无

Windows 上使用串口调试

前言

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

准备工作

• AIO-3128C 开发板

• 固件

• 双公头USB数据线

固件文件一般有两种：

• 单个统一固件 update.img, 将启动加载器、参数和所有分区镜像都打包到一起，用于固件发布。

• 多个分区镜像,如 kernel.img, boot.img, recovery.img 等，在开发阶段生成。

这里可以找到已编译好的统一固件，下载后解压。也可以参考编译固件的说明自行编译。 主机操作系统支持：

• Windows XP （32/64位）

• Windows 7 (32/64位)

• Windows 8 (32/64位)

• Linux (32/64位)

Windows 主机烧录固件

之前烧写 RK 的固件，需要用到以下两种工具：

• 量产工具 RKBatchTool，用于烧写统一固件（update.img）

• 开发者工具 RKDevelopTool，可单独烧写分区固件

后来 RK 发布了 AndroidTool 工具，在 RKDevelopTool 的基础上增加了统一固件（update.img）的烧写支持，因此现在仅需要这个工具即可。

使用烧写工具前需要安装 RK USB 驱动。如果驱动已经安装好，可以跳过这步。

Linux 主机烧录固件

RK 提供了一个 Linux 下的命令行工具 upgrade_tool，支持统一固件 update.img 和分区镜像的烧写。

开源工具则有两个选择:

• rkflashtool https://github.com/Galland/rkflashtool_rk3066

• rkflashkit https://github.com/linuxerwang/rkflashkit

它们都仅支持分区映像烧写，不支持统一固件。rkflashtool 是命令行工具，rkflashkit 有图形界面，后加了命令行支持，更是好用。以下仅对 rkflashkit 做介绍。

Linux 下无须安装设备驱动，参照 Windows 章节连接设备则可。

前言

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

准备连接

在开发板上进入选项->开发人员选项，勾上 “USB 调试” 选项。用双公头USB数据线连接设备和主机。

Windows下的 ADB 安装

首先参照安装 RK USB 驱动一节安装好驱动。然后到 http://adbshell.com/download/download-adb-for-

准备工作

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

• 64 位 CPU

• 16GB 物理内存 交换内存

• 30GB 空闲的磁盘空间用于构建，源码树另外占用大约 25GB

官方推荐 Ubuntu 14.04 操作系统，经测试，Ubuntu 12.04 也可以编译运行成功，只需要满足 http://source.android.com/source/building.html 里的软硬件配置即可。编译环境的初始化可参考 http://source.android.com/source/initializing.html 。

• 下载链接

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

默认的目标构建变体(TARGET_BUILD_VARIANT)为 userdebug。常用变体有三种，分别是用户(user)、用户调试(userdebug)和工程模式(eng)，其区别如下：

• user

  • 仅安装标签为 user 的模块

  • 设定属性 ro.secure=1，打开安全检查功能

  • 设定属性 ro.debuggable=0，关闭应用调试功能

  • 默认关闭 adb 功能

  • 打开 Proguard 混淆器

  • 打开 DEXPREOPT 预先编译优化

• userdebug

  • 安装标签为 user、debug 的模块

  • 设定属性 ro.secure=1，打开安全检查功能

  • 设定属性 ro.debuggable=1，启用应用调试功能

  • 默认打开 adb 功能

  • 打开 Proguard 混淆器

  • 打开 DEXPREOPT 预先编译优化

• eng

  • 安装标签为 user、debug、eng 的模块

  • 设定属性 ro.secure=0，关闭安全检查功能

  • 设定属性 ro.debuggable=1，启用应用调试功能

  • 设定属性 ro.kernel.android.checkjni=1，启用 JNI 调用检查

  • 默认打开 adb 功能

  • 关闭 Proguard 混淆器

  • 关闭 DEXPREOPT 预先编译优化

如果目标构建变体为 user，则 adb 无法获取 root 权限。要选择目标构建变体，可以在 make 命令行加入参数，例如：

请参照 如何升级固件 一文来烧写分区映像文件。如果使用的是 Windows 系统，将上述映像文件拷贝到 AndroidTool （Windows 下的固件升级工具）的 rockdevImage 目录中，之后参照升级文档烧写分区映像即可，这样的好处是使用默认配置即可，不用修改文件的路径。

前言

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

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

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

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

固件格式

统一固件 release_update.img，内含启动加载器 loader.img 和真正的固件数据 update.img

• package-file

• update.img 的打包说明文件，update.img 里也含有一份 package-file。

• rk3128MiniLoaderAll(L)_V2.20.bin, Image/uboot.img

• 启动加载器，即 bootloader。

• rk312x.parameter.txt

• 参数文件，可以设定内核启动参数，里面有重要的分区信息。

• Image/misc.img

• misc 分区的映像，用来控制 Android 是正常启动，还是进入急救模式（Recovery Mode）。

• Image/kernel.img

• Android 内核。

• Image/resource.img

• 资源映像，内有内核开机图片和内核设备树信息（Device Tree Blob)。

• Image/boot.img

• Android 内核的内存启动盘（initrd)，是内核启动后最先加载的根文件系统，包含重要的初始化动作，一般不需要改动。

• Image/recovery.img

• Android 急救模式的映像，内含内核和急救模式的根文件系统。

• Image/system.img

• 对应于 Android 的 /system 分区，是以下的定制对象。

解包，就是提取 release_update.img 里的 update.img, 然后解压出内含 package-file 所声明的多个文件。打包，则是个逆过程，将 package-file 将所列的多个文件合成 update.img，加进 loader.img，最终生成 release_update.img 。

硬件资料

• 正面视图

• 背面视图

前言

AIO-3128C 开发板有一个 3 通道（0/1/2)、10 比特精度的 SAR ADC (Successive Approximation Register，逐次逼近寄存器)，其中：

• ADCIN0: 引到RECOVER位置，如下图片红框位置

• ADCIN1: 内部作 Recovery 键检测

• ADCIN2: 未引出来

本文主要介绍 ADC 的基本使用方法。

配置DTS节点

AIO-3128C ADC 的 DTS 节点在 kernel/arch/arm/boot/dts/rk312x.dtsi 文件中定义，如下所示：

简介

GPIO, 全称 General-Purpose Input/Output（通用输入输出），是一种软件运行期间能够动态配置和控制的通用引脚。

AIO-3128C 有 4 组 GPIO bank： GPIO0，GPIO1, GPIO2, GPIO3。每组又以 A0~A7, B0~B7, C0~C7, D0~D7 作为编号区分。

每个 GPIO 口除了通用输入输出功能外，还可能有其它复用功能，例如 GPIO1_C2，可以复用成以下功能之一：

• GPIO1_C2

• SDMMC0_D0

• UART2_TX

每个 GPIO 口的驱动电流、上下拉和重置后的初始状态都不尽相同，详细情况请参考《RK3128 规格书》中的 “RK3128 function IO description” 一章。

AIO-3128C 的 GPIO 驱动是在以下 pinctrl 文件中实现的：

前言

AIO-3128C 开发板上有 4 个片上 I2C 控制器。本文主要描述如何在该开发板上配置 I2C。

配置 I2C 可分为两大步骤：

• 定义和注册 I2C 设备

• 定义和注册 I2C 驱动

下面以配置 lt8641ex 为例。

定义和注册 I2C 设备

在注册I2C设备时，需要结构体 i2c_client 来描述 I2C 设备。然而在标准Linux中，用户只需要提供相应的 I2C 设备信息，Linux就会根据所提供的信息构造 i2c_client 结构体。

用户所提供的 I2C 设备信息以节点的形式写到 dts 文件中，如下所示：

定义和注册 I2C 驱动

static const struct of_device_id of_rk_lt8641ex_match[] = { { .compatible = "firefly,lt8641ex" },{ /* Sentinel */ }};

前言

AIO-3128C 开发板上有 2 个 LED 灯，如下表所示：

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

以设备的方式控制 LED

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

用户可以通过 /sys/class/leds/ 目录控制这两个 LED。

更详细的说明请参考 leds-class.txt 。

开发板上的 LED 的默认状态为：

• Blue: 系统上电时打开

• Yellow：用户自定义

用户可以通过 echo 向其 trigger 属性输入命令控制每一个 LED：

Config配置

在arch/arm/configs/fireprime_defconfig添加配置：

驱动配置

前言

AIO-3128C 开发板上有 4 路 PWM 输出，分别为 PWM0 ~ PWM3，其中：

• PWM0/GPIO0_D2: 在扩展口中引出

• PWM1/GPIO0_D3: 内部用作 AUX_DET 信号

• PWM2/GPIO0_D4: 内部用作 RTC_INT 信号

本章主要描述如何配置 PWM。 AIO-3128C 的 PWM 驱动为：

配置步骤

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

配置 PWM DTS节点

在 kernel/arch/arm/boot/dts/rk312x.dtsi 定义了以下 PWM 节点，如下所示：

pwm0: pwm@20050000 {compatible = "rockchip,rk-pwm";reg = <0x20050000 0x10>;#pwm-cells = <2>;pinctrl-names = "default";pinctrl-0 = <&pwm0_pin>;clocks = <&clk_gates7 10>;clock-names = "pclk_pwm";status = "disabled";}; 
pwm1: pwm@20050010 {compatible = "rockchip,rk-pwm";reg = <0x20050010 0x10>;#pwm-cells = <2>;pinctrl-names = "default";pinctrl-0 = <&pwm1_pin>;clocks = <&clk_gates7 10>;clock-names = "pclk_pwm";status = "disabled";}; 
pwm2: pwm@20050020 {compatible = "rockchip,rk-pwm";reg = <0x20050020 0x10>;#pwm-cells = <2>;pinctrl-names = "default";pinctrl-0 = <&pwm2_pin>;clocks = <&clk_gates7 10>;clock-names = "pclk_pwm";status = "disabled";}; 
pwm3: pwm@20050030 {compatible = "rockchip,rk-pwm";reg = <0x20050030 0x10>;#pwm-cells = <2>;pinctrl-names = "default";pinctrl-0 = <&pwm3_pin>;clocks = <&clk_gates7 10>;clock-names = "pclk_pwm";status = "disabled";}; 
remotectl: pwm@20050030 {compatible = "rockchip,remotectl-pwm";reg = <0x20050030 0x10>;#pwm-cells = <2>;pinctrl-names = "default";pinctrl-0 = <&pwm3_pin>;clocks = <&clk_gates7 10>;clock-names = "pclk_pwm";remote_pwm_id = <3>;interrupts = ;status = "okay";};

要使用 pwm0, 只需在 kernel/arch/arm/boot/dts/aio-3128c.dts 加入：

• 功能：禁止 pwm

• 参数：

  • pwm：要禁止的 pwm

SPI工作方式

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

板载资源介绍

AIO-3128C 开发板内置 3 路 UART，分别为 uart0，uart1，uart2。

uart0 用于蓝牙数据传输，如果要使用 uart0，必须关掉蓝牙，才可以使用扩展槽上的 UART0 针脚。

uart1, 因为存在以下复用：

• SPI_TXD/UART1_TX

• SPI_RXD/UART1_RX

• SPI_CSN0/UART1_RTS

AIO-3128C 使用SPI桥接/扩展4个增强功能串口(UART)的功能，分别为UART1，RS232(上)，RS232(下),RS485功能,其中RS232(下)口硬件可做修改为TTL功能。 每个UART都拥有256字节的FIFO缓冲区，用于数据接收和发送。 

uart2 一般用做调试串口，但同样存在复用，也就是说 TF 卡与调试串口不可以同时使用：

• SDMMC_D0/UART2_TX

• SDMMC_D1/UART2_RX

uart2 有 32 字节的 FIFO 收发缓冲区，uart0 则要有双 64 字节的 FIFO 用作蓝牙数据收发。所有 uart 均支持 5 位、6 位、7 位、8 位数据收发和 DMA 操作。

配置 DTS 节点

文件 kernel/arch/arm/boot/dts/aio-3128c.dtsi 中已经有 spi转uart 相关节点定义，如下所示：

屏幕模组