@ovok/native 0.4.6 → 0.4.8

package/lib/module/modules/bt-management/services/devices/veroval/veroval.duo-control-device.js

@@ -0,0 +1,108 @@
+"use strict";
+
+import { MeasurementTypeKey } from "@ovok/core";
+import { defineCustomDevice } from "../../custom/define-custom-device.js";
+import { CustomDevice } from "../custom/custom.device.js";
+import { SentinelFrameReader } from "../sentinel-frame-reader.js";
+import { VerovalDuoControlSequencer } from "./veroval.duo-control-sequencer.js";
+const SERVICE = "5d4b8aa6-a26a-4a1b-99f5-cd4473c786e3";
+const NOTIFY = "5d4b8aa6-a26a-4a1b-99f5-cd4473c786e4";
+const WRITE = "5d4b8aa6-a26a-4a1b-99f5-cd4473c786e5";
+const STX = "02";
+const ETX = "03";
+const ACK = "06";
+const NAK = "15";
+
+/** One stored measurement, as the device writes it: twenty-six characters. */
+const RECORD_BYTES = 26;
+
+/** A reply opens by echoing the four-character command it answers. */
+const TAG_BYTES = 4;
+
+/** `?MDR`, the reply carrying stored records. */
+const DATA_REPLY = "3f4d4452";
+
+/** `?MRN`, the reply carrying a record count. The sequencer reads it; no reading comes of it. */
+const COUNT_REPLY = "3f4d524e";
+
+/** Two memories of a hundred records each, plus the echo, with room to spare. */
+const MAX_REPLY_BYTES = 8_192;
+
+/** The device sleeps between measurements, so it is given a while to answer. */
+const STUCK_TIMEOUT_MS = 120_000;
+const asciiField = (name, from, unit) => ({
+  name,
+  byteIndexes: [from, from + 1, from + 2],
+  encoding: "ascii",
+  unit
+});
+
+/**
+ * The record layout, read from HARTMANN's own application.
+ *
+ * Offsets are relative to a record, and every field is decimal digits written as text. The
+ * timestamp at the front of each record is not declared: the SDK stamps a reading when it
+ * arrives, and a stored record's own clock would need the device's timezone to be
+ * meaningful.
+ */
+const duoControlDefinition = defineCustomDevice({
+  id: "veroval-duo-control",
+  nameMatch: /^Veroval duo control$/i,
+  stuckDataTimeoutMs: STUCK_TIMEOUT_MS,
+  services: [{
+    uuid: SERVICE,
+    monitor: [{
+      uuid: NOTIFY,
+      frame: {
+        minLengthBytes: TAG_BYTES + RECORD_BYTES
+      },
+      caseSelectorBytes: [0, 1, 2, 3],
+      cases: [{
+        selector: DATA_REPLY,
+        kind: "result",
+        measurementTypeKey: MeasurementTypeKey.bloodPressure,
+        description: "Stored measurements, one record each",
+        repeatedRecords: {
+          recordBytes: RECORD_BYTES,
+          from: TAG_BYTES
+        },
+        fields: [asciiField("systolic", 11, "mmHg"), asciiField("diastolic", 14, "mmHg"), asciiField("heartRate", 17, "bpm")]
+      }, {
+        selector: COUNT_REPLY,
+        kind: "idle",
+        description: "How many records a memory holds"
+      }]
+    }]
+  }]
+});
+
+/**
+ * The Veroval duo control.
+ *
+ * A device class rather than a declaration, because reading it is a conversation: the two
+ * user memories are asked in turn, and the device answers with bare control bytes as often
+ * as with payload. The decoding is still declared - the class supplies the framing and the
+ * walk, and nothing else.
+ *
+ * Readings are stored measurements, not live ones. The device hands over its history when
+ * asked, so what arrives was taken before the connection and may be days old.
+ */
+export class VerovalDuoControlDevice extends CustomDevice {
+  constructor(device, params) {
+    super(device, params, duoControlDefinition);
+    this.frameReader = new SentinelFrameReader({
+      start: STX,
+      terminator: ETX,
+      maxFrameBytes: MAX_REPLY_BYTES,
+      standaloneBytes: [ACK, NAK]
+    });
+    this.createCommandSequencer = () => new VerovalDuoControlSequencer({
+      write: {
+        serviceUuid: SERVICE,
+        characteristicUuid: WRITE
+      },
+      onRefused: reason => this.onError?.(new Error(`Veroval duo control: ${reason}.`))
+    });
+  }
+}
+//# sourceMappingURL=veroval.duo-control-device.js.map

package/lib/module/modules/bt-management/services/devices/veroval/veroval.duo-control-device.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["MeasurementTypeKey","defineCustomDevice","CustomDevice","SentinelFrameReader","VerovalDuoControlSequencer","SERVICE","NOTIFY","WRITE","STX","ETX","ACK","NAK","RECORD_BYTES","TAG_BYTES","DATA_REPLY","COUNT_REPLY","MAX_REPLY_BYTES","STUCK_TIMEOUT_MS","asciiField","name","from","unit","byteIndexes","encoding","duoControlDefinition","id","nameMatch","stuckDataTimeoutMs","services","uuid","monitor","frame","minLengthBytes","caseSelectorBytes","cases","selector","kind","measurementTypeKey","bloodPressure","description","repeatedRecords","recordBytes","fields","VerovalDuoControlDevice","constructor","device","params","frameReader","start","terminator","maxFrameBytes","standaloneBytes","createCommandSequencer","write","serviceUuid","characteristicUuid","onRefused","reason","onError","Error"],"sourceRoot":"../../../../../../../src","sources":["modules/bt-management/services/devices/veroval/veroval.duo-control-device.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/modules/bt-management/services/devices/veroval/veroval.duo-control-sequencer.js

@@ -0,0 +1,116 @@
+"use strict";
+
+import { hexToByte } from "../../../utils/hex-to-byte.js";
+
+/** The control bytes of the serial protocol this device speaks over BLE. */
+const ACK = 0x06;
+const NAK = 0x15;
+const ENQ = "05";
+
+/** The device holds two user memories, and each is asked for a count and then its data. */
+const STEPS = ["?MRN1", "?MDR1A", "?MRN2", "?MDR2A"];
+
+/** A reply echoes the four-character command it answers, after the byte the reader strips. */
+const TAG_FROM = 0;
+const TAG_BYTES = 4;
+const COUNT_BYTES = 3;
+const ASCII_ZERO = 0x30;
+const ASCII_NINE = 0x39;
+const asciiOf = (frame, from, count) => frame.slice(from, from + count).map(byte => String.fromCharCode(hexToByte(byte))).join("");
+const asciiNumberOf = (frame, from, count) => {
+  const codes = frame.slice(from, from + count).map(byte => hexToByte(byte));
+  if (codes.length !== count || codes.some(code => code < ASCII_ZERO || code > ASCII_NINE)) {
+    return undefined;
+  }
+  return Number(codes.map(code => code - ASCII_ZERO).join(""));
+};
+const asciiCommand = (write, text) => ({
+  ...write,
+  frame: [...text].map(character => character.charCodeAt(0).toString(16).padStart(2, "0")),
+  withoutResponse: true
+});
+
+/**
+ * Walks the Veroval duo control through its stored history.
+ *
+ * The device answers one request at a time and holds two user memories, so the exchange is
+ * a fixed walk: ask user one how many records it has, read them, then user two. A memory
+ * that reports none is skipped rather than read.
+ *
+ * Two of its replies are not payload at all. A bare `ACK` means the device has more to send
+ * and is waiting to be asked, which is what `ENQ` does - so an acknowledgement provokes an
+ * enquiry rather than advancing the walk. A bare `NAK` is a refusal and ends it.
+ *
+ * Everything here is derived from HARTMANN's own application. The one part that is an
+ * inference rather than a reading is `ENQ` as flow control: the app writes it on receiving
+ * `ACK`, which is what that pair means in the serial protocol this is descended from, but
+ * the pacing was not observed on hardware.
+ */
+export class VerovalDuoControlSequencer {
+  step = 0;
+  isDone = false;
+  constructor(params) {
+    this.params = params;
+  }
+  initialCommands = () => [this.commandFor(0)];
+  nextCommand = frame => {
+    if (this.isDone) {
+      return undefined;
+    }
+    if (frame.length === 1) {
+      return this.answerControlByte(hexToByte(frame[0] ?? "0"));
+    }
+    const tag = asciiOf(frame, TAG_FROM, TAG_BYTES);
+    if (tag === "?MRN") {
+      return this.answerCount(frame);
+    }
+    return tag === "?MDR" ? this.advance() : undefined;
+  };
+  answerControlByte = code => {
+    if (code === ACK) {
+      return [asciiCommandFromHex(this.params.write, ENQ)];
+    }
+    if (code === NAK) {
+      return this.stop("the device refused the request");
+    }
+    return undefined;
+  };
+
+  /**
+   * A memory reporting no records is skipped. Asking for the data of an empty memory is a
+   * request the device answers with nothing, which would stall the walk on its own reply.
+   */
+  answerCount = frame => {
+    const count = asciiNumberOf(frame, TAG_BYTES, COUNT_BYTES);
+    if (count === undefined) {
+      return this.stop("the device answered a record count that was not a number");
+    }
+    return count > 0 ? this.advance() : this.skipMemory();
+  };
+
+  /** Past this memory's data command, to the next memory's count. */
+  skipMemory = () => {
+    this.step += 1;
+    return this.advance();
+  };
+  advance = () => {
+    this.step += 1;
+    if (this.step >= STEPS.length) {
+      this.isDone = true;
+      return undefined;
+    }
+    return [this.commandFor(this.step)];
+  };
+  stop = reason => {
+    this.isDone = true;
+    this.params.onRefused(reason);
+    return undefined;
+  };
+  commandFor = step => asciiCommand(this.params.write, STEPS[step] ?? "");
+}
+const asciiCommandFromHex = (write, hex) => ({
+  ...write,
+  frame: [hex],
+  withoutResponse: true
+});
+//# sourceMappingURL=veroval.duo-control-sequencer.js.map

package/lib/module/modules/bt-management/services/devices/veroval/veroval.duo-control-sequencer.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["hexToByte","ACK","NAK","ENQ","STEPS","TAG_FROM","TAG_BYTES","COUNT_BYTES","ASCII_ZERO","ASCII_NINE","asciiOf","frame","from","count","slice","map","byte","String","fromCharCode","join","asciiNumberOf","codes","length","some","code","undefined","Number","asciiCommand","write","text","character","charCodeAt","toString","padStart","withoutResponse","VerovalDuoControlSequencer","step","isDone","constructor","params","initialCommands","commandFor","nextCommand","answerControlByte","tag","answerCount","advance","asciiCommandFromHex","stop","skipMemory","reason","onRefused","hex"],"sourceRoot":"../../../../../../../src","sources":["modules/bt-management/services/devices/veroval/veroval.duo-control-sequencer.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/modules/bt-management/services/devices/veroval/veroval.ecg-device.js

@@ -0,0 +1,87 @@
+"use strict";
+
+import { MeasurementTypeKey } from "@ovok/core";
+import { CaseType } from "../../../types/case-type.js";
+import { BTManagedDevice } from "../bt-managed-device.js";
+import { decodeVerovalEcgSamples, VEROVAL_ECG_SAMPLE_RATE_HZ } from "./veroval.ecg-samples.js";
+import { VerovalEcgTransfer } from "./veroval.ecg-transfer.js";
+const SERVICE = "0000a000-0000-1000-8000-00805f9b34fb";
+
+/** Requests go to one characteristic and every reply arrives on the other. */
+const CONTROL_POINT = "00002a37-0000-1000-8000-00805f9b34fb";
+const NOTIFY = "00002a36-0000-1000-8000-00805f9b34fb";
+
+/** A recording is thirty-four seconds, and the device waits on a person before sending it. */
+const STUCK_TIMEOUT_MS = 180_000;
+const PREFERRED_MTU = 247;
+
+/**
+ * Every notification matches this, and none of them is a measurement.
+ *
+ * The transfer assembles the recording itself and reports it once, so the parser is given a
+ * case that matches anything and decodes nothing. Without it each of the five hundred odd
+ * packets would be logged as a frame nothing declared.
+ */
+const acceptEverything = {
+  caseValuePosition: [],
+  cases: [{
+    caseValue: "",
+    caseType: CaseType.OTHER,
+    parseDefinitions: [],
+    description: "A packet of a download, assembled by the transfer"
+  }]
+};
+
+/**
+ * The Veroval ECG.
+ *
+ * Reading it is a download rather than a decode, so the whole recording is assembled before
+ * anything is reported: thirty-four seconds of samples at 128 Hz, two bytes each, converted
+ * to millivolts with the device's own calibration.
+ *
+ * The vendor's app plots a thirty-second window of this with a baseline-wander filter
+ * applied. That is a display transform, not calibration, so it is deliberately not
+ * reproduced here - what is reported is what the device recorded.
+ */
+export class VerovalEcgDevice extends BTManagedDevice {
+  stuckDataTimeout = STUCK_TIMEOUT_MS;
+  preferredMtu = PREFERRED_MTU;
+  onStreamStart = undefined;
+  mainServices = [{
+    uuid: SERVICE,
+    monitorUuids: [{
+      uuid: NOTIFY,
+      parsingModel: acceptEverything
+    }]
+  }];
+  validatePackage = () => true;
+  createCommandSequencer = () => new VerovalEcgTransfer({
+    write: {
+      serviceUuid: SERVICE,
+      characteristicUuid: CONTROL_POINT
+    },
+    onRecording: this.reportRecording
+  });
+  constructor(device, params) {
+    super(device, params);
+  }
+
+  /** Nothing is reported per packet; the transfer reports the recording when it is whole. */
+  handleSuccessResult() {
+    return;
+  }
+  reportRecording = bytes => {
+    const diagramPoints = decodeVerovalEcgSamples(bytes);
+    if (diagramPoints.length === 0) {
+      this.onError?.(new Error("Veroval ECG: the recording held no samples."));
+      return;
+    }
+    this.onResult?.({
+      measurementTypeKey: MeasurementTypeKey.ecg,
+      caseType: CaseType.RESULT,
+      diagramPoints,
+      duration: diagramPoints.length / VEROVAL_ECG_SAMPLE_RATE_HZ
+    });
+  };
+}
+//# sourceMappingURL=veroval.ecg-device.js.map

package/lib/module/modules/bt-management/services/devices/veroval/veroval.ecg-device.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["MeasurementTypeKey","CaseType","BTManagedDevice","decodeVerovalEcgSamples","VEROVAL_ECG_SAMPLE_RATE_HZ","VerovalEcgTransfer","SERVICE","CONTROL_POINT","NOTIFY","STUCK_TIMEOUT_MS","PREFERRED_MTU","acceptEverything","caseValuePosition","cases","caseValue","caseType","OTHER","parseDefinitions","description","VerovalEcgDevice","stuckDataTimeout","preferredMtu","onStreamStart","undefined","mainServices","uuid","monitorUuids","parsingModel","validatePackage","createCommandSequencer","write","serviceUuid","characteristicUuid","onRecording","reportRecording","constructor","device","params","handleSuccessResult","bytes","diagramPoints","length","onError","Error","onResult","measurementTypeKey","ecg","RESULT","duration"],"sourceRoot":"../../../../../../../src","sources":["modules/bt-management/services/devices/veroval/veroval.ecg-device.ts"],"mappings":";;AAAA,SAASA,kBAAkB,QAAQ,YAAY;AAG/C,SAASC,QAAQ,QAAQ,6BAA0B;AAInD,SAASC,eAAe,QAAQ,yBAAsB;AAEtD,SACEC,uBAAuB,EACvBC,0BAA0B,QACrB,0BAAuB;AAC9B,SAASC,kBAAkB,QAAQ,2BAAwB;AAE3D,MAAMC,OAAO,GAAG,sCAAsC;;AAEtD;AACA,MAAMC,aAAa,GAAG,sCAAsC;AAC5D,MAAMC,MAAM,GAAG,sCAAsC;;AAErD;AACA,MAAMC,gBAAgB,GAAG,OAAO;AAEhC,MAAMC,aAAa,GAAG,GAAG;;AAEzB;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMC,gBAAgB,GAAG;EACvBC,iBAAiB,EAAE,EAAE;EACrBC,KAAK,EAAE,CACL;IACEC,SAAS,EAAE,EAAE;IACbC,QAAQ,EAAEd,QAAQ,CAACe,KAAK;IACxBC,gBAAgB,EAAE,EAAE;IACpBC,WAAW,EAAE;EACf,CAAC;AAEL,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,gBAAgB,SAASjB,eAAe,CAAgC;EACzEkB,gBAAgB,GAAGX,gBAAgB;EAC1BY,YAAY,GAAGX,aAAa;EACrCY,aAAa,GAAGC,SAAS;EAEzBC,YAAY,GAAe,CACnC;IACEC,IAAI,EAAEnB,OAAO;IACboB,YAAY,EAAE,CAAC;MAAED,IAAI,EAAEjB,MAAM;MAAEmB,YAAY,EAAEhB;IAAiB,CAAC;EACjE,CAAC,CACF;EAEkBiB,eAAe,GAAGA,CAAA,KAAe,IAAI;EAErCC,sBAAsB,GAAGA,CAAA,KAC1C,IAAIxB,kBAAkB,CAAC;IACrByB,KAAK,EAAE;MAAEC,WAAW,EAAEzB,OAAO;MAAE0B,kBAAkB,EAAEzB;IAAc,CAAC;IAClE0B,WAAW,EAAE,IAAI,CAACC;EACpB,CAAC,CAAC;EAEGC,WAAWA,CAChBC,MAAc,EACdC,MAAyD,EACzD;IACA,KAAK,CAACD,MAAM,EAAEC,MAAM,CAAC;EACvB;;EAEA;EACUC,mBAAmBA,CAAA,EAAS;IACpC;EACF;EAEQJ,eAAe,GAAIK,KAAwB,IAAW;IAC5D,MAAMC,aAAa,GAAGrC,uBAAuB,CAACoC,KAAK,CAAC;IAEpD,IAAIC,aAAa,CAACC,MAAM,KAAK,CAAC,EAAE;MAC9B,IAAI,CAACC,OAAO,GAAG,IAAIC,KAAK,CAAC,6CAA6C,CAAC,CAAC;MAExE;IACF;IAEA,IAAI,CAACC,QAAQ,GAAG;MACdC,kBAAkB,EAAE7C,kBAAkB,CAAC8C,GAAG;MAC1C/B,QAAQ,EAAEd,QAAQ,CAAC8C,MAAM;MACzBP,aAAa;MACbQ,QAAQ,EAAER,aAAa,CAACC,MAAM,GAAGrC;IACnC,CAAC,CAAC;EACJ,CAAC;AACH","ignoreList":[]}

package/lib/module/modules/bt-management/services/devices/veroval/veroval.ecg-samples.js

@@ -0,0 +1,60 @@
+"use strict";
+
+import { hexToByte } from "../../../utils/hex-to-byte.js";
+const SAMPLE_BYTES = 2;
+const BYTE_BITS = 8;
+const SIGN_BIT = 0x8000;
+const SIGNED_16_RANGE = 0x10000;
+
+/**
+ * How fast the device samples.
+ *
+ * Not taken on trust: the vendor's own plotting step works out to two two-hundred-and-fifty
+ * sixths of a second, and its transfer is thirty-four segments of sixteen packets of sixteen
+ * bytes - which is 256 bytes, 128 samples, one second per segment. Both say 128 Hz.
+ */
+const VEROVAL_ECG_SAMPLE_RATE_HZ = 128;
+
+/**
+ * The calibration the recording is read with.
+ *
+ * This is the EDF convention - a linear map from counts onto a physical range - and the
+ * device states its own in the header it sends before the curve. These are the values the
+ * vendor's app falls back to, and are what the SDK uses until a header supplies otherwise:
+ * the full signed sixteen-bit range spans plus or minus 27.68 mV.
+ */
+const DEFAULT_CALIBRATION = {
+  physicalMinimumMicrovolts: -27_680,
+  physicalMaximumMicrovolts: 27_680,
+  digitalMinimum: -32_768,
+  digitalMaximum: 32_767
+};
+const MICROVOLTS_PER_MILLIVOLT = 1000;
+/** Samples are two bytes, most significant first, and signed. */
+const signedSampleAt = (bytes, index) => {
+  const raw = hexToByte(bytes[index] ?? "0") << BYTE_BITS | hexToByte(bytes[index + 1] ?? "0");
+  return raw & SIGN_BIT ? raw - SIGNED_16_RANGE : raw;
+};
+
+/**
+ * Turns the bytes of a recording into millivolts.
+ *
+ * A trailing odd byte is ignored: half a sample is not a sample. The conversion is the
+ * device's own, applied as it states it rather than reduced to a single factor, so a header
+ * that reports a different range still decodes correctly.
+ */
+const decodeVerovalEcgSamples = (bytes, calibration = DEFAULT_CALIBRATION) => {
+  const physicalRange = calibration.physicalMaximumMicrovolts - calibration.physicalMinimumMicrovolts;
+  const digitalRange = calibration.digitalMaximum - calibration.digitalMinimum;
+  const samples = [];
+  if (digitalRange === 0) {
+    return samples;
+  }
+  for (let index = 0; index + 1 < bytes.length; index += SAMPLE_BYTES) {
+    const counts = signedSampleAt(bytes, index) - calibration.digitalMinimum;
+    samples.push((counts * physicalRange / digitalRange + calibration.physicalMinimumMicrovolts) / MICROVOLTS_PER_MILLIVOLT);
+  }
+  return samples;
+};
+export { decodeVerovalEcgSamples, DEFAULT_CALIBRATION, VEROVAL_ECG_SAMPLE_RATE_HZ };
+//# sourceMappingURL=veroval.ecg-samples.js.map

package/lib/module/modules/bt-management/services/devices/veroval/veroval.ecg-samples.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["hexToByte","SAMPLE_BYTES","BYTE_BITS","SIGN_BIT","SIGNED_16_RANGE","VEROVAL_ECG_SAMPLE_RATE_HZ","DEFAULT_CALIBRATION","physicalMinimumMicrovolts","physicalMaximumMicrovolts","digitalMinimum","digitalMaximum","MICROVOLTS_PER_MILLIVOLT","signedSampleAt","bytes","index","raw","decodeVerovalEcgSamples","calibration","physicalRange","digitalRange","samples","length","counts","push"],"sourceRoot":"../../../../../../../src","sources":["modules/bt-management/services/devices/veroval/veroval.ecg-samples.ts"],"mappings":";;AAAA,SAASA,SAAS,QAAQ,+BAA4B;AAEtD,MAAMC,YAAY,GAAG,CAAC;AACtB,MAAMC,SAAS,GAAG,CAAC;AACnB,MAAMC,QAAQ,GAAG,MAAM;AACvB,MAAMC,eAAe,GAAG,OAAO;;AAE/B;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMC,0BAA0B,GAAG,GAAG;;AAEtC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMC,mBAAmB,GAAG;EAC1BC,yBAAyB,EAAE,CAAC,MAAM;EAClCC,yBAAyB,EAAE,MAAM;EACjCC,cAAc,EAAE,CAAC,MAAM;EACvBC,cAAc,EAAE;AAClB,CAAU;AAEV,MAAMC,wBAAwB,GAAG,IAAI;AASrC;AACA,MAAMC,cAAc,GAAGA,CAACC,KAAwB,EAAEC,KAAa,KAAa;EAC1E,MAAMC,GAAG,GACNf,SAAS,CAACa,KAAK,CAACC,KAAK,CAAC,IAAI,GAAG,CAAC,IAAIZ,SAAS,GAC5CF,SAAS,CAACa,KAAK,CAACC,KAAK,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC;EAEpC,OAAOC,GAAG,GAAGZ,QAAQ,GAAGY,GAAG,GAAGX,eAAe,GAAGW,GAAG;AACrD,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMC,uBAAuB,GAAGA,CAC9BH,KAAwB,EACxBI,WAA2B,GAAGX,mBAAmB,KACpC;EACb,MAAMY,aAAa,GACjBD,WAAW,CAACT,yBAAyB,GAAGS,WAAW,CAACV,yBAAyB;EAE/E,MAAMY,YAAY,GAAGF,WAAW,CAACP,cAAc,GAAGO,WAAW,CAACR,cAAc;EAC5E,MAAMW,OAAiB,GAAG,EAAE;EAE5B,IAAID,YAAY,KAAK,CAAC,EAAE;IACtB,OAAOC,OAAO;EAChB;EAEA,KAAK,IAAIN,KAAK,GAAG,CAAC,EAAEA,KAAK,GAAG,CAAC,GAAGD,KAAK,CAACQ,MAAM,EAAEP,KAAK,IAAIb,YAAY,EAAE;IACnE,MAAMqB,MAAM,GAAGV,cAAc,CAACC,KAAK,EAAEC,KAAK,CAAC,GAAGG,WAAW,CAACR,cAAc;IAExEW,OAAO,CAACG,IAAI,CACV,CAAED,MAAM,GAAGJ,aAAa,GAAIC,YAAY,GACtCF,WAAW,CAACV,yBAAyB,IACrCI,wBACJ,CAAC;EACH;EAEA,OAAOS,OAAO;AAChB,CAAC;AAED,SACEJ,uBAAuB,EACvBV,mBAAmB,EACnBD,0BAA0B","ignoreList":[]}

package/lib/module/modules/bt-management/services/devices/veroval/veroval.ecg-transfer.js

@@ -0,0 +1,89 @@
+"use strict";
+
+/** Every request is a fixed twenty-byte packet, zero filled but for its group and command. */
+const PACKET_BYTES = 20;
+const GROUP_INDEX = 1;
+const COMMAND_INDEX = 2;
+const PARAMETER_INDEX = 3;
+const DOWNLOAD_GROUP = 4;
+const DOWNLOAD_MODE = 1;
+const DOWNLOAD_HEADER = 2;
+const DOWNLOAD_RAW = 3;
+
+/** The transfer's shape, from the vendor's own device table. */
+const PAYLOAD_FROM = 4;
+const PAYLOAD_BYTES = 16;
+const HEADER_PACKETS = 5;
+const PACKETS_PER_SEGMENT = 16;
+const SEGMENTS = 34;
+const BYTE_MASK = 0xff;
+const BYTE_BITS = 8;
+const toHex = byte => (byte & BYTE_MASK).toString(16).padStart(2, "0");
+const packet = (write, command, parameters = []) => {
+  const bytes = new Array(PACKET_BYTES).fill(0);
+  bytes[GROUP_INDEX] = DOWNLOAD_GROUP;
+  bytes[COMMAND_INDEX] = command;
+  parameters.forEach((value, index) => {
+    bytes[PARAMETER_INDEX + index] = value;
+  });
+  return {
+    ...write,
+    frame: bytes.map(toHex)
+  };
+};
+const segmentParameters = segment => [segment & BYTE_MASK, segment >> BYTE_BITS & BYTE_MASK, segment >> BYTE_BITS * 2 & BYTE_MASK];
+/**
+ * Downloads a recording from the Veroval ECG.
+ *
+ * The exchange is a fixed walk rather than a conversation: ask for the download mode, then
+ * the header, then each second of the recording in turn. The device answers each request
+ * with a known number of twenty-byte packets, sixteen payload bytes each, so the transfer is
+ * paced by counting them - which is how the vendor's own app paces it, and is the only thing
+ * that distinguishes one phase's packets from another's.
+ *
+ * A recording is thirty-four seconds at 128 Hz. Nothing is reported until all of it has
+ * arrived: a partial ECG that looked whole would be worse than none, and the count is what
+ * says it is whole.
+ */
+export class VerovalEcgTransfer {
+  phase = "mode";
+  packets = 0;
+  segment = 0;
+  recording = [];
+  constructor(params) {
+    this.params = params;
+  }
+  initialCommands = () => [packet(this.params.write, DOWNLOAD_MODE)];
+  nextCommand = frame => {
+    if (this.phase === "done") {
+      return undefined;
+    }
+    if (this.phase === "mode") {
+      this.phase = "header";
+      this.packets = 0;
+      return [packet(this.params.write, DOWNLOAD_HEADER)];
+    }
+    this.packets += 1;
+    if (this.phase === "header") {
+      return this.packets < HEADER_PACKETS ? undefined : this.requestSegment(0);
+    }
+    this.recording.push(...frame.slice(PAYLOAD_FROM, PAYLOAD_FROM + PAYLOAD_BYTES));
+    return this.packets < PACKETS_PER_SEGMENT ? undefined : this.finishSegment();
+  };
+  finishSegment = () => {
+    this.segment += 1;
+    if (this.segment < SEGMENTS) {
+      return this.requestSegment(this.segment);
+    }
+    this.phase = "done";
+    this.params.onRecording(this.recording);
+    return undefined;
+  };
+  requestSegment = segment => {
+    this.phase = "raw";
+    this.packets = 0;
+    this.segment = segment;
+    return [packet(this.params.write, DOWNLOAD_RAW, segmentParameters(segment))];
+  };
+}
+//# sourceMappingURL=veroval.ecg-transfer.js.map

package/lib/module/modules/bt-management/services/devices/veroval/veroval.ecg-transfer.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["PACKET_BYTES","GROUP_INDEX","COMMAND_INDEX","PARAMETER_INDEX","DOWNLOAD_GROUP","DOWNLOAD_MODE","DOWNLOAD_HEADER","DOWNLOAD_RAW","PAYLOAD_FROM","PAYLOAD_BYTES","HEADER_PACKETS","PACKETS_PER_SEGMENT","SEGMENTS","BYTE_MASK","BYTE_BITS","toHex","byte","toString","padStart","packet","write","command","parameters","bytes","Array","fill","forEach","value","index","frame","map","segmentParameters","segment","VerovalEcgTransfer","phase","packets","recording","constructor","params","initialCommands","nextCommand","undefined","requestSegment","push","slice","finishSegment","onRecording"],"sourceRoot":"../../../../../../../src","sources":["modules/bt-management/services/devices/veroval/veroval.ecg-transfer.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/modules/bt-management/services/devices/viatom/viatom.bp-monitors.js

@@ -0,0 +1,118 @@
+"use strict";
+
+import { MeasurementTypeKey } from "@ovok/core";
+import { lepuNameMatch } from "../lepu/lepu.name-match.js";
+import { lepuDevice } from "../lepu/lepu.transports.js";
+
+/**
+ * The Viatom blood-pressure monitors that report a reading over the realtime channel.
+ *
+ * The vendor documents BP2, BP2A and BP2T as one product group on one set of characteristics
+ * with one API, and the SDK's own BP2 device class has run against that protocol on real
+ * hardware. The byte offsets below are that class's, unchanged.
+ *
+ * BP2W and the BP3 range decode the same struct rather than merely sharing a transport:
+ * their interfaces build `Bp2BleRtData`, which holds the device state in its first nine
+ * bytes and the result immediately after, and all of them answer the same `RT_DATA` opcode.
+ * That is still one step short of BP2A and BP2T, which the vendor groups with BP2 outright.
+ */
+
+/** Realtime data. Inert on this series: it reads state, it does not start a measurement. */
+const RT_DATA = 0x08;
+
+/**
+ * The command byte and the device's state byte together pick the case.
+ *
+ * The state is the first byte of the realtime payload and is what says whether the numbers
+ * that follow are a finished reading or a cuff still inflating.
+ */
+const CASE_SELECTOR_BYTES = [1, 7];
+
+/** Header, realtime state, and the result struct through its pulse-rate field. */
+const MIN_LENGTH_BYTES = 28;
+const READING = [{
+  name: "systolic",
+  byteIndexes: [20, 21],
+  byteOrder: "little",
+  encoding: "uint",
+  unit: "mmHg"
+}, {
+  name: "diastolic",
+  byteIndexes: [22, 23],
+  byteOrder: "little",
+  encoding: "uint",
+  unit: "mmHg"
+}, {
+  name: "heartRate",
+  byteIndexes: [26, 27],
+  byteOrder: "little",
+  encoding: "uint",
+  unit: "bpm"
+}];
+const result = (selector, description) => ({
+  selector,
+  kind: "result",
+  measurementTypeKey: MeasurementTypeKey.bloodPressure,
+  fields: [...READING],
+  description
+});
+const measuring = (selector, description) => ({
+  selector,
+  kind: "stream",
+  description
+});
+
+/**
+ * The states the series reports, and what each means for a reading.
+ *
+ * A finished measurement keeps reporting itself for as long as the device sits on the
+ * result screen, so the same numbers arrive on every poll. The state transition is what
+ * separates one measurement from the next, which is why the states in between are declared
+ * rather than ignored.
+ */
+const BP2_CASES = [measuring("0804", "Cuff inflating or deflating"), result("0805", "Measurement finished"), measuring("080f", "Averaging run: a measurement is in progress"), measuring("0810", "Averaging run: waiting between measurements"), result("0811", "Averaging run finished, carrying the same payload")];
+/**
+ * Declares one monitor of the BP2 series.
+ *
+ * `advertisedName` is the name the vendor's SDK matches - `BP2A`, `BP2T` - and the matcher
+ * derived from it excludes every longer name in the family, so a declaration for `BP2`
+ * cannot pick up a `BP2W`.
+ */
+const viatomBpMonitor = (advertisedName, params) => lepuDevice({
+  id: params.id,
+  nameMatch: params.nameMatch ?? lepuNameMatch(advertisedName),
+  pollCommand: RT_DATA,
+  minLengthBytes: MIN_LENGTH_BYTES,
+  caseSelectorBytes: CASE_SELECTOR_BYTES,
+  cases: BP2_CASES.map(each => ({
+    ...each
+  })),
+  ...(params.expectedDeviceTypes ? {
+    expectedDeviceTypes: params.expectedDeviceTypes
+  } : {})
+});
+
+/** BP2A, the arm-cuff monitor of the series. */
+const bp2aMonitor = params => viatomBpMonitor("BP2A", params);
+
+/** BP2T, documented by the vendor alongside BP2 and BP2A as the same protocol. */
+const bp2tMonitor = params => viatomBpMonitor("BP2T", params);
+
+/** BP2W. Documented in its own section, but decoding the same realtime struct. */
+const bp2wMonitor = params => viatomBpMonitor("BP2W", params);
+
+/**
+ * The names the BP3 range advertises.
+ *
+ * Fifteen products differing in cuff and casing rather than in protocol, so declaring the
+ * range is one line per name:
+ *
+ * ```typescript
+ * const bp3Devices = BP3_MODEL_NAMES.map((name) =>
+ *   viatomBpMonitor(name, { id: `viatom-${name.toLowerCase()}` }),
+ * );
+ * ```
+ */
+const BP3_MODEL_NAMES = ["BP3", "BP3-B", "BP3-C1", "BP3-C2", "BP3A", "BP3B", "BP3C", "BP3D", "BP3E", "BP3F", "BP3G", "BP3H", "BP3K", "BP3L", "BP3Z"];
+export { bp2aMonitor, bp2tMonitor, bp2wMonitor, BP3_MODEL_NAMES, viatomBpMonitor };
+//# sourceMappingURL=viatom.bp-monitors.js.map

package/lib/module/modules/bt-management/services/devices/viatom/viatom.bp-monitors.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["MeasurementTypeKey","lepuNameMatch","lepuDevice","RT_DATA","CASE_SELECTOR_BYTES","MIN_LENGTH_BYTES","READING","name","byteIndexes","byteOrder","encoding","unit","result","selector","description","kind","measurementTypeKey","bloodPressure","fields","measuring","BP2_CASES","viatomBpMonitor","advertisedName","params","id","nameMatch","pollCommand","minLengthBytes","caseSelectorBytes","cases","map","each","expectedDeviceTypes","bp2aMonitor","bp2tMonitor","bp2wMonitor","BP3_MODEL_NAMES"],"sourceRoot":"../../../../../../../src","sources":["modules/bt-management/services/devices/viatom/viatom.bp-monitors.ts"],"mappings":"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","ignoreList":[]}