Difference between revisions of "Node Setup"

Jump to navigation Jump to search
(→‎Downgrade Ubiquiti AirOS: Add line by line bullet point.)
(→‎Install the Mass Mesh Firmware: Friendly up the instructions.)
Line 136: Line 136:
  
 
<ol>
 
<ol>
<li>Statically assign your computer the IP address <code>192.168.1.25</code></li>
+
<li>Statically assign your computer the IP address <code>192.168.1.25</code>
<li>Power on the device and plug it into your computer's ethernet port</li>
+
    <ul>
<li>Copy the firmware you want to flash to the device:</li>
+
        <li>See [[#Set Up a Static IP Address]] if needed.</li>
<pre>scp openwrt-ar71xx-generic-ubnt-unifiac-lite-squashfs-sysupgrade.bin ubnt@192.168.1.20:/tmp/</pre>
+
    </ul>
<li>SSH into the device and log in with the default username and password <code>ubnt / ubnt</code></li>
+
</li>
<pre>ssh ubnt@192.168.1.20</pre>
+
<li>Copy the Mass Mesh firmware onto the device:
<li>Then write the firmware to <code>kernel0</code> and <code>kernel1</code></li>
+
    <ul>
<pre>
+
        <li> <pre>scp openwrt-ar71xx-generic-ubnt-unifiac-lite-squashfs-sysupgrade.bin ubnt@192.168.1.20:/tmp/</pre></li>
BZ.v3.7.40# mtd write /tmp/openwrt-ar71xx-generic-ubnt-unifiac-lite-squashfs-sysupgrade.bin kernel0
+
    </ul>
 +
</li>
 +
<li>SSH into the device and log in with the default username and password <code>ubnt / ubnt</code>
 +
    <ul>
 +
        <li><pre>ssh ubnt@192.168.1.20</pre></li>
 +
    </ul>
 +
</li>
 +
<li>Then write the firmware to <code>kernel0</code> and <code>kernel1</code> by entering the following into the terminal, line by line:
 +
    <ul>
 +
        <li>
 +
            <pre>BZ.v3.7.40# mtd write /tmp/openwrt-ar71xx-generic-ubnt-unifiac-lite-squashfs-sysupgrade.bin kernel0
 +
BZ.v3.7.40# mtd -r write /tmp/openwrt-ar71xx-generic-ubnt-unifiac-lite-squashfs-sysupgrade.bin kernel1</pre>
 +
        </li>
 +
        <li>You should see something like the following:</li>
 +
        <li>
 +
            <pre>BZ.v3.7.40# mtd write /tmp/openwrt-ar71xx-generic-ubnt-unifiac-lite-squashfs-sysupgrade.bin kernel0
 
Unlocking kernel0 ...
 
Unlocking kernel0 ...
 
Erasing kernel0 ...
 
Erasing kernel0 ...
Line 152: Line 167:
 
Unlocking kernel1 ...
 
Unlocking kernel1 ...
 
Erasing kernel1 ...
 
Erasing kernel1 ...
Writing from /tmp/openwrt-ar71xx-generic-ubnt-unifiac-lite-squashfs-sysupgrade.bin to kernel1 ...  [e/w]
+
Writing from /tmp/openwrt-ar71xx-generic-ubnt-unifiac-lite-squashfs-sysupgrade.bin to kernel1 ...  [e/w]</pre>
</pre>
+
        </li>
 +
    </ul>
 +
</li>
 +
<li>Type <code>reboot</code> into the terminal, and hit enter. The radio will now restart. Please wait upwards of 5+ minutes during this "first boot" process. When the device is working properly, you should see a wifi network named "MassMesh.org"
 
</ol>
 
</ol>
  
After writing the firmware and giving the radio a <code>reboot</code> please wait upwards of 5+ minutes during this "first boot" process. Soon you'll be able to access to device over WiFi (or Ethernet) in order to set a new admin password. (192.168.2.1)
+
'''Congratulations!''' You have now installed all the firmware you need. Set the radio aside, and pick up in [[#Assembly]]
 
 
'''Congratulations!''' You have now installed all the firmware you need.
 
  
 
= Assembly =
 
= Assembly =

Revision as of 20:47, 11 August 2020

In these instructions, we will cover how to deploy a mesh node that is privacy-enabled by default, and allows you to share an Internet connection with your neighbors. The whole setup process takes about 2 hours from start to finish. The necessary hardware is listed below, and instructions for everything from flashing the firmware to placing the antenna are covered.

Definitions

  • Mesh Node: A mesh node is the smallest unit on a mesh network. Every mesh node is a router, and is critical for delivering the online traffic of its neighbors. For more details about how mesh networks and neighborhood networks work internally, please see the Network Architecture page.
  • Firmware: Firmware is the first thing that you will install on your mesh node. Firmware is just like the operating system on your computer (Linux, Windows, Mac, etc.) Firmware is what allows us to install applications, manage users, and all the other things you can do on a functioning computer. The firmware that we use on our network is a customized version of OpenWrt.
  • Antenna/Radio: The antenna (or radio) is what allows your mesh node to communicate with other mesh nodes. Our antennas communicate in free spectrum at 2.4Ghz and 5Ghz -- just like the wi-fi in your home or workplace.
  • Router: A router is any computer that is responsible for "routing" information on a network. All the mesh nodes on our network can also be called routers.
  • Gateway: A gateway or gateway server is a computer (usually a big one) that acts as a bridge between two networks. In order to provide a high level of security on our network, all of our mesh nodes reach the Internet through a gateway server. For more details about how mesh networks and neighborhood networks work internally, please see the Network Architecture page.

Preparation

Note: Set yourself up for success, and introduce yourself in one of our chat rooms before you begin. Something will go wrong during the setup process, and it's best to have experienced friends ready to help when it does.

Considerations

  • Time: about 2 hours
  • Cost: about $150
  • Internet Access: If you do not already have Internet access, you will need to find a neighbor (on your same street) who is willing to set up a mesh node at their home too, and work out a deal to share their Internet connection fairly.
  • Difficulty: The instructions contained on this website are quite technical, and may be incomplete in some places. Most of these instructions were written with Linux users in mind. If you are using another operating system (like Windows or Mac,) some "googling" may be necessary to get through them. As stated above, it's good to have friends. Introduce yourself in any of our chat channels if you want some help getting started!

Materials

Standard Mesh Node

To set up a standard mesh node that broadcasts a secure Internet connection in all directions, you will need to obtain the following equipment:

Custom Mesh Nodes

If you know what kind of hardware you want, and this 'aint it, please see the recommended Hardware Bundles, or browse the full list of Devices.

Firmware Installation

If you prefer, bring your hardware to one of our weekly meetups, and we will be happy to flash it for you!

Raspberry Pi 4

Materials & Software

Warning: Download and install the appropriate version of the Raspberry Pi Imager for your computer before continuing.

Install the Firmware

  1. Download the latest stable version of Mass Mesh's free firmware here
  2. Open the Raspberry Pi Imager (Download and install it from here if you haven't yet.)
  3. Select "Choose OS"
    1. Select "Choose OS"
  4. Scroll to the bottom of the list, and select "Use Custom"
    1. Scroll to the bottom of the list, and select "Use Custom"
  5. Find the Mass Mesh firmware you just downloaded, and select it from the filesystem.
  6. Once you have selected the appropriate firmware, select "Choose SD Card"
    1. Once you have selected the appropriate firmware, select "Choose SD Card"
  7. You should see something like the following. Go ahead and select that card. (You probably only see one, but use the size of the card as a hint if you see several.)
    1. Go ahead and select that card. (You probably only see one, but use the size of the card as a hint if you see several.)
  8. Once you have selected the OS and the SD Card, select "Write." You will see a warning like the one shown below... Go ahead and select "Yes."
    1. Once you have selected the OS and the SD Card, select "Write."
    2. You will see a warning like this... Go ahead and select "Yes."
  9. You should see a screen like the following. Click "Continue," and remove the SD card from your computer.
    1. Click "Continue," and remove the SD card from your computer.
  10. Plug the micro SD card into your Raspberry Pi 4.
    1. Plug in the SD card with the gold side up, like shown here:
    2. Plug in the SD card with the gold side up

Congratulations!!! You have successfully prepared your Raspberry Pi 4b to act as a secure mesh node. Set it aside for now while we prepare the other hardware. We will assemble it at the end in #Assembly.

UAP AC Mesh

Materials

Install the Firmware

The steps to install firmware on the antenna are a bit different than they were for the Raspberry Pi. For one thing, the antenna does not have an SD card. So, we will have to install the firmware by connecting to the antenna with our laptop. Please see page 6 of the "Node Installation Guide" for instructions on plugging in the antenna. After you have followed the instructions there, connect your computer to the port marked "LAN" on your PoE injector. We are now ready to begin installing the firmware.

Enter Factory Reset Mode

  1. Put the antenna into factory reset mode
    1. Unplug the ethernet from the antenna
    2. Use a paper clip to hold in the reset button
    3. Plug the ethernet back in to the antenna, holding the paperclip steady as you do
    4. Continue holding the paper clip until the light on the side of your UAP AC Mesh starts blinking OFF/WHITE/BLUE (should take about 30 seconds)

Set Up a Static IP Address

  1. Assign your computer a static IP address of 192.168.1.25/24
    1. Windows: Setting a static IP address in Windows 10
    2. Mac: Setting a static IP address in OSX
    3. Linux: Setting a static IP address in Ubuntu 18.04 desktop

Downgrade Ubiquiti AirOS

Because we are "jailbreaking" the Ubiquiti router, we have to downgrade to an older version of their proprietary firmware first. Using a tool called TFTP, we can do this quite simply.

  1. Download version 3.7 of Ubiquiti's AirOS
  2. Rename the firmware file to firmware.bin, as the device will look for this file name
  3. Launch a command prompt/terminal, and enter the following, one line at a time:
tftp
tftp> connect 192.168.1.20
tftp> binary
tftp> rexmt 1
tftp> timeout 60
tftp> put firmware.bin
Sent x bytes in x seconds

The LED will flash at varying speeds, then it will turn solid when complete.

  • If you don't see something like what's shown above (maybe your "Transfer timed out.), go back and make sure that the light on the side of your UAP AC Mesh is blinking in the pattern indicated above. If not, start again from #Enter Factory Reset Mode
  • If the light is blinking properly, make sure that your static IP address was assigned properly. If not, start again from #Set Up a Static IP Address
  • If you are still having trouble transferring firmware to the device, reach out for help in the chatroom. Someone will help you get unstuck.

Install the Mass Mesh Firmware

Get the firmware here.

In the stock firmware, the access point will have the default user/pass ubnt / ubnt. If there is no DHCP server, it will assign itself the IP address 192.168.1.20.

  1. Statically assign your computer the IP address 192.168.1.25
  2. Copy the Mass Mesh firmware onto the device:
    • scp openwrt-ar71xx-generic-ubnt-unifiac-lite-squashfs-sysupgrade.bin ubnt@192.168.1.20:/tmp/
  3. SSH into the device and log in with the default username and password ubnt / ubnt
    • ssh ubnt@192.168.1.20
  4. Then write the firmware to kernel0 and kernel1 by entering the following into the terminal, line by line:
    • BZ.v3.7.40# mtd write /tmp/openwrt-ar71xx-generic-ubnt-unifiac-lite-squashfs-sysupgrade.bin kernel0
      BZ.v3.7.40# mtd -r write /tmp/openwrt-ar71xx-generic-ubnt-unifiac-lite-squashfs-sysupgrade.bin kernel1
    • You should see something like the following:
    • BZ.v3.7.40# mtd write /tmp/openwrt-ar71xx-generic-ubnt-unifiac-lite-squashfs-sysupgrade.bin kernel0
      Unlocking kernel0 ...
      Erasing kernel0 ...
      Writing from /tmp/openwrt-ar71xx-generic-ubnt-unifiac-lite-squashfs-sysupgrade.bin to kernel0 ...  [e/w]
      
      BZ.v3.7.40# mtd -r write /tmp/openwrt-ar71xx-generic-ubnt-unifiac-lite-squashfs-sysupgrade.bin kernel1
      Unlocking kernel1 ...
      Erasing kernel1 ...
      Writing from /tmp/openwrt-ar71xx-generic-ubnt-unifiac-lite-squashfs-sysupgrade.bin to kernel1 ...  [e/w]
  5. Type reboot into the terminal, and hit enter. The radio will now restart. Please wait upwards of 5+ minutes during this "first boot" process. When the device is working properly, you should see a wifi network named "MassMesh.org"

Congratulations! You have now installed all the firmware you need. Set the radio aside, and pick up in #Assembly

Assembly

To assemble your mesh node, please follow this PDF guide. It can be downloaded for your convenience.

<pdf>File:New_Node_Install_Guide.pdf</pdf>

Next Steps

Note: You still have to do Gateway Configuration in order to access the Internet.
  1. First Time Setup
  2. Gateway Configuration