Mount
The mount drives target acquisition and tracking. Every telescope has exactly one mount; it’s the device the task executors call into through the mount driver interface to slew, track, apply offsets, and play offset patterns for mapping observations.
Config shape
Section titled “Config shape”Every mount has an entry under device_configs.device_configs_by_id.<device-uid>:
{ "device_type": "mount", "driver": "mount.ascom" | "gbtwenty-mount" | "mount.simulator", "managed_by": "this_node", "driver_configs": { "mount.ascom": { /* see below */ }, "gbtwenty-mount": { /* see below */ }, "mount.simulator": { /* see below */ } }}The driver_configs map holds parameters for every driver you might use, keyed by driver ID; the active driver is selected by the top-level driver key. This lets you switch between drivers (e.g., simulator and ASCOM) without losing the unused driver’s settings.
Drivers
Section titled “Drivers”mount.ascom — production
Section titled “mount.ascom — production”The standard driver for any ASCOM-conformant mount on Windows.
"mount.ascom": { "prog_id": "ASCOM.SoftwareBisque.Telescope"}| Key | Meaning |
|---|---|
prog_id |
The ASCOM ProgID of the mount driver to load. Examples: ASCOM.SoftwareBisque.Telescope, ASCOM.SiTechExe.Telescope, ASCOM.Simulator.Telescope |
In the app, Configure driver on the device’s Settings page opens the ASCOM Chooser and stores the ProgID you pick.
Notes:
- The mount’s ASCOM driver must be installed and configured on the SkyNode host before SkyNode tries to load it.
- The ASCOM driver app should already be set up for your hardware (COM port, baud rate, pier flip behavior, slew rates). SkyNode does not manage those settings; it loads the ProgID and talks to whatever the ASCOM driver presents.
- ASCOM is Windows-only — the
pythoncomandwin32com.clientbindings are imported unconditionally in the driver. Running SkyNode on macOS or Linux is fine for simulator and native drivers; for ASCOM you need Windows.
gbtwenty-mount — experimental
Section titled “gbtwenty-mount — experimental”The native driver for the GBTwenty (Green Bank 20-meter) radio telescope’s mount. Streams position-velocity (PD) commands to the Observatory Control Unit (OCU). See Driver interfaces → GBTwenty for how it works.
"gbtwenty-mount": { "connection_string": "socket://localhost:9620", "baudrate": 115200, "timeout": 5.0}| Key | Meaning |
|---|---|
connection_string |
The OCU: a serial port (COM20, /dev/ttyUSB0) for the real OCU, or a pyserial URL such as socket://host:port. The default points at the local OCU simulator container |
baudrate |
Serial baud rate. Default 115200, the OCU’s rate |
timeout |
Serial operation timeout in seconds. Default 5.0 |
max_slew_velocity_az_deg_per_sec, max_slew_velocity_el_deg_per_sec, max_slew_acceleration_az_deg_per_sec2, max_slew_acceleration_el_deg_per_sec2 |
Motion limits the driver clamps its commands to; the defaults are the GBTwenty’s |
This driver is the only native mount integration today and is considered experimental. Use it only with the GBTwenty hardware and the OCU configured by the GBTwenty operations team.
mount.simulator — testing only
Section titled “mount.simulator — testing only”Drives a paper mount that accepts every command and reports back sensible state. Good for verifying the rest of your install before hooking up real hardware.
"mount.simulator": {}No parameters required.
Troubleshooting
Section titled “Troubleshooting”- “ASCOM driver won’t load.” Check the ProgID with the ASCOM Diagnostics tool or PowerShell:
(New-Object -ComObject ASCOM.Utilities.Profile).RegisteredDeviceTypes. A common cause is a 32-bit driver loaded into a 64-bit Python process (or vice versa) — the SkyNode build should match. - Mount drops connection after slewing. The ASCOM driver app is crashing or the COM proxy is dying. Usually a driver-app issue, not a SkyNode issue. Restart the driver app first.
- “Tracking is engaged but pointing drifts.” Mount calibration (T-Point or equivalent) lives in the ASCOM driver app; SkyNode consumes whatever the driver reports. If pointing isn’t right in the driver app it won’t be right in SkyNode.
- Mount won’t go past a pole or meridian. Mount-side limits enforced by the driver and the mount’s control system. SkyNode respects these; the fix is in the mount’s configuration.