Project

General

Profile

QuickStart » History » Version 26

Alexey Z., 02/28/2013 12:53 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 26 Alexey Z.
# You can save your selection to "Build Profile" for future use (file will be created at "./Zrouter/zrouter/build_profiles/" ):
51 24 Alexey Z.
!save_menu.jpg!
52 24 Alexey Z.
!save.jpg!
53 1 Nicolai Petri
# You can load your Build Profile if you save it early:
54 25 Alexey Z.
!load_menu.jpg!
55 1 Nicolai Petri
!load.jpg!
56 26 Alexey Z.
# Now select to "Build" and you see all your choices:
57 26 Alexey Z.
!Compilate.jpg!
58 26 Alexey Z.
Answer "yes" and firmware will begining.
59 26 Alexey Z.
60 26 Alexey Z.
h2. "Flash your firmware":http://zrouter.org/projects/zrouter/wiki/Howto_flash