Repository : ssh://git@open-mesh.org/doc

On branches: backup-redmine/2017-07-13,master

commit 299719407e1c74394b5caeb8879196f8791be22b Author: Linus Lüssing linus.luessing@c0d3.blue Date: Wed Mar 31 15:37:47 2010 +0000

doc: batman-adv/Building-with-openwrt: adding "the easy way", removing divs for verbatims (otherwise I'd have a grey line on half of my screen)

299719407e1c74394b5caeb8879196f8791be22b batman-adv/Building-with-openwrt.textile | 32 ++++++-------------------------- 1 file changed, 6 insertions(+), 26 deletions(-)

diff --git a/batman-adv/Building-with-openwrt.textile b/batman-adv/Building-with-openwrt.textile index 310f8db1..7b546473 100644 --- a/batman-adv/Building-with-openwrt.textile +++ b/batman-adv/Building-with-openwrt.textile @@ -2,46 +2,34 @@ = Building B.A.T.M.A.N. Advanced on OpenWRT =

{{{ -#!div style="width: 40em; text-align: justify" +#!div style="width: 46em; text-align: justify"

Many tutorials assume that you have batman-adv running on an OpenWRT system without going into detail how to get the system built and configured. This documents aims to fill the gap by providing a step-by-step explanation how to get your OpenWRT system up & running.

=== Getting the OpenWRT build environment ===

First, you need to obtain a copy of the OpenWRT build system which contains all the build information to compile & package a complete linux system. You can either checkout the last stable or the trunk directly from the OpenWRT SVN repository or get tarballs from the OpenWRT project website. We assume you intend to download the latest stable (8.09.2 at the point of writing this document) via SVN: -}}}

{{{ svn co svn://svn.openwrt.org/openwrt/tags/8.09.2 openwrt-kamikaze }}}

-{{{ -#!div style="width: 40em; text-align: justify" - Change into the openwrt-kamikaze directory and configure the system to meet you needs (e.g. choose the platform and additional packages you intend to use). -}}}

{{{ cd openwrt-kamikaze make menuconfig }}}

-{{{ -#!div style="width: 40em; text-align: justify" - __Note__: The batman-adv package is not there yet because it needs to be activated seperately (see the following steps). [[BR]]

To build your images you always have to invoke the "make" command from within the openwrt-kamikaze folder: -}}}

{{{ cd openwrt-kamikaze make }}}

-{{{ -#!div style="width: 40em; text-align: justify" - The rest of the document will focus on the batman-adv package. It is assumed that you configured the system to work on your platform. If you require additional information on how to tweak your OpenWRT system, please see [http://www.openwrt.org the OpenWRT project website].

=== Adding the batman-adv package === @@ -54,43 +42,35 @@ Downloading and adding all packages might clutter your OpenWRT package menu with

__The easy way__: [[BR]]

-TBD +{{{ +scripts/feeds update +scripts/feeds install kmod-batman-adv-kernelland +}}} +''Note'': If you want to build a current version of batman-adv, make sure you have ''"svn-src packages !svn://svn.openwrt.org/openwrt/packages"'' in your feeds.conf(.default)

__The manual way__: [[BR]]

Download the OpenWRT package repository via SVN next to your openwrt-kamikaze folder (not inside!): -}}}

{{{ svn co svn://svn.openwrt.org/openwrt/packages openwrt-packages }}}

-{{{ -#!div style="width: 40em; text-align: justify" - The batman-adv package can be found in the "net" subfolder of the package repository. Now, it needs to be linked into your main package folder, so that OpenWRT can find it: -}}}

{{{ cd openwrt-kamikaze/package ln -sf ../../openwrt-packages/net/batman-advanced/ . }}}

-{{{ -#!div style="width: 40em; text-align: justify" - === Configuring the batman-adv package ===

As soon as the batman-adv package has been added, it will show up in the OpenWRT package menu: -}}}

{{{ Kernel modules ---> Network Support ---> kmod-batman-adv-kernelland }}}

-{{{ -#!div style="width: 40em; text-align: justify" - Once the package had been selected a number of suboptions will become visible. The branch option decides whether OpenWRT should build the latest stable batman-adv release or the bleeding edge development version. You also can enable/disable the verbose debug logging as well as choose whether or not to include the batctl tool.

In addition, the batman-adv package comes with an init script which is installed per default. This script will run at boot time and can be used to configure your desired batman-adv options. It reads the batman-adv-kernelland uci file to retrieve the settings which allows to specify interfaces, intervals, log level and more.