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