Projecte

General

Perfil

Start » Historial » Versió 21

Pau Escrich, 27-02-2012 15:26

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
9
* It is firmware for embedded network devices based on OpenWRT GNU/linux operating system
10
* 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
* It is a fast and reliable way to extend an Internet uplink to end-users
12
13
h2. Why?
14
15
Two main purposes:
16
17 6 Pau Escrich
* *For quick deployments*
18
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
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
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
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
h2. How?
26
27
* Providing a complete autoconfiguration system from the first boot
28
* Using a set of Layer 3 MESH protocols: BMX6 (main), OLSR6 and Babel as backup
29
* Using IPv6 as the main IP protocol
30
* Using IPv4 only for end-user connection (tunneling)
31
* Providing an easy and intuitive administration web interface (LuCI based)
32
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
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
h2. Features
39 6 Pau Escrich
40
# *autoconf:* A system to auto-configure all settings. So the user does not need to configure anything.
41
# *qmpinfo:* It is a tool written in Lua to get some information about the QMP system.
42
# *qmpcontrol:* It is a tool written as a shell script to manage the QMP system.
43
# *qMp webint:* A LUCI (web interface) module to manage and monitor QMP system.
44
# *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
# *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
49 19 Pau Escrich
h3. Binary files
50 20 Pau Escrich
51 19 Pau Escrich
Just go to http://fw.qmp.cat to find the binary files ready to install in your device.
52 20 Pau Escrich
53 19 Pau Escrich
54
h3. From Source (recomended)
55
56 7 Pau Escrich
Get the code using wget
57 1 Pau Escrich
58 11 Pau Escrich
<code class="bash">wget -c -q -O - "http://qmp.cat/gitrevision_download?project_id=7&rev=anonymous" | tar zxvf -</code>
59
60 1 Pau Escrich
Or get the code using git
61
62 11 Pau Escrich
<code class="bash">git clone git://qmp.cat/qmpfw.git qmpfw</code>
63
64 1 Pau Escrich
Then enter to diectory
65 7 Pau Escrich
66 11 Pau Escrich
<code class="bash">cd qmpfw</code>
67
68 1 Pau Escrich
And compile it
69
70 11 Pau Escrich
<code class="bash">make T=alix build</code>
71
72 7 Pau Escrich
You can find available targets executing
73 11 Pau Escrich
74
<code class="bash">make list_targets</code>
75 7 Pau Escrich
76
After that, you will find the images ready to install in your devices inside directory images/
77
78 21 Pau Escrich
h2. Use the firmware
79
80
By default the network interfaces from your device are used for the next pourposes (if some of them missing, it is just ignored):
81
82
* eth0 LAN with DHCP server and IP 172.30.22.1
83
* eth1 WAN with DHCP client running (you can connect it to internet)
84
* wlan0 MESH & ADHOC Routing daemons running using IPv6
85
* wlan1 LAN & AP DHCP server and IP 172.30.22.1
86
* wlan2 MESH & ADHOC Routing daemons running using IPv6
87
88
So you can access to it connection your computer to eth0 or wlan1. Access via web browser to http://172.30.22.1 using default login:
89
90
* user: root
91
* password: 13f
92
93 1 Pau Escrich
h2. Contributions
94
95 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.
96 10 Pau Escrich
97
h2. Contact
98
99
* e-mail: info_at_qmp.cat
100
* Users mailing list: https://mail.qmp.cat/cgi-bin/mailman/listinfo/qmp-users
101
* Developers mailing list: https://mail.qmp.cat/cgi-bin/mailman/listinfo/qmp-dev
102
103
<pre>             
104
                 __ _  /\/\  _ __  
105
                / _` |/    \| '_ \ 
106
               | (_| / /\/\ \ |_) |
107
                \__, \/    \/ .__/ 
108
                   |_|      |_|    
109
                                   
110
                 quick MESH project
111
</pre>