free
/
freedombone
Watch 1
Star 0
Fork 0
Code Issues 0 Pull Requests 0 Releases 0 Wiki Activity
Browse Source

Don't rely upon github

Bob Mottram 8 years ago
parent
f3b7768a1f
commit
84062a6eb5
No account linked to committer's email
2 changed files with 42 additions and 34 deletions
Split View Show Diff Stats
  1. 10
    6
      doc/EN/mesh.org
  2. 32
    28
      website/EN/mesh.html

+ 10
- 6
doc/EN/mesh.org View File 

@@ -73,19 +73,23 @@ If you have a few Beaglebone Blacks to use as routers then repeat the /dd/ comma
73 73 
 * To build the disk image yourself
74 74 
 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.
75 75
76 
-First you will need to create an image. On a Debian based system:
76 
+First you will need to create an image. On a Debian based system (tested on Debian Jessie and Trisquel 7):
77 77
78 78 
 #+begin_src bash
79 
-sudo su
80 
-apt-get -y install build-essential libc6-dev-i386 \
79 
+sudo apt-get -y install build-essential libc6-dev-i386 wget \
81 80 
     gcc-multilib g++-multilib git python-docutils mktorrent \
82 81 
     vmdebootstrap xz-utils dosfstools btrfs-tools extlinux \
83 82 
     python-distro-info mbr qemu-user-static binfmt-support \
84 83 
     u-boot-tools qemu
85 
-git clone https://github.com/bashrc/freedombone
84 
+wget https://freedombone.net/downloads/freedombone-mesh-source.tar.gz
85 
+wget https://freedombone.net/downloads/freedombone-mesh-source.tar.gz.sig
86 
+gpg --verify freedombone-mesh-source.tar.gz.sig
87 
+sha256sum freedombone-mesh-source.tar.gz
88 
+912a881e32c2846337f19d60bc4685f745b252858b8bccb5d07d009e67c80c33
89 
+tar -xzvf freedombone-mesh-source.tar.gz
86 90 
 cd freedombone
87 91 
 git checkout stockholm
88 
-make install
92 
+sudo make install
89 93 
 freedombone-image -t i386 -v meshclient
90 94 
 #+end_src
91 95 
 
@@ -108,7 +112,7 @@ Now plug in the USB thumb drive, and do the same again. Notice which drive lette
108 112 
 You can now copy the image to the USB thumb drive, replacing *sdX* with the identifier of the USB thumb drive. Don't include any numbers (so for example use *sdc* instead of *sdc1*).
109 113
110 114 
 #+begin_src bash
111 
-dd bs=1M if=myimagefile.img of=/dev/sdX conv=fdatasync
115 
+sudo dd bs=1M if=myimagefile.img of=/dev/sdX conv=fdatasync
112 116 
 #+end_src
113 117
114 118 
 And wait. Again it will take a while to copy over. When that's done plug it into the laptop or netbook which you want to use on the mesh, power on and set the BIOS to boot from the USB stick.

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

@@ -3,7 +3,7 @@
3 3 
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
4 4 
 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
5 5 
 <head>
6 
-<!-- 2016-09-01 Thu 10:55 -->
6 
+<!-- 2016-09-01 Thu 11:31 -->
7 7 
 <meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
8 8 
 <meta name="viewport" content="width=device-width, initial-scale=1" />
9 9 
 <title></title>
 
@@ -257,17 +257,17 @@ Mesh networks are useful as a quick way to make a fully decentralised communicat
257 257 
 </p>
258 258
259 259 
 <ul class="org-ul">
260 
-<li><a href="#org760a031">Ready made images</a></li>
261 
-<li><a href="#org800eb33">To build the disk image yourself</a></li>
262 
-<li><a href="#org2f93077">How to use it</a></li>
260 
+<li><a href="#org58fc760">Ready made images</a></li>
261 
+<li><a href="#orgd79f2a2">To build the disk image yourself</a></li>
262 
+<li><a href="#org1a1359a">How to use it</a></li>
263 263 
 </ul>
264 264
265 
-<div id="outline-container-org760a031" class="outline-2">
266 
-<h2 id="org760a031">Ready made images</h2>
267 
-<div class="outline-text-2" id="text-org760a031">
268 
-</div><div id="outline-container-org66c2a01" class="outline-3">
269 
-<h3 id="org66c2a01">Client images</h3>
270 
-<div class="outline-text-3" id="text-org66c2a01">
265 
+<div id="outline-container-org58fc760" class="outline-2">
266 
+<h2 id="org58fc760">Ready made images</h2>
267 
+<div class="outline-text-2" id="text-org58fc760">
268 
+</div><div id="outline-container-org8b67c9e" class="outline-3">
269 
+<h3 id="org8b67c9e">Client images</h3>
270 
+<div class="outline-text-3" id="text-org8b67c9e">
271 271 
 <p>
272 272 
 "Client" isn't exactly the right term, but it's a mesh peer with a user interface. These images can be copied to a USB drive, then you can plug it into a laptop/netbook/desktop machine and boot from it. You will probably also need an Atheros USB wifi dongle, because most built-in wifi usually requires proprietary firmware. In the commands below substitute /dev/sdX with the USB drive device, excluding any trailing numbers (eg. /dev/sdb).
273 273 
 </p>
 
@@ -308,16 +308,16 @@ sudo dd <span class="org-variable-name">bs</span>=1M <span class="org-variable-n
308 308 
 </div>
309 309 
 </div>
310 310
311 
-<div id="outline-container-org67334a7" class="outline-3">
312 
-<h3 id="org67334a7">Router images</h3>
313 
-<div class="outline-text-3" id="text-org67334a7">
311 
+<div id="outline-container-orgcde0031" class="outline-3">
312 
+<h3 id="orgcde0031">Router images</h3>
313 
+<div class="outline-text-3" id="text-orgcde0031">
314 314 
 <p>
315 315 
 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.
316 316 
 </p>
317 317 
 </div>
318 
-<div id="outline-container-org6711b0a" class="outline-4">
319 
-<h4 id="org6711b0a">Beaglebone Black</h4>
320 
-<div class="outline-text-4" id="text-org6711b0a">
318 
+<div id="outline-container-org7419bac" class="outline-4">
319 
+<h4 id="org7419bac">Beaglebone Black</h4>
320 
+<div class="outline-text-4" id="text-org7419bac">
321 321 
 <div class="org-src-container">
322 322
323 323 
 <pre class="src src-bash">sudo apt-get install xz-utils wget
 
@@ -339,29 +339,33 @@ If you have a few Beaglebone Blacks to use as routers then repeat the <i>dd</i>
339 339 
 </div>
340 340 
 </div>
341 341
342 
-<div id="outline-container-org800eb33" class="outline-2">
343 
-<h2 id="org800eb33">To build the disk image yourself</h2>
344 
-<div class="outline-text-2" id="text-org800eb33">
342 
+<div id="outline-container-orgd79f2a2" class="outline-2">
343 
+<h2 id="orgd79f2a2">To build the disk image yourself</h2>
344 
+<div class="outline-text-2" id="text-orgd79f2a2">
345 345 
 <p>
346 346 
 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.
347 347 
 </p>
348 348
349 349 
 <p>
350 
-First you will need to create an image. On a Debian based system:
350 
+First you will need to create an image. On a Debian based system (tested on Debian Jessie and Trisquel 7):
351 351 
 </p>
352 352
353 353 
 <div class="org-src-container">
354 354
355 
-<pre class="src src-bash">sudo su
356 
-apt-get -y install build-essential libc6-dev-i386 <span class="org-sh-escaped-newline">\</span>
355 
+<pre class="src src-bash">sudo apt-get -y install build-essential libc6-dev-i386 wget <span class="org-sh-escaped-newline">\</span>
357 356 
     gcc-multilib g++-multilib git python-docutils mktorrent <span class="org-sh-escaped-newline">\</span>
358 357 
     vmdebootstrap xz-utils dosfstools btrfs-tools extlinux <span class="org-sh-escaped-newline">\</span>
359 358 
     python-distro-info mbr qemu-user-static binfmt-support <span class="org-sh-escaped-newline">\</span>
360 359 
     u-boot-tools qemu
361 
-git clone https://github.com/bashrc/freedombone
360 
+wget https://freedombone.net/downloads/freedombone-mesh-source.tar.gz
361 
+wget https://freedombone.net/downloads/freedombone-mesh-source.tar.gz.sig
362 
+gpg --verify freedombone-mesh-source.tar.gz.sig
363 
+sha256sum freedombone-mesh-source.tar.gz
364 
+912a881e32c2846337f19d60bc4685f745b252858b8bccb5d07d009e67c80c33
365 
+tar -xzvf freedombone-mesh-source.tar.gz
362 366 
 <span class="org-builtin">cd</span> freedombone
363 367 
 git checkout stockholm
364 
-make install
368 
+sudo make install
365 369 
 freedombone-image -t i386 -v meshclient
366 370 
 </pre>
367 371 
 </div>
 
@@ -400,7 +404,7 @@ You can now copy the image to the USB thumb drive, replacing <b>sdX</b> with the
400 404
401 405 
 <div class="org-src-container">
402 406
403 
-<pre class="src src-bash">dd <span class="org-variable-name">bs</span>=1M <span class="org-variable-name">if</span>=myimagefile.img <span class="org-variable-name">of</span>=/dev/sdX <span class="org-variable-name">conv</span>=fdatasync
407 
+<pre class="src src-bash">sudo dd <span class="org-variable-name">bs</span>=1M <span class="org-variable-name">if</span>=myimagefile.img <span class="org-variable-name">of</span>=/dev/sdX <span class="org-variable-name">conv</span>=fdatasync
404 408 
 </pre>
405 409 
 </div>
406 410 
 
@@ -432,9 +436,9 @@ The resulting image can be copied to a microSD card, inserted into a Beaglebone
432 436 
 </div>
433 437 
 </div>
434 438
435 
-<div id="outline-container-org2f93077" class="outline-2">
436 
-<h2 id="org2f93077">How to use it</h2>
437 
-<div class="outline-text-2" id="text-org2f93077">
439 
+<div id="outline-container-org1a1359a" class="outline-2">
440 
+<h2 id="org1a1359a">How to use it</h2>
441 
+<div class="outline-text-2" id="text-org1a1359a">
438 442 
 <p>
439 443 
 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.
440 444 
 </p>