
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 withName
andValue
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 typesImportant
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-precisionIEC 60559
formats forSingle
andDouble
values respectively.
Boolean
values should be transferred using integer 0 forFALSE
and a non-zero value to representTRUE
.
String
values should beUTF16
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.