Project

General

Profile

QuickStart » History » Version 34

« Previous - Version 34/40 (diff) - Next » - Current version
Alexey Z., 03/06/2013 05:56 AM


Quickstart guide

Creating a ZRouter build environment.

This should probably be done within a Jail.

At First, this Requires you have [[hg]]/mercurial installed:
  • From FreeBSD ports:
    # cd /usr/ports/devel/mercurial
    # make install clean
    
  • OR From FreeBSD packages:
    # pkg_add -r mercurial (or # pkg install mercurial)
    
  1. Create a path set aside for ZRouter build.
    # mkdir -p ZRouter/
  2. Enter directory:
    # cd ZRouter
  3. Checkout/clone ZRouter Project
    # hg clone http://zrouter.org/hg/zrouter/
  4. Checkout/clone Current compatible FreeBSD source:
    # hg clone http://zrouter.org/hg/FreeBSD/head FreeBSD
  5. Begin ZRouter Build Menu
    # ./menu.sh

Entering ./menu.sh

Main menu

  1. Select your target device (example D-Link DIR-632):
    Target device
  2. 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)

Firmware size

  1. At "Profiles" select package that included firmware:
    - DEBUG_ -
    - ath -
    - dhclient -
    - dhcp -
    - dig_spcdns -
    - hostap -
    - ipfw - stateful firewall written for FreeBSD.
    - lagg -
    - lua_web_ui -
    - mono -
    - mpd -
    - mroute -
    - net_help -
    - nfs_client -
    - ng_igmp_fwd -
    - ntpdate - for clock synchronization over Network Time Protocol.
    - openvpn - create a Virtual Private Network. Include OpenVPN, crypto libraries.
    - ppp -
    - racoon -
    - racoon2 -
    - shttpd -
    - ssh - enable SSH service. Include ssh, sshd, SSH PAM service file and /etc/ssh configs.
    - watchdog - if software freeze, then watchdog H/W reset system. Include watchdogd and rc.d script.
    - zhttpd -
    Packages
  2. Last that must to do - select paths of source and build object:
    Paths
    - Path of FreeBSD/head
    Source
    - Path of objects (temporary direcroty where will be compilate your firmware)
    Objects
    Then go back to main menu:
    Back to main menu
  3. You can save your selection to "Build Profile" for future use (file will be created at "./Zrouter/zrouter/build_profiles/" ):
    Save Build Profile
    Enter Build Profile Name
  4. You can load your Build Profile if you save it early:
    Load Build Profile
    Select Build Profile
  5. Now select to "Build" and you see all your choices:
    Last choice
    Answer "yes" and firmware will begining.

Flash your firmware