| $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 up till 7.09: |
| 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 | For OpenWRT Kamikaze 8.09 and up, there is no SDK available and the 7.09 SDK does not work. So Option 1 is not an option. Option 2 is not an option either since building the SDK did not seem to work (https://forum.openwrt.org/viewtopic.php?id=17879). So jump to Option 3! |
| 45 | |
| 46 | If it works (!) you will have an ipkg file in $(OPENWRTSDK)/bin/packages/ |
| 47 | You can then boot up your OpenWrt |
| 48 | router, copy the .ipk to it, and install it using the ipkg commands. |
| 49 | |
| 50 | You should also make sure that the wifidog prereqs are already |
| 51 | installed on the router before you try to run wifidog. Note that if you build the |
| 52 | 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. |
| 53 | |
| 54 | The prereqs are: |
| 55 | * iptables command and modules mac, mark and MARK |
| 56 | * iptables kernel module mac |
| 57 | * libpthread |
| 58 | |
| 59 | These are all packages you can install on your running OpenWrt router |
| 60 | using the ipkg commands. If the router is on the net, the ipkg |
| 61 | commands can download the packages from www.openwrt.org, just like |
| 62 | debian apt-get or fedora yum or up2date. |
| 63 | |
| 64 | Option 2. Build your own SDK (or find someone to do it for you) |
| 65 | cd ~ |
| 66 | wget http://downloads.openwrt.org/kamikaze/7.09/kamikaze_7.09.tar.bz2 |
| 67 | tar -jxvf kamikaze_7.09.tar.bz2 |
| 68 | cd kamikaze_7.09 |
| 69 | make menuconfig #(Make sure you build the SDK in "special targets") |
| 70 | make #(could take hours downloading and compiling all dependencies) |
| 71 | Follow the instructions in Option 1, using the SDK you build instead of downloading it. |
| 72 | |
| 73 | Option 3. Use the full buildroot directly (time consuming...) |
| 74 | cd wifidog |
| 75 | make dist |
| 76 | cd ~ |
| 77 | wget http://downloads.openwrt.org/kamikaze/7.09/kamikaze_7.09.tar.bz2 |
| 78 | tar -jxvf kamikaze_7.09.tar.bz2 |
| 79 | cp -R wifidog/contrib/build-openwrt-kamikazeipk/wifidog kamikaze_7.09/package/ |
| 80 | cp wifidog/wifidog-1.1.5.tar.gz kamikaze_7.09/dl/ |
| 81 | cd kamikaze_7.09 |
| 82 | make menuconfig #(Follow instructions on OpenWRT's site to setup your buildroot for your platform) |
| 83 | make #(could take hours downloading and compiling all dependencies) |
| 84 | |
| 85 | For Kamikaze 8.09 and up, there is an extra dependency to add to the package, so here would be the new procedure |
| 86 | cd wifidog |
| 87 | make dist |
| 88 | cd ~ |
| 89 | wget http://downloads.openwrt.org/kamikaze/8.09/kamikaze_8.09.tar.bz2 |
| 90 | tar -jxvf kamikaze_8.09.tar.bz2 |
| 91 | cp -R wifidog/contrib/build-openwrt-kamikazeipk8.09up/wifidog kamikaze_8.09/package/ |
| 92 | cp wifidog/wifidog-1.1.5.tar.gz kamikaze_8.09/dl/ |
| 93 | cd kamikaze_8.09 |
| 94 | make menuconfig #(Follow instructions on OpenWRT's site to setup your buildroot for your platform) |
| 95 | make #(could take hours downloading and compiling all dependencies) |
| 96 |