Add instructions for Raspberry Pi 2.

ParadropLabs · Dec 13, 2018 · 59526b0 · 59526b0
1 parent e48de1d
commit 59526b0
Show file tree

Hide file tree

Showing 3 changed files with 43 additions and 2 deletions.
diff --git a/docs/device/index.rst b/docs/device/index.rst
@@ -16,5 +16,6 @@ activate the node with the cloud controller at paradrop.org. The page
    :maxdepth: 2
 
    virtual-machine
-   pcengines-apu2
    intel-nuc
+   pcengines-apu2
+   raspberry-pi2
diff --git a/docs/device/pcengines-apu2.rst b/docs/device/pcengines-apu2.rst
@@ -51,7 +51,7 @@ First Boot
 
 If you know the IP address of the router, e.g. because you have access to the
 DHCP server upstream from the router, then you can skip this step and proceed
-with activating the router as described in the section :doc:`../manual/index`_.
+with activating the router as described in the section :doc:`../manual/index`.
 
 The first time you boot the Paradrop router, you can optionally connect
 a serial cable to complete the Ubuntu Core setup process.  The default

diff --git a/docs/device/raspberry-pi2.rst b/docs/device/raspberry-pi2.rst
@@ -0,0 +1,40 @@
+Raspberry Pi 2
+==============
+
+Hardware requirements
+---------------------
+
+* 1x Raspberry Pi 2 (recommended: 1 GB memory)
+* 1x micro SD card (minimum: 4 GB, recommended: 16 GB)
+
+Preparing the SD card
+---------------------
+
+1. Download the latest build of the Paradrop
+   `disk image <https://paradrop.org/release/latest/paradrop-pi2.img.xz>`_
+2. Insert the SD card into the machine you used to download the image and find
+   the device node for the card.  This is often "/dev/sdb", but please make
+   sure, as the next command will overwrite the contents of whatever device you
+   pass.
+3. Copy ("flash") the Paradrop image to the SD card.::
+
+    xzcat paradrop-pi2.img.xz | sudo dd of=<DEVICE> bs=32M status=progress; sync
+
+4. Insert the SD card in the Raspberry Pi and proceed to power it.
+
+Please note that in order to make the SD card bootable, it is not
+enough to copy the disk image file to an existing filesystem on
+the SD card. Instead, one must overwrite the contents of the SD
+card including MBR, partition table, and data with the provided
+disk image.  In Linux, you can do this with the `dd` command. If
+you are using Windows, we suggest using the `win32-image-writer
+<https://launchpad.net/win32-image-writer>`_ tool. Follow the
+Sourceforge link to download the installer.
+
+First Boot
+----------
+
+The first time you boot the target device, ensure that it is connected
+to a wired network. Identify the IP address that the Raspberry Pi device
+received from the network and proceed to the activation step described
+in the section :doc:`../manual/index`.