查看“4003 FriendlyElec NanoPi NEO3”的源代码

== '''关键词''' ==
友善、NanoPi NEO3、RK3328、DDR4、USB2.0、Type-C、FriendlyWrt、OpenWrt、OpenMediaVault、Debian、Ubuntu

== '''一、简介''' ==
NanoPi NEO3是FriendlyELEC为创客、业余爱好者和粉丝开发的一款开发板。

== '''二、硬件资源''' ==
SoC：RockChip RK3328，四核64位高性能Cortex A53；

RAM：1GB/2GB DDR4；

LAN：10/100/1000M以太网，带全球唯一MAC地址；

USB：一路USB3.0-A口、两路USB2.0，2.54mm间距；

MicroSD插槽：一路MicroSD，用于系统启动和存储；

LED：电源LEDx1，系统LEDx1；

按键：用户按键x1；

风扇：一个2Pin JST ZH 1.5mm连接器，用于5V风扇；

GPIO：26pin 2.54mm间距，包括I2C、UART、SPI、I2S、GPIO等；

串口：3pin 2.54mm间距，波特率为1500000bps；

电源：5V/1A，通过Type-C或GPIO；

PCB尺寸：48x48mm；

工作温度：-20℃至70℃；

重量：22g。

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_01.jpg

== '''三、友善介绍页面''' ==
https://wiki.friendlyelec.com/wiki/index.php/NanoPi_NEO3/zh

== '''四、硬件外设选配''' ==
1. 高通4G LTE模组：

http://www.mcuzone.com/wiki/4001_Friendly_NanoPi_R3S/4001_Friendly_NanoPi_R3S_26.jpg

2. Air600E 4G模组

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_50.jpg

注：Air600E 4G模组和高通4G CAT模组配置完毕后即可联网，下次开机自动联网。其余如国产4G CAT4模组、ZTE CAT4模组等，需要开机后再插入4G模组进行配置，否则可能会因为4G先于R3S的网卡识别而导致网卡序号混乱进而无法访问后台。

3. 外置USB MT7662无线网卡。

== '''五、软件功能演示''' ==

=== 5.1 设备启动及网口调整 ===
首先将FriendlyWrt系统烧写进TF卡。

友善官方烧写包版本：rk3328-sd-friendlywrt-23.05-20240314.img.gz

NanoPi NEO3只有一个原生千兆网口，在官方FriendlyWrt系统中被定义为WAN口，所以我们需要在系统启动前将一条连接上游路由器的网线插入NanoPi NEO3的千兆网口，然后启动系统。

待系统启动完毕，在同一局域网内的PC上，使用浏览器打开下面的网址：

http://friendlywrt/

即为FriendlyWrt系统的管理页面，按正常方式登录即可。

点击 ”网络 - 接口“，在界面上点击wan和wan6后面的“删除”：

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_02.jpg

然后点击选项卡的“设备”，进入设备页面，点击br-lan后面的配置：

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_03.jpg

在配置页面中，点击“网桥端口”后面的下拉箭头，只选中eth0：

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_04.jpg

按保存，回到上一页面，然后按“保存并应用”：

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_05.jpg

这样，就把原生网口从WAN口调整为LAN口了。

将原生网口与PC的网口直连，重启系统，PC网口就会获得192.168.2.x这样的地址，启动完毕后，在PC上使用浏览器访问192.168.2.1，即可登录FriendlyWrt系统的管理页面。

=== 5.2 系统总览 ===
http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_06.jpg

=== 5.3 友善电子FriendlyWrt主要功能 ===

==== 5.3.1 支持通过USB无线网卡上网 ====
以外置MT7662 USB无线网卡为例。

NanoPi NEO3可选配外置MT7662 USB无线网卡，可工作在AP模式，亦可工作在无线中继模式实现无线扩展。

===== 5.3.1.1 Client模式连接到主无线路由器 =====
将MT7662 USB无线网卡插入NanoPi NEO3的USB-A接口，重启系统。

点击 ”网络 - 无线“，在界面上点击”Aukey USBAC1200 802.11ac/b/g/n“后面的”扫描“按钮扫描网络，点击无线路由器后面的”加入网络“按钮，在加入网络的配置页面中，勾选”重置无线配置“，在”WPA密钥“一栏中输入密钥，其他配置保持默认，点 ”提交“：

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_07.jpg

点击”接口设置 - 高级设置“，在”接口名称“中输入”wlan0“，再点击”保存“：

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_08.jpg

最后点”保存并应用“，连接成功后，可以在”网络 - 接口“看到IP地址：

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_09.jpg

WiFi模块上网测速（可跑满200M电信宽带）：

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_10.jpg

'''''注意：网络测速受网络环境和测试方法影响，速度请以实际为准，本测试仅供参考。'''''

Client模式连接到千兆无线路由器，使用iperf3测速：

NanoPi NEO3作为client，测速大约为186Mbps：

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_11.jpg

NanoPi NEO3作为server，测速大约为192Mbps：

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_12.jpg

'''''注意：网络测速受网络环境和测试方法影响，速度请以实际为准，本测试仅供参考。'''''

===== 5.3.1.2 Master模式创建无线热点 =====
点击 ”网络 - 无线“，如果之前有设置了Client上网，建议先删除或者禁用这个接口。

在界面上点击”Aukey USBAC1200 802.11ac/b/g/n“后面的”添加“按钮，将会弹出”编辑无线网络“页面，在”工作频率“一栏中设置无线信道（例如”40 (5200 MHz)“），在”ESSID“一栏中，输入热点名称，在”网络“一栏中，勾选”lan“，点击”无线安全“，设置加密类型 （例如”WPA2-PSK（强安全性）“）和密钥：

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_13.jpg

点击“高级设置”，在“接口名称”中输入“wlan1”：

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_14.jpg

然后点击“保存”，然后点击“保存并应用”：

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_15.jpg

由于需要重启才能生效，点击“系统”选择“重启”，重启后回到“无线”，使用手机等设备连接这个无线AP：

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_16.jpg

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_17.jpg

因为NanoPi NEO3只有一个网口，而这个网口已经被用作LAN口了，所以现在没有WAN口可以连接上游路由器，因此无法上网。但是可以按照[[4003 FriendlyElec NanoPi NEO3#5.3.1 支持通过4G模组上网|5.3.1节]]中所述，安装4G模组，系统采用Mcuzone系统烧写包，因为Mcuzone系统烧写包支持4G模组（FriendlyWrt系统不支持4G模组），所以可以将4G模组作为WAN，这样手机等设备连接这个无线AP后就可以上网了。

Master模式下，PC连NanoPi NEO3建立的无线热点，使用iperf3在PC和NanoPi NEO3之间测速：

NanoPi NEO3作为client，测速大约为395Mbps：

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_18.jpg

NanoPi NEO3作为server，测速大约为283Mbps：

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_19.jpg

'''''注意：网络测速受网络环境和测试方法影响，速度请以实际为准，本测试仅供参考。'''''

===== 5.3.1.3 无线中继模式 =====
第一步：连接到主无线路由器。

点击“网络 - 无线”，在界面上点击“Aukey USBAC1200 802.11ac/b/g/n”后面的“扫描”按钮扫描网络，点击无线路由器后面的“加入网络”按钮：

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_20.jpg

在加入网络的配置页面中，勾选“重置无线配置”，在“WPA密钥”一栏中输入密钥，其他配置保持默认，点“提交”：

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_21.jpg

点击“高级设置”，在“接口名称”中输入“wlan0”，再点击“保存”：

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_22.jpg

最后点击“保存并应用”:

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_23.jpg

连接成功后，可以在“网络 - 接口”中看到IP地址：

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_24.jpg

第二步：创建无线热点。

点击“网络 - 无线”，在界面上点击“Aukey USBAC1200 802.11ac/b/g/n”后面的“添加”按钮，将会弹出“编辑无线网络”页面，在 "工作频率" 一栏中设置无线信道（例如"40 (5200 MHz)"），在“ESSID”一栏中，输入热点名称，在 "网络" 一栏中，勾选 "lan"，点击“无线安全”，设置加密类型 （例如 "WPA2-PSK（强安全性）"）和密钥：

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_25.jpg

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_26.jpg

点击“接口配置 - 高级设置”，在“接口名称”中输入“wlan1”：

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_27.jpg

然后点击“保存”，然后点击“保存并应用”：

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_28.jpg

由于需要重启才能生效，点击“系统”选择“重启”。

第三步：无线设备连接热点上网。

使用手机等无线设备连接第二步中设置的无线热点，即可上网：

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_29.jpg

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_30.jpg

手机连接无线热点上网测速：

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_31.jpg

'''''注意：网络测速受网络环境和测试方法影响，速度请以实际为准，本测试仅供参考。'''''

===== 5.3.1.4 测试总结 =====
经实测，NanoPi NEO3在运行FriendlyWrt时对MT7662 USB无线网卡支持完美，无论在Client模式下还是在Master模式下都能正常使用，也可以使用中继模式开启热点给其它设备上网；而RTL8812 USB无线网卡只能运行在Client模式下（不稳定），Master模式下无法使用。

==== 5.3.2 支持USB有线网卡设置为WAN ====
以外置RTL8153 USB网卡为例，可以将这个网卡[[4002 FriendlyElec NanoPi R2S Plus#5.2.3 支持USB有线网卡设置双LAN|设置为第二个LAN口]]，但是因为NanoPi NEO3本身只有一个原生网口，且目前已经把这个网口配置成了LAN口了，所以再添加一个LAN口意义不大，因此本节主要介绍如何将这块USB网卡设置成为WAN口。

先不接USB网卡，系统正常启动，登录后台页面。

再插入USB网卡，稍等片刻，等在终端中执行<code>ifconfig -a</code>后出现eth1即可：

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_32.jpg

然后进入”网络 - 接口“，点击“添加新接口”：

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_33.jpg

按下图设置新接口，然后点击“创建新接口”：

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_34.jpg

点击“防火墙设置”，将防火墙区域指定为wan，点击“保存”：

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_35.jpg

回到上一页面，点击“保存并应用”，然后将连接上级路由器的网线插入USB网卡的网口，稍等片刻，即可看到WWAN2获取了正确的IP地址：

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_36.jpg

此时PC通过NanoPi NEO3可以上网，测试下网速（可跑满200M电信宽带）：

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_37.jpg

'''''注意：网络测速受网络环境和测试方法影响，速度请以实际为准，本测试仅供参考。'''''

==== 5.3.3 刷机方式 ====
友善电子提供了USB（线刷）、SD、eflasher（卡刷）三种形式的固件包，但是NanoPi NEO3没有eMMC，所以只能使用从SD卡启动的方式，详情请参阅[https://wiki.friendlyelec.com/wiki/index.php/NanoPi_NEO3/zh 友善电子官方文档]。

==== 5.3.4 Adblock ====
http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_38.jpg

==== 5.3.5 统计 ====
如温控统计、处理器统计等：

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_39.jpg

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_40.jpg

=== 5.3 Mcuzone新增功能 ===
Mcuzone系统烧写包版本：friendlywrt_23.05_20240823_rk3328_arm64_sd.img.gz

==== 5.3.1 支持通过4G模组上网 ====
经测试，Air600E 4G模组和高通4G CAT模组配置完毕后即可联网，下次开机自动联网。其余如国产4G CAT4模组、ZTE CAT4模组等，需要开机后再插入4G模组进行配置，否则可能会因为4G先于R3S的网卡识别而导致网卡序号混乱进而无法访问后台。

重烧系统后需要重新配置LAN口，所以请按照[[4003 FriendlyElec NanoPi NEO3#5.1 设备启动及网口调整|5.1节]]所述，将NanoPi NEO3的原生网口设置为LAN口。

以Air600E 4G模组为例，将已插入SIM卡的4G模组与NanoPi NEO3通过排针连接，启动系统，进入”网络 - 接口“，点击“添加新接口”：

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_41.jpg

按下图设置新接口（eth1即为4G模组），然后点击“创建新接口”：

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_42.jpg

点击“防火墙设置”，将防火墙区域指定为wan，点击“保存”：

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_43.jpg

回到上一页面，点击“保存并应用”，稍等片刻，即可看到WWAN3获取了正确的IP地址：

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_44.jpg

此时PC通过Air600E 4G模组可以上网，测试下网速：

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_45.jpg

如果4G模组为USB接口，则将4G模组直接插入NanoPi NEO3的USB-A口，即可配置使用。

==== 5.3.2 支持WiFi上网 ====
本系统也支持USB无线网卡（如外置MT7662 USB无线网卡）上网。

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_46.jpg

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_47.jpg

经实测，NanoPi NEO3在运行本系统时对MT7662 USB无线网卡支持完美，无论在Client模式下还是在Master模式下都能正常使用，也可以使用中继模式开启热点给其它设备上网；而RTL8812 USB无线网卡只能运行在Client模式下（不稳定），Master模式下无法使用。

==== 5.3.3 其它功能 ====
注：该功能需要在存在WAN口，并且WAN口能上网的情况下才能使用。

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_48.jpg

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_49.jpg

=== 5.5 Ubuntu Noble Core 6.1系统测试 ===

==== 5.5.1 烧写系统及设备连接 ====
首先将Ubuntu Noble Core 6.1系统烧写进TF卡。

友善官方烧写包版本：rk3328-sd-ubuntu-noble-core-6.1-arm64-20240818.img.gz

本次测试的目的：验证NanoPi NEO3的原生千兆网口接内网，通过内网PC连接SSH控制操作系统，确认可以通过4G模组连接Internet。

连接方法：

NanoPi NEO3的原生千兆网口接无线路由器的有线网口，PC通过无线网络连接无线路由器，4G模组插入可上网的SIM卡，为了区别内外网，本无线路由器不连接Internet。

==== 5.5.2 SSH连接系统 ====
系统启动后，通过路由器的后台，查看NanoPi NEO3的ip地址：

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_51.jpg

然后使用MobaXterm，通过SSH连接系统（用户名和密码都是<code>pi</code>）：

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_52.jpg

==== 5.5.3 测试网络连接 ====
执行<code>ifconfig -a</code>，查看网络参数如下：

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_53.jpg

可见4G模组为eth1，且已经获取了ip。

ping外网ip地址，可以ping通，说明可以连接Internet，因为原生千兆网口连接的路由器不连通Internet，所以此时是通过4G网络上网：

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_54.jpg

如果需要ping域名，则需要修改resolv.conf文件：

<code>sudo vi /etc/resolv.conf</code>

将下图黄色框中的地址改为常用的DNS服务器地址（如所示的114.114.114.114）：

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_55.jpg

保存退出后即可正常ping通域名：

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_56.jpg

但是单单这么修改的话，重启后resolv.conf文件内的DNS会被修改到默认地址，所以还需要修改resolv.conf文件的权限，因为/etc/resolv.conf实际上是个软链接，所以需要重新生成resolv.conf文件才能修改权限，方法如下：

<code>sudo mv /etc/resolv.conf /etc/resolv.conf.link</code>

<code>sudo vi /etc/resolv.conf</code>

这样就重新建立了resolv.conf文件，在这个新建的文件中输入：

<code>nameserver 114.114.114.114</code>

保存退出，然后执行：

<code>sudo chattr +i /etc/resolv.conf</code>

做完上述步骤后，重启系统，resolv.conf文件的内容也不会变化了。

==== 5.5.4 查看USB设备 ====
首先需要安装usbutils：

<code>sudo apt install usbutils</code>

安装完毕后可使用<code>lsusb</code>查看USB设备，红框处即为4G模组：

http://www.mcuzone.com/wiki/4003_FriendlyElec_NanoPi_NEO3/4003_FriendlyElec_NanoPi_NEO3_57.jpg

{{联系我们_图标}}