Introduction
In line with previous Platform installers, 7.0 is a cumulative release that contains all enhancements and fixes from previous Platform releases and service packs. The Platform
environment pre-requisites are listed here Platform Prerequisites.
Changes in 7.0 - For Everyone-
Simplified Start menu with ASCOM applications in the top-level menu.
-
The ASCOM global default log file location can now be customised to a value other than Documents\ASCOM.
-
The new location can be set through the Diagnostics Tool – Tools / Set Log File Location menu dialogue.
-
This only applies to logs from applications and drivers that use the Platform’s TraceLogger component.
If the developer created their own logging mechanic their logs will remain in the location defined by the developer.
-
Improvements in performance
-
The entire device operational state can be determined in a single call, replacing use of many single purpose calls.
-
Focus on async operations to keep UIs responsive
- Updated explanatory user guide that now includes Alpaca.
- ASCOM Remote and the ASCOM Omni-Simulators are now included in the install
-
The ASCOM Omni-Simulators are now the default Platform simulators.
-
The original simulators can be used if required through a configuration option in the Diagnostics Tool Options menu.
The Platform now includes the "JustAHub" hub application to host 32bit in-process (DLL based) drivers and enable them to be used by 64bit applications.
JustAHub is intentionally straight-forward to configure and, unlike Device Hub, has no user interface of its own beyond selecting which
devices are hosted.
Initially, JustAHub hosts camera and filter wheel drivers, to support cameras that have built in filter wheels and which are controlled through
a single physical connection. Support for further ASCOM device types will be added in future releases.
-
There is now a weekly scheduled Platform update availability check.
-
When an update is available an alert will appear as a Windows message.
-
An update check can be made manually by running the Diagnostics Tool. An “Update available button will appear when an update has been posted to GitHub.
-
Update checks can be enabled and disabled through the Diagnostics Options menu.
- The Platform Focuser simulator has better field labelling when in relative mode and accepts negative movement offsets.
-
Platform Installer
-
Has an updated appearance
-
Now has more reliable and consistent error reporting
-
Now has a clear cache option to address “File Missing” issues during installation
-
Dynamic Clients
-
The Dynamic Clients now provide access to the Alpaca device's HTML configuration pages though the SetupDialog method when the Alpaca device is connected.
Previously all access was blocked.
-
When connecting to an Alpaca device that cannot be reached, the Dynamic Clients now time out in about 4 seconds rather than the 10 second delay in Platform 6.
The quicker return on fail now also applies to the InterfaceVersion property, which some applications call before connecting, and which suffered from a 30 second
delay before reporting a failed connection.
-
Device Hub
-
The activity log page now has a "Save Settings" button to save the current logging configuration, which will be restored when the activity log is next used.
-
The activity log now starts recording activity as soon as Device Hub is started, even if the activity log is not visible, and limits capacity to about the most
recent 1600 entries to prevent excessive memory consumption. In previous versions, activity that occurred before opening the activity log was not recorded.
-
The activity log can now optionally be written to disk.
-
A configuration option has been added that will automatically show the activity log when Device Hub starts.
-
The telescope rate offset fields and "Send to telescope" buttons are now enabled only when tracking at sidereal rate in line with the interface specification.
-
Device Hub now shuts down more quickly than previously.
-
The F12 key now toggles the Device Hub "Keep on top" state.
-
Installer
- The installer no longer displays a successful install message when an error occurs.
- All external links now use https rather than http.
-
Telescope Simulators - These now respect the TrackingRates configuration setting and the TrackingRates property returns a
PropertyNotImplementedExcetion when tracking rates are configured to be not available.
- Profile Explorer - The visual appearance has been improved when the application starts and is re-sized.
-
Device Hub
-
Hosted devices are now polled directly every time a client application asks for an operational property value such as Telescope.RightAscension.
The previous behaviour of returning cached values could result in incorrect values being returned to clients because the caches could be as much as 3 seconds (telescope)
or 5 seconds (dome, focuser) out of date with current device values.
- The default dome radius in the dome geometry configuration has been changed from 0.0 to 2000.0 to ensure that dome synchronisation works "out of the box".
- When a device does not supply an expected numeric value, the displayed text in the Device Hub is now "Unavailable" rather than "NaN".
-
Diagnostics
- Fixed a bug where a non-existent directory could cause an unexpected Diagnostics error.
- Fixed issues being reported when some telescope simulator settings were not at their default values.
- The full Windows 10/11 version name e.g. "Windows 11 24H2" is now displayed rather than "Windows 10".
- Chooser - Fixed exception when starting the Alpaca device manager application when no device was selected in the Chooser drop-down list.
Key Changes in 7.0 - For Developers- The developer components are now included with the main installer and no longer need to be installed separately.
- How to make an ASCOM driver document completely re-written to document the current process.
- A new DeviceState property for all interfaces that returns the entire device operational state in a single call.
- New asynchronous Connect and Disconnect methods for all interfaces.
-
New asynchronous methods and API clarifications.
-
Platform neutral online documentation – External link
ascom-standards.org/newdocs
- Documentation clarity on where async operation is expected
- DriverAccess now has convenience methods to retrieve device state in a single call.
- The driver templates have been updated to support Platform 7 interface changes.
- SOFA has been updated to release 19 as issued on 11th October 2023.
- Platform 6 versions of Conform are incompatible with Platform 7 and a warning is issued by the Platform installer to this effect. An updated version is available on GitHub.
- Interface version numbers have all increased by 1.
Issues Fixed in 7.0 - For Developers- NOVASCOM – Fixed error in Sun Ephemeris calculation introduced when the Code was transcribed from C++ in 2009.
- Driver template – Fixed issue in Focuser Link code that resulted in an out of the box Conform fail.
- Fixed issue in NOVAS 3.1 component where the ephemeris file may not have been closed on DLL unload.
- The installer now pre-populates historic leap second data so that AstroUtils.DeltaUT1 works out of the box when there has been no earth rotation data update.
- Fixed a bug introduced in Platform 6.6 SP2 where a DriverException was returned instead of more specialised exceptions like InvalidValueException.
-
The driver template default namespace has been changed to ASCOM.LocalServer from ASCOM.LocalServer.Server because the latter causes
a namespace clash with the Server class when a resources file is added.
Breaking Changes (For Developers) in Platform 7.0
Known Limitations - Developers-
The components in the Astrometry.NOVAS namespace are fully usable from .NET languages but are not fully
accessible through COM from scripting languages because a number of parameters are passed by reference or use
structures that do not pass across the COM interface. Two work rounds are available:
- Use the Transform component in the ASCOM.Astrometry.Transform namespace, it is fully COM compatible.
-
Create your own COM presentation component that encapsulates the SOFA or NOVAS 3.1 functions that you require
and presents them in a COM compatible fashion to suit your needs. This component can them be consumed by your
scripting application.
Platform Infrastructure Changes- A more secure code signing mechanic has been introduced.
- All current components that were written in VB have been migrated to C#.
- The Platform source code folder structure has been rationalised.
- The installer internal structure has been simplified to improve maintainability.