zrouter

h1. QuickStart

h2. Quickstart guide to creating a ZRouter build environment.

h3. This Requires you have [[hg]]/mercurial installed (pkg install mercurial).

This should probably be done within a Jail.

At First, this Requires you have [[hg]]/mercurial installed:
* From FreeBSD ports:
<pre>
# cd /usr/ports/devel/mercurial
# make install clean
</pre>
* *OR* From FreeBSD packages:
<pre>
# pkg_add -r mercurial
</pre>

# Create a path set aside for ZRouter build.
<pre># mkdir -p ZRouter/</pre>
# Enter directory:
<pre># cd ZRouter</pre>
# Checkout/clone ZRouter Project
<pre># hg clone http://zrouter.org/hg/zrouter/</pre>
# Checkout/clone Current compatible FreeBSD source:
<pre># hg clone http://zrouter.org/hg/FreeBSD/head FreeBSD</pre>
# Begin ZRouter Build Menu Create Makefile.local.opts and set the following environment variables:
<pre># ./menu.sh</pre>

h2. Entering ./menu.sh

!mainmenu.jpg!

# Select your target device (example D-Link DIR-632): ee Makefile.local.opts
!Target.jpg! FREEBSD_SRC_TREE=${PATH_TO_FREEBSD_SRC}/head
# Select Base Profile. That's two choise:
- Small - size firmware > 4 MB (if your ROM more than 4 MB)
- Extra small - size firmware <= 4MB (if your ROM less than 4 MB) OBJ_DIR=${PATH_FOR_OBJ_BUILD_DIR}
!kernel.jpg! </pre>
# At "Profiles" select package that included firmware: Begin ZRouter Build Menu
!package.jpg! <pre># ./menu.sh</pre>
# Last that must to do - select paths of source Or alternatively run make from the command-line, where Brand is board brand from zrouter/boards and build object: Model is the model from zrouter/boards/brand/model:
!path.jpg!
- <pre>-# make TARGET_PAIR=Brand/Model FREEBSD_SRC_TREE=${PATH_TO_FREEBSD_SRC}/head OBJ_DIR=${PATH_FOR_OBJ_BUILD_DIR}</pre>