immortalwrt-mt798x项目介绍

immortalwrt-mt798x基于immortalwrt项目，特点如下

• 基于immortalwrt 21.02分支，内核版本5.4，目前仅支持mt7981/mt7986

• 使用mtk-openwrt-feeds提供的有线驱动、hnat驱动、内核补丁及配置工具，支持所有加速特性

• mt7981/mt7986均支持两个ppe，每个ppe最大支持32k Entry（16k连接数），默认开启1个ppe

• 使用mtwifi原厂无线驱动（目前默认使用7.6.6.1版本），默认开启802.11k，支持warp在内的所有加速特性

• 新开发的mtwifi-cfg无线配置工具支持openwrt的原生luci界面以及netifd-wireless标准接口。除此以外，还支持mtk原厂提供的luci-app-mtk和wifi-profile

支持机型

路由器型号CPURAMFLASH有线规格无线规格USB360 T7/T7U/T7MMT7981256M128M SPI-NAND4*1GAX3000×ZR3020MT7981256M128M SPI-NAND4*1GAX3000×Cetron CT3003MT7981256M128M SPI-NAND4*1GAX3000×JCG Q30 PROMT7981256M128M SPI-NAND4*1GAX3000×GL.iNet GL-MT3000MT7981512M256M SPI-NAND1G+2.5GAX3000√GL.iNet GL-MT2500MT79811G8G EMMC1G+2.5G×√康佳 KOMI-A31MT7981256M128M SPI-NAND4*1GAX3000×小米 WR30U/T/MMT7981256M128M SPI-NAND4*1GAX3000×乐橙 LC-HX3001MT7981256M128M SPI-NAND4*1GAX3000×H3C NX30 ProMT7981256M128M SPI-NAND4*1GAX3000×CMCC RAX3000MMT7981512M128M SPI-NAND4*1GAX3000√CMCC RAX3000M 算力版MT7981512M64G EMMC4*1GAX3000√CMCC A10MT7981256M128M SPI-NAND4*1GAX3000×安博通 ABT ASR3000MT7981256M128M SPI-NAND4*1GAX3000×创联腾 CLT-R30B1MT7981256M128M SPI-NAND4*1GAX3000×小米 AX3000TMT7981256M128M SPI-NAND4*1GAX3000×TP-LINK XDR6086MT7986512M128M SPI-NAND1G+2*2.5GAX6000√TP-LINK XDR6088MT7986512M128M SPI-NAND4*1G+2*2.5GAX6000√Banana Pi BPI-R3 MiniMT79862G128M SPI-NAND + 8G EMMC2*2.5GAX4200√磊科 N60MT7986256M128M SPI-NAND4*1G+2.5GAX6000×GL.iNet GL-MT6000MT79861G8G EMMC4*1G+2*2.5GAX6000√红米 AX6000MT7986512M128M SPI-NAND4*1GAX6000×

固件源码

https://github.com/hanwckf/immortalwrt-mt798x

编译说明

1. 拉取固件源码，参考immortalwrt的README搭建openwrt编译环境，并更新feeds

2. 使用defconfig目录内预置的配置文件作为配置模板，

1 2 3 4 5 6 7 8 9 10 11 12 13 14

# 默认使用luci-app-mtk作为无线配置工具 # 如果要体验mtwifi-cfg，请选择后缀为mtwifi-cfg的配置文件作为模板进行编译 # 对于mt7981，使用mt7981-ax3000.config cp -f defconfig/mt7981-ax3000.config .config # 对于mt7986，使用mt7986-ax6000.config #cp -f defconfig/mt7986-ax6000.config .config # 对于256M内存的mt7986（如磊科N60），使用mt7986-ax6000-256m.config #cp -f defconfig/mt7986-ax6000-256m.config .config # 对于AX4200方案的mt7986，使用mt7986-ax4200.config #cp -f defconfig/mt7986-ax4200.config .config

Copy

3. 运行make menuconfig定制固件

4. 运行make V=s开始编译固件，为了加快编译速度，可以使用make V=s -j$(nproc)

注意事项

• 不要在开启hwnat时使用主线的flow-offload，即不要启用turbo-acc的flow-offload加速方式

• 使用apcli无线中继时，推荐选择WPA3PSK认证方式以获得最好的兼容性。上级AP可使用WPA2/WPA3PSK混合模式

• 由于mt798x无线驱动中继扫描所需时间较长，对应频段关联的无线设备可能会在扫描期间断开。因此在触发中继扫描时，要使用有线或者非扫描频段连接路由器操作

• 因未经测试，不推荐同时开启shortcut-fe

• 当前无线驱动的IGMP Snooping功能可能存在问题，新版源码已默认关闭此功能，较旧版本的固件可以手动在无线设置中禁用IGMP Snooping以避免出现问题

后期计划

• 加入mtk-wappd等高级扩展，更好支持802.11k/v/iapp等漫游功能

mtwifi无线配置工具说明

immortalwrt-mt798x早期采用的是mtk-sdk提供的luci-app-mtk和wifi-profile作为无线配置工具，并且在mtk-sdk基础上进行了大幅度的精简、修复、适配和汉化以尽可能满足日常使用需求。2023年12月，我开发了新的mtwifi-cfg配置工具，并配套做好了iwinfo和netifd相关支持，至此immortalwrt-mt798x可以选择两种完全不同的无线配置工具，各自特点如下：

• mtwifi-cfg：为mtwifi设计的无线配置工具，兼容openwrt原生luci和netifd，可调整无线驱动的参数较少，配置界面美观友好，由于是新开发的工具，可能存在一些问题

• luci-app-mtk：源自mtk-sdk提供的配置工具，需要配合wifi-profile脚本使用，可调整无线驱动的几乎所有参数，配置界面较为简陋

mtwifi-cfg与luci-app-mtk不能在固件里共存，编译时必须选择其中之一，由于mtwifi-cfg还处于测试阶段，用户需手动选择defconfig目录下带mtwifi-cfg后缀的配置文件进行编译，后续将默认使用mtwifi-cfg作为无线配置工具

mtwifi-cfg无线配置说明

mtwifi-cfg是我为mt798x无线平台新开发的配置工具，支持openwrt的luci和netifd-wireless无线控制界面，具有以下特点：

1. 使用openwrt原版luci无线配置界面，配置方法非常接近原版openwrt

2. 支持apcli中继功能

3. 支持已连接站点信息显示（含apcli连接信息）

4. 支持读取无线芯片实际发射功率

5. 支持mtk原厂无线驱动可配置的大部分选项（含弱信号剔除等）

mtwifi-cfg已知问题

• 不要一次同时新增2.4G和5G频段的vif虚拟接口（即新增SSID），否则可能导致脚本死锁。如果要新增2.4G和5G频段的虚拟接口，请分两次单独操作

mtwifi-cfg配套源码

mtwifi-cfg及配套的补丁完全开源，具体参考immortalwrt-mt798x源码内下列目录

• package/mtk/applications/mtwifi-cfg

• package/mtk/applications/luci-app-mtwifi-cfg

• package/mtk/drivers/mt_wifi/patches

• package/network/utils/iwinfo

• package/network/config/netifd/patches

Image link

luci-app-mtk无线配置说明

luci-app-mtk来源于mtk-sdk，采用wifi-profile作为无线控制脚本，不支持openwrt的原版luci界面和netifd-wireless

• luci-app-mtk配置界面已基本汉化，可显示驱动版本、芯片温度、已连接客户端信息等，下面以MT7981为例

  • 第一级MT7981右侧的配置按钮为chip_cfg，配置无线驱动基础参数，一般无需修改

  • 第二级MT7981.1.1右侧的配置按钮为dev_cfg，可配置信道、国家代码等频段相关参数

  • 第三级接口右侧的配置按钮为vif_cfg，可配置SSID、加密方式、无线中继扫描等

Image link

• 以MT7981.1.1为例，该设备代表MT7981的2.4G频段，其配置页面可以配置自动信道、国家代码、频宽、空间流、发射功率、波束成形等物理参数

Image link

• MBSSID以ra0为例，该vif虚拟接口代表MT7981 2.4G的第一个MBSSID，在配置页面可以配置加密方式、密码、AP隔离、隐藏SSID等参数

Image link

• 无线中继以apcli0为例，该vif虚拟接口代表MT7981的2.4G无线ApCli，可在其配置页面点击扫描无线网络触发中继扫描功能

  Image link

  中继扫描结束后，选择想要连接的上级AP并输入密码即可，WAN会自动更新为apcli0。 在禁用ApCli时，只需设置ApClient模式为禁用，WAN会恢复到默认的eth1

  Image link