User Tools

Site Tools


Software at TMO is as follows:

As of 07/16/2019

  • Windows 10 (latest updates)
  • Microsoft .NET Framework 3.5 (also requires 2.5 and 3.0)
  • ASCOM Platform (6.4 - Service Pack 1)
  • SiTechExe (0.94N)
  • SiTech Servo II Driver (9.7)
  • MaxImDL (6.20)
  • ACP/ACP Scheduler (8.2.1)
  • Focusmax (, switched to FocusMax v4 March 2021
  • Clarity II (3.008)
  • CygWin (3.0.7)
  • Teamviewer (14)
  • AnyDesk (5.2.1)
  • TigerVNC (1.9.0)

2022 : fresh install on new computer with Windows 11

Initial Software Installation

Assuming a fresh start (either due to OS upgrade, or drive failure).
Install Windows. You can get install media from the ICT Help Desk in Hardman & Jacobs. We’re currently running Windows 10, so the following instructions are based around that version.
Download and install Microsoft .NET Framework 3.5, 3.0, and 2.5

Install Cygwin (we mainly use it for cron jobs). The installer will list all of the packages you can choose from. Be sure to add cron, rsync, openSSH, emacs and tcsh.

Allow ping requests: get admin CMD window (CMD+CTRL/SHIFT/ENTER), enter: netsh advfirewall firewall add rule name=“ICMP Allow incoming V4 echo request” protocol=icmpv4:8,any dir=in action=allow

Enable Windows time updates!

VNC/Remote Control

Download the installers for TigerVNC, Teamviewer, and AnyDesk.
Set passwords for TV and AD. AAVSO requested specific passwords for these, so check with them.
You’ll need to note down the ID numbers for both TV and AD, and send them on to AAVSO so they can access the computer remotely. AAVSO has licensing information for !AnyDesk.
We use VNC for remote access. Launch TigerVNC, right click the tray icon and go to options. Set authentication password for remote access.

Observatory/Telescope Control

Download and install:

AAVSO have the necessary licenses for MaxImDL. They’ll send you an email with the download link (Jon Rees and Jon Holtzman should also have a copy of this). Install MaxImDL and copy the text of the email to the clipboard. Start MaxImDL and the license information should automatically populate into the window. If it doesn’t, double check that the license information in the email is applicable for the version of !MaxIm and/or that the license is still valid for updates.

Download Clarity II for the Boltwood II Weather Station (under Downloads tab). When starting the software it may complain about a missing file, MCI32.ocx. This used to be included in older versions of Windows, but not in the current version of Windows 10. If you need it you can get a copy from the Clarity II Support Forum (look for a thread titled Clarity II and Windows 10 - missing file). Put the MCI32.ocx file in the C:/Windows/SysWOW64 folder. Once Clarity II launches successfully hit setup and enter the COM port for the Boltwood II (currently COM4, check device manager to determine current COM ports)

Download and install Focusmax 3.8. Focusmax was the last free version. Focusmax 4 now requires a purchase/license. AAVSO can send you the installer, or it’s available on the web at the above link (at least as of the time of writing). Our focuser is an optec tcf (temperature controlled focuser). Download the optec ascom driver. Open Focusmax. In Focusmax, click ‘choose’ next to ‘not connected’. Select the Optec driver. Click properties, to set up the focus properties. Select the COM port for the focuser. Currently COM5

In March 2021, switched to FocusMax v4, needed for new large format camera. License purchased. IN 2022, switched to FocusMax v5

Download camera drivers. Camera was a QSI 583. You can download an image of the installation CD from the QSI site (under support, drivers) Open the installer, select MaxImDL plugin, install. Move the CCDPlugQSI.dll file from C:/ProgramFiles(x86)/Cyanogen/MaxImDL V5 to /MaxImDL 6 if it put it in the wrong location.[ Our guide camera is a Starlight Xpress Lodestar. Download the Starlight Xpress drivers and install. Open MaximDL6 Go to camera control tab, setup camera1, select model QSI Camera 2, setup, SX Universal. You should now be able to connect to the cameras. Disconnect again and click Set Up Filter on Camera 1 to set up the filter wheel. Select the QSI Universal driver under ‘Filter or Controlling Camera Model’. Set the Filters in each slot. Currently we have B,V,R,I,Halpha in slots 1-5 respectively. Delete the names in slots 6+ if they’ve been auto-populated.

March 2021, switched to QHY 600 camera, downloaded drivers from their web site. Select ASCOM drivers for camera and filter wheel. Set up camera using Advanced button on ASCOM setup.

Open Servoconfig, setup COMM port, and enter the COM port for the telescope (currently COM 6). Open SiTech.exe, config, change config, misc, select COM Port for the telescope.

Dome control is usually done through ACP, but low-level checks can be done through ASCOM Dome Control directly. Open ASCOM Dome Control, Select dome, and select the MaxDome II driver. Click Setup Dome, select COM port (Currently COM10).

Now we should be able to connect to everything. It’s time to tweak the setup. Check telescope config in SiTech (Config tab, change config). Check telescope name (TM61), Aperture (24 inches), and focal length (Telescope is f/5, but effectively f/5.6 due to coma corrector → Focal length is 5.6*24=134.4 inches). Check site Lat/Long/Elevation. Under Mount Params, check that the mount is set to Equatorial. We haven’t changed any of the other parameters under this tab yet.

In ACP, Preferences, Dome Control: Check that the dome is set to !MaxDome II (under Select Dome). Under Properties, hit auto calibrate to determine the number of tics in a complete rotation (currently 192). Set the home position (~88 degrees) and the park position (90 degrees). Also make sure shutter control is enabled, and select “has upper shutter only”. Also select “Close and park dome when scope parked” and “safe to slew scope with shutter closed”.

ACP Preferences for Dome Control

Check the following boxes:

  1. Enable ACP Dome Control
  2. Close and park/home dome when scope is parked by script
  3. Safe to slew scope anywhere with shutter close
Geometry Value
Mount Pivot EW Offset 0
Mount Pivot NS Offset 0
Mount Pivot Vert Offset 0
Optical Axis Offset 900 (mm)
Dome Radius 4 (m)
Dome Az Bias 0

Under Advanced there’s an option to slave the dome when slit is closed. Useful for testing, but disabled by default to avoid sun in the telescope (if we were to open the slit, telescope could be pointed at sun, and dome would be slaved). ACP → Preferences → Server Tab → Enable, to allow web services (scheduler etc.) Under Observatory tab, enter the site name (TMO), latitude (+32 17 35), longitude (-106 41 53) and elevation (1505m). Under Telescope tab set the Telescope Name (TM61), aperture (609.6mm), focal length (3460mm) min elevation (15 deg) and ensure ‘telescope needs local topocentric coordinates’ is selected. Select German Equatorial mount. Under Flip Settings set the flip before(East-West)/after(West-East) meridian values to large (~360 minutes), because our mount doesn’t actually flip. Under Dome Control tab enable ACP Dome Control, select close and park dome when scope is parked, and safe to slew anywhere with the shutter closed. For mount geometry we currently have the values: Mount Pivot E/W: Mount Pivot N/S: Mount Pivot Vert Offset: Optical Axis Offset: 900mm Dome Radius: 4m Dome Az Bias: 0 We’re still getting some errors with the dome slit positioning, so these values need to be tweaked.

In ACP Preferences, Enable ACP Pointing Correction, and enable AutoFocus (but get it working with FocusMax first). In PinPoint menu, change exposure interval to 10s. Setup changes in Telescope, Observatory, Imaging. Add Server Users as desired. For guiding, may want to set maximum error to 2 pixels.


In Focusmax, go to open → options. Enable auto connect for focuser and camera. In Camera, set central region to 50% (for large FOV). In Autofocus, disable max HFD, or set to sufficiently large number. Find a star, manual focus, and do a Vcurve. In Settings/Autofocus, set to use binning=2 for all filters of interest. Test a focus run.


In MaxImDL, Observatory Control select the setup tab. Add Telescope (SiTechDLL Telescope). Do NOT connect to Focuser (FocusMax Focuser Hub) if ACP will be connecting to focusser, other you will get communication hangs leading MaxIM to frezee up! If it auto-detects the weatherstation (Boltwood CS and Davis), make sure to disable them for enable all (click the arrow for more options, then deselect Enable for Connect All) In maximDL, observatory window, Telescope tab, calibrate to allow point here. I could not get Auto to successfully identify stars, so used Manual given information from ACP plate solve: used scale=0.22 and orientation=0 for QHY 600 as mounted.

using Guider window in expose, calibrate guider: take an image and click on Guide star, then use Calibrate button. Need to select AscomDirect in Autoguider output control, and select telescope (Scitech) with setup button. For some reason, maybe need to change sign of Xspeed (once using ACP, seems like it!). May want to set track box size in Guider/Options to keep star from drifting out of guiding images.

Clarity II

Clarity II Setup: To integrate the Boltwood weather station with ACP, enable the data file by going to setup → data file. Set the file name/location (default boltwood.log, in Documents/ClarityII). This will write a single line file which ACP can read to determine conditions (see Clarity II Limits section below) In ACP go to Weather, Setup. In Weather Server Object ID enter ACP.BoltwoodFile and enable the weather services by checking the box. Make sure the Minimum Unsafe Time is set to something sensible like 10 minutes. This is the time that ACP will wait after the weather becomes safe again before resuming. Then edit the ACP weather script (located in C:/ACP Obs Control/ACP-Weather.vbs) and uncomment the lines to allow the dome to close before telescope is parked (because we have a ‘real dome’).

Clarity II Limits: Clarity has limits (set under setup tab) to define the level at which you switch from e.g. cloudy to very cloudy. You can then select what levels trigger alerts. For example maybe you want the system to trigger alerts when the wind level is above either the windy or very windy limits, but for clouds only when it’s above the very cloudy limit. These selections will determine whether the alert flag is set in the one-line file (see the Boltwood manual, section 17.1.1 New Format for the format of this file). The alert flag is either 0 (no alert) or 1 (alert), and should be the final digit in the file. Unfortunately currently this file is missing the alert bit. Diffraction Limited forums show other users encountering this as well, currently waiting on a response to a post I’ve made.
It looks like the alert flag was never actually implemented in the software, but still made it into the documentation. So Bob Denny incorporated it into ACP based off of the documentation, but the functionality never truly existed.
In the interim, if the alert flag is not present ACP can still function (older versions of Clarity also didn’t have this alert bit). Instead ACP will look at the level digits for the individual conditions (cloud, wind, rain, daylight), and trigger the weather script if any of the conditions is at Level 3.

ACP and Scheduler Setup

Note that ACP Config is rsynced, so you can find some of the files below in the rsync location.

- For ACP, add SchedulerDawnFlats.txt (and Dusk) in /Users/admin/Documents/ACP Astronomy/Plans

- add Autoflat.config in /Users/Public/Public Documents/ACP Config/

- edit filename in ImageConfig

- see also /Users/Public/Public Documents/ACPConfig/Scheduler, StartupObs.js, ShutdownObs.js, temperature.txt

- Run focusoffsets script, creates FilterInfo.txt in ACP Config, or copy existing FilterInfo.txt don't put offsets in MaximDL or they will get applied twice!

To get webcam images in ACP web interface, setup (in ACP Web Data/Doc Root/webcam) to run from crontab on reboot. Create TelescopeWebcam tiddler per Bill Ketzeback instructions and add into MainMenu. New tiddler code:

  return "<html><table width=100%> <TR> <TD><a href= target=dummy> LED on </a> // <a href= target=dummy> LED off  </a> (will open new tab, need to select original tab to return) <TD><a href= target=dummy> LED on </a> // <a href= target=dummy> LED off  </a>(will open new tab, need to select original tab to return) <tr>  </html> [img[/webcam/tmocam.jpg?" + new Date().getTime()+"]] [img[webcam/tmocam2.jpg?" + new Date().getTime()+"]]";
<<RefreshTiddler Refresh "Refresh Display" 5 >>

To get focuser position in ACP web, add focus stuff in ACP Web Data/Doc Root/ac/acsystemstatus.asp, and add code in SystemStatus tiddler:

                <tr title="Focuser position">
                    <td class="telemlabel">Focus:</td>
                    <td id="sm_focus" class="telemetry"><span>-----</span></td>

Various asp files plus tiddler files are attached in acp.tar

Finally, use copy script (in rsync directory) with crontab to rsync files, e.g., every 5 minutes?

*/15 * * * * /home/admin/copy > /home/admin/copy.log 2>&1
@reboot /cygdrive/c/Users/Public/Documents/ACP\ Web\ Data/Doc\ Root/webcam/ > /dev/null 2>&1 &

AAVSO setup

Install anaconda Python. Get TortoiseSVN and configure to sync \data\code and \data\plans. Edit \data\plans\scripts\environ.bat to set correct direcctory locations; need to create zip directories; run it as admin to set environment variables. Set Windows Scheduler to run sync. bat

software.txt · Last modified: 2023/01/04 04:22 by holtz

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki