@synapticon/motion-master-client 6.0.0-alpha.111 → 6.0.0-alpha.112

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1909,7 +1909,7 @@ export declare class Api<SecurityDataType = unknown> extends HttpClient<Security
1909
1909
  */
1910
1910
  deleteMonitoring: (topic: string, params?: RequestParams) => Promise<import("./http-client.js").HttpResponse<void, void>>;
1911
1911
  /**
1912
- * @description Returns one entry per cached parameter-definition file on disk, keyed by device identity (vendor, product, revision). The cache stores only the object-dictionary *definitions* (not live values), so a scan of previously-seen hardware can skip the slow SDO enumeration. Independent of the bus — works whether or not a driver is initialised.
1912
+ * @description Returns one entry per cached parameter-definition file on disk, keyed by vendor ID, product code and firmware version (object 0x100A). A device without 0x100A is not cached. The cache stores only the object-dictionary *definitions* (not live values), so a scan of previously-seen hardware can skip the slow SDO enumeration. Independent of the bus — works whether or not a driver is initialised.
1913
1913
  *
1914
1914
  * @name ListParameterCacheEntries
1915
1915
  * @summary List on-disk parameter caches
@@ -1925,7 +1925,7 @@ export declare class Api<SecurityDataType = unknown> extends HttpClient<Security
1925
1925
  */
1926
1926
  getParameterCache: (id: string, params?: RequestParams) => Promise<import("./http-client.js").HttpResponse<object, void>>;
1927
1927
  /**
1928
- * @description Removes one cached file from disk. The next scan of that hardware re-enumerates it. Useful when a vendor reused a revision across an object-dictionary change.
1928
+ * @description Removes one cached file from disk. The next scan of that hardware re-enumerates it. Useful when a firmware changed its object dictionary and kept its version string.
1929
1929
  *
1930
1930
  * @name DeleteParameterCache
1931
1931
  * @summary Delete a parameter-cache file
@@ -1230,7 +1230,7 @@ export class Api extends HttpClient {
1230
1230
  ...params,
1231
1231
  });
1232
1232
  /**
1233
- * @description Returns one entry per cached parameter-definition file on disk, keyed by device identity (vendor, product, revision). The cache stores only the object-dictionary *definitions* (not live values), so a scan of previously-seen hardware can skip the slow SDO enumeration. Independent of the bus — works whether or not a driver is initialised.
1233
+ * @description Returns one entry per cached parameter-definition file on disk, keyed by vendor ID, product code and firmware version (object 0x100A). A device without 0x100A is not cached. The cache stores only the object-dictionary *definitions* (not live values), so a scan of previously-seen hardware can skip the slow SDO enumeration. Independent of the bus — works whether or not a driver is initialised.
1234
1234
  *
1235
1235
  * @name ListParameterCacheEntries
1236
1236
  * @summary List on-disk parameter caches
@@ -1256,7 +1256,7 @@ export class Api extends HttpClient {
1256
1256
  ...params,
1257
1257
  });
1258
1258
  /**
1259
- * @description Removes one cached file from disk. The next scan of that hardware re-enumerates it. Useful when a vendor reused a revision across an object-dictionary change.
1259
+ * @description Removes one cached file from disk. The next scan of that hardware re-enumerates it. Useful when a firmware changed its object dictionary and kept its version string.
1260
1260
  *
1261
1261
  * @name DeleteParameterCache
1262
1262
  * @summary Delete a parameter-cache file
@@ -232,8 +232,8 @@ export interface UserCacheFile {
232
232
  /** Summary of one on-disk parameter-cache file (its identity, size, and count). */
233
233
  export interface ParameterCacheEntry {
234
234
  /**
235
- * Opaque key addressing this cache file in the download/delete endpoints ("<vendor>-<product>-<revision>"). Use it verbatim — do not construct it client-side.
236
- * @example "000022d2-00000201-0000000a"
235
+ * Opaque key addressing this cache file in the download/delete endpoints ("<vendor>-<product>-<version>", the version reduced to URL-safe characters). Use it verbatim — do not construct it client-side.
236
+ * @example "000022d2-00000201-v5.6.6"
237
237
  */
238
238
  id: string;
239
239
  /**
@@ -247,10 +247,10 @@ export interface ParameterCacheEntry {
247
247
  */
248
248
  productCode: number;
249
249
  /**
250
- * Revision number.
251
- * @example 10
250
+ * The device's firmware version (0x100A) the file was written for, in full.
251
+ * @example "v5.6.6"
252
252
  */
253
- revisionNumber: number;
253
+ firmwareVersion: string;
254
254
  /**
255
255
  * Number of cached parameter definitions in the file.
256
256
  * @example 312
@@ -1018,7 +1018,7 @@ export interface ProcedureRequest {
1018
1018
  */
1019
1019
  pollIntervalMs?: number;
1020
1020
  /**
1021
- * `os-command` only: whether the command moves bulk data through the drive's fs-buffer, and which way. Most commands move none. The transfer runs while the command runs, because the drive holds the command in progress until all the data has moved, and it needs firmware 5.2 or newer. Setting a direction for a command that moves no bulk data leaves the server waiting for a transfer the drive will never start.
1021
+ * `os-command` only: whether the command moves bulk data through the drive's fs-buffer, and which way. Most commands move none. A write runs while the command runs, because the command reads its input as it arrives, and it needs firmware 5.2 or newer. A read runs after the command succeeds, because the command completes when its whole output is in the fs-buffer. No read runs after a failure. An output larger than the 2024-byte fs-buffer cannot be read: the command waits for the master to empty it and runs into its timeout. Setting a direction for a command that moves no bulk data makes the transfer wait for an answer the drive never sends.
1022
1022
  * @default "none"
1023
1023
  * @example "read"
1024
1024
  */
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@synapticon/motion-master-client",
3
- "version": "6.0.0-alpha.111",
3
+ "version": "6.0.0-alpha.112",
4
4
  "description": "Isomorphic TypeScript client for Motion Master: the generated HTTP API client, the WebSocket connection, and helpers.",
5
5
  "license": "MIT",
6
6
  "repository": {