Difference between revisions of "SOM-RK3399/zh"

Revision as of 09:23, 26 October 2023

English

1 简介

Front

Back

Overview

• SOM-RK3399是友善电子团队设计的一款266-pin金手指形式高性能ARM计算机模块，它采用了瑞芯微64位六核SoC RK3399作为主处理器，标配2GB DDR3内存和16GB闪存，板载2x2 MIMO双天线WiFi模组，尺寸只有69.6x50mm，模块上带有独立的TypeC供电接口，以及USB-C显示接口，无需底板也可以单独使用。

• SOM-RK3399计算模块具有丰富的外设和扩展接口，通过底板可连接使用4通道NVMe高速固态硬盘，读写速度高达1GB/s; 它还可以扩展使用双MIPI宽动态摄像头，另外它还带有eDP显示接口，MIPI显示接口, 1路USB3.0, 2路USB2.0, 以及I2C, I2S, SPI, PWM, GPIO和串口等各种资源。

• SOM-RK3399可流畅运行Android 8.1, Ubuntu 18.04, Armbian, Buildroot等主流嵌入式操作系统, 软件资源和生态非常丰富，尤其是Android 8.1具有NN SDK神经网络加速软件包, Qt-5.10集成了VPU硬件编解码, GPU图形加速，可使用QML快速开发流畅的动态式界面，因此SOM-RK3399核心板非常适合中小型企业和初创公司做高端人脸识别，机器视觉，VR虚拟现实，自动驾驶，深度计算分析等方面的人工智能产品快速原型及产品开发。

2 硬件特性

• 主控芯片: Rockchip RK3399
  • CPU: big.LITTLE大小核架构，双Cortex-A72大核(up to 2.0GHz)+四Cortex-A53小核结构(up to 1.5GHz)
  • GPU: Mali-T864 GPU，支持OpenGL ES1.1/2.0/3.0/3.1, OpenCL, DX11, 支持AFBC（帧缓冲压缩）
  • VPU: 支持4K VP9 and 4K 10bits H265/H264 视频解码，高达60fps, 双VOP显示等视频编解码功能
• 电源管理单元: RK808-D PMIC, 搭配独立DC/DC, 支持动态调压, 软件关机, 按键开机, RTC唤醒, 睡眠唤醒等功能
• 内存: 双通道2GB DDR3
• Flash: 标配16GB eMMC 5.1闪存，可定制选配32GB/64GB
• 有线网络: 集成千兆以太网PHY
• Wi-Fi/蓝牙: 802.11a/b/g/n/ac, Bluetooth 4.1 双频Wi-Fi蓝牙模块, 2x2 MIMO, 双天线接口
• 视频输入: 1个或2个4线MIPI-CSI, 双ISP像素处理能力高达13MPix/s，支持双路摄像头数据同时输入
• 视频输出
  • HDMI: HDMI 2.0a, 支持4K@60Hz显示，支持HDCP 1.4/2.2
  • DP on Type-C: DisplayPort 1.2 Alt Mode on USB Type-C
  • LCD Interface: 一个eDP 1.3（4 线，10.8Gbps）, 一个或2个4线MIPI-DSI
• USB
  • USB 2.0: 2个独立的原生USB 2.0 Host
  • USB 3.0: 1个原生USB 3.0 Host
  • USB Type-C: 支持USB3.0 Type-C 和 DisplayPort 1.2 Alt Mode on USB Type-C
• PCIe: PCIe x4, compatible with PCIe 2.1, Dual operation mode
• SDIO/MMC: 一路SDIO/MMC， 用来扩展SD卡
• 调试串口: 一路调试串口 UART, 3V level, 1500000bps
• 按键: PowerKey, Reset, Recovery 各一个
• LED指示灯: 一个电源LED ，一个GPIO控制的状态LED
• 其它资源
  • 2 X 1.8V I2C, 1 x 3V I2C
  • 1 x 3V UART/SPI
  • 2 x PWM
  • 1 x IR-RX
  • 1 x SPDIF_TX
  • 1 x 1.8V 8ch-I2S,
  • 6 x 1.8V GPIO, 8 x 3V GPIO
  • 3 x 1.8V ADC inputs
• 供电: DC12V/1A（金手指）， Type-C：DC5V/2.5A（Type-C）
• PCB: 8层沉金工艺, 50 mm x 69.6 mm x 1.2mm, 260 Pin金手指接口
• 环境工作温度: -20℃ to 70℃

3 布局和引脚定义

• 260 Pin 金手指定义
  • 匹配的卡槽型号：0.5mm Pitch 260-Pin Standard Type DDR4 SODIMM Socket， 参考型号：https://www.te.com/usa-en/product-2309409-5.html

• 按键
  • 三个按键分别是电源按键, 系统还原和复位。此3个按键相应的信号也存在于260Pin金手指上。

• LED
  • 一个红色的电源LED和一个绿色的状态LED

• USB Type-C接口
  • 一个全功能USB-C接口，支持DP，支持USB2.0和USB3.0数据传输，可向外输出5V/2A电源，但不可外接电源给板子供电。支持DRP和安卓ADB调试。因为USB3.0模式下不支持ADB，所以，当使用ADB功能时，请连接到PC的USB2.0端口，或使用只具备USB2.0功能的数据线连接板子和PC。
  • 另外一个USB Type-C 5V_IN接口只有给板子供电的功能，用于不接底板快速测试板子。

• 电源输入
  • 支持从金手指和USB Type-C 5V_IN接口给核心板供电，支持5V到20V宽电压输入，推荐12V。我们运行安兔兔测试程序时，测量到的最大功耗是10.8W， 建议按12W设计。
  • 设计底板时，建议在电源输入处添加100uF/16V,或100uF/35V电解电容， 以减少电源振铃和提供瞬态电流。

4 参考底板

• SOM-RK3399 Dev Kit 点击跳转到底板介绍页面

5 快速入门

5.1 准备工作

要开启你的SOM-RK3399，请先准备好以下硬件:

• SOM-RK3399主板
• Type-C数据线
• TF卡: Class10或以上的8GB microSD卡
• USB转串口适配器(可选，用于调试或PC上进行操作)
• 一个DC接口的外接电源，要求输出为12V/2A
• 一台支持HDMI输入的显示器或者电视（或选购LCD配件）
• 一套USB键盘鼠标，同时连接更多USB的设备时还需要USB HUB
• 一台电脑，需要联网，建议使用Ubuntu 18.04 64位系统

5.2 安装系统

5.2.1 下载固件

5.2.1.1 官方固件

访问此处的下载地址下载固件文件 (位于网盘的"01_系统固件"目录)：
下表列出了所有官方固件，文件名中的XYZ代表文件的不同用途，其含义如下:

• sd: 安装系统到TF卡时使用
• eflasher: 需要通过TF卡烧写系统到eMMC时使用
• usb: USB线刷时使用

图标	文件名	版本	描述	内核版本
	rk3399-XYZ-android10-YYYYMMDD.img.zip	10	Android 10	4.4.y
	rk3399-XYZ-android8-YYYYMMDD.img.zip	8.1	Android 8.1	4.4.y
	rk3399-XYZ-android7-YYYYMMDD.img.zip	7.1.2	Android 7.1.2	4.4.y
	rk3399-XYZ-debian-bullseye-minimal-4.19-arm64-YYYYMMDD.img.gz	bullseye	Debian11 系统固件，LXDE桌面, 不预装推荐软件包, 支持GPU/VPU硬件加速	4.19.y
	rk3399-XYZ-debian-bullseye-desktop-4.19-arm64-YYYYMMDD.img.gz	bullseye	Debian11 完整版固件，LXDE桌面, 预装推荐软件包, 支持GPU/VPU硬件加速	4.19.y
	rk3399-XYZ-debian-bookworm-core-4.19-arm64-YYYYMMDD.img.gz	bookworm	Debian12 精简版固件，没有桌面, 仅命令行	4.19.y
	rk3399-XYZ-ubuntu-focal-desktop-4.19-arm64-YYYYMMDD.img.gz	focal	Ubuntu 20.04固件, LXQT桌面，支持GPU/VPU硬件加速	4.19.y
	rk3399-XYZ-friendlydesktop-bionic-4.4-arm64-YYYYMMDD.img.zip	bionic	64位FriendlyDesktop桌面固件（内置Qt 5.10.0, X-Window)，基于Ubuntu Desktop 18.04构建	4.4.y
	rk3399-XYZ-friendlycore-focal-4.19-arm64-YYYYMMDD.img.gz	focal	64位FriendlyCore系统固件 (内置Qt 5.10.0)，基于Ubuntu core 20.04构建	4.19.y
	rk3399-XYZ-friendlycore-bionic-4.4-arm64-YYYYMMDD.img.gz	bionic	64位FriendlyCore系统固件 (内置Qt 5.10.0)，基于Ubuntu core 18.04构建	4.4.y
	rk3399-XYZ-lubuntu-desktop-xenial-4.4-armhf-YYYYMMDD.img.zip	xenial	Lubuntu桌面版固件（内置Qt 5.10.0, X-Window)	4.4.y
	rk3399-XYZ-ubuntu-noble-core-4.19-arm64-YYYYMMDD.img.gz	noble	精简版64位Ubuntu系统固件，基于Ubuntu core 24.04构建	4.19.y
	rk3399-XYZ-openmediavault-6.1-YYYYMMDD.img.gz	Shaitan	OpenMediaVault NAS系统，基于Debian12构建	6.1.y
	rk3399-XYZ-buildroot-4.19-arm64-YYYYMMDD.img.gz	--	Buildroot 固件，基于Rockchip Linux SDK，带Qt5-wayland图形界面	4.19.y
	rk3399-XYZ-friendlywrt-21.02-YYYYMMDD.img.gz	21.02	FriendlyWrt, 基于OpenWrt 21.02	6.1.y
	rk3399-XYZ-friendlywrt-21.02-docker-YYYYMMDD.img.gz	21.02	预装了Docker的FriendlyWrt, 基于OpenWrt 21.02	6.1.y
	rk3399-XYZ-friendlywrt-23.05-YYYYMMDD.img.gz	23.05	FriendlyWrt, 基于OpenWrt 23.05	6.1.y
	rk3399-XYZ-friendlywrt-23.05-docker-YYYYMMDD.img.gz	23.05	预装了Docker的FriendlyWrt, 基于OpenWrt 23.05	6.1.y
Other Image
	Github Actions - FriendlyWrt云编译版本	21.02,23.05	FriendlyWrt	6.1.y
	rk3399-XYZ-multiple-os-YYYYMMDD-25g.img.gz	-	内含了多个操作系统的eMMC烧写文件，方便测试各个OS，此固件不会开机自动烧写，需要手动选择要烧写的OS

5.2.1.2 工具软件(可选)

访问 此处的下载链接 下载所需要的工具软件 (位于网盘的"05_工具软件"目录).

5.2.2 通过TF卡运行系统

操作步骤如下：

• 准备一张8G或以上容量的TF卡;
• 访问此处的下载地址下载需要的固件(位于"01_系统固件/01_SD卡固件"目录);
• 下载烧写工具 win32diskimager (位于"05_工具软件"目录)，或者选用你喜爱的工具;
• 解压 .gz 格式的压缩文件得到 .img 格式的镜像文件;
• 在Windows下以管理员身份运行 win32diskimager，在界面上选择你的SD卡盘符，选择解压后的固件文件，点击 Write 按钮烧写到SD卡;
• 将SD卡从电脑端弹出，插入SOM-RK3399的microSD卡槽;
• 连接SOM-RK3399的电源，系统会从TF卡启动, 某些型号可能需要按下Power键才会启动;

5.2.3 烧写系统到eMMC

5.2.3.1 方法1: 用TF启动卡进行自动烧写

此方法是通过SD卡启动一个小型的Linux系统, 借助名为EFlasher的工具来烧写固件到eMMC。

如果有连接HDMI显示器, 可通过图形界面观察烧写进度, 也可以通过板载LED灯来掌握烧写进度:

默认情况下烧写是上电自动开始的，所以要注意备份eMMC里的数据，如果不想自动，可以使用文件名含"multiple-os"字样的固件，在界面上手动选择要烧写的系统。

5.2.3.1.1 烧写官方固件到eMMC

详细操作步骤如下：

• 准备一张8G或以上容量的SDHC卡;
• 访问此处的下载地址下载需要的固件(位于"01_系统固件/02_SD卡刷机固件(SD-to-eMMC)"目录)和烧写工具win32diskimager(位于"05_工具软件"目录);
• 解压 .gz 格式的压缩文件得到 .img 格式的镜像文件;
• 在Windows下以管理员身份运行 win32diskimager，在界面上选择你的SD卡盘符，选择解压后的固件文件，点击 Write 按钮烧写到SD卡;
• 将SD卡从电脑端弹出，插入SOM-RK3399的microSD卡槽;
• 连接SOM-RK3399的电源，系统会从SD卡启动，并自动启动 EFlasher 烧写工具将系统安装到 eMMC;
• 烧写完成后，从SOM-RK3399弹出SD卡，SOM-RK3399会自动重启并从eMMC启动你刚刚烧写的系统;

5.2.3.1.2 烧写第三方固件(镜像文件)到eMMC

1) 从网盘上下载文件名带 eflasher 字样的任意固件(位于"01_系统固件/02_SD卡刷机固件(SD-to-eMMC)"目录), 解压后烧进TF卡;
2) 重新拨插一次TF卡, PC上会出现一个名为FriendlyARM的盘符(Linux下是FriendlyARM目录), 将 .raw 或者 .gz 结尾的固件复制进去 (注：如果你的文件为 .img 格式那么请改名为 .raw 格式);
3) 编辑TF卡上的 eflasher.conf 配置文件, 修改 autoStart= 后面的值指定为你的固件文件名, 例如:

autoStart=openwrt-rockchip-armv8_nanopi-ext4-sysupgrade.img.gz

除了第三方固件，亦支持文件名带 "-sd-" 字样的官方固件文件, 例如: rk3NNN-sd-friendlywrt-21.02-YYYYMMDD.img.gz
4) 安全弹出TF卡, 将TF卡放在SOM-RK3399上上电启动, 会自动烧写你的固件, 通过板载 LED 灯来了解安装进度;

5.2.3.2 方法2: 在网页上烧写

使用烧写了FriendlyWrt固件的TF卡启动SOM-RK3399, 登录FriendlyWrt页面, 在网页菜单上点击 "系统" -> "eMMC刷机助手" 进入eMMC刷机助手界面, 点击界面上的 "选择文件" 按钮, 选择你要刷写的文件 (官方固件选用文件名有"-sd-"的文件), 亦可选择第三方固件, 文件支持 .gz 格式的压缩文件, 或者以 .img 作为扩展名的raw格式。

选择文件后, 点击 “上传并烧写” 按钮, 开始上传并烧写, 如下图所示:

烧写完成后,请弹出SD卡,设备会自动重启, 并从eMMC引导新系统，可留意指示灯的状态, 在系统状态灯闪烁，同时网卡状态灯亮起时，表示系统启动完成, 如果eMMC安装的系统是 FriendlyWrt, 则可以通过点击“进入首页”进入FriendlyWrt管理页面。
官方固件需要选用文件名带 "-sd-" 字样的镜像文件, 例如: rk3NNN-sd-friendlywrt-21.02-YYYYMMDD.img.gz, 压缩文件只支持gz格式, 如果文件太大, 可以先压缩成gz格式再上传。

5.2.3.3 方法3: 通过USB烧写

5.2.3.3.1 USB烧写步骤1: 安装USB驱动和工具

从网盘的tools目录下载瑞芯微的USB驱动: DriverAssitant_v5.12.zip, 解压后安装;
在相同目录下, 下载瑞芯微开发工具: RKDevTool_Release_v2.84.zip, 解压后备用;

5.2.3.3.2 USB烧写步骤2: 将SOM-RK3399与电脑连接, 并进入刷机模式

按住Recover Key按键不放, 用USB C数据线, 将SOM-RK3399与电脑进行连接, 连接到SOM-RK3399的USB C接口, 保持按住Recover Key键, 状态灯亮起3秒后即可松开;

5.2.3.3.3 USB烧写步骤3: 开始烧写

固件格式一般有两种格式, 一种是单个的image文件, 通常第三方固件会使用这种打包方式, 另一种是多个分区镜像, FriendlyELEC的固件采用这种方式, 下面分别对这两种格式的固件进行说明:

• 选项1: 烧写打包成单个image文件的固件
  

在电脑上双击 RKDevTool_Release_v2.84 目录下的 RKDevTool.exe 启动瑞芯微开发工具, 与电脑连接正常的情况下, 瑞芯微开发工具界面上会显示 "发现一个Maskrom设备";
在瑞芯微开发工具界面上, 点击 “升级固件”, 再点击 “固件” 按钮, 选择你要烧写的image文件, 点击 “升级” 然后等待烧写完成即可, 完成后设备会自动重启, 并从eMMC启动你刚刚安装的系统;

• 选项2: 烧写由多个分区镜像组成的固件
  

根据需要到网盘上下载对应的压缩包(位于"01_系统固件/03_USB线刷固件(USB-to-eMMC)"目录), 在电脑上解压: 解压后, 可以看到固件目录下已内置了瑞芯微开发工具和预设好的配置文件, 双击 RKDevTool.exe 启动瑞芯微开发工具, 界面上会显示 "发现一个Maskrom设备", 点击界面上的“执行”按钮, 稍等片刻即可完成烧写, 完成后设备会自动重启, 并从eMMC启动你安装的系统;

5.3 eMMC与TF卡的启动优先级说明 (救砖办法)

默认情况下, 会优先从 TF卡启动系统, 但并不是所有条件下都是这样, 本节内容将详细说明所有情况;

引用Rockchip官方文档[1]的描述，系统引导程序(Loader)分为以下2种:
1) U-Boot TPL/SPL (即upsream U-Boot, 也叫主线U-Boot)
2) Rockchip MiniLoader

需要留意的是:
1) FriendlyELEC发布的所有Rom均采用的都是第2种，即Rockchip MiniLoader
2) 第三方固件通常采用的是第1种, 即 U-Boot TPL/SPL

以下情况将总是从 eMMC 启动 (意味着无法通过TF卡烧写系统了):
1) 如果eMMC里的系统, 或者TF卡里的系统是采用第一种Loader类型U-Boot TPL/SPL的, 上电将总是从 eMMC启动;
2) eMMC内的系统并没有适配SOM-RK3399, 也就是说Loader压根就是坏的;

这时, 可以用如下方法让SOM-RK3399从TF卡启动系统, 进行系统重装或Flash擦除:
1) 插入一张烧写有FriendlyWrt系统的TF卡 (制作方法请参考上面的章节);
2) 按下Maskrom按键, 并上电开机 (或短接Maskrom触点);
3) 重要: 上电后默数4秒左右立即松开Maskrom按键;
4) SOM-RK3399将会从TF卡启动FriendlyWrt系统;
5) 用网线连接电脑到SOM-RK3399的LAN网口, 在电脑上输入网址 http://192.168.2.1 进入FriendlyWrt管理页面, 使用系统菜单中的eMMC刷机工具重新烧写系统到 eMMC;
6) 如果你仅仅想清除eMMC上的数据, 可以上传一个内容全是零的img文件刷进eMMC, 该文件在电脑上可以用如下命令生成, 因eMMC刷机工具在烧写系统时会先对eMMC进行全面擦除, 所以img文件的大小是不重要的:

dd if=/dev/zero of=~/empty.img bs=8M count=1

或者, 进入命令终端, 输入以下命令尝试清除eMMC上的 Loader:

dd if=/dev/zero of=/dev/mmcblk2 bs=8M count=25

常见问题:
如果用TF卡启动系统后,发现系统检测不到eMMC,可能的原因是上电后按下Markrom键太长时间, 正确方法是按住4秒立即松开;
请确认你使用了最新固件(日期2022-07-25之后的固件), 然后重新操作一次;

总结如下:

5.4 串口调试

如果你想查看SOM-RK3399启动时更多详细的信息，或者更直接的对其进行控制，建议连接并使用调试串口。

• 使用准备好的USB转串口适配器和连接线(需另购)，连接开发板:

Pin#	开发板调试串口	USB转串口适配器
1	GND	GND
2	VCC5V0_SYS	NC (不需要连接) 注: Matrix USB2UART适配器，请将5V ON/OFF切换到OFF
3	UART2DBG_TX	RX
4	UART2DBG_RX	TX

• 将USB转串口适配器连接到PC Linux，通常会识别为ttyUSB0，或使用以下命令来确定设备名字:

 dmesg | grep ttyUSB
 ls -l /dev/ttyUSB*

• 在PC Linux安装minicom，运行minicom，配置串口设备和参数(1500000 Bps, 8N1, 流控无)

 sudo apt-get install minicom
 minicom -s

注意: RK3399调试串口的波特率缺省是1500000，有些适配器可能达不到此速率，还有可能因USB延长线或连接到USB hub出现异常(如乱码)，需检查并更换。

6 Debian11 桌面系统的使用

6.1 Debian11桌面系统简介

Debian11 Desktop 是一个轻量级的Debian桌面环境，具有如下特点：

• 桌面环境采用 LXDE, 多种主题可选, 简洁美观, 占用资源少;
  
• 提供基于 Mali GPU 的 OpenGL 支持;
  
• 支持Rockhip MPP视频硬编和硬解码;
  
• 预装基于mpv的Kodi, SMPlayer播放器, 均支持4K视频硬解码;
  
• 预装Chromium浏览器, 支持vpu/gpu硬件加速 (视频硬解限h264/mp4格式);
  
• 支持安装Plex Server, Docker与wps等应用, 玩法丰富;
  

6.2 帐户与密码

普通用户：
    用户名: pi
    密码: pi

Root用户：
    默认没有设置root密码，可通过sudo passwd root命令配置root密码

6.3 查看IP地址

由于Debian主机名默认为硬件型号, 所以可以使用ping命令来获得IP地址: ping SOM-RK3399

6.4 通过ssh登录Debian

使用以下命令:ssh pi@SOM-RK3399
默认密码为pi

6.5 更新软件包

6.5.1 更换软件源为国内镜像源

sudo sed -i -e 's/deb.debian.org/mirrors.cloud.tencent.com/g' /etc/apt/sources.list
sudo sed -i -e 's/security.debian.org/mirrors.cloud.tencent.com/g' /etc/apt/sources.list
sudo apt update

6.6 安装x11vnc远程桌面

x11vnc是一个VNC服务器, 安装后我们可以不依赖外部的显示设备, 通过网络远程登录Debian桌面。

6.6.1 安装x11vnc

sudo apt-get install x11vnc

6.6.2 设置VNC登录密码

sudo x11vnc -storepasswd /etc/x11vnc.pwd

6.6.3 设置x11vnc在开机时自动启动

新建如下文件:

sudo vi /lib/systemd/system/x11vnc.service

内容如下:

[Unit]
Description=Start x11vnc at startup.
Requires=display-manager.service
After=syslog.target network-online.target
Wants=syslog.target network-online.target
 
[Service]
Type=simple
ExecStart=/usr/bin/x11vnc -display :0 -forever -loop -noxdamage -repeat -rfbauth /etc/x11vnc.pwd -rfbport 5900 -shared -capslock -nomodtweak
ExecStop=/usr/bin/x11vnc -R stop
Restart=on-failure
 
[Install]
WantedBy=multi-user.target

设置systemd服务:

sudo systemctl daemon-reload
sudo systemctl enable x11vnc.service
sudo systemctl start x11vnc

6.6.4 测试远程桌面

在电脑上启动VNC客户端软件, 在地址栏输入: IP地址:5900 连接即可, 效果如下图所示, 图中设备IP地址为192.168.1.123, 使用端口5900进行连接:

6.7 安装内核头文件

sudo dpkg -i /opt/linux-headers-*.deb

测试编译内核模块:

sudo apt update
sudo apt install git gcc make bc
git clone https://github.com/RinCat/RTL88x2BU-Linux-Driver.git
cd RTL88x2BU-Linux-Driver
make -j$(nproc)
sudo make install
sudo modprobe 88x2bu

6.8 更改时区

6.8.1 检查当前时区

timedatectl

6.8.2 列出所有时区

timedatectl list-timezones

6.8.3 设置时区 (比如上海)

sudo timedatectl set-timezone Asia/Shanghai

6.9 更换开机LOGO和桌面墙纸

6.9.1 更换开机LOGO

替换内核下面的两个文件，重新编译内核：
kernel/logo.bmp
kernel/logo_kernel.bmp
或者使用脚本来操作，如下所示：

• 下载脚本

git clone https://github.com/friendlyarm/sd-fuse_rk3399.git -b kernel-4.19 --single-branch
cd sd-fuse_rk3399

• 编译内核并重新打包固件

convert files/logo.jpg -type truecolor /tmp/logo.bmp
convert files/logo.jpg -type truecolor /tmp/logo_kernel.bmp
sudo LOGO=/tmp/logo.bmp KERNEL_LOGO=/tmp/logo_kernel.bmp ./build-kernel.sh debian-bullseye-desktop-arm64
sudo ./mk-sd-image.sh debian-bullseye-desktop-arm64
sudo ./mk-emmc-image.sh debian-bullseye-desktop-arm64

注: 如果你的系统不是debian-bullseye-desktop-arm64,请根据实际情况指定

6.9.2 更换桌面墙纸

修改如下配置文件:

/home/pi/.config/pcmanfm/LXDE/desktop-items-0.conf

6.9.3 恢复出厂设置

在终端上执行如下命令:

sudo firstboot && sudo reboot

6.10 开机自动启动程序(例如Kodi)

把要开机启动的程序的desktop文件放入~/.config/autostart/目录即可，例如：

mkdir ~/.config/autostart/
cp /usr/share/applications/kodi.desktop ~/.config/autostart/

6.11 取消USB存储设备自动挂载

sudo systemctl mask udisks2
sudo reboot

6.12 设置中文语言与输入法

6.12.1 设置中文语言

输入以下命令,用空格选中 'zh_CN.UTF-8'

sudo dpkg-reconfigure locales

添加环境变量到 .bashrc:

echo "export LC_ALL=zh_CN.UTF-8" >> ~/.bashrc
echo "export LANG=zh_CN.UTF-8" >> ~/.bashrc
echo "export LANGUAGE=zh_CN.UTF-8" >> ~/.bashrc

重启确认一下设置是否生效:

sudo reboot

6.12.2 安装中文输入法

输入如下命令安装fcitx和拼音输入法:

sudo apt update
sudo apt-get install fcitx fcitx-pinyin
sudo apt-get install im-config
sudo apt-get install fcitx-table*
sudo apt-get install fcitx-ui-classic fcitx-ui-light
sudo apt-get install fcitx-frontend-gtk2 fcitx-frontend-gtk3 fcitx-frontend-qt4
sudo apt-get remove --purge scim* ibus*
sudo reboot

重启后, 按Ctrl+Space即可切换中英文输入法, 右上角也出现了输入法图标, 右击右上角的输入法图标, 在弹出菜单中可以切换输入法, 如下图所示:

6.13 安装Plex多媒体服务器

访问 Plex官网的如下地址: https://www.plex.tv/media-server-downloads/
在下载页面上, 选择 ”Plex Media Server” 分类, 平台选择 ”Linux“, 版本选择 "Ubuntu(16.04+)/Debian(8+) - ARMv8",
下载得到deb包后, 使用 dpkg 命令安装软件包即可:

sudo dpkg -i plexmediaserver_1.31.0.6654-02189b09f_arm64.deb

安装完成后, 在电脑浏览器上输入以下地址登录Plex服务器后台: http://IP地址:32400/web/

6.14 在Debian系统上安装Docker

请参考此链接: How to Install Docker on Debian/zh

6.15 如何测试NPU

请参考此链接: NPU/zh

6.16 如何测试VPU

请参考此链接: VPU/zh

6.17 设置WiFi无线链接

6.17.1 图形界面操作

点击右上角的网络图标，选择你要连接的WiFi热点，按界面提示操作即可。

6.17.2 命令行操作

请参考 Use NetworkManager to configure network settings/zh

6.18 取消自动登录

编辑文件:

sudo vim /etc/lightdm/lightdm.conf

注释掉如下两行内容 (在前面插入#):

autologin-user=pi
autologin-user-timeout=0

6.19 测试OpenGL ES性能

在系统菜单 System Tools 中点击 Terminator 打开命令行终端，输入以下命令即可测试:

glmark2-es2

6.20 设置HDMI/DP屏幕分辨率

进入系统菜单 Perferences -> Monitor Settings界面进行设置即可。
推荐分辨率：1920x1080@60Hz

6.21 调节HDMI边界

打开命令行终端，输入命令进行操作，有几个注意事项：
1) 需要登录桌面才能操作，如果Desktop停留在Login是无法设置的;
2) 如果你是在 ssh 登录的终端，请使用与桌面登录相同的用户名，默认是 pi，不能使用root用户，同时，你需要赋值 DISPLAY 变量：

export DISPLAY=:0.0

6.21.1 查询显示器支持哪些分辨率

xrandr -q

输出示例：

Screen 0: minimum 320 x 200, current 1920 x 1080, maximum 8192 x 8192
eDP-1 disconnected primary (normal left inverted right x axis y axis)
HDMI-1 connected 1920x1080+0+0 (normal left inverted right x axis y axis) 0mm x 0mm
   1920x1080     60.00*+  50.00  
   1280x720      60.00    50.00  
   720x576       50.00  
   720x480       59.94

6.21.2 设置分辨率

例如设置为 1920X1080@60Hz:

xrandr --output HDMI-1 --mode 1920x1080 --refresh 60

6.21.3 设节HDMI输出边界

For example, the transformation scaling horizontal coordinates by 0.8, vertical coordinates by 1.04 and moving the screen by 35 pixels right and 19 pixels down:

xrandr --output HDMI-1 --transform 0.80,0,-35,0,1.04,-19,0,0,1

6.21.4 开机自动调整

编辑~/.config/autostart/lxrandr-autostart.desktop，将完整的xrandr命令写入到Exec=开头的键中，如下所示：

[Desktop Entry]
Type=Application
Name=LXRandR autostart
Comment=Start xrandr with settings done in LXRandR
Exec=sh -c 'xrandr --output HDMI-1 --mode 1920x1080 --refresh 50 --transform 1.04,0,-35,0,1.05,-30,0,0,1'
OnlyShowIn=LXDE

6.22 Chromium网页浏览器

6.22.1 GPU支持情况

系统预装的Chromium网页浏览器已经默认启用硬件加速，支持WebGL，可以通过输入网址 chrome://gpu 了解硬件加速情况，如下图所示：

6.22.2 VPU支持情况

在浏览器上播放一个视频,然后在命令行使用fuser查看mpp设备节点的使用情况来确认已经调用了vpu:

pi@FriendlyElec:~$ fuser /dev/mpp_service
/dev/mpp_service:     3258

如果fuser命令没有内容输出, 则表示当前是软解.

6.22.3 查看支持的硬解格式

在浏览器地址栏输入 about://gpu，翻页到页面最底部，查看 "Video Acceleration Information" 表格;
播放一个视频后，再在浏览器地址栏输入 about://media-internals, 可以查看最近播放的视频是否启用了硬解;

6.23 测试mpp视频硬件编码

mpi_enc_test -w 1920 -h 1080 -t 7 -f 0 -o test.h264 -n 300
export XDG_RUNTIME_DIR=/run/user/0
ffplay test.h264

7 Debian10 桌面系统的使用

• Refer to：
  • Debian Buster

8 FriendlyDesktop系统的使用

Arduino

Firefox

Scratch

FriendlyDesktop 是一个轻量级的Ubuntu桌面环境，其底层基于LXDE桌面构建，具有如下特点：
    最新版本 － 基于Ubuntu 18.04 64位系统构建。
    易于开发 － 兼容FriendlyCore的特性，集成经过优化的Qt5.10, QtCreator和Arduino IDE。
    轻巧 － 只需要很少的CPU资源即可执行顺畅，而且当内存容量充足时表现特别出色。
    省能源 － 它比其他常见的系统需要较少的资源运行相同的工作。
    简朴美 － 借由GTK+ 2，它拥有美观、支持国际化的用户界面。
    使用简单 － 提供用户如微软Windows般的应用程序列表。
    可自定义性 － 用户可以轻易自定义LXDE的外观。
    兼容标准 － 兼容于freedesktop.org标准。
用于友善电子RK3399平台的FriendlyDesktop已经最佳化了对Mali GPU和VPU的支持，系统中已集成X.org驱动，支持Hardware Cursor、OpenGL图形加速等,支持4K硬解视频播放。

8.1 帐户与密码

普通用户：

   用户名: pi
   密码: pi

Root用户：

   用户名: root
   密码: fa

8.2 设置WiFi无线链接

点击FriendlyDesktop右上角的网络图标，选择你要连接的WiFi热点，按界面提示操作即可。

8.3 设置HDMI/DP屏幕分辨率

进入系统菜单 Perferences -> Monitor Settings界面进行设置即可。
推荐分辨率：1920x1080@60Hz

8.4 调节HDMI边界

打开命令行终端，输入命令进行操作，有几个注意事项：
1) 需要登录桌面才能操作，如果Desktop停留在Login是无法设置的;
2) 如果你是在 ssh 登录的终端，请使用与桌面登录相同的用户名，默认是 pi，不能使用root用户，同时，你需要赋值 DISPLAY 变量：

export DISPLAY=:0.0

8.4.1 查询显示器支持哪些分辨率

xrandr -q

输出示例：

Screen 0: minimum 320 x 200, current 1920 x 1080, maximum 8192 x 8192
eDP-1 disconnected primary (normal left inverted right x axis y axis)
HDMI-1 connected 1920x1080+0+0 (normal left inverted right x axis y axis) 0mm x 0mm
   1920x1080     60.00*+  50.00  
   1280x720      60.00    50.00  
   720x576       50.00  
   720x480       59.94

8.4.2 设置分辨率

例如设置为 1920X1080@60Hz:

xrandr --output HDMI-1 --mode 1920x1080 --refresh 60

8.4.3 设节HDMI输出边界

For example, the transformation scaling horizontal coordinates by 0.8, vertical coordinates by 1.04 and moving the screen by 35 pixels right and 19 pixels down:

xrandr --output HDMI-1 --transform 0.80,0,-35,0,1.04,-19,0,0,1

8.4.4 开机自动调整

编辑~/.config/autostart/lxrandr-autostart.desktop，将完整的xrandr命令写入到Exec=开头的键中，如下所示：

[Desktop Entry]
Type=Application
Name=LXRandR autostart
Comment=Start xrandr with settings done in LXRandR
Exec=sh -c 'xrandr --output HDMI-1 --mode 1920x1080 --refresh 50 --transform 1.04,0,-35,0,1.05,-30,0,0,1'
OnlyShowIn=LXDE

8.5 设置eDP显示屏旋转

如果要旋转eDP屏的显示，可使用命令xrotate.sh 来旋转90/180/270度。 以root用户运行以下命令，即可顺时钟旋转90度，命令执行过程中，会重启lightdm服务让设置立即生效:

sudo xrotate.sh -m CW -r

其他旋转角度，可以通过运行 xrotate -h 命令获得详细的参数说明。
另外，该命令暂不支持HDMI显示的旋转，用户参考X11的文档，自行编辑 /etc/X11/xorg.conf 配置文件。

注意：硬解视频时，视频窗口并不会跟随屏幕旋转。

8.6 测试OpenGL ES性能

在系统菜单 System Tools 中点击 Terminator 打开命令行终端，输入以下命令即可测试:

taskset -c 4-5 glmark2-es2

8.7 如何播放4K视频

8.7.1 使用Qt硬解播放器播放

FriendlyDesktop预装了Qt播放器Qt5-VideoPlayer，该播放器已经适配Rockchip的gstreamer插件，支持4K视频的硬解播放, 播放器启动方法： 在FriendlyDesktop上打开菜单 Sound & Video，点击 Qt5-VideoPlayer。

在播放器界面上，点击左下角的 Open 按钮加载一个视频文件到右边的播放列表，双击播放列表上的文件开始播放。播放器的界面如下所示，可以设置全屏播放，也可以调节音量：

Qt播放器源代码: https://github.com/friendlyarm/rk-player-qt

8.7.2 命令行播放

打开命令行终端，输入以下命令即可测试:

gst-player.sh

默认音频会输出到耳机孔， 可以使用 which gst-player.sh 找到这个脚本的位置，自已定制其播放的行为。

8.8 如何使用USB摄像头

将USB摄像头（比如罗技C270/C920）插入开发板，双FriendlyDesktop桌面上的USB Camera会弹出luvcview预览界面 (需要使用2019/05/11版本以上的FriendlyDesktop)，在界面上点击中间的录像按钮可以录像.
luvcview 是一个开源软件，你可以自行编译：

git clone https://github.com/ksv1986/luvcview
cd luvcview
make

查看luvcview的用法：

./luvcview -h

参数说明：

luvcview version 0.2.1
usage: uvcview [-h -d -g -f -s -i -c -o -C -S -L -l -r]
-h    print this message
-d    /dev/videoX       use videoX device
-g    use read method for grab instead mmap
-w    disable SDL hardware accel.
-f    video format  default jpg  others options are yuv jpg
-i    fps           use specified frame interval
-s    widthxheight      use specified input size
-c    enable raw frame capturing for the first frame
-C    enable raw frame stream capturing from the start
-S    enable raw stream capturing from the start
-o    avifile  create avifile, default video.avi
-L    query valid video formats
-l    query valid controls and settings
-r    read and set control settings from luvcview.cfg

以640x360@30fps的格式预览USB摄像头图像可以使用以下命令：

./luvcview -d /dev/video8 -i 30 -s 640x360

从luvcview的输出信息可以看到，硬件加速已经开启：

pi@NanoPC-T4:/etc/xrdp$ luvcview -d /dev/video8 -i 30 -s 640x360
luvcview version 0.2.1
 interval: 30 fps
Hardware acceleration available
video /dev/video8

8.9 如何通过蓝牙传输文件

在FriendlyDesktop上打开菜单 Preferences，启动 Bluetooth Manager，在界面上点 Search 即可搜索周边的蓝牙设备, 点击你的设备进行配对，配对后即可发送文件，如下图所示：

8.10 安装使用OpenCV

OpenCV has been pre-installed in FriendlyCore/FriendlyDesktop (Version after 201905) and does not require manual installation.
Please refre this link: https://github.com/friendlyarm/install-opencv-on-friendlycore/blob/rk3399/README.md

8.11 开发Qt程序

FriendlyDesktop下提供了重新编译的 Qt 5.10.0，支持RK3399的OpenGL ES和Gstreamer 1.0的硬件加速，同时集成了 QtCreator IDE，已配置好可以直接在开发板上编译并运行程序，如下所示：

运行Qt程序时，需要指定platform参数为xcb，如下所示：

./HelloQt --platform xcb

8.12 访问GPIO/I2C/串口等硬件资源

请参考下面的文档：

• WiringPi for RK3399
• WiringPi-Python for RK3399

8.13 切换音频默认输出设备

8.13.1 查看当前默认的输出设备

在普通用户的终端上，输入以下命令：

pactl info -vvv

显示的信息包含以下内容，表示当前音频输出到耳机：

Default Sink: alsa_output.platform-rt5651-sound.stereo-fallback

显示的信息包含以下内容，表示当前音频输出到HDMI：

Default Sink: alsa_output.platform-hdmi-sound.stereo-fallback

8.13.2 设置默认的音频输出设备为耳机口

在普通用户的终端上，输入以下命令：

pactl set-default-sink  alsa_output.platform-rt5651-sound.stereo-fallback

设置耳机口输出的默认音量为20%：

pactl -- set-sink-volume alsa_output.platform-rt5651-sound.stereo-fallback 20%

8.13.3 设置默认的音频输出设备为HDMI

在普通用户的终端上，输入以下命令：

pactl set-default-sink  alsa_output.platform-hdmi-sound.stereo-fallback

8.13.4 查看设置是否已生效

cat /var/lib/pulse/*-default-sink

8.13.5 播放时临时切换

这种方法仅对当前的播放进程有效:
打开菜单 "Sound & Video" -> "PulseAudio Volume Control", 在界面上点击 "Built-in Audio Stereo" 按钮切换不同的输出设备，比如在HDMI与耳机接口之间切换。

8.14 播放网络流媒体(或网络摄像头)

打开命令行终端，输入以下命令:

gst-launch-1.0 rtspsrc location="rtsp://admin:12345@192.168.1.120:554/live/main" ! rtph264depay ! decodebin ! rkximagesink

请将 rtsp:// 后面的地址改成真实的地址。

8.15 Chromium网页浏览器

系统预装的Chromium网页浏览器已经默认启用硬件加速，支持WebGL，可以通过输入网址 chrome://gpu 了解硬件加速情况，如下图所示：

8.16 屏幕保护与自动休眠相关设置

屏幕保护与自动休眠的配置文件是 /etc/xdg/autostart/xset_command.desktop，默认出厂的设置是屏幕保护和DPMS都是关闭的，你可以通过修改这个文件来更改配置，具体可以了解一下Linux下 xset 命令的用法。

8.17 安装Scratch

用以下命令安装:

sudo apt-get install scratch:arm64

8.18 安装Arduino IDE

用以下命令安装:

sudo apt-get install arduino:arm64

8.19 开机自动启动程序

把要开机启动的程序的desktop文件放入~/.config/autostart/目录即可，例如：

cp /usr/share/applications/org.qt-project.qtcreator.desktop ~/.config/autostart/

8.20 用root用户登录桌面

编辑 /root/.profile文件：

sudo vim /root/.profile

替换成如下内容：

if [ -n "$BASH_VERSION" ]; then
    if [ -f "$HOME/.bashrc" ]; then
	. "$HOME/.bashrc"
    fi
fi
if [ -d "$HOME/bin" ] ; then
    PATH="$HOME/bin:$PATH"
fi

执行以下命令修改lightdm的配置文件，将自动登录的用户名改成 root:

sudo sed -i 's/autologin-user=pi/autologin-user=root/g' /usr/share/lightdm/lightdm.conf.d/20-defaultsession.conf

执行reboot命令重启:

sudo reboot

如果希望登录后，桌面图标与配置等都与pi用户一样，可以从/home/pi目录复制相关的目录过来：

sudo rm -rf /root/Desktop /root/Pictures /root/.config
sudo cp -af /home/pi/Desktop /home/pi/Pictures /home/pi/.config /root/
sudo chown root:root /root/Desktop /root/Pictures /root/.config

8.21 FriendlyDesktop下使用NVME SSD

请参考: How to Initialize and Format New SSD And HDD

9 FriendlyCore的使用

9.1 介绍

FriendlyCore，是一个没有预装X Desktop，基于Ubuntu core构建的系统 (版本: 18.04)。

FriendlyCore的定位是为企业客户提供可直接用于产品的基础OS，Core的含义是指"核心"与"可量产"，FriendlyCore与Ubuntu base最小系统的定位不同，FriendlyCore并不只是提供命令行界面，它提供了两种形式的图形界面：
1）针对RK3399优化的Qt 5.10.0，支持GPU和VPU加速，提供QtQuick/QtWebEngine/QtMultimedia/WebGL等Qt模块以及KMS、EGLFS和XCB三种显示插件;
2) 集成Xorg最小系统，可以以最轻量的方式运行X11应用，X11服务器同样支持硬件加速;

FriendlyCore在 RK3399 平台下的其他特性还包括：

• 支持7寸电容屏HD702，与HDMI同时连接时，可实现双屏异显，或者同步显示
• 支持 Gstreamer 1.0 多媒体框架
• 支持命令行和Qt硬解播放器
• 支持Qt5 WebGL，可以在其他设备上用浏览器上显示Qt界面
• 支持Qt5 VNC，可以将Qt应用作为VNC Server的形式运行，轻松实现远程控制
• 支持蓝牙，已预装bluez等相关软件包

9.2 运行FriendlyCore

• 对于有HDMI接口的板子，如果要在电视上进行操作，您需要连接USB鼠标和键盘。
• 如果您需要进行内核开发，最好选购一个串口配件，连接了串口，则可以通过串口终端对开发板进行操作。

SOM-RK3399需要使用USB转串口模块，连接方法如下图所示：

• FriendlyCore默认帐户：

普通用户：

   用户名: pi
   密码: pi

Root用户：

   用户名: root
   密码: fa

默认会以 pi 用户自动登录，你可以使用 sudo npi-config 命令取消自动登录。

• 更新软件包：

$ sudo apt-get update

9.3 开发Qt应用

请参考 How to Build and Install Qt Application for FriendlyELEC Boards/zh

9.4 开机自动运行Qt示例程序

使用npi-config工具进行开启：

sudo npi-config

进入Boot Options -> Autologin -> Qt/Embedded，选择Enable然后重启即可。

9.5 扩展TF卡文件系统

第一次启动FriendlyCore系统时，系统会自动扩展文件系统分区，请耐心等待，TF卡/eMMC的容量越大，需要等待的时间越长，进入系统后执行下列命令查看文件系统分区大小：

df -h

9.6 使用蓝牙传输文件

以传输文件到手机为例进行说明，首先，将你的手机蓝牙设置为可侦测状态，然后执行以下命令开始蓝牙搜索：

hcitool scan

搜索到设备时，结果举例如下：

Scanning ...
    2C:8A:72:1D:46:02   HTC6525LVW

这表示搜索到一台名为HTC6525LVW的手机，我们记下手机名称前面的MAC地址，然后用sdptool命令查看该手机支持的蓝牙服务：

sdptool browser 2C:8A:72:1D:46:02

注：上述命令中的MAC地址请替换成手机实际的蓝牙MAC地址
这个命令会详细列出手机蓝牙所支持的协议，我们需要关心的是一个名为 OBEX Object Push 的文件传输服务，以HTC6525LVW手机为例，其显示结果如下所示：

Service Name: OBEX Object Push
Service RecHandle: 0x1000b
Service Class ID List:
  "OBEX Object Push" (0x1105)
Protocol Descriptor List:
  "L2CAP" (0x0100)
  "RFCOMM" (0x0003)
    Channel: 12
  "OBEX" (0x0008)
Profile Descriptor List:
  "OBEX Object Push" (0x1105)
    Version: 0x0100

从上面的信息可以看到，这个手机的OBEX Object Push服务的所用的频道是12, 我们需要将它传递给obexftp命令，最后发起文件传输请求的命令如下：

obexftp --nopath --noconn --uuid none --bluetooth -b 2C:8A:72:1D:46:02 -B 12 -put example.jpg

注：上述命令中的MAC地址、频道和文件名请替换成实际的

执行上述命令后，请留意手机屏幕，正常情况下手机会弹出配对和接收文件的提示，确定后就开始文件传輪了。

蓝牙常见问题：
1) 开发板上找不到蓝牙设备, 可尝试用以下命令开启蓝牙：

rfkill unblock 0

2) 提示找不到相关命令，可尝试用以下命令安装相关软件：

apt-get install bluetooth bluez obexftp openobex-apps python-gobject ussp-push

9.7 连接WiFi

无论是SD WiFi还是USB WiFi, 它们的连接方式都是一样的。正基科技的APXX系列芯片属于SD WiFi，另外系统默认也已经支持市面上众多常见的USB WiFi，已测试过的USB WiFi型号如下：

序号	型号
1	RTL8188CUS/8188EU 802.11n WLAN Adapter
2	RT2070 Wireless Adapter
3	RT2870/RT3070 Wireless Adapter
4	RTL8192CU Wireless Adapter
5	小米WiFi mt7601
6	5G USB WiFi RTL8821CU
7	5G USB WiFi RTL8812AU

目前使用 NetworkManager 工具来管理网络，其在命令行下对应的命令是 nmcli，要连接WiFi，相关的命令如下：

• 切换到root账户

$ su root

• 查看网络设备列表

$ nmcli dev

注意，如果列出的设备状态是 unmanaged 的，说明网络设备不受NetworkManager管理，你需要清空 /etc/network/interfaces下的网络设置,然后重启.

• 开启WiFi

$ nmcli r wifi on

• 扫描附近的 WiFi 热点

$ nmcli dev wifi

• 连接到指定的 WiFi 热点

$ nmcli dev wifi connect "SSID" password "PASSWORD" ifname wlan0

请将 SSID和 PASSWORD 替换成实际的 WiFi名称和密码。
连接成功后，下次开机，WiFi 也会自动连接。

更详细的NetworkManager使用指南可参考这篇文章： Use NetworkManager to configure network settings

如果你的USB WiFi无法正常工作, 大概率是因为文件系统里缺少了对应的USB WiFi固件。对于Debian系统, 可以在Debian-WiFi里找到并安装USB WiFi芯片的固件。而对于Ubuntu系统, 则可以通过下列命令安装所有的USB WiFi固件:

$ apt-get install linux-firmware

一般情况下, 各种WiFi芯片的固件都存放在/lib/firmware目录下。

9.8 连接以太网

默认插上网线开机，会自动连接并通过DHCP获取IP地址，如需要配置静态IP地址，请参考 NetworkManager 的相关文档: Use NetworkManager to configure network settings。

9.9 定制命令行的欢迎信息（文字LOGO）

欢迎信息主要是这个目录下的脚本来打印的：

/etc/update-motd.d/

比如要修改 FriendlyELEC 的大字LOGO，可以修改/etc/update-motd.d/10-header 这个文件，比如要将LOGO改为HELLO，可将以下行：

TERM=linux toilet -f standard -F metal $BOARD_VENDOR

改为：

TERM=linux toilet -f standard -F metal HELLO

9.10 修改时区

例如更改为Shanghai时区:

sudo rm /etc/localtime
sudo ln -ls /usr/share/zoneinfo/Asia/Shanghai /etc/localtime

9.11 选择系统默认的音频设备

可以通过下面的操作步骤，设置系统默认的音频设备。
可用以下命令查看系统中所有的声卡设备 (注：不同的开发板结果会有所不同):

pi@NanoPi:~$ aplay -l
**** List of PLAYBACK Hardware Devices ****
card 0: realtekrt5651co [realtek,rt5651-codec], device 0: ff880000.i2s-rt5651-aif1 rt5651-aif1-0 []
  Subdevices: 1/1
  Subdevice #0: subdevice #0
card 1: rockchiphdmi [rockchip,hdmi], device 0: ff8a0000.i2s-i2s-hifi i2s-hifi-0 []
  Subdevices: 1/1
  Subdevice #0: subdevice #0
card 2: ROCKCHIPSPDIF [ROCKCHIP,SPDIF], device 0: ff870000.spdif-dit-hifi dit-hifi-0 []
  Subdevices: 1/1
  Subdevice #0: subdevice #0

可以看到，硬件上有如下声卡设备：

声卡设备	声卡序号	说明
realtekrt5651co	0	Realtek声卡的缺省输出接口（通过3.5mm耳机输出）
rockchiphdmi	1	HDMI输出
ROCKCHIPSPDIF	2	光纤输出 (注：暂不可用，因为硬件没有引出)

要配置成将音频输出到3.5mm耳机接口，可修改配置文件/etc/asound.conf，修改成如下内容:

defaults.pcm.card 0
defaults.pcm.device 0

要配置成将音频输出到HDMI，则将上面的defaults.pcm.card修改为1。
需要注意的是，有些板子由于没有Realtek声卡 (没有耳机输出接口)，所以HDMI设备的序号会是card 0，所以配置时，要以aplay -l命令的结果为准。

9.12 设置PWM风扇的行为

默认情况下，风扇的转速是根据cpu温度动态调整的，如果需要取消温控，让风扇一直处于运行状态，可以把脚本 /usr/bin/start-rk3399-pwm-fan.sh 修改成以下内容来实现：

#!/bin/bash
 
echo 0 > /sys/class/pwm/pwmchip1/export
sleep 1
echo 0 > /sys/class/pwm/pwmchip1/pwm0/enable
echo 50000 > /sys/class/pwm/pwmchip1/pwm0/period
echo 1 > /sys/class/pwm/pwmchip1/pwm0/enable
echo 45000 > /sys/class/pwm/pwmchip1/pwm0/duty_cycle

9.13 运行X11程序

FriendlyCore系统集成了轻量级的Xorg，虽然没有窗口管理器，但是你仍然可以运行单一的X-Windows程序，例如要运行的程序是~/YourX11App，使用以下命令：

. /usr/bin/setqt5env-xcb
startx ~/YourX11App -geometry 1280x800

注意 “.” 与 /usr/bin/setqt5env-xcb 之间有一个空格，另外，-geometry后面的分辨率请更改为你的屏幕的实际分辨率。

9.14 mpv硬解播放器

FriendlyCore预装了基于 ffmpeg 实现的命令行视频播放器，除了 mpv 播放器本身，也包含了 libmpv 库文件，方便在程序里调用。
mpv播放器支持 Rockchip MPP video decoder，所以支持4K硬解播放，mpv的参数较多，为了简化使用，我们提供了一个脚本 start-mpv，简化后，只要传文件名给它，就可以播放视频了：

start-mpv /home/pi/demo.mp4

需要注意的是，播放时需要使用pi用户登录，因为其它用户的目录里没有mpv相关的设置，当然你可以从pi用户目录复制一份过来也是可以的，mpv的设置文件存放在以下路径：

/home/pi/.config/mpv/mpv.conf

mpv.conf的文件内容如下所示：

vo=gpu
gpu-context=drm
hwdec=rkmpp
demuxer-max-bytes=41943040
demuxer-max-back-bytes=41943040
drm-osd-plane-id=1
drm-video-plane-id=0
audio-device=alsa/default:CARD=rockchiphdmi

这些都是比较重要的，会传递给 mpv 的参数，其中hwdec需要指定为rkmpp才能开启硬件解码，audio-device用于指定音频输出设备，默认输出到HDMI，你可以用以下命令来查询系统中有哪些音频设备：

mpv --audio-device=help

另一个比较重要的参数是 drm-osd-size，当全屏播放视频时，drm-osd-size指定为屏幕的分辨率即可，这个参数由start-mpv自动获取屏幕参数并传给mpv，start-mpv脚本除此之外，还会做一件更重要的事情，它需要保证系统中的 libmali 库用了正确的版本，因为 mpv 是通过 gbm 来渲染画面的，所以 libmali.so 需要使用这个版本： libmali-midgard-t86x-r14p0-gbm.so，这也意味着，这个版本的mpv只能在FriendlyCore下使用，不能在X11 Desktop下使用，具体细节可以自已查看 start-mpv 的脚本内容。
mpv官方使用指南：https://github.com/mpv-player/mpv/wiki

10 同时适用于FriendlyDesktop与FriendlyCore系统的功能特性

10.1 Linux下使用摄像头（MIPI接口摄像头OV13850与OV4689，USB摄像头罗技C920）

摄像头连接方法： 摄像头可以连接在MIPI接口，如下图所示：

为了方便测试摄像头，我们提供了脚本可以在命令行测试摄像头的拍照和录像功能。
你可以用以下命令更新这个脚本到最新版本:

cd /tmp/
git clone https://github.com/friendlyarm/gst-camera-sh.git
sudo cp gst-camera-sh/*.sh /usr/bin/

共有以下三个脚本：
gst-camera.sh: 单个摄像头的预览、拍照与录像
dual-camera.sh: 预览两个摄像头
stop-gst-camera.sh: 停止预览

10.1.1 gst-camera.sh 参数说明

参数	功能
--index或-i	选择要使用的摄像头的序号，可选值为0和1，当同时连接两个摄像头时，指定为1表示要操作第二个摄像头
--action或-a	指定命令要执行的动作，可选参数为: preview、photo和video，分别对应预览、拍照和录像
--output或-o	指定输出的文件名，用于拍照和录像时指定输出文件名
--verbose或-v	指定为yes时，会输出调用gst-launch-1.0命令的完整命令行
-x	使用rkximagesink插件，预览图像会输出到X11窗口，适用于FriendlyDesktop与Lubuntu系统
-g	使用glimagesink插件，预览图像会输出到X11窗口，适用于FriendlyDesktop与Lubuntu系统
-k	使用kmssink插件，预览图像会直接输出到屏幕，适用于FriendlyCore系统

脚本gst-camera.sh会自动识别OV13850/OV4689/罗技C920摄像头，并传递合适的参数给gst-launch-1.0。

10.1.2 脚本使用方法

• 预览图像

gst-camera.sh --action preview

• 拍照

用命令拍照一张照片，存储为文件 1.jpg：

gst-camera.sh -a photo -o 1.jpg

• 录像并预览

用以下命令启动录像，存储为视频文件 1.ts，录像时使用了硬件编码：

gst-camera.sh --action video -output 1.ts

• 显示完整的命令

加入 --verbose yes 的参数，会显示最终的 gsteamer 命令，例如：

gst-camera.sh --action video --output 1.ts --verbose yes

你会得到以下完整的 gsteamer 命令，这对你开发会有帮助：

gst-launch-1.0 rkisp num-buffers=512 device=/dev/video0 io-mode=1 ! \
    video/x-raw,format=NV12,width=1280,height=720,framerate=30/1 ! \
        mpph264enc ! queue ! h264parse ! mpegtsmux ! \
        filesink location=/tmp/camera-record.ts

• 预览双摄像头

连接两个mipi摄像头，或者一个mipi摄像头加一个usb摄像头（仅测试过：罗技C920 pro)，调用以下命令即可同时预览两个摄像头的图像：

dual-camera.sh

注：建议在FriendlyDesktop下测试。

10.1.3 gst-launch-1.0命令行解析

在FriendlyDesktop下预览摄像头命令如下：

gst-launch-1.0 rkisp device=/dev/video1 io-mode=4 ! video/x-raw,format=NV12,width=1280,height=720,framerate=30/1 ! rkximagesink

重要参数说明：

参数	说明
device	用于预览的device (selfpath) 是 /dev/video1, 用于拍照的device (mainpath) 是 /dev/video0, 如果是多路摄像头，则另一路预览（selfpath)是 /dev/video5, 另一路拍照 (mainpath)是 /dev/video4, USB摄像头一般都是 /dev/video8
io-mode	值为1表示是memory map模式，值为4表示是dmabuf模式，一般预览用io-mode=4，拍照用io-mode=1, 在OpenCV里访问用io-mode=4
rkximagesink/glimagesink/kmssink	在X-Windows窗口中输出mipi摄像头图像时指定为rkximagesink (适用于FriendlyDesktop)，如果是USB摄像头则指定为glimagesink，FriendlyCore下只能使用kmssink

10.1.4 在OpenCV中访问摄像头

访问MIPI摄像头：

cv.VideoCapture('rkisp device=/dev/video1 io-mode=4 ! video/x-raw,format=NV12,width=640,height=480,framerate=30/1 ! videoconvert ! appsink', cv.CAP_GSTREAMER)

访问USB摄像头：

cv.VideoCapture('rkisp device=/dev/video8 io-mode=4 ! videoconvert ! video/x-raw,format=NV12,width=640,height=480,framerate=30/1 ! videoconvert ! appsink', cv.CAP_GSTREAMER)

详情请参考这里的示例代码：https://github.com/friendlyarm/install-opencv-on-friendlycore/tree/rk3399/examples

10.1.5 摄像头应用教程: 推流至直播平台

请查看这篇文档: How to setup RTMP server on NanoPC-T4/zh

10.1.6 参考资源

http://blog.iotwrt.com/media/2017/10/01/camera/ http://www.360doc.com/content/16/1019/17/496343_599664458.shtml

10.2 Docker的安装与使用

10.2.1 安装Docker

使用以下命令安装：

wget https://download.docker.com/linux/ubuntu/dists/bionic/pool/stable/arm64/containerd.io_1.2.6-3_arm64.deb
wget https://download.docker.com/linux/ubuntu/dists/bionic/pool/stable/arm64/docker-ce-cli_19.03.2~3-0~ubuntu-bionic_arm64.deb
wget https://download.docker.com/linux/ubuntu/dists/bionic/pool/stable/arm64/docker-ce_19.03.2~3-0~ubuntu-bionic_arm64.deb
sudo dpkg -i containerd.io_1.2.6-3_arm64.deb
sudo dpkg -i docker-ce-cli_19.03.2~3-0~ubuntu-bionic_arm64.deb
sudo dpkg -i docker-ce_19.03.2~3-0~ubuntu-bionic_arm64.deb

10.2.2 验证Docker的安装

用Docker创建并运行一个debian镜像:

git clone https://github.com/friendlyarm/debian-jessie-arm-docker
cd debian-jessie-arm-docker
./rebuild-image.sh
./run.sh

10.3 Linux下使用ffmpeg进行硬件加速的视频解码

FriendlyCore和FriendlyDesktop系统均预装了 ffmpeg 的可执行文件、静态库和头文件，位于 /usr/ffmpeg-rkmp目录。
ffmpeg支持RockChip MPP视频硬件解码器，但并不支持硬编码，具体信息可参考：https://trac.ffmpeg.org/wiki/HWAccelIntro

测试4K视频的解码性能：

/usr/ffmpeg-rkmp/bin/ffmpeg -benchmark -loglevel 48 -vcodec h264_rkmpp -i 4K-Chimei-inn-60mbps.mp4 -map 0:v:0 -f null -

结果如下图所示，平均 45 FPS：

要播放视频，可以使用基于 ffmpeg 实现的播放器 mpv，上面测试所用的4K视频可在网盘的 test-video 目录找到，网盘地址：http://dl.friendlyelec.com/nanopct4。

11 初始化NVME固态硬盘和USB移动硬盘

11.1 检查是否检测到了硬盘

安装好硬盘后, 上电开机, 在终端上输入以下命令:

cat /proc/partitions

看到有 nvme0n1 设备的节点，说明NVME固态硬盘已经成功被识别到了:

major minor  #blocks  name
   1        0       4096 ram0
 259        0  125034840 nvme0n1

看到有 sda 设备的节点，说明USB移动硬盘已经成功被识别到了:

 179      105   30646767 mmcblk0p9
   8        0 3907018584 sda
   8        1 3907017543 sda1

11.2 给硬盘重新分区并格式化为ext4格式

为了简化操作, 我们会将硬盘整个空间分成一个分区, 如果你用的是NVME固态硬盘, 输入以下命令进行操作:

(echo g; echo n; echo p; echo 1; echo ""; echo ""; echo w; echo q) | fdisk /dev/nvme0n1
mkfs.ext4 /dev/nvme0n1p1

如果要对USB移动硬盘进行操作, 输入以下命令:

(echo g; echo n; echo p; echo 1; echo ""; echo ""; echo w; echo q) | fdisk /dev/sda
mkfs.ext4 /dev/sda1

11.3 硬盘的自动挂载

11.3.1 在FriendlyWrt系统下挂载

在FriendlyWrt菜单中, 点击"系统"->"挂载点"界面, 在页面底部的"挂载点"的区域中, 点击"新增"按钮, 在UUID一栏中,选择你的硬盘分区, NVME固态硬盘选择 /dev/nvme0n1p1, 如果是USB移动硬盘, 则选择 /dev/sda1, 然后钩选"已启动“, 填写挂载硬盘的目标位置, 本例中选择将 NVME固态硬盘 挂载到 /mnt 目录, 如下图所示:

点击"Save"按钮保存设置, 挂载完成后界面会列出所挂载的硬盘, 如下图所示:

11.3.2 在FriendlyCore系统下挂载

首先，我们需要了解分区的Block ID，用blkid查看, NVME固态硬盘输入如下命令查看:

blkid /dev/nvme0n1p1

USB移动固态硬盘输入如下命令查看:

blkid /dev/sda1

输入信息如下所示, 我们需要的是UUID:

/dev/sda1: UUID="de29e869-f442-414a-8dc4-9c47c05b229f" BLOCK_SIZE="4096" TYPE="ext4" PARTUUID="b026f952-01"

然后需要把 UUID 添加到 /etc/fstab 文件中去，为了挂载本例中使用的硬盘，/etc/fstab内容如下所示：

UUID=de29e869-f442-414a-8dc4-9c47c05b229f /media/mydisk ext4 defaults 0 0

硬盘将挂载到 /media/mydisk 目录，这个目录默认是不存在的，我们用以下命令手动创建它，并设置为普通用户可以读写：

mkdir -p /media/mydisk
chmod 777 /media/mydisk

接下来就可以输入mount命令，测试一下是否能正常挂载了：

mount /media/mydisk

如果成功挂载, 接下来我们关机测试一下，看下次开机是否会自动挂载：

reboot

11.4 为硬盘设置网络共享

11.4.1 提升硬件挂载目录的权限

为了方便普通用户的读取, 进入终端, 输入以下命令先提升硬件挂载目录的权限:

chmod 777 /mnt

11.4.2 FriendlyWrt下设置网络共享

进入 “服务” -> "网络共享" 菜单, 在页面底部的 “共享目录” 区域, 点击 “新增” 按钮, 分别填写 "名称" 与 "路径" 为 mnt 和 /mnt, 其他默认, 点击 "保存并应用" 即可.

11.4.3 在电脑上访问共享

在Windows电脑上输入以下地址访问共享目录:

\\192.168.2.1\mnt

在Ubuntu/Mac电脑上使用以下地址访问共享目录:

smb://192.168.2.1/mnt

在询问身份验证时, 输入如下信息:
连接方式: 已注册用户
用户名: root
域: WORKGROUP
密码: password

11.5 本机上进行硬盘速度测试

11.5.1 NVME固态硬盘速度测试

11.5.1.1 写入速度

测试命令:

dd if=/dev/zero of=/mnt/deleteme.dat bs=32M count=64 oflag=direct,nonblock

结果如下:

2147483648 bytes (2.1 GB, 2.0 GiB) copied, 6.74925 s, 318 MB/s

11.5.1.2 读取速度

测试命令:

dd if=/mnt/deleteme.dat of=/dev/null bs=32M count=64 iflag=direct,nonblock

结果如下:

2147483648 bytes (2.1 GB, 2.0 GiB) copied, 5.18329 s, 414 MB/s

11.5.2 USB移动机械硬盘速度测试

11.5.2.1 写入速度

测试命令:

dd if=/dev/zero of=/mnt/deleteme.dat bs=32M count=64 oflag=direct,nonblock

结果如下:

2147483648 bytes (2.1 GB, 2.0 GiB) copied, 20.3973 s, 105 MB/s

11.5.2.2 读取速度

测试命令:

dd if=/mnt/deleteme.dat of=/dev/null bs=32M count=64 iflag=direct,nonblock

结果如下:

2147483648 bytes (2.1 GB, 2.0 GiB) copied, 18.9168 s, 114 MB/s

11.6 设置调速散热风扇

散热风扇使用PWM来实现自动调速，会根据当前的CPU温度来决定风扇的开关，以及风扇的转速，如果当前的CPU温度不高，风扇会被关闭或者以较低转速旋转 (减少不必要的环境噪声)，
如果你想让风扇立即开始工作，可以用以下命令让CPU立即以高负载运行，以便观察风扇的工作状态：

cpuburn

如果你想改变风扇的调速行为，请修改以下文件：

/usr/bin/fa-fancontrol.sh         # 入口，被pwm-fan.service服务调用，分两种情况控制风扇，由内核控制风扇，或者用户空间通过操作PWM控制风扇
/usr/bin/fa-fancontrol-direct.sh  # 用户空间通过操作PWM控制风扇的脚本，可控制风速等，此脚本由上面的脚本调用

需要禁止开机自动启动风扇（比如你需要连接其他的PWM设备），请输入以下命令：

systemctl stop pwm-fan
systemctl disable pwm-fan

或者删除下面这两个文件：

/etc/systemd/system/pwm-fan.service
/etc/systemd/system/multi-user.target.wants/pwm-fan.service

11.7 Linux下使用4G EC20模块

请参考: How to use 4G Module on NanoPC-T4/zh

12 Buildroot Linux系统的使用

Buildroot是Linux平台上一个构建嵌入式Linux系统的框架，由Makefile脚本和Kconfig配置文件构成，旨在简化系统制作步骤，可实现一站式生成可烧写的系统固件，最终的固件包含boot-loader、kernel和rootfs，以及rootfs中的各种库和应用程序 (例如qt, gstreamer, busybox等)。

由 FriendlyELEC 提供的 Buildroot 项目是基于Rockchip原厂的 linux-sdk 制作, 项目使用 git 管理，与原厂的linux sdk更新保持同步;

• Rockchip原厂Buildroot项目: https://github.com/rockchip-linux/buildroot
  
• Buildroot官网: https://buildroot.org

Buildroot for rockchip运行界面如下：

关于Buildroot系统更详细的说明，请参考: Buildroot

13 Lubuntu 系统的使用

看这里: Lubuntu desktop 16.04 for RK3399/zh
Lubuntu下使用NVME SSD: How to Initialize and Format New SSD And HDD

14 Android8.1 系统的使用

我们为 SOM-RK3399 提供了完善的Android8.1 BSP，代码使用 gitlab.com 平台管理，完全开源，支持GPU加速和VPU硬件加速。

14.1 使用MIPI摄像头进行拍照和录像

SOM-RK3399在Android系统下，可以搭配 MIPI摄像头CAM1320 进行拍照和录像，操作比较简单，连接摄像头到SOM-RK3399的MIPI接口，开机进入 Android 系统，用系统自带的 Camera 应用即可完成拍照和录像，操作跟 Android 手机是一样的。

14.2 使用双MIPI摄像头预览与录像

从github下载以下示例源代码，并用 Android studio 编译并运行：

git clone https://github.com/friendlyarm/Dual-Camera.git -b working-branch

应用安装后，需要设置Android权限才能让程序正常运行，方法是在开发板的Android系统里进入 Settings -> Apps & notifications -> Dual Camera -> Permissions 钩选以下权限：

Camera
Microphone
Storage

最终运行效果如下：

点击界面上的 "CAPTURE VIDEO" 按钮即可录制视频（同时录两个摄像头），录制的视频保存到以下位置：/storage/emulated/0/Download/dualcamera_h264.mp4，电脑上可以用以下adb命令下载到本地：

adb pull /storage/emulated/0/Download/dualcamera_h264.mp4

已知问题：
录制的视频文件，播放时会比正常的快，可能需要调整mediacodec的某些参数

14.3 切换系统语言

Android系统默认的系统语言是英文，比如我们要设置为中文，步骤如下： 1) 进入 Android 设置：Settings -> System -> Languages & Input -> Languages;
2）点击"Add a language", 在列表中选择 "简体中文"，再选择 "中国";
3) 这时列表中会有中文和英文两种语言，拖动中文那一项到列表的最上面即可，注意，如果你使用的是鼠标，拖动的方法是：将鼠标指针放在列表项右边的图标上，然后按下鼠标中键来拖动;

14.4 Android8.1 硬件访问

开发者可以通过FriendlyThings SDK在Android App中访问和控制主板上的各种硬件资源，比如Uart, SPI, I2C, GPIO等接口，详情可参考以下两份文档：

• Android: FriendlyThings for Rockchip
• Android: FriendlyThings APIs

14.5 Android神经网络 NN SDK示例

Android8.1 BSP中包含了支持GPU加速的Android NN SDK，为了方便测试，Android8固件中也预装了原厂提供的Android NN示例程序：TfLiteCameraDemo，这是一个使用Rockchip AndroidNN GPU加速的MobileNet分类器Demo，运行时需要连接摄像头模块，USB和CSI摄像头都是支持的，通过点击 “TfLiteCameraDemo”图标进入示例，其运行效果如下所示：


关于Android NN SDK的详细描述，可以去网上参考原厂的文档
TfLiteCameraDemo示例源代码下载地址：[TfLiteCameraDemo源代码]

14.6 如何使用adb(Android Debug Bridge)

14.6.1 在Windows10下使用adb

1. 准备一个烧写好安卓系统的 SOM-RK3399 ，一条Typc-C数据线
2. 在dl.friendlyelec.com找到 SOM-RK3399 的网盘，进入后下载Tools文件夹下的adb.zip

3. 解压adb.zip

4. 按win+R打开“运行”窗口，输入“cmd”打开命令行工具

5. 在命令行工具输入以下命令转到adb工具的所在路径：

cd c:\adb

6. 输入以下命令会出现adb的版本信息和使用说明，说明adb可用：

adb

7. 把烧写好安卓系统的 SOM-RK3399 接上电源，用Type-C数据线连接 SOM-RK3399 和电脑，然后在命令行工具输入：

adb devices

可看到返回的设备信息，说明Win10已经通过adb检测到 SOM-RK3399 ，之后可以在Win10下对设备进行操作

8. 尝试在Win10下使用命令在设备上安装安卓应用，下载一个APK文件，然后输入“adb install 文件名.apk”，如：

adb install QQ_Android_8.3.6.apk

看到“Success”的提示即安装成功

14.6.2 在Ubuntu下使用adb

1. 把烧写好安卓系统的 SOM-RK3399 接上电源，用Type-C数据线连接 SOM-RK3399 和电脑，打开“终端”

2. 输入以下命令安装adb工具，这时要求输入用户密码：

sudo apt-get install android-tools-adb

3. 安装过程中弹出下载提示，输入“Y”然后按Enter确认

等待安装完成

4. 在命令行工具输入以下命令查看设备：

adb devices

可看到返回的设备信息，说明Ubuntu已经通过adb检测到 SOM-RK3399

14.6.3 adb下修改系统文件

1. 第一次启动系统，如果需要更改系统文件，需要关闭安全验证 (注：安装apk不需要关闭)，关闭安全验证后需要重启

adb root
adb disable-verity
adb reboot

2. 重启后，获得root权限，并重新挂载 /system 开启写入权限

adb root
adb remount

3. 上传文件

adb push example.txt /system/

14.6.4 注意事项

部分电脑USB端口可能供电不足，如使用NanoPi M4系列请使用PSU Module供电

14.7 HDMI分辨率、边界调节

如果连接了HDMI显示设备，可进入 Android 的 Settings -> Display -> Advanced -> HDMI & Rotation 进行设置。

HDMI Resolution	缺省为 Auto，可手动设置显示分辨率，最高可支持 4K 分辨率
Screen Zoom	用户可观察红色边框的显示，点击中间的4个箭头按钮来进行缩放调节
Display Rotation	可进行横竖屏切换

14.8 屏幕旋转

使用HDMI与LCD作为显示设备时，如果需要旋转屏幕，可进入 Android 的 Settings -> Display -> Advanced -> HDMI & Rotation -> Display Rotation 进行设置。

在 adb shell 用命令来测试屏幕旋转 (不会保存设置)：

wm rotation 90

14.9 隐藏Navigation bar

进入设置界面 Settings -> Accessibility，启用 Immersive Mode，然后再打开你的 Android应用，例如 Lightning，你会发现它将处于全屏状态。

14.10 切换音频输出通道

可以配置音频输出到HDMI或者耳机接口，设置入口：Android 的 Settings -> Accessibility -> Force audio output。 如果 Force audio output菜单项是灰色的，即处于不可选择的状态，说明你所用的硬件会自动检测耳机插拨状态，并自动切换音频通道，无需设置。

14.11 调整录音的音量

1) 先通过串口或adb shell，以root用户权限使用amix 命令调节录音的音量，例如:

amix "IN2 Boost"
amix "ADC Capture Volume"

以上命令用于查看当前的设置，然后便可根据支持的值来调节并测试。
2) 调试好后，修改 hardware/rockchip/audio/tinyalsa_hal/codec_config/rt5651_config.h 文件中 rt5651_main_mic_capture_controls 数组中对应配置项的值，编译Android源代码并测试。

14.12 定制开关机界面与动画

14.12.1 开启与关闭

将 device/rockchip/common/BoardConfig.mk 文件的
BOOT_SHUTDOWN_ANIMATION_RINGING := false
改为
BOOT_SHUTDOWN_ANIMATION_RINGING := true
来打开编译时将文件打包进固件的功能

14.12.2 开机动画

创建或替换Android源代码目录下的如下文件：
kernel/logo.bmp
kernel/logo_kernel.bmp
device/rockchip/common/bootshutdown/bootanimation.zip

14.12.3 关机动画

创建或替换Android源代码目录下的如下文件：
device/rockchip/common/bootshutdown/shutdownanimation.zip

14.12.4 动画制作方法

请参考：http://blog.sina.com.cn/s/blog_4960586c0100vu5v.html

14.13 移除Google框架

如果不需要使用google服务，可以删除Google框架以节约系统资源，方法是删除Android源代码中的以下目录，然后重新编译Android:
vendor/google

14.14 用摇控器操作Android

SOM-RK3399在Android下完美支持 FriendlyARM RC-100 红外遥控器，更方便SOM-RK3399在接电视的场景下使用，遥控器按键功能丰富:


按键定义与功能如下表所示：

按键	功能
上	导航键-上
下	导航键-下
左	导航键-左
右	导航键-右
OK	确认
-	音量-
+	音量+
静音	静音
菜单	Android菜单键
首页	Android Home键
返回	Android 返回键
F1	下拉Android 通知栏
F2	Android 截屏
F3	切换操作模式，在鼠标模式与按钮模式之间切换

14.15 使用USB摄像头进行拍照和录像

Android系统同时支持USB摄像头拍照和录像，使用系统自带的 Camera 应用即可，有两点需要注意的地方：
1）需要根据摄像头规格，选择合适的录像分辨率，可以先选择较低的CIF分辨率，测试OK之后再尝试更高的分辨率，设置界面如下所示：
;
2）USB摄像头不能与MIPI摄像头同时使用，也不能热拨插，插入摄像头后需要重新开机才能识别;

我们测试过的USB摄像头型号如下：罗技C270，罗技C922 PRO,
实测罗技C922 PRO录像和拍照可以达到1080P分辨率。

14.16 Android下使用4G模块EC20

14.16.1 连接方法

连接时，需要通过USB to miniPCIe转接板转接EC20，再连接到主板的USB Host端口，如下图所示：

连接后无需额外的配置，启动Android后就可以使用4G上网了，跟Android手机类拟。

14.16.2 启用EC20的GPS功能

默认情况下，Android的GPS功能是关闭的 (原因是Android在没有找到任何GPS模块的情况下，会不停的打印LOG信息），在你连接了EC20模块后，就可以开启GPS了。
开启方法是修改Android源代码下的 vendor/quectel/ec20/BoardConfigPartial.mk 文件，将下面这行：

BOARD_HAS_GPS := false

改为

BOARD_HAS_GPS := true

然后重新编译 Android。

14.17 Android下使用NVME SSD高速固态硬盘

14.17.1 第一步：格式化SSD为单分区ext4格式

此操作可以在电脑上进行，也可以在开发板的 linux 系统里进行。

为了方便操作，请在终端上先用以下命令切换为 root 用户：

su -

root用户的默认密码是fa。

14.17.1.1 检查是否检测到了SSD

root@FriendlyELEC:~# cat /proc/partitions 
major minor  #blocks  name
   1        0       4096 ram0
 259        0  125034840 nvme0n1

看到有 nvme0n1 设备的节点，说明SSD已经成功被识别到了。

14.17.1.2 给SSD重新分区

为了让 Linux 系统能成功能挂载，我们选择给 SSD 重新分区，下面的命令会自动将 SSD 整个空间分成一个区：

(echo o; echo n; echo p; echo 1; echo ""; echo ""; echo w; echo q) | fdisk /dev/nvme0n1

如果要分多个区，可以用 fdisk /dev/nvme0n1 命令，参考 fdisk的文档来操作。

14.17.1.3 将分区格式化为 ext4 格式

上一个步骤分区完成后，我们再用 cat /proc/partitions 命令看一下当前的分区信息，在下面的结果中，可用于存储数据的分区设备名为 /dev/nvme0n1p1 :

root@FriendlyELEC:~# cat /proc/partitions
major minor  #blocks  name
 
   1        0       4096 ram0
 259        0  125034840 nvme0n1
 259        2  125033816 nvme0n1p1

下面的命令将该分区格式化为 ext4 格式，其中-L参数指定SSD分区的名称，这个名称会在Android界面上显示：

mkfs.ext4 /dev/nvme0n1p1 -L SSD

14.17.2 第二步：Android开机自动挂载

只要SSD已经被正确地格式化，Android就会自动挂载SSD为外置存储设备，无需额外的设置，打开Android内置的Files应用，可以看到SSD设备已经挂载：

第三方的软件可以正常识别SSD，如下图中的迅雷下载软件，可以设置将文件默认下载到SSD上：

14.18 设置调速散热风扇

散热风扇使用PWM来实现自动调速，会根据当前的CPU温度来决定风扇的开关，以及风扇的转速，如果当前的CPU温度不高，风扇会被关闭或者以较低转速旋转 (减少不必要的环境噪声)，如果你想改变风扇的调速行为，请修改Android bsp源代码中的以下文件：

device/rockchip/rk3399/nanopc-t4/pwm_fan.sh

需要禁止开机自动启动风扇（比如你需要连接其他的PWM设备），请修改Android bsp源代码中的以下文件：

device/rockchip/rk3399/init.rk3399.rc

对源代码做了修改后，需要重新编译Android。

15 Android7.1 系统的使用

看这里: Android7

16 如何编译系统

16.1 搭建编译环境

16.1.1 方法1: 使用Docker进行交叉编译

请参考 docker-cross-compiler-novnc，也可使用网盘 “04_SDK与编译器/docker” 目录下的本地镜像，参考README.md用docker load命令导入即可。

16.1.2 方法2: 本地搭建交叉编译环境

16.1.2.1 安装编译所需软件包

建议使用amd64架构的Ubuntu 20.04操作系统,参考如下内容安装编译及打包所需要的软件包：

sudo apt-get -y update
sudo apt-get install -y sudo curl
sudo bash -c \
  "$(curl -fsSL https://raw.githubusercontent.com/friendlyarm/build-env-on-ubuntu-bionic/master/install.sh)"

对于中国大陆的用户亦可使用以下地址：

sudo bash -c \
  "$(curl -fsSL http://112.124.9.243:3000/friendlyelec/build-env-on-ubuntu-bionic/raw/branch/cn/install.sh)"

你的电脑上会安装好如下交叉编译器:

16.1.2.2 设置交叉编译器

参考上一节的表格，选用合适版本的编译器，然后将编译器的路径加入到PATH中，例如要使用11.3的交叉编译器，用vi编辑~/.bashrc，在末尾加入以下内容：

export PATH=/opt/FriendlyARM/toolchain/11.3-aarch64/bin:$PATH
export GCC_COLORS=auto

执行一下~/.bashrc脚本让设置立即在当前shell窗口中生效，注意"."后面有个空格：

. ~/.bashrc

验证是否安装成功：

$ aarch64-linux-gcc -v
Using built-in specs.
COLLECT_GCC=aarch64-linux-gcc
COLLECT_LTO_WRAPPER=/opt/FriendlyARM/toolchain/11.3-aarch64/libexec/gcc/aarch64-cortexa53-linux-gnu/11.3.0/lto-wrapper
Target: aarch64-cortexa53-linux-gnu
Configured with: /home/cross/arm64/src/gcc/configure --build=x86_64-build_pc-linux-gnu --host=x86_64-build_pc-linux-gnu --target=aarch64-cortexa53-linux-gnu --prefix=/opt/FriendlyARM/toolchain/11.3-aarch64 --exec_prefix=/opt/FriendlyARM/toolchain/11.3-aarch64 --with-sysroot=/opt/FriendlyARM/toolchain/11.3-aarch64/aarch64-cortexa53-linux-gnu/sysroot --enable-languages=c,c++ --enable-fix-cortex-a53-843419 --with-arch=armv8-a+crypto+crc --with-cpu=cortex-a53 --with-pkgversion=ctng-1.25.0-119g-FA --with-bugurl=http://www.friendlyelec.com/ --enable-objc-gc --enable-__cxa_atexit --disable-libmudflap --disable-libgomp --disable-libssp --disable-libquadmath --disable-libquadmath-support --disable-libsanitizer --disable-libmpx --with-gmp=/home/cross/arm64/buildtools --with-mpfr=/home/cross/arm64/buildtools --with-mpc=/home/cross/arm64/buildtools --with-isl=/home/cross/arm64/buildtools --enable-lto --enable-threads=posix --disable-libstdcxx-pch --enable-clocale=gnu --enable-libstdcxx-time=yes --with-default-libstdcxx-abi=new --enable-gnu-indirect-function --enable-gnu-unique-object --enable-default-pie --enable-linker-build-id --with-linker-hash-style=gnu --enable-plugin --enable-gold --with-libintl-prefix=/home/cross/arm64/buildtools --disable-multilib --with-local-prefix=/opt/FriendlyARM/toolchain/11.3-aarch64/aarch64-cortexa53-linux-gnu/sysroot --enable-long-long --enable-checking=release --enable-link-serialization=2
Thread model: posix
Supported LTO compression algorithms: zlib
gcc version 11.3.0 (ctng-1.25.0-119g-FA)

16.2 编译 Openwrt/Friendlywrt

16.2.1 下载源代码

FriendlyWrt有两个版本, 请根据需要进行选择.

16.2.1.1 版本FriendlyWrt 21.02

mkdir friendlywrt21-rk3399
cd friendlywrt21-rk3399
git clone https://github.com/friendlyarm/repo --depth 1 tools
tools/repo init -u https://github.com/friendlyarm/friendlywrt_manifests -b master-v21.02 \
        -m rk3399.xml --repo-url=https://github.com/friendlyarm/repo  --no-clone-bundle
tools/repo sync -c  --no-clone-bundle

16.2.1.2 版本FriendlyWrt 23.05

mkdir friendlywrt23-rk3399
cd friendlywrt23-rk3399
git clone https://github.com/friendlyarm/repo --depth 1 tools
tools/repo init -u https://github.com/friendlyarm/friendlywrt_manifests -b master-v23.05 \
        -m rk3399.xml --repo-url=https://github.com/friendlyarm/repo  --no-clone-bundle
tools/repo sync -c  --no-clone-bundle

16.2.2 首次编译

下面的命令是编译不带docker的版本, 如需要编译带docker的版本, 请将rk3399.mk替换为rk3399-docker.mk:

./build.sh rk3399.mk

会编译所有组件（包含u-boot, kernel 和 friendlywrt）并生成sd卡镜像文件,再执行以下命令,可生成用于安装系统到emmc运行的镜像文件(eflahser固件):

./build.sh emmc-img

对项目进行过修改后, 需要重新打包sd卡镜像, 可执行如下命令:

./build.sh sd-img

16.2.3 二次编译

cd friendlywrt
make menuconfig #改动FriendlyWrt的配置
rm -rf ./tmp
make -j${nproc}
cd ../
./build.sh sd-img
./build.sh emmc-img

16.2.4 单独编译u-boot

./build.sh uboot

16.2.5 单独编译kernel

./build.sh kernel

16.2.6 单独编译friendlywrt

./build.sh friendlywrt

或者进入friendlywrt目录, 按标准openwrt的命令操作, 上面的命令出现错误时, 可尝试使用以下命令单线程编译:

cd friendlywrt
make -j1 V=s

16.3 编译Buildroot

请参考: Buildroot

16.4 其他Linux系统编译

16.4.1 各个OS对应的内核与u-boot版本

• 内核源代码仓库地址：https://github.com/friendlyarm/kernel-rockchip
• u-boot源代码仓库地址：https://github.com/friendlyarm/uboot-rockchip
• 交叉编译工具链存放在如下路径： /opt/FriendlyARM/toolchain/，使用前需导出到PATH环境变量,例如需要使用11.3-aarch64版本的编译器，使用如下命令:

export PATH=/opt/FriendlyARM/toolchain/11.3-aarch64/bin/:$PATH

• sd-fuse构建脚本可以用于快速编译kernel和uboot、重新打包sd卡固件与卡刷固件等
• 点击表格中的MBR与GPT可查看各系统的分区布局(配置文件)

16.4.2 编译内核linux-v4.4.y

本节内容适用于如下OS:

下载源代码并编译:

git clone https://github.com/friendlyarm/kernel-rockchip --single-branch --depth 1 -b nanopi4-linux-v4.4.y kernel-rockchip
cd kernel-rockchip
export PATH=/opt/FriendlyARM/toolchain/6.4-aarch64/bin/:$PATH
touch .scmversion
# 配置内核
make ARCH=arm64 CROSS_COMPILE=aarch64-linux- nanopi4_linux_defconfig
# 启动配置界面
# make ARCH=arm64 CROSS_COMPILE=aarch64-linux- menuconfig
# 编译内核
make ARCH=arm64 CROSS_COMPILE=aarch64-linux- nanopi4-images -j$(nproc)
# 编译驱动模块
mkdir -p out-modules
make ARCH=arm64 CROSS_COMPILE=aarch64-linux- INSTALL_MOD_PATH="$PWD/out-modules" modules -j$(nproc)
make ARCH=arm64 CROSS_COMPILE=aarch64-linux- INSTALL_MOD_PATH="$PWD/out-modules" modules_install
KERNEL_VER=$(make CROSS_COMPILE=aarch64-linux-gnu- ARCH=arm64 kernelrelease)
rm -rf $PWD/out-modules/lib/modules/${KERNEL_VER}/kernel/drivers/gpu/arm/mali400/
[ ! -f "$PWD/out-modules/lib/modules/${KERNEL_VER}/modules.dep" ] && depmod -b $PWD/out-modules -E Module.symvers -F System.map -w ${KERNEL_VER}
(cd $PWD/out-modules && find . -name \*.ko | xargs aarch64-linux-strip --strip-unneeded)