HOWTO - How to Install UU-AODV on a IPAQ H3760 using Familiar 0.7
	================================================================

This is a HOWTO for getting AODV version of the Upsala University (version 0.8) to work 
on a Compaq IPAQ H3760 with a Compaq WL110 WLAN PCMCIA card that runs a Familiar 0.7 with
a 2.4.19 kernel


The Environment
---------------
PDA
	Version - IPAQ H3760 with PCMCIA dual jacket
	Wireless Card - Compaq WL110 (PCMCIA WLAN)

Linux
	Distibution - Familiar 0.7.2
	Kernel - 2.4.19-rmk6-pxa1-hh30 
	Location - cvs.handhelds.org 

Cross Compiler
	Version - Arm Linux GCC 3.3.2
	Location - ftp://ftp.handhelds.org/pub/linux/arm/toolchain/
	Files - arm-linux-gcc-3.3.2.tar.bz2

UU-AODV
	Version 0.8
	Location - http://www.docs.uu.se/~henrikl/aodv
	Files - aodv-uu-0.8.tar.gz

Host Environment
	Computer - i686
	Distribution - Mandrake 9.2
	Kernel - 2.4.22-10mdk



Procedure
---------

1. Download the Kernel and set environment

	a. cd /usr/src
	b. rm linux
	c. export CVSROOT=:pserver:anoncvs@cvs.handhelds.org:/cvs
	d. cvs login 
	e. password : anoncvs
	f. cvs export -r K2-4-19-rmk6-pxa1-hh30 linux/kernel
	g. mv linux K2-4-19-rmk6-pxa1-hh30
	h. ln -s /usr/src/K2-4-19-rmk6-pxa1-hh30/kernel /usr/src/linux

2. Install the cross compiler

	a. mkdir /usr/src/cross-compilers
	b. cd /usr/src/cross-compilers
	c. wget ftp://ftp.handhelds.org/pub/linux/arm/toolchain/arm-linux-gcc-3.3.2.tar.bz2
	d. cd /
	e. tar -xyvf /usr/src/cross-compilers/arm-linux-gcc-3.3.2.tar.bz2
	f. export PATH=$PATH:/usr/local/arm/3.3.2/bin

3. Compile the Kernel

	a. cd /usr/src/linux
	b. cp arch/arm/def-configs/ipaqsa .config
	c. make oldconfig
	d. make menuconfig
		select "Network Options" -> "IP : Netfilter Configuration"
		select "M" for "Userspace queuing via NETLINK (EXPERIMENTAL)"
		select Exit -> Exit -> Exit
		select "yes" for "Do you wish to save your kernel configuration?"
		(the entry that is set is CONFIG_IP_NF_QUEUE=m)
	e. vi /usr/src/linux/arch/arm/Makefile
		Remove the switch "-mshort-load-bytes" from all tags
		(I changed in CFLAGS_BOOT and CFLAGS)
	f. make dep 
	g. make zImage
	h. make modules

4. Compile UU AODV

	a. mkdir /usr/src/uu-aodv
	b. cd /usr/src/uu-aodv
	c. wget http://www.docs.uu.se/~henrikl/aodv/aodv-uu-0.8.tar.gz
	d. tar -xzvf aodv-uu-0.8.tar.gz
	e. cd /usr/src/uu-aodv/aodv-uu-0.8
	f. vi Makefile
		add "-I/usr/src/linux/include -I /usr/local/arm/3.3.2/include" to 
		the KINC tag just after -nostdin (make sure that this is before 
		all other -I entries)
	g. make arm

5. Getting all files

	a. mkdir /usr/src/uu-aodv-installable
	b. cd /usr/src/uu-aodv-installable
	c. cp /usr/src/linux/net/ipv4/netfilter/ip_queue.o .
	d. cp /usr/src/uu-aodv/aodv-uu-0.8/kaodv.o
	e. cp /usr/src/uu-aodv/aodv-uu-0.8/aodvd .

6. Load all files to IPAQ

	I used a PCMCIA Compact Flash card
	copy all files to /root on the IPAQ

7. Setup Networking in IPAQ

	a. Select "Text Editor" from "Pim" menu
	b. Open /etc/pcmcia/network.opts
		set the following for a static IP address
			DHCP="n"
			PUMP='n'
			DHCP_HOSTNAME=""
			IPADDR="192.168.0.100"
			NETMASK="255.255.255.0"
			NETWORK="192.168.0.0"
			BROADCAST="192.168.0.255"
			GATEWAY="192.168.0.1"
			DOMAIN=""
			SEARCH=""
			DNS_1="192.168.0.150"
		and save file
	c. Open /etc/pcmcia/wireless.opts
		set the following for WLAN ad-hoc mode
			ESSID="uuaodv"
			MODE="Ad-hoc"
		and save file
	d. Insert the WLAN (Compaq WL110) card into the PCMCIA Slot	
	e. Select "Konsole" in "Applications" menu
	f. ifconfig
		check whether your IP address is set
	g. iwconfig 
		check whether WLAN card is in adhoc mode

8. Running UU AODV
	a. Select "Konsole" in "Applications" menu
	b. insmod /root/ip_queue.o
	c. insmod /root/kaodv.o
	d. /root/aodvd -i eth0
		use whatever other parameters you wish

@compiled by 
	Asanga Udugama (adu@comnets.uni-bremen.de) on 2004-11-10

@acknowledgment
	author acknowledges all those mailing lists, READMEs and other documents
	that were helpful in making this HOWTO possible