Difference between revisions of "Raspberry Pi"

From SatNOGS Wiki
m (Intro: added link to ansible guide)
(45 intermediate revisions by 9 users not shown)
Line 1: Line 1:
The Raspberry Pi 3 is the reference platform for SatNOGs.  As of September 2017, there are two methods of installing the SatNOGS client on a Raspberry Pi:
+
{{Message|This page assumes you have an account and a ground station registered on either network.satnogs.org or network-dev.satnogs.org. Make note of your station ID and API Key.}}
 +
[[File:B3342fcc865731d69e0c9d7a8b1abb887185bc13 1 531x500.jpg|alt=Libre Space Foundation Raspberry Pi Case|thumb|Libre Space Foundation Raspberry Pi Case, [https://www.thingiverse.com/thing:3233687 on thingiverse]]]
  
* Using Fedora for ARM, and following the instructions at [http://satnogs.readthedocs.io/en/stable/satnogs-client/doc/raspi-install.html satnogs.readthedocs.io]
+
= Intro =
* Installing the custom-built SatNOGS Raspian image
 
  
= Fedora =
+
The Raspberry Pi 3 is the reference platform for SatNOGS (see our [[SatNOGS Client Ansible|Ansible guide]] to install SatNOGS on other Linux machines). You can try using various distributions for this (eg. Arch, Fedora), but the one we suggest is our custom image based on latest Raspbian.
  
Start by downloading the "Server" or "Minimal" image from the [https://arm.fedoraproject.org/ the Fedora ARM project page].  After that, follow the instructions at [http://satnogs.readthedocs.io/en/stable/satnogs-client/doc/raspi-install.html satnogs.readthedocs.io].
+
== [https://gitlab.com/librespacefoundation/satnogs/satnogs-pi-gen/-/jobs/artifacts/2018080300/download?job=release <span class="glyphicon glyphicon-save"></span> Download]==
  
* If you run into anything in the instructions that is unclear, please submit an issue against [https://gitlab.com/librespacefoundation/satnogs/satnogs-docs the documentation repository].
+
You can download the latest Raspbian SatNOGS image following the links from the [https://gitlab.com/librespacefoundation/satnogs/satnogs-pi-gen/tags latest tag on GitLab]. Click on the cloud icon and then click "Download release". You will get an Artifacts.zip file:
  
= Raspbian =
+
=== Artifacts list ===
Latest Raspbian zipped image can be downloaded from [https://gitlab.com/librespacefoundation/satnogs/satnogs-pi-gen/tags GitLab].
 
You should verify the contents of that file by checking the SHA256 checksum.  On Linux, run "sha256sum -c sha256sums" like so:
 
  
 +
The current artifacts list consists of:
 +
* A Zipped image file
 +
* An Image info file
 +
* A SHA256 checksums file
 +
 +
== Data integrity verification ==
 +
 +
You should verify the data integrity of the artifacts by checking the SHA256 checksums. On Linux, run <code>sha256sum -c sha256sums</code> in the directory where the artifacts are downloaded
 +
 +
Example:
 
<pre>
 
<pre>
/tmp $ cp ~/Downloads/artifacts.zip .
+
$ sha256sum -c sha256sums  
/tmp $ unzip artifacts.zip
+
2017-09-29-Raspbian-SatNOGS-master-lite.info: OK
Archive:  artifacts.zip
+
image_2017-09-29-Raspbian-SatNOGS-master-lite.zip: OK
  inflating: deploy/2017-09-10-Raspbian-SatNOGS-master-lite.info 
 
  inflating: deploy/image_2017-09-10-Raspbian-SatNOGS-master-lite.zip 
 
  inflating: deploy/sha256sums     
 
/tmp $ cd deploy/
 
/tmp/deploy $ ls -l
 
total 637892
 
-rw-r--r--. 1 aardvark aardvark    116696 Sep 10 00:59 2017-09-10-Raspbian-SatNOGS-master-lite.info
 
-rw-r--r--. 1 aardvark aardvark 653075512 Sep 10 00:59 image_2017-09-10-Raspbian-SatNOGS-master-lite.zip
 
-rw-r--r--. 1 aardvark aardvark      227 Sep 10 01:06 sha256sums
 
/tmp/deploy $ sha256sum -c sha256sums  
 
2017-09-10-Raspbian-SatNOGS-master-lite.info: OK
 
image_2017-09-10-Raspbian-SatNOGS-master-lite.zip: OK
 
 
</pre>
 
</pre>
  
Unzip the image zipfile that was contained in the artifacts zipfile. (In the example above, it is named "image_2017-09-10-Raspbian-SatNOGS-master-lite.zip".)  Within that, you'll find the image file that needs to be installed to an SD card:
+
== Flashing ==
 +
[https://www.raspberrypi.org/documentation/installation/installing-images/README.md Follow the usual Raspbian flashing instructions], and boot your Raspberry Pi.
 +
 
 +
== Configuration==
 +
The Raspberry Pi can be set up by connecting it to a keyboard and monitor, by connecting it to wired Ethernet, or by editing files in the /boot mount on the flashed USB stick.
 +
 
 +
=== Modifying the /boot mount ===
 +
This eliminates the need for a keyboard and monitor. Note your OS may mount /boot in a different location, and [https://raspberrypi.stackexchange.com/questions/10251/prepare-sd-card-for-wifi-on-headless-pi#comment98121_57023 Windows users have line ending problems]. Suggested actions:
  
 +
enable ssh server
 +
 +
    touch /boot/ssh
 +
 +
set up wifi:
 +
 +
    edit /boot/wpa_supplicant.conf
 +
 +
contents: (note key_mgmt options include NONE, WPA-PSK, WPA-EAP)
 +
 +
    ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
 +
    update_config=1
 +
    country=US
 +
   
 +
    network={
 +
        ssid="NETWORK_NAME"
 +
        psk="password"
 +
        key_mgmt=WPA-PSK
 +
    }
 +
 +
=== Ethernet ===
 +
If you are using wired Ethernet you should get connectivity right away.
 +
 +
=== Wireless setup ===
 +
If you are using wireless then see [https://www.raspberrypi.org/documentation/configuration/wireless/wireless-cli.md this doc for network configuration instructions] after booting.
 +
 +
== Keyboard and monitor setup ==
 +
Once your Raspberry Pi is booted, log in with username "pi" password "raspberry" and run:
 
<pre>
 
<pre>
/tmp/deploy $ unzip image_2017-09-10-Raspbian-SatNOGS-master-lite.zip
+
sudo raspi-config
Archive:  image_2017-09-10-Raspbian-SatNOGS-master-lite.zip
 
  inflating: 2017-09-10-Raspbian-SatNOGS-master-lite.img 
 
 
</pre>
 
</pre>
  
[https://www.raspberrypi.org/documentation/installation/installing-images/README.md Follow the usual Raspbian flashing instructions], and boot your Raspberry Pi.
+
You will want to be sure to do the following:
 +
 
 +
* Set a strong, unique password
 +
* Change localization settings:
 +
** by default the rpi locale is configured for EN-GB, change as appropriate (ie: to EN_US.UTF-8)
 +
** set timezone (we recommend UTC so your logs match the times in Network)
 +
** set keyboard layout, again this is defaulting to a UK layout
 +
** set wifi country
 +
** expand filesystem
 +
* Finish and reboot
 +
 
 +
 
 +
== SatNOGS Setup ==
 +
 
 +
SSH to the Raspberry Pi with user "pi" and password "raspberry" (no quotes).
  
If you are using wired ethernet you should get connectivity right away. If you are using wireless then see [https://www.raspberrypi.org/documentation/configuration/wireless/wireless-cli.md this doc for network configuration instructions].
+
Follow [[SatNOGS_Client_Ansible#SatNOGS_Client_Setup|SatNOGS Client Setup]] instructions to configure the system.
  
SSH to the Raspberry Pi with user "pi" and password "raspberry" (no quotes).  Run "sudo satnogs-setup" to set basic configuration.  When it's done, the Raspberry Pi will reconfigure itself; this may take some time.
+
= Fedora =
  
* Note: you can always reconfigure the software by running "sudo satnogs-setup -n" again.
+
Instructions for installing on Fedora can be found [[Fedora_Installation|here]].

Revision as of 03:14, 14 February 2019

Idea.png
This page assumes you have an account and a ground station registered on either network.satnogs.org or network-dev.satnogs.org. Make note of your station ID and API Key.
Libre Space Foundation Raspberry Pi Case
Libre Space Foundation Raspberry Pi Case, on thingiverse

Intro

The Raspberry Pi 3 is the reference platform for SatNOGS (see our Ansible guide to install SatNOGS on other Linux machines). You can try using various distributions for this (eg. Arch, Fedora), but the one we suggest is our custom image based on latest Raspbian.

Download

You can download the latest Raspbian SatNOGS image following the links from the latest tag on GitLab. Click on the cloud icon and then click "Download release". You will get an Artifacts.zip file:

Artifacts list

The current artifacts list consists of:

  • A Zipped image file
  • An Image info file
  • A SHA256 checksums file

Data integrity verification

You should verify the data integrity of the artifacts by checking the SHA256 checksums. On Linux, run sha256sum -c sha256sums in the directory where the artifacts are downloaded

Example:

$ sha256sum -c sha256sums 
2017-09-29-Raspbian-SatNOGS-master-lite.info: OK
image_2017-09-29-Raspbian-SatNOGS-master-lite.zip: OK

Flashing

Follow the usual Raspbian flashing instructions, and boot your Raspberry Pi.

Configuration

The Raspberry Pi can be set up by connecting it to a keyboard and monitor, by connecting it to wired Ethernet, or by editing files in the /boot mount on the flashed USB stick.

Modifying the /boot mount

This eliminates the need for a keyboard and monitor. Note your OS may mount /boot in a different location, and Windows users have line ending problems. Suggested actions:

enable ssh server

   touch /boot/ssh

set up wifi:

   edit /boot/wpa_supplicant.conf

contents: (note key_mgmt options include NONE, WPA-PSK, WPA-EAP)

   ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
   update_config=1
   country=US
   
   network={
       ssid="NETWORK_NAME"
       psk="password"
       key_mgmt=WPA-PSK
   }

Ethernet

If you are using wired Ethernet you should get connectivity right away.

Wireless setup

If you are using wireless then see this doc for network configuration instructions after booting.

Keyboard and monitor setup

Once your Raspberry Pi is booted, log in with username "pi" password "raspberry" and run:

sudo raspi-config

You will want to be sure to do the following:

  • Set a strong, unique password
  • Change localization settings:
    • by default the rpi locale is configured for EN-GB, change as appropriate (ie: to EN_US.UTF-8)
    • set timezone (we recommend UTC so your logs match the times in Network)
    • set keyboard layout, again this is defaulting to a UK layout
    • set wifi country
    • expand filesystem
  • Finish and reboot


SatNOGS Setup

SSH to the Raspberry Pi with user "pi" and password "raspberry" (no quotes).

Follow SatNOGS Client Setup instructions to configure the system.

Fedora

Instructions for installing on Fedora can be found here.