spacecruft
/
SNOUG
1
0
Fork 1
Code Packages Releases 14 Activity

KStars steps

glossary
Jeff Moe 2022-09-01 19:51:39 -06:00
parent 5b081cd340
commit 9c0a62d08f
2 changed files with 133 additions and 88 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
src/Glossary.tex
View File

@ -436,3 +436,4 @@
% gpsd
% List of Software ?
% NTP
% IP

220
src/Software.tex
View File

@ -374,96 +374,9 @@ There are applications for using PTZ control of cameras, such as used in
I don't know of any of these being used in satellite tracking prototypes
at present.
\section{KStars}
\label{sec:software-overview}
\index{software}\index{KStars}\index{Debian}
KStars is an application that has been used for years in the astronomy
community. It is well established, well supported and included in \gls{Debian}.
KStars has multiple uses for imaging \glspl{satellite}.
One main use is to control a telescope tracking mount, such as the
hardware described in section \ref{sec:hardware-mounts}, page \pageref{sec:hardware-mounts}.
For the purposes here, described below will be using KStars with a
Sky-Watcher tracking mount with INDI and Ekos.
See figure \ref{fig:video-enclosure-mount-tripod}, page \pageref{fig:video-enclosure-mount-tripod}
for a photo of the setup used with KStars below.
The telescope mount will be used in sidereal tracking mode,
where the stars will appear as
``points'', and the \glspl{satellite} will appear as trails.
The mount is not used in a satellite tracking mode.
Sidereal is the ``standard'' tracking mode of \glspl{telescope}.
\index{Sky-Watcher}\index{INDI}\index{Ekos}
KStars is the ``main'' application, but it depends on other key parts.
\gls{INDI} is the protocol that KStars uses for telescope control.
\gls{INDI} itself is a collection of applications.
While KStars has the main sky chart and Ekos is launched within it,
the actual mount control is done with the Ekos application.
While it may sound complex, all of this is set up pretty easily in
\gls{Debian}.
\begin{minted}{sh}
# Quick and dirty from memory, something like:
sudo apt update
sudo apt install kstars indi-bin indi-eqmod indi-gpsd
\end{minted}
KStars has a sky chart, as can be see in figure \ref{fig:kstars-skychart},
page \pageref{fig:kstars-skychart}.
When mount control is functioning, a location on the sky chart, such as a star,
can be clicked on and the mount will go to that location and optionally track it.
Using this, a telescope mount can be used to easily point the camera at a location
and track it to observe telescopes. It should also provide a superior \gls{FITS} file
for extracting data than using a static mount (XXX made up).
\index{KStars}\index{sky chart}\index{GOTO}\index{mount}\index{track}
To fully set up a telescope tracking mount, the following steps need to be performed in
roughly this order:
\begin{mdframed}[backgroundcolor=blue!10,linecolor=blue!30]
\begin{enumerate}
\item Physically mount all hardware.
\item Plug in and power everything up.
\item Confirm all hardware looks ok (e.g. \texttt{lsusb}).
\item Confirm GNSS time and location are ok (e.g. \texttt{cgps -u m}).
\item Conr
\end{enumerate}
\end{mdframed}
\index{mount}\index{KStars}\index{telescope}\index{track}
\index{lsusb}\index{cgps}\index{GNSS}
\begin{sidewaysfigure}[p!]
\begin{center}
\includegraphics[keepaspectratio=true,height=1.00\textheight,width=1.00\textwidth,angle=0]{kstars-skychart.png}
\caption{KStars sky chart, example screenshot.}
\index{KStars}\index{sky chart}
\label{fig:kstars-skychart}
\end{center}
\end{sidewaysfigure}
\begin{sidewaysfigure}[p!]
\begin{center}
\includegraphics[keepaspectratio=true,height=1.00\textheight,width=1.00\textwidth,angle=0]{kstars-profile-edit-v4l2.png}
\caption{KStars using V4L2, example screenshot.}
\index{KStars}\index{V4L2}
\label{fig:kstars-profile-edit-v4l2}
\end{center}
\end{sidewaysfigure}
\begin{sidewaysfigure}[p!]
\begin{center}
\includegraphics[keepaspectratio=true,height=1.00\textheight,width=1.00\textwidth,angle=0]{kstars-profile-edit-simulator.png}
\caption{KStars using simulated CCD, example screenshot.}
\index{KStars}\index{CCD}
\label{fig:kstars-profile-edit-simulator}
\end{center}
\end{sidewaysfigure}
\section{GNSS with \texttt{gpsd}}
\label{sec:software-overview}
\label{sec:software-gnss}
\index{GNSS}\index{GPS}\index{Galileo}\index{GLONASS}\index{Beidou}
\index{gpsd}
@ -585,6 +498,7 @@ See below for sample output from \texttt{cgps}.
\end{minted}
\index{cgps}
\section{NTP}
\label{sec:software-ntp}
\index{NTP}
@ -624,3 +538,133 @@ sudo systemctl start ntp
Go through each of the systems used in the toolchain and make
sure they all have accurate time or everything will be off.
\section{KStars}
\label{sec:software-kstars}
\index{software}\index{KStars}\index{Debian}
KStars is an application that has been used for years in the astronomy
community. It is well established, well supported and included in \gls{Debian}.
KStars has multiple uses for imaging \glspl{satellite}.
One main use is to control a telescope tracking mount, such as the
hardware described in section \ref{sec:hardware-mounts}, page \pageref{sec:hardware-mounts}.
For the purposes here, described below will be using KStars with a
Sky-Watcher tracking mount with INDI and Ekos.
See figure \ref{fig:video-enclosure-mount-tripod}, page \pageref{fig:video-enclosure-mount-tripod}
for a photo of the setup used with KStars below.
The telescope mount will be used in sidereal tracking mode,
where the stars will appear as
``points'', and the \glspl{satellite} will appear as trails.
The mount is not used in a satellite tracking mode.
Sidereal is the ``standard'' tracking mode of \glspl{telescope}.
\index{Sky-Watcher}\index{INDI}\index{Ekos}
KStars is the ``main'' application, but it depends on other key parts.
\gls{INDI} is the protocol that KStars uses for telescope control.
\gls{INDI} itself is a collection of applications.
While KStars has the main sky chart and Ekos is launched within it,
the actual mount control is done with the Ekos application.
While it may sound complex, all of this is set up pretty easily in
\gls{Debian}.
\begin{minted}{sh}
# Quick and dirty from memory, something like:
sudo apt update
sudo apt install kstars indi-bin indi-eqmod indi-gpsd
\end{minted}
KStars has a sky chart, as can be see in figure \ref{fig:kstars-skychart},
page \pageref{fig:kstars-skychart}.
When mount control is functioning, a location on the sky chart, such as a star,
can be clicked on and the mount will go to that location and optionally track it.
Using this, a telescope mount can be used to easily point the camera at a location
and track it to observe telescopes. It should also provide a superior \gls{FITS} file
for extracting data than using a static mount (XXX made up).
\index{KStars}\index{sky chart}\index{GOTO}\index{mount}\index{track}
To use a telescope tracking mount for use with \texttt{stvid}, the following steps need to be performed in
roughly this order, assuming everything has been configured.
A brief overview of steps:
\index{stvid}
\begin{mdframed}[backgroundcolor=blue!10,linecolor=blue!30]
\begin{enumerate}
\item Physically mount all hardware.
\item Plug in and power everything up.
\item Confirm all hardware looks ok (e.g. \texttt{lsusb}).
\item Confirm GNSS time and location are ok (e.g. \texttt{cgps -u m}).
See section \ref{sec:software-gnss}, page \pageref{sec:software-gnss}.
\item Confirm time is correct on all systems in toolchain (e.g. \texttt{date}).
See section \ref{sec:software-ntp}, page \pageref{sec:software-ntp}.
\item Run camera configuration script (e.g. \texttt{v4l2-ctl} commands).
\item Start \texttt{indiserver} on the embedded computer.
\item Start KStars on the workstation.
\item Launch Ekos within KStars.
\item In Ekos, select a configuration with the EQ Mount for the Sky-Watcher,
and \texttt{V4L2} for the CCD, which will work with The Imaging Source
camera used in this example. Alternatively, the ZWO ASI could be used with a similar configuration.
\item The Ekos configuration should also be set to use the remote \texttt{indiserver}
IP address of the embedded computer USB connected to the Sky-Watcher mount.
\item Hit the start button to start Ekos/INDI.
\item On the screen that pops up, confirm all the tabs are good.
\item Check the last configuration tab for the camera, it often
resets the size.
\item Hit close on the screen with the INDI devices.
\item Click the mount icon, and start tracking.
\item Perhaps do some focusing... XXX
\item Click the solver icon.
\item Click the Sync radio button.
\item Click Capture and Solve. XXX what is it.
\item If everything is tracking happily, good.
\item If not, do all the alignment steps.
\item When alignment is good and tracking is accurate, stop Ekos and close it.
\item Select the INDI configuration with a remote \texttt{indiserver},
the EQ Mount, and the Simulated \gls{CCD}.
\item Hit start in Ekos to get INDI connections going.
\item Confirm all is ok in hardware tabs, then hit close.
\item Now in the KStars sky chart window there is control of the mount without
interfering with the camera.
\item Start \texttt{stvid}. See XXX for more info.
\item When done capturing that part of the sky with \texttt{stvid},
stop \texttt{stvid}
\item Go to the KStars sky chart and right-click on the new location,
and slew to it.
\item Start \texttt{stvid} again, pointing at the new location.
\item Repeat the last few steps each time a new sky location is desired.
\end{enumerate}
\end{mdframed}
\index{v4l2-ctl}\index{mount}\index{KStars}\index{telescope}\index{track}
\index{lsusb}\index{cgps}\index{GNSS}\index{NTP}\index{indiserver}
\index{Ekos}\index{Sky-Watcher}\index{V4L2}\index{The Imaging Source}
\index{stvid}
\begin{sidewaysfigure}[p!]
\begin{center}
\includegraphics[keepaspectratio=true,height=1.00\textheight,width=1.00\textwidth,angle=0]{kstars-skychart.png}
\caption{KStars sky chart, example screenshot.}
\index{KStars}\index{sky chart}
\label{fig:kstars-skychart}
\end{center}
\end{sidewaysfigure}
\begin{sidewaysfigure}[p!]
\begin{center}
\includegraphics[keepaspectratio=true,height=1.00\textheight,width=1.00\textwidth,angle=0]{kstars-profile-edit-v4l2.png}
\caption{KStars using V4L2, example screenshot.}
\index{KStars}\index{V4L2}
\label{fig:kstars-profile-edit-v4l2}
\end{center}
\end{sidewaysfigure}
\begin{sidewaysfigure}[p!]
\begin{center}
\includegraphics[keepaspectratio=true,height=1.00\textheight,width=1.00\textwidth,angle=0]{kstars-profile-edit-simulator.png}
\caption{KStars using simulated CCD, example screenshot.}
\index{KStars}\index{CCD}
\label{fig:kstars-profile-edit-simulator}
\end{center}
\end{sidewaysfigure}