Diff for "MississippiNetworkRepeater" - Personal Telco Project

Differences between revisions 6 and 12 (spanning 6 versions)

The MississippiNetworkRepeater is a NetgearWgt634u loaded with OpenWRT. It uses a HawkingHwu54g USB 802.11g radio as a client to any nearby www.personaltelco.net network and operates its native radio as a local coverage access point.

Building

To build one of the devices:

load OpenWrt Kamikaze (here r6007) in a normal fashion, via serial console:

CFE> ifconfig eth0 -auto
CFE> flash -noheader 192.168.0.5:wgt634u/wipe-1.img flash0.os
CFE> flash -noheader -offset=3932160 192.168.0.5:wgt634u/wipe-2.img flash0.os
CFE> flash -noheader 192.168.0.5:wgt634u/openwrt-wgt634u-2.6-jffs2-r6007.bin flash0.os
CFE> reboot

log into the AP via serial console

set root password:

passwd

configure /etc/ipkg.conf to point at a compatible package archive:

src snapshots http://www.personaltelco.net/~russell/openwrt/r6007/packages
dest root /
dest ram /tmp

install zd1211 packages:

ipkg install kmod-usb2
ipkg install kmod-zd1211

install iproute2 tools because I like them:
- ```
ipkg install ip
```

configure /etc/config/wireless:

config wifi-device  wifi0
        option type     atheros
        option channel  11

config wifi-iface
        option device   wifi0
#       option network  lan
        option mode     ap
        option ssid     www.personaltelco.net/repeater
        option hidden   0
        option encryption none

disable firewall script:
- ```
rm /etc/rc.d/S45firewall
```

modify the lan stanza in /etc/config/network:

#### LAN configuration
config interface lan
        option type     bridge
        option ifname   "eth0.0 ath0"
        option proto    static
        option ipaddr   192.168.3.1
        option netmask  255.255.255.0

add a file /etc/init.d/repeater:

cat > /etc/init.d/repeater <<EOF
#!/bin/sh

echo "Initializing Repeater"

/sbin/ifconfig wlan0 up
/usr/sbin/iwconfig wlan0 essid www.personaltelco.net
while /usr/sbin/iwconfig wlan0 2>/dev/null | grep Access | awk '{ print $5 }' | grep 00:00:00:00:00:00 ; do sleep 1 ; done
/sbin/udhcpc -i wlan0
/usr/sbin/iptables -t nat -A POSTROUTING -o wlan0 -j MASQUERADE
EOF
chmod 755 /etc/init.d/repeater

create a link in /etc/rc.d:

cd /etc/rc.d
ln -s /etc/init.d/repeater S90repeater

turn of wan stanza's dhcp in /etc/config/network:

#### WAN configuration
config interface        wan
        option ifname   "eth0.1"
        option proto    none

-  ← Revision 6 as of 2006-05-29 20:10:20 →
  Size: 4979
  Editor: RussellSenior
  Comment: added a few details
+  ← Revision 12 as of 2007-01-17 17:06:03 →
  Size: 2631
  Editor: RussellSenior
  Comment: sync up instructions with latest build, remove old stuff
-Deletions are marked like this.
+Additions are marked like this.
 Line 1:
-The MississippiNetworkRepeater is a NetgearWgt634u loaded with OpenWGT v0.06 and some custom modules built by JasonMcArthur.  It uses a HawkingHwu54g USB 802.11g radio as a client to any nearby www.personaltelco.net network and operates its native radio as a local coverage access point.
+The MississippiNetworkRepeater is a NetgearWgt634u loaded with OpenWRT.  It uses a HawkingHwu54g USB 802.11g radio as a client to any nearby www.personaltelco.net network and operates its native radio as a local coverage access point.
 Line 5:
-The current methodology for building one of the devices is as follows:
+To build one of the devices:
 Line 7:
- * load OpenWGT in a normal fashion, either via serial console or via the Netgear web interface
+ * load OpenWrt Kamikaze (here r6007) in a normal fashion, via serial console:
 Line 10:
-CFE> flash -noheader 192.168.0.3:wgt634u/wipe-1.img flash0.os

CFE> flash -noheader -offset=3932160 192.168.0.3:wgt634u/wipe-2.img flash0.os

CFE> flash -noheader 192.168.0.3:wgt634u/openwgt-0.06.img flash0.os
+CFE> flash -noheader 192.168.0.5:wgt634u/wipe-1.img flash0.os

CFE> flash -noheader -offset=3932160 192.168.0.5:wgt634u/wipe-2.img flash0.os

CFE> flash -noheader 192.168.0.5:wgt634u/openwrt-wgt634u-2.6-jffs2-r6007.bin flash0.os
 Line 16:
- * log into the AP 

 * configure network, e.g.:

   {{{ 

ifconfig vlan0 192.168.0.x up

ip route add default via 192.168.0.1

vi /etc/resolv.conf
+ * log into the AP via serial console



 * set root password:

   {{{

passwd
-Line 24:
+Line 23:
- * wget three ipkg's from [http://downloads.openwrt.org/whiterussian/packages/ openwrt's whiterussian repository] to /tmp: 

   * [http://downloads.openwrt.org/whiterussian/packages/rsync_2.6.5-0_mipsel.ipk rsync]

   * [http://downloads.openwrt.org/whiterussian/packages/libpopt_1.7-4_mipsel.ipk libpopt]

   * [http://downloads.openwrt.org/whiterussian/packages/uclibc_0.9.27-8_mipsel.ipk uclibc]

 * remount the flash read-write: 

   {{{ 

remount-rootfs.sh rw

}}}

 * install the packages:
+ * configure /etc/ipkg.conf to point at a compatible package archive:
-Line 34:
+Line 25:
-ipkg install rsync_2.6.5-0_mipsel.ipk

ipkg install libpopt_1.7-4_mipsel.ipk

ipkg install uclibc_0.9.27-8_mipsel.ipk 

}}}

 * ssh to the host where the repeater rootfs lives (to initialize the hostkey), if necessary: 

   {{{ 

ssh root@192.168.0.3 

}}}

 * rsync from a copy of the repeater rootfs, e.g.:

   {{{ 

rsync -v -a -H -x --delete root@192.168.0.3:/src/repeater-rootfs/ / 

}}}

 * reboot 



== Testing ==



To test, plug in the HawkingHwu54g radio, either directly or via a USB extension cable (up to 15 feet long, or even further using powered hubs).  Place the HawkingHwu54g where the best {{{www.personaltelco.net}}} signal is available.  Place the NetgearWgt634u where convenient and it provides good local coverage.  Power up the NetgearWgt634u and, after 15-30 seconds, associate your client device to {{{www.personaltelco.net/repeater}}}.  You should receive an address via DHCP in the 192.168.3.0/24 network.  Try loading a web page with your client device and click through the splash page.  Try pinging {{{4.2.2.2}}} and {{{www.google.com}}}.



== Feedback ==



The MississippiNetworkRepeater is in a testing phase.  If you encounter problems or to provide positive or negative feedback, please contact RussellSenior.  Thanks!



== FIXME ==



Need to package up a tarball of the repeater-rootfs.



== OpenWrt Version ==



Experimenting with an OpenWrt-based version of the repeater, aiming for inclusion of the zd1211rw driver.



To build one of the devices:



 * load OpenWrt Kamikaze in a normal fashion, via serial console:

   {{{

CFE> ifconfig eth0 -auto

CFE> flash -noheader 192.168.0.3:wgt634u/wipe-1.img flash0.os

CFE> flash -noheader -offset=3932160 192.168.0.3:wgt634u/wipe-2.img flash0.os

CFE> flash -noheader 192.168.0.3:wgt634u/openwrt-wgt634u-2.6-squashfs-r3794.bin flash0.os

CFE> reboot
+src snapshots http://www.personaltelco.net/~russell/openwrt/r6007/packages

dest root /

dest ram /tmp
-Line 75:
+Line 30:
- * log into the AP 



 * install USB modules:
+ * install zd1211 packages:
-Line 79:
+Line 32:
-cd /tmp

scp 192.168.0.4:/src/kamikaze4/trunk/openwrt/bin/packages/kmod-usb-core_2.6.16.7-brcm-1_mipsel.ipk .

scp 192.168.0.4:/src/kamikaze4/trunk/openwrt/bin/packages/kmod-usb2_2.6.16.7-brcm-1_mipsel.ipk .

scp 192.168.0.4:/src/kamikaze4/trunk/openwrt/bin/packages/kmod-zd1211_2.6.16.7+r69-brcm-1_mipsel.ipk .

ipkg install kmod-usb-core_2.6.16.7-brcm-1_mipsel.ipk

ipkg install kmod-usb2_2.6.16.7-brcm-1_mipsel.ipk

ipkg install kmod-zd1211_2.6.16.7+r69-brcm-1_mipsel.ipk
+ipkg install kmod-usb2

ipkg install kmod-zd1211
-Line 88:
+Line 36:
- * change root password
+ * install iproute2 tools because I like them:
-Line 90:
+Line 38:
-passwd
+ipkg install ip
-Line 93:
+Line 41:
- * modify /etc/modules.d

  * remove encryption modules from 20-madwifi

    {{{

cd /etc/modules.d

rm 20-madwifi

cp /rom/etc/modules.d/20-madwifi .

vi 20-madwifi
+ * configure /etc/config/wireless:

   {{{

config wifi-device  wifi0

        option type     atheros

        option channel  11



config wifi-iface

        option device   wifi0

#       option network  lan

        option mode     ap

        option ssid     www.personaltelco.net/repeater

        option hidden   0

        option encryption none
-Line 102:
+Line 56:
-  * add a file for zd1211:

    {{{

cat > /etc/modules.d/70-zd1211 <<EOF

zd1211

EOF
+ * disable firewall script:

   {{{

rm /etc/rc.d/S45firewall
-Line 109:
+Line 61:
- * modify /etc/init.d

  * add some lines to S20madwifi:

    {{{

cd /etc/init.d

rm S20madwifi

cp /rom/etc/init.d/S20madwifi .

cat >> S20madwifi <<EOF



iwconfig ath0 essid www.personaltelco.net/repeater

iwconfig ath0 channel 11

EOF
+ * modify the lan stanza in /etc/config/network:

   {{{

#### LAN configuration

config interface lan

        option type     bridge

        option ifname   "eth0.0 ath0"

        option proto    static

        option ipaddr   192.168.3.1

        option netmask  255.255.255.0
-Line 122:
+Line 72:
-  * remove S45firewall
+ * add a file /etc/init.d/repeater:
-Line 124:
+Line 74:
-rm /etc/init.d/S45firewall

}}}

  * add a file S90repeater:

    {{{

cat > /etc/init.d/S90repeater <<EOF
+cat > /etc/init.d/repeater <<EOF
-Line 139:
+Line 85:
-chmod 755 /etc/init.d/S90repeater
+chmod 755 /etc/init.d/repeater
-Line 142:
+Line 88:
-  * Modify /etc/config/network to:

    {{{

lan_ipaddr="192.168.3.1"

wan_proto=none
+ * create a link in /etc/rc.d:

   {{{

cd /etc/rc.d

ln -s /etc/init.d/repeater S90repeater
-Line 147:
+Line 93:
+ * turn of wan stanza's dhcp in /etc/config/network:

   {{{

#### WAN configuration

config interface        wan

        option ifname   "eth0.1"

        option proto    none

}}}