SatNOGS Wiki - User contributions [en]

Raspberry Pi

2022-04-06T09:31:16Z

Pe0sat: /* Pi4 Workaround */

[[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]]]

==Introduction==

The Raspberry Pi (version 3 and 4) 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. Debian/Armbian, Arch, Fedora), but the one we suggest is our custom image based on latest Raspbian.

{{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.}}

==Download==
'''<big>Raspbian SatNOGS Image:</big> <big>[https://gitlab.com/librespacefoundation/satnogs/satnogs-pi-gen/-/jobs/artifacts/2020122700/download?job=release artifacts.zip]</big> ''' (Release: 2020122700)

Download the latest Raspbian SatNOGS Image from above (or via the "Download" icon on the right side of the [https://gitlab.com/librespacefoundation/satnogs/satnogs-pi-gen/tags latest tag page on GitLab]). This image has the SatNOGS setup script installed, the SSH server enabled ( 2021-11-15 edit by PE2BZ there is no ssh file in the boot partition, this has to be added else the Pi will not be accessible by SSH) and all required packages preinstalled. You will get an <code>artifacts.zip</code> file with the following content:

*A Zipped image file
*An Image info file
*A SHA256 checksum file

===Data integrity verification===

You should verify the data integrity of the artifacts by comparing the SHA256 checksums. On Linux, run <code>sha256sum -c sha256sums</code> in the directory where the artifacts are downloaded and unzipped.

Example:
<pre>
$ sha256sum -c sha256sums
2020-12-27-Raspbian-SatNOGS-master-lite.info: OK
image_2020-12-27-Raspbian-SatNOGS-master-lite.zip: OK
</pre>

===Pi4 Workaround===

With newer Pi4 models there where missing firmware files in the image, for now we have created a temporary solution.
The updated image can be downloaded via the following [https://cloud.libre.space/s/4cfcK6H4joCdyCm link]

Data integrity information:

<pre>
md5: 5128e134554ef32aa7eb31267305b302
sha256: c769ead89686f6b232a79f23637dedec018aa73982ec31e387e61d4d60029d52
</pre>

==Flashing==
[https://www.raspberrypi.org/documentation/installation/installing-images/README.md Follow the usual Raspbian flashing instructions], and boot your Raspberry Pi.

==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 username "'''pi'''" password "'''raspberry'''".

===Ethernet===
If you are using wired Ethernet you should get connectivity right away. You just need to find the IP address of Raspberry Pi (e.g. in your router management interface). Log in with SSH using username "'''pi'''" password "'''raspberry'''", for example:
$ ssh pi@192.168.1.2
If your network supports [[wikipedia:Zero-configuration_networking|<code>zeroconf</code>]], then you can use the hostname of your Pi:
$ ssh pi@raspberrypi.local

===Pre-boot wireless configuration===
If neither keyboard/monitor, nor a wired Ethernet are available, you can set up a WiFi connection before boot by mounting the boot partition of the flashed SD card and editing files directly. Note your OS may mount boot partition in a different location. [https://raspberrypi.stackexchange.com/questions/10251/prepare-sd-card-for-wifi-on-headless-pi#comment98121_57023 Windows users have line ending problems]. Suggested actions:

$ $EDITOR /media/Raspbian_SatNOGS-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
}

==Configuration==

===Raspberry Pi Setup===
Once your Raspberry Pi is booted, log in with username "'''pi'''" password "'''raspberry'''" and run:
<pre>
$ sudo raspi-config
</pre>

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; UTC is under the 'none of the above' submenu)
**set keyboard layout, again this is defaulting to a UK layout
**set wifi country
**expand filesystem (under the Advanced menu)
*Configure network or WiFi (see [https://www.raspberrypi.org/documentation/configuration/wireless/wireless-cli.md this doc for network configuration instructions])
*Finish and reboot

===SatNOGS Setup===
SSH to the Raspberry Pi with user "'''pi'''" and your new password.

Follow [[SatNOGS Client Setup]] instructions to configure the system.

[[Category:Build]]
[[Category:Software]]

Raspberry Pi

2022-04-06T08:49:11Z

Pe0sat:

[[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]]]

==Introduction==

The Raspberry Pi (version 3 and 4) 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. Debian/Armbian, Arch, Fedora), but the one we suggest is our custom image based on latest Raspbian.

{{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.}}

==Download==
'''<big>Raspbian SatNOGS Image:</big> <big>[https://gitlab.com/librespacefoundation/satnogs/satnogs-pi-gen/-/jobs/artifacts/2020122700/download?job=release artifacts.zip]</big> ''' (Release: 2020122700)

Download the latest Raspbian SatNOGS Image from above (or via the "Download" icon on the right side of the [https://gitlab.com/librespacefoundation/satnogs/satnogs-pi-gen/tags latest tag page on GitLab]). This image has the SatNOGS setup script installed, the SSH server enabled ( 2021-11-15 edit by PE2BZ there is no ssh file in the boot partition, this has to be added else the Pi will not be accessible by SSH) and all required packages preinstalled. You will get an <code>artifacts.zip</code> file with the following content:

*A Zipped image file
*An Image info file
*A SHA256 checksum file

===Data integrity verification===

You should verify the data integrity of the artifacts by comparing the SHA256 checksums. On Linux, run <code>sha256sum -c sha256sums</code> in the directory where the artifacts are downloaded and unzipped.

Example:
<pre>
$ sha256sum -c sha256sums
2020-12-27-Raspbian-SatNOGS-master-lite.info: OK
image_2020-12-27-Raspbian-SatNOGS-master-lite.zip: OK
</pre>

===Pi4 Workaround===

With newer Pi4 models there where missing firmware files in the image, for now we have created a temporary solution.
The updated image can be downloaded via the following (link)[https://cloud.libre.space/s/4cfcK6H4joCdyCm]

Data integrity information:

<pre>
md5: 5128e134554ef32aa7eb31267305b302
sha256: c769ead89686f6b232a79f23637dedec018aa73982ec31e387e61d4d60029d52
</pre>

==Flashing==
[https://www.raspberrypi.org/documentation/installation/installing-images/README.md Follow the usual Raspbian flashing instructions], and boot your Raspberry Pi.

==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 username "'''pi'''" password "'''raspberry'''".

===Ethernet===
If you are using wired Ethernet you should get connectivity right away. You just need to find the IP address of Raspberry Pi (e.g. in your router management interface). Log in with SSH using username "'''pi'''" password "'''raspberry'''", for example:
$ ssh pi@192.168.1.2
If your network supports [[wikipedia:Zero-configuration_networking|<code>zeroconf</code>]], then you can use the hostname of your Pi:
$ ssh pi@raspberrypi.local

===Pre-boot wireless configuration===
If neither keyboard/monitor, nor a wired Ethernet are available, you can set up a WiFi connection before boot by mounting the boot partition of the flashed SD card and editing files directly. Note your OS may mount boot partition in a different location. [https://raspberrypi.stackexchange.com/questions/10251/prepare-sd-card-for-wifi-on-headless-pi#comment98121_57023 Windows users have line ending problems]. Suggested actions:

$ $EDITOR /media/Raspbian_SatNOGS-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
}

==Configuration==

===Raspberry Pi Setup===
Once your Raspberry Pi is booted, log in with username "'''pi'''" password "'''raspberry'''" and run:
<pre>
$ sudo raspi-config
</pre>

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; UTC is under the 'none of the above' submenu)
**set keyboard layout, again this is defaulting to a UK layout
**set wifi country
**expand filesystem (under the Advanced menu)
*Configure network or WiFi (see [https://www.raspberrypi.org/documentation/configuration/wireless/wireless-cli.md this doc for network configuration instructions])
*Finish and reboot

===SatNOGS Setup===
SSH to the Raspberry Pi with user "'''pi'''" and your new password.

Follow [[SatNOGS Client Setup]] instructions to configure the system.

[[Category:Build]]
[[Category:Software]]

SatNOGS Ansible

2022-02-12T17:13:25Z

Pe0sat: Remark on the name selection for youruser.

==Introduction==

{{Warning|Follow these instructions only if you are provisioning SatNOGS to Debian from another host or are installing on the same host. }}

'''SatNOGS Client Ansible''' makes the actual provisioning of the '''SatNOGS Client''' system. It is called, under the hood, when applying the configuration using [[SatNOGS Client Setup|SatNOGS Client Setup utility]]. It currently supports Raspbian and Debian (stretch and buster).

==Raspbian==

For Raspberry Pi, which is the reference platform for SatNOGS, a custom Raspbian image with '''SatNOGS Client Ansible''' pre-installed is available. Installation instructions are given in the [[Raspberry_Pi| Raspberry Pi Setup Guide]].

==Debian==

These sections contain generic instructions for installing SatNOGS Client on a Debian system.

==Other distributions==

Other distributions are not supported by '''SatNOGS Client Ansible''', as the pre-built packages won't be compatible. Thus, while derived from Debian, '''SatNOGS Client Ansible''' is known to break for Ubuntu and Linux Mint. If you are an experienced user, a manual installation of all components could be possible.

==Installation Guide==
===Prerequisites===

*A target Debian system. To install Debian please follow the [https://www.debian.org/releases/stretch/installmanual Debian Installation Guide] and chose the net installer if you want to run a headless server. The target system can be the host itself.
*A user (referenced later as ''youruser'') which is member of 'sudo' group exists on the target system. Don't use the username `satnogs` when you install the Debian system.
*An SSH server running on the target system.
*Install installation dependencies: `sudo apt-get install ansible git sshpass python-setuptools`

===Installation===

On the host system run the following commands:
$ git clone <nowiki>https://gitlab.com/librespacefoundation/satnogs/satnogs-client-ansible.git</nowiki> # Clone SatNOGS Client Ansible repository
$ cd satnogs-client-ansible # Change to cloned repository directory
$ git checkout stable # Optionally, check out stable (Debian Buster 10) branch
$ cp -r production.dist production # Copy dist configuration
$ vi production/inventory/hosts # Update file with your own target host e.g. 127.0.0.1, user and SSH password
$ ssh youruser@yourtargetsystem true # Test SSH connection to target system
$ ansible-playbook -i production/inventory/hosts -K site.yml # Run Ansible playbook
$ ssh -t youruser@yourtargetsystem sudo satnogs-setup # Setup SatNOGS client (see below)

<br />

===Next Steps===

Follow [[SatNOGS_Client_Setup|SatNOGS Client Setup]] to configure your system and SatNOGS station.

[[Category:Build]]
[[Category:Software]]

SatNOGS Ansible

2022-02-12T16:45:12Z

Pe0sat: Update the installation with dependency packages that need to be installed.

==Introduction==

{{Warning|Follow these instructions only if you are provisioning SatNOGS to Debian from another host or are installing on the same host. }}

'''SatNOGS Client Ansible''' makes the actual provisioning of the '''SatNOGS Client''' system. It is called, under the hood, when applying the configuration using [[SatNOGS Client Setup|SatNOGS Client Setup utility]]. It currently supports Raspbian and Debian (stretch and buster).

==Raspbian==

For Raspberry Pi, which is the reference platform for SatNOGS, a custom Raspbian image with '''SatNOGS Client Ansible''' pre-installed is available. Installation instructions are given in the [[Raspberry_Pi| Raspberry Pi Setup Guide]].

==Debian==

These sections contain generic instructions for installing SatNOGS Client on a Debian system.

==Other distributions==

Other distributions are not supported by '''SatNOGS Client Ansible''', as the pre-built packages won't be compatible. Thus, while derived from Debian, '''SatNOGS Client Ansible''' is known to break for Ubuntu and Linux Mint. If you are an experienced user, a manual installation of all components could be possible.

==Installation Guide==
===Prerequisites===

*A target Debian system. To install Debian please follow the [https://www.debian.org/releases/stretch/installmanual Debian Installation Guide] and chose the net installer if you want to run a headless server. The target system can be the host itself.
*A user (referenced later as ''youruser'') which is member of 'sudo' group exists on the target system.
*An SSH server running on the target system.
*Install installation dependencies: `sudo apt-get install ansible git sshpass python-setuptools`

===Installation===

On the host system run the following commands:
$ git clone <nowiki>https://gitlab.com/librespacefoundation/satnogs/satnogs-client-ansible.git</nowiki> # Clone SatNOGS Client Ansible repository
$ cd satnogs-client-ansible # Change to cloned repository directory
$ git checkout stable # Optionally, check out stable (Debian Buster 10) branch
$ cp -r production.dist production # Copy dist configuration
$ vi production/inventory/hosts # Update file with your own target host e.g. 127.0.0.1, user and SSH password
$ ssh youruser@yourtargetsystem true # Test SSH connection to target system
$ ansible-playbook -i production/inventory/hosts -K site.yml # Run Ansible playbook
$ ssh -t youruser@yourtargetsystem sudo satnogs-setup # Setup SatNOGS client (see below)

<br />

===Next Steps===

Follow [[SatNOGS_Client_Setup|SatNOGS Client Setup]] to configure your system and SatNOGS station.

[[Category:Build]]
[[Category:Software]]