search

rlancaste / AstroPi3

GNU General Public License v3.0
96 stars 31 forks source link

readme

AstroPi3

This script is meant to automate the many setup steps involved with configuring a Raspberry Pi 3b, 3b+, 4 or similar single board computer (SBC) running Ubuntu or Raspbian, so that it can be an Astrophotography hub using INDI, KStars, and Ekos. I first developed the series of steps by research, trial, and error in 2016. Then several users on indilib.org, especially James Taylor ( u2pilotjt ), tested my steps and helped me revise them. James Taylor wrote a beginners guide which can be accessed here: http://www.indilib.org/support/tutorials/169-ekos-on-raspberry-pi-complete-guide.html In Fall 2017, I was configuring another PI, went back to my instructions and his guide and followed both. I revised my steps and then turned it into this script. Hopefully this is much easier to use.

Running KStars on Pi 3 Running Ekos on Pi 3 Running Ekos on 64 bit SBC Running Ekos on 64 bit SBC

Before running the script, please be sure to do some research and read up on all that it will do to your Raspberry Pi or other SBC. You may want to use the script as is or add or remove certain lines before running it by adding or removing comment symbols from the front of the line (#).

When you are ready, you can follow these steps:

  1. Download latest version of an image for your SBC. Some sources:

    If you are using a different SBC, you should find an appropriate image for your system. My scripts so far are all based on Ubuntu or Raspbian, so you should probably get an image that is Ubuntu or Raspbian for now.

  2. You will need to flash that img file to the SD card. The easiest way to do this is to download the free program Etcher (https://etcher.io)

  3. Drag and drop the disk image you downloaded into etcher along with the mounted SD card. Click to initialize the flash.

  4. If you are installing Ubuntu-MATE on the Pi 3 (not the Pi 4) you will need to edit the /boot/config.txt file before you remove it from your computer. Apparently there is an issue where one of the settings is optimized for the Pi 4, but does not work on the Pi 3. Luckily it is a fairly simple solution. Just change

    dtoverlay=vc4-fkms-v3d

    To:

    dtoverlay=vc4-kms-v3d,cma-64,cma-128

    For reference: https://bugs.launchpad.net/ubuntu/+source/linux-raspi/+bug/1889223

  5. Insert the SD Card into the SBC, connect a mouse, keyboard, and display. Also be sure to connect it to the internet with an Ethernet Cord (not WIFI, since it might lose the connection later) Then turn it on. Often the SBC will reboot the first time to resize the partition. Note: Until you finish the script, be sure to keep an HDMI display connected while you are setting up the pi, so that the HDMI connection does not go to sleep. Also be sure to keep it connected to Ethernet, not WIFI, since it will probably lose the connection and not finish halfway through if you use wifi. (Once you have run the script, you can plug in an HDMI monitor or use WIFI at any time)

  6. You should get a setup window if you are using a Raspberry Pi running Ubuntu-MATE that will allow you to setup your login name and computer name. This is difficult to change later, so set it up carefully. Note that it may say your name is unavailable at first, but when you enter your login name that may change. After the configuration, your pi will restart. You may need to restart it again to get your wifi network connection started. If you are running Raspbian or some other SBC, you might not have the option to setup the login name or computer name in the setup script. I would recommend that you try to do this before you run my script.

  7. Copy the scripts in this GIT Repo to your SBC and Open a Terminal Window. You could type the following commands into Terminal to accomplish this goal.

    sudo apt-get install git

git clone https://github.com/rlancaste/AstroPi3.git

  8. Navigate to the Folder containing the script. Assuming you typed the above commands, you can type the following to do this:

    cd AstroPi3

  9. Run one of the following scripts using sudo. Choose the right one for your system.

    • The setupAstroPi3.sh is for a Raspberry Pi 3b or 3b+ running Ubuntu-Mate in the armhf architecture.
    • The setupUbuntuSBC.sh script is for an SBC system running Ubuntu on any architecture such as an Odroid C2.
    • The setupDebianSBC.sh script is for an SBC system running Debian on any architecture such as a Rock64.

    • The setupRaspbianPi.sh script is for a Raspberry Pi running Raspbian.

      sudo ./setupAstroPi3.sh

      sudo ./setupUbuntuSBC.sh

      sudo ./setupDebianSBC.sh

      sudo ./setupAstroRaspbianPi.sh

Here is a list of what the script does (If you want to disable or modify any of these, please edit before running the script):

Icons included in repo: The icons for INDI, KStars, and PHD2 are included in their respective packages and are the same no matter what operating system you are currently using. The icons I used for my scripts in the utilities folder are available freely on Ubuntu-MATE systems, but are not all available on other operating systems. To make them appear the same on different systems, I have included these in the icons folder. These are listed below with their respective source and copyright info:

irda.png (Hicolor icon theme, GPL) mate-preferences-desktop-display.svg (Hicolor icon theme, GPL) plip.png (Hicolor icon theme, GPL) preferences-system-network.svg (MATE icon theme, GPL) system-software-update.svg (Humanity icon theme, GPL) system-upgrade.svg (MATE icon theme, GPL)