_images/Bug72.jpg

IStateValue Interface

class StateValue

Each device type has a property DeviceState which returns a set of aggregated operational properties of the device. Each of these operatinosl properties are returned as an object with Name and Value properties.

Properties

property Name: string

The name of an operational property. The name is case sensitive and must match the property name’s spelling and casing in the relevant ASCOM interface specification.

property Value: object

The corresponding value of the named operational property. The StateValue.Value property has the object type so that it can accept any type including the types commonly used in ASCOM interfaces such as int16, int32, double, string and enum. This approach avoids localisation complexities when transferring numeric and bool types

Important

  • Integer values should be transferred as little endian byte sequences.

  • Floating point values should be transferred using the 32-bit single-precision and 64-bit double-precision IEC 60559 formats for Single and Double values respectively.

  • Boolean values should be transferred using integer 0 for FALSE and a non-zero value to represent TRUE.

  • String values should be UTF16 encoded without a null terminator.

These requirements are met by the Microsoft C++ and .NET languages, for other languages, please consolut your language implementation documentation.