Difference between revisions of "Raspberry Pi"
From SatNOGS Wiki
(Correct link to Raspbian images on Gitlab (the previous link was to down load the repository, not the images)) |
(Add basic walkthrough for Raspbian/Ansible setup) |
||
| Line 1: | Line 1: | ||
= Intro = | = Intro = | ||
| + | |||
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: | 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: | ||
| Line 14: | Line 15: | ||
== Download == | == Download == | ||
| + | |||
The latest Raspbian SatNOGS image artifacts can be downloaded from [https://gitlab.com/librespacefoundation/satnogs/satnogs-pi-gen/-/jobs GitLab]. | The latest Raspbian SatNOGS image artifacts can be downloaded from [https://gitlab.com/librespacefoundation/satnogs/satnogs-pi-gen/-/jobs GitLab]. | ||
=== Artifacts list === | === Artifacts list === | ||
| + | |||
The current artifacts list consists of: | The current artifacts list consists of: | ||
* A Zipped image file | * A Zipped image file | ||
| Line 23: | Line 26: | ||
== Data integrity verification == | == 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 | 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 | ||
| Line 31: | Line 35: | ||
image_2017-09-10-Raspbian-SatNOGS-master-lite.zip: OK | image_2017-09-10-Raspbian-SatNOGS-master-lite.zip: OK | ||
</pre> | </pre> | ||
| + | |||
== Flashing == | == Flashing == | ||
| Line 42: | Line 47: | ||
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. | 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. | ||
| − | * Note: you can always reconfigure the software by running "sudo satnogs-setup -n" again. | + | * Note: you can always reconfigure the software by running "sudo satnogs-setup -n" again. |
| + | |||
| + | * Note: You may find further details about the following options on the [http://satnogs.readthedocs.io/en/stable/satnogs-client/doc/raspi-install.html satnogs.readthedocs.io] page. | ||
| + | |||
| + | === Basic setup === | ||
| + | |||
| + | * '''SATNOGS_API_TOKEN''': The API token assigned to your ground station on the SatNOGS Network website. | ||
| + | * '''SATNOGS_NETWORK_API_URL''': The API for the SatNOGS network site. If you're working on the stage environment, this is https://network-dev.satnogs.org/api/; if you're working on the prod environment, this is https://network.satnogs.org/api/. | ||
| + | * '''SATNOGS_RX_DEVICE''': If you are using an RTL-SDR, odds are this is /dev/dvb/adapter0. | ||
| + | * '''SATNOTS_STATION_ELEV''': The elevation of your ground station in metres. | ||
| + | * '''SATNOTS_STATION_ID''': The ID assigned to your station in the SatNOGS network site (either stage or prod). | ||
| + | * '''SATNOTS_STATION_LAT''': The latitude of your station. North is positive, south is negative. | ||
| + | * '''SATNOTS_STATION_LONG''': The longitude of your station. East is positive, west is negative. | ||
| + | * '''HAMLIB_UTILS_ROT_ENABLED''': Whether or not to enable the Hamlibs rotator daemon. Rotctld is a software daemon that provides a network server to control a rotator on a serial port. '''Note:''' even if you [https://wiki.satnogs.org/No_rotator do not have a rotator], you'll want to enable this; see the next option for details. | ||
| + | * '''HAMLIB_UTILS_ROT_OPTS''': Options for rotcld. '''If you don't have a rotator, set this to <code>-m 1</code>'''; see [https://community.libre.space/t/raspbian-satnogs-client-image-issues/1319/10 here] for details. | ||
== Updating == | == Updating == | ||
| + | |||
To update SatNOGS software, re-run <code>sudo satnogs-setup</code>. This will pull the latest Ansible playbook and update if necessary. | To update SatNOGS software, re-run <code>sudo satnogs-setup</code>. This will pull the latest Ansible playbook and update if necessary. | ||
Revision as of 21:16, 1 October 2017
Contents
Intro
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:
- Using Fedora for ARM, and following the instructions at satnogs.readthedocs.io
- Installing the custom-built SatNOGS Raspbian image
Fedora
Start by downloading the "Server" or "Minimal" image from the the Fedora ARM project page. After that, follow the instructions at satnogs.readthedocs.io.
- If you run into anything in the instructions that is unclear, please submit an issue against the documentation repository.
Raspbian
Download
The latest Raspbian SatNOGS image artifacts can be downloaded from GitLab.
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-10-Raspbian-SatNOGS-master-lite.info: OK image_2017-09-10-Raspbian-SatNOGS-master-lite.zip: OK
Flashing
Follow the usual Raspbian flashing instructions, and boot your Raspberry Pi.
Networking
If you are using wired Ethernet you should get connectivity right away. If you are using wireless then see this doc for network configuration instructions.
Setup
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.
- Note: you can always reconfigure the software by running "sudo satnogs-setup -n" again.
- Note: You may find further details about the following options on the satnogs.readthedocs.io page.
Basic setup
- SATNOGS_API_TOKEN: The API token assigned to your ground station on the SatNOGS Network website.
- SATNOGS_NETWORK_API_URL: The API for the SatNOGS network site. If you're working on the stage environment, this is https://network-dev.satnogs.org/api/; if you're working on the prod environment, this is https://network.satnogs.org/api/.
- SATNOGS_RX_DEVICE: If you are using an RTL-SDR, odds are this is /dev/dvb/adapter0.
- SATNOTS_STATION_ELEV: The elevation of your ground station in metres.
- SATNOTS_STATION_ID: The ID assigned to your station in the SatNOGS network site (either stage or prod).
- SATNOTS_STATION_LAT: The latitude of your station. North is positive, south is negative.
- SATNOTS_STATION_LONG: The longitude of your station. East is positive, west is negative.
- HAMLIB_UTILS_ROT_ENABLED: Whether or not to enable the Hamlibs rotator daemon. Rotctld is a software daemon that provides a network server to control a rotator on a serial port. Note: even if you do not have a rotator, you'll want to enable this; see the next option for details.
- HAMLIB_UTILS_ROT_OPTS: Options for rotcld. If you don't have a rotator, set this to
-m 1; see here for details.
Updating
To update SatNOGS software, re-run sudo satnogs-setup. This will pull the latest Ansible playbook and update if necessary.
Raspbian packages can be updated using the normal APT updating methods (e.g. apt-get upgrade or aptitude).
WARNING: An update can potentially interrupt a running observation!
