Skip to content
This repository has been archived by the owner on Dec 14, 2020. It is now read-only.

Commit

Permalink
Replaced Asus's README.TXT with a more up-to-date alternative
Browse files Browse the repository at this point in the history
  • Loading branch information
RMerl committed Jul 20, 2016
1 parent 2a6d195 commit db2eb76
Showing 1 changed file with 66 additions and 122 deletions.
188 changes: 66 additions & 122 deletions README.TXT
Original file line number Diff line number Diff line change
@@ -1,122 +1,66 @@

The GPL source is created for ASUS wireless router related products. Please visit the ASUS support site (http://support.asus.com) to get the latest GPL tarball.It has a lot in common with many wireless router open source projects, including Oleg/Tomato/DD-WRT/OpenWRT. Thanks the developers of those projects for making the source code available.

Set Up Environment(Tested in Fedora 8/9 and Ubuntu)

1. prepare environment

a. Ubuntu
Install these packages (I used synaptic: "sudo synaptic")

libncurses5
libncurses5-dev
m4
bison
gawk
flex
libstdc++6-4.4-dev
g++-4.4
g++
git (or git-core)
gitk
zlib1g-dev
autoconf
autopoint (or gettext)
libtool
shtool
autogen
mtd-utils
intltool
sharutils
docbook-xsl-*
libstdc++5
texinfo
dos2unix (or tofrodos)
xsltproc

b. Fedora
sudo yum groupinstall "Development Tools"
sudo yum install gettext-devel libxml2-devel mtd-utils-ubi ncurses-devel zlib-devel intltool sharutils docbook-dtds docbook-style-xsl

If you are using Fedora 19 or above, you need to install below packages.
sudo yum groupinstall "C Development Tools and Libraries"

If you are using Fedora x86_64, you may need to install 32-bit packages listed below.
glibc.i686
libstdc++.i686
zlib.i686

2. prepare source to, ex, $HOME/asuswrt

cd $HOME
tar xvfz [tar file]

3. setup development system

Broadcom SoC models
===================

To install the tools:
- copy the tools/brcm/ directory to /opt
- add /opt/brcm/hndtools-mipsel-linux/bin to your path
- add /opt/brcm/hndtools-mipsel-uclibc/bin to your path

Mediatek/Ralink SoC models
==========================

To install the tools:
- copy the tools/brcm/ directory to /opt
- add /opt/brcm/hndtools-mipsel-linux/bin to your path
- add /opt/brcm/hndtools-mipsel-uclibc/bin to your path
- extract tools/buildroot-gcc342.tar.bz2 to /opt
- add /opt/buildroot-gcc342/bin to your path

For MT7621 Uboot:
- extract mips-2012.03.tar.bz2 directory to /opt
- add /opt/mips-2012.03/bin to your uboot path

Qualcomm SoC models
===================

To install the tools:
- extract openwrt-gcc463.mips.tar.bz2 directory to /opt
- add /opt/openwrt-gcc463.mips/bin to your path
- If you want to build small utilities out of asuswrt box,
add STAGING_DIR environment variable as below:

export STAGING_DIR=/opt/openwrt-gcc463.mips


Note: Broadcom/Ralink(except 4708 series) platform use the same toolchain for user space program, so please set PATH to the same directory as above

4. build firmware.

a. rt-n16
cd release/src-rt
make rt-n16

b. rt-n56u
cd release/src-ra
make rt-n56u

c. rt-n65u
cd release/src-ra-3.0
make rt-n65u

d. rt-n14u (/ rt-ac52u / rt-ac51u / rt-n11p / rt-n54u)
cd release/src-ra-mt7620
make rt-n14u
( make rt-ac52u )
( make rt-ac51u )
( make rt-n11p )
( make rt-n54u )

e. rt-ac56u (/ rt-ac68u / rt-n18uhp)
cd release/src-rt-6.x.4708
make rt-ac56u
( make rt-ac68u )
( make rt-n18uhp )

f. rt-ac55u
cd release/src-qca
make rt-ac55u
Build instructions
==================

Please refer to the Wiki for detailed instructions on how to
build the firmware from source:

https://github.com/RMerl/asuswrt-merlin/wiki#development

A Linux-based environment is required. The firmware has been
successfully built under Mint-Linux and Ubuntu. As of
July 2016, the official Asuswrt-Merlin build environment
is based on Ubuntu 16.04 LTS.


Installation:
-------------

1) Make sure your build environment has all the necessary
software packages installed. Under Ubuntu 16.04 LTS:

sudo apt-get install git autoconf automake bash bison bzip2 diffutils file flex \
m4 g++ gawk groff-base libncurses-dev libtool libslang2 make patch perl \
pkg-config shtool subversion tar texinfo zlib1g zlib1g-dev git-core gettext \
libexpat1-dev libssl-dev cvs gperf unzip python libxml-parser-perl gcc-multilib \
gconf-editor libxml2-dev g++-4.7 g++-multilib gitk libncurses5 mtd-utils \
libncurses5-dev libstdc++6-4.7-dev libvorbis-dev g++-4.7-multilib git autopoint \
autogen sed build-essential intltool libelf1:i386 libglib2.0-dev

If your build environment is 64-bit, then also install the following packages:

sudo apt-get install lib32z1-dev lib32stdc++6


2) Setup build environment and toolchain. If the source code is located under
~/asuswrt-merlin/ :

sudo ln -s ~/asuswrt-merlin/tools/brcm /opt/brcm
sudo ln -s ~/asuswrt-merlin/release/src-rt-6.x.4708/toolchains/hndtools-arm-linux-2.6.36-uclibc-4.5.3 /opt/brcm-arm

echo "PATH=$PATH:/opt/brcm/hndtools-mipsel-linux/bin:/opt/brcm/hndtools-mipsel-uclibc/bin:/opt/brcm-arm/bin" >> ~/.profile


3) Either use the supplied tools/build-all script (read it
to see how to configure and use it), or manually launch
the build process from the appropriate SDK location.

MIPS (RT-N66U, RT-AC66U):
cd release/src-rt-6.x/
make rt-n66u

ARM SDK6 (RT-AC56U, RT-AC68U, RT-AC87U):
cd release/src-rt-6.x.4708/
make rt-ac56u

ARM SDK7 (RT-AC3200)
cd release/src-rt-7.x.main/src/
make rt-ac3200u

ARM SDK7.14 (RT-AC88U, RT-AC3100, RT-AC5300)
cd release/src-rt-7.14.114.x/src/
make rt-ac88u


The resulting FW image will be in the image/
sub-directory.

0 comments on commit db2eb76

Please sign in to comment.