Project

General

Profile

QuickStart » History » Version 24

Alexey Z., 02/28/2013 12:43 PM

1 1 Nicolai Petri
h1. QuickStart
2 1 Nicolai Petri
3 13 Michael Vale
h2. Quickstart guide to creating a ZRouter build environment.
4 1 Nicolai Petri
5 1 Nicolai Petri
This should probably be done within a Jail.
6 1 Nicolai Petri
7 22 Alexey Z.
  At First, this Requires you have [[hg]]/mercurial installed:
8 23 Alexey Z.
9 22 Alexey Z.
* From FreeBSD ports:
10 22 Alexey Z.
<pre>
11 22 Alexey Z.
# cd /usr/ports/devel/mercurial
12 22 Alexey Z.
# make install clean
13 22 Alexey Z.
</pre>
14 22 Alexey Z.
* *OR* From FreeBSD packages:
15 22 Alexey Z.
<pre>
16 22 Alexey Z.
# pkg_add -r mercurial
17 22 Alexey Z.
</pre>
18 22 Alexey Z.
19 16 Michael Vale
# Create a path set aside for ZRouter build.
20 1 Nicolai Petri
<pre># mkdir -p ZRouter/</pre>
21 1 Nicolai Petri
# Enter directory: 
22 1 Nicolai Petri
<pre># cd ZRouter</pre>
23 1 Nicolai Petri
# Checkout/clone ZRouter Project
24 1 Nicolai Petri
<pre># hg clone http://zrouter.org/hg/zrouter/</pre>
25 1 Nicolai Petri
# Checkout/clone Current compatible FreeBSD source:
26 1 Nicolai Petri
<pre># hg clone http://zrouter.org/hg/FreeBSD/head FreeBSD</pre>
27 1 Nicolai Petri
# Begin ZRouter Build Menu
28 1 Nicolai Petri
<pre># ./menu.sh</pre>
29 22 Alexey Z.
30 22 Alexey Z.
h2. Entering ./menu.sh
31 1 Nicolai Petri
32 23 Alexey Z.
    !mainmenu.jpg!
33 22 Alexey Z.
34 22 Alexey Z.
# Select your target device (example D-Link DIR-632):
35 22 Alexey Z.
!Target.jpg!
36 22 Alexey Z.
# Select Base Profile. That's two choise: 
37 22 Alexey Z.
 - Small - size firmware > 4 MB (if your ROM more than 4 MB)
38 22 Alexey Z.
 - Extra small - size firmware <= 4MB (if your ROM less than 4 MB)
39 22 Alexey Z.
!kernel.jpg!
40 22 Alexey Z.
# At "Profiles" select package that included firmware:
41 22 Alexey Z.
!package.jpg!
42 1 Nicolai Petri
# Last that must to do - select paths of source and build object:
43 1 Nicolai Petri
!path.jpg!
44 23 Alexey Z.
 - Path of FreeBSD/head
45 23 Alexey Z.
!Path_head.jpg!
46 24 Alexey Z.
 - Path of objects (temporary direcroty where will be compilate your firmware)
47 23 Alexey Z.
!path_obj.jpg!
48 23 Alexey Z.
Then go back to main menu:
49 1 Nicolai Petri
!path_back.jpg!
50 24 Alexey Z.
# You can save your selection to "Build Profile" for future use (file will be created at Zrouter/zrouter/build_profiles/${name}.conf):
51 24 Alexey Z.
!save_menu.jpg!
52 24 Alexey Z.
!save.jpg!
53 24 Alexey Z.
# You can load your Build Profile if you save it early: