From 2a784eb48130d073cc45a4acc3580e113cd3bc18 Mon Sep 17 00:00:00 2001 From: ToupTekSoftware Date: Wed, 8 Jul 2026 16:50:36 +0800 Subject: [PATCH] Add TOUPTEK SH20 driver documentation --- .../touptek/touptek-sh20/touptek-sh20.md | 89 ++++++++++++++++++ .../touptek/touptek-sh20/touptek-sh20.webp | Bin 0 -> 5010 bytes .../touptek/touptek-sh20/touptek-sh20.yaml | 9 ++ 3 files changed, 98 insertions(+) create mode 100644 src/content/docs/mounts/touptek/touptek-sh20/touptek-sh20.md create mode 100644 src/content/docs/mounts/touptek/touptek-sh20/touptek-sh20.webp create mode 100644 src/content/docs/mounts/touptek/touptek-sh20/touptek-sh20.yaml diff --git a/src/content/docs/mounts/touptek/touptek-sh20/touptek-sh20.md b/src/content/docs/mounts/touptek/touptek-sh20/touptek-sh20.md new file mode 100644 index 0000000..e05914a --- /dev/null +++ b/src/content/docs/mounts/touptek/touptek-sh20/touptek-sh20.md @@ -0,0 +1,89 @@ +--- +title: TOUPTEK SH20 Equatorial Mount +categories: ["mounts"] +description: Driver for the TOUPTEK SH20 equatorial mount. +thumbnail: ./touptek-sh20.webp +--- + +## Features + +The TOUPTEK SH20 telescope driver supports: + +- USB serial connection +- Equatorial and azimuth mount type selection +- 10 slew rates from 0.25x to 1440x +- Manual motion control in north, south, west, and east directions +- Goto and sync coordinates +- Sidereal, solar, and lunar tracking modes +- Track on/off control +- Park and unpark +- Home find and home go actions +- Site and time synchronization from INDI clients +- Pier side reporting in equatorial mode +- Timed pulse guiding +- Configurable guiding rate +- Buzzer control +- Meridian flip settings in equatorial mode + +## Installation + +The TOUPTEK SH20 telescope driver is available as `indi_touptek_sh20`. + +To run the driver after installation: + +```bash +indiserver indi_touptek_sh20 +``` + +When testing from a build tree, run the driver through the `indi_touptek_sh20` executable or symbolic link so the LX200 generic loader can select the SH20 implementation: + +```bash +cd build/drivers/telescope +ln -sf indi_lx200generic indi_touptek_sh20 +indiserver ./indi_touptek_sh20 +``` + +## Operation + +Connect the SH20 mount to the host computer with a USB serial cable. Start the driver with `indiserver indi_touptek_sh20` or select `TOUPTEK SH20` from an INDI client such as KStars/Ekos. + +In the Connection tab, select the serial port assigned to the mount, for example `/dev/ttyUSB0` or `/dev/ttyACM0`, then press Connect. After connection, the driver reads startup data from the mount, including mount type, track mode, guide rate, buzzer state, and meridian flip settings when available. + +### Main Control tab + +The Main Control tab provides the standard telescope controls: + +- Connect and disconnect the mount +- Track, slew, and sync commands +- RA/DEC coordinate display and target entry +- Abort motion +- Tracking mode selection +- Park and unpark +- Pier side display in equatorial mode +- Mount type selection + +### Motion Control tab + +The Motion Control tab provides manual movement and rate settings: + +- Motion N/S and Motion W/E buttons for manual slewing +- Reverse controls for north/south and west/east movement +- Slew rate selection from 0.25x to 1440x +- Guide rate configuration from 0.1x to 0.9x sidereal rate + +### Site Management tab + +The Site Management tab is used by INDI clients to send observer location information to the mount. Time and date are synchronized from the INDI client as part of the standard telescope driver operation. + +### Options tab + +The Options tab includes the SH20 buzzer control. The buzzer can be set to off, low, or high. + +### Meridian Flip tab + +The Meridian Flip tab is available in equatorial mode. It provides meridian flip enable/disable, after-meridian behavior, and meridian limit configuration. + +## Issues + +- The driver must be started as `indi_touptek_sh20`. Starting the shared `indi_lx200generic` executable directly loads the generic LX200 driver instead. +- Mount type changes are sent to the mount immediately. Reconnect the driver after changing mount type so client-visible properties match the selected mode. diff --git a/src/content/docs/mounts/touptek/touptek-sh20/touptek-sh20.webp b/src/content/docs/mounts/touptek/touptek-sh20/touptek-sh20.webp new file mode 100644 index 0000000000000000000000000000000000000000..cd7899fe616f40ab75e79726c7bb9b9eeca3624b GIT binary patch literal 5010 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 cfT>t<8 literal 0 HcmV?d00001 diff --git a/src/content/docs/mounts/touptek/touptek-sh20/touptek-sh20.yaml b/src/content/docs/mounts/touptek/touptek-sh20/touptek-sh20.yaml new file mode 100644 index 0000000..f6daec6 --- /dev/null +++ b/src/content/docs/mounts/touptek/touptek-sh20/touptek-sh20.yaml @@ -0,0 +1,9 @@ +# Display Names (Human-Friendly) +driver_name: TOUPTEK SH20 +categories: ["mounts"] +manufacturer_name: TOUPTEK + +# Additional Metadata +executable: indi_touptek_sh20 +platforms: Linux +version: 1.0