RASC Halifax Centre - Setup the Raspberry Pi4 for the SCO HyperStar system

These instructions were written after-the-fact, so there are errors and omissions.

1. Initial setup (already done)

First off, acquire an Raspberry Pi microprocessor (in my case donated by Dave Chapman with 4G RAM and micro SD memory).
Donated hardware by Jane and Alfred Howard: Celestron AUX, 8" Celestron Edge HD SCT, HyperStar, Atik 428ex 1931 x 1451 pixel colour CCD.
Downloaded Rob Lancaste's excellent AstroPi3 installer script from GitHub - rlancaste/AstroPi3. This script automates the many setup steps involved with configuring a Raspberry Pi or similar single board computer (SBC) running Ubuntu or Raspbian, so that it can be an Astrophotography hub using INDI, KStars, and Ekos. Follow the instructions on that GitHub page to create a bootable microSD OS image and run this script to install the astronomy software.
```
sudo ./setupUbuntuSBC.sh
```
In this case we chose the option to install the x11vnc VNC server, as well as creation of it's own automatic hot-spot when no known networks are found.
After connecting the RPi to an HDMI display, attaching a keyboard, mouse and providing an ethernet cable link to the home router, power up the RPi.
With the ethernet connection active, download NoMachine Remote Desktop software, the ARMv8 DEB installation and install that on the RPi. I chose this approach based on discussions on https://www.indilib.org/forum/recent.html. If you don't want to use this software, the AstroPi3 installer script will install alternatives (below).
With NoMachine running as a Remote Desktop server disconnect the HDMI, keyboard and mouse and access the RPi via an installation of NoMachine (on the MacBook Pro) (a RPi reboot permitted the Remote Desktop to be reconfigured to a lower readable pixel density).
When that is completed, launch KStars to complete the initialization of KStars and test it using the telescope simulators.
Connect the physical telescope equipment to the RPi and create a new Profile in EKOS containing the matching drivers for each of your devices. In my case we are using Celestron AVX mount, Starizona microlight focuser, Atik 428ex camera.
Download the Astrometry.net Index files (to allow StellarSolver to plate solve) via the Solver Options Index Files dialog. I chose to update files at the predefined Location: /home/odroid/.local/share/kstars/astrometry. There are check boxes that allow KStars to download these files for you. You don't need to download the most detailed (largest) indexes, depending on the Field of View of you scope/camera.
Generate an Artificial Horizon polygon for the KStars desktop planetarium to provide a visual indicator of your unobstructed view.
I our use case, there is no need to use Phd2 (included) for guiding and haven't a profile configured for this scenario.
After noticing some warnings about missing locale during the software updates, I ran
```
sudo dpkg-reconfigure locales
sudo localectl set-locale LANG=en_CA.UTF-8
```
to set up my locale for my language/country e.g. en_CA.UTF-8. (A reboot was required to have locale show the updated info)

Installing Source code version of KStars

The 1st step is from https://github.com/KDE/kstars

A shell script to automate Installing Kstars/Indi from their git repositories

Link to repository gitea.nouspiro.space/nou/astro-soft-build

Before running this script uninstall INDI and KStars from repository.

Steps:

Clone git repository git clone gitea.nouspiro.space/nou/astro-soft-build.git
Enter cloned directory cd astro-soft-build
Install dependencies by running ./install-dependencies.sh This need to be done only first time.
If you are using QHY camera then run ./build-fxload.sh
Run one of build-soft-stable.sh or build-soft-latest.sh

For general use run stable version. Use latest version if you want to test new bleeding edge feature in development.
Latest build sometimes fail because some breaking change in base indi and not every driver was updated. In this case try to wait day and try again.
If stable build fail try remove all build-* directories in $HOME/astro-soft or $HOME/astro-soft-stable

I update stable script when new stable version of INDI is released so to get latest version run

Enter astro-soft-build directory

Run git pull origin

Run one of build-soft-stable.sh or build-soft-latest.sh

Configure novnc SSL

raspberrypi@raspberrypi-desktop:~$ openssl req -x509 -nodes -newkey rsa:3072 -keyout novnc.pem -out novnc.pem -days 3650
-----
You are about to be asked to enter information that will be incorporated into your certificate request.
What you are about to enter is what is called a Distinguished Name or a DN.
There are quite a few fields but you can leave some blank
For some fields there will be a default value,
If you enter '.', the field will be left blank.
-----
Country Name (2 letter code):CA
State or Province Name (full name):Nova-Scotia
Locality Name (eg, city):Halifax
Organization Name (eg, company):RASC-Halifax
Organizational Unit Name (eg, section):
Common Name (e.g. server FQDN or YOUR name):SCO
Email Address:j******.com

# launch novnc
/usr/share/novnc/utils/launch.sh --cert /usr/share/novnc/novnc.pem --web /usr/share/novnc
# install novnc as a service
sudo --preserve-env bash -c 'cat > /lib/systemd/system/novnc.service' << EOF
[Unit]
Description=Start novnc at startup.
After=multi-user.target
[Service]
Type=simple
ExecStart=/usr/share/novnc/utils/launch.sh --cert /usr/share/novnc/novnc.pem --web /usr/share/novnc
[Install]
WantedBy=multi-user.target
EOF
######################
# This enables the Service so it runs at startup
sudo systemctl enable novnc.service
sudo systemctl daemon-reload
# launch vnc server
sudo /usr/bin/x11vnc -auth guess -forever -loop -noxdamage -repeat -rfbauth /etc/x11vnc.pass -rfbport 5900 -shared

# install x11vnc as a service
# Note: RealVNC does not work on non-Raspberry Pi ARM systems as far as I can tell.
# This will install x11vnc instead
sudo apt -y install x11vnc
# This will get the password for VNC
x11vnc -storepasswd /etc/x11vnc.pass
# This will store the service file.
######################
sudo --preserve-env bash -c 'cat > /lib/systemd/system/x11vnc.service' << EOF
[Unit]
Description=Start x11vnc at startup.
After=multi-user.target
[Service]
Type=simple
ExecStart=/usr/bin/x11vnc -auth guess -forever -loop -noxdamage -repeat -rfbauth /etc/x11vnc.pass -rfbport 5900 -shared
[Install]
WantedBy=multi-user.target
EOF
######################
# This enables the Service so it runs at startup
sudo systemctl enable x11vnc.service
sudo systemctl daemon-reload

Auto start Kstars and EKOS

Created the indiwebmanager.service by opening http://localhost:8624/ in Firefox on the RPi4 and creating a new profile "SCO-AVX+HyperStar+Atik"

by choosing the Atik CCD, Celestron Advanced VX HC and Microtouch Drivers

using the default Port 7624 and configured to Auto Start and Auto Connect.

2. Reference Manuals

KStars Manual

: Last Updated: 09 May 2024; Hits: 124

Setup the Raspberry Pi4 for the SCO HyperStar system