<a href="content/down/muddy-0.4.beta-30-6-07.tar.gz"><img src="images/logos/muddy.png" alt="muddy linux logo" border="0" align="right"></a>
<p>A small linux distro, developed from pebble linux for New Your Wireless, designed to be booted from a 128 Meg CF card.</p>
<p>This was used for at least 2 years to run PierToPier.net's seafront wifi network in brighton. Put in an apearance at the Glade festival.</P>
<p>ultimatly its just tweaked Pebble linux, however its does have some differences.</P>
<ul>
  <li> Newer kernel (USB webcam support ov511 and stv680) </li>
  <li>New hostap driver </li>
  <li>SNMPD</li>
  <li> netcat</li>
  <li> Chillispot instead of nocat, (and bits it needs to run)</li>
</ul>
 <h3>DOWNLOAD</h3>
 <p><a href="content/down/muddy-0.4.beta-30-6-07.tar.gz">muddy 0.4 beta </a></p>
 <p>old versions might be on <a href="http://www.piertopier.net" target="_blank">piertopier.net's download page </a></p>
 <h3>Basics</h3>
 <p>It doesn't exactly &quot;Mesh&quot; but it comes close. As it was originally built the installer creates either a Gateway (wired connection to the internet) or a repeater. The repeater uses a static default route and uses OSPF to advertise the fact. The Repeater uses OSPF to find a default route.</p>
 <p>Both automatically build a bridge of WDS access points in range. This was a <strong>bad</strong>  idea. On first live test it built 12 WDS links to god knows what. The auto wds function should be turned of!</p>
 <p>Both gateway and repeater service clients via the <a href="http://www.chillispot.org" target="_blank">chillispot</a> captive portal system </p>
 <p>Here's the Out of Date Readme..... </p>
 <h3>README</h3>
 <div class="blog">
 <div class="code">
   <p>PierToPier.net &ldquo;Muddy&rdquo; Pebble Notes.<br />
     By Tom Griffiths, with help from Chris Wilson, Dave Phelan and Ben PierToPier.net 2006 GNU License V2 and all that.</p>
   <p>What is &ldquo;Muddy&rdquo;? <br />
     Its just our customized version of Pebble linux (NY Wireless http://www.nycwireless.net/pebble)</p>
   <p>Where Can I get it? <br />
     Probably on our Wiki.(wiki.piertopier.net)</p>
   <p>What do I need to run it,<br />
     Dunno 486 with a few meg of ram and a 128 meg flash card. To make it WDS with stuff you need a PRISM II based wifi card, and you need to flash its station firmware to greater than 5.6.(see http://linux.junsun.net/intersil-prism/)</p>
   <p>How do I install it?<br />
     Same way you install pebble, from linux. Windows users dunno, virtual machine?<br />
     tar -xvzf muddy-0.1.tar.gz to extract it<br />
     change dir to where ever you extracted it and type &ldquo;./muddy.update&rdquo;<br />
     Follow the instructions, If your running MiniITX, then use option 1, this loads hostap_pci and via-rhine drivers. Option 2 loads via-rhine, ath_pci and hostap_pci drivers option three loads every net driver I could think of for generic PC's.</p>
   <p>How Does muddy differ from Pebble?<br />
     Its got more bits principally<br />
     SNMPD<br />
     netcat<br />
     Chillispot instead of nocat, (and bits it needs to run)<br />
     p2pcheckin scripts.<br />
     customized wds scripts / networking scripts. principally /etc/init.d/bridge (by me) and /etc/init.d/wds (from Sown http://www.sown.org.uk/)<br />
     extra /dev/ entry for the tun interface.</p>
   <p>How does it work.<br />
     Depending how you configure it, it fires up the wireless card and automatically creates WDS links to any (change this using the /etc/network/wds config file) accesspoint on its channel.<br />
     Then it builds a bridge, of wlan0 and any WDS devices in range. Then uses zebra/OSPF (/etc/zebra/ospfd.conf and zebra.conf) to build its routes, if its got a wired Internet connection zebra sets that as the default route, then OSPF advatises that node as a gateway to other WDS links. If zebra isn't set with a default route OFPF will find one off another WDS links. Bridges are running STP (spanning tree protocol) to stop bridge loops.<br />
     Finally it starts up chillispot and authentication system, radius client/nas, dhcp captive portal. This creates a tun0 interface and services clients off it.<br />
     There's a firewall (/etc/init.d/firewall), basically the one supplied with chillispot. Does nat etc.</p>
   <p>No really how does it work, whats a tun interface? why wouldn't I want a Bridge loop?<br />
     F***ed if I know I'm a physics laboratory technician for 16 to 18 year olds, not an expert. </p>
   <p>What do I need to change?<br />
     Not Much the Installer should set it all up ready to go. However the following have been tweaked by and if you gwet stuck have a go at them.<br />
     /etc/modules &ndash; hardware, if you chose the right install option, you shouldn't need to change this, this is what drivers are loaded on boot. (ath_pci for atheros &ndash; no WDS at present)<br />
     /etc/network/interfaces &ndash; network cards config (note wifi interface ip is overridden by the bridge its a backup) specifiy the ssid etc here.<br />
     /etc/network/wds &ndash; wds configuration<br />
     /etc/init.d/bridge &ndash; wireless bridge configuration and management script<br />
     /etc/zebra/zebra.conf make sure it matches /etc/network/interfaces. If gateway add default route here.<br />
     /etc/zebra/ospfd.conf if gateway uncomment default information-origninate, so it tells WDS devices its a gateway. otherwise should match /etc/network/interfaces configuration.<br />
     /etc/hosts. WARNING chillispot will NOT start unless it can resolve any domain names in its config file. Since OSPF takes a while to find a default route make sure any domain used in chilli.conf are in here.<br />
     /etc/init.d/chilli.conf captive portal configuration, you can use chillispot's radius and splash for practice (http://www.chillispot.org).<br />
     Choose your firewall configuration, /etc/init.d/firewall for a gateway, firewall.repeater for a repeater.<br />
     some of the settings the isntall make us are piertopier.net specific. If you want to change the INSTALLER settings then edit the files in /sample. Leave the phrases like &quot;REPLACEWITHNODENO&quot; and simailr as they are used by the installer.</p>
   <p>Sounds great does it work?<br />
     Sort of. Things I know are broken:<br />
     Repeater Firewall doesn't actually work &ndash; I'm no good at iptables. Just turn it off and chilli off and the central gateway will splash 'em, I got this to work on OpenWRT<br />
     cron runs &quot;/etc/init.d/bridge rebuild&rdquo; to create and add/remove new/lost WDS links to/from the wireless bridge. I use static WDS declaration in /etc/network/wds anyway. Its wds'ing is a bit virulent. It will WDS with anything. First time I tried it gave me an ip off a neighboring meashap box!.</p>
   <p>How secure is it?<br />
     Not at all, what do I know I clean test-tubes for a living? OK anything with an IP on the backhaul net (i.e. NOT DHCP'd from chillispot) can access the Internet. All you have to do is assign yourself a free IP on this net and your free to go. This is partly deliberate, its in development &ndash; I Need it for when I screw up. Ultimately some sort of ip tunnel for backhaul instead is wise... I don't do ipsec....</p>
   <p>Why do it this way?<br />
     Errrrrrrr what is it with the difficult questions? BUT its compatible with OpenWRT (use PierToPier.net &ldquo;rusty&rdquo; and it will talk to a linksys WRT54G in WDS mode :-) which is cool.<br />
     Chillispot does radius accounting :-), which is really cool (stats.piertopier.net) we already had the hardware. MeshAP(www.locusworld.net) was driving me nuts, and it was the best I could do!</p>
   <p>BIG FAT WARNING.<br />
     Do not try this if your not competent at networking, linux, wifi and for gods skake don't try it near any sensitive people/equipment. <br />
   </p>
   </div>
 </div>
 <h3>RELEASE NOTES<br />
 </h3>
 <div class="blog">
   <div class="code">
     <p>Muddy Release Notes:<br />
Muddy Linux pre 0.3<br />
0.3 Release<br />
Firewall settings finally sorted, Chillispot runs on Repeater Nodes, OSPF decides wich gateway to use.<br />
Installer Sets up firewall for repeater/gateway.<br />
Webcam has been tested with 0.3<br />
WEBCAM MINI HOWTO<br />
apt-get update<br />
apt-get install vgrabbj<br />
edit /etc/vgrabbj.conf - warning so of these options will toast your card!<br />
you may need to create /dev/video<br />
Madwifi appears to be working<br />
Compatiblility testing:<br />
Muddy 0.3 has been tweaked to run on: EBX, MiniITX, old Celeron 366, IBM thinkpad 560. Every Prism2 card I can get my hands on works fine with this. Pretty sure that the CF ones will work too.</p>
     <p>BUGS:<br />
       Wireless tools package will NOT talk to Madwifing properly. I'm testing this before I put it in the build. apt-get isntall wireless tools seems to work.<br />
       Madwifi-ng crashes the kernel suprise suprise....<br />
       ------------------------------------------------------------------------<br />
       0.2 Release<br />
       New Kernel (2.4.27-muuddy 0.1), suport for v4l and usb webcams based on ov511 and stv60.<br />
       New hostap Driver, with firmware download suport.<br />
       New Madwifi drivers, moved over to the new Madwifi-ng driver.<br />
       Auto Prism2 firmware upgrade on boot /etc/init.d/firmware config in /etc/network/firmware selection of firmware in /usr/lib/firmware<br />
       Bridge Script improved. It functions as before however it DOES NOT require Its IP to be se manually anymore, it gets it from ifconfig. Its other settings have been moved to a config file /etc/network/bridge however its not expected that these will need to be changed (unless we go to atheros cards) <br />
       PCMCIA (well some) </p>
     <p>BUGS:<br />
       Missing wlanconfig prog for madwifi so anything bar client mode don't work - will probably be fixed before full release.<br />
       TMPFs much improved. ksmoops main culprit.<br />
       not expectign the zebra bug again, typeo in old configs I suspect.<br />
       PCMCIA alecs 16 bit thingy works my card bu one doesn't<br />
       Repeater Firewall</p>
     <p>------------------------------------------------------------------------<br />
       O.1 Release </p>
     <p>NEW THINGS:<br />
       /usr/sbin/logclean and its cron job. Don't tell Dave but p2pcheckin is more important than log data I can't understand. Its only mildy deleted once a day.<br />
       Icreased the size of /rw the tmpfs to 20 meg as all boxes have &gt;128 meg of ram. Untill the log thing is under control<br />
       Rmoved the link to the firewall. Needs to be put back ofr a gateway only (cd to /etc/rc2.d and ln -s ../init.d/firewall S99firewall<br />
       needs to be added for a gateway.<br />
       New isntaller, won't know if it works till after this is writern. I'm building this as arelease in case I've done somehting dumb and the script decimates the build dir.<br />
       better hardware support from the installer. (both the normal muddy.update and muddy.update.tom)<br />
       Hs M-E's DNS set this time.<br />
       ppcheckin has full path to urlencode now, which it seems to like<br />
     </p>
     <p>BUGS:<br />
       Still no smart repeater. Disable chilli on a repeater.<br />
       Runs out of tmfs which is irritating<br />
       deleting stuff from tmpfs doesn't seem to free up hd space WTF?<br />
       f you put an atheros card in for backhaul zebra goes bannans and starts assinging address to lo not wlan0 which is annoying.     </p>
     <p><br />
     </p>
   </div>
 </div>