v2.5.5 Changelog

New Features

• Screenshot Capability:

  • Added a hidden hotkey ('p') to capture the current screen.
  • Saves images as .bmp files to the /satscreenshots/ folder on the SD card.
  • Added a visual "SNAP!" indicator in red text to confirm capture.

• AOS (Acquisition of Signal) Audio Alert:

  • Implemented a feature to play a melody when a satellite rises above the horizon (AOS).
  • Added a persistent soundEnabled setting that saves to the device memory.

• Audio Configuration Menu:

  • Added a new "Audio Config" submenu (Option 5 in Main Menu).
  • Includes a toggle for Sound On/Off.
  • Includes a "Test Beep" button to play the melody on demand.

Configuration Changes

• src/config.h Updates:
  • Moved audio frequency and duration constants into config.h for easier editing.

v2.5.0 - Favorites & Hardware Intelligence

🛰️ ISS/Satellite Tracker v2.0 Release Notes

This release brings major usability improvements and makes the software smarter about the hardware it is running on.

🚀 New Features:

🛰️ Satellite Favorites Menu

• Preset List: Added a built-in list of 10 popular satellites: ISS, Tiangong, Hubble, NOAA 15/18/19, Meteor-M2 3, SO-50, AO-91, and FOX-1B.
• Quick Select: Instantly select a target using keys 1-4 to download TLE data and start tracking.
• Smart Scrolling: Navigate the list using the arrow keys with a paginated view that keeps the UI clean.

🔌 Automatic GPS Detection

• The firmware now automatically scans for the M5Stack LoRa868/GPS Module at boot.
• If detected, it auto-enables GPS mode. If not found, it defaults to Manual Location mode. No more toggling settings when you attach/detach the base!

⏱️ Precision Timing

• Continuous GPS Time Sync
• Previously: The clock synced once at boot and could drift over time.
• New Behavior: The system now re-syncs its internal clock with the atomic GPS time every 60 seconds.
• Result: Your "Live Telemetry" screen (Azimuth/Elevation) remains frame-perfect and drift-free for long-duration tracking sessions.

🛠️ Improvements & Fixes

• Manual Entry Moved: The "Manual Entry" option is now located at Option #3 in the config menu, keeping the ability to track any NORAD ID custom.
• UI Polish: Added visual "Up/Down" indicators to menus to show when more options are available off-screen.
• Drift Fix: Solved an issue where the internal RTC would slowly desync from real-time if the GPS signal fluctuated.

v2.0.0! - Wifi scanning and Satellite Tracking!

🛰️ ISS/Satellite Tracker v2.0 Release Notes

This major update transforms the ISS Tracker into a Universal Satellite Tracker. You can now track any satellite in the NORAD catalog, scan for WiFi networks, and use the M5Stack GPS module for automatic location updates.

🚀 New Features

• Custom Satellite Tracking: You are no longer limited to the ISS! Enter any NORAD Catalog Number (e.g., 20580 for Hubble, 33591 for NOAA 19) in the settings menu to track it.
• GPS Module Support: Added support for the Cardputer LoRa/GPS extension. The device can now automatically update your Latitude/Longitude and sync time from GPS satellites.
• WiFi Network Scanner: No need to manually type your SSID anymore. The new WiFi menu scans for nearby networks and lets you select one from a list.
• Arrow Key Navigation: You can now cycle through the dashboard screens (Home, Live, Radar, Pass) using the arrow keys (< and >) on the keyboard, in addition to the G0 button.

🛠️ Improvements & Fixes

• Smart TLE Updates: Changing the satellite ID now automatically triggers a TLE download.
• Reset to Default: Added a quick "Reset to ISS" option in the Satellite menu.
• Stale Data Fix: The home screen now correctly clears old satellite names if a download fails or the ID is invalid.
• File System Cleanup: Fixed a bug where TLE data would append to the file instead of overwriting it, preventing file bloat and parsing errors.
• UI Polish: Adjusted the Home Screen layout to prevent text from overlapping with the header line.

Enjoy!

v1.6.0 - GPS Integration & Menu System Overhaul

v1.6.0 - GPS Integration & Menu System Overhaul

This release transforms the ISS Tracker into a fully standalone field tool with the addition of hardware GPS support and a completely redesigned menu system.

🚀 New Features

• Hardware GPS Support: Added integration for the M5Stack CAP LoRa868 (ATGM336H) module.
  • Auto-Location: Automatically updates your Latitude and Longitude for accurate pass predictions on the go.
  • Dual Modes: Toggle between "Manual" entry and "GPS" mode in the Location menu.
  • GPS Status Dashboard: A new detailed screen showing Satellite Count, HDOP, Altitude, and UTC Time.
• New Menu System: Replaced the basic options list with a dedicated, hierarchical configuration menu.
  • Shortcut: Press the c key at any time to enter the configuration menu.
  • Sub-Menus: Organized settings into WiFi, Satellite, and Location categories.

🐛 Bug Fixes & Improvements

• Prediction Logic: Fixed a bug where changing manual coordinates did not immediately trigger a recalculation of the next pass.
• GPS Tuning: Optimized serial communication for the ATGM336H chip (115200 baud) and corrected RX/TX pin mapping (RX=15, TX=13).
• UI Cleanup: Improved input handling for text fields (SSID, Lat/Lon) to prevent blocking the main loop.

📦 Hardware Requirements (Optional)

• M5Stack Cardputer ADV
• (Optional) M5Stack CAP LoRa868 Module for GPS functionality. (The tracker still works perfectly in Manual mode without it!)

ISS Tracker v1.5.0 - Embiggened Font and LEDs

This release focuses on significantly improving readability on the Cardputer's display and adding hardware status indicators for easier tracking.

🚀 New Features

Status LED Indicator ("On Air" Light):

• Utilizes the built-in RGB LED on the M5StampS3.
• Solid Green: Satellite is currently Visible (AOS).
• Solid Red (5s): Satellite has just gone Below Horizon (LOS). The light turns off automatically after 5 seconds to save power.

High-Visibility UI Overhaul:

• Replaced the default system font with Font2 (8x16 Console Font).
• Text is now significantly larger and crisper, making it much easier to read at a glance.

Improvements & Fixes

Layout Optimization:

• Live Screen: Combined "Azimuth" and "Elevation" onto a single line to maximize vertical space for the larger font.
• Header Design: Moved the decorative header line down by 10 pixels. It now correctly underlines the title instead of striking through the text.
• Spacing: Increased global line spacing from 12px to 18px to prevent text crowding.
• Screen Offsets: Adjusted the vertical start position of all menus (Home, Pass, Options) to ensure text clears the new header line.

Codebase:

• Added Adafruit_NeoPixel dependency for LED control.
• Cleaned up redundant screen drawing logic.

📦 Dependency Updates

• Added adafruit/Adafruit NeoPixel @ ^1.12.0 to platformio.ini.

ISS Tracker v1.4.2 - UI Updates

Some UI updates.

ISS Tracker v1.4.1 - Time Zone Update

I guess it would be nice to make it use your timezone.
I have added the offset to the options page.

ISS Tracker v1.4.0 - Radar Skyplot & Pass Prediction Update

New Features:

Radar Skyplot: Added a visual "Radar" view (polar plot) showing the satellite's path across the sky relative to your location (N/S/E/W). Shows the trajectory from T-5 minutes to T+15 minutes.

Next Pass Prediction: Added a prediction engine that calculates the next Acquisition of Signal (AOS) time, Loss of Signal (LOS), max elevation, and pass duration up to 24 hours in advance.

Minimum Elevation Filter: Added a configurable filter (default 10°) to the Prediction menu. The tracker will now skip "noise floor" passes and only notify you of passes that peak above your set threshold.

Modular Architecture: Refactored the monolithic codebase into modular components (orbit, ui, config) for easier maintenance and faster compilation.

Fixes & Improvements:

Timezone Labeling: Corrected the main display label from "UTC" to "Local" to accurately reflect the applied timezone offset.

UI Cleanup: Fixed screen refresh artifacts where "Calculating..." text would persist after a prediction was found.

ISS Tracker v1.3.0

v1.3.0 — Display Update

This version switches the app over to sprite-based drawing.
The screen now updates as a single frame instead of redrawing line-by-line, which gets rid of the flicker that showed up on the LIVE screen and in the menus.

Changes:
Converted all screens to use an off-screen sprite buffer
LIVE updates are smoother and no longer flash
Text entry screens redraw cleanly
General UI feels more stable overall

Nothing else changed functionally, just a much cleaner display update method.

ISS Tracker v1.2.0

Fixes:

• Cleaned up loop
• Got TLE calculations working
• Better Theme