2.1. 选购适配器

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

• CP2104

• PL2303

• CH340

一般来说，采用 CH340 芯片的适配器，性能比较稳定，价格上贵一些。

2.2. 硬件连接

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

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

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

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

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

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

AIO-3288C 串口连接图：

2.3. 串口参数配置

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

• 波特率：115200

• 数据位：8

• 停止位：1

• 奇偶校验：无

• 流控：无

2.4. Windows 上使用串口调试

3.1. 前言

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

3.2. 准备工作

• AIO-3288C 开发板

• 固件

• 主机

• 良好的双公头 USB 数据线

3.3. 固件文件

固件文件一般有两种：

• 单个统一固件

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

• 多个分区镜像

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

3.4. Windows

• 工具: Androidtool_xxx(版本号)

注意：不同固件使用的工具版本可能不同,请根据《烧写须知》下载对应的版本。

3.5. 烧写固件

下载 AndroidTool，解压，运行 AndroidTool_Release_vxx 目录里面的 AndroidTool.exe（注意，如果是 Windows 7/8,需要按鼠标右键，选择以管理员身份运行），如下图：

3.6. Linux

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

• 工具：upgrade_tool_xxx(版本号)

注意:不同固件使用的工具版本可能不同，请根据《烧写须知》下载对应的版本。

4.1. 准备工作

4.2. 烧写 Android 固件须知

烧写 Android 固件时，请仔细阅读表格：

重点说明：在 Windows 下，Linux 升级 Android5.1 时，如何进入 Maskrom 模式：

步骤如下:

1. 用 AndroidTool_v2.58 工具，点击 “擦除flash”，这步的作用是 “擦除IDB”，但无法擦除 flash，因此会出现 “擦除 flash 失败” 的情况。

2. 重启板子，用 AndroidTool_v2.35 工具，点击 “擦除flash”，现在才是真正的 “擦除flash”。

3. 点击 “升级”，开始烧写 Android5.1 固件。

提示：若有用户在使用 AndroidTool_v2.35 工具时，点击 “擦除flash” 和 “升级” 都会出现 “测试设备失败” 的情况下，换 AndroidTool_v2.47 版本工具。

4.3. 烧写 Linux-GPT 固件须知

烧写 Linux-GPT 固件时，请仔细阅读表格：

重点说明：

一、在 Windows 下，Linux-MBR 或 Android5.1 升级 Linux-GPT，如何进入 Maskrom 模式：

步骤如下：

1. 用 AndroidTool_v2.58 工具，点击 “擦除flash”，完成后，设备自动进入 Maskrom 模式。

2. 点击 “升级”，开始烧写 Linux-GPT 固件

二、在 Linux 下，Linux-MBR 或 Android5.1 升级 Linux-GPT，如何进入 Maskrom 模式：

步骤如下：

1.1. 编译环境搭建

本章介绍 Linux SDK 的编译环境搭建。

注意：

（1）推荐在 X86_64 Ubuntu 16.04 系统环境下进行开发，若使用其它系统版本，可能需要对编译环境做相应调整。

（2）使用普通用户进行编译，不要使用 root 用户权限进行编译。

• 方法一（推荐）

Firefly_Linux_SDK 源码包比较大，可以通过如下方式获取 Firefly_Linux_SDK 源码包：下载链接

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

mkdir ~/proj/rk3288_linux_release_v2.5.0a_20230510/
cd ~/proj/rk3288_linux_release_v2.5.0a_20230510/

## 完整 SDK
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 rk3288_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 -u https://gitlab.com/firefly-linux/manifests.git -b master -m rk3288_linux_bsp_release.xml

FIRMWARE_VER: 8.1
MACHINE_MODEL:RK3288
MACHINE_ID:007
MANUFACTURER:RK3288
MAGIC: 0x5041524B
ATAG: 0x00200800
MACHINE: 3288
CHECK_MASK: 0x80
PWR_HLD: 0,0,A,0,1
TYPE: GPT
CMDLINE: mtdparts=rk29xxnand:0x00002000@0x00004000(uboot),0x00002000@0x00006000(trust),0x00002000@0x00008000(misc),0x00010000@0x0000a000(boot),0x00010000@0x0001a000(recovery),0x00010000@0x0002a000(backup),0x00600000@0x0005a000(rootfs),-@0x0065a000(userdata:grow)
uuid:rootfs=614e0000-0000-4b53-8000-1d28000054a9

FIRMWARE_VER: 8.1
MACHINE_MODEL:RK3288
MACHINE_ID:007
MANUFACTURER:RK3288
MAGIC: 0x5041524B
ATAG: 0x00200800
MACHINE: 3288
CHECK_MASK: 0x80
PWR_HLD: 0,0,A,0,1
TYPE: GPT
CMDLINE: mtdparts=rk29xxnand:0x00002000@0x00004000(uboot),0x00002000@0x00006000(trust),0x00002000@0x00008000(misc),0x00010000@0x0000a000(boot),0x00010000@0x0001a000(recovery),0x00010000@0x0002a000(backup),0x00020000@0x0003a000(oem),0x00100000@0x0005a000(rootfs),-@0x0015a000(userdata:grow)
uuid:rootfs=614e0000-0000-4b53-8000-1d28000054a9

1.1. 前言

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

1.2. 准备连接

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

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

打开命令行窗口，输入：

2.1. 准备工作

编译 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 。

3.1. 下载 Android SDK

Android SDK 源码包比较大(约6.3G),可以通过如下方式获取源码包：

• [下载链接]

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

4.1. 前言

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

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

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

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

• package-file

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

• RK3288Loader_uboot_Apr212014_134842.bin

  • 启动加载器，即 bootloader。

• rk3288-3.10-uboot-data1G.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 分区，是以下的定制对象。

1.1. 前言

AIO-3288C 开发板上的 AD 接口分为：高速 ADC 流接口 (High-speed ADC Stream Interface)、温度传感器 (Temperature Sensor)、逐次逼近ADC (Successive Approximation Register)。本文主要介绍 ADC 的基本配置方法。

内核采用工业 I/O 子系统来控制 ADC，该子系统主要为 AD 转换或者 DA 转换的传感器设计。其相关数据结构以及配置方法如下：

1.2. 数据结构

2.1. 简介

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

RK3288 有 9 组 GPIO bank： GPIO0，GPIO1, …, GPIO8。每组又以 A0~A7, B0~B7, C0~C7, D0~D7 作为编号区分（不是所有 bank 都有全部编号，例如 GPIO5 就只有 B0~B7, C0~C3)。

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

• spi0_clk

• ts0_data4

• uart4exp_ctsn

每个 GPIO 口的驱动电流、上下拉和重置后的初始状态都不尽相同，详细情况请参考TRM 文档。

RK3288 的 GPIO 驱动是在以下 pinctrl 文件中实现的：

of_get_named_gpio_flags 从设备树中读取 led-power 的 GPIO 配置编号和标志，gpio_is_valid 判断该 GPIO 编号是否有效，gpio_request 则申请占用该 GPIO。如果初始化过程出错，需要调用 gpio_free 来释放之前申请过且成功的 GPIO 。

调用 gpio_direction_output 就可以设置输出高还是低电平，因为是 GPIO_ACTIVE_LOW ，如果要灯亮，需要写入 0。

实际中如果要读出 GPIO，需要先设置成输入模式，然后再读取值：

2.4. 复用

如何定义 GPIO 有哪些功能可以复用，在运行时又如何切换功能呢？以 I2C4 为例作简单的介绍。

查规格表可知，I2C4_SDA 与 I2C4_SCL 的功能定义如下：

3.1. 前言

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

• 配置 I2C 可分为两大步骤：

  • 定义和注册 I2C 设备

  • 定义和注册 I2C 驱动

下面以配置 lt8641ex 为例。

3.2. 定义和注册 I2C 设备

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

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

注：msgs[0] 是要向从机发送的信息，告诉从机主机要读取信息。msgs[1] 是主机向从机读取到的信息。

至此，主机可以使用函数 i2c_master_reg8_send 和 i2c_master_reg8_recv 和从机进行通讯。

• 实际通讯示例

例如主机和 LT8641EX 通讯，主机向 LT8641EX 发送信息，设置 LT8641EX 使用通道 1：

注：ch用于保存读取到的信息。

4.1. 红外遥控配置

AIO-3288C开发板上可以接红外收发传感器 IR 实现遥控功能。

AIO-3288C的 IR 接线位置如下图红框所示：

本文主要描述在开发板上如何配置红外遥控器。其配置步骤可分为两个部分：

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

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

4.2. 内核驱动

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

注：通过 adb 修改该文件重启后即可生效。

6.1. 板载资源

AIO-3288C 开发板有 MIPI 摄像头接口，摄像头图像处理能力达到 4416x3312 像素，支持 4K 视频录制。此外，开发板还支持 USB 摄像头。

本文以 OV13850 摄像头为例，讲解 MIPI 摄像头在该开发板上的配置过程。

6.2. 相关代码目录

与摄像头相关的代码目录如下：

7.1. 前言

AIO-3288C 开发板上有 4 路 PWM 输出，分别为 PWM0 ~ PWM3，本章主要描述如何配置 PWM。

PWM 驱动文件：

9.1. 简介

AIO-3288C 开发板支持 SPI 桥接/扩展 4个增强功能串口(UART)的功能，分别为 RS232，RS485 和 1个调试串口 UART2。

其中：UART2 为 TTL 电平接口，RS232 为 RS232 电平接口，RS485 为 RS485 电平接口。

注意:RS232 需要使用RS232交叉线才能使用，不然rx和tx会出现收发不成功的问题

9.2. 调试方法

内核已默认打开这个几个串口，硬件接口对应软件上的节点分别为：

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

2.1. 10.1寸LVDS屏幕模组

1.5. 打开 Root 权限

Android 系统有很多很强大的功能都需要用到 root 权限，开发者经常在使用的时候遇到权限的问题。

那如何在 Firefly 平台上开启系统的 root 权限功能呢？Firefly 已在系统添加启动 root 权限的功能，具体的步骤如下：

1. 在 Settgins apk 里面找到 About device 然后点击进去

2. 点击 Build number 7次后会提示(you are now a developer)

3. 然后返回上一级点击 Developer options 选项后，在选项中点击 Enable ROOT 就打开 root 权限功能

1.6. OTG 口无法使用 USB 设备

AIO-3288C 有一个双层 USB 接口，底下的接口为 OTG 接口，使用 ADB 时需要在设置->USB->连接PC打钩，如果使用其他 USB 设备，则需要去掉打钩，不然会导致 USB 设备不能使用。

1. 接口定义