Browse Source

Recommended book

Bob Mottram 9 years ago
parent
commit
33c407fad4
2 changed files with 42 additions and 29 deletions
  1. 3
    1
      doc/EN/mesh.org
  2. 39
    28
      website/EN/mesh.html

+ 3
- 1
doc/EN/mesh.org View File

@@ -8,7 +8,7 @@
8 8
 [[./images/logo.png]]
9 9
 #+END_CENTER
10 10
 
11
-| [[What is a mesh network?]] | [[The Freedombone Mesh]] | [[Installation]] | [[Wifi adaptors]] | [[Using the mesh]] |
11
+| [[What is a mesh network?]] | [[The Freedombone Mesh]] | [[Installation]] | [[Wifi adaptors]] | [[Using the mesh]] | [[Further reading]] |
12 12
 
13 13
 * What is a mesh network?
14 14
 The internet as it currently exists is mostly organised according to a client/server model. Servers run the web services and store the data and clients are the laptops, desktops and other devices accessing the servers. In a mesh network there isn't any clear division between clients and servers. The computers on a mesh network are known as "peers" and they can perform the functions of both clients and servers. Commonly this is also known as a "peer to peer" network.
@@ -157,3 +157,5 @@ sudo batman stop
157 157
 #+END_SRC
158 158
 
159 159
 After a few seconds your usual internet wifi connection should be re-established.
160
+* Further reading
161
+For much more extensive details about deploying wireless networks there is an excellent book called [[http://wndw.net][Wireless Networking in the Developing World]] which is worth reading. It's not necessarily exclusively about mesh networks, but may be useful in terms of advice about antennas, reflections, extending wifi range and so on.

+ 39
- 28
website/EN/mesh.html View File

@@ -4,7 +4,7 @@
4 4
 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
5 5
 <head>
6 6
 <title></title>
7
-<!-- 2015-09-05 Sat 14:12 -->
7
+<!-- 2015-09-05 Sat 14:34 -->
8 8
 <meta  http-equiv="Content-Type" content="text/html;charset=utf-8" />
9 9
 <meta  name="generator" content="Org-mode" />
10 10
 <meta  name="author" content="Bob Mottram" />
@@ -175,6 +175,8 @@ for the JavaScript code in this tag.
175 175
 <col  class="org-left" />
176 176
 
177 177
 <col  class="org-left" />
178
+
179
+<col  class="org-left" />
178 180
 </colgroup>
179 181
 <tbody>
180 182
 <tr>
@@ -183,6 +185,7 @@ for the JavaScript code in this tag.
183 185
 <td class="org-left"><a href="#orgheadline3">Installation</a></td>
184 186
 <td class="org-left"><a href="#orgheadline4">Wifi adaptors</a></td>
185 187
 <td class="org-left"><a href="#orgheadline5">Using the mesh</a></td>
188
+<td class="org-left"><a href="#orgheadline6">Further reading</a></td>
186 189
 </tr>
187 190
 </tbody>
188 191
 </table>
@@ -232,9 +235,9 @@ The Freedombone mesh is offline - in the sense of not being part of the larger i
232 235
 <div id="outline-container-orgheadline3" class="outline-2">
233 236
 <h2 id="orgheadline3">Installation</h2>
234 237
 <div class="outline-text-2" id="text-orgheadline3">
235
-</div><div id="outline-container-orgheadline6" class="outline-3">
236
-<h3 id="orgheadline6">Two types of system</h3>
237
-<div class="outline-text-3" id="text-orgheadline6">
238
+</div><div id="outline-container-orgheadline7" class="outline-3">
239
+<h3 id="orgheadline7">Two types of system</h3>
240
+<div class="outline-text-3" id="text-orgheadline7">
238 241
 <p>
239 242
 Installation is split into two categories, <i>routers</i> and <i>user devices</i>.
240 243
 </p>
@@ -252,9 +255,9 @@ Small computers acting as mesh routers can also be battery operated or solar pow
252 255
 </p>
253 256
 </div>
254 257
 </div>
255
-<div id="outline-container-orgheadline7" class="outline-3">
256
-<h3 id="orgheadline7">Installing on routers</h3>
257
-<div class="outline-text-3" id="text-orgheadline7">
258
+<div id="outline-container-orgheadline8" class="outline-3">
259
+<h3 id="orgheadline8">Installing on routers</h3>
260
+<div class="outline-text-3" id="text-orgheadline8">
258 261
 <p>
259 262
 Whatever system you're going to use as a mesh router should have a new Debian Jessie install on it. It's advisable that this be a new install so that there is no existing software on the system which could confuse the mesh install process. Connect your system to your internet router with an ethernet cable, then ssh into it and type:
260 263
 </p>
@@ -304,9 +307,9 @@ The reboot is needed in order to enable zram and the hardware random number gene
304 307
 </p>
305 308
 </div>
306 309
 </div>
307
-<div id="outline-container-orgheadline8" class="outline-3">
308
-<h3 id="orgheadline8">Installing on user devices</h3>
309
-<div class="outline-text-3" id="text-orgheadline8">
310
+<div id="outline-container-orgheadline9" class="outline-3">
311
+<h3 id="orgheadline9">Installing on user devices</h3>
312
+<div class="outline-text-3" id="text-orgheadline9">
310 313
 <p>
311 314
 Typically on a laptop with a Debian-based distro installed, open a terminal and type:
312 315
 </p>
@@ -347,9 +350,9 @@ sudo dpkg -i batctl_2014.1.0-2_amd64.deb
347 350
 There are a small number of wifi adaptors which are compatible with a fully free software stack.
348 351
 </p>
349 352
 </div>
350
-<div id="outline-container-orgheadline9" class="outline-3">
351
-<h3 id="orgheadline9">Atheros AR9271</h3>
352
-<div class="outline-text-3" id="text-orgheadline9">
353
+<div id="outline-container-orgheadline10" class="outline-3">
354
+<h3 id="orgheadline10">Atheros AR9271</h3>
355
+<div class="outline-text-3" id="text-orgheadline10">
353 356
 <p>
354 357
 To install the firmware for this:
355 358
 </p>
@@ -370,9 +373,9 @@ mv *.fw /lib/firmware
370 373
 <div id="outline-container-orgheadline5" class="outline-2">
371 374
 <h2 id="orgheadline5">Using the mesh</h2>
372 375
 <div class="outline-text-2" id="text-orgheadline5">
373
-</div><div id="outline-container-orgheadline10" class="outline-3">
374
-<h3 id="orgheadline10">Switching from internet to mesh mode</h3>
375
-<div class="outline-text-3" id="text-orgheadline10">
376
+</div><div id="outline-container-orgheadline11" class="outline-3">
377
+<h3 id="orgheadline11">Switching from internet to mesh mode</h3>
378
+<div class="outline-text-3" id="text-orgheadline11">
376 379
 <p>
377 380
 To join the mesh network open a terminal and type:
378 381
 </p>
@@ -392,9 +395,9 @@ A web page should appear in your browser, which then allows you to access commun
392 395
 </p>
393 396
 </div>
394 397
 </div>
395
-<div id="outline-container-orgheadline11" class="outline-3">
396
-<h3 id="orgheadline11">Chat</h3>
397
-<div class="outline-text-3" id="text-orgheadline11">
398
+<div id="outline-container-orgheadline12" class="outline-3">
399
+<h3 id="orgheadline12">Chat</h3>
400
+<div class="outline-text-3" id="text-orgheadline12">
398 401
 <p>
399 402
 If you have a Tox client installed on your system then you can use that to communicate with other mesh peers. A limitation is that if peers change you may need to quit the application and restart it in order to receive the updated list of DHTnodes. The <a href="https://github.com/Tox/toxic">Toxic</a> client is installed by default, but you may also want to install <a href="https://github.com/tux3/qTox">qTox</a> or <a href="http://utox.org/">uTox</a> for a more conventional-looking user experience.
400 403
 </p>
@@ -437,9 +440,9 @@ A note for the security-conscious is that broadcasting Tox IDs via the network (
437 440
 </p>
438 441
 </div>
439 442
 </div>
440
-<div id="outline-container-orgheadline12" class="outline-3">
441
-<h3 id="orgheadline12">Blogging</h3>
442
-<div class="outline-text-3" id="text-orgheadline12">
443
+<div id="outline-container-orgheadline13" class="outline-3">
444
+<h3 id="orgheadline13">Blogging</h3>
445
+<div class="outline-text-3" id="text-orgheadline13">
443 446
 <p>
444 447
 The Freedombone mesh uses a fully decentralized blogging system called <a href="https://github.com/HelloZeroNet/ZeroBlog">ZeroBlog</a>. It behaves rather like other peer-to-peer file sharing systems in that if you are reading the blog of another user you are also simultaneously seeding it to other peers (acting as both a client and a server). This allows the system to scale well, while also being robust to any peer failing or leaving the network.
445 448
 </p>
@@ -457,17 +460,17 @@ To add a new blog entry click the <i>new post</i> button, edit the title and con
457 460
 </p>
458 461
 </div>
459 462
 </div>
460
-<div id="outline-container-orgheadline13" class="outline-3">
461
-<h3 id="orgheadline13">Other services</h3>
462
-<div class="outline-text-3" id="text-orgheadline13">
463
+<div id="outline-container-orgheadline14" class="outline-3">
464
+<h3 id="orgheadline14">Other services</h3>
465
+<div class="outline-text-3" id="text-orgheadline14">
463 466
 <p>
464 467
 It is hoped that a decentralized forum will be added, but this is not yet complete. In the mean time a substitute is to use the Tox group chat feature.
465 468
 </p>
466 469
 </div>
467 470
 </div>
468
-<div id="outline-container-orgheadline14" class="outline-3">
469
-<h3 id="orgheadline14">Turing off the mesh</h3>
470
-<div class="outline-text-3" id="text-orgheadline14">
471
+<div id="outline-container-orgheadline15" class="outline-3">
472
+<h3 id="orgheadline15">Turing off the mesh</h3>
473
+<div class="outline-text-3" id="text-orgheadline15">
471 474
 <p>
472 475
 If you wish to return to the internet then open a terminal and type:
473 476
 </p>
@@ -484,6 +487,14 @@ After a few seconds your usual internet wifi connection should be re-established
484 487
 </div>
485 488
 </div>
486 489
 </div>
490
+<div id="outline-container-orgheadline6" class="outline-2">
491
+<h2 id="orgheadline6">Further reading</h2>
492
+<div class="outline-text-2" id="text-orgheadline6">
493
+<p>
494
+For much more extensive details about deploying wireless networks there is an excellent book called <a href="http://wndw.net/">Wireless Networking in the Developing World</a> which is worth reading. It's not necessarily exclusively about mesh networks, but may be useful in terms of advice about antennas, reflections, extending wifi range and so on.
495
+</p>
496
+</div>
497
+</div>
487 498
 </div>
488 499
 <div id="postamble" class="status">
489 500