# MX-HD ASCOM Distribution Guide (User Distribution v2.0.5)

Last updated: 2026-06-09
Target driver: `ASCOM.MXHD.Telescope`
Target installer: `MXHD-ASCOM-Setup-2.0.5.exe`

## 1. Prerequisites

- ASCOM Platform 7 must be installed in advance.
- Before installation, close applications that may use the ASCOM driver, such as N.I.N.A., Device Hub, Conform, and PHD2.

## 2. Installation

1. Run `MXHD-ASCOM-Setup-2.0.5.exe`.
2. Complete the setup process.
3. In ASCOM Chooser, confirm that `ASCOM.MXHD.Telescope` is listed.
4. If needed, open the setup dialog and confirm the COM port and other connection settings.

Notes:
- This release uses a per-user installer. Administrator rights are normally not required.
- The default installation path is `%LocalAppData%\Programs\MXHD\ASCOM\Telescope\MXHD`.

## 3. Notes for Updating

- If `MXHD ASCOM` is already installed, you can normally install this version over the existing one.
- If the PC previously used the older administrator-based installer and behavior is unstable, uninstall the old version first, then install `v2.0.5`.

## 4. Uninstallation

- Uninstall `MXHD ASCOM` from Windows "Apps & features".

## 5. Known Items in v2.0.5

- During PulseGuide / ST-4 guiding, MX-HD intentionally does not actively update the displayed RA/Dec coordinates. Because of this, Conform coordinate-change checks may report `ISSUE`.
- Because RA is handled with one-second resolution, some Conform position-comparison tests may report an `ISSUE` of about `20.9 arc seconds`.
- These two items are related to coordinate presentation and resolution. They do not by themselves indicate failure of command acceptance or basic mount operation.

## 6. Log Locations

- Driver log:
  `%LOCALAPPDATA%\MXHD\ASCOMTrace\yyyy-MM-dd\ASCOM.MXHD.Telescope.*.txt`
- Conform log:
  The folder specified by `-p` when running Conform

## 7. Basic Verification Checklist

- `ASCOM.MXHD.Telescope` appears in ASCOM Chooser
- Connection succeeds
- Basic Park / Unpark / FindHome / Slew operations work

