Skip to content

ASCOM.Common

Directory actions

More options

Directory actions

More options

Latest commit

 

History

History

ASCOM.Common

README.md

ASCOM.Common

Library of components providing common Interfaces, enums and other types for ASCOM projects.

Version History

The version history only contains entries when a change is made.

Release 4.0.0

  • CHANGE - If a null value is passed to the ExceptionHelper.ErrorCodeFromException method a default error code of AlpacaErrors.Unknown is now returned instead of throwing a NullReferenceException.
  • BUG-FIX - The ExceptionHelper.ErrorCodeFromException method now returns AlpacaErrors.ActionNotImplementedException instead of AlpacaErrors.NotImplemented when handling an ActionNotImplementedException.
  • BUG-FIX - The Focuser and Video device state classes incorrectly recorded messages as coming from the FilterWheel device.

Release 3.1.0

  • REVISED - Interface help text is now consistent with the online canonical documentation for the interface.

Release 3.0.0

  • ADDED - Support for .NET 8.0, 9.0 and 10.0 target frameworks. It will no longer be necessary for applications that use these frameworks to rely on the .NET Standard 2.0 component.

Release 2.2.0

  • AlpacaTools - Add a new ToByteArray() method that allows the element type returned to the client to be specified. Previously the array would always have the element type of the array provided by the Alpaca device.

Release 2.0.9

  • Add new InterfaceHasMember and DeviceCapabilities.VersionIntroduced methods to help clients and drivers support multiple interface versions.

Release 2.0.8

  • Refactor DeviceCapabilities so that there is only one source of truth for when interface changes occurred.
  • Add IsSupportedInterface and IsValidInterface methods to DeviceCapabilities.

Release 2.0.7

  • Added further logging to the ConnectAsync extension to aid debugging.

Release 2.0.6

  • Fix - The ConnectAsync and DisconnectAsync extension methods now work correctly with both Platform 6 and 7 devices. Both methods have additional mandatory parameters to specify the device type and interface version implemented by the device. These are required to enable the method to differentiate between Platform 6 and Platform 7 interfaces. For Platform 7 interface devices the Connect() and Disconnect() methods are used while the Connected property is used for Platform 6 devices.

Release 2.0.0

  • Add support for Platform 7 interface changes.
  • Added JSON response classes for new interface members.
  • Added further discovery members to DeviceCapabilities such as IsPlatform7Orlater(), HasConnectAndDeviceState() and HasCoverMoving().
  • Added client async task extensions ConnectAsync() and DisconnectAsync().
  • Fix - A MethodNotImplementedException was replaced by a NotImplementedException in line with Library policy.
  • Fix - Client async methods now respect timeouts if the target driver/device locks up and does not return from the initiator or polling variable.

Release 1.0.106

  • A new base class has been introduced in the Alpaca response classes to enable just error keys to be extracted from JSON responses. This is expected to be a non-breaking backward compatible change.

Components

  • ASCOM.Common.Alpaca - Common types for accessing and working with Alpaca devices.
  • ASCOM.Common.Com - Common types for accessing and working with ASCOM COM drivers.
  • ASCOM.Common.DeviceInterfaces - Device interfaces for Alpaca and COM drivers. Also includes types and enums.
  • ASCOM.Common.Helpers - Sets of extension methods to help use ASCOM and Alpaca drivers.
  • ASCOM.Common.Interfaces - Interfaces for library functions.