| 1 |
$Id$ |
|---|
| 2 |
|
|---|
| 3 |
OpenWRT specific README |
|---|
| 4 |
======================= |
|---|
| 5 |
|
|---|
| 6 |
So, you want to run wifidog on one of linksys's WRT wireless routers! |
|---|
| 7 |
|
|---|
| 8 |
OpenWRT is the embedded linux-gnu bundle that runs on the linksys WRT |
|---|
| 9 |
series routers (among numerous others). |
|---|
| 10 |
|
|---|
| 11 |
OpenWRT's home page is http://openwrt.org/ |
|---|
| 12 |
|
|---|
| 13 |
---- I just want to RUN the thing: ---- |
|---|
| 14 |
-DO NOT use the wifidog packages distributed by OpenWRT (you are asking for trouble, they are broken in various ways; you will get no support if you do) |
|---|
| 15 |
-Use the official wifidog packages on sourceforge (currently only available for whiterussian. |
|---|
| 16 |
|
|---|
| 17 |
---- I want to develop and test on OpenWRT ---- |
|---|
| 18 |
|
|---|
| 19 |
To build wifidog so that it may be run on the linksys wrt routers you |
|---|
| 20 |
must first obtain the OpenWRT toolchain. This toolchain is a set of |
|---|
| 21 |
compilers and other software development tools that will allow you, |
|---|
| 22 |
running on your intel/pentium/mac computer to compile and develop software |
|---|
| 23 |
that is to run on the mips based linksys wrt series routers, which is |
|---|
| 24 |
based on another computer cpu chip entirely. |
|---|
| 25 |
|
|---|
| 26 |
You have several options for building wifidog using the OpenWRT toolchain. |
|---|
| 27 |
|
|---|
| 28 |
Option 1. get the prebuilt, minimal OpenWRT toolchain (The OpenWRT SDK), and give the makefile it's path. This is the best option, assuming you have a x86_64 Os (the SDK is distributed only for x86_64). |
|---|
| 29 |
|
|---|
| 30 |
For OpenWRT 0.9 (Whiterussian): |
|---|
| 31 |
cd ~ |
|---|
| 32 |
wget http://downloads.openwrt.org/whiterussian/newest/OpenWrt-SDK-Linux-i686-1.tar.bz2 |
|---|
| 33 |
tar -jxvf OpenWrt-SDK-Linux-i686-1.tar.bz2 |
|---|
| 34 |
cd wifidog |
|---|
| 35 |
make whiterussianipk OPENWRTSDK=~/OpenWrt-SDK-Linux-i686-1/ |
|---|
| 36 |
|
|---|
| 37 |
For OpenWRT Kamikaze: |
|---|
| 38 |
cd ~ |
|---|
| 39 |
wget http://downloads.openwrt.org/kamikaze/7.09/brcm-2.4/OpenWrt-SDK-brcm-2.4-for-Linux-x86_64.tar.bz2 |
|---|
| 40 |
tar -jxvf OpenWrt-SDK-brcm-2.4-for-Linux-x86_64.tar.bz2 |
|---|
| 41 |
cd wifidog |
|---|
| 42 |
make kamikazeipk OPENWRTSDK=~/OpenWrt-SDK-brcm-2.4-for-Linux-x86_64 |
|---|
| 43 |
|
|---|
| 44 |
If it works (!) you will have an ipkg file in $(OPENWRTSDK)/bin/packages/ |
|---|
| 45 |
You can then boot up your OpenWrt |
|---|
| 46 |
router, copy the .ipk to it, and install it using the ipkg commands. |
|---|
| 47 |
|
|---|
| 48 |
You should also make sure that the wifidog prereqs are already |
|---|
| 49 |
installed on the router before you try to run wifidog. Note that if you build the |
|---|
| 50 |
packages with the instructions above, they will download the required dependencies auomatically (if you have an internet connecion on yout router) and will refuse to install without them. |
|---|
| 51 |
|
|---|
| 52 |
The prereqs are: |
|---|
| 53 |
* iptables command and modules mac, mark and MARK |
|---|
| 54 |
* iptables kernel module mac |
|---|
| 55 |
* libpthread |
|---|
| 56 |
|
|---|
| 57 |
These are all packages you can install on your running OpenWrt router |
|---|
| 58 |
using the ipkg commands. If the router is on the net, the ipkg |
|---|
| 59 |
commands can download the packages from www.openwrt.org, just like |
|---|
| 60 |
debian apt-get or fedora yum or up2date. |
|---|
| 61 |
|
|---|
| 62 |
Option 2. Build your own SDK (or find someone to do it for you) |
|---|
| 63 |
cd ~ |
|---|
| 64 |
wget http://downloads.openwrt.org/kamikaze/7.09/kamikaze_7.09.tar.bz2 |
|---|
| 65 |
tar -jxvf kamikaze_7.09.tar.bz2 |
|---|
| 66 |
cd kamikaze_7.09 |
|---|
| 67 |
make menuconfig #(Make sure you build the SDK in "special targets") |
|---|
| 68 |
make #(could take hours downloading and compiling all dependencies) |
|---|
| 69 |
Follow the instructions in Option 1, using the SDK you build instead of downloading it. |
|---|
| 70 |
|
|---|
| 71 |
Option 3. Use the full buildroot directly (time consuming...) |
|---|
| 72 |
cd wifidog |
|---|
| 73 |
make dist |
|---|
| 74 |
cd ~ |
|---|
| 75 |
wget http://downloads.openwrt.org/kamikaze/7.09/kamikaze_7.09.tar.bz2 |
|---|
| 76 |
tar -jxvf kamikaze_7.09.tar.bz2 |
|---|
| 77 |
cp -R wifidog/contrib/build-openwrt-kamikazeipk/wifidog kamikaze_7.09/package/ |
|---|
| 78 |
cp wifidog/wifidog-1.1.5.tar.gz kamikaze_7.09/dl/ |
|---|
| 79 |
cd kamikaze_7.09 |
|---|
| 80 |
make menuconfig #(Follow instructions on OpenWRT's site to setup your buildroot for your platform) |
|---|
| 81 |
make #(could take hours downloading and compiling all dependencies) |
|---|
| 82 |
|
|---|
| 83 |
|
|---|
