|
|
| Line 53: |
Line 53: |
| | * Finish and reboot | | * Finish and reboot |
| | | | |
| − | Next, run
| + | == SatNOGS Setup == |
| − | <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). | | SSH to the Raspberry Pi with user "pi" and password "raspberry" (no quotes). |
| | | | |
| − | # Run "sudo satnogs-setup"
| + | Follow [[SatNOGS_Client_Ansible#SatNOGS_Client_Setup|SatNOGS Client Setup]] instructions to configure the system. |
| − | # 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 = | | = Fedora = |
| | | | |
| | Instructions for installing on Fedora can be found [[Fedora_Installation|here]]. | | Instructions for installing on Fedora can be found [[Fedora_Installation|here]]. |
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 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 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.
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.
Initial 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.
