Asuswrt-merlin 빌드 방법

상태: 현재 추천하는 빌드 시스템은 Ubuntu 20.04 LTS이며, 이 문서는 그에 맞게 조정되었습니다. 다른 리눅스 버전에서의 빌드에 대한 문서는 보존되어 있지만, 아마도 구시대의 것이며 그렇게 표시될 것입니다.

빌드용 가상 머신 설정하기

윈도우 10 (2004 버전 이상)

윈도우 10 버전 2004 이상에서 빌드용 가상 머신을 설정하는 가장 쉬운 방법은 Windows Subsystem for Linux (WSL2)을 사용하는 것입니다. 빌드 VM용 WSL을 구성하는 방법에 대한 지침은 WSL2 아래에서 빌드 VM 설정하기를 참조하세요.

리눅스, MacOS, 오래된 윈도우

리눅스 시스템, MacOS, 오래된 윈도우 버전에서는 Canonical의 Multipass를 사용하여 빌드용 가상 머신을 설정하는 것이 가장 쉽습니다. Multipass 아래에서 빌드 VM 설정하기를 참조하세요.

빌드 VM으로서의 Docker 컨테이너

더 추상화된 빌드를 선호하고 빌드 VM 설정을 다른 사람에게 맡기고 싶은 사람들을 위해, GNUTon은 모든 도구가 이미 설정된 Docker 컨테이너를 만들고 유지 관리하고 있습니다. 이를 사용하는 경우, 리눅스 환경 설정의 모든 단계를 건너뛰고 바로 컴파일로 넘어갈 수 있습니다. 자세한 내용은 Docker에서 빌드 VM 설정하기에서 GNUTon의 작업 링크를 참조하세요.

맥 사용자를 위한 주의 사항: 커널 소스는 빌드를 위해 대소문자 구분 파일 시스템이 필요합니다! Docker 컨테이너를 빌드에 사용하는 경우, 시스템 파일 시스템의 대소문자 구분(대부분 대소문자 구분이 안 됨)을 상속합니다. 가장 쉬운 해결책은 디스크 이미지 파일을 생성하는 것입니다(디스크 유틸리티 사용, 새 이미지 -> 빈 이미지, 포맷 옵션을 대소문자 구분 형식으로 설정하고 이미지에 약 10GB 정도를 할당). 이미지를 생성하고 마운트하세요(/Volumes 아래에 마운트될 것임), 그런 다음 git 저장소를 그 마운트된 볼륨에 복제하고, 컨테이너 내 /build에 대소문자 구분 레포지토리를 바인드 마운트하기 위해 해당 위치에서 도커 빌드 컨테이너를 실행합니다.

다른 리눅스 버전에서의 네이티브 빌드

Multipass를 사용하여 빌드 VM을 생성하는 것이 리눅스 시스템에서 직접 빌드하는 것보다 훨씬 권장됩니다. 하지만, 리눅스 시스템에서 네이티브로 빌드하는 데 관심이 있는 사람들은 아래 단계를 따르는 것이 좋습니다(리눅스의 특정 버전에 맞게 조정). 이 Wiki

의 다른 곳에서 찾을 수 있는 구시대의 문서보다는 이 방법을 따르세요.

리눅스 환경 설정하기

나머지는 실제 리눅스 VM에서 할 것과 동일합니다: 도구 체인의 복사본을 얻고, 설정한 다음, 소스 코드의 복사본을 얻고, 빌드를 시작합니다.

모든 작업을 인스턴스 내부에서 수행해야 합니다.

먼저, 도구 체인에 필요한 32비트 라이브러리를 지원하도록 설정해야 합니다. 다음을 실행하십시오:

sudo dpkg --add-architecture i386

i386 아키텍처가 단계적으로 폐지되면서, 적어도 ARM 시스템에서는 몇 가지 추가 단계가 필요합니다.

이 페이지에서: https://askubuntu.com/questions/1211022/how-to-install-i386-amd64-packages-on-arm-or-any-other-arch-from-ubuntu-ports

# 'deb'를 'deb [arch=arm64]'로 대체
sudo sed 's/^deb http/deb [arch=arm64] http/' -i '/etc/apt/sources.list'

x86 미러 서버가 있는 /etc/apt/sources.list.d/i386.list와 같은 파일을 추가합니다:

sudo tee -a /etc/apt/sources.list.d/i386.list > /dev/null <<EOT
deb [arch=i386] http://security.ubuntu.com/ubuntu/ focal-security  main restricted universe multiverse
deb [arch=i386]  http://archive.ubuntu.com/ubuntu/ focal           main restricted universe multiverse
deb [arch=i386]  http://archive.ubuntu.com/ubuntu/ focal-updates   main restricted universe multiverse
deb [arch=i386]  http://archive.ubuntu.com/ubuntu/ focal-backports main restricted universe multiverse
EOT

또한, 기본 셸(/bin/sh)을 dash에서 bash로 변경해야 합니다. 이는 Broadcom의 HND 기반 모델에 사용되는 새로운 빌드 시스템에 의해 필요합니다. 다음 명령을 실행하고, 물어보면 Dash를 사용하지 않도록 선택합니다:

sudo dpkg-reconfigure dash

이제 필요한 모든 패키지를 설치할 수 있습니다. 펌웨어 코드에 새로운 구성 요소가 추가됨에 따라 이 목록은 시간이 지남에 따라 변경될 수 있습니다.

sudo apt update
sudo apt-get install libtool-bin cmake libproxy-dev uuid-dev liblzo2-dev autoconf autoconf-archive automake bash bison \
bzip2 diffutils file flex m4 g++ gawk groff-base libncurses5-dev libtool libslang2 make patch perl pkg-config shtool \
subversion tar texinfo zlib1g zlib1g-dev git gettext libexpat1-dev libssl-dev cvs gperf unzip \
python libxml-parser-perl gcc-multilib gconf-editor libxml2-dev g++-multilib gitk libncurses5 mtd-utils \
libncurses5-dev libvorbis-dev git autopoint autogen automake-1.15 sed build-essential intltool libglib2.0-dev \
xutils-dev lib32z1-dev lib32stdc++6 xsltproc gtk-doc-tools libelf1:i386

이제 RMerlin의 열심히 작업한 내용을 다운로드할 시간입니다.

참고: GitHub에서 최신 소스 코드를 다운로드하는 방법에 대한 매우 자세한 안내는 이 Wiki 페이지에서 찾을 수 있습니다.

cd $HOME
git clone https://github.com/RMerl/am-toolchains
git clone https://github.com/RMerl/asuswrt-merlin.ng

클론한 저장소에서 직접 컴파일하지 않고 복사본에서 작업하는 것이 좋습니다. 이렇게 하면 깨끗한 복사본과 다시 동기화함으로써 쉽게 정리할 수 있습니다.

mkdir amng-build
rsync -a --del asuswrt-merlin.ng/ amng-build

이제 도구 체인을 설정해야 합니다.

브로드컴 HND ARM 플랫폼 (RT-AC86U, GT-AC2900):

sudo ln -s ~/am-toolchains/brcm-arm-hnd /opt/toolchains
echo "export LD_LIBRARY_PATH=\$LD_LIBRARY:/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

브로드컴 HND AX ARM 플랫폼 (RT-AX56U, RT-AX58U, RT-AX86U, RT-AX88U, GT-AX11000, RT-AX68U):

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

브로드컴 SDK6/SDK7 ARM 플랫폼 (RT-AC68U, RT-AC88U, RT-AC3100, RT-AC5300):

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  ~/amng-build/release/src-rt-6.x.4708/toolchains
echo "PATH=\$PATH:/opt/brcm-arm/bin" >> ~/.profile

amng-build 폴더 내에서 컴파일을 위한 설정이 완료되었습니다.

RT-AC68U 펌웨어

cd ~/amng-build/release/src-rt-6.x.4708
make rt-ac68u

RT-AC88U 펌웨어

cd ~/amng-build/release/src-rt-7.14.114.x/src
make rt-ac88u

RT-AC3100 펌웨어

cd ~/amng-build/release/src-rt-7.14.114.x/src
make rt-ac3100

RT-AC5300 펌웨어

cd ~/amng-build/release/src-rt-7.14.114.x/src
make rt-ac5300

RT-AC86U 펌웨어

cd ~/amng-build/release/src-rt-5.02hnd
make rt-ac86u

RT-AX56U 펌웨어

cd ~/amng-build/release/src-rt-5.02axhnd.675x
make rt-ax56u

RT-AX58U 펌웨어

cd ~/amng-build/release/src-

rt-5.02axhnd.675x
make rt-ax58u

RT-AX86U 펌웨어

cd ~/amng-build/release/src-rt-5.02L.07p2axhnd
make rt-ax86u

RT-AX88U 펌웨어

cd ~/amng-build/release/src-rt-5.02axhnd
make rt-ax88u

GT-AC2900 펌웨어

cd ~/amng-build/release/src-rt-5.02hnd
make gt-ac2900

GT-AX11000 펌웨어

cd ~/amng-build/release/src-rt-5.02axhnd
make gt-ax11000

RT-AX68U 펌웨어

cd ~/amng-build/release/src-rt-5.02L.07p2axhnd
make rt-ax68u

참고자료

1. Asuswrt-merlin 빌드 스크립트
2. Asuswrt-merlin 도구 체인

유용한 링크

1. Asuswrt-merlin - 사용자 정의 펌웨어 관리자