LeoooChen / PonWRT-TYFZA1

PonWRT · TYFZA1 
 天翼 TYFZA1 的 OpenWrt 固件 
 PON 光口 · 双频 Wi-Fi 6 · 硬件加速
 下载固件 ·
 刷入指南 ·
 更新日志 ·
 问题反馈 
## 关于项目
PonWRT-TYFZA1 是面向天翼 TYFZA1 光猫的 OpenWrt 适配项目。设备采用 Realtek RTL9617C 四核 Cortex-A55，固件基于 Linux 6.18.55。
- **PON 适配**：10G-EPON、XG-PON 线路认证、业务配置和状态管理。
- **双频无线**：2.4 GHz / 5 GHz、WPA2、Wi-Fi 6 和 160 MHz。
- **硬件加速**：有线与 Wi-Fi 双向硬件转发，可在 LuCI 中启用流量卸载。
- **原生体验**：使用 LuCI 管理上网、无线和防火墙，通过 sysupgrade 升级。
- **原厂数据保留**：启动时自动读取本机身份、光学校准和无线校准，安装时保留另一槽原厂系统及配置卷。
## 下载固件
前往 **Releases** 下载适用于原生 U-Boot 的固件，版本变化见 更新日志。
| 文件 | 用途 |
| --- | --- |
| `sysupgrade.bin` | 原生 U-Boot 首次安装 / OpenWrt 升级 |
| `SHA256SUMS` | 核对下载文件的 SHA-256 |
## 刷入
### 1. 安装原生 U-Boot
按 TYFZA1 U-Boot 安装指南，将单文件安装包传入光猫，执行安装命令后重启。已安装该 U-Boot 的设备直接进入下一步。
### 2. 进入恢复网页
1. 电脑用网线连接任意 LAN 口，网卡设为自动获取地址。
2. 断开光猫电源，**按住 Reset 后接通电源**。
3. 保持按住，直到电脑获得地址并能打开恢复网页，然后松开。
4. 访问 **http://192.168.0.1**。
恢复服务提供 DHCP；手动设置电脑地址时，使用 `192.168.0.2/24`。
### 3. 安装固件
1. 在“刷机 → 刷写系统”中选择 `sysupgrade.bin`。
2. 点击“上传并刷写”，等待任务完成。
3. 点击“启动系统”。
4. 电脑重新获取地址后，打开 **http://192.168.1.1** 管理 OpenWrt。
恢复安装会初始化 OpenWrt 配置，并保留本机身份、校准数据和另一系统槽。系统卷按镜像实际大小分配，其余空间用于可写数据卷；当前全千兆版实机新装后剩余约 **34.6 MiB**。
### 后续升级
在 LuCI **系统 → 备份与更新** 中上传 `sysupgrade.bin`，或通过 SSH 执行：
 [code] 
默认保留配置；清空配置升级使用 `sysupgrade -n /tmp/sysupgrade.bin`。
## 开始使用
首次进入管理页面后，设置管理员密码。首次安装和清空配置升级时，线路协议从原厂配置初始化；保留配置升级沿用已有设置。
| 入口 | 配置内容 |
| --- | --- |
| **网络 → PON 管理** | 按线路选择 PON 模式，填写运营商要求的认证参数；MAC、SN 等身份项留空时使用本机原厂值 |
| **网络 → 接口 → WAN** | 设置 DHCP 或 PPPoE、上网 VLAN 和 IPv6；默认业务设备为 `pon0`，VLAN 子设备为 `pon0.VID` |
| **网络 → 无线** | 设置 SSID、密码、信道和带宽，启用无线 |
| **网络 → 防火墙** | 配置软件流量卸载和硬件流量卸载 |
使用 DFS 信道时，无线会先完成 CAC 检测，再开始广播 SSID。系统日志中的 `DFS-CAC-START`、`DFS-CAC-COMPLETED` 和 `AP-ENABLED` 分别对应检测开始、检测完成和 AP 启用。
有线接口使用 `lan1`、`lan2` 等命名，PON 业务接口为 `pon0`。
业务 MAC 在启动时从原厂 `ELAN_MAC_ADDR` 读取，自定义值在网络接口中设置。PON 管理中的 ONU MAC 用于 EPON 注册与 OAM。
保留配置升级会自动迁移原有网络、防火墙、LED 和 SQM 配置中的设备引用，包括 VLAN 子设备。
## 软件源
固件配置了 OpenWrt 官方 snapshot 软件源、公钥和 HTTPS CA 证书。可在 LuCI 软件包页面安装软件，或在终端执行：
 [code] 
常用插件所需的内核模块和运行库随固件预装，涵盖 VPN、SQM、代理、多 WAN 和流量统计。具体项目见预装依赖清单，软件包架构和安装验证见兼容说明。
## 自行编译
### GitHub Actions
1. **Fork** 本仓库，在 **Actions** 中启用工作流。
2. 打开 **Build TYFZA1 firmware → Run workflow**，填写 `release_tag`，例如 `v0.8.0-beta`。
3. 如需自定义软件包，将配置文件提交到仓库，并在 `config_file` 中填写路径。
4. 重建已发布版本时勾选 `replace_release`。
5. 构建完成后，从 **Releases** 或本次运行的 **Artifacts → firmware-and-build-log** 下载固件。
工作流自动下载编译依赖和运行时文件，并准备 FIT 签名材料。
 本地开发与构建 
使用 Linux 构建环境，安装 LLVM/Clang 18、Rust 1.96.1 及 `aarch64-unknown-linux-musl` 目标。按构建工作流中的步骤准备运行时文件和 FIT 签名目录，然后在仓库根目录执行：
 [code] 
自定义软件包可先运行 `sh port/scripts/sync-overlay.sh sources/openwrt` 和 `sh scripts/prepare_luci_feeds.sh sources/openwrt`，再进入 `sources/openwrt` 执行 `make menuconfig`。后续构建保留 `.config`，也可通过 `TYFZA1_CONFIG` 指定配置文件。
常用插件的预装依赖配置位于 `port/configs/tyfza1-compat.config`，同步脚本会将其合并入构建配置。
固件保留原厂 UBI 卷编号：内核上限 6 MiB，rootfs 上限约 32.09 MiB。rootfs 按镜像大小取整到 UBI 逻辑擦除块，可写数据卷使用剩余空间；升级时自动调整两者大小。构建脚本自动检查镜像大小。
## 参与项目
欢迎通过 Issues 反馈问题、通过 Pull Requests 提交改进，也欢迎在 恩山交流帖 分享线路测试结果。
提交问题时，请提供固件版本、PON 模式、复现步骤和脱敏后的日志。
## 致谢与许可
感谢 OpenWr