NanoPi R2C Plus/zh

English

1 介绍
2 NanoPi R2C资源特性
3 接口布局和尺寸
- 3.1 接口布局
4 快速入门
5 FriendlyWrt的使用
6 FriendlyCore的使用
7 如何编译系统
- 7.1 编译 Openwrt/Friendlywrt
  - 7.1.1 下载源代码
  - 7.1.2 开始编译
- 7.2 单独编译u-boot,kernel或friendlywrt
8 更多OS
- 8.1 DietPi
9 资源链接
- 9.1 手册原理图等开发资料
10 更新日志

1 介绍

概览

正面

背面

外壳

NanoPi R2C（以下简称R2C）是友善电子团队最新推出的一款实现满速率双千兆的、完全开源的Iot应用神器。
NanoPi R2C 使用RK3328 CPU，有两个千兆网络，1G DDR4内存，友善电子团队为NanoPi R2C专门移植了OpenWrt系统，支持Docker CE, 完全开源，用于企业物联网二次开发，个人定制NAS，家庭物联网网关等。

2 NanoPi R2C资源特性

CPU: Rockchip RK3328, Quad-core Cortex-A53
DDR4 RAM: 1GB
Network：
- 10/100/1000M以太网口 x 1
- USB3.0转10/100/1000M以太网口 x 1
USB2.0 Host: Type-A x1
MicroSD Slot x 1
MicroUSB: 供电和Slave功能
Debug Serial Port: 3.3V TTL电平，3Pin 2.54mm间距排针
LED: LED x 3
KEY: KEY x 1 用户自定义功能
PC Size: 55.6 x 52mm
Power Supply: DC 5V/2A
Temperature measuring range: 0℃ to 80℃
OS/Software: U-boot，Ubuntu-Core，OpenWrt

实测网络速率

	TX	RX
WAN	941 Mbps	941 Mbps
LAN	941 Mbps	941 Mbps
Notes：	1、测试工具：iperf 2、使用独立IP地址段和PC机单向通讯测试

3 接口布局和尺寸

3.1 接口布局

GPIO 24Pin管脚定义

Pin#	Name	Linux gpio	Pin#	Name	Linux gpio
1	SYS_3.3V		2	VDD_5V
3	I2C0_SDA / GPIO2_D1	89	4	VDD_5V
5	I2C0_SCL / GPIO2_D0	88	6	GND
7	GPIO2_A2 / IR_RX	66	8	UART1_TX / GPIO3_A4	100
9	GND		10	UART1_RX / GPIOG3_A6	102

更详细的信息请查看原理图：NanoPi_R2C_2107_SCH.pdf

详细PCB尺寸图：NanoPi_R2C_2107_PCB_DXF.zip

4 快速入门

4.1 准备工作

要开启你的NanoPi R2C新玩具，请先准备好以下硬件

NanoPi R2C主板
MicroSD卡/TF卡: Class10或以上的 8GB SDHC卡
一个MicroUSB接口的外接电源，要求输出为5V/2A（可使用同规格的手机充电器）
一台电脑，需要联网，建议使用Ubuntu 16.04 64位系统

4.2 经测试使用的TF卡

制作启动NanoPi R2C的TF卡时，建议Class10或以上的 8GB SDHC卡。以下是经友善电子测试验证过的高速TF卡：

SanDisk闪迪 TF 8G Class10 microSD 高速 TF卡：

SanDisk闪迪 TF 128G 至尊高速 Class10 microSDXC TF 128G 48MB/S:

川宇 8G手机内存卡 TF 8G 卡存储卡 C10 高速 Class10 microSD卡：

4.3 串口调试

用screen登入串口调试：

screen /dev/ttyUSB0 1500000 8N1

4.4 安装系统

4.4.1 下载系统固件

首先访问下载地址下载需要的固件文件(officail-ROMs目录)和烧写工具(tools目录)：

使用以下固件：
rk3328-sd-friendlycore-lite-bionic-5.10-arm64-YYYYMMDD.img.zip	UbuntuCore 20.04系统固件，使用 Linux-5.10 内核
rk3328-sd-friendlywrt-5.10-YYYYMMDD.img.zip	基于 OpenWrt 构建的 FriendlyWrt 系统固件，使用 5.10 内核
烧写工具：
win32diskimager.rar	Windows平台下的系统烧写工具，Linux平台下可以用dd命令烧写系统

4.4.2 烧写Linux系统

4.4.2.1 烧写到TF卡

FriendlyCore / FriendlyWrt 等系统都属于 Linux 系统，所以它们的烧写方法是一样。
将 Linux 系统固件和烧写工具 win32diskimager.rar 分别解压，在 Windows 下插入TF卡（限4G及以上的卡)，以管理员身份运行烧写工具 win32diskimager，在烧写工具 win32diskimager 的界面上，选择你的TF卡盘符，选择Linux 系统固件，点击 Write 按钮烧写。

成功烧写后，会看到如下界面：

当制作完成TF卡后，拔出TF卡插入 BOOT 卡槽，上电启动（注意，这里需要5V/2A的供电），你可以看到STAT灯闪烁，这时你已经成功启动系统。;

5 FriendlyWrt的使用

5.1 FriendlyWrt简介

FriendlyWrt是友善电子基于OpenWrt定制的系统，完全开源，用于企业物联网二次开发，个人定制NAS等。

5.2 首次开机的初始化

首次上电开机，系统需要做以下一些初始化工作：
1）扩展根文件系统
2）初始化设置（会执行/root/setup.sh)
所以第一次开机需要等待片刻（约2～3分钟），再对FriendlyWrt进行设置，可以在openwrt网页上进入ttyd终端，当提示符显示为 root@FriendlyWrt 表示系统已经初始化完成。

root@FriendlyWrt

5.3 帐户与密码

默认的密码是password(某些版本是空密码），请设置或更改一个较安全的密码用于web登录与ssh登录，建议在将NanoPi-R2C连接到互联网之前完成此设置。

5.4 登录FriendlyWrt

将电脑连接到 NanoPi-R2C 的LAN口，如果电脑没有网口，可将无线AP的LAN口与NanoPi-R2C的LAN口相连接，电脑再通过WiFi连接到无线AP，在电脑浏览器上输入以下网址即可进入FriendlyWrt管理页面:

http://friendlywrt/
http://192.168.2.1/
http://[fd00:ab:cd::1]

以上是NanoPi-R2C的LAN口地址，WAN口会从你的主路由器动态获取IP地址。

5.5 建议的安全性设置

以下设置事项非常建议在将 NanoPi-R2C 接入互联网之前完成，因为在空密码或弱密码的状态下将NanoPi-R2C接入互联网，极易受到网络攻击。

设置一个安全的密码

进入系统->管理权界面设置密码。

禁止从wan访问ssh，更换端口

进入系统->管理权->SSH访问，将接口限制为 lan，将端口设置为其他非常用端口，例如 23333。

检查防火墙设置

根据实际情况调整设置

5.6 更改LAN口的IP地址

1) 菜单栏导航到："网络" -> "接口", 点击“LAN”右边的“编辑”按钮;
2) 在“常规设置”页面上找到“IPv4 地址”, 输入新的IP地址 (例如192.168.11.1), 然后点击“保存”, 再点击“保存并应用”;
3) 在弹出的“连接更改“询问界面上, 选择"Apply and revert on connectivity loss";
4) 稍等片刻, 在电脑的浏览器上输入新的地址登录 FriendlyWrt;

5.7 安全的关机操作

进入"服务"->"终端"，输入poweroff命令敲回车，待led灯熄灭，再拔开电源。

5.8 恢复出厂设置

进入"系统"->"备份/升级"，点击“执行重置“按钮,在弹出的询问界面上点击“确定”,设备会重启并擦除data分区, 所有的设置和数据都会被清除, 并恢复至出厂时的状态。
恢复出厂设置也可以通过命令行来操作, 进入“服务”-》“终端”界面, 输入如下命令:

firstboot && reboot

5.9 安装软件包

5.9.1 设置第三方软件源

进入菜单”系统“-》”软件包“, 在界面上点击”okpg配置“按钮, 在新弹出的界面上, 更改/etc/opkg/distfeeds.conf的文件内容即可,
比如要切换至国内腾讯源, 可以替换成如下内容, 然后点击 “保存” 按钮:

src/gz openwrt_base https://mirrors.tuna.tsinghua.edu.cn/openwrt/releases/23.05.4/packages/aarch64_cortex-a53/base
src/gz openwrt_luci https://mirrors.tuna.tsinghua.edu.cn/openwrt/releases/23.05.4/packages/aarch64_cortex-a53/luci
src/gz openwrt_packages https://mirrors.tuna.tsinghua.edu.cn/openwrt/releases/23.05.4/packages/aarch64_cortex-a53/packages
src/gz openwrt_routing https://mirrors.tuna.tsinghua.edu.cn/openwrt/releases/23.05.4/packages/aarch64_cortex-a53/routing
src/gz openwrt_telephony https://mirrors.tuna.tsinghua.edu.cn/openwrt/releases/23.05.4/packages/aarch64_cortex-a53/telephony
src/gz friendlywrt_packages file://opt/packages

注意, friendlywrt_packages需要保留, 否则会缺少一些系统依赖;
如果你使用的是 friendlywrt 21.02 的固件, 则将上面的 23.05.4 替换成 21.02.5;
CPU架构可选择 aarch64_cortex-a53和aarch64_generic这两种;
通过命令行切换国内源:

sed -i -e 's/downloads.openwrt.org/mirrors.cloud.tencent.com/g' /etc/opkg/distfeeds.conf
opkg update

5.9.2 在线安装软件包

回到”软件包“界面, 点击 “更新列表” 更新软件包信息, 更新完成后, 就可以在“筛选器”一栏中输入软件包的关键字, 搜索软件包安装了。

5.9.3 安装离线ipk软件包

在”软件包“界面上点击“上传软件包“, 定位你本地的ipk文件, 上传并安装即可。

5.10 FriendlyWrt的一些常见问题

无法拨号上网
- 进入“网络“->“防火墙“，将 “WAN区域“ 的“入站数据“，“出站数据“与“转发“均设置为 “接受”;
- 如仍无法上网，可尝试关闭IPV6;
拨号成功,但没有外网流量
- 进入"服务"->"终端"，输入fw4 reload尝试重新加载一次防火墙设置;
无法开机，LED灯不亮
- 尝试更换电源适配器和电缆，推荐使用 5V/2A 以上规格的电源供应;
- 注意，部分Type-C接口的快速充电器会有延迟，可能需要几秒钟才开始提供电量;
做二级路由时，电脑无法连接互联网
- 如果你的主网络是IPv4，而NanoPi-R2C工作在IPv6，电脑有可能无法连接互联网，建议关闭IPv6 (本WiKi后面有介绍方法)，或将主路由切换到IPv6;
如果你有问题，或有更好的建议，欢迎发送邮件到 techsupport@friendlyarm.com;

5.11 禁用IPv6

要关掉 IPv6，可在ssh终端输入如下命令：

. /root/setup.sh
disable_ipv6
reboot

待NanoPi-R2C重启完毕，电脑也需要重新插拨一下网线（或重启网络端口）以便重新获得IP地址。

5.12 配置用户按键的功能

默认情况下, 用户按键配置成用于重启设备(软重启), 如下所示:

echo 'BTN_1 1 /sbin/reboot' >> /etc/triggerhappy/triggers.d/example.conf

你可以通过更改上面的配置文件改变它的行为.

5.13 配置移远EC20（4G模块）拨号上网

进入“网络“->“接口“;
点击 “WAN6“ 后面的 “删除“, 点击 "保存及应用";
点击 “WAN“ 后面的 “编辑“，在 “设备“ 下拉选单中选择 "以太网适配器：wwan0"，在“协议”下拉选单中选择“QMI蜂窝”，然后点击“切换协议“;
在“调制解调器设备“下拉选单中选择”/dev/cdc-wdm0“，如果是中国联通，在“APN“中填入3gnet，如果是中国移动则填入cmnet，填写完成后，如下图所示：

点击“保存”关闭界面，最后点击下方的“保存并应用"，FriendlyWrt后台会进行拨号上网，拨号成功的状态如下所示:

连接到Lan的设备将可以连接互联网，如有WiFi模块，可进入“无线”界面开启无线AP功能，通过无线接入的设备亦可连接到互联网。

5.14 使用USB2LCD查看IP和温度

在终端输入如下命令设置lcd2usb服务开机自动启动：

. /root/setup.sh
init_lcd2usb
poweroff

将USB2LCD模块Plug到 NanoPi-R2C 的USB接口再开机，IP地址和CPU温度将显示在LCD上：

5.15 如何使用USB WiFi

5.15.1 如何在终端使用命令查询USB无线网卡型号

(1) 点击“服务>ttyd”进入FriendlyWrt的命令行界面

(2) 在开发板没有插入任何USB设备时输入以下命令以查看挂在USB主线上的现有设备

lsusb

(3) 插入USB WiFi，再次输入以下命令

lsusb

可以看到多出一个设备，ID为0BDA:C811

(4) 以“0BDA:C811”或“VID_0BDA&PID_C811”作为关键词在搜索引擎上搜索，搜索结果显示VID_0BDA&PID_C811的对应WIFI芯片为Realtek 8811CU

5.15.2 如何使用USB WiFi作为AP

(1) 把USB WiFi插入NanoPi-R2C的USB端口，推荐使用以下列表中支持AP模式的WiFi芯片模块:

注：符合以上WiFi芯片型号并符合以上VID&PID信息的USB无线网卡都可以使用，支持的型号不局限于某个品牌某个型号
(2) 插入USB WiFi后，点击上方菜单栏的“系统>重启”，点击“执行重启”按钮重启NanoPi-R2C

(3) 点击“网络>无线”进入配置无线WiFi界面

(4) 点击“编辑”按钮可编辑WiFi设置

(5) 在“接口配置”中可设置WiFi 模式和SSID等，然后点击到“无线安全”项可修改加密方式和WiFi密码，默认密码为password，设置完成后点击“保存”

(4) 配置完成后使用手机端或电脑端搜索对应SSID的WiFi即可

5.15.3 常见的USB WiFi问题及应对方法

1) 建议在关机状态下插入usb wifi, 再上电开机，FriendlyWrt会自动生成配置文件 /etc/config/wireless，如果没有生成，通过 ifconfig -a 看看有没有 wlan0，如果没有 wlan0，通常是没有驱动。
2) 如果 ifconfig -a 能看到 wlan0，但是热点没有正常工作，可以尝试更改频道和国家代号，不合适的国家代号也会导致 WiFi 不工作。
3) 某些USB WiFi(例如MTK MT7662)默认工作在CD-ROM模式，需要经过usb_modeswitch来进行切换，可以尝试自行添加 usb_modeswitch 配置到以下目录：/etc/usb_modeswitch.d 。

5.15.4 更改系统默认的WiFi热点配置

FriendlyWrt默认会为USB WiFi设置国家、热点名称等参数，目的是尽量的做到即插即用，但这不能保证所有的模块都能兼容此设置，你可以通过修改以下文件，来更改这些行为：

/lib/wifi/mac80211.sh

5.16 玩转Docker应用

5.16.1 Docker使用：安装JellyFin影音服务器

5.16.1.1 安装JellyFin

(1) 准备一个已烧好FriendlyWrt的NanoPi-R2C（或任意H3/RK3399 平台的友善开发板），接上电源和网线，网线接入NanoPi-R2C的WAN口； (2) 在电脑端的浏览器输入 http://friendlywrt/ 或者开发板的IP地址即可进入FriendlyWrt管理页面，默认情况下，LAN口的IP地址为192.168.2.1，WAN会从你的主路由器动态获取IP地址；

(3) 点击上方菜单栏的“服务->ttyd”进入命令行界面；

(4) 输入以下命令安装JellyFin：创建一个目录用于存放 JellyFin 的配置：

mkdir -p /jellyfin/config

创建一个专门供JellyFin访问的目录，存放影片和视频：

mkdir -p /jellyfin/videos

然后安装JellyFin，请耐心等待安装过程：

docker run --restart=always -d -p 8096:8096 -v /jellyfin/config:/config -v /jellyfin/videos:/videos jellyfin/jellyfin:10.1.0-arm64 -name myjellyfin

主要参数说明：
8096:8096：指定端口号为 8096，安装完后，可能通过 http://路由器IP:8096 访问jellyFin
/jellyfin/videos：指定用于存放影片的目录，本地目录为 /jellyfin/videos，在jellyFin界面上可以通过路径 /videos访问到这些影片

(5) 等到可再次操作命令行界面时即完成安装，如下图：

5.16.1.2 为JellyFin添加媒体库

(1) 在浏览器输入NanoPi-R2C的IP地址+端口8096 进入JellyFin界面：
如：192.168.1.126:8096

(2) 点击右上角的“设置”图标进入控制台：

(3) 点击左边的“媒体库”，然后点击“添加媒体库”：

(4) 建议打开“显示高级设置”选项，内容类型等选项根据情况选择，勾选“将媒体图像保存到媒体所在文件夹”的话JellyFin会在网上搜索电影封面等信息下载到媒体文件夹中，设置完成后点击“确定”：

(5) 设置完成后回到“控制台”，可看到“Scan media library”任务，即JellyFin正在扫描媒体库并下载媒体信息，视网络情况而定可能需要几分钟至几十分钟：

(6) 扫描完成后返回主界面，可看到媒体库已添加成功：

5.16.1.3 在JellyFin下播放媒体

5.16.1.3.1 在电脑端播放媒体

在浏览器中输入NanoPi-R2C的IP地址+端口8096 进入JellyFin，点击媒体库中其中一部影片，即可开始播放：

5.16.1.3.2 在手机端播放媒体

(1) 从应用商店下载安装JellyFin APP，打开APP输入NanoPi-R2C的IP地址+端口8096登录进入：

(2) 点击媒体库可看到库中所有影片，点击其中一部影片可查看影片详情：

(3) 点击播放按钮即可观看影片：

详细使用教程请参考： How to setup JellyFin media system on NanoPi-R2S/zh

5.16.2 Docker使用：安装个人网盘nextcloud

mkdir /nextcloud -p
docker run -d -p 8888:80  --name nextcloud  -v /nextcloud/:/var/www/html/ --restart=always --privileged=true  arm64v8/nextcloud

安装完成后，使用8888端口进行访问。

5.17 挂载外接存储设备

(1) 把移动硬盘连接NanoPi-R2C作为外接存储设备，将移动硬盘插入NanoPi-R2C的USB接口，在FriendlyWrt中点击“系统->挂载点”进入挂载点设置界面：

(2) 在界面下方找到挂载点存储设备设置，点击“添加”按钮：

(3) 在弹出的对话框中UUID一栏选中刚刚接入的移动硬盘 /dev/sda1（实际情况请根据自身设备选择，如硬盘有多个分区可能会显示sda1/sda2……等）：

(4) 在挂载点一栏中使用自定义，填入要挂载到的目标目录，这里以/jellyfin/videos 目录为例，勾选上方的“已启用”，然后点击“保存”：

(5) 设置完后点击“系统->重启”重启NanoPi-R2C使挂载点生效：

(6) 重启后再回到“挂载点”界面可看到“已挂载的文件系统”中显示刚刚挂载的移动硬盘信息，即设置成功（以后需要再新增或删减编辑挂载点都可以在下面的“挂载点”设置中操作）：
注：每次操作后都需要重启后才能生效

5.17.1 使用外接硬盘来扩展Docker可用空间

先停止docker服务:

/etc/init.d/dockerd stop

把原来的/opt目录改个名, 建一个空的/opt目录:

mv /opt /opt-old && mkdir /opt

参考章节“8 初始化NVME固态硬盘和USB移动硬盘”, 将你的硬盘格式化为ext4, 然后挂载至 /opt 目录:

输入命令 "mount | grep /opt" 确实一下硬盘被正常挂载到 /opt 下:

root@FriendlyWrt:~# mount | grep /opt
/dev/nvme0n1p1 on /opt type ext4 (rw,relatime)
root@FriendlyWrt:~#

把原来 /opt 目录下的文件复制到新的 /opt 目录:

cp -af /opt-old/* /opt/ && rm -rf /opt-old

操作完后, 重启

reboot

重启后, 进入"Docker"->"概览"页面, 查看"Docker根目录"这一行的信息, 可以确认Docke空间已扩容:

5.17.2 Docker的常见问题与解决办法

5.17.2.1 无法访问Docker提供的网络服务

解决办法:

进入 "防火墙" 的设置，把 "转发" 设置成 "接受";
关闭 ”软件流量分载“;

5.18 挂载smbfs共享资源

mount -t cifs //192.168.1.10/shared /movie -o username=xxx,password=yyy,file_mode=0644

5.19 使用Aria2下载网络资源

使用 Aria2 之前，需要先设置一个目录专门用于存放 Aria2 下载的文件，这个目录需要让aria2 用户有读写权限，如果你是挂载外部的硬盘作为下载目录，硬盘建议格式化为 ext4 格式。
下面以 /jellyfin/videos/Disk/download 目录为例，点击上方菜单栏“服务->ttyd”, 输入以下命令创建目录，并设置目录拥有者为 aria2：

mkdir -p /jellyfin/videos/Disk/download
chown aria2:aria2 /jellyfin/videos/Disk/download

(2) 点击“服务->Aria2”

(3) 勾选“已启用”复选框，将下载目录设置为/jellyfin/videos/Disk/download，然后点击“保存并应用”按钮：

(4) 保存完成后，点击 “AriaNg”即可进入 Aria2 前端界面，点击“新建”按钮即可创建下载任务：

5.20 在Windows10系统下使用WinSCP共享文件

(1)下载安装WinSCP后打开，新建一个连接，主机名填写NanoPi-R2C的IP地址，然后填写NanoPi-R2C的用户名和密码，默认用户名：root，密码为空，文件协议改为“SCP”，点击“登录”
使用WinSCP可以远程访问NanoPi-R2C并传输文件。
WinSCP下载地址：https://winscp.net/eng/download.php

(2) 登录后可看到左边是本地的目录，右边是NanoPi-R2C的文件目录，打开需要共享文件的目录，这里以/jellyfin/videos目录为例，把媒件文件拖到右边即可开始传输，等待文件传输完成：

5.21 设置Samba网络文件共享

(1)在FriendlyWrt中点击上方菜单栏的“服务->网络共享”

(2) 点击底部的“添加”按钮：

(3) 填写你要共享目录，这里以设置共享 /jellyfin/videos 目录为例(如目录文件夹有大小写请注意区分)，填写完成后点击“保存并应用”：

5.21.1 在Windows10系统下访问Samba共享

默认情况下，你的Windows10可能没有启动网络发现与共享，请先参考下面这二份文档，对你的Windows10做一些设置：
(1) 启用Samba v1/v2的访问：https://www.windowscentral.com/how-access-files-network-devices-using-smbv1-windows-10

(2) 启用网络发现：https://www.dummies.com/computers/operating-systems/windows-10/how-to-enable-network-discovery-and-configure-sharing-options-in-windows-10/

具体操作可以百度“Windows10 开启SMBv1” 与 "Win10启用网络发现"了解中文版的设置方法；
设置完成后，在资源管理器的地址栏输入 \\friendlywrt 即可访问共享目录, 用户名为root, 密码为password；

5.21.2 在OS X系统下访问Samba共享

右击 Finder 图标，选择“连接到服务器“，输入地址 smb://root@friendlywrt 后点击“连接“按钮，
在要求输入用户名与密码时，输入用户名为root, 密码为password，最后点击 mnt 即可进入 /mnt/的共享目录。

5.21.3 在Linux系统下访问Samba共享

在文件管理器的地址栏中输入 smb://root@friendlywrt 后敲回车，在提示输入密码时输入 password，最后点击 mnt 即可进入 /mnt/的共享目录。

5.22 更改Mac地址

注1：这里以更改WAN口的MAC地址为例进行说明;
注2：MAC的格式是严格的，不能胡乱编造，格式不合规的地址会导致无法接入网络，建议参考其他设备的MAC地址，做少量修改作为新的MAC地址;

新建一个服务文件 /etc/init.d/custom-mac，内容如下，其中的MAC地址，请替换成你需要更改的MAC地址，eth0更改为你想要更换MAC地址的网口（例如R2S的WAN口对应eth0)：

#!/bin/sh /etc/rc.common
# Copyright (C) 2014 OpenWrt.org
 
START=94
STOP=15
 
start() {
    ifconfig eth0 down
    ifconfig eth0 hw ether 80:1F:12:EF:BC:99
    ifconfig eth0 up
}
 
stop() {
    echo "Stop."
}

运行一下服务，测试一下MAC地址有没有按预期改变，除了用ifconfig命令查看，如果你的NanoPi的WAN口连接的是主路由器，推荐登录主路由器的后台去确认新的MAC地址是否已生效：

chmod 755 /etc/init.d/custom-mac
/etc/init.d/custom-mac start
ifconfig eth0 | grep HWaddr

如果一切正常，再执下以下命令，让该服务开机自动运行：

/etc/init.d/custom-mac enable

以后开机都会自动应用新的MAC地址了。

5.23 如何超频

5.23.1 选择合格的电源

超频使用NanoPi-R2C需要保证有稳定可靠的电源供应，这包括标称真实，质量可靠的电源适配器，以及低阻抗的Type-C连接线（通俗讲就是铜芯足够粗，旧款为MicroUSB连接线）。

5.23.2 保证散热措施

超频会令NanoPi-R2C发热增加，必须使用金属外壳进行散热，或DIY使用风扇进行主动散热。
另外TF卡也建议使用能支持高温条件下正常工作的TF卡，可以选购行车记录仪专用的TF卡;

5.23.3 超频测试固件

暂时没有NanoPi-R2C固件，请自行参考以下内容，修改内核重新进行编译。进入ssh终端，输入以下命令：

cat /sys/devices/system/cpu/cpu[04]/cpufreq/scaling_max_freq

就可以看到NanoPi-R2C已经运行在 1.51G：

5.23.4 超频前后的性能测试

测试命令：

openssl speed -evp aes-256-gcm

超频前的SSL性能（CPU主频：1.29G）：

The 'numbers' are in 1000s of bytes per second processed.
type             16 bytes     64 bytes    256 bytes   1024 bytes   8192 bytes  16384 bytes
aes-256-gcm      68976.85k   189985.39k   342481.66k   432472.75k   466349.46k   466414.25k

超频后的SSL性能（CPU主频：1.51G）：

type             16 bytes     64 bytes    256 bytes   1024 bytes   8192 bytes  16384 bytes
aes-256-gcm      80187.19k   222333.58k   399549.27k   504449.02k   542182.06k   545855.70k

可以看到aes-256-gcm该项的性能提升了16%。

5.23.5 超频方法

5.23.5.1 修改内核解锁更高的CPU频率

在FriendlyWrt Repo源代码的目录下，用vim打开以下文件：

vim kernel/arch/arm64/boot/dts/rockchip/rk3328.dtsi

在文件中搜索文本 opp-1296000000，在opp-1296000000定义后面，增加CPU频率1.51G的定义，修改后的内容如下所示：

        opp-1296000000 {
            opp-hz = /bits/ 64 <1296000000>;
            opp-microvolt = <1300000>;
            clock-latency-ns = <40000>;
        };
        opp-1512000000 {
            opp-hz = /bits/ 64 <1512000000>;
            opp-microvolt = <1450000>;
            clock-latency-ns = <40000>;
        };

修改完成后，重新编译内核，并制作SD固件：

./build.sh kernel
./build.sh sd-img

5.23.5.2 验证CPU是否超频成功

执行以下命令让CPU产生负载：

dd if=/dev/zero of=/dev/null bs=1&
dd if=/dev/zero of=/dev/null bs=1&
dd if=/dev/zero of=/dev/null bs=1&
dd if=/dev/zero of=/dev/null bs=1&

再用如下命令查看当前的CPU频率，可以看到频率已经是1.5G：

root@FriendlyWrt:~# cat /sys/devices/system/cpu/cpu[04]/cpufreq/cpuinfo_cur_freq
1512000

5.24 使用sdk编译软件包

5.24.1 安装编译环境

在64位的Ubuntu （版本18.04+）下载并运行如下脚本： How to setup the Compiling Environment on Ubuntu bionic

5.24.2 在网盘上下载并解压sdk

sdk位于网盘的toolchain目录，解压后，需要先下载feeds软件包：

tar xvf openwrt-sdk-*-rockchip-armv8_gcc-11.2.0_musl.Linux-x86_64.tar.xz
# 路径太长会导致有些包编译出错，所以这里改一下目录名
mv openwrt-sdk-*-rockchip-armv8_gcc-11.2.0_musl.Linux-x86_64 sdk
cd sdk
./scripts/feeds update -a
./scripts/feeds install -a

5.24.3 将软件包编译并打包成ipk文件

此处以mwarning的示例作为演示，下载例子的源代码（共3个分别为example1, example2, example3)，并拷到package目录：

git clone https://github.com/mwarning/openwrt-examples.git
cp -rf openwrt-examples/example* package/
rm -rf openwrt-examples/

再通过以下命令进入配置菜单:

make menuconfig

在菜单中选中以下我们要编译的软件包（默认实际上已经选中）:

"Utilities" => "example1"
"Utilities" => "example3"
"Network" => "VPN" => "example2"

退出配置菜单的界面，在提示是否保存设置时需要选择Yes，然后执下以下命令，分别编译这三个软件包：

make package/example1/compile V=99
make package/example2/compile V=99
make package/example3/compile V=99

编译成功后，可以在bin目录下找到ipk文件，如下所示：

$ find ./bin -name example*.ipk
./bin/packages/aarch64_generic/base/example3_1.0.0-220420.38257_aarch64_generic.ipk
./bin/packages/aarch64_generic/base/example1_1.0.0-220420.38257_aarch64_generic.ipk
./bin/packages/aarch64_generic/base/example2_1.0.0-220420.38257_aarch64_generic.ipk

5.24.4 将编译生成的ipk安装到NanoPi上

可以用scp命令将ipk文件上传到NanoPi上:

cd ./bin/packages/aarch64_generic/base/
scp example*.ipk root@192.168.2.1:/root/

然后用opkg命令进行安装他们：

cd /root/
opkg install example3_1.0.0-220420.38257_aarch64_generic.ipk
opkg install example1_1.0.0-220420.38257_aarch64_generic.ipk
opkg install example2_1.0.0-220420.38257_aarch64_generic.ipk

5.25 使用 GitHub Actions 编译 FriendlyWrt

项目地址: https://github.com/friendlyarm/Actions-FriendlyWrt

5.26 Compile u-boot,kernel or friendlywrt

Refer to：
- sd-fuse_rk3328
- How to Build FriendlyWrt

5.27 Serial port debug

Connect to NanoPi R2C with screen :

screen /dev/ttyUSB0 1500000 8N1

6 FriendlyCore的使用

6.1 FriendlyCore默认帐户

普通用户：

   用户名: pi
   密码: pi

Root用户：

   用户名: Root用户：
   密码: fa

6.2 更新软件包

$ sudo apt-get update

6.3 配置网络

6.3.1 设置静态IP地址

默认已将 eth0 配置成 dhcp 自动获取IP地址，要更改配置，可以修改这个文件：

vi /etc/network/interfaces.d/eth0

比如修改成静态IP地址，如下所示：

auto eth0
iface eth0 inet static
    address 192.168.1.231
    netmask 255.255.255.0
    gateway 192.168.1.1

6.3.2 设置DNS

还需要修改如下文件加入DNS的配置：

vi /etc/systemd/resolved.conf

例如设置为192.168.1.1:

[Resolve]
DNS=192.168.1.1

再用以下命令重新启动systemd-resolved服务：

sudo systemctl restart systemd-resolved.service
sudo systemctl enable systemd-resolved.service

6.3.3 设置使用另一个网络接口

要配置另一个网口, 例如eth1，可以在 /etc/network/interfaces.d/ 下复制 eth0 成 eth1，然后编辑eth1, 把其中的eth0改为eth1, 根据需要指定网络配置:

cp /etc/network/interfaces.d/eth0 /etc/network/interfaces.d/eth1
vi /etc/network/interfaces.d/eth1

6.4 连接WiFi

先用以下命令检查一下系统是否有安装Network-Manager:

which nmcli

如果有安装Network-Manager, 则参考此链接的方法连接WiFi: Use NetworkManager to configure network settings/zh, 如果没有安装, 则参考如下方法配置WiFi,
输入以下命令查询一下WiFi的网络接口，wlan开头的就是WiFi:

ifconfig -a

默认情况下是wlan0，在/etc/network/interfaces.d/目录下新建一个与网络接口同名的配置文件，以wlan0为例，用vi命令新建以下文件：

sudo vi /etc/network/interfaces.d/wlan0

wlan0文件的内容如下：

auto lo
iface lo inet loopback
auto wlan0
iface wlan0 inet dhcp
wpa-driver wext
wpa-ssid YourWiFiESSID
wpa-ap-scan 1
wpa-proto RSN
wpa-pairwise CCMP
wpa-group CCMP
wpa-key-mgmt WPA-PSK
wpa-psk YourWiFiPassword

其中，YourWiFiESSID和YourWiFiPassword请替换成你要连接的无线AP名称和密码, 保存文件后输入以下命令, 或者重启以应用配置:

sudo systemctl daemon-reload
sudo systemctl restart networking

需要注意的是，如果你的SD卡在多个硬件上运行，WiFi的网络接口可能会被重命名为wlan1, wlan2等，你可以通过清空这个文件的内容并重启让它恢复为默认值：/etc/udev/rules.d/70-persistent-net.rules。

6.4.1 重点支持的WIFI型号

6.4.1.1 M.2 WiFi Module

RTL8822CE

6.4.1.2 Usb Dongle

RTL8821CU (Vid: 0BDA, Pid: C811) (测试样品:TP-Link TL-WDN5200H)
RTL8812AU (Vid: 0BDA, Pid: 8812)
MediaTek MT7662 (Vid: 0E8D, Pid: 7612) (测试样品:COMFAST CF-WU782AC V2)

6.5 安装内核头文件

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

6.6 编译内核头文件安装包

请参考 https://github.com/friendlyarm/sd-fuse_rk3328/blob/master/test/test-build-kernel-header-deb.sh

6.7 配置状态灯

先确定一下系统是否已经存在leds初始化的服务:

sudo systemctl status leds

如果已经存在leds服务, 则通过编辑如下文件改变状态灯的默认行为:

/etc/init.d/leds.sh

早期的固件由于没有leds服务, 需要参考以下指南手动配置状态灯, 首先, 设置开机自动加载以下内核模块:

modprobe ledtrig-netdev
echo ledtrig-netdev > /etc/modules-load.d/ledtrig-netdev.conf

下面的脚本代码将状态灯与网卡相关联, 需要加入到开机自动运行的脚本中:

echo netdev > /sys/class/leds/wan_led/trigger
echo eth0 > /sys/class/leds/wan_led/device_name
echo 1 > /sys/class/leds/wan_led/link
 
echo netdev > /sys/class/leds/lan_led/trigger
echo eth1 > /sys/class/leds/lan_led/device_name
echo 1 > /sys/class/leds/lan_led/link

7 如何编译系统

7.1 编译 Openwrt/Friendlywrt

7.1.1 下载源代码

mkdir friendlywrt-rk3328
cd friendlywrt-rk3328
repo init -u https://github.com/friendlyarm/friendlywrt_manifests -b master-v21.02 \
        -m rk3328.xml --repo-url=https://github.com/friendlyarm/repo  --no-clone-bundle
repo sync -c  --no-clone-bundle

7.1.2 开始编译

./build.sh nanopi_r2.mk

会编译所有组件（包含u-boot, kernel 和 friendlywrt）并生成sd卡镜像文件。

7.2 单独编译u-boot,kernel或friendlywrt

请参考以下链接：
- sd-fuse_rk3328
- How to Build FriendlyWrt/zh

8 更多OS

8.1 DietPi

DietPi is a highly optimised & minimal Debian-based Linux distribution. DietPi is extremely lightweight at its core, and also extremely easy to install and use.
Setting up a single board computer (SBC) or even a computer, for both regular or server use, takes time and skill. DietPi provides an easy way to install and run favourite software you choose.
For more information, please visit this link https://dietpi.com/docs/.

DietPi supports many of the NanoPi board series, you may download the image file from here:

https://dietpi.com/docs/hardware/#nanopi-series-friendlyarm

9 资源链接

9.1 手册原理图等开发资料

原理图
- NanoPi_R2C_2107_SCH.pdf

PCB尺寸图
- NanoPi_R2C_2107_PCB_DXF.zip
芯片规格书
- RK3328芯片手册 Rockchip_RK3328_Datasheet.pdf

10 更新日志

10.1 2024-04-21

10.1.1 OpenMediaVault

更新到 7.0.5-1
更新到 Debian12

10.2 2024-01-31

10.2.1 Debian/Ubuntu/FriendlyCore/Buildroot

增加adb支持

10.3 2023-12-01

10.3.1 FriendlyWrt

更新到 6.1.63 内核
更新到 OpenWrt 23.05.2

10.4 2023-10-31

10.4.1 增加新系统

增加NAS系统 OpenMediaVault，基于Debian11构建，使用6.1内核

10.4.2 Debian Core/FriendlyCore-Lite-Core

更新到 6.1 内核

10.4.3 FriendlyWrt

更新到 6.1 内核
更新到 OpenWrt 23.05

10.5 2023-05-29

10.5.1 Debian11 Core

修正在 R2C Plus 上无法启动的问题

10.6 2023-05-26

10.6.1 FriendlyWrt更新

更新 v22.03 到新版本 openwrt-22.03.5
更新 v21.02 到新版本 openwrt-21.02.7

10.7 2023-04-26

10.7.1 FriendlyWrt更新

更新 v22.03 到新版本 openwrt-22.03.4
更新 v21.02 到新版本 openwrt-21.02.6

10.8 2023-02-10

新增 Debian11 Core系统

10.9 2023-01-09

10.9.1 FriendlyCore更新说明：

优化了开机服务

10.10 2022-12-04

10.10.1 FriendlyWrt更新

修正存储空间某些情况下无法扩展的问题
加强eMMC刷机工具的刷机稳定性

10.11 2022-09-06

10.11.1 FriendlyWrt更新说明：

增加Fullcone NAT支持 (默认开启)
版本升级到 22.03.0 正式版

10.12 2022-08-03

10.12.1 FriendlyWrt更新说明：

升级FriendlyWrt至最新版本22.03-rc6

10.13 2022-08-01

10.13.1 FriendlyWrt更新说明：

防火墙设置调整: 单网口的设备(使如NEO3)默认设置为允许WAN入站流量以方便网页配置,多网口的设备仍然保持默认拒绝WAN入站流量

10.14 2022-07-27

10.14.1 FriendlyWrt更新说明：

提供docker与非docker两个版本,除了docker外其他特性相同
提供测试版22.03-rc3, 可根据软件包的需求情况进行选择, 推荐使用稳定版本 21.02.3
改善了第三方软件包的安装兼容性问题
增加支持 “恢复出厂设置” 功能
增加网页刷机工具 eMMC-Tools, 支持安装FriendlyElec及部分第三方固件到eMMC, 除了raw-image还支持rockchip打包格式的固件
其他一些细节调整: 默认设置时区设置为上海、新增NAS分类菜单、去掉lcd2usb、改进安全性设置、调优sysctl参数、修正docker防火墙设置等

10.15 2021-12-02

10.15.1 FriendlyWrt更新说明：

改进了FriendlyWrt系统上软件包安装的兼容性
修正某些sd卡会导致reboot命令无响应的问题 (更新了5.10内核)
将NanoPi-NEO3上的USB排针默认配置成Host模式

10.16 2021-10-29

10.16.1 FriendlyWrt更新说明：

FriendlyWrt更新至官方稳定版本 21.02.1，特性与19.07.5基本保持一致，支持docker、usb wifi等

10.17 2021-08-30

10.17.1 FriendlyWrt更新说明：

FriendlyWrt内核更新到 5.10.60
新增一款高速5G USB WiFi的支持，网卡型号为 Comfast CF-WU782AC V2，芯片型号为 MediaTek MT7662
改进了USB WiFi的兼容性
改进了首次启动的稳定性 (之前的版本，首次启动时，某些情况下会出现bpfilter错误)

10.17.2 FriendlyCore更新说明：

FriendlyCore内核更新到 5.10.60

10.18 2021-03-05

FriendlyCore更新到20.04 (基于ubuntu focal)

10.19 2021-01-15

FriendlyWrt内核更新到 5.10
FriendlyWrt升级到19.07.5

10.20 2020-09-04

提高了usb3.0驱动的稳定性（整合了rockchip官方更新），以及r8153网卡的稳定性
更新8153以太网卡的驱动为主线内核中的，版本为v1.11.11
启用R2S和NEO3的串口UART1

10.21 2020-08-31

内核更新到 5.4.61
采用Realtek官网下载的驱动 r8152-2.13.0 (https://www.realtek.com/en/downloads)
改进usb网卡驱动，WLAN<->LAN桥接速度可达 700/500 Mbits/sec
增加rockhip rng(硬件随机数)驱动

10.22 2020-07-10

10.22.1 FriendlyWrt更新说明：

内核版本升至5.4.50
增加NanoPi-NEO3的支持

10.23 2020-05-14

10.23.1 FriendlyWrt更新说明：

内核升至5.4.40内核, 增强防火墙稳定性
增加usb wifi 的支持（rtl8812au）
加强了 overlayfs 的稳定性

10.24 2020-02-28

10.24.1 FriendlyWrt更新说明：

默认不启用 lan 口的dhcp ipv6
增加usb wifi 的支持（RTL8821CU）

10.25 2020-02-25

10.25.1 FriendlyWrt更新说明：

10.25.1.1 更新代码到 openwrt v19.07.1 版本，请使用 master-v19.07.1 分支的代码，下载方法：

mkdir friendlywrt-rk3328
cd friendlywrt-rk3328
repo init -u https://github.com/friendlyarm/friendlywrt_manifests -b master-v19.07.1 -m rk3328.xml --repo-url=https://github.com/friendlyarm/repo --no-clone-bundle
repo sync -c --no-clone-bundle

10.25.1.2 修复初版固件发现的一些issues，如下：

优化加载bpfilter 模块
设置 dist-feeds 指向最新版本, 解决opkg update 异常
缺省config中移除 modemmanager和mwan3 插件（可自行添加)
优化 cpu 调频策略和开机速度

10.26 2020-02-20

10.26.1 FriendlyWrt

优化了 openssl 性能
增加pwm风扇的支持，支持温控 (平台: rk3328/rk3399)