free
/
freedombone
关注 1
点赞 0
派生 0
代码 工单 0 合并请求 0 版本发布 0 百科 动态
浏览代码

Mesh documentation

Bob Mottram 8 年前
父节点
e14c72b32a
当前提交
9b7a56f392
没有帐户链接到提交者的电子邮件
共有 10 个文件被更改，包括 129 次插入 和 58 次删除
合并视图 显示文件统计
  1. 34
    11
      doc/EN/mesh.org
  2. 二进制
      img/mesh_new_blog.jpg
  3. 二进制
      img/mesh_new_blog2.jpg
  4. 二进制
      img/mesh_paste_tox_id.jpg
  5. 二进制
      img/mesh_screenshot.jpg
  6. 二进制
      img/mesh_share_files.jpg
  7. 二进制
      img/mesh_text_chat.jpg
  8. 二进制
      img/mesh_view_blog.jpg
  9. 二进制
      img/mesh_visit_site.jpg
  10. 95
    47
      website/EN/mesh.html

+ 34
- 11
doc/EN/mesh.org 查看文件

32 
  - Private and public sharing of files
 32 
  - Private and public sharing of files
33 
  - Blogging
 33 
  - Blogging
34 
  - No network administration required
 34 
  - No network administration required
35 
-
36 
-Communication is local between systems within wifi range of each other. If systems are out of wifi range the data is mesh routed through intermediate peers.
37 
-
38 
-No servers, internet connection or cabling is needed.
39 
-
40 
-Works from bootable USB drives or microSD drives.
41 
-
42 
-Private communications is end-to-end secured with elliptic curve encryption and is forward secret. Not easy to censor or passively monitor.
43 
-
44 
-Publicly shared data is /content addressable/ and therefore scalable to many peers.
35 
+ - No servers, internet connection or cabling is needed.
36 
+ - Works from bootable USB drives or microSD drives.
37 
+ - Data is mesh routed between systems
38 
+ - Private communications is end-to-end secured and forward secret.
39 
+ - Publicly shared data is /content addressable/ and therefore scalable to many peers.
45
40
46 
 * Disk Images
 41 
 * Disk Images
47 
 ** Client images
 42 
 ** Client images
162 
 * How to use it
 157 
 * How to use it
163 
 When you first boot from the USB drive the system will create some encryption keys, assign a unique network address to the system and then reboot itself. When that's done you should see a prompt asking for a username. This username just makes it easy for others to initially find you on the mesh and will appear in the list of users.
 158 
 When you first boot from the USB drive the system will create some encryption keys, assign a unique network address to the system and then reboot itself. When that's done you should see a prompt asking for a username. This username just makes it easy for others to initially find you on the mesh and will appear in the list of users.
164
159
160 
+** Chat System
161 
+
165 
 Ensure that you're within wifi range of at least one other mesh peer (could be a router or client) and then you should see that the Tox chat and users icons appear. Select the users icon and you should see a list of users on the mesh. Select the Tox chat icon and once you are connected you should see the status light turn green. If after a few minutes you don't get the green status light then try closing and re-opening the Tox chat application. Select the plus button to add a friend and then copy and paste in a Tox ID from the users list.
 162 
 Ensure that you're within wifi range of at least one other mesh peer (could be a router or client) and then you should see that the Tox chat and users icons appear. Select the users icon and you should see a list of users on the mesh. Select the Tox chat icon and once you are connected you should see the status light turn green. If after a few minutes you don't get the green status light then try closing and re-opening the Tox chat application. Select the plus button to add a friend and then copy and paste in a Tox ID from the users list.
166
163
167 
 #+BEGIN_CENTER
 164 
 #+BEGIN_CENTER
188
185
189 
 One important point is that by default the microphone is turned off. When doing voice chat you can select the microphone volume with the drop down slider in the top right corner of the screen.
 186 
 One important point is that by default the microphone is turned off. When doing voice chat you can select the microphone volume with the drop down slider in the top right corner of the screen.
190
187
191 
-At present video doesn't work reliably, but text and voice chat do work well. In future IPFS or Tahoe-LAFS may be added to create a distributed filesystem for the mesh.
188 
+At present video doesn't work reliably, but text and voice chat do work well.
189 
+
190 
+** Sharing Files
191 
+You can make files publicly available on the network simply by dragging and dropping them into the /Public/ folder on the desktop. To view the files belonging to another user select the desktop icon called /Visit a site/ and enter the username or Tox ID of the other user.
192 
+
193 
+#+BEGIN_CENTER
194 
+[[file:images/mesh_share_files.jpg]]
195 
+#+END_CENTER
196 
+
197 
+** Blogging
198 
+To create a blog post select the /Blog/ icon on the desktop and then use the up and down cursor keys, space bar and enter key to add a new entry. Edit the title of the entry and add your text. You can also include photos if you wish - just copy them to the *CreateBlog/content/images* directory and then link to them as shown.
199 
+
200 
+#+BEGIN_CENTER
201 
+[[file:images/mesh_new_blog.jpg]]
202 
+#+END_CENTER
203 
+
204 
+To finish your blog entry just select /Save/ and then close the editor. On older hardware it may take a while to publish the results, and this depends upon the amount of computation needed by IPFS to create file hashes. If you make no changes to the default text then the new blog entry will not be saved.
205 
+
206 
+#+BEGIN_CENTER
207 
+[[file:images/mesh_new_blog2.jpg]]
208 
+#+END_CENTER
209 
+
210 
+#+BEGIN_CENTER
211 
+[[file:images/mesh_view_blog.jpg]]
212 
+#+END_CENTER
213 
+
214 
+You can also visit other blogs, edit or delete your previous entry and also change your blog theme.
192
215
193
216
194 
 #+BEGIN_CENTER
 217 
 #+BEGIN_CENTER

二进制
img/mesh_new_blog.jpg 查看文件


二进制
img/mesh_new_blog2.jpg 查看文件


二进制
img/mesh_paste_tox_id.jpg 查看文件


二进制
img/mesh_screenshot.jpg 查看文件


二进制
img/mesh_share_files.jpg 查看文件


二进制
img/mesh_text_chat.jpg 查看文件


二进制
img/mesh_view_blog.jpg 查看文件


二进制
img/mesh_visit_site.jpg 查看文件


+ 95
- 47
website/EN/mesh.html 查看文件

3 
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
 3 
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
4 
 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
 4 
 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
5 
 <head>
 5 
 <head>
6 
-<!-- 2016-09-09 Fri 20:10 -->
6 
+<!-- 2016-09-09 Fri 21:10 -->
7 
 <meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
 7 
 <meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
8 
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 8 
 <meta name="viewport" content="width=device-width, initial-scale=1" />
9 
 <title></title>
 9 
 <title></title>
272 
 </colgroup>
 272 
 </colgroup>
273 
 <tbody>
 273 
 <tbody>
274 
 <tr>
 274 
 <tr>
275 
-<td class="org-left"><a href="#org707c257">What the system can do</a></td>
275 
+<td class="org-left"><a href="#org4a254bc">What the system can do</a></td>
276 
 <td class="org-left">-</td>
 276 
 <td class="org-left">-</td>
277 
-<td class="org-left"><a href="#orgd00db33">Disk Images</a></td>
277 
+<td class="org-left"><a href="#orgced8804">Disk Images</a></td>
278 
 <td class="org-left">-</td>
 278 
 <td class="org-left">-</td>
279 
-<td class="org-left"><a href="#org0840eb8">Building Disk Images</a></td>
279 
+<td class="org-left"><a href="#org32e81f3">Building Disk Images</a></td>
280 
 <td class="org-left">-</td>
 280 
 <td class="org-left">-</td>
281 
-<td class="org-left"><a href="#orga6e8ab2">How to use it</a></td>
281 
+<td class="org-left"><a href="#org759e416">How to use it</a></td>
282 
 </tr>
 282 
 </tr>
283 
 </tbody>
 283 
 </tbody>
284 
 </table>
 284 
 </table>
287 
 Mesh networks are useful as a quick way to make a fully decentralised communications system which is not connected to or reliant upon the internet. Think festivals, hacker conferences, onboard ships at sea, disaster/war zones, small business internal office communications, protests, remote areas of the world, temporary "digital blackouts", scientific expeditions and off-world space colonies. The down side is that you can't access any internet content. The upside is that you can securely communicate with anyone on the local mesh. No ISPs. No payments or subscriptions beyond the cost of obtaining the hardware. Systems need to be within wifi range of each other for the mesh to be created. It can be an ultra-convenient way to do purely local communications.
 287 
 Mesh networks are useful as a quick way to make a fully decentralised communications system which is not connected to or reliant upon the internet. Think festivals, hacker conferences, onboard ships at sea, disaster/war zones, small business internal office communications, protests, remote areas of the world, temporary "digital blackouts", scientific expeditions and off-world space colonies. The down side is that you can't access any internet content. The upside is that you can securely communicate with anyone on the local mesh. No ISPs. No payments or subscriptions beyond the cost of obtaining the hardware. Systems need to be within wifi range of each other for the mesh to be created. It can be an ultra-convenient way to do purely local communications.
288 
 </p>
 288 
 </p>
289
289
290 
-<div id="outline-container-org707c257" class="outline-2">
291 
-<h2 id="org707c257">What the system can do</h2>
292 
-<div class="outline-text-2" id="text-org707c257">
290 
+<div id="outline-container-org4a254bc" class="outline-2">
291 
+<h2 id="org4a254bc">What the system can do</h2>
292 
+<div class="outline-text-2" id="text-org4a254bc">
293 
 <ul class="org-ul">
 293 
 <ul class="org-ul">
294 
 <li>Discovery of other users on the network</li>
 294 
 <li>Discovery of other users on the network</li>
295 
 <li>Text based chat, one-to-one and in groups</li>
 295 
 <li>Text based chat, one-to-one and in groups</li>
297 
 <li>Private and public sharing of files</li>
 297 
 <li>Private and public sharing of files</li>
298 
 <li>Blogging</li>
 298 
 <li>Blogging</li>
299 
 <li>No network administration required</li>
 299 
 <li>No network administration required</li>
300 
+<li>No servers, internet connection or cabling is needed.</li>
301 
+<li>Works from bootable USB drives or microSD drives.</li>
302 
+<li>Data is mesh routed between systems</li>
303 
+<li>Private communications is end-to-end secured and forward secret.</li>
304 
+<li>Publicly shared data is <i>content addressable</i> and therefore scalable to many peers.</li>
300 
 </ul>
 305 
 </ul>
301 
-
302 
-<p>
303 
-Communication is local between systems within wifi range of each other. If systems are out of wifi range the data is mesh routed through intermediate peers.
304 
-</p>
305 
-
306 
-<p>
307 
-No servers, internet connection or cabling is needed.
308 
-</p>
309 
-
310 
-<p>
311 
-Works from bootable USB drives or microSD drives.
312 
-</p>
313 
-
314 
-<p>
315 
-Private communications is end-to-end secured with elliptic curve encryption and is forward secret. Not easy to censor or passively monitor.
316 
-</p>
317 
-
318 
-<p>
319 
-Publicly shared data is <i>content addressable</i> and therefore scalable to many peers.
320 
-</p>
321 
 </div>
 306 
 </div>
322 
 </div>
 307 
 </div>
323
308
324 
-<div id="outline-container-orgd00db33" class="outline-2">
325 
-<h2 id="orgd00db33">Disk Images</h2>
326 
-<div class="outline-text-2" id="text-orgd00db33">
327 
-</div><div id="outline-container-orgb5d2863" class="outline-3">
328 
-<h3 id="orgb5d2863">Client images</h3>
329 
-<div class="outline-text-3" id="text-orgb5d2863">
309 
+<div id="outline-container-orgced8804" class="outline-2">
310 
+<h2 id="orgced8804">Disk Images</h2>
311 
+<div class="outline-text-2" id="text-orgced8804">
312 
+</div><div id="outline-container-orgfb748a3" class="outline-3">
313 
+<h3 id="orgfb748a3">Client images</h3>
314 
+<div class="outline-text-3" id="text-orgfb748a3">
330 
 <div class="org-center">
 315 
 <div class="org-center">
331
316
332 
 <div class="figure">
 317 
 <div class="figure">
375 
 </div>
 360 
 </div>
376 
 </div>
 361 
 </div>
377
362
378 
-<div id="outline-container-orgd6a576d" class="outline-3">
379 
-<h3 id="orgd6a576d">Router images</h3>
380 
-<div class="outline-text-3" id="text-orgd6a576d">
363 
+<div id="outline-container-orgecfe8de" class="outline-3">
364 
+<h3 id="orgecfe8de">Router images</h3>
365 
+<div class="outline-text-3" id="text-orgecfe8de">
381 
 <p>
 366 
 <p>
382 
 Routers are intended to build network coverage for an area using small and low cost hardware. You can bolt them to walls or leave them on window ledges. They don't have any user interface and their only job is to haul network traffic across the mesh. Copy the image to a microSD card and insert it into the router, plug in an Atheros wifi dongle and power on. That should be all you need to do.
 367 
 Routers are intended to build network coverage for an area using small and low cost hardware. You can bolt them to walls or leave them on window ledges. They don't have any user interface and their only job is to haul network traffic across the mesh. Copy the image to a microSD card and insert it into the router, plug in an Atheros wifi dongle and power on. That should be all you need to do.
383 
 </p>
 368 
 </p>
384 
 </div>
 369 
 </div>
385 
-<div id="outline-container-org2908ddf" class="outline-4">
386 
-<h4 id="org2908ddf">Beaglebone Black</h4>
387 
-<div class="outline-text-4" id="text-org2908ddf">
370 
+<div id="outline-container-orgf896ab9" class="outline-4">
371 
+<h4 id="orgf896ab9">Beaglebone Black</h4>
372 
+<div class="outline-text-4" id="text-orgf896ab9">
388 
 <div class="org-center">
 373 
 <div class="org-center">
389
374
390 
 <div class="figure">
 375 
 <div class="figure">
418 
 </div>
 403 
 </div>
419 
 </div>
 404 
 </div>
420
405
421 
-<div id="outline-container-org0840eb8" class="outline-2">
422 
-<h2 id="org0840eb8">Building Disk Images</h2>
423 
-<div class="outline-text-2" id="text-org0840eb8">
406 
+<div id="outline-container-org32e81f3" class="outline-2">
407 
+<h2 id="org32e81f3">Building Disk Images</h2>
408 
+<div class="outline-text-2" id="text-org32e81f3">
424 
 <p>
 409 
 <p>
425 
 It's better not to trust images downloaded from random places on the interwebs. Chances are that unless you are in the web of trust of the above GPG signatures then they don't mean very much to you. If you actually want something trustworthy then build the images from scratch. It will take some time. Here's how to do it.
 410 
 It's better not to trust images downloaded from random places on the interwebs. Chances are that unless you are in the web of trust of the above GPG signatures then they don't mean very much to you. If you actually want something trustworthy then build the images from scratch. It will take some time. Here's how to do it.
426 
 </p>
 411 
 </p>
515 
 </div>
 500 
 </div>
516 
 </div>
 501 
 </div>
517
502
518 
-<div id="outline-container-orga6e8ab2" class="outline-2">
519 
-<h2 id="orga6e8ab2">How to use it</h2>
520 
-<div class="outline-text-2" id="text-orga6e8ab2">
503 
+<div id="outline-container-org759e416" class="outline-2">
504 
+<h2 id="org759e416">How to use it</h2>
505 
+<div class="outline-text-2" id="text-org759e416">
521 
 <p>
 506 
 <p>
522 
 When you first boot from the USB drive the system will create some encryption keys, assign a unique network address to the system and then reboot itself. When that's done you should see a prompt asking for a username. This username just makes it easy for others to initially find you on the mesh and will appear in the list of users.
 507 
 When you first boot from the USB drive the system will create some encryption keys, assign a unique network address to the system and then reboot itself. When that's done you should see a prompt asking for a username. This username just makes it easy for others to initially find you on the mesh and will appear in the list of users.
523 
 </p>
 508 
 </p>
509 
+</div>
524
510
511 
+<div id="outline-container-org5ba5715" class="outline-3">
512 
+<h3 id="org5ba5715">Chat System</h3>
513 
+<div class="outline-text-3" id="text-org5ba5715">
525 
 <p>
 514 
 <p>
526 
 Ensure that you're within wifi range of at least one other mesh peer (could be a router or client) and then you should see that the Tox chat and users icons appear. Select the users icon and you should see a list of users on the mesh. Select the Tox chat icon and once you are connected you should see the status light turn green. If after a few minutes you don't get the green status light then try closing and re-opening the Tox chat application. Select the plus button to add a friend and then copy and paste in a Tox ID from the users list.
 515 
 Ensure that you're within wifi range of at least one other mesh peer (could be a router or client) and then you should see that the Tox chat and users icons appear. Select the users icon and you should see a list of users on the mesh. Select the Tox chat icon and once you are connected you should see the status light turn green. If after a few minutes you don't get the green status light then try closing and re-opening the Tox chat application. Select the plus button to add a friend and then copy and paste in a Tox ID from the users list.
527 
 </p>
 516 
 </p>
575 
 </p>
 564 
 </p>
576
565
577 
 <p>
 566 
 <p>
578 
-At present video doesn't work reliably, but text and voice chat do work well. In future IPFS or Tahoe-LAFS may be added to create a distributed filesystem for the mesh.
567 
+At present video doesn't work reliably, but text and voice chat do work well.
568 
+</p>
569 
+</div>
570 
+</div>
571 
+
572 
+<div id="outline-container-org7e9110a" class="outline-3">
573 
+<h3 id="org7e9110a">Sharing Files</h3>
574 
+<div class="outline-text-3" id="text-org7e9110a">
575 
+<p>
576 
+You can make files publicly available on the network simply by dragging and dropping them into the <i>Public</i> folder on the desktop. To view the files belonging to another user select the desktop icon called <i>Visit a site</i> and enter the username or Tox ID of the other user.
577 
+</p>
578 
+
579 
+<div class="org-center">
580 
+
581 
+<div class="figure">
582 
+<p><img src="images/mesh_share_files.jpg" alt="mesh_share_files.jpg" />
583 
+</p>
584 
+</div>
585 
+</div>
586 
+</div>
587 
+</div>
588 
+
589 
+<div id="outline-container-orgfb852dc" class="outline-3">
590 
+<h3 id="orgfb852dc">Blogging</h3>
591 
+<div class="outline-text-3" id="text-orgfb852dc">
592 
+<p>
593 
+To create a blog post select the <i>Blog</i> icon on the desktop and then use the up and down cursor keys, space bar and enter key to add a new entry. Edit the title of the entry and add your text. You can also include photos if you wish - just copy them to the <b>CreateBlog/content/images</b> directory and then link to them as shown.
594 
+</p>
595 
+
596 
+<div class="org-center">
597 
+
598 
+<div class="figure">
599 
+<p><img src="images/mesh_new_blog.jpg" alt="mesh_new_blog.jpg" />
600 
+</p>
601 
+</div>
602 
+</div>
603 
+
604 
+<p>
605 
+To finish your blog entry just select <i>Save</i> and then close the editor. On older hardware it may take a while to publish the results, and this depends upon the amount of computation needed by IPFS to create file hashes. If you make no changes to the default text then the new blog entry will not be saved.
606 
+</p>
607 
+
608 
+<div class="org-center">
609 
+
610 
+<div class="figure">
611 
+<p><img src="images/mesh_new_blog2.jpg" alt="mesh_new_blog2.jpg" />
612 
+</p>
613 
+</div>
614 
+</div>
615 
+
616 
+<div class="org-center">
617 
+
618 
+<div class="figure">
619 
+<p><img src="images/mesh_view_blog.jpg" alt="mesh_view_blog.jpg" />
620 
+</p>
621 
+</div>
622 
+</div>
623 
+
624 
+<p>
625 
+You can also visit other blogs, edit or delete your previous entry and also change your blog theme.
579 
 </p>
 626 
 </p>
580
627
581
628
587 
 </div>
 634 
 </div>
588 
 </div>
 635 
 </div>
589 
 </div>
 636 
 </div>
637 
+</div>
590 
 <div id="postamble" class="status">
 638 
 <div id="postamble" class="status">
591
639
592 
 <style type="text/css">
 640 
 <style type="text/css">