SDP user's guide - Revision history

Jeschke at 09:14, 31 January 2006

2006-01-31T09:14:48Z

← Older revision		Revision as of 09:14, 31 January 2006
Line 23:		Line 23:
	export RANLIB=${P}ranlib		export RANLIB=${P}ranlib
	export STRIP=${P}strip		export STRIP=${P}strip
	export CLICKPATH=$BUILD_DIR/staging_dir~~/bin~~/lib		export CLICKPATH=$BUILD_DIR/staging_dir/lib

	This script must then always be sourced before working with the software.		This script must then always be sourced before working with the software.

Jeschke at 09:14, 31 January 2006

2006-01-31T09:14:26Z

← Older revision		Revision as of 09:14, 31 January 2006
Line 39:		Line 39:

	install some missing header files for BRN		install some missing header files for BRN
	mkdir -p staging_dir~~/bin~~/include/elements/wifi/{ap,sr}		mkdir -p staging_dir/include/elements/wifi/{ap,sr}
	cp -a click/elements/wifi/*.hh staging_dir/bin/include/elements/wifi/		cp -a click/elements/wifi/*.hh staging_dir/bin/include/elements/wifi/
	cp -a click/elements/wifi/ap/*.hh staging_dir/bin/include/elements/wifi/ap/		cp -a click/elements/wifi/ap/*.hh staging_dir/bin/include/elements/wifi/ap/

Jkm at 23:35, 25 January 2006

2006-01-25T23:35:24Z

← Older revision		Revision as of 23:35, 25 January 2006
Line 51:		Line 51:

	==New BRN==		==New BRN==
	Since 2005-10-15 there is a working kernel-click with added BRN for the OpenWGT platform. It comes with a complete build environment / toolchain that is documented at [[~~http://intwiki/wiki/index.php/~~BRN:~~:Development:~~:Toolchain]] ~~(internal wiki is only available from within SAR)~~.		Since 2005-10-15 there is a working kernel-click with added BRN for the OpenWGT platform. It comes with a complete build environment / toolchain that is documented at [[BRN:Dev:Toolchain]].
	I used the "Jens' method" to build it ~~(warning: took 5h to complete)~~.		I used the "Jens' method" to build it.

	When the toolchain is complete, you start building the additional components in ~/projects/brn :		When the toolchain is complete, you start building the additional components in ~/projects/brn :

Efuhrman at 14:00, 25 January 2006

2006-01-25T14:00:47Z

← Older revision		Revision as of 14:00, 25 January 2006
Line 35:		Line 35:
	svn co svn://merkur.sardmn.informatik.hu-berlin.de/brn/platform/wgt634u/openwrt make		svn co svn://merkur.sardmn.informatik.hu-berlin.de/brn/platform/wgt634u/openwrt make

	and build click ~~with~~		and build click
	make -f make/click.mk click		make -f make/click.mk click

	for standard BRN_NEIGHBOR_BEACON_MAGIC or

	make -f make/click.mk click CPPFLAGS=-D'BRN_NEIGHBOR_BEACON_MAGIC=<magic>' TARGET_CFLAGS=-D'BRN_NEIGHBOR_BEACON_MAGIC=<magic>'

	for non-standard BRN_NEIGHBOR_BEACON_MAGIC

	install some missing header files for BRN		install some missing header files for BRN

Cakruege: /* Installation and Setup */

2006-01-25T12:36:02Z

Installation and Setup

← Older revision		Revision as of 12:36, 25 January 2006
Line 35:		Line 35:
	svn co svn://merkur.sardmn.informatik.hu-berlin.de/brn/platform/wgt634u/openwrt make		svn co svn://merkur.sardmn.informatik.hu-berlin.de/brn/platform/wgt634u/openwrt make

	and build click		and build click with
	make -f make/click.mk click		make -f make/click.mk click

			for standard BRN_NEIGHBOR_BEACON_MAGIC or

			make -f make/click.mk click CPPFLAGS=-D'BRN_NEIGHBOR_BEACON_MAGIC=<magic>' TARGET_CFLAGS=-D'BRN_NEIGHBOR_BEACON_MAGIC=<magic>'

			for non-standard BRN_NEIGHBOR_BEACON_MAGIC

	install some missing header files for BRN		install some missing header files for BRN

Wiedemann: minor clarifications

2005-12-21T16:46:50Z

minor clarifications

← Older revision		Revision as of 16:46, 21 December 2005
Line 51:		Line 51:

	==New BRN==		==New BRN==
	Since 2005-10-15 there is a working kernel-click with added BRN for the OpenWGT platform. It comes with a complete build environment / toolchain that is documented at [[http://intwiki/wiki/index.php/BRN::Development::Toolchain]].		Since 2005-10-15 there is a working kernel-click with added BRN for the OpenWGT platform. It comes with a complete build environment / toolchain that is documented at [[http://intwiki/wiki/index.php/BRN::Development::Toolchain]] (internal wiki is only available from within SAR).
	I used the "Jens' method" to build it (warning: took 5h to complete).		I used the "Jens' method" to build it (warning: took 5h to complete).

	When the toolchain is complete, you start building the additional components in ~/projects/brn :		When the toolchain is complete, you start building the additional components in ~/projects/brn :
	( cd madmax/mips/kernel ; sh build.sh )		( cd madmax/mips/kernel ; sh build.sh )
⚫	( cd madmax/mips/click/linuxmodule ; sh build.sh )
	( cd madmax/mips/madwifi.stripped ; sh build.sh )		( cd madmax/mips/madwifi.stripped ; sh build.sh )
		⚫	( cd madmax/mips/click/linuxmodule ; sh build.sh )


	For the kernel build you need to take care that the .config matches the kernel that is run on the system on which the click.ko loadable kernel module shall be used		For the kernel build you need to take care that the .config matches the kernel that is run on the system on which the click.ko loadable kernel module shall be used

	The steps from the old installation section are only changed in one minimal thing: you omit "make -f make/brn.mk brn" because the BRN modules do not run in user-space and are included in the click directory.		The steps from the old installation section are only changed in one minimal thing: you omit "make -f make/brn.mk brn" because the BRN modules do not run in user-space anymore and are now included in the new click directory.

	After all building is done, change your current directory to sdp/package . To build a version 0 SDP package without any BRN you do		After all building is done, change your current directory to sdp/package . To build a version 0 SDP package without any BRN you do

Wiedemann: add new SDP documentation

2005-12-16T17:41:28Z

add new SDP documentation

← Older revision		Revision as of 17:41, 16 December 2005
Line 48:		Line 48:
	make -f make/sdp.mk sdp		make -f make/sdp.mk sdp

	Then, provided that no errors occurred, you are done setting SDP up and can follow on with reading sdp/README .		Then, provided that no errors occurred, you are done setting SDP up and can follow on with reading sdp/README about building SDP packages.

			==New BRN==
			Since 2005-10-15 there is a working kernel-click with added BRN for the OpenWGT platform. It comes with a complete build environment / toolchain that is documented at [[http://intwiki/wiki/index.php/BRN::Development::Toolchain]].
			I used the "Jens' method" to build it (warning: took 5h to complete).

			When the toolchain is complete, you start building the additional components in ~/projects/brn :
			( cd madmax/mips/kernel ; sh build.sh )
			( cd madmax/mips/click/linuxmodule ; sh build.sh )
			( cd madmax/mips/madwifi.stripped ; sh build.sh )

			For the kernel build you need to take care that the .config matches the kernel that is run on the system on which the click.ko loadable kernel module shall be used

			The steps from the old installation section are only changed in one minimal thing: you omit "make -f make/brn.mk brn" because the BRN modules do not run in user-space and are included in the click directory.

			After all building is done, change your current directory to sdp/package . To build a version 0 SDP package without any BRN you do
			make sdp sdppackage version=0

			Then to build a new package for distributing a kernel BRN version (that is scheduled for activation in 300 seconds and to be immediately injected at the BRN node wgt27) do
			make brn sdppackage activation=$(expr $(date +%s) + 300) && make sdpdeploy node=wgt27

			Whenever you do not explicitly specify a version it is auto-incremented by 1.

			The default injection node= value can be set in the sdp/package/Makefile

			Now. That is it. Have fun with your new SDP.

Wiedemann: minor update

2005-12-14T09:45:52Z

minor update

← Older revision		Revision as of 09:45, 14 December 2005
Line 9:		Line 9:
	cd openwrt		cd openwrt

	There you should create a script called env.sh adapting this content to your ~~pathes~~. This assumes the OpenWRT/WGT toolchain is located in /home/wrt/buildroot		There you should create a script called env.sh adapting this content to your paths. This assumes the OpenWRT/WGT toolchain is located in /home/wrt/buildroot
	#!/bin/sh		#!/bin/sh
	echo "Setting up Click environment!"		echo "Setting up Click environment!"
Line 33:		Line 33:

	Then check out the main Makefiles		Then check out the main Makefiles
	svn co svn://merkur.sardmn.informatik.hu-berlin.de/brn/platform/wgt634u/openwrt		svn co svn://merkur.sardmn.informatik.hu-berlin.de/brn/platform/wgt634u/openwrt make

	and build click		and build click
	make -f ~~openwrt~~/click.mk click		make -f make/click.mk click

	install some missing header files for BRN		install some missing header files for BRN
Line 45:		Line 45:

	and build the modules		and build the modules
	make -f ~~openwrt~~/brn.mk brn		make -f make/brn.mk brn
	make -f ~~openwrt~~/sdp.mk sdp		make -f make/sdp.mk sdp

	Then, provided that no errors occurred, you are done setting SDP up and can follow on with reading sdp/README .		Then, provided that no errors occurred, you are done setting SDP up and can follow on with reading sdp/README .

Wiedemann: add env Note

2005-12-06T20:38:37Z

add env Note

← Older revision		Revision as of 20:38, 6 December 2005
Line 28:		Line 28:
	. env.sh		. env.sh

			Note that the above step is very important and lack of proper environment variables can lead to strange behaviour. If you got it right this should work:
			echo $CC
			/home/wrt/buildroot/build_mipsel/staging_dir/bin/mipsel-linux-uclibc-gcc

	check out the main Makefiles		Then check out the main Makefiles
	svn co svn://merkur.sardmn.informatik.hu-berlin.de/brn/platform/wgt634u/openwrt		svn co svn://merkur.sardmn.informatik.hu-berlin.de/brn/platform/wgt634u/openwrt

Wiedemann: initial version from my spdoc/install

2005-12-06T20:31:24Z

initial version from my spdoc/install

New page

This page is intended to help you getting started using the [[Software Distribution Platform]] (SDP) within [[BerlinRoofNet]] (BRN).

=Installation and Setup=
This includes checking out and building all required components

First, create the directory to store everything belonging to SDP, BRN and [[click]].
mkdir openwrt
cd openwrt

There you should create a script called env.sh adapting this content to your pathes. This assumes the OpenWRT/WGT toolchain is located in /home/wrt/buildroot
#!/bin/sh
echo "Setting up Click environment!"

export BUILD_DIR=/home/bernhard/openwrt
export BASEDIR=/home/wrt/buildroot/build_mipsel/staging_dir
P=$BASEDIR/bin/mipsel-linux-uclibc-
export CC="${P}gcc"
export CPP=${P}cpp
export CXX="${P}g++"
export TARGET_CC="$CC"
export TARGET_CXX="$CXX"
export RANLIB=${P}ranlib
export STRIP=${P}strip
export CLICKPATH=$BUILD_DIR/staging_dir/bin/lib

This script must then always be sourced before working with the software.
. env.sh

check out the main Makefiles
svn co svn://merkur.sardmn.informatik.hu-berlin.de/brn/platform/wgt634u/openwrt

and build click
make -f openwrt/click.mk click

install some missing header files for BRN
mkdir -p staging_dir/bin/include/elements/wifi/{ap,sr}
cp -a click/elements/wifi/*.hh staging_dir/bin/include/elements/wifi/
cp -a click/elements/wifi/ap/*.hh staging_dir/bin/include/elements/wifi/ap/
cp -a click/elements/wifi/sr/*.hh staging_dir/bin/include/elements/wifi/sr/

and build the modules
make -f openwrt/brn.mk brn
make -f openwrt/sdp.mk sdp

Then, provided that no errors occurred, you are done setting SDP up and can follow on with reading sdp/README .