aes70 1.3.8 → 1.4.0

package/src/controller/ControlClasses/OcaGrouper.js

@@ -1,44 +1,112 @@
-import { make_control_class } from '../make_control_class.js';
-import { OcaAgent } from './OcaAgent.js';
 import { OcaBoolean } from '../../OCP1/OcaBoolean.js';
 import { OcaGrouperCitizen } from '../../OCP1/OcaGrouperCitizen.js';
 import { OcaGrouperEnrollment } from '../../OCP1/OcaGrouperEnrollment.js';
 import { OcaGrouperGroup } from '../../OCP1/OcaGrouperGroup.js';
 import { OcaGrouperMode } from '../../OCP1/OcaGrouperMode.js';
-import { OcaGrouperStatusChangeType } from '../../OCP1/OcaGrouperStatusChangeType.js';
+import { OcaGrouperStatusChangeEventData } from '../../OCP1/OcaGrouperStatusChangeEventData.js';
 import { OcaList } from '../../OCP1/OcaList.js';
 import { OcaString } from '../../OCP1/OcaString.js';
 import { OcaUint16 } from '../../OCP1/OcaUint16.js';
 import { OcaUint32 } from '../../OCP1/OcaUint32.js';
+import { make_control_class } from '../make_control_class.js';
+import { OcaAgent } from './OcaAgent.js';
 
 /**
- *  **Concept**   ** ** A  **grouper**  is an object responsible for aggregating property values. An  **actuator grouper**  allows control of many actuator objects from a single input value; a  **sensor grouper**  allows observing many sensor objects via a single output value. Actuator groupers are described below; sensor groupers are TBD. In a working media system, many actuator objects (we will call them  **citizens** ) will be members of multiple groups. For example, in a multiway stereo sound reinforcement system, the left woofer power amplifier might be controlled by a master gain group, a left-side gain group, and a woofer gain group. To manage the interactions of these multiple memberships, we need a single entity that manages all three of these groups, anticipating the interactions and taking appropriate action. An actuator grouper is such an entity. The grouper:
+ * **Concept** ** **A **grouper** is an object responsible for aggregating
+ * property values. An **actuator grouper** allows control of many actuator
+ * objects from a single input value; a **sensor grouper** allows observing many
+ * sensor objects via a single output value. Actuator groupers are described
+ * below; sensor groupers are TBD. In a working media system, many actuator
+ * objects (we will call them **citizens**) will be members of multiple groups.
+ * For example, in a multiway stereo sound reinforcement system, the left woofer
+ * power amplifier might be controlled by a master gain group, a left-side gain
+ * group, and a woofer gain group. To manage the interactions of these multiple
+ * memberships, we need a single entity that manages all three of these groups,
+ * anticipating the interactions and taking appropriate action. An actuator
+ * grouper is such an entity. The grouper:
  *
  *  - Registers all the groups and all the citizens.
  *
- *
  *  - Remembers which citizens belong to which groups.
  *
- *
  *  - Computes new property values when group settings change.
  *
- *
- *  - Manages overrange and underrange conditions proactively, so that citizens are never asked to assume out of range values.
- *   For any given grouper instance, all of its citizens will all be of the same class. Applications may have a number of grouper instances, one for each citizen class -- an OcaGain grouper, an OcaFrequency grouper, etc. For controlling each group, the grouper creates a proxy object of the same class as its citizens, so that the same controller logic can be used for either a group or an individual worker. It may be helpful to visualize a grouper as a matrix whose rows are groups, columns are citizens, and each cell contains information relating to the membership of the citizen in the group. This information is called the citizen's  **enrollment**  in the group.  **Mechanism**  Each Grouper is an instance of this class ( **OcaGrouper** ). A  **group** is a collection of citizens. A citizen that belongs to a group is called a  **member**  of that group. There is a many-to-many relationship between groups and citizens -- any citizen can be a member of any number of groups. The purpose of the Grouper is to contain the set of groups and the set of citizens, to remember which citizens belong to which groups, and to compute new aggregate values when settings or readings change. The Grouper itself does not provide direct access to parameter data values. That access is provided by  **group proxies** or by  **peer to peer**  mastering -- see below. It is useful to think of a Grouper as a matrix in which groups are rows and citizens are columns. A cell of the matrix is nonempty whenever its column (=citizen) belongs to its row (=group). Such a cell is called an  **enrollment.**   **Classes of Grouped Objects**  Group members can be actuator or sensor objects. A group whose members are actuators is called an  **actuator group** . A group whose members are sensors is called a  **sensor group** . All the citizens of a given Grouper must be of the same worker class (sounds communistic, doesn't it :) called the  **citizen class** . Typically an application will have multiple Groupers, each one supporting a different citizen class.  **Adding Groups**  New groups can be added to the Grouper at any time, using OcaGrouper's  **AddGroup** method.  **Group Proxies; Peer to Peer Mastering**  Depending on the setting of its  **mode**  property, a grouper may be in  **master-slave mode**  or  **peer to peer mode.**   _In master-slave mode_ , each time a caller adds a group to a Grouper instance, the Grouper instance creates an object known as a  **group proxy.** Thus, there is one group proxy instance per group.The class of the group proxy is the same as the Grouper's citizen class. For example, for a group of OcaGain actuators, the group proxy is an OcaGain object. The purpose of the group proxy is to allow controllers to access the group's setpoint (for actuator groups) or reading (for sensor groups) in the same way as they would access individual workers of the citizen class.  _In peer-to-peer mode_ , no group proxy is created. Instead, the group setpoint is changed whenever  *any*  member's setpoint is changed. In effect, all the group's members behave as though they were group proxies.  **Adding Citizens**  New citizens may be added to a Grouper instance at any time, using OcaGrouper's  **AddCitizen**  method. Newly-added citizens are by default not members of any group. Citizens may be enrolled in groups at any time using OcaGrouper's  **SetEnrollment** method.  **Deleting**  The Grouper allows deletion of groups and citizens at any time, although excessive deletion may lead to sparse memory use, depending on Grouper implementation. **Setpoints, Readings, and Aggregation**   **Setpoints and Rules**  Each group has a  **setpoint**  (for actuator groups) or  **reading**  (for sensor groups) whose value is related to its members' setpoints or readings by the combination of two rules:
- *
- *  - The group's  **saturation rules** , which control handling of overrange conditions; and
- *
- *
- *  - Each member's  **aggregation rules** , which determine the algorithms by which aggregate values are computed.
- *    ** **  **Scope of the OcaGrouper Class**  Many aspects of groupers will vary from product to product.  **OcaGrouper**  is an abstract class that defines common concepts and terms for groupers, a canonical control interface, and most aspects of membership management . However it but stops short of specifying actual semantics. Implementations will need to define (at least):
+ *  - Manages overrange and underrange conditions proactively, so that citizens
+ *    are never asked to assume out of range values.
+ *
+ *
+ * For any given grouper instance, all of its citizens will all be of the same
+ * class. Applications may have a number of grouper instances, one for each
+ * citizen class -- an OcaGain grouper, an OcaFrequency grouper, etc. For
+ * controlling each group, the grouper creates a proxy object of the same class
+ * as its citizens, so that the same controller logic can be used for either a
+ * group or an individual worker. It may be helpful to visualize a grouper as a
+ * matrix whose rows are groups, columns are citizens, and each cell contains
+ * information relating to the membership of the citizen in the group. This
+ * information is called the citizen's **enrollment** in the group.
+ * **Mechanism** Each Grouper is an instance of this class (**OcaGrouper**). A
+ * **group** is a collection of citizens. A citizen that belongs to a group is
+ * called a **member** of that group. There is a many-to-many relationship
+ * between groups and citizens -- any citizen can be a member of any number of
+ * groups. The purpose of the Grouper is to contain the set of groups and the
+ * set of citizens, to remember which citizens belong to which groups, and to
+ * compute new aggregate values when settings or readings change. The Grouper
+ * itself does not provide direct access to parameter data values. That access
+ * is provided by **group proxies** or by **peer to peer** mastering -- see
+ * below. It is useful to think of a Grouper as a matrix in which groups are
+ * rows and citizens are columns. A cell of the matrix is nonempty whenever its
+ * column (=citizen) belongs to its row (=group). Such a cell is called an
+ * **enrollment.** **Classes of Grouped Objects** Group members can be actuator
+ * or sensor objects. A group whose members are actuators is called an
+ * **actuator group**. A group whose members are sensors is called a **sensor
+ * group**. All the citizens of a given Grouper must be of the same worker class
+ * (sounds communistic, doesn't it :) called the **citizen class**. Typically an
+ * application will have multiple Groupers, each one supporting a different
+ * citizen class. **Adding Groups** New groups can be added to the Grouper at
+ * any time, using OcaGrouper's **AddGroup** method. **Group Proxies; Peer to
+ * Peer Mastering** Depending on the setting of its **mode** property, a grouper
+ * may be in **master-slave mode** or **peer to peer mode. ** In master-slave
+ * mode, each time a caller adds a group to a Grouper instance, the Grouper
+ * instance creates an object known as a **group proxy.** Thus, there is one
+ * group proxy instance per group.** ** The class of the group proxy is the same
+ * as the Grouper's citizen class. For example, for a group of OcaGain
+ * actuators, the group proxy is an OcaGain object. The purpose of the group
+ * proxy is to allow controllers to access the group's setpoint (for actuator
+ * groups) or reading (for sensor groups) in the same way as they would access
+ * individual workers of the citizen class. In peer-to-peer mode, no group proxy
+ * is created. Instead, the group setpoint is changed whenever *any* member's
+ * setpoint is changed. In effect, all the group's members behave as though they
+ * were group proxies. **Adding Citizens** New citizens may be added to a
+ * Grouper instance at any time, using OcaGrouper's **AddCitizen** method.
+ * Newly-added citizens are by default not members of any group. Citizens may be
+ * enrolled in groups at any time using OcaGrouper's **SetEnrollment** method.
+ * **Deleting** The Grouper allows deletion of groups and citizens at any time,
+ * although excessive deletion may lead to sparse memory use, depending on
+ * Grouper implementation.**Setpoints, Readings, and Aggregation** **Setpoints
+ * and Rules** Each group has a **setpoint** (for actuator groups) or
+ * **reading** (for sensor groups) whose value is related to its members'
+ * setpoints or readings by the combination of two rules:
+ *
+ *  - The group's **saturation rules**, which control handling of overrange
+ *    conditions; and
+ *
+ *  - Each member's **aggregation rules**, which determine the algorithms by
+ *    which aggregate values are computed.
+ *
+ *
+ * ** ****Scope of the OcaGrouper Class** Many aspects of groupers will vary
+ * from product to product. **OcaGrouper** is an abstract class that defines
+ * common concepts and terms for groupers, a canonical control interface, and
+ * most aspects of membership management . However it but stops short of
+ * specifying actual semantics. Implementations will need to define (at least):
  *
  *  - Saturation rules
  *
- *
  *  - Aggregation rules
  *
+ *  - Error-handling mechanisms (e.g. what happens when a grouper loses its
+ *    connection to a citizen, and what happens when it later re-attaches)
  *
- *  - Error-handling mechanisms (e.g. what happens when a grouper loses its connection to a citizen, and what happens when it later re-attaches)
  *
  * @extends OcaAgent
  * @class OcaGrouper
@@ -89,11 +157,13 @@ export const OcaGrouper = make_control_class(
     ],
     ['Mode', [OcaGrouperMode], 3, 5, false, false, null],
   ],
-  [['StatusChange', 3, 1, [OcaUint16, OcaUint16, OcaGrouperStatusChangeType]]]
+  [['StatusChange', 3, 1, [OcaGrouperStatusChangeEventData]]]
 );
 
 /**
- * Adds a group to the grouper and returns its object number. (The group's network address will be the same as the grouper's). The return value indicates whether the group was successfully added.
+ * Adds a group to the grouper and returns its object number. (The group's
+ * network address will be the same as the grouper's). The return value
+ * indicates whether the group was successfully added.
  * The return values of this method are
  *
  * - Index of type ``number``
@@ -105,7 +175,9 @@ export const OcaGrouper = make_control_class(
  * @returns {Promise<Arguments<number,number>>}
  */
 /**
- * Deletes a group from the grouper. The return value indicates whether the group was successfully deleted. Note: index values of deleted groups are not reused during the lifetime of the grouper instance.
+ * Deletes a group from the grouper. The return value indicates whether the
+ * group was successfully deleted. Note: index values of deleted groups are not
+ * reused during the lifetime of the grouper instance.
  *
  * @method OcaGrouper#DeleteGroup
  * @param {number} Index
@@ -113,30 +185,38 @@ export const OcaGrouper = make_control_class(
  * @returns {Promise<void>}
  */
 /**
- * Gets the count of groups owned by this grouper. The return value indicates whether the count was successfully retrieved.
+ * Gets the count of groups owned by this grouper. The return value indicates
+ * whether the count was successfully retrieved.
  *
  * @method OcaGrouper#GetGroupCount
  * @returns {Promise<number>}
  *   A promise which resolves to a single value of type ``number``.
  */
 /**
- * Gets the list of groups owned by this grouper. The return value indicates whether the list was successfully retrieved.
+ * Gets the list of groups owned by this grouper. The return value indicates
+ * whether the list was successfully retrieved.
  *
  * @method OcaGrouper#GetGroupList
  * @returns {Promise<OcaGrouperGroup[]>}
- *   A promise which resolves to a single value of type ``OcaGrouperGroup[]``.
+ *   A promise which resolves to a single value of type :class:`OcaGrouperGroup[]`.
  */
 /**
- * Adds a target to the group. The return value indicates whether the target was successfully added. This method does not enroll the new target in any of the grouper's groups -- it merely makes the target available for enrollment. Group membership is controlled by the SetEnrollment method, q.v.
+ * Adds a target to the group. The return value indicates whether the target was
+ * successfully added. This method does not enroll the new target in any of the
+ * grouper's groups -- it merely makes the target available for enrollment.
+ * Group membership is controlled by the SetEnrollment method, q.v.
  *
  * @method OcaGrouper#AddCitizen
- * @param {OcaGrouperCitizen} Citizen
+ * @param {IOcaGrouperCitizen} Citizen
  *
  * @returns {Promise<number>}
  *   A promise which resolves to a single value of type ``number``.
  */
 /**
- * Delete a citizen from the grouper (and therefore from all of its groups). The return value indicates whether the citizen was successfully deleted. Note: index values of deleted citizens are not reused during the lifetime of the grouper instance.
+ * Delete a citizen from the grouper (and therefore from all of its groups). The
+ * return value indicates whether the citizen was successfully deleted. Note:
+ * index values of deleted citizens are not reused during the lifetime of the
+ * grouper instance.
  *
  * @method OcaGrouper#DeleteCitizen
  * @param {number} Index
@@ -144,56 +224,62 @@ export const OcaGrouper = make_control_class(
  * @returns {Promise<void>}
  */
 /**
- * Gets the count of citizens registered in this grouper. The return value indicates whether the count was successfully retrieved.
+ * Gets the count of citizens registered in this grouper. The return value
+ * indicates whether the count was successfully retrieved.
  *
  * @method OcaGrouper#GetCitizenCount
  * @returns {Promise<number>}
  *   A promise which resolves to a single value of type ``number``.
  */
 /**
- * Gets the list of citizens registered in this grouper. The return value indicates whether the list was successfully retrieved.
+ * Gets the list of citizens registered in this grouper. The return value
+ * indicates whether the list was successfully retrieved.
  *
  * @method OcaGrouper#GetCitizenList
  * @returns {Promise<OcaGrouperCitizen[]>}
- *   A promise which resolves to a single value of type ``OcaGrouperCitizen[]``.
+ *   A promise which resolves to a single value of type :class:`OcaGrouperCitizen[]`.
  */
 /**
- * Gets membership status for given target in given group. The return value indicates whether the status was successfully retrieved.
+ * Gets membership status for given target in given group. The return value
+ * indicates whether the status was successfully retrieved.
  *
  * @method OcaGrouper#GetEnrollment
- * @param {OcaGrouperEnrollment} Enrollment
+ * @param {IOcaGrouperEnrollment} Enrollment
  *
  * @returns {Promise<boolean>}
  *   A promise which resolves to a single value of type ``boolean``.
  */
 /**
- * Sets membership status for given target in given group. The return value indicates whether the status was successfully set.
+ * Sets membership status for given target in given group. The return value
+ * indicates whether the status was successfully set.
  *
  * @method OcaGrouper#SetEnrollment
- * @param {OcaGrouperEnrollment} Enrollment
- *
+ * @param {IOcaGrouperEnrollment} Enrollment
  * @param {boolean} IsMember
  *
  * @returns {Promise<void>}
  */
 /**
- * Gets the list of members of the given group. The return value indicates whether the list was successfully retrieved.
+ * Gets the list of members of the given group. The return value indicates
+ * whether the list was successfully retrieved.
  *
  * @method OcaGrouper#GetGroupMemberList
  * @param {number} Index
  *
  * @returns {Promise<OcaGrouperCitizen[]>}
- *   A promise which resolves to a single value of type ``OcaGrouperCitizen[]``.
+ *   A promise which resolves to a single value of type :class:`OcaGrouperCitizen[]`.
  */
 /**
- * Gets the value of the ActuatorOrSensor property. The return value indicates whether the value was successfully retrieved.
+ * Gets the value of the ActuatorOrSensor property. The return value indicates
+ * whether the value was successfully retrieved.
  *
  * @method OcaGrouper#GetActuatorOrSensor
  * @returns {Promise<boolean>}
  *   A promise which resolves to a single value of type ``boolean``.
  */
 /**
- * Sets the value of the ActuatorOrSensor property. The return value indicates whether the value was successfully set.
+ * Sets the value of the ActuatorOrSensor property. The return value indicates
+ * whether the value was successfully set.
  *
  * @method OcaGrouper#SetActuatorOrSensor
  * @param {boolean} ActuatorOrSensor
@@ -201,75 +287,67 @@ export const OcaGrouper = make_control_class(
  * @returns {Promise<void>}
  */
 /**
- * Gets the value of the Mode property. The return value indicates whether the value was successfully retrieved.
+ * Gets the value of the Mode property. The return value indicates whether the
+ * value was successfully retrieved.
  *
  * @method OcaGrouper#GetMode
  * @returns {Promise<OcaGrouperMode>}
  *   A promise which resolves to a single value of type :class:`OcaGrouperMode`.
  */
 /**
- * Sets the value of the Mode property. The return value indicates whether the value was successfully set.
+ * Sets the value of the Mode property. The return value indicates whether the
+ * value was successfully set.
  *
  * @method OcaGrouper#SetMode
- * @param {OcaGrouperMode} Mode
+ * @param {IOcaGrouperMode} Mode
  *
  * @returns {Promise<void>}
  */
 /**
- * Event that is emitted whenever key aspects of a group's status change. Status events include:
+ * Event that is emitted whenever key aspects of a group's status change. Status
+ * events include:
  *
  *  - Citizen joins grouper
  *
- *
  *  - Citizen leaves grouper
  *
- *
  *  - Citizen fails to execute grouper value change request
  *
- *
  *  - Connection to online citizen is lost
  *
- *
  *  - Connection to offline citizen is reestablished
  *
- *
  *  - Citizen enrolls in group
  *
- *
  *  - Citizen de-enrolls from group
  *
+ *
  * @member OcaGrouper#OnStatusChange {Event}
- * Event that is emitted whenever key aspects of a group's status change.
- * Status events include: <ul> <li>Citizen joins grouper</li> <li>Citizen
- * leaves grouper</li> <li>Citizen fails to execute grouper value change
- * request</li> <li>Connection to online citizen is lost</li>
- * <li>Connection to offline citizen is reestablished</li> <li>Citizen
- * enrolls in group</li> <li>Citizen de-enrolls from group</li> </ul>
  */
 /**
- * This event is emitted when the property ActuatorOrSensor changes in the remote object.
+ * This event is emitted when the property ``ActuatorOrSensor`` changes in the remote object.
  * The property ``ActuatorOrSensor`` is described in the AES70 standard as follows.
  * True if Grouper is actuator grouper, false if sensor grouper.
  *
  * @member {PropertyEvent<boolean>} OcaGrouper#OnActuatorOrSensorChanged
  */
 /**
- * This event is emitted when the property Groups changes in the remote object.
+ * This event is emitted when the property ``Groups`` changes in the remote object.
  * The property ``Groups`` is described in the AES70 standard as follows.
- * List of groups in the grouper. Groups are added to and deleted from a
- * grouper by the AdGroup and DeleteGroup methods of OcaGrouper.
+ * List of groups in the grouper. Groups are added to and deleted from a grouper
+ * by the AdGroup and DeleteGroup methods of OcaGrouper.
  *
  * @member {PropertyEvent<OcaGrouperGroup[]>} OcaGrouper#OnGroupsChanged
  */
 /**
- * This event is emitted when the property Citizens changes in the remote object.
+ * This event is emitted when the property ``Citizens`` changes in the remote object.
  * The property ``Citizens`` is described in the AES70 standard as follows.
  * List of citizens defined for this grouper.
  *
  * @member {PropertyEvent<OcaGrouperCitizen[]>} OcaGrouper#OnCitizensChanged
  */
 /**
- * This event is emitted when the property Enrollments changes in the remote object.
+ * This event is emitted when the property ``Enrollments`` changes in the remote object.
  * The property ``Enrollments`` is described in the AES70 standard as follows.
  * List of grouper's enrollments, i.e. which citizen(s) belong to which
  * group(s).
@@ -277,7 +355,7 @@ export const OcaGrouper = make_control_class(
  * @member {PropertyEvent<OcaGrouperEnrollment[]>} OcaGrouper#OnEnrollmentsChanged
  */
 /**
- * This event is emitted when the property Mode changes in the remote object.
+ * This event is emitted when the property ``Mode`` changes in the remote object.
  * The property ``Mode`` is described in the AES70 standard as follows.
  * Switch that determines whether grouper is in master-slave mode or
  * peer-to-peer mode.

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

@@ -1,28 +1,25 @@
+import { PropertyEvent } from '../property_event';
 import { RemoteDevice } from '../remote_device';
 import { OcaActuator } from './OcaActuator';
 
-import { PropertyEvent } from '../property_event';
-
 /**
- * Represents a function that turns on some kind of human-detectable indicator for purposes of device identification during network setup. Physical form of indicator is not defined by OCA, so it could be anything, e.g.
+ * Represents a function that turns on some kind of human-detectable indicator
+ * for purposes of device identification during network setup. Physical form of
+ * indicator is not defined by OCA, so it could be anything, e.g.
  *
  *  - LED
  *
- *
  *  - Foghorn
  *
- *
  *  - Smoke emitter
  *
- *
  *  - Little waving robot hand wearing white glove
  *
- *
  *  - Jack-in-the-box popout
  *
- *
  *  - et cetera
  *
+ *
  * @extends OcaActuator
  * @class OcaIdentificationActuator
  */
@@ -35,7 +32,8 @@ export declare class OcaIdentificationActuator extends OcaActuator {
   constructor(objectNumber: number, device: RemoteDevice);
 
   /**
-   * Gets the current identification indicator activity state. The return value indicates whether the state was successfully retrieved.
+   * Gets the current identification indicator activity state. The return value
+   * indicates whether the state was successfully retrieved.
    *
    * @method OcaIdentificationActuator#GetActive
    * @returns {Promise<boolean>}
@@ -44,7 +42,8 @@ export declare class OcaIdentificationActuator extends OcaActuator {
   GetActive(): Promise<boolean>;
 
   /**
-   * Sets the Active state (i.e. value of the Active property). The return value indicates whether the state was successfully set.
+   * Sets the Active state (i.e. value of the Active property). The return value
+   * indicates whether the state was successfully set.
    *
    * @method OcaIdentificationActuator#SetActive
    * @param {boolean} active

package/src/controller/ControlClasses/OcaIdentificationActuator.js

@@ -1,27 +1,25 @@
+import { OcaBoolean } from '../../OCP1/OcaBoolean.js';
 import { make_control_class } from '../make_control_class.js';
 import { OcaActuator } from './OcaActuator.js';
-import { OcaBoolean } from '../../OCP1/OcaBoolean.js';
 
 /**
- * Represents a function that turns on some kind of human-detectable indicator for purposes of device identification during network setup. Physical form of indicator is not defined by OCA, so it could be anything, e.g.
+ * Represents a function that turns on some kind of human-detectable indicator
+ * for purposes of device identification during network setup. Physical form of
+ * indicator is not defined by OCA, so it could be anything, e.g.
  *
  *  - LED
  *
- *
  *  - Foghorn
  *
- *
  *  - Smoke emitter
  *
- *
  *  - Little waving robot hand wearing white glove
  *
- *
  *  - Jack-in-the-box popout
  *
- *
  *  - et cetera
  *
+ *
  * @extends OcaActuator
  * @class OcaIdentificationActuator
  */
@@ -40,14 +38,16 @@ export const OcaIdentificationActuator = make_control_class(
 );
 
 /**
- * Gets the current identification indicator activity state. The return value indicates whether the state was successfully retrieved.
+ * Gets the current identification indicator activity state. The return value
+ * indicates whether the state was successfully retrieved.
  *
  * @method OcaIdentificationActuator#GetActive
  * @returns {Promise<boolean>}
  *   A promise which resolves to a single value of type ``boolean``.
  */
 /**
- * Sets the Active state (i.e. value of the Active property). The return value indicates whether the state was successfully set.
+ * Sets the Active state (i.e. value of the Active property). The return value
+ * indicates whether the state was successfully set.
  *
  * @method OcaIdentificationActuator#SetActive
  * @param {boolean} active
@@ -55,7 +55,7 @@ export const OcaIdentificationActuator = make_control_class(
  * @returns {Promise<void>}
  */
 /**
- * This event is emitted when the property Active changes in the remote object.
+ * This event is emitted when the property ``Active`` changes in the remote object.
  * The property ``Active`` is described in the AES70 standard as follows.
  * True iff indicator is active.
  *

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

@@ -1,18 +1,20 @@
+import { Event } from '../event';
 import { RemoteDevice } from '../remote_device';
 import { OcaSensor } from './OcaSensor';
-import { Event } from '../event';
 
 /**
- * Sensor for device identification mechanism. The idea of this mechanism is that there is some kind of control -- a pushbutton, for instance -- that the user depresses to send a device identification event to the controller. Such mechanisms aid in the setup of networks.
+ * Sensor for device identification mechanism. The idea of this mechanism is
+ * that there is some kind of control -- a pushbutton, for instance -- that the
+ * user depresses to send a device identification event to the controller. Such
+ * mechanisms aid in the setup of networks.
  * @extends OcaSensor
  * @class OcaIdentificationSensor
  */
 export declare class OcaIdentificationSensor extends OcaSensor {
   /**
-   * Event that is emitted when someone actuates the device identification control.
-   * @member OcaIdentificationSensor#OnIdentify {Event}
    * Event that is emitted when someone actuates the device identification
    * control.
+   * @member OcaIdentificationSensor#OnIdentify {Event}
    */
   OnIdentify: Event;
 

package/src/controller/ControlClasses/OcaIdentificationSensor.js

@@ -2,7 +2,10 @@ import { make_control_class } from '../make_control_class.js';
 import { OcaSensor } from './OcaSensor.js';
 
 /**
- * Sensor for device identification mechanism. The idea of this mechanism is that there is some kind of control -- a pushbutton, for instance -- that the user depresses to send a device identification event to the controller. Such mechanisms aid in the setup of networks.
+ * Sensor for device identification mechanism. The idea of this mechanism is
+ * that there is some kind of control -- a pushbutton, for instance -- that the
+ * user depresses to send a device identification event to the controller. Such
+ * mechanisms aid in the setup of networks.
  * @extends OcaSensor
  * @class OcaIdentificationSensor
  */
@@ -18,8 +21,7 @@ export const OcaIdentificationSensor = make_control_class(
 );
 
 /**
- * Event that is emitted when someone actuates the device identification control.
- * @member OcaIdentificationSensor#OnIdentify {Event}
  * Event that is emitted when someone actuates the device identification
  * control.
+ * @member OcaIdentificationSensor#OnIdentify {Event}
  */

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

@@ -1,9 +1,8 @@
-import { RemoteDevice } from '../remote_device';
-import { OcaSensor } from './OcaSensor';
+import { OcaImpedance } from '../../types/OcaImpedance';
 import { Arguments } from '../arguments';
-
 import { PropertyEvent } from '../property_event';
-import { OcaImpedance } from '../../types/OcaImpedance';
+import { RemoteDevice } from '../remote_device';
+import { OcaSensor } from './OcaSensor';
 
 /**
  * Basic impedance sensor. Value is complex (magnitude and phase).
@@ -19,12 +18,13 @@ export declare class OcaImpedanceSensor extends OcaSensor {
   constructor(objectNumber: number, device: RemoteDevice);
 
   /**
-   * Gets the value and limits of the  **Reading** property. The return value indicates whether the data was successfully retrieved.
+   * Gets the value and limits of the **Reading** property. The return value
+   * indicates whether the data was successfully retrieved.
    * The return values of this method are
    *
-   * - Reading of type :class:`OcaImpedance`
-   * - minReading of type :class:`OcaImpedance`
-   * - maxReading of type :class:`OcaImpedance`
+   * - Reading of type ``IOcaImpedance``
+   * - minReading of type ``IOcaImpedance``
+   * - maxReading of type ``IOcaImpedance``
    *
    * @method OcaImpedanceSensor#GetReading
    * @returns {Promise<Arguments<OcaImpedance,OcaImpedance,OcaImpedance>>}

package/src/controller/ControlClasses/OcaImpedanceSensor.js

@@ -1,6 +1,6 @@
+import { OcaImpedance } from '../../OCP1/OcaImpedance.js';
 import { make_control_class } from '../make_control_class.js';
 import { OcaSensor } from './OcaSensor.js';
-import { OcaImpedance } from '../../OCP1/OcaImpedance.js';
 
 /**
  * Basic impedance sensor. Value is complex (magnitude and phase).
@@ -19,18 +19,19 @@ export const OcaImpedanceSensor = make_control_class(
 );
 
 /**
- * Gets the value and limits of the  **Reading** property. The return value indicates whether the data was successfully retrieved.
+ * Gets the value and limits of the **Reading** property. The return value
+ * indicates whether the data was successfully retrieved.
  * The return values of this method are
  *
- * - Reading of type :class:`OcaImpedance`
- * - minReading of type :class:`OcaImpedance`
- * - maxReading of type :class:`OcaImpedance`
+ * - Reading of type ``IOcaImpedance``
+ * - minReading of type ``IOcaImpedance``
+ * - maxReading of type ``IOcaImpedance``
  *
  * @method OcaImpedanceSensor#GetReading
  * @returns {Promise<Arguments<OcaImpedance,OcaImpedance,OcaImpedance>>}
  */
 /**
- * This event is emitted when the property Reading changes in the remote object.
+ * This event is emitted when the property ``Reading`` changes in the remote object.
  * The property ``Reading`` is described in the AES70 standard as follows.
  * Impedance value (magnitude and phase).
  *

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

@@ -1,8 +1,7 @@
-import { RemoteDevice } from '../remote_device';
-import { OcaBasicActuator } from './OcaBasicActuator';
 import { Arguments } from '../arguments';
-
 import { PropertyEvent } from '../property_event';
+import { RemoteDevice } from '../remote_device';
+import { OcaBasicActuator } from './OcaBasicActuator';
 
 /**
  * Basic int16 actuator.
@@ -18,7 +17,8 @@ export declare class OcaInt16Actuator extends OcaBasicActuator {
   constructor(objectNumber: number, device: RemoteDevice);
 
   /**
-   * Gets the value and limits of the  **Setting** property. The return value indicates whether the data was successfully retrieved.
+   * Gets the value and limits of the **Setting** property. The return value
+   * indicates whether the data was successfully retrieved.
    * The return values of this method are
    *
    * - Setting of type ``number``
@@ -31,7 +31,8 @@ export declare class OcaInt16Actuator extends OcaBasicActuator {
   GetSetting(): Promise<Arguments<[number, number, number]>>;
 
   /**
-   * Sets the  **Setting** property. The return value indicates whether the property was successfully set.
+   * Sets the **Setting** property. The return value indicates whether the
+   * property was successfully set.
    *
    * @method OcaInt16Actuator#SetSetting
    * @param {number} Setting