Raspberry Pi

2018-01-26T00:15:52Z

Captain morgan: satnogs-client is after SATNOGS_STATION_LON, not SATNOGS_STATION_LONG

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

= Intro =

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

= Raspbian =

== Download ==

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

=== 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 <code>sha256sum -c sha256sums</code> in the directory where the artifacts are downloaded

Example:
<pre>
$ sha256sum -c sha256sums
2017-09-29-Raspbian-SatNOGS-master-lite.info: OK
image_2017-09-29-Raspbian-SatNOGS-master-lite.zip: OK
</pre>

== Flashing ==
[https://www.raspberrypi.org/documentation/installation/installing-images/README.md 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 [https://www.raspberrypi.org/documentation/configuration/wireless/wireless-cli.md this doc for network configuration instructions].

== Initial 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)
** set keyboard layout, again this is defaulting to a UK layout
** set wifi country
** expand filesysten
* Finish and reboot

Next, run
<pre>
sudo apt-get update && sudo apt-get -y upgrade
</pre>

== Setup ==

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

# Run "sudo satnogs-setup"
# Select "Update" to update the configuration tool
# Set basic configuration
# Select "Apply" and the Raspberry Pi will configure itself; this may take some time
# Select "Back" to exit

* Note: you can always reconfigure the software by running "sudo satnogs-setup" again.

=== 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 <code><nowiki>https://network-dev.satnogs.org/api/</nowiki></code>; if you're working on the prod environment, this is <code><nowiki>https://network.satnogs.org/api/</nowiki></code>.

* '''SATNOGS_RX_DEVICE''': If you are using an RTL-SDR, this is <code>rtlsdr</code>. Other devices supported by gr-satnogs include <code>usrpb200</code>, <code>usrp2</code>, <code>airspy</code> or <code>hackrf</code>; a complete list can be found [https://gitlab.com/librespacefoundation/satnogs/gr-satnogs/blob/master/apps/flowgraphs/satellites/README.md here].

* '''SATNOGS_STATION_ELEV''': The elevation of your ground station in metres.

* '''SATNOGS_STATION_ID''': The ID assigned to your station in the SatNOGS network site (either stage or prod).

* '''SATNOGS_STATION_LAT''': The latitude of your station. North is positive, south is negative.

* '''SATNOGS_STATION_LON''': 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. If you don't have a rotator (like the [https://wiki.satnogs.org/No_rotator No rotator setup]), enter <code>False</code>.

* '''HAMLIB_UTILS_ROT_OPTS''': Options for rotcld. For a yaesu rotator, use <code>-m 601 -r /dev/ttyACM0 -s 9600 -T 0.0.0.0</code>

=== Advanced Setup ===

* '''SATNOGS_CLIENT_URL''': If you to try a development version of satnogs-client, you can change the URL here. The URL needs to be in [https://pip.pypa.io/en/stable/reference/pip_install PIP format]. Here are some examples:
** git+https://gitlab.com/librespacefoundation/satnogs/satnogs-client.git@0 -- the '0' branch (the current development version) of satnogs-client
** git+https://gitlab.com/jdoe/satnogs-client.git@new-feature -- the 'new-feature' branch of jdoe's fork of satnogs-client
* '''SATNOGS_RADIO_GR_SATNOGS_PACKAGE''': This options allows you to change the installed package of gr-satnogs. For example, to install nightly development builds use:
** https://gitlab.com/librespacefoundation/satnogs/gr-satnogs-package/-/jobs/artifacts/master/raw/build/debian/output/armhf/gr-satnogs_armhf.deb?job=nightly
* '''RF_GAIN''': RF Gain value for your SDR hardware. Defaults can be found [https://gitlab.com/librespacefoundation/satnogs/gr-satnogs/blob/master/python/hw_settings.py here].
** For rtl-sdr possible values are the following: 0.0 0.9 1.4 2.7 3.7 7.7 8.7 12.5 14.4 15.7 16.6 19.7 20.7 22.9 25.4 28.0 29.7 32.8 33.8 36.4 37.2 38.6 40.2 42.1 43.4 43.9 44.5 48.0 49.6

{{Message|Changing these settings is ''not'' recommended unless you're developing SatNOGS.}}

== Updating ==

To update SatNOGS software, re-run <code>sudo satnogs-setup</code>. Select "Update" to pull the latest Ansible playbook and then "Apply" to apply any updates.

Raspbian packages can be updated using the normal APT updating methods (e.g. <code>apt-get upgrade</code> or <code>aptitude</code>).

WARNING: An update can potentially interrupt a running observation!

== Testing ==

To see if satnogs-client has started successfully, check the logs with journalctl:

<pre>
journalctl -u satnogs-client.service
</pre>

You should see entries running approximately once per minute that look like this:

<pre>
Oct 01 23:02:13 raspberrypi satnogs-client[6695]: * Running on http://0.0.0.0:5000/ (Press CTRL+C to quit)
Oct 01 23:02:14 raspberrypi satnogs-client[6695]: 2017-10-01 23:02:14,466 - satnogsclient - INFO - [LD] Downlink thread waiting for first downlink packet
Oct 01 23:03:14 raspberrypi satnogs-client[6695]: 2017-10-01 23:03:14,450 - apscheduler.executors.default - INFO - Running job "get_jobs (trigger: interval[0:01:00], next run at: 2017-10-01 23:03:14 UTC)" (scheduled at 2017-10-01 23:03:14.423393+00:00)
Oct 01 23:03:47 raspberrypi satnogs-client[6695]: 2017-10-01 23:03:47,324 - satnogsclient - DEBUG - Opening TCP socket: 127.0.0.1:5011
Oct 01 23:03:47 raspberrypi satnogs-client[6695]: 2017-10-01 23:03:47,325 - satnogsclient - DEBUG - Sending message: []
Oct 01 23:03:47 raspberrypi satnogs-client[6695]: 2017-10-01 23:03:47,327 - apscheduler.executors.default - INFO - Job "get_jobs (trigger: interval[0:01:00], next run at: 2017-10-01 23:04:14 UTC)" executed successfully
Oct 01 23:04:14 raspberrypi satnogs-client[6695]: 2017-10-01 23:04:14,453 - apscheduler.executors.default - INFO - Running job "get_jobs (trigger: interval[0:01:00], next run at: 2017-10-01 23:04:14 UTC)" (scheduled at 2017-10-01 23:04:14.423393+00:00)
Oct 01 23:04:14 raspberrypi satnogs-client[6695]: 2017-10-01 23:04:14,484 - apscheduler.executors.default - INFO - Running job "post_data (trigger: interval[0:02:00], next run at: 2017-10-01 23:04:14 UTC)" (scheduled at 2017-10-01 23:04:14.436367+00:00)
Oct 01 23:04:14 raspberrypi satnogs-client[6695]: 2017-10-01 23:04:14,489 - apscheduler.executors.default - INFO - Job "post_data (trigger: interval[0:02:00], next run at: 2017-10-01 23:04:14 UTC)" executed successfully
Oct 01 23:04:15 raspberrypi satnogs-client[6695]: 2017-10-01 23:04:15,627 - satnogsclient - DEBUG - Opening TCP socket: 127.0.0.1:5011
Oct 01 23:04:15 raspberrypi satnogs-client[6695]: 2017-10-01 23:04:15,628 - satnogsclient - DEBUG - Sending message: []
Oct 01 23:04:15 raspberrypi satnogs-client[6695]: 2017-10-01 23:04:15,629 - apscheduler.executors.default - INFO - Job "get_jobs (trigger: interval[0:01:00], next run at: 2017-10-01 23:05:14 UTC)" executed successfully
</pre>

You can also try visiting satnog-client's web interface. In your browser, go to '''<nowiki>http://(ip address of your raspberry pi):5000</nowiki>'''. You should see something like this:

[[File:SatNOGS_client_screenshot.png|400px|thumb|center|SatNOGS client web page]]

If you see that, great -- you're ready to [[Operation|schedule your first observation]]! If not, check out the [[Troubleshooting]] page.

= Fedora =

Instructions for installing on Fedora can be found [[Fedora_Installation|here]].

SatNOGS Wiki - User contributions [en]

Raspberry Pi