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.
Open source · GPL-3.0 · Windows, macOS, Linux
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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
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.
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.