aes70 1.6.1 → 2.0.0

package/src/controller/ControlClasses/OcaNumericObserverList.d.ts

@@ -42,20 +42,20 @@ import { OcaAgent } from './OcaAgent';
  *  - For signed integer targets, the threshold and target are both coerced to
  *    **OcaInt64** before comparing.
  *
- *  - For boolean values, the threshold hreshold and target are both coerced to
+ *  - For boolean values, the threshold and target are both coerced to
  *    **OcaUint8**, True is assigned the value One, False is assigned the value
  *    Zero.
  *
  *
  * Note that this coercion may result in rounding errors if the observed
- * datatype is of type OcaUint64 or OcaUint64. An **OcaNumericObserver**
+ * datatype is of type **OcaUint64** or **OcaInt64**. An **OcaNumericObserver**
  * instance and the property it observes are bound at the time the
  * **OcaNumericObserver** instance is constructed. For static devices,
  * construction will occur during manufacture, or possibly during a subsequent
  * hardware configuration step. For reconfigurable devices, construction might
  * be done by online controllers as part of device configuration sessions. This
- * class is normally used for monitoring readings of sensor readings, but may be
- * used equally well for watching workers' parameter settings.
+ * class is normally used for monitoring sensor readings, but may be used
+ * equally well for watching workers' parameter settings.
  * @extends OcaAgent
  * @class OcaNumericObserverList
  */
@@ -115,8 +115,7 @@ export declare class OcaNumericObserverList extends OcaAgent {
    * The order of values in the returned list is determined by the order of
    * values set by SetObservedProperties, and is the same as the order of values
    * returned by the Observation event, and the same as the order of object
-   * identifications returned by GetObservedProperties. The return status
-   * indicates whether the value has been successfully returned.
+   * identifications returned by GetObservedProperties.
    *
    * @method OcaNumericObserverList#GetLastObservation
    * @returns {Promise<number[]>}
@@ -125,8 +124,7 @@ export declare class OcaNumericObserverList extends OcaAgent {
   GetLastObservation(): Promise<number[]>;
 
   /**
-   * Gets the observer's state. The return value indicates whether the state was
-   * successfully retrieved.
+   * Gets the observer's state.
    *
    * @method OcaNumericObserverList#GetState
    * @returns {Promise<OcaObserverState>}
@@ -137,10 +135,9 @@ export declare class OcaNumericObserverList extends OcaAgent {
   /**
    * Gets the identifications of the properties that the observer observes. The
    * order of property identifications in the returned list is determined by the
-   * order of property identifications set by SetObservedProperties, and is the
-   * same as the order of values returned by GetLastObservation and the
-   * Observation event. The return value indicates whether the identifications
-   * were successfully retrieved.
+   * order of property identifications set by **SetObservedProperties**, and is
+   * the same as the order of values returned by **GetLastObservation** and the
+   * **Observation** event.
    *
    * @method OcaNumericObserverList#GetObservedProperties
    * @returns {Promise<OcaProperty[]>}
@@ -151,9 +148,8 @@ export declare class OcaNumericObserverList extends OcaAgent {
   /**
    * Sets the identifications of the properties that the observer observes. The
    * order of property identifications supplied determines the order of property
-   * identifications returned by GetObservedProperties and the order of values
-   * returned by GetLastObservation and the Observation event. The return value
-   * indicates whether the identifications were successfully set.
+   * identifications returned by **GetObservedProperties** and the order of
+   * values returned by **GetLastObservation** and the **Observation** event.
    *
    * @method OcaNumericObserverList#SetObservedProperties
    * @param {IOcaProperty[]} property
@@ -163,8 +159,7 @@ export declare class OcaNumericObserverList extends OcaAgent {
   SetObservedProperties(property: IOcaProperty[]): Promise<void>;
 
   /**
-   * Gets the value of the **Threshold** property. The return value indicates
-   * whether the threshold value was successfully retrieved.
+   * Gets the value of the **Threshold** property.
    *
    * @method OcaNumericObserverList#GetThreshold
    * @returns {Promise<number>}
@@ -173,8 +168,7 @@ export declare class OcaNumericObserverList extends OcaAgent {
   GetThreshold(): Promise<number>;
 
   /**
-   * Sets the value of the **Threshold** property. The return value indicates
-   * whether the threshold value was successfully set.
+   * Sets the value of the **Threshold** property.
    *
    * @method OcaNumericObserverList#SetThreshold
    * @param {number} Threshold
@@ -194,8 +188,7 @@ export declare class OcaNumericObserverList extends OcaAgent {
   GetOperator(): Promise<OcaRelationalOperator>;
 
   /**
-   * Sets the value of the **Operator** property. The return value indicates
-   * whether the operator was successfully set.
+   * Sets the value of the **Operator** property.
    *
    * @method OcaNumericObserverList#SetOperator
    * @param {IOcaRelationalOperator} operator
@@ -205,8 +198,7 @@ export declare class OcaNumericObserverList extends OcaAgent {
   SetOperator(operator: IOcaRelationalOperator): Promise<void>;
 
   /**
-   * Gets the value of the **TwoWay** property. The return value indicates
-   * whether the property was successfully retrieved.
+   * Gets the value of the **TwoWay** property.
    *
    * @method OcaNumericObserverList#GetTwoWay
    * @returns {Promise<boolean>}
@@ -215,8 +207,7 @@ export declare class OcaNumericObserverList extends OcaAgent {
   GetTwoWay(): Promise<boolean>;
 
   /**
-   * Sets the value of the **TwoWay** property. The return value indicates
-   * whether the property was successfully set.
+   * Sets the value of the **TwoWay** property.
    *
    * @method OcaNumericObserverList#SetTwoWay
    * @param {boolean} twoWay
@@ -226,8 +217,7 @@ export declare class OcaNumericObserverList extends OcaAgent {
   SetTwoWay(twoWay: boolean): Promise<void>;
 
   /**
-   * Gets the value of the **Hysteresis** property. The return value indicates
-   * whether the property was successfully retrieved.
+   * Gets the value of the **Hysteresis** property.
    *
    * @method OcaNumericObserverList#GetHysteresis
    * @returns {Promise<number>}
@@ -236,8 +226,7 @@ export declare class OcaNumericObserverList extends OcaAgent {
   GetHysteresis(): Promise<number>;
 
   /**
-   * Sets the value of the **Hysteresis** property. The return value indicates
-   * whether the property was successfully set.
+   * Sets the value of the **Hysteresis** property.
    *
    * @method OcaNumericObserverList#SetHysteresis
    * @param {number} hysteresis
@@ -247,8 +236,7 @@ export declare class OcaNumericObserverList extends OcaAgent {
   SetHysteresis(hysteresis: number): Promise<void>;
 
   /**
-   * Gets the value of the **Period** property. The return value indicates
-   * whether the property was successfully retrieved.
+   * Gets the value of the **Period** property.
    *
    * @method OcaNumericObserverList#GetPeriod
    * @returns {Promise<number>}
@@ -257,8 +245,7 @@ export declare class OcaNumericObserverList extends OcaAgent {
   GetPeriod(): Promise<number>;
 
   /**
-   * Sets the value of the **Period** property. The return value indicates
-   * whether the property was successfully set.
+   * Sets the value of the **Period** property.
    *
    * @method OcaNumericObserverList#SetPeriod
    * @param {number} period

package/src/controller/ControlClasses/OcaNumericObserverList.js

@@ -42,20 +42,20 @@ import { OcaAgent } from './OcaAgent.js';
  *  - For signed integer targets, the threshold and target are both coerced to
  *    **OcaInt64** before comparing.
  *
- *  - For boolean values, the threshold hreshold and target are both coerced to
+ *  - For boolean values, the threshold and target are both coerced to
  *    **OcaUint8**, True is assigned the value One, False is assigned the value
  *    Zero.
  *
  *
  * Note that this coercion may result in rounding errors if the observed
- * datatype is of type OcaUint64 or OcaUint64. An **OcaNumericObserver**
+ * datatype is of type **OcaUint64** or **OcaInt64**. An **OcaNumericObserver**
  * instance and the property it observes are bound at the time the
  * **OcaNumericObserver** instance is constructed. For static devices,
  * construction will occur during manufacture, or possibly during a subsequent
  * hardware configuration step. For reconfigurable devices, construction might
  * be done by online controllers as part of device configuration sessions. This
- * class is normally used for monitoring readings of sensor readings, but may be
- * used equally well for watching workers' parameter settings.
+ * class is normally used for monitoring sensor readings, but may be used
+ * equally well for watching workers' parameter settings.
  * @extends OcaAgent
  * @class OcaNumericObserverList
  */
@@ -63,7 +63,7 @@ export const OcaNumericObserverList = make_control_class(
   'OcaNumericObserverList',
   3,
   '\u0001\u0002\t',
-  2,
+  3,
   OcaAgent,
   [
     ['GetLastObservation', 3, 1, [], [OcaList(OcaFloat64)]],
@@ -100,16 +100,14 @@ export const OcaNumericObserverList = make_control_class(
  * of values in the returned list is determined by the order of values set by
  * SetObservedProperties, and is the same as the order of values returned by the
  * Observation event, and the same as the order of object identifications
- * returned by GetObservedProperties. The return status indicates whether the
- * value has been successfully returned.
+ * returned by GetObservedProperties.
  *
  * @method OcaNumericObserverList#GetLastObservation
  * @returns {Promise<number[]>}
  *   A promise which resolves to a single value of type ``number[]``.
  */
 /**
- * Gets the observer's state. The return value indicates whether the state was
- * successfully retrieved.
+ * Gets the observer's state.
  *
  * @method OcaNumericObserverList#GetState
  * @returns {Promise<OcaObserverState>}
@@ -118,10 +116,9 @@ export const OcaNumericObserverList = make_control_class(
 /**
  * Gets the identifications of the properties that the observer observes. The
  * order of property identifications in the returned list is determined by the
- * order of property identifications set by SetObservedProperties, and is the
- * same as the order of values returned by GetLastObservation and the
- * Observation event. The return value indicates whether the identifications
- * were successfully retrieved.
+ * order of property identifications set by **SetObservedProperties**, and is
+ * the same as the order of values returned by **GetLastObservation** and the
+ * **Observation** event.
  *
  * @method OcaNumericObserverList#GetObservedProperties
  * @returns {Promise<OcaProperty[]>}
@@ -130,9 +127,8 @@ export const OcaNumericObserverList = make_control_class(
 /**
  * Sets the identifications of the properties that the observer observes. The
  * order of property identifications supplied determines the order of property
- * identifications returned by GetObservedProperties and the order of values
- * returned by GetLastObservation and the Observation event. The return value
- * indicates whether the identifications were successfully set.
+ * identifications returned by **GetObservedProperties** and the order of values
+ * returned by **GetLastObservation** and the **Observation** event.
  *
  * @method OcaNumericObserverList#SetObservedProperties
  * @param {IOcaProperty[]} property
@@ -140,16 +136,14 @@ export const OcaNumericObserverList = make_control_class(
  * @returns {Promise<void>}
  */
 /**
- * Gets the value of the **Threshold** property. The return value indicates
- * whether the threshold value was successfully retrieved.
+ * Gets the value of the **Threshold** property.
  *
  * @method OcaNumericObserverList#GetThreshold
  * @returns {Promise<number>}
  *   A promise which resolves to a single value of type ``number``.
  */
 /**
- * Sets the value of the **Threshold** property. The return value indicates
- * whether the threshold value was successfully set.
+ * Sets the value of the **Threshold** property.
  *
  * @method OcaNumericObserverList#SetThreshold
  * @param {number} Threshold
@@ -165,8 +159,7 @@ export const OcaNumericObserverList = make_control_class(
  *   A promise which resolves to a single value of type :class:`OcaRelationalOperator`.
  */
 /**
- * Sets the value of the **Operator** property. The return value indicates
- * whether the operator was successfully set.
+ * Sets the value of the **Operator** property.
  *
  * @method OcaNumericObserverList#SetOperator
  * @param {IOcaRelationalOperator} operator
@@ -174,16 +167,14 @@ export const OcaNumericObserverList = make_control_class(
  * @returns {Promise<void>}
  */
 /**
- * Gets the value of the **TwoWay** property. The return value indicates whether
- * the property was successfully retrieved.
+ * Gets the value of the **TwoWay** property.
  *
  * @method OcaNumericObserverList#GetTwoWay
  * @returns {Promise<boolean>}
  *   A promise which resolves to a single value of type ``boolean``.
  */
 /**
- * Sets the value of the **TwoWay** property. The return value indicates whether
- * the property was successfully set.
+ * Sets the value of the **TwoWay** property.
  *
  * @method OcaNumericObserverList#SetTwoWay
  * @param {boolean} twoWay
@@ -191,16 +182,14 @@ export const OcaNumericObserverList = make_control_class(
  * @returns {Promise<void>}
  */
 /**
- * Gets the value of the **Hysteresis** property. The return value indicates
- * whether the property was successfully retrieved.
+ * Gets the value of the **Hysteresis** property.
  *
  * @method OcaNumericObserverList#GetHysteresis
  * @returns {Promise<number>}
  *   A promise which resolves to a single value of type ``number``.
  */
 /**
- * Sets the value of the **Hysteresis** property. The return value indicates
- * whether the property was successfully set.
+ * Sets the value of the **Hysteresis** property.
  *
  * @method OcaNumericObserverList#SetHysteresis
  * @param {number} hysteresis
@@ -208,16 +197,14 @@ export const OcaNumericObserverList = make_control_class(
  * @returns {Promise<void>}
  */
 /**
- * Gets the value of the **Period** property. The return value indicates whether
- * the property was successfully retrieved.
+ * Gets the value of the **Period** property.
  *
  * @method OcaNumericObserverList#GetPeriod
  * @returns {Promise<number>}
  *   A promise which resolves to a single value of type ``number``.
  */
 /**
- * Sets the value of the **Period** property. The return value indicates whether
- * the property was successfully set.
+ * Sets the value of the **Period** property.
  *
  * @method OcaNumericObserverList#SetPeriod
  * @param {number} period
@@ -244,7 +231,7 @@ export const OcaNumericObserverList = make_control_class(
 /**
  * This event is emitted when the property ``ObservedProperties`` changes in the remote object.
  * The property ``ObservedProperties`` is described in the AES70 standard as follows.
- * List of identifiers of the properties are being observed.
+ * List of identifiers of the properties being observed.
  *
  * @member {PropertyEvent<OcaProperty[]>} OcaNumericObserverList#OnObservedPropertiesChanged
  */
@@ -286,16 +273,16 @@ export const OcaNumericObserverList = make_control_class(
  * **Operator** property is 'Inequality'. If the State is **Not Triggered** it
  * changes to **Triggered** if any of the ObservedProperties reaches the
  * Threshold. If the State is **Triggered** it changes to **Not Triggered** only
- * if all of the ObservedProperties no longer meet the ‘Threshold including
- * Hysteresis’** .**
+ * if all of the ObservedProperties no longer meet the �Threshold including
+ * Hysteresis�** .**
  *
  * @member {PropertyEvent<number>} OcaNumericObserverList#OnHysteresisChanged
  */
 /**
  * This event is emitted when the property ``Period`` changes in the remote object.
  * The property ``Period`` is described in the AES70 standard as follows.
- * Repetition period or zero. If nonzero, the observer will retrieve the value
- * and emit
+ * Repetition period or zero. Zero value means the **Observation** event is not
+ * emitted periodically.
  *
  * @member {PropertyEvent<number>} OcaNumericObserverList#OnPeriodChanged
  */

package/src/controller/ControlClasses/OcaPanBalance.d.ts

@@ -22,8 +22,7 @@ export declare class OcaPanBalance extends OcaActuator {
   constructor(objectNumber: number, device: RemoteDevice);
 
   /**
-   * Gets the value and limits of the Position property. The return value
-   * indicates whether the data was successfully retrieved.
+   * Gets the value and limits of the **Position** property.
    * The return values of this method are
    *
    * - Position of type ``number``
@@ -36,8 +35,7 @@ export declare class OcaPanBalance extends OcaActuator {
   GetPosition(): Promise<Arguments<[number, number, number]>>;
 
   /**
-   * Sets the value of the Position property. The return value indicates whether
-   * the property was successfully set.
+   * Sets the value of the **Position** property.
    *
    * @method OcaPanBalance#SetPosition
    * @param {number} Position
@@ -47,8 +45,7 @@ export declare class OcaPanBalance extends OcaActuator {
   SetPosition(Position: number): Promise<void>;
 
   /**
-   * Gets the value and limits of the MidpointGain property. The return value
-   * indicates whether the data was successfully retrieved.
+   * Gets the value and limits of the **MidpointGain** property.
    * The return values of this method are
    *
    * - Gain of type ``number``
@@ -61,8 +58,7 @@ export declare class OcaPanBalance extends OcaActuator {
   GetMidpointGain(): Promise<Arguments<[number, number, number]>>;
 
   /**
-   * Sets the value of the MidpointGain property. The return value indicates
-   * whether the property was successfully set.
+   * Sets the value of the **MidpointGain** property.
    *
    * @method OcaPanBalance#SetMidpointGain
    * @param {number} Gain

package/src/controller/ControlClasses/OcaPanBalance.js

@@ -11,7 +11,7 @@ export const OcaPanBalance = make_control_class(
   'OcaPanBalance',
   4,
   '\u0001\u0001\u0001\u0006',
-  2,
+  3,
   OcaActuator,
   [
     ['GetPosition', 4, 1, [], [OcaFloat32, OcaFloat32, OcaFloat32]],
@@ -27,8 +27,7 @@ export const OcaPanBalance = make_control_class(
 );
 
 /**
- * Gets the value and limits of the Position property. The return value
- * indicates whether the data was successfully retrieved.
+ * Gets the value and limits of the **Position** property.
  * The return values of this method are
  *
  * - Position of type ``number``
@@ -39,8 +38,7 @@ export const OcaPanBalance = make_control_class(
  * @returns {Promise<Arguments<number,number,number>>}
  */
 /**
- * Sets the value of the Position property. The return value indicates whether
- * the property was successfully set.
+ * Sets the value of the **Position** property.
  *
  * @method OcaPanBalance#SetPosition
  * @param {number} Position
@@ -48,8 +46,7 @@ export const OcaPanBalance = make_control_class(
  * @returns {Promise<void>}
  */
 /**
- * Gets the value and limits of the MidpointGain property. The return value
- * indicates whether the data was successfully retrieved.
+ * Gets the value and limits of the **MidpointGain** property.
  * The return values of this method are
  *
  * - Gain of type ``number``
@@ -60,8 +57,7 @@ export const OcaPanBalance = make_control_class(
  * @returns {Promise<Arguments<number,number,number>>}
  */
 /**
- * Sets the value of the MidpointGain property. The return value indicates
- * whether the property was successfully set.
+ * Sets the value of the **MidpointGain** property.
  *
  * @method OcaPanBalance#SetMidpointGain
  * @param {number} Gain

package/src/controller/ControlClasses/OcaPhysicalPosition.d.ts

@@ -24,8 +24,7 @@ export declare class OcaPhysicalPosition extends OcaAgent {
   constructor(objectNumber: number, device: RemoteDevice);
 
   /**
-   * Retrieves value of property **CoordinateSystem**. Result indicates whether
-   * retrieval was successful.
+   * Gets value of property **CoordinateSystem**.
    *
    * @method OcaPhysicalPosition#GetCoordinateSystem
    * @returns {Promise<OcaPositionCoordinateSystem>}
@@ -34,8 +33,7 @@ export declare class OcaPhysicalPosition extends OcaAgent {
   GetCoordinateSystem(): Promise<OcaPositionCoordinateSystem>;
 
   /**
-   * Retrieves value of property **PositionDescriptorFieldFlags**. Result
-   * indicates whether retrieval was successful.
+   * Gets value of property **PositionDescriptorFieldFlags**.
    *
    * @method OcaPhysicalPosition#GetPositionDescriptorFieldFlags
    * @returns {Promise<IOcaPositionDescriptorFieldFlags>}
@@ -44,8 +42,7 @@ export declare class OcaPhysicalPosition extends OcaAgent {
   GetPositionDescriptorFieldFlags(): Promise<IOcaPositionDescriptorFieldFlags>;
 
   /**
-   * Retrieves value of property **PositioinDescriptor**. Result indicates
-   * whether retrieval was successful.
+   * Gets value of property **PositionDescriptor**.
    * The return values of this method are
    *
    * - PositionDescriptor of type ``IOcaPositionDescriptor``

package/src/controller/ControlClasses/OcaPhysicalPosition.js

@@ -14,7 +14,7 @@ export const OcaPhysicalPosition = make_control_class(
   'OcaPhysicalPosition',
   3,
   '\u0001\u0002\u0011',
-  1,
+  3,
   OcaAgent,
   [
     ['GetCoordinateSystem', 3, 1, [], [OcaPositionCoordinateSystem]],
@@ -59,24 +59,21 @@ export const OcaPhysicalPosition = make_control_class(
 );
 
 /**
- * Retrieves value of property **CoordinateSystem**. Result indicates whether
- * retrieval was successful.
+ * Gets value of property **CoordinateSystem**.
  *
  * @method OcaPhysicalPosition#GetCoordinateSystem
  * @returns {Promise<OcaPositionCoordinateSystem>}
  *   A promise which resolves to a single value of type :class:`OcaPositionCoordinateSystem`.
  */
 /**
- * Retrieves value of property **PositionDescriptorFieldFlags**. Result
- * indicates whether retrieval was successful.
+ * Gets value of property **PositionDescriptorFieldFlags**.
  *
  * @method OcaPhysicalPosition#GetPositionDescriptorFieldFlags
  * @returns {Promise<IOcaPositionDescriptorFieldFlags>}
  *   A promise which resolves to a single value of type ``IOcaPositionDescriptorFieldFlags``.
  */
 /**
- * Retrieves value of property **PositioinDescriptor**. Result indicates whether
- * retrieval was successful.
+ * Gets value of property **PositionDescriptor**.
  * The return values of this method are
  *
  * - PositionDescriptor of type ``IOcaPositionDescriptor``

package/src/controller/ControlClasses/OcaPolarity.d.ts

@@ -20,8 +20,7 @@ export declare class OcaPolarity extends OcaActuator {
   constructor(objectNumber: number, device: RemoteDevice);
 
   /**
-   * Gets the current inverter state. The return value indicates whether the
-   * state was successfully retrieved.
+   * Gets the inversion state (i.e. value of the **State** property.
    *
    * @method OcaPolarity#GetState
    * @returns {Promise<OcaPolarityState>}
@@ -30,8 +29,7 @@ export declare class OcaPolarity extends OcaActuator {
   GetState(): Promise<OcaPolarityState>;
 
   /**
-   * Sets the inversion state (i.e. value of the State property). The return
-   * value indicates whether the state was successfully set.
+   * Sets the inversion state (i.e. value of the **State** property).
    *
    * @method OcaPolarity#SetState
    * @param {IOcaPolarityState} state

package/src/controller/ControlClasses/OcaPolarity.js

@@ -11,7 +11,7 @@ export const OcaPolarity = make_control_class(
   'OcaPolarity',
   4,
   '\u0001\u0001\u0001\u0003',
-  2,
+  3,
   OcaActuator,
   [
     ['GetState', 4, 1, [], [OcaPolarityState]],
@@ -22,16 +22,14 @@ export const OcaPolarity = make_control_class(
 );
 
 /**
- * Gets the current inverter state. The return value indicates whether the state
- * was successfully retrieved.
+ * Gets the inversion state (i.e. value of the **State** property.
  *
  * @method OcaPolarity#GetState
  * @returns {Promise<OcaPolarityState>}
  *   A promise which resolves to a single value of type :class:`OcaPolarityState`.
  */
 /**
- * Sets the inversion state (i.e. value of the State property). The return value
- * indicates whether the state was successfully set.
+ * Sets the inversion state (i.e. value of the **State** property).
  *
  * @method OcaPolarity#SetState
  * @param {IOcaPolarityState} state

package/src/controller/ControlClasses/OcaPowerManager.d.ts

@@ -6,7 +6,7 @@ import { OcaManager } from './OcaManager';
 /**
  * Optional manager that manages power settings and state.
  *
- *  - May be instantiated once in any device.
+ *  - May be instantiated at most once in any device.
  *
  *  - If instantiated, object number must be 5.
  *
@@ -43,9 +43,8 @@ export declare class OcaPowerManager extends OcaManager {
   constructor(objectNumber: number, device: RemoteDevice);
 
   /**
-   * Retrieve the value of property **03p01 State**, the current power state of
-   * the device. Return value indicates whether the value was successfully
-   * retrieved.
+   * Retrieve the value of property **State**, the current power state of the
+   * device.
    *
    * @method OcaPowerManager#GetState
    * @returns {Promise<OcaPowerState>}
@@ -54,8 +53,20 @@ export declare class OcaPowerManager extends OcaManager {
   GetState(): Promise<OcaPowerState>;
 
   /**
-   * Change the device power state. The return value indicates whether the
-   * requested change has been successfully made.
+   * Change the target power state. Erroneously named **SetState** prior to v3
+   * of this class.
+   *
+   * @method OcaPowerManager#SetTargetState
+   * @param {IOcaPowerState} State
+   *
+   * @returns {Promise<void>}
+   */
+  SetTargetState(State: IOcaPowerState): Promise<void>;
+
+  /**
+   * Change the target power state. Erroneously named **SetState** prior to v3
+   * of this class.
+   * An alias for SetTargetState.
    *
    * @method OcaPowerManager#SetState
    * @param {IOcaPowerState} State
@@ -65,8 +76,7 @@ export declare class OcaPowerManager extends OcaManager {
   SetState(State: IOcaPowerState): Promise<void>;
 
   /**
-   * Retrieves list of object number(s) of all power supply(ies). Return value
-   * indicates whether the data was successfully retrieved.
+   * Retrieves list of object number(s) of all power supply(ies).
    *
    * @method OcaPowerManager#GetPowerSupplies
    * @returns {Promise<number[]>}
@@ -75,8 +85,7 @@ export declare class OcaPowerManager extends OcaManager {
   GetPowerSupplies(): Promise<number[]>;
 
   /**
-   * Retrieves list of object number(s) of active power supply(ies). Return
-   * value indicates whether the data was successfully retrieved.
+   * Retrieves list of object number(s) of active power supply(ies).
    *
    * @method OcaPowerManager#GetActivePowerSupplies
    * @returns {Promise<number[]>}
@@ -88,8 +97,6 @@ export declare class OcaPowerManager extends OcaManager {
    * Deactivate one power supply and activate another. An option switch
    * indicates whether the previously active power supply is to be turned off.
    * If it is not turned off, it will be placed in the **Unavailable** state.
-   * The return value indicates whether the requested exchange has been
-   * successfully made.
    *
    * @method OcaPowerManager#ExchangePowerSupply
    * @param {number} oldPsu
@@ -105,12 +112,21 @@ export declare class OcaPowerManager extends OcaManager {
   ): Promise<void>;
 
   /**
-   * Gets the value of the **AutoState** property. The return value indicates
-   * whether the value was successfully retrieved.
+   * Gets the value of the **AutoState** property.
    *
    * @method OcaPowerManager#GetAutoState
    * @returns {Promise<boolean>}
    *   A promise which resolves to a single value of type ``boolean``.
    */
   GetAutoState(): Promise<boolean>;
+
+  /**
+   * Retrieve the value of property** TargetState**, the power state of the
+   * device to which the device is transitioning.
+   *
+   * @method OcaPowerManager#GetTargetState
+   * @returns {Promise<OcaPowerState>}
+   *   A promise which resolves to a single value of type :class:`OcaPowerState`.
+   */
+  GetTargetState(): Promise<OcaPowerState>;
 }