Changes
/* Troubleshooting */
10. Close the Script, PointXP6 and Astrometry windows, the SiTechCamera GUI and CTRL-C in the terminal to stop running the astrometry programme. If going back to normal operations, stop all SiTech software and reopen from ioserver1, then do a "sudo systemctl restart lesedi" and "sudo systemctl restart lesedi-web" from lesedis2 and restart the autoguider software.
== "SiTech Ready" config: illustrated guide ==
== Troubleshooting ==
The pink warning box will disappear from the relevant GUI if the problem is resolved. If the problem persists, see point 3 below.
3. If clicking on a "Bad comms" warning button does not fix the problem, the SiTech software will need to be stopped and restarted. It is vital that all the SiTech GUIs are closed, and that they are reopened in the correct order, so follow [[#Starting SiTech software| this procedure.]] then restart all the other Lesedi/Mookodi services.
4. The most common issue is '''loss of dome comms'''. The symptom will be that the dome won't move to a new target, or that it has closed without warning (the telescope will not park, mirror covers will not close: those actions suggest an LCU shutdown). A red warning button will appear labelled "Bad Dome Comms" in the Dome GUI - clicking it should solve the problem. If it does, go to the browser TCS Advanced tab, and in the central panel click "TAKE CONTROL", then turn dome "Tracking" ON and OPEN if the dome had closed without good reason in the middle of observing. If comms are not restored this way, then press Shutdown on the browser TCS and follow the full instructions on [[#Starting SiTech software| starting SiTech software]] to restart. Then reload the browser TCS and run the telescope startup procedure.
The serial number of the rotator controller is A603G14W, so this confirms that the rotators are communicating on port ttyUSB1. If the above command gives you a different serial number, edit the command to try each port from ttyUSB0 to ttyUSB5 until you find A603G14W. Now go to the ServoSCommunicator GUI and select the Rotators tab. In the dropdown menu, select the appropriate port - in this case ttyUSB1. Go to each of the Left Rotator GUI and the Right Rotator GUI and click on the pink warning complaining of no comms. If the warning doesn't clear, shutdown and restart all SiTech. ServoSCommunicator should wake up with the ttyUSB1 port selected, and communications to the rotator GUIs should be restored.
7. '''The telescope won't slew'''. First check that the telescope is unparked and that the target is within the visibility window(the TCS web GUI has a visibility calculator). If those things are fine, the telescope may have triggered the hardware azimuth hardware limit switch. This sometimes happens if the telescope is at azimuth ~165163-175. Go to the SiTechExe GUI (the long, thin one) and at the top of the Scope tab, check if any of the arrows are red or orange. If they are, click the "STOP" button toward the bottom of the GUI, then click the opposite arrow a few times to move nudge the telescope out of the limit. If the motors are in "blinky", you may need to click the button at the bottom to switch the motors to automatic.
8. '''Telescope won't slew: motors are in "blinky" mode and won't switch to auto.''' There is likely an error on the alt and/or az controller board which will need to be reset. Find the SiTechExe GUI (the long, thin one) and try pressing the button at the very bottom to switch the motors to Auto. If it does nothing, select the "Features" tab on the same GUI. Press the "Controller Stuff" button, which will open the "Controller Information Window". There are two columns in this GUI, one for alt, one for az. There is a text box about two-thirds of the way down each column, which will either say "No Errors", or list some errors. If there is an error in the box, click the "Reset Errors" button directly underneath that text box. '''Be very careful not to click any other button.''' If that has fixed the problem, the motors will now be in Auto mode - the button in the top left corner will say "To Manual (Blinky)", and the long, thin SiTechExe button will say "Motors Automatic" at the bottom. Close the Controller Information Window and resume operations. This almost always solves the problem, but if it persists, go to 8a).
