Start
Version 18 (Pau Escrich, 01/23/2012 11:31 am)
| 1 | 15 | Pau Escrich | !http://qmp.cat/images/qmp_small.png! |
|---|---|---|---|
| 2 | 1 | Pau Escrich | |
| 3 | 17 | Pau Escrich | -------------------------------------------------------------------------------------------------------------------------- |
| 4 | 18 | Pau Escrich | |
| 5 | 17 | Pau Escrich | [[Inici|Catalan Version]] |
| 6 | 13 | Pau Escrich | |
| 7 | 1 | Pau Escrich | h2. What is qMp? |
| 8 | 1 | Pau Escrich | |
| 9 | 1 | Pau Escrich | * It is firmware for embedded network devices based on OpenWRT GNU/linux operating system |
| 10 | 1 | Pau Escrich | * It provides an easy way to set up networks using MESH it doesn't matter your they are either wired or WiFi or a mix of both |
| 11 | 1 | Pau Escrich | * It is a fast and reliable way to extend an Internet uplink to end-users |
| 12 | 1 | Pau Escrich | |
| 13 | 1 | Pau Escrich | h2. Why? |
| 14 | 1 | Pau Escrich | |
| 15 | 1 | Pau Escrich | Two main purposes: |
| 16 | 1 | Pau Escrich | |
| 17 | 6 | Pau Escrich | * *For quick deployments* |
| 18 | 6 | Pau Escrich | There's no need to think about network topology, all you need to do is to spread the nodes and connect one to internet. |
| 19 | 6 | Pau Escrich | Use it in any kind of environments like concerts, meetings, demonstrations or in case of a natural disaster. |
| 20 | 1 | Pau Escrich | |
| 21 | 6 | Pau Escrich | * *For the wireless communities* |
| 22 | 6 | Pau Escrich | If you are new into this all you need to become part of the existing community or to start building one is to download and install the firmware. It won't take you more than the time you need to take a coffee to have your node ready to be put in place. |
| 23 | 6 | Pau Escrich | But if you are already an old hands at wireless communities here is qMp to let you forget about all those weird network administration tricks that don't last more than a day in your mind and focus on what makes your community grow, that is, the nodes deployment. |
| 24 | 1 | Pau Escrich | |
| 25 | 1 | Pau Escrich | h2. How? |
| 26 | 1 | Pau Escrich | |
| 27 | 1 | Pau Escrich | * Providing a complete autoconfiguration system from the first boot |
| 28 | 1 | Pau Escrich | * Using a set of Layer 3 MESH protocols: BMX6 (main), OLSR6 and Babel as backup |
| 29 | 1 | Pau Escrich | * Using IPv6 as the main IP protocol |
| 30 | 1 | Pau Escrich | * Using IPv4 only for end-user connection (tunneling) |
| 31 | 1 | Pau Escrich | * Providing an easy and intuitive administration web interface (LuCI based) |
| 32 | 1 | Pau Escrich | |
| 33 | 12 | Pau Escrich | h2. Devices |
| 34 | 1 | Pau Escrich | |
| 35 | 6 | Pau Escrich | Currently the official supported devices are: Alix, Routerstation, RouterstationPro, NanoStation/Nanobridge/Airgrid M5/M2 |
| 36 | 6 | Pau Escrich | But qMp is Free software, so if it doesn't perfectly suits for you all you need to do is to modify it and send us your patches to let us apply them. |
| 37 | 1 | Pau Escrich | |
| 38 | 1 | Pau Escrich | h2. Features |
| 39 | 6 | Pau Escrich | |
| 40 | 6 | Pau Escrich | # *autoconf:* A system to auto-configure all settings. So the user does not need to configure anything. |
| 41 | 6 | Pau Escrich | # *qmpinfo:* It is a tool written in Lua to get some information about the QMP system. |
| 42 | 6 | Pau Escrich | # *qmpcontrol:* It is a tool written as a shell script to manage the QMP system. |
| 43 | 6 | Pau Escrich | # *qMp webint:* A LUCI (web interface) module to manage and monitor QMP system. |
| 44 | 6 | Pau Escrich | # *map:* A map tool (named b6m and written in Shell Scripting using OpenStreetMaps) to see the position of all network nodes and how are they connected. |
| 45 | 6 | Pau Escrich | # *internet detect:* A tool (named gwck) written in Shell Script which is monitoring if the node is connected to internet, in this case it modifies all needed things to share it with the whole network. |
| 46 | 1 | Pau Escrich | |
| 47 | 7 | Pau Escrich | h2. Get the firmware |
| 48 | 7 | Pau Escrich | |
| 49 | 7 | Pau Escrich | Get the code using wget |
| 50 | 1 | Pau Escrich | |
| 51 | 11 | Pau Escrich | <code class="bash">wget -c -q -O - "http://qmp.cat/gitrevision_download?project_id=7&rev=anonymous" | tar zxvf -</code> |
| 52 | 11 | Pau Escrich | |
| 53 | 1 | Pau Escrich | Or get the code using git |
| 54 | 1 | Pau Escrich | |
| 55 | 11 | Pau Escrich | <code class="bash">git clone git://qmp.cat/qmpfw.git qmpfw</code> |
| 56 | 11 | Pau Escrich | |
| 57 | 1 | Pau Escrich | Then enter to diectory |
| 58 | 7 | Pau Escrich | |
| 59 | 11 | Pau Escrich | <code class="bash">cd qmpfw</code> |
| 60 | 11 | Pau Escrich | |
| 61 | 1 | Pau Escrich | And compile it |
| 62 | 1 | Pau Escrich | |
| 63 | 11 | Pau Escrich | <code class="bash">make T=alix build</code> |
| 64 | 11 | Pau Escrich | |
| 65 | 7 | Pau Escrich | You can find available targets executing |
| 66 | 11 | Pau Escrich | |
| 67 | 11 | Pau Escrich | <code class="bash">make list_targets</code> |
| 68 | 7 | Pau Escrich | |
| 69 | 7 | Pau Escrich | After that, you will find the images ready to install in your devices inside directory images/ |
| 70 | 7 | Pau Escrich | |
| 71 | 1 | Pau Escrich | h2. Contributions |
| 72 | 1 | Pau Escrich | |
| 73 | 8 | Pau Escrich | The main part of this project has been freely contributed by a bunch of wireless enthusiast, but in the year 2011 it has been partially funded by Funació PuntCat. |
| 74 | 10 | Pau Escrich | |
| 75 | 10 | Pau Escrich | h2. Contact |
| 76 | 10 | Pau Escrich | |
| 77 | 10 | Pau Escrich | * e-mail: info_at_qmp.cat |
| 78 | 10 | Pau Escrich | * Users mailing list: https://mail.qmp.cat/cgi-bin/mailman/listinfo/qmp-users |
| 79 | 10 | Pau Escrich | * Developers mailing list: https://mail.qmp.cat/cgi-bin/mailman/listinfo/qmp-dev |
| 80 | 10 | Pau Escrich | |
| 81 | 10 | Pau Escrich | <pre> |
| 82 | 10 | Pau Escrich | __ _ /\/\ _ __ |
| 83 | 10 | Pau Escrich | / _` |/ \| '_ \ |
| 84 | 10 | Pau Escrich | | (_| / /\/\ \ |_) | |
| 85 | 10 | Pau Escrich | \__, \/ \/ .__/ |
| 86 | 10 | Pau Escrich | |_| |_| |
| 87 | 10 | Pau Escrich | |
| 88 | 10 | Pau Escrich | quick MESH project |
| 89 | 10 | Pau Escrich | </pre> |