Mini-LinuxCPE
Mini-LinuxCPE 4G 路由器的 ImmortalWrt 定制固件与构建 SDK,适配 MT7628/MT7688 和 EC200。 | Custom ImmortalWrt firmware and build SDK for the Mini-LinuxCPE 4G router, supporting MT7628/MT7688 and EC200.
项目文档
Mini-LinuxCPE路由器 SDK
这是 Mini-LinuxCPE 的 ImmortalWrt 25.12-SNAPSHOT 定制构建项目。构建固定到经过本地验证的源码提交,并使用 Linux 6.12.103。
系统适配
路由器已适配OpenWRT ImmortalWrt 25.12-SNAPSHOT 支持Linux内核6.12.103
- 默认主机名:
YANG-RouterOS - 设备型号:
MiniLinux-CPE - 固件显示名称:
YANG-RouterOS
| OpenWRT 25.12 Linux Kernel 6.12 | Breed U-boot |
|---|---|
![]() | ![]() |
刷入 Breed-UBoot
[!CAUTION] Bootloader 刷写有变砖风险。请先备份完整 Flash、Factory/ART 与 EEPROM, 核对设备确为 MT7628AN/MT7688AN、串口电平为 3.3 V,并保证刷写期间供电稳定。
- 查看串口刷入 Breed 完整教程
- Breed-U-Boot 文件说明与镜像校验值
- 镜像:
Breed-U-Boot/breed-mt7688-reset38.bin
Breed 镜像仅用于写入 Bootloader 分区,绝不能作为 OpenWrt sysupgrade 镜像上传。
GitHub Actions 构建
- 打开仓库的 Actions 页面。
- 选择 Build ImmortalWrt for MiniLinux-CPE。
- 点击 Run workflow。
- 构建成功后下载
YANG-RouterOS-1.0.0-MT7628-4G-CPE-kernel-6.12.103artifact。 - 使用 artifact 内名称以
yang_minilinux-cpe-squashfs-sysupgrade.bin结尾的镜像。
MiniLinux-CPE 现使用独立构建目标 yang_minilinux-cpe 和板级标识 yang,minilinux-cpe。上游 HLK-7628N 定义保持原始版本。旧定制固件首次迁移时, 请参阅 独立设备说明,确认升级方式。
本地 WSL 验证
Ubuntu WSL 中执行:
bash MiniLinux-CPE/build-wsl.sh
构建生成的固件已内置 yang-cpe-console 和 luci-app-yang-cpe-console 1.1.0。刷入后进入 LuCI 的 服务 → MiniLinux CPE,即可使用码表、资源与流量曲线、风扇 PWM 控制以及 EC200 状态和配置功能,无需另外安装 APK。
风扇控制
刷机并启动成功后:
fanctl status
fanctl 0
fanctl 128
fanctl 255
串口实机验证
在 Linux 6.12.103 固件上通过 COM26(57600、8N1)确认:
- GPIO41/42/43 已分别进入
p2led_an、p1led_an、p0led_an硬件复用。 - 交换机 LED 模式
5为 Link/Activity,模式12可用于强制常亮诊断。 - GPIO44 的旧默认设备名
wlan0在当前 mac80211 中不存在,本项目已改为实测设备名phy0-ap0。 - 交换机逻辑 Port 0 实测可协商至 100baseT 全双工,并有正常收发计数。
- SDXC 使用 GPIO22–29(未使用的 EPHY Port 3/4 管脚)。新增待实机验证的补丁通过
sdmode = sdxc、esd = iot和按端口数字模式掩码0x18配置 TF,保留 Port 0/1/2 网口;仅配置sdmode不足以切换模拟管脚。详见MiniLinux-CPE/README.md。
成品展示
| 正面 | 内部 |
|---|---|
![]() | ![]() |
功能
- ✅支持OpenWRT 25.12系统
- ✅支持Linux Kernel 6.12内核
- ✅支持3X100M有线接口
- ✅支持2.4GH 40MHz带宽
- ✅支持802.11n 模式下可达到最高的 300Mbps
- ✅支持TF卡/USB扩展存储
- 🚧OLED屏幕数据显示(计划适配SSD1362 160*64屏幕)
如遇问题,请向我提出issues
项目参数
- 本项目采用 联发科MT7628芯片,以实现无线路由功能;
- 本项目采用 移远通信EC200 4G模组,以实现4G信号接收功能;
- 本项目采用 沁恒CH334p 芯片,以实现USB设备连接
开源协议
本项目遵循CC BY-NC-SA 4.0开源协议,使用本程序时请注明出处并进行版权声明
本项目仅供学习研究,严禁非授权的商业获利,
如果您有更好的建议,欢迎PR
实物图
| PCB正面 | PCB背面 |
|---|---|
![]() | ![]() |
| 外壳 | 完整成品 |
![]() | ![]() |








