Differences

This shows you the differences between two versions of the page.

--- software [2025/04/09 20:25] – holtz
+++ software [2025/05/10 18:09] (current) – holtz
@@ Line 32: / Line 32: @@
 This will also provide instantiations of all of the Alpaca devices: Telescope as T, Dome as D, Safetymonitor as S, Cameras as C[], Switches as SW[], Focussers as F[].
-Documentation is also available at http://aposong.readthedocs.io
+Documentation is available at http://aposong.readthedocs.io
 ===== Robotic software =====
@@ Line 38: / Line 38: @@
 Alternatively, a robotic client is implemented in the robotic.py module in this APOsong repository. This makes use of the command set provided by aposong.py, but adds in functionality for opening and closing the dome at appropriate times and under appropriate conditions, and selecting targets and exposure sequences from entries in the Postgres database.
+For SONG operation, robotic operations will be conducted through Postgres database syncs from Aarhus, details TBD when this is implemented ...
+===== song1m computer =====
+This is the main computer interface. It is a virtual machine running on a box in the APO server room. Use the song account to log in. Once all remote software is started (see pwi1m, spec1m, and dome1m):
+<code>
+cd APOsong
+ipython
+> from aposong import *
+</code>
+This should show you a list of commands (which you can see again with the commands() function), and a list of connected devices.
 ===== pwi1m computer =====
@@ Line 47: / Line 59: @@
     * several ASCOM drivers for telescope, port 1 focuser, and mirror cover control
     * a custom PlaneWave API interface
-  * ASCOM remote to make the telescope, focuser, mirror covers and camera / filter wheel accessible. This is used to set up the ASCOM cameras connected to PWI1: port 1 imaging camera, port 2 acquisition/guide camera, and eShel spectrograph detector
+  * ASCOM remote for communication with native Windows ASCOM drivers:
+    * PWI-4 interface
+    * PlaneWave Focuser (via PWI4)
+    * PlaneWave Mirror Cover (via PWI4)
+    * Atik guide camera
+    * Atik eShel camera
+    * QSI camera (for PlanWave port 1)
+    * QSI FilterWheel
   * A custom Alpaca server which supports Alpaca drivers for:
-   *the Zaber focusing stage (Zaber XX) through an ASCOM Focuser device,
+   * the Zaber focusing stage (Zaber XX) through an ASCOM Focuser device,
-   *the iodine stage (Thorlabs TLS 150 stage), commanded through an ASCOM Focuser device,
+   * the calibration stage (Thorlabs LTS 150 stage), commanded through an ASCOM Focuser device
+   * the iodine stage (Thorlabs TLS 150 stage), commanded through an ASCOM Focuser device,
    * the iodine cell temperature controller (Thorlabs TC300 controller), commanded through an ASCOM Switch device
    *  the Shelyak eShel calibration unit, through an ASCOM Switch device.
+PlaneWave interface 4 is started from a desktop icon. It will open (after a minute or two) a graphical window (more details below). Need to ensure that telescope is connected and all motors/focuser are enabled.
+ASCOM remote is stated from a desktop icon. It may need to be restarted if power is cycled to any of the devices that it interfaces to. It takes a minute or two to start and should show connections to all of the devices listed above.
+The Alypca server is started from an Anaconda Python shell (start using Windows input). Once the terminal window comes up:
+<code>
+cd APOalpyca/device
+python fpu_app.py
+</code>
+The system should then be ready for remote usage.
 === Planewave software ===
+The PlaneWave software is not normally used for regular operation, as we just use the ASCOM and direct PWI interface. However, more detailed information and more command functionality is available through the PWI graphical interface, e.g., for pointing models and telescope troubleshooting. Hence we provide some information here.
 On pwi1m, the telescope is controlled through the PWI4 software. This also has the capability to control an ASCOM camera, necessary when using PWI4 to construct a pointing model.
@@ Line 101: / Line 136: @@
 Documentation of the Alpaca drivers can be found at [[https://apoalpyca.readthedocs.io/en/latest/|http://APOalpyca.readthedocs.io]].
-===== Dome software =====
+===== spec1m computer =====
+spec1m is the SONG spectrograph computer. It controls the spectrograph QHY detector and the Esatto focuser. It also controls two thermocouples that monitor the body temperature of the QHY and a relay that resets a watchdog timer if the body temperature is under a limit; otherwise the watchdog is not reset and the QHY camera power will be cut after 2-3 minutes.
+Run ASCOM remote for QHY interface and Esatto focuser interface.
+Run Alpyca server for thermocouple interface from an Anaconda terminal shell:
+<code>
+cd APOalpyca/device
+python spectro_app.py
+</code>
+Since the QHY power is controlled by the thermocouple interface, the ASCOM remote interface won't connect until this is run: it will prompt you to connect the ASCOM device within 10 seconds.
+===== dome1m =====
 Dome control is implemented through software running on a Raspberry Pi, dome1m.
@@ Line 128: / Line 177: @@
 <code>
 cd APOalpyca/device
-python domeapp.py
+python dome_app.py
 </code>
@@ Line 182: / Line 231: @@
 <code>
-dnf install tcsh emacs git gnome-tweaks tigervnc-server gcc g++
+dnf install tcsh emacs git gnome-tweaks tigervnc-server gcc g++ strongswan
 </code>
@@ Line 194: / Line 243: @@
 firewall-cmd --permanent --add-service=vnc-server
 firewall-cmd --reload
+</code>
+set up ipsec.secrets, ipsec.conf
+<code>
+systemctl enable --now strongswan
 </code>
@@ Line 218: / Line 273: @@
 dnf install pgadmin4
 </code>
-</code>
 Need to set up correct password authetication in pg_hba.conf and postgresql.conf
@@ Line 287: / Line 342: @@
 Copy existing grafana.db  to /var/lib/grafana
-dnf install tigervnc-server
-strongswan and ipsec.conf, etc. for communication with Aarhus