aes70 1.6.1 → 2.0.0

package/src/controller/ControlClasses/OcaMatrix.js

@@ -1,4 +1,11 @@
+import { OcaCommandResult } from '../../OCP1/OcaCommandResult.js';
+import { OcaList } from '../../OCP1/OcaList.js';
 import { OcaList2D } from '../../OCP1/OcaList2D.js';
+import { OcaList32 } from '../../OCP1/OcaList32.js';
+import { OcaLongBlob } from '../../OCP1/OcaLongBlob.js';
+import { OcaMatrixCommand } from '../../OCP1/OcaMatrixCommand.js';
+import { OcaMatrixCoordinates } from '../../OCP1/OcaMatrixCoordinates.js';
+import { OcaMethodID } from '../../OCP1/OcaMethodID.js';
 import { OcaUint16 } from '../../OCP1/OcaUint16.js';
 import { OcaUint32 } from '../../OCP1/OcaUint32.js';
 import { OcaUint8 } from '../../OCP1/OcaUint8.js';
@@ -6,48 +13,23 @@ import { make_control_class } from '../make_control_class.js';
 import { OcaWorker } from './OcaWorker.js';
 
 /**
- * A matrix is a rectangular array of identical objects ("**members**") that is
- * coordinate addressable and has sets of common input and output ports. The
- * matrix host does not instantiate these objects, but instead mediates the
- * coordinate addressing, implements the common input and output ports, and
- * provdes certain other aggregate functions. Matrix members may be workers
- * (including blocks), or agents. All members of a matrix must be of the same
- * class. No object may belong to more than one matrix at a time. No object may
- * appear more than once in a given matrix. The complete model of an OCA matrix
- * consists of: 1. One instance of **OcaMatrix.** 2. **(N x M) members**, where
- * each member is an instance of a worker or agent class. For any given matrix,
- * this class must be the same for all members, and is referred to as the
- * **member class.** Members are sometimes referred to as **cells** of the
- * matrix. 3. One additional instance of the member class, called the **matrix
- * proxy.** Thus, the **OcaMatrix** instance is a container for the
- * two-dimensional collection of its members. Once a matrix is set up, the
- * controller may get and set member properties by the following procedures:
- * **Get** To get a property value of member (x :sub:`1`, y :sub:`1`): 1.
- * Controller calls **OcaMatrix.SetXY(x1, y1)**. This action: - locks the
- * **OcaMatrix** instance, and - posts x :sub:`1` and y :sub:`1` as coordinates
- * of the object whose property value is to be retrieved. 2. Controller calls
- * the matrix proxy's **Get** method for the property value desired. This action
- * causes the **OcaMatrix** instance to: - decode the posted x :sub:`1` and y
- * :sub:`1` values into a member ONo. - call the given **Get** method for the
- * object identified by the decoded ONo. - aggregate the **OcaResult** from each
- * **Get** call into a consolidated **OcaResult**. - unlock the **OcaMatrix**
- * instance. - return the consolidated **OcaResult** to the controller. **Set**
- * ** **To set a property value of member (x :sub:`1`, y :sub:`1`), or of row
- * (0, y :sub:`1`) or column (x :sub:`1`, 0) or whole matrix (0,0) 1. Controller
- * calls **OcaMatrix.SetXY(x1, y1)**. This action: - locks the **OcaMatrix**
- * instance, and - posts x :sub:`1` and y :sub:`1` as coordinates of the object
- * whose property value is to be changed. 2. Controller calls the matrix proxy's
- * **Set** method for the target property. This action causes the **OcaMatrix**
- * instance to: - decode the posted x :sub:`1` and y :sub:`1` values into a list
- * of target member ONos, as follows: If x :sub:`1` ``>`` 0 and y :sub:`1` ``>``
- * 0, the list will be the single ONo of the addressed cell. If x :sub:`1` = 0
- * and y :sub:`1` ``>`` 0, the list will be the list of ONos of the cells in row
- * y :sub:`1` . If x :sub:`1` ``>`` 0 and y :sub:`1` = 0, the list will be the
- * list of ONos of the cells in column x :sub:`1`. If x :sub:`1` = 0 and y
- * :sub:`1` = 0, the list will be the list of ONos of all cells of the matrix. -
- * call the given **Set** method for each target member in the ONo list. -
- * aggregate the **OcaResult** from each **Set** call into a consolidated
- * **OcaResult**. - unlock the **OcaMatrix** instance.
+ * Rectangular array of identical objects (**Matrix Members,** or just****
+ * **Members** in context) that is coordinate addressable and has sets of common
+ * input and output ports. An **OcaMatrix** instance is a container for a
+ * two-dimensional collection of members. Matrix members may be workers
+ * (including blocks or other matrices), or agents. All members of a given
+ * matrix shall be of the same class (*the* **member class**). No object shall
+ * belong to more than one matrix at a time. No object shall appear more than
+ * once in a given matrix. The **OcaMatrix** object shall not instantiate the
+ * Members, but instead shall provide the coordinate addressing, implement the
+ * common input and output ports, and provide certain other aggregate functions.
+ * The term M**atrix** means an **OcaMatrix** object *plus* the ancillary
+ * objects that collectively provide matrixing functionality. Specifically, a
+ * Matrix shall consists of: 1. One instance of the **OcaMatrix** class (the
+ * **matrix object**); and 2. **(N x M) members**, where each member shall be an
+ * instance of the member class; and The normative specification of the
+ * **OcaMatrix** class is here. The normative specification of the overall
+ * Matrix mechanism, with informative examples, is in [AES70-1(Matrices)].
  * @extends OcaWorker
  * @class OcaMatrix
  */
@@ -55,7 +37,7 @@ export const OcaMatrix = make_control_class(
   'OcaMatrix',
   3,
   '\u0001\u0001\u0005',
-  2,
+  4,
   OcaWorker,
   [
     ['GetCurrentXY', 3, 1, [], [OcaUint16, OcaUint16]],
@@ -80,6 +62,20 @@ export const OcaMatrix = make_control_class(
     ['SetPortsPerColumn', 3, 14, [OcaUint8], []],
     ['SetCurrentXYLock', 3, 15, [OcaUint16, OcaUint16], []],
     ['UnlockCurrent', 3, 16, [], []],
+    [
+      'ExecuteMethod',
+      3,
+      17,
+      [OcaList32(OcaMatrixCoordinates), OcaMethodID, OcaList(OcaLongBlob)],
+      [OcaList(OcaCommandResult)],
+    ],
+    [
+      'ExecuteCommands',
+      3,
+      18,
+      [OcaList32(OcaMatrixCommand)],
+      [OcaList32(OcaCommandResult)],
+    ],
   ],
   [
     ['X', [OcaUint16], 3, 1, false, false, null],
@@ -88,15 +84,14 @@ export const OcaMatrix = make_control_class(
     ['ySize', [OcaUint16], 3, 4, false, false, null],
     ['Members', [OcaList2D(OcaUint32)], 3, 5, false, false, null],
     ['Proxy', [OcaUint32], 3, 6, false, false, null],
-    ['PortsPerRow', [OcaUint8], 3, 7, false, false, null],
-    ['PortsPerColumn', [OcaUint8], 3, 8, false, false, null],
   ],
   []
 );
 
 /**
  * Gets coordinates of the currently active area (cell, row, column, or whole
- * matrix). The returned status indicates whether the operation was successful.
+ * matrix). See the definitions of the properties **X** and **Y** for
+ * specification of X and Y values.
  * The return values of this method are
  *
  * - x of type ``number``
@@ -106,8 +101,12 @@ export const OcaMatrix = make_control_class(
  * @returns {Promise<Arguments<number,number>>}
  */
 /**
- * Sets the currently active area (cell, row, column, or whole matrix). The
- * returned status indicates whether the operation was successful.
+ * Sets the currently active area (cell, row, column, or whole matrix).
+ * Automatically locks the **OcaMatrix** object and the Matrix Proxy object.
+ * Does not lock the addressed matrix Members. Locks shall persist until any
+ * matrix proxy method is called in the same Control Session. See the
+ * definitions of the properties **X** and **Y** for specification of X and Y
+ * values.
  *
  * @method OcaMatrix#SetCurrentXY
  * @param {number} x
@@ -116,8 +115,7 @@ export const OcaMatrix = make_control_class(
  * @returns {Promise<void>}
  */
 /**
- * Gets the matrix size. The returned status indicates whether the operation was
- * successful.
+ * Gets the matrix size.
  * The return values of this method are
  *
  * - xSize of type ``number``
@@ -131,8 +129,8 @@ export const OcaMatrix = make_control_class(
  * @returns {Promise<Arguments<number,number,number,number,number,number>>}
  */
 /**
- * Sets the matrix size. The returned status indicates whether the operation was
- * successful. This method will not be available for fixed-size matrices.
+ * Sets the matrix size. This method will not be available for fixed-size
+ * matrices.
  *
  * @method OcaMatrix#SetSize
  * @param {number} xSize
@@ -141,16 +139,18 @@ export const OcaMatrix = make_control_class(
  * @returns {Promise<void>}
  */
 /**
- * Retrieves the 2D array of member object numbers. Cells for which no member
- * has been defined will return Zero as the object number.
+ * Retrieves the 2D array of Member ONos. Cells for which no Member has been
+ * provided will contain the value zero.
  *
  * @method OcaMatrix#GetMembers
  * @returns {Promise<number[][]>}
  *   A promise which resolves to a single value of type ``number[][]``.
  */
 /**
- * Sets the entire 2D array of member object numbers. Row and column size of the
- * **members** parameter must be equal to the current size of the matrix.
+ * Sets the entire 2D array of Member Object Numbers. Row and column dimensions
+ * of the M**embers** parameter shall be equal to the current row and column
+ * counts of the Matrix. In the list, a Member Object Number value of zero shall
+ * remove any Member at the given position.
  *
  * @method OcaMatrix#SetMembers
  * @param {number[][]} members
@@ -158,8 +158,8 @@ export const OcaMatrix = make_control_class(
  * @returns {Promise<void>}
  */
 /**
- * Retrieves the object number of the member at position (x,y). If no member is
- * defined at this position, returns an object number value of Zero.
+ * Retrieves the object number of the Member at position (x,y). If no Member is
+ * defined at this position, shall return the value zero.
  *
  * @method OcaMatrix#GetMember
  * @param {number} x
@@ -169,8 +169,10 @@ export const OcaMatrix = make_control_class(
  *   A promise which resolves to a single value of type ``number``.
  */
 /**
- * Installs a particular object as a member at position (x,y). If another object
- * was at this position, it is removed.
+ * Installs a particular object as a Member at position (x,y). If another object
+ * is already at this position, it is replaced. If value of the **memberONo**
+ * parameter is zero, any object already at this position is removed and not
+ * replaced.
  *
  * @method OcaMatrix#SetMember
  * @param {number} x
@@ -180,14 +182,14 @@ export const OcaMatrix = make_control_class(
  * @returns {Promise<void>}
  */
 /**
- * Gets the object number of the matrix proxy.
+ * Gets the object number of the Matrix Proxy.
  *
  * @method OcaMatrix#GetProxy
  * @returns {Promise<number>}
  *   A promise which resolves to a single value of type ``number``.
  */
 /**
- * Sets the object number of the matrix proxy.
+ * Sets the object number of the Matrix Proxy.
  *
  * @method OcaMatrix#SetProxy
  * @param {number} ONo
@@ -195,14 +197,14 @@ export const OcaMatrix = make_control_class(
  * @returns {Promise<void>}
  */
 /**
- * Gets the number of ports per row. These are input ports.
+ * Gets the number of Ports per row. Note: these are Input Ports.
  *
  * @method OcaMatrix#GetPortsPerRow
  * @returns {Promise<number>}
  *   A promise which resolves to a single value of type ``number``.
  */
 /**
- * Sets the number of ports per row. These must be input ports.
+ * Sets the number of Ports per row. These shall be Input Ports.
  *
  * @method OcaMatrix#SetPortsPerRow
  * @param {number} Ports
@@ -210,14 +212,14 @@ export const OcaMatrix = make_control_class(
  * @returns {Promise<void>}
  */
 /**
- * Gets the number of ports per output channel. These are output ports.
+ * Gets the number of Ports per column. Note: these are Output Ports.
  *
  * @method OcaMatrix#GetPortsPerColumn
  * @returns {Promise<number>}
  *   A promise which resolves to a single value of type ``number``.
  */
 /**
- * Sets the number of ports per column. These must be output ports.
+ * Sets the number of Ports per column. These shall be Output Ports.
  *
  * @method OcaMatrix#SetPortsPerColumn
  * @param {number} Ports
@@ -225,9 +227,15 @@ export const OcaMatrix = make_control_class(
  * @returns {Promise<void>}
  */
 /**
- * Sets the currently active area (cell, row, column, or whole matrix) and locks
- * it. Fails if the referenced members cannot all be locked. The returned status
- * indicates whether the operation was successful.
+ * Sets the currently active area (cell, row, column, or whole matrix), locks
+ * the **OcaMatrix** object, locks the Matrix Proxy object, and locks all the
+ * Members in the active area. Fails if the referenced members cannot all be
+ * locked. The **OcaMatrix** and Matrix Proxy locks shall persist until any
+ * Matrix Proxy method is called in the same Control Session. The Member locks
+ * shall persist until unlocked by calls to their **Unlock()** methods or by a
+ * call to the **OcaMatrix** method **UnlockCurrent**. The returned status
+ * indicates whether the operation was successful. See the definitions of the
+ * properties **X** and **Y** for specification of X and Y values.
  *
  * @method OcaMatrix#SetCurrentXYLock
  * @param {number} x
@@ -236,21 +244,54 @@ export const OcaMatrix = make_control_class(
  * @returns {Promise<void>}
  */
 /**
- * Unlocks the currently active area of the matrix. Fails if all the members of
- * the currently active area cannot be unlocked. Failure is not triggered if one
- * or more members of the currently active area are already unlocked at the time
- * Unlock() is called. The returned status indicates whether the operation was
- * successful.
+ * Unlocks the Member objects in the currently active area of the Matrix.
+ * Succeeds only if all the Members of the currently active area can be
+ * unlocked. Failure shall not be**** triggered if one or more Members of the
+ * currently active area are already unlocked. The returned status indicates
+ * whether the operation was successful.
  *
  * @method OcaMatrix#UnlockCurrent
  * @returns {Promise<void>}
  */
+/**
+ * Execute the same method in various Matrix Members with a common set of input
+ * parameters. Return the status and returned parameter values from each call.
+ * When an addressed Member is a Block, this method shall not be capable of
+ * executing methods of objects inside the Block. The **OcaStatus** value
+ * returned by this** ExecuteMethods(...)** method shall be as follows: **OK **
+ * Requested methods were called; all, none, or some of them succeeded.
+ * **<anything else>** Problem, no method calls were attempted
+ *
+ * @method OcaMatrix#ExecuteMethod
+ * @param {IOcaMatrixCoordinates[]} TargetMembers
+ * @param {IOcaMethodID} TargetMethod
+ * @param {Uint8Array[]} InData
+ *
+ * @returns {Promise<OcaCommandResult[]>}
+ *   A promise which resolves to a single value of type :class:`OcaCommandResult[]`.
+ */
+/**
+ * Execute various methods in various Matrix Members with individual parameter
+ * sets for each. Return the status and returned parameter values, if any, from
+ * each call. When an addressed Member is a Block, this method shall not be
+ * capable of executing methods of objects inside the Block. The **OcaStatus**
+ * value returned by this** ExecuteMethods(...)** method shall be as follows:
+ * **OK ** Requested methods were called; all, none, or some of them succeeded.
+ * **<anything else>** Problem, no method calls were attempted
+ *
+ * @method OcaMatrix#ExecuteCommands
+ * @param {IOcaMatrixCommand[]} Commands
+ *
+ * @returns {Promise<OcaCommandResult[]>}
+ *   A promise which resolves to a single value of type :class:`OcaCommandResult[]`.
+ */
 /**
  * This event is emitted when the property ``X`` changes in the remote object.
  * The property ``X`` is described in the AES70 standard as follows.
  * Active column index. The active column is the column to which matrix proxy
  * method calls will be reflected. Value is zero-relative, i.e. the first column
  * is number zero. A value of 65535 means all columns in the matrix.
+ * **Deprecated** in version 4 of this class (AES70-2024).
  *
  * @member {PropertyEvent<number>} OcaMatrix#OnXChanged
  */
@@ -259,7 +300,8 @@ export const OcaMatrix = make_control_class(
  * The property ``Y`` is described in the AES70 standard as follows.
  * Active row index. The active row is the row to which matrix proxy changes
  * will be reflected. Value is zero-relative, i.e. the first row is number zero.
- * A value of 65535 means all rows in the matrix.
+ * A value of 65535 means all rows in the matrix. **Deprecated** in version 4 of
+ * this class (AES70-2024).
  *
  * @member {PropertyEvent<number>} OcaMatrix#OnYChanged
  */
@@ -280,30 +322,16 @@ export const OcaMatrix = make_control_class(
 /**
  * This event is emitted when the property ``Members`` changes in the remote object.
  * The property ``Members`` is described in the AES70 standard as follows.
- * 2D array of member object numbers.
+ * 2D array of Member object numbers. A zero value shall indicate the absence of
+ * a Member at the position in question.
  *
  * @member {PropertyEvent<number[][]>} OcaMatrix#OnMembersChanged
  */
 /**
  * This event is emitted when the property ``Proxy`` changes in the remote object.
  * The property ``Proxy`` is described in the AES70 standard as follows.
- * Object number of the matrix proxy.
+ * Object number of the Matrix Proxy. **Deprecated** in version 4 of this class
+ * (AES70-2024).
  *
  * @member {PropertyEvent<number>} OcaMatrix#OnProxyChanged
  */
-/**
- * This event is emitted when the property ``PortsPerRow`` changes in the remote object.
- * The property ``PortsPerRow`` is described in the AES70 standard as follows.
- * Number of input ports per row- e.g. for a stereo matrix, the value would be
- * 2.
- *
- * @member {PropertyEvent<number>} OcaMatrix#OnPortsPerRowChanged
- */
-/**
- * This event is emitted when the property ``PortsPerColumn`` changes in the remote object.
- * The property ``PortsPerColumn`` is described in the AES70 standard as follows.
- * Number of output ports per column - e.g. for a stereo matrix, the value would
- * be 2.
- *
- * @member {PropertyEvent<number>} OcaMatrix#OnPortsPerColumnChanged
- */

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

@@ -38,6 +38,10 @@ export declare class OcaMediaClock extends OcaAgent {
    */
   OnCurrentRateChanged: PropertyEvent<OcaMediaClockRate>;
 
+  /**
+   * An alias for OnCurrentRateChanged
+   */
+  OnRateChanged: PropertyEvent<OcaMediaClockRate>;
   /**
    * This event is emitted whenever LockState changes.
    */
@@ -103,6 +107,17 @@ export declare class OcaMediaClock extends OcaAgent {
    * Gets the current sampling rate. The return value indicates whether the
    * value was successfully retrieved.
    *
+   * @method OcaMediaClock#GetRate
+   * @returns {Promise<OcaMediaClockRate>}
+   *   A promise which resolves to a single value of type :class:`OcaMediaClockRate`.
+   */
+  GetRate(): Promise<OcaMediaClockRate>;
+
+  /**
+   * Gets the current sampling rate. The return value indicates whether the
+   * value was successfully retrieved.
+   * An alias for GetRate.
+   *
    * @method OcaMediaClock#GetCurrentRate
    * @returns {Promise<OcaMediaClockRate>}
    *   A promise which resolves to a single value of type :class:`OcaMediaClockRate`.
@@ -113,6 +128,18 @@ export declare class OcaMediaClock extends OcaAgent {
    * Sets the sampling rate. The return value indicates whether the rate was
    * successfully set.
    *
+   * @method OcaMediaClock#SetRate
+   * @param {IOcaMediaClockRate} rate
+   *
+   * @returns {Promise<void>}
+   */
+  SetRate(rate: IOcaMediaClockRate): Promise<void>;
+
+  /**
+   * Sets the sampling rate. The return value indicates whether the rate was
+   * successfully set.
+   * An alias for SetRate.
+   *
    * @method OcaMediaClock#SetCurrentRate
    * @param {IOcaMediaClockRate} rate
    *

package/src/controller/ControlClasses/OcaMediaClock.js

@@ -16,7 +16,7 @@ export const OcaMediaClock = make_control_class(
   'OcaMediaClock',
   3,
   '\u0001\u0002\u0006',
-  2,
+  3,
   OcaAgent,
   [
     ['GetType', 3, 1, [], [OcaMediaClockType]],
@@ -24,15 +24,15 @@ export const OcaMediaClock = make_control_class(
     ['GetDomainID', 3, 3, [], [OcaUint16]],
     ['SetDomainID', 3, 4, [OcaUint16], []],
     ['GetSupportedRates', 3, 5, [], [OcaList(OcaMediaClockRate)]],
-    ['GetCurrentRate', 3, 6, [], [OcaMediaClockRate]],
-    ['SetCurrentRate', 3, 7, [OcaMediaClockRate], []],
+    ['GetRate', 3, 6, [], [OcaMediaClockRate], ['GetCurrentRate']],
+    ['SetRate', 3, 7, [OcaMediaClockRate], [], ['SetCurrentRate']],
     ['GetLockState', 3, 8, [], [OcaMediaClockLockState]],
   ],
   [
     ['Type', [OcaMediaClockType], 3, 1, false, false, null],
     ['DomainID', [OcaUint16], 3, 2, false, false, null],
     ['RatesSupported', [OcaList(OcaMediaClockRate)], 3, 3, false, false, null],
-    ['CurrentRate', [OcaMediaClockRate], 3, 4, false, false, null],
+    ['CurrentRate', [OcaMediaClockRate], 3, 4, false, false, ['Rate']],
     ['LockState', [OcaMediaClockLockState], 3, 5, false, false, null],
   ],
   []
@@ -86,6 +86,15 @@ export const OcaMediaClock = make_control_class(
  * Gets the current sampling rate. The return value indicates whether the value
  * was successfully retrieved.
  *
+ * @method OcaMediaClock#GetRate
+ * @returns {Promise<OcaMediaClockRate>}
+ *   A promise which resolves to a single value of type :class:`OcaMediaClockRate`.
+ */
+/**
+ * Gets the current sampling rate. The return value indicates whether the value
+ * was successfully retrieved.
+ * An alias for GetRate.
+ *
  * @method OcaMediaClock#GetCurrentRate
  * @returns {Promise<OcaMediaClockRate>}
  *   A promise which resolves to a single value of type :class:`OcaMediaClockRate`.
@@ -94,6 +103,16 @@ export const OcaMediaClock = make_control_class(
  * Sets the sampling rate. The return value indicates whether the rate was
  * successfully set.
  *
+ * @method OcaMediaClock#SetRate
+ * @param {IOcaMediaClockRate} rate
+ *
+ * @returns {Promise<void>}
+ */
+/**
+ * Sets the sampling rate. The return value indicates whether the rate was
+ * successfully set.
+ * An alias for SetRate.
+ *
  * @method OcaMediaClock#SetCurrentRate
  * @param {IOcaMediaClockRate} rate
  *
@@ -135,6 +154,11 @@ export const OcaMediaClock = make_control_class(
  *
  * @member {PropertyEvent<OcaMediaClockRate>} OcaMediaClock#OnCurrentRateChanged
  */
+/**
+ * An alias for OnCurrentRateChanged
+ *
+ * @member {PropertyEvent<OcaMediaClockRate>} OcaMediaClock#OnRateChanged
+ */
 /**
  * This event is emitted when the property ``LockState`` changes in the remote object.
  * The property ``LockState`` is described in the AES70 standard as follows.

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

@@ -6,7 +6,7 @@ import {
   IOcaMediaClockRate,
   OcaMediaClockRate,
 } from '../../types/OcaMediaClockRate';
-import { IOcaTimePTP, OcaTimePTP } from '../../types/OcaTimePTP';
+import { IOcaTime, OcaTime } from '../../types/OcaTime';
 import { Arguments } from '../arguments';
 import { PropertyEvent } from '../property_event';
 import { RemoteDevice } from '../remote_device';
@@ -32,7 +32,7 @@ export declare class OcaMediaClock3 extends OcaAgent {
   /**
    * This event is emitted whenever Offset changes.
    */
-  OnOffsetChanged: PropertyEvent<OcaTimePTP>;
+  OnOffsetChanged: PropertyEvent<OcaTime>;
 
   /**
    * This event is emitted whenever CurrentRate changes.
@@ -47,8 +47,7 @@ export declare class OcaMediaClock3 extends OcaAgent {
   constructor(objectNumber: number, device: RemoteDevice);
 
   /**
-   * Gets the value of the **Availability** property. The return value indicates
-   * whether the value was successfully retrieved.
+   * Gets the value of the **Availability** property.
    *
    * @method OcaMediaClock3#GetAvailability
    * @returns {Promise<OcaMediaClockAvailability>}
@@ -57,9 +56,8 @@ export declare class OcaMediaClock3 extends OcaAgent {
   GetAvailability(): Promise<OcaMediaClockAvailability>;
 
   /**
-   * Sets the value of the **Availability** property. The return value indicates
-   * whether the value was successfully set. Optional method, may not be
-   * supported in all implementations.
+   * Sets the value of the **Availability** property. Optional method, need not
+   * be supported in all implementations.
    *
    * @method OcaMediaClock3#SetAvailability
    * @param {IOcaMediaClockAvailability} Availability
@@ -70,8 +68,7 @@ export declare class OcaMediaClock3 extends OcaAgent {
 
   /**
    * Gets the current clock rate and the ONo of the associated **OcaTimeSource**
-   * object. The return value indicates whether the value was successfully
-   * retrieved.
+   * object.
    * The return values of this method are
    *
    * - Rate of type ``IOcaMediaClockRate``
@@ -84,8 +81,7 @@ export declare class OcaMediaClock3 extends OcaAgent {
 
   /**
    * Sets the clock rate and the ONo of the associated **OcaTimeSource** object.
-   * The return value indicates whether the value was successfully set. Optional
-   * method, may not be supported in all implementations.
+   * Optional method, may not be supported in all implementations.
    *
    * @method OcaMediaClock3#SetCurrentRate
    * @param {IOcaMediaClockRate} Rate
@@ -100,31 +96,29 @@ export declare class OcaMediaClock3 extends OcaAgent {
 
   /**
    * Gets the offset of this media clock's time from that of the associated
-   * **OcaTimeSource** object. The return value indicates whether the value was
-   * successfully retrieved.
+   * **OcaTimeSource** object.
    *
    * @method OcaMediaClock3#GetOffset
-   * @returns {Promise<OcaTimePTP>}
-   *   A promise which resolves to a single value of type :class:`OcaTimePTP`.
+   * @returns {Promise<OcaTime>}
+   *   A promise which resolves to a single value of type :class:`OcaTime`.
    */
-  GetOffset(): Promise<OcaTimePTP>;
+  GetOffset(): Promise<OcaTime>;
 
   /**
    * Sets the offset of this media clock's time from that of the associated
-   * **OcaTimeSource** object. The return value indicates whether the value was
-   * successfully set. Optional method, may not be supported in all
+   * **OcaTimeSource** object. Optional method, may not be supported in all
    * implementations.
    *
    * @method OcaMediaClock3#SetOffset
-   * @param {IOcaTimePTP} Offset
+   * @param {IOcaTime} Offset
    *
    * @returns {Promise<void>}
    */
-  SetOffset(Offset: IOcaTimePTP): Promise<void>;
+  SetOffset(Offset: IOcaTime): Promise<void>;
 
   /**
-   * Gets the list of supported media clock rates for the given time source. The
-   * return value indicates whether the list was successfully retrieved.
+   * Gets the list of supported media clock rates for each supported time
+   * source.
    *
    * @method OcaMediaClock3#GetSupportedRates
    * @returns {Promise<Map<number, OcaMediaClockRate[]>>}