zrouter

h1. Howto build

h2. Fetch sources

Check out the ZRouter source code with Mercurial hg or by fetching "the latest ZRouter sources":http://zrouter.org/hg/zrouter/archive/tip.tar.bz2 ("as zip":http://zrouter.org/hg/zrouter/archive/tip.zip)

For this tutorial we expect you check out / unpack the sources to @/projects/ZRouter/zrouter@.

For now you also need our patched FreeBSD sources. We work on getting this patches back to official FreeBSD-HEAD, so one day this step will be obsolete.

Get it via Mercurial or by fetching "ZRouter's patched FreeBSD sources":http://archive.zrouter.org/nightly/FreeBSD-zrouter-head-latest.tgz

For this tutorial we expect you check out / unpack the modified FreeBSD sources to @/projects/ZRouter/FreeBSD@.

h2. Build

For this tutorial we expect you want to build a firmware for a device from vendor D-Link, the model is DIR-320 (see [[Supported devices]]).

As root do:
<pre>
cd /projects/ZRouter/zrouter
make FREEBSD_SRC_TREE=/projects/ZRouter/FreeBSD/head TARGET_PAIR=D-Link/DIR-320
</pre>

h2. Customize the build

You can create the file _Makefile.local.opts_ in your ZRouter's home with predefined variables, so you can skip to specify them with every make run:

e.g. /projects/ZRouter/zrouter/Makefile.local.opts
<pre>
FREEBSD_SRC_TREE=/projects/ZRouter/FreeBSD/head

# override default /usr/obj
OBJ_DIR=/projects/ZRouter/obj

TARGET_PAIR=D-Link/DIR-320
</pre>

Now just run @make@.