开源项目 `am-toolchains` 使用教程

1. 项目介绍

am-toolchains 是一个用于编译 Asuswrt-Merlin 固件的工具链集合。Asuswrt-Merlin 是一个基于华硕路由器官方固件的开源项目，旨在提供更多功能和更好的性能。am-toolchains 项目包含了多个版本的交叉编译工具链，适用于不同的硬件平台和固件版本。

2. 项目快速启动

2.1 克隆项目

首先，克隆 am-toolchains 项目到本地：

git clone https://github.com/RMerl/am-toolchains.git

2.2 设置环境变量

假设项目被克隆到 ~/am-toolchains/ 目录下，按照以下步骤设置环境变量：

2.2.1 BCM-HND 平台

sudo ln -s ~/am-toolchains/brcm-arm-hnd /opt/toolchains
echo "export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/opt/toolchains/crosstools-arm-gcc-5.3-linux-4.1-glibc-2.22-binutils-2.25/usr/lib" >> ~/.profile
echo "export TOOLCHAIN_BASE=/opt/toolchains" >> ~/.profile
echo "PATH=\$PATH:/opt/toolchains/crosstools-arm-gcc-5.3-linux-4.1-glibc-2.22-binutils-2.25/usr/bin" >> ~/.profile
echo "PATH=\$PATH:/opt/toolchains/crosstools-aarch64-gcc-5.3-linux-4.1-glibc-2.22-binutils-2.25/usr/bin" >> ~/.profile

2.2.2 BCM-SDK 平台

假设你已经将固件仓库克隆到 ~/asuswrt-merlin.ng/ 目录下：

sudo ln -s ~/am-toolchains/brcm-arm-sdk/hndtools-arm-linux-2.6.36-uclibc-4.5.3 /opt/brcm-arm
ln -s ~/am-toolchains/brcm-arm-sdk ~/asuswrt-merlin.ng/release/src-rt-6.x.4708/toolchains
echo "PATH=\$PATH:/opt/brcm-arm/bin" >> ~/.profile

2.3 验证设置

重新加载 .profile 文件以应用更改：

source ~/.profile

验证工具链是否正确安装：

arm-linux-gcc --version

3. 应用案例和最佳实践

3.1 编译 Asuswrt-Merlin 固件

使用 am-toolchains 工具链编译 Asuswrt-Merlin 固件的步骤如下：

1. 克隆 Asuswrt-Merlin 固件仓库：

   git clone https://github.com/RMerl/asuswrt-merlin.ng.git
   

2. 进入固件目录并开始编译：

   cd asuswrt-merlin.ng
   make
   

3.2 自定义固件功能

通过修改源代码和重新编译，可以自定义固件功能。例如，添加新的插件或修改现有功能。

4. 典型生态项目

4.1 Asuswrt-Merlin

Asuswrt-Merlin 是 am-toolchains 的主要应用场景，提供了丰富的功能和性能优化。

4.2 OpenWRT

虽然 am-toolchains 主要用于 Asuswrt-Merlin，但部分工具链也可以用于 OpenWRT 项目，特别是针对 Broadcom 平台的交叉编译。

4.3 LEDE

LEDE 项目是 OpenWRT 的一个分支，也可以使用 am-toolchains 进行交叉编译。

通过以上步骤，您可以快速上手并使用 am-toolchains 项目进行固件编译和开发。