Difference between revisions of "Raspberry Pi"

Latest revision as of 13:56, 11 January 2025

Libre Space Foundation Raspberry Pi Case, on thingiverse

Introduction

The Raspberry Pi (version 3, 4 and 5) is the reference platform for SatNOGS (see our Ansible guide to install SatNOGS on other Linux machines).

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.

Flashing

IMPORTANT: Some essential features from the previous version are currently unavailable in the newer version. Please review the Missing Features Table before flashing. If any of the missing features are critical to your setup, follow the Legacy Software Installation Guide to install the legacy software.

Use the Raspberry Pi Imager, as outlined in the Raspberry Pi OS flashing guidelines, and follow the steps provided there. Along with the official guide, be sure to take into account the instructions provided in the following subsections.

OS selection

To optimize resource usage and reduce unnecessary running services, choose the Raspberry Pi OS Lite image instead of the full Raspberry Pi OS image. During the OS selection process, navigate to the Raspberry Pi OS (other) submenu and select Raspberry Pi OS Lite (64-bit).

OS customization

At the very least, you need to:

Set username and password
Set locale settings
- Time zone
- Keyboard layout
Enable SSH

If connection to the internet is via Wi-Fi, make sure to Configure wireless LAN as well.

To easily discover the Rapsberry Pi among other Rapsberry Pis in your network, set a unique hostname.

Getting console access

You can log in the Raspberry Pi by connecting it to a keyboard and monitor or through network via an SSH connection.

Keyboard and monitor

Once your Raspberry Pi is booted, log in with the username and password that you set during the flashing process.

Network

If your network supports zeroconf, you can use the hostname of your Raspberry Pi and log in with SSH using the username and password that you set during the flashing process. Example:

$ ssh pi@raspberrypi.local

If zeroconf is not supported then you must manually find the IP address of the Raspberry Pi (e.g. in your router management interface).

Installation

To install the SatNOGS software on the Raspberry Pi OS or any other supported OS you just log, and execute the following command:

$ curl -sfL https://satno.gs/install | sh -s --

This command executes the SatNOGS Setup tool which will install all the necessary software and then bring up the SatNOGS configuration menu-driven utility.

Follow SatNOGS Setup instructions to configure the system.

@@ 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:
+[[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]
+==Introduction==
-* Installing the custom-built SatNOGS Raspian image
-== Fedora ==
+The Raspberry Pi (version 3, 4 and 5) is the reference platform for SatNOGS (see our [[SatNOGS Client Ansible|Ansible guide]] to install SatNOGS on other Linux machines).
-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].
+{{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.}}
-* 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].
+==Flashing==
+{{Warning|IMPORTANT: Some essential features from the previous version are currently unavailable in the newer version. Please review the [[SatNOGS Setup#Missing_features|Missing Features Table]] before flashing. If any of the missing features are critical to your setup, follow the [[Raspberry_Pi_Legacy|Legacy Software Installation Guide]] to install the legacy software.}}Use the '''Raspberry Pi Imager''', as outlined in the [https://www.raspberrypi.com/documentation/computers/getting-started.html#raspberry-pi-imager Raspberry Pi OS flashing guidelines], and follow the steps provided there. Along with the official guide, be sure to take into account the instructions provided in the following subsections.
-== Raspian ==
+===OS selection===
+To optimize resource usage and reduce unnecessary running services, choose the Raspberry Pi OS Lite image instead of the full Raspberry Pi OS image. During the OS selection process, navigate to the <code>Raspberry Pi OS (other)</code> submenu and select <code>Raspberry Pi OS Lite (64-bit)</code>.
-The latest Raspian image can be downloaded from [https://gitlab.com/librespacefoundation/satnogs/satnogs-pi-gen/-/jobs Gitlab.com].  On that page, look for the Download icon for the latest job (listed first on the page).
+===OS customization===
+At the very least, you need to:
-* [https://community.libre.space/t/raspbian-satnogs-client-images-available/1291 As of September 2017], the latest Raspian image can be downloaded [https://gitlab.com/librespacefoundation/satnogs/satnogs-pi-gen/-/jobs/31916682/artifacts/download here].
-** This may change; if the link no longer works, check the [https://gitlab.com/librespacefoundation/satnogs/satnogs-pi-gen/-/jobs jobs page and look for a more recent image].
-You will download a file named "artifacts.zip".  Unzip this to a convenient place.
+*Set username and password
+*Set locale settings
+**Time zone
+**Keyboard layout
+*Enable SSH
-You should verify the contents of that file by checking the SHA256 checksum.  On Linux, run "sha256sum -c sha256sums" like so:
-<pre>
+If connection to the internet is via Wi-Fi, make sure to '''Configure wireless LAN''' as well.
-/tmp $ cp ~/Downloads/artifacts.zip .
-/tmp $ unzip artifacts.zip
-Archive:  artifacts.zip
-  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
--09-10-Raspbian-SatNOGS-master-lite.info: OK
-image_2017-09-10-Raspbian-SatNOGS-master-lite.zip: OK
-</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:
+To easily discover the Rapsberry Pi among other Rapsberry Pis in your network, '''set a unique hostname'''.
-<pre>
+==Getting console access==
-/tmp/deploy $ unzip image_2017-09-10-Raspbian-SatNOGS-master-lite.zip
+You can log in the Raspberry Pi by connecting it to a keyboard and monitor or through network via an SSH connection.
-Archive:  image_2017-09-10-Raspbian-SatNOGS-master-lite.zip
-  inflating: 2017-09-10-Raspbian-SatNOGS-master-lite.img
-</pre>
-[https://www.raspberrypi.org/documentation/installation/installing-images/README.md Follow the usual Raspian flashing instructions], and boot your Raspberry Pi.
+===Keyboard and monitor===
+Once your Raspberry Pi is booted, log in with the username and password that you set during the flashing process.
-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.
+===Network===
+If your network supports [[wikipedia:Zero-configuration_networking|<code>zeroconf</code>]], you can use the hostname of your Raspberry Pi and log in with SSH using the username and password that you set during the flashing process. Example:
+  $ ssh pi@raspberrypi.local
+If <code>zeroconf</code> is not supported then you must manually find the IP address of the Raspberry Pi (e.g. in your router management interface).
-* Note: you can always reconfigure the software by running "sudo satnogs-setup -n" again.
+==Installation==
+To install the SatNOGS software on the Raspberry Pi OS or any other supported OS you just log, and execute the following command:
+ $ curl -sfL https://satno.gs/install | sh -s --
+This command executes the '''SatNOGS Setup''' tool which will install all the necessary software and then bring up the SatNOGS configuration menu-driven utility.
+Follow [[SatNOGS Setup]] instructions to configure the system.
+[[Category:Build]]
+[[Category:Software]]