Difference between revisions of "NanoPC-T6/zh"

From FriendlyELEC WiKi
Jump to: navigation, search
(接口布局)
(接口布局和尺寸)
Line 233: Line 233:
 
*'''关于电源'''
 
*'''关于电源'''
 
** 电源输入接口为5.5*2.1mm DC连接器。支持5V~20V输入, 推荐使用12V电源。
 
** 电源输入接口为5.5*2.1mm DC连接器。支持5V~20V输入, 推荐使用12V电源。
** 以下是各个外设接口的电源输出能力。请根据实际使用情况计算实际功耗,总和不能超过40W。注意电源适配器也要有足够的输出功率。
+
** 以下是各个外设接口的电源输出能力。请根据实际使用情况计算实际功耗,总和不能超过35W。注意电源适配器也要有足够的输出功率。
 
::{| class="wikitable"
 
::{| class="wikitable"
 
|-
 
|-
Line 248: Line 248:
 
|GPIO      || 5V/0.5A, 3.3V/0.5A  || miniPCIe      || 3.3V/3A
 
|GPIO      || 5V/0.5A, 3.3V/0.5A  || miniPCIe      || 3.3V/3A
 
|-
 
|-
| Total    || 40W
+
| Total    || 35W
 
|}
 
|}
  

Revision as of 04:41, 14 April 2023

English

Contents

1 介绍

NanoPC-T6(简称”T6”)是友善电子团队设计出品的一款开源高性能一体化边缘计算平台,它带有双2.5G网口。它采用瑞芯微RK3588作为主控处理器, 配备4GB/8GB/16GB LPDDR4x内存,和32GB/64GB/256GB eMMC闪存,支持运行FriendlyWrt, Android, Debian和Ubuntu等多种系统, 支持GPU和VPU加速。

T6接口丰富,布局紧凑,主板尺寸只有TODO,可选配安装一体化CNC氧化铝外壳。它带有2个HDMI输出接口和一个HDMI IN接口,可解码播放最高8K60p H.265/VP9, 以及8K30p H264等格式视频。

T6带有1个USB3.0接口以及1个USB C接口,采用DV 12V供电。

T6非常适合企业客户定制开发带有多网口的迷你机器视觉系统,并适合嵌入式爱好者发掘、探索打造自己独具一格的玩法。

2 NanoPC-T6资源特性

  • SoC: Rockchip RK3588
    • CPU: 四核 ARM Cortex-A76(up to 2.4GHz) + 四核 Cortex-A55 (up to 1.8GHz)
    • GPU: Mali-G610 MP4, 兼容 OpenGLES 1.1, 2.0, 3.2, 以及OpenCL (up to 2.2) 和 Vulkan1.2
    • VPU: 支持8K@60fps H.265 和 VP9 解码, 8K@30fps H.264 解码, 4K@60fps AV1 解码, 8K@30fps H.264 和 H.265 编码
    • NPU: 6TOPs, 支持INT4/INT8/INT16/FP16
  • RAM: 64-bit 4GB/8GB/16GB LPDDR4X 频率高达2133MHz
  • Flash: 32GB/64GB/256GB eMMC, 最高支持 HS400 模式
  • microSD: 最高支持SDR104模式
  • Ethernet: 2个PCIe扩展的2.5G以太网
  • 4G LTE: 一个用于扩展4G LTE的mimiPCIe插槽和一个microSIM卡槽
  • USB-A: 一个USB 3.0 Type-A
  • USB-C: 一个全功能USB Type‑C™接口, 支持USB3.0数据传输和DP显示输出,分辨率高达4Kp60。
  • 视频输入:
    • 1x Standard HDMI input port, up to 4Kp60
    • 2x 4-lane MIPI-CSI, compatible with MIPI V1.2
  • 视频输出:
    • 2个标准尺寸HDMI输出接口
      • 兼容HDMI2.1, HDMI2.0, 以及HDMI1.4
      • one support displays up to 7680x4320@60Hz, another one support up to 4Kp60
      • Support RGB/YUV(up to 10bit) format
    • USB Type‑C™ DP显示输出,分辨率高达4Kp60
    • 2x 4-lane MIPI-DSI, compatible with MIPI DPHY 2.0 or CPHY 1.1
  • 音频:
    • 3.5mm耳机输出接口
    • 2.0mm PH-2A模拟麦克风输入接口
  • GPIO:
    • 40-Pin 2.54mm双排针接口
    • up to 2x SPIs, 6x UARTs, 1x I2Cs, 8x PWMs, 2x I2Ss, 28x GPIOs
  • M.2 Connectors
    • one M.2 M-Key connector with PCIe 3.0 x4
    • one M.2 E-key connector with PCIe 2.1 x1 and USB2.0 Host
  • 其它:
    • 2 Pin 1.27/1.25mm RTC battery input connector for low power RTC IC HYM8563TS
    • one 38Khz IR receiver
    • MASK button for eMMC update, reset button, and Power button
    • one 5V Fan connector
    • Debug UART, 3-Pin 2.54mm header, 3.3V level, 1500000bps
    • 2 x GPIO Controlled LED (SYS, LED1)
  • Power supply: 5.5*2.1mm DC Jack, 12VDC input.
  • PCB: 8 Layer, 110x80x1.6mm
  • Ambient Operating Temperature: 0℃ to 70℃

3 接口布局和尺寸

3.1 接口布局

  • 40-pin GPIO
Pin# GPIO SPI UART I2C I2S PWM POWER Description
1,17 VCC3V3_SYS_S3 3.3V Power Output, 500mA Max
2,4 VCC_5V0 5V Power Output, 500mA Max
6,9,14,20,25,30,34,39 GND Power and Signal Ground
3 GPIO1_D7 I2C8_SDA_M2 T6内部已经通过2.2K上拉到3.3V
5 GPIO1_D6 I2C8_SCL_M2 T6内部已经通过2.2K上拉到3.3V
7 GPIO3_B2 I2S2_SDI_M1 3.3V
8 GPIO0_C5 UART0_TX_M0 PWM4_M0 3.3V
10 GPIO0_C4 UART0_RX_M0 3.3V
11 GPIO3_C2 PWM14_M0 3.3V
12 GPIO3_B7 3.3V
13 GPIO3_C3 PWM15_IR_M0 3.3V
15 GPIO1_A7 3.3V
16 GPIO3_B3 I2S2_SDO_M1 3.3V
18 GPIO3_B4 I2S2_MCLK_M1 3.3V
19 GPIO1_B2 SPI0_MOSI_M2 UART4_RX_M2 3.3V
21 GPIO1_B1 SPI0_MISO_M2 3.3V
22 GPIO1_B5 SPI0_CS1_M0 UART7_TX_M2 3.3V
23 GPIO1_B3 SPI0_CLK_M2 UART4_TX_M2 3.3V
24 GPIO1_B4 SPI0_CS0_M2 UART7_RX_M2 3.3V
26 GPIO1_B0 3.3V
27 GPIO1_A0 UART6_RX_M1 3.3V
28 GPIO1_A1 UART6_TX_M1 3.3V
29 GPIO3_B5 UART3_TX_M1 I2S2_SCLK_M1 PWM12_M0 3.3V
31 GPIO3_B6 UART3_RX_M1 I2S2_LRCK_M1 PWM13_M0 3.3V
32 GPIO0_C6 PWM5_M1 3.3V
33 GPIO3_B0 PWM9_M0 3.3V
35 GPIO3_A0 SPI4_MISO_M1 I2S3_MCLK PWM10_M0 3.3V
36 GPIO3_A3 SPI4_CS0_M1 UART8_RX_M1 I2S3_SDO 3.3V
37 GPIO3_A4 SPI4_CS1_M1 I2S3_SDI 3.3V
38 GPIO3_A1 SPI4_MOSI_M1 I2S3_SCLK 3.3V
40 GPIO3_A2 SPI4_CLK_M1 UART8_TX_M1 I2S3_LRCK 3.3V
  • MIPI-DSI
0.5mm FPC Connector
Pin# MIPI-DSI0 MIPI-DSI1 Description
1,2,3 VCC_5V0 VCC_5V0 5V Power ouput
4,7,9,11,15,18,21,24,27,30 GND GND Power and Signal Ground
5 I2C5_SDA_M0 I2C4_SDA_M3 3.3V, I2C Data, T6内部已经通过2.2K上拉到3.3V
6 I2C5_SCL_M0 I2C4_SCL_M3 3.3V, I2C Clock, T6内部已经通过2.2K上拉到3.3V
8 GPIO3_C0 GPIO4_A0 3.3V, GPIO
10 GPIO3_B1/PWM2_M1 GPIO3_D5/PWM11_M3 3.3V, GPIO/PWM
12 GPIO3_A6 GPIO4_A3 3.3V, GPIO
13 /NC /NC No Connection
14 GPIO3_C1 GPIO4_A1 3.3V, GPIO
16 MIPI_DPHY0_TX_D3N MIPI_DPHY1_TX_D3N MIPI TX Lane3 ouput N
17 MIPI_DPHY0_TX_D3P MIPI_DPHY1_TX_D3P MIPI TX Lane3 ouput P
19 MIPI_DPHY0_TX_D2N MIPI_DPHY1_TX_D2N MIPI TX Lane2 ouput N
20 MIPI_DPHY0_TX_D2P MIPI_DPHY1_TX_D2P MIPI TX Lane2 ouput P
22 MIPI_DPHY0_TX_D1N MIPI_DPHY1_TX_D1N MIPI TX Lane1 ouput N
23 MIPI_DPHY0_TX_D1P MIPI_DPHY1_TX_D1P MIPI TX Lane1 ouput P
25 MIPI_DPHY0_TX_D0N MIPI_DPHY1_TX_D0N MIPI TX Lane0 ouput N
26 MIPI_DPHY0_TX_D0P MIPI_DPHY1_TX_D0P MIPI TX Lane0 ouput P
28 MIPI_DPHY0_TX_CLKN MIPI_DPHY1_TX_CLKN MIPI TX Clock ouput N
29 MIPI_DPHY0_TX_CLKP MIPI_DPHY1_TX_CLKP MIPI TX Clock ouput P
  • MIPI-CSI
0.5mm FPC Connector
Pin# MIPI-CSI0 MIPI-CSI1 Description
1,2 VCC_5V0 VCC_5V0 5V Power ouput
3,13,15,18,21,24,27,30 GND GND Power and Signal Ground
4,5,7 /NC /NC No Connection
6 VCC_1V8_S3 VCC_1V8_S3 1.8V Power ouput, 100mA Max
8 VSYNC_MASTER VSYNC_SLAVE 用于两个摄像头的同步信号互联,T6内部已经短接了这两个Pin
9 I2C3_SCL_M0 I2C7_SCL_M0 1.8V, I2C Clock, T6内部已经通过2.2K上拉到1.8V
10 I2C3_SDA_M0 I2C7_SDA_M0 1.8V, I2C Data, T6内部已经通过2.2K上拉到1.8V
11 GPIO4_C4 GPIO2_C1 1.8V, GPIO
12 GPIO4_C5 GPIO2_C2 1.8V, GPIO
14 MIPI_CAM1_CLKOUT MIPI_CAM2_CLKOUT 1.8V, CLock ouput for Sensor
16 MIPI_CSI0_RX_D3P MIPI_CSI1_RX_D3P MIPI RX Lane3 iuput P
17 MIPI_CSI0_RX_D3N MIPI_CSI1_RX_D3N MIPI RX Lane3 iuput N
19 MIPI_CSI0_RX_D2P MIPI_CSI1_RX_D2P MIPI RX Lane2 iuput P
20 MIPI_CSI0_RX_D2P MIPI_CSI1_RX_D2N MIPI RX Lane2 iuput N
22 MIPI_CSI0_RX_D1P MIPI_CSI1_RX_D1P MIPI RX Lane1 iuput P
23 MIPI_CSI0_RX_D1N MIPI_CSI1_RX_D1N MIPI RX Lane1 iuput N
25 MIPI_CSI0_RX_CLK0P MIPI_CSI1_RX_CLK0P MIPI RX Clock iuput P
26 MIPI_CSI0_RX_CLK0N MIPI_CSI1_RX_CLK0N MIPI RX Clock iuput N
28 MIPI_CSI0_RX_D0P MIPI_CSI1_RX_D0P MIPI RX Lane0 iuput P
29 MIPI_CSI0_RX_D0N MIPI_CSI1_RX_D0N MIPI RX Lane0 iuput N
  • 调试串口
3.3V电平, 波特率为1500000bps
Pin# Assignment Description
1 GND 0V
2 UART2_TX_M0_DEBUG output
3 UART2_RX_M0_DEBUG intput
  • 关于电源
    • 电源输入接口为5.5*2.1mm DC连接器。支持5V~20V输入, 推荐使用12V电源。
    • 以下是各个外设接口的电源输出能力。请根据实际使用情况计算实际功耗,总和不能超过35W。注意电源适配器也要有足够的输出功率。
Port Max Output Port Max Output
USB-A 3.0 5V/2A USB-C/DP 5V/2A
M.2 M-Key 3.3V/3A M.2 E-Key 3.3V/3A
MIPI-CSI0 5V/0.5A MIPI-CSI1 5V/0.5A
MIPI-DSI0 5V/1A MIPI-DSI1 5V/1A
GPIO 5V/0.5A, 3.3V/0.5A miniPCIe 3.3V/3A
Total 35W


  • RTC
RTC backup current is 0.25μA TYP (VDD =3.0V, TA =25℃).
Connector P/N: Molex 53398-0271
  • IR receiver
Connected to PWM3_IR_M0
38Khz carrier frequency
compatible with NEC protocol, User code is 3B4C
Support FriendlyELEC RC100 IR controller

4 快速入门

4.1 准备工作

要开启你的NanoPC-T6新玩具,请先准备好以下硬件

  • NanoPC-T6主板
  • MicroSD卡/TF卡: Class10或以上的 8GB SDHC卡
  • 一个DC接口的外接电源,要求输出为12V/2A
  • 如果需要开发与编译,则需要一台可以联网的电脑,推荐安装Ubuntu 18.04 64位系统,并使用下面的脚本初始化开发环境:

4.2 经测试可选用的TF卡

请参考: TF Cards We Tested

4.3 调试串口参数配置

使用以下串口参数:

波特率 1500000
数据位 8
奇偶校验 None
停止位 1
流控制 None

4.4 安装系统

4.4.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卡从电脑端弹出,插入NanoPC-T6的microSD卡槽;
  • 连接NanoPC-T6的电源,系统会从TF卡启动;

4.4.2 烧写系统到eMMC

4.4.2.1 方法1: 在网页上烧写

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

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

4.4.2.2 方法2: 用TF启动卡进行自动烧写

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

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

进度

SYS灯 (红灯)

上电开机

长亮

系统启动

慢闪

正在烧写

快闪

烧写完成

慢闪

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

4.4.2.2.1 烧写官方固件到eMMC

详细操作步骤如下:

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

4.4.2.3 方法3: 通过USB烧写
4.4.2.3.1 步骤1: 安装USB驱动和工具

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

4.4.2.3.2 步骤2: 将NanoPC-T6与电脑连接, 并进入刷机模式

1) 断开NanoPC-T6上连接的USB和电源线, 弹出TF卡;
2) 按住Mask按键不放, 插上电源, 保持按住Mask键, 状态灯亮起3秒后即可松开;
3) 用USB C-to-A数据线, 将NanoPC-T6与电脑进行连接, 连接到NanoPC-T6的USB C接口

4.4.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.5 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内的系统并没有适配NanoPC-T6, 也就是说Loader压根就是坏的;

这时, 可以用如下方法让NanoPC-T6从TF卡启动系统, 进行系统重装或Flash擦除:
1) 插入一张烧写有FriendlyWrt系统的TF卡 (制作方法请参考上面的章节);
2) 按下Maskrom按键, 并上电开机 (或短接Maskrom触点);
3) 重要: 上电后默数4秒左右立即松开Maskrom按键;
4) NanoPC-T6将会从TF卡启动FriendlyWrt系统;
5) 用网线连接电脑到NanoPC-T6的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登录,建议在将NanoPC-T6连接到互联网之前完成此设置。

5.4 登录FriendlyWrt

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

以上是NanoPC-T6的LAN口地址,WAN口会从你的主路由器动态获取IP地址。

5.5 建议的安全性设置

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

  • 设置一个安全的密码

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

  • 禁止从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.cloud.tencent.com/openwrt/releases/23.05.2/packages/aarch64_cortex-a53/base
src/gz openwrt_luci https://mirrors.cloud.tencent.com/openwrt/releases/23.05.2/packages/aarch64_cortex-a53/luci
src/gz openwrt_packages https://mirrors.cloud.tencent.com/openwrt/releases/23.05.2/packages/aarch64_cortex-a53/packages
src/gz openwrt_routing https://mirrors.cloud.tencent.com/openwrt/releases/23.05.2/packages/aarch64_cortex-a53/routing
src/gz openwrt_telephony https://mirrors.cloud.tencent.com/openwrt/releases/23.05.2/packages/aarch64_cortex-a53/telephony
src/gz friendlywrt_packages file://opt/packages
  • 注意, friendlywrt_packages需要保留, 否则会缺少一些系统依赖;
  • 如果你使用的是 friendlywrt 21.02 的固件, 则将上面的 23.05.2 替换成 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,而NanoPC-T6工作在IPv6,电脑有可能无法连接互联网,建议关闭IPv6 (本WiKi后面有介绍方法),或将主路由切换到IPv6;
  • 如果你有问题,或有更好的建议,欢迎发送邮件到 techsupport@friendlyarm.com;

5.11 禁用IPv6

要关掉 IPv6,可在ssh终端输入如下命令:

. /root/setup.sh
disable_ipv6
reboot

待NanoPC-T6重启完毕,电脑也需要重新插拨一下网线(或重启网络端口)以便重新获得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-ec20-config-cn.png

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

Friendlywrt-ec20-netstatus-cn.png

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

5.14 使用USB2LCD查看IP和温度

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

. /root/setup.sh
init_lcd2usb
poweroff

将USB2LCD模块Plug到 NanoPC-T6 的USB接口再开机,IP地址和CPU温度将显示在LCD上:
Xxx-usb2lcd-01.png


5.15 如何使用M.2 WiFi

  • NanoPC-T6支持的M.2 WiFi型号为: rtl8822ce

5.15.1 AP模式

  • FriendlyWrt系统的无线功能默认是关闭状态, 要启用WiFi, 可点击“网络>无线”进入配置无线WiFi界面, 找到“无线未启用”那一行, 点击后面的“启用”按钮即可
  • 启用后, 在手机上搜索连接名称类拟 FriendlyWrt-xx:yy:zz 名称的WiFi热点, 输入默认密码password即可连接

5.15.2 无线中继模式

NanoPiAPMode.jpg

  • 连接到主无线路由器

点击 "网络" -> "无线", 在界面上点击 "Generic MAC80211 802.11ac/b/g/n" 后面的 "扫描" 按钮扫描网络,点击无线路由器后面的 "加入网络" 按钮,
在加入网络的配置页面中,勾选 "重置无线配置",在 "WPA密钥"一栏中输入密钥,其他配置保持默认,点 "提交",
点击 "高级设置", 在 “接口名称” 中输入 "wlan0", 再点击 "保存",
最后点 "保存并应用", 连接成功后,可以在FriendlyWrt首页看到IP地址。

  • 创建无线热点

点击 "网络" -> "无线",在界面上点击 "Generic MAC80211 802.11ac/b/g/n" 后面的 "添加" 按钮,将会弹出 "编辑无线网络" 页面,
在 "工作频率" 一栏中设置无线信道(例如"40 (5200 MHz)"),
在 "ESSID" 一栏中,输入热点名称,
在 "网络" 一栏中,钩选 "lan",
点击 "无线安全", 设置加密类型 (例如 "WPA2-PSK(强安全性)")和密钥,
点击 "高级设置", 在 “接口名称” 中输入 "wlan1",
然后点击 "保存", 然后点击 "保存并应用",
由于需要重启才能生效,点击 "系统" 选择 "重启"。

5.16 如何使用USB WiFi

5.16.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.16.2 如何使用USB WiFi作为AP

(1) 把USB WiFi插入NanoPC-T6的USB端口,推荐使用以下列表中支持AP模式的WiFi芯片模块:
R2swrt+usbwifi-20210831.jpg
注:符合以上WiFi芯片型号并符合以上VID&PID信息的USB无线网卡都可以使用,支持的型号不局限于某个品牌某个型号
(2) 插入USB WiFi后,点击上方菜单栏的“系统>重启”,点击“执行重启”按钮重启NanoPC-T6

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

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

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

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

5.16.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.16.4 更改系统默认的WiFi热点配置

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

/lib/wifi/mac80211.sh

5.17 玩转Docker应用

5.17.1 Docker使用:安装JellyFin影音服务器

请参考: How to setup JellyFin media system on NanoPi-R2S/zh

5.17.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.3 使用外接硬盘来扩展Docker可用空间

  • 先停止docker服务:
/etc/init.d/dockerd stop
  • 把原来的/opt目录改个名, 建一个空的/opt目录:
mv /opt /opt-old && mkdir /opt
  • 参考章节“8 初始化NVME固态硬盘和USB移动硬盘”, 将你的硬盘格式化为ext4, 然后挂载至 /opt 目录:

Friendlywrt mount nvme opt-zh.jpg

  • 输入命令 "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空间已扩容:

Friendlywrt docker info-zh.jpg

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

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

解决办法:

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

5.18 挂载smbfs共享资源

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


5.19 使用sdk编译软件包

5.19.1 安装编译环境

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

5.19.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.19.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.19.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.20 使用 GitHub Actions 编译 FriendlyWrt

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

5.21 Compile u-boot,kernel or friendlywrt

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, 玩法丰富;

Ubuntu2204desktop.png

6.2 Account & Password

6.3 帐户与密码

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

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

6.4 查看IP地址

由于主机名默认为FriendlyElec.lan, 所以可以使用ping命令来获得IP地址:

ping FriendlyElec.lan

6.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和桌面墙纸

替换内核下面的两个文件,重新编译内核:
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 reboot

6.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 info

6.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 了解硬件加速情况,如下图所示:
Rk35xx-ubuntu-chromium-gpu.png

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;
  • 支持视频硬解码等;

AndroidTV12.png

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的使用

7.2.1 USB连接

请注意: 开启ADB后, 该USB3端口将工作在Device模式, 如果需要连接U盘等设备,你需要关闭ADB并重启开发板
一般情况下adb是默认关闭的,请执行以下步骤开启:

  • 用USB A-to-A数据线 (也叫USB公对公数据线), 将开发板与电脑进行连接, 连接方法参照下图, 需要连接靠近外侧的USB端口:

400px

7.2.2 Android Tablet界面下开启

  • Android Tablet界面下, 依次进入 Settings -> About tablet -> 连续点击7下屏幕最下面的Build number
  • 再次进入Android系统的Settings -> System -> Advance -> Developer options, 勾选 USB debugging
  • 重新开机

7.2.3 Android TV界面下开启

  • Android TV界面下, 点击右上角的Settings图标(齿轮形状的图标), 依次进入 Device Preferences -> About -> 连续点击7下屏幕最下面的Android TV OS build
  • 再次点击右上角的Settings图标(齿轮形状的图标) -> Device Preferences -> Developer options, 勾选 USB debugging
  • 重新开机

7.2.4 使用adb

  • 基于你的操作系统安装 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等应用, 玩法丰富;

Debian10-lxde.png

8.2 帐户与密码

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

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

8.3 查看IP地址

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

8.4 通过ssh登录Debian

使用以下命令:ssh pi@NanoPC-T6
默认密码为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进行连接:
Debian10-x11vnc.png

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 reboot

8.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即可切换中英文输入法, 右上角也出现了输入法图标, 右击右上角的输入法图标, 在弹出菜单中可以切换输入法, 如下图所示:
Debian10-chinese-im.png

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=0

8.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 了解硬件加速情况,如下图所示:
Rk35xx-debian-chromium-gpu.png

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 桌面系统的使用

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

下面的脚本代码将板载LED1与第一个网卡相关联, 需要加入到开机自动运行的脚本中:

echo netdev > /sys/class/leds/usr_led/trigger
echo eth0 > /sys/class/leds/usr_led/device_name
echo 1 > /sys/class/leds/usr_led/link

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-img

11.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 uboot

11.3 单独编译kernel

./build.sh kernel

11.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/RK3588

13 更改内核命令行参数

13.1 eMMC启动

步骤如下:
先做一张eflahser的烧写卡 (使用rk3xxxx-eflasher-开头的固件文件),
将烧写卡插入电脑,进入sd卡的OS相关目录,编辑文件parameter.txt, 这是个文本文件,里面有命令行参数,
然后再用烧写卡启动,把系统烧写进 eMMC。

13.2 SD启动

要修改SD卡启动时的命令行参数, 需要重新打包SD卡镜像文件, 可以使用我们提供的sd-fuse脚本来辅助打包:
仅支持RK3328/RK3399/RK3568/RK3588

13.3 更多文档

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及以上规格的网线连接电脑到NanoPC-T6的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 手册原理图等开发资料

17 更新日志

17.1 首次发布