Open source · GPL-3.0 · Windows, macOS, Linux

See what your Celestron mount is saying.

celestron-aux discovers the devices on a Celestron telescope's AUX bus, decodes every packet between them, sends commands, and can emulate a whole mount, so apps such as CPWI can be tried, and their traffic studied, without a telescope.

celestron-aux wifi · NexStar SLT
AZM MC → CPWI         MTR_GET_MODEL       0x0783 (Nexstar SLT)
AZM MC → CPWI         MTR_GET_VERSION     5.18
ALT MC → CPWI         MTR_GET_POSITION    -2°42'57.54"
Focuser → CPWI        FOCUS_GET_POSITION  11981
GPS → CPWI            GPS_GET_FW_VER      11.1
Dew Heater → CPWI     DEWHEATER_GET_AMBIENT
                      Temp: 27.67°C Dew: 17.326°C Hum: 53%
Starsense HC → AZM MC MTR_NMSLEW_RATE     9

Real traffic, captured over Wi-Fi between CPWI and a NexStar SLT.

What it does

Scan the bus

Finds every device on the mount (motors, hand controller, GPS, StarSense cameras, focuser, dew heater, Wi-Fi module, battery, lights) with its firmware version, and names the mount model.

Decode the traffic

Names the devices and commands of every packet and decodes their data: positions, RA/Dec, plate solves, polar alignment, GPS time and place, dew heater readings, power and more.

Watch without touching

Listen-only mode never transmits, so you can watch a hand controller or CPWI talk to the mount. Mark what you just did, and the note lands in every log next to the traffic it explains.

Work out the unknown

Traffic the catalog cannot name yet is collected with example payloads. Name devices and commands as you decode them; your names are kept in your own catalog.

Browser interface

Everything the console does, as buttons in a page: scans, commands, mount position, focuser, GPS, StarSense captures with the star field drawn live, and a red night-vision theme. Works offline, on the mount's own Wi-Fi, with an optional password.

Record and replay

Log decoded traffic to CSV, record raw captures and replay them later with their original timing, from the console or from the browser.

Connects through a SkyPortal or Evolution Wi-Fi module, a serial adapter on an AUX port, or the hand controller.

No telescope? Emulate one.

Switch an emulator on and this computer answers on the bus like Celestron devices do. Everything they send is decoded and logged like real traffic, so you can try an app, or work out what it asks for, from your desk.

Devices

  • Telescope: both motor controllers, with go-to, direction buttons, tracking, sync, a wedge, and a sky view of where it points
  • Wi-Fi dongle: CPWI and SkySafari connect to it as to a SkyPortal module, on port 2000
  • StarSense AutoAlign V2: plate solves and All-Star Polar Alignment, with a polar axis you correct as CPWI guides
  • StarSense AutoAlign (V1), GPS, focuser and dew heater controller

Mounts

  • NexStar SLT
  • NexStar 4/5SE
  • NexStar 6/8SE
  • CPC Deluxe
  • GT Series
  • NexStar GPS
  • NexStar Evolution
  • Origin
  • Advanced GT
  • AVX
  • CGX
  • CGX-L

Each reports its own model and latest known motor firmware (editable). Alt-az mounts that can take a wedge offer one; equatorial mounts turn around a polar axis.

Bring it into Wireshark

celestron-aux writes a Wireshark dissector that names every device and command, decodes the data exactly as celestron-aux does, and checks checksums. It decodes live Wi-Fi captures on TCP port 2000, putting frames split across TCP segments back together, and the captures celestron-aux records.

Filter with celestron_aux, for example celestron_aux.cmd_name == "MTR_GOTO_FAST" or celestron_aux.value contains "Solved".

# the dissector, for Wireshark's plugins folder
celestron-aux --export-dissector celestron_aux.lua

# a recorded capture as a pcap file
celestron-aux --export-pcap rawoutput.txt capture.pcap

Install

Needs Python 3.9 or later. One command installs the latest version from GitHub:

pip install git+https://github.com/platini2/celestron-aux

Without Git, download celestron-aux-<version>.zip from the latest release and run pip install on it. On Windows, write py -m pip for pip and py -m celestron_aux for celestron-aux.

Run

celestron-aux --web                    # open http://localhost:8080 and connect from the page
celestron-aux wifi 1.2.3.4             # SkyPortal or Evolution Wi-Fi
celestron-aux serial COM3              # serial adapter on an AUX port
celestron-aux hc /dev/ttyUSB0          # through a hand controller
celestron-aux playback rawoutput.txt   # replay a recorded session

Everything else is in the README, the protocol reference and the changelog.