NanoPi R6C/zh
Contents
- 1 介绍
- 2 NanoPi R6C资源特性
- 3 接口布局和尺寸
- 4 快速入门
- 5 FriendlyWrt的使用
- 5.1 FriendlyWrt简介
- 5.2 首次开机的初始化
- 5.3 帐户与密码
- 5.4 登录FriendlyWrt
- 5.5 建议的安全性设置
- 5.6 更改LAN口的IP地址
- 5.7 安全的关机操作
- 5.8 恢复出厂设置
- 5.9 安装软件包
- 5.10 FriendlyWrt的一些常见问题
- 5.11 禁用IPv6
- 5.12 配置用户按键的功能
- 5.13 配置移远EC20（4G模块）拨号上网
- 5.14 使用USB2LCD查看IP和温度
- 5.15 如何使用USB WiFi
- 5.16 玩转Docker应用
- 5.17 挂载smbfs共享资源
- 5.18 使用sdk编译软件包
- 5.19 使用 GitHub Actions 编译 FriendlyWrt
- 5.20 Compile u-boot,kernel or friendlywrt
- 6 Ubuntu 22.04 桌面系统的使用
- 6.1 Ubuntu 22.04桌面系统简介
- 6.2 Account & Password
- 6.3 帐户与密码
- 6.4 查看IP地址
- 6.5 通过ssh登录Ubuntu
- 6.6 更新软件包
- 6.7 安装软件中心
- 6.8 安装内核头文件
- 6.9 更改时区
- 6.10 更换开机LOGO和桌面墙纸
- 6.11 开机自动启动程序(例如Firefox)
- 6.12 取消USB存储设备自动挂载
- 6.13 设置中文语言与输入法
- 6.14 硬解播放视频
- 6.15 安装Plex多媒体服务器
- 6.16 安装Docker
- 6.17 取消桌面的自动登录
- 6.18 设置WiFi无线链接
- 6.19 测试OpenGL ES性能
- 6.20 Chromium网页浏览器
- 7 Android TV系统简介
- 8 Debian11 桌面系统的使用
- 8.1 Debian11桌面系统简介
- 8.2 帐户与密码
- 8.3 查看IP地址
- 8.4 通过ssh登录Debian
- 8.5 更新软件包
- 8.6 安装x11vnc远程桌面
- 8.7 安装内核头文件
- 8.8 更改时区
- 8.9 更换开机LOGO和桌面墙纸
- 8.10 开机自动启动程序(例如Kodi)
- 8.11 取消USB存储设备自动挂载
- 8.12 设置中文语言与输入法
- 8.13 安装Plex多媒体服务器
- 8.14 在Debian系统上安装Docker
- 8.15 如何测试NPU
- 8.16 如何测试VPU
- 8.17 设置WiFi无线链接
- 8.18 取消自动登录
- 8.19 测试OpenGL ES性能
- 8.20 设置HDMI/DP屏幕分辨率
- 8.21 调节HDMI边界
- 8.22 Chromium网页浏览器
- 8.23 测试mpp视频硬件编码
- 9 Debian10 桌面系统的使用
- 10 FriendlyCore的使用
- 11 如何编译系统
- 12 备份文件系统并创建SD映像(将系统及应用复制到另一块开发板)
- 13 初始化NVME固态硬盘和USB移动硬盘
- 14 性能测试方法
- 15 Link to Rockchip Resources
- 16 手册原理图等开发资料
- 17 更新日志
1 介绍
NanoPi R6C(简称”R6C”)是友善电子团队设计出品的一款开源高性能一体化边缘计算平台，它带有1个2.5G和1个千兆网口。它采用瑞芯微RK3588S作为主控处理器, 配备4GB/8GB LPDDR4x内存，以及可选的32GB eMMC闪存，支持运行FriendlyWrt, Android, Debian和Ubuntu等多种系统, 支持GPU和VPU加速。
R6C接口丰富，布局紧凑，主板尺寸只有 90x62 mm，有30个针脚的排针引出了硬件资源以方便二次开发，其中包括GPIO、I2C、I2S、PWM和SPI等接口, 还带有1个HDMI输出接口，可解码播放最高8K@60fps H.265/VP9, 以及8K@30fps H264等格式视频。
R6C还带有1个M.2 NVME固态硬盘接口和2个USB接口，支持当前流行的PD快充电源供电(USB-C接口)，外接移动硬盘时无需担心供电不足, 可选配安装一体化CNC氧化铝外壳。
简言之，R6C非常适合企业客户定制开发带有多网口的迷你机器视觉系统，并适合嵌入式爱好者发掘、探索打造自己独具一格的玩法。
2 NanoPi R6C资源特性
- SoC: Rockchip RK3588S
- CPU: Quad-core ARM Cortex-A76(up to 2.4GHz) and quad-core Cortex-A55 CPU (up to 1.8GHz)
- GPU: Mali-G610 MP4, compatible with OpenGLES 1.1, 2.0, and 3.2, OpenCL up to 2.2 and Vulkan1.2
- VPU: 8K@60fps H.265 and VP9 decoder, 8K@30fps H.264 decoder, 4K@60fps AV1 decoder, 8K@30fps H.264 and H.265 encoder
- NPU: 6TOPs, supports INT4/INT8/INT16/FP16
- RAM: 64-bit 4GB/8GB LPDDR4X at 2133MHz
- Flash: 32GB/None eMMC, at HS400 mode
- Ethernet: one Native Gigabit Ethernet, and one PCIe 2.5G Ethernet
- USB: one USB 3.0 Type-A and one USB 2.0 Type-A
- PCIe: one M.2 Key M connector with PCIe 2.1 x1
- HDMI:
- compatible with HDMI2.1, HDMI2.0, and HDMI1.4 operation
- support up to 7680x4320@60Hz
- Support RGB/YUV(up to 10bit) format
- microSD: support up to SDR104 mode
- GPIO:
- 30-pin 2.54mm header connector
- up to 1x SPI, 3x UARTs, 3x I2Cs, 2x SPDIFs, 1x I2Ss, 3x PWMs, 1x CAN, 20x GPIOs
- Debug: UART via 3-Pin 2.54mm header, or on-board USB-C to UART
- LEDs: 4 x GPIO Controlled LED (SYS, WAN, LAN, LED1)
- others:
- 2 Pin 1.27/1.25mm RTC battery input connector for low power RTC IC HYM8563TS
- MASK button for eMMC update
- one user button
- Power supply: USB-C, support PD, 5V/9V/12V/20V input
- PCB: 8 Layer, 62x90x1.6mm
- Ambient Operating Temperature: 0℃ to 70℃
3 接口布局和尺寸
3.1 接口布局
- 30-pin GPIO
Pin# Assignment Pin# Assignment 1 VCC_3V3_S3* 2 VCC_5V0* 3 I2C8_SDA_M2 4 VCC_5V0* 5 I2C8_SCL_M2 6 GND 7 GPIO4_A0/I2S1_MCLK_M0 8 GPIO3_C4/UART5_TX_M1/CAN2_RX_M0 9 GND 10 GPIO3_C5/UART5_RX_M1/CAN2_TX_M0 11 GPIO4_A1/I2S1_SCLK_M0 12 GPIO0_D4/PWM3_IR_M0 13 GPIO4_A2/I2S1_LRCK_M0 14 GND 15 GPIO4_A5/I2S1_SDI0_M0 16 GPIO4_A6/I2S1_SDI1_M0 17 VCC_3V3_S3* 18 GPIO4_B1/I2S1_SDO0_M0 19 GPIO1_B2/SPI0_MOSI_M2/UART4_RX_M2 20 GND 21 GPIO1_B1/SPI0_MISO_M2 22 GPIO4_B2/I2S1_SDO1_M0 23 GPIO1_B3/SPI0_CLK_M2/UART4_TX_M2 24 GPIO1_B4/SPI0_CS0_M2 25 GND 26 GPIO1_A2/PWM0_M2/I2C4_SDA_M3 27 GPIO1_B6/UART1_TX_M1/I2C5_SCL_M3/SPDIF0_TX_M0 28 GPIO1_B7/UART1_RX_M1/I2C5_SDA_M3/SPDIF1_TX_M0 29 GPIO1_A3/PWM1_M2/I2C4_SCL_M3 30 GND
- 所有信号均为3.3V.
- VCC_3V3_S3为3.3V电源输出，最大输出为500mA.
- VCC_5V0为5V电源输出，最大输出为1A.
- 调试串口
- 3.3V电平, 波特率为1500000bps
Pin# Assignment Description 1 GND 0V 2 UART2_TX_M0_DEBUG output 3 UART2_RX_M0_DEBUG intput
- USB-C调试串口
- 板子集成了USB转TTL，直接连到调试串口。即插即用.
- Windows下的驱动可从这里下载: http://www.wch-ic.com/downloads/CH341SER_ZIP.html
- USB-A口
- 每个USB-A有独立的限流IC，均支持最大1.4A输出.
- RTC
- 板子集成低功耗RTC芯片，型号为HYM8563TS；根据芯片手册，RTC备份电流典型值为0.25μA (VDD =3.0V, TA =25℃).
- 电池接口连接器型号为Molex 53398-0271（或兼容型号），Pin间距为1.27mm；正负极见板子丝印标注。
- 用户按键
- 用户按键连接到GPIO1_C0；按下就是低电平，松开高电平.
4 快速入门
4.1 准备工作
要开启你的NanoPi R6C新玩具，请先准备好以下硬件
- NanoPi R6C主板
- MicroSD卡/TF卡: Class10或以上的 8GB SDHC卡
- 一个USB-C接口外接电源 (要求10W及以上规格)，支持PD协议的电源适配器
- 如果需要开发与编译，则需要一台可以联网的电脑，推荐安装Ubuntu 18.04 64位系统，并使用下面的脚本初始化开发环境:
4.2 经测试可选用的TF卡
请参考: TF Cards We Tested
4.3 经我们测试过的PD电源适配器
请参考: PD Power Adapters We Tested
4.4 调试串口参数配置
{{{1}}}内置了USB转TTL芯片, 芯片型号为CH340E, 使用Typc-C线连接到电脑的USB-A接口即可使用, Linux下免驱, Windows系统与Mac系统则需要安装驱动程序, 驱动程序下载地址如下:
Windows驱动下载: Matrix - CH341SER.ZIP
Mac系统驱动下载: - CH341SER_MAC_ZIP
调试串口参数:
| 波特率 | 1500000 |
| 数据位 | 8 |
| 奇偶校验 | None |
| 停止位 | 1 |
| 流控制 | None |
4.5 安装系统
4.5.1 通过TF卡运行系统
访问此处的下载地址下载需要的固件文件(位于"01_系统固件/01_SD卡固件"目录)和烧写工具(位于"05_工具软件"目录)：
| 固件文件 | |
| rk3588-sd-friendlywrt-21.02-YYYYMMDD.img.gz | FriendlyWrt系统固件，基于OpenWrt 21.02构建，内核版本 5.10.y |
| rk3588-sd-friendlywrt-21.02-docker-YYYYMMDD.img.gz | 预装了Docker的FriendlyWrt系统固件，基于OpenWrt 21.02构建，内核版本 5.10.y |
| rk3588-sd-friendlywrt-22.03-YYYYMMDD.img.gz | FriendlyWrt系统固件，基于OpenWrt 22.03构建，内核版本 5.10.y |
| rk3588-sd-friendlywrt-22.03-docker-YYYYMMDD.img.gz | 预装了Docker的FriendlyWrt系统固件，基于OpenWrt 22.03构建，内核版本 5.10.y |
| rk3588-sd-androidtv-YYYYMMDD.img.zip | Android TV 系统固件 |
| rk3588-sd-android12-YYYYMMDD.img.zip | Android Tablet 系统固件 |
| rk3588-sd-debian-bullseye-core-5.10-arm64-YYYYMMDD.img.gz | Debian11 精简版固件，没有桌面, 仅命令行，内核版本 5.10.y |
| rk3588-sd-debian-bullseye-minimal-5.10-arm64-YYYYMMDD.img.gz | Debian11 系统固件，Xfce桌面, 不预装推荐软件包, 支持GPU/VPU硬件加速，内核版本 5.10.y |
| rk3588-sd-debian-bullseye-desktop-5.10-arm64-YYYYMMDD.img.gz | Debian11 完整版固件，Xfce桌面, 预装推荐软件包, 支持GPU/VPU硬件加速，内核版本 5.10.y |
| rk3588-sd-ubuntu-focal-desktop-5.10-arm64-YYYYMMDD.img.gz | Ubuntu 20.04固件, LXQT桌面，支持GPU/VPU硬件加速, 内核版本 5.10.y |
| rk3588-sd-ubuntu-jammy-desktop-arm64-YYYYMMDD.img.gz | Ubuntu 22.04固件, 使用GNOME与Wayland，预装网页浏览器等推荐软件, 内核版本 5.10.y |
| rk3588-sd-ubuntu-jammy-minimal-arm64-YYYYMMDD.img.gz | 精简版Ubuntu 22.04固件, 使用GNOME与Wayland, 不预装推荐软件，内核版本 5.10.y |
| rk3588-sd-ubuntu-jammy-x11-desktop-5.10-arm64-YYYYMMDD.img.gz | Ubuntu 22.04固件, 基于X11与Xubuntu，使用panfrost GPU驱动，集成rkmpp/mpv实现视频硬件加速, 内核版本 5.10.y |
| rk3588-sd-friendlycore-focal-5.10-arm64-YYYYMMDD.img.gz | 64位FriendlyCore系统固件，基于Ubuntu core 20.04构建，内核版本 5.10.y，预装了Qt5 |
| 其他固件 | |
| Github Actions云编译版本 | FriendlyWrt |
| Flash Utility: | |
| win32diskimager.rar | Windows utility. Under Linux users can use "dd" |
详细操作步骤如下：
- 准备一张8G或以上容量的TF卡;
- 下载并解压镜像文件 xxx.img.gz 和工具 win32diskimager;
- 在Windows下以管理员身份运行 win32diskimager，在界面上选择你的SD卡盘符，选择解压后的固件文件，点击 Write 按钮烧写到SD卡; 或者在 Linux下使用 dd 命令将 xxx.img 写入 SD卡;
- 将SD卡从电脑端弹出，插入NanoPi-R6C的microSD卡槽;
- 连接NanoPi-R6C的电源，系统会从TF卡启动;
4.5.2 烧写系统到eMMC
4.5.2.1 方法1: 在网页上烧写
使用烧写了FriendlyWrt固件的TF卡启动NanoPi-R6C, 登录FriendlyWrt页面, 在网页菜单上点击 "系统" -> "eMMC刷机助手" 进入eMMC刷机助手界面, 点击界面上的 "选择文件" 按钮, 选择你要刷写的文件 (官方固件选用文件名有"-sd-"的文件), 亦可选择第三方固件, 文件支持 .gz 格式的压缩文件, 或者以 .img 作为扩展名的raw格式。
选择文件后, 点击 “上传并烧写” 按钮, 开始上传并烧写, 如下图所示:
烧写完成后,请弹出SD卡,设备会自动重启, 并从eMMC引导新系统，可留意指示灯的状态, 在系统状态灯闪烁，同时网卡状态灯亮起时，表示系统启动完成, 如果eMMC安装的系统是 FriendlyWrt, 则可以通过点击“进入首页”进入FriendlyWrt管理页面。
官方固件需要选用文件名带 "-sd-" 字样的镜像文件, 例如: rk3NNN-sd-friendlywrt-21.02-YYYYMMDD.img.gz, 压缩文件只支持gz格式, 如果文件太大, 可以先压缩成gz格式再上传。
4.5.2.2 方法2: 用TF启动卡进行自动烧写
此方法是通过SD卡启动一个小型的Linux系统, 借助名为EFlasher的工具来烧写固件到eMMC。
如果有连接HDMI显示器, 可通过图形界面观察烧写进度, 也可以通过板载LED灯来掌握烧写进度:
进度 |
SYS灯 (红灯) |
LAN灯(绿灯) |
WAN灯(绿灯) |
|---|---|---|---|
上电开机 |
长亮 |
灭 |
灭 |
系统启动 |
慢闪 |
灭 |
灭 |
正在烧写 |
快闪 |
灭 |
灭 |
烧写完成 |
慢闪 |
长亮 |
长亮 |
默认情况下烧写是上电自动开始的，所以要注意备份eMMC里的数据，如果不想自动，可以使用文件名含"multiple-os"字样的固件，在界面上手动选择要烧写的系统。
4.5.2.2.1 烧写官方固件到eMMC
详细操作步骤如下：
- 准备一张8G或以上容量的SDHC卡;
- 访问此处的下载地址下载需要的固件(位于"01_系统固件/02_SD卡刷机固件(SD-to-eMMC)"目录)和烧写工具win32diskimager(位于"05_工具软件"目录);
- 解压 .gz 格式的压缩文件得到 .img 格式的镜像文件;
- 在Windows下以管理员身份运行 win32diskimager，在界面上选择你的SD卡盘符，选择解压后的固件文件，点击 Write 按钮烧写到SD卡;
- 将SD卡从电脑端弹出，插入NanoPi-R6C的microSD卡槽;
- 连接NanoPi-R6C的电源，系统会从SD卡启动，并自动启动 EFlasher 烧写工具将系统安装到 eMMC;
- 烧写完成后，从NanoPi-R6C弹出SD卡，NanoPi-R6C会自动重启并从eMMC启动你刚刚烧写的系统;
4.5.2.2.2 烧写第三方固件(镜像文件)到eMMC
1) 从网盘上下载文件名带 eflasher 字样的任意固件(位于"01_系统固件/02_SD卡刷机固件(SD-to-eMMC)"目录), 解压后烧进TF卡;
2) 重新拨插一次TF卡, PC上会出现一个名为FriendlyARM的盘符(Linux下是FriendlyARM目录), 将 .img 或者 .gz结尾的固件复制进去;
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卡放在NanoPi-R6C上上电启动, 会自动烧写你的固件, 通过板载 LED 灯来了解安装进度;
4.5.2.3 方法3: 通过USB烧写
4.5.2.3.1 步骤1: 安装USB驱动和工具
从网盘的tools目录下载瑞芯微的USB驱动: DriverAssitant_v5.1.1.zip, 解压后安装;
在相同目录下, 下载瑞芯微开发工具: RKDevTool_Release_v2.84.zip, 解压后备用;
4.5.2.3.2 步骤2: 将NanoPi-R6C与电脑连接, 并进入刷机模式
1) 断开NanoPi-R6C上连接的USB和电源线, 弹出TF卡;
2) 按住Mask按键不放, 插上电源, 保持按住Mask键, 状态灯亮起3秒后即可松开;
3) 用USB A-to-A数据线 (也叫USB公对公数据线), 将NanoPi-R6C与电脑进行连接, 连接方法参照下图, 需要连接靠近外侧的USB端口:
4.5.2.3.3 步骤3: 烧写固件到eMMC
固件格式一般有两种格式, 一种是单个的image文件, 通常第三方固件会使用这种打包方式, 另一种是多个分区镜像, FriendlyELEC的固件采用这种方式, 下面分别对这两种格式的固件进行说明:
- 选项1: 烧写打包成单个image文件的固件
在电脑上双击 RKDevTool_Release_v2.84 目录下的 RKDevTool.exe 启动瑞芯微开发工具, 与电脑连接正常的情况下, 瑞芯微开发工具界面上会显示 "发现一个Maskrom设备";
在瑞芯微开发工具界面上, 点击 “升级固件”, 再点击 “固件” 按钮, 选择你要烧写的image文件, 点击 “升级” 然后等待烧写完成即可, 完成后设备会自动重启, 并从eMMC启动你刚刚安装的系统;
- 选项2: 烧写由多个分区镜像组成的固件
根据需要到网盘上下载对应的压缩包(位于"01_系统固件/03_USB线刷固件(USB-to-eMMC)"目录), 在电脑上解压:
解压后, 可以看到固件目录下已内置了瑞芯微开发工具和预设好的配置文件, 双击 RKDevTool.exe 启动瑞芯微开发工具, 界面上会显示 "发现一个Maskrom设备", 点击界面上的“执行”按钮, 稍等片刻即可完成烧写, 完成后设备会自动重启, 并从eMMC启动你安装的系统;
4.6 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内的系统并没有适配NanoPi-R6C, 也就是说Loader压根就是坏的;
这时, 可以用如下方法让NanoPi-R6C从TF卡启动系统, 进行系统重装或Flash擦除:
1) 插入一张烧写有FriendlyWrt系统的TF卡 (制作方法请参考上面的章节);
2) 按下Maskrom按键, 并上电开机 (或短接Maskrom触点);
3) 重要: 上电后默数4秒左右立即松开Maskrom按键;
4) NanoPi-R6C将会从TF卡启动FriendlyWrt系统;
5) 用网线连接电脑到NanoPi-R6C的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之后的固件), 然后重新操作一次;
总结如下:
| eMMC当前系统 | TF卡当前系统 | 启动优先级 |
|---|---|---|
| 无系统 | 任意固件 | TF卡 |
| FriendlyELEC的固件 | FriendlyELEC的固件 | TF卡 |
| FriendlyELEC的固件 | 采用主线U-boot的固件 | eMMC |
| 采用主线U-boot的固件 | FriendlyELEC的固件 | eMMC |
| 采用主线U-boot的固件 | 采用主线U-boot的固件 | eMMC |
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-R6C连接到互联网之前完成此设置。
5.4 登录FriendlyWrt
将电脑连接到 NanoPi-R6C 的LAN口，如果电脑没有网口，可将无线AP的LAN口与NanoPi-R6C的LAN口相连接，电脑再通过WiFi连接到无线AP，在电脑浏览器上输入以下网址即可进入FriendlyWrt管理页面:
- http://friendlywrt/
- http://192.168.2.1/
- http://[fd00:ab:cd::1]
以上是NanoPi-R6C的LAN口地址，WAN口会从你的主路由器动态获取IP地址。
5.5 建议的安全性设置
以下设置事项非常建议在将 NanoPi-R6C 接入互联网之前完成，因为在空密码或弱密码的状态下将NanoPi-R6C接入互联网，极易受到网络攻击。
- 设置一个安全的密码
进入 系统->管理权 界面设置密码。
- 禁止从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 && reboot5.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-R6C工作在IPv6，电脑有可能无法连接互联网，建议关闭IPv6 (本WiKi后面有介绍方法)，或将主路由切换到IPv6;
- 如果你有问题，或有更好的建议，欢迎发送邮件到 techsupport@friendlyarm.com;
5.11 禁用IPv6
要关掉 IPv6，可在ssh终端输入如下命令：
. /root/setup.sh disable_ipv6 reboot
待NanoPi-R6C重启完毕，电脑也需要重新插拨一下网线（或重启网络端口）以便重新获得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-R6C 的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-R6C的USB端口，推荐使用以下列表中支持AP模式的WiFi芯片模块:
注：符合以上WiFi芯片型号并符合以上VID&PID信息的USB无线网卡都可以使用，支持的型号不局限于某个品牌某个型号
(2) 插入USB WiFi后，点击上方菜单栏的“系统>重启”，点击“执行重启”按钮重启NanoPi-R6C
(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影音服务器
请参考： 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.16.3 使用外接硬盘来扩展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.16.4 Docker的常见问题与解决办法
5.16.4.1 无法访问Docker提供的网络服务
解决办法:
- 进入 "防火墙" 的设置，把 "转发" 设置成 "接受";
- 关闭 ”软件流量分载“;
5.17 挂载smbfs共享资源
mount -t cifs //192.168.1.10/shared /movie -o username=xxx,password=yyy,file_mode=0644
5.18 使用sdk编译软件包
5.18.1 安装编译环境
在64位的Ubuntu （版本18.04+）下载并运行如下脚本： How to setup the Compiling Environment on Ubuntu bionic
5.18.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.18.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.18.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.19 使用 GitHub Actions 编译 FriendlyWrt
项目地址: https://github.com/friendlyarm/Actions-FriendlyWrt
5.20 Compile u-boot,kernel or friendlywrt
- Refer to：
6 Ubuntu 22.04 桌面系统的使用
6.1 Ubuntu 22.04桌面系统简介
Ubuntu 22.04 桌面 具有如下特点：
- 桌面环境采用 GNOME 42;
- 默认使用Wayland 会话, 性能更好;
- 提供基于 Mali GPU 的 OpenGL ES 支持;
- 支持Rockhip MPP视频硬编和硬解码;
- 预装基于mpv与kodi, 支持视频硬解码;
- 支持安装Docker和Plex, 玩法丰富;
6.2 Account & Password
6.3 帐户与密码
普通用户：
用户名: pi
密码: pi
Root用户：
用户名: root
密码: fa
6.4 查看IP地址
由于主机名默认为FriendlyElec.lan, 所以可以使用ping命令来获得IP地址:
ping FriendlyElec.lan6.5 通过ssh登录Ubuntu
ssh pi@FriendlyElec.lan
默认密码为pi
6.6 更新软件包
6.6.1 更换软件源为国内镜像源
$ sudo cp /etc/apt/sources.list /etc/apt/sources.list.org $ sudo sed -i -e 's/ports.ubuntu.com/mirrors.ustc.edu.cn/g' /etc/apt/sources.list
6.6.2 更新软件包列表
$ sudo apt-get update
6.7 安装软件中心
$ sudo apt-get install snapd $ sudo snap install snap-store
6.8 安装内核头文件
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.9 更改时区
6.9.1 检查当前时区
timedatectl
6.9.2 列出所有时区
timedatectl list-timezones
6.9.3 设置时区 (比如上海)
sudo timedatectl set-timezone Asia/Shanghai
6.10 更换开机LOGO和桌面墙纸
6.10.1 更换开机LOGO
替换内核下面的两个文件，重新编译内核：
kernel/logo.bmp
kernel/logo_kernel.bmp
或者使用脚本来操作，如下所示：
- 下载脚本
git clone https://github.com/friendlyarm/sd-fuse_rk3588.git -b kernel-6.1.y cd sd-fuse_rk3588
- 编译内核并重新打包固件
convert files/logo.jpg -type truecolor /tmp/logo.bmp convert files/logo.jpg -type truecolor /tmp/logo_kernel.bmp LOGO=/tmp/logo.bmp KERNEL_LOGO=/tmp/logo_kernel.bmp ./build-kernel.sh ubuntu-jammy-desktop-arm64 ./mk-emmc-image.sh ubuntu-jammy-desktop-arm64
6.10.2 恢复出厂设置
在终端上执行如下命令:
sudo firstboot && sudo reboot
6.11 开机自动启动程序(例如Firefox)
把要开机启动的程序的desktop文件放入~/.config/autostart/目录即可，例如：
mkdir ~/.config/autostart/ cp /usr/share/applications/firefox.desktop ~/.config/autostart/
6.12 取消USB存储设备自动挂载
sudo systemctl mask udisks2 sudo reboot
6.13 设置中文语言与输入法
6.13.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 reboot6.14 硬解播放视频
6.14.1 界面播放
- 在文件浏览器定位到视频文件,右击选择使用"Play with mpv media player"播放视频
- 通过Kodi播放, 默认会调用mpv进行硬解播放
- 使用Chromium网页浏览器, 可以硬解播放网页上视频 (限CPU能支持的视频格式)
6.14.2 命令行播放
- 播放本地视频
export DISPLAY=:0.0 mpv --fs /home/pi/Videos/demo.mp4
- 播放网络视频
export DISPLAY=:0.0 mpv --fs https://www.youtube.com/watch?v=lK-nYDmC1Dk
6.15 安装Plex多媒体服务器
运行以下命令安装:
echo deb https://downloads.plex.tv/repo/deb public main | sudo tee /etc/apt/sources.list.d/plexmediaserver.list curl https://downloads.plex.tv/plex-keys/PlexSign.key | sudo apt-key add - sudo apt update sudo apt install plexmediaserver
成功安装后，启用 Plex（系统启动时自动启动）:
sudo systemctl enable plexmediaserver sudo systemctl start plexmediaserver sudo systemctl status plexmediaserver
安装完成后, 在电脑浏览器上输入以下地址登录Plex服务器后台: http://IP地址:32400/web/
6.16 安装Docker
6.16.1 安装docker
sudo apt install apt-transport-https ca-certificates curl software-properties-common gnupg lsb-release curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null sudo apt update sudo apt install docker-ce docker-ce-cli containerd.io docker-compose-plugin
验证是否安装成功:
sudo docker info6.16.2 不使用sudo运行docker
sudo groupadd docker sudo gpasswd -a ${USER} docker sudo systemctl restart docker sudo chmod a+rw /var/run/docker.sock
验证是否成功:
docker images
6.16.3 测试运行docker映像: 安装nextcloud网盘
mkdir ~/nextcloud -p docker run -d -p 8888:80 --name nextcloud -v ~/nextcloud/:/var/www/html/ --restart=always --privileged=true arm64v8/nextcloud
安装完成后, 在电脑浏览器上访问: http://设备IP地址:8888, 即可查看nextcloud网盘页面。
6.17 取消桌面的自动登录
编辑文件/etc/gdm3/custom.conf, 设置字段AutomaticLoginEnable为false:
[daemon] AutomaticLoginEnable = false
6.18 设置WiFi无线链接
6.18.1 图形界面操作
点击右上角的网络图标，选择你要连接的WiFi热点，按界面提示操作即可。
6.18.2 命令行操作
请参考 Use NetworkManager to configure network settings/zh
6.19 测试OpenGL ES性能
首先, 将CPU设置为性能模式:
sudo sh -c 'echo performance > /sys/devices/system/cpu/cpufreq/policy0/scaling_governor' sudo sh -c 'echo performance > /sys/devices/system/cpu/cpufreq/policy4/scaling_governor' sudo sh -c 'echo performance > /sys/devices/system/cpu/cpufreq/policy6/scaling_governor'
然后启动glmark2-es2-wayland:
glmark2-es2-wayland
6.20 Chromium网页浏览器
6.20.1 GPU支持情况
系统预装的Chromium网页浏览器已经默认启用硬件加速，支持WebGL，可以通过输入网址 chrome://gpu 了解硬件加速情况，如下图所示：
6.20.2 VPU支持情况
在浏览器上播放一个视频,然后在命令行使用fuser查看mpp设备节点的使用情况来确认已经调用了vpu:
pi@FriendlyElec:~$ fuser /dev/mpp_service /dev/mpp_service: 3258
如果fuser命令没有内容输出, 则表示当前是软解.
6.20.3 查看支持的硬解格式
在浏览器地址栏输入 about://gpu，翻页到页面最底部，查看 "Video Acceleration Information" 表格;
播放一个视频后，再在浏览器地址栏输入 about://media-internals, 可以查看最近播放的视频是否启用了硬解;
7 Android TV系统简介
Android TV 是专门为电视而创建的一个Android版本，具有如下特点：
- 支持红外摇控器;
- 支持有线网络;
- 支持USB WiFi;
- 支持视频硬解码等;
7.1 Android系统支持的WIFI型号
7.1.1 M.2 WiFi Module
- RTW8822CE
7.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)
7.2 ADB的使用
请注意: 开启ADB后, 该USB3端口将工作在Device模式, 如果需要连接U盘等设备,你需要关闭ADB并重启开发板
一般情况下adb是默认关闭的，请执行以下步骤开启：
- 用USB A-to-A数据线 (也叫USB公对公数据线), 将开发板与电脑进行连接, 连接方法参照下图, 需要连接靠近外侧的USB端口:
- 进入Android系统, 依次进入 Settings -> About tablet -> 连续点击7下屏幕最下面的Build number
- 再次进入Android系统的Settings -> System -> Advance -> Developer options, 勾选 USB debugging
- 基于你的操作系统安装 adb 驱动和命令
- 正常情况下, Android状态栏会提示 USB debugging connected，表示ADB已开启, 在电脑上输入如下命令检测连接：
$ adb devices List of devices attached 27f7a63caa3faf16 device
- 进入adb shell:
$ adb shell
nanopi3:/ $8 Debian11 桌面系统的使用
8.1 Debian11桌面系统简介
Debian11 Desktop 是一个轻量级的Debian桌面环境，具有如下特点：
- 桌面环境采用 LXDE, 多种主题可选, 简洁美观, 占用资源少;
- 提供基于 Mali GPU 的 OpenGL 支持;
- 支持Rockhip MPP视频硬编和硬解码;
- 预装基于mpv的Kodi, SMPlayer播放器, 均支持4K视频硬解码;
- 预装Chromium浏览器, 支持vpu/gpu硬件加速 (视频硬解限h264/mp4格式);
- 支持安装Plex Server, Docker与wps等应用, 玩法丰富;
8.2 帐户与密码
普通用户：
用户名: pi
密码: pi
Root用户：
默认没有设置root密码，可通过sudo passwd root命令配置root密码
8.3 查看IP地址
由于Debian主机名默认为硬件型号, 所以可以使用ping命令来获得IP地址: ping NanoPi-R6C
8.4 通过ssh登录Debian
使用以下命令:ssh pi@NanoPi-R6C
默认密码为pi
8.5 更新软件包
8.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
8.6 安装x11vnc远程桌面
x11vnc是一个VNC服务器, 安装后我们可以不依赖外部的显示设备, 通过网络远程登录Debian桌面。
8.6.1 安装x11vnc
sudo apt-get install x11vnc
8.6.2 设置VNC登录密码
sudo x11vnc -storepasswd /etc/x11vnc.pwd
8.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
8.6.4 测试远程桌面
在电脑上启动VNC客户端软件, 在地址栏输入: IP地址:5900 连接即可, 效果如下图所示, 图中设备IP地址为192.168.1.123, 使用端口5900进行连接:
8.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
8.8 更改时区
8.8.1 检查当前时区
timedatectl
8.8.2 列出所有时区
timedatectl list-timezones
8.8.3 设置时区 (比如上海)
sudo timedatectl set-timezone Asia/Shanghai
8.9 更换开机LOGO和桌面墙纸
8.9.1 更换开机LOGO
替换内核下面的两个文件，重新编译内核：
kernel/logo.bmp
kernel/logo_kernel.bmp
或者使用脚本来操作，如下所示：
- 下载脚本
git clone https://github.com/friendlyarm/sd-fuse_rk3588.git -b kernel-6.1.y --single-branch cd sd-fuse_rk3588
- 编译内核并重新打包固件
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,请根据实际情况指定
8.9.2 更换桌面墙纸
修改如下配置文件:
/home/pi/.config/pcmanfm/LXDE/desktop-items-0.conf
8.9.3 恢复出厂设置
在终端上执行如下命令:
sudo firstboot && sudo reboot
8.10 开机自动启动程序(例如Kodi)
把要开机启动的程序的desktop文件放入~/.config/autostart/目录即可，例如：
mkdir ~/.config/autostart/ cp /usr/share/applications/kodi.desktop ~/.config/autostart/
8.11 取消USB存储设备自动挂载
sudo systemctl mask udisks2 sudo reboot
8.12 设置中文语言与输入法
8.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 reboot8.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即可切换中英文输入法, 右上角也出现了输入法图标, 右击右上角的输入法图标, 在弹出菜单中可以切换输入法, 如下图所示:
8.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/
8.14 在Debian系统上安装Docker
请参考此链接: How to Install Docker on Debian/zh
8.15 如何测试NPU
请参考此链接: NPU/zh
8.16 如何测试VPU
请参考此链接: VPU/zh
8.17 设置WiFi无线链接
8.17.1 图形界面操作
点击右上角的网络图标，选择你要连接的WiFi热点，按界面提示操作即可。
8.17.2 命令行操作
请参考 Use NetworkManager to configure network settings/zh
8.18 取消自动登录
编辑文件:
sudo vim /etc/lightdm/lightdm.conf
注释掉如下两行内容 (在前面插入#):
autologin-user=pi
autologin-user-timeout=08.19 测试OpenGL ES性能
在系统菜单 System Tools 中点击 Terminator 打开命令行终端，输入以下命令即可测试:
glmark2-es2
8.20 设置HDMI/DP屏幕分辨率
进入系统菜单 Perferences -> Monitor Settings界面进行设置即可。
推荐分辨率：1920x1080@60Hz
8.21 调节HDMI边界
打开命令行终端，输入命令进行操作，有几个注意事项：
1) 需要登录桌面才能操作，如果Desktop停留在Login是无法设置的;
2) 如果你是在 ssh 登录的终端，请使用与桌面登录相同的用户名，默认是 pi，不能使用root用户，同时，你需要赋值 DISPLAY 变量：
export DISPLAY=:0.0
8.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
8.21.2 设置分辨率
例如设置为 1920X1080@60Hz:
xrandr --output HDMI-1 --mode 1920x1080 --refresh 60
8.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
8.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
8.22 Chromium网页浏览器
8.22.1 GPU支持情况
系统预装的Chromium网页浏览器已经默认启用硬件加速，支持WebGL，可以通过输入网址 chrome://gpu 了解硬件加速情况，如下图所示：
8.22.2 VPU支持情况
在浏览器上播放一个视频,然后在命令行使用fuser查看mpp设备节点的使用情况来确认已经调用了vpu:
pi@FriendlyElec:~$ fuser /dev/mpp_service /dev/mpp_service: 3258
如果fuser命令没有内容输出, 则表示当前是软解.
8.22.3 查看支持的硬解格式
在浏览器地址栏输入 about://gpu，翻页到页面最底部，查看 "Video Acceleration Information" 表格;
播放一个视频后，再在浏览器地址栏输入 about://media-internals, 可以查看最近播放的视频是否启用了硬解;
8.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
9 Debian10 桌面系统的使用
- Refer to：
10 FriendlyCore的使用
10.1 FriendlyCore默认帐户
- 普通用户：
用户名: pi 密码: pi
- Root用户：
用户名: Root用户： 密码: fa
10.2 更新软件包
$ sudo apt-get update
10.3 配置网络
10.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另1个网口设置了静态IP地址, 设置如下:
eth1: 192.168.2.1
10.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
10.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
10.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。
10.4.1 重点支持的WIFI型号
10.4.1.1 M.2 WiFi Module
- RTL8822CE
10.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)
10.5 安装内核头文件
sudo dpkg -i /opt/linux-headers-*.deb
10.6 配置状态灯
先确定一下系统是否已经存在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/lan1_led/trigger echo eth1 > /sys/class/leds/lan1_led/device_name echo 1 > /sys/class/leds/lan1_led/link
板载的LED1可以根据需要进行配置，节点是 /sys/class/leds/usr_led。
11 如何编译系统
11.1 编译 Openwrt/Friendlywrt
11.1.1 下载源代码
FriendlyWrt有两个版本, 请根据需要进行选择.
11.1.1.1 版本FriendlyWrt 22.03
mkdir friendlywrt22-rk3588 cd friendlywrt22-rk3588 git clone https://github.com/friendlyarm/repo --depth 1 tools tools/repo init -u https://github.com/friendlyarm/friendlywrt_manifests -b master-v22.03 \ -m rk3588.xml --repo-url=https://github.com/friendlyarm/repo --no-clone-bundle tools/repo sync -c --no-clone-bundle
11.1.1.2 版本FriendlyWrt 21.02
mkdir friendlywrt21-rk3588 cd friendlywrt21-rk3588 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 rk3588.xml --repo-url=https://github.com/friendlyarm/repo --no-clone-bundle tools/repo sync -c --no-clone-bundle
11.1.2 首次编译
下面的命令是编译不带docker的版本, 如需要编译带docker的版本, 请将rk3588.mk替换为rk3588-docker.mk:
./build.sh rk3588.mk会编译所有组件（包含u-boot, kernel 和 friendlywrt）并生成sd卡镜像文件,再执行以下命令,可生成用于安装系统到emmc运行的镜像文件(eflahser固件):
./build.sh emmc-img对项目进行过修改后, 需要重新打包sd卡镜像, 可执行如下命令:
./build.sh sd-img11.1.3 二次编译
cd friendlywrt make menuconfig #改动FriendlyWrt的配置 rm -rf ./tmp make -j${nproc} cd ../ ./build.sh sd-img ./build.sh emmc-img
11.2 单独编译u-boot
./build.sh uboot11.3 单独编译kernel
./build.sh kernel11.4 单独编译friendlywrt
./build.sh friendlywrt或者进入friendlywrt目录, 按标准openwrt的命令操作, 上面的命令出现错误时, 可尝试使用以下命令单线程编译:
cd friendlywrt make -j1 V=s
12 备份文件系统并创建SD映像(将系统及应用复制到另一块开发板)
12.1 备份根文件系统
开发板上执行以下命令，备份整个文件系统（包括OS与数据)：
sudo passwd root su root cd / tar --warning=no-file-changed -cvpzf /rootfs.tar.gz \ --exclude=/rootfs.tar.gz --exclude=/var/lib/docker/runtimes \ --exclude=/etc/firstuser --exclude=/etc/friendlyelec-release \ --exclude=/usr/local/first_boot_flag --one-file-system /
注：备份时，如果系统中有挂载目录，最后会出现一个错误提示信息，可以无视它，我们本来就是要忽略这些目录
12.2 从根文件系统制作一个可启动的SD卡
Only support RK3328/RK3399/RK3568/RK3566/RK3588
12.3 更多文档
13 初始化NVME固态硬盘和USB移动硬盘
13.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
13.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
13.3 硬盘的自动挂载
13.3.1 在FriendlyWrt系统下挂载
在FriendlyWrt菜单中, 点击"系统"->"挂载点"界面, 在页面底部的"挂载点"的区域中, 点击"新增"按钮, 在UUID一栏中,选择你的硬盘分区, NVME固态硬盘选择 /dev/nvme0n1p1, 如果是USB移动硬盘, 则选择 /dev/sda1, 然后钩选"已启动“, 填写挂载硬盘的目标位置, 本例中选择将 NVME固态硬盘 挂载到 /mnt 目录, 如下图所示:
点击"Save"按钮保存设置, 挂载完成后界面会列出所挂载的硬盘, 如下图所示:
13.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
13.4 为硬盘设置网络共享
13.4.1 提升硬件挂载目录的权限
为了方便普通用户的读取, 进入终端, 输入以下命令先提升硬件挂载目录的权限:
chmod 777 /mnt
13.4.2 FriendlyWrt下设置网络共享
进入 “服务” -> "网络共享" 菜单, 在页面底部的 “共享目录” 区域, 点击 “新增” 按钮, 分别填写 "名称" 与 "路径" 为 mnt 和 /mnt, 其他默认, 点击 "保存并应用" 即可.
13.4.3 在电脑上访问共享
在Windows电脑上输入以下地址访问共享目录:
\\192.168.2.1\mnt
在Ubuntu/Mac电脑上使用以下地址访问共享目录:
smb://192.168.2.1/mnt
在询问身份验证时, 输入如下信息:
连接方式: 已注册用户
用户名: root
域: WORKGROUP
密码: password
13.5 本机上进行硬盘速度测试
13.5.1 NVME固态硬盘速度测试
13.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
13.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
13.5.2 USB移动机械硬盘速度测试
13.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
13.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
14 性能测试方法
14.1 测试2.5G网口速率
14.1.1 软件下载
Windows下可以到官网下载 iperf3测速工具: https://iperf.fr/iperf-download.php
Linux系统可以用以下命令安装: sudo apt-get install iperf3
14.1.2 开始测速
电脑需要配置2.5G或10G网卡, 用CAT6及以上规格的网线连接电脑到NanoPi-R6C的Lan网口,
电脑上打开浏览器, 进入FriendlyWrt后台页面, 进入 "服务“ -> “终端”, 登录后输入以下命令启用 iperf3 服务:
iperf3 -s -i 2
再打开电脑的终端, 输入以下命令开始测试RX速率:
iperf3 -c 192.168.2.1 -i 2 -t 30 -P4
输入以下命令开始测试TX速率:
iperf3 -c 192.168.2.1 -i 2 -t 30 -P4 -R
15 Link to Rockchip Resources
16 手册原理图等开发资料
- Schematic: NanoPi_R6C_2302_SCH.PDF
- PCB CAD File：NanoPi_R6C_2302_2d_dxf.zip
17 更新日志
17.1 2023-3-10
首次发布
