¶ 简介
Banana Pi BPI-R3 Mini 路由器开发板采用 MediaTek MT7986A（Filogic 830）四核 ARM Cortex-A53 芯片，板载 2 GB DDR 内存和 8 GB eMMC。它是一款高性能开源路由器开发板，采用 MT7976C 支持 2.4 GHz/5 GHz Wi-Fi 6，并提供两个 2.5GbE 以太网端口。
¶ MediaTek MT7986(Filogic 830)
MT7986（Filogic 830）集成四个最高 2 GHz 的 Arm Cortex-A53 内核，处理能力最高可达 18,000 DMIPS，并支持总速率达 6 Gbps 的双频 4×4 Wi-Fi 6 连接。它提供两个 2.5G 以太网接口和串行外设接口（SPI）。Filogic 830 内置的硬件加速引擎可实现快速、可靠的 Wi-Fi 卸载和无线网络连接。此外，该芯片还支持 MediaTek FastPath™ 技术，适用于游戏、AR/VR 等低延迟应用。
与上一代技术相比，Wi-Fi 6 具有更低的延迟、更大的带宽容量和更快的传输速率。支持 6 GHz 频段的无线设备主要利用 160 MHz 宽信道和较少拥塞的 6 GHz 频谱，提供多千兆传输及低延迟 Wi-Fi 连接，为流媒体、游戏、AR/VR 等应用提供可靠的无线网络。
¶ 规格参数
-
MediaTek MT7986A（Filogic 830）四核 ARM Cortex-A53
-
WiFi 6 2.4G/5G（MT7976C）
-
2 GB DDR 内存
-
8 GB eMMC 闪存
-
128 MB NAND 闪存
-
2 个 2.5GbE 以太网端口
-
1 个 M.2 Key B USB 接口
-
1 个 M.2 Key M PCIe 接口
-
1 个 USB 2.0 接口
¶ 开发
¶ 准备
-
准备一个 USB 转串口适配器。
-
使用 USB 转串口适配器连接 BPI-R3 Mini 的调试控制台。
-
调试串口：3.3 V TTL，波特率 115200。
-
LAN 口默认 IP 地址：192.168.1.1
-
用户名/密码：pi/bananapi ,root/bananapi。+ 也可以使用无密码的 root 用户登录。
-
WiFi：OpenWrt
-
-
R3 Mini 启动开关跳线设置
支持从 eMMC 或 NAND 启动。
¶ 警告
| BPI-R3 Mini 不支持从 SD 卡启动，因此出厂时会在 NAND 和 eMMC 中预先烧录默认镜像。 请始终确保 eMMC 或 NAND 中至少有一个设备包含可启动镜像，这一点非常重要！ |
-
如需更新 eMMC，请从 NAND 启动
-
如需更新 NAND，则从 eMMC 启动。
¶ Linux
¶ 将镜像烧录到板载 eMMC
| 更新 eMMC 时，首先将启动开关切换为从 NAND 启动。系统启动后，将 eMMC 镜像烧录到 eMMC，最后再把启动方式切换为从 eMMC 启动。 |
向 eMMC 烧录镜像前，请准备一个 U 盘。下面以 OpenWrt 镜像（mtk-bpi-r3mini-EMMC-20230719.img、bl2_emmc-r3mini.img）为例：
-
将 eMMC 启动用 OpenWrt 镜像（mtk-bpi-r3mini-EMMC-20230719.img、bl2_emmc.img）复制到 U 盘。
-
调整启动开关跳线，使开发板从 NAND 启动，然后上电。
-
将 U 盘插入开发板，并按如下方式将其挂载到 /mnt 或其他目录：（如果已自动挂载，可跳过此步）
mount -t vfat /dev/sda1 /mnt切换到挂载点，本例为：
cd /mnt -
执行以下命令，启用 eMMC 并将镜像写入 eMMC：
echo 0 > /sys/block/mmcblk0boot0/force_ro dd if=bl2_emmc-r3mini.img of=/dev/mmcblk0boot0 dd if=mtk-bpi-r3mini-EMMC-20230719.img of=/dev/mmcblk0 mmc bootpart enable 1 1 /dev/mmcblk0 -
关闭 R3 Mini 开发板电源，拔出 U 盘，并将启动方式切换为从 eMMC 启动。
启用 eMMC 设备，并将启动方式设为从 eMMC 启动。
¶ 将镜像烧录到板载 NAND
| 更新 NAND 时，首先将启动开关切换为从 eMMC 启动。系统启动后，将 NAND 镜像烧录到 NAND，最后再把启动方式切换为从 NAND 启动。 |
向 NAND 烧录镜像前，请准备一个 U 盘。下面以 OpenWrt 镜像（mtk-bpi-r3mini-NAND-20230719-single-image.bin）为例：
-
将 NAND 启动用 OpenWrt 镜像（mtk-bpi-r3mini-NAND-20230719-single-image.bin）复制到 U 盘。
-
调整启动开关跳线，使开发板从 eMMC 启动，然后上电。
-
将 U 盘插入开发板，并按如下方式将其挂载到 /mnt 或其他目录：（如果已自动挂载，可跳过此步）
mount -t vfat /dev/sda1 /mnt切换到挂载点，本例为：
cd /mnt -
执行以下命令，擦除整个 NAND 闪存并将镜像写入 NAND：
mtd erase /dev/mtd0 dd if=mtk-bpi-r3mini-NAND-20230719-single-image.bin of=/dev/mtdblock0 -
关闭 BPI-R3 Mini 开发板电源，拔出 U 盘，并将启动方式切换为从 NAND 启动。
启用 NAND 设备，并将启动方式设为从 NAND 启动。
¶ 网络配置
网络接口：eth1 用作 WAN；eth0、rax0、ra0 用作 LAN。其中 ra0 用于 2.4 GHz 无线网络，rax0 用于 5 GHz 无线网络。
root@OpenWrt:/# ifconfig
br-lan Link encap:Ethernet HWaddr EE:A1:57:81:CA:19
inet addr:192.168.1.1 Bcast:192.168.1.255 Mask:255.255.255.0
inet6 addr: fe80::eca1:57ff:fe81:ca19/64 Scope:Link
inet6 addr: fd63:8bea:d5ce::1/60 Scope:Global
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:0 errors:0 dropped:0 overruns:0 frame:0
TX packets:15 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:0 (0.0 B) TX bytes:2418 (2.3 KiB)
br-wan Link encap:Ethernet HWaddr EE:A1:57:81:CA:19
inet6 addr: fe80::eca1:57ff:fe81:ca19/64 Scope:Link
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:0 errors:0 dropped:0 overruns:0 frame:0
TX packets:34 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:0 (0.0 B) TX bytes:8538 (8.3 KiB)
eth0 Link encap:Ethernet HWaddr EE:A1:57:81:CA:19
inet6 addr: fe80::eca1:57ff:fe81:ca19/64 Scope:Link
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:0 errors:0 dropped:0 overruns:0 frame:0
TX packets:32 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:0 (0.0 B) TX bytes:4408 (4.3 KiB)
Interrupt:124
eth1 Link encap:Ethernet HWaddr 4A:BB:84:B4:5D:3F
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:0 errors:0 dropped:0 overruns:0 frame:0
TX packets:34 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:0 (0.0 B) TX bytes:8674 (8.4 KiB)
Interrupt:124
lo Link encap:Local Loopback
inet addr:127.0.0.1 Mask:255.0.0.0
inet6 addr: ::1/128 Scope:Host
UP LOOPBACK RUNNING MTU:65536 Metric:1
RX packets:56 errors:0 dropped:0 overruns:0 frame:0
TX packets:56 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:4368 (4.2 KiB) TX bytes:4368 (4.2 KiB)
ra0 Link encap:Ethernet HWaddr 00:0C:43:26:60:38
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:0 errors:0 dropped:0 overruns:0 frame:0
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)
Interrupt:6
rax0 Link encap:Ethernet HWaddr 02:0C:43:36:60:38
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:0 errors:0 dropped:0 overruns:0 frame:0
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)root@OpenWrt:/# brctl show br-wan
bridge name bridge id STP enabled interfaces br-wan 7fff.eea15781ca19 no eth1
root@OpenWrt:/# brctl show br-lan
bridge name bridge id STP enabled interfaces br-lan 7fff.eea15781ca19 no eth0, rax0, ra0, apclix0, apcli0¶ iperf3 测试
2.5G Ethernet:
R3miniA（WAN）--- |
||
2.5G 交换机 |
---以太网 |
|
R3miniB（WAN）--- |
||
R3miniA ←-------iperf3-----→ R3miniB |
||
R3miniA（WAN）--- |
||
2.5G 交换机 |
---以太网 |
|
R3miniC（WAN）---（LAN）R3miniB（WAN）--- |
||
R3miniC ←-------iperf3-----→ R3miniA |
||
5 GHz WiFi：
iPhone 5G WiFi ←------iperf3-----→（WiFi）BPI-R3mini
| iPhone 与 R3mini 之间的距离约为 1 米。 |
¶ WiFi 设置
-
可以在系统的 /etc/config/wireless 文件中修改 WiFi 配置。
config wifi-device 'radio0' option type 'mac80211' option path 'platform/18000000.wbsys' option channel '1' option band '2g' option htmode 'HE20' option cell_density '0' config wifi-iface 'default_radio0' option device 'radio0' option network 'lan' option mode 'ap' option encryption 'none' option ssid 'OpenWrt-2.4G' config wifi-device 'radio1' option type 'mac80211' option path 'platform/18000000.wbsys+1' option channel '36' option band '5g' option htmode 'HE80' option cell_density '0' config wifi-iface 'default_radio1' option device 'radio1' option network 'lan' option mode 'ap' option encryption 'none' option ssid 'OpenWrt-5G' -
也可以通过 Web 管理界面设置。两个官方镜像中的 WiFi 设置界面有所不同。
| 如果界面中有 MTK 选项，则使用 MTK 下的 WiFi 设置页面。 |
-
第一种方法是在 Network 设置中打开 Wireless 页面。页面会显示相应的 2.4 GHz 和 5 GHz WiFi，右侧的 Edit 按钮可用于配置。
设置模式
设置加密方式（设置密码）
-
第二种方法是在 MTK 设置页面中配置 WiFi。
右侧有一个配置按钮。
¶ 进阶开发
¶ GPIO 控制
echo xxx > /sys/class/gpio/export
echo in/out > /sys/class/gpio/gpioxxx/direction
echo 0/1 > /sys/class/gpio/gpioxxx/value查看 GPIO 基准编号，本例中为 411
例如，如果要将 GPIO 22 配置为高电平输出，需要输入以下命令：
echo 433（22+411） > /sys/class/gpio/export
echo out > /sys/class/gpio/gpio433/direction
echo 1 > /sys/class/gpio/gpio433/value
¶ PWM 风扇控制
echo 0 > /sys/class/pwm/pwmchip0/export
echo 10000 > /sys/class/pwm/pwmchip0/pwm0/period
echo 5000 > /sys/class/pwm/pwmchip0/pwm0/duty_cycle
echo normal > /sys/class/pwm/pwmchip0/pwm0/polarity
echo 1 > /sys/class/pwm/pwmchip0/pwm0/enable¶ M.2 KEY B 插槽
目前 M.2 Key B 插槽仅支持 USB 4G/5G 模块，例如 Quectel RM500U-CN 或 RM520N-GL。
安装 4G/5G 模块后，可按下述方式检查设备。
¶ 4G/5G 模块
BPI-R3mini 支持使用 M.2 Key B USB 接口 的蜂窝网络模块，包括 4G LTE EM05，以及 5G Quectel RM500U-CN/RG200U-CN 和 RM520N-GL/RM500Q-GL 系列。
2023-09-12 及以后发布的镜像默认支持 RM500U-CN 和 RM520N-GL，安装其中任一模块即可直接使用。
如果使用 EM05 或其他模块，通常需要修改驱动程序。
-
将 4G/5G 蜂窝模块安装到 CN4 插槽（M.2 Key B）
-
插入 NANOSIM 卡
-
在模块上安装天线
-
开机后会自动拨号
| 4G/5G 是否可用取决于当地运营商使用的频段。 |
RM520N-GL
wwan0 Link encap:Ethernet HWaddr C2:CA:76:42:83:EC
NOARP MTU:1500 Metric:1
RX packets:0 errors:0 dropped:0 overruns:0 frame:0
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)
wwan0_1 Link encap:Ethernet HWaddr C2:CA:76:42:83:EC
NOARP MTU:1500 Metric:1
RX packets:0 errors:0 dropped:0 overruns:0 frame:0
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)
root@OpenWrt:/#
root@OpenWrt:/# lsusb
Bus 001 Device 001: ID 1d6b:0002 Linux 5.4.188 xhci-hcd xHCI Host Controller
Bus 002 Device 002: ID 2c7c:0801 Quectel RM520N-GL
Bus 002 Device 001: ID 1d6b:0003 Linux 5.4.188 xhci-hcd xHCI Host Controller
root@OpenWrt:/#
root@OpenWrt:/# ping ping baidu .com
PING baidu.com (110.242.68.66) 56 data bvtes
64 bytes from 110.242.68.66: seq=0 ttl=50 time=38.540 ms
64 bytes from 110.242.68.66: seq=1 ttl=50 time=38.276 ms
64 bytes from 110.242.68.66: seq=2 ttl=50 time=38.355 ms
64 bytes from 110.242.68.66: seq=3 ttl=50 time=38.788 ms
^C
--- baidu.com ping statistics ---
4 packets transmitted, 4 received，0% packet loss
round-trip min/avg/max = 38.276/38.490/38.788 ms
root@OpenWrt:/#RM500U-CN
usb0 Link encap:Ethernet HWaddr 46:F7:1B:36:AE:26
inet addr:10.101.26.65 Bcast:10.101.26.255 Mask:255.255.255.0
inet6 addr: 2409:895a:30a9:55e2:44f7:1bff:fe36:ae26/64 Scope:Global
inet6 addr: fe80::5c3b:9cff:fe76:7c46/64 Scope:Link
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:191 errors:0 dropped:2 overruns:0 frame:0
TX packets:243 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:71800 (70.1 KiB) TX bytes:35923 (35.0 KiB)
root@R3mini-Router:/#
root@R3mini-Router:/# lsusb
Bus 001 Device 001: ID 1d6b:0002 Linux 5.4.171 xhci-hcd xHCI Host Controller
Bus 002 Device 002: ID 2c7c:0900 RM500U-CN
Bus 002 Device 001: ID 1d6b:0003 Linux 5.4.171 xhci-hcd xHCI Host Controller
root@R3mini-Router:/#¶ BPI-R3mini 的 WiFi AP 模式
-
ra0 是 MT7986A 的 2.4 GHz WiFi 接口
-
rax0 是 MT7986A 的 5 GHz WiFi 接口
¶ 串口线
由于调试接口的 UART0_TXD 同时也是 WiFi 启动配置引脚，上电时需要将该引脚拉低。
部分串口线（如 PL2303）带有较强的上拉。如果在上电前插入，可能导致 WiFi 芯片识别错误，使 WiFi 功能失效。
CP2102、CH340、FTDI 等其他型号均可使用；串口线必须符合 3.3 V TTL 电平标准。
可在此处购买串口线：https://www.aliexpress.us/item/3256805457599756.html
如果电脑配有 USB Type-C 接口并支持 PD 12 V/1.5 A（20 W）或更高功率，也可以直接用电脑为 BPI-R3mini 供电。
此外，BPI-R3mini 内置 CH340E USB 转串口芯片，无需额外的串口线。
| 如果电脑不支持 USB PD，R3mini 很可能会反复重启。 |
这是因为 R3mini 功耗较高；连接所有外设时，运行功耗接近 20 W。
¶ 源码镜像烧录
生成的 NAND 镜像名称：openwrt-mediatek-mt7986-BPI-R3MINI-NAND-squashfs-sysupgrade.bin
NAND 镜像生成路径：BPI-R3MINI-OPENWRT-V21.02.3/bin/targets/mediatek/mt7986
生成的 eMMC 镜像名称：mtk-bpi-r3mini-EMMC.img
eMMC 镜像生成路径：BPI-R3MINI-OPENWRT-V21.02.3/build_dir/target-aarch64_cortex-a53_musl/linux-mediatek_mt7986
NAND 烧录：
可以在 U-Boot 菜单中选择“upgrading single image”，通过 Xmodem 烧录程序。
¶ 常见问题
MT7986A 开发板（BPI）参考手册
Google Drive：https://drive.google.com/file/d/1biSJmxnIpNzQroYDg9mtPtSTAv4i0DFf/view?usp=sharing
¶ TTL 电压
调试串口使用 3.3 V TTL 电平。