English

NanoPC-T6(简称”T6”)是友善电子团队设计出品的一款开源高性能一体化边缘计算平台，它带有双2.5G网口。它采用瑞芯微RK3588作为主控处理器, 配备4GB/8GB/16GB LPDDR4x内存，和32GB/64GB/256GB eMMC闪存，支持运行FriendlyWrt, Android, Debian和Ubuntu等多种系统, 支持GPU和VPU加速。 T6接口丰富，布局紧凑，主板尺寸只有110x80mm，可选配安装一体化CNC氧化铝外壳。它带有2个HDMI输出接口和一个HDMI IN接口，可解码播放最高8K60p H.265/VP9, 以及8K30p H264等格式视频。 T6带有1个USB3.0接口以及1个USB C接口，采用DV 12V供电。 T6非常适合企业客户定制开发带有多网口的迷你机器视觉系统，并适合嵌入式爱好者发掘、探索打造自己独具一格的玩法。

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

请参考: TF Cards We Tested

使用以下串口参数：

访问此处的下载地址下载需要的固件文件(位于"01_系统固件/01_SD卡固件"目录)和烧写工具(位于"05_工具软件"目录)：

详细操作步骤如下：

使用烧写了FriendlyWrt固件的TF卡启动NanoPC-T6, 登录FriendlyWrt页面, 在网页菜单上点击 "系统" -> "eMMC刷机助手" 进入eMMC刷机助手界面, 点击界面上的 "选择文件" 按钮, 选择你要刷写的文件 (官方固件以rk3588-sd开头), 亦可选择第三方固件, 文件支持 .gz 格式的压缩文件, 或者以 .img 作为扩展名的raw格式。 选择文件后, 点击 “上传并烧写” 按钮, 开始上传并烧写, 如下图所示: 烧写完成后,请弹出SD卡,设备会自动重启, 并从eMMC引导新系统，可留意指示灯的状态, 在系统状态灯闪烁，同时网卡状态灯亮起时，表示系统启动完成, 如果eMMC安装的系统是 FriendlyWrt, 则可以通过点击“进入首页”进入FriendlyWrt管理页面。 需要注意的是, 如果烧写的是FriendlyElec的固件, 网页烧写需要选用文件名带 "-sd-" 字样的镜像文件, 类拟如下的文件名:

第三方固件由于命名不规则,你需要确认的是:此固件支持从eMMC启动,如果文件格式是7z、zip或者rar格式, 需要先解压缩, 如果文件太大无法写入, 可以先压缩成 .gz 格式再尝试。

访问此处的下载地址下载eMMC烧写所需的文件及工具:

详细操作步骤如下：

1) 从网盘上下载文件名带 eflasher 字样的任意固件, 解压后烧进TF卡; 2) 重新拨插一次TF卡, PC上会出现一个名为FriendlyARM的盘符(Linux下是FriendlyARM目录), 将 .img 或者 .gz结尾的固件复制进去; 3) 编辑TF卡上的 eflasher.conf 配置文件, 修改 autoStart= 后面的值指定为你的固件文件名, 例如:

支持文件名带 "-sd-" 字样的镜像文件, 如下所示:

4) 安全弹出TF卡, 将TF卡放在NanoPC-T6上上电启动, 会自动烧写你的固件, 通过板载 LED 灯来了解安装进度;

如需要关闭自动烧写, 参考上一章节, 编辑flasher.conf配置文件中的autoStart值, 将其清空即可:

在这种使用场景下, 系统启动后, 会停留在选择固件的界面上, 需要连接HDMI显示器以及USB鼠标, 通过UI操作来进行固件烧写;

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

1) 断开NanoPC-T6上连接的USB和电源线, 弹出TF卡; 2) 按住Mask按键不放, 插上电源, 保持按住Mask键, 状态灯亮起3秒后即可松开; 3) 用USB A-to-A数据线 (也叫USB公对公数据线), 将NanoPC-T6与电脑进行连接, 连接方法参照下图, 需要连接靠近外侧的USB端口: TODO

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

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

根据需要到网盘上下载对应的压缩包, 在电脑上解压:

解压后, 可以看到固件目录下已内置了瑞芯微开发工具和预设好的配置文件, 双击 RKDevTool.exe 启动瑞芯微开发工具, 界面上会显示 "发现一个Maskrom设备", 点击界面上的“执行”按钮, 稍等片刻即可完成烧写, 完成后设备会自动重启, 并从eMMC启动你安装的系统;

默认情况下, 会优先从 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文件的大小是不重要的:

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

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

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

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

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

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

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

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

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

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

编辑 /etc/config/uhttpd，将原来的0.0.0.0和[::]地址改为本地lan的地址，例如：

完成后重启服务：

根据实际情况调整设置

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

(4) 配置完成后使用手机端或电脑端搜索对应SSID的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 。

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

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

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

解决办法:

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

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

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

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

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

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

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

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

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

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

Ubuntu 22.04 桌面 具有如下特点：

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

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

默认密码为pi

测试编译内核模块:

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

在终端上执行如下命令:

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

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

添加环境变量到 .bashrc:

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

运行以下命令安装:

成功安装后，启用 Plex（系统启动时自动启动）:

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

验证是否安装成功:

验证是否成功:

安装完成后, 在电脑浏览器上访问: http://设备IP地址:8888, 即可查看nextcloud网盘页面。

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

请参考 Use NetworkManager to configure network settings/zh

首先, 将CPU设置为性能模式:

然后启动glmark2-es2-wayland:

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

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

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

Android TV 是专门为电视而创建的一个Android版本，具有如下特点：

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

400px

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

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

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

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

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

新建如下文件:

内容如下:

设置systemd服务:

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

测试编译内核模块:

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

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

修改如下配置文件:

在终端上执行如下命令:

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

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

添加环境变量到 .bashrc:

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

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

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

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

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

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

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

请参考 Use NetworkManager to configure network settings/zh

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

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

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

输出示例：

例如设置为 1920X1080@60Hz:

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:

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

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

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

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

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

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

另1个网口设置了静态IP地址, 设置如下: eth1: 192.168.2.1

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

例如设置为192.168.1.1:

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

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

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

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

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

wlan0文件的内容如下：

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

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

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

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

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

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

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

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

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

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

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

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

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

Windows下可以到官网下载 iperf3测速工具: https://iperf.fr/iperf-download.php Linux系统可以用以下命令安装: sudo apt-get install iperf3

电脑需要配置2.5G或10G网卡, 用CAT6及以上规格的网线连接电脑到NanoPC-T6的Lan网口, 电脑上打开浏览器, 进入FriendlyWrt后台页面, 进入 "服务“ -> “终端”, 登录后输入以下命令启用 iperf3 服务:

再打开电脑的终端, 输入以下命令开始测试RX速率: