Firmware-Build-Reference

---

📘 About This Project

Firmware-Build-Reference 是一个面向多硬件路由器的 OpenWrt 编译引用库（Reference Library），用于集中存放构建固件所需的：

• 上游源码引用（防止仓库被删除或变为私有）
• 固件构建工具（AmlImg、u-boot、打包工具等）
• 补丁、依赖、SDK、工具链
• 各硬件型号的编译资料、脚本、配置文件
• GitHub Actions 构建引用文件（如 amlogic、ramips、bcm53xx、x86 等）

本仓库的目标是：

✔ 让 OpenWrt 编译更稳定

避免上游仓库失效导致构建失败。

✔ 让多硬件构建更高效

所有资料集中管理，构建脚本可直接引用。

✔ 让资料长期可用

作为公共镜像库，确保工具与源码不会丢失。

---

🔧 Included Tools & References

本仓库将长期维护以下内容：

📌 固件构建工具

• AmlImg（OneCloud 烧录工具）
• u-boot（各硬件型号）
• 打包工具（img、ext4、sparse 等）
• 编译依赖（android-sdk-libsparse-utils 等）

📌 上游源码镜像

• amlogic / meson8b（OneCloud）
• bcm53xx（R7000）
• mt7621 / mt7620 / mt7628（JCG Q20 / K2 / 小米 4A）
• ipq40xx（中兴 E2633）
• x86-64（通用）

📌 补丁与 DTS 文件

• 各硬件专用 DTS
• 内核补丁
• OpenWrt target 补丁
• 自定义构建脚本

---

🚀 Usage

你可以在自己的 OpenWrt 构建脚本中引用本仓库，例如：

git clone https://github.com/upleung/firmware-build-reference.git reference

# 引用 OneCloud amlogic target
rm -rf openwrt/target/linux/amlogic
cp -r reference/onecloud/amlogic-meson8b openwrt/target/linux/amlogic

# 引用 AmlImg 工具
cp reference/common-tools/AmlImg/AmlImg ./AmlImg
chmod +x ./AmlImg

---

🤝 Contribution

欢迎提交：

• 新硬件资料
• 构建工具
• 补丁
• 上游镜像
• 编译脚本

---

⭐ Why This Repository Exists

为了避免：

• 上游仓库被删除
• 仓库变为私有
• 构建脚本拉取不到依赖
• 固件编译失败
• 多硬件资料分散难以维护

本仓库将作为 长期稳定的引用源，为多硬件 OpenWrt 构建提供可靠支持。

---

📁 Repository Structure

目录结构如下：

Firmware-Build-Reference/
│
├── onecloud/                         # 玩客云（Amlogic S805 / Meson8b）专用资料
│   ├── amlogic-meson8b/              # OneCloud 专用 target 源码、补丁
│   ├── uboot/                        # OneCloud 专用 u-boot
│   ├── tools/                        # OneCloud 专用工具（非通用）
│   └── patches/                      # OneCloud 专用补丁
│
├── netgear-r7000/                    # 网件 R7000（BCM53xx）专用资料
│   ├── bcm53xx/                      # R7000 target 源码、补丁
│   ├── patches/                      # R7000 专用补丁
│   └── toolchain/                    # R7000 编译工具链
│
├── jcg-q20/                          # JCG Q20（MT7621）专用资料
│   ├── mt7621/                       # MT7621 target 源码
│   ├── dts/                          # Q20 专用 DTS
│   └── patches/                      # Q20 专用补丁
│
├── xiaomi-4a/                        # 小米路由器 4A（MT7628）专用资料
│   ├── mt7628/                       # MT7628 target 源码
│   ├── uboot/                        # 4A 专用 u-boot
│   └── patches/                      # 4A 专用补丁
│
├── phicomm-k2/                       # 斐讯 K2（MT7620）专用资料
│   ├── mt7620/                       # MT7620 target 源码
│   └── patches/                      # K2 专用补丁
│
├── zte-e2633/                        # 中兴 E2633（IPQ40xx）专用资料
│   ├── ipq40xx/                      # IPQ40xx target 源码
│   └── patches/                      # E2633 专用补丁
│
├── x86-64/                           # X86-64 通用资料
│   ├── configs/                      # X86 构建配置
│   └── tools/                        # X86 构建工具
│
├── common-tools/                     # 所有设备共享的通用工具库（重点）
│   ├── AmlImg/                       # Amlogic 烧录工具（通用）
│   ├── uboot/                        # 通用 u-boot 工具
│   ├── sdk/                          # 通用 SDK
│   ├── build-deps/                   # 通用构建依赖
│   └── scripts/                      # 通用构建脚本
│
└── README.md                         # 仓库说明文档

---

📄 License

本仓库采用 MIT License，允许自由使用、修改与分发。