中兴巡天AX3000 (E2631) 主线 Linux 内核移植全记录

2.1 硬件规格#

2.2 CPU 能力（最重要的事实）#

由 cat /proc/cpuinfo 实测，CPU features 为：

1
half thumb fastmult edsp thumbee tls

对照 ARMv7 完整特性集，结论如下：

2.3 串口 IP 逆向#

E2631 的调试串口是 ZTE 定制的 PL011 兼容 IP，基地址 0x94404000，earlycon=zteuart 可输出引导日志，periphid 为 0x001feffe。它与标准 PL011 的寄存器偏移不同（与 ZX279133 是同一 IP）：

2.4 与 SR1010 的外设差异#

本项目基于 cnjn 的 SR1010 主线移植（linux-mainline-zte-zxslc-sr1010），但 E2631 的外围方案与 SR1010 不同，SoC 周边芯片不能直接照搬：

所以设备树、网卡/PHY 驱动、闪存驱动都需要针对 E2631 单独适配，这也是”待办与未来工作”一章里列出的主要缺口。

3.1 加密与密钥#

原厂固件的 kernel 分区使用 AES-128-ECB 加密，密钥常量为 E263111559d0dfde。解密后即得到标准 uImage（ih_load 为 0x40008000，这也是后面 XIP 陷阱的根源）。

3.2 分区布局#

128MB SPI NAND 上的功能分区（具体偏移以固件 dump 为准）：

3.3 kmodule 解包与 vendor 运行库#

把 kmodule 分区按 JFFS2 解包后，拿到两样关键资产：

• busybox v1.17.2（原厂用户态，后续 initramfs 直接复用）；
• uClibc 0.9.33.2 运行库（libc.so.0 / libm.so.0 / libresolv.so.0 等）。

4.1 进入 U-Boot#

上电后立即连续按 1 进入引导菜单，输入密码 5cE080@fyBD，回车后停在 U-Boot 命令行（自动启动已被停止）。原厂 U-Boot 支持 tftp / bootm / md / mw 等常用命令，可以直接用来引导主线内核。

1
# 电脑端准备一个 TFTP 服务器（仓库里的 e2631-tools/tftpd2.py 即可）
2

3
# 串口里配置网络并下载内核
4
setenv serverip 192.168.1.100
5

6
setenv ipaddr 192.168.1.1
7

8
tftp 0x43000000 uImage-e2631.img
9

10
bootm 0x43000000

4.2 XIP 陷阱（本项目最大的坑）#

4.3 完整引导链路#

5.1 环境组成#

项目在纯 Windows 上完成了整个内核构建，环境如下：

5.2 Windows 构建的强制限制#

构建命令（对应 build.sh / build.bat 的核心）：

1
make ARCH=arm CROSS_COMPILE=arm-none-eabi- zx279128s_e2631_defconfig
2

3
make ARCH=arm CROSS_COMPILE=arm-none-eabi- -j4

5.3 踩过的编译坑（均已修复并固化在仓库）#

6.1 关键特性（全部 =y 并已上板验证）#

6.2 netfilter 配置丢失的修复#

内核默认配置做”平台精简”时会把 netfilter 相关选项丢掉，需要在 olddefconfig 之后显式重新打开：

1
make ARCH=arm CROSS_COMPILE=arm-none-eabi- olddefconfig
2

3
scripts/config -e NETFILTER -e XTABLES_LEGACY -e IP_NF_IPTABLES_LEGACY
4

5
make ARCH=arm CROSS_COMPILE=arm-none-eabi- olddefconfig

6.3 嵌入式 initramfs#

initramfs 内容（由 e2631-tools/initramfs-src/ 构建）：

• init：musl 静态编译，O_RDWR 打开 console、TIOCSCTTY 接管终端、spawn busybox sh；
• busybox v1.17.2（vendor 版，经 uClibc 库支撑）；
• uClibc 0.9.33.2 运行库（经 .symlink 修复后的真实 ELF）；
• 设备节点：console / null / tty / ttyAMA0(204<64>) / zero / random（pack2.py 递归 cpio 打包）。

7.1 启动结果#

主线内核 6.18.38 从 U-Boot 引导成功，earlycon=zteuart 输出完整启动日志，最终进入交互式 busybox shell。板上实测日志：

1
=== E2631 mainline bring-up init reached userspace ===
2
[init] kernel booted, zteuart console OK
3
[init] Features : half thumb fastmult edsp thumbee tls
4
[init] handing console to busybox shell
5
/ # iptables -t mangle -L PREROUTING    # 正常
6
/ # ip rule add fwmark 1 lookup 100     # 正常
7
/ # busybox cat /proc/net/ip_tables_targets
8
...
9
TPROXY
10
TPROXY
11
MASQUERADE
12
REDIRECT
13
...

7.2 特性验证命令#

1
# 验证 TPROXY / REDIRECT / MASQUERADE / MARK 等目标已编进内核
2
cat /proc/net/ip_tables_targets
3

4
# 确认 CPU 特性（无 VFP / NEON / idiv）
5
cat /proc/cpuinfo
6

7
# 确认内存识别
8
cat /proc/meminfo

/proc/net/ip_tables_targets 中能看到 TPROXY 等目标，说明透明代理内核路径完整可用；策略路由（ip rule fwmark）也已在板上实测通过。

8.1 二进制选择#

由于 CPU 无 VFP / NEON / idiv，mihomo 必须使用 armv5 软浮点 二进制：

1
mihomo-linux-armv5      # GOARM=5，软浮点

8.2 内核侧已就绪#

mihomo 需要的内核能力已全部 =y 编入（见第六章）：TUN、TPROXY（v4/v6）、xt_socket、nftables（nft_tproxy/socket/compat）、iptables-legacy、conntrack、NAT、策略路由、IPv6、zram。无需任何外部内核模块。

8.3 部署与预期#

部署方式：通过 tftp / 串口把 armv5 二进制与配置文件拷入，挂到 TUN 或 TPROXY 模式即可。注意这台机器没有 USB，所以文件传输只能走网络或串口。

9.1 仓库结构#

仓库 Zlion-Y/e2631-mainline-zx279128s 本身就是完整的内核源码树（Linux 6.18.38 + E2631 平台适配全部落树），不再需要单独拉基础树再套补丁。默认分支 main：

1
e2631-mainline-zx279128s/                       # 完整内核源码树（GitHub）
2
├── arch/arm/boot/dts/zte/zx279128s-e2631.dts       # E2631 板级设备树
3
├── arch/arm/configs/zx279128s_e2631_defconfig      # 精简 defconfig（initramfs 已内嵌）
4
├── initramfs-e2631.cpio.gz                         # 嵌入式 initramfs（busybox + uClibc + init）
5
├── e2631-tools/
6
│   ├── tftpd2.py          # 简易 TFTP 服务器（UDP 69，服务父目录）
7
│   ├── pack_uimage.py     # uImage 打包（load/entry 0x40008000）
8
│   ├── serial_ctl.py      # 串口驱动（驱动 U-Boot 用）
9
│   ├── bootflow2.py       # 脚本化 tftp + bootm 串口序列
10
│   ├── mkconfig.sh        # MSYS2 构建步骤
11
│   ├── cleanbuild3.sh     # MSYS2 清理重建
12
│   ├── mihomobuild.sh     # mihomo 相关构建
13
│   ├── initramfs-src/     # init.c + pack2.py
14
│   └── README.md
15
├── upstream-series/                             # cnjn 的 ZX279133 16 补丁集（6.18.38 基线，参考）
16
├── research.md                                 # 内核版本调研笔记
17
├── README.md / README_EN.md / README           # 中英文说明 + 内核自带 README
18
├── build.sh                                    # Linux / WSL 一键编译
19
├── build.bat                                   # Windows / MSYS2 一键编译
20
└── .github/workflows/build.yml                 # CI：main + v* tag + 手动触发

编译产物由 CI 直接发布到 GitHub Release：v0.1.1 已包含 uImage-e2631.img（约 13.3MB，zImage + DTB 拼接，DTB 在末尾），可直接下载后 tftp 引导。

9.2 复现步骤#

Linux / WSL（树内直接构建，无需套补丁）：

1
git clone https://github.com/Zlion-Y/e2631-mainline-zx279128s.git
2

3
cd e2631-mainline-zx279128s
4

5
./build.sh

Windows（MSYS2，首次运行自动装 MSYS2 与交叉工具链，再树内构建）：

1
git clone https://github.com/Zlion-Y/e2631-mainline-zx279128s.git
2

3
cd e2631-mainline-zx279128s
4

5
build.bat

GitHub Actions：fork 后 push（或手动 workflow_dispatch）即可，产物在 Actions 页面 / Release 下载。

编译产物 uImage-e2631.img 按第四章的姿势引导：

1
tftp 0x43000000 uImage-e2631.img
2

3
bootm 0x43000000

9.3 CI 与 Release#

build.yml 触发条件：main 分支 push、v* tag push、手动 workflow_dispatch；并显式声明 permissions: contents: write 以便创建/更新 Release。流程为：装依赖 → 装 Arm GNU Toolchain 10.3（arm-none-linux-gnueabihf-）→ zx279128s_e2631_defconfig → zImage → 单目标 zte/zx279128s-e2631.dtb → e2631-tools/pack_uimage.py 打包 → 上传 artifact → 在 tag 上挂到 Release。

当前状态：v0.1.1 已发布（2026-08-31），Release 附件 uImage-e2631.img 为 Actions 验证产物（zImage + DTB），可直接下载引导。

9.4 参考项目#