Release 0.9.17

This update introduces a major new weather integration, field-optimized visual themes, and significant stability refinements.

🌡️ Internet Weather Integration (Open-Meteo)

• Virtual Data Sourcing: You can now pull local weather data (Air Pressure, Wind Speed, Cloud Cover, and Rain) directly from the internet via the Open-Meteo API.
• Smart Hybrid Telemetry: Missing hardware sensors are automatically supplemented by cloud data, ensuring your automation software always has a complete picture.
• ASCOM ObservingConditions: All internet-sourced weather data is standard-compliant and exposed through the ASCOM Alpaca interface for full compatibility with imaging sequencers (N.I.N.A., SGP, etc.).

🎨 Visual & Theme Optimizations

• New "Night Vision" Mode: A specialized high-contrast red theme designed to preserve dark adaptation for field use.
• New Default Look: "Material Dark" is now the default interface, providing a premium, eye-friendly design.

🛠️ Stability & Maintenance

• Alpaca Discovery Control: Added a UI toggle to enable/disable the Alpaca UDP discovery responder. This prevents port conflicts (UDP 32227) on systems running multiple Alpaca servers.
• Flasher Stability Update: Upgraded the integrated maintenance tool to esp-web-tools v10.2.1.
• Baud Rate Throttling: Implemented a locked 115,200 Baud rate for flashing.
• Improved Handle Management: Added a safety delay (3s) during serial port handovers to ensure the OS properly releases the COM port for the browser.
• Bug Fixes: Resolved a race condition in the serial discovery logic that could cause "Serial port busy" errors.

Release 0.9.15

This release introduces significant telemetry improvements for ASCOM clients, a completely rewritten build system, and high-precision voltage control.

⚠️ Important Upgrade Instructions

Important

Action Required: Uninstall Old Proxy
The installation directory architecture has changed (moved to 64-bit Program Files).
Please manually uninstall the previous version of "SV241 ASCOM Alpaca Proxy" via Windows Settings before installing this version.

Warning

Firmware Update Required
This update requires Firmware v0.9.12.
The WebUI will automatically detect the version mismatch and prompt you to update. Please use the built-in Flasher to update your ESP32.

---

🌟 Key New Features

📊 Enhanced ASCOM Telemetry (Lens Temp & PWM)

Internal sensors are now exposed directly as ASCOM Switches, allowing advanced monitoring in clients like NINA:

• Lens Temperature: Now visible as a read-only switch value (configurable visibility).
• PWM Duty Cycle: Real-time heater power output is now exposed as a read-only switch value for monitoring.
  (Commits: 5a7d094, 55649c8)

⚡ Precision Voltage Calibration

The SC8903 Adjustable Converter now uses a 15-point calibration Lookup Table (LUT) with linear interpolation.

• Accuracy: Output is calibrated to Nominal + 0.1V across the entire 1V–15V range.
• Reliability: Eliminates under-voltage issues and ensures consistent power delivery for connected equipment.
  (Commit: 6f41ff8)

🛠️ Native Windows Build System

The build system has been completely migrated from Python to native Windows Batch scripts.

• No Dependencies: Building the proxy and installer no longer requires a Python environment.
• Architecture: Installer updated to x64compatible mode for proper Program Files integration on modern Windows.
  (Commit: d1ba588)

---

🐛 Bug Fixes & Refinements

• NINA PWM Timeout: Fixed a critical issue where NINA would timeout when turning off PWM heaters (Value=0 is now correctly handled as an explicit "OFF" command).
• Master Power Logic: Simplified sync logic to rely exclusively on firmware config, preventing state conflicts.
• Installer Improvements: The uninstaller now fully removes the installation directory to ensure a clean removal.
• Voltage Safety: WebUI now enforces a minimum limit of 1.0V for the adjustable converter to prevent invalid states.

Release v0.9.14

ℹ️ Firmware Notice: If you are upgrading from v0.9.13, no firmware update is required. You only need to update the ASCOM Alpaca Proxy.

✨ New Features

• Windows Notification Control: Added a new toggle in the Proxy Settings ("Connection Settings" card) to enable or disable Windows toast notifications for device connection events.
  • Note: Default is disabled for existing installations to prevent unwanted distractions.
• UI Improvements:
  • Smart Name Truncation: Long switch names now automatically truncate with an ellipsis (...) to prevent layout issues.
  • Styled Tooltips: Hovering over a truncated name reveals the full text in a styled glassmorphism tooltip.

🐛 Bug Fixes

• Alpaca Connection Safety: The driver now correctly returns an error if an Alpaca client attempts to connect while the hardware is not actually connected.
• Layout Spacing: Fixed inconsistent vertical spacing between main dashboard sections (Live Telemetry, Power Control, Configuration, Logs).

Release 0.9.13

Fixed Coil Whine on Adjustable Output

⚠️ Firmware Update Required: This release includes important firmware changes. Please update your SV241 firmware to version 0.9.10 using the integrated web flasher.

---

Firmware (0.9.10)

Adjustable Voltage Converter - SC8903 Discovery & Fix

• Identified the buck-boost converter chip: Southchip SC8903 (previously unknown)
• Fixed coil whine/noise when the adjustable voltage output is under load
  • Based on SC8903 datasheet: VPWM pin requires 20-100 kHz PWM input
  • Changed PWM frequency from 5 kHz (out of spec) to 50 kHz
  • Reduced PWM resolution from 10-bit to 8-bit (~59mV steps, sufficient for voltage control)
• Simplified voltage control: Replaced empirical calibration LUT with direct linear formula per SC8903 datasheet (VOUT = VOUT_SET × Duty Cycle)
• Updated documentation: Added SC8903 chip reference and datasheet link to README

---

Proxy (0.9.13)

Bug Fixes

• Fixed floating-point precision display issue in ASCOM Alpaca API responses
  • Values like 3.4 were displaying as 3.4000000000000004 in client software (e.g., NINA)
  • All float responses are now rounded to 2 decimal places

Improvements

• feat(telemetry): Added scheduled database retention and cleanup
• IP address dropdown now filters APIPA addresses
• Moved development guide to proxy README

Release 0.9.12

🚀 Major Architecture Overhaul & SQLite Telemetry

This release represents a comprehensive modernization of the application architecture, moving from a static frontend and CSV logging to a robust Vue.js application and database-backed telemetry.

✨ Key Changes

🏗️ Complete Frontend Rewrite (Static JS → Vue.js)

We have fully migrated the frontend from static HTML/JavaScript to a modern Vue.js 3 Single Page Application (SPA).

• Motivation: The legacy static-site architecture had become unmaintainable. Managing state across disparate files and ensuring UI consistency was increasingly difficult and error-prone.
• Improvements:
  • Component-Based Architecture: Modular, reusable components greatly improve code organization and maintainability.
  • Robust State Management: Implemented Pinia for predictable, centralized management of device application state.
  • Unified UX: A consistent design language and global modal system replace the disjointed legacy UI.

💾 SQLite Telemetry Backend

The file-based CSV logging system has been replaced with an SQLite database engine.

• Why: CSV files were prone to concurrency issues and made querying historical data inefficient.
• Benefits:
  • Performance: Instantaneous retrieval of historical data for graphing.
  • Reliability: ACID transactions prevent data corruption during writes.
  • Scalability: Supports complex querying for the new Telemetry Explorer efficiently.

🐛 Critical Fixes

• fix: Hybrid approach for FindPort with guaranteed cleanup
  • Implemented a hybrid approach for serial port detection to solve hanging issues.
  • Keeps a goroutine for hard timeout protection against hanging ports.
  • Stores the port handle in a shared variable for reliable external cleanup.
  • Force closes the port when the main thread times out, preventing both process hangs and orphaned port handles.

---

Run npm run build in AscomAlpacaProxy/frontend-vue before building the Go binaries to ensure these changes are included.

Release 0.9.11

SV241-Unbound 0.9.11 - Integrated Flasher & First-Run Wizard

🎉 All-in-One Installation

You now only need the Proxy Installer!
The firmware flasher is fully integrated into the proxy application - no internet connection required, no separate tools needed.

✨ First-Run Wizard

On first startup, a guided wizard automatically detects your SV241 hardware and walks you through the firmware installation:

• Actively polls for device connection with a live countdown timer
• Detects if compatible firmware is already installed
• One-click access to the integrated web flasher

Note for existing users: When upgrading from a previous version, the First-Run Wizard will appear once. Simply click "Continue Setup" to dismiss it.

🔔 Firmware Update Notification

When a newer firmware version is bundled with the proxy than what's currently installed on your device, the setup page will show:

• Banner notification at the top of the page linking to the flasher
• First-Run Wizard displays version comparison and offers direct update

Note: The web flasher requires Chrome or Edge (Web Serial API).

---

💡 Getting Started

1. Download and run the installer
2. Right-click the system tray icon → Open Setup Page
3. Follow the First-Run Wizard to flash firmware
4. Connect from your astronomy software (NINA, SGP, etc.)
   Full documentation: readme.md

Release 0.9.10

Release 0.9.10 - ASCOM Alpaca Proxy Only

⚠️ Firmware unchanged: If you already have firmware v0.9.9 installed, no firmware update is required. Only the ASCOM Alpaca Proxy needs to be updated.

✨ New Features

Sensor Switches for NINA Gauges

Power metrics are now available as read-only ASCOM switches:

• ID 0: Input Voltage (V)
• ID 1: Total Current (A)
• ID 2: Total Power (W)

Use these in NINA gauges or any Alpaca client that supports analog switch values.

⚠️ BREAKING CHANGE: All existing switch IDs shift by +3 (DC1 was ID 0, now ID 3). You may need to update your sequences or reconnect your equipment.

Extended CSV Telemetry Logging

Switch states are now logged alongside sensor data:

• Columns: dc1, dc2, dc3, dc4, dc5, usbc12, usb345, adj_conv
• Enabled switches show 0 (off) or 1 (on)
• adj_conv shows actual voltage (e.g., 9.5) when on
• Disabled switches show empty values

---

🐛 Bug Fixes

• Fixed: Periodic UI refresh no longer overwrites unsaved config changes

---

📝 Documentation Updates

• Added sensor switch API examples (curl/PowerShell)
• Added PowerShell examples for direct serial communication
• Documented dry_sensor command and dm (dew heater modes) array
• Added ASCOM client reconnection requirement notes
• Removed deprecated getvoltage, getcurrent, getpower actions

---

🔄 Migration Notes

1. Switch IDs changed: Disconnect and reconnect your ASCOM clients after updating
2. Old CSV files: New files will have additional switch columns; old files remain compatible for reading

Release 0.9.9

🚀 SV241-Unbound v0.9.9

This is a critical maintenance release focused on stability, bug fixes, and security. We highly recommend all users upgrade to this version.

⚠️ IMPORTANT CHANGE: New Network Port

To avoid conflicts with other applications, the default network port has been changed:

• Old: 8080
• New: 32241

Please Note:

• Existing Users: Your current configuration (port 8080) remains unchanged unless you delete your proxy_config.json file.
• If you do change the port:
  • Update your browser bookmarks.
  • Update port settings in your astronomy software (NINA, Voyager, etc.).
  • Static ASCOM Driver: If you used the "Create SV241 Ascom Driver" script, you must run it again to register the driver with the new port.

🐛 Bug Fixes & Stability

• Fix for Hanging Port Detection: A timeout prevents the proxy from hanging indefinitely at startup if a serial port (e.g., CH340) fails to respond, ensuring reliable startup.
• Robust Connection: Improved detection when the box is plugged in after the proxy has started. Firmware version is now displayed reliably.
• Memory Optimization: Reduced heap fragmentation on the ESP32 for even longer runtime stability without reboots.
• Resource Leaks Fixed: Various minor fixes in the proxy server to properly close resources during HTTP requests.

✨ New Features

• Improved Backup & Restore: Confirmation dialogs prevent accidental overwrites, and all settings (including Port & Logging) are now correctly restored.
• Log Download: New button in the web interface to download the proxy.log directly.

📚 Documentation

• Comprehensive documentation updates: New guide for the web interface, detailed explanation of the REST API, and clarification of firewall rules.

Release 0.9.8

Release Notes

⭐ Highlights

Hide Unused Outputs from Web UI and ASCOM

The most significant addition in this release: Switches and Dew Heaters can now be disabled and hidden from both the Web UI and ASCOM/Alpaca device list.
How to hide unused outputs:

• Standard Switches (DC1-DC5, USB, ADJ): Set startup state to "Disabled" via serial command or firmware config
• Dew Heaters (PWM1/PWM2): Select "Disabled" mode in the Web UI heater settings
  Disabled outputs are:
• Hidden from the Power Control grid
• Removed from the ASCOM switch list
• Protected from accidental activation (Master Power ignores them)

---

🚀 Other New Features

• Follower Mode with Minimum Temperature Leader - Sync mode now supports Mode 4 (MinTemp) as a valid leader
• Master Power Switch Visibility - Option to hide Master Power from ASCOM clients
• Custom Naming for Dew Heaters - Added custom name input fields for PWM1/PWM2
• Improved UI - Custom glass-panel modals, mobile-responsive layout

---

🐛 Key Bug Fixes

• Non-Blocking SHT40 Drying Cycle - Sensor drying runs in background without blocking firmware
• Voltage control fixes - Setting 0V now turns off the output; slider shows correct value
• Stable ASCOM switch mapping - Uses internal names instead of hardcoded IDs
• Telemetry chart - Auto-selects most recent date when opened
• Firmware stability - Fixed I2C transactions, stack overflow prevention, mutex locks

Release 0.9.7

Release v0.9.7

This release introduces major improvements for manual dew heater control and adjustable voltage output (ADJ) via ASCOM/Alpaca.

🚀 New Features

Variable PWM Control (0-100%)

• Feature: Dew heaters ("PWM1", "PWM2") can now be controlled linearly from 0% to 100% via ASCOM (e.g., NINA Slider) when in Manual Mode.
• Technology: Values are stored directly in RAM ("RAM Overrides") to prevent flash wear. Feedback is immediate with zero lag.
• UI: The ASCOM driver dynamically detects the mode, displaying a Slider (0-100) in Manual Mode and a Switch (On/Off) in Auto Mode.

Adjustable Voltage Output (0-15V)

• Feature: The "ADJ" output can now be used as a variable slider (0-15V) in ASCOM.
• Activation: Must be enabled in Proxy Settings (/setup) -> "Enable Alpaca Voltage Control".
• Precision: Cleanly distinguishes between "OFF" (0V / False) and the set voltage target.

Objective Temperature via ASCOM

• Feature: Added new ASCOM Action getlenstemperature. Allows scripts/plugins to retrieve the currently measured objective temperature.

Offline Fonts

• UI: The "Outfit" font family is now embedded locally. The web interface now loads instantly and correctly even without an internet connection.

✨ Improvements & Fixes

• Auto-Mode Status: The firmware now always reports heaters in Auto Mode as "Active" (true) as long as they are enabled, even if the current PID power output is 0%. This prevents switches in ASCOM clients from incorrectly flipping to "Off".
• SHT40 Offset: Corrected default Humidity Offset for SHT40 sensors to 0.0 (was -10.0).
• Proxy Stability: Improved robustness of the Alpaca Proxy when handling mixed data types from the device.