motion-master-client 0.0.246 → 0.0.247

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "motion-master-client",
-  "version": "0.0.246",
+  "version": "0.0.247",
   "type": "commonjs",
   "description": "A library and CLI program used for communicating with Motion Master.",
   "dependencies": {

package/src/lib/config-file.js

@@ -46,7 +46,7 @@ class ConfigFile {
     }
     get isSmmConfigFile() {
         for (const parameter of this.parameters) {
-            if ((0, parameter_1.isSmmIndex)(parameter.index)) {
+            if ((0, parameter_1.isSmmParameterIndex)(parameter.index)) {
                 return true;
             }
         }

package/src/lib/config-file.js.map

@@ -1 +1 @@
-{"version":3,"file":"config-file.js","sourceRoot":"","sources":["../../../../../libs/motion-master-client/src/lib/config-file.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config-file.js","sourceRoot":"","sources":["../../../../../libs/motion-master-client/src/lib/config-file.ts"],"names":[],"mappings":"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"}

package/src/lib/motion-master-req-res-client.d.ts

@@ -8,7 +8,7 @@ import { Parameter, UIFeaturesConfig } from './parameter';
 import { SystemLogLine } from './system-log-line';
 import { MotionMasterMessage, ParameterValueType, ParameterTypeValue, DeviceParameterValuesStatus, ParameterTypeValueKey, DeviceRefObj, DeviceRef, FullAutoTuningStatus, SystemVersionStatus, DeviceInfoStatus, DeviceParameterInfoStatus, GetDeviceParameterInfoRequest, GetDeviceParameterValuesRequest, GetMultiDeviceParameterValuesRequest, MultiDeviceParameterValuesStatus, SetDeviceParameterValuesRequest, SetMultiDeviceParameterValuesRequest, GetDeviceFileListRequest, DeviceFileListStatus, GetDeviceFileRequest, DeviceFileStatus, SetDeviceFileRequest, DeleteDeviceFileRequest, ResetDeviceFaultRequest, DeviceFaultResetStatus, StopDeviceRequest, DeviceStopStatus, StartDeviceFirmwareInstallationRequest, DeviceFirmwareInstallationStatus, GetDeviceLogRequest, DeviceLogStatus, StartCoggingTorqueRecordingRequest, CoggingTorqueRecordingStatus, GetCoggingTorqueDataRequest, CoggingTorqueDataStatus, StartOffsetDetectionRequest, OffsetDetectionStatus, StartPlantModelIdentificationRequest, PlantIdentificationStatus, ComputeAutoTuningGainsRequest, AutoTuningStatus, SetMotionControllerParametersRequest, MotionControllerStatus, EnableMotionControllerRequest, SetSignalGeneratorParametersRequest, SignalGeneratorStatus, StopSignalGeneratorRequest, StartMonitoringDeviceParameterValuesRequest, MonitoringParameterValuesStatus, StopMonitoringDeviceParameterValuesRequest, GetEthercatNetworkStateRequest, EthercatNetworkStateStatus, SetEthercatNetworkStateRequest, StartNarrowAngleCalibrationRequest, NarrowAngleCalibrationStatus, SetSystemClientTimeoutRequest, StartSystemIdentificationRequest, SystemIdentificationStatus, CirculoEncoderMagnetDistanceStatus, StartCirculoEncoderNarrowAngleCalibrationProcedureRequest, CirculoEncoderNarrowAngleCalibrationProcedureStatus, GetDeviceCiA402StateRequest, DeviceCiA402StateStatus, SetDeviceCiA402StateRequest, SystemLogStatus, StartDeviceSiiRestoreRequest, DeviceSiiRestoreStatus, StartOpenLoopFieldControlRequest, OpenLoopFieldControlStatus, ComputeFullAutoTuningGainsRequest, StartFullAutoTuningRequest, StopFullAutoTuningRequest, StartCirculoEncoderConfigurationRequest, CirculoEncoderConfigurationStatus, StopCirculoEncoderNarrowAngleCalibrationProcedureRequest, StartOsCommandRequest, OsCommandStatus, RestoreDefaultParametersType, DeviceParameterAddressValue, DeviceParameterIds, DeviceParameterInfo, RequestStatusMessage } from './types';
 import { Cia402State, ModesOfOperation } from './cia402';
-import { EncoderRegisterCommunicationOsCommandResponse, MotorPhaseOrderDetectionOsCommandResponse, OpenPhaseDetectionOsCommandResponse, OsCommandMode, OsCommandResponse, PhaseResistanceMeasurementOsCommandResponse, PhaseInductanceMeasurementOsCommandResponse, PolePairDetectionOsCommandResponse, CommutationOffsetMeasurementOsCommandResponse, IcMuCalibrationModeOsCommandResponse, OpenLoopFieldModeOsCommandResponse, HrdStreamingOsCommandResponse, TorqueConstantMeasurementOsCommandResponse, SkippedCyclesCounterOsCommandResponse, IgnoreBissStatusBitsOsCommandResponse, SystemIdentificationOsCommandResponse, KublerEncoderCommandOsCommandResponse, UseInternalEncoderVelocityOsCommandResponse, KublerEncoderRegisterCommunicationOsCommandResponse, SmmAcyclicHandlerOsCommandResponse, HrdStreamingOsCommandAction, HrdStreamingOsCommandDataIndex } from './os-command';
+import { EncoderRegisterCommunicationOsCommandResponse, MotorPhaseOrderDetectionOsCommandResponse, OpenPhaseDetectionOsCommandResponse, OsCommandMode, OsCommandResponse, PhaseResistanceMeasurementOsCommandResponse, PhaseInductanceMeasurementOsCommandResponse, PolePairDetectionOsCommandResponse, CommutationOffsetMeasurementOsCommandResponse, IcMuCalibrationModeOsCommandResponse, OpenLoopFieldModeOsCommandResponse, HrdStreamingOsCommandResponse, TorqueConstantMeasurementOsCommandResponse, SkippedCyclesCounterOsCommandResponse, IgnoreBissStatusBitsOsCommandResponse, SystemIdentificationOsCommandResponse, KublerEncoderCommandOsCommandResponse, UseInternalEncoderVelocityOsCommandResponse, KublerEncoderRegisterCommunicationOsCommandResponse, SmmAcyclicHandlerOsCommandResponse, HrdStreamingOsCommandAction, HrdStreamingOsCommandDataIndex, SmmAcyclicHandlerLoadParametersForVerificationOsCommandResponse } from './os-command';
 import { IntegroVariant } from './integro-variant';
 import { ConfigParameter } from './config-file';
 import { MotionMasterClientIndexedDB } from './mmcidb';
@@ -1321,7 +1321,7 @@ export declare class MotionMasterReqResClient {
      */
     readSmmParameterArrayValue(deviceRef: DeviceRef, index: number, subindex?: number): Observable<number[]>;
     /**
-     * Reads the SMM firmware version from a device.
+     * Reads the SMM firmware version from a device as an array of bytes.
      *
      * This method reads the firmware version (MCU Software Version 0x0001:00) of the device as an array of numbers.
      * The first byte represents the minor version, and the second byte represents the major version.
@@ -1331,6 +1331,32 @@ export declare class MotionMasterReqResClient {
      * @returns An observable that emits an array of numbers, representing the byte values of the firmware version.
      */
     readSmmFirmareVersion(deviceRef: DeviceRef): Observable<number[]>;
+    /**
+     * Reads the SMM firmware version from a device as a number.
+     *
+     * This function retrieves a specific parameter from the device's SMM memory
+     * and interprets the result as a 16-bit version number.
+     *
+     * @param deviceRef - A reference to the target device.
+     * @returns An `Observable<number>` emitting the firmware version, represented as an integer.
+     */
+    readSmmFirmareVersionAsNumber(deviceRef: DeviceRef): Observable<number>;
+    /**
+     * Resolves the SMM parameter structure version for the specified device based on its firmware version.
+     *
+     * @param deviceRef - The reference to the target device.
+     *
+     * @returns An Observable that emits the appropriate SMM parameter structure version:
+     *          - 0x0041 for firmware versions below 2.3 (0x0203).
+     *          - 0x0203 for firmware versions 2.3 (0x0203) and above.
+     *
+     * @remarks
+     * - The function first reads the firmware version of the device.
+     * - Based on the firmware version, it returns the corresponding parameter structure version:
+     *   - If the firmware version is less than 0x0203, the parameter structure version is 0x0041.
+     *   - If the firmware version is 0x0203 or greater, the parameter structure version is 0x0203.
+     */
+    resolveSmmParameterStructureVersion(deviceRef: DeviceRef): Observable<number>;
     /**
      * Reads the SMM serial number from a device.
      *
@@ -1436,6 +1462,20 @@ export declare class MotionMasterReqResClient {
      * @returns An observable that emits a boolean value indicating whether the relogin attempt succeeded.
      */
     reloginToSmmForParameterDownload(deviceRef: DeviceRef, username: string, password: string): Observable<boolean>;
+    /**
+     * Changes the SMM password for the specified device.
+     *
+     * @param deviceRef - A reference to the target device.
+     * @param oldPassword - The current SMM password.
+     * @param newPassword - The new password to set for the SMM.
+     * @returns An Observable that emits `true` if the password change and SMM restart succeed, otherwise `false`.
+     *
+     * @remarks
+     * A prior successful login is required before changing the password.
+     * The new password must be at least 4 characters long.
+     *
+     * This function sends an acyclic command to update the password. If successful, it triggers an SMM restart.
+     */
     changeSmmPassword(deviceRef: DeviceRef, oldPassword: string, newPassword: string): Observable<boolean>;
     /**
      * Triggers a restart for the specified device.
@@ -1465,9 +1505,35 @@ export declare class MotionMasterReqResClient {
     acknowledgeIoFailureOnSmm(deviceRef: DeviceRef, commandTimeout?: number, responsePollingInterval?: number): Observable<boolean>;
     configureSmmSoftwareUpdate(deviceRef: DeviceRef, fileSize: number): Observable<boolean>;
     updateSmmSoftware(deviceRef: DeviceRef, username: string, password: string, buffer: Uint8Array, crc: number, chunkSize?: number): Observable<boolean>;
-    transmitSmmParameters(deviceRef: DeviceRef, parameters: Pick<Parameter, 'value'>[], version?: number): Observable<boolean>;
-    loadSmmParametersForVerification(deviceRef: DeviceRef): Observable<OsCommandResponse>;
-    loadSmmParametersForVerificationAndUnpack(deviceRef: DeviceRef): Observable<DataType[]>;
+    /**
+     * Transmits SMM parameters to the specified device.
+     *
+     * @param deviceRef - The reference to the target device.
+     * @param values - An array of data values to transmit.
+     * @param parameterStructureVersion - The version of the parameter structure (default: 0x0041).
+     *
+     * @returns An Observable that emits `true` if the operation succeeds, or `false` if it fails, the `values` array is empty.
+     *
+     * @remarks
+     * - If the `values` array is empty, the function immediately returns `false`.
+     * - The `version` is prepended to the values array before packing.
+     * - The function constructs an OS command for transmitting the parameters and writes the packed buffer to the file system.
+     */
+    transmitSmmParameters(deviceRef: DeviceRef, values: DataType[], parameterStructureVersion?: number): Observable<boolean>;
+    /**
+     * Loads the SMM parameters for verification on the specified device.
+     *
+     * This method sends a command to the device to load the SMM parameters for verification and waits for the response.
+     * The device returns a buffer with all bits inverted. The OS command will invert the bits and reconstruct the buffer
+     * into valid parameter values, which are then returned in sequence within the OS command response.
+     *
+     * @param deviceRef - The reference to the device from which the parameters should be loaded.
+     * @returns An Observable that emits the response from the device, containing the valid parameter values for verification
+     *          after the buffer is processed and reconstructed.
+     *
+     * @throws Will throw an error if the command fails or times out.
+     */
+    loadSmmParametersForVerification(deviceRef: DeviceRef): Observable<SmmAcyclicHandlerLoadParametersForVerificationOsCommandResponse>;
     verifySmmParameters(deviceRef: DeviceRef, parameters: Pick<Parameter, 'value'>[], groupOrdinal: SmmVerificationGroupOrdinal): Observable<boolean>;
     loadSmmValidationFile(deviceRef: DeviceRef): Observable<OsCommandResponse>;
     validateSmmConfiguration(deviceRef: DeviceRef, report: Uint8Array, date: Date, username: string, password: string): Observable<boolean>;

package/src/lib/motion-master-req-res-client.js

@@ -2081,7 +2081,7 @@ class MotionMasterReqResClient {
                 ? rxjs_1.EMPTY
                 : (0, rxjs_1.timer)(responsePollingInterval),
         }))).pipe((0, operators_1.takeUntil)((0, rxjs_1.timer)(commandTimeout).pipe((0, operators_1.mergeMap)(() => (0, rxjs_1.throwError)(() => new Error(`A timeout has occurred for the OS command ${JSON.stringify(command)} on device ${deviceRef}.`))))), (0, operators_1.filter)(os_command_1.isOsCommandResponse), (0, operators_1.mergeMap)((response) => {
-            if (fsBufferContent === true) {
+            if (response.request === 'succeeded' && fsBufferContent === true) {
                 return this.getFile(deviceRef, 'fs-buffer', 20000).pipe((0, operators_1.map)((value) => {
                     response.fsBuffer = value;
                     return response;
@@ -2592,7 +2592,7 @@ class MotionMasterReqResClient {
         }));
     }
     /**
-     * Reads the SMM firmware version from a device.
+     * Reads the SMM firmware version from a device as an array of bytes.
      *
      * This method reads the firmware version (MCU Software Version 0x0001:00) of the device as an array of numbers.
      * The first byte represents the minor version, and the second byte represents the major version.
@@ -2604,6 +2604,43 @@ class MotionMasterReqResClient {
     readSmmFirmareVersion(deviceRef) {
         return this.readSmmParameterArrayValue(deviceRef, 0x0001, 0);
     }
+    /**
+     * Reads the SMM firmware version from a device as a number.
+     *
+     * This function retrieves a specific parameter from the device's SMM memory
+     * and interprets the result as a 16-bit version number.
+     *
+     * @param deviceRef - A reference to the target device.
+     * @returns An `Observable<number>` emitting the firmware version, represented as an integer.
+     */
+    readSmmFirmareVersionAsNumber(deviceRef) {
+        return this.readSmmParameterArrayValue(deviceRef, 0x0001, 0).pipe((0, operators_1.map)((bytes) => (bytes[1] << 8) | bytes[0]));
+    }
+    /**
+     * Resolves the SMM parameter structure version for the specified device based on its firmware version.
+     *
+     * @param deviceRef - The reference to the target device.
+     *
+     * @returns An Observable that emits the appropriate SMM parameter structure version:
+     *          - 0x0041 for firmware versions below 2.3 (0x0203).
+     *          - 0x0203 for firmware versions 2.3 (0x0203) and above.
+     *
+     * @remarks
+     * - The function first reads the firmware version of the device.
+     * - Based on the firmware version, it returns the corresponding parameter structure version:
+     *   - If the firmware version is less than 0x0203, the parameter structure version is 0x0041.
+     *   - If the firmware version is 0x0203 or greater, the parameter structure version is 0x0203.
+     */
+    resolveSmmParameterStructureVersion(deviceRef) {
+        return this.readSmmFirmareVersionAsNumber(deviceRef).pipe((0, operators_1.map)((version) => {
+            if (version < 0x0203) {
+                return 0x0041;
+            }
+            else {
+                return 0x0203;
+            }
+        }));
+    }
     /**
      * Reads the SMM serial number from a device.
      *
@@ -2728,12 +2765,26 @@ class MotionMasterReqResClient {
      * @returns An observable that emits a boolean value indicating whether the relogin attempt succeeded.
      */
     reloginToSmmForParameterDownload(deviceRef, username, password) {
-        return (0, rxjs_1.concat)(this.logoutFromSmm(deviceRef), this.loginToSmmForParameterDownload(deviceRef, username, password)).pipe((0, operators_1.last)());
+        return this.logoutFromSmm(deviceRef).pipe((0, operators_1.mergeMap)((succeeded) => succeeded ? this.loginToSmmForParameterDownload(deviceRef, username, password) : (0, rxjs_1.of)(false)));
     }
+    /**
+     * Changes the SMM password for the specified device.
+     *
+     * @param deviceRef - A reference to the target device.
+     * @param oldPassword - The current SMM password.
+     * @param newPassword - The new password to set for the SMM.
+     * @returns An Observable that emits `true` if the password change and SMM restart succeed, otherwise `false`.
+     *
+     * @remarks
+     * A prior successful login is required before changing the password.
+     * The new password must be at least 4 characters long.
+     *
+     * This function sends an acyclic command to update the password. If successful, it triggers an SMM restart.
+     */
     changeSmmPassword(deviceRef, oldPassword, newPassword) {
         const command = (0, os_command_1.createSmmAcyclicHandlerOsCommand)(os_command_1.SmmAcyclicHandlerSubcommandId.CHANGE_PASSWORD);
         const content = (0, smm_1.packSmmChangePassword)(newPassword, oldPassword);
-        return (0, rxjs_1.concat)((0, rxjs_1.defer)(() => this.runOsCommandAndWriteFsBuffer(deviceRef, command, content).pipe((0, operators_1.last)(), (0, operators_1.map)((response) => response.request === 'succeeded'))), (0, rxjs_1.defer)(() => this.triggerSmmRestart(deviceRef))).pipe((0, operators_1.last)());
+        return this.runOsCommandAndWriteFsBuffer(deviceRef, command, content).pipe((0, operators_1.last)(), (0, operators_1.map)((response) => response.request === 'succeeded'), (0, operators_1.mergeMap)((succeeded) => (succeeded ? this.triggerSmmRestart(deviceRef) : (0, rxjs_1.of)(false))));
     }
     /**
      * Triggers a restart for the specified device.
@@ -2790,26 +2841,46 @@ class MotionMasterReqResClient {
         observables.push((0, rxjs_1.defer)(() => this.runOsCommandAndWriteFsBuffer(deviceRef, finalizeSoftwareUpdateCommand, packedCrc).pipe((0, operators_1.last)(), (0, operators_1.map)((response) => response.request === 'succeeded'))), (0, rxjs_1.defer)(() => this.triggerSmmRestart(deviceRef)));
         return (0, rxjs_1.concat)(...observables);
     }
-    transmitSmmParameters(deviceRef, parameters, version = 0x0041) {
-        const values = parameters.map((p) => p.value);
+    /**
+     * Transmits SMM parameters to the specified device.
+     *
+     * @param deviceRef - The reference to the target device.
+     * @param values - An array of data values to transmit.
+     * @param parameterStructureVersion - The version of the parameter structure (default: 0x0041).
+     *
+     * @returns An Observable that emits `true` if the operation succeeds, or `false` if it fails, the `values` array is empty.
+     *
+     * @remarks
+     * - If the `values` array is empty, the function immediately returns `false`.
+     * - The `version` is prepended to the values array before packing.
+     * - The function constructs an OS command for transmitting the parameters and writes the packed buffer to the file system.
+     */
+    transmitSmmParameters(deviceRef, values, parameterStructureVersion = 0x0041) {
+        if (values.length === 0) {
+            return (0, rxjs_1.of)(false);
+        }
         // usedParameterStructVersion: 1st byte is major version, 2nd byte is minor version (0x0028 -> 0.40)
-        values.unshift(version);
+        values.unshift(parameterStructureVersion);
         const command = (0, os_command_1.createSmmAcyclicHandlerOsCommand)(os_command_1.SmmAcyclicHandlerSubcommandId.TRANSMIT_PARAMETERS);
         const { buffer: content } = (0, smm_1.packSmmParameterValues)(values);
         return this.runOsCommandAndWriteFsBuffer(deviceRef, command, content).pipe((0, operators_1.last)(), (0, operators_1.map)((response) => response.request === 'succeeded'));
     }
+    /**
+     * Loads the SMM parameters for verification on the specified device.
+     *
+     * This method sends a command to the device to load the SMM parameters for verification and waits for the response.
+     * The device returns a buffer with all bits inverted. The OS command will invert the bits and reconstruct the buffer
+     * into valid parameter values, which are then returned in sequence within the OS command response.
+     *
+     * @param deviceRef - The reference to the device from which the parameters should be loaded.
+     * @returns An Observable that emits the response from the device, containing the valid parameter values for verification
+     *          after the buffer is processed and reconstructed.
+     *
+     * @throws Will throw an error if the command fails or times out.
+     */
     loadSmmParametersForVerification(deviceRef) {
         const command = (0, os_command_1.createSmmAcyclicHandlerOsCommand)(os_command_1.SmmAcyclicHandlerSubcommandId.LOAD_PARAMETERS_FOR_VERIFICATION);
-        return this.runOsCommandAndReadFsBuffer(deviceRef, command, 5000, 1000);
-    }
-    loadSmmParametersForVerificationAndUnpack(deviceRef) {
-        return this.loadSmmParametersForVerification(deviceRef).pipe((0, operators_1.map)((response) => {
-            if (!response.fsBuffer) {
-                throw new Error('Reading loading SMM parameters for verification. The response buffer is empty.');
-            }
-            const values = Uint8Array.from(response.fsBuffer).map((byte) => byte ^ 0xff);
-            return (0, smm_1.unpackSmmParameterValues)(values);
-        }));
+        return this.runOsCommandAndReadFsBuffer(deviceRef, command, 10000, 1000);
     }
     verifySmmParameters(deviceRef, parameters, groupOrdinal) {
         const values = parameters.map((p) => p.value);